Google Cloud AlloyDB for PostgreSQL V1 Client - Class Cluster (0.5.0)

Reference documentation and code samples for the Google Cloud AlloyDB for PostgreSQL V1 Client class Cluster.

A cluster is a collection of regional AlloyDB resources. It can include a primary instance and one or more read pool instances.

All cluster resources share a storage layer, which scales as needed.

Generated from protobuf message google.cloud.alloydb.v1.Cluster

Namespace

Google \ Cloud \ AlloyDb \ V1

Methods

__construct

Constructor.

Parameters
NameDescription
data array

Optional. Data for populating the Message object.

↳ backup_source Google\Cloud\AlloyDb\V1\BackupSource

Output only. Cluster created from backup.

↳ migration_source Google\Cloud\AlloyDb\V1\MigrationSource

Output only. Cluster created via DMS migration.

↳ name string

Output only. The name of the cluster resource with the format: * projects/{project}/locations/{region}/clusters/{cluster_id} where the cluster ID segment should satisfy the regex expression [a-z0-9-]+. For more details see https://google.aip.dev/122. The prefix of the cluster resource name is the name of the parent resource: * projects/{project}/locations/{region}

↳ display_name string

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

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

↳ create_time Google\Protobuf\Timestamp

Output only. Create time stamp

↳ update_time Google\Protobuf\Timestamp

Output only. Update time stamp

↳ delete_time Google\Protobuf\Timestamp

Output only. Delete time stamp

↳ labels array|Google\Protobuf\Internal\MapField

Labels as key value pairs

↳ state int

Output only. The current serving state of the cluster.

↳ cluster_type int

Output only. The type of the cluster. This is an output-only field and it's populated at the Cluster creation time or the Cluster promotion time. The cluster type is determined by which RPC was used to create the cluster (i.e. CreateCluster vs. CreateSecondaryCluster

↳ database_version int

Output only. The database engine major version. This is an output-only field and it's populated at the Cluster creation time. This field cannot be changed after cluster creation.

↳ network string

Required. The resource link for the VPC network in which cluster resources are created and from which they are accessible via Private IP. The network must belong to the same project as the cluster. It is specified in the form: "projects/{project_number}/global/networks/{network_id}". This is required to create a cluster. It can be updated, but it cannot be removed.

↳ etag string

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

↳ annotations array|Google\Protobuf\Internal\MapField

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

↳ reconciling bool

Output only. Reconciling (https://google.aip.dev/128#reconciliation). Set to true if the current state of Cluster does not match the user's intended state, and the service is actively updating the resource to reconcile them. This can happen due to user-triggered updates or system actions like failover or maintenance.

↳ initial_user Google\Cloud\AlloyDb\V1\UserPassword

Input only. Initial user to setup during cluster creation. Required. If used in RestoreCluster this is ignored.

↳ automated_backup_policy Google\Cloud\AlloyDb\V1\AutomatedBackupPolicy

The automated backup policy for this cluster. If no policy is provided then the default policy will be used. If backups are supported for the cluster, the default policy takes one backup a day, has a backup window of 1 hour, and retains backups for 14 days. For more information on the defaults, consult the documentation for the message type.

↳ ssl_config Google\Cloud\AlloyDb\V1\SslConfig

SSL configuration for this AlloyDB cluster.

↳ encryption_config Google\Cloud\AlloyDb\V1\EncryptionConfig

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

↳ encryption_info Google\Cloud\AlloyDb\V1\EncryptionInfo

Output only. The encryption information for the cluster.

↳ continuous_backup_config Google\Cloud\AlloyDb\V1\ContinuousBackupConfig

Optional. Continuous backup configuration for this cluster.

↳ continuous_backup_info Google\Cloud\AlloyDb\V1\ContinuousBackupInfo

Output only. Continuous backup properties for this cluster.

↳ secondary_config Google\Cloud\AlloyDb\V1\Cluster\SecondaryConfig

Cross Region replication config specific to SECONDARY cluster.

↳ primary_config Google\Cloud\AlloyDb\V1\Cluster\PrimaryConfig

Output only. Cross Region replication config specific to PRIMARY cluster.

getBackupSource

Output only. Cluster created from backup.

Returns
TypeDescription
Google\Cloud\AlloyDb\V1\BackupSource|null

hasBackupSource

setBackupSource

Output only. Cluster created from backup.

Parameter
NameDescription
var Google\Cloud\AlloyDb\V1\BackupSource
Returns
TypeDescription
$this

getMigrationSource

Output only. Cluster created via DMS migration.

Returns
TypeDescription
Google\Cloud\AlloyDb\V1\MigrationSource|null

hasMigrationSource

setMigrationSource

Output only. Cluster created via DMS migration.

Parameter
NameDescription
var Google\Cloud\AlloyDb\V1\MigrationSource
Returns
TypeDescription
$this

getName

Output only. The name of the cluster resource with the format:

  • projects/{project}/locations/{region}/clusters/{cluster_id} where the cluster ID segment should satisfy the regex expression [a-z0-9-]+. For more details see https://google.aip.dev/122.

The prefix of the cluster resource name is the name of the parent resource:

  • projects/{project}/locations/{region}
Returns
TypeDescription
string

setName

Output only. The name of the cluster resource with the format:

  • projects/{project}/locations/{region}/clusters/{cluster_id} where the cluster ID segment should satisfy the regex expression [a-z0-9-]+. For more details see https://google.aip.dev/122.

The prefix of the cluster resource name is the name of the parent resource:

  • projects/{project}/locations/{region}
Parameter
NameDescription
var string
Returns
TypeDescription
$this

getDisplayName

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

Returns
TypeDescription
string

setDisplayName

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

Parameter
NameDescription
var string
Returns
TypeDescription
$this

getUid

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.

Returns
TypeDescription
string

setUid

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.

Parameter
NameDescription
var string
Returns
TypeDescription
$this

getCreateTime

Output only. Create time stamp

Returns
TypeDescription
Google\Protobuf\Timestamp|null

hasCreateTime

clearCreateTime

setCreateTime

Output only. Create time stamp

Parameter
NameDescription
var Google\Protobuf\Timestamp
Returns
TypeDescription
$this

getUpdateTime

Output only. Update time stamp

Returns
TypeDescription
Google\Protobuf\Timestamp|null

hasUpdateTime

clearUpdateTime

setUpdateTime

Output only. Update time stamp

Parameter
NameDescription
var Google\Protobuf\Timestamp
Returns
TypeDescription
$this

getDeleteTime

Output only. Delete time stamp

Returns
TypeDescription
Google\Protobuf\Timestamp|null

hasDeleteTime

clearDeleteTime

setDeleteTime

Output only. Delete time stamp

Parameter
NameDescription
var Google\Protobuf\Timestamp
Returns
TypeDescription
$this

getLabels

Labels as key value pairs

Returns
TypeDescription
Google\Protobuf\Internal\MapField

setLabels

Labels as key value pairs

Parameter
NameDescription
var array|Google\Protobuf\Internal\MapField
Returns
TypeDescription
$this

getState

Output only. The current serving state of the cluster.

Returns
TypeDescription
int

setState

Output only. The current serving state of the cluster.

Parameter
NameDescription
var int
Returns
TypeDescription
$this

getClusterType

Output only. The type of the cluster. This is an output-only field and it's populated at the Cluster creation time or the Cluster promotion time. The cluster type is determined by which RPC was used to create the cluster (i.e. CreateCluster vs. CreateSecondaryCluster

Returns
TypeDescription
int

setClusterType

Output only. The type of the cluster. This is an output-only field and it's populated at the Cluster creation time or the Cluster promotion time. The cluster type is determined by which RPC was used to create the cluster (i.e. CreateCluster vs. CreateSecondaryCluster

Parameter
NameDescription
var int
Returns
TypeDescription
$this

getDatabaseVersion

Output only. The database engine major version. This is an output-only field and it's populated at the Cluster creation time. This field cannot be changed after cluster creation.

Returns
TypeDescription
int

setDatabaseVersion

Output only. The database engine major version. This is an output-only field and it's populated at the Cluster creation time. This field cannot be changed after cluster creation.

Parameter
NameDescription
var int
Returns
TypeDescription
$this

getNetwork

Required. The resource link for the VPC network in which cluster resources are created and from which they are accessible via Private IP. The network must belong to the same project as the cluster. It is specified in the form: "projects/{project_number}/global/networks/{network_id}". This is required to create a cluster. It can be updated, but it cannot be removed.

Returns
TypeDescription
string

setNetwork

Required. The resource link for the VPC network in which cluster resources are created and from which they are accessible via Private IP. The network must belong to the same project as the cluster. It is specified in the form: "projects/{project_number}/global/networks/{network_id}". This is required to create a cluster. It can be updated, but it cannot be removed.

Parameter
NameDescription
var string
Returns
TypeDescription
$this

getEtag

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

Returns
TypeDescription
string

setEtag

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

Parameter
NameDescription
var string
Returns
TypeDescription
$this

getAnnotations

Annotations to allow client tools to store small amount of arbitrary data.

This is distinct from labels. https://google.aip.dev/128

Returns
TypeDescription
Google\Protobuf\Internal\MapField

setAnnotations

Annotations to allow client tools to store small amount of arbitrary data.

This is distinct from labels. https://google.aip.dev/128

Parameter
NameDescription
var array|Google\Protobuf\Internal\MapField
Returns
TypeDescription
$this

getReconciling

Output only. Reconciling (https://google.aip.dev/128#reconciliation).

Set to true if the current state of Cluster does not match the user's intended state, and the service is actively updating the resource to reconcile them. This can happen due to user-triggered updates or system actions like failover or maintenance.

Returns
TypeDescription
bool

setReconciling

Output only. Reconciling (https://google.aip.dev/128#reconciliation).

Set to true if the current state of Cluster does not match the user's intended state, and the service is actively updating the resource to reconcile them. This can happen due to user-triggered updates or system actions like failover or maintenance.

Parameter
NameDescription
var bool
Returns
TypeDescription
$this

getInitialUser

Input only. Initial user to setup during cluster creation. Required.

If used in RestoreCluster this is ignored.

Returns
TypeDescription
Google\Cloud\AlloyDb\V1\UserPassword|null

hasInitialUser

clearInitialUser

setInitialUser

Input only. Initial user to setup during cluster creation. Required.

If used in RestoreCluster this is ignored.

Parameter
NameDescription
var Google\Cloud\AlloyDb\V1\UserPassword
Returns
TypeDescription
$this

getAutomatedBackupPolicy

The automated backup policy for this cluster.

If no policy is provided then the default policy will be used. If backups are supported for the cluster, the default policy takes one backup a day, has a backup window of 1 hour, and retains backups for 14 days. For more information on the defaults, consult the documentation for the message type.

Returns
TypeDescription
Google\Cloud\AlloyDb\V1\AutomatedBackupPolicy|null

hasAutomatedBackupPolicy

clearAutomatedBackupPolicy

setAutomatedBackupPolicy

The automated backup policy for this cluster.

If no policy is provided then the default policy will be used. If backups are supported for the cluster, the default policy takes one backup a day, has a backup window of 1 hour, and retains backups for 14 days. For more information on the defaults, consult the documentation for the message type.

Parameter
NameDescription
var Google\Cloud\AlloyDb\V1\AutomatedBackupPolicy
Returns
TypeDescription
$this

getSslConfig

SSL configuration for this AlloyDB cluster.

Returns
TypeDescription
Google\Cloud\AlloyDb\V1\SslConfig|null

hasSslConfig

clearSslConfig

setSslConfig

SSL configuration for this AlloyDB cluster.

Parameter
NameDescription
var Google\Cloud\AlloyDb\V1\SslConfig
Returns
TypeDescription
$this

getEncryptionConfig

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

Returns
TypeDescription
Google\Cloud\AlloyDb\V1\EncryptionConfig|null

hasEncryptionConfig

clearEncryptionConfig

setEncryptionConfig

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

Parameter
NameDescription
var Google\Cloud\AlloyDb\V1\EncryptionConfig
Returns
TypeDescription
$this

getEncryptionInfo

Output only. The encryption information for the cluster.

Returns
TypeDescription
Google\Cloud\AlloyDb\V1\EncryptionInfo|null

hasEncryptionInfo

clearEncryptionInfo

setEncryptionInfo

Output only. The encryption information for the cluster.

Parameter
NameDescription
var Google\Cloud\AlloyDb\V1\EncryptionInfo
Returns
TypeDescription
$this

getContinuousBackupConfig

Optional. Continuous backup configuration for this cluster.

Returns
TypeDescription
Google\Cloud\AlloyDb\V1\ContinuousBackupConfig|null

hasContinuousBackupConfig

clearContinuousBackupConfig

setContinuousBackupConfig

Optional. Continuous backup configuration for this cluster.

Parameter
NameDescription
var Google\Cloud\AlloyDb\V1\ContinuousBackupConfig
Returns
TypeDescription
$this

getContinuousBackupInfo

Output only. Continuous backup properties for this cluster.

Returns
TypeDescription
Google\Cloud\AlloyDb\V1\ContinuousBackupInfo|null

hasContinuousBackupInfo

clearContinuousBackupInfo

setContinuousBackupInfo

Output only. Continuous backup properties for this cluster.

Parameter
NameDescription
var Google\Cloud\AlloyDb\V1\ContinuousBackupInfo
Returns
TypeDescription
$this

getSecondaryConfig

Cross Region replication config specific to SECONDARY cluster.

Returns
TypeDescription
Google\Cloud\AlloyDb\V1\Cluster\SecondaryConfig|null

hasSecondaryConfig

clearSecondaryConfig

setSecondaryConfig

Cross Region replication config specific to SECONDARY cluster.

Parameter
NameDescription
var Google\Cloud\AlloyDb\V1\Cluster\SecondaryConfig
Returns
TypeDescription
$this

getPrimaryConfig

Output only. Cross Region replication config specific to PRIMARY cluster.

Returns
TypeDescription
Google\Cloud\AlloyDb\V1\Cluster\PrimaryConfig|null

hasPrimaryConfig

clearPrimaryConfig

setPrimaryConfig

Output only. Cross Region replication config specific to PRIMARY cluster.

Parameter
NameDescription
var Google\Cloud\AlloyDb\V1\Cluster\PrimaryConfig
Returns
TypeDescription
$this

getSource

Returns
TypeDescription
string