REST Resource: projects.locations.instances

Resource: Instance

Instance is a container for the rest of API resources. Only resourcse in the same instance can interact with each other. Child resources inherit the location (data residency) and encryption (CMEK). The location of the provided input and output in requests must match the location of the instance.

JSON representation
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "state": enum (State),
  "labels": {
    string: string,
    ...
  },
  "kmsKey": string
}
Fields
name

string

Output only. The full path to the Instance resource in this API. format: "projects/{project}/locations/{location}/instances/{instance}"

createTime

string (Timestamp format)

Output only. Timestamp when the Instance was created. Assigned by the server.

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. Timestamp when the Instance was last updated. Assigned by the server.

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

state

enum (State)

Output only. State of the instance. Assigned by the server.

labels

map (key: string, value: string)

Labels

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

kmsKey

string

Required. The KMS key name used for CMEK (encryption-at-rest). format: "projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{cryptoKey}" VPC-SC restrictions apply.

State

The Resource State

Enums
STATE_UNSPECIFIED State is unspecified, should not occur.
CREATING The resource has not finished being created.
ACTIVE The resource is active/ready to be used.
UPDATING The resource is in the process of being updated.
DELETING The resource is in the process of being deleted.

Methods

create

Creates an instance.

delete

Deletes an instance.

exportRegisteredParties

Exports the list of registered parties.

get

Gets an instance.

importRegisteredParties

Imports the list of registered parties.

list

Lists instances.

patch

Updates the parameters of a single Instance.