标准字段

这个章节描述了一系列定义近似概念时候应该被使用的标准消息字段。这可以用来保证跨不同APIs之间的相同概念有着相同的名称和语义。

Name	Type	Description
name	string	name字段应该包含相对资源名。
parent	string	在资源定义和List/Create请求里，parent应该包含其父级的相对资源名。
create_time	Timestamp	一个实体的创建时间戳。
update_time	Timestamp	一个实体最后一次被修改的时间戳. 提示: update_time会在create/patch/delete操作发生作用时被更新。
delete_time	Timestamp	一个实体的被删除时间。只有支持还原操作时存在。
expire_time	Timestamp	一个实体的过期时间戳，如果它会过期的话。
start_time	Timestamp	标记某个时间段开始的时间戳。
end_time	Timestamp	标记某个时间段或操作结束的时间戳(不管成功与否)。
read_time	Timestamp	某个特定资源被获取（在请求中被使用）或者被读取（在响应中使用）的时间戳。
time_zone	string	时区名称. 它应该是一个 IANA TZ 名称，形如"America/Los_Angeles”。更多信息，请查看 https://en.wikipedia.org/wiki/List_of_tz_database_time_zones。
region_code	string	一个地区的Unicode country/region code (CLDR) ，形如”US" and "419”。更多信息，请查看 http://www.unicode.org/reports/tr35/#unicode_region_subtag。
language_code	string	The BCP-47 language code，形如”en-US”或者"sr-Latn”。更多信息，请查看 http://www.unicode.org/reports/tr35/#Unicode_locale_identifier。
mime_type	string	一个IANA发布的MIME类型（也被称为媒体类型）。更多信息，请查看 https://www.iana.org/assignments/media-types/media-types.xhtml.
display_name	string	一个实体的显示名称。
title	string	一个实体的官方名称，例如公司名字。 它应该被视为display_name的正式版本。
description	string	一个实体的一段或多段文字描述。
filter	string	List方法的标准过滤参数。
query	string	如果应用于搜索方法，则与过滤器相同（即：搜索）
page_token	string	List请求中的分页标记。
page_size	int32	List请求中的分页大小。
total_size	int32	不分页时列表中的项目总数。
next_page_token	string	列表响应中的下一个分页标记。 它应该作为page_token用于下一个请求。 一个空值意味着没有更多的结果。
order_by	string	指定List请求结果的排序规则。
request_id	string	一个用于检测重复请求的唯一字符串。
resume_token	string	用于恢复流媒体请求的不透明令牌。
labels	map<string, string>	代表云资源标签。
deleted	bool	如果某个资源允许取消删除行为，则必须有一个deleted的字段，指示该资源是否已被删除。
show_deleted	bool	如果某个资源允许取消删除行为，则对应的List方法必须有一个show_deleted的参数，这样客户端才能查看那些被删除的资源。
update_mask	FieldMask	它用于更新请求消息，以便对资源执行部分更新。 该掩码是相对于资源而不是请求消息。
validate_only	bool	如果为true，则表示只想验证给定的请求，而并不实际执行。