• 标准字段

    标准字段

    本节描述了在需要类似概念时应使用的一组标准消息字段定义。 这将确保相同的概念在不同的API上具有相同的名称和语义。

    字段名 类型 描述
    name string name字段应该包含相对资源名
    parent string 对于资源定义和List/Create请求,parent字段应包含父级相对资源名
    create_time Timestamp 一个实体的创建时间戳
    update_time Timestamp 一个实体的最后更新时间戳;注意update_time会被create/patch/delete等操作更新
    delete_time Timestamp 实体的删除时间戳,仅当支持保留时。
    time_zone string 时区名,它应该符合IANA时区标准,如”America/Los_Angeles”。 有关详细信息,请参阅 https://en.wikipedia.org/wiki/List_of_tz_database_time_zones.
    region_code string 位置的Unicode国家/地区代码(CLDR),例如“US”和“419”。 有关详细信息,请参阅 http://www.unicode.org/reports/tr35/#unicode_region_subtag。
    language_code string BCP-47语言代码,如“en-US”或“sr-Latn”。 有关详细信息,请参阅http://www.unicode.org/reports/tr35/#Unicode_locale_identifier。
    display_name string 一个实体显示的名称。
    title string 实体的正式名称,例如公司名称。 它应该被视为正规版本的display_name
    description string 一个实体的详细文字描述
    filter string List方法的标准过滤参数
    query string 应用于Search方法的(也就是说 :search)过滤参数
    page_token string List请求的数据分页令牌
    page_size int32 List请求的数据分页大小
    total_size int32 列表中的总条目数,不考虑分页
    next_page_token string List返回结果中下一个分页的令牌。它应该在后续请求中传递为page_token参数;空值意味着没有更多数据
    request_id string 用于检测重复请求的唯一字符串id
    resume_token string 用于恢复流式传输请求的隐含令牌
    labels map\ 表示云资源的标签
    deleted bool 如果资源允许取消删除,则它必须有deleted字段表示资源是否已被删除
    show_deleted bool 如果资源允许取消删除,相应的List方法必须有一个show_deleted字段,以便客户端发现已删除的资源。
    validate_only bool 如果为true,则表示给定的请求仅需要被检验,而不是被执行。