REST Resource: projects.locations.restorePlans

Resource: RestorePlan

The configuration of a potential series of Restore operations to be performed against Backups belong to a particular BackupPlan.

JSON representation
{
  "name": string,
  "uid": string,
  "createTime": string,
  "updateTime": string,
  "description": string,
  "backupPlan": string,
  "cluster": string,
  "restoreConfig": {
    object (RestoreConfig)
  },
  "labels": {
    string: string,
    ...
  },
  "etag": string,
  "state": enum (State),
  "stateReason": string
}
Fields
name

string

Output only. The full name of the RestorePlan resource. Format: projects/*/locations/*/restorePlans/*.

uid

string

Output only. Server generated global unique identifier of UUID format.

createTime

string (Timestamp format)

Output only. The timestamp when this RestorePlan resource 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".

updateTime

string (Timestamp format)

Output only. The timestamp when this RestorePlan resource was last updated.

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

description

string

Optional. User specified descriptive string for this RestorePlan.

backupPlan

string

Required. Immutable. A reference to the BackupPlan from which Backups may be used as the source for Restores created via this RestorePlan. Format: projects/*/locations/*/backupPlans/*.

cluster

string

Required. Immutable. The target cluster into which Restores created via this RestorePlan will restore data. NOTE: the cluster's region must be the same as the RestorePlan. Valid formats:

  • projects/*/locations/*/clusters/*
  • projects/*/zones/*/clusters/*
restoreConfig

object (RestoreConfig)

Required. Configuration of Restores created via this RestorePlan.

labels

map (key: string, value: string)

Optional. A set of custom labels supplied by user.

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

etag

string

Output only. etag is used for optimistic concurrency control as a way to help prevent simultaneous updates of a restore from overwriting each other. It is strongly suggested that systems make use of the etag in the read-modify-write cycle to perform restore updates in order to avoid race conditions: An etag is returned in the response to restorePlans.get, and systems are expected to put that etag in the request to restorePlans.patch or restorePlans.delete to ensure that their change will be applied to the same version of the resource.

state

enum (State)

Output only. State of the RestorePlan. This State field reflects the various stages a RestorePlan can be in during the Create operation.

stateReason

string

Output only. Human-readable description of why RestorePlan is in the current state

State

State

Enums
STATE_UNSPECIFIED Default first value for Enums.
CLUSTER_PENDING Waiting for cluster state to be RUNNING.
READY The RestorePlan has successfully been created and is ready for Restores.
FAILED RestorePlan creation has failed.
DELETING The RestorePlan is in the process of being deleted.

Methods

create

Creates a new RestorePlan in a given location.

delete

Deletes an existing RestorePlan.

get

Retrieve the details of a single RestorePlan.

getIamPolicy

Gets the access control policy for a resource.

list

Lists RestorePlans in a given location.

patch

Update a RestorePlan.

setIamPolicy

Sets the access control policy on the specified resource.

testIamPermissions

Returns permissions that a caller has on the specified resource.