Skip to content

Commit a6d4eb2

Browse files
author
awstools
committed
feat(client-rds): Enhanced RDS error handling: Added DBProxyEndpointNotFoundFault, DBShardGroupNotFoundFault, KMSKeyNotAccessibleFault for snapshots/restores/backups, NetworkTypeNotSupported, StorageTypeNotSupportedFault for restores, and granular state validation faults. Changed DBInstanceNotReadyFault to HTTP 400.
1 parent def0338 commit a6d4eb2

File tree

74 files changed

+3678
-2815
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

74 files changed

+3678
-2815
lines changed

‎clients/client-rds/src/RDS.ts‎

Lines changed: 0 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1467,7 +1467,6 @@ export interface RDS {
14671467
/**
14681468
* @see {@link CreateGlobalClusterCommand}
14691469
*/
1470-
createGlobalCluster(): Promise<CreateGlobalClusterCommandOutput>;
14711470
createGlobalCluster(
14721471
args: CreateGlobalClusterCommandInput,
14731472
options?: __HttpHandlerOptions
@@ -3132,7 +3131,6 @@ export interface RDS {
31323131
/**
31333132
* @see {@link ModifyGlobalClusterCommand}
31343133
*/
3135-
modifyGlobalCluster(): Promise<ModifyGlobalClusterCommandOutput>;
31363134
modifyGlobalCluster(
31373135
args: ModifyGlobalClusterCommandInput,
31383136
options?: __HttpHandlerOptions
@@ -3317,7 +3315,6 @@ export interface RDS {
33173315
/**
33183316
* @see {@link RemoveFromGlobalClusterCommand}
33193317
*/
3320-
removeFromGlobalCluster(): Promise<RemoveFromGlobalClusterCommandOutput>;
33213318
removeFromGlobalCluster(
33223319
args: RemoveFromGlobalClusterCommandInput,
33233320
options?: __HttpHandlerOptions

‎clients/client-rds/src/commands/AddTagsToResourceCommand.ts‎

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -74,12 +74,18 @@ export interface AddTagsToResourceCommandOutput extends __MetadataBearer {}
7474
* <p>
7575
* <code>DBInstanceIdentifier</code> doesn't refer to an existing DB instance.</p>
7676
*
77+
* @throws {@link DBProxyEndpointNotFoundFault} (client fault)
78+
* <p>The DB proxy endpoint doesn't exist.</p>
79+
*
7780
* @throws {@link DBProxyNotFoundFault} (client fault)
7881
* <p>The specified proxy name doesn't correspond to a proxy owned by your Amazon Web Services account in the specified Amazon Web Services Region.</p>
7982
*
8083
* @throws {@link DBProxyTargetGroupNotFoundFault} (client fault)
8184
* <p>The specified target group isn't available for a proxy owned by your Amazon Web Services account in the specified Amazon Web Services Region.</p>
8285
*
86+
* @throws {@link DBShardGroupNotFoundFault} (client fault)
87+
* <p>The specified DB shard group name wasn't found.</p>
88+
*
8389
* @throws {@link DBSnapshotNotFoundFault} (client fault)
8490
* <p>
8591
* <code>DBSnapshotIdentifier</code> doesn't refer to an existing DB snapshot.</p>
@@ -90,6 +96,15 @@ export interface AddTagsToResourceCommandOutput extends __MetadataBearer {}
9096
* @throws {@link IntegrationNotFoundFault} (client fault)
9197
* <p>The specified integration could not be found.</p>
9298
*
99+
* @throws {@link InvalidDBClusterEndpointStateFault} (client fault)
100+
* <p>The requested operation can't be performed on the endpoint while the endpoint is in this state.</p>
101+
*
102+
* @throws {@link InvalidDBClusterStateFault} (client fault)
103+
* <p>The requested operation can't be performed while the cluster is in this state.</p>
104+
*
105+
* @throws {@link InvalidDBInstanceStateFault} (client fault)
106+
* <p>The DB instance isn't in a valid state.</p>
107+
*
93108
* @throws {@link TenantDatabaseNotFoundFault} (client fault)
94109
* <p>The specified tenant database wasn't found in the DB instance.</p>
95110
*

‎clients/client-rds/src/commands/CopyDBClusterSnapshotCommand.ts‎

Lines changed: 8 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,11 @@ import { Command as $Command } from "@smithy/smithy-client";
66
import { MetadataBearer as __MetadataBearer } from "@smithy/types";
77

88
import { commonParams } from "../endpoint/EndpointParameters";
9-
import { CopyDBClusterSnapshotMessage, CopyDBClusterSnapshotResult } from "../models/models_0";
9+
import {
10+
CopyDBClusterSnapshotMessage,
11+
CopyDBClusterSnapshotMessageFilterSensitiveLog,
12+
CopyDBClusterSnapshotResult,
13+
} from "../models/models_0";
1014
import { de_CopyDBClusterSnapshotCommand, se_CopyDBClusterSnapshotCommand } from "../protocols/Aws_query";
1115
import { RDSClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../RDSClient";
1216

@@ -120,10 +124,10 @@ export interface CopyDBClusterSnapshotCommandOutput extends CopyDBClusterSnapsho
120124
* // Value: "STRING_VALUE",
121125
* // },
122126
* // ],
123-
* // DBSystemId: "STRING_VALUE",
124127
* // StorageType: "STRING_VALUE",
125-
* // DbClusterResourceId: "STRING_VALUE",
126128
* // StorageThroughput: Number("int"),
129+
* // DbClusterResourceId: "STRING_VALUE",
130+
* // DBSystemId: "STRING_VALUE",
127131
* // },
128132
* // };
129133
*
@@ -220,7 +224,7 @@ export class CopyDBClusterSnapshotCommand extends $Command
220224
})
221225
.s("AmazonRDSv19", "CopyDBClusterSnapshot", {})
222226
.n("RDSClient", "CopyDBClusterSnapshotCommand")
223-
.f(void 0, void 0)
227+
.f(CopyDBClusterSnapshotMessageFilterSensitiveLog, void 0)
224228
.ser(se_CopyDBClusterSnapshotCommand)
225229
.de(de_CopyDBClusterSnapshotCommand)
226230
.build() {

‎clients/client-rds/src/commands/CopyDBSnapshotCommand.ts‎

Lines changed: 10 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,11 @@ import { Command as $Command } from "@smithy/smithy-client";
66
import { MetadataBearer as __MetadataBearer } from "@smithy/types";
77

88
import { commonParams } from "../endpoint/EndpointParameters";
9-
import { CopyDBSnapshotMessage, CopyDBSnapshotResult } from "../models/models_0";
9+
import {
10+
CopyDBSnapshotMessage,
11+
CopyDBSnapshotMessageFilterSensitiveLog,
12+
CopyDBSnapshotResult,
13+
} from "../models/models_0";
1014
import { de_CopyDBSnapshotCommand, se_CopyDBSnapshotCommand } from "../protocols/Aws_query";
1115
import { RDSClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../RDSClient";
1216

@@ -58,9 +62,9 @@ export interface CopyDBSnapshotCommandOutput extends CopyDBSnapshotResult, __Met
5862
* PreSignedUrl: "STRING_VALUE",
5963
* OptionGroupName: "STRING_VALUE",
6064
* TargetCustomAvailabilityZone: "STRING_VALUE",
65+
* SnapshotTarget: "STRING_VALUE",
6166
* CopyOptionGroup: true || false,
6267
* SnapshotAvailabilityZone: "STRING_VALUE",
63-
* SnapshotTarget: "STRING_VALUE",
6468
* };
6569
* const command = new CopyDBSnapshotCommand(input);
6670
* const response = await client.send(command);
@@ -81,6 +85,7 @@ export interface CopyDBSnapshotCommandOutput extends CopyDBSnapshotResult, __Met
8185
* // LicenseModel: "STRING_VALUE",
8286
* // SnapshotType: "STRING_VALUE",
8387
* // Iops: Number("int"),
88+
* // StorageThroughput: Number("int"),
8489
* // OptionGroupName: "STRING_VALUE",
8590
* // PercentProgress: Number("int"),
8691
* // SourceRegion: "STRING_VALUE",
@@ -105,13 +110,12 @@ export interface CopyDBSnapshotCommandOutput extends CopyDBSnapshotResult, __Met
105110
* // Value: "STRING_VALUE",
106111
* // },
107112
* // ],
113+
* // SnapshotTarget: "STRING_VALUE",
108114
* // OriginalSnapshotCreateTime: new Date("TIMESTAMP"),
109115
* // SnapshotDatabaseTime: new Date("TIMESTAMP"),
110-
* // SnapshotTarget: "STRING_VALUE",
111-
* // StorageThroughput: Number("int"),
112116
* // DBSystemId: "STRING_VALUE",
113-
* // DedicatedLogVolume: true || false,
114117
* // MultiTenant: true || false,
118+
* // DedicatedLogVolume: true || false,
115119
* // SnapshotAvailabilityZone: "STRING_VALUE",
116120
* // },
117121
* // };
@@ -213,7 +217,7 @@ export class CopyDBSnapshotCommand extends $Command
213217
})
214218
.s("AmazonRDSv19", "CopyDBSnapshot", {})
215219
.n("RDSClient", "CopyDBSnapshotCommand")
216-
.f(void 0, void 0)
220+
.f(CopyDBSnapshotMessageFilterSensitiveLog, void 0)
217221
.ser(se_CopyDBSnapshotCommand)
218222
.de(de_CopyDBSnapshotCommand)
219223
.build() {

‎clients/client-rds/src/commands/CopyOptionGroupCommand.ts‎

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,11 @@ import { Command as $Command } from "@smithy/smithy-client";
55
import { MetadataBearer as __MetadataBearer } from "@smithy/types";
66

77
import { commonParams } from "../endpoint/EndpointParameters";
8-
import { CopyOptionGroupMessage, CopyOptionGroupResult } from "../models/models_0";
8+
import {
9+
CopyOptionGroupMessage,
10+
CopyOptionGroupResult,
11+
CopyOptionGroupResultFilterSensitiveLog,
12+
} from "../models/models_0";
913
import { de_CopyOptionGroupCommand, se_CopyOptionGroupCommand } from "../protocols/Aws_query";
1014
import { RDSClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../RDSClient";
1115

@@ -165,7 +169,7 @@ export class CopyOptionGroupCommand extends $Command
165169
})
166170
.s("AmazonRDSv19", "CopyOptionGroup", {})
167171
.n("RDSClient", "CopyOptionGroupCommand")
168-
.f(void 0, void 0)
172+
.f(void 0, CopyOptionGroupResultFilterSensitiveLog)
169173
.ser(se_CopyOptionGroupCommand)
170174
.de(de_CopyOptionGroupCommand)
171175
.build() {

‎clients/client-rds/src/commands/CreateBlueGreenDeploymentCommand.ts‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -153,6 +153,10 @@ export interface CreateBlueGreenDeploymentCommandOutput extends CreateBlueGreenD
153153
* @throws {@link SourceDatabaseNotSupportedFault} (client fault)
154154
* <p>The source DB instance isn't supported for a blue/green deployment.</p>
155155
*
156+
* @throws {@link StorageQuotaExceededFault} (client fault)
157+
* <p>The request would result in the user exceeding the allowed amount of storage
158+
* available across all DB instances.</p>
159+
*
156160
* @throws {@link RDSServiceException}
157161
* <p>Base exception class for all service exceptions from RDS service.</p>
158162
*

‎clients/client-rds/src/commands/CreateCustomDBEngineVersionCommand.ts‎

Lines changed: 15 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -44,6 +44,8 @@ export interface CreateCustomDBEngineVersionCommandOutput extends DBEngineVersio
4444
* DatabaseInstallationFilesS3Prefix: "STRING_VALUE",
4545
* ImageId: "STRING_VALUE",
4646
* KMSKeyId: "STRING_VALUE",
47+
* SourceCustomDbEngineVersionIdentifier: "STRING_VALUE",
48+
* UseAwsProvidedLatestImage: true || false,
4749
* Description: "STRING_VALUE",
4850
* Manifest: "STRING_VALUE",
4951
* Tags: [ // TagList
@@ -52,16 +54,19 @@ export interface CreateCustomDBEngineVersionCommandOutput extends DBEngineVersio
5254
* Value: "STRING_VALUE",
5355
* },
5456
* ],
55-
* SourceCustomDbEngineVersionIdentifier: "STRING_VALUE",
56-
* UseAwsProvidedLatestImage: true || false,
5757
* };
5858
* const command = new CreateCustomDBEngineVersionCommand(input);
5959
* const response = await client.send(command);
6060
* // { // DBEngineVersion
6161
* // Engine: "STRING_VALUE",
62+
* // MajorEngineVersion: "STRING_VALUE",
6263
* // EngineVersion: "STRING_VALUE",
64+
* // DatabaseInstallationFilesS3BucketName: "STRING_VALUE",
65+
* // DatabaseInstallationFilesS3Prefix: "STRING_VALUE",
66+
* // CustomDBEngineVersionManifest: "STRING_VALUE",
6367
* // DBParameterGroupFamily: "STRING_VALUE",
6468
* // DBEngineDescription: "STRING_VALUE",
69+
* // DBEngineVersionArn: "STRING_VALUE",
6570
* // DBEngineVersionDescription: "STRING_VALUE",
6671
* // DefaultCharacterSet: { // CharacterSet
6772
* // CharacterSetName: "STRING_VALUE",
@@ -72,6 +77,8 @@ export interface CreateCustomDBEngineVersionCommandOutput extends DBEngineVersio
7277
* // Status: "STRING_VALUE",
7378
* // },
7479
* // DBEngineMediaType: "STRING_VALUE",
80+
* // KMSKeyId: "STRING_VALUE",
81+
* // CreateTime: new Date("TIMESTAMP"),
7582
* // SupportedCharacterSets: [ // SupportedCharacterSetsList
7683
* // {
7784
* // CharacterSetName: "STRING_VALUE",
@@ -121,20 +128,13 @@ export interface CreateCustomDBEngineVersionCommandOutput extends DBEngineVersio
121128
* // Status: "STRING_VALUE",
122129
* // SupportsParallelQuery: true || false,
123130
* // SupportsGlobalDatabases: true || false,
124-
* // MajorEngineVersion: "STRING_VALUE",
125-
* // DatabaseInstallationFilesS3BucketName: "STRING_VALUE",
126-
* // DatabaseInstallationFilesS3Prefix: "STRING_VALUE",
127-
* // DBEngineVersionArn: "STRING_VALUE",
128-
* // KMSKeyId: "STRING_VALUE",
129-
* // CreateTime: new Date("TIMESTAMP"),
130131
* // TagList: [ // TagList
131132
* // { // Tag
132133
* // Key: "STRING_VALUE",
133134
* // Value: "STRING_VALUE",
134135
* // },
135136
* // ],
136137
* // SupportsBabelfish: true || false,
137-
* // CustomDBEngineVersionManifest: "STRING_VALUE",
138138
* // SupportsLimitlessDatabase: true || false,
139139
* // SupportsCertificateRotationWithoutRestart: true || false,
140140
* // SupportedCACertificateIdentifiers: [ // CACertificateIdentifiersList
@@ -162,12 +162,18 @@ export interface CreateCustomDBEngineVersionCommandOutput extends DBEngineVersio
162162
* @throws {@link CustomDBEngineVersionAlreadyExistsFault} (client fault)
163163
* <p>A CEV with the specified name already exists.</p>
164164
*
165+
* @throws {@link CustomDBEngineVersionNotFoundFault} (client fault)
166+
* <p>The specified CEV was not found.</p>
167+
*
165168
* @throws {@link CustomDBEngineVersionQuotaExceededFault} (client fault)
166169
* <p>You have exceeded your CEV quota.</p>
167170
*
168171
* @throws {@link Ec2ImagePropertiesNotSupportedFault} (client fault)
169172
* <p>The AMI configuration prerequisite has not been met.</p>
170173
*
174+
* @throws {@link InvalidCustomDBEngineVersionStateFault} (client fault)
175+
* <p>You can't delete the CEV.</p>
176+
*
171177
* @throws {@link KMSKeyNotAccessibleFault} (client fault)
172178
* <p>An error occurred accessing an Amazon Web Services KMS key.</p>
173179
*

0 commit comments

Comments
 (0)