Version

  • A version resource has a unique identifier, a state, a creator, and an update timestamp.

  • The versionState object represents the current state of the version, including an enum indicating the specific state and a user-friendly message.

  • The State enum defines the possible states a version can be in, such as creation in progress, created, approved, or denied.

Definition of version resource.

JSON representation 
{
  "name": string,
  "versionState": {
    object (VersionState)
  },
  "creator": string,
  "updateTime": string
}
Fields
name

string

The unique identifier of the version in the following format. projects/{project}/versions/{version}.
versionState

object (VersionState)

The current state of the version.
creator

string

Email of the user who created this version.
updateTime

string (Timestamp format)

Timestamp of the last change to this version.

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

VersionState

Represents the current state of the version.

JSON representation 
{
  "state": enum (State),
  "message": string
}
Fields
state

enum (State)

The current state of the version.
message

string

User-friendly message for the current state of the version.

State

Enum indicating the states that a Version can take. This enum is not yet frozen and values maybe added later.

Enums
STATE_UNSPECIFIED Default value of State.
CREATION_IN_PROGRESS The version creation is in progress.
CREATION_FAILED The version creation failed.
CREATED The version has been successfully created.
REVIEW_IN_PROGRESS The version is under policy review (aka Approval).
APPROVED The version has been approved for policy review and can be deployed.
CONDITIONALLY_APPROVED The version has been conditionally approved but is pending final review. It may be rolled back if final review is denied.
DENIED The version has been denied for policy review.
UNDER_TAKEDOWN The version is taken down as entire agent and all versions are taken down.
DELETED The version has been deleted.