@aws-sdk/client-kms 3.775.0 → 3.782.0

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

@@ -105,23 +105,23 @@ declare const CancelKeyDeletionCommand_base: {
  * @throws {@link KMSServiceException}
  * <p>Base exception class for all service exceptions from KMS service.</p>
  *
- * @public
+ *
  * @example To cancel deletion of a KMS key
  * ```javascript
  * // The following example cancels deletion of the specified KMS key.
  * const input = {
- *   "KeyId": "1234abcd-12ab-34cd-56ef-1234567890ab"
+ *   KeyId: "1234abcd-12ab-34cd-56ef-1234567890ab"
  * };
  * const command = new CancelKeyDeletionCommand(input);
  * const response = await client.send(command);
- * /* response ==
+ * /* response is
  * {
- *   "KeyId": "arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab"
+ *   KeyId: "arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab"
  * }
  * *\/
- * // example id: to-cancel-deletion-of-a-cmk-1477428535102
  * ```
  *
+ * @public
  */
 export declare class CancelKeyDeletionCommand extends CancelKeyDeletionCommand_base {
     /** @internal type navigation helper, not in runtime. */

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

@@ -225,18 +225,21 @@ declare const ConnectCustomKeyStoreCommand_base: {
  * @throws {@link KMSServiceException}
  * <p>Base exception class for all service exceptions from KMS service.</p>
  *
- * @public
+ *
  * @example To connect a custom key store
  * ```javascript
  * // This example connects an AWS KMS custom key store to its backing key store. For an AWS CloudHSM key store, it connects the key store to its AWS CloudHSM cluster. For an external key store, it connects the key store to the external key store proxy that communicates with your external key manager. This operation does not return any data. To verify that the custom key store is connected, use the <code>DescribeCustomKeyStores</code> operation.
  * const input = {
- *   "CustomKeyStoreId": "cks-1234567890abcdef0"
+ *   CustomKeyStoreId: "cks-1234567890abcdef0"
  * };
  * const command = new ConnectCustomKeyStoreCommand(input);
- * await client.send(command);
- * // example id: to-connect-a-custom-key-store-1628626947750
+ * const response = await client.send(command);
+ * /* response is
+ * { /* empty *\/ }
+ * *\/
  * ```
  *
+ * @public
  */
 export declare class ConnectCustomKeyStoreCommand extends ConnectCustomKeyStoreCommand_base {
     /** @internal type navigation helper, not in runtime. */

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

@@ -155,19 +155,22 @@ declare const CreateAliasCommand_base: {
  * @throws {@link KMSServiceException}
  * <p>Base exception class for all service exceptions from KMS service.</p>
  *
- * @public
+ *
  * @example To create an alias
  * ```javascript
  * // The following example creates an alias for the specified KMS key.
  * const input = {
- *   "AliasName": "alias/ExampleAlias",
- *   "TargetKeyId": "1234abcd-12ab-34cd-56ef-1234567890ab"
+ *   AliasName: "alias/ExampleAlias",
+ *   TargetKeyId: "1234abcd-12ab-34cd-56ef-1234567890ab"
  * };
  * const command = new CreateAliasCommand(input);
- * await client.send(command);
- * // example id: to-create-an-alias-1477505685119
+ * const response = await client.send(command);
+ * /* response is
+ * { /* metadata only *\/ }
+ * *\/
  * ```
  *
+ * @public
  */
 export declare class CreateAliasCommand extends CreateAliasCommand_base {
     /** @internal type navigation helper, not in runtime. */

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

@@ -281,75 +281,26 @@ declare const CreateCustomKeyStoreCommand_base: {
  * @throws {@link KMSServiceException}
  * <p>Base exception class for all service exceptions from KMS service.</p>
  *
- * @public
+ *
  * @example To create an AWS CloudHSM key store
  * ```javascript
  * // This example creates a custom key store that is associated with an AWS CloudHSM cluster.
  * const input = {
- *   "CloudHsmClusterId": "cluster-234abcdefABC",
- *   "CustomKeyStoreName": "ExampleKeyStore",
- *   "KeyStorePassword": "kmsPswd",
- *   "TrustAnchorCertificate": "<certificate-goes-here>"
- * };
- * const command = new CreateCustomKeyStoreCommand(input);
- * const response = await client.send(command);
- * /* response ==
- * {
- *   "CustomKeyStoreId": "cks-1234567890abcdef0"
- * }
- * *\/
- * // example id: to-create-an-aws-cloudhsm-custom-key-store-1
- * ```
- *
- * @example To create an external key store with VPC endpoint service connectivity
- * ```javascript
- * // This example creates an external key store that uses an Amazon VPC endpoint service to communicate with AWS KMS.
- * const input = {
- *   "CustomKeyStoreName": "ExampleVPCEndpointKeyStore",
- *   "CustomKeyStoreType": "EXTERNAL_KEY_STORE",
- *   "XksProxyAuthenticationCredential": {
- *     "AccessKeyId": "ABCDE12345670EXAMPLE",
- *     "RawSecretAccessKey": "DXjSUawnel2fr6SKC7G25CNxTyWKE5PF9XX6H/u9pSo="
- *   },
- *   "XksProxyConnectivity": "VPC_ENDPOINT_SERVICE",
- *   "XksProxyUriEndpoint": "https://myproxy-private.xks.example.com",
- *   "XksProxyUriPath": "/example-prefix/kms/xks/v1",
- *   "XksProxyVpcEndpointServiceName": "com.amazonaws.vpce.us-east-1.vpce-svc-example1"
+ *   CloudHsmClusterId: "cluster-234abcdefABC",
+ *   CustomKeyStoreName: "ExampleKeyStore",
+ *   KeyStorePassword: "kmsPswd",
+ *   TrustAnchorCertificate: "<certificate-goes-here>"
  * };
  * const command = new CreateCustomKeyStoreCommand(input);
  * const response = await client.send(command);
- * /* response ==
+ * /* response is
  * {
- *   "CustomKeyStoreId": "cks-1234567890abcdef0"
+ *   CustomKeyStoreId: "cks-1234567890abcdef0"
  * }
  * *\/
- * // example id: to-create-an-external-custom-key-store-with-vpc-connectivity-2
- * ```
- *
- * @example To create an external key store with public endpoint connectivity
- * ```javascript
- * // This example creates an external key store with public endpoint connectivity.
- * const input = {
- *   "CustomKeyStoreName": "ExamplePublicEndpointKeyStore",
- *   "CustomKeyStoreType": "EXTERNAL_KEY_STORE",
- *   "XksProxyAuthenticationCredential": {
- *     "AccessKeyId": "ABCDE12345670EXAMPLE",
- *     "RawSecretAccessKey": "DXjSUawnel2fr6SKC7G25CNxTyWKE5PF9XX6H/u9pSo="
- *   },
- *   "XksProxyConnectivity": "PUBLIC_ENDPOINT",
- *   "XksProxyUriEndpoint": "https://myproxy.xks.example.com",
- *   "XksProxyUriPath": "/kms/xks/v1"
- * };
- * const command = new CreateCustomKeyStoreCommand(input);
- * const response = await client.send(command);
- * /* response ==
- * {
- *   "CustomKeyStoreId": "cks-987654321abcdef0"
- * }
- * *\/
- * // example id: to-create-an-external-custom-key-store-with-a-public-endpoint-3
  * ```
  *
+ * @public
  */
 export declare class CreateCustomKeyStoreCommand extends CreateCustomKeyStoreCommand_base {
     /** @internal type navigation helper, not in runtime. */

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

@@ -186,29 +186,29 @@ declare const CreateGrantCommand_base: {
  * @throws {@link KMSServiceException}
  * <p>Base exception class for all service exceptions from KMS service.</p>
  *
- * @public
+ *
  * @example To create a grant
  * ```javascript
  * // The following example creates a grant that allows the specified IAM role to encrypt data with the specified KMS key.
  * const input = {
- *   "GranteePrincipal": "arn:aws:iam::111122223333:role/ExampleRole",
- *   "KeyId": "arn:aws:kms:us-east-2:444455556666:key/1234abcd-12ab-34cd-56ef-1234567890ab",
- *   "Operations": [
+ *   GranteePrincipal: "arn:aws:iam::111122223333:role/ExampleRole",
+ *   KeyId: "arn:aws:kms:us-east-2:444455556666:key/1234abcd-12ab-34cd-56ef-1234567890ab",
+ *   Operations: [
  *     "Encrypt",
  *     "Decrypt"
  *   ]
  * };
  * const command = new CreateGrantCommand(input);
  * const response = await client.send(command);
- * /* response ==
+ * /* response is
  * {
- *   "GrantId": "0c237476b39f8bc44e45212e08498fbe3151305030726c0590dd8d3e9f3d6a60",
- *   "GrantToken": "AQpAM2RhZTk1MGMyNTk2ZmZmMzEyYWVhOWViN2I1MWM4Mzc0MWFiYjc0ZDE1ODkyNGFlNTIzODZhMzgyZjBlNGY3NiKIAgEBAgB4Pa6VDCWW__MSrqnre1HIN0Grt00ViSSuUjhqOC8OT3YAAADfMIHcBgkqhkiG9w0BBwaggc4wgcsCAQAwgcUGCSqGSIb3DQEHATAeBglghkgBZQMEAS4wEQQMmqLyBTAegIn9XlK5AgEQgIGXZQjkBcl1dykDdqZBUQ6L1OfUivQy7JVYO2-ZJP7m6f1g8GzV47HX5phdtONAP7K_HQIflcgpkoCqd_fUnE114mSmiagWkbQ5sqAVV3ov-VeqgrvMe5ZFEWLMSluvBAqdjHEdMIkHMlhlj4ENZbzBfo9Wxk8b8SnwP4kc4gGivedzFXo-dwN8fxjjq_ZZ9JFOj2ijIbj5FyogDCN0drOfi8RORSEuCEmPvjFRMFAwcmwFkN2NPp89amA"
+ *   GrantId: "0c237476b39f8bc44e45212e08498fbe3151305030726c0590dd8d3e9f3d6a60",
+ *   GrantToken: "AQpAM2RhZTk1MGMyNTk2ZmZmMzEyYWVhOWViN2I1MWM4Mzc0MWFiYjc0ZDE1ODkyNGFlNTIzODZhMzgyZjBlNGY3NiKIAgEBAgB4Pa6VDCWW__MSrqnre1HIN0Grt00ViSSuUjhqOC8OT3YAAADfMIHcBgkqhkiG9w0BBwaggc4wgcsCAQAwgcUGCSqGSIb3DQEHATAeBglghkgBZQMEAS4wEQQMmqLyBTAegIn9XlK5AgEQgIGXZQjkBcl1dykDdqZBUQ6L1OfUivQy7JVYO2-ZJP7m6f1g8GzV47HX5phdtONAP7K_HQIflcgpkoCqd_fUnE114mSmiagWkbQ5sqAVV3ov-VeqgrvMe5ZFEWLMSluvBAqdjHEdMIkHMlhlj4ENZbzBfo9Wxk8b8SnwP4kc4gGivedzFXo-dwN8fxjjq_ZZ9JFOj2ijIbj5FyogDCN0drOfi8RORSEuCEmPvjFRMFAwcmwFkN2NPp89amA"
  * }
  * *\/
- * // example id: to-create-a-grant-1477972226782
  * ```
  *
+ * @public
  */
 export declare class CreateGrantCommand extends CreateGrantCommand_base {
     /** @internal type navigation helper, not in runtime. */

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

@@ -407,290 +407,8 @@ declare const CreateKeyCommand_base: {
  * @throws {@link KMSServiceException}
  * <p>Base exception class for all service exceptions from KMS service.</p>
  *
- * @public
- * @example To create a KMS key
- * ```javascript
- * // The following example creates a symmetric KMS key for encryption and decryption. No parameters are required for this operation.
- * const input = {};
- * const command = new CreateKeyCommand(input);
- * const response = await client.send(command);
- * /* response ==
- * {
- *   "KeyMetadata": {
- *     "AWSAccountId": "111122223333",
- *     "Arn": "arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab",
- *     "CreationDate": "2017-07-05T14:04:55-07:00",
- *     "CustomerMasterKeySpec": "SYMMETRIC_DEFAULT",
- *     "Description": "",
- *     "Enabled": true,
- *     "EncryptionAlgorithms": [
- *       "SYMMETRIC_DEFAULT"
- *     ],
- *     "KeyId": "1234abcd-12ab-34cd-56ef-1234567890ab",
- *     "KeyManager": "CUSTOMER",
- *     "KeySpec": "SYMMETRIC_DEFAULT",
- *     "KeyState": "Enabled",
- *     "KeyUsage": "ENCRYPT_DECRYPT",
- *     "MultiRegion": false,
- *     "Origin": "AWS_KMS"
- *   }
- * }
- * *\/
- * // example id: to-create-a-cmk-1
- * ```
- *
- * @example To create an asymmetric RSA KMS key for encryption and decryption
- * ```javascript
- * // This example creates a KMS key that contains an asymmetric RSA key pair for encryption and decryption. The key spec and key usage can't be changed after the key is created.
- * const input = {
- *   "KeySpec": "RSA_4096",
- *   "KeyUsage": "ENCRYPT_DECRYPT"
- * };
- * const command = new CreateKeyCommand(input);
- * const response = await client.send(command);
- * /* response ==
- * {
- *   "KeyMetadata": {
- *     "AWSAccountId": "111122223333",
- *     "Arn": "arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab",
- *     "CreationDate": "2021-04-05T14:04:55-07:00",
- *     "CustomerMasterKeySpec": "RSA_4096",
- *     "Description": "",
- *     "Enabled": true,
- *     "EncryptionAlgorithms": [
- *       "RSAES_OAEP_SHA_1",
- *       "RSAES_OAEP_SHA_256"
- *     ],
- *     "KeyId": "1234abcd-12ab-34cd-56ef-1234567890ab",
- *     "KeyManager": "CUSTOMER",
- *     "KeySpec": "RSA_4096",
- *     "KeyState": "Enabled",
- *     "KeyUsage": "ENCRYPT_DECRYPT",
- *     "MultiRegion": false,
- *     "Origin": "AWS_KMS"
- *   }
- * }
- * *\/
- * // example id: to-create-an-asymmetric-rsa-kms-key-for-encryption-and-decryption-2
- * ```
- *
- * @example To create an asymmetric elliptic curve KMS key for signing and verification
- * ```javascript
- * // This example creates a KMS key that contains an asymmetric elliptic curve (ECC) key pair for signing and verification. The key usage is required even though "SIGN_VERIFY" is the only valid value for ECC KMS keys. The key spec and key usage can't be changed after the key is created.
- * const input = {
- *   "KeySpec": "ECC_NIST_P521",
- *   "KeyUsage": "SIGN_VERIFY"
- * };
- * const command = new CreateKeyCommand(input);
- * const response = await client.send(command);
- * /* response ==
- * {
- *   "KeyMetadata": {
- *     "AWSAccountId": "111122223333",
- *     "Arn": "arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab",
- *     "CreationDate": "2019-12-02T07:48:55-07:00",
- *     "CustomerMasterKeySpec": "ECC_NIST_P521",
- *     "Description": "",
- *     "Enabled": true,
- *     "KeyId": "1234abcd-12ab-34cd-56ef-1234567890ab",
- *     "KeyManager": "CUSTOMER",
- *     "KeySpec": "ECC_NIST_P521",
- *     "KeyState": "Enabled",
- *     "KeyUsage": "SIGN_VERIFY",
- *     "MultiRegion": false,
- *     "Origin": "AWS_KMS",
- *     "SigningAlgorithms": [
- *       "ECDSA_SHA_512"
- *     ]
- *   }
- * }
- * *\/
- * // example id: to-create-an-asymmetric-elliptic-curve-kms-key-for-signing-and-verification-3
- * ```
- *
- * @example To create an HMAC KMS key
- * ```javascript
- * // This example creates a 384-bit symmetric HMAC KMS key. The GENERATE_VERIFY_MAC key usage value is required even though it's the only valid value for HMAC KMS keys. The key spec and key usage can't be changed after the key is created.
- * const input = {
- *   "KeySpec": "HMAC_384",
- *   "KeyUsage": "GENERATE_VERIFY_MAC"
- * };
- * const command = new CreateKeyCommand(input);
- * const response = await client.send(command);
- * /* response ==
- * {
- *   "KeyMetadata": {
- *     "AWSAccountId": "111122223333",
- *     "Arn": "arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab",
- *     "CreationDate": "2022-04-05T14:04:55-07:00",
- *     "CustomerMasterKeySpec": "HMAC_384",
- *     "Description": "",
- *     "Enabled": true,
- *     "KeyId": "1234abcd-12ab-34cd-56ef-1234567890ab",
- *     "KeyManager": "CUSTOMER",
- *     "KeySpec": "HMAC_384",
- *     "KeyState": "Enabled",
- *     "KeyUsage": "GENERATE_VERIFY_MAC",
- *     "MacAlgorithms": [
- *       "HMAC_SHA_384"
- *     ],
- *     "MultiRegion": false,
- *     "Origin": "AWS_KMS"
- *   }
- * }
- * *\/
- * // example id: to-create-an-hmac-kms-key-1630628752841
- * ```
- *
- * @example To create a multi-Region primary KMS key
- * ```javascript
- * // This example creates a multi-Region primary symmetric encryption key. Because the default values for all parameters create a symmetric encryption key, only the MultiRegion parameter is required for this KMS key.
- * const input = {
- *   "MultiRegion": true
- * };
- * const command = new CreateKeyCommand(input);
- * const response = await client.send(command);
- * /* response ==
- * {
- *   "KeyMetadata": {
- *     "AWSAccountId": "111122223333",
- *     "Arn": "arn:aws:kms:us-west-2:111122223333:key/mrk-1234abcd12ab34cd56ef12345678990ab",
- *     "CreationDate": "2021-09-02T016:15:21-09:00",
- *     "CustomerMasterKeySpec": "SYMMETRIC_DEFAULT",
- *     "Description": "",
- *     "Enabled": true,
- *     "EncryptionAlgorithms": [
- *       "SYMMETRIC_DEFAULT"
- *     ],
- *     "KeyId": "mrk-1234abcd12ab34cd56ef12345678990ab",
- *     "KeyManager": "CUSTOMER",
- *     "KeySpec": "SYMMETRIC_DEFAULT",
- *     "KeyState": "Enabled",
- *     "KeyUsage": "ENCRYPT_DECRYPT",
- *     "MultiRegion": true,
- *     "MultiRegionConfiguration": {
- *       "MultiRegionKeyType": "PRIMARY",
- *       "PrimaryKey": {
- *         "Arn": "arn:aws:kms:us-west-2:111122223333:key/mrk-1234abcd12ab34cd56ef12345678990ab",
- *         "Region": "us-west-2"
- *       },
- *       "ReplicaKeys": []
- *     },
- *     "Origin": "AWS_KMS"
- *   }
- * }
- * *\/
- * // example id: to-create-a-multi-region-primary-kms-key-4
- * ```
- *
- * @example To create a KMS key for imported key material
- * ```javascript
- * // This example creates a symmetric KMS key with no key material. When the operation is complete, you can import your own key material into the KMS key. To create this KMS key, set the Origin parameter to EXTERNAL.
- * const input = {
- *   "Origin": "EXTERNAL"
- * };
- * const command = new CreateKeyCommand(input);
- * const response = await client.send(command);
- * /* response ==
- * {
- *   "KeyMetadata": {
- *     "AWSAccountId": "111122223333",
- *     "Arn": "arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab",
- *     "CreationDate": "2019-12-02T07:48:55-07:00",
- *     "CustomerMasterKeySpec": "SYMMETRIC_DEFAULT",
- *     "Description": "",
- *     "Enabled": false,
- *     "EncryptionAlgorithms": [
- *       "SYMMETRIC_DEFAULT"
- *     ],
- *     "KeyId": "1234abcd-12ab-34cd-56ef-1234567890ab",
- *     "KeyManager": "CUSTOMER",
- *     "KeySpec": "SYMMETRIC_DEFAULT",
- *     "KeyState": "PendingImport",
- *     "KeyUsage": "ENCRYPT_DECRYPT",
- *     "MultiRegion": false,
- *     "Origin": "EXTERNAL"
- *   }
- * }
- * *\/
- * // example id: to-create-a-kms-key-for-imported-key-material-5
- * ```
- *
- * @example To create a KMS key in an AWS CloudHSM key store
- * ```javascript
- * // This example creates a KMS key in the specified AWS CloudHSM key store. The operation creates the KMS key and its metadata in AWS KMS and creates the key material in the AWS CloudHSM cluster associated with the custom key store. This example requires the CustomKeyStoreId  and Origin parameters.
- * const input = {
- *   "CustomKeyStoreId": "cks-1234567890abcdef0",
- *   "Origin": "AWS_CLOUDHSM"
- * };
- * const command = new CreateKeyCommand(input);
- * const response = await client.send(command);
- * /* response ==
- * {
- *   "KeyMetadata": {
- *     "AWSAccountId": "111122223333",
- *     "Arn": "arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab",
- *     "CloudHsmClusterId": "cluster-234abcdefABC",
- *     "CreationDate": "2019-12-02T07:48:55-07:00",
- *     "CustomKeyStoreId": "cks-1234567890abcdef0",
- *     "CustomerMasterKeySpec": "SYMMETRIC_DEFAULT",
- *     "Description": "",
- *     "Enabled": true,
- *     "EncryptionAlgorithms": [
- *       "SYMMETRIC_DEFAULT"
- *     ],
- *     "KeyId": "1234abcd-12ab-34cd-56ef-1234567890ab",
- *     "KeyManager": "CUSTOMER",
- *     "KeySpec": "SYMMETRIC_DEFAULT",
- *     "KeyState": "Enabled",
- *     "KeyUsage": "ENCRYPT_DECRYPT",
- *     "MultiRegion": false,
- *     "Origin": "AWS_CLOUDHSM"
- *   }
- * }
- * *\/
- * // example id: to-create-a-kms-key-in-an-aws-cloudhsm-custom-key-store-6
- * ```
- *
- * @example To create a KMS key in an external key store
- * ```javascript
- * // This example creates a KMS key in the specified external key store. It uses the XksKeyId parameter to associate the KMS key with an existing symmetric encryption key in your external key manager. This CustomKeyStoreId, Origin, and XksKeyId parameters are required in this operation.
- * const input = {
- *   "CustomKeyStoreId": "cks-9876543210fedcba9",
- *   "Origin": "EXTERNAL_KEY_STORE",
- *   "XksKeyId": "bb8562717f809024"
- * };
- * const command = new CreateKeyCommand(input);
- * const response = await client.send(command);
- * /* response ==
- * {
- *   "KeyMetadata": {
- *     "AWSAccountId": "111122223333",
- *     "Arn": "arn:aws:kms:us-east-2:111122223333:key/0987dcba-09fe-87dc-65ba-ab0987654321",
- *     "CreationDate": "2022-02-02T07:48:55-07:00",
- *     "CustomKeyStoreId": "cks-9876543210fedcba9",
- *     "CustomerMasterKeySpec": "SYMMETRIC_DEFAULT",
- *     "Description": "",
- *     "Enabled": true,
- *     "EncryptionAlgorithms": [
- *       "SYMMETRIC_DEFAULT"
- *     ],
- *     "KeyId": "0987dcba-09fe-87dc-65ba-ab0987654321",
- *     "KeyManager": "CUSTOMER",
- *     "KeySpec": "SYMMETRIC_DEFAULT",
- *     "KeyState": "Enabled",
- *     "KeyUsage": "ENCRYPT_DECRYPT",
- *     "MultiRegion": false,
- *     "Origin": "EXTERNAL_KEY_STORE",
- *     "XksKeyConfiguration": {
- *       "Id": "bb8562717f809024"
- *     }
- *   }
- * }
- * *\/
- * // example id: to-create-a-kms-key-in-an-external-custom-key-store-7
- * ```
  *
+ * @public
  */
 export declare class CreateKeyCommand extends CreateKeyCommand_base {
     /** @internal type navigation helper, not in runtime. */

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

@@ -247,69 +247,45 @@ declare const DecryptCommand_base: {
  * @throws {@link KMSServiceException}
  * <p>Base exception class for all service exceptions from KMS service.</p>
  *
- * @public
+ *
  * @example To decrypt data with a symmetric encryption KMS key
  * ```javascript
  * // The following example decrypts data that was encrypted with a symmetric encryption KMS key. The KeyId is not required when decrypting with a symmetric encryption key, but it is a best practice.
  * const input = {
- *   "CiphertextBlob": "<binary data>",
- *   "KeyId": "arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab"
+ *   CiphertextBlob: "<binary data>",
+ *   KeyId: "arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab"
  * };
  * const command = new DecryptCommand(input);
  * const response = await client.send(command);
- * /* response ==
+ * /* response is
  * {
- *   "EncryptionAlgorithm": "SYMMETRIC_DEFAULT",
- *   "KeyId": "arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab",
- *   "Plaintext": "<binary data>"
+ *   EncryptionAlgorithm: "SYMMETRIC_DEFAULT",
+ *   KeyId: "arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab",
+ *   Plaintext: "<binary data>"
  * }
  * *\/
- * // example id: to-decrypt-data-1
  * ```
  *
  * @example To decrypt data with an asymmetric encryption KMS key
  * ```javascript
  * // The following example decrypts data that was encrypted with an asymmetric encryption KMS key. When the KMS encryption key is asymmetric, you must specify the KMS key ID and the encryption algorithm that was used to encrypt the data.
  * const input = {
- *   "CiphertextBlob": "<binary data>",
- *   "EncryptionAlgorithm": "RSAES_OAEP_SHA_256",
- *   "KeyId": "0987dcba-09fe-87dc-65ba-ab0987654321"
+ *   CiphertextBlob: "<binary data>",
+ *   EncryptionAlgorithm: "RSAES_OAEP_SHA_256",
+ *   KeyId: "0987dcba-09fe-87dc-65ba-ab0987654321"
  * };
  * const command = new DecryptCommand(input);
  * const response = await client.send(command);
- * /* response ==
+ * /* response is
  * {
- *   "EncryptionAlgorithm": "RSAES_OAEP_SHA_256",
- *   "KeyId": "arn:aws:kms:us-west-2:111122223333:key/0987dcba-09fe-87dc-65ba-ab0987654321",
- *   "Plaintext": "<binary data>"
+ *   EncryptionAlgorithm: "RSAES_OAEP_SHA_256",
+ *   KeyId: "arn:aws:kms:us-west-2:111122223333:key/0987dcba-09fe-87dc-65ba-ab0987654321",
+ *   Plaintext: "<binary data>"
  * }
  * *\/
- * // example id: to-decrypt-data-2
- * ```
- *
- * @example To decrypt data for a Nitro enclave
- * ```javascript
- * // The following Decrypt example includes the Recipient parameter with a signed attestation document from an AWS Nitro enclave. Instead of returning the decrypted data in plaintext (Plaintext), the operation returns the decrypted data encrypted by the public key from the attestation document (CiphertextForRecipient).
- * const input = {
- *   "CiphertextBlob": "<binary data>",
- *   "KeyId": "arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab",
- *   "Recipient": {
- *     "AttestationDocument": "<attestation document>",
- *     "KeyEncryptionAlgorithm": "RSAES_OAEP_SHA_256"
- *   }
- * };
- * const command = new DecryptCommand(input);
- * const response = await client.send(command);
- * /* response ==
- * {
- *   "CiphertextForRecipient": "<binary data>",
- *   "KeyId": "arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab",
- *   "Plaintext": ""
- * }
- * *\/
- * // example id: to-decrypt-data-for-a-nitro-enclave-2
  * ```
  *
+ * @public
  */
 export declare class DecryptCommand extends DecryptCommand_base {
     /** @internal type navigation helper, not in runtime. */

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

@@ -134,18 +134,21 @@ declare const DeleteAliasCommand_base: {
  * @throws {@link KMSServiceException}
  * <p>Base exception class for all service exceptions from KMS service.</p>
  *
- * @public
+ *
  * @example To delete an alias
  * ```javascript
  * // The following example deletes the specified alias.
  * const input = {
- *   "AliasName": "alias/ExampleAlias"
+ *   AliasName: "alias/ExampleAlias"
  * };
  * const command = new DeleteAliasCommand(input);
- * await client.send(command);
- * // example id: to-delete-an-alias-1478285209338
+ * const response = await client.send(command);
+ * /* response is
+ * { /* metadata only *\/ }
+ * *\/
  * ```
  *
+ * @public
  */
 export declare class DeleteAliasCommand extends DeleteAliasCommand_base {
     /** @internal type navigation helper, not in runtime. */

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

@@ -163,18 +163,21 @@ declare const DeleteCustomKeyStoreCommand_base: {
  * @throws {@link KMSServiceException}
  * <p>Base exception class for all service exceptions from KMS service.</p>
  *
- * @public
+ *
  * @example To delete a custom key store from AWS KMS
  * ```javascript
  * // This example deletes a custom key store from AWS KMS. This operation does not affect the backing key store, such as a CloudHSM cluster, external key store proxy, or your external key manager. This operation doesn't return any data. To verify that the operation was successful, use the DescribeCustomKeyStores operation.
  * const input = {
- *   "CustomKeyStoreId": "cks-1234567890abcdef0"
+ *   CustomKeyStoreId: "cks-1234567890abcdef0"
  * };
  * const command = new DeleteCustomKeyStoreCommand(input);
- * await client.send(command);
- * // example id: to-delete-a-custom-key-store-from-aws-kms-1628630837145
+ * const response = await client.send(command);
+ * /* response is
+ * { /* empty *\/ }
+ * *\/
  * ```
  *
+ * @public
  */
 export declare class DeleteCustomKeyStoreCommand extends DeleteCustomKeyStoreCommand_base {
     /** @internal type navigation helper, not in runtime. */

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

@@ -122,18 +122,21 @@ declare const DeleteImportedKeyMaterialCommand_base: {
  * @throws {@link KMSServiceException}
  * <p>Base exception class for all service exceptions from KMS service.</p>
  *
- * @public
+ *
  * @example To delete imported key material
  * ```javascript
  * // The following example deletes the imported key material from the specified KMS key.
  * const input = {
- *   "KeyId": "1234abcd-12ab-34cd-56ef-1234567890ab"
+ *   KeyId: "1234abcd-12ab-34cd-56ef-1234567890ab"
  * };
  * const command = new DeleteImportedKeyMaterialCommand(input);
- * await client.send(command);
- * // example id: to-delete-imported-key-material-1478561674507
+ * const response = await client.send(command);
+ * /* response is
+ * { /* metadata only *\/ }
+ * *\/
  * ```
  *
+ * @public
  */
 export declare class DeleteImportedKeyMaterialCommand extends DeleteImportedKeyMaterialCommand_base {
     /** @internal type navigation helper, not in runtime. */