SnapshotSettings

JSON representation
{
  "storageLocation": {
    object (StorageLocationSettings)
  },
  "accessLocation": {
    object (AccessLocation)
  }
}
Fields
storageLocation

object (StorageLocationSettings)

Policy of which storage location is going to be resolved, and additional data that particularizes how the policy is going to be carried out.

accessLocation

object (AccessLocation)

(Regional snapshots use only)Policy of which location is allowed to access snapshot.

StorageLocationSettings

JSON representation
{
  "policy": enum (StorageLocationPolicy),
  "locations": {
    string: {
      object (StorageLocationPreference)
    },
    ...
  }
}
Fields
policy

enum (StorageLocationPolicy)

The chosen location policy.

locations

map (key: string, value: object (StorageLocationPreference))

When the policy is SPECIFIC_LOCATIONS, snapshots will be stored in the locations listed in this field. Keys are Cloud Storage bucket locations. Only one location can be specified.

StorageLocationPolicy

Enums
STORAGE_LOCATION_POLICY_UNSPECIFIED
NEAREST_MULTI_REGION Store snapshot in the nearest multi region Cloud Storage bucket, relative to the originating disk. No additional parameters are needed.
LOCAL_REGION Store snapshot in the same region as with the originating disk. No additional parameters are needed.
SPECIFIC_LOCATIONS Store snapshot in the specific locations, as specified by the user. The list of regions to store must be defined under the locations field.

StorageLocationPreference

A structure for specifying storage locations.

JSON representation
{
  "name": string
}
Fields
name

string

Name of the location. It should be one of the Cloud Storage buckets. Only one location can be specified.

AccessLocation

JSON representation
{
  "locations": {
    string: {
      object (AccessLocationPreference)
    },
    ...
  },
  "policy": enum (AccessLocationPolicy)
}
Fields
locations

map (key: string, value: object (AccessLocationPreference))

List of regions that can restore a regional snapshot from the current region

policy

enum (AccessLocationPolicy)

Policy of which location is allowed to access snapshot.

AccessLocationPreference

A structure for specifying an allowed target region.

JSON representation
{
  "region": string
}
Fields
region

string

Accessible region name

AccessLocationPolicy

Enums
POLICY_UNSPECIFIED
ALL_REGIONS Any regions will be able to access the source location.
SPECIFIC_REGIONS Only allowlisted regions will be able to restore region scoped snapshots