Class: Aws::RDS::DBCluster
- Inherits:
-
Object
- Object
- Aws::RDS::DBCluster
- Extended by:
- Deprecations
- Defined in:
- lib/aws-sdk-rds/db_cluster.rb
Defined Under Namespace
Classes: Collection
Read-Only Attributes collapse
-
#allocated_storage ⇒ Integer
For all database engines except Amazon Aurora, ‘AllocatedStorage` specifies the allocated storage size in gibibytes (GiB).
-
#associated_roles ⇒ Array<Types::DBClusterRole>
Provides a list of the AWS Identity and Access Management (IAM) roles that are associated with the DB cluster.
-
#availability_zones ⇒ Array<String>
Provides the list of EC2 Availability Zones that instances in the DB cluster can be created in.
-
#backtrack_consumed_change_records ⇒ Integer
The number of change records stored for Backtrack.
-
#backtrack_window ⇒ Integer
The target backtrack window, in seconds.
-
#backup_retention_period ⇒ Integer
Specifies the number of days for which automatic DB snapshots are retained.
-
#capacity ⇒ Integer
The current capacity of an Aurora Serverless DB cluster.
-
#character_set_name ⇒ String
If present, specifies the name of the character set that this cluster is associated with.
-
#clone_group_id ⇒ String
Identifies the clone group to which the DB cluster is associated.
-
#cluster_create_time ⇒ Time
Specifies the time when the DB cluster was created, in Universal Coordinated Time (UTC).
-
#custom_endpoints ⇒ Array<String>
Identifies all custom endpoints associated with the cluster.
-
#database_name ⇒ String
Contains the name of the initial database of this DB cluster that was provided at create time, if one was specified when the DB cluster was created.
-
#db_cluster_arn ⇒ String
The Amazon Resource Name (ARN) for the DB cluster.
-
#db_cluster_members ⇒ Array<Types::DBClusterMember>
Provides the list of instances that make up the DB cluster.
-
#db_cluster_option_group_memberships ⇒ Array<Types::DBClusterOptionGroupStatus>
Provides the list of option group memberships for this DB cluster.
-
#db_cluster_parameter_group ⇒ String
Specifies the name of the DB cluster parameter group for the DB cluster.
-
#db_cluster_resource_id ⇒ String
The AWS Region-unique, immutable identifier for the DB cluster.
-
#db_subnet_group ⇒ String
Specifies information on the subnet group associated with the DB cluster, including the name, description, and subnets in the subnet group.
-
#deletion_protection ⇒ Boolean
Indicates if the DB cluster has deletion protection enabled.
-
#earliest_backtrack_time ⇒ Time
The earliest time to which a DB cluster can be backtracked.
-
#earliest_restorable_time ⇒ Time
The earliest time to which a database can be restored with point-in-time restore.
-
#enabled_cloudwatch_logs_exports ⇒ Array<String>
A list of log types that this DB cluster is configured to export to CloudWatch Logs.
-
#endpoint ⇒ String
Specifies the connection endpoint for the primary instance of the DB cluster.
-
#engine ⇒ String
Provides the name of the database engine to be used for this DB cluster.
-
#engine_mode ⇒ String
The DB engine mode of the DB cluster, either ‘provisioned`, `serverless`, or `parallelquery`.
-
#engine_version ⇒ String
Indicates the database engine version.
-
#hosted_zone_id ⇒ String
Specifies the ID that Amazon Route 53 assigns when you create a hosted zone.
-
#http_endpoint_enabled ⇒ Boolean
<note markdown=“1”> HTTP endpoint functionality is in beta for Aurora Serverless and is subject to change.
-
#iam_database_authentication_enabled ⇒ Boolean
True if mapping of AWS Identity and Access Management (IAM) accounts to database accounts is enabled, and otherwise false.
- #id ⇒ String (also: #db_cluster_identifier)
-
#kms_key_id ⇒ String
If ‘StorageEncrypted` is true, the AWS KMS key identifier for the encrypted DB cluster.
-
#latest_restorable_time ⇒ Time
Specifies the latest time to which a database can be restored with point-in-time restore.
-
#master_username ⇒ String
Contains the master username for the DB cluster.
-
#multi_az ⇒ Boolean
Specifies whether the DB cluster has instances in multiple Availability Zones.
-
#percent_progress ⇒ String
Specifies the progress of the operation as a percentage.
-
#port ⇒ Integer
Specifies the port that the database engine is listening on.
-
#preferred_backup_window ⇒ String
Specifies the daily time range during which automated backups are created if automated backups are enabled, as determined by the ‘BackupRetentionPeriod`.
-
#preferred_maintenance_window ⇒ String
Specifies the weekly time range during which system maintenance can occur, in Universal Coordinated Time (UTC).
-
#read_replica_identifiers ⇒ Array<String>
Contains one or more identifiers of the Read Replicas associated with this DB cluster.
-
#reader_endpoint ⇒ String
The reader endpoint for the DB cluster.
-
#replication_source_identifier ⇒ String
Contains the identifier of the source DB cluster if this DB cluster is a Read Replica.
-
#scaling_configuration_info ⇒ Types::ScalingConfigurationInfo
Shows the scaling configuration for an Aurora DB cluster in ‘serverless` DB engine mode.
-
#status ⇒ String
Specifies the current state of this DB cluster.
-
#storage_encrypted ⇒ Boolean
Specifies whether the DB cluster is encrypted.
-
#vpc_security_groups ⇒ Array<Types::VpcSecurityGroupMembership>
Provides a list of VPC security groups that the DB cluster belongs to.
Actions collapse
- #create(options = {}) ⇒ DBCluster
- #create_snapshot(options = {}) ⇒ DBClusterSnapshot
- #delete(options = {}) ⇒ DBCluster
- #failover(options = {}) ⇒ DBCluster
- #modify(options = {}) ⇒ DBCluster
- #restore(options = {}) ⇒ DBCluster
Associations collapse
- #events(options = {}) ⇒ Event::Collection
- #identifiers ⇒ Object deprecated private Deprecated.
- #members ⇒ DBInstance::Collection
- #option_groups ⇒ OptionGroup::Collection
- #parameter_group ⇒ DBClusterParameterGroup?
- #snapshots(options = {}) ⇒ DBClusterSnapshot::Collection
- #subnet_group ⇒ DBSubnetGroup?
Instance Method Summary collapse
- #client ⇒ Client
-
#data ⇒ Types::DBCluster
Returns the data for this DBCluster.
-
#data_loaded? ⇒ Boolean
Returns ‘true` if this resource is loaded.
-
#initialize(*args) ⇒ DBCluster
constructor
A new instance of DBCluster.
- #load ⇒ self (also: #reload)
-
#wait_until(options = {}, &block) ⇒ Resource
deprecated
Deprecated.
Use [Aws::RDS::Client] #wait_until instead
Constructor Details
#initialize(id, options = {}) ⇒ DBCluster #initialize(options = {}) ⇒ DBCluster
Returns a new instance of DBCluster.
19 20 21 22 23 24 |
# File 'lib/aws-sdk-rds/db_cluster.rb', line 19 def initialize(*args) = Hash === args.last ? args.pop.dup : {} @id = extract_id(args, ) @data = .delete(:data) @client = .delete(:client) || Client.new() end |
Instance Method Details
#allocated_storage ⇒ Integer
For all database engines except Amazon Aurora, ‘AllocatedStorage` specifies the allocated storage size in gibibytes (GiB). For Aurora, `AllocatedStorage` always returns 1, because Aurora DB cluster storage size is not fixed, but instead automatically adjusts as needed.
39 40 41 |
# File 'lib/aws-sdk-rds/db_cluster.rb', line 39 def allocated_storage data[:allocated_storage] end |
#associated_roles ⇒ Array<Types::DBClusterRole>
Provides a list of the AWS Identity and Access Management (IAM) roles that are associated with the DB cluster. IAM roles that are associated with a DB cluster grant permission for the DB cluster to access other AWS services on your behalf.
260 261 262 |
# File 'lib/aws-sdk-rds/db_cluster.rb', line 260 def associated_roles data[:associated_roles] end |
#availability_zones ⇒ Array<String>
Provides the list of EC2 Availability Zones that instances in the DB cluster can be created in.
46 47 48 |
# File 'lib/aws-sdk-rds/db_cluster.rb', line 46 def availability_zones data[:availability_zones] end |
#backtrack_consumed_change_records ⇒ Integer
The number of change records stored for Backtrack.
300 301 302 |
# File 'lib/aws-sdk-rds/db_cluster.rb', line 300 def backtrack_consumed_change_records data[:backtrack_consumed_change_records] end |
#backtrack_window ⇒ Integer
The target backtrack window, in seconds. If this value is set to 0, backtracking is disabled for the DB cluster. Otherwise, backtracking is enabled.
294 295 296 |
# File 'lib/aws-sdk-rds/db_cluster.rb', line 294 def backtrack_window data[:backtrack_window] end |
#backup_retention_period ⇒ Integer
Specifies the number of days for which automatic DB snapshots are retained.
53 54 55 |
# File 'lib/aws-sdk-rds/db_cluster.rb', line 53 def backup_retention_period data[:backup_retention_period] end |
#capacity ⇒ Integer
The current capacity of an Aurora Serverless DB cluster. The capacity is 0 (zero) when the cluster is paused.
For more information about Aurora Serverless, see [Using Amazon Aurora Serverless] in the *Amazon Aurora User Guide*.
[1]: docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-serverless.html
329 330 331 |
# File 'lib/aws-sdk-rds/db_cluster.rb', line 329 def capacity data[:capacity] end |
#character_set_name ⇒ String
If present, specifies the name of the character set that this cluster is associated with.
60 61 62 |
# File 'lib/aws-sdk-rds/db_cluster.rb', line 60 def character_set_name data[:character_set_name] end |
#client ⇒ Client
388 389 390 |
# File 'lib/aws-sdk-rds/db_cluster.rb', line 388 def client @client end |
#clone_group_id ⇒ String
Identifies the clone group to which the DB cluster is associated.
273 274 275 |
# File 'lib/aws-sdk-rds/db_cluster.rb', line 273 def clone_group_id data[:clone_group_id] end |
#cluster_create_time ⇒ Time
Specifies the time when the DB cluster was created, in Universal Coordinated Time (UTC).
280 281 282 |
# File 'lib/aws-sdk-rds/db_cluster.rb', line 280 def cluster_create_time data[:cluster_create_time] end |
#create(options = {}) ⇒ DBCluster
813 814 815 816 817 818 819 820 821 |
# File 'lib/aws-sdk-rds/db_cluster.rb', line 813 def create( = {}) = .merge(db_cluster_identifier: @id) resp = @client.create_db_cluster() DBCluster.new( id: resp.data.db_cluster.db_cluster_identifier, data: resp.data.db_cluster, client: @client ) end |
#create_snapshot(options = {}) ⇒ DBClusterSnapshot
851 852 853 854 855 856 857 858 859 860 |
# File 'lib/aws-sdk-rds/db_cluster.rb', line 851 def create_snapshot( = {}) = .merge(db_cluster_identifier: @id) resp = @client.create_db_cluster_snapshot() DBClusterSnapshot.new( cluster_id: resp.data.db_cluster_snapshot.db_cluster_identifier, snapshot_id: resp.data.db_cluster_snapshot.db_cluster_snapshot_identifier, data: resp.data.db_cluster_snapshot, client: @client ) end |
#custom_endpoints ⇒ Array<String>
Identifies all custom endpoints associated with the cluster.
131 132 133 |
# File 'lib/aws-sdk-rds/db_cluster.rb', line 131 def custom_endpoints data[:custom_endpoints] end |
#data ⇒ Types::DBCluster
Returns the data for this Aws::RDS::DBCluster. Calls Client#describe_db_clusters if #data_loaded? is ‘false`.
408 409 410 411 |
# File 'lib/aws-sdk-rds/db_cluster.rb', line 408 def data load unless @data @data end |
#data_loaded? ⇒ Boolean
416 417 418 |
# File 'lib/aws-sdk-rds/db_cluster.rb', line 416 def data_loaded? !!@data end |
#database_name ⇒ String
Contains the name of the initial database of this DB cluster that was provided at create time, if one was specified when the DB cluster was created. This same name is returned for the life of the DB cluster.
68 69 70 |
# File 'lib/aws-sdk-rds/db_cluster.rb', line 68 def database_name data[:database_name] end |
#db_cluster_arn ⇒ String
The Amazon Resource Name (ARN) for the DB cluster.
251 252 253 |
# File 'lib/aws-sdk-rds/db_cluster.rb', line 251 def db_cluster_arn data[:db_cluster_arn] end |
#db_cluster_members ⇒ Array<Types::DBClusterMember>
Provides the list of instances that make up the DB cluster.
211 212 213 |
# File 'lib/aws-sdk-rds/db_cluster.rb', line 211 def db_cluster_members data[:db_cluster_members] end |
#db_cluster_option_group_memberships ⇒ Array<Types::DBClusterOptionGroupStatus>
Provides the list of option group memberships for this DB cluster.
176 177 178 |
# File 'lib/aws-sdk-rds/db_cluster.rb', line 176 def db_cluster_option_group_memberships data[:db_cluster_option_group_memberships] end |
#db_cluster_parameter_group ⇒ String
Specifies the name of the DB cluster parameter group for the DB cluster.
75 76 77 |
# File 'lib/aws-sdk-rds/db_cluster.rb', line 75 def db_cluster_parameter_group data[:db_cluster_parameter_group] end |
#db_cluster_resource_id ⇒ String
The AWS Region-unique, immutable identifier for the DB cluster. This identifier is found in AWS CloudTrail log entries whenever the AWS KMS key for the DB cluster is accessed.
245 246 247 |
# File 'lib/aws-sdk-rds/db_cluster.rb', line 245 def db_cluster_resource_id data[:db_cluster_resource_id] end |
#db_subnet_group ⇒ String
Specifies information on the subnet group associated with the DB cluster, including the name, description, and subnets in the subnet group.
83 84 85 |
# File 'lib/aws-sdk-rds/db_cluster.rb', line 83 def db_subnet_group data[:db_subnet_group] end |
#delete(options = {}) ⇒ DBCluster
898 899 900 901 902 903 904 905 906 |
# File 'lib/aws-sdk-rds/db_cluster.rb', line 898 def delete( = {}) = .merge(db_cluster_identifier: @id) resp = @client.delete_db_cluster() DBCluster.new( id: resp.data.db_cluster.db_cluster_identifier, data: resp.data.db_cluster, client: @client ) end |
#deletion_protection ⇒ Boolean
Indicates if the DB cluster has deletion protection enabled. The database can’t be deleted when this value is set to true.
357 358 359 |
# File 'lib/aws-sdk-rds/db_cluster.rb', line 357 def deletion_protection data[:deletion_protection] end |
#earliest_backtrack_time ⇒ Time
The earliest time to which a DB cluster can be backtracked.
286 287 288 |
# File 'lib/aws-sdk-rds/db_cluster.rb', line 286 def earliest_backtrack_time data[:earliest_backtrack_time] end |
#earliest_restorable_time ⇒ Time
The earliest time to which a database can be restored with point-in-time restore.
102 103 104 |
# File 'lib/aws-sdk-rds/db_cluster.rb', line 102 def earliest_restorable_time data[:earliest_restorable_time] end |
#enabled_cloudwatch_logs_exports ⇒ Array<String>
A list of log types that this DB cluster is configured to export to CloudWatch Logs.
Log types vary by DB engine. For information about the log types for each DB engine, see [Amazon RDS Database Log Files] in the *Amazon Aurora User Guide.*
[1]: docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_LogAccess.html
315 316 317 |
# File 'lib/aws-sdk-rds/db_cluster.rb', line 315 def enabled_cloudwatch_logs_exports data[:enabled_cloudwatch_logs_exports] end |
#endpoint ⇒ String
Specifies the connection endpoint for the primary instance of the DB cluster.
109 110 111 |
# File 'lib/aws-sdk-rds/db_cluster.rb', line 109 def endpoint data[:endpoint] end |
#engine ⇒ String
Provides the name of the database engine to be used for this DB cluster.
145 146 147 |
# File 'lib/aws-sdk-rds/db_cluster.rb', line 145 def engine data[:engine] end |
#engine_mode ⇒ String
The DB engine mode of the DB cluster, either ‘provisioned`, `serverless`, or `parallelquery`.
336 337 338 |
# File 'lib/aws-sdk-rds/db_cluster.rb', line 336 def engine_mode data[:engine_mode] end |
#engine_version ⇒ String
Indicates the database engine version.
151 152 153 |
# File 'lib/aws-sdk-rds/db_cluster.rb', line 151 def engine_version data[:engine_version] end |
#events(options = {}) ⇒ Event::Collection
1366 1367 1368 1369 1370 1371 1372 1373 1374 1375 1376 1377 1378 1379 1380 1381 1382 1383 1384 1385 1386 1387 |
# File 'lib/aws-sdk-rds/db_cluster.rb', line 1366 def events( = {}) batches = Enumerator.new do |y| = .merge( source_type: "db-cluster", source_identifier: @id ) resp = @client.describe_events() resp.each_page do |page| batch = [] page.data.events.each do |e| batch << Event.new( source_id: e.source_identifier, date: e.date, data: e, client: @client ) end y.yield(batch) end end Event::Collection.new(batches) end |
#failover(options = {}) ⇒ DBCluster
920 921 922 923 924 925 926 927 928 |
# File 'lib/aws-sdk-rds/db_cluster.rb', line 920 def failover( = {}) = .merge(db_cluster_identifier: @id) resp = @client.failover_db_cluster() DBCluster.new( id: resp.data.db_cluster.db_cluster_identifier, data: resp.data.db_cluster, client: @client ) end |
#hosted_zone_id ⇒ String
Specifies the ID that Amazon Route 53 assigns when you create a hosted zone.
224 225 226 |
# File 'lib/aws-sdk-rds/db_cluster.rb', line 224 def hosted_zone_id data[:hosted_zone_id] end |
#http_endpoint_enabled ⇒ Boolean
<note markdown=“1”> HTTP endpoint functionality is in beta for Aurora Serverless and is subject to change.
</note>
Value that is ‘true` if the HTTP endpoint for an Aurora Serverless DB cluster is enabled and `false` otherwise.
When enabled, the HTTP endpoint provides a connectionless web service API for running SQL queries on the Aurora Serverless DB cluster. You can also query your database from inside the RDS console with the query editor.
For more information about Aurora Serverless, see [Using Amazon Aurora Serverless] in the *Amazon Aurora User Guide*.
[1]: docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-serverless.html
381 382 383 |
# File 'lib/aws-sdk-rds/db_cluster.rb', line 381 def http_endpoint_enabled data[:http_endpoint_enabled] end |
#iam_database_authentication_enabled ⇒ Boolean
True if mapping of AWS Identity and Access Management (IAM) accounts to database accounts is enabled, and otherwise false.
267 268 269 |
# File 'lib/aws-sdk-rds/db_cluster.rb', line 267 def iam_database_authentication_enabled data[:iam_database_authentication_enabled] end |
#id ⇒ String Also known as: db_cluster_identifier
29 30 31 |
# File 'lib/aws-sdk-rds/db_cluster.rb', line 29 def id @id end |
#identifiers ⇒ Object
This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.
1547 1548 1549 |
# File 'lib/aws-sdk-rds/db_cluster.rb', line 1547 def identifiers { id: @id } end |
#kms_key_id ⇒ String
If ‘StorageEncrypted` is true, the AWS KMS key identifier for the encrypted DB cluster.
237 238 239 |
# File 'lib/aws-sdk-rds/db_cluster.rb', line 237 def kms_key_id data[:kms_key_id] end |
#latest_restorable_time ⇒ Time
Specifies the latest time to which a database can be restored with point-in-time restore.
158 159 160 |
# File 'lib/aws-sdk-rds/db_cluster.rb', line 158 def latest_restorable_time data[:latest_restorable_time] end |
#load ⇒ self Also known as: reload
Loads, or reloads #data for the current Aws::RDS::DBCluster. Returns ‘self` making it possible to chain methods.
db_cluster.reload.data
398 399 400 401 402 |
# File 'lib/aws-sdk-rds/db_cluster.rb', line 398 def load resp = @client.describe_db_clusters(db_cluster_identifier: @id) @data = resp.db_clusters[0] self end |
#master_username ⇒ String
Contains the master username for the DB cluster.
170 171 172 |
# File 'lib/aws-sdk-rds/db_cluster.rb', line 170 def master_username data[:master_username] end |
#members ⇒ DBInstance::Collection
1390 1391 1392 1393 1394 1395 1396 1397 1398 1399 1400 |
# File 'lib/aws-sdk-rds/db_cluster.rb', line 1390 def members batch = [] data[:db_cluster_members].each do |d| batch << DBInstance.new( id: d[:db_instance_identifier], data: d, client: @client ) end DBInstance::Collection.new([batch], size: batch.size) end |
#modify(options = {}) ⇒ DBCluster
1126 1127 1128 1129 1130 1131 1132 1133 1134 |
# File 'lib/aws-sdk-rds/db_cluster.rb', line 1126 def modify( = {}) = .merge(db_cluster_identifier: @id) resp = @client.modify_db_cluster() DBCluster.new( id: resp.data.db_cluster.db_cluster_identifier, data: resp.data.db_cluster, client: @client ) end |
#multi_az ⇒ Boolean
Specifies whether the DB cluster has instances in multiple Availability Zones.
138 139 140 |
# File 'lib/aws-sdk-rds/db_cluster.rb', line 138 def multi_az data[:multi_az] end |
#option_groups ⇒ OptionGroup::Collection
1403 1404 1405 1406 1407 1408 1409 1410 1411 1412 1413 |
# File 'lib/aws-sdk-rds/db_cluster.rb', line 1403 def option_groups batch = [] data[:db_cluster_option_group_memberships].each do |d| batch << OptionGroup.new( name: d[:db_cluster_option_group_name], data: d, client: @client ) end OptionGroup::Collection.new([batch], size: batch.size) end |
#parameter_group ⇒ DBClusterParameterGroup?
1416 1417 1418 1419 1420 1421 1422 1423 1424 1425 |
# File 'lib/aws-sdk-rds/db_cluster.rb', line 1416 def parameter_group if data[:db_cluster_parameter_group] DBClusterParameterGroup.new( name: data[:db_cluster_parameter_group], client: @client ) else nil end end |
#percent_progress ⇒ String
Specifies the progress of the operation as a percentage.
95 96 97 |
# File 'lib/aws-sdk-rds/db_cluster.rb', line 95 def percent_progress data[:percent_progress] end |
#port ⇒ Integer
Specifies the port that the database engine is listening on.
164 165 166 |
# File 'lib/aws-sdk-rds/db_cluster.rb', line 164 def port data[:port] end |
#preferred_backup_window ⇒ String
Specifies the daily time range during which automated backups are created if automated backups are enabled, as determined by the ‘BackupRetentionPeriod`.
184 185 186 |
# File 'lib/aws-sdk-rds/db_cluster.rb', line 184 def preferred_backup_window data[:preferred_backup_window] end |
#preferred_maintenance_window ⇒ String
Specifies the weekly time range during which system maintenance can occur, in Universal Coordinated Time (UTC).
191 192 193 |
# File 'lib/aws-sdk-rds/db_cluster.rb', line 191 def preferred_maintenance_window data[:preferred_maintenance_window] end |
#read_replica_identifiers ⇒ Array<String>
Contains one or more identifiers of the Read Replicas associated with this DB cluster.
205 206 207 |
# File 'lib/aws-sdk-rds/db_cluster.rb', line 205 def read_replica_identifiers data[:read_replica_identifiers] end |
#reader_endpoint ⇒ String
The reader endpoint for the DB cluster. The reader endpoint for a DB cluster load-balances connections across the Aurora Replicas that are available in a DB cluster. As clients request new connections to the reader endpoint, Aurora distributes the connection requests among the Aurora Replicas in the DB cluster. This functionality can help balance your read workload across multiple Aurora Replicas in your DB cluster.
If a failover occurs, and the Aurora Replica that you are connected to is promoted to be the primary instance, your connection is dropped. To continue sending your read workload to other Aurora Replicas in the cluster, you can then reconnect to the reader endpoint.
125 126 127 |
# File 'lib/aws-sdk-rds/db_cluster.rb', line 125 def reader_endpoint data[:reader_endpoint] end |
#replication_source_identifier ⇒ String
Contains the identifier of the source DB cluster if this DB cluster is a Read Replica.
198 199 200 |
# File 'lib/aws-sdk-rds/db_cluster.rb', line 198 def replication_source_identifier data[:replication_source_identifier] end |
#restore(options = {}) ⇒ DBCluster
1309 1310 1311 1312 1313 1314 1315 1316 1317 |
# File 'lib/aws-sdk-rds/db_cluster.rb', line 1309 def restore( = {}) = .merge(source_db_cluster_identifier: @id) resp = @client.restore_db_cluster_to_point_in_time() DBCluster.new( id: resp.data.db_cluster.db_cluster_identifier, data: resp.data.db_cluster, client: @client ) end |
#scaling_configuration_info ⇒ Types::ScalingConfigurationInfo
Shows the scaling configuration for an Aurora DB cluster in ‘serverless` DB engine mode.
For more information, see [Using Amazon Aurora Serverless] in the *Amazon Aurora User Guide*.
[1]: docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-serverless.html
350 351 352 |
# File 'lib/aws-sdk-rds/db_cluster.rb', line 350 def scaling_configuration_info data[:scaling_configuration_info] end |
#snapshots(options = {}) ⇒ DBClusterSnapshot::Collection
1515 1516 1517 1518 1519 1520 1521 1522 1523 1524 1525 1526 1527 1528 1529 1530 1531 |
# File 'lib/aws-sdk-rds/db_cluster.rb', line 1515 def snapshots( = {}) batches = Enumerator.new do |y| batch = [] = .merge(db_cluster_identifier: @id) resp = @client.describe_db_cluster_snapshots() resp.data.db_cluster_snapshots.each do |d| batch << DBClusterSnapshot.new( cluster_id: @id, snapshot_id: d.db_cluster_snapshot_identifier, data: d, client: @client ) end y.yield(batch) end DBClusterSnapshot::Collection.new(batches) end |
#status ⇒ String
Specifies the current state of this DB cluster.
89 90 91 |
# File 'lib/aws-sdk-rds/db_cluster.rb', line 89 def status data[:status] end |
#storage_encrypted ⇒ Boolean
Specifies whether the DB cluster is encrypted.
230 231 232 |
# File 'lib/aws-sdk-rds/db_cluster.rb', line 230 def storage_encrypted data[:storage_encrypted] end |
#subnet_group ⇒ DBSubnetGroup?
1534 1535 1536 1537 1538 1539 1540 1541 1542 1543 |
# File 'lib/aws-sdk-rds/db_cluster.rb', line 1534 def subnet_group if data[:db_subnet_group] DBSubnetGroup.new( name: data[:db_subnet_group], client: @client ) else nil end end |
#vpc_security_groups ⇒ Array<Types::VpcSecurityGroupMembership>
Provides a list of VPC security groups that the DB cluster belongs to.
217 218 219 |
# File 'lib/aws-sdk-rds/db_cluster.rb', line 217 def vpc_security_groups data[:vpc_security_groups] end |
#wait_until(options = {}, &block) ⇒ Resource
Use [Aws::RDS::Client] #wait_until instead
The waiting operation is performed on a copy. The original resource remains unchanged
Waiter polls an API operation until a resource enters a desired state.
## Basic Usage
Waiter will polls until it is successful, it fails by entering a terminal state, or until a maximum number of attempts are made.
# polls in a loop until condition is true
resource.wait_until() {|resource| condition}
## Example
instance.wait_until(max_attempts:10, delay:5) {|instance| instance.state.name == 'running' }
## Configuration
You can configure the maximum number of polling attempts, and the delay (in seconds) between each polling attempt. The waiting condition is set by passing a block to #wait_until:
# poll for ~25 seconds
resource.wait_until(max_attempts:5,delay:5) {|resource|...}
## Callbacks
You can be notified before each polling attempt and before each delay. If you throw ‘:success` or `:failure` from these callbacks, it will terminate the waiter.
started_at = Time.now
# poll for 1 hour, instead of a number of attempts
proc = Proc.new do |attempts, response|
throw :failure if Time.now - started_at > 3600
end
# disable max attempts
instance.wait_until(before_wait:proc, max_attempts:nil) {...}
## Handling Errors
When a waiter is successful, it returns the Resource. When a waiter fails, it raises an error.
begin
resource.wait_until(...)
rescue Aws::Waiters::Errors::WaiterFailed
# resource did not enter the desired state in time
end
attempts attempt in seconds invoked before each attempt invoked before each wait
498 499 500 501 502 503 504 505 506 507 508 509 510 511 512 513 |
# File 'lib/aws-sdk-rds/db_cluster.rb', line 498 def wait_until( = {}, &block) self_copy = self.dup attempts = 0 [:max_attempts] = 10 unless .key?(:max_attempts) [:delay] ||= 10 [:poller] = Proc.new do attempts += 1 if block.call(self_copy) [:success, self_copy] else self_copy.reload unless attempts == [:max_attempts] :retry end end Aws::Waiters::Waiter.new().wait({}) end |