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

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

Optional. The database engine major version. This is an optional field and it is populated at the Cluster creation time. If a database version is not supplied at cluster creation time, then a default database version will be used.

↳ network_config Google\Cloud\AlloyDb\V1\Cluster\NetworkConfig
↳ 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}/global/networks/{network_id}". This is required to create a cluster. Deprecated, use network_config.network instead.

↳ 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
Type Description
Google\Cloud\AlloyDb\V1\BackupSource|null

hasBackupSource

setBackupSource

Output only. Cluster created from backup.

Parameter
Name Description
var Google\Cloud\AlloyDb\V1\BackupSource
Returns
Type Description
$this

getMigrationSource

Output only. Cluster created via DMS migration.

Returns
Type Description
Google\Cloud\AlloyDb\V1\MigrationSource|null

hasMigrationSource

setMigrationSource

Output only. Cluster created via DMS migration.

Parameter
Name Description
var Google\Cloud\AlloyDb\V1\MigrationSource
Returns
Type Description
$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
Type Description
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
Name Description
var string
Returns
Type Description
$this

getDisplayName

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

Returns
Type Description
string

setDisplayName

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

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

getCreateTime

Output only. Create time stamp

Returns
Type Description
Google\Protobuf\Timestamp|null

hasCreateTime

clearCreateTime

setCreateTime

Output only. Create time stamp

Parameter
Name Description
var Google\Protobuf\Timestamp
Returns
Type Description
$this

getUpdateTime

Output only. Update time stamp

Returns
Type Description
Google\Protobuf\Timestamp|null

hasUpdateTime

clearUpdateTime

setUpdateTime

Output only. Update time stamp

Parameter
Name Description
var Google\Protobuf\Timestamp
Returns
Type Description
$this

getDeleteTime

Output only. Delete time stamp

Returns
Type Description
Google\Protobuf\Timestamp|null

hasDeleteTime

clearDeleteTime

setDeleteTime

Output only. Delete time stamp

Parameter
Name Description
var Google\Protobuf\Timestamp
Returns
Type Description
$this

getLabels

Labels as key value pairs

Returns
Type Description
Google\Protobuf\Internal\MapField

setLabels

Labels as key value pairs

Parameter
Name Description
var array|Google\Protobuf\Internal\MapField
Returns
Type Description
$this

getState

Output only. The current serving state of the cluster.

Returns
Type Description
int

setState

Output only. The current serving state of the cluster.

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

getDatabaseVersion

Optional. The database engine major version. This is an optional field and it is populated at the Cluster creation time. If a database version is not supplied at cluster creation time, then a default database version will be used.

Returns
Type Description
int

setDatabaseVersion

Optional. The database engine major version. This is an optional field and it is populated at the Cluster creation time. If a database version is not supplied at cluster creation time, then a default database version will be used.

Parameter
Name Description
var int
Returns
Type Description
$this

getNetworkConfig

Generated from protobuf field .google.cloud.alloydb.v1.Cluster.NetworkConfig network_config = 29 [(.google.api.field_behavior) = OPTIONAL];

Returns
Type Description
Google\Cloud\AlloyDb\V1\Cluster\NetworkConfig|null

hasNetworkConfig

clearNetworkConfig

setNetworkConfig

Generated from protobuf field .google.cloud.alloydb.v1.Cluster.NetworkConfig network_config = 29 [(.google.api.field_behavior) = OPTIONAL];

Parameter
Name Description
var Google\Cloud\AlloyDb\V1\Cluster\NetworkConfig
Returns
Type Description
$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}/global/networks/{network_id}". This is required to create a cluster. Deprecated, use network_config.network instead.

Returns
Type Description
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}/global/networks/{network_id}". This is required to create a cluster. Deprecated, use network_config.network instead.

Parameter
Name Description
var string
Returns
Type Description
$this

getEtag

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

Returns
Type Description
string

setEtag

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

Parameter
Name Description
var string
Returns
Type Description
$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
Type Description
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
Name Description
var array|Google\Protobuf\Internal\MapField
Returns
Type Description
$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
Type Description
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
Name Description
var bool
Returns
Type Description
$this

getInitialUser

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

If used in RestoreCluster this is ignored.

Returns
Type Description
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
Name Description
var Google\Cloud\AlloyDb\V1\UserPassword
Returns
Type Description
$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
Type Description
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
Name Description
var Google\Cloud\AlloyDb\V1\AutomatedBackupPolicy
Returns
Type Description
$this

getSslConfig

SSL configuration for this AlloyDB cluster.

Returns
Type Description
Google\Cloud\AlloyDb\V1\SslConfig|null

hasSslConfig

clearSslConfig

setSslConfig

SSL configuration for this AlloyDB cluster.

Parameter
Name Description
var Google\Cloud\AlloyDb\V1\SslConfig
Returns
Type Description
$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
Type Description
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
Name Description
var Google\Cloud\AlloyDb\V1\EncryptionConfig
Returns
Type Description
$this

getEncryptionInfo

Output only. The encryption information for the cluster.

Returns
Type Description
Google\Cloud\AlloyDb\V1\EncryptionInfo|null

hasEncryptionInfo

clearEncryptionInfo

setEncryptionInfo

Output only. The encryption information for the cluster.

Parameter
Name Description
var Google\Cloud\AlloyDb\V1\EncryptionInfo
Returns
Type Description
$this

getContinuousBackupConfig

Optional. Continuous backup configuration for this cluster.

Returns
Type Description
Google\Cloud\AlloyDb\V1\ContinuousBackupConfig|null

hasContinuousBackupConfig

clearContinuousBackupConfig

setContinuousBackupConfig

Optional. Continuous backup configuration for this cluster.

Parameter
Name Description
var Google\Cloud\AlloyDb\V1\ContinuousBackupConfig
Returns
Type Description
$this

getContinuousBackupInfo

Output only. Continuous backup properties for this cluster.

Returns
Type Description
Google\Cloud\AlloyDb\V1\ContinuousBackupInfo|null

hasContinuousBackupInfo

clearContinuousBackupInfo

setContinuousBackupInfo

Output only. Continuous backup properties for this cluster.

Parameter
Name Description
var Google\Cloud\AlloyDb\V1\ContinuousBackupInfo
Returns
Type Description
$this

getSecondaryConfig

Cross Region replication config specific to SECONDARY cluster.

Returns
Type Description
Google\Cloud\AlloyDb\V1\Cluster\SecondaryConfig|null

hasSecondaryConfig

clearSecondaryConfig

setSecondaryConfig

Cross Region replication config specific to SECONDARY cluster.

Parameter
Name Description
var Google\Cloud\AlloyDb\V1\Cluster\SecondaryConfig
Returns
Type Description
$this

getPrimaryConfig

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

Returns
Type Description
Google\Cloud\AlloyDb\V1\Cluster\PrimaryConfig|null

hasPrimaryConfig

clearPrimaryConfig

setPrimaryConfig

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

Parameter
Name Description
var Google\Cloud\AlloyDb\V1\Cluster\PrimaryConfig
Returns
Type Description
$this

getSource

Returns
Type Description
string