Reference documentation and code samples for the Google Cloud Gke Backup V1 Client class BackupPlan.
Defines the configuration and scheduling for a "line" of Backups.
Generated from protobuf message google.cloud.gkebackup.v1.BackupPlan
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 BackupPlan resource. Format: projects/*/locations/*/backupPlans/*
↳ uid
↳ create_time
↳ update_time
Google\Protobuf\Timestamp
Output only. The timestamp when this BackupPlan resource was last updated.
↳ description
string
Optional. User specified descriptive string for this BackupPlan.
↳ cluster
string
Required. Immutable. The source cluster from which Backups will be created via this BackupPlan. Valid formats: - projects/*/locations/*/clusters/*
- projects/*/zones/*/clusters/*
↳ retention_policy
BackupPlan\RetentionPolicy
Optional. RetentionPolicy governs lifecycle of Backups created under this plan.
↳ labels
↳ backup_schedule
↳ etag
string
Output only. etag
is used for optimistic concurrency control as a way to help prevent simultaneous updates of a backup plan from overwriting each other. It is strongly suggested that systems make use of the 'etag' in the read-modify-write cycle to perform BackupPlan updates in order to avoid race conditions: An etag
is returned in the response to GetBackupPlan
, and systems are expected to put that etag in the request to UpdateBackupPlan
or DeleteBackupPlan
to ensure that their change will be applied to the same version of the resource.
↳ deactivated
bool
Optional. This flag indicates whether this BackupPlan has been deactivated. Setting this field to True locks the BackupPlan such that no further updates will be allowed (except deletes), including the deactivated field itself. It also prevents any new Backups from being created via this BackupPlan (including scheduled Backups). Default: False
↳ backup_config
↳ protected_pod_count
int
Output only. The number of Kubernetes Pods backed up in the last successful Backup created via this BackupPlan.
↳ state
int
Output only. State of the BackupPlan. This State field reflects the various stages a BackupPlan can be in during the Create operation. It will be set to "DEACTIVATED" if the BackupPlan is deactivated on an Update
↳ state_reason
string
Output only. Human-readable description of why BackupPlan is in the 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.
↳ rpo_risk_level
int
Output only. A number that represents the current risk level of this BackupPlan from RPO perspective with 1 being no risk and 5 being highest risk.
↳ rpo_risk_reason
string
Output only. Human-readable description of why the BackupPlan is in the current rpo_risk_level and action items if any.
↳ backup_channel
string
Output only. The fully qualified name of the BackupChannel to be used to create a backup. This field is set only if the cluster being backed up is in a different project. projects/*/locations/*/backupChannels/*
↳ last_successful_backup_time
Google\Protobuf\Timestamp
Output only. Completion time of the last successful Backup. This is sourced from a successful Backup's complete_time field. This field is added to maintain consistency with BackupPlanBinding to display last successful backup time.
getName
Output only. The full name of the BackupPlan resource.
Format: projects/*/locations/*/backupPlans/*
string
setName
Output only. The full name of the BackupPlan resource.
Format: projects/*/locations/*/backupPlans/*
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 BackupPlan resource was created.
hasCreateTime
clearCreateTime
setCreateTime
Output only. The timestamp when this BackupPlan resource was created.
$this
getUpdateTime
Output only. The timestamp when this BackupPlan resource was last updated.
hasUpdateTime
clearUpdateTime
setUpdateTime
Output only. The timestamp when this BackupPlan resource was last updated.
$this
getDescription
Optional. User specified descriptive string for this BackupPlan.
string
setDescription
Optional. User specified descriptive string for this BackupPlan.
var
string
$this
getCluster
Required. Immutable. The source cluster from which Backups will be created via this BackupPlan. Valid formats:
-
projects/*/locations/*/clusters/*
-
projects/*/zones/*/clusters/*
string
setCluster
Required. Immutable. The source cluster from which Backups will be created via this BackupPlan. Valid formats:
-
projects/*/locations/*/clusters/*
-
projects/*/zones/*/clusters/*
var
string
$this
getRetentionPolicy
Optional. RetentionPolicy governs lifecycle of Backups created under this plan.
hasRetentionPolicy
clearRetentionPolicy
setRetentionPolicy
Optional. RetentionPolicy governs lifecycle of Backups created under this plan.
$this
getLabels
Optional. A set of custom labels supplied by user.
setLabels
Optional. A set of custom labels supplied by user.
$this
getBackupSchedule
Optional. Defines a schedule for automatic Backup creation via this BackupPlan.
hasBackupSchedule
clearBackupSchedule
setBackupSchedule
Optional. Defines a schedule for automatic Backup creation via this BackupPlan.
$this
getEtag
Output only. etag
is used for optimistic concurrency control as a way to
help prevent simultaneous updates of a backup plan from overwriting each
other. It is strongly suggested that systems make use of the 'etag' in the
read-modify-write cycle to perform BackupPlan updates in order to avoid
race conditions: An etag
is returned in the response to GetBackupPlan
,
and systems are expected to put that etag in the request to UpdateBackupPlan
or DeleteBackupPlan
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 backup plan from overwriting each
other. It is strongly suggested that systems make use of the 'etag' in the
read-modify-write cycle to perform BackupPlan updates in order to avoid
race conditions: An etag
is returned in the response to GetBackupPlan
,
and systems are expected to put that etag in the request to UpdateBackupPlan
or DeleteBackupPlan
to ensure that their change
will be applied to the same version of the resource.
var
string
$this
getDeactivated
Optional. This flag indicates whether this BackupPlan has been deactivated.
Setting this field to True locks the BackupPlan such that no further updates will be allowed (except deletes), including the deactivated field itself. It also prevents any new Backups from being created via this BackupPlan (including scheduled Backups). Default: False
bool
setDeactivated
Optional. This flag indicates whether this BackupPlan has been deactivated.
Setting this field to True locks the BackupPlan such that no further updates will be allowed (except deletes), including the deactivated field itself. It also prevents any new Backups from being created via this BackupPlan (including scheduled Backups). Default: False
var
bool
$this
getBackupConfig
Optional. Defines the configuration of Backups created via this BackupPlan.
hasBackupConfig
clearBackupConfig
setBackupConfig
Optional. Defines the configuration of Backups created via this BackupPlan.
$this
getProtectedPodCount
Output only. The number of Kubernetes Pods backed up in the last successful Backup created via this BackupPlan.
int
setProtectedPodCount
Output only. The number of Kubernetes Pods backed up in the last successful Backup created via this BackupPlan.
var
int
$this
getState
Output only. State of the BackupPlan. This State field reflects the various stages a BackupPlan can be in during the Create operation. It will be set to "DEACTIVATED" if the BackupPlan is deactivated on an Update
int
setState
Output only. State of the BackupPlan. This State field reflects the various stages a BackupPlan can be in during the Create operation. It will be set to "DEACTIVATED" if the BackupPlan is deactivated on an Update
var
int
$this
getStateReason
Output only. Human-readable description of why BackupPlan is in the 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 BackupPlan is in the 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
getRpoRiskLevel
Output only. A number that represents the current risk level of this BackupPlan from RPO perspective with 1 being no risk and 5 being highest risk.
int
setRpoRiskLevel
Output only. A number that represents the current risk level of this BackupPlan from RPO perspective with 1 being no risk and 5 being highest risk.
var
int
$this
getRpoRiskReason
Output only. Human-readable description of why the BackupPlan is in the current rpo_risk_level and action items if any.
string
setRpoRiskReason
Output only. Human-readable description of why the BackupPlan is in the current rpo_risk_level and action items if any.
var
string
$this
getBackupChannel
Output only. The fully qualified name of the BackupChannel to be used to create a backup. This field is set only if the cluster being backed up is in a different project.
projects/*/locations/*/backupChannels/*
string
setBackupChannel
Output only. The fully qualified name of the BackupChannel to be used to create a backup. This field is set only if the cluster being backed up is in a different project.
projects/*/locations/*/backupChannels/*
var
string
$this
getLastSuccessfulBackupTime
Output only. Completion time of the last successful Backup. This is sourced from a successful Backup's complete_time field. This field is added to maintain consistency with BackupPlanBinding to display last successful backup time.
hasLastSuccessfulBackupTime
clearLastSuccessfulBackupTime
setLastSuccessfulBackupTime
Output only. Completion time of the last successful Backup. This is sourced from a successful Backup's complete_time field. This field is added to maintain consistency with BackupPlanBinding to display last successful backup time.
$this