@aws-sdk/client-kms 3.775.0 → 3.777.0

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

@@ -243,46 +243,45 @@ declare const EncryptCommand_base: {
  * @throws {@link KMSServiceException}
  * <p>Base exception class for all service exceptions from KMS service.</p>
  *
- * @public
+ *
  * @example To encrypt data with a symmetric encryption KMS key
  * ```javascript
  * // The following example encrypts data with the specified symmetric encryption KMS key.
  * const input = {
- *   "KeyId": "1234abcd-12ab-34cd-56ef-1234567890ab",
- *   "Plaintext": "<binary data>"
+ *   KeyId: "1234abcd-12ab-34cd-56ef-1234567890ab",
+ *   Plaintext: "<binary data>"
  * };
  * const command = new EncryptCommand(input);
  * const response = await client.send(command);
- * /* response ==
+ * /* response is
  * {
- *   "CiphertextBlob": "<binary data>",
- *   "EncryptionAlgorithm": "SYMMETRIC_DEFAULT",
- *   "KeyId": "arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab"
+ *   CiphertextBlob: "<binary data>",
+ *   EncryptionAlgorithm: "SYMMETRIC_DEFAULT",
+ *   KeyId: "arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab"
  * }
  * *\/
- * // example id: to-encrypt-data-1
  * ```
  *
  * @example To encrypt data with an asymmetric encryption KMS key
  * ```javascript
  * // The following example encrypts data with the specified RSA asymmetric KMS key. When you encrypt with an asymmetric key, you must specify the encryption algorithm.
  * const input = {
- *   "EncryptionAlgorithm": "RSAES_OAEP_SHA_256",
- *   "KeyId": "0987dcba-09fe-87dc-65ba-ab0987654321",
- *   "Plaintext": "<binary data>"
+ *   EncryptionAlgorithm: "RSAES_OAEP_SHA_256",
+ *   KeyId: "0987dcba-09fe-87dc-65ba-ab0987654321",
+ *   Plaintext: "<binary data>"
  * };
  * const command = new EncryptCommand(input);
  * const response = await client.send(command);
- * /* response ==
+ * /* response is
  * {
- *   "CiphertextBlob": "<binary data>",
- *   "EncryptionAlgorithm": "RSAES_OAEP_SHA_256",
- *   "KeyId": "arn:aws:kms:us-west-2:111122223333:key/0987dcba-09fe-87dc-65ba-ab0987654321"
+ *   CiphertextBlob: "<binary data>",
+ *   EncryptionAlgorithm: "RSAES_OAEP_SHA_256",
+ *   KeyId: "arn:aws:kms:us-west-2:111122223333:key/0987dcba-09fe-87dc-65ba-ab0987654321"
  * }
  * *\/
- * // example id: to-encrypt-data-2
  * ```
  *
+ * @public
  */
 export declare class EncryptCommand extends EncryptCommand_base {
     /** @internal type navigation helper, not in runtime. */

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

@@ -242,50 +242,26 @@ declare const GenerateDataKeyCommand_base: {
  * @throws {@link KMSServiceException}
  * <p>Base exception class for all service exceptions from KMS service.</p>
  *
- * @public
+ *
  * @example To generate a data key
  * ```javascript
  * // The following example generates a 256-bit symmetric data encryption key (data key) in two formats. One is the unencrypted (plainext) data key, and the other is the data key encrypted with the specified KMS key.
  * const input = {
- *   "KeyId": "alias/ExampleAlias",
- *   "KeySpec": "AES_256"
+ *   KeyId: "alias/ExampleAlias",
+ *   KeySpec: "AES_256"
  * };
  * const command = new GenerateDataKeyCommand(input);
  * const response = await client.send(command);
- * /* response ==
+ * /* response is
  * {
- *   "CiphertextBlob": "<binary data>",
- *   "KeyId": "arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab",
- *   "Plaintext": "<binary data>"
+ *   CiphertextBlob: "<binary data>",
+ *   KeyId: "arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab",
+ *   Plaintext: "<binary data>"
  * }
  * *\/
- * // example id: to-generate-a-data-key-1
- * ```
- *
- * @example To generate a data key pair for a Nitro enclave
- * ```javascript
- * // The following example includes the Recipient parameter with a signed attestation document from an AWS Nitro enclave. Instead of returning a copy of the data key encrypted by the KMS key and a plaintext copy of the data key, GenerateDataKey returns one copy of the data key encrypted by the KMS key (CiphertextBlob) and one copy of the data key encrypted by the public key from the attestation document (CiphertextForRecipient). The operation doesn't return a plaintext data key.
- * const input = {
- *   "KeyId": "arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab",
- *   "KeySpec": "AES_256",
- *   "Recipient": {
- *     "AttestationDocument": "<attestation document>",
- *     "KeyEncryptionAlgorithm": "RSAES_OAEP_SHA_256"
- *   }
- * };
- * const command = new GenerateDataKeyCommand(input);
- * const response = await client.send(command);
- * /* response ==
- * {
- *   "CiphertextBlob": "<binary data>",
- *   "CiphertextForRecipient": "<binary data>",
- *   "KeyId": "arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab",
- *   "Plaintext": ""
- * }
- * *\/
- * // example id: to-generate-a-data-key-for-a-nitro-enclave-2
  * ```
  *
+ * @public
  */
 export declare class GenerateDataKeyCommand extends GenerateDataKeyCommand_base {
     /** @internal type navigation helper, not in runtime. */

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

@@ -226,54 +226,28 @@ declare const GenerateDataKeyPairCommand_base: {
  * @throws {@link KMSServiceException}
  * <p>Base exception class for all service exceptions from KMS service.</p>
  *
- * @public
+ *
  * @example To generate an RSA key pair for encryption and decryption
  * ```javascript
  * // This example generates an RSA data key pair for encryption and decryption. The operation returns a plaintext public key and private key, and a copy of the private key that is encrypted under a symmetric encryption KMS key that you specify.
  * const input = {
- *   "KeyId": "arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab",
- *   "KeyPairSpec": "RSA_3072"
+ *   KeyId: "arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab",
+ *   KeyPairSpec: "RSA_3072"
  * };
  * const command = new GenerateDataKeyPairCommand(input);
  * const response = await client.send(command);
- * /* response ==
+ * /* response is
  * {
- *   "KeyId": "arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab",
- *   "KeyPairSpec": "RSA_3072",
- *   "PrivateKeyCiphertextBlob": "<binary data>",
- *   "PrivateKeyPlaintext": "<binary data>",
- *   "PublicKey": "<binary data>"
+ *   KeyId: "arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab",
+ *   KeyPairSpec: "RSA_3072",
+ *   PrivateKeyCiphertextBlob: "<binary data>",
+ *   PrivateKeyPlaintext: "<binary data>",
+ *   PublicKey: "<binary data>"
  * }
  * *\/
- * // example id: to-generate-an-rsa-key-pair-for-encryption-and-decryption-1
- * ```
- *
- * @example To generate a data key pair for a Nitro enclave
- * ```javascript
- * // The following example includes the Recipient parameter with a signed attestation document from an AWS Nitro enclave. Instead of returning a plaintext copy of the private data key, GenerateDataKeyPair returns a copy of the private data key encrypted by the public key from the attestation document (CiphertextForRecipient). It returns the public data key (PublicKey) and a copy of private data key encrypted under the specified KMS key (PrivateKeyCiphertextBlob), as usual, but plaintext private data key field (PrivateKeyPlaintext) is null or empty.
- * const input = {
- *   "KeyId": "arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab",
- *   "KeyPairSpec": "RSA_3072",
- *   "Recipient": {
- *     "AttestationDocument": "<attestation document>",
- *     "KeyEncryptionAlgorithm": "RSAES_OAEP_SHA_256"
- *   }
- * };
- * const command = new GenerateDataKeyPairCommand(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",
- *   "KeyPairSpec": "RSA_3072",
- *   "PrivateKeyCiphertextBlob": "<binary data>",
- *   "PrivateKeyPlaintext": "",
- *   "PublicKey": "<binary data>"
- * }
- * *\/
- * // example id: to-generate-a-data-key-pair-for-a-nitro-enclave-2
  * ```
  *
+ * @public
  */
 export declare class GenerateDataKeyPairCommand extends GenerateDataKeyPairCommand_base {
     /** @internal type navigation helper, not in runtime. */

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

@@ -202,27 +202,27 @@ declare const GenerateDataKeyPairWithoutPlaintextCommand_base: {
  * @throws {@link KMSServiceException}
  * <p>Base exception class for all service exceptions from KMS service.</p>
  *
- * @public
+ *
  * @example To generate an asymmetric data key pair without a plaintext key
  * ```javascript
  * // This example returns an asymmetric elliptic curve (ECC) data key pair. The private key is encrypted under the symmetric encryption KMS key that you specify. This operation doesn't return a plaintext (unencrypted) private key.
  * const input = {
- *   "KeyId": "arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab",
- *   "KeyPairSpec": "ECC_NIST_P521"
+ *   KeyId: "arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab",
+ *   KeyPairSpec: "ECC_NIST_P521"
  * };
  * const command = new GenerateDataKeyPairWithoutPlaintextCommand(input);
  * const response = await client.send(command);
- * /* response ==
+ * /* response is
  * {
- *   "KeyId": "arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab",
- *   "KeyPairSpec": "ECC_NIST_P521",
- *   "PrivateKeyCiphertextBlob": "<binary data>",
- *   "PublicKey": "<binary data>"
+ *   KeyId: "arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab",
+ *   KeyPairSpec: "ECC_NIST_P521",
+ *   PrivateKeyCiphertextBlob: "<binary data>",
+ *   PublicKey: "<binary data>"
  * }
  * *\/
- * // example id: to-generate-an-asymmetric-data-key-pair-without-a-plaintext-key-1628620971564
  * ```
  *
+ * @public
  */
 export declare class GenerateDataKeyPairWithoutPlaintextCommand extends GenerateDataKeyPairWithoutPlaintextCommand_base {
     /** @internal type navigation helper, not in runtime. */

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

@@ -206,25 +206,25 @@ declare const GenerateDataKeyWithoutPlaintextCommand_base: {
  * @throws {@link KMSServiceException}
  * <p>Base exception class for all service exceptions from KMS service.</p>
  *
- * @public
+ *
  * @example To generate an encrypted data key
  * ```javascript
  * // The following example generates an encrypted copy of a 256-bit symmetric data encryption key (data key). The data key is encrypted with the specified KMS key.
  * const input = {
- *   "KeyId": "alias/ExampleAlias",
- *   "KeySpec": "AES_256"
+ *   KeyId: "alias/ExampleAlias",
+ *   KeySpec: "AES_256"
  * };
  * const command = new GenerateDataKeyWithoutPlaintextCommand(input);
  * const response = await client.send(command);
- * /* response ==
+ * /* response is
  * {
- *   "CiphertextBlob": "<binary data>",
- *   "KeyId": "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/1234abcd-12ab-34cd-56ef-1234567890ab"
  * }
  * *\/
- * // example id: to-generate-an-encrypted-data-key-1478914121134
  * ```
  *
+ * @public
  */
 export declare class GenerateDataKeyWithoutPlaintextCommand extends GenerateDataKeyWithoutPlaintextCommand_base {
     /** @internal type navigation helper, not in runtime. */

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

@@ -156,27 +156,27 @@ declare const GenerateMacCommand_base: {
  * @throws {@link KMSServiceException}
  * <p>Base exception class for all service exceptions from KMS service.</p>
  *
- * @public
+ *
  * @example To generate an HMAC for a message
  * ```javascript
  * // This example generates an HMAC for a message, an HMAC KMS key, and a MAC algorithm. The algorithm must be supported by the specified HMAC KMS key.
  * const input = {
- *   "KeyId": "1234abcd-12ab-34cd-56ef-1234567890ab",
- *   "MacAlgorithm": "HMAC_SHA_384",
- *   "Message": "Hello World"
+ *   KeyId: "1234abcd-12ab-34cd-56ef-1234567890ab",
+ *   MacAlgorithm: "HMAC_SHA_384",
+ *   Message: "Hello World"
  * };
  * const command = new GenerateMacCommand(input);
  * const response = await client.send(command);
- * /* response ==
+ * /* response is
  * {
- *   "KeyId": "arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab",
- *   "Mac": "<HMAC_TAG>",
- *   "MacAlgorithm": "HMAC_SHA_384"
+ *   KeyId: "arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab",
+ *   Mac: "<HMAC_TAG>",
+ *   MacAlgorithm: "HMAC_SHA_384"
  * }
  * *\/
- * // example id: to-generate-an-hmac-for-a-message-1631570135665
  * ```
  *
+ * @public
  */
 export declare class GenerateMacCommand extends GenerateMacCommand_base {
     /** @internal type navigation helper, not in runtime. */

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

@@ -135,44 +135,23 @@ declare const GenerateRandomCommand_base: {
  * @throws {@link KMSServiceException}
  * <p>Base exception class for all service exceptions from KMS service.</p>
  *
- * @public
- * @example To generate random data
- * ```javascript
- * // The following example generates 32 bytes of random data.
- * const input = {
- *   "NumberOfBytes": 32
- * };
- * const command = new GenerateRandomCommand(input);
- * const response = await client.send(command);
- * /* response ==
- * {
- *   "Plaintext": "<binary data>"
- * }
- * *\/
- * // example id: to-generate-random-data-1
- * ```
  *
  * @example To generate random data
  * ```javascript
- * // The following example includes the Recipient parameter with a signed attestation document from an AWS Nitro enclave. Instead of returning a plaintext (unencrypted) byte string, GenerateRandom returns the byte string encrypted by the public key from the enclave's attestation document.
+ * // The following example generates 32 bytes of random data.
  * const input = {
- *   "NumberOfBytes": 1024,
- *   "Recipient": {
- *     "AttestationDocument": "<attestation document>",
- *     "KeyEncryptionAlgorithm": "RSAES_OAEP_SHA_256"
- *   }
+ *   NumberOfBytes: 32
  * };
  * const command = new GenerateRandomCommand(input);
  * const response = await client.send(command);
- * /* response ==
+ * /* response is
  * {
- *   "CiphertextForRecipient": "<binary data>",
- *   "Plaintext": ""
+ *   Plaintext: "<binary data>"
  * }
  * *\/
- * // example id: to-generate-random-data-2
  * ```
  *
+ * @public
  */
 export declare class GenerateRandomCommand extends GenerateRandomCommand_base {
     /** @internal type navigation helper, not in runtime. */

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

@@ -102,24 +102,36 @@ declare const GetKeyPolicyCommand_base: {
  * @throws {@link KMSServiceException}
  * <p>Base exception class for all service exceptions from KMS service.</p>
  *
- * @public
+ *
  * @example To retrieve a key policy
  * ```javascript
  * // The following example retrieves the key policy for the specified KMS key.
  * const input = {
- *   "KeyId": "1234abcd-12ab-34cd-56ef-1234567890ab",
- *   "PolicyName": "default"
+ *   KeyId: "1234abcd-12ab-34cd-56ef-1234567890ab",
+ *   PolicyName: "default"
  * };
  * const command = new GetKeyPolicyCommand(input);
  * const response = await client.send(command);
- * /* response ==
+ * /* response is
  * {
- *   "Policy": "{\n  \"Version\" : \"2012-10-17\",\n  \"Id\" : \"key-default-1\",\n  \"Statement\" : [ {\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}"
+ *   Policy: `{
+ *   "Version" : "2012-10-17",
+ *   "Id" : "key-default-1",
+ *   "Statement" : [ {
+ *     "Sid" : "Enable IAM User Permissions",
+ *     "Effect" : "Allow",
+ *     "Principal" : {
+ *       "AWS" : "arn:aws:iam::111122223333:root"
+ *     },
+ *     "Action" : "kms:*",
+ *     "Resource" : "*"
+ *   } ]
+ * }`
  * }
  * *\/
- * // example id: to-retrieve-a-key-policy-1479170128325
  * ```
  *
+ * @public
  */
 export declare class GetKeyPolicyCommand extends GetKeyPolicyCommand_base {
     /** @internal type navigation helper, not in runtime. */

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

@@ -165,27 +165,8 @@ declare const GetKeyRotationStatusCommand_base: {
  * @throws {@link KMSServiceException}
  * <p>Base exception class for all service exceptions from KMS service.</p>
  *
- * @public
- * @example To retrieve the rotation status for a KMS key
- * ```javascript
- * // The following example retrieves detailed information about the rotation status for a KMS key, including whether automatic key rotation is enabled for the specified KMS key, the rotation period, and the next scheduled rotation date.
- * const input = {
- *   "KeyId": "1234abcd-12ab-34cd-56ef-1234567890ab"
- * };
- * const command = new GetKeyRotationStatusCommand(input);
- * const response = await client.send(command);
- * /* response ==
- * {
- *   "KeyId": "1234abcd-12ab-34cd-56ef-1234567890ab",
- *   "KeyRotationEnabled": true,
- *   "NextRotationDate": "2024-04-05T15:14:47.757000+00:00",
- *   "OnDemandRotationStartDate": "2024-03-02T10:11:36.564000+00:00",
- *   "RotationPeriodInDays": 365
- * }
- * *\/
- * // example id: to-retrieve-the-rotation-status-for-a-kms-key-1712500357701
- * ```
  *
+ * @public
  */
 export declare class GetKeyRotationStatusCommand extends GetKeyRotationStatusCommand_base {
     /** @internal type navigation helper, not in runtime. */

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

@@ -175,91 +175,8 @@ declare const GetParametersForImportCommand_base: {
  * @throws {@link KMSServiceException}
  * <p>Base exception class for all service exceptions from KMS service.</p>
  *
- * @public
- * @example To download the public key and import token for a symmetric encryption KMS key
- * ```javascript
- * // The following example downloads a public key and import token to import symmetric encryption key material. It uses the default wrapping key spec and the RSAES_OAEP_SHA_256 wrapping algorithm.
- * const input = {
- *   "KeyId": "1234abcd-12ab-34cd-56ef-1234567890ab",
- *   "WrappingAlgorithm": "RSAES_OAEP_SHA_1",
- *   "WrappingKeySpec": "RSA_2048"
- * };
- * const command = new GetParametersForImportCommand(input);
- * const response = await client.send(command);
- * /* response ==
- * {
- *   "ImportToken": "<binary data>",
- *   "KeyId": "arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab",
- *   "ParametersValidTo": "2023-02-01T14:52:17-08:00",
- *   "PublicKey": "<binary data>"
- * }
- * *\/
- * // example id: to-download-the-public-key-and-import-token-1
- * ```
- *
- * @example To download the public key and import token for an RSA asymmetric KMS key
- * ```javascript
- * // The following example downloads a public key and import token to import an RSA private key. It uses a required RSA_AES wrapping algorithm and the largest supported private key.
- * const input = {
- *   "KeyId": "arn:aws:kms:us-east-2:111122223333:key/8888abcd-12ab-34cd-56ef-1234567890ab",
- *   "WrappingAlgorithm": "RSA_AES_KEY_WRAP_SHA_256",
- *   "WrappingKeySpec": "RSA_4096"
- * };
- * const command = new GetParametersForImportCommand(input);
- * const response = await client.send(command);
- * /* response ==
- * {
- *   "ImportToken": "<binary data>",
- *   "KeyId": "arn:aws:kms:us-east-2:111122223333:key/8888abcd-12ab-34cd-56ef-1234567890ab",
- *   "ParametersValidTo": "2023-03-08T13:02:02-07:00",
- *   "PublicKey": "<binary data>"
- * }
- * *\/
- * // example id: to-download-the-public-key-and-import-token-2
- * ```
- *
- * @example To download the public key and import token for an elliptic curve (ECC) asymmetric KMS key
- * ```javascript
- * // The following example downloads a public key and import token to import an ECC_NIST_P521 (secp521r1) private key. You cannot directly wrap this ECC key under an RSA_2048 public key, although you can use an RSA_2048 public key with an RSA_AES wrapping algorithm to wrap any supported key material. This example requests an RSA_3072 public key for use with the RSAES_OAEP_SHA_256.
- * const input = {
- *   "KeyId": "arn:aws:kms:us-east-2:111122223333:key/9876abcd-12ab-34cd-56ef-1234567890ab",
- *   "WrappingAlgorithm": "RSAES_OAEP_SHA_256",
- *   "WrappingKeySpec": "RSA_3072"
- * };
- * const command = new GetParametersForImportCommand(input);
- * const response = await client.send(command);
- * /* response ==
- * {
- *   "ImportToken": "<binary data>",
- *   "KeyId": "arn:aws:kms:us-east-2:111122223333:key/9876abcd-12ab-34cd-56ef-1234567890ab",
- *   "ParametersValidTo": "2023-09-12T03:15:01-20:00",
- *   "PublicKey": "<binary data>"
- * }
- * *\/
- * // example id: to-download-the-public-key-and-import-token-3
- * ```
- *
- * @example To download the public key and import token for an HMAC KMS key
- * ```javascript
- * // The following example downloads a public key and import token to import an HMAC key. It uses the RSAES_OAEP_SHA_256 wrapping algorithm and an RSA_4096 private key.
- * const input = {
- *   "KeyId": "2468abcd-12ab-34cd-56ef-1234567890ab",
- *   "WrappingAlgorithm": "RSAES_OAEP_SHA_256",
- *   "WrappingKeySpec": "RSA_4096"
- * };
- * const command = new GetParametersForImportCommand(input);
- * const response = await client.send(command);
- * /* response ==
- * {
- *   "ImportToken": "<binary data>",
- *   "KeyId": "arn:aws:kms:us-east-2:111122223333:key/2468abcd-12ab-34cd-56ef-1234567890ab",
- *   "ParametersValidTo": "2023-04-02T13:02:02-07:00",
- *   "PublicKey": "<binary data>"
- * }
- * *\/
- * // example id: to-download-the-public-key-and-import-token-4
- * ```
  *
+ * @public
  */
 export declare class GetParametersForImportCommand extends GetParametersForImportCommand_base {
     /** @internal type navigation helper, not in runtime. */

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

@@ -193,30 +193,30 @@ declare const GetPublicKeyCommand_base: {
  * @throws {@link KMSServiceException}
  * <p>Base exception class for all service exceptions from KMS service.</p>
  *
- * @public
+ *
  * @example To download the public key of an asymmetric KMS key
  * ```javascript
  * // This example gets the public key of an asymmetric RSA KMS key used for encryption and decryption. The operation returns the key spec, key usage, and encryption or signing algorithms to help you use the public key correctly outside of AWS KMS.
  * const input = {
- *   "KeyId": "arn:aws:kms:us-west-2:111122223333:key/0987dcba-09fe-87dc-65ba-ab0987654321"
+ *   KeyId: "arn:aws:kms:us-west-2:111122223333:key/0987dcba-09fe-87dc-65ba-ab0987654321"
  * };
  * const command = new GetPublicKeyCommand(input);
  * const response = await client.send(command);
- * /* response ==
+ * /* response is
  * {
- *   "CustomerMasterKeySpec": "RSA_4096",
- *   "EncryptionAlgorithms": [
+ *   CustomerMasterKeySpec: "RSA_4096",
+ *   EncryptionAlgorithms: [
  *     "RSAES_OAEP_SHA_1",
  *     "RSAES_OAEP_SHA_256"
  *   ],
- *   "KeyId": "arn:aws:kms:us-west-2:111122223333:key/0987dcba-09fe-87dc-65ba-ab0987654321",
- *   "KeyUsage": "ENCRYPT_DECRYPT",
- *   "PublicKey": "<binary data>"
+ *   KeyId: "arn:aws:kms:us-west-2:111122223333:key/0987dcba-09fe-87dc-65ba-ab0987654321",
+ *   KeyUsage: "ENCRYPT_DECRYPT",
+ *   PublicKey: "<binary data>"
  * }
  * *\/
- * // example id: to-download-the-public-key-of-an-asymmetric-kms-key-1628621691873
  * ```
  *
+ * @public
  */
 export declare class GetPublicKeyCommand extends GetPublicKeyCommand_base {
     /** @internal type navigation helper, not in runtime. */

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

@@ -220,36 +220,24 @@ declare const ImportKeyMaterialCommand_base: {
  * @throws {@link KMSServiceException}
  * <p>Base exception class for all service exceptions from KMS service.</p>
  *
- * @public
- * @example To import key material into a KMS key
- * ```javascript
- * // The following example imports key material into the specified KMS key.
- * const input = {
- *   "EncryptedKeyMaterial": "<binary data>",
- *   "ExpirationModel": "KEY_MATERIAL_DOES_NOT_EXPIRE",
- *   "ImportToken": "<binary data>",
- *   "KeyId": "1234abcd-12ab-34cd-56ef-1234567890ab"
- * };
- * const command = new ImportKeyMaterialCommand(input);
- * await client.send(command);
- * // example id: to-import-key-material-into-a-kms-key-1
- * ```
  *
  * @example To import key material into a KMS key
  * ```javascript
- * // The following example imports key material that expires in 3 days. It might be part of an application that frequently reimports the same key material to comply with business rules or regulations.
+ * // The following example imports key material into the specified KMS key.
  * const input = {
- *   "EncryptedKeyMaterial": "<binary data>",
- *   "ExpirationModel": "KEY_MATERIAL_EXPIRES",
- *   "ImportToken": "<binary data>",
- *   "KeyId": "arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab",
- *   "ValidTo": "2023-09-30T00:00:00-00:00"
+ *   EncryptedKeyMaterial: "<binary data>",
+ *   ExpirationModel: "KEY_MATERIAL_DOES_NOT_EXPIRE",
+ *   ImportToken: "<binary data>",
+ *   KeyId: "1234abcd-12ab-34cd-56ef-1234567890ab"
  * };
  * const command = new ImportKeyMaterialCommand(input);
- * await client.send(command);
- * // example id: to-import-key-material-into-a-kms-key-2
+ * const response = await client.send(command);
+ * /* response is
+ * { /* metadata only *\/ }
+ * *\/
  * ```
  *
+ * @public
  */
 export declare class ImportKeyMaterialCommand extends ImportKeyMaterialCommand_base {
     /** @internal type navigation helper, not in runtime. */