Skip to main content

rollouts

Overview

Namerollouts
TypeResource
Idgoogle.clouddeploy.rollouts

Fields

NameDatatypeDescription
namestringOptional. Name of the Rollout. Format is projects/{project}/ locations/{location}/deliveryPipelines/{deliveryPipeline}/ releases/{release}/rollouts/a-z{0,62}.
descriptionstringDescription of the Rollout for user purposes. Max length is 255 characters.
annotationsobjectUser annotations. These attributes can only be set and used by the user, and not by Cloud Deploy. See https://google.aip.dev/128#annotations for more details such as format and size limitations.
approvalStatestringOutput only. Approval state of the Rollout.
approveTimestringOutput only. Time at which the Rollout was approved.
controllerRolloutstringOutput only. Name of the ControllerRollout. Format is projects/{project}/ locations/{location}/deliveryPipelines/{deliveryPipeline}/ releases/{release}/rollouts/a-z{0,62}.
createTimestringOutput only. Time at which the Rollout was created.
deployEndTimestringOutput only. Time at which the Rollout finished deploying.
deployFailureCausestringOutput only. The reason this rollout failed. This will always be unspecified while the rollout is in progress.
deployStartTimestringOutput only. Time at which the Rollout started deploying.
deployingBuildstringOutput only. The resource name of the Cloud Build Build object that is used to deploy the Rollout. Format is projects/{project}/locations/{location}/builds/{build}.
enqueueTimestringOutput only. Time at which the Rollout was enqueued.
etagstringThis checksum is computed by the server based on the value of other fields, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding.
failureReasonstringOutput only. Additional information about the rollout failure, if available.
labelsobjectLabels are attributes that can be set and used by both the user and by Cloud Deploy. Labels must meet the following constraints: Keys and values can contain only lowercase letters, numeric characters, underscores, and dashes. All characters must use UTF-8 encoding, and international characters are allowed. Keys must start with a lowercase letter or international character. Each resource is limited to a maximum of 64 labels. Both keys and values are additionally constrained to be <= 128 bytes.
metadataobjectMetadata includes information associated with a Rollout.
phasesarrayOutput only. The phases that represent the workflows of this Rollout.
statestringOutput only. Current state of the Rollout.
targetIdstringRequired. The ID of Target to which this Rollout is deploying.
uidstringOutput only. Unique identifier of the Rollout.

Methods

NameAccessible byRequired ParamsDescription
getSELECTdeliveryPipelinesId, locationsId, projectsId, releasesId, rolloutsIdGets details of a single Rollout.
listSELECTdeliveryPipelinesId, locationsId, projectsId, releasesIdLists Rollouts in a given project and location.
createINSERTdeliveryPipelinesId, locationsId, projectsId, releasesIdCreates a new Rollout in a given project and location.
_listEXECdeliveryPipelinesId, locationsId, projectsId, releasesIdLists Rollouts in a given project and location.
advanceEXECdeliveryPipelinesId, locationsId, projectsId, releasesId, rolloutsIdAdvances a Rollout in a given project and location.
approveEXECdeliveryPipelinesId, locationsId, projectsId, releasesId, rolloutsIdApproves a Rollout.
cancelEXECdeliveryPipelinesId, locationsId, projectsId, releasesId, rolloutsIdCancels a Rollout in a given project and location.
ignore_jobEXECdeliveryPipelinesId, locationsId, projectsId, releasesId, rolloutsIdIgnores the specified Job in a Rollout.
retry_jobEXECdeliveryPipelinesId, locationsId, projectsId, releasesId, rolloutsIdRetries the specified Job in a Rollout.