REST Resource: projects.locations.instances

Resource: Instance

Message describing Instance object

JSON representation
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "labels": {
    string: string,
    ...
  },
  "state": enum (State),
  "region": string,
  "productActivation": {
    string: enum (ActivationState),
    ...
  },
  "licenseVersionId": string,
  "computeInstance": string,
  "externalInstance": string,
  "type": enum (Type)
}
Fields
name

string

Identifier. name of resource

createTime

string (Timestamp format)

Output only. [Output only] Create time stamp

Uses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".

updateTime

string (Timestamp format)

Output only. [Output only] Update time stamp

Uses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".

labels

map (key: string, value: string)

Optional. Labels as key value pairs

An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

state

enum (State)

Output only. The state of the VM.

region

string

Output only. The location of the VM.

productActivation

map (key: string, value: enum (ActivationState))

Output only. Map with Product_Name and Activation State of the VM.

An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

licenseVersionId

string

Output only. license version id.

computeInstance
(deprecated)

string

Required. Compute Instance resource name, i.e. projects/{project}/zones/{zone}/instances/{instance}. Deprecated. Use externalInstance instead.

externalInstance

string

Required. External instance resource name.

type

enum (Type)

Required. The type of the external instance.

State

VM status enum.

Enums
STATE_UNSPECIFIED The Status of the VM is unspecified.
PROVISIONING Resources are being allocated for the instance.
STAGING All required resources have been allocated and the instance is being started.
RUNNING The instance is running.
STOPPING The instance is currently stopping (either being deleted or terminated).
STOPPED The instance has stopped due to various reasons (user request, VM preemption, project freezing, etc.).
TERMINATED The instance has failed in some way.
REPAIRING The instance is in repair.

ActivationState

State of the License Key activation on the instance.

Enums
ACTIVATION_STATE_UNSPECIFIED The Status of the activation is unspecified
ACTIVATION_STATE_KEY_REQUESTED Activation key (MAK) requested for the instance.
ACTIVATION_STATE_ACTIVATING License activation process is running on the instance.
ACTIVATION_STATE_ACTIVATED License activation is complete on the instance.
ACTIVATION_STATE_DEACTIVATING License Key is deactivating on the instance.
ACTIVATION_STATE_DEACTIVATED License Key is deactivated on the instance.
ACTIVATION_STATE_TERMINATED License Key activation failed on the instance.

Type

External instance type.

Enums
TYPE_UNSPECIFIED The type of the external instance is unspecified.
TYPE_GCE The external instance is a Compute Engine instance.
TYPE_GCVE The external instance is a GCVE instance.

Methods

get

Gets details of a single Instance.

list

Lists Instances in a given project and location.