REST Resource: projects.locations.backends.rollouts

资源:发布

后端 build 的单次发布。

JSON 表示法
{
  "name": string,
  "displayName": string,
  "state": enum (State),
  "error": {
    object (Status)
  },
  "build": string,
  "reconciling": boolean,
  "createTime": string,
  "updateTime": string,
  "deleteTime": string,
  "labels": {
    string: string,
    ...
  },
  "annotations": {
    string: string,
    ...
  },
  "uid": string,
  "etag": string
}
字段
name

string

标识符。发布的资源名称。

格式:

projects/{project}/locations/{locationId}/backends/{backendId}/rollouts/{rolloutId}

displayName

string

可选。人类可读的名称。上限为 63 个字符。

state

enum (State)

仅限输出。发布的状态。

error

object (Status)

仅限输出。发布的状态和(人类可读的)错误消息(如果处于 FAILED 状态)。

build

string

不可变。已存在的 build 的名称。不一定非要开发出来发布操作会等待 build 准备就绪,然后再更新流量。

reconciling

boolean

仅限输出。一个字段,如果为 true,则表示发布当前具有 LRO。

createTime

string (Timestamp format)

仅限输出。创建发布的时间。

时间戳采用 RFC3339 世界协调时间(UTC,即“祖鲁时”)格式,精确到纳秒,最多九个小数位。示例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

updateTime

string (Timestamp format)

仅限输出。上次更新发布的时间。

时间戳采用 RFC3339 世界协调时间(UTC,即“祖鲁时”)格式,精确到纳秒,最多九个小数位。示例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

deleteTime

string (Timestamp format)

仅限输出。删除发布的时间。

时间戳采用 RFC3339 世界协调时间(UTC,即“祖鲁时”)格式,精确到纳秒,最多九个小数位。示例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

labels

map (key: string, value: string)

可选。可用于对对象进行整理和分类的非结构化键值对映射。

包含一系列 "key": value 对的对象。示例:{ "name": "wrench", "mass": "1.3kg", "count": "3" }

annotations

map (key: string, value: string)

可选。非结构化键值对映射,可由外部工具设置,用于存储和任意元数据。它们不可查询,在修改对象时应保留。

包含一系列 "key": value 对的对象。示例:{ "name": "wrench", "mass": "1.3kg", "count": "3" }

uid

string

仅限输出。系统分配的唯一标识符。

etag

string

仅限输出。服务器基于其他值计算的校验和;更新或删除时发送,以确保对预期资源完成操作。

状态

发布的状态。

枚举
STATE_UNSPECIFIED 发布处于未知状态。
QUEUED 发布正在等待启动开始。这可能是因为它正在等待另一项发布完成。
PENDING_BUILD 发布正在等待构建流程完成,构建流程将构建代码并设置底层基础架构。
PROGRESSING 发布已开始,目前正在积极修改流量。
PAUSED 发布由于被手动暂停或处于暂停阶段而已暂停。应在 paused = true 时设置此字段。
SUCCEEDED 发布已完成。
FAILED 发布失败。如需了解详情,请参阅错误。
CANCELLED 已取消发布。

方法

create

为后端创建新的发布。

get

获取有关发布的信息。

list

列出后端的发布。