REST Resource: projects.locations.fleetPackages.rollouts

资源：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 表示法 
{

  // Union field strategy can be only one of the following:
  "allAtOnceStrategyInfo": {
    object (AllAtOnceStrategyInfo)
  },
  "rollingStrategyInfo": {
    object (RollingStrategyInfo)
  }
  // End of list of possible types for union field strategy.
}
字段
联合字段 strategy。Strategy 表示应用某项发布策略的结果。strategy 只能是下列其中一项：
allAtOnceStrategyInfo

object (AllAtOnceStrategyInfo)

AllAtOnceStrategyInfo 表示“一次性”发布策略的执行状态。
rollingStrategyInfo

object (RollingStrategyInfo)

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

AllAtOnceStrategyInfo

AllAtOnceStrategyInfo 表示“一次性”发布策略的执行状态。

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

 获取单个 Rollout 的详细信息。

list

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

resume

 恢复发布。

suspend

 暂停发布。