feat(client-cloudhsm-v2): Added 3 new APIs to support backup sharing: GetResourcePolicy, PutResourcePolicy, and DeleteResourcePolicy. Added BackupArn to the output of the DescribeBackups API. Added support for BackupArn in the CreateCluster API.

Author: awstools

clients/client-cloudhsm-v2/README.md

@@ -6,7 +6,7 @@
 
 AWS SDK for JavaScript CloudHSMV2 Client for Node.js, Browser and React Native.
 
-<p>For more information about AWS CloudHSM, see <a href="http://aws.amazon.com/cloudhsm/">AWS CloudHSM</a> and the <a href="https://docs.aws.amazon.com/cloudhsm/latest/userguide/">AWS
+<p>For more information about CloudHSM, see <a href="http://aws.amazon.com/cloudhsm/">CloudHSM</a> and the <a href="https://docs.aws.amazon.com/cloudhsm/latest/userguide/">
 CloudHSM User Guide</a>.</p>
 
 ## Installing
@@ -251,6 +251,14 @@ DeleteHsm
 
 [Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/cloudhsm-v2/command/DeleteHsmCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-cloudhsm-v2/Interface/DeleteHsmCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-cloudhsm-v2/Interface/DeleteHsmCommandOutput/)
 
+</details>
+<details>
+<summary>
+DeleteResourcePolicy
+</summary>
+
+[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/cloudhsm-v2/command/DeleteResourcePolicyCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-cloudhsm-v2/Interface/DeleteResourcePolicyCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-cloudhsm-v2/Interface/DeleteResourcePolicyCommandOutput/)
+
 </details>
 <details>
 <summary>
@@ -267,6 +275,14 @@ DescribeClusters
 
 [Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/cloudhsm-v2/command/DescribeClustersCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-cloudhsm-v2/Interface/DescribeClustersCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-cloudhsm-v2/Interface/DescribeClustersCommandOutput/)
 
+</details>
+<details>
+<summary>
+GetResourcePolicy
+</summary>
+
+[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/cloudhsm-v2/command/GetResourcePolicyCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-cloudhsm-v2/Interface/GetResourcePolicyCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-cloudhsm-v2/Interface/GetResourcePolicyCommandOutput/)
+
 </details>
 <details>
 <summary>
@@ -299,6 +315,14 @@ ModifyCluster
 
 [Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/cloudhsm-v2/command/ModifyClusterCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-cloudhsm-v2/Interface/ModifyClusterCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-cloudhsm-v2/Interface/ModifyClusterCommandOutput/)
 
+</details>
+<details>
+<summary>
+PutResourcePolicy
+</summary>
+
+[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/cloudhsm-v2/command/PutResourcePolicyCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-cloudhsm-v2/Interface/PutResourcePolicyCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-cloudhsm-v2/Interface/PutResourcePolicyCommandOutput/)
+
 </details>
 <details>
 <summary>

clients/client-cloudhsm-v2/src/CloudHSMV2.ts

@@ -25,6 +25,11 @@ import {
   DeleteClusterCommandOutput,
 } from "./commands/DeleteClusterCommand";
 import { DeleteHsmCommand, DeleteHsmCommandInput, DeleteHsmCommandOutput } from "./commands/DeleteHsmCommand";
+import {
+  DeleteResourcePolicyCommand,
+  DeleteResourcePolicyCommandInput,
+  DeleteResourcePolicyCommandOutput,
+} from "./commands/DeleteResourcePolicyCommand";
 import {
   DescribeBackupsCommand,
   DescribeBackupsCommandInput,
@@ -35,6 +40,11 @@ import {
   DescribeClustersCommandInput,
   DescribeClustersCommandOutput,
 } from "./commands/DescribeClustersCommand";
+import {
+  GetResourcePolicyCommand,
+  GetResourcePolicyCommandInput,
+  GetResourcePolicyCommandOutput,
+} from "./commands/GetResourcePolicyCommand";
 import {
   InitializeClusterCommand,
   InitializeClusterCommandInput,
@@ -51,6 +61,11 @@ import {
   ModifyClusterCommandInput,
   ModifyClusterCommandOutput,
 } from "./commands/ModifyClusterCommand";
+import {
+  PutResourcePolicyCommand,
+  PutResourcePolicyCommandInput,
+  PutResourcePolicyCommandOutput,
+} from "./commands/PutResourcePolicyCommand";
 import {
   RestoreBackupCommand,
   RestoreBackupCommandInput,
@@ -70,12 +85,15 @@ const commands = {
   DeleteBackupCommand,
   DeleteClusterCommand,
   DeleteHsmCommand,
+  DeleteResourcePolicyCommand,
   DescribeBackupsCommand,
   DescribeClustersCommand,
+  GetResourcePolicyCommand,
   InitializeClusterCommand,
   ListTagsCommand,
   ModifyBackupAttributesCommand,
   ModifyClusterCommand,
+  PutResourcePolicyCommand,
   RestoreBackupCommand,
   TagResourceCommand,
   UntagResourceCommand,
@@ -154,6 +172,24 @@ export interface CloudHSMV2 {
     cb: (err: any, data?: DeleteHsmCommandOutput) => void
   ): void;
 
+  /**
+   * @see {@link DeleteResourcePolicyCommand}
+   */
+  deleteResourcePolicy(): Promise<DeleteResourcePolicyCommandOutput>;
+  deleteResourcePolicy(
+    args: DeleteResourcePolicyCommandInput,
+    options?: __HttpHandlerOptions
+  ): Promise<DeleteResourcePolicyCommandOutput>;
+  deleteResourcePolicy(
+    args: DeleteResourcePolicyCommandInput,
+    cb: (err: any, data?: DeleteResourcePolicyCommandOutput) => void
+  ): void;
+  deleteResourcePolicy(
+    args: DeleteResourcePolicyCommandInput,
+    options: __HttpHandlerOptions,
+    cb: (err: any, data?: DeleteResourcePolicyCommandOutput) => void
+  ): void;
+
   /**
    * @see {@link DescribeBackupsCommand}
    */
@@ -187,6 +223,24 @@ export interface CloudHSMV2 {
     cb: (err: any, data?: DescribeClustersCommandOutput) => void
   ): void;
 
+  /**
+   * @see {@link GetResourcePolicyCommand}
+   */
+  getResourcePolicy(): Promise<GetResourcePolicyCommandOutput>;
+  getResourcePolicy(
+    args: GetResourcePolicyCommandInput,
+    options?: __HttpHandlerOptions
+  ): Promise<GetResourcePolicyCommandOutput>;
+  getResourcePolicy(
+    args: GetResourcePolicyCommandInput,
+    cb: (err: any, data?: GetResourcePolicyCommandOutput) => void
+  ): void;
+  getResourcePolicy(
+    args: GetResourcePolicyCommandInput,
+    options: __HttpHandlerOptions,
+    cb: (err: any, data?: GetResourcePolicyCommandOutput) => void
+  ): void;
+
   /**
    * @see {@link InitializeClusterCommand}
    */
@@ -243,6 +297,24 @@ export interface CloudHSMV2 {
     cb: (err: any, data?: ModifyClusterCommandOutput) => void
   ): void;
 
+  /**
+   * @see {@link PutResourcePolicyCommand}
+   */
+  putResourcePolicy(): Promise<PutResourcePolicyCommandOutput>;
+  putResourcePolicy(
+    args: PutResourcePolicyCommandInput,
+    options?: __HttpHandlerOptions
+  ): Promise<PutResourcePolicyCommandOutput>;
+  putResourcePolicy(
+    args: PutResourcePolicyCommandInput,
+    cb: (err: any, data?: PutResourcePolicyCommandOutput) => void
+  ): void;
+  putResourcePolicy(
+    args: PutResourcePolicyCommandInput,
+    options: __HttpHandlerOptions,
+    cb: (err: any, data?: PutResourcePolicyCommandOutput) => void
+  ): void;
+
   /**
    * @see {@link RestoreBackupCommand}
    */
@@ -278,7 +350,7 @@ export interface CloudHSMV2 {
 }
 
 /**
- * <p>For more information about AWS CloudHSM, see <a href="http://aws.amazon.com/cloudhsm/">AWS CloudHSM</a> and the <a href="https://docs.aws.amazon.com/cloudhsm/latest/userguide/">AWS
+ * <p>For more information about CloudHSM, see <a href="http://aws.amazon.com/cloudhsm/">CloudHSM</a> and the <a href="https://docs.aws.amazon.com/cloudhsm/latest/userguide/">
  *       CloudHSM User Guide</a>.</p>
  * @public
  */

clients/client-cloudhsm-v2/src/CloudHSMV2Client.ts

@@ -59,15 +59,21 @@ import { CreateHsmCommandInput, CreateHsmCommandOutput } from "./commands/Create
 import { DeleteBackupCommandInput, DeleteBackupCommandOutput } from "./commands/DeleteBackupCommand";
 import { DeleteClusterCommandInput, DeleteClusterCommandOutput } from "./commands/DeleteClusterCommand";
 import { DeleteHsmCommandInput, DeleteHsmCommandOutput } from "./commands/DeleteHsmCommand";
+import {
+  DeleteResourcePolicyCommandInput,
+  DeleteResourcePolicyCommandOutput,
+} from "./commands/DeleteResourcePolicyCommand";
 import { DescribeBackupsCommandInput, DescribeBackupsCommandOutput } from "./commands/DescribeBackupsCommand";
 import { DescribeClustersCommandInput, DescribeClustersCommandOutput } from "./commands/DescribeClustersCommand";
+import { GetResourcePolicyCommandInput, GetResourcePolicyCommandOutput } from "./commands/GetResourcePolicyCommand";
 import { InitializeClusterCommandInput, InitializeClusterCommandOutput } from "./commands/InitializeClusterCommand";
 import { ListTagsCommandInput, ListTagsCommandOutput } from "./commands/ListTagsCommand";
 import {
   ModifyBackupAttributesCommandInput,
   ModifyBackupAttributesCommandOutput,
 } from "./commands/ModifyBackupAttributesCommand";
 import { ModifyClusterCommandInput, ModifyClusterCommandOutput } from "./commands/ModifyClusterCommand";
+import { PutResourcePolicyCommandInput, PutResourcePolicyCommandOutput } from "./commands/PutResourcePolicyCommand";
 import { RestoreBackupCommandInput, RestoreBackupCommandOutput } from "./commands/RestoreBackupCommand";
 import { TagResourceCommandInput, TagResourceCommandOutput } from "./commands/TagResourceCommand";
 import { UntagResourceCommandInput, UntagResourceCommandOutput } from "./commands/UntagResourceCommand";
@@ -92,12 +98,15 @@ export type ServiceInputTypes =
   | DeleteBackupCommandInput
   | DeleteClusterCommandInput
   | DeleteHsmCommandInput
+  | DeleteResourcePolicyCommandInput
   | DescribeBackupsCommandInput
   | DescribeClustersCommandInput
+  | GetResourcePolicyCommandInput
   | InitializeClusterCommandInput
   | ListTagsCommandInput
   | ModifyBackupAttributesCommandInput
   | ModifyClusterCommandInput
+  | PutResourcePolicyCommandInput
   | RestoreBackupCommandInput
   | TagResourceCommandInput
   | UntagResourceCommandInput;
@@ -112,12 +121,15 @@ export type ServiceOutputTypes =
   | DeleteBackupCommandOutput
   | DeleteClusterCommandOutput
   | DeleteHsmCommandOutput
+  | DeleteResourcePolicyCommandOutput
   | DescribeBackupsCommandOutput
   | DescribeClustersCommandOutput
+  | GetResourcePolicyCommandOutput
   | InitializeClusterCommandOutput
   | ListTagsCommandOutput
   | ModifyBackupAttributesCommandOutput
   | ModifyClusterCommandOutput
+  | PutResourcePolicyCommandOutput
   | RestoreBackupCommandOutput
   | TagResourceCommandOutput
   | UntagResourceCommandOutput;
@@ -294,7 +306,7 @@ export type CloudHSMV2ClientResolvedConfigType = __SmithyResolvedConfiguration<_
 export interface CloudHSMV2ClientResolvedConfig extends CloudHSMV2ClientResolvedConfigType {}
 
 /**
- * <p>For more information about AWS CloudHSM, see <a href="http://aws.amazon.com/cloudhsm/">AWS CloudHSM</a> and the <a href="https://docs.aws.amazon.com/cloudhsm/latest/userguide/">AWS
+ * <p>For more information about CloudHSM, see <a href="http://aws.amazon.com/cloudhsm/">CloudHSM</a> and the <a href="https://docs.aws.amazon.com/cloudhsm/latest/userguide/">
  *       CloudHSM User Guide</a>.</p>
  * @public
  */

clients/client-cloudhsm-v2/src/commands/CopyBackupToRegionCommand.ts

@@ -28,7 +28,9 @@ export interface CopyBackupToRegionCommandInput extends CopyBackupToRegionReques
 export interface CopyBackupToRegionCommandOutput extends CopyBackupToRegionResponse, __MetadataBearer {}
 
 /**
- * <p>Copy an AWS CloudHSM cluster backup to a different region.</p>
+ * <p>Copy an CloudHSM cluster backup to a different region.</p>
+ *          <p>
+ *             <b>Cross-account use:</b> No. You cannot perform this operation on an CloudHSM backup in a different Amazon Web Services account.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -69,7 +71,7 @@ export interface CopyBackupToRegionCommandOutput extends CopyBackupToRegionRespo
  *       requested operation.</p>
  *
  * @throws {@link CloudHsmInternalFailureException} (server fault)
- *  <p>The request was rejected because of an AWS CloudHSM internal failure. The request can
+ *  <p>The request was rejected because of an CloudHSM internal failure. The request can
  *       be retried.</p>
  *
  * @throws {@link CloudHsmInvalidRequestException} (client fault)

clients/client-cloudhsm-v2/src/commands/CreateClusterCommand.ts

@@ -28,7 +28,10 @@ export interface CreateClusterCommandInput extends CreateClusterRequest {}
 export interface CreateClusterCommandOutput extends CreateClusterResponse, __MetadataBearer {}
 
 /**
- * <p>Creates a new AWS CloudHSM cluster.</p>
+ * <p>Creates a new CloudHSM cluster.</p>
+ *          <p>
+ *             <b>Cross-account use:</b> Yes. To perform this operation with an CloudHSM backup in a different AWS account, specify the full backup
+ *     ARN in the value of the SourceBackupId parameter.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -116,7 +119,7 @@ export interface CreateClusterCommandOutput extends CreateClusterResponse, __Met
  *       requested operation.</p>
  *
  * @throws {@link CloudHsmInternalFailureException} (server fault)
- *  <p>The request was rejected because of an AWS CloudHSM internal failure. The request can
+ *  <p>The request was rejected because of an CloudHSM internal failure. The request can
  *       be retried.</p>
  *
  * @throws {@link CloudHsmInvalidRequestException} (client fault)

clients/client-cloudhsm-v2/src/commands/CreateHsmCommand.ts

@@ -28,8 +28,10 @@ export interface CreateHsmCommandInput extends CreateHsmRequest {}
 export interface CreateHsmCommandOutput extends CreateHsmResponse, __MetadataBearer {}
 
 /**
- * <p>Creates a new hardware security module (HSM) in the specified AWS CloudHSM
+ * <p>Creates a new hardware security module (HSM) in the specified CloudHSM
  *       cluster.</p>
+ *          <p>
+ *             <b>Cross-account use:</b> No. You cannot perform this operation on an CloudHSM cluster in a different Amazon Web Service account.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -69,7 +71,7 @@ export interface CreateHsmCommandOutput extends CreateHsmResponse, __MetadataBea
  *       requested operation.</p>
  *
  * @throws {@link CloudHsmInternalFailureException} (server fault)
- *  <p>The request was rejected because of an AWS CloudHSM internal failure. The request can
+ *  <p>The request was rejected because of an CloudHSM internal failure. The request can
  *       be retried.</p>
  *
  * @throws {@link CloudHsmInvalidRequestException} (client fault)

clients/client-cloudhsm-v2/src/commands/DeleteBackupCommand.ts

@@ -28,9 +28,11 @@ export interface DeleteBackupCommandInput extends DeleteBackupRequest {}
 export interface DeleteBackupCommandOutput extends DeleteBackupResponse, __MetadataBearer {}
 
 /**
- * <p>Deletes a specified AWS CloudHSM backup. A backup can be restored up to 7 days
+ * <p>Deletes a specified CloudHSM backup. A backup can be restored up to 7 days
  *             after the DeleteBackup request is made. For more information on restoring a backup, see
  *                 <a>RestoreBackup</a>.</p>
+ *          <p>
+ *             <b>Cross-account use:</b> No. You cannot perform this operation on an CloudHSM backup in a different Amazon Web Services account.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -45,6 +47,7 @@ export interface DeleteBackupCommandOutput extends DeleteBackupResponse, __Metad
  * // { // DeleteBackupResponse
  * //   Backup: { // Backup
  * //     BackupId: "STRING_VALUE", // required
+ * //     BackupArn: "STRING_VALUE",
  * //     BackupState: "CREATE_IN_PROGRESS" || "READY" || "DELETED" || "PENDING_DELETION",
  * //     ClusterId: "STRING_VALUE",
  * //     CreateTimestamp: new Date("TIMESTAMP"),
@@ -78,7 +81,7 @@ export interface DeleteBackupCommandOutput extends DeleteBackupResponse, __Metad
  *       requested operation.</p>
  *
  * @throws {@link CloudHsmInternalFailureException} (server fault)
- *  <p>The request was rejected because of an AWS CloudHSM internal failure. The request can
+ *  <p>The request was rejected because of an CloudHSM internal failure. The request can
  *       be retried.</p>
  *
  * @throws {@link CloudHsmInvalidRequestException} (client fault)

clients/client-cloudhsm-v2/src/commands/DeleteClusterCommand.ts

@@ -28,8 +28,10 @@ export interface DeleteClusterCommandInput extends DeleteClusterRequest {}
 export interface DeleteClusterCommandOutput extends DeleteClusterResponse, __MetadataBearer {}
 
 /**
- * <p>Deletes the specified AWS CloudHSM cluster. Before you can delete a cluster, you must
+ * <p>Deletes the specified CloudHSM cluster. Before you can delete a cluster, you must
  *       delete all HSMs in the cluster. To see if the cluster contains any HSMs, use <a>DescribeClusters</a>. To delete an HSM, use <a>DeleteHsm</a>.</p>
+ *          <p>
+ *             <b>Cross-account use:</b> No. You cannot perform this operation on an CloudHSM cluster in a different Amazon Web Services account.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -102,7 +104,7 @@ export interface DeleteClusterCommandOutput extends DeleteClusterResponse, __Met
  *       requested operation.</p>
  *
  * @throws {@link CloudHsmInternalFailureException} (server fault)
- *  <p>The request was rejected because of an AWS CloudHSM internal failure. The request can
+ *  <p>The request was rejected because of an CloudHSM internal failure. The request can
  *       be retried.</p>
  *
  * @throws {@link CloudHsmInvalidRequestException} (client fault)

clients/client-cloudhsm-v2/src/commands/DeleteHsmCommand.ts

@@ -31,6 +31,8 @@ export interface DeleteHsmCommandOutput extends DeleteHsmResponse, __MetadataBea
  * <p>Deletes the specified HSM. To specify an HSM, you can use its identifier (ID), the IP
  *       address of the HSM's elastic network interface (ENI), or the ID of the HSM's ENI. You need to
  *       specify only one of these values. To find these values, use <a>DescribeClusters</a>.</p>
+ *          <p>
+ *             <b>Cross-account use:</b> No. You cannot perform this operation on an CloudHSM hsm in a different Amazon Web Services account.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -62,7 +64,7 @@ export interface DeleteHsmCommandOutput extends DeleteHsmResponse, __MetadataBea
  *       requested operation.</p>
  *
  * @throws {@link CloudHsmInternalFailureException} (server fault)
- *  <p>The request was rejected because of an AWS CloudHSM internal failure. The request can
+ *  <p>The request was rejected because of an CloudHSM internal failure. The request can
  *       be retried.</p>
  *
  * @throws {@link CloudHsmInvalidRequestException} (client fault)