@aws-sdk/client-kms 3.35.0 → 3.36.0

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

@@ -7,19 +7,20 @@ export interface EncryptCommandInput extends EncryptRequest {
 export interface EncryptCommandOutput extends EncryptResponse, __MetadataBearer {
 }
 /**
- * <p>Encrypts plaintext into ciphertext by using a KMS key. The
- *         <code>Encrypt</code> operation has two primary use cases:</p>
+ * <p>Encrypts plaintext into ciphertext by using a KMS key. The <code>Encrypt</code> operation
+ *       has two primary use cases:</p>
  *          <ul>
  *             <li>
  *                <p>You can encrypt small amounts of arbitrary data, such as a personal identifier or
  *           database password, or other sensitive information. </p>
  *             </li>
  *             <li>
- *                <p>You can use the <code>Encrypt</code> operation to move encrypted data from one Amazon Web Services Region to another. For example, in Region A, generate a data key and use the plaintext key to encrypt
- *           your data. Then, in Region A, use the <code>Encrypt</code> operation to encrypt the
- *           plaintext data key under a KMS key in Region B. Now, you can move the encrypted data and the
- *           encrypted data key to Region B. When necessary, you can decrypt the encrypted data key and
- *           the encrypted data entirely within in Region B.</p>
+ *                <p>You can use the <code>Encrypt</code> operation to move encrypted data from one Amazon Web Services
+ *           Region to another. For example, in Region A, generate a data key and use the plaintext key
+ *           to encrypt your data. Then, in Region A, use the <code>Encrypt</code> operation to encrypt
+ *           the plaintext data key under a KMS key in Region B. Now, you can move the encrypted data
+ *           and the encrypted data key to Region B. When necessary, you can decrypt the encrypted data
+ *           key and the encrypted data entirely within in Region B.</p>
  *             </li>
  *          </ul>
  *
@@ -30,10 +31,10 @@ export interface EncryptCommandOutput extends EncryptResponse, __MetadataBearer
  *       encryption operation. The KMS key must have a <code>KeyUsage</code> value of
  *         <code>ENCRYPT_DECRYPT.</code> To find the <code>KeyUsage</code> of a KMS key, use the <a>DescribeKey</a> operation. </p>
  *
- *          <p>If you use a symmetric KMS key, you can use an encryption context to add additional security
- *       to your encryption operation. If you specify an <code>EncryptionContext</code> when encrypting
- *       data, you must specify the same encryption context (a case-sensitive exact match) when
- *       decrypting the data. Otherwise, the request to decrypt fails with an
+ *          <p>If you use a symmetric KMS key, you can use an encryption context to add additional
+ *       security to your encryption operation. If you specify an <code>EncryptionContext</code> when
+ *       encrypting data, you must specify the same encryption context (a case-sensitive exact match)
+ *       when decrypting the data. Otherwise, the request to decrypt fails with an
  *         <code>InvalidCiphertextException</code>. For more information, see <a href="https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#encrypt_context">Encryption
  *         Context</a> in the <i>Key Management Service Developer Guide</i>.</p>
  *          <p>If you specify an asymmetric KMS key, you must also specify the encryption algorithm. The
@@ -105,7 +106,8 @@ export interface EncryptCommandOutput extends EncryptResponse, __MetadataBearer
  *          <p>The KMS key that you use for this operation must be in a compatible key state. For
  * details, see <a href="https://docs.aws.amazon.com/kms/latest/developerguide/key-state.html">Key state: Effect on your KMS key</a> in the <i>Key Management Service Developer Guide</i>.</p>
  *          <p>
- *             <b>Cross-account use</b>: Yes. To perform this operation with a KMS key in a different Amazon Web Services account, specify
+ *             <b>Cross-account use</b>: Yes.
+ *       To perform this operation with a KMS key in a different Amazon Web Services account, specify
  *   the key ARN or alias ARN in the value of the <code>KeyId</code> parameter.</p>
  *
  *          <p>

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

@@ -8,19 +8,19 @@ export interface GenerateDataKeyCommandOutput extends GenerateDataKeyResponse, _
 }
 /**
  * <p>Generates a unique symmetric data key for client-side encryption. This operation returns a
- *       plaintext copy of the data key and a copy that is encrypted under a KMS key
- *       that you specify. You can use the plaintext key to encrypt your data outside of KMS and
- *       store the encrypted data key with the encrypted data.</p>
+ *       plaintext copy of the data key and a copy that is encrypted under a KMS key that you specify.
+ *       You can use the plaintext key to encrypt your data outside of KMS and store the encrypted
+ *       data key with the encrypted data.</p>
  *
  *          <p>
  *             <code>GenerateDataKey</code> returns a unique data key for each request. The bytes in the
  *       plaintext key are not related to the caller or the KMS key.</p>
  *
- *          <p>To generate a data key, specify the symmetric KMS key that will be used to encrypt the data
- *       key. You cannot use an asymmetric KMS key to generate data keys. To get the type of your KMS key, use
- *       the <a>DescribeKey</a> operation. You must also specify the length of the data key.
- *       Use either the <code>KeySpec</code> or <code>NumberOfBytes</code> parameters (but not both).
- *       For 128-bit and 256-bit data keys, use the <code>KeySpec</code> parameter. </p>
+ *          <p>To generate a data key, specify the symmetric KMS key that will be used to encrypt the
+ *       data key. You cannot use an asymmetric KMS key to generate data keys. To get the type of your
+ *       KMS key, use the <a>DescribeKey</a> operation. You must also specify the length of
+ *       the data key. Use either the <code>KeySpec</code> or <code>NumberOfBytes</code> parameters
+ *       (but not both). For 128-bit and 256-bit data keys, use the <code>KeySpec</code> parameter. </p>
  *
  *          <p>To get only an encrypted copy of the data key, use <a>GenerateDataKeyWithoutPlaintext</a>. To generate an asymmetric data key pair, use
  *       the <a>GenerateDataKeyPair</a> or <a>GenerateDataKeyPairWithoutPlaintext</a> operation. To get a cryptographically secure
@@ -35,11 +35,14 @@ export interface GenerateDataKeyCommandOutput extends GenerateDataKeyResponse, _
  *          <p>The KMS key that you use for this operation must be in a compatible key state. For
  * details, see <a href="https://docs.aws.amazon.com/kms/latest/developerguide/key-state.html">Key state: Effect on your KMS key</a> in the <i>Key Management Service Developer Guide</i>.</p>
  *          <p>
- *             <b>How to use your data key</b>
+ *             <b>How to use your data
+ *         key</b>
  *          </p>
- *          <p>We recommend that you use the following pattern to encrypt data locally in your application.
- *       You can write your own code or use a client-side encryption library, such as the <a href="https://docs.aws.amazon.com/encryption-sdk/latest/developer-guide/">Amazon Web Services Encryption SDK</a>, the <a href="https://docs.aws.amazon.com/dynamodb-encryption-client/latest/devguide/">Amazon DynamoDB Encryption Client</a>, or
- *         <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingClientSideEncryption.html">Amazon S3
+ *          <p>We recommend that you use the following pattern to encrypt data locally in your
+ *       application. You can write your own code or use a client-side encryption library, such as the
+ *         <a href="https://docs.aws.amazon.com/encryption-sdk/latest/developer-guide/">Amazon Web Services Encryption SDK</a>, the
+ *         <a href="https://docs.aws.amazon.com/dynamodb-encryption-client/latest/devguide/">Amazon DynamoDB Encryption Client</a>,
+ *       or <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingClientSideEncryption.html">Amazon S3
  *         client-side encryption</a> to do these tasks for you.</p>
  *          <p>To encrypt data outside of KMS:</p>
  *          <ol>

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

@@ -9,20 +9,21 @@ export interface GenerateDataKeyPairCommandOutput extends GenerateDataKeyPairRes
 /**
  * <p>Generates a unique asymmetric data key pair. The <code>GenerateDataKeyPair</code>
  *       operation returns a plaintext public key, a plaintext private key, and a copy of the private
- *       key that is encrypted under the symmetric KMS key you specify. You can use the data key pair to
- *       perform asymmetric cryptography and implement digital signatures outside of KMS.</p>
+ *       key that is encrypted under the symmetric KMS key you specify. You can use the data key pair
+ *       to perform asymmetric cryptography and implement digital signatures outside of KMS.</p>
  *
  *          <p>You can use the public key that <code>GenerateDataKeyPair</code> returns to encrypt data
  *       or verify a signature outside of KMS. Then, store the encrypted private key with the data.
  *       When you are ready to decrypt data or sign a message, you can use the <a>Decrypt</a> operation to decrypt the encrypted private key.</p>
  *
- *          <p>To generate a data key pair, you must specify a symmetric KMS key to
- *       encrypt the private key in a data key pair. You cannot use an asymmetric KMS key or a KMS key in a
- *       custom key store. To get the type and origin of your KMS key, use the <a>DescribeKey</a> operation. </p>
+ *          <p>To generate a data key pair, you must specify a symmetric KMS key to encrypt the private
+ *       key in a data key pair. You cannot use an asymmetric KMS key or a KMS key in a custom key
+ *       store. To get the type and origin of your KMS key, use the <a>DescribeKey</a>
+ *       operation. </p>
  *          <p>Use the <code>KeyPairSpec</code> parameter to choose an RSA or Elliptic Curve (ECC) data
- *       key pair. KMS recommends that your use ECC key pairs for signing, and use RSA key pairs
- *       for either encryption or signing, but not both. However, KMS cannot enforce any restrictions
- *       on the use of data key pairs outside of KMS.</p>
+ *       key pair. KMS recommends that your use ECC key pairs for signing, and use RSA key pairs for
+ *       either encryption or signing, but not both. However, KMS cannot enforce any restrictions on
+ *       the use of data key pairs outside of KMS.</p>
  *
  *          <p>If you are using the data key pair to encrypt data, or for any operation where you don't
  *       immediately need a private key, consider using the <a>GenerateDataKeyPairWithoutPlaintext</a> operation.
@@ -34,10 +35,10 @@ export interface GenerateDataKeyPairCommandOutput extends GenerateDataKeyPairRes
  *
  *          <p>
  *             <code>GenerateDataKeyPair</code> returns a unique data key pair for each request. The
- *       bytes in the keys are not related to the caller or the KMS key that is used to encrypt the private
- *       key. The public key is a DER-encoded X.509 SubjectPublicKeyInfo, as specified in <a href="https://tools.ietf.org/html/rfc5280">RFC 5280</a>. The
- *       private key is a DER-encoded PKCS8 PrivateKeyInfo, as specified in <a href="https://tools.ietf.org/html/rfc5958">RFC
- *         5958</a>.</p>
+ *       bytes in the keys are not related to the caller or the KMS key that is used to encrypt the
+ *       private key. The public key is a DER-encoded X.509 SubjectPublicKeyInfo, as specified in
+ *         <a href="https://tools.ietf.org/html/rfc5280">RFC 5280</a>. The private key is a
+ *       DER-encoded PKCS8 PrivateKeyInfo, as specified in <a href="https://tools.ietf.org/html/rfc5958">RFC 5958</a>.</p>
  *
  *          <p>You can use the optional encryption context to add additional security to the encryption
  *       operation. If you specify an <code>EncryptionContext</code>, you must specify the same
@@ -47,7 +48,8 @@ export interface GenerateDataKeyPairCommandOutput extends GenerateDataKeyPairRes
  *          <p>The KMS key that you use for this operation must be in a compatible key state. For
  * details, see <a href="https://docs.aws.amazon.com/kms/latest/developerguide/key-state.html">Key state: Effect on your KMS key</a> in the <i>Key Management Service Developer Guide</i>.</p>
  *          <p>
- *             <b>Cross-account use</b>: Yes. To perform this operation with a KMS key in a different Amazon Web Services account, specify
+ *             <b>Cross-account
+ *         use</b>: Yes. To perform this operation with a KMS key in a different Amazon Web Services account, specify
  *   the key ARN or alias ARN in the value of the <code>KeyId</code> parameter.</p>
  *
  *          <p>

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

@@ -9,23 +9,24 @@ export interface GenerateDataKeyPairWithoutPlaintextCommandOutput extends Genera
 /**
  * <p>Generates a unique asymmetric data key pair. The
  *         <code>GenerateDataKeyPairWithoutPlaintext</code> operation returns a plaintext public key
- *       and a copy of the private key that is encrypted under the symmetric KMS key you specify. Unlike
- *         <a>GenerateDataKeyPair</a>, this operation does not return a plaintext private
- *       key. </p>
+ *       and a copy of the private key that is encrypted under the symmetric KMS key you specify.
+ *       Unlike <a>GenerateDataKeyPair</a>, this operation does not return a plaintext
+ *       private key. </p>
  *          <p>You can use the public key that <code>GenerateDataKeyPairWithoutPlaintext</code> returns
  *       to encrypt data or verify a signature outside of KMS. Then, store the encrypted private key
  *       with the data. When you are ready to decrypt data or sign a message, you can use the <a>Decrypt</a> operation to decrypt the encrypted private key.</p>
- *          <p>To generate a data key pair, you must specify a symmetric KMS key to
- *       encrypt the private key in a data key pair. You cannot use an asymmetric KMS key or a KMS key in a
- *       custom key store. To get the type and origin of your KMS key, use the <a>DescribeKey</a> operation. </p>
+ *          <p>To generate a data key pair, you must specify a symmetric KMS key to encrypt the private
+ *       key in a data key pair. You cannot use an asymmetric KMS key or a KMS key in a custom key
+ *       store. To get the type and origin of your KMS key, use the <a>DescribeKey</a>
+ *       operation. </p>
  *          <p>Use the <code>KeyPairSpec</code> parameter to choose an RSA or Elliptic Curve (ECC) data
- *       key pair. KMS recommends that your use ECC key pairs for signing, and use RSA key pairs
- *       for either encryption or signing, but not both. However, KMS cannot enforce any restrictions
- *       on the use of data key pairs outside of KMS.</p>
+ *       key pair. KMS recommends that your use ECC key pairs for signing, and use RSA key pairs for
+ *       either encryption or signing, but not both. However, KMS cannot enforce any restrictions on
+ *       the use of data key pairs outside of KMS.</p>
  *          <p>
  *             <code>GenerateDataKeyPairWithoutPlaintext</code> returns a unique data key pair for each
- *       request. The bytes in the key are not related to the caller or KMS key that is used to encrypt the
- *       private key. The public key is a DER-encoded X.509 SubjectPublicKeyInfo, as specified in
+ *       request. The bytes in the key are not related to the caller or KMS key that is used to encrypt
+ *       the private key. The public key is a DER-encoded X.509 SubjectPublicKeyInfo, as specified in
  *         <a href="https://tools.ietf.org/html/rfc5280">RFC 5280</a>.</p>
  *
  *          <p>You can use the optional encryption context to add additional security to the encryption
@@ -36,11 +37,13 @@ export interface GenerateDataKeyPairWithoutPlaintextCommandOutput extends Genera
  *          <p>The KMS key that you use for this operation must be in a compatible key state. For
  * details, see <a href="https://docs.aws.amazon.com/kms/latest/developerguide/key-state.html">Key state: Effect on your KMS key</a> in the <i>Key Management Service Developer Guide</i>.</p>
  *          <p>
- *             <b>Cross-account use</b>: Yes. To perform this operation with a KMS key in a different Amazon Web Services account, specify
+ *             <b>Cross-account
+ *         use</b>: Yes. To perform this operation with a KMS key in a different Amazon Web Services account, specify
  *   the key ARN or alias ARN in the value of the <code>KeyId</code> parameter.</p>
  *
  *          <p>
- *             <b>Required permissions</b>: <a href="https://docs.aws.amazon.com/kms/latest/developerguide/kms-api-permissions-reference.html">kms:GenerateDataKeyPairWithoutPlaintext</a> (key policy)</p>
+ *             <b>Required permissions</b>: <a href="https://docs.aws.amazon.com/kms/latest/developerguide/kms-api-permissions-reference.html">kms:GenerateDataKeyPairWithoutPlaintext</a> (key
+ *       policy)</p>
  *          <p>
  *             <b>Related operations:</b>
  *          </p>

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

@@ -8,8 +8,8 @@ export interface GenerateDataKeyWithoutPlaintextCommandOutput extends GenerateDa
 }
 /**
  * <p>Generates a unique symmetric data key. This operation returns a data key that is encrypted
- *       under a KMS key that you specify. To request an asymmetric data key pair,
- *       use the <a>GenerateDataKeyPair</a> or <a>GenerateDataKeyPairWithoutPlaintext</a> operations.</p>
+ *       under a KMS key that you specify. To request an asymmetric data key pair, use the <a>GenerateDataKeyPair</a> or <a>GenerateDataKeyPairWithoutPlaintext</a>
+ *       operations.</p>
  *          <p>
  *             <code>GenerateDataKeyWithoutPlaintext</code> is identical to the <a>GenerateDataKey</a> operation except that returns only the encrypted copy of the
  *       data key. This operation is useful for systems that need to encrypt data at some point, but
@@ -24,12 +24,12 @@ export interface GenerateDataKeyWithoutPlaintextCommandOutput extends GenerateDa
  *       plaintext data key.</p>
  *          <p>
  *             <code>GenerateDataKeyWithoutPlaintext</code> returns a unique data key for each request.
- *       The bytes in the keys are not related to the caller or KMS key that is used to encrypt the private
- *       key.</p>
+ *       The bytes in the keys are not related to the caller or KMS key that is used to encrypt the
+ *       private key.</p>
  *
- *          <p>To generate a data key, you must specify the symmetric KMS key that is
- *       used to encrypt the data key. You cannot use an asymmetric KMS key to generate a data key. To get
- *       the type of your KMS key, use the <a>DescribeKey</a> operation.</p>
+ *          <p>To generate a data key, you must specify the symmetric KMS key that is used to encrypt the
+ *       data key. You cannot use an asymmetric KMS key to generate a data key. To get the type of your
+ *       KMS key, use the <a>DescribeKey</a> operation.</p>
  *
  *          <p>If the operation succeeds, you will find the encrypted copy of the data key in the
  *         <code>CiphertextBlob</code> field.</p>
@@ -42,11 +42,13 @@ export interface GenerateDataKeyWithoutPlaintextCommandOutput extends GenerateDa
  *          <p>The KMS key that you use for this operation must be in a compatible key state. For
  * details, see <a href="https://docs.aws.amazon.com/kms/latest/developerguide/key-state.html">Key state: Effect on your KMS key</a> in the <i>Key Management Service Developer Guide</i>.</p>
  *          <p>
- *             <b>Cross-account use</b>: Yes. To perform this operation with a KMS key in a different Amazon Web Services account, specify
+ *             <b>Cross-account
+ *         use</b>: Yes. To perform this operation with a KMS key in a different Amazon Web Services account, specify
  *   the key ARN or alias ARN in the value of the <code>KeyId</code> parameter.</p>
  *
  *          <p>
- *             <b>Required permissions</b>: <a href="https://docs.aws.amazon.com/kms/latest/developerguide/kms-api-permissions-reference.html">kms:GenerateDataKeyWithoutPlaintext</a> (key policy)</p>
+ *             <b>Required permissions</b>: <a href="https://docs.aws.amazon.com/kms/latest/developerguide/kms-api-permissions-reference.html">kms:GenerateDataKeyWithoutPlaintext</a> (key
+ *       policy)</p>
  *          <p>
  *             <b>Related operations:</b>
  *          </p>

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

@@ -12,7 +12,8 @@ export interface GenerateRandomCommandOutput extends GenerateRandomResponse, __M
  *       the CloudHSM cluster that is associated with a <a href="https://docs.aws.amazon.com/kms/latest/developerguide/custom-key-store-overview.html">custom key store</a>, specify the custom key store
  *       ID.</p>
  *          <p>Applications in Amazon Web Services Nitro Enclaves can call this operation by using the <a href="https://github.com/aws/aws-nitro-enclaves-sdk-c">Amazon Web Services Nitro Enclaves Development Kit</a>. For information about the supporting parameters, see <a href="https://docs.aws.amazon.com/kms/latest/developerguide/services-nitro-enclaves.html">How Amazon Web Services Nitro Enclaves use KMS</a> in the <i>Key Management Service Developer Guide</i>.</p>
- *          <p>For more information about entropy and random number generation, see <a href="https://docs.aws.amazon.com/kms/latest/cryptographic-details/">Key Management Service Cryptographic Details</a>.</p>
+ *          <p>For more information about entropy and random number generation, see
+ *       <a href="https://docs.aws.amazon.com/kms/latest/cryptographic-details/">Key Management Service Cryptographic Details</a>.</p>
  *
  *          <p>
  *             <b>Required permissions</b>: <a href="https://docs.aws.amazon.com/kms/latest/developerguide/kms-api-permissions-reference.html">kms:GenerateRandom</a> (IAM policy)</p>

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

@@ -9,7 +9,8 @@ export interface GetKeyRotationStatusCommandOutput extends GetKeyRotationStatusR
 /**
  * <p>Gets a Boolean value that indicates whether <a href="https://docs.aws.amazon.com/kms/latest/developerguide/rotate-keys.html">automatic rotation of the key material</a> is
  *       enabled for the specified KMS key.</p>
- *          <p>You cannot enable automatic rotation of <a href="https://docs.aws.amazon.com/kms/latest/developerguide/symm-asymm-concepts.html#asymmetric-cmks">asymmetric KMS keys</a>, KMS keys with <a href="https://docs.aws.amazon.com/kms/latest/developerguide/importing-keys.html">imported key material</a>, or KMS keys in a <a href="https://docs.aws.amazon.com/kms/latest/developerguide/custom-key-store-overview.html">custom key store</a>. To enable or disable automatic rotation of a set of related <a href="https://docs.aws.amazon.com/kms/latest/developerguide/multi-region-keys-overview.html#mrk-replica-key">multi-Region keys</a>, set the property on the primary key. The key rotation status for these KMS keys is always <code>false</code>.</p>
+ *          <p>You cannot enable automatic rotation of <a href="https://docs.aws.amazon.com/kms/latest/developerguide/symm-asymm-concepts.html#asymmetric-cmks">asymmetric KMS keys</a>, KMS keys with <a href="https://docs.aws.amazon.com/kms/latest/developerguide/importing-keys.html">imported key material</a>, or KMS keys in a <a href="https://docs.aws.amazon.com/kms/latest/developerguide/custom-key-store-overview.html">custom key store</a>. To enable or disable automatic rotation of a set of related <a href="https://docs.aws.amazon.com/kms/latest/developerguide/multi-region-keys-overview.html#mrk-replica-key">multi-Region keys</a>, set the property on the primary key. The key rotation status for these KMS keys is always
+ *       <code>false</code>.</p>
  *          <p>The KMS key that you use for this operation must be in a compatible key state. For
  * details, see <a href="https://docs.aws.amazon.com/kms/latest/developerguide/key-state.html">Key state: Effect on your KMS key</a> in the <i>Key Management Service Developer Guide</i>.</p>
  *          <ul>

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

@@ -7,16 +7,15 @@ export interface GetParametersForImportCommandInput extends GetParametersForImpo
 export interface GetParametersForImportCommandOutput extends GetParametersForImportResponse, __MetadataBearer {
 }
 /**
- * <p>Returns the items you need to import key material into a symmetric, customer managed
- *       KMS key. For more information about importing key material into KMS, see
- *         <a href="https://docs.aws.amazon.com/kms/latest/developerguide/importing-keys.html">Importing Key
- *         Material</a> in the <i>Key Management Service Developer Guide</i>.</p>
+ * <p>Returns the items you need to import key material into a symmetric, customer managed KMS
+ *       key. For more information about importing key material into KMS, see <a href="https://docs.aws.amazon.com/kms/latest/developerguide/importing-keys.html">Importing Key Material</a>
+ *       in the <i>Key Management Service Developer Guide</i>.</p>
  *          <p>This operation returns a public key and an import token. Use the public key to encrypt the
  *       symmetric key material. Store the import token to send with a subsequent <a>ImportKeyMaterial</a> request.</p>
- *          <p>You must specify the key ID of the symmetric KMS key into which you will import key material.
- *       This KMS key's <code>Origin</code> must be <code>EXTERNAL</code>. You must also specify the
- *       wrapping algorithm and type of wrapping key (public key) that you will use to encrypt the key
- *       material. You cannot perform this operation on an asymmetric KMS key or on any KMS key in a different Amazon Web Services account.</p>
+ *          <p>You must specify the key ID of the symmetric KMS key into which you will import key
+ *       material. This KMS key's <code>Origin</code> must be <code>EXTERNAL</code>. You must also
+ *       specify the wrapping algorithm and type of wrapping key (public key) that you will use to
+ *       encrypt the key material. You cannot perform this operation on an asymmetric KMS key or on any KMS key in a different Amazon Web Services account.</p>
  *          <p>To import key material, you must use the public key and import token from the same
  *       response. These items are valid for 24 hours. The expiration date and time appear in the
  *         <code>GetParametersForImport</code> response. You cannot use an expired token in an <a>ImportKeyMaterial</a> request. If your key and token expire, send another

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

@@ -7,10 +7,11 @@ export interface GetPublicKeyCommandInput extends GetPublicKeyRequest {
 export interface GetPublicKeyCommandOutput extends GetPublicKeyResponse, __MetadataBearer {
 }
 /**
- * <p>Returns the public key of an asymmetric KMS key. Unlike the private key of a asymmetric KMS key,
- *       which never leaves KMS unencrypted, callers with <code>kms:GetPublicKey</code> permission
- *       can download the public key of an asymmetric KMS key. You can share the public key to allow others
- *       to encrypt messages and verify signatures outside of KMS. For information about symmetric and asymmetric KMS keys, see <a href="https://docs.aws.amazon.com/kms/latest/developerguide/symmetric-asymmetric.html">Using Symmetric and Asymmetric KMS keys</a> in the <i>Key Management Service Developer Guide</i>.</p>
+ * <p>Returns the public key of an asymmetric KMS key. Unlike the private key of a asymmetric
+ *       KMS key, which never leaves KMS unencrypted, callers with <code>kms:GetPublicKey</code>
+ *       permission can download the public key of an asymmetric KMS key. You can share the public key
+ *       to allow others to encrypt messages and verify signatures outside of KMS.
+ *       For information about symmetric and asymmetric KMS keys, see <a href="https://docs.aws.amazon.com/kms/latest/developerguide/symmetric-asymmetric.html">Using Symmetric and Asymmetric KMS keys</a> in the <i>Key Management Service Developer Guide</i>.</p>
  *          <p>You do not need to download the public key. Instead, you can use the public key within
  *       KMS by calling the <a>Encrypt</a>, <a>ReEncrypt</a>, or <a>Verify</a> operations with the identifier of an asymmetric KMS key. When you use the
  *       public key within KMS, you benefit from the authentication, authorization, and logging that
@@ -44,7 +45,8 @@ export interface GetPublicKeyCommandOutput extends GetPublicKeyResponse, __Metad
  *          <p>The KMS key that you use for this operation must be in a compatible key state. For
  * details, see <a href="https://docs.aws.amazon.com/kms/latest/developerguide/key-state.html">Key state: Effect on your KMS key</a> in the <i>Key Management Service Developer Guide</i>.</p>
  *          <p>
- *             <b>Cross-account use</b>: Yes. To perform this operation with a KMS key in a different Amazon Web Services account, specify
+ *             <b>Cross-account use</b>:
+ *       Yes. To perform this operation with a KMS key in a different Amazon Web Services account, specify
  *   the key ARN or alias ARN in the value of the <code>KeyId</code> parameter.</p>
  *
  *          <p>

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

@@ -7,12 +7,12 @@ export interface ImportKeyMaterialCommandInput extends ImportKeyMaterialRequest
 export interface ImportKeyMaterialCommandOutput extends ImportKeyMaterialResponse, __MetadataBearer {
 }
 /**
- * <p>Imports key material into an existing symmetric KMS KMS key that was
- *       created without key material. After you successfully import key material into a KMS key, you can
- *         <a href="https://docs.aws.amazon.com/kms/latest/developerguide/importing-keys.html#reimport-key-material">reimport the same key material</a> into that KMS key, but you cannot import different key
+ * <p>Imports key material into an existing symmetric KMS KMS key that was created without key
+ *       material. After you successfully import key material into a KMS key, you can <a href="https://docs.aws.amazon.com/kms/latest/developerguide/importing-keys.html#reimport-key-material">reimport
+ *         the same key material</a> into that KMS key, but you cannot import different key
  *       material. </p>
- *          <p>You cannot perform this operation on an asymmetric KMS key or on any KMS key in a different Amazon Web Services account. For more information about creating KMS keys with no key material and
- *       then importing key material, see <a href="https://docs.aws.amazon.com/kms/latest/developerguide/importing-keys.html">Importing Key Material</a> in the
+ *          <p>You cannot perform this operation on an asymmetric KMS key or on any KMS key in a different Amazon Web Services account. For more information about creating KMS keys with no key material
+ *       and then importing key material, see <a href="https://docs.aws.amazon.com/kms/latest/developerguide/importing-keys.html">Importing Key Material</a> in the
  *       <i>Key Management Service Developer Guide</i>.</p>
  *          <p>Before using this operation, call <a>GetParametersForImport</a>. Its response
  *       includes a public key and an import token. Use the public key to encrypt the key material.
@@ -21,8 +21,8 @@ export interface ImportKeyMaterialCommandOutput extends ImportKeyMaterialRespons
  *          <p>When calling this operation, you must specify the following values:</p>
  *          <ul>
  *             <li>
- *                <p>The key ID or key ARN of a KMS key with no key material. Its <code>Origin</code> must be
- *             <code>EXTERNAL</code>.</p>
+ *                <p>The key ID or key ARN of a KMS key with no key material. Its <code>Origin</code> must
+ *           be <code>EXTERNAL</code>.</p>
  *                <p>To create a KMS key with no key material, call <a>CreateKey</a> and set the
  *           value of its <code>Origin</code> parameter to <code>EXTERNAL</code>. To get the
  *             <code>Origin</code> of a KMS key, call <a>DescribeKey</a>.)</p>
@@ -37,17 +37,17 @@ export interface ImportKeyMaterialCommandOutput extends ImportKeyMaterialRespons
  *             </li>
  *             <li>
  *                <p>Whether the key material expires and if so, when. If you set an expiration date, KMS
- *           deletes the key material from the KMS key on the specified date, and the KMS key becomes unusable.
- *           To use the KMS key again, you must reimport the same key material. The only way to change an
- *           expiration date is by reimporting the same key material and specifying a new expiration
- *           date. </p>
+ *           deletes the key material from the KMS key on the specified date, and the KMS key becomes
+ *           unusable. To use the KMS key again, you must reimport the same key material. The only way
+ *           to change an expiration date is by reimporting the same key material and specifying a new
+ *           expiration date. </p>
  *             </li>
  *          </ul>
  *          <p>When this operation is successful, the key state of the KMS key changes from
  *         <code>PendingImport</code> to <code>Enabled</code>, and you can use the KMS key.</p>
  *          <p>If this operation fails, use the exception to help determine the problem. If the error is
- *       related to the key material, the import token, or wrapping key, use <a>GetParametersForImport</a> to get a new public key and import token for the KMS key and
- *       repeat the import procedure. For help, see <a href="https://docs.aws.amazon.com/kms/latest/developerguide/importing-keys.html#importing-keys-overview">How To Import Key
+ *       related to the key material, the import token, or wrapping key, use <a>GetParametersForImport</a> to get a new public key and import token for the KMS key
+ *       and repeat the import procedure. For help, see <a href="https://docs.aws.amazon.com/kms/latest/developerguide/importing-keys.html#importing-keys-overview">How To Import Key
  *         Material</a> in the <i>Key Management Service Developer Guide</i>.</p>
  *          <p>The KMS key that you use for this operation must be in a compatible key state. For
  * details, see <a href="https://docs.aws.amazon.com/kms/latest/developerguide/key-state.html">Key state: Effect on your KMS key</a> in the <i>Key Management Service Developer Guide</i>.</p>

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

@@ -7,26 +7,29 @@ export interface ListAliasesCommandInput extends ListAliasesRequest {
 export interface ListAliasesCommandOutput extends ListAliasesResponse, __MetadataBearer {
 }
 /**
- * <p>Gets a list of aliases in the caller's Amazon Web Services account and region. For more information about
- *       aliases, see <a>CreateAlias</a>.</p>
+ * <p>Gets a list of aliases in the caller's Amazon Web Services account and region. For more information
+ *       about aliases, see <a>CreateAlias</a>.</p>
  *          <p>By default, the <code>ListAliases</code> operation returns all aliases in the account and
- *       region. To get only the aliases associated with a particular KMS key, use
- *       the <code>KeyId</code> parameter.</p>
+ *       region. To get only the aliases associated with a particular KMS key, use the
+ *         <code>KeyId</code> parameter.</p>
  *          <p>The <code>ListAliases</code> response can include aliases that you created and associated
- *       with your customer managed keys, and aliases that Amazon Web Services created and associated with Amazon Web Services managed keys in your account. You can recognize Amazon Web Services aliases because their names have the format
- *         <code>aws/<service-name></code>, such as <code>aws/dynamodb</code>.</p>
+ *       with your customer managed keys, and aliases that Amazon Web Services created and associated with Amazon Web Services
+ *       managed keys in your account. You can recognize Amazon Web Services aliases because their names have the
+ *       format <code>aws/<service-name></code>, such as <code>aws/dynamodb</code>.</p>
  *          <p>The response might also include aliases that have no <code>TargetKeyId</code> field. These
- *       are predefined aliases that Amazon Web Services has created but has not yet associated with a KMS key. Aliases
- *       that Amazon Web Services creates in your account, including predefined aliases, do not count against your
- *         <a href="https://docs.aws.amazon.com/kms/latest/developerguide/limits.html#aliases-limit">KMS aliases
+ *       are predefined aliases that Amazon Web Services has created but has not yet associated with a KMS key.
+ *       Aliases that Amazon Web Services creates in your account, including predefined aliases, do not count against
+ *       your <a href="https://docs.aws.amazon.com/kms/latest/developerguide/limits.html#aliases-limit">KMS aliases
  *         quota</a>.</p>
  *          <p>
  *             <b>Cross-account use</b>: No. <code>ListAliases</code> does not
  *       return aliases in other Amazon Web Services accounts.</p>
  *
+ *
  *          <p>
  *             <b>Required permissions</b>: <a href="https://docs.aws.amazon.com/kms/latest/developerguide/kms-api-permissions-reference.html">kms:ListAliases</a> (IAM policy)</p>
- *          <p>For details, see <a href="https://docs.aws.amazon.com/kms/latest/developerguide/kms-alias.html#alias-access">Controlling access to aliases</a> in the <i>Key Management Service Developer Guide</i>.</p>
+ *          <p>For details, see <a href="https://docs.aws.amazon.com/kms/latest/developerguide/kms-alias.html#alias-access">Controlling access to aliases</a> in the
+ *       <i>Key Management Service Developer Guide</i>.</p>
  *          <p>
  *             <b>Related operations:</b>
  *          </p>

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

@@ -8,8 +8,8 @@ export interface ListGrantsCommandOutput extends ListGrantsResponse, __MetadataB
 }
 /**
  * <p>Gets a list of all grants for the specified KMS key. </p>
- *          <p>You must specify the KMS key in all requests. You can filter the grant list by grant ID
- *       or grantee principal.</p>
+ *          <p>You must specify the KMS key in all requests. You can filter the grant list by grant ID or
+ *       grantee principal.</p>
  *          <p>For detailed information about grants, including grant terminology, see <a href="https://docs.aws.amazon.com/kms/latest/developerguide/grants.html">Using grants</a> in the
  *         <i>
  *                <i>Key Management Service Developer Guide</i>

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

@@ -7,9 +7,9 @@ export interface ListKeyPoliciesCommandInput extends ListKeyPoliciesRequest {
 export interface ListKeyPoliciesCommandOutput extends ListKeyPoliciesResponse, __MetadataBearer {
 }
 /**
- * <p>Gets the names of the key policies that are attached to a KMS key. This
- *       operation is designed to get policy names that you can use in a <a>GetKeyPolicy</a>
- *       operation. However, the only valid policy name is <code>default</code>. </p>
+ * <p>Gets the names of the key policies that are attached to a KMS key. This operation is
+ *       designed to get policy names that you can use in a <a>GetKeyPolicy</a> operation.
+ *       However, the only valid policy name is <code>default</code>. </p>
  *          <p>
  *             <b>Cross-account use</b>: No. You cannot perform this operation on a KMS key in a different Amazon Web Services account.</p>
  *

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

@@ -7,8 +7,7 @@ export interface ListKeysCommandInput extends ListKeysRequest {
 export interface ListKeysCommandOutput extends ListKeysResponse, __MetadataBearer {
 }
 /**
- * <p>Gets a list of all KMS keys in the caller's Amazon Web Services account and
- *       Region.</p>
+ * <p>Gets a list of all KMS keys in the caller's Amazon Web Services account and Region.</p>
  *          <p>
  *             <b>Cross-account use</b>: No. You cannot perform this operation on a KMS key in a different Amazon Web Services account.</p>
  *

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

@@ -7,11 +7,11 @@ export interface ListRetirableGrantsCommandInput extends ListRetirableGrantsRequ
 export interface ListRetirableGrantsCommandOutput extends ListGrantsResponse, __MetadataBearer {
 }
 /**
- * <p>Returns information about all grants in the Amazon Web Services account and Region that have the specified
- *       retiring principal. </p>
+ * <p>Returns information about all grants in the Amazon Web Services account and Region that have the
+ *       specified retiring principal. </p>
  *          <p>You can specify any principal in your Amazon Web Services account. The grants that are returned include
- *       grants for KMS keys in your Amazon Web Services account and other Amazon Web Services accounts. You might use this operation to
- *       determine which grants you may retire. To retire a grant, use the <a>RetireGrant</a> operation.</p>
+ *       grants for KMS keys in your Amazon Web Services account and other Amazon Web Services accounts. You might use this
+ *       operation to determine which grants you may retire. To retire a grant, use the <a>RetireGrant</a> operation.</p>
  *          <p>For detailed information about grants, including grant terminology, see <a href="https://docs.aws.amazon.com/kms/latest/developerguide/grants.html">Using grants</a> in the
  *         <i>
  *                <i>Key Management Service Developer Guide</i>
@@ -20,11 +20,12 @@ export interface ListRetirableGrantsCommandOutput extends ListGrantsResponse, __
  *          <p>
  *             <b>Cross-account use</b>: You must specify a principal in your
  *       Amazon Web Services account. However, this operation can return grants in any Amazon Web Services account. You do not need
- *       <code>kms:ListRetirableGrants</code> permission (or any other additional permission) in any
+ *         <code>kms:ListRetirableGrants</code> permission (or any other additional permission) in any
  *       Amazon Web Services account other than your own.</p>
  *
  *          <p>
- *             <b>Required permissions</b>: <a href="https://docs.aws.amazon.com/kms/latest/developerguide/kms-api-permissions-reference.html">kms:ListRetirableGrants</a> (IAM policy) in your Amazon Web Services account.</p>
+ *             <b>Required permissions</b>: <a href="https://docs.aws.amazon.com/kms/latest/developerguide/kms-api-permissions-reference.html">kms:ListRetirableGrants</a> (IAM policy) in your
+ *       Amazon Web Services account.</p>
  *          <p>
  *             <b>Related operations:</b>
  *          </p>