REST Resource: projects.locations.fleetPackages.rollouts

资源:Rollout

Rollout 资源表示在整个舰队中执行的 FleetPackage 发布操作的实例。这是系统生成的资源,对最终用户而言是只读的。该服务将主要使用此服务账号来处理 FleetPackage 中的更改以及环境中的其他更改。

JSON 表示法
{
  "name": string,
  "release": string,
  "rolloutStrategy": {
    object (RolloutStrategy)
  },
  "info": {
    object (RolloutInfo)
  },
  "deletionPropagationPolicy": enum (DeletionPropagationPolicy),
  "createTime": string,
  "updateTime": string
}
字段
name

string

标识符。发布作业的名称。格式为 projects/{project}/locations/{location}/fleetPackages/{fleetPackage}/rollouts/[a-z][a-z0-9\-]{0,62}。

release

string

对正在发布的 Release 的引用。

rolloutStrategy

object (RolloutStrategy)

用于将 FleetPackage 发布到集群的发布策略。

info

object (RolloutInfo)

发布的当前详情。

deletionPropagationPolicy

enum (DeletionPropagationPolicy)

发布版本的删除传播政策。

createTime

string (Timestamp format)

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

采用 RFC 3339 标准,生成的输出将始终进行 Z 规范化(即转换为 UTC 零时区格式并在末尾附加 Z),并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例:"2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。

updateTime

string (Timestamp format)

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

采用 RFC 3339 标准,生成的输出将始终进行 Z 规范化(即转换为 UTC 零时区格式并在末尾附加 Z),并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例:"2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。

RolloutInfo

RolloutInfo 表示 FleetPackage 在发布所针对的所有集群中的状态。

JSON 表示法
{
  "state": enum (State),
  "startTime": string,
  "endTime": string,
  "message": string,
  "rolloutStrategyInfo": {
    object (RolloutStrategyInfo)
  }
}
字段
state

enum (State)

仅限输出。State 包含发布的总体状态。

startTime

string (Timestamp format)

仅限输出。发布开始的时间。

采用 RFC 3339 标准,生成的输出将始终进行 Z 规范化(即转换为 UTC 零时区格式并在末尾附加 Z),并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例:"2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。

endTime

string (Timestamp format)

仅限输出。发布完成的时间。

采用 RFC 3339 标准,生成的输出将始终进行 Z 规范化(即转换为 UTC 零时区格式并在末尾附加 Z),并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例:"2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。

message

string

仅限输出。包含与发布相关的其他信息的消息。

rolloutStrategyInfo

object (RolloutStrategyInfo)

仅限输出。发布策略信息表示发布策略的执行状态。

州

发布状态

枚举
STATE_UNSPECIFIED 未指定状态。
COMPLETED 发布完成。
SUSPENDED 发布已暂停。
ABORTED 发布已中止。由于舰队成员资格发生变化或舰队软件包被删除,已在运行的发布已停止。
IN_PROGRESS 正在发布。
STALLED 发布已停止。
CANCELLED 发布已取消。由于软件包、发布版本或变体配置存在问题,拟议的发布从一开始就被视为无效或无法执行。
ABORTING 正在取消发布。

RolloutStrategyInfo

RolloutStrategyInfo 表示不同类型的发布策略的执行状态。系统只会填充与发布资源中指定的发布策略对应的字段。

JSON 表示法
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "allAtOnceStrategyInfo": {
    object (AllAtOnceStrategyInfo)
  },
  "rollingStrategyInfo": {
    object (RollingStrategyInfo)
  }
  // End of mutually exclusive fields.
}
字段
Strategy 表示应用其中一种发布策略的结果。以下是互斥字段的列表。在响应中,最多只能设置其中一个字段:
allAtOnceStrategyInfo

object (AllAtOnceStrategyInfo)

AllAtOnceStrategyInfo 表示 AllAtOnce 发布策略执行的状态。

rollingStrategyInfo

object (RollingStrategyInfo)

RollingStrategyInfo 表示滚动发布策略执行的状态。

互斥字段结束。

AllAtOnceStrategyInfo

AllAtOnceStrategyInfo 表示 AllAtOnce 发布策略的执行状态。

JSON 表示法
{
  "clusters": [
    {
      object (ClusterInfo)
    }
  ]
}
字段
clusters[]

object (ClusterInfo)

无序列表。资源包在所有目标集群中的部署状态。

ClusterInfo

ClusterInfo 表示集群的资源包发布状态。

JSON 表示法
{
  "membership": string,
  "desired": {
    object (ResourceBundleDeploymentInfo)
  },
  "initial": {
    object (ResourceBundleDeploymentInfo)
  },
  "current": {
    object (ResourceBundleDeploymentInfo)
  },
  "state": enum (State),
  "messages": [
    string
  ],
  "startTime": string,
  "endTime": string
}
字段
membership

string

仅限输出。目标集群的 gkehub 成员资格

desired

object (ResourceBundleDeploymentInfo)

仅限输出。资源包的期望状态。

initial

object (ResourceBundleDeploymentInfo)

仅限输出。部署前资源包的初始状态。

current

object (ResourceBundleDeploymentInfo)

仅限输出。资源包的当前状态。

state

enum (State)

仅限输出。集群的发布作业状态。

messages[]

string

仅限输出。无序列表。消息会传达与部署相关的其他信息。

startTime

string (Timestamp format)

仅限输出。对账开始时的时间戳。

采用 RFC 3339 标准,生成的输出将始终进行 Z 规范化(即转换为 UTC 零时区格式并在末尾附加 Z),并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例:"2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。

endTime

string (Timestamp format)

仅限输出。对账结束时的时间戳。

采用 RFC 3339 标准,生成的输出将始终进行 Z 规范化(即转换为 UTC 零时区格式并在末尾附加 Z),并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例:"2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。

ResourceBundleDeploymentInfo

ResourceBundleDeploymentInfo 表示资源包部署的状态。

JSON 表示法
{
  "release": string,
  "version": string,
  "variant": string,
  "syncState": enum (SyncState),
  "messages": [
    string
  ]
}
字段
release

string

仅限输出。指 ResourceBundle 版本。

version

string

仅限输出。指 ResourceBundle 版本的某个版本。

variant

string

仅限输出。指 ResourceBundle 版本中的变体。

syncState

enum (SyncState)

仅限输出。ResourceBundle 部署的同步状态。

messages[]

string

仅限输出。无序列表。消息包含与 ResourceBundle 部署相关的信息。例如,如果发生错误,请指明错误原因。如果部署处于待处理状态,消息中会包含新版本部署处于待处理状态的原因。

SyncState

资源包部署的同步状态。

枚举
SYNC_STATE_UNSPECIFIED 未指定状态。
RECONCILING 正在协调状态。
STALLED 停滞状态。
SYNCED 已同步状态。
PENDING 待处理状态。
ERROR 错误状态。
DELETION_PENDING 删除待处理状态。
DELETING 正在删除状态。
DELETED 已删除状态。

州

集群的发布作业状态。

枚举
STATE_UNSPECIFIED 未指定状态。
WAITING 等待状态。
IN_PROGRESS “进行中”状态。
STALLED 停滞状态。
COMPLETED 已完成状态。
ABORTED 中止状态。由于舰队成员资格发生变化或舰队软件包被删除,已在运行的发布已停止。
CANCELLED 已取消状态。由于软件包、发布版本或变体配置存在问题,拟议的发布从一开始就被视为无效或无法执行。
ERROR 错误状态。
UNCHANGED 状态未变。
SKIPPED 已跳过状态。

RollingStrategyInfo

RollingStrategyInfo 表示滚动发布策略的执行状态。

JSON 表示法
{
  "clusters": [
    {
      object (ClusterInfo)
    }
  ]
}
字段
clusters[]

object (ClusterInfo)

无序列表。资源包在所有目标集群中的部署状态。

方法

abort

中止发布。

get

获取单个发布作业的详细信息。

list

列出给定项目、位置和 Fleet 软件包中的发布。

resume

恢复发布。

suspend

暂停发布。