REST Resource: projects.locations.backups

Stay organized with collections Save and categorize content based on your preferences.

Resource: Backup

Message describing Backup object NEXT ID: 18

JSON representation
{
  "name": string,
  "displayName": string,
  "uid": string,
  "createTime": string,
  "updateTime": string,
  "deleteTime": string,
  "labels": {
    string: string,
    ...
  },
  "state": enum (State),
  "type": enum (Type),
  "description": string,
  "clusterName": string,
  "reconciling": boolean,
  "encryptionConfig": {
    object (EncryptionConfig)
  },
  "encryptionInfo": {
    object (EncryptionInfo)
  },
  "etag": string,
  "annotations": {
    string: string,
    ...
  },
  "sizeBytes": string
}
Fields
name

string

Output only. The name of the backup resource with the format: * projects/{project}/locations/{region}/backups/{backupId} where the cluster and backup ID segments should satisfy the regex expression "a-z?", e.g. 1-63 characters of lowercase letters, numbers, and dashes, starting with a letter, and ending with a letter or number. For more details see https://google.aip.dev/122. The prefix of the backup resource name is the name of the parent resource: * projects/{project}/locations/{region}

displayName

string

User-settable and human-readable display name for the Backup.

uid

string

Output only. The system-generated UID of the resource. The UID is assigned when the resource is created, and it is retained until it is deleted.

createTime

string (Timestamp format)

Output only. Create time stamp

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. Update time stamp

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

deleteTime

string (Timestamp format)

Output only. Delete time stamp

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)

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 current state of the backup.

type

enum (Type)

The backup type, which suggests the trigger for the backup.

description

string

User-provided description of the backup.

clusterName

string

Required. The full resource name of the backup source cluster (e.g., projects//locations//clusters/).

reconciling

boolean

Output only. Reconciling (https://google.aip.dev/128#reconciliation), if true, indicates that the service is actively updating the resource. This can happen due to user-triggered updates or system actions like failover or maintenance.

encryptionConfig

object (EncryptionConfig)

Optional. The encryption config can be specified to encrypt the backup with a customer-managed encryption key (CMEK). When this field is not specified, the backup will then use default encryption scheme to protect the user data.

encryptionInfo

object (EncryptionInfo)

Output only. The encryption information for the backup.

etag

string

For Resource freshness validation (https://google.aip.dev/154)

annotations

map (key: string, value: string)

Annotations to allow client tools to store small amount of arbitrary data. This is distinct from labels. https://google.aip.dev/128

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

sizeBytes

string (int64 format)

Output only. The size of the backup in bytes.

State

Backup State

Enums
STATE_UNSPECIFIED The state of the backup is unknown.
READY The backup is ready.
CREATING The backup is creating.
FAILED The backup failed.
DELETING The backup is being deleted.

Type

Backup Type

Enums
TYPE_UNSPECIFIED Backup Type is unknown.
ON_DEMAND ON_DEMAND backups that were triggered by the customer (e.g., not AUTOMATED).
AUTOMATED AUTOMATED backups triggered by the automated backups scheduler pursuant to an automated backup policy.

Methods

create

Creates a new Backup in a given project and location.

delete

Deletes a single Backup.

get

Gets details of a single Backup.

list

Lists Backups in a given project and location.

patch

Updates the parameters of a single Backup.