Reference documentation and code samples for the AlloyDB V1 API class Google::Cloud::AlloyDB::V1::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.
Inherits
- Object
Extended By
- Google::Protobuf::MessageExts::ClassMethods
Includes
- Google::Protobuf::MessageExts
Methods
#annotations
def annotations() -> ::Google::Protobuf::Map{::String => ::String}
- (::Google::Protobuf::Map{::String => ::String}) — Annotations to allow client tools to store small amount of arbitrary data. This is distinct from labels. https://google.aip.dev/128
#annotations=
def annotations=(value) -> ::Google::Protobuf::Map{::String => ::String}
- value (::Google::Protobuf::Map{::String => ::String}) — Annotations to allow client tools to store small amount of arbitrary data. This is distinct from labels. https://google.aip.dev/128
- (::Google::Protobuf::Map{::String => ::String}) — Annotations to allow client tools to store small amount of arbitrary data. This is distinct from labels. https://google.aip.dev/128
#automated_backup_policy
def automated_backup_policy() -> ::Google::Cloud::AlloyDB::V1::AutomatedBackupPolicy
-
(::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.
#automated_backup_policy=
def automated_backup_policy=(value) -> ::Google::Cloud::AlloyDB::V1::AutomatedBackupPolicy
-
value (::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.
-
(::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.
#backup_source
def backup_source() -> ::Google::Cloud::AlloyDB::V1::BackupSource
- (::Google::Cloud::AlloyDB::V1::BackupSource) — Output only. Cluster created from backup.
#cluster_type
def cluster_type() -> ::Google::Cloud::AlloyDB::V1::Cluster::ClusterType
-
(::Google::Cloud::AlloyDB::V1::Cluster::ClusterType) — 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
#create_time
def create_time() -> ::Google::Protobuf::Timestamp
- (::Google::Protobuf::Timestamp) — Output only. Create time stamp
#database_version
def database_version() -> ::Google::Cloud::AlloyDB::V1::DatabaseVersion
- (::Google::Cloud::AlloyDB::V1::DatabaseVersion) — 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.
#delete_time
def delete_time() -> ::Google::Protobuf::Timestamp
- (::Google::Protobuf::Timestamp) — Output only. Delete time stamp
#display_name
def display_name() -> ::String
- (::String) — User-settable and human-readable display name for the Cluster.
#display_name=
def display_name=(value) -> ::String
- value (::String) — User-settable and human-readable display name for the Cluster.
- (::String) — User-settable and human-readable display name for the Cluster.
#encryption_config
def encryption_config() -> ::Google::Cloud::AlloyDB::V1::EncryptionConfig
- (::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_config=
def encryption_config=(value) -> ::Google::Cloud::AlloyDB::V1::EncryptionConfig
- value (::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.
- (::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
def encryption_info() -> ::Google::Cloud::AlloyDB::V1::EncryptionInfo
- (::Google::Cloud::AlloyDB::V1::EncryptionInfo) — Output only. The encryption information for the cluster.
#etag
def etag() -> ::String
- (::String) — For Resource freshness validation (https://google.aip.dev/154)
#etag=
def etag=(value) -> ::String
- value (::String) — For Resource freshness validation (https://google.aip.dev/154)
- (::String) — For Resource freshness validation (https://google.aip.dev/154)
#initial_user
def initial_user() -> ::Google::Cloud::AlloyDB::V1::UserPassword
-
(::Google::Cloud::AlloyDB::V1::UserPassword) — Input only. Initial user to setup during cluster creation. Required.
If used in
RestoreCluster
this is ignored.
#initial_user=
def initial_user=(value) -> ::Google::Cloud::AlloyDB::V1::UserPassword
-
value (::Google::Cloud::AlloyDB::V1::UserPassword) — Input only. Initial user to setup during cluster creation. Required.
If used in
RestoreCluster
this is ignored.
-
(::Google::Cloud::AlloyDB::V1::UserPassword) — Input only. Initial user to setup during cluster creation. Required.
If used in
RestoreCluster
this is ignored.
#labels
def labels() -> ::Google::Protobuf::Map{::String => ::String}
- (::Google::Protobuf::Map{::String => ::String}) — Labels as key value pairs
#labels=
def labels=(value) -> ::Google::Protobuf::Map{::String => ::String}
- value (::Google::Protobuf::Map{::String => ::String}) — Labels as key value pairs
- (::Google::Protobuf::Map{::String => ::String}) — Labels as key value pairs
#migration_source
def migration_source() -> ::Google::Cloud::AlloyDB::V1::MigrationSource
- (::Google::Cloud::AlloyDB::V1::MigrationSource) — Output only. Cluster created via DMS migration.
#name
def name() -> ::String
-
(::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}
- projects/{project}/locations/{region}/clusters/{cluster_id}
where the cluster ID segment should satisfy the regex expression
#network
def network() -> ::String
- (::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.
#network=
def network=(value) -> ::String
- value (::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.
- (::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.
#primary_config
def primary_config() -> ::Google::Cloud::AlloyDB::V1::Cluster::PrimaryConfig
- (::Google::Cloud::AlloyDB::V1::Cluster::PrimaryConfig) — Output only. Cross Region replication config specific to PRIMARY cluster.
#reconciling
def reconciling() -> ::Boolean
- (::Boolean) — 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.
#secondary_config
def secondary_config() -> ::Google::Cloud::AlloyDB::V1::Cluster::SecondaryConfig
- (::Google::Cloud::AlloyDB::V1::Cluster::SecondaryConfig) — Cross Region replication config specific to SECONDARY cluster.
#secondary_config=
def secondary_config=(value) -> ::Google::Cloud::AlloyDB::V1::Cluster::SecondaryConfig
- value (::Google::Cloud::AlloyDB::V1::Cluster::SecondaryConfig) — Cross Region replication config specific to SECONDARY cluster.
- (::Google::Cloud::AlloyDB::V1::Cluster::SecondaryConfig) — Cross Region replication config specific to SECONDARY cluster.
#ssl_config
def ssl_config() -> ::Google::Cloud::AlloyDB::V1::SslConfig
- (::Google::Cloud::AlloyDB::V1::SslConfig) — SSL configuration for this AlloyDB Cluster.
#ssl_config=
def ssl_config=(value) -> ::Google::Cloud::AlloyDB::V1::SslConfig
- value (::Google::Cloud::AlloyDB::V1::SslConfig) — SSL configuration for this AlloyDB Cluster.
- (::Google::Cloud::AlloyDB::V1::SslConfig) — SSL configuration for this AlloyDB Cluster.
#state
def state() -> ::Google::Cloud::AlloyDB::V1::Cluster::State
- (::Google::Cloud::AlloyDB::V1::Cluster::State) — Output only. The current serving state of the cluster.
#uid
def uid() -> ::String
- (::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.
#update_time
def update_time() -> ::Google::Protobuf::Timestamp
- (::Google::Protobuf::Timestamp) — Output only. Update time stamp