REST Resource: projects.locations.volumes.snapshots

Resource: Snapshot

Snapshot is a point-in-time version of a Volume's content.

JSON representation
{
  "name": string,
  "state": enum (State),
  "stateDetails": string,
  "description": string,
  "usedBytes": number,
  "createTime": string,
  "labels": {
    string: string,
    ...
  }
}
Fields
name

string

Identifier. The resource name of the snapshot. Format: projects/{projectId}/locations/{location}/volumes/{volumeId}/snapshots/{snapshotId}.

state

enum (State)

Output only. The snapshot state.

stateDetails

string

Output only. State details of the storage pool

description

string

A description of the snapshot with 2048 characters or less. Requests with longer descriptions will be rejected.

usedBytes

number

Output only. Current storage usage for the snapshot in bytes.

createTime

string (Timestamp format)

Output only. The time when the snapshot 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".

labels

map (key: string, value: string)

Resource labels to represent user provided metadata.

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

State

The Snapshot States

Enums
STATE_UNSPECIFIED Unspecified Snapshot State
READY Snapshot State is Ready
CREATING Snapshot State is Creating
DELETING Snapshot State is Deleting
UPDATING Snapshot State is Updating
DISABLED Snapshot State is Disabled
ERROR Snapshot State is Error

Methods

create

Create a new snapshot for a volume.

delete

Deletes a snapshot.

get

Describe a snapshot for a volume.

list

Returns descriptions of all snapshots for a volume.

patch

Updates the settings of a specific snapshot.