@aws-sdk/client-kms 3.775.0 → 3.782.0

package/dist-types/commands/ListAliasesCommand.d.ts

@@ -129,63 +129,63 @@ declare const ListAliasesCommand_base: {
  * @throws {@link KMSServiceException}
  * <p>Base exception class for all service exceptions from KMS service.</p>
  *
- * @public
+ *
  * @example To list aliases
  * ```javascript
  * // The following example lists aliases.
- * const input = {};
+ * const input = { /* empty *\/ };
  * const command = new ListAliasesCommand(input);
  * const response = await client.send(command);
- * /* response ==
+ * /* response is
  * {
- *   "Aliases": [
+ *   Aliases: [
  *     {
- *       "AliasArn": "arn:aws:kms:us-east-2:111122223333:alias/aws/acm",
- *       "AliasName": "alias/aws/acm",
- *       "TargetKeyId": "da03f6f7-d279-427a-9cae-de48d07e5b66"
+ *       AliasArn: "arn:aws:kms:us-east-2:111122223333:alias/aws/acm",
+ *       AliasName: "alias/aws/acm",
+ *       TargetKeyId: "da03f6f7-d279-427a-9cae-de48d07e5b66"
  *     },
  *     {
- *       "AliasArn": "arn:aws:kms:us-east-2:111122223333:alias/aws/ebs",
- *       "AliasName": "alias/aws/ebs",
- *       "TargetKeyId": "25a217e7-7170-4b8c-8bf6-045ea5f70e5b"
+ *       AliasArn: "arn:aws:kms:us-east-2:111122223333:alias/aws/ebs",
+ *       AliasName: "alias/aws/ebs",
+ *       TargetKeyId: "25a217e7-7170-4b8c-8bf6-045ea5f70e5b"
  *     },
  *     {
- *       "AliasArn": "arn:aws:kms:us-east-2:111122223333:alias/aws/rds",
- *       "AliasName": "alias/aws/rds",
- *       "TargetKeyId": "7ec3104e-c3f2-4b5c-bf42-bfc4772c6685"
+ *       AliasArn: "arn:aws:kms:us-east-2:111122223333:alias/aws/rds",
+ *       AliasName: "alias/aws/rds",
+ *       TargetKeyId: "7ec3104e-c3f2-4b5c-bf42-bfc4772c6685"
  *     },
  *     {
- *       "AliasArn": "arn:aws:kms:us-east-2:111122223333:alias/aws/redshift",
- *       "AliasName": "alias/aws/redshift",
- *       "TargetKeyId": "08f7a25a-69e2-4fb5-8f10-393db27326fa"
+ *       AliasArn: "arn:aws:kms:us-east-2:111122223333:alias/aws/redshift",
+ *       AliasName: "alias/aws/redshift",
+ *       TargetKeyId: "08f7a25a-69e2-4fb5-8f10-393db27326fa"
  *     },
  *     {
- *       "AliasArn": "arn:aws:kms:us-east-2:111122223333:alias/aws/s3",
- *       "AliasName": "alias/aws/s3",
- *       "TargetKeyId": "d2b0f1a3-580d-4f79-b836-bc983be8cfa5"
+ *       AliasArn: "arn:aws:kms:us-east-2:111122223333:alias/aws/s3",
+ *       AliasName: "alias/aws/s3",
+ *       TargetKeyId: "d2b0f1a3-580d-4f79-b836-bc983be8cfa5"
  *     },
  *     {
- *       "AliasArn": "arn:aws:kms:us-east-2:111122223333:alias/example1",
- *       "AliasName": "alias/example1",
- *       "TargetKeyId": "4da1e216-62d0-46c5-a7c0-5f3a3d2f8046"
+ *       AliasArn: "arn:aws:kms:us-east-2:111122223333:alias/example1",
+ *       AliasName: "alias/example1",
+ *       TargetKeyId: "4da1e216-62d0-46c5-a7c0-5f3a3d2f8046"
  *     },
  *     {
- *       "AliasArn": "arn:aws:kms:us-east-2:111122223333:alias/example2",
- *       "AliasName": "alias/example2",
- *       "TargetKeyId": "f32fef59-2cc2-445b-8573-2d73328acbee"
+ *       AliasArn: "arn:aws:kms:us-east-2:111122223333:alias/example2",
+ *       AliasName: "alias/example2",
+ *       TargetKeyId: "f32fef59-2cc2-445b-8573-2d73328acbee"
  *     },
  *     {
- *       "AliasArn": "arn:aws:kms:us-east-2:111122223333:alias/example3",
- *       "AliasName": "alias/example3",
- *       "TargetKeyId": "1374ef38-d34e-4d5f-b2c9-4e0daee38855"
+ *       AliasArn: "arn:aws:kms:us-east-2:111122223333:alias/example3",
+ *       AliasName: "alias/example3",
+ *       TargetKeyId: "1374ef38-d34e-4d5f-b2c9-4e0daee38855"
  *     }
  *   ],
- *   "Truncated": false
+ *   Truncated: false
  * }
  * *\/
- * // example id: to-list-aliases-1480729693349
  * ```
  *
+ * @public
  */
 export declare class ListAliasesCommand extends ListAliasesCommand_base {
     /** @internal type navigation helper, not in runtime. */

package/dist-types/commands/ListGrantsCommand.d.ts

@@ -171,76 +171,8 @@ declare const ListGrantsCommand_base: {
  * @throws {@link KMSServiceException}
  * <p>Base exception class for all service exceptions from KMS service.</p>
  *
- * @public
- * @example To list grants for a KMS key
- * ```javascript
- * // The following example lists grants for the specified KMS key.
- * const input = {
- *   "KeyId": "1234abcd-12ab-34cd-56ef-1234567890ab"
- * };
- * const command = new ListGrantsCommand(input);
- * const response = await client.send(command);
- * /* response ==
- * {
- *   "Grants": [
- *     {
- *       "CreationDate": "2016-10-25T14:37:41-07:00",
- *       "GrantId": "91ad875e49b04a9d1f3bdeb84d821f9db6ea95e1098813f6d47f0c65fbe2a172",
- *       "GranteePrincipal": "acm.us-east-2.amazonaws.com",
- *       "IssuingAccount": "arn:aws:iam::111122223333:root",
- *       "KeyId": "arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab",
- *       "Operations": [
- *         "Encrypt",
- *         "ReEncryptFrom",
- *         "ReEncryptTo"
- *       ],
- *       "RetiringPrincipal": "acm.us-east-2.amazonaws.com"
- *     },
- *     {
- *       "CreationDate": "2016-10-25T14:37:41-07:00",
- *       "GrantId": "a5d67d3e207a8fc1f4928749ee3e52eb0440493a8b9cf05bbfad91655b056200",
- *       "GranteePrincipal": "acm.us-east-2.amazonaws.com",
- *       "IssuingAccount": "arn:aws:iam::111122223333:root",
- *       "KeyId": "arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab",
- *       "Operations": [
- *         "ReEncryptFrom",
- *         "ReEncryptTo"
- *       ],
- *       "RetiringPrincipal": "acm.us-east-2.amazonaws.com"
- *     },
- *     {
- *       "CreationDate": "2016-10-25T14:37:41-07:00",
- *       "GrantId": "c541aaf05d90cb78846a73b346fc43e65be28b7163129488c738e0c9e0628f4f",
- *       "GranteePrincipal": "acm.us-east-2.amazonaws.com",
- *       "IssuingAccount": "arn:aws:iam::111122223333:root",
- *       "KeyId": "arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab",
- *       "Operations": [
- *         "Encrypt",
- *         "ReEncryptFrom",
- *         "ReEncryptTo"
- *       ],
- *       "RetiringPrincipal": "acm.us-east-2.amazonaws.com"
- *     },
- *     {
- *       "CreationDate": "2016-10-25T14:37:41-07:00",
- *       "GrantId": "dd2052c67b4c76ee45caf1dc6a1e2d24e8dc744a51b36ae2f067dc540ce0105c",
- *       "GranteePrincipal": "acm.us-east-2.amazonaws.com",
- *       "IssuingAccount": "arn:aws:iam::111122223333:root",
- *       "KeyId": "arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab",
- *       "Operations": [
- *         "Encrypt",
- *         "ReEncryptFrom",
- *         "ReEncryptTo"
- *       ],
- *       "RetiringPrincipal": "acm.us-east-2.amazonaws.com"
- *     }
- *   ],
- *   "Truncated": true
- * }
- * *\/
- * // example id: to-list-grants-for-a-cmk-1481067365389
- * ```
  *
+ * @public
  */
 export declare class ListGrantsCommand extends ListGrantsCommand_base {
     /** @internal type navigation helper, not in runtime. */

package/dist-types/commands/ListKeyPoliciesCommand.d.ts

@@ -120,26 +120,26 @@ declare const ListKeyPoliciesCommand_base: {
  * @throws {@link KMSServiceException}
  * <p>Base exception class for all service exceptions from KMS service.</p>
  *
- * @public
+ *
  * @example To list key policies for a KMS key
  * ```javascript
  * // The following example lists key policies for the specified KMS key.
  * const input = {
- *   "KeyId": "1234abcd-12ab-34cd-56ef-1234567890ab"
+ *   KeyId: "1234abcd-12ab-34cd-56ef-1234567890ab"
  * };
  * const command = new ListKeyPoliciesCommand(input);
  * const response = await client.send(command);
- * /* response ==
+ * /* response is
  * {
- *   "PolicyNames": [
+ *   PolicyNames: [
  *     "default"
  *   ],
- *   "Truncated": false
+ *   Truncated: false
  * }
  * *\/
- * // example id: to-list-key-policies-for-a-cmk-1481069780998
  * ```
  *
+ * @public
  */
 export declare class ListKeyPoliciesCommand extends ListKeyPoliciesCommand_base {
     /** @internal type navigation helper, not in runtime. */

package/dist-types/commands/ListKeyRotationsCommand.d.ts

@@ -141,35 +141,8 @@ declare const ListKeyRotationsCommand_base: {
  * @throws {@link KMSServiceException}
  * <p>Base exception class for all service exceptions from KMS service.</p>
  *
- * @public
- * @example To retrieve information about all completed key material rotations
- * ```javascript
- * // The following example returns information about all completed key material rotations for the specified KMS key.
- * const input = {
- *   "KeyId": "1234abcd-12ab-34cd-56ef-1234567890ab"
- * };
- * const command = new ListKeyRotationsCommand(input);
- * const response = await client.send(command);
- * /* response ==
- * {
- *   "Rotations": [
- *     {
- *       "KeyId": "1234abcd-12ab-34cd-56ef-1234567890ab",
- *       "RotationDate": "2024-03-02T10:11:36.564000+00:00",
- *       "RotationType": "AUTOMATIC"
- *     },
- *     {
- *       "KeyId": "1234abcd-12ab-34cd-56ef-1234567890ab",
- *       "RotationDate": "2024-04-05T15:14:47.757000+00:00",
- *       "RotationType": "ON_DEMAND"
- *     }
- *   ],
- *   "Truncated": false
- * }
- * *\/
- * // example id: to-retrieve-information-about-all-completed-key-material-rotations-1712585167775
- * ```
  *
+ * @public
  */
 export declare class ListKeyRotationsCommand extends ListKeyRotationsCommand_base {
     /** @internal type navigation helper, not in runtime. */

package/dist-types/commands/ListKeysCommand.d.ts

@@ -106,51 +106,51 @@ declare const ListKeysCommand_base: {
  * @throws {@link KMSServiceException}
  * <p>Base exception class for all service exceptions from KMS service.</p>
  *
- * @public
+ *
  * @example To list KMS keys
  * ```javascript
  * // The following example lists KMS keys.
- * const input = {};
+ * const input = { /* empty *\/ };
  * const command = new ListKeysCommand(input);
  * const response = await client.send(command);
- * /* response ==
+ * /* response is
  * {
- *   "Keys": [
+ *   Keys: [
  *     {
- *       "KeyArn": "arn:aws:kms:us-east-2:111122223333:key/0d990263-018e-4e65-a703-eff731de951e",
- *       "KeyId": "0d990263-018e-4e65-a703-eff731de951e"
+ *       KeyArn: "arn:aws:kms:us-east-2:111122223333:key/0d990263-018e-4e65-a703-eff731de951e",
+ *       KeyId: "0d990263-018e-4e65-a703-eff731de951e"
  *     },
  *     {
- *       "KeyArn": "arn:aws:kms:us-east-2:111122223333:key/144be297-0ae1-44ac-9c8f-93cd8c82f841",
- *       "KeyId": "144be297-0ae1-44ac-9c8f-93cd8c82f841"
+ *       KeyArn: "arn:aws:kms:us-east-2:111122223333:key/144be297-0ae1-44ac-9c8f-93cd8c82f841",
+ *       KeyId: "144be297-0ae1-44ac-9c8f-93cd8c82f841"
  *     },
  *     {
- *       "KeyArn": "arn:aws:kms:us-east-2:111122223333:key/21184251-b765-428e-b852-2c7353e72571",
- *       "KeyId": "21184251-b765-428e-b852-2c7353e72571"
+ *       KeyArn: "arn:aws:kms:us-east-2:111122223333:key/21184251-b765-428e-b852-2c7353e72571",
+ *       KeyId: "21184251-b765-428e-b852-2c7353e72571"
  *     },
  *     {
- *       "KeyArn": "arn:aws:kms:us-east-2:111122223333:key/214fe92f-5b03-4ae1-b350-db2a45dbe10c",
- *       "KeyId": "214fe92f-5b03-4ae1-b350-db2a45dbe10c"
+ *       KeyArn: "arn:aws:kms:us-east-2:111122223333:key/214fe92f-5b03-4ae1-b350-db2a45dbe10c",
+ *       KeyId: "214fe92f-5b03-4ae1-b350-db2a45dbe10c"
  *     },
  *     {
- *       "KeyArn": "arn:aws:kms:us-east-2:111122223333:key/339963f2-e523-49d3-af24-a0fe752aa458",
- *       "KeyId": "339963f2-e523-49d3-af24-a0fe752aa458"
+ *       KeyArn: "arn:aws:kms:us-east-2:111122223333:key/339963f2-e523-49d3-af24-a0fe752aa458",
+ *       KeyId: "339963f2-e523-49d3-af24-a0fe752aa458"
  *     },
  *     {
- *       "KeyArn": "arn:aws:kms:us-east-2:111122223333:key/b776a44b-df37-4438-9be4-a27494e4271a",
- *       "KeyId": "b776a44b-df37-4438-9be4-a27494e4271a"
+ *       KeyArn: "arn:aws:kms:us-east-2:111122223333:key/b776a44b-df37-4438-9be4-a27494e4271a",
+ *       KeyId: "b776a44b-df37-4438-9be4-a27494e4271a"
  *     },
  *     {
- *       "KeyArn": "arn:aws:kms:us-east-2:111122223333:key/deaf6c9e-cf2c-46a6-bf6d-0b6d487cffbb",
- *       "KeyId": "deaf6c9e-cf2c-46a6-bf6d-0b6d487cffbb"
+ *       KeyArn: "arn:aws:kms:us-east-2:111122223333:key/deaf6c9e-cf2c-46a6-bf6d-0b6d487cffbb",
+ *       KeyId: "deaf6c9e-cf2c-46a6-bf6d-0b6d487cffbb"
  *     }
  *   ],
- *   "Truncated": false
+ *   Truncated: false
  * }
  * *\/
- * // example id: to-list-cmks-1481071643069
  * ```
  *
+ * @public
  */
 export declare class ListKeysCommand extends ListKeysCommand_base {
     /** @internal type navigation helper, not in runtime. */

package/dist-types/commands/ListResourceTagsCommand.d.ts

@@ -115,37 +115,37 @@ declare const ListResourceTagsCommand_base: {
  * @throws {@link KMSServiceException}
  * <p>Base exception class for all service exceptions from KMS service.</p>
  *
- * @public
+ *
  * @example To list tags for a KMS key
  * ```javascript
  * // The following example lists tags for a KMS key.
  * const input = {
- *   "KeyId": "1234abcd-12ab-34cd-56ef-1234567890ab"
+ *   KeyId: "1234abcd-12ab-34cd-56ef-1234567890ab"
  * };
  * const command = new ListResourceTagsCommand(input);
  * const response = await client.send(command);
- * /* response ==
+ * /* response is
  * {
- *   "Tags": [
+ *   Tags: [
  *     {
- *       "TagKey": "CostCenter",
- *       "TagValue": "87654"
+ *       TagKey: "CostCenter",
+ *       TagValue: "87654"
  *     },
  *     {
- *       "TagKey": "CreatedBy",
- *       "TagValue": "ExampleUser"
+ *       TagKey: "CreatedBy",
+ *       TagValue: "ExampleUser"
  *     },
  *     {
- *       "TagKey": "Purpose",
- *       "TagValue": "Test"
+ *       TagKey: "Purpose",
+ *       TagValue: "Test"
  *     }
  *   ],
- *   "Truncated": false
+ *   Truncated: false
  * }
  * *\/
- * // example id: to-list-tags-for-a-cmk-1483996855796
  * ```
  *
+ * @public
  */
 export declare class ListResourceTagsCommand extends ListResourceTagsCommand_base {
     /** @internal type navigation helper, not in runtime. */

package/dist-types/commands/ListRetirableGrantsCommand.d.ts

@@ -153,37 +153,8 @@ declare const ListRetirableGrantsCommand_base: {
  * @throws {@link KMSServiceException}
  * <p>Base exception class for all service exceptions from KMS service.</p>
  *
- * @public
- * @example To list grants that the specified principal can retire
- * ```javascript
- * // The following example lists the grants that the specified principal (identity) can retire.
- * const input = {
- *   "RetiringPrincipal": "arn:aws:iam::111122223333:role/ExampleRole"
- * };
- * const command = new ListRetirableGrantsCommand(input);
- * const response = await client.send(command);
- * /* response ==
- * {
- *   "Grants": [
- *     {
- *       "CreationDate": "2016-12-07T11:09:35-08:00",
- *       "GrantId": "0c237476b39f8bc44e45212e08498fbe3151305030726c0590dd8d3e9f3d6a60",
- *       "GranteePrincipal": "arn:aws:iam::111122223333:role/ExampleRole",
- *       "IssuingAccount": "arn:aws:iam::444455556666:root",
- *       "KeyId": "arn:aws:kms:us-east-2:444455556666:key/1234abcd-12ab-34cd-56ef-1234567890ab",
- *       "Operations": [
- *         "Decrypt",
- *         "Encrypt"
- *       ],
- *       "RetiringPrincipal": "arn:aws:iam::111122223333:role/ExampleRole"
- *     }
- *   ],
- *   "Truncated": false
- * }
- * *\/
- * // example id: to-list-grants-that-the-specified-principal-can-retire-1481140499620
- * ```
  *
+ * @public
  */
 export declare class ListRetirableGrantsCommand extends ListRetirableGrantsCommand_base {
     /** @internal type navigation helper, not in runtime. */

package/dist-types/commands/PutKeyPolicyCommand.d.ts

@@ -118,20 +118,96 @@ declare const PutKeyPolicyCommand_base: {
  * @throws {@link KMSServiceException}
  * <p>Base exception class for all service exceptions from KMS service.</p>
  *
- * @public
+ *
  * @example To attach a key policy to a KMS key
  * ```javascript
  * // The following example attaches a key policy to the specified KMS key.
  * const input = {
- *   "KeyId": "1234abcd-12ab-34cd-56ef-1234567890ab",
- *   "Policy": "{\n    \"Version\": \"2012-10-17\",\n    \"Id\": \"custom-policy-2016-12-07\",\n    \"Statement\": [\n        {\n            \"Sid\": \"Enable IAM User Permissions\",\n            \"Effect\": \"Allow\",\n            \"Principal\": {\n                \"AWS\": \"arn:aws:iam::111122223333:root\"\n            },\n            \"Action\": \"kms:*\",\n            \"Resource\": \"*\"\n        },\n        {\n            \"Sid\": \"Allow access for Key Administrators\",\n            \"Effect\": \"Allow\",\n            \"Principal\": {\n                \"AWS\": [\n                    \"arn:aws:iam::111122223333:user/ExampleAdminUser\",\n                    \"arn:aws:iam::111122223333:role/ExampleAdminRole\"\n                ]\n            },\n            \"Action\": [\n                \"kms:Create*\",\n                \"kms:Describe*\",\n                \"kms:Enable*\",\n                \"kms:List*\",\n                \"kms:Put*\",\n                \"kms:Update*\",\n                \"kms:Revoke*\",\n                \"kms:Disable*\",\n                \"kms:Get*\",\n                \"kms:Delete*\",\n                \"kms:ScheduleKeyDeletion\",\n                \"kms:CancelKeyDeletion\"\n            ],\n            \"Resource\": \"*\"\n        },\n        {\n            \"Sid\": \"Allow use of the key\",\n            \"Effect\": \"Allow\",\n            \"Principal\": {\n                \"AWS\": \"arn:aws:iam::111122223333:role/ExamplePowerUserRole\"\n            },\n            \"Action\": [\n                \"kms:Encrypt\",\n                \"kms:Decrypt\",\n                \"kms:ReEncrypt*\",\n                \"kms:GenerateDataKey*\",\n                \"kms:DescribeKey\"\n            ],\n            \"Resource\": \"*\"\n        },\n        {\n            \"Sid\": \"Allow attachment of persistent resources\",\n            \"Effect\": \"Allow\",\n            \"Principal\": {\n                \"AWS\": \"arn:aws:iam::111122223333:role/ExamplePowerUserRole\"\n            },\n            \"Action\": [\n                \"kms:CreateGrant\",\n                \"kms:ListGrants\",\n                \"kms:RevokeGrant\"\n            ],\n            \"Resource\": \"*\",\n            \"Condition\": {\n                \"Bool\": {\n                    \"kms:GrantIsForAWSResource\": \"true\"\n                }\n            }\n        }\n    ]\n}\n",
- *   "PolicyName": "default"
+ *   KeyId: "1234abcd-12ab-34cd-56ef-1234567890ab",
+ *   Policy: `{
+ *     "Version": "2012-10-17",
+ *     "Id": "custom-policy-2016-12-07",
+ *     "Statement": [
+ *         {
+ *             "Sid": "Enable IAM User Permissions",
+ *             "Effect": "Allow",
+ *             "Principal": {
+ *                 "AWS": "arn:aws:iam::111122223333:root"
+ *             },
+ *             "Action": "kms:*",
+ *             "Resource": "*"
+ *         },
+ *         {
+ *             "Sid": "Allow access for Key Administrators",
+ *             "Effect": "Allow",
+ *             "Principal": {
+ *                 "AWS": [
+ *                     "arn:aws:iam::111122223333:user/ExampleAdminUser",
+ *                     "arn:aws:iam::111122223333:role/ExampleAdminRole"
+ *                 ]
+ *             },
+ *             "Action": [
+ *                 "kms:Create*",
+ *                 "kms:Describe*",
+ *                 "kms:Enable*",
+ *                 "kms:List*",
+ *                 "kms:Put*",
+ *                 "kms:Update*",
+ *                 "kms:Revoke*",
+ *                 "kms:Disable*",
+ *                 "kms:Get*",
+ *                 "kms:Delete*",
+ *                 "kms:ScheduleKeyDeletion",
+ *                 "kms:CancelKeyDeletion"
+ *             ],
+ *             "Resource": "*"
+ *         },
+ *         {
+ *             "Sid": "Allow use of the key",
+ *             "Effect": "Allow",
+ *             "Principal": {
+ *                 "AWS": "arn:aws:iam::111122223333:role/ExamplePowerUserRole"
+ *             },
+ *             "Action": [
+ *                 "kms:Encrypt",
+ *                 "kms:Decrypt",
+ *                 "kms:ReEncrypt*",
+ *                 "kms:GenerateDataKey*",
+ *                 "kms:DescribeKey"
+ *             ],
+ *             "Resource": "*"
+ *         },
+ *         {
+ *             "Sid": "Allow attachment of persistent resources",
+ *             "Effect": "Allow",
+ *             "Principal": {
+ *                 "AWS": "arn:aws:iam::111122223333:role/ExamplePowerUserRole"
+ *             },
+ *             "Action": [
+ *                 "kms:CreateGrant",
+ *                 "kms:ListGrants",
+ *                 "kms:RevokeGrant"
+ *             ],
+ *             "Resource": "*",
+ *             "Condition": {
+ *                 "Bool": {
+ *                     "kms:GrantIsForAWSResource": "true"
+ *                 }
+ *             }
+ *         }
+ *     ]
+ * }
+ * `,
+ *   PolicyName: "default"
  * };
  * const command = new PutKeyPolicyCommand(input);
- * await client.send(command);
- * // example id: to-attach-a-key-policy-to-a-cmk-1481147345018
+ * const response = await client.send(command);
+ * /* response is
+ * { /* metadata only *\/ }
+ * *\/
  * ```
  *
+ * @public
  */
 export declare class PutKeyPolicyCommand extends PutKeyPolicyCommand_base {
     /** @internal type navigation helper, not in runtime. */

package/dist-types/commands/ReEncryptCommand.d.ts

@@ -250,26 +250,26 @@ declare const ReEncryptCommand_base: {
  * @throws {@link KMSServiceException}
  * <p>Base exception class for all service exceptions from KMS service.</p>
  *
- * @public
+ *
  * @example To reencrypt data
  * ```javascript
  * // The following example reencrypts data with the specified KMS key.
  * const input = {
- *   "CiphertextBlob": "<binary data>",
- *   "DestinationKeyId": "0987dcba-09fe-87dc-65ba-ab0987654321"
+ *   CiphertextBlob: "<binary data>",
+ *   DestinationKeyId: "0987dcba-09fe-87dc-65ba-ab0987654321"
  * };
  * const command = new ReEncryptCommand(input);
  * const response = await client.send(command);
- * /* response ==
+ * /* response is
  * {
- *   "CiphertextBlob": "<binary data>",
- *   "KeyId": "arn:aws:kms:us-east-2:111122223333:key/0987dcba-09fe-87dc-65ba-ab0987654321",
- *   "SourceKeyId": "arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab"
+ *   CiphertextBlob: "<binary data>",
+ *   KeyId: "arn:aws:kms:us-east-2:111122223333:key/0987dcba-09fe-87dc-65ba-ab0987654321",
+ *   SourceKeyId: "arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab"
  * }
  * *\/
- * // example id: to-reencrypt-data-1481230358001
  * ```
  *
+ * @public
  */
 export declare class ReEncryptCommand extends ReEncryptCommand_base {
     /** @internal type navigation helper, not in runtime. */

package/dist-types/commands/ReplicateKeyCommand.d.ts

@@ -259,55 +259,57 @@ declare const ReplicateKeyCommand_base: {
  * @throws {@link KMSServiceException}
  * <p>Base exception class for all service exceptions from KMS service.</p>
  *
- * @public
+ *
  * @example To replicate a multi-Region key in a different AWS Region
  * ```javascript
  * // This example creates a multi-Region replica key in us-west-2 of a multi-Region primary key in us-east-1.
  * const input = {
- *   "KeyId": "arn:aws:kms:us-east-1:111122223333:key/mrk-1234abcd12ab34cd56ef1234567890ab",
- *   "ReplicaRegion": "us-west-2"
+ *   KeyId: "arn:aws:kms:us-east-1:111122223333:key/mrk-1234abcd12ab34cd56ef1234567890ab",
+ *   ReplicaRegion: "us-west-2"
  * };
  * const command = new ReplicateKeyCommand(input);
  * const response = await client.send(command);
- * /* response ==
+ * /* response is
  * {
- *   "ReplicaKeyMetadata": {
- *     "AWSAccountId": "111122223333",
- *     "Arn": "arn:aws:kms:us-west-2:111122223333:key/mrk-1234abcd12ab34cd56ef1234567890ab",
- *     "CreationDate": 1607472987.918,
- *     "CustomerMasterKeySpec": "SYMMETRIC_DEFAULT",
- *     "Description": "",
- *     "Enabled": true,
- *     "EncryptionAlgorithms": [
+ *   ReplicaKeyMetadata: {
+ *     AWSAccountId: "111122223333",
+ *     Arn: "arn:aws:kms:us-west-2:111122223333:key/mrk-1234abcd12ab34cd56ef1234567890ab",
+ *     CreationDate: 1.607472987918E9,
+ *     CustomerMasterKeySpec: "SYMMETRIC_DEFAULT",
+ *     Description: "",
+ *     Enabled: true,
+ *     EncryptionAlgorithms: [
  *       "SYMMETRIC_DEFAULT"
  *     ],
- *     "KeyId": "mrk-1234abcd12ab34cd56ef1234567890ab",
- *     "KeyManager": "CUSTOMER",
- *     "KeyState": "Enabled",
- *     "KeyUsage": "ENCRYPT_DECRYPT",
- *     "MultiRegion": true,
- *     "MultiRegionConfiguration": {
- *       "MultiRegionKeyType": "REPLICA",
- *       "PrimaryKey": {
- *         "Arn": "arn:aws:kms:us-east-1:111122223333:key/mrk-1234abcd12ab34cd56ef1234567890ab",
- *         "Region": "us-east-1"
+ *     KeyId: "mrk-1234abcd12ab34cd56ef1234567890ab",
+ *     KeyManager: "CUSTOMER",
+ *     KeyState: "Enabled",
+ *     KeyUsage: "ENCRYPT_DECRYPT",
+ *     MultiRegion: true,
+ *     MultiRegionConfiguration: {
+ *       MultiRegionKeyType: "REPLICA",
+ *       PrimaryKey: {
+ *         Arn: "arn:aws:kms:us-east-1:111122223333:key/mrk-1234abcd12ab34cd56ef1234567890ab",
+ *         Region: "us-east-1"
  *       },
- *       "ReplicaKeys": [
+ *       ReplicaKeys: [
  *         {
- *           "Arn": "arn:aws:kms:us-west-2:111122223333:key/mrk-1234abcd12ab34cd56ef1234567890ab",
- *           "Region": "us-west-2"
+ *           Arn: "arn:aws:kms:us-west-2:111122223333:key/mrk-1234abcd12ab34cd56ef1234567890ab",
+ *           Region: "us-west-2"
  *         }
  *       ]
  *     },
- *     "Origin": "AWS_KMS"
+ *     Origin: "AWS_KMS"
  *   },
- *   "ReplicaPolicy": "{\n  \"Version\" : \"2012-10-17\",\n  \"Id\" : \"key-default-1\",...}",
- *   "ReplicaTags": []
+ *   ReplicaPolicy: `{
+ *   "Version" : "2012-10-17",
+ *   "Id" : "key-default-1",...}`,
+ *   ReplicaTags:   []
  * }
  * *\/
- * // example id: to-replicate-a-multi-region-key-in-a-different-aws-region-1628622402887
  * ```
  *
+ * @public
  */
 export declare class ReplicateKeyCommand extends ReplicateKeyCommand_base {
     /** @internal type navigation helper, not in runtime. */