feat(client-rds): Include Global Cluster Identifier in DBCluster if the DBCluster is a Global Cluster Member.

awstools · awstools · commit 80906313d78c · 2025-06-06T18:20:12.000Z
diff --git a/clients/client-rds/src/commands/CreateDBClusterCommand.ts b/clients/client-rds/src/commands/CreateDBClusterCommand.ts
@@ -259,6 +259,7 @@ export interface CreateDBClusterCommandOutput extends CreateDBClusterResult, __M
  * //         Value: "STRING_VALUE",
  * //       },
  * //     ],
+ * //     GlobalClusterIdentifier: "STRING_VALUE",
  * //     GlobalWriteForwardingStatus: "enabled" || "disabled" || "enabling" || "disabling" || "unknown",
  * //     GlobalWriteForwardingRequested: true || false,
  * //     PendingModifiedValues: { // ClusterPendingModifiedValues
diff --git a/clients/client-rds/src/commands/DeleteDBClusterCommand.ts b/clients/client-rds/src/commands/DeleteDBClusterCommand.ts
@@ -177,6 +177,7 @@ export interface DeleteDBClusterCommandOutput extends DeleteDBClusterResult, __M
  * //         Value: "STRING_VALUE",
  * //       },
  * //     ],
+ * //     GlobalClusterIdentifier: "STRING_VALUE",
  * //     GlobalWriteForwardingStatus: "enabled" || "disabled" || "enabling" || "disabling" || "unknown",
  * //     GlobalWriteForwardingRequested: true || false,
  * //     PendingModifiedValues: { // ClusterPendingModifiedValues
diff --git a/clients/client-rds/src/commands/DescribeDBClustersCommand.ts b/clients/client-rds/src/commands/DescribeDBClustersCommand.ts
@@ -184,6 +184,7 @@ export interface DescribeDBClustersCommandOutput extends DBClusterMessage, __Met
  * //           Value: "STRING_VALUE",
  * //         },
  * //       ],
+ * //       GlobalClusterIdentifier: "STRING_VALUE",
  * //       GlobalWriteForwardingStatus: "enabled" || "disabled" || "enabling" || "disabling" || "unknown",
  * //       GlobalWriteForwardingRequested: true || false,
  * //       PendingModifiedValues: { // ClusterPendingModifiedValues
diff --git a/clients/client-rds/src/commands/DownloadDBLogFilePortionCommand.ts b/clients/client-rds/src/commands/DownloadDBLogFilePortionCommand.ts
@@ -30,6 +30,11 @@ export interface DownloadDBLogFilePortionCommandOutput extends DownloadDBLogFile
 /**
  * <p>Downloads all or a portion of the specified log file, up to 1 MB in size.</p>
  *          <p>This command doesn't apply to RDS Custom.</p>
+ *          <note>
+ *             <p>This operation uses resources on database instances. Because of this, we recommend publishing database logs to CloudWatch and then
+ *                 using the GetLogEvents operation. For more information,
+ *                 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>
+ *          </note>
  * @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/FailoverDBClusterCommand.ts b/clients/client-rds/src/commands/FailoverDBClusterCommand.ts
@@ -183,6 +183,7 @@ export interface FailoverDBClusterCommandOutput extends FailoverDBClusterResult,
  * //         Value: "STRING_VALUE",
  * //       },
  * //     ],
+ * //     GlobalClusterIdentifier: "STRING_VALUE",
  * //     GlobalWriteForwardingStatus: "enabled" || "disabled" || "enabling" || "disabling" || "unknown",
  * //     GlobalWriteForwardingRequested: true || false,
  * //     PendingModifiedValues: { // ClusterPendingModifiedValues
diff --git a/clients/client-rds/src/commands/ModifyDBClusterCommand.ts b/clients/client-rds/src/commands/ModifyDBClusterCommand.ts
@@ -237,6 +237,7 @@ export interface ModifyDBClusterCommandOutput extends ModifyDBClusterResult, __M
  * //         Value: "STRING_VALUE",
  * //       },
  * //     ],
+ * //     GlobalClusterIdentifier: "STRING_VALUE",
  * //     GlobalWriteForwardingStatus: "enabled" || "disabled" || "enabling" || "disabling" || "unknown",
  * //     GlobalWriteForwardingRequested: true || false,
  * //     PendingModifiedValues: { // ClusterPendingModifiedValues
diff --git a/clients/client-rds/src/commands/PromoteReadReplicaDBClusterCommand.ts b/clients/client-rds/src/commands/PromoteReadReplicaDBClusterCommand.ts
@@ -164,6 +164,7 @@ export interface PromoteReadReplicaDBClusterCommandOutput extends PromoteReadRep
  * //         Value: "STRING_VALUE",
  * //       },
  * //     ],
+ * //     GlobalClusterIdentifier: "STRING_VALUE",
  * //     GlobalWriteForwardingStatus: "enabled" || "disabled" || "enabling" || "disabling" || "unknown",
  * //     GlobalWriteForwardingRequested: true || false,
  * //     PendingModifiedValues: { // ClusterPendingModifiedValues
diff --git a/clients/client-rds/src/commands/RebootDBClusterCommand.ts b/clients/client-rds/src/commands/RebootDBClusterCommand.ts
@@ -174,6 +174,7 @@ export interface RebootDBClusterCommandOutput extends RebootDBClusterResult, __M
  * //         Value: "STRING_VALUE",
  * //       },
  * //     ],
+ * //     GlobalClusterIdentifier: "STRING_VALUE",
  * //     GlobalWriteForwardingStatus: "enabled" || "disabled" || "enabling" || "disabling" || "unknown",
  * //     GlobalWriteForwardingRequested: true || false,
  * //     PendingModifiedValues: { // ClusterPendingModifiedValues
diff --git a/clients/client-rds/src/commands/RestoreDBClusterFromS3Command.ts b/clients/client-rds/src/commands/RestoreDBClusterFromS3Command.ts
@@ -232,6 +232,7 @@ export interface RestoreDBClusterFromS3CommandOutput extends RestoreDBClusterFro
  * //         Value: "STRING_VALUE",
  * //       },
  * //     ],
+ * //     GlobalClusterIdentifier: "STRING_VALUE",
  * //     GlobalWriteForwardingStatus: "enabled" || "disabled" || "enabling" || "disabling" || "unknown",
  * //     GlobalWriteForwardingRequested: true || false,
  * //     PendingModifiedValues: { // ClusterPendingModifiedValues
diff --git a/clients/client-rds/src/commands/RestoreDBClusterFromSnapshotCommand.ts b/clients/client-rds/src/commands/RestoreDBClusterFromSnapshotCommand.ts
@@ -244,6 +244,7 @@ export interface RestoreDBClusterFromSnapshotCommandOutput
  * //         Value: "STRING_VALUE",
  * //       },
  * //     ],
+ * //     GlobalClusterIdentifier: "STRING_VALUE",
  * //     GlobalWriteForwardingStatus: "enabled" || "disabled" || "enabling" || "disabling" || "unknown",
  * //     GlobalWriteForwardingRequested: true || false,
  * //     PendingModifiedValues: { // ClusterPendingModifiedValues
diff --git a/clients/client-rds/src/commands/RestoreDBClusterToPointInTimeCommand.ts b/clients/client-rds/src/commands/RestoreDBClusterToPointInTimeCommand.ts
@@ -249,6 +249,7 @@ export interface RestoreDBClusterToPointInTimeCommandOutput
  * //         Value: "STRING_VALUE",
  * //       },
  * //     ],
+ * //     GlobalClusterIdentifier: "STRING_VALUE",
  * //     GlobalWriteForwardingStatus: "enabled" || "disabled" || "enabling" || "disabling" || "unknown",
  * //     GlobalWriteForwardingRequested: true || false,
  * //     PendingModifiedValues: { // ClusterPendingModifiedValues
diff --git a/clients/client-rds/src/commands/StartDBClusterCommand.ts b/clients/client-rds/src/commands/StartDBClusterCommand.ts
@@ -171,6 +171,7 @@ export interface StartDBClusterCommandOutput extends StartDBClusterResult, __Met
  * //         Value: "STRING_VALUE",
  * //       },
  * //     ],
+ * //     GlobalClusterIdentifier: "STRING_VALUE",
  * //     GlobalWriteForwardingStatus: "enabled" || "disabled" || "enabling" || "disabling" || "unknown",
  * //     GlobalWriteForwardingRequested: true || false,
  * //     PendingModifiedValues: { // ClusterPendingModifiedValues
diff --git a/clients/client-rds/src/commands/StopDBClusterCommand.ts b/clients/client-rds/src/commands/StopDBClusterCommand.ts
@@ -172,6 +172,7 @@ export interface StopDBClusterCommandOutput extends StopDBClusterResult, __Metad
  * //         Value: "STRING_VALUE",
  * //       },
  * //     ],
+ * //     GlobalClusterIdentifier: "STRING_VALUE",
  * //     GlobalWriteForwardingStatus: "enabled" || "disabled" || "enabling" || "disabling" || "unknown",
  * //     GlobalWriteForwardingRequested: true || false,
  * //     PendingModifiedValues: { // ClusterPendingModifiedValues
diff --git a/clients/client-rds/src/models/models_0.ts b/clients/client-rds/src/models/models_0.ts
@@ -6358,6 +6358,13 @@ export interface DBCluster {
    */
   TagList?: Tag[] | undefined;
 
+  /**
+   * <p>Contains a user-supplied global database cluster identifier. This identifier is the unique key that
+   *         identifies a global database cluster.</p>
+   * @public
+   */
+  GlobalClusterIdentifier?: string | undefined;
+
   /**
    * <p>The status of write forwarding for a secondary cluster in an Aurora global database.</p>
    * @public
@@ -8978,7 +8985,9 @@ export interface DBSubnetGroup {
   SubnetGroupStatus?: string | undefined;
 
   /**
-   * <p>Contains a list of <code>Subnet</code> elements.</p>
+   * <p>Contains a list of <code>Subnet</code> elements. The list of subnets shown
+   *             here might not reflect the current state of your VPC. For the most up-to-date information,
+   *             we recommend checking your VPC configuration directly.</p>
    * @public
    */
   Subnets?: Subnet[] | undefined;
@@ -11708,16 +11717,17 @@ export interface CreateDBShardGroupMessage {
   DBClusterIdentifier: string | undefined;
 
   /**
-   * <p>Specifies whether to create standby DB shard groups for the DB shard group. Valid values are the following:</p>
+   * <p>Specifies whether to create standby standby DB data access shard for the DB shard group.
+   *             Valid values are the following:</p>
    *          <ul>
    *             <li>
-   *                <p>0 - Creates a DB shard group without a standby DB shard group. This is the default value.</p>
+   *                <p>0 - Creates a DB shard group without a standby DB data access shard. This is the default value.</p>
    *             </li>
    *             <li>
-   *                <p>1 - Creates a DB shard group with a standby DB shard group in a different Availability Zone (AZ).</p>
+   *                <p>1 - Creates a DB shard group with a standby DB data access shard in a different Availability Zone (AZ).</p>
    *             </li>
    *             <li>
-   *                <p>2 - Creates a DB shard group with two standby DB shard groups in two different AZs.</p>
+   *                <p>2 - Creates a DB shard group with two standby DB data access shard in two different AZs.</p>
    *             </li>
    *          </ul>
    * @public
diff --git a/clients/client-rds/src/models/models_1.ts b/clients/client-rds/src/models/models_1.ts
@@ -2541,11 +2541,11 @@ export interface ConnectionPoolConfigurationInfo {
 
   /**
    * <p>One or more SQL statements for the proxy to run when opening each new database connection.
-   *         Typically used with <code>SET</code> statements to make sure that each connection has identical
-   *         settings such as time zone and character set. This setting is empty by default.
-   *         For multiple statements, use semicolons as the separator.
-   *         You can also include multiple variables in a single <code>SET</code> statement, such as
-   *         <code>SET x=1, y=2</code>.</p>
+   *         The setting is typically used with <code>SET</code> statements to make sure that each connection has identical settings.
+   *         The query added here must be valid. For including multiple variables in a single SET statement, use a comma separator.
+   *         This is an optional field.</p>
+   *          <p>For example: <code>SET variable1=value1, variable2=value2</code>
+   *          </p>
    * @public
    */
   InitQuery?: string | undefined;
@@ -9973,7 +9973,7 @@ export interface ConnectionPoolConfiguration {
    *          <p>Constraints:</p>
    *          <ul>
    *             <li>
-   *                <p>Must be between 0 and 3600.</p>
+   *                <p>Must be between 0 and 300.</p>
    *             </li>
    *          </ul>
    * @public
@@ -9990,15 +9990,12 @@ export interface ConnectionPoolConfiguration {
   SessionPinningFilters?: string[] | undefined;
 
   /**
-   * <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. The setting is
-   *             typically used with <code>SET</code> statements to make sure that each
-   *             connection has identical settings. Make sure that the query you add is valid. To
-   *             include multiple variables in a single <code>SET</code> statement, use comma
-   *             separators.</p>
+   * <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.
+   *             The setting is typically used with <code>SET</code> statements to make sure that each connection has identical settings.
+   *             Make sure the query added here is valid. This is an optional field, so you can choose to leave it empty.
+   *             For including multiple variables in a single SET statement, use a comma separator.</p>
    *          <p>For example: <code>SET variable1=value1, variable2=value2</code>
    *          </p>
-   *          <p>For multiple statements, use semicolons as the separator.</p>
    *          <p>Default: no initialization query</p>
    * @public
    */
diff --git a/clients/client-rds/src/protocols/Aws_query.ts b/clients/client-rds/src/protocols/Aws_query.ts
@@ -17545,6 +17545,9 @@ const de_DBCluster = (output: any, context: __SerdeContext): DBCluster => {
   } else if (output[_TL] != null && output[_TL][_Tag] != null) {
     contents[_TL] = de_TagList(__getArrayIfSingleItem(output[_TL][_Tag]), context);
   }
+  if (output[_GCI] != null) {
+    contents[_GCI] = __expectString(output[_GCI]);
+  }
   if (output[_GWFS] != null) {
     contents[_GWFS] = __expectString(output[_GWFS]);
   }
diff --git a/codegen/sdk-codegen/aws-models/rds.json b/codegen/sdk-codegen/aws-models/rds.json
@@ -3020,7 +3020,7 @@
         "ConnectionBorrowTimeout": {
           "target": "com.amazonaws.rds#IntegerOptional",
           "traits": {
-            "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>"
+            "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>"
           }
         },
         "SessionPinningFilters": {
@@ -3032,7 +3032,7 @@
         "InitQuery": {
           "target": "com.amazonaws.rds#String",
           "traits": {
-            "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>"
+            "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>"
           }
         }
       },
@@ -3070,7 +3070,7 @@
         "InitQuery": {
           "target": "com.amazonaws.rds#String",
           "traits": {
-            "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>"
+            "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>"
           }
         }
       },
@@ -6165,7 +6165,7 @@
         "ComputeRedundancy": {
           "target": "com.amazonaws.rds#IntegerOptional",
           "traits": {
-            "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>"
+            "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>"
           }
         },
         "MaxACU": {
@@ -7457,6 +7457,12 @@
         "TagList": {
           "target": "com.amazonaws.rds#TagList"
         },
+        "GlobalClusterIdentifier": {
+          "target": "com.amazonaws.rds#GlobalClusterIdentifier",
+          "traits": {
+            "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>"
+          }
+        },
         "GlobalWriteForwardingStatus": {
           "target": "com.amazonaws.rds#WriteForwardingStatus",
           "traits": {
@@ -11822,7 +11828,7 @@
         "Subnets": {
           "target": "com.amazonaws.rds#SubnetList",
           "traits": {
-            "smithy.api#documentation": "<p>Contains a list of <code>Subnet</code> elements.</p>"
+            "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>"
           }
         },
         "DBSubnetGroupArn": {
@@ -18618,7 +18624,7 @@
         }
       ],
       "traits": {
-        "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>",
+        "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>",
         "smithy.api#examples": [
           {
             "title": "To download a DB log file",
