Google Cloud Gke Backup V1 Client - Class BackupPlan (1.2.1)

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 \ V1

Methods

__construct

Constructor.

Parameters
Name
Description
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
string

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

↳ create_time
Google\Protobuf\Timestamp

Output only. The timestamp when this BackupPlan resource was created.

↳ 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
array| Google\Protobuf\Internal\MapField

Optional. A set of custom labels supplied by user.

↳ backup_schedule
BackupPlan\Schedule

Optional. Defines a schedule for automatic Backup creation via this BackupPlan.

↳ 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
BackupPlan\BackupConfig

Optional. Defines the configuration of Backups created via this BackupPlan.

↳ 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/*

Returns
Type
Description
string

setName

Output only. The full name of the BackupPlan resource.

Format: projects/*/locations/*/backupPlans/*

Parameter
Name
Description
var
string
Returns
Type
Description
$this

getUid

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

Returns
Type
Description
string

setUid

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

Parameter
Name
Description
var
string
Returns
Type
Description
$this

getCreateTime

Output only. The timestamp when this BackupPlan resource was created.

Returns
Type
Description

hasCreateTime

clearCreateTime

setCreateTime

Output only. The timestamp when this BackupPlan resource was created.

Parameter
Name
Description
Returns
Type
Description
$this

getUpdateTime

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

Returns
Type
Description

hasUpdateTime

clearUpdateTime

setUpdateTime

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

Parameter
Name
Description
Returns
Type
Description
$this

getDescription

Optional. User specified descriptive string for this BackupPlan.

Returns
Type
Description
string

setDescription

Optional. User specified descriptive string for this BackupPlan.

Parameter
Name
Description
var
string
Returns
Type
Description
$this

getCluster

Required. Immutable. The source cluster from which Backups will be created via this BackupPlan. Valid formats:

  • projects/*/locations/*/clusters/*
  • projects/*/zones/*/clusters/*
Returns
Type
Description
string

setCluster

Required. Immutable. The source cluster from which Backups will be created via this BackupPlan. Valid formats:

  • projects/*/locations/*/clusters/*
  • projects/*/zones/*/clusters/*
Parameter
Name
Description
var
string
Returns
Type
Description
$this

getRetentionPolicy

Optional. RetentionPolicy governs lifecycle of Backups created under this plan.

Returns
Type
Description

hasRetentionPolicy

clearRetentionPolicy

setRetentionPolicy

Optional. RetentionPolicy governs lifecycle of Backups created under this plan.

Parameter
Name
Description
Returns
Type
Description
$this

getLabels

Optional. A set of custom labels supplied by user.

Returns
Type
Description

setLabels

Optional. A set of custom labels supplied by user.

Parameter
Name
Description
Returns
Type
Description
$this

getBackupSchedule

Optional. Defines a schedule for automatic Backup creation via this BackupPlan.

Returns
Type
Description

hasBackupSchedule

clearBackupSchedule

setBackupSchedule

Optional. Defines a schedule for automatic Backup creation via this BackupPlan.

Parameter
Name
Description
Returns
Type
Description
$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.

Returns
Type
Description
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.

Parameter
Name
Description
var
string
Returns
Type
Description
$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

Returns
Type
Description
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

Parameter
Name
Description
var
bool
Returns
Type
Description
$this

getBackupConfig

Optional. Defines the configuration of Backups created via this BackupPlan.

Returns
Type
Description

hasBackupConfig

clearBackupConfig

setBackupConfig

Optional. Defines the configuration of Backups created via this BackupPlan.

Parameter
Name
Description
Returns
Type
Description
$this

getProtectedPodCount

Output only. The number of Kubernetes Pods backed up in the last successful Backup created via this BackupPlan.

Returns
Type
Description
int

setProtectedPodCount

Output only. The number of Kubernetes Pods backed up in the last successful Backup created via this BackupPlan.

Parameter
Name
Description
var
int
Returns
Type
Description
$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

Returns
Type
Description
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

Parameter
Name
Description
var
int
Returns
Type
Description
$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.

Returns
Type
Description
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.

Parameter
Name
Description
var
string
Returns
Type
Description
$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.

Returns
Type
Description
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.

Parameter
Name
Description
var
int
Returns
Type
Description
$this

getRpoRiskReason

Output only. Human-readable description of why the BackupPlan is in the current rpo_risk_level and action items if any.

Returns
Type
Description
string

setRpoRiskReason

Output only. Human-readable description of why the BackupPlan is in the current rpo_risk_level and action items if any.

Parameter
Name
Description
var
string
Returns
Type
Description
$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/*

Returns
Type
Description
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/*

Parameter
Name
Description
var
string
Returns
Type
Description
$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.

Returns
Type
Description

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.

Parameter
Name
Description
Returns
Type
Description
$this
Create a Mobile Website
View Site in Mobile | Classic
Share by: