@aws-sdk/client-rds 3.391.0 → 3.396.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 (54) hide show
  1. package/README.md +8 -0
  2. package/dist-cjs/RDS.js +2 -0
  3. package/dist-cjs/RDSClient.js +4 -2
  4. package/dist-cjs/clientConfiguration.js +2 -0
  5. package/dist-cjs/commands/SwitchoverGlobalClusterCommand.js +46 -0
  6. package/dist-cjs/commands/index.js +1 -0
  7. package/dist-cjs/models/models_0.js +5 -1
  8. package/dist-cjs/protocols/Aws_query.js +86 -4
  9. package/dist-cjs/runtimeConfig.shared.js +1 -0
  10. package/dist-cjs/runtimeExtensions.js +16 -0
  11. package/dist-es/RDS.js +2 -0
  12. package/dist-es/RDSClient.js +4 -2
  13. package/dist-es/clientConfiguration.js +1 -0
  14. package/dist-es/commands/SwitchoverGlobalClusterCommand.js +42 -0
  15. package/dist-es/commands/index.js +1 -0
  16. package/dist-es/models/models_0.js +4 -0
  17. package/dist-es/protocols/Aws_query.js +80 -0
  18. package/dist-es/runtimeConfig.shared.js +1 -0
  19. package/dist-es/runtimeExtensions.js +12 -0
  20. package/dist-types/RDS.d.ts +7 -0
  21. package/dist-types/RDSClient.d.ts +9 -3
  22. package/dist-types/clientConfiguration.d.ts +6 -0
  23. package/dist-types/commands/CreateGlobalClusterCommand.d.ts +2 -0
  24. package/dist-types/commands/DeleteGlobalClusterCommand.d.ts +2 -0
  25. package/dist-types/commands/DescribeDBEngineVersionsCommand.d.ts +2 -1
  26. package/dist-types/commands/DescribeGlobalClustersCommand.d.ts +2 -0
  27. package/dist-types/commands/FailoverGlobalClusterCommand.d.ts +38 -11
  28. package/dist-types/commands/ModifyGlobalClusterCommand.d.ts +3 -1
  29. package/dist-types/commands/RemoveFromGlobalClusterCommand.d.ts +2 -0
  30. package/dist-types/commands/SwitchoverGlobalClusterCommand.d.ts +124 -0
  31. package/dist-types/commands/index.d.ts +1 -0
  32. package/dist-types/models/models_0.d.ts +46 -245
  33. package/dist-types/models/models_1.d.ts +286 -8
  34. package/dist-types/protocols/Aws_query.d.ts +9 -0
  35. package/dist-types/runtimeConfig.browser.d.ts +1 -0
  36. package/dist-types/runtimeConfig.d.ts +1 -0
  37. package/dist-types/runtimeConfig.native.d.ts +1 -0
  38. package/dist-types/runtimeConfig.shared.d.ts +1 -0
  39. package/dist-types/runtimeExtensions.d.ts +17 -0
  40. package/dist-types/ts3.4/RDS.d.ts +17 -0
  41. package/dist-types/ts3.4/RDSClient.d.ts +9 -0
  42. package/dist-types/ts3.4/clientConfiguration.d.ts +2 -0
  43. package/dist-types/ts3.4/commands/DescribeDBEngineVersionsCommand.d.ts +2 -4
  44. package/dist-types/ts3.4/commands/SwitchoverGlobalClusterCommand.d.ts +42 -0
  45. package/dist-types/ts3.4/commands/index.d.ts +1 -0
  46. package/dist-types/ts3.4/models/models_0.d.ts +8 -12
  47. package/dist-types/ts3.4/models/models_1.d.ts +21 -0
  48. package/dist-types/ts3.4/protocols/Aws_query.d.ts +12 -0
  49. package/dist-types/ts3.4/runtimeConfig.browser.d.ts +1 -0
  50. package/dist-types/ts3.4/runtimeConfig.d.ts +1 -0
  51. package/dist-types/ts3.4/runtimeConfig.native.d.ts +1 -0
  52. package/dist-types/ts3.4/runtimeConfig.shared.d.ts +1 -0
  53. package/dist-types/ts3.4/runtimeExtensions.d.ts +11 -0
  54. package/package.json +3 -3
@@ -4016,6 +4016,10 @@ export interface CreateDBClusterMessage {
4016
4016
  * </p>
4017
4017
  * </li>
4018
4018
  * </ul>
4019
+ * <note>
4020
+ * <p>When you create an Aurora DB cluster with the storage type set to <code>aurora-iopt1</code>, the storage type is returned
4021
+ * in the response. The storage type isn't returned when you set it to <code>aurora</code>.</p>
4022
+ * </note>
4019
4023
  */
4020
4024
  StorageType?: string;
4021
4025
  /**
@@ -9730,26 +9734,26 @@ export declare const FailoverStatus: {
9730
9734
  export type FailoverStatus = (typeof FailoverStatus)[keyof typeof FailoverStatus];
9731
9735
  /**
9732
9736
  * @public
9733
- * <p>Contains the state of scheduled or in-process failover operations on an
9734
- * Aurora global database (<a>GlobalCluster</a>). This Data type is empty unless a failover
9735
- * operation is scheduled or is currently underway on the Aurora global database.</p>
9737
+ * <p>Contains the state of scheduled or in-process operations on a
9738
+ * global cluster (Aurora global database). This data type is empty unless a switchover
9739
+ * or failover operation is scheduled or is in progress on the Aurora global database.</p>
9736
9740
  */
9737
9741
  export interface FailoverState {
9738
9742
  /**
9739
9743
  * @public
9740
- * <p>The current status of the Aurora global database (<a>GlobalCluster</a>). Possible values are as follows:</p>
9744
+ * <p>The current status of the global cluster. Possible values are as follows:</p>
9741
9745
  * <ul>
9742
9746
  * <li>
9743
- * <p>pending – A request to fail over the Aurora global database (<a>GlobalCluster</a>) has been received by the service. The
9744
- * <code>GlobalCluster</code>'s primary DB cluster and the specified secondary DB cluster are being verified before the failover
9745
- * process can start.</p>
9747
+ * <p>pending – The service received a request to switch over or fail over the global cluster. The
9748
+ * global cluster's primary DB cluster and the specified secondary DB cluster are being verified before the operation
9749
+ * starts.</p>
9746
9750
  * </li>
9747
9751
  * <li>
9748
- * <p>failing-over – This status covers the range of Aurora internal operations that take place during the failover process, such
9749
- * as demoting the primary Aurora DB cluster, promoting the secondary Aurora DB, and synchronizing replicas.</p>
9752
+ * <p>failing-over – This status covers the range of Aurora internal operations that take place during the switchover or failover process, such
9753
+ * as demoting the primary Aurora DB cluster, promoting the secondary Aurora DB cluster, and synchronizing replicas.</p>
9750
9754
  * </li>
9751
9755
  * <li>
9752
- * <p>cancelling – The request to fail over the Aurora global database (<a>GlobalCluster</a>) was cancelled and the primary
9756
+ * <p>cancelling – The request to switch over or fail over the global cluster was cancelled and the primary
9753
9757
  * Aurora DB cluster and the selected secondary Aurora DB cluster are returning to their previous states.</p>
9754
9758
  * </li>
9755
9759
  * </ul>
@@ -9767,37 +9771,60 @@ export interface FailoverState {
9767
9771
  * with this state.</p>
9768
9772
  */
9769
9773
  ToDbClusterArn?: string;
9774
+ /**
9775
+ * @public
9776
+ * <p>Indicates whether the operation is a global switchover or a global failover. If data loss is allowed, then the operation is a global failover.
9777
+ * Otherwise, it's a switchover.</p>
9778
+ */
9779
+ IsDataLossAllowed?: boolean;
9770
9780
  }
9781
+ /**
9782
+ * @public
9783
+ * @enum
9784
+ */
9785
+ export declare const GlobalClusterMemberSynchronizationStatus: {
9786
+ readonly CONNECTED: "connected";
9787
+ readonly PENDING_RESYNC: "pending-resync";
9788
+ };
9789
+ /**
9790
+ * @public
9791
+ */
9792
+ export type GlobalClusterMemberSynchronizationStatus = (typeof GlobalClusterMemberSynchronizationStatus)[keyof typeof GlobalClusterMemberSynchronizationStatus];
9771
9793
  /**
9772
9794
  * @public
9773
9795
  * <p>A data structure with information about any primary and
9774
- * secondary clusters associated with an Aurora global database.</p>
9796
+ * secondary clusters associated with a global cluster (Aurora global database).</p>
9775
9797
  */
9776
9798
  export interface GlobalClusterMember {
9777
9799
  /**
9778
9800
  * @public
9779
- * <p>The Amazon Resource Name (ARN) for each Aurora cluster.</p>
9801
+ * <p>The Amazon Resource Name (ARN) for each Aurora DB cluster in the global cluster.</p>
9780
9802
  */
9781
9803
  DBClusterArn?: string;
9782
9804
  /**
9783
9805
  * @public
9784
9806
  * <p>The Amazon Resource Name (ARN) for each read-only secondary cluster
9785
- * associated with the Aurora global database.</p>
9807
+ * associated with the global cluster.</p>
9786
9808
  */
9787
9809
  Readers?: string[];
9788
9810
  /**
9789
9811
  * @public
9790
- * <p>Specifies whether the Aurora cluster is the primary cluster
9791
- * (that is, has read-write capability) for the Aurora global
9792
- * database with which it is associated.</p>
9812
+ * <p>Specifies whether the Aurora DB cluster is the primary cluster
9813
+ * (that is, has read-write capability) for the global
9814
+ * cluster with which it is associated.</p>
9793
9815
  */
9794
9816
  IsWriter?: boolean;
9795
9817
  /**
9796
9818
  * @public
9797
- * <p>Specifies whether a secondary cluster in an Aurora global database has
9819
+ * <p>Specifies whether a secondary cluster in the global cluster has
9798
9820
  * write forwarding enabled, not enabled, or is in the process of enabling it.</p>
9799
9821
  */
9800
9822
  GlobalWriteForwardingStatus?: WriteForwardingStatus | string;
9823
+ /**
9824
+ * @public
9825
+ * <p>The status of synchronization of each Aurora DB cluster in the global cluster.</p>
9826
+ */
9827
+ SynchronizationStatus?: GlobalClusterMemberSynchronizationStatus | string;
9801
9828
  }
9802
9829
  /**
9803
9830
  * @public
@@ -9858,8 +9885,8 @@ export interface GlobalCluster {
9858
9885
  GlobalClusterMembers?: GlobalClusterMember[];
9859
9886
  /**
9860
9887
  * @public
9861
- * <p>A data object containing all properties for the current state of an in-process or pending failover process for this Aurora global database.
9862
- * This object is empty unless the <a>FailoverGlobalCluster</a> API operation has been called on this Aurora global database (<a>GlobalCluster</a>).</p>
9888
+ * <p>A data object containing all properties for the current state of an in-process or pending switchover or failover process for this global cluster (Aurora global database).
9889
+ * This object is empty unless the <code>SwitchoverGlobalCluster</code> or <code>FailoverGlobalCluster</code> operation was called on this global cluster.</p>
9863
9890
  */
9864
9891
  FailoverState?: FailoverState;
9865
9892
  }
@@ -12182,229 +12209,3 @@ export interface DBEngineVersionMessage {
12182
12209
  */
12183
12210
  DBEngineVersions?: DBEngineVersion[];
12184
12211
  }
12185
- /**
12186
- * @public
12187
- */
12188
- export interface DescribeDBEngineVersionsMessage {
12189
- /**
12190
- * @public
12191
- * <p>The database engine to return.</p>
12192
- * <p>Valid Values:</p>
12193
- * <ul>
12194
- * <li>
12195
- * <p>
12196
- * <code>aurora-mysql</code>
12197
- * </p>
12198
- * </li>
12199
- * <li>
12200
- * <p>
12201
- * <code>aurora-postgresql</code>
12202
- * </p>
12203
- * </li>
12204
- * <li>
12205
- * <p>
12206
- * <code>custom-oracle-ee</code>
12207
- * </p>
12208
- * </li>
12209
- * <li>
12210
- * <p>
12211
- * <code>mariadb</code>
12212
- * </p>
12213
- * </li>
12214
- * <li>
12215
- * <p>
12216
- * <code>mysql</code>
12217
- * </p>
12218
- * </li>
12219
- * <li>
12220
- * <p>
12221
- * <code>oracle-ee</code>
12222
- * </p>
12223
- * </li>
12224
- * <li>
12225
- * <p>
12226
- * <code>oracle-ee-cdb</code>
12227
- * </p>
12228
- * </li>
12229
- * <li>
12230
- * <p>
12231
- * <code>oracle-se2</code>
12232
- * </p>
12233
- * </li>
12234
- * <li>
12235
- * <p>
12236
- * <code>oracle-se2-cdb</code>
12237
- * </p>
12238
- * </li>
12239
- * <li>
12240
- * <p>
12241
- * <code>postgres</code>
12242
- * </p>
12243
- * </li>
12244
- * <li>
12245
- * <p>
12246
- * <code>sqlserver-ee</code>
12247
- * </p>
12248
- * </li>
12249
- * <li>
12250
- * <p>
12251
- * <code>sqlserver-se</code>
12252
- * </p>
12253
- * </li>
12254
- * <li>
12255
- * <p>
12256
- * <code>sqlserver-ex</code>
12257
- * </p>
12258
- * </li>
12259
- * <li>
12260
- * <p>
12261
- * <code>sqlserver-web</code>
12262
- * </p>
12263
- * </li>
12264
- * </ul>
12265
- */
12266
- Engine?: string;
12267
- /**
12268
- * @public
12269
- * <p>The database engine version to return.</p>
12270
- * <p>Example: <code>5.1.49</code>
12271
- * </p>
12272
- */
12273
- EngineVersion?: string;
12274
- /**
12275
- * @public
12276
- * <p>The name of a specific DB parameter group family to return details for.</p>
12277
- * <p>Constraints:</p>
12278
- * <ul>
12279
- * <li>
12280
- * <p>If supplied, must match an existing DBParameterGroupFamily.</p>
12281
- * </li>
12282
- * </ul>
12283
- */
12284
- DBParameterGroupFamily?: string;
12285
- /**
12286
- * @public
12287
- * <p>A filter that specifies one or more DB engine versions to describe.</p>
12288
- * <p>Supported filters:</p>
12289
- * <ul>
12290
- * <li>
12291
- * <p>
12292
- * <code>db-parameter-group-family</code> - Accepts parameter groups family names.
12293
- * The results list only includes information about
12294
- * the DB engine versions for these parameter group families.</p>
12295
- * </li>
12296
- * <li>
12297
- * <p>
12298
- * <code>engine</code> - Accepts engine names.
12299
- * The results list only includes information about
12300
- * the DB engine versions for these engines.</p>
12301
- * </li>
12302
- * <li>
12303
- * <p>
12304
- * <code>engine-mode</code> - Accepts DB engine modes.
12305
- * The results list only includes information about
12306
- * the DB engine versions for these engine modes. Valid
12307
- * DB engine modes are the following:</p>
12308
- * <ul>
12309
- * <li>
12310
- * <p>
12311
- * <code>global</code>
12312
- * </p>
12313
- * </li>
12314
- * <li>
12315
- * <p>
12316
- * <code>multimaster</code>
12317
- * </p>
12318
- * </li>
12319
- * <li>
12320
- * <p>
12321
- * <code>parallelquery</code>
12322
- * </p>
12323
- * </li>
12324
- * <li>
12325
- * <p>
12326
- * <code>provisioned</code>
12327
- * </p>
12328
- * </li>
12329
- * <li>
12330
- * <p>
12331
- * <code>serverless</code>
12332
- * </p>
12333
- * </li>
12334
- * </ul>
12335
- * </li>
12336
- * <li>
12337
- * <p>
12338
- * <code>engine-version</code> - Accepts engine versions.
12339
- * The results list only includes information about
12340
- * the DB engine versions for these engine versions.</p>
12341
- * </li>
12342
- * <li>
12343
- * <p>
12344
- * <code>status</code> - Accepts engine version statuses.
12345
- * The results list only includes information about
12346
- * the DB engine versions for these statuses. Valid statuses
12347
- * are the following:</p>
12348
- * <ul>
12349
- * <li>
12350
- * <p>
12351
- * <code>available</code>
12352
- * </p>
12353
- * </li>
12354
- * <li>
12355
- * <p>
12356
- * <code>deprecated</code>
12357
- * </p>
12358
- * </li>
12359
- * </ul>
12360
- * </li>
12361
- * </ul>
12362
- */
12363
- Filters?: Filter[];
12364
- /**
12365
- * @public
12366
- * <p>The maximum number of records to include in the response.
12367
- * If more than the <code>MaxRecords</code> value is available, a pagination token called a marker is
12368
- * included in the response so you can retrieve the remaining results.</p>
12369
- * <p>Default: 100</p>
12370
- * <p>Constraints: Minimum 20, maximum 100.</p>
12371
- */
12372
- MaxRecords?: number;
12373
- /**
12374
- * @public
12375
- * <p>An optional pagination token provided by a previous request.
12376
- * If this parameter is specified, the response includes
12377
- * only records beyond the marker,
12378
- * up to the value specified by <code>MaxRecords</code>.</p>
12379
- */
12380
- Marker?: string;
12381
- /**
12382
- * @public
12383
- * <p>A value that indicates whether only the default version of the specified engine or engine and major version combination is returned.</p>
12384
- */
12385
- DefaultOnly?: boolean;
12386
- /**
12387
- * @public
12388
- * <p>A value that indicates whether to list the supported character sets for each engine version.</p>
12389
- * <p>If this parameter is enabled and the requested engine supports the <code>CharacterSetName</code> parameter for
12390
- * <code>CreateDBInstance</code>, the response includes a list of supported character sets for each engine
12391
- * version.</p>
12392
- * <p>For RDS Custom, the default is not to list supported character sets. If you set <code>ListSupportedCharacterSets</code>
12393
- * to <code>true</code>, RDS Custom returns no results.</p>
12394
- */
12395
- ListSupportedCharacterSets?: boolean;
12396
- /**
12397
- * @public
12398
- * <p>A value that indicates whether to list the supported time zones for each engine version.</p>
12399
- * <p>If this parameter is enabled and the requested engine supports the <code>TimeZone</code> parameter for <code>CreateDBInstance</code>,
12400
- * the response includes a list of supported time zones for each engine version.</p>
12401
- * <p>For RDS Custom, the default is not to list supported time zones. If you set <code>ListSupportedTimezones</code>
12402
- * to <code>true</code>, RDS Custom returns no results.</p>
12403
- */
12404
- ListSupportedTimezones?: boolean;
12405
- /**
12406
- * @public
12407
- * <p>A value that indicates whether to include engine versions that aren't available in the list. The default is to list only available engine versions.</p>
12408
- */
12409
- IncludeAll?: boolean;
12410
- }