Reference documentation and code samples for the Google Cloud Gke Backup V1 Client class Restore.
Represents both a request to Restore some portion of a Backup into a target GKE cluster and a record of the restore operation itself.
Generated from protobuf message google.cloud.gkebackup.v1.Restore
Namespace
Google \ Cloud \ GkeBackup \ V1Methods
__construct
Constructor.
data
array
Optional. Data for populating the Message object.
↳ name
string
Output only. The full name of the Restore resource. Format: projects/*/locations/*/restorePlans/*/restores/*
↳ uid
↳ create_time
↳ update_time
↳ description
string
Optional. User specified descriptive string for this Restore.
↳ backup
string
Required. Immutable. A reference to the Backup
used as the source from which this Restore will restore. Note that this Backup must be a sub-resource of the RestorePlan's backup_plan
. Format: projects/*/locations/*/backupPlans/*/backups/*
.
↳ cluster
string
Output only. The target cluster into which this Restore will restore data. Valid formats: - projects/*/locations/*/clusters/*
- projects/*/zones/*/clusters/*
Inherited from parent RestorePlan's cluster
value.
↳ restore_config
RestoreConfig
Output only. Configuration of the Restore. Inherited from parent RestorePlan's restore_config .
↳ labels
↳ state
int
Output only. The current state of the Restore.
↳ state_reason
string
Output only. Human-readable description of why the Restore is in its current state. This field is only meant for human readability and should not be used programmatically as this field is not guaranteed to be consistent.
↳ complete_time
↳ resources_restored_count
int
Output only. Number of resources restored during the restore execution.
↳ resources_excluded_count
int
Output only. Number of resources excluded during the restore execution.
↳ resources_failed_count
int
Output only. Number of resources that failed to be restored during the restore execution.
↳ volumes_restored_count
int
Output only. Number of volumes restored during the restore execution.
↳ 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 GetRestore
, and systems are expected to put that etag in the request to UpdateRestore
or DeleteRestore
to ensure that their change will be applied to the same version of the resource.
↳ filter
Restore\Filter
Optional. Immutable. Filters resources for Restore
. If not specified, the scope of the restore will remain the same as defined in the RestorePlan
. If this is specified and no resources are matched by the inclusion_filters
or everything is excluded by the exclusion_filters
, nothing will be restored. This filter can only be specified if the value of namespaced_resource_restore_mode
is set to MERGE_SKIP_ON_CONFLICT
, MERGE_REPLACE_VOLUME_ON_CONFLICT
or MERGE_REPLACE_ON_CONFLICT
.
↳ volume_data_restore_policy_overrides
array< VolumeDataRestorePolicyOverride
>
Optional. Immutable. Overrides the volume data restore policies selected in the Restore Config for override-scoped resources.
getName
Output only. The full name of the Restore resource.
Format: projects/*/locations/*/restorePlans/*/restores/*
string
setName
Output only. The full name of the Restore resource.
Format: projects/*/locations/*/restorePlans/*/restores/*
var
string
$this
getUid
Output only. Server generated global unique identifier of UUID format.
string
setUid
Output only. Server generated global unique identifier of UUID format.
var
string
$this
getCreateTime
Output only. The timestamp when this Restore resource was created.
hasCreateTime
clearCreateTime
setCreateTime
Output only. The timestamp when this Restore resource was created.
$this
getUpdateTime
Output only. The timestamp when this Restore resource was last updated.
hasUpdateTime
clearUpdateTime
setUpdateTime
Output only. The timestamp when this Restore resource was last updated.
$this
getDescription
Optional. User specified descriptive string for this Restore.
string
setDescription
Optional. User specified descriptive string for this Restore.
var
string
$this
getBackup
Required. Immutable. A reference to the Backup
used as the source from which
this Restore will restore. Note that this Backup must be a sub-resource of
the RestorePlan's backup_plan
. Format: projects/*/locations/*/backupPlans/*/backups/*
.
string
setBackup
Required. Immutable. A reference to the Backup
used as the source from which
this Restore will restore. Note that this Backup must be a sub-resource of
the RestorePlan's backup_plan
. Format: projects/*/locations/*/backupPlans/*/backups/*
.
var
string
$this
getCluster
Output only. The target cluster into which this Restore will restore data.
Valid formats:
-
projects/*/locations/*/clusters/*
-
projects/*/zones/*/clusters/*
Inherited from parent RestorePlan's cluster value.
string
setCluster
Output only. The target cluster into which this Restore will restore data.
Valid formats:
-
projects/*/locations/*/clusters/*
-
projects/*/zones/*/clusters/*
Inherited from parent RestorePlan's cluster value.
var
string
$this
getRestoreConfig
Output only. Configuration of the Restore. Inherited from parent RestorePlan's restore_config .
hasRestoreConfig
clearRestoreConfig
setRestoreConfig
Output only. Configuration of the Restore. Inherited from parent RestorePlan's restore_config .
$this
getLabels
A set of custom labels supplied by user.
setLabels
A set of custom labels supplied by user.
$this
getState
Output only. The current state of the Restore.
int
setState
Output only. The current state of the Restore.
var
int
$this
getStateReason
Output only. Human-readable description of why the Restore is in its current state. This field is only meant for human readability and should not be used programmatically as this field is not guaranteed to be consistent.
string
setStateReason
Output only. Human-readable description of why the Restore is in its current state. This field is only meant for human readability and should not be used programmatically as this field is not guaranteed to be consistent.
var
string
$this
getCompleteTime
Output only. Timestamp of when the restore operation completed.
hasCompleteTime
clearCompleteTime
setCompleteTime
Output only. Timestamp of when the restore operation completed.
$this
getResourcesRestoredCount
Output only. Number of resources restored during the restore execution.
int
setResourcesRestoredCount
Output only. Number of resources restored during the restore execution.
var
int
$this
getResourcesExcludedCount
Output only. Number of resources excluded during the restore execution.
int
setResourcesExcludedCount
Output only. Number of resources excluded during the restore execution.
var
int
$this
getResourcesFailedCount
Output only. Number of resources that failed to be restored during the restore execution.
int
setResourcesFailedCount
Output only. Number of resources that failed to be restored during the restore execution.
var
int
$this
getVolumesRestoredCount
Output only. Number of volumes restored during the restore execution.
int
setVolumesRestoredCount
Output only. Number of volumes restored during the restore execution.
var
int
$this
getEtag
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 GetRestore
,
and systems are expected to put that etag in the request to UpdateRestore
or DeleteRestore
to ensure that their change will be
applied to the same version of the resource.
string
setEtag
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 GetRestore
,
and systems are expected to put that etag in the request to UpdateRestore
or DeleteRestore
to ensure that their change will be
applied to the same version of the resource.
var
string
$this
getFilter
Optional. Immutable. Filters resources for Restore
. If not specified, the
scope of the restore will remain the same as defined in the RestorePlan
.
If this is specified and no resources are matched by the inclusion_filters
or everything is excluded by the exclusion_filters
,
nothing will be restored. This filter can only be specified if the value of namespaced_resource_restore_mode
is set to MERGE_SKIP_ON_CONFLICT
, MERGE_REPLACE_VOLUME_ON_CONFLICT
or MERGE_REPLACE_ON_CONFLICT
.
hasFilter
clearFilter
setFilter
Optional. Immutable. Filters resources for Restore
. If not specified, the
scope of the restore will remain the same as defined in the RestorePlan
.
If this is specified and no resources are matched by the inclusion_filters
or everything is excluded by the exclusion_filters
,
nothing will be restored. This filter can only be specified if the value of namespaced_resource_restore_mode
is set to MERGE_SKIP_ON_CONFLICT
, MERGE_REPLACE_VOLUME_ON_CONFLICT
or MERGE_REPLACE_ON_CONFLICT
.
$this
getVolumeDataRestorePolicyOverrides
Optional. Immutable. Overrides the volume data restore policies selected in the Restore Config for override-scoped resources.
setVolumeDataRestorePolicyOverrides
Optional. Immutable. Overrides the volume data restore policies selected in the Restore Config for override-scoped resources.
$this