feat(client-dsql): Cluster endpoint added to CreateCluster and GetCluster API responses

Author: awstools

clients/client-dsql/README.md

@@ -6,12 +6,7 @@
 
 AWS SDK for JavaScript DSQL Client for Node.js, Browser and React Native.
 
-<p>This is an interface reference for Amazon Aurora DSQL. It contains documentation for one of the
-programming or command line interfaces you can use to manage Amazon Aurora DSQL.</p>
-<p>Amazon Aurora DSQL is a serverless, distributed SQL database suitable for workloads of any size.
-is available in both single-Region and multi-Region configurations, so your
-clusters and databases are always available even if an Availability Zone or an Amazon Web Services Region are unavailable.  lets you focus on using your data to
-acquire new insights for your business and customers.</p>
+<p>This is an interface reference for Amazon Aurora DSQL. It contains documentation for one of the programming or command line interfaces you can use to manage Amazon Aurora DSQL.</p> <p>Amazon Aurora DSQL is a serverless, distributed SQL database suitable for workloads of any size. is available in both single-Region and multi-Region configurations, so your clusters and databases are always available even if an Availability Zone or an Amazon Web Services Region are unavailable. lets you focus on using your data to acquire new insights for your business and customers.</p>
 
 ## Installing
 

clients/client-dsql/src/DSQL.ts

@@ -238,12 +238,7 @@ export interface DSQL {
 }
 
 /**
- * <p>This is an interface reference for Amazon Aurora DSQL. It contains documentation for one of the
- *          programming or command line interfaces you can use to manage Amazon Aurora DSQL.</p>
- *          <p>Amazon Aurora DSQL is a serverless, distributed SQL database suitable for workloads of any size.
- *           is available in both single-Region and multi-Region configurations, so your
- *          clusters and databases are always available even if an Availability Zone or an Amazon Web Services Region are unavailable.  lets you focus on using your data to
- *          acquire new insights for your business and customers.</p>
+ * <p>This is an interface reference for Amazon Aurora DSQL. It contains documentation for one of the programming or command line interfaces you can use to manage Amazon Aurora DSQL.</p> <p>Amazon Aurora DSQL is a serverless, distributed SQL database suitable for workloads of any size. is available in both single-Region and multi-Region configurations, so your clusters and databases are always available even if an Availability Zone or an Amazon Web Services Region are unavailable. lets you focus on using your data to acquire new insights for your business and customers.</p>
  * @public
  */
 export class DSQL extends DSQLClient implements DSQL {}

clients/client-dsql/src/DSQLClient.ts

@@ -310,12 +310,7 @@ export type DSQLClientResolvedConfigType = __SmithyResolvedConfiguration<__HttpH
 export interface DSQLClientResolvedConfig extends DSQLClientResolvedConfigType {}
 
 /**
- * <p>This is an interface reference for Amazon Aurora DSQL. It contains documentation for one of the
- *          programming or command line interfaces you can use to manage Amazon Aurora DSQL.</p>
- *          <p>Amazon Aurora DSQL is a serverless, distributed SQL database suitable for workloads of any size.
- *           is available in both single-Region and multi-Region configurations, so your
- *          clusters and databases are always available even if an Availability Zone or an Amazon Web Services Region are unavailable.  lets you focus on using your data to
- *          acquire new insights for your business and customers.</p>
+ * <p>This is an interface reference for Amazon Aurora DSQL. It contains documentation for one of the programming or command line interfaces you can use to manage Amazon Aurora DSQL.</p> <p>Amazon Aurora DSQL is a serverless, distributed SQL database suitable for workloads of any size. is available in both single-Region and multi-Region configurations, so your clusters and databases are always available even if an Availability Zone or an Amazon Web Services Region are unavailable. lets you focus on using your data to acquire new insights for your business and customers.</p>
  * @public
  */
 export class DSQLClient extends __Client<

clients/client-dsql/src/commands/CreateClusterCommand.ts

@@ -28,71 +28,7 @@ export interface CreateClusterCommandInput extends CreateClusterInput {}
 export interface CreateClusterCommandOutput extends CreateClusterOutput, __MetadataBearer {}
 
 /**
- * <p>The CreateCluster API allows you to create both single-Region clusters and multi-Region
- *          clusters. With the addition of the <i>multiRegionProperties</i> parameter,
- *          you can create a cluster with witness Region support and establish peer relationships with
- *          clusters in other Regions during creation.</p>
- *          <note>
- *             <p>Creating multi-Region clusters requires additional IAM permissions beyond those
- *                needed for single-Region clusters, as detailed in the <b>Required permissions</b> section
- *             below.</p>
- *          </note>
- *          <p>
- *             <b>Required permissions</b>
- *          </p>
- *          <dl>
- *             <dt>dsql:CreateCluster</dt>
- *             <dd>
- *                <p>Required to create a cluster.</p>
- *                <p>Resources: <code>arn:aws:dsql:region:account-id:cluster/*</code>
- *                </p>
- *             </dd>
- *             <dt>dsql:TagResource</dt>
- *             <dd>
- *                <p>Permission to add tags to a resource.</p>
- *                <p>Resources: <code>arn:aws:dsql:region:account-id:cluster/*</code>
- *                </p>
- *             </dd>
- *             <dt>dsql:PutMultiRegionProperties</dt>
- *             <dd>
- *                <p>Permission to configure multi-Region properties for a cluster.</p>
- *                <p>Resources: <code>arn:aws:dsql:region:account-id:cluster/*</code>
- *                </p>
- *             </dd>
- *             <dt>dsql:AddPeerCluster</dt>
- *             <dd>
- *                <p>When specifying <code>multiRegionProperties.clusters</code>, permission to
- *                   add peer clusters.</p>
- *                <p>Resources:</p>
- *                <ul>
- *                   <li>
- *                      <p>Local cluster: <code>arn:aws:dsql:region:account-id:cluster/*</code>
- *                      </p>
- *                   </li>
- *                   <li>
- *                      <p>Each peer cluster: exact ARN of each specified peer cluster</p>
- *                   </li>
- *                </ul>
- *             </dd>
- *             <dt>dsql:PutWitnessRegion</dt>
- *             <dd>
- *                <p>When specifying <code>multiRegionProperties.witnessRegion</code>, permission
- *                   to set a witness Region. This permission is checked both in the cluster Region and
- *                   in the witness Region.</p>
- *                <p>Resources: <code>arn:aws:dsql:region:account-id:cluster/*</code>
- *                </p>
- *                <p>Condition Keys: <code>dsql:WitnessRegion</code> (matching the specified witness region)</p>
- *             </dd>
- *          </dl>
- *          <important>
- *             <ul>
- *                <li>
- *                   <p>The witness Region specified in
- *                      <code>multiRegionProperties.witnessRegion</code> cannot be the same as the
- *                   cluster's Region.</p>
- *                </li>
- *             </ul>
- *          </important>
+ * <p>The CreateCluster API allows you to create both single-Region clusters and multi-Region clusters. With the addition of the <i>multiRegionProperties</i> parameter, you can create a cluster with witness Region support and establish peer relationships with clusters in other Regions during creation.</p> <note> <p>Creating multi-Region clusters requires additional IAM permissions beyond those needed for single-Region clusters, as detailed in the <b>Required permissions</b> section below.</p> </note> <p> <b>Required permissions</b> </p> <dl> <dt>dsql:CreateCluster</dt> <dd> <p>Required to create a cluster.</p> <p>Resources: <code>arn:aws:dsql:region:account-id:cluster/*</code> </p> </dd> <dt>dsql:TagResource</dt> <dd> <p>Permission to add tags to a resource.</p> <p>Resources: <code>arn:aws:dsql:region:account-id:cluster/*</code> </p> </dd> <dt>dsql:PutMultiRegionProperties</dt> <dd> <p>Permission to configure multi-Region properties for a cluster.</p> <p>Resources: <code>arn:aws:dsql:region:account-id:cluster/*</code> </p> </dd> <dt>dsql:AddPeerCluster</dt> <dd> <p>When specifying <code>multiRegionProperties.clusters</code>, permission to add peer clusters.</p> <p>Resources:</p> <ul> <li> <p>Local cluster: <code>arn:aws:dsql:region:account-id:cluster/*</code> </p> </li> <li> <p>Each peer cluster: exact ARN of each specified peer cluster</p> </li> </ul> </dd> <dt>dsql:PutWitnessRegion</dt> <dd> <p>When specifying <code>multiRegionProperties.witnessRegion</code>, permission to set a witness Region. This permission is checked both in the cluster Region and in the witness Region.</p> <p>Resources: <code>arn:aws:dsql:region:account-id:cluster/*</code> </p> <p>Condition Keys: <code>dsql:WitnessRegion</code> (matching the specified witness region)</p> </dd> </dl> <important> <ul> <li> <p>The witness Region specified in <code>multiRegionProperties.witnessRegion</code> cannot be the same as the cluster's Region.</p> </li> </ul> </important>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -136,6 +72,7 @@ export interface CreateClusterCommandOutput extends CreateClusterOutput, __Metad
  * //     encryptionStatus: "ENABLED" || "UPDATING" || "KMS_KEY_INACCESSIBLE" || "ENABLING", // required
  * //   },
  * //   deletionProtectionEnabled: true || false, // required
+ * //   endpoint: "STRING_VALUE",
  * // };
  *
  * ```
@@ -159,8 +96,7 @@ export interface CreateClusterCommandOutput extends CreateClusterOutput, __Metad
  *  <p>You do not have sufficient access to perform this action.</p>
  *
  * @throws {@link InternalServerException} (server fault)
- *  <p>The request processing has failed because of an unknown error, exception or
- *          failure.</p>
+ *  <p>The request processing has failed because of an unknown error, exception or failure.</p>
  *
  * @throws {@link ThrottlingException} (client fault)
  *  <p>The request was denied due to request throttling.</p>

clients/client-dsql/src/commands/DeleteClusterCommand.ts

@@ -68,8 +68,7 @@ export interface DeleteClusterCommandOutput extends DeleteClusterOutput, __Metad
  *  <p>You do not have sufficient access to perform this action.</p>
  *
  * @throws {@link InternalServerException} (server fault)
- *  <p>The request processing has failed because of an unknown error, exception or
- *          failure.</p>
+ *  <p>The request processing has failed because of an unknown error, exception or failure.</p>
  *
  * @throws {@link ThrottlingException} (client fault)
  *  <p>The request was denied due to request throttling.</p>

clients/client-dsql/src/commands/DeleteClusterPolicyCommand.ts

@@ -69,8 +69,7 @@ export interface DeleteClusterPolicyCommandOutput extends DeleteClusterPolicyOut
  *  <p>You do not have sufficient access to perform this action.</p>
  *
  * @throws {@link InternalServerException} (server fault)
- *  <p>The request processing has failed because of an unknown error, exception or
- *          failure.</p>
+ *  <p>The request processing has failed because of an unknown error, exception or failure.</p>
  *
  * @throws {@link ThrottlingException} (client fault)
  *  <p>The request was denied due to request throttling.</p>

clients/client-dsql/src/commands/GetClusterCommand.ts

@@ -62,6 +62,7 @@ export interface GetClusterCommandOutput extends GetClusterOutput, __MetadataBea
  * //     kmsKeyArn: "STRING_VALUE",
  * //     encryptionStatus: "ENABLED" || "UPDATING" || "KMS_KEY_INACCESSIBLE" || "ENABLING", // required
  * //   },
+ * //   endpoint: "STRING_VALUE",
  * // };
  *
  * ```
@@ -79,8 +80,7 @@ export interface GetClusterCommandOutput extends GetClusterOutput, __MetadataBea
  *  <p>You do not have sufficient access to perform this action.</p>
  *
  * @throws {@link InternalServerException} (server fault)
- *  <p>The request processing has failed because of an unknown error, exception or
- *          failure.</p>
+ *  <p>The request processing has failed because of an unknown error, exception or failure.</p>
  *
  * @throws {@link ThrottlingException} (client fault)
  *  <p>The request was denied due to request throttling.</p>

clients/client-dsql/src/commands/GetClusterPolicyCommand.ts

@@ -65,8 +65,7 @@ export interface GetClusterPolicyCommandOutput extends GetClusterPolicyOutput, _
  *  <p>You do not have sufficient access to perform this action.</p>
  *
  * @throws {@link InternalServerException} (server fault)
- *  <p>The request processing has failed because of an unknown error, exception or
- *          failure.</p>
+ *  <p>The request processing has failed because of an unknown error, exception or failure.</p>
  *
  * @throws {@link ThrottlingException} (client fault)
  *  <p>The request was denied due to request throttling.</p>

clients/client-dsql/src/commands/GetVpcEndpointServiceNameCommand.ts

@@ -55,8 +55,7 @@ export interface GetVpcEndpointServiceNameCommandOutput extends GetVpcEndpointSe
  * @see {@link DSQLClientResolvedConfig | config} for DSQLClient's `config` shape.
  *
  * @throws {@link InternalServerException} (server fault)
- *  <p>The request processing has failed because of an unknown error, exception or
- *          failure.</p>
+ *  <p>The request processing has failed because of an unknown error, exception or failure.</p>
  *
  * @throws {@link ResourceNotFoundException} (client fault)
  *  <p>The resource could not be found.</p>

clients/client-dsql/src/commands/ListClustersCommand.ts

@@ -68,8 +68,7 @@ export interface ListClustersCommandOutput extends ListClustersOutput, __Metadat
  *  <p>You do not have sufficient access to perform this action.</p>
  *
  * @throws {@link InternalServerException} (server fault)
- *  <p>The request processing has failed because of an unknown error, exception or
- *          failure.</p>
+ *  <p>The request processing has failed because of an unknown error, exception or failure.</p>
  *
  * @throws {@link ThrottlingException} (client fault)
  *  <p>The request was denied due to request throttling.</p>