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

ID。推出作業的名稱。格式為 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 正規化，並使用 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 正規化，並使用 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)

僅供輸出。狀態包含推出作業的整體狀態。
startTime

string (Timestamp format)

僅供輸出。推出作業開始時間。

使用 RFC 3339，產生的輸出內容一律會經過 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 正規化，並使用 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 只能是下列其中一個設定：
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 正規化，並使用 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 正規化，並使用 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

 列出指定專案、位置和機群套件中的發布作業。

resume

 繼續推出作業。

suspend

 暫停發布。