REST Resource: projects.locations.fleetPackages.rollouts

Resource: Rollout

Rollout resource represents an instance of FleetPackage rollout operation across a fleet. This is a system generated resource and will be read only for end-users. It will be primarily used by the service to process the changes in the FleetPackage and other changes in the environment.

JSON representation
{
  "name": string,
  "release": string,
  "rolloutStrategy": {
    object (RolloutStrategy)
  },
  "info": {
    object (RolloutInfo)
  },
  "deletionPropagationPolicy": enum (DeletionPropagationPolicy),
  "createTime": string,
  "updateTime": string
}
Fields
name

string

Identifier. Name of the Rollout. Format is projects/{project}/locations/{location}/fleetPackages/{fleetPackage}/rollouts/[a-z][a-z0-9\-]{0,62}.

release

string

Reference to the Release being rolled out.

rolloutStrategy

object (RolloutStrategy)

Rollout strategy for rolling out FleetPackage to clusters.

info

object (RolloutInfo)

Current details of the rollout.

deletionPropagationPolicy

enum (DeletionPropagationPolicy)

Deletion propagation policy of the rollout.

createTime

string (Timestamp format)

Output only. The time the rollout was created.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

Output only. The time the rollout was most recently updated.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

RolloutInfo

RolloutInfo represents the state of the FleetPackage at all the clusters the rollout is targeting.

JSON representation
{
  "state": enum (State),
  "startTime": string,
  "endTime": string,
  "message": string,
  "rolloutStrategyInfo": {
    object (RolloutStrategyInfo)
  }
}
Fields
state

enum (State)

Output only. state contains the overall status of the Rollout.

startTime

string (Timestamp format)

Output only. Time when the rollout started.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

endTime

string (Timestamp format)

Output only. Time when the rollout completed.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

message

string

Output only. Message containing additional information related to the rollout.

rolloutStrategyInfo

object (RolloutStrategyInfo)

Output only. Rollout strategy info represents the status of execution of rollout strategy.

State

State of the rollout

Enums
STATE_UNSPECIFIED Unspecified state.
COMPLETED Rollout completed.
SUSPENDED Rollout suspended.
ABORTED Rollout aborted.
IN_PROGRESS Rollout in progress.
STALLED Rollout stalled.
CANCELLED Rollout cancelled.

RolloutStrategyInfo

RolloutStrategyInfo represents the status of execution of different types of rollout strategies. Only the field corresponding to the rollout strategy specified at the rollout resource will be populated.

JSON representation
{

  // 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.
}
Fields
Union field strategy. strategy represents result of applying one of the rollout strategies. strategy can be only one of the following:
allAtOnceStrategyInfo

object (AllAtOnceStrategyInfo)

AllAtOnceStrategyInfo represents the status of AllAtOnce rollout strategy execution.

rollingStrategyInfo

object (RollingStrategyInfo)

RollingStrategyInfo represents the status of Rolling rollout strategy execution.

AllAtOnceStrategyInfo

AllAtOnceStrategyInfo represents the status of execution of AllAtOnce rollout strategy.

JSON representation
{
  "clusters": [
    {
      object (ClusterInfo)
    }
  ]
}
Fields
clusters[]

object (ClusterInfo)

resource bundle's deployment status for all targeted clusters.

ClusterInfo

ClusterInfo represents status of a resource bundle rollout for a cluster.

JSON representation
{
  "membership": string,
  "desired": {
    object (ResourceBundleDeploymentInfo)
  },
  "initial": {
    object (ResourceBundleDeploymentInfo)
  },
  "current": {
    object (ResourceBundleDeploymentInfo)
  },
  "state": enum (State),
  "messages": [
    string
  ],
  "startTime": string,
  "endTime": string
}
Fields
membership

string

Output only. gkehub membership of target cluster

desired

object (ResourceBundleDeploymentInfo)

Output only. Desired state for the resource bundle.

initial

object (ResourceBundleDeploymentInfo)

Output only. Initial state of the resource bundle prior to the deployment.

current

object (ResourceBundleDeploymentInfo)

Output only. Current state of the resource bundle.

state

enum (State)

Output only. State of the rollout for the cluster.

messages[]

string

Output only. Messages convey additional information related to the deployment.

startTime

string (Timestamp format)

Output only. Timestamp when reconciliation starts.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

endTime

string (Timestamp format)

Output only. Timestamp when reconciliation ends.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

ResourceBundleDeploymentInfo

ResourceBundleDeploymentInfo represents the status of a resource bundle deployment.

JSON representation
{
  "release": string,
  "version": string,
  "variant": string,
  "syncState": enum (SyncState),
  "messages": [
    string
  ],
  "deletionPropagationPolicy": enum (DeletionPropagationPolicy)
}
Fields
release

string

Output only. Refers to a ResourceBundle release.

version

string

Output only. Refers to a version of the ResourceBundle release.

variant

string

Output only. Refers to a variant in a ResourceBundle release.

syncState

enum (SyncState)

Output only. Synchronization state of the ResourceBundle deployment.

messages[]

string

Output only. Messages contains information related to the ResourceBundle deployment. For example, in case of an error, indicate the reason for the error. In case of a pending deployment, reason for why the deployment of new release is pending.

deletionPropagationPolicy

enum (DeletionPropagationPolicy)

Output only. DeletionPropagationPolicy of the FleetPackage.

SyncState

Synchronization state of the resource bundle deployment.

Enums
SYNC_STATE_UNSPECIFIED Unspecified state.
RECONCILING Reconciling state.
STALLED Stalled state.
SYNCED Synced state.
PENDING Pending state.
ERROR Error state.
DELETION_PENDING Deletion pending state.
DELETING Deleting state.
DELETED Deleted state.

State

State of the rollout for the cluster.

Enums
STATE_UNSPECIFIED Unspecified state.
WAITING Waiting state.
IN_PROGRESS In progress state.
STALLED Stalled state.
COMPLETED Completed state.
ABORTED Aborted state.
CANCELLED Cancelled state.
ERROR Error state.

RollingStrategyInfo

RollingStrategyInfo represents the status of execution of Rolling rollout strategy.

JSON representation
{
  "clusters": [
    {
      object (ClusterInfo)
    }
  ]
}
Fields
clusters[]

object (ClusterInfo)

resource bundle's deployment status for all targeted clusters.

Methods

abort

Abort a Rollout.

get

Gets details of a single Rollout.

list

Lists Rollouts in a given project, location, and fleet package.

resume

Resume a Rollout.

suspend

Suspend a Rollout.