aws-sdk-rds 1.80.0 → 1.85.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (34) hide show
  1. checksums.yaml +5 -5
  2. data/lib/aws-sdk-rds.rb +1 -1
  3. data/lib/aws-sdk-rds/account_quota.rb +13 -11
  4. data/lib/aws-sdk-rds/certificate.rb +13 -11
  5. data/lib/aws-sdk-rds/client.rb +280 -151
  6. data/lib/aws-sdk-rds/client_api.rb +18 -1
  7. data/lib/aws-sdk-rds/customizations/auth_token_generator.rb +6 -3
  8. data/lib/aws-sdk-rds/db_cluster.rb +41 -24
  9. data/lib/aws-sdk-rds/db_cluster_parameter_group.rb +13 -11
  10. data/lib/aws-sdk-rds/db_cluster_snapshot.rb +14 -12
  11. data/lib/aws-sdk-rds/db_engine.rb +13 -11
  12. data/lib/aws-sdk-rds/db_engine_version.rb +20 -12
  13. data/lib/aws-sdk-rds/db_instance.rb +98 -76
  14. data/lib/aws-sdk-rds/db_log_file.rb +13 -11
  15. data/lib/aws-sdk-rds/db_parameter_group.rb +13 -11
  16. data/lib/aws-sdk-rds/db_parameter_group_family.rb +13 -11
  17. data/lib/aws-sdk-rds/db_security_group.rb +13 -11
  18. data/lib/aws-sdk-rds/db_snapshot.rb +13 -11
  19. data/lib/aws-sdk-rds/db_snapshot_attribute.rb +13 -11
  20. data/lib/aws-sdk-rds/db_subnet_group.rb +13 -11
  21. data/lib/aws-sdk-rds/event.rb +13 -11
  22. data/lib/aws-sdk-rds/event_category_map.rb +13 -11
  23. data/lib/aws-sdk-rds/event_subscription.rb +13 -11
  24. data/lib/aws-sdk-rds/option_group.rb +13 -11
  25. data/lib/aws-sdk-rds/option_group_option.rb +13 -11
  26. data/lib/aws-sdk-rds/parameter.rb +13 -11
  27. data/lib/aws-sdk-rds/pending_maintenance_action.rb +13 -11
  28. data/lib/aws-sdk-rds/reserved_db_instance.rb +13 -11
  29. data/lib/aws-sdk-rds/reserved_db_instances_offering.rb +13 -11
  30. data/lib/aws-sdk-rds/resource.rb +29 -20
  31. data/lib/aws-sdk-rds/resource_pending_maintenance_action_list.rb +13 -11
  32. data/lib/aws-sdk-rds/types.rb +261 -143
  33. data/lib/aws-sdk-rds/waiters.rb +66 -0
  34. metadata +3 -3
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
- SHA1:
3
- metadata.gz: 8412e671c9a5bb116740036953f0b0c2d3109f99
4
- data.tar.gz: 8907b7ec70f15faf1bbc94cf3cba60b68138bceb
2
+ SHA256:
3
+ metadata.gz: 76e9b510f084d2bb4f1518b9071d27a8484c6b9f3f39869b6669e3e7dfbdca19
4
+ data.tar.gz: cf688bc2584f7b79710b0fcfe6eee5b772a90fa202e69c03050369125cf47320
5
5
  SHA512:
6
- metadata.gz: 82e0ff97d18b4c6263ba8cc9a0aeb3ded05ff364988c9223deb47f18e2f7f4dbe0cbf181cbb9c8904bf19cec5549c2199ef016df6166cc90f545474d7aa5dc76
7
- data.tar.gz: 38c1d72cf7e555bc99ebdc451d9e30f512bab0a1edbdac584ba7dbb235b5cab9593d151fe5bada44a8ec922bea7764b1c22ac1969f083d417d6057af99d4cc3e
6
+ metadata.gz: 530fed5135252cc2560b41597d99148193576ff2f048506b146d52370b9e2b0da885ca1d783faab1198ba84e43c313f965303e414f7e688baeab095ec79a4daf
7
+ data.tar.gz: 5eb0236a995a452f54e21e6b2da9bea721790c6400d81a21ae17e0c4196a1fc8abf46627ddeb0e3c418c2d2211a4d01827ea5c83c7d59d7251314a14054fe463
@@ -71,6 +71,6 @@ require_relative 'aws-sdk-rds/customizations'
71
71
  # @service
72
72
  module Aws::RDS
73
73
 
74
- GEM_VERSION = '1.80.0'
74
+ GEM_VERSION = '1.85.0'
75
75
 
76
76
  end
@@ -80,7 +80,8 @@ module Aws::RDS
80
80
  # Waiter polls an API operation until a resource enters a desired
81
81
  # state.
82
82
  #
83
- # @note The waiting operation is performed on a copy. The original resource remains unchanged
83
+ # @note The waiting operation is performed on a copy. The original resource
84
+ # remains unchanged.
84
85
  #
85
86
  # ## Basic Usage
86
87
  #
@@ -93,13 +94,15 @@ module Aws::RDS
93
94
  #
94
95
  # ## Example
95
96
  #
96
- # instance.wait_until(max_attempts:10, delay:5) {|instance| instance.state.name == 'running' }
97
+ # instance.wait_until(max_attempts:10, delay:5) do |instance|
98
+ # instance.state.name == 'running'
99
+ # end
97
100
  #
98
101
  # ## Configuration
99
102
  #
100
103
  # You can configure the maximum number of polling attempts, and the
101
- # delay (in seconds) between each polling attempt. The waiting condition is set
102
- # by passing a block to {#wait_until}:
104
+ # delay (in seconds) between each polling attempt. The waiting condition is
105
+ # set by passing a block to {#wait_until}:
103
106
  #
104
107
  # # poll for ~25 seconds
105
108
  # resource.wait_until(max_attempts:5,delay:5) {|resource|...}
@@ -130,17 +133,16 @@ module Aws::RDS
130
133
  # # resource did not enter the desired state in time
131
134
  # end
132
135
  #
136
+ # @yieldparam [Resource] resource to be used in the waiting condition.
133
137
  #
134
- # @yield param [Resource] resource to be used in the waiting condition
135
- #
136
- # @raise [Aws::Waiters::Errors::FailureStateError] Raised when the waiter terminates
137
- # because the waiter has entered a state that it will not transition
138
- # out of, preventing success.
138
+ # @raise [Aws::Waiters::Errors::FailureStateError] Raised when the waiter
139
+ # terminates because the waiter has entered a state that it will not
140
+ # transition out of, preventing success.
139
141
  #
140
142
  # yet successful.
141
143
  #
142
- # @raise [Aws::Waiters::Errors::UnexpectedError] Raised when an error is encountered
143
- # while polling for a resource that is not expected.
144
+ # @raise [Aws::Waiters::Errors::UnexpectedError] Raised when an error is
145
+ # encountered while polling for a resource that is not expected.
144
146
  #
145
147
  # @raise [NotImplementedError] Raised when the resource does not
146
148
  #
@@ -116,7 +116,8 @@ module Aws::RDS
116
116
  # Waiter polls an API operation until a resource enters a desired
117
117
  # state.
118
118
  #
119
- # @note The waiting operation is performed on a copy. The original resource remains unchanged
119
+ # @note The waiting operation is performed on a copy. The original resource
120
+ # remains unchanged.
120
121
  #
121
122
  # ## Basic Usage
122
123
  #
@@ -129,13 +130,15 @@ module Aws::RDS
129
130
  #
130
131
  # ## Example
131
132
  #
132
- # instance.wait_until(max_attempts:10, delay:5) {|instance| instance.state.name == 'running' }
133
+ # instance.wait_until(max_attempts:10, delay:5) do |instance|
134
+ # instance.state.name == 'running'
135
+ # end
133
136
  #
134
137
  # ## Configuration
135
138
  #
136
139
  # You can configure the maximum number of polling attempts, and the
137
- # delay (in seconds) between each polling attempt. The waiting condition is set
138
- # by passing a block to {#wait_until}:
140
+ # delay (in seconds) between each polling attempt. The waiting condition is
141
+ # set by passing a block to {#wait_until}:
139
142
  #
140
143
  # # poll for ~25 seconds
141
144
  # resource.wait_until(max_attempts:5,delay:5) {|resource|...}
@@ -166,17 +169,16 @@ module Aws::RDS
166
169
  # # resource did not enter the desired state in time
167
170
  # end
168
171
  #
172
+ # @yieldparam [Resource] resource to be used in the waiting condition.
169
173
  #
170
- # @yield param [Resource] resource to be used in the waiting condition
171
- #
172
- # @raise [Aws::Waiters::Errors::FailureStateError] Raised when the waiter terminates
173
- # because the waiter has entered a state that it will not transition
174
- # out of, preventing success.
174
+ # @raise [Aws::Waiters::Errors::FailureStateError] Raised when the waiter
175
+ # terminates because the waiter has entered a state that it will not
176
+ # transition out of, preventing success.
175
177
  #
176
178
  # yet successful.
177
179
  #
178
- # @raise [Aws::Waiters::Errors::UnexpectedError] Raised when an error is encountered
179
- # while polling for a resource that is not expected.
180
+ # @raise [Aws::Waiters::Errors::UnexpectedError] Raised when an error is
181
+ # encountered while polling for a resource that is not expected.
180
182
  #
181
183
  # @raise [NotImplementedError] Raised when the resource does not
182
184
  #
@@ -107,7 +107,7 @@ module Aws::RDS
107
107
  # @option options [required, String] :region
108
108
  # The AWS region to connect to. The configured `:region` is
109
109
  # used to determine the service `:endpoint`. When not passed,
110
- # a default `:region` is search for in the following locations:
110
+ # a default `:region` is searched for in the following locations:
111
111
  #
112
112
  # * `Aws.config[:region]`
113
113
  # * `ENV['AWS_REGION']`
@@ -163,7 +163,7 @@ module Aws::RDS
163
163
  # @option options [String] :endpoint
164
164
  # The client endpoint is normally constructed from the `:region`
165
165
  # option. You should only configure an `:endpoint` when connecting
166
- # to test endpoints. This should be avalid HTTP(S) URI.
166
+ # to test endpoints. This should be a valid HTTP(S) URI.
167
167
  #
168
168
  # @option options [Integer] :endpoint_cache_max_entries (1000)
169
169
  # Used for the maximum size limit of the LRU cache storing endpoints data
@@ -178,7 +178,7 @@ module Aws::RDS
178
178
  # requests fetching endpoints information. Defaults to 60 sec.
179
179
  #
180
180
  # @option options [Boolean] :endpoint_discovery (false)
181
- # When set to `true`, endpoint discovery will be enabled for operations when available. Defaults to `false`.
181
+ # When set to `true`, endpoint discovery will be enabled for operations when available.
182
182
  #
183
183
  # @option options [Aws::Log::Formatter] :log_formatter (Aws::Log::Formatter.default)
184
184
  # The log formatter.
@@ -271,8 +271,7 @@ module Aws::RDS
271
271
  #
272
272
  # @option options [Integer] :http_read_timeout (60) The default
273
273
  # number of seconds to wait for response data. This value can
274
- # safely be set
275
- # per-request on the session yielded by {#session_for}.
274
+ # safely be set per-request on the session.
276
275
  #
277
276
  # @option options [Float] :http_idle_timeout (5) The number of
278
277
  # seconds a connection is allowed to sit idle before it is
@@ -284,7 +283,7 @@ module Aws::RDS
284
283
  # request body. This option has no effect unless the request has
285
284
  # "Expect" header set to "100-continue". Defaults to `nil` which
286
285
  # disables this behaviour. This value can safely be set per
287
- # request on the session yielded by {#session_for}.
286
+ # request on the session.
288
287
  #
289
288
  # @option options [Boolean] :http_wire_trace (false) When `true`,
290
289
  # HTTP debug output will be sent to the `:logger`.
@@ -1140,7 +1139,7 @@ module Aws::RDS
1140
1139
  # encrypted DB cluster snapshot in the same AWS Region.
1141
1140
  #
1142
1141
  # The pre-signed URL must be a valid request for the
1143
- # `CopyDBSClusterSnapshot` API action that can be executed in the source
1142
+ # `CopyDBClusterSnapshot` API action that can be executed in the source
1144
1143
  # AWS Region that contains the encrypted DB cluster snapshot to be
1145
1144
  # copied. The pre-signed URL request must contain the following
1146
1145
  # parameter values:
@@ -1804,7 +1803,7 @@ module Aws::RDS
1804
1803
  # Creates a new Amazon Aurora DB cluster.
1805
1804
  #
1806
1805
  # You can use the `ReplicationSourceIdentifier` parameter to create the
1807
- # DB cluster as a Read Replica of another DB cluster or Amazon RDS MySQL
1806
+ # DB cluster as a read replica of another DB cluster or Amazon RDS MySQL
1808
1807
  # DB instance. For cross-region replication where the DB cluster
1809
1808
  # identified by `ReplicationSourceIdentifier` is encrypted, you must
1810
1809
  # also specify the `PreSignedUrl` parameter.
@@ -2001,7 +2000,7 @@ module Aws::RDS
2001
2000
  #
2002
2001
  # @option params [String] :replication_source_identifier
2003
2002
  # The Amazon Resource Name (ARN) of the source DB instance or DB cluster
2004
- # if this DB cluster is created as a Read Replica.
2003
+ # if this DB cluster is created as a read replica.
2005
2004
  #
2006
2005
  # @option params [Array<Types::Tag>] :tags
2007
2006
  # Tags to assign to the DB cluster.
@@ -2032,9 +2031,9 @@ module Aws::RDS
2032
2031
  # AWS account has a different default encryption key for each AWS
2033
2032
  # Region.
2034
2033
  #
2035
- # If you create a Read Replica of an encrypted DB cluster in another AWS
2034
+ # If you create a read replica of an encrypted DB cluster in another AWS
2036
2035
  # Region, you must set `KmsKeyId` to a KMS key ID that is valid in the
2037
- # destination AWS Region. This key is used to encrypt the Read Replica
2036
+ # destination AWS Region. This key is used to encrypt the read replica
2038
2037
  # in that AWS Region.
2039
2038
  #
2040
2039
  # @option params [String] :pre_signed_url
@@ -2057,8 +2056,8 @@ module Aws::RDS
2057
2056
  # action that is called in the destination AWS Region, and the action
2058
2057
  # contained in the pre-signed URL.
2059
2058
  #
2060
- # * `DestinationRegion` - The name of the AWS Region that Aurora Read
2061
- # Replica will be created in.
2059
+ # * `DestinationRegion` - The name of the AWS Region that Aurora read
2060
+ # replica will be created in.
2062
2061
  #
2063
2062
  # * `ReplicationSourceIdentifier` - The DB cluster identifier for the
2064
2063
  # encrypted DB cluster to be copied. This identifier must be in the
@@ -2124,6 +2123,12 @@ module Aws::RDS
2124
2123
  # The DB engine mode of the DB cluster, either `provisioned`,
2125
2124
  # `serverless`, `parallelquery`, `global`, or `multimaster`.
2126
2125
  #
2126
+ # <note markdown="1"> `global` engine mode only applies for global database clusters created
2127
+ # with Aurora MySQL version 5.6.10a. For higher Aurora MySQL versions,
2128
+ # the clusters in a global database use `provisioned` engine mode.
2129
+ #
2130
+ # </note>
2131
+ #
2127
2132
  # Limitations and requirements apply to some DB engine modes. For more
2128
2133
  # information, see the following sections in the *Amazon Aurora User
2129
2134
  # Guide*\:
@@ -2182,12 +2187,12 @@ module Aws::RDS
2182
2187
  #
2183
2188
  # For Amazon Aurora DB clusters, Amazon RDS can use Kerberos
2184
2189
  # Authentication to authenticate users that connect to the DB cluster.
2185
- # For more information, see [Using Kerberos Authentication for Aurora
2186
- # MySQL][1] in the *Amazon Aurora User Guide*.
2190
+ # For more information, see [Kerberos Authentication][1] in the *Amazon
2191
+ # Aurora User Guide*.
2187
2192
  #
2188
2193
  #
2189
2194
  #
2190
- # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurmysql-kerberos.html
2195
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/kerberos-authentication.html
2191
2196
  #
2192
2197
  # @option params [String] :domain_iam_role_name
2193
2198
  # Specify the name of the IAM role to be used when making API calls to
@@ -3096,7 +3101,7 @@ module Aws::RDS
3096
3101
  #
3097
3102
  # * Must be a value from 0 to 35
3098
3103
  #
3099
- # * Can't be set to 0 if the DB instance is a source to Read Replicas
3104
+ # * Can't be set to 0 if the DB instance is a source to read replicas
3100
3105
  #
3101
3106
  # @option params [String] :preferred_backup_window
3102
3107
  # The daily time range during which automated backups are created if
@@ -3136,7 +3141,7 @@ module Aws::RDS
3136
3141
  #
3137
3142
  # Default: `3306`
3138
3143
  #
3139
- # Valid Values: `1150-65535`
3144
+ # Valid values: `1150-65535`
3140
3145
  #
3141
3146
  # Type: Integer
3142
3147
  #
@@ -3144,7 +3149,7 @@ module Aws::RDS
3144
3149
  #
3145
3150
  # Default: `3306`
3146
3151
  #
3147
- # Valid Values: `1150-65535`
3152
+ # Valid values: `1150-65535`
3148
3153
  #
3149
3154
  # Type: Integer
3150
3155
  #
@@ -3152,7 +3157,7 @@ module Aws::RDS
3152
3157
  #
3153
3158
  # Default: `5432`
3154
3159
  #
3155
- # Valid Values: `1150-65535`
3160
+ # Valid values: `1150-65535`
3156
3161
  #
3157
3162
  # Type: Integer
3158
3163
  #
@@ -3160,20 +3165,20 @@ module Aws::RDS
3160
3165
  #
3161
3166
  # Default: `1521`
3162
3167
  #
3163
- # Valid Values: `1150-65535`
3168
+ # Valid values: `1150-65535`
3164
3169
  #
3165
3170
  # **SQL Server**
3166
3171
  #
3167
3172
  # Default: `1433`
3168
3173
  #
3169
- # Valid Values: `1150-65535` except for `1434`, `3389`, `47001`,
3170
- # `49152`, and `49152` through `49156`.
3174
+ # Valid values: `1150-65535` except `1234`, `1434`, `3260`, `3343`,
3175
+ # `3389`, `47001`, and `49152-49156`.
3171
3176
  #
3172
3177
  # **Amazon Aurora**
3173
3178
  #
3174
3179
  # Default: `3306`
3175
3180
  #
3176
- # Valid Values: `1150-65535`
3181
+ # Valid values: `1150-65535`
3177
3182
  #
3178
3183
  # Type: Integer
3179
3184
  #
@@ -3366,15 +3371,13 @@ module Aws::RDS
3366
3371
  # Amazon RDS DB Instance Running Microsoft SQL Server][1] in the *Amazon
3367
3372
  # RDS User Guide*.
3368
3373
  #
3369
- # For Oracle DB instance, Amazon RDS can use Kerberos Authentication to
3374
+ # For Oracle DB instances, Amazon RDS can use Kerberos Authentication to
3370
3375
  # authenticate users that connect to the DB instance. For more
3371
3376
  # information, see [ Using Kerberos Authentication with Amazon RDS for
3372
3377
  # Oracle][2] in the *Amazon RDS User Guide*.
3373
3378
  #
3374
3379
  #
3375
3380
  #
3376
- #
3377
- #
3378
3381
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_SQLServerWinAuth.html
3379
3382
  # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/oracle-kerberos.html
3380
3383
  #
@@ -3745,19 +3748,20 @@ module Aws::RDS
3745
3748
  req.send_request(options)
3746
3749
  end
3747
3750
 
3748
- # Creates a new DB instance that acts as a Read Replica for an existing
3749
- # source DB instance. You can create a Read Replica for a DB instance
3750
- # running MySQL, MariaDB, Oracle, or PostgreSQL. For more information,
3751
- # see [Working with Read Replicas][1] in the *Amazon RDS User Guide*.
3751
+ # Creates a new DB instance that acts as a read replica for an existing
3752
+ # source DB instance. You can create a read replica for a DB instance
3753
+ # running MySQL, MariaDB, Oracle, PostgreSQL, or SQL Server. For more
3754
+ # information, see [Working with Read Replicas][1] in the *Amazon RDS
3755
+ # User Guide*.
3752
3756
  #
3753
- # Amazon Aurora doesn't support this action. You must call the
3757
+ # Amazon Aurora doesn't support this action. Call the
3754
3758
  # `CreateDBInstance` action to create a DB instance for an Aurora DB
3755
3759
  # cluster.
3756
3760
  #
3757
- # All Read Replica DB instances are created with backups disabled. All
3761
+ # All read replica DB instances are created with backups disabled. All
3758
3762
  # other DB instance attributes (including DB security groups and DB
3759
3763
  # parameter groups) are inherited from the source DB instance, except as
3760
- # specified following.
3764
+ # specified.
3761
3765
  #
3762
3766
  # Your source DB instance must have backup retention enabled.
3763
3767
  #
@@ -3766,47 +3770,53 @@ module Aws::RDS
3766
3770
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_ReadRepl.html
3767
3771
  #
3768
3772
  # @option params [required, String] :db_instance_identifier
3769
- # The DB instance identifier of the Read Replica. This identifier is the
3773
+ # The DB instance identifier of the read replica. This identifier is the
3770
3774
  # unique key that identifies a DB instance. This parameter is stored as
3771
3775
  # a lowercase string.
3772
3776
  #
3773
3777
  # @option params [required, String] :source_db_instance_identifier
3774
3778
  # The identifier of the DB instance that will act as the source for the
3775
- # Read Replica. Each DB instance can have up to five Read Replicas.
3779
+ # read replica. Each DB instance can have up to five read replicas.
3776
3780
  #
3777
3781
  # Constraints:
3778
3782
  #
3779
- # * Must be the identifier of an existing MySQL, MariaDB, Oracle, or
3780
- # PostgreSQL DB instance.
3783
+ # * Must be the identifier of an existing MySQL, MariaDB, Oracle,
3784
+ # PostgreSQL, or SQL Server DB instance.
3781
3785
  #
3782
- # * Can specify a DB instance that is a MySQL Read Replica only if the
3786
+ # * Can specify a DB instance that is a MySQL read replica only if the
3783
3787
  # source is running MySQL 5.6 or later.
3784
3788
  #
3785
- # * For the limitations of Oracle Read Replicas, see [Read Replica
3789
+ # * For the limitations of Oracle read replicas, see [Read Replica
3786
3790
  # Limitations with Oracle][1] in the *Amazon RDS User Guide*.
3787
3791
  #
3788
- # * Can specify a DB instance that is a PostgreSQL DB instance only if
3789
- # the source is running PostgreSQL 9.3.5 or later (9.4.7 and higher
3790
- # for cross-region replication).
3792
+ # * For the limitations of SQL Server read replicas, see [Read Replica
3793
+ # Limitations with Microsoft SQL Server][2] in the *Amazon RDS User
3794
+ # Guide*.
3791
3795
  #
3792
- # * The specified DB instance must have automatic backups enabled, its
3793
- # backup retention period must be greater than 0.
3796
+ # * Can specify a PostgreSQL DB instance only if the source is running
3797
+ # PostgreSQL 9.3.5 or later (9.4.7 and higher for cross-region
3798
+ # replication).
3794
3799
  #
3795
- # * If the source DB instance is in the same AWS Region as the Read
3796
- # Replica, specify a valid DB instance identifier.
3800
+ # * The specified DB instance must have automatic backups enabled, that
3801
+ # is, its backup retention period must be greater than 0.
3797
3802
  #
3798
- # * If the source DB instance is in a different AWS Region than the Read
3799
- # Replica, specify a valid DB instance ARN. For more information, go
3800
- # to [ Constructing an ARN for Amazon RDS][2] in the *Amazon RDS User
3801
- # Guide*.
3803
+ # * If the source DB instance is in the same AWS Region as the read
3804
+ # replica, specify a valid DB instance identifier.
3805
+ #
3806
+ # * If the source DB instance is in a different AWS Region from the read
3807
+ # replica, specify a valid DB instance ARN. For more information, see
3808
+ # [Constructing an ARN for Amazon RDS][3] in the *Amazon RDS User
3809
+ # Guide*. This doesn't apply to SQL Server, which doesn't support
3810
+ # cross-region replicas.
3802
3811
  #
3803
3812
  #
3804
3813
  #
3805
3814
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/oracle-read-replicas.html
3806
- # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.ARN.html#USER_Tagging.ARN.Constructing
3815
+ # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/SQLServer.ReadReplicas.Limitations.html
3816
+ # [3]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.ARN.html#USER_Tagging.ARN.Constructing
3807
3817
  #
3808
3818
  # @option params [String] :db_instance_class
3809
- # The compute and memory capacity of the Read Replica, for example,
3819
+ # The compute and memory capacity of the read replica, for example,
3810
3820
  # `db.m4.large`. Not all DB instance classes are available in all AWS
3811
3821
  # Regions, or for all database engines. For the full list of DB instance
3812
3822
  # classes, and availability for your engine, see [DB Instance Class][1]
@@ -3819,7 +3829,7 @@ module Aws::RDS
3819
3829
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Concepts.DBInstanceClass.html
3820
3830
  #
3821
3831
  # @option params [String] :availability_zone
3822
- # The Availability Zone (AZ) where the Read Replica will be created.
3832
+ # The Availability Zone (AZ) where the read replica will be created.
3823
3833
  #
3824
3834
  # Default: A random, system-chosen Availability Zone in the endpoint's
3825
3835
  # AWS Region.
@@ -3834,18 +3844,18 @@ module Aws::RDS
3834
3844
  # Valid Values: `1150-65535`
3835
3845
  #
3836
3846
  # @option params [Boolean] :multi_az
3837
- # A value that indicates whether the Read Replica is in a Multi-AZ
3847
+ # A value that indicates whether the read replica is in a Multi-AZ
3838
3848
  # deployment.
3839
3849
  #
3840
- # You can create a Read Replica as a Multi-AZ DB instance. RDS creates a
3850
+ # You can create a read replica as a Multi-AZ DB instance. RDS creates a
3841
3851
  # standby of your replica in another Availability Zone for failover
3842
- # support for the replica. Creating your Read Replica as a Multi-AZ DB
3852
+ # support for the replica. Creating your read replica as a Multi-AZ DB
3843
3853
  # instance is independent of whether the source database is a Multi-AZ
3844
3854
  # DB instance.
3845
3855
  #
3846
3856
  # @option params [Boolean] :auto_minor_version_upgrade
3847
3857
  # A value that indicates whether minor engine upgrades are applied
3848
- # automatically to the Read Replica during the maintenance window.
3858
+ # automatically to the read replica during the maintenance window.
3849
3859
  #
3850
3860
  # Default: Inherits from the source DB instance
3851
3861
  #
@@ -3857,13 +3867,18 @@ module Aws::RDS
3857
3867
  # The option group the DB instance is associated with. If omitted, the
3858
3868
  # option group associated with the source instance is used.
3859
3869
  #
3870
+ # <note markdown="1"> For SQL Server, you must use the option group associated with the
3871
+ # source instance.
3872
+ #
3873
+ # </note>
3874
+ #
3860
3875
  # @option params [String] :db_parameter_group_name
3861
3876
  # The name of the DB parameter group to associate with this DB instance.
3862
3877
  #
3863
3878
  # If you do not specify a value for `DBParameterGroupName`, then Amazon
3864
3879
  # RDS uses the `DBParameterGroup` of source DB instance for a same
3865
- # region Read Replica, or the default `DBParameterGroup` for the
3866
- # specified DB engine for a cross region Read Replica.
3880
+ # region read replica, or the default `DBParameterGroup` for the
3881
+ # specified DB engine for a cross region read replica.
3867
3882
  #
3868
3883
  # <note markdown="1"> Currently, specifying a parameter group for this operation is only
3869
3884
  # supported for Oracle DB instances.
@@ -3910,25 +3925,25 @@ module Aws::RDS
3910
3925
  # * The specified DB subnet group must be in the same AWS Region in
3911
3926
  # which the operation is running.
3912
3927
  #
3913
- # * All Read Replicas in one AWS Region that are created from the same
3928
+ # * All read replicas in one AWS Region that are created from the same
3914
3929
  # source DB instance must either:&gt;
3915
3930
  #
3916
- # * Specify DB subnet groups from the same VPC. All these Read
3917
- # Replicas are created in the same VPC.
3931
+ # * Specify DB subnet groups from the same VPC. All these read
3932
+ # replicas are created in the same VPC.
3918
3933
  #
3919
- # * Not specify a DB subnet group. All these Read Replicas are created
3934
+ # * Not specify a DB subnet group. All these read replicas are created
3920
3935
  # outside of any VPC.
3921
3936
  #
3922
3937
  # Example: `mySubnetgroup`
3923
3938
  #
3924
3939
  # @option params [Array<String>] :vpc_security_group_ids
3925
- # A list of EC2 VPC security groups to associate with the Read Replica.
3940
+ # A list of EC2 VPC security groups to associate with the read replica.
3926
3941
  #
3927
3942
  # Default: The default EC2 VPC security group for the DB subnet group's
3928
3943
  # VPC.
3929
3944
  #
3930
3945
  # @option params [String] :storage_type
3931
- # Specifies the storage type to be associated with the Read Replica.
3946
+ # Specifies the storage type to be associated with the read replica.
3932
3947
  #
3933
3948
  # Valid values: `standard | gp2 | io1`
3934
3949
  #
@@ -3938,12 +3953,12 @@ module Aws::RDS
3938
3953
  # Default: `io1` if the `Iops` parameter is specified, otherwise `gp2`
3939
3954
  #
3940
3955
  # @option params [Boolean] :copy_tags_to_snapshot
3941
- # A value that indicates whether to copy all tags from the Read Replica
3942
- # to snapshots of the Read Replica. By default, tags are not copied.
3956
+ # A value that indicates whether to copy all tags from the read replica
3957
+ # to snapshots of the read replica. By default, tags are not copied.
3943
3958
  #
3944
3959
  # @option params [Integer] :monitoring_interval
3945
3960
  # The interval, in seconds, between points when Enhanced Monitoring
3946
- # metrics are collected for the Read Replica. To disable collecting
3961
+ # metrics are collected for the read replica. To disable collecting
3947
3962
  # Enhanced Monitoring metrics, specify 0. The default is 0.
3948
3963
  #
3949
3964
  # If `MonitoringRoleArn` is specified, then you must also set
@@ -3966,22 +3981,22 @@ module Aws::RDS
3966
3981
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Monitoring.html#USER_Monitoring.OS.IAMRole
3967
3982
  #
3968
3983
  # @option params [String] :kms_key_id
3969
- # The AWS KMS key ID for an encrypted Read Replica. The KMS key ID is
3984
+ # The AWS KMS key ID for an encrypted read replica. The KMS key ID is
3970
3985
  # the Amazon Resource Name (ARN), KMS key identifier, or the KMS key
3971
3986
  # alias for the KMS encryption key.
3972
3987
  #
3973
- # If you create an encrypted Read Replica in the same AWS Region as the
3988
+ # If you create an encrypted read replica in the same AWS Region as the
3974
3989
  # source DB instance, then you do not have to specify a value for this
3975
- # parameter. The Read Replica is encrypted with the same KMS key as the
3990
+ # parameter. The read replica is encrypted with the same KMS key as the
3976
3991
  # source DB instance.
3977
3992
  #
3978
- # If you create an encrypted Read Replica in a different AWS Region,
3993
+ # If you create an encrypted read replica in a different AWS Region,
3979
3994
  # then you must specify a KMS key for the destination AWS Region. KMS
3980
3995
  # encryption keys are specific to the AWS Region that they are created
3981
3996
  # in, and you can't use encryption keys from one AWS Region in another
3982
3997
  # AWS Region.
3983
3998
  #
3984
- # You can't create an encrypted Read Replica from an unencrypted DB
3999
+ # You can't create an encrypted read replica from an unencrypted DB
3985
4000
  # instance.
3986
4001
  #
3987
4002
  # @option params [String] :pre_signed_url
@@ -3989,9 +4004,9 @@ module Aws::RDS
3989
4004
  # `CreateDBInstanceReadReplica` API action in the source AWS Region that
3990
4005
  # contains the source DB instance.
3991
4006
  #
3992
- # You must specify this parameter when you create an encrypted Read
3993
- # Replica from another AWS Region by using the Amazon RDS API. Don't
3994
- # specify `PreSignedUrl` when you are creating an encrypted Read Replica
4007
+ # You must specify this parameter when you create an encrypted read
4008
+ # replica from another AWS Region by using the Amazon RDS API. Don't
4009
+ # specify `PreSignedUrl` when you are creating an encrypted read replica
3995
4010
  # in the same AWS Region.
3996
4011
  #
3997
4012
  # The presigned URL must be a valid request for the
@@ -3999,7 +4014,7 @@ module Aws::RDS
3999
4014
  # source AWS Region that contains the encrypted source DB instance. The
4000
4015
  # presigned URL request must contain the following parameter values:
4001
4016
  #
4002
- # * `DestinationRegion` - The AWS Region that the encrypted Read Replica
4017
+ # * `DestinationRegion` - The AWS Region that the encrypted read replica
4003
4018
  # is created in. This AWS Region is the same one where the
4004
4019
  # `CreateDBInstanceReadReplica` action is called that contains this
4005
4020
  # presigned URL.
@@ -4013,7 +4028,7 @@ module Aws::RDS
4013
4028
  # presigned URL must be set to the us-east-1 AWS Region.
4014
4029
  #
4015
4030
  # * `KmsKeyId` - The AWS KMS key identifier for the key to use to
4016
- # encrypt the Read Replica in the destination AWS Region. This is the
4031
+ # encrypt the read replica in the destination AWS Region. This is the
4017
4032
  # same identifier for both the `CreateDBInstanceReadReplica` action
4018
4033
  # that is called in the destination AWS Region, and the action
4019
4034
  # contained in the presigned URL.
@@ -4021,7 +4036,7 @@ module Aws::RDS
4021
4036
  # * `SourceDBInstanceIdentifier` - The DB instance identifier for the
4022
4037
  # encrypted DB instance to be replicated. This identifier must be in
4023
4038
  # the Amazon Resource Name (ARN) format for the source AWS Region. For
4024
- # example, if you are creating an encrypted Read Replica from a DB
4039
+ # example, if you are creating an encrypted read replica from a DB
4025
4040
  # instance in the us-west-2 AWS Region, then your
4026
4041
  # `SourceDBInstanceIdentifier` looks like the following example:
4027
4042
  # `arn:aws:rds:us-west-2:123456789012:instance:mysql-instance1-20161115`.
@@ -4033,9 +4048,12 @@ module Aws::RDS
4033
4048
  # <note markdown="1"> If you are using an AWS SDK tool or the AWS CLI, you can specify
4034
4049
  # `SourceRegion` (or `--source-region` for the AWS CLI) instead of
4035
4050
  # specifying `PreSignedUrl` manually. Specifying `SourceRegion`
4036
- # autogenerates a pre-signed URL that is a valid request for the
4051
+ # autogenerates a presigned URL that is a valid request for the
4037
4052
  # operation that can be executed in the source AWS Region.
4038
4053
  #
4054
+ # `SourceRegion` isn't supported for SQL Server, because SQL Server on
4055
+ # Amazon RDS doesn't support cross-region read replicas.
4056
+ #
4039
4057
  # </note>
4040
4058
  #
4041
4059
  #
@@ -4059,7 +4077,7 @@ module Aws::RDS
4059
4077
  #
4060
4078
  # @option params [Boolean] :enable_performance_insights
4061
4079
  # A value that indicates whether to enable Performance Insights for the
4062
- # Read Replica.
4080
+ # read replica.
4063
4081
  #
4064
4082
  # For more information, see [Using Amazon Performance Insights][1] in
4065
4083
  # the *Amazon RDS User Guide*.
@@ -4118,9 +4136,16 @@ module Aws::RDS
4118
4136
  # information, see [ Using Kerberos Authentication with Amazon RDS for
4119
4137
  # Oracle][1] in the *Amazon RDS User Guide*.
4120
4138
  #
4139
+ # For Microsoft SQL Server DB instances, Amazon RDS can use Windows
4140
+ # Authentication to authenticate users that connect to the DB instance.
4141
+ # For more information, see [ Using Windows Authentication with an
4142
+ # Amazon RDS DB Instance Running Microsoft SQL Server][2] in the *Amazon
4143
+ # RDS User Guide*.
4144
+ #
4121
4145
  #
4122
4146
  #
4123
4147
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/oracle-kerberos.html
4148
+ # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_SQLServerWinAuth.html
4124
4149
  #
4125
4150
  # @option params [String] :domain_iam_role_name
4126
4151
  # Specify the name of the IAM role to be used when making API calls to
@@ -4465,9 +4490,8 @@ module Aws::RDS
4465
4490
  # @option params [required, String] :engine_family
4466
4491
  # The kinds of databases that the proxy can connect to. This value
4467
4492
  # determines which database network protocol the proxy recognizes when
4468
- # it interprets network traffic to and from the database. Currently,
4469
- # this value is always `MYSQL`. The engine family applies to both RDS
4470
- # MySQL and Aurora MySQL.
4493
+ # it interprets network traffic to and from the database. The engine
4494
+ # family applies to MySQL and PostgreSQL for both RDS and Aurora.
4471
4495
  #
4472
4496
  # @option params [required, Array<Types::UserAuthConfig>] :auth
4473
4497
  # The authorization mechanism that the proxy uses.
@@ -4513,7 +4537,7 @@ module Aws::RDS
4513
4537
  #
4514
4538
  # resp = client.create_db_proxy({
4515
4539
  # db_proxy_name: "String", # required
4516
- # engine_family: "MYSQL", # required, accepts MYSQL
4540
+ # engine_family: "MYSQL", # required, accepts MYSQL, POSTGRESQL
4517
4541
  # auth: [ # required
4518
4542
  # {
4519
4543
  # description: "String",
@@ -4541,7 +4565,7 @@ module Aws::RDS
4541
4565
  #
4542
4566
  # resp.db_proxy.db_proxy_name #=> String
4543
4567
  # resp.db_proxy.db_proxy_arn #=> String
4544
- # resp.db_proxy.status #=> String, one of "available", "modifying", "incompatible-network", "insufficient-resource-limits", "creating", "deleting"
4568
+ # resp.db_proxy.status #=> String, one of "available", "modifying", "incompatible-network", "insufficient-resource-limits", "creating", "deleting", "suspended", "suspending", "reactivating"
4545
4569
  # resp.db_proxy.engine_family #=> String
4546
4570
  # resp.db_proxy.vpc_security_group_ids #=> Array
4547
4571
  # resp.db_proxy.vpc_security_group_ids[0] #=> String
@@ -5631,14 +5655,14 @@ module Aws::RDS
5631
5655
  # you can't delete the DB instance if both of the following conditions
5632
5656
  # are true:
5633
5657
  #
5634
- # * The DB cluster is a Read Replica of another Amazon Aurora DB
5658
+ # * The DB cluster is a read replica of another Amazon Aurora DB
5635
5659
  # cluster.
5636
5660
  #
5637
5661
  # * The DB instance is the only instance in the DB cluster.
5638
5662
  #
5639
5663
  # To delete a DB instance in this case, first call the
5640
5664
  # `PromoteReadReplicaDBCluster` API action to promote the DB cluster so
5641
- # it's no longer a Read Replica. After the promotion completes, then
5665
+ # it's no longer a read replica. After the promotion completes, then
5642
5666
  # call the `DeleteDBInstance` API action to delete the final instance in
5643
5667
  # the DB cluster.
5644
5668
  #
@@ -5663,7 +5687,7 @@ module Aws::RDS
5663
5687
  # 'failed', 'incompatible-restore', or 'incompatible-network', it
5664
5688
  # can only be deleted when skip is specified.
5665
5689
  #
5666
- # Specify skip when deleting a Read Replica.
5690
+ # Specify skip when deleting a read replica.
5667
5691
  #
5668
5692
  # <note markdown="1"> The FinalDBSnapshotIdentifier parameter must be specified if skip
5669
5693
  # isn't specified.
@@ -5687,7 +5711,7 @@ module Aws::RDS
5687
5711
  #
5688
5712
  # * Can't end with a hyphen or contain two consecutive hyphens.
5689
5713
  #
5690
- # * Can't be specified when deleting a Read Replica.
5714
+ # * Can't be specified when deleting a read replica.
5691
5715
  #
5692
5716
  # @option params [Boolean] :delete_automated_backups
5693
5717
  # A value that indicates whether to remove automated backups immediately
@@ -5966,7 +5990,7 @@ module Aws::RDS
5966
5990
  #
5967
5991
  # resp.db_proxy.db_proxy_name #=> String
5968
5992
  # resp.db_proxy.db_proxy_arn #=> String
5969
- # resp.db_proxy.status #=> String, one of "available", "modifying", "incompatible-network", "insufficient-resource-limits", "creating", "deleting"
5993
+ # resp.db_proxy.status #=> String, one of "available", "modifying", "incompatible-network", "insufficient-resource-limits", "creating", "deleting", "suspended", "suspending", "reactivating"
5970
5994
  # resp.db_proxy.engine_family #=> String
5971
5995
  # resp.db_proxy.vpc_security_group_ids #=> Array
5972
5996
  # resp.db_proxy.vpc_security_group_ids[0] #=> String
@@ -6559,6 +6583,8 @@ module Aws::RDS
6559
6583
  # * {Types::CustomAvailabilityZoneMessage#marker #marker} => String
6560
6584
  # * {Types::CustomAvailabilityZoneMessage#custom_availability_zones #custom_availability_zones} => Array&lt;Types::CustomAvailabilityZone&gt;
6561
6585
  #
6586
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
6587
+ #
6562
6588
  # @example Request syntax with placeholder values
6563
6589
  #
6564
6590
  # resp = client.describe_custom_availability_zones({
@@ -7254,6 +7280,12 @@ module Aws::RDS
7254
7280
  # resp.db_cluster_snapshots[0].source_db_cluster_snapshot_arn #=> String
7255
7281
  # resp.db_cluster_snapshots[0].iam_database_authentication_enabled #=> Boolean
7256
7282
  #
7283
+ #
7284
+ # The following waiters are defined for this operation (see {Client#wait_until} for detailed usage):
7285
+ #
7286
+ # * db_cluster_snapshot_available
7287
+ # * db_cluster_snapshot_deleted
7288
+ #
7257
7289
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeDBClusterSnapshots AWS API Documentation
7258
7290
  #
7259
7291
  # @overload describe_db_cluster_snapshots(params = {})
@@ -7325,6 +7357,8 @@ module Aws::RDS
7325
7357
  # * {Types::DBClusterMessage#marker #marker} => String
7326
7358
  # * {Types::DBClusterMessage#db_clusters #db_clusters} => Array&lt;Types::DBCluster&gt;
7327
7359
  #
7360
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
7361
+ #
7328
7362
  #
7329
7363
  # @example Example: To list DB clusters
7330
7364
  #
@@ -7510,6 +7544,8 @@ module Aws::RDS
7510
7544
  # * {Types::DBEngineVersionMessage#marker #marker} => String
7511
7545
  # * {Types::DBEngineVersionMessage#db_engine_versions #db_engine_versions} => Array&lt;Types::DBEngineVersion&gt;
7512
7546
  #
7547
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
7548
+ #
7513
7549
  #
7514
7550
  # @example Example: To list DB engine version settings
7515
7551
  #
@@ -7650,6 +7686,8 @@ module Aws::RDS
7650
7686
  # * {Types::DBInstanceAutomatedBackupMessage#marker #marker} => String
7651
7687
  # * {Types::DBInstanceAutomatedBackupMessage#db_instance_automated_backups #db_instance_automated_backups} => Array&lt;Types::DBInstanceAutomatedBackup&gt;
7652
7688
  #
7689
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
7690
+ #
7653
7691
  # @example Request syntax with placeholder values
7654
7692
  #
7655
7693
  # resp = client.describe_db_instance_automated_backups({
@@ -7768,6 +7806,8 @@ module Aws::RDS
7768
7806
  # * {Types::DBInstanceMessage#marker #marker} => String
7769
7807
  # * {Types::DBInstanceMessage#db_instances #db_instances} => Array&lt;Types::DBInstance&gt;
7770
7808
  #
7809
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
7810
+ #
7771
7811
  #
7772
7812
  # @example Example: To list DB instance settings
7773
7813
  #
@@ -7913,6 +7953,12 @@ module Aws::RDS
7913
7953
  # resp.db_instances[0].listener_endpoint.hosted_zone_id #=> String
7914
7954
  # resp.db_instances[0].max_allocated_storage #=> Integer
7915
7955
  #
7956
+ #
7957
+ # The following waiters are defined for this operation (see {Client#wait_until} for detailed usage):
7958
+ #
7959
+ # * db_instance_available
7960
+ # * db_instance_deleted
7961
+ #
7916
7962
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeDBInstances AWS API Documentation
7917
7963
  #
7918
7964
  # @overload describe_db_instances(params = {})
@@ -7965,6 +8011,8 @@ module Aws::RDS
7965
8011
  # * {Types::DescribeDBLogFilesResponse#describe_db_log_files #describe_db_log_files} => Array&lt;Types::DescribeDBLogFilesDetails&gt;
7966
8012
  # * {Types::DescribeDBLogFilesResponse#marker #marker} => String
7967
8013
  #
8014
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
8015
+ #
7968
8016
  #
7969
8017
  # @example Example: To list DB log file names
7970
8018
  #
@@ -8054,6 +8102,8 @@ module Aws::RDS
8054
8102
  # * {Types::DBParameterGroupsMessage#marker #marker} => String
8055
8103
  # * {Types::DBParameterGroupsMessage#db_parameter_groups #db_parameter_groups} => Array&lt;Types::DBParameterGroup&gt;
8056
8104
  #
8105
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
8106
+ #
8057
8107
  #
8058
8108
  # @example Example: To list information about DB parameter groups
8059
8109
  #
@@ -8142,6 +8192,8 @@ module Aws::RDS
8142
8192
  # * {Types::DBParameterGroupDetails#parameters #parameters} => Array&lt;Types::Parameter&gt;
8143
8193
  # * {Types::DBParameterGroupDetails#marker #marker} => String
8144
8194
  #
8195
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
8196
+ #
8145
8197
  #
8146
8198
  # @example Example: To list information about DB parameters
8147
8199
  #
@@ -8231,6 +8283,8 @@ module Aws::RDS
8231
8283
  # * {Types::DescribeDBProxiesResponse#db_proxies #db_proxies} => Array&lt;Types::DBProxy&gt;
8232
8284
  # * {Types::DescribeDBProxiesResponse#marker #marker} => String
8233
8285
  #
8286
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
8287
+ #
8234
8288
  # @example Request syntax with placeholder values
8235
8289
  #
8236
8290
  # resp = client.describe_db_proxies({
@@ -8250,7 +8304,7 @@ module Aws::RDS
8250
8304
  # resp.db_proxies #=> Array
8251
8305
  # resp.db_proxies[0].db_proxy_name #=> String
8252
8306
  # resp.db_proxies[0].db_proxy_arn #=> String
8253
- # resp.db_proxies[0].status #=> String, one of "available", "modifying", "incompatible-network", "insufficient-resource-limits", "creating", "deleting"
8307
+ # resp.db_proxies[0].status #=> String, one of "available", "modifying", "incompatible-network", "insufficient-resource-limits", "creating", "deleting", "suspended", "suspending", "reactivating"
8254
8308
  # resp.db_proxies[0].engine_family #=> String
8255
8309
  # resp.db_proxies[0].vpc_security_group_ids #=> Array
8256
8310
  # resp.db_proxies[0].vpc_security_group_ids[0] #=> String
@@ -8317,6 +8371,8 @@ module Aws::RDS
8317
8371
  # * {Types::DescribeDBProxyTargetGroupsResponse#target_groups #target_groups} => Array&lt;Types::DBProxyTargetGroup&gt;
8318
8372
  # * {Types::DescribeDBProxyTargetGroupsResponse#marker #marker} => String
8319
8373
  #
8374
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
8375
+ #
8320
8376
  # @example Request syntax with placeholder values
8321
8377
  #
8322
8378
  # resp = client.describe_db_proxy_target_groups({
@@ -8396,6 +8452,8 @@ module Aws::RDS
8396
8452
  # * {Types::DescribeDBProxyTargetsResponse#targets #targets} => Array&lt;Types::DBProxyTarget&gt;
8397
8453
  # * {Types::DescribeDBProxyTargetsResponse#marker #marker} => String
8398
8454
  #
8455
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
8456
+ #
8399
8457
  # @example Request syntax with placeholder values
8400
8458
  #
8401
8459
  # resp = client.describe_db_proxy_targets({
@@ -8420,6 +8478,9 @@ module Aws::RDS
8420
8478
  # resp.targets[0].rds_resource_id #=> String
8421
8479
  # resp.targets[0].port #=> Integer
8422
8480
  # resp.targets[0].type #=> String, one of "RDS_INSTANCE", "RDS_SERVERLESS_ENDPOINT", "TRACKED_CLUSTER"
8481
+ # resp.targets[0].target_health.state #=> String, one of "REGISTERING", "AVAILABLE", "UNAVAILABLE"
8482
+ # resp.targets[0].target_health.reason #=> String, one of "UNREACHABLE", "CONNECTION_FAILED", "AUTH_FAILURE", "PENDING_PROXY_CAPACITY"
8483
+ # resp.targets[0].target_health.description #=> String
8423
8484
  # resp.marker #=> String
8424
8485
  #
8425
8486
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeDBProxyTargets AWS API Documentation
@@ -8462,6 +8523,8 @@ module Aws::RDS
8462
8523
  # * {Types::DBSecurityGroupMessage#marker #marker} => String
8463
8524
  # * {Types::DBSecurityGroupMessage#db_security_groups #db_security_groups} => Array&lt;Types::DBSecurityGroup&gt;
8464
8525
  #
8526
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
8527
+ #
8465
8528
  #
8466
8529
  # @example Example: To list DB security group settings
8467
8530
  #
@@ -8699,6 +8762,8 @@ module Aws::RDS
8699
8762
  # * {Types::DBSnapshotMessage#marker #marker} => String
8700
8763
  # * {Types::DBSnapshotMessage#db_snapshots #db_snapshots} => Array&lt;Types::DBSnapshot&gt;
8701
8764
  #
8765
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
8766
+ #
8702
8767
  #
8703
8768
  # @example Example: To list DB snapshot attributes
8704
8769
  #
@@ -8769,6 +8834,12 @@ module Aws::RDS
8769
8834
  # resp.db_snapshots[0].processor_features[0].value #=> String
8770
8835
  # resp.db_snapshots[0].dbi_resource_id #=> String
8771
8836
  #
8837
+ #
8838
+ # The following waiters are defined for this operation (see {Client#wait_until} for detailed usage):
8839
+ #
8840
+ # * db_snapshot_available
8841
+ # * db_snapshot_deleted
8842
+ #
8772
8843
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeDBSnapshots AWS API Documentation
8773
8844
  #
8774
8845
  # @overload describe_db_snapshots(params = {})
@@ -8815,6 +8886,8 @@ module Aws::RDS
8815
8886
  # * {Types::DBSubnetGroupMessage#marker #marker} => String
8816
8887
  # * {Types::DBSubnetGroupMessage#db_subnet_groups #db_subnet_groups} => Array&lt;Types::DBSubnetGroup&gt;
8817
8888
  #
8889
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
8890
+ #
8818
8891
  #
8819
8892
  # @example Example: To list information about DB subnet groups
8820
8893
  #
@@ -8987,6 +9060,8 @@ module Aws::RDS
8987
9060
  #
8988
9061
  # * {Types::DescribeEngineDefaultParametersResult#engine_defaults #engine_defaults} => Types::EngineDefaults
8989
9062
  #
9063
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
9064
+ #
8990
9065
  #
8991
9066
  # @example Example: To list default parameters for a DB engine
8992
9067
  #
@@ -9141,6 +9216,8 @@ module Aws::RDS
9141
9216
  # * {Types::EventSubscriptionsMessage#marker #marker} => String
9142
9217
  # * {Types::EventSubscriptionsMessage#event_subscriptions_list #event_subscriptions_list} => Array&lt;Types::EventSubscription&gt;
9143
9218
  #
9219
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
9220
+ #
9144
9221
  #
9145
9222
  # @example Example: To list information about DB event notification subscriptions
9146
9223
  #
@@ -9280,6 +9357,8 @@ module Aws::RDS
9280
9357
  # * {Types::EventsMessage#marker #marker} => String
9281
9358
  # * {Types::EventsMessage#events #events} => Array&lt;Types::Event&gt;
9282
9359
  #
9360
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
9361
+ #
9283
9362
  #
9284
9363
  # @example Example: To list information about events
9285
9364
  #
@@ -9386,6 +9465,8 @@ module Aws::RDS
9386
9465
  # * {Types::ExportTasksMessage#marker #marker} => String
9387
9466
  # * {Types::ExportTasksMessage#export_tasks #export_tasks} => Array&lt;Types::ExportTask&gt;
9388
9467
  #
9468
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
9469
+ #
9389
9470
  # @example Request syntax with placeholder values
9390
9471
  #
9391
9472
  # resp = client.describe_export_tasks({
@@ -9488,6 +9569,8 @@ module Aws::RDS
9488
9569
  # * {Types::GlobalClustersMessage#marker #marker} => String
9489
9570
  # * {Types::GlobalClustersMessage#global_clusters #global_clusters} => Array&lt;Types::GlobalCluster&gt;
9490
9571
  #
9572
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
9573
+ #
9491
9574
  # @example Request syntax with placeholder values
9492
9575
  #
9493
9576
  # resp = client.describe_global_clusters({
@@ -9568,6 +9651,8 @@ module Aws::RDS
9568
9651
  # * {Types::InstallationMediaMessage#marker #marker} => String
9569
9652
  # * {Types::InstallationMediaMessage#installation_media #installation_media} => Array&lt;Types::InstallationMedia&gt;
9570
9653
  #
9654
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
9655
+ #
9571
9656
  # @example Request syntax with placeholder values
9572
9657
  #
9573
9658
  # resp = client.describe_installation_media({
@@ -9637,6 +9722,8 @@ module Aws::RDS
9637
9722
  # * {Types::OptionGroupOptionsMessage#option_group_options #option_group_options} => Array&lt;Types::OptionGroupOption&gt;
9638
9723
  # * {Types::OptionGroupOptionsMessage#marker #marker} => String
9639
9724
  #
9725
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
9726
+ #
9640
9727
  #
9641
9728
  # @example Example: To list information about DB option group options
9642
9729
  #
@@ -9749,6 +9836,8 @@ module Aws::RDS
9749
9836
  # * {Types::OptionGroups#option_groups_list #option_groups_list} => Array&lt;Types::OptionGroup&gt;
9750
9837
  # * {Types::OptionGroups#marker #marker} => String
9751
9838
  #
9839
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
9840
+ #
9752
9841
  #
9753
9842
  # @example Example: To list information about DB option groups
9754
9843
  #
@@ -9841,6 +9930,14 @@ module Aws::RDS
9841
9930
  # The license model filter value. Specify this parameter to show only
9842
9931
  # the available offerings matching the specified license model.
9843
9932
  #
9933
+ # @option params [String] :availability_zone_group
9934
+ # The Availability Zone group associated with a Local Zone. Specify this
9935
+ # parameter to retrieve available offerings for the Local Zones in the
9936
+ # group.
9937
+ #
9938
+ # Omit this parameter to show the available offerings in the specified
9939
+ # AWS Region.
9940
+ #
9844
9941
  # @option params [Boolean] :vpc
9845
9942
  # A value that indicates whether to show only VPC or non-VPC offerings.
9846
9943
  #
@@ -9868,6 +9965,8 @@ module Aws::RDS
9868
9965
  # * {Types::OrderableDBInstanceOptionsMessage#orderable_db_instance_options #orderable_db_instance_options} => Array&lt;Types::OrderableDBInstanceOption&gt;
9869
9966
  # * {Types::OrderableDBInstanceOptionsMessage#marker #marker} => String
9870
9967
  #
9968
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
9969
+ #
9871
9970
  #
9872
9971
  # @example Example: To list information about orderable DB instance options
9873
9972
  #
@@ -9893,6 +9992,7 @@ module Aws::RDS
9893
9992
  # engine_version: "String",
9894
9993
  # db_instance_class: "String",
9895
9994
  # license_model: "String",
9995
+ # availability_zone_group: "String",
9896
9996
  # vpc: false,
9897
9997
  # filters: [
9898
9998
  # {
@@ -9911,6 +10011,7 @@ module Aws::RDS
9911
10011
  # resp.orderable_db_instance_options[0].engine_version #=> String
9912
10012
  # resp.orderable_db_instance_options[0].db_instance_class #=> String
9913
10013
  # resp.orderable_db_instance_options[0].license_model #=> String
10014
+ # resp.orderable_db_instance_options[0].availability_zone_group #=> String
9914
10015
  # resp.orderable_db_instance_options[0].availability_zones #=> Array
9915
10016
  # resp.orderable_db_instance_options[0].availability_zones[0].name #=> String
9916
10017
  # resp.orderable_db_instance_options[0].multi_az_capable #=> Boolean
@@ -10107,6 +10208,8 @@ module Aws::RDS
10107
10208
  # * {Types::ReservedDBInstanceMessage#marker #marker} => String
10108
10209
  # * {Types::ReservedDBInstanceMessage#reserved_db_instances #reserved_db_instances} => Array&lt;Types::ReservedDBInstance&gt;
10109
10210
  #
10211
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
10212
+ #
10110
10213
  #
10111
10214
  # @example Example: To list information about reserved DB instances
10112
10215
  #
@@ -10239,6 +10342,8 @@ module Aws::RDS
10239
10342
  # * {Types::ReservedDBInstancesOfferingMessage#marker #marker} => String
10240
10343
  # * {Types::ReservedDBInstancesOfferingMessage#reserved_db_instances_offerings #reserved_db_instances_offerings} => Array&lt;Types::ReservedDBInstancesOffering&gt;
10241
10344
  #
10345
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
10346
+ #
10242
10347
  #
10243
10348
  # @example Example: To list information about reserved DB instance offerings
10244
10349
  #
@@ -10303,7 +10408,7 @@ module Aws::RDS
10303
10408
  end
10304
10409
 
10305
10410
  # Returns a list of the source AWS Regions where the current AWS Region
10306
- # can create a Read Replica or copy a DB snapshot from. This API action
10411
+ # can create a read replica or copy a DB snapshot from. This API action
10307
10412
  # supports pagination.
10308
10413
  #
10309
10414
  # @option params [String] :region_name
@@ -10534,6 +10639,8 @@ module Aws::RDS
10534
10639
  # * {Types::DownloadDBLogFilePortionDetails#marker #marker} => String
10535
10640
  # * {Types::DownloadDBLogFilePortionDetails#additional_data_pending #additional_data_pending} => Boolean
10536
10641
  #
10642
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
10643
+ #
10537
10644
  #
10538
10645
  # @example Example: To list information about DB log files
10539
10646
  #
@@ -11956,13 +12063,13 @@ module Aws::RDS
11956
12063
  #
11957
12064
  # * Must be a value from 0 to 35
11958
12065
  #
11959
- # * Can be specified for a MySQL Read Replica only if the source is
12066
+ # * Can be specified for a MySQL read replica only if the source is
11960
12067
  # running MySQL 5.6 or later
11961
12068
  #
11962
- # * Can be specified for a PostgreSQL Read Replica only if the source is
12069
+ # * Can be specified for a PostgreSQL read replica only if the source is
11963
12070
  # running PostgreSQL 9.3.5
11964
12071
  #
11965
- # * Can't be set to 0 if the DB instance is a source to Read Replicas
12072
+ # * Can't be set to 0 if the DB instance is a source to read replicas
11966
12073
  #
11967
12074
  # @option params [String] :preferred_backup_window
11968
12075
  # The daily time range during which automated backups are created if
@@ -12073,7 +12180,7 @@ module Aws::RDS
12073
12180
  # performance degradation. While the migration takes place, nightly
12074
12181
  # backups for the instance are suspended. No other Amazon RDS operations
12075
12182
  # can take place for the instance, including modifying the instance,
12076
- # rebooting the instance, deleting the instance, creating a Read Replica
12183
+ # rebooting the instance, deleting the instance, creating a read replica
12077
12184
  # for the instance, and creating a DB snapshot of the instance.
12078
12185
  #
12079
12186
  # Constraints: For MariaDB, MySQL, Oracle, and PostgreSQL, the value
@@ -12133,7 +12240,7 @@ module Aws::RDS
12133
12240
  # performance degradation. While the migration takes place, nightly
12134
12241
  # backups for the instance are suspended. No other Amazon RDS operations
12135
12242
  # can take place for the instance, including modifying the instance,
12136
- # rebooting the instance, deleting the instance, creating a Read Replica
12243
+ # rebooting the instance, deleting the instance, creating a read replica
12137
12244
  # for the instance, and creating a DB snapshot of the instance.
12138
12245
  #
12139
12246
  # Valid values: `standard | gp2 | io1`
@@ -12209,19 +12316,19 @@ module Aws::RDS
12209
12316
  #
12210
12317
  # Default: `3306`
12211
12318
  #
12212
- # Valid Values: `1150-65535`
12319
+ # Valid values: `1150-65535`
12213
12320
  #
12214
12321
  # **MariaDB**
12215
12322
  #
12216
12323
  # Default: `3306`
12217
12324
  #
12218
- # Valid Values: `1150-65535`
12325
+ # Valid values: `1150-65535`
12219
12326
  #
12220
12327
  # **PostgreSQL**
12221
12328
  #
12222
12329
  # Default: `5432`
12223
12330
  #
12224
- # Valid Values: `1150-65535`
12331
+ # Valid values: `1150-65535`
12225
12332
  #
12226
12333
  # Type: Integer
12227
12334
  #
@@ -12229,20 +12336,20 @@ module Aws::RDS
12229
12336
  #
12230
12337
  # Default: `1521`
12231
12338
  #
12232
- # Valid Values: `1150-65535`
12339
+ # Valid values: `1150-65535`
12233
12340
  #
12234
12341
  # **SQL Server**
12235
12342
  #
12236
12343
  # Default: `1433`
12237
12344
  #
12238
- # Valid Values: `1150-65535` except for `1434`, `3389`, `47001`,
12239
- # `49152`, and `49152` through `49156`.
12345
+ # Valid values: `1150-65535` except `1234`, `1434`, `3260`, `3343`,
12346
+ # `3389`, `47001`, and `49152-49156`.
12240
12347
  #
12241
12348
  # **Amazon Aurora**
12242
12349
  #
12243
12350
  # Default: `3306`
12244
12351
  #
12245
- # Valid Values: `1150-65535`
12352
+ # Valid values: `1150-65535`
12246
12353
  #
12247
12354
  # @option params [Boolean] :publicly_accessible
12248
12355
  # A value that indicates whether the DB instance is publicly accessible.
@@ -12778,7 +12885,7 @@ module Aws::RDS
12778
12885
  #
12779
12886
  # resp.db_proxy.db_proxy_name #=> String
12780
12887
  # resp.db_proxy.db_proxy_arn #=> String
12781
- # resp.db_proxy.status #=> String, one of "available", "modifying", "incompatible-network", "insufficient-resource-limits", "creating", "deleting"
12888
+ # resp.db_proxy.status #=> String, one of "available", "modifying", "incompatible-network", "insufficient-resource-limits", "creating", "deleting", "suspended", "suspending", "reactivating"
12782
12889
  # resp.db_proxy.engine_family #=> String
12783
12890
  # resp.db_proxy.vpc_security_group_ids #=> Array
12784
12891
  # resp.db_proxy.vpc_security_group_ids[0] #=> String
@@ -12874,8 +12981,8 @@ module Aws::RDS
12874
12981
  req.send_request(options)
12875
12982
  end
12876
12983
 
12877
- # Updates a manual DB snapshot, which can be encrypted or not encrypted,
12878
- # with a new engine version.
12984
+ # Updates a manual DB snapshot with a new engine version. The snapshot
12985
+ # can be encrypted or unencrypted, but not shared or public.
12879
12986
  #
12880
12987
  # Amazon RDS supports upgrading DB snapshots for MySQL, Oracle, and
12881
12988
  # PostgreSQL.
@@ -13454,16 +13561,16 @@ module Aws::RDS
13454
13561
  req.send_request(options)
13455
13562
  end
13456
13563
 
13457
- # Promotes a Read Replica DB instance to a standalone DB instance.
13564
+ # Promotes a read replica DB instance to a standalone DB instance.
13458
13565
  #
13459
13566
  # <note markdown="1"> * Backup duration is a function of the amount of changes to the
13460
- # database since the previous backup. If you plan to promote a Read
13461
- # Replica to a standalone instance, we recommend that you enable
13567
+ # database since the previous backup. If you plan to promote a read
13568
+ # replica to a standalone instance, we recommend that you enable
13462
13569
  # backups and complete at least one backup prior to promotion. In
13463
- # addition, a Read Replica cannot be promoted to a standalone instance
13570
+ # addition, a read replica cannot be promoted to a standalone instance
13464
13571
  # when it is in the `backing-up` status. If you have enabled backups
13465
- # on your Read Replica, configure the automated backup window so that
13466
- # daily backups do not interfere with Read Replica promotion.
13572
+ # on your read replica, configure the automated backup window so that
13573
+ # daily backups do not interfere with read replica promotion.
13467
13574
  #
13468
13575
  # * This command doesn't apply to Aurora MySQL and Aurora PostgreSQL.
13469
13576
  #
@@ -13475,7 +13582,7 @@ module Aws::RDS
13475
13582
  #
13476
13583
  # Constraints:
13477
13584
  #
13478
- # * Must match the identifier of an existing Read Replica DB instance.
13585
+ # * Must match the identifier of an existing read replica DB instance.
13479
13586
  #
13480
13587
  # ^
13481
13588
  #
@@ -13492,7 +13599,7 @@ module Aws::RDS
13492
13599
  #
13493
13600
  # * Must be a value from 0 to 35.
13494
13601
  #
13495
- # * Can't be set to 0 if the DB instance is a source to Read Replicas.
13602
+ # * Can't be set to 0 if the DB instance is a source to read replicas.
13496
13603
  #
13497
13604
  # @option params [String] :preferred_backup_window
13498
13605
  # The daily time range during which automated backups are created if
@@ -13672,19 +13779,19 @@ module Aws::RDS
13672
13779
  req.send_request(options)
13673
13780
  end
13674
13781
 
13675
- # Promotes a Read Replica DB cluster to a standalone DB cluster.
13782
+ # Promotes a read replica DB cluster to a standalone DB cluster.
13676
13783
  #
13677
13784
  # <note markdown="1"> This action only applies to Aurora DB clusters.
13678
13785
  #
13679
13786
  # </note>
13680
13787
  #
13681
13788
  # @option params [required, String] :db_cluster_identifier
13682
- # The identifier of the DB cluster Read Replica to promote. This
13789
+ # The identifier of the DB cluster read replica to promote. This
13683
13790
  # parameter isn't case-sensitive.
13684
13791
  #
13685
13792
  # Constraints:
13686
13793
  #
13687
- # * Must match the identifier of an existing DBCluster Read Replica.
13794
+ # * Must match the identifier of an existing DB cluster read replica.
13688
13795
  #
13689
13796
  # ^
13690
13797
  #
@@ -14104,6 +14211,9 @@ module Aws::RDS
14104
14211
  # resp.db_proxy_targets[0].rds_resource_id #=> String
14105
14212
  # resp.db_proxy_targets[0].port #=> Integer
14106
14213
  # resp.db_proxy_targets[0].type #=> String, one of "RDS_INSTANCE", "RDS_SERVERLESS_ENDPOINT", "TRACKED_CLUSTER"
14214
+ # resp.db_proxy_targets[0].target_health.state #=> String, one of "REGISTERING", "AVAILABLE", "UNAVAILABLE"
14215
+ # resp.db_proxy_targets[0].target_health.reason #=> String, one of "UNREACHABLE", "CONNECTION_FAILED", "AUTH_FAILURE", "PENDING_PROXY_CAPACITY"
14216
+ # resp.db_proxy_targets[0].target_health.description #=> String
14107
14217
  #
14108
14218
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/RegisterDBProxyTargets AWS API Documentation
14109
14219
  #
@@ -14562,6 +14672,18 @@ module Aws::RDS
14562
14672
  # described in [ Migrating Data to an Amazon Aurora MySQL DB Cluster][1]
14563
14673
  # in the *Amazon Aurora User Guide*.
14564
14674
  #
14675
+ # <note markdown="1"> This action only restores the DB cluster, not the DB instances for
14676
+ # that DB cluster. You must invoke the `CreateDBInstance` action to
14677
+ # create DB instances for the restored DB cluster, specifying the
14678
+ # identifier of the restored DB cluster in `DBClusterIdentifier`. You
14679
+ # can create DB instances only after the `RestoreDBClusterFromS3` action
14680
+ # has completed and the DB cluster is available.
14681
+ #
14682
+ # </note>
14683
+ #
14684
+ # For more information on Amazon Aurora, see [ What Is Amazon
14685
+ # Aurora?][2] in the *Amazon Aurora User Guide.*
14686
+ #
14565
14687
  # <note markdown="1"> This action only applies to Aurora DB clusters.
14566
14688
  #
14567
14689
  # </note>
@@ -14569,6 +14691,7 @@ module Aws::RDS
14569
14691
  #
14570
14692
  #
14571
14693
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/AuroraMySQL.Migrating.html
14694
+ # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html
14572
14695
  #
14573
14696
  # @option params [Array<String>] :availability_zones
14574
14697
  # A list of Availability Zones (AZs) where instances in the restored DB
@@ -14846,12 +14969,12 @@ module Aws::RDS
14846
14969
  #
14847
14970
  # For Amazon Aurora DB clusters, Amazon RDS can use Kerberos
14848
14971
  # Authentication to authenticate users that connect to the DB cluster.
14849
- # For more information, see [Using Kerberos Authentication for Aurora
14850
- # MySQL][1] in the *Amazon Aurora User Guide*.
14972
+ # For more information, see [Kerberos Authentication][1] in the *Amazon
14973
+ # Aurora User Guide*.
14851
14974
  #
14852
14975
  #
14853
14976
  #
14854
- # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurmysql-kerberos.html
14977
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/kerberos-authentication.html
14855
14978
  #
14856
14979
  # @option params [String] :domain_iam_role_name
14857
14980
  # Specify the name of the IAM role to be used when making API calls to
@@ -14990,16 +15113,20 @@ module Aws::RDS
14990
15113
  end
14991
15114
 
14992
15115
  # Creates a new DB cluster from a DB snapshot or DB cluster snapshot.
15116
+ # This action only applies to Aurora DB clusters.
14993
15117
  #
14994
- # If a DB snapshot is specified, the target DB cluster is created from
14995
- # the source DB snapshot with a default configuration and default
14996
- # security group.
15118
+ # The target DB cluster is created from the source snapshot with a
15119
+ # default configuration. If you don't specify a security group, the new
15120
+ # DB cluster is associated with the default security group.
14997
15121
  #
14998
- # If a DB cluster snapshot is specified, the target DB cluster is
14999
- # created from the source DB cluster restore point with the same
15000
- # configuration as the original source DB cluster. If you don't specify
15001
- # a security group, the new DB cluster is associated with the default
15002
- # security group.
15122
+ # <note markdown="1"> This action only restores the DB cluster, not the DB instances for
15123
+ # that DB cluster. You must invoke the `CreateDBInstance` action to
15124
+ # create DB instances for the restored DB cluster, specifying the
15125
+ # identifier of the restored DB cluster in `DBClusterIdentifier`. You
15126
+ # can create DB instances only after the `RestoreDBClusterFromSnapshot`
15127
+ # action has completed and the DB cluster is available.
15128
+ #
15129
+ # </note>
15003
15130
  #
15004
15131
  # For more information on Amazon Aurora, see [ What Is Amazon
15005
15132
  # Aurora?][1] in the *Amazon Aurora User Guide.*
@@ -15572,12 +15699,12 @@ module Aws::RDS
15572
15699
  #
15573
15700
  # For Amazon Aurora DB clusters, Amazon RDS can use Kerberos
15574
15701
  # Authentication to authenticate users that connect to the DB cluster.
15575
- # For more information, see [Using Kerberos Authentication for Aurora
15576
- # MySQL][1] in the *Amazon Aurora User Guide*.
15702
+ # For more information, see [Kerberos Authentication][1] in the *Amazon
15703
+ # Aurora User Guide*.
15577
15704
  #
15578
15705
  #
15579
15706
  #
15580
- # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurmysql-kerberos.html
15707
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/kerberos-authentication.html
15581
15708
  #
15582
15709
  # @option params [String] :domain_iam_role_name
15583
15710
  # Specify the name of the IAM role to be used when making API calls to
@@ -17874,17 +18001,19 @@ module Aws::RDS
17874
18001
  # provided, all the snapshot data is exported. Valid values are the
17875
18002
  # following:
17876
18003
  #
17877
- # * `database` - Export all the data of the snapshot.
18004
+ # * `database` - Export all the data from a specified database.
17878
18005
  #
17879
- # * `database.table [table-name]` - Export a table of the snapshot.
18006
+ # * `database.table` *table-name* - Export a table of the snapshot. This
18007
+ # format is valid only for RDS for MySQL, RDS for MariaDB, and Aurora
18008
+ # MySQL.
17880
18009
  #
17881
- # * `database.schema [schema-name]` - Export a database schema of the
17882
- # snapshot. This value isn't valid for RDS for MySQL, RDS for
17883
- # MariaDB, or Aurora MySQL.
18010
+ # * `database.schema` *schema-name* - Export a database schema of the
18011
+ # snapshot. This format is valid only for RDS for PostgreSQL and
18012
+ # Aurora PostgreSQL.
17884
18013
  #
17885
- # * `database.schema.table [table-name]` - Export a table of the
17886
- # database schema. This value isn't valid for RDS for MySQL, RDS for
17887
- # MariaDB, or Aurora MySQL.
18014
+ # * `database.schema.table` *table-name* - Export a table of the
18015
+ # database schema. This format is valid only for RDS for PostgreSQL
18016
+ # and Aurora PostgreSQL.
17888
18017
  #
17889
18018
  # @return [Types::ExportTask] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
17890
18019
  #
@@ -18284,7 +18413,7 @@ module Aws::RDS
18284
18413
  params: params,
18285
18414
  config: config)
18286
18415
  context[:gem_name] = 'aws-sdk-rds'
18287
- context[:gem_version] = '1.80.0'
18416
+ context[:gem_version] = '1.85.0'
18288
18417
  Seahorse::Client::Request.new(handlers, context)
18289
18418
  end
18290
18419
 
@@ -18350,14 +18479,14 @@ module Aws::RDS
18350
18479
  # The following table lists the valid waiter names, the operations they call,
18351
18480
  # and the default `:delay` and `:max_attempts` values.
18352
18481
  #
18353
- # | waiter_name | params | :delay | :max_attempts |
18354
- # | ----------------------------- | -------------------------------- | -------- | ------------- |
18355
- # | db_cluster_snapshot_available | {#describe_db_cluster_snapshots} | 30 | 60 |
18356
- # | db_cluster_snapshot_deleted | {#describe_db_cluster_snapshots} | 30 | 60 |
18357
- # | db_instance_available | {#describe_db_instances} | 30 | 60 |
18358
- # | db_instance_deleted | {#describe_db_instances} | 30 | 60 |
18359
- # | db_snapshot_available | {#describe_db_snapshots} | 30 | 60 |
18360
- # | db_snapshot_deleted | {#describe_db_snapshots} | 30 | 60 |
18482
+ # | waiter_name | params | :delay | :max_attempts |
18483
+ # | ----------------------------- | -------------------------------------- | -------- | ------------- |
18484
+ # | db_cluster_snapshot_available | {Client#describe_db_cluster_snapshots} | 30 | 60 |
18485
+ # | db_cluster_snapshot_deleted | {Client#describe_db_cluster_snapshots} | 30 | 60 |
18486
+ # | db_instance_available | {Client#describe_db_instances} | 30 | 60 |
18487
+ # | db_instance_deleted | {Client#describe_db_instances} | 30 | 60 |
18488
+ # | db_snapshot_available | {Client#describe_db_snapshots} | 30 | 60 |
18489
+ # | db_snapshot_deleted | {Client#describe_db_snapshots} | 30 | 60 |
18361
18490
  #
18362
18491
  # @raise [Errors::FailureStateError] Raised when the waiter terminates
18363
18492
  # because the waiter has entered a state that it will not transition