Skip to content

Commit 8090631

Browse files
author
awstools
committed
feat(client-rds): Include Global Cluster Identifier in DBCluster if the DBCluster is a Global Cluster Member.
1 parent a99b352 commit 8090631

17 files changed

+57
-24
lines changed

clients/client-rds/src/commands/CreateDBClusterCommand.ts

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -259,6 +259,7 @@ export interface CreateDBClusterCommandOutput extends CreateDBClusterResult, __M
259259
* // Value: "STRING_VALUE",
260260
* // },
261261
* // ],
262+
* // GlobalClusterIdentifier: "STRING_VALUE",
262263
* // GlobalWriteForwardingStatus: "enabled" || "disabled" || "enabling" || "disabling" || "unknown",
263264
* // GlobalWriteForwardingRequested: true || false,
264265
* // PendingModifiedValues: { // ClusterPendingModifiedValues

clients/client-rds/src/commands/DeleteDBClusterCommand.ts

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -177,6 +177,7 @@ export interface DeleteDBClusterCommandOutput extends DeleteDBClusterResult, __M
177177
* // Value: "STRING_VALUE",
178178
* // },
179179
* // ],
180+
* // GlobalClusterIdentifier: "STRING_VALUE",
180181
* // GlobalWriteForwardingStatus: "enabled" || "disabled" || "enabling" || "disabling" || "unknown",
181182
* // GlobalWriteForwardingRequested: true || false,
182183
* // PendingModifiedValues: { // ClusterPendingModifiedValues

clients/client-rds/src/commands/DescribeDBClustersCommand.ts

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -184,6 +184,7 @@ export interface DescribeDBClustersCommandOutput extends DBClusterMessage, __Met
184184
* // Value: "STRING_VALUE",
185185
* // },
186186
* // ],
187+
* // GlobalClusterIdentifier: "STRING_VALUE",
187188
* // GlobalWriteForwardingStatus: "enabled" || "disabled" || "enabling" || "disabling" || "unknown",
188189
* // GlobalWriteForwardingRequested: true || false,
189190
* // PendingModifiedValues: { // ClusterPendingModifiedValues

clients/client-rds/src/commands/DownloadDBLogFilePortionCommand.ts

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -30,6 +30,11 @@ export interface DownloadDBLogFilePortionCommandOutput extends DownloadDBLogFile
3030
/**
3131
* <p>Downloads all or a portion of the specified log file, up to 1 MB in size.</p>
3232
* <p>This command doesn't apply to RDS Custom.</p>
33+
* <note>
34+
* <p>This operation uses resources on database instances. Because of this, we recommend publishing database logs to CloudWatch and then
35+
* using the GetLogEvents operation. For more information,
36+
* see <a href="https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_GetLogEvents.html">GetLogEvents</a> in the <i>Amazon CloudWatch Logs API Reference</i>.</p>
37+
* </note>
3338
* @example
3439
* Use a bare-bones client and the command you need to make an API call.
3540
* ```javascript

clients/client-rds/src/commands/FailoverDBClusterCommand.ts

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -183,6 +183,7 @@ export interface FailoverDBClusterCommandOutput extends FailoverDBClusterResult,
183183
* // Value: "STRING_VALUE",
184184
* // },
185185
* // ],
186+
* // GlobalClusterIdentifier: "STRING_VALUE",
186187
* // GlobalWriteForwardingStatus: "enabled" || "disabled" || "enabling" || "disabling" || "unknown",
187188
* // GlobalWriteForwardingRequested: true || false,
188189
* // PendingModifiedValues: { // ClusterPendingModifiedValues

clients/client-rds/src/commands/ModifyDBClusterCommand.ts

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -237,6 +237,7 @@ export interface ModifyDBClusterCommandOutput extends ModifyDBClusterResult, __M
237237
* // Value: "STRING_VALUE",
238238
* // },
239239
* // ],
240+
* // GlobalClusterIdentifier: "STRING_VALUE",
240241
* // GlobalWriteForwardingStatus: "enabled" || "disabled" || "enabling" || "disabling" || "unknown",
241242
* // GlobalWriteForwardingRequested: true || false,
242243
* // PendingModifiedValues: { // ClusterPendingModifiedValues

clients/client-rds/src/commands/PromoteReadReplicaDBClusterCommand.ts

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -164,6 +164,7 @@ export interface PromoteReadReplicaDBClusterCommandOutput extends PromoteReadRep
164164
* // Value: "STRING_VALUE",
165165
* // },
166166
* // ],
167+
* // GlobalClusterIdentifier: "STRING_VALUE",
167168
* // GlobalWriteForwardingStatus: "enabled" || "disabled" || "enabling" || "disabling" || "unknown",
168169
* // GlobalWriteForwardingRequested: true || false,
169170
* // PendingModifiedValues: { // ClusterPendingModifiedValues

clients/client-rds/src/commands/RebootDBClusterCommand.ts

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -174,6 +174,7 @@ export interface RebootDBClusterCommandOutput extends RebootDBClusterResult, __M
174174
* // Value: "STRING_VALUE",
175175
* // },
176176
* // ],
177+
* // GlobalClusterIdentifier: "STRING_VALUE",
177178
* // GlobalWriteForwardingStatus: "enabled" || "disabled" || "enabling" || "disabling" || "unknown",
178179
* // GlobalWriteForwardingRequested: true || false,
179180
* // PendingModifiedValues: { // ClusterPendingModifiedValues

clients/client-rds/src/commands/RestoreDBClusterFromS3Command.ts

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -232,6 +232,7 @@ export interface RestoreDBClusterFromS3CommandOutput extends RestoreDBClusterFro
232232
* // Value: "STRING_VALUE",
233233
* // },
234234
* // ],
235+
* // GlobalClusterIdentifier: "STRING_VALUE",
235236
* // GlobalWriteForwardingStatus: "enabled" || "disabled" || "enabling" || "disabling" || "unknown",
236237
* // GlobalWriteForwardingRequested: true || false,
237238
* // PendingModifiedValues: { // ClusterPendingModifiedValues

clients/client-rds/src/commands/RestoreDBClusterFromSnapshotCommand.ts

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -244,6 +244,7 @@ export interface RestoreDBClusterFromSnapshotCommandOutput
244244
* // Value: "STRING_VALUE",
245245
* // },
246246
* // ],
247+
* // GlobalClusterIdentifier: "STRING_VALUE",
247248
* // GlobalWriteForwardingStatus: "enabled" || "disabled" || "enabling" || "disabling" || "unknown",
248249
* // GlobalWriteForwardingRequested: true || false,
249250
* // PendingModifiedValues: { // ClusterPendingModifiedValues

clients/client-rds/src/commands/RestoreDBClusterToPointInTimeCommand.ts

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -249,6 +249,7 @@ export interface RestoreDBClusterToPointInTimeCommandOutput
249249
* // Value: "STRING_VALUE",
250250
* // },
251251
* // ],
252+
* // GlobalClusterIdentifier: "STRING_VALUE",
252253
* // GlobalWriteForwardingStatus: "enabled" || "disabled" || "enabling" || "disabling" || "unknown",
253254
* // GlobalWriteForwardingRequested: true || false,
254255
* // PendingModifiedValues: { // ClusterPendingModifiedValues

clients/client-rds/src/commands/StartDBClusterCommand.ts

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -171,6 +171,7 @@ export interface StartDBClusterCommandOutput extends StartDBClusterResult, __Met
171171
* // Value: "STRING_VALUE",
172172
* // },
173173
* // ],
174+
* // GlobalClusterIdentifier: "STRING_VALUE",
174175
* // GlobalWriteForwardingStatus: "enabled" || "disabled" || "enabling" || "disabling" || "unknown",
175176
* // GlobalWriteForwardingRequested: true || false,
176177
* // PendingModifiedValues: { // ClusterPendingModifiedValues

clients/client-rds/src/commands/StopDBClusterCommand.ts

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -172,6 +172,7 @@ export interface StopDBClusterCommandOutput extends StopDBClusterResult, __Metad
172172
* // Value: "STRING_VALUE",
173173
* // },
174174
* // ],
175+
* // GlobalClusterIdentifier: "STRING_VALUE",
175176
* // GlobalWriteForwardingStatus: "enabled" || "disabled" || "enabling" || "disabling" || "unknown",
176177
* // GlobalWriteForwardingRequested: true || false,
177178
* // PendingModifiedValues: { // ClusterPendingModifiedValues

clients/client-rds/src/models/models_0.ts

Lines changed: 15 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -6358,6 +6358,13 @@ export interface DBCluster {
63586358
*/
63596359
TagList?: Tag[] | undefined;
63606360

6361+
/**
6362+
* <p>Contains a user-supplied global database cluster identifier. This identifier is the unique key that
6363+
* identifies a global database cluster.</p>
6364+
* @public
6365+
*/
6366+
GlobalClusterIdentifier?: string | undefined;
6367+
63616368
/**
63626369
* <p>The status of write forwarding for a secondary cluster in an Aurora global database.</p>
63636370
* @public
@@ -8978,7 +8985,9 @@ export interface DBSubnetGroup {
89788985
SubnetGroupStatus?: string | undefined;
89798986

89808987
/**
8981-
* <p>Contains a list of <code>Subnet</code> elements.</p>
8988+
* <p>Contains a list of <code>Subnet</code> elements. The list of subnets shown
8989+
* here might not reflect the current state of your VPC. For the most up-to-date information,
8990+
* we recommend checking your VPC configuration directly.</p>
89828991
* @public
89838992
*/
89848993
Subnets?: Subnet[] | undefined;
@@ -11708,16 +11717,17 @@ export interface CreateDBShardGroupMessage {
1170811717
DBClusterIdentifier: string | undefined;
1170911718

1171011719
/**
11711-
* <p>Specifies whether to create standby DB shard groups for the DB shard group. Valid values are the following:</p>
11720+
* <p>Specifies whether to create standby standby DB data access shard for the DB shard group.
11721+
* Valid values are the following:</p>
1171211722
* <ul>
1171311723
* <li>
11714-
* <p>0 - Creates a DB shard group without a standby DB shard group. This is the default value.</p>
11724+
* <p>0 - Creates a DB shard group without a standby DB data access shard. This is the default value.</p>
1171511725
* </li>
1171611726
* <li>
11717-
* <p>1 - Creates a DB shard group with a standby DB shard group in a different Availability Zone (AZ).</p>
11727+
* <p>1 - Creates a DB shard group with a standby DB data access shard in a different Availability Zone (AZ).</p>
1171811728
* </li>
1171911729
* <li>
11720-
* <p>2 - Creates a DB shard group with two standby DB shard groups in two different AZs.</p>
11730+
* <p>2 - Creates a DB shard group with two standby DB data access shard in two different AZs.</p>
1172111731
* </li>
1172211732
* </ul>
1172311733
* @public

clients/client-rds/src/models/models_1.ts

Lines changed: 10 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -2541,11 +2541,11 @@ export interface ConnectionPoolConfigurationInfo {
25412541

25422542
/**
25432543
* <p>One or more SQL statements for the proxy to run when opening each new database connection.
2544-
* Typically used with <code>SET</code> statements to make sure that each connection has identical
2545-
* settings such as time zone and character set. This setting is empty by default.
2546-
* For multiple statements, use semicolons as the separator.
2547-
* You can also include multiple variables in a single <code>SET</code> statement, such as
2548-
* <code>SET x=1, y=2</code>.</p>
2544+
* The setting is typically used with <code>SET</code> statements to make sure that each connection has identical settings.
2545+
* The query added here must be valid. For including multiple variables in a single SET statement, use a comma separator.
2546+
* This is an optional field.</p>
2547+
* <p>For example: <code>SET variable1=value1, variable2=value2</code>
2548+
* </p>
25492549
* @public
25502550
*/
25512551
InitQuery?: string | undefined;
@@ -9973,7 +9973,7 @@ export interface ConnectionPoolConfiguration {
99739973
* <p>Constraints:</p>
99749974
* <ul>
99759975
* <li>
9976-
* <p>Must be between 0 and 3600.</p>
9976+
* <p>Must be between 0 and 300.</p>
99779977
* </li>
99789978
* </ul>
99799979
* @public
@@ -9990,15 +9990,12 @@ export interface ConnectionPoolConfiguration {
99909990
SessionPinningFilters?: string[] | undefined;
99919991

99929992
/**
9993-
* <p>Add an initialization query, or modify the current one. You can specify one or more SQL statements for
9994-
* the proxy to run when opening each new database connection. The setting is
9995-
* typically used with <code>SET</code> statements to make sure that each
9996-
* connection has identical settings. Make sure that the query you add is valid. To
9997-
* include multiple variables in a single <code>SET</code> statement, use comma
9998-
* separators.</p>
9993+
* <p>Add an initialization query, or modify the current one. You can specify one or more SQL statements for the proxy to run when opening each new database connection.
9994+
* The setting is typically used with <code>SET</code> statements to make sure that each connection has identical settings.
9995+
* Make sure the query added here is valid. This is an optional field, so you can choose to leave it empty.
9996+
* For including multiple variables in a single SET statement, use a comma separator.</p>
99999997
* <p>For example: <code>SET variable1=value1, variable2=value2</code>
100009998
* </p>
10001-
* <p>For multiple statements, use semicolons as the separator.</p>
100029999
* <p>Default: no initialization query</p>
1000310000
* @public
1000410001
*/

clients/client-rds/src/protocols/Aws_query.ts

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -17545,6 +17545,9 @@ const de_DBCluster = (output: any, context: __SerdeContext): DBCluster => {
1754517545
} else if (output[_TL] != null && output[_TL][_Tag] != null) {
1754617546
contents[_TL] = de_TagList(__getArrayIfSingleItem(output[_TL][_Tag]), context);
1754717547
}
17548+
if (output[_GCI] != null) {
17549+
contents[_GCI] = __expectString(output[_GCI]);
17550+
}
1754817551
if (output[_GWFS] != null) {
1754917552
contents[_GWFS] = __expectString(output[_GWFS]);
1755017553
}

codegen/sdk-codegen/aws-models/rds.json

Lines changed: 12 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -3020,7 +3020,7 @@
30203020
"ConnectionBorrowTimeout": {
30213021
"target": "com.amazonaws.rds#IntegerOptional",
30223022
"traits": {
3023-
"smithy.api#documentation": "<p>The number of seconds for a proxy to wait for a connection to become available in the connection pool. This setting only applies when the\n proxy has opened its maximum number of connections and all connections are busy with client sessions.</p>\n <p>Default: <code>120</code>\n </p>\n <p>Constraints:</p>\n <ul>\n <li>\n <p>Must be between 0 and 3600.</p>\n </li>\n </ul>"
3023+
"smithy.api#documentation": "<p>The number of seconds for a proxy to wait for a connection to become available in the connection pool. This setting only applies when the\n proxy has opened its maximum number of connections and all connections are busy with client sessions.</p>\n <p>Default: <code>120</code>\n </p>\n <p>Constraints:</p>\n <ul>\n <li>\n <p>Must be between 0 and 300.</p>\n </li>\n </ul>"
30243024
}
30253025
},
30263026
"SessionPinningFilters": {
@@ -3032,7 +3032,7 @@
30323032
"InitQuery": {
30333033
"target": "com.amazonaws.rds#String",
30343034
"traits": {
3035-
"smithy.api#documentation": "<p>Add an initialization query, or modify the current one. You can specify one or more SQL statements for\n the proxy to run when opening each new database connection. The setting is\n typically used with <code>SET</code> statements to make sure that each\n connection has identical settings. Make sure that the query you add is valid. To\n include multiple variables in a single <code>SET</code> statement, use comma\n separators.</p>\n <p>For example: <code>SET variable1=value1, variable2=value2</code>\n </p>\n <p>For multiple statements, use semicolons as the separator.</p>\n <p>Default: no initialization query</p>"
3035+
"smithy.api#documentation": "<p>Add an initialization query, or modify the current one. You can specify one or more SQL statements for the proxy to run when opening each new database connection. \n The setting is typically used with <code>SET</code> statements to make sure that each connection has identical settings. \n Make sure the query added here is valid. This is an optional field, so you can choose to leave it empty.\n For including multiple variables in a single SET statement, use a comma separator.</p>\n <p>For example: <code>SET variable1=value1, variable2=value2</code>\n </p>\n <p>Default: no initialization query</p>"
30363036
}
30373037
}
30383038
},
@@ -3070,7 +3070,7 @@
30703070
"InitQuery": {
30713071
"target": "com.amazonaws.rds#String",
30723072
"traits": {
3073-
"smithy.api#documentation": "<p>One or more SQL statements for the proxy to run when opening each new database connection.\n Typically used with <code>SET</code> statements to make sure that each connection has identical\n settings such as time zone and character set. This setting is empty by default.\n For multiple statements, use semicolons as the separator.\n You can also include multiple variables in a single <code>SET</code> statement, such as\n <code>SET x=1, y=2</code>.</p>"
3073+
"smithy.api#documentation": "<p>One or more SQL statements for the proxy to run when opening each new database connection. \n The setting is typically used with <code>SET</code> statements to make sure that each connection has identical settings. \n The query added here must be valid. For including multiple variables in a single SET statement, use a comma separator. \n This is an optional field.</p>\n <p>For example: <code>SET variable1=value1, variable2=value2</code>\n </p>"
30743074
}
30753075
}
30763076
},
@@ -6165,7 +6165,7 @@
61656165
"ComputeRedundancy": {
61666166
"target": "com.amazonaws.rds#IntegerOptional",
61676167
"traits": {
6168-
"smithy.api#documentation": "<p>Specifies whether to create standby DB shard groups for the DB shard group. Valid values are the following:</p>\n <ul>\n <li>\n <p>0 - Creates a DB shard group without a standby DB shard group. This is the default value.</p>\n </li>\n <li>\n <p>1 - Creates a DB shard group with a standby DB shard group in a different Availability Zone (AZ).</p>\n </li>\n <li>\n <p>2 - Creates a DB shard group with two standby DB shard groups in two different AZs.</p>\n </li>\n </ul>"
6168+
"smithy.api#documentation": "<p>Specifies whether to create standby standby DB data access shard for the DB shard group. \n Valid values are the following:</p>\n <ul>\n <li>\n <p>0 - Creates a DB shard group without a standby DB data access shard. This is the default value.</p>\n </li>\n <li>\n <p>1 - Creates a DB shard group with a standby DB data access shard in a different Availability Zone (AZ).</p>\n </li>\n <li>\n <p>2 - Creates a DB shard group with two standby DB data access shard in two different AZs.</p>\n </li>\n </ul>"
61696169
}
61706170
},
61716171
"MaxACU": {
@@ -7457,6 +7457,12 @@
74577457
"TagList": {
74587458
"target": "com.amazonaws.rds#TagList"
74597459
},
7460+
"GlobalClusterIdentifier": {
7461+
"target": "com.amazonaws.rds#GlobalClusterIdentifier",
7462+
"traits": {
7463+
"smithy.api#documentation": "<p>Contains a user-supplied global database cluster identifier. This identifier is the unique key that\n identifies a global database cluster.</p>"
7464+
}
7465+
},
74607466
"GlobalWriteForwardingStatus": {
74617467
"target": "com.amazonaws.rds#WriteForwardingStatus",
74627468
"traits": {
@@ -11822,7 +11828,7 @@
1182211828
"Subnets": {
1182311829
"target": "com.amazonaws.rds#SubnetList",
1182411830
"traits": {
11825-
"smithy.api#documentation": "<p>Contains a list of <code>Subnet</code> elements.</p>"
11831+
"smithy.api#documentation": "<p>Contains a list of <code>Subnet</code> elements. The list of subnets shown \n here might not reflect the current state of your VPC. For the most up-to-date information, \n we recommend checking your VPC configuration directly.</p>"
1182611832
}
1182711833
},
1182811834
"DBSubnetGroupArn": {
@@ -18618,7 +18624,7 @@
1861818624
}
1861918625
],
1862018626
"traits": {
18621-
"smithy.api#documentation": "<p>Downloads all or a portion of the specified log file, up to 1 MB in size.</p>\n <p>This command doesn't apply to RDS Custom.</p>",
18627+
"smithy.api#documentation": "<p>Downloads all or a portion of the specified log file, up to 1 MB in size.</p>\n <p>This command doesn't apply to RDS Custom.</p>\n <note>\n <p>This operation uses resources on database instances. Because of this, we recommend publishing database logs to CloudWatch and then \n using the GetLogEvents operation. For more information, \n see <a href=\"https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_GetLogEvents.html\">GetLogEvents</a> in the <i>Amazon CloudWatch Logs API Reference</i>.</p>\n </note>",
1862218628
"smithy.api#examples": [
1862318629
{
1862418630
"title": "To download a DB log file",

0 commit comments

Comments
 (0)