Google Cloud Deploy V1 Client - Class Rollout (0.12.1)

Reference documentation and code samples for the Google Cloud Deploy V1 Client class Rollout.

A Rollout resource in the Cloud Deploy API.

A Rollout contains information around a specific deployment to a Target.

Generated from protobuf message google.cloud.deploy.v1.Rollout

Namespace

Google \ Cloud \ Deploy \ V1

Methods

__construct

Constructor.

Parameters
NameDescription
data array

Optional. Data for populating the Message object.

↳ name string

Optional. Name of the Rollout. Format is projects/{project}/ locations/{location}/deliveryPipelines/{deliveryPipeline}/ releases/{release}/rollouts/[a-z][a-z0-9-]{0,62}.

↳ uid string

Output only. Unique identifier of the Rollout.

↳ description string

Description of the Rollout for user purposes. Max length is 255 characters.

↳ annotations array|Google\Protobuf\Internal\MapField

User 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.

↳ labels array|Google\Protobuf\Internal\MapField

Labels 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.

↳ create_time Google\Protobuf\Timestamp

Output only. Time at which the Rollout was created.

↳ approve_time Google\Protobuf\Timestamp

Output only. Time at which the Rollout was approved.

↳ enqueue_time Google\Protobuf\Timestamp

Output only. Time at which the Rollout was enqueued.

↳ deploy_start_time Google\Protobuf\Timestamp

Output only. Time at which the Rollout started deploying.

↳ deploy_end_time Google\Protobuf\Timestamp

Output only. Time at which the Rollout finished deploying.

↳ target_id string

Required. The ID of Target to which this Rollout is deploying.

↳ approval_state int

Output only. Approval state of the Rollout.

↳ state int

Output only. Current state of the Rollout.

↳ failure_reason string

Output only. Additional information about the rollout failure, if available.

↳ deploying_build string

Output 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}.

↳ etag string

This 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.

↳ deploy_failure_cause int

Output only. The reason this rollout failed. This will always be unspecified while the rollout is in progress.

↳ phases array<Google\Cloud\Deploy\V1\Phase>

Output only. The phases that represent the workflows of this Rollout.

↳ metadata Google\Cloud\Deploy\V1\Metadata

Output only. Metadata contains information about the rollout.

↳ controller_rollout string

Output only. Name of the ControllerRollout. Format is projects/{project}/ locations/{location}/deliveryPipelines/{deliveryPipeline}/ releases/{release}/rollouts/[a-z][a-z0-9-]{0,62}.

getName

Optional. Name of the Rollout. Format is projects/{project}/ locations/{location}/deliveryPipelines/{deliveryPipeline}/ releases/{release}/rollouts/[a-z][a-z0-9-]{0,62}.

Returns
TypeDescription
string

setName

Optional. Name of the Rollout. Format is projects/{project}/ locations/{location}/deliveryPipelines/{deliveryPipeline}/ releases/{release}/rollouts/[a-z][a-z0-9-]{0,62}.

Parameter
NameDescription
var string
Returns
TypeDescription
$this

getUid

Output only. Unique identifier of the Rollout.

Returns
TypeDescription
string

setUid

Output only. Unique identifier of the Rollout.

Parameter
NameDescription
var string
Returns
TypeDescription
$this

getDescription

Description of the Rollout for user purposes. Max length is 255 characters.

Returns
TypeDescription
string

setDescription

Description of the Rollout for user purposes. Max length is 255 characters.

Parameter
NameDescription
var string
Returns
TypeDescription
$this

getAnnotations

User 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.

Returns
TypeDescription
Google\Protobuf\Internal\MapField

setAnnotations

User 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.

Parameter
NameDescription
var array|Google\Protobuf\Internal\MapField
Returns
TypeDescription
$this

getLabels

Labels 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.
Returns
TypeDescription
Google\Protobuf\Internal\MapField

setLabels

Labels 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.
Parameter
NameDescription
var array|Google\Protobuf\Internal\MapField
Returns
TypeDescription
$this

getCreateTime

Output only. Time at which the Rollout was created.

Returns
TypeDescription
Google\Protobuf\Timestamp|null

hasCreateTime

clearCreateTime

setCreateTime

Output only. Time at which the Rollout was created.

Parameter
NameDescription
var Google\Protobuf\Timestamp
Returns
TypeDescription
$this

getApproveTime

Output only. Time at which the Rollout was approved.

Returns
TypeDescription
Google\Protobuf\Timestamp|null

hasApproveTime

clearApproveTime

setApproveTime

Output only. Time at which the Rollout was approved.

Parameter
NameDescription
var Google\Protobuf\Timestamp
Returns
TypeDescription
$this

getEnqueueTime

Output only. Time at which the Rollout was enqueued.

Returns
TypeDescription
Google\Protobuf\Timestamp|null

hasEnqueueTime

clearEnqueueTime

setEnqueueTime

Output only. Time at which the Rollout was enqueued.

Parameter
NameDescription
var Google\Protobuf\Timestamp
Returns
TypeDescription
$this

getDeployStartTime

Output only. Time at which the Rollout started deploying.

Returns
TypeDescription
Google\Protobuf\Timestamp|null

hasDeployStartTime

clearDeployStartTime

setDeployStartTime

Output only. Time at which the Rollout started deploying.

Parameter
NameDescription
var Google\Protobuf\Timestamp
Returns
TypeDescription
$this

getDeployEndTime

Output only. Time at which the Rollout finished deploying.

Returns
TypeDescription
Google\Protobuf\Timestamp|null

hasDeployEndTime

clearDeployEndTime

setDeployEndTime

Output only. Time at which the Rollout finished deploying.

Parameter
NameDescription
var Google\Protobuf\Timestamp
Returns
TypeDescription
$this

getTargetId

Required. The ID of Target to which this Rollout is deploying.

Returns
TypeDescription
string

setTargetId

Required. The ID of Target to which this Rollout is deploying.

Parameter
NameDescription
var string
Returns
TypeDescription
$this

getApprovalState

Output only. Approval state of the Rollout.

Returns
TypeDescription
int

setApprovalState

Output only. Approval state of the Rollout.

Parameter
NameDescription
var int
Returns
TypeDescription
$this

getState

Output only. Current state of the Rollout.

Returns
TypeDescription
int

setState

Output only. Current state of the Rollout.

Parameter
NameDescription
var int
Returns
TypeDescription
$this

getFailureReason

Output only. Additional information about the rollout failure, if available.

Returns
TypeDescription
string

setFailureReason

Output only. Additional information about the rollout failure, if available.

Parameter
NameDescription
var string
Returns
TypeDescription
$this

getDeployingBuild

Output 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}.

Returns
TypeDescription
string

setDeployingBuild

Output 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}.

Parameter
NameDescription
var string
Returns
TypeDescription
$this

getEtag

This 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.

Returns
TypeDescription
string

setEtag

This 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.

Parameter
NameDescription
var string
Returns
TypeDescription
$this

getDeployFailureCause

Output only. The reason this rollout failed. This will always be unspecified while the rollout is in progress.

Returns
TypeDescription
int

setDeployFailureCause

Output only. The reason this rollout failed. This will always be unspecified while the rollout is in progress.

Parameter
NameDescription
var int
Returns
TypeDescription
$this

getPhases

Output only. The phases that represent the workflows of this Rollout.

Returns
TypeDescription
Google\Protobuf\Internal\RepeatedField

setPhases

Output only. The phases that represent the workflows of this Rollout.

Parameter
NameDescription
var array<Google\Cloud\Deploy\V1\Phase>
Returns
TypeDescription
$this

getMetadata

Output only. Metadata contains information about the rollout.

Returns
TypeDescription
Google\Cloud\Deploy\V1\Metadata|null

hasMetadata

clearMetadata

setMetadata

Output only. Metadata contains information about the rollout.

Parameter
NameDescription
var Google\Cloud\Deploy\V1\Metadata
Returns
TypeDescription
$this

getControllerRollout

Output only. Name of the ControllerRollout. Format is projects/{project}/ locations/{location}/deliveryPipelines/{deliveryPipeline}/ releases/{release}/rollouts/[a-z][a-z0-9-]{0,62}.

Returns
TypeDescription
string

setControllerRollout

Output only. Name of the ControllerRollout. Format is projects/{project}/ locations/{location}/deliveryPipelines/{deliveryPipeline}/ releases/{release}/rollouts/[a-z][a-z0-9-]{0,62}.

Parameter
NameDescription
var string
Returns
TypeDescription
$this