From fb8ad1a222d78af980a252144eecbb217cd23e9d Mon Sep 17 00:00:00 2001 From: awstools Date: Fri, 17 Nov 2023 20:13:27 +0000 Subject: [PATCH] feat(client-rds): This release adds support for option groups and replica enhancements to Amazon RDS Custom. --- .../CopyDBClusterParameterGroupCommand.ts | 4 + .../commands/CopyDBParameterGroupCommand.ts | 4 + .../src/commands/CreateDBClusterCommand.ts | 18 +++ .../src/commands/DeleteDBClusterCommand.ts | 10 ++ ...escribeDBClusterAutomatedBackupsCommand.ts | 3 +- .../src/commands/DescribeDBClustersCommand.ts | 10 ++ .../src/commands/FailoverDBClusterCommand.ts | 10 ++ .../src/commands/ModifyDBClusterCommand.ts | 13 ++ .../PromoteReadReplicaDBClusterCommand.ts | 10 ++ .../src/commands/RebootDBClusterCommand.ts | 10 ++ .../commands/RestoreDBClusterFromS3Command.ts | 10 ++ .../RestoreDBClusterFromSnapshotCommand.ts | 11 ++ .../RestoreDBClusterToPointInTimeCommand.ts | 11 ++ .../src/commands/StartDBClusterCommand.ts | 10 ++ .../src/commands/StopDBClusterCommand.ts | 10 ++ clients/client-rds/src/models/models_0.ts | 130 +++++++++++------- clients/client-rds/src/models/models_1.ts | 19 +++ clients/client-rds/src/protocols/Aws_query.ts | 57 +++++++- codegen/sdk-codegen/aws-models/rds.json | 66 ++++++++- 19 files changed, 358 insertions(+), 58 deletions(-) diff --git a/clients/client-rds/src/commands/CopyDBClusterParameterGroupCommand.ts b/clients/client-rds/src/commands/CopyDBClusterParameterGroupCommand.ts index 957502ec3141..784e959580d7 100644 --- a/clients/client-rds/src/commands/CopyDBClusterParameterGroupCommand.ts +++ b/clients/client-rds/src/commands/CopyDBClusterParameterGroupCommand.ts @@ -38,6 +38,10 @@ export interface CopyDBClusterParameterGroupCommandOutput extends CopyDBClusterP /** * @public *

Copies the specified DB cluster parameter group.

+ * + *

You can't copy a default DB cluster parameter group. Instead, create a new custom DB cluster parameter group, which copies + * the default parameters and values for the specified DB cluster parameter group family.

+ * * @example * Use a bare-bones client and the command you need to make an API call. * ```javascript diff --git a/clients/client-rds/src/commands/CopyDBParameterGroupCommand.ts b/clients/client-rds/src/commands/CopyDBParameterGroupCommand.ts index fef5f589a73d..d3c8221b9665 100644 --- a/clients/client-rds/src/commands/CopyDBParameterGroupCommand.ts +++ b/clients/client-rds/src/commands/CopyDBParameterGroupCommand.ts @@ -38,6 +38,10 @@ export interface CopyDBParameterGroupCommandOutput extends CopyDBParameterGroupR /** * @public *

Copies the specified DB parameter group.

+ * + *

You can't copy a default DB parameter group. Instead, create a new custom DB parameter group, which copies the default + * parameters and values for the specified DB parameter group family.

+ * * @example * Use a bare-bones client and the command you need to make an API call. * ```javascript diff --git a/clients/client-rds/src/commands/CreateDBClusterCommand.ts b/clients/client-rds/src/commands/CreateDBClusterCommand.ts index d901f0ab0a90..959a55312555 100644 --- a/clients/client-rds/src/commands/CreateDBClusterCommand.ts +++ b/clients/client-rds/src/commands/CreateDBClusterCommand.ts @@ -106,6 +106,7 @@ export interface CreateDBClusterCommandOutput extends CreateDBClusterResult, __M * RdsCustomClusterConfiguration: { // RdsCustomClusterConfiguration * InterconnectSubnetId: "STRING_VALUE", * TransitGatewayMulticastDomainId: "STRING_VALUE", + * ReplicaMode: "open-read-only" || "mounted", * }, * DeletionProtection: true || false, * GlobalClusterIdentifier: "STRING_VALUE", @@ -176,6 +177,14 @@ export interface CreateDBClusterCommandOutput extends CreateDBClusterResult, __M * // ReadReplicaIdentifiers: [ // ReadReplicaIdentifierList * // "STRING_VALUE", * // ], + * // StatusInfos: [ // DBClusterStatusInfoList + * // { // DBClusterStatusInfo + * // StatusType: "STRING_VALUE", + * // Normal: true || false, + * // Status: "STRING_VALUE", + * // Message: "STRING_VALUE", + * // }, + * // ], * // DBClusterMembers: [ // DBClusterMemberList * // { // DBClusterMember * // DBInstanceIdentifier: "STRING_VALUE", @@ -224,6 +233,7 @@ export interface CreateDBClusterCommandOutput extends CreateDBClusterResult, __M * // RdsCustomClusterConfiguration: { // RdsCustomClusterConfiguration * // InterconnectSubnetId: "STRING_VALUE", * // TransitGatewayMulticastDomainId: "STRING_VALUE", + * // ReplicaMode: "open-read-only" || "mounted", * // }, * // DeletionProtection: true || false, * // HttpEndpointEnabled: true || false, @@ -272,6 +282,7 @@ export interface CreateDBClusterCommandOutput extends CreateDBClusterResult, __M * // RdsCustomClusterConfiguration: { * // InterconnectSubnetId: "STRING_VALUE", * // TransitGatewayMulticastDomainId: "STRING_VALUE", + * // ReplicaMode: "open-read-only" || "mounted", * // }, * // Iops: Number("int"), * // StorageType: "STRING_VALUE", @@ -356,6 +367,10 @@ export interface CreateDBClusterCommandOutput extends CreateDBClusterResult, __M * @throws {@link InvalidDBInstanceStateFault} (client fault) *

The DB instance isn't in a valid state.

* + * @throws {@link InvalidDBSubnetGroupFault} (client fault) + *

The DBSubnetGroup doesn't belong to the same VPC as that of an existing + * cross-region read replica of the same source instance.

+ * * @throws {@link InvalidDBSubnetGroupStateFault} (client fault) *

The DB subnet group cannot be deleted because it's in use.

* @@ -372,6 +387,9 @@ export interface CreateDBClusterCommandOutput extends CreateDBClusterResult, __M * @throws {@link KMSKeyNotAccessibleFault} (client fault) *

An error occurred accessing an Amazon Web Services KMS key.

* + * @throws {@link OptionGroupNotFoundFault} (client fault) + *

The specified option group could not be found.

+ * * @throws {@link StorageQuotaExceededFault} (client fault) *

The request would result in the user exceeding the allowed amount of storage * available across all DB instances.

diff --git a/clients/client-rds/src/commands/DeleteDBClusterCommand.ts b/clients/client-rds/src/commands/DeleteDBClusterCommand.ts index 8a6502db6e8e..56c48692f5ee 100644 --- a/clients/client-rds/src/commands/DeleteDBClusterCommand.ts +++ b/clients/client-rds/src/commands/DeleteDBClusterCommand.ts @@ -101,6 +101,14 @@ export interface DeleteDBClusterCommandOutput extends DeleteDBClusterResult, __M * // ReadReplicaIdentifiers: [ // ReadReplicaIdentifierList * // "STRING_VALUE", * // ], + * // StatusInfos: [ // DBClusterStatusInfoList + * // { // DBClusterStatusInfo + * // StatusType: "STRING_VALUE", + * // Normal: true || false, + * // Status: "STRING_VALUE", + * // Message: "STRING_VALUE", + * // }, + * // ], * // DBClusterMembers: [ // DBClusterMemberList * // { // DBClusterMember * // DBInstanceIdentifier: "STRING_VALUE", @@ -149,6 +157,7 @@ export interface DeleteDBClusterCommandOutput extends DeleteDBClusterResult, __M * // RdsCustomClusterConfiguration: { // RdsCustomClusterConfiguration * // InterconnectSubnetId: "STRING_VALUE", * // TransitGatewayMulticastDomainId: "STRING_VALUE", + * // ReplicaMode: "open-read-only" || "mounted", * // }, * // DeletionProtection: true || false, * // HttpEndpointEnabled: true || false, @@ -197,6 +206,7 @@ export interface DeleteDBClusterCommandOutput extends DeleteDBClusterResult, __M * // RdsCustomClusterConfiguration: { * // InterconnectSubnetId: "STRING_VALUE", * // TransitGatewayMulticastDomainId: "STRING_VALUE", + * // ReplicaMode: "open-read-only" || "mounted", * // }, * // Iops: Number("int"), * // StorageType: "STRING_VALUE", diff --git a/clients/client-rds/src/commands/DescribeDBClusterAutomatedBackupsCommand.ts b/clients/client-rds/src/commands/DescribeDBClusterAutomatedBackupsCommand.ts index d3c05a328844..f1ead17cd577 100644 --- a/clients/client-rds/src/commands/DescribeDBClusterAutomatedBackupsCommand.ts +++ b/clients/client-rds/src/commands/DescribeDBClusterAutomatedBackupsCommand.ts @@ -14,8 +14,7 @@ import { SMITHY_CONTEXT_KEY, } from "@smithy/types"; -import { DBClusterAutomatedBackupMessage } from "../models/models_0"; -import { DescribeDBClusterAutomatedBackupsMessage } from "../models/models_1"; +import { DBClusterAutomatedBackupMessage, DescribeDBClusterAutomatedBackupsMessage } from "../models/models_1"; import { de_DescribeDBClusterAutomatedBackupsCommand, se_DescribeDBClusterAutomatedBackupsCommand, diff --git a/clients/client-rds/src/commands/DescribeDBClustersCommand.ts b/clients/client-rds/src/commands/DescribeDBClustersCommand.ts index f48e29b78bfc..5d071809c437 100644 --- a/clients/client-rds/src/commands/DescribeDBClustersCommand.ts +++ b/clients/client-rds/src/commands/DescribeDBClustersCommand.ts @@ -108,6 +108,14 @@ export interface DescribeDBClustersCommandOutput extends DBClusterMessage, __Met * // ReadReplicaIdentifiers: [ // ReadReplicaIdentifierList * // "STRING_VALUE", * // ], + * // StatusInfos: [ // DBClusterStatusInfoList + * // { // DBClusterStatusInfo + * // StatusType: "STRING_VALUE", + * // Normal: true || false, + * // Status: "STRING_VALUE", + * // Message: "STRING_VALUE", + * // }, + * // ], * // DBClusterMembers: [ // DBClusterMemberList * // { // DBClusterMember * // DBInstanceIdentifier: "STRING_VALUE", @@ -156,6 +164,7 @@ export interface DescribeDBClustersCommandOutput extends DBClusterMessage, __Met * // RdsCustomClusterConfiguration: { // RdsCustomClusterConfiguration * // InterconnectSubnetId: "STRING_VALUE", * // TransitGatewayMulticastDomainId: "STRING_VALUE", + * // ReplicaMode: "open-read-only" || "mounted", * // }, * // DeletionProtection: true || false, * // HttpEndpointEnabled: true || false, @@ -204,6 +213,7 @@ export interface DescribeDBClustersCommandOutput extends DBClusterMessage, __Met * // RdsCustomClusterConfiguration: { * // InterconnectSubnetId: "STRING_VALUE", * // TransitGatewayMulticastDomainId: "STRING_VALUE", + * // ReplicaMode: "open-read-only" || "mounted", * // }, * // Iops: Number("int"), * // StorageType: "STRING_VALUE", diff --git a/clients/client-rds/src/commands/FailoverDBClusterCommand.ts b/clients/client-rds/src/commands/FailoverDBClusterCommand.ts index 244aa1784df0..8f49266501a3 100644 --- a/clients/client-rds/src/commands/FailoverDBClusterCommand.ts +++ b/clients/client-rds/src/commands/FailoverDBClusterCommand.ts @@ -105,6 +105,14 @@ export interface FailoverDBClusterCommandOutput extends FailoverDBClusterResult, * // ReadReplicaIdentifiers: [ // ReadReplicaIdentifierList * // "STRING_VALUE", * // ], + * // StatusInfos: [ // DBClusterStatusInfoList + * // { // DBClusterStatusInfo + * // StatusType: "STRING_VALUE", + * // Normal: true || false, + * // Status: "STRING_VALUE", + * // Message: "STRING_VALUE", + * // }, + * // ], * // DBClusterMembers: [ // DBClusterMemberList * // { // DBClusterMember * // DBInstanceIdentifier: "STRING_VALUE", @@ -153,6 +161,7 @@ export interface FailoverDBClusterCommandOutput extends FailoverDBClusterResult, * // RdsCustomClusterConfiguration: { // RdsCustomClusterConfiguration * // InterconnectSubnetId: "STRING_VALUE", * // TransitGatewayMulticastDomainId: "STRING_VALUE", + * // ReplicaMode: "open-read-only" || "mounted", * // }, * // DeletionProtection: true || false, * // HttpEndpointEnabled: true || false, @@ -201,6 +210,7 @@ export interface FailoverDBClusterCommandOutput extends FailoverDBClusterResult, * // RdsCustomClusterConfiguration: { * // InterconnectSubnetId: "STRING_VALUE", * // TransitGatewayMulticastDomainId: "STRING_VALUE", + * // ReplicaMode: "open-read-only" || "mounted", * // }, * // Iops: Number("int"), * // StorageType: "STRING_VALUE", diff --git a/clients/client-rds/src/commands/ModifyDBClusterCommand.ts b/clients/client-rds/src/commands/ModifyDBClusterCommand.ts index c84737c189c4..231ea9a7ccfa 100644 --- a/clients/client-rds/src/commands/ModifyDBClusterCommand.ts +++ b/clients/client-rds/src/commands/ModifyDBClusterCommand.ts @@ -157,6 +157,14 @@ export interface ModifyDBClusterCommandOutput extends ModifyDBClusterResult, __M * // ReadReplicaIdentifiers: [ // ReadReplicaIdentifierList * // "STRING_VALUE", * // ], + * // StatusInfos: [ // DBClusterStatusInfoList + * // { // DBClusterStatusInfo + * // StatusType: "STRING_VALUE", + * // Normal: true || false, + * // Status: "STRING_VALUE", + * // Message: "STRING_VALUE", + * // }, + * // ], * // DBClusterMembers: [ // DBClusterMemberList * // { // DBClusterMember * // DBInstanceIdentifier: "STRING_VALUE", @@ -205,6 +213,7 @@ export interface ModifyDBClusterCommandOutput extends ModifyDBClusterResult, __M * // RdsCustomClusterConfiguration: { // RdsCustomClusterConfiguration * // InterconnectSubnetId: "STRING_VALUE", * // TransitGatewayMulticastDomainId: "STRING_VALUE", + * // ReplicaMode: "open-read-only" || "mounted", * // }, * // DeletionProtection: true || false, * // HttpEndpointEnabled: true || false, @@ -253,6 +262,7 @@ export interface ModifyDBClusterCommandOutput extends ModifyDBClusterResult, __M * // RdsCustomClusterConfiguration: { * // InterconnectSubnetId: "STRING_VALUE", * // TransitGatewayMulticastDomainId: "STRING_VALUE", + * // ReplicaMode: "open-read-only" || "mounted", * // }, * // Iops: Number("int"), * // StorageType: "STRING_VALUE", @@ -334,6 +344,9 @@ export interface ModifyDBClusterCommandOutput extends ModifyDBClusterResult, __M *

The DB subnet group doesn't cover all Availability Zones after it's * created because of users' change.

* + * @throws {@link OptionGroupNotFoundFault} (client fault) + *

The specified option group could not be found.

+ * * @throws {@link StorageQuotaExceededFault} (client fault) *

The request would result in the user exceeding the allowed amount of storage * available across all DB instances.

diff --git a/clients/client-rds/src/commands/PromoteReadReplicaDBClusterCommand.ts b/clients/client-rds/src/commands/PromoteReadReplicaDBClusterCommand.ts index 2f3014361f87..b2743d3fa019 100644 --- a/clients/client-rds/src/commands/PromoteReadReplicaDBClusterCommand.ts +++ b/clients/client-rds/src/commands/PromoteReadReplicaDBClusterCommand.ts @@ -88,6 +88,14 @@ export interface PromoteReadReplicaDBClusterCommandOutput extends PromoteReadRep * // ReadReplicaIdentifiers: [ // ReadReplicaIdentifierList * // "STRING_VALUE", * // ], + * // StatusInfos: [ // DBClusterStatusInfoList + * // { // DBClusterStatusInfo + * // StatusType: "STRING_VALUE", + * // Normal: true || false, + * // Status: "STRING_VALUE", + * // Message: "STRING_VALUE", + * // }, + * // ], * // DBClusterMembers: [ // DBClusterMemberList * // { // DBClusterMember * // DBInstanceIdentifier: "STRING_VALUE", @@ -136,6 +144,7 @@ export interface PromoteReadReplicaDBClusterCommandOutput extends PromoteReadRep * // RdsCustomClusterConfiguration: { // RdsCustomClusterConfiguration * // InterconnectSubnetId: "STRING_VALUE", * // TransitGatewayMulticastDomainId: "STRING_VALUE", + * // ReplicaMode: "open-read-only" || "mounted", * // }, * // DeletionProtection: true || false, * // HttpEndpointEnabled: true || false, @@ -184,6 +193,7 @@ export interface PromoteReadReplicaDBClusterCommandOutput extends PromoteReadRep * // RdsCustomClusterConfiguration: { * // InterconnectSubnetId: "STRING_VALUE", * // TransitGatewayMulticastDomainId: "STRING_VALUE", + * // ReplicaMode: "open-read-only" || "mounted", * // }, * // Iops: Number("int"), * // StorageType: "STRING_VALUE", diff --git a/clients/client-rds/src/commands/RebootDBClusterCommand.ts b/clients/client-rds/src/commands/RebootDBClusterCommand.ts index 944c0dae99c2..cf085a0a5a9d 100644 --- a/clients/client-rds/src/commands/RebootDBClusterCommand.ts +++ b/clients/client-rds/src/commands/RebootDBClusterCommand.ts @@ -98,6 +98,14 @@ export interface RebootDBClusterCommandOutput extends RebootDBClusterResult, __M * // ReadReplicaIdentifiers: [ // ReadReplicaIdentifierList * // "STRING_VALUE", * // ], + * // StatusInfos: [ // DBClusterStatusInfoList + * // { // DBClusterStatusInfo + * // StatusType: "STRING_VALUE", + * // Normal: true || false, + * // Status: "STRING_VALUE", + * // Message: "STRING_VALUE", + * // }, + * // ], * // DBClusterMembers: [ // DBClusterMemberList * // { // DBClusterMember * // DBInstanceIdentifier: "STRING_VALUE", @@ -146,6 +154,7 @@ export interface RebootDBClusterCommandOutput extends RebootDBClusterResult, __M * // RdsCustomClusterConfiguration: { // RdsCustomClusterConfiguration * // InterconnectSubnetId: "STRING_VALUE", * // TransitGatewayMulticastDomainId: "STRING_VALUE", + * // ReplicaMode: "open-read-only" || "mounted", * // }, * // DeletionProtection: true || false, * // HttpEndpointEnabled: true || false, @@ -194,6 +203,7 @@ export interface RebootDBClusterCommandOutput extends RebootDBClusterResult, __M * // RdsCustomClusterConfiguration: { * // InterconnectSubnetId: "STRING_VALUE", * // TransitGatewayMulticastDomainId: "STRING_VALUE", + * // ReplicaMode: "open-read-only" || "mounted", * // }, * // Iops: Number("int"), * // StorageType: "STRING_VALUE", diff --git a/clients/client-rds/src/commands/RestoreDBClusterFromS3Command.ts b/clients/client-rds/src/commands/RestoreDBClusterFromS3Command.ts index 88f8969472e8..7b99fbf82f05 100644 --- a/clients/client-rds/src/commands/RestoreDBClusterFromS3Command.ts +++ b/clients/client-rds/src/commands/RestoreDBClusterFromS3Command.ts @@ -154,6 +154,14 @@ export interface RestoreDBClusterFromS3CommandOutput extends RestoreDBClusterFro * // ReadReplicaIdentifiers: [ // ReadReplicaIdentifierList * // "STRING_VALUE", * // ], + * // StatusInfos: [ // DBClusterStatusInfoList + * // { // DBClusterStatusInfo + * // StatusType: "STRING_VALUE", + * // Normal: true || false, + * // Status: "STRING_VALUE", + * // Message: "STRING_VALUE", + * // }, + * // ], * // DBClusterMembers: [ // DBClusterMemberList * // { // DBClusterMember * // DBInstanceIdentifier: "STRING_VALUE", @@ -202,6 +210,7 @@ export interface RestoreDBClusterFromS3CommandOutput extends RestoreDBClusterFro * // RdsCustomClusterConfiguration: { // RdsCustomClusterConfiguration * // InterconnectSubnetId: "STRING_VALUE", * // TransitGatewayMulticastDomainId: "STRING_VALUE", + * // ReplicaMode: "open-read-only" || "mounted", * // }, * // DeletionProtection: true || false, * // HttpEndpointEnabled: true || false, @@ -250,6 +259,7 @@ export interface RestoreDBClusterFromS3CommandOutput extends RestoreDBClusterFro * // RdsCustomClusterConfiguration: { * // InterconnectSubnetId: "STRING_VALUE", * // TransitGatewayMulticastDomainId: "STRING_VALUE", + * // ReplicaMode: "open-read-only" || "mounted", * // }, * // Iops: Number("int"), * // StorageType: "STRING_VALUE", diff --git a/clients/client-rds/src/commands/RestoreDBClusterFromSnapshotCommand.ts b/clients/client-rds/src/commands/RestoreDBClusterFromSnapshotCommand.ts index bb491ab0d435..308b7465ff77 100644 --- a/clients/client-rds/src/commands/RestoreDBClusterFromSnapshotCommand.ts +++ b/clients/client-rds/src/commands/RestoreDBClusterFromSnapshotCommand.ts @@ -117,6 +117,7 @@ export interface RestoreDBClusterFromSnapshotCommandOutput * RdsCustomClusterConfiguration: { // RdsCustomClusterConfiguration * InterconnectSubnetId: "STRING_VALUE", * TransitGatewayMulticastDomainId: "STRING_VALUE", + * ReplicaMode: "open-read-only" || "mounted", * }, * }; * const command = new RestoreDBClusterFromSnapshotCommand(input); @@ -160,6 +161,14 @@ export interface RestoreDBClusterFromSnapshotCommandOutput * // ReadReplicaIdentifiers: [ // ReadReplicaIdentifierList * // "STRING_VALUE", * // ], + * // StatusInfos: [ // DBClusterStatusInfoList + * // { // DBClusterStatusInfo + * // StatusType: "STRING_VALUE", + * // Normal: true || false, + * // Status: "STRING_VALUE", + * // Message: "STRING_VALUE", + * // }, + * // ], * // DBClusterMembers: [ // DBClusterMemberList * // { // DBClusterMember * // DBInstanceIdentifier: "STRING_VALUE", @@ -208,6 +217,7 @@ export interface RestoreDBClusterFromSnapshotCommandOutput * // RdsCustomClusterConfiguration: { // RdsCustomClusterConfiguration * // InterconnectSubnetId: "STRING_VALUE", * // TransitGatewayMulticastDomainId: "STRING_VALUE", + * // ReplicaMode: "open-read-only" || "mounted", * // }, * // DeletionProtection: true || false, * // HttpEndpointEnabled: true || false, @@ -256,6 +266,7 @@ export interface RestoreDBClusterFromSnapshotCommandOutput * // RdsCustomClusterConfiguration: { * // InterconnectSubnetId: "STRING_VALUE", * // TransitGatewayMulticastDomainId: "STRING_VALUE", + * // ReplicaMode: "open-read-only" || "mounted", * // }, * // Iops: Number("int"), * // StorageType: "STRING_VALUE", diff --git a/clients/client-rds/src/commands/RestoreDBClusterToPointInTimeCommand.ts b/clients/client-rds/src/commands/RestoreDBClusterToPointInTimeCommand.ts index 5b3a318954b9..b43a4ee6f041 100644 --- a/clients/client-rds/src/commands/RestoreDBClusterToPointInTimeCommand.ts +++ b/clients/client-rds/src/commands/RestoreDBClusterToPointInTimeCommand.ts @@ -119,6 +119,7 @@ export interface RestoreDBClusterToPointInTimeCommandOutput * RdsCustomClusterConfiguration: { // RdsCustomClusterConfiguration * InterconnectSubnetId: "STRING_VALUE", * TransitGatewayMulticastDomainId: "STRING_VALUE", + * ReplicaMode: "open-read-only" || "mounted", * }, * }; * const command = new RestoreDBClusterToPointInTimeCommand(input); @@ -162,6 +163,14 @@ export interface RestoreDBClusterToPointInTimeCommandOutput * // ReadReplicaIdentifiers: [ // ReadReplicaIdentifierList * // "STRING_VALUE", * // ], + * // StatusInfos: [ // DBClusterStatusInfoList + * // { // DBClusterStatusInfo + * // StatusType: "STRING_VALUE", + * // Normal: true || false, + * // Status: "STRING_VALUE", + * // Message: "STRING_VALUE", + * // }, + * // ], * // DBClusterMembers: [ // DBClusterMemberList * // { // DBClusterMember * // DBInstanceIdentifier: "STRING_VALUE", @@ -210,6 +219,7 @@ export interface RestoreDBClusterToPointInTimeCommandOutput * // RdsCustomClusterConfiguration: { // RdsCustomClusterConfiguration * // InterconnectSubnetId: "STRING_VALUE", * // TransitGatewayMulticastDomainId: "STRING_VALUE", + * // ReplicaMode: "open-read-only" || "mounted", * // }, * // DeletionProtection: true || false, * // HttpEndpointEnabled: true || false, @@ -258,6 +268,7 @@ export interface RestoreDBClusterToPointInTimeCommandOutput * // RdsCustomClusterConfiguration: { * // InterconnectSubnetId: "STRING_VALUE", * // TransitGatewayMulticastDomainId: "STRING_VALUE", + * // ReplicaMode: "open-read-only" || "mounted", * // }, * // Iops: Number("int"), * // StorageType: "STRING_VALUE", diff --git a/clients/client-rds/src/commands/StartDBClusterCommand.ts b/clients/client-rds/src/commands/StartDBClusterCommand.ts index daf4ed0f617e..41200e5cfd7a 100644 --- a/clients/client-rds/src/commands/StartDBClusterCommand.ts +++ b/clients/client-rds/src/commands/StartDBClusterCommand.ts @@ -95,6 +95,14 @@ export interface StartDBClusterCommandOutput extends StartDBClusterResult, __Met * // ReadReplicaIdentifiers: [ // ReadReplicaIdentifierList * // "STRING_VALUE", * // ], + * // StatusInfos: [ // DBClusterStatusInfoList + * // { // DBClusterStatusInfo + * // StatusType: "STRING_VALUE", + * // Normal: true || false, + * // Status: "STRING_VALUE", + * // Message: "STRING_VALUE", + * // }, + * // ], * // DBClusterMembers: [ // DBClusterMemberList * // { // DBClusterMember * // DBInstanceIdentifier: "STRING_VALUE", @@ -143,6 +151,7 @@ export interface StartDBClusterCommandOutput extends StartDBClusterResult, __Met * // RdsCustomClusterConfiguration: { // RdsCustomClusterConfiguration * // InterconnectSubnetId: "STRING_VALUE", * // TransitGatewayMulticastDomainId: "STRING_VALUE", + * // ReplicaMode: "open-read-only" || "mounted", * // }, * // DeletionProtection: true || false, * // HttpEndpointEnabled: true || false, @@ -191,6 +200,7 @@ export interface StartDBClusterCommandOutput extends StartDBClusterResult, __Met * // RdsCustomClusterConfiguration: { * // InterconnectSubnetId: "STRING_VALUE", * // TransitGatewayMulticastDomainId: "STRING_VALUE", + * // ReplicaMode: "open-read-only" || "mounted", * // }, * // Iops: Number("int"), * // StorageType: "STRING_VALUE", diff --git a/clients/client-rds/src/commands/StopDBClusterCommand.ts b/clients/client-rds/src/commands/StopDBClusterCommand.ts index 6f335a45ce3b..2c9b2e5c319f 100644 --- a/clients/client-rds/src/commands/StopDBClusterCommand.ts +++ b/clients/client-rds/src/commands/StopDBClusterCommand.ts @@ -96,6 +96,14 @@ export interface StopDBClusterCommandOutput extends StopDBClusterResult, __Metad * // ReadReplicaIdentifiers: [ // ReadReplicaIdentifierList * // "STRING_VALUE", * // ], + * // StatusInfos: [ // DBClusterStatusInfoList + * // { // DBClusterStatusInfo + * // StatusType: "STRING_VALUE", + * // Normal: true || false, + * // Status: "STRING_VALUE", + * // Message: "STRING_VALUE", + * // }, + * // ], * // DBClusterMembers: [ // DBClusterMemberList * // { // DBClusterMember * // DBInstanceIdentifier: "STRING_VALUE", @@ -144,6 +152,7 @@ export interface StopDBClusterCommandOutput extends StopDBClusterResult, __Metad * // RdsCustomClusterConfiguration: { // RdsCustomClusterConfiguration * // InterconnectSubnetId: "STRING_VALUE", * // TransitGatewayMulticastDomainId: "STRING_VALUE", + * // ReplicaMode: "open-read-only" || "mounted", * // }, * // DeletionProtection: true || false, * // HttpEndpointEnabled: true || false, @@ -192,6 +201,7 @@ export interface StopDBClusterCommandOutput extends StopDBClusterResult, __Metad * // RdsCustomClusterConfiguration: { * // InterconnectSubnetId: "STRING_VALUE", * // TransitGatewayMulticastDomainId: "STRING_VALUE", + * // ReplicaMode: "open-read-only" || "mounted", * // }, * // Iops: Number("int"), * // StorageType: "STRING_VALUE", diff --git a/clients/client-rds/src/models/models_0.ts b/clients/client-rds/src/models/models_0.ts index 6ab65f7589ac..9b1ff1732f95 100644 --- a/clients/client-rds/src/models/models_0.ts +++ b/clients/client-rds/src/models/models_0.ts @@ -4173,6 +4173,20 @@ export class Ec2ImagePropertiesNotSupportedFault extends __BaseException { } } +/** + * @public + * @enum + */ +export const ReplicaMode = { + MOUNTED: "mounted", + OPEN_READ_ONLY: "open-read-only", +} as const; + +/** + * @public + */ +export type ReplicaMode = (typeof ReplicaMode)[keyof typeof ReplicaMode]; + /** * @public *

Reserved for future use.

@@ -4189,6 +4203,12 @@ export interface RdsCustomClusterConfiguration { *

Reserved for future use.

*/ TransitGatewayMulticastDomainId?: string; + + /** + * @public + *

Reserved for future use.

+ */ + ReplicaMode?: ReplicaMode; } /** @@ -5478,6 +5498,36 @@ export interface ServerlessV2ScalingConfigurationInfo { MaxCapacity?: number; } +/** + * @public + *

Reserved for future use.

+ */ +export interface DBClusterStatusInfo { + /** + * @public + *

Reserved for future use.

+ */ + StatusType?: string; + + /** + * @public + *

Reserved for future use.

+ */ + Normal?: boolean; + + /** + * @public + *

Reserved for future use.

+ */ + Status?: string; + + /** + * @public + *

Reserved for future use.

+ */ + Message?: string; +} + /** * @public *

Contains the details of an Amazon Aurora DB cluster or Multi-AZ DB cluster.

@@ -5670,6 +5720,12 @@ export interface DBCluster { */ ReadReplicaIdentifiers?: string[]; + /** + * @public + *

Reserved for future use.

+ */ + StatusInfos?: DBClusterStatusInfo[]; + /** * @public *

The list of DB instances that make up the DB cluster.

@@ -6201,6 +6257,27 @@ export class InsufficientStorageClusterCapacityFault extends __BaseException { } } +/** + * @public + *

The DBSubnetGroup doesn't belong to the same VPC as that of an existing + * cross-region read replica of the same source instance.

+ */ +export class InvalidDBSubnetGroupFault extends __BaseException { + readonly name: "InvalidDBSubnetGroupFault" = "InvalidDBSubnetGroupFault"; + readonly $fault: "client" = "client"; + /** + * @internal + */ + constructor(opts: __ExceptionOptionType) { + super({ + name: "InvalidDBSubnetGroupFault", + $fault: "client", + ...opts, + }); + Object.setPrototypeOf(this, InvalidDBSubnetGroupFault.prototype); + } +} + /** * @public *

The DB subnet group cannot be deleted because it's in use.

@@ -8552,20 +8629,6 @@ export interface PendingModifiedValues { MultiTenant?: boolean; } -/** - * @public - * @enum - */ -export const ReplicaMode = { - MOUNTED: "mounted", - OPEN_READ_ONLY: "open-read-only", -} as const; - -/** - * @public - */ -export type ReplicaMode = (typeof ReplicaMode)[keyof typeof ReplicaMode]; - /** * @public *

Provides a list of status information for a DB instance.

@@ -10078,27 +10141,6 @@ export class DBSubnetGroupNotAllowedFault extends __BaseException { } } -/** - * @public - *

The DBSubnetGroup doesn't belong to the same VPC as that of an existing - * cross-region read replica of the same source instance.

- */ -export class InvalidDBSubnetGroupFault extends __BaseException { - readonly name: "InvalidDBSubnetGroupFault" = "InvalidDBSubnetGroupFault"; - readonly $fault: "client" = "client"; - /** - * @internal - */ - constructor(opts: __ExceptionOptionType) { - super({ - name: "InvalidDBSubnetGroupFault", - $fault: "client", - ...opts, - }); - Object.setPrototypeOf(this, InvalidDBSubnetGroupFault.prototype); - } -} - /** * @public *

@@ -14037,24 +14079,6 @@ export interface DescribeCertificatesMessage { Marker?: string; } -/** - * @public - */ -export interface DBClusterAutomatedBackupMessage { - /** - * @public - *

The pagination token provided in the previous request. If this parameter is specified the response includes only - * records beyond the marker, up to MaxRecords.

- */ - Marker?: string; - - /** - * @public - *

A list of DBClusterAutomatedBackup backups.

- */ - DBClusterAutomatedBackups?: DBClusterAutomatedBackup[]; -} - /** * @internal */ diff --git a/clients/client-rds/src/models/models_1.ts b/clients/client-rds/src/models/models_1.ts index 221f2e4e2c67..ca9631df03cc 100644 --- a/clients/client-rds/src/models/models_1.ts +++ b/clients/client-rds/src/models/models_1.ts @@ -10,6 +10,7 @@ import { BlueGreenDeployment, Certificate, DBCluster, + DBClusterAutomatedBackup, DBClusterBacktrack, DBClusterEndpoint, DBClusterParameterGroup, @@ -44,6 +45,24 @@ import { } from "./models_0"; import { RDSServiceException as __BaseException } from "./RDSServiceException"; +/** + * @public + */ +export interface DBClusterAutomatedBackupMessage { + /** + * @public + *

The pagination token provided in the previous request. If this parameter is specified the response includes only + * records beyond the marker, up to MaxRecords.

+ */ + Marker?: string; + + /** + * @public + *

A list of DBClusterAutomatedBackup backups.

+ */ + DBClusterAutomatedBackups?: DBClusterAutomatedBackup[]; +} + /** * @public */ diff --git a/clients/client-rds/src/protocols/Aws_query.ts b/clients/client-rds/src/protocols/Aws_query.ts index d63637f9d462..312b6a322d1c 100644 --- a/clients/client-rds/src/protocols/Aws_query.ts +++ b/clients/client-rds/src/protocols/Aws_query.ts @@ -601,7 +601,6 @@ import { DBCluster, DBClusterAlreadyExistsFault, DBClusterAutomatedBackup, - DBClusterAutomatedBackupMessage, DBClusterAutomatedBackupNotFoundFault, DBClusterAutomatedBackupQuotaExceededFault, DBClusterBacktrack, @@ -621,6 +620,7 @@ import { DBClusterSnapshot, DBClusterSnapshotAlreadyExistsFault, DBClusterSnapshotNotFoundFault, + DBClusterStatusInfo, DBEngineVersion, DBInstance, DBInstanceAlreadyExistsFault, @@ -807,6 +807,7 @@ import { CloudwatchLogsExportConfiguration, ConnectionPoolConfiguration, ConnectionPoolConfigurationInfo, + DBClusterAutomatedBackupMessage, DBClusterBacktrackMessage, DBClusterBacktrackNotFoundFault, DBClusterCapacityInfo, @@ -4534,6 +4535,9 @@ const de_CreateDBClusterCommandError = async ( case "InvalidDBInstanceState": case "com.amazonaws.rds#InvalidDBInstanceStateFault": throw await de_InvalidDBInstanceStateFaultRes(parsedOutput, context); + case "InvalidDBSubnetGroupFault": + case "com.amazonaws.rds#InvalidDBSubnetGroupFault": + throw await de_InvalidDBSubnetGroupFaultRes(parsedOutput, context); case "InvalidDBSubnetGroupStateFault": case "com.amazonaws.rds#InvalidDBSubnetGroupStateFault": throw await de_InvalidDBSubnetGroupStateFaultRes(parsedOutput, context); @@ -4549,6 +4553,9 @@ const de_CreateDBClusterCommandError = async ( case "KMSKeyNotAccessibleFault": case "com.amazonaws.rds#KMSKeyNotAccessibleFault": throw await de_KMSKeyNotAccessibleFaultRes(parsedOutput, context); + case "OptionGroupNotFoundFault": + case "com.amazonaws.rds#OptionGroupNotFoundFault": + throw await de_OptionGroupNotFoundFaultRes(parsedOutput, context); case "StorageQuotaExceeded": case "com.amazonaws.rds#StorageQuotaExceededFault": throw await de_StorageQuotaExceededFaultRes(parsedOutput, context); @@ -9060,6 +9067,9 @@ const de_ModifyDBClusterCommandError = async ( case "InvalidVPCNetworkStateFault": case "com.amazonaws.rds#InvalidVPCNetworkStateFault": throw await de_InvalidVPCNetworkStateFaultRes(parsedOutput, context); + case "OptionGroupNotFoundFault": + case "com.amazonaws.rds#OptionGroupNotFoundFault": + throw await de_OptionGroupNotFoundFaultRes(parsedOutput, context); case "StorageQuotaExceeded": case "com.amazonaws.rds#StorageQuotaExceededFault": throw await de_StorageQuotaExceededFaultRes(parsedOutput, context); @@ -18797,6 +18807,9 @@ const se_RdsCustomClusterConfiguration = (input: RdsCustomClusterConfiguration, if (input.TransitGatewayMulticastDomainId != null) { entries["TransitGatewayMulticastDomainId"] = input.TransitGatewayMulticastDomainId; } + if (input.ReplicaMode != null) { + entries["ReplicaMode"] = input.ReplicaMode; + } return entries; }; @@ -21308,6 +21321,14 @@ const de_DBCluster = (output: any, context: __SerdeContext): DBCluster => { context ); } + if (output.StatusInfos === "") { + contents.StatusInfos = []; + } else if (output["StatusInfos"] !== undefined && output["StatusInfos"]["DBClusterStatusInfo"] !== undefined) { + contents.StatusInfos = de_DBClusterStatusInfoList( + __getArrayIfSingleItem(output["StatusInfos"]["DBClusterStatusInfo"]), + context + ); + } if (output.DBClusterMembers === "") { contents.DBClusterMembers = []; } else if (output["DBClusterMembers"] !== undefined && output["DBClusterMembers"]["DBClusterMember"] !== undefined) { @@ -22342,6 +22363,37 @@ const de_DBClusterSnapshotNotFoundFault = (output: any, context: __SerdeContext) return contents; }; +/** + * deserializeAws_queryDBClusterStatusInfo + */ +const de_DBClusterStatusInfo = (output: any, context: __SerdeContext): DBClusterStatusInfo => { + const contents: any = {}; + if (output["StatusType"] !== undefined) { + contents.StatusType = __expectString(output["StatusType"]); + } + if (output["Normal"] !== undefined) { + contents.Normal = __parseBoolean(output["Normal"]); + } + if (output["Status"] !== undefined) { + contents.Status = __expectString(output["Status"]); + } + if (output["Message"] !== undefined) { + contents.Message = __expectString(output["Message"]); + } + return contents; +}; + +/** + * deserializeAws_queryDBClusterStatusInfoList + */ +const de_DBClusterStatusInfoList = (output: any, context: __SerdeContext): DBClusterStatusInfo[] => { + return (output || []) + .filter((e: any) => e != null) + .map((entry: any) => { + return de_DBClusterStatusInfo(entry, context); + }); +}; + /** * deserializeAws_queryDBEngineVersion */ @@ -27318,6 +27370,9 @@ const de_RdsCustomClusterConfiguration = (output: any, context: __SerdeContext): if (output["TransitGatewayMulticastDomainId"] !== undefined) { contents.TransitGatewayMulticastDomainId = __expectString(output["TransitGatewayMulticastDomainId"]); } + if (output["ReplicaMode"] !== undefined) { + contents.ReplicaMode = __expectString(output["ReplicaMode"]); + } return contents; }; diff --git a/codegen/sdk-codegen/aws-models/rds.json b/codegen/sdk-codegen/aws-models/rds.json index d6a23afb3829..9031fe2d37e9 100644 --- a/codegen/sdk-codegen/aws-models/rds.json +++ b/codegen/sdk-codegen/aws-models/rds.json @@ -3039,7 +3039,7 @@ } ], "traits": { - "smithy.api#documentation": "

Copies the specified DB cluster parameter group.

", + "smithy.api#documentation": "

Copies the specified DB cluster parameter group.

\n \n

You can't copy a default DB cluster parameter group. Instead, create a new custom DB cluster parameter group, which copies\n the default parameters and values for the specified DB cluster parameter group family.

\n ", "smithy.api#examples": [ { "title": "To copy a DB cluster parameter group", @@ -3250,7 +3250,7 @@ } ], "traits": { - "smithy.api#documentation": "

Copies the specified DB parameter group.

", + "smithy.api#documentation": "

Copies the specified DB parameter group.

\n \n

You can't copy a default DB parameter group. Instead, create a new custom DB parameter group, which copies the default\n parameters and values for the specified DB parameter group family.

\n ", "smithy.api#examples": [ { "title": "To copy a DB parameter group", @@ -3841,6 +3841,9 @@ { "target": "com.amazonaws.rds#InvalidDBInstanceStateFault" }, + { + "target": "com.amazonaws.rds#InvalidDBSubnetGroupFault" + }, { "target": "com.amazonaws.rds#InvalidDBSubnetGroupStateFault" }, @@ -3856,6 +3859,9 @@ { "target": "com.amazonaws.rds#KMSKeyNotAccessibleFault" }, + { + "target": "com.amazonaws.rds#OptionGroupNotFoundFault" + }, { "target": "com.amazonaws.rds#StorageQuotaExceededFault" } @@ -6911,6 +6917,12 @@ "smithy.api#documentation": "

Contains one or more identifiers of the read replicas associated with this DB\n cluster.

" } }, + "StatusInfos": { + "target": "com.amazonaws.rds#DBClusterStatusInfoList", + "traits": { + "smithy.api#documentation": "

Reserved for future use.

" + } + }, "DBClusterMembers": { "target": "com.amazonaws.rds#DBClusterMemberList", "traits": { @@ -8315,6 +8327,47 @@ "smithy.api#httpError": 404 } }, + "com.amazonaws.rds#DBClusterStatusInfo": { + "type": "structure", + "members": { + "StatusType": { + "target": "com.amazonaws.rds#String", + "traits": { + "smithy.api#documentation": "

Reserved for future use.

" + } + }, + "Normal": { + "target": "com.amazonaws.rds#Boolean", + "traits": { + "smithy.api#documentation": "

Reserved for future use.

" + } + }, + "Status": { + "target": "com.amazonaws.rds#String", + "traits": { + "smithy.api#documentation": "

Reserved for future use.

" + } + }, + "Message": { + "target": "com.amazonaws.rds#String", + "traits": { + "smithy.api#documentation": "

Reserved for future use.

" + } + } + }, + "traits": { + "smithy.api#documentation": "

Reserved for future use.

" + } + }, + "com.amazonaws.rds#DBClusterStatusInfoList": { + "type": "list", + "member": { + "target": "com.amazonaws.rds#DBClusterStatusInfo", + "traits": { + "smithy.api#xmlName": "DBClusterStatusInfo" + } + } + }, "com.amazonaws.rds#DBEngineVersion": { "type": "structure", "members": { @@ -19949,6 +20002,9 @@ { "target": "com.amazonaws.rds#InvalidVPCNetworkStateFault" }, + { + "target": "com.amazonaws.rds#OptionGroupNotFoundFault" + }, { "target": "com.amazonaws.rds#StorageQuotaExceededFault" }, @@ -23618,6 +23674,12 @@ "traits": { "smithy.api#documentation": "

Reserved for future use.

" } + }, + "ReplicaMode": { + "target": "com.amazonaws.rds#ReplicaMode", + "traits": { + "smithy.api#documentation": "

Reserved for future use.

" + } } }, "traits": {