| JSON representation |
|---|
{ "resource": { "kind": string, "id": string, "creationTimestamp": string, "name": string, "description": string, "selfLink": string, "selfLinkWithId": string, "rolloutEntity": { // Union field |
resourceobject
resource.kindstring
Output only. Type of the resource. Always compute#rollout for rollouts.
resource.idstring (uint64 format)
Output only. The unique identifier for the resource. This identifier is defined by the server.
resource.creationTimestampstring
Output only. Creation timestamp in RFC3339 text format.
resource.namestring
Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
resource.descriptionstring
An optional description of this resource. Provide this property when you create the resource.
resource.selfLinkstring
Output only. Server-defined fully-qualified URL for this resource.
resource.selfLinkWithIdstring
Output only. Server-defined URL for this resource's resource id.
resource.rolloutEntityobject
Required. The resource being rolled out.
resource.rolloutEntity.orchestratedEntityobject
Optional. Entity details for products using the Orchestrated Integration model.
resource.rolloutEntity.orchestratedEntity.orchestrationActionstring
Required. Orchestration action during the Rollout. It can be one of the following values: 1) "update": Resources will be updated by the rollout. 2) "delete": Resources will be deleted by the rollout.
resource.rolloutEntity.orchestratedEntity.orchestrationSourcestring
resource.rolloutEntity.orchestratedEntity.conflictBehaviorstring
Required. Specifies the behavior of the Rollout if an out of band update is detected in a project during a Rollout. It can be one of the following values: 1) overwrite : Overwrite the local value with the rollout value. 2) no_overwrite : Do not overwrite the local value with the rollout value.
resource.rolloutPlanstring
Required. Rollout Plan used to model the Rollout. Ex. compute.googleapis.com/v1/projects/1234/rolloutPlans/rp1
resource.stateenum
Output only. The current state of the Rollout.
resource.etagstring
Output only. etag of the Rollout Ex. abc1234
resource.currentWaveNumberstring (int64 format)
Output only. The number of the currently running wave. Ex. 1
resource.waveDetails[]object
Output only. Details about each wave of the rollout.
resource.waveDetails[].orchestratedWaveDetailsobject
Output only. Additional details of the wave for products using the Orchestrated Integration model.
resource.waveDetails[].orchestratedWaveDetails.estimatedTotalResourcesCountstring (int64 format)
Output only. Estimated total count of resources.
resource.waveDetails[].orchestratedWaveDetails.completedResourcesCountstring (int64 format)
Output only. Resource completed so far.
resource.waveDetails[].orchestratedWaveDetails.failedResourcesCountstring (int64 format)
Output only. Resources failed.
resource.waveDetails[].orchestratedWaveDetails.failedLocations[]string
Output only. Locations that failed during orchestration, and ProgressiveRollout stopped retrying. There may be some successful resources rolled out in the wave as the location may have failed later in the Rollout.
resource.waveDetails[].orchestratedWaveDetails.locationStatus[]map (key: string, value: object)
Output only. Status of each location in the wave. Map keys (locations) must be specified like "us-east1" or "asia-west1-a".
resource.waveDetails[].orchestratedWaveDetails.locationStatus[].stateenum
Output only. Location state of the wave.
resource.waveDetails[].orchestratedWaveDetails.estimatedCompletionTimestring
Output only. Estimated timestamp at which the wave will complete. Extrapolated from current progress.
resource.waveDetails[].waveDisplayNamestring
Output only. Wave name. Ex. wave1
resource.waveDetails[].waveNumberstring (int64 format)
Output only. System generated number for the wave.
resource.completionTimestring
Output only. The timestamp at which the Rollout was completed.
resource.cancellationTimestring
Output only. The timestamp at which the Rollout was cancelled.
resource.pauseTimestring
Output only. The timestamp at which the Rollout was paused.
resource.resumeTimestring
Output only. The timestamp at which the Rollout was resumed.
etagstring
Methods |
|
|---|---|
|
Advances a Rollout to the next wave, or completes it if no waves remain. |
|
Cancels a Rollout. |
|
Deletes a Rollout. |
|
Gets details of a single organization-scoped Rollout. |
|
Lists Rollouts in a given organization and location. |
|
Pauses a Rollout. |
|
Resumes a Rollout. |
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2026-06-25 UTC.