REST Resource: projects.locations.deployments.revisions

Resource: Revision

A child resource of a Deployment generated by a 'CreateDeployment' or 'UpdateDeployment' call. Each Revision contains metadata pertaining to a snapshot of a particular Deployment.

JSON representation 
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "action": enum (Action),
  "state": enum (State),
  "applyResults": {
    object (ApplyResults)
  },
  "stateDetail": string,
  "errorCode": enum (ErrorCode),
  "build": string,
  "logs": string,
  "tfErrors": [
    {
      object (TerraformError)
    }
  ],
  "errorLogs": string,
  "serviceAccount": string,
  "importExistingResources": boolean,
  "workerPool": string,
  "tfVersionConstraint": string,
  "tfVersion": string,
  "quotaValidationResults": string,
  "quotaValidation": enum (QuotaValidation),

  // Union field blueprint can be only one of the following:
  "terraformBlueprint": {
    object (TerraformBlueprint)
  }
  // End of list of possible types for union field blueprint.
}
Fields
name

string

Revision name. Format: projects/{project}/locations/{location}/deployments/{deployment}/ revisions/{revision}
createTime

string (Timestamp format)

Output only. Time when the revision 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. Time when the revision was last modified.

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".
action

enum (Action)

Output only. The action which created this revision
state

enum (State)

Output only. Current state of the revision.
applyResults

object (ApplyResults)

Output only. Outputs and artifacts from applying a deployment.
stateDetail

string

Output only. Additional info regarding the current state.
errorCode

enum (ErrorCode)

Output only. Code describing any errors that may have occurred.
build

string

Output only. Cloud Build instance UUID associated with this revision.
logs

string

Output only. Location of Revision operation logs in gs://{bucket}/{object} format.
tfErrors[]

object (TerraformError)

Output only. Errors encountered when creating or updating this deployment. Errors are truncated to 10 entries, see deleteResults and errorLogs for full details.
errorLogs

string

Output only. Location of Terraform error logs in Google Cloud Storage. Format: gs://{bucket}/{object}.
serviceAccount

string

Output only. User-specified Service Account (SA) to be used as credential to manage resources. Format: projects/{projectID}/serviceAccounts/{serviceAccount}
importExistingResources

boolean

Output only. By default, Infra Manager will return a failure when Terraform encounters a 409 code (resource conflict error) during actuation. If this flag is set to true, Infra Manager will instead attempt to automatically import the resource into the Terraform state (for supported resource types) and continue actuation.

Not all resource types are supported, refer to documentation.
workerPool

string

Output only. The user-specified Cloud Build worker pool resource in which the Cloud Build job will execute. Format: projects/{project}/locations/{location}/workerPools/{workerPoolId}. If this field is unspecified, the default Cloud Build worker pool will be used.
tfVersionConstraint

string

Output only. The user-specified Terraform version constraint. Example: "=1.3.10".
tfVersion

string

Output only. The version of Terraform used to create the Revision. It is in the format of "Major.Minor.Patch", for example, "1.3.10".
quotaValidationResults

string

Output only. Cloud Storage path containing quota validation results. This field is set when a user sets Deployment.quota_validation field to ENABLED or ENFORCED. Format: gs://{bucket}/{object}.
quotaValidation

enum (QuotaValidation)

Optional. Input to control quota checks for resources in terraform configuration files. There are limited resources on which quota validation applies.
Union field blueprint. Blueprint that was deployed. blueprint can be only one of the following:
terraformBlueprint

object (TerraformBlueprint)

Output only. A blueprint described using Terraform's HashiCorp Configuration Language as a root module.

Action

Actions that generate a revision.

Enums
ACTION_UNSPECIFIED The default value. This value is used if the action is omitted.
CREATE The revision was generated by creating a deployment.
UPDATE The revision was generated by updating a deployment.
DELETE The revision was deleted.

State

Possible states of a revision.

Enums
STATE_UNSPECIFIED The default value. This value is used if the state is omitted.
APPLYING The revision is being applied.
APPLIED The revision was applied successfully.
FAILED The revision could not be applied successfully.

ErrorCode

Possible errors if Revision could not be created or updated successfully.

Enums
ERROR_CODE_UNSPECIFIED No error code was specified.
CLOUD_BUILD_PERMISSION_DENIED Cloud Build failed due to a permission issue.
APPLY_BUILD_API_FAILED Cloud Build job associated with creating or updating a deployment could not be started.
APPLY_BUILD_RUN_FAILED Cloud Build job associated with creating or updating a deployment was started but failed.
QUOTA_VALIDATION_FAILED quota validation failed for one or more resources in terraform configuration files.

Methods

exportState

 Exports Terraform state file from a given revision.

get

 Gets details about a Revision.

list

 Lists Revisions of a deployment.