@aws-sdk/client-rds-data 3.478.0 → 3.481.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 (39) hide show
  1. package/README.md +15 -9
  2. package/dist-cjs/commands/BatchExecuteStatementCommand.js +18 -41
  3. package/dist-cjs/commands/BeginTransactionCommand.js +18 -41
  4. package/dist-cjs/commands/CommitTransactionCommand.js +18 -41
  5. package/dist-cjs/commands/ExecuteSqlCommand.js +18 -41
  6. package/dist-cjs/commands/ExecuteStatementCommand.js +18 -41
  7. package/dist-cjs/commands/RollbackTransactionCommand.js +18 -41
  8. package/dist-cjs/endpoint/EndpointParameters.js +7 -1
  9. package/dist-cjs/models/models_0.js +105 -1
  10. package/dist-cjs/protocols/Aws_restJson1.js +210 -0
  11. package/dist-es/commands/BatchExecuteStatementCommand.js +18 -41
  12. package/dist-es/commands/BeginTransactionCommand.js +18 -41
  13. package/dist-es/commands/CommitTransactionCommand.js +18 -41
  14. package/dist-es/commands/ExecuteSqlCommand.js +18 -41
  15. package/dist-es/commands/ExecuteStatementCommand.js +18 -41
  16. package/dist-es/commands/RollbackTransactionCommand.js +18 -41
  17. package/dist-es/endpoint/EndpointParameters.js +6 -0
  18. package/dist-es/models/models_0.js +96 -0
  19. package/dist-es/protocols/Aws_restJson1.js +211 -1
  20. package/dist-types/RDSData.d.ts +14 -8
  21. package/dist-types/RDSDataClient.d.ts +14 -8
  22. package/dist-types/commands/BatchExecuteStatementCommand.d.ts +44 -27
  23. package/dist-types/commands/BeginTransactionCommand.d.ts +43 -26
  24. package/dist-types/commands/CommitTransactionCommand.d.ts +41 -24
  25. package/dist-types/commands/ExecuteSqlCommand.d.ts +13 -28
  26. package/dist-types/commands/ExecuteStatementCommand.d.ts +57 -26
  27. package/dist-types/commands/RollbackTransactionCommand.d.ts +41 -24
  28. package/dist-types/endpoint/EndpointParameters.d.ts +18 -0
  29. package/dist-types/index.d.ts +14 -8
  30. package/dist-types/models/models_0.d.ts +160 -45
  31. package/dist-types/ts3.4/commands/BatchExecuteStatementCommand.d.ts +12 -24
  32. package/dist-types/ts3.4/commands/BeginTransactionCommand.d.ts +14 -23
  33. package/dist-types/ts3.4/commands/CommitTransactionCommand.d.ts +14 -23
  34. package/dist-types/ts3.4/commands/ExecuteSqlCommand.d.ts +14 -23
  35. package/dist-types/ts3.4/commands/ExecuteStatementCommand.d.ts +14 -23
  36. package/dist-types/ts3.4/commands/RollbackTransactionCommand.d.ts +14 -23
  37. package/dist-types/ts3.4/endpoint/EndpointParameters.d.ts +18 -0
  38. package/dist-types/ts3.4/models/models_0.d.ts +59 -0
  39. package/package.json +9 -9
@@ -158,14 +158,20 @@ export interface RDSDataClientResolvedConfig extends RDSDataClientResolvedConfig
158
158
  }
159
159
  /**
160
160
  * @public
161
- * <fullname>Amazon RDS Data Service</fullname>
162
- * <p>Amazon RDS provides an HTTP endpoint to run SQL statements on an Amazon Aurora Serverless v1 DB cluster. To run these
163
- * statements, you work with the Data Service API.</p>
164
- * <note>
165
- * <p>The Data Service API isn't supported on Amazon Aurora Serverless v2 DB clusters.</p>
166
- * </note>
167
- * <p>For more information about the Data Service API, see
168
- * <a href="https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/data-api.html">Using the Data API</a>
161
+ * <fullname>RDS Data API</fullname>
162
+ * <p>Amazon RDS provides an HTTP endpoint to run SQL statements on an Amazon Aurora DB cluster. To run these
163
+ * statements, you use the RDS Data API (Data API).</p>
164
+ * <p>Data API is available with the following types of Aurora databases:</p>
165
+ * <ul>
166
+ * <li>
167
+ * <p>Aurora PostgreSQL - Serverless v2, Serverless v1, and provisioned</p>
168
+ * </li>
169
+ * <li>
170
+ * <p>Aurora MySQL - Serverless v1 only</p>
171
+ * </li>
172
+ * </ul>
173
+ * <p>For more information about the Data API, see
174
+ * <a href="https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/data-api.html">Using RDS Data API</a>
169
175
  * in the <i>Amazon Aurora User Guide</i>.</p>
170
176
  */
171
177
  export declare class RDSDataClient extends __Client<__HttpHandlerOptions, ServiceInputTypes, ServiceOutputTypes, RDSDataClientResolvedConfig> {
@@ -1,6 +1,5 @@
1
- import { EndpointParameterInstructions } from "@smithy/middleware-endpoint";
2
1
  import { Command as $Command } from "@smithy/smithy-client";
3
- import { Handler, HttpHandlerOptions as __HttpHandlerOptions, MetadataBearer as __MetadataBearer, MiddlewareStack } from "@smithy/types";
2
+ import { MetadataBearer as __MetadataBearer } from "@smithy/types";
4
3
  import { BatchExecuteStatementRequest, BatchExecuteStatementResponse } from "../models/models_0";
5
4
  import { RDSDataClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../RDSDataClient";
6
5
  /**
@@ -21,13 +20,17 @@ export interface BatchExecuteStatementCommandInput extends BatchExecuteStatement
21
20
  */
22
21
  export interface BatchExecuteStatementCommandOutput extends BatchExecuteStatementResponse, __MetadataBearer {
23
22
  }
23
+ declare const BatchExecuteStatementCommand_base: {
24
+ new (input: BatchExecuteStatementCommandInput): import("@smithy/smithy-client").CommandImpl<BatchExecuteStatementCommandInput, BatchExecuteStatementCommandOutput, RDSDataClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
25
+ getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
26
+ };
24
27
  /**
25
28
  * @public
26
29
  * <p>Runs a batch SQL statement over an array of data.</p>
27
- * <p>You can run bulk update and insert operations for multiple records using a DML
30
+ * <p>You can run bulk update and insert operations for multiple records using a DML
28
31
  * statement with different parameter sets. Bulk operations can provide a significant
29
32
  * performance improvement over individual insert and update operations.</p>
30
- * <note>
33
+ * <note>
31
34
  * <p>If a call isn't part of a transaction because it doesn't include the <code>transactionID</code> parameter,
32
35
  * changes that result from the call are committed automatically.</p>
33
36
  * <p>There isn't a fixed upper limit on the number of parameter sets. However, the maximum size of the HTTP request
@@ -36,7 +39,7 @@ export interface BatchExecuteStatementCommandOutput extends BatchExecuteStatemen
36
39
  * number of parameter sets that you can include depends on a combination of factors, such as the size of the SQL statement and
37
40
  * the size of each parameter set.</p>
38
41
  * <p>The response size limit is 1 MiB. If the call returns more than 1 MiB of response data, the call is terminated.</p>
39
- * </note>
42
+ * </note>
40
43
  * @example
41
44
  * Use a bare-bones client and the command you need to make an API call.
42
45
  * ```javascript
@@ -161,45 +164,59 @@ export interface BatchExecuteStatementCommandOutput extends BatchExecuteStatemen
161
164
  * @see {@link RDSDataClientResolvedConfig | config} for RDSDataClient's `config` shape.
162
165
  *
163
166
  * @throws {@link AccessDeniedException} (client fault)
164
- * <p>You do not have sufficient access to perform this action.</p>
167
+ * <p>You don't have sufficient access to perform this action.</p>
165
168
  *
166
169
  * @throws {@link BadRequestException} (client fault)
167
- * <p>There is an error in the call or in a SQL statement.</p>
170
+ * <p>There is an error in the call or in a SQL statement. (This error only appears in calls from Aurora Serverless v1 databases.)</p>
171
+ *
172
+ * @throws {@link DatabaseErrorException} (client fault)
173
+ * <p>There was an error in processing the SQL statement.</p>
174
+ *
175
+ * @throws {@link DatabaseNotFoundException} (client fault)
176
+ * <p>The DB cluster doesn't have a DB instance.</p>
177
+ *
178
+ * @throws {@link DatabaseUnavailableException} (server fault)
179
+ * <p>The writer instance in the DB cluster isn't available.</p>
168
180
  *
169
181
  * @throws {@link ForbiddenException} (client fault)
170
182
  * <p>There are insufficient privileges to make the call.</p>
171
183
  *
184
+ * @throws {@link HttpEndpointNotEnabledException} (client fault)
185
+ * <p>The HTTP endpoint for using RDS Data API isn't enabled for the DB cluster.</p>
186
+ *
172
187
  * @throws {@link InternalServerErrorException} (server fault)
173
188
  * <p>An internal error occurred.</p>
174
189
  *
190
+ * @throws {@link InvalidSecretException} (client fault)
191
+ * <p>The Secrets Manager secret used with the request isn't valid.</p>
192
+ *
193
+ * @throws {@link SecretsErrorException} (client fault)
194
+ * <p>There was a problem with the Secrets Manager secret used with the request, caused by one of the following conditions:</p>
195
+ * <ul>
196
+ * <li>
197
+ * <p>RDS Data API timed out retrieving the secret.</p>
198
+ * </li>
199
+ * <li>
200
+ * <p>The secret provided wasn't found.</p>
201
+ * </li>
202
+ * <li>
203
+ * <p>The secret couldn't be decrypted.</p>
204
+ * </li>
205
+ * </ul>
206
+ *
175
207
  * @throws {@link ServiceUnavailableError} (server fault)
176
- * <p>The service specified by the <code>resourceArn</code> parameter is not
208
+ * <p>The service specified by the <code>resourceArn</code> parameter isn't
177
209
  * available.</p>
178
210
  *
179
211
  * @throws {@link StatementTimeoutException} (client fault)
180
212
  * <p>The execution of the SQL statement timed out.</p>
181
213
  *
214
+ * @throws {@link TransactionNotFoundException} (client fault)
215
+ * <p>The transaction ID wasn't found.</p>
216
+ *
182
217
  * @throws {@link RDSDataServiceException}
183
218
  * <p>Base exception class for all service exceptions from RDSData service.</p>
184
219
  *
185
220
  */
186
- export declare class BatchExecuteStatementCommand extends $Command<BatchExecuteStatementCommandInput, BatchExecuteStatementCommandOutput, RDSDataClientResolvedConfig> {
187
- readonly input: BatchExecuteStatementCommandInput;
188
- static getEndpointParameterInstructions(): EndpointParameterInstructions;
189
- /**
190
- * @public
191
- */
192
- constructor(input: BatchExecuteStatementCommandInput);
193
- /**
194
- * @internal
195
- */
196
- resolveMiddleware(clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>, configuration: RDSDataClientResolvedConfig, options?: __HttpHandlerOptions): Handler<BatchExecuteStatementCommandInput, BatchExecuteStatementCommandOutput>;
197
- /**
198
- * @internal
199
- */
200
- private serialize;
201
- /**
202
- * @internal
203
- */
204
- private deserialize;
221
+ export declare class BatchExecuteStatementCommand extends BatchExecuteStatementCommand_base {
205
222
  }
@@ -1,6 +1,5 @@
1
- import { EndpointParameterInstructions } from "@smithy/middleware-endpoint";
2
1
  import { Command as $Command } from "@smithy/smithy-client";
3
- import { Handler, HttpHandlerOptions as __HttpHandlerOptions, MetadataBearer as __MetadataBearer, MiddlewareStack } from "@smithy/types";
2
+ import { MetadataBearer as __MetadataBearer } from "@smithy/types";
4
3
  import { BeginTransactionRequest, BeginTransactionResponse } from "../models/models_0";
5
4
  import { RDSDataClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../RDSDataClient";
6
5
  /**
@@ -21,17 +20,21 @@ export interface BeginTransactionCommandInput extends BeginTransactionRequest {
21
20
  */
22
21
  export interface BeginTransactionCommandOutput extends BeginTransactionResponse, __MetadataBearer {
23
22
  }
23
+ declare const BeginTransactionCommand_base: {
24
+ new (input: BeginTransactionCommandInput): import("@smithy/smithy-client").CommandImpl<BeginTransactionCommandInput, BeginTransactionCommandOutput, RDSDataClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
25
+ getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
26
+ };
24
27
  /**
25
28
  * @public
26
29
  * <p>Starts a SQL transaction.</p>
27
- * <note>
30
+ * <note>
28
31
  * <p>A transaction can run for a maximum of 24 hours. A transaction is terminated and rolled back automatically after 24
29
32
  * hours.</p>
30
33
  * <p>A transaction times out if no calls use its transaction ID in three minutes. If a transaction times out before it's
31
34
  * committed, it's rolled back automatically.</p>
32
35
  * <p>DDL statements inside a transaction cause an implicit commit. We recommend that you run each DDL statement in a separate
33
36
  * <code>ExecuteStatement</code> call with <code>continueAfterTimeout</code> enabled.</p>
34
- * </note>
37
+ * </note>
35
38
  * @example
36
39
  * Use a bare-bones client and the command you need to make an API call.
37
40
  * ```javascript
@@ -59,45 +62,59 @@ export interface BeginTransactionCommandOutput extends BeginTransactionResponse,
59
62
  * @see {@link RDSDataClientResolvedConfig | config} for RDSDataClient's `config` shape.
60
63
  *
61
64
  * @throws {@link AccessDeniedException} (client fault)
62
- * <p>You do not have sufficient access to perform this action.</p>
65
+ * <p>You don't have sufficient access to perform this action.</p>
63
66
  *
64
67
  * @throws {@link BadRequestException} (client fault)
65
- * <p>There is an error in the call or in a SQL statement.</p>
68
+ * <p>There is an error in the call or in a SQL statement. (This error only appears in calls from Aurora Serverless v1 databases.)</p>
69
+ *
70
+ * @throws {@link DatabaseErrorException} (client fault)
71
+ * <p>There was an error in processing the SQL statement.</p>
72
+ *
73
+ * @throws {@link DatabaseNotFoundException} (client fault)
74
+ * <p>The DB cluster doesn't have a DB instance.</p>
75
+ *
76
+ * @throws {@link DatabaseUnavailableException} (server fault)
77
+ * <p>The writer instance in the DB cluster isn't available.</p>
66
78
  *
67
79
  * @throws {@link ForbiddenException} (client fault)
68
80
  * <p>There are insufficient privileges to make the call.</p>
69
81
  *
82
+ * @throws {@link HttpEndpointNotEnabledException} (client fault)
83
+ * <p>The HTTP endpoint for using RDS Data API isn't enabled for the DB cluster.</p>
84
+ *
70
85
  * @throws {@link InternalServerErrorException} (server fault)
71
86
  * <p>An internal error occurred.</p>
72
87
  *
88
+ * @throws {@link InvalidSecretException} (client fault)
89
+ * <p>The Secrets Manager secret used with the request isn't valid.</p>
90
+ *
91
+ * @throws {@link SecretsErrorException} (client fault)
92
+ * <p>There was a problem with the Secrets Manager secret used with the request, caused by one of the following conditions:</p>
93
+ * <ul>
94
+ * <li>
95
+ * <p>RDS Data API timed out retrieving the secret.</p>
96
+ * </li>
97
+ * <li>
98
+ * <p>The secret provided wasn't found.</p>
99
+ * </li>
100
+ * <li>
101
+ * <p>The secret couldn't be decrypted.</p>
102
+ * </li>
103
+ * </ul>
104
+ *
73
105
  * @throws {@link ServiceUnavailableError} (server fault)
74
- * <p>The service specified by the <code>resourceArn</code> parameter is not
106
+ * <p>The service specified by the <code>resourceArn</code> parameter isn't
75
107
  * available.</p>
76
108
  *
77
109
  * @throws {@link StatementTimeoutException} (client fault)
78
110
  * <p>The execution of the SQL statement timed out.</p>
79
111
  *
112
+ * @throws {@link TransactionNotFoundException} (client fault)
113
+ * <p>The transaction ID wasn't found.</p>
114
+ *
80
115
  * @throws {@link RDSDataServiceException}
81
116
  * <p>Base exception class for all service exceptions from RDSData service.</p>
82
117
  *
83
118
  */
84
- export declare class BeginTransactionCommand extends $Command<BeginTransactionCommandInput, BeginTransactionCommandOutput, RDSDataClientResolvedConfig> {
85
- readonly input: BeginTransactionCommandInput;
86
- static getEndpointParameterInstructions(): EndpointParameterInstructions;
87
- /**
88
- * @public
89
- */
90
- constructor(input: BeginTransactionCommandInput);
91
- /**
92
- * @internal
93
- */
94
- resolveMiddleware(clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>, configuration: RDSDataClientResolvedConfig, options?: __HttpHandlerOptions): Handler<BeginTransactionCommandInput, BeginTransactionCommandOutput>;
95
- /**
96
- * @internal
97
- */
98
- private serialize;
99
- /**
100
- * @internal
101
- */
102
- private deserialize;
119
+ export declare class BeginTransactionCommand extends BeginTransactionCommand_base {
103
120
  }
@@ -1,6 +1,5 @@
1
- import { EndpointParameterInstructions } from "@smithy/middleware-endpoint";
2
1
  import { Command as $Command } from "@smithy/smithy-client";
3
- import { Handler, HttpHandlerOptions as __HttpHandlerOptions, MetadataBearer as __MetadataBearer, MiddlewareStack } from "@smithy/types";
2
+ import { MetadataBearer as __MetadataBearer } from "@smithy/types";
4
3
  import { CommitTransactionRequest, CommitTransactionResponse } from "../models/models_0";
5
4
  import { RDSDataClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../RDSDataClient";
6
5
  /**
@@ -21,6 +20,10 @@ export interface CommitTransactionCommandInput extends CommitTransactionRequest
21
20
  */
22
21
  export interface CommitTransactionCommandOutput extends CommitTransactionResponse, __MetadataBearer {
23
22
  }
23
+ declare const CommitTransactionCommand_base: {
24
+ new (input: CommitTransactionCommandInput): import("@smithy/smithy-client").CommandImpl<CommitTransactionCommandInput, CommitTransactionCommandOutput, RDSDataClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
25
+ getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
26
+ };
24
27
  /**
25
28
  * @public
26
29
  * <p>Ends a SQL transaction started with the <code>BeginTransaction</code> operation and
@@ -51,48 +54,62 @@ export interface CommitTransactionCommandOutput extends CommitTransactionRespons
51
54
  * @see {@link RDSDataClientResolvedConfig | config} for RDSDataClient's `config` shape.
52
55
  *
53
56
  * @throws {@link AccessDeniedException} (client fault)
54
- * <p>You do not have sufficient access to perform this action.</p>
57
+ * <p>You don't have sufficient access to perform this action.</p>
55
58
  *
56
59
  * @throws {@link BadRequestException} (client fault)
57
- * <p>There is an error in the call or in a SQL statement.</p>
60
+ * <p>There is an error in the call or in a SQL statement. (This error only appears in calls from Aurora Serverless v1 databases.)</p>
61
+ *
62
+ * @throws {@link DatabaseErrorException} (client fault)
63
+ * <p>There was an error in processing the SQL statement.</p>
64
+ *
65
+ * @throws {@link DatabaseNotFoundException} (client fault)
66
+ * <p>The DB cluster doesn't have a DB instance.</p>
67
+ *
68
+ * @throws {@link DatabaseUnavailableException} (server fault)
69
+ * <p>The writer instance in the DB cluster isn't available.</p>
58
70
  *
59
71
  * @throws {@link ForbiddenException} (client fault)
60
72
  * <p>There are insufficient privileges to make the call.</p>
61
73
  *
74
+ * @throws {@link HttpEndpointNotEnabledException} (client fault)
75
+ * <p>The HTTP endpoint for using RDS Data API isn't enabled for the DB cluster.</p>
76
+ *
62
77
  * @throws {@link InternalServerErrorException} (server fault)
63
78
  * <p>An internal error occurred.</p>
64
79
  *
80
+ * @throws {@link InvalidSecretException} (client fault)
81
+ * <p>The Secrets Manager secret used with the request isn't valid.</p>
82
+ *
65
83
  * @throws {@link NotFoundException} (client fault)
66
84
  * <p>The <code>resourceArn</code>, <code>secretArn</code>, or <code>transactionId</code> value can't be found.</p>
67
85
  *
86
+ * @throws {@link SecretsErrorException} (client fault)
87
+ * <p>There was a problem with the Secrets Manager secret used with the request, caused by one of the following conditions:</p>
88
+ * <ul>
89
+ * <li>
90
+ * <p>RDS Data API timed out retrieving the secret.</p>
91
+ * </li>
92
+ * <li>
93
+ * <p>The secret provided wasn't found.</p>
94
+ * </li>
95
+ * <li>
96
+ * <p>The secret couldn't be decrypted.</p>
97
+ * </li>
98
+ * </ul>
99
+ *
68
100
  * @throws {@link ServiceUnavailableError} (server fault)
69
- * <p>The service specified by the <code>resourceArn</code> parameter is not
101
+ * <p>The service specified by the <code>resourceArn</code> parameter isn't
70
102
  * available.</p>
71
103
  *
72
104
  * @throws {@link StatementTimeoutException} (client fault)
73
105
  * <p>The execution of the SQL statement timed out.</p>
74
106
  *
107
+ * @throws {@link TransactionNotFoundException} (client fault)
108
+ * <p>The transaction ID wasn't found.</p>
109
+ *
75
110
  * @throws {@link RDSDataServiceException}
76
111
  * <p>Base exception class for all service exceptions from RDSData service.</p>
77
112
  *
78
113
  */
79
- export declare class CommitTransactionCommand extends $Command<CommitTransactionCommandInput, CommitTransactionCommandOutput, RDSDataClientResolvedConfig> {
80
- readonly input: CommitTransactionCommandInput;
81
- static getEndpointParameterInstructions(): EndpointParameterInstructions;
82
- /**
83
- * @public
84
- */
85
- constructor(input: CommitTransactionCommandInput);
86
- /**
87
- * @internal
88
- */
89
- resolveMiddleware(clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>, configuration: RDSDataClientResolvedConfig, options?: __HttpHandlerOptions): Handler<CommitTransactionCommandInput, CommitTransactionCommandOutput>;
90
- /**
91
- * @internal
92
- */
93
- private serialize;
94
- /**
95
- * @internal
96
- */
97
- private deserialize;
114
+ export declare class CommitTransactionCommand extends CommitTransactionCommand_base {
98
115
  }
@@ -1,6 +1,5 @@
1
- import { EndpointParameterInstructions } from "@smithy/middleware-endpoint";
2
1
  import { Command as $Command } from "@smithy/smithy-client";
3
- import { Handler, HttpHandlerOptions as __HttpHandlerOptions, MetadataBearer as __MetadataBearer, MiddlewareStack } from "@smithy/types";
2
+ import { MetadataBearer as __MetadataBearer } from "@smithy/types";
4
3
  import { ExecuteSqlRequest, ExecuteSqlResponse } from "../models/models_0";
5
4
  import { RDSDataClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../RDSDataClient";
6
5
  /**
@@ -21,15 +20,19 @@ export interface ExecuteSqlCommandInput extends ExecuteSqlRequest {
21
20
  */
22
21
  export interface ExecuteSqlCommandOutput extends ExecuteSqlResponse, __MetadataBearer {
23
22
  }
23
+ declare const ExecuteSqlCommand_base: {
24
+ new (input: ExecuteSqlCommandInput): import("@smithy/smithy-client").CommandImpl<ExecuteSqlCommandInput, ExecuteSqlCommandOutput, RDSDataClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
25
+ getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
26
+ };
24
27
  /**
25
28
  * @public
26
29
  * @deprecated
27
30
  *
28
31
  * <p>Runs one or more SQL statements.</p>
29
- * <note>
30
- * <p>This operation is deprecated. Use the <code>BatchExecuteStatement</code> or
31
- * <code>ExecuteStatement</code> operation.</p>
32
- * </note>
32
+ * <note>
33
+ * <p>This operation isn't supported for Aurora PostgreSQL Serverless v2 and provisioned DB clusters, and for Aurora Serverless v1 DB clusters,
34
+ * the operation is deprecated. Use the <code>BatchExecuteStatement</code> or <code>ExecuteStatement</code> operation.</p>
35
+ * </note>
33
36
  * @example
34
37
  * Use a bare-bones client and the command you need to make an API call.
35
38
  * ```javascript
@@ -122,10 +125,10 @@ export interface ExecuteSqlCommandOutput extends ExecuteSqlResponse, __MetadataB
122
125
  * @see {@link RDSDataClientResolvedConfig | config} for RDSDataClient's `config` shape.
123
126
  *
124
127
  * @throws {@link AccessDeniedException} (client fault)
125
- * <p>You do not have sufficient access to perform this action.</p>
128
+ * <p>You don't have sufficient access to perform this action.</p>
126
129
  *
127
130
  * @throws {@link BadRequestException} (client fault)
128
- * <p>There is an error in the call or in a SQL statement.</p>
131
+ * <p>There is an error in the call or in a SQL statement. (This error only appears in calls from Aurora Serverless v1 databases.)</p>
129
132
  *
130
133
  * @throws {@link ForbiddenException} (client fault)
131
134
  * <p>There are insufficient privileges to make the call.</p>
@@ -134,30 +137,12 @@ export interface ExecuteSqlCommandOutput extends ExecuteSqlResponse, __MetadataB
134
137
  * <p>An internal error occurred.</p>
135
138
  *
136
139
  * @throws {@link ServiceUnavailableError} (server fault)
137
- * <p>The service specified by the <code>resourceArn</code> parameter is not
140
+ * <p>The service specified by the <code>resourceArn</code> parameter isn't
138
141
  * available.</p>
139
142
  *
140
143
  * @throws {@link RDSDataServiceException}
141
144
  * <p>Base exception class for all service exceptions from RDSData service.</p>
142
145
  *
143
146
  */
144
- export declare class ExecuteSqlCommand extends $Command<ExecuteSqlCommandInput, ExecuteSqlCommandOutput, RDSDataClientResolvedConfig> {
145
- readonly input: ExecuteSqlCommandInput;
146
- static getEndpointParameterInstructions(): EndpointParameterInstructions;
147
- /**
148
- * @public
149
- */
150
- constructor(input: ExecuteSqlCommandInput);
151
- /**
152
- * @internal
153
- */
154
- resolveMiddleware(clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>, configuration: RDSDataClientResolvedConfig, options?: __HttpHandlerOptions): Handler<ExecuteSqlCommandInput, ExecuteSqlCommandOutput>;
155
- /**
156
- * @internal
157
- */
158
- private serialize;
159
- /**
160
- * @internal
161
- */
162
- private deserialize;
147
+ export declare class ExecuteSqlCommand extends ExecuteSqlCommand_base {
163
148
  }
@@ -1,6 +1,5 @@
1
- import { EndpointParameterInstructions } from "@smithy/middleware-endpoint";
2
1
  import { Command as $Command } from "@smithy/smithy-client";
3
- import { Handler, HttpHandlerOptions as __HttpHandlerOptions, MetadataBearer as __MetadataBearer, MiddlewareStack } from "@smithy/types";
2
+ import { MetadataBearer as __MetadataBearer } from "@smithy/types";
4
3
  import { ExecuteStatementRequest, ExecuteStatementResponse } from "../models/models_0";
5
4
  import { RDSDataClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../RDSDataClient";
6
5
  /**
@@ -21,15 +20,19 @@ export interface ExecuteStatementCommandInput extends ExecuteStatementRequest {
21
20
  */
22
21
  export interface ExecuteStatementCommandOutput extends ExecuteStatementResponse, __MetadataBearer {
23
22
  }
23
+ declare const ExecuteStatementCommand_base: {
24
+ new (input: ExecuteStatementCommandInput): import("@smithy/smithy-client").CommandImpl<ExecuteStatementCommandInput, ExecuteStatementCommandOutput, RDSDataClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
25
+ getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
26
+ };
24
27
  /**
25
28
  * @public
26
29
  * <p>Runs a SQL statement against a database.</p>
27
- * <note>
30
+ * <note>
28
31
  * <p>If a call isn't part of a transaction because it doesn't include the
29
32
  * <code>transactionID</code> parameter, changes that result from the call are
30
33
  * committed automatically.</p>
31
34
  * <p>If the binary response data from the database is more than 1 MB, the call is terminated.</p>
32
- * </note>
35
+ * </note>
33
36
  * @example
34
37
  * Use a bare-bones client and the command you need to make an API call.
35
38
  * ```javascript
@@ -188,45 +191,73 @@ export interface ExecuteStatementCommandOutput extends ExecuteStatementResponse,
188
191
  * @see {@link RDSDataClientResolvedConfig | config} for RDSDataClient's `config` shape.
189
192
  *
190
193
  * @throws {@link AccessDeniedException} (client fault)
191
- * <p>You do not have sufficient access to perform this action.</p>
194
+ * <p>You don't have sufficient access to perform this action.</p>
192
195
  *
193
196
  * @throws {@link BadRequestException} (client fault)
194
- * <p>There is an error in the call or in a SQL statement.</p>
197
+ * <p>There is an error in the call or in a SQL statement. (This error only appears in calls from Aurora Serverless v1 databases.)</p>
198
+ *
199
+ * @throws {@link DatabaseErrorException} (client fault)
200
+ * <p>There was an error in processing the SQL statement.</p>
201
+ *
202
+ * @throws {@link DatabaseNotFoundException} (client fault)
203
+ * <p>The DB cluster doesn't have a DB instance.</p>
204
+ *
205
+ * @throws {@link DatabaseUnavailableException} (server fault)
206
+ * <p>The writer instance in the DB cluster isn't available.</p>
195
207
  *
196
208
  * @throws {@link ForbiddenException} (client fault)
197
209
  * <p>There are insufficient privileges to make the call.</p>
198
210
  *
211
+ * @throws {@link HttpEndpointNotEnabledException} (client fault)
212
+ * <p>The HTTP endpoint for using RDS Data API isn't enabled for the DB cluster.</p>
213
+ *
199
214
  * @throws {@link InternalServerErrorException} (server fault)
200
215
  * <p>An internal error occurred.</p>
201
216
  *
217
+ * @throws {@link InvalidSecretException} (client fault)
218
+ * <p>The Secrets Manager secret used with the request isn't valid.</p>
219
+ *
220
+ * @throws {@link SecretsErrorException} (client fault)
221
+ * <p>There was a problem with the Secrets Manager secret used with the request, caused by one of the following conditions:</p>
222
+ * <ul>
223
+ * <li>
224
+ * <p>RDS Data API timed out retrieving the secret.</p>
225
+ * </li>
226
+ * <li>
227
+ * <p>The secret provided wasn't found.</p>
228
+ * </li>
229
+ * <li>
230
+ * <p>The secret couldn't be decrypted.</p>
231
+ * </li>
232
+ * </ul>
233
+ *
202
234
  * @throws {@link ServiceUnavailableError} (server fault)
203
- * <p>The service specified by the <code>resourceArn</code> parameter is not
235
+ * <p>The service specified by the <code>resourceArn</code> parameter isn't
204
236
  * available.</p>
205
237
  *
206
238
  * @throws {@link StatementTimeoutException} (client fault)
207
239
  * <p>The execution of the SQL statement timed out.</p>
208
240
  *
241
+ * @throws {@link TransactionNotFoundException} (client fault)
242
+ * <p>The transaction ID wasn't found.</p>
243
+ *
244
+ * @throws {@link UnsupportedResultException} (client fault)
245
+ * <p>There was a problem with the result because of one of the following conditions:</p>
246
+ * <ul>
247
+ * <li>
248
+ * <p>It contained an unsupported data type.</p>
249
+ * </li>
250
+ * <li>
251
+ * <p>It contained a multidimensional array.</p>
252
+ * </li>
253
+ * <li>
254
+ * <p>The size was too large.</p>
255
+ * </li>
256
+ * </ul>
257
+ *
209
258
  * @throws {@link RDSDataServiceException}
210
259
  * <p>Base exception class for all service exceptions from RDSData service.</p>
211
260
  *
212
261
  */
213
- export declare class ExecuteStatementCommand extends $Command<ExecuteStatementCommandInput, ExecuteStatementCommandOutput, RDSDataClientResolvedConfig> {
214
- readonly input: ExecuteStatementCommandInput;
215
- static getEndpointParameterInstructions(): EndpointParameterInstructions;
216
- /**
217
- * @public
218
- */
219
- constructor(input: ExecuteStatementCommandInput);
220
- /**
221
- * @internal
222
- */
223
- resolveMiddleware(clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>, configuration: RDSDataClientResolvedConfig, options?: __HttpHandlerOptions): Handler<ExecuteStatementCommandInput, ExecuteStatementCommandOutput>;
224
- /**
225
- * @internal
226
- */
227
- private serialize;
228
- /**
229
- * @internal
230
- */
231
- private deserialize;
262
+ export declare class ExecuteStatementCommand extends ExecuteStatementCommand_base {
232
263
  }