@aws-sdk/client-kms 3.28.0 → 3.32.0

package/commands/GenerateDataKeyCommand.ts

@@ -22,16 +22,16 @@ 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 customer master key (CMK)
- *       that you specify. You can use the plaintext key to encrypt your data outside of AWS KMS and
+ *       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 CMK.</p>
+ *       plaintext key are not related to the caller or the KMS key.</p>
  *
- *          <p>To generate a data key, specify the symmetric CMK that will be used to encrypt the data
- *       key. You cannot use an asymmetric CMK to generate data keys. To get the type of your CMK, use
+ *          <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>
@@ -44,45 +44,44 @@ export interface GenerateDataKeyCommandOutput extends GenerateDataKeyResponse, _
  *       operation. If you specify an <code>EncryptionContext</code>, you must specify the same
  *       encryption context (a case-sensitive exact match) when decrypting the encrypted data key.
  *       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>AWS Key Management Service Developer Guide</i>.</p>
- *          <p>The CMK 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 CMK</a> in the <i>AWS Key Management Service Developer Guide</i>.</p>
+ *       <i>Key Management Service Developer Guide</i>.</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>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/">AWS Encryption SDK</a>, the <a href="https://docs.aws.amazon.com/dynamodb-encryption-client/latest/devguide/">Amazon DynamoDB Encryption Client</a>, or
+ *          <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 AWS KMS:</p>
+ *          <p>To encrypt data outside of KMS:</p>
  *          <ol>
  *             <li>
  *                <p>Use the <code>GenerateDataKey</code> operation to get a data key.</p>
  *             </li>
  *             <li>
  *                <p>Use the plaintext data key (in the <code>Plaintext</code> field of the response) to
- *           encrypt your data outside of AWS KMS. Then erase the plaintext data key from memory.</p>
+ *           encrypt your data outside of KMS. Then erase the plaintext data key from memory.</p>
  *             </li>
  *             <li>
  *                <p>Store the encrypted data key (in the <code>CiphertextBlob</code> field of the
  *           response) with the encrypted data.</p>
  *             </li>
  *          </ol>
- *          <p>To decrypt data outside of AWS KMS:</p>
+ *          <p>To decrypt data outside of KMS:</p>
  *          <ol>
  *             <li>
  *                <p>Use the <a>Decrypt</a> operation to decrypt the encrypted data key. The
  *           operation returns a plaintext copy of the data key.</p>
  *             </li>
  *             <li>
- *                <p>Use the plaintext data key to decrypt data outside of AWS KMS, then erase the plaintext
+ *                <p>Use the plaintext data key to decrypt data outside of KMS, then erase the plaintext
  *           data key from memory.</p>
  *             </li>
  *          </ol>
  *          <p>
- *             <b>Cross-account use</b>: Yes. To perform this operation with a CMK in a different AWS 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/commands/GenerateDataKeyPairCommand.ts

@@ -23,21 +23,20 @@ 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 CMK you specify. You can use the data key pair to
- *       perform asymmetric cryptography outside of AWS KMS.</p>
- *
- *          <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 CMK that is used to encrypt the private
- *       key.</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 AWS KMS. Then, store the encrypted private key with the 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 customer master key (CMK) to
- *       encrypt the private key in a data key pair. You cannot use an asymmetric CMK or a CMK in a
- *       custom key store. To get the type and origin of your CMK, 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>
  *
  *          <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.
@@ -47,15 +46,22 @@ export interface GenerateDataKeyPairCommandOutput extends GenerateDataKeyPairRes
  *       the <a>Decrypt</a> operation to decrypt the encrypted private key in the data key
  *       pair.</p>
  *
+ *          <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>
+ *
  *          <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
  *       encryption context (a case-sensitive exact match) when decrypting the encrypted data key.
  *       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>AWS Key Management Service Developer Guide</i>.</p>
- *          <p>The CMK 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 CMK</a> in the <i>AWS Key Management Service Developer Guide</i>.</p>
+ *       <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>
  *          <p>
- *             <b>Cross-account use</b>: Yes. To perform this operation with a CMK in a different AWS 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/commands/GenerateDataKeyPairWithoutPlaintextCommand.ts

@@ -28,30 +28,34 @@ export interface GenerateDataKeyPairWithoutPlaintextCommandOutput
 /**
  * <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 CMK you specify. Unlike
+ *       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>To generate a data key pair, you must specify a symmetric customer master key (CMK) to
- *       encrypt the private key in the data key pair. You cannot use an asymmetric CMK or a CMK in a
- *       custom key store. To get the type and origin of your CMK, use the <code>KeySpec</code> field
- *       in the <a>DescribeKey</a> response.</p>
  *          <p>You can use the public key that <code>GenerateDataKeyPairWithoutPlaintext</code> returns
- *       to encrypt data or verify a signature outside of AWS KMS. Then, store the encrypted private key
+ *       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>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>
  *          <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 CMK that is used to encrypt the
- *       private key.</p>
+ *       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
  *       operation. If you specify an <code>EncryptionContext</code>, you must specify the same
  *       encryption context (a case-sensitive exact match) when decrypting the encrypted data key.
  *       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>AWS Key Management Service Developer Guide</i>.</p>
- *          <p>The CMK 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 CMK</a> in the <i>AWS Key Management Service Developer Guide</i>.</p>
+ *       <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>
  *          <p>
- *             <b>Cross-account use</b>: Yes. To perform this operation with a CMK in a different AWS 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/commands/GenerateDataKeyWithoutPlaintextCommand.ts

@@ -24,7 +24,7 @@ export interface GenerateDataKeyWithoutPlaintextCommandOutput
 
 /**
  * <p>Generates a unique symmetric data key. This operation returns a data key that is encrypted
- *       under a customer master key (CMK) that you specify. To request an asymmetric data key pair,
+ *       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
@@ -40,12 +40,12 @@ export interface GenerateDataKeyWithoutPlaintextCommandOutput
  *       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 CMK that is used to encrypt the private
+ *       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 customer master key (CMK) that is
- *       used to encrypt the data key. You cannot use an asymmetric CMK to generate a data key. To get
- *       the type of your CMK, 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>
@@ -54,11 +54,11 @@ export interface GenerateDataKeyWithoutPlaintextCommandOutput
  *       operation. If you specify an <code>EncryptionContext</code>, you must specify the same
  *       encryption context (a case-sensitive exact match) when decrypting the encrypted data key.
  *       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>AWS Key Management Service Developer Guide</i>.</p>
- *          <p>The CMK 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 CMK</a> in the <i>AWS Key Management Service Developer Guide</i>.</p>
+ *       <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>
  *          <p>
- *             <b>Cross-account use</b>: Yes. To perform this operation with a CMK in a different AWS 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/commands/GenerateRandomCommand.ts

@@ -22,10 +22,11 @@ export interface GenerateRandomCommandOutput extends GenerateRandomResponse, __M
 
 /**
  * <p>Returns a random byte string that is cryptographically secure.</p>
- *          <p>By default, the random byte string is generated in AWS KMS. To generate the byte string in
- *       the AWS 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
+ *          <p>By default, the random byte string is generated in KMS. To generate the byte string in
+ *       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>For more information about entropy and random number generation, see <a href="https://docs.aws.amazon.com/kms/latest/cryptographic-details/">AWS Key Management Service Cryptographic Details</a>.</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>
  *             <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/commands/GetKeyPolicyCommand.ts

@@ -21,9 +21,9 @@ export interface GetKeyPolicyCommandInput extends GetKeyPolicyRequest {}
 export interface GetKeyPolicyCommandOutput extends GetKeyPolicyResponse, __MetadataBearer {}
 
 /**
- * <p>Gets a key policy attached to the specified customer master key (CMK).</p>
+ * <p>Gets a key policy attached to the specified KMS key.</p>
  *          <p>
- *             <b>Cross-account use</b>: No. You cannot perform this operation on a CMK in a different AWS account.</p>
+ *             <b>Cross-account use</b>: No. You cannot perform this operation on a KMS key in a different Amazon Web Services account.</p>
  *
  *          <p>
  *             <b>Required permissions</b>: <a href="https://docs.aws.amazon.com/kms/latest/developerguide/kms-api-permissions-reference.html">kms:GetKeyPolicy</a> (key policy)</p>

package/commands/GetKeyRotationStatusCommand.ts

@@ -22,23 +22,23 @@ 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 customer master key (CMK).</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 CMKs</a>, CMKs with <a href="https://docs.aws.amazon.com/kms/latest/developerguide/importing-keys.html">imported key material</a>, or CMKs 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 CMKs is always <code>false</code>.</p>
- *          <p>The CMK 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 CMK</a> in the <i>AWS Key Management Service Developer Guide</i>.</p>
+ *       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>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>
  *             <li>
- *                <p>Disabled: The key rotation status does not change when you disable a CMK. However,
- *           while the CMK is disabled, AWS KMS does not rotate the backing key.</p>
+ *                <p>Disabled: The key rotation status does not change when you disable a KMS key. However,
+ *           while the KMS key is disabled, KMS does not rotate the key material.</p>
  *             </li>
  *             <li>
- *                <p>Pending deletion: While a CMK is pending deletion, its key rotation status is
- *             <code>false</code> and AWS KMS does not rotate the backing key. If you cancel the
+ *                <p>Pending deletion: While a KMS key is pending deletion, its key rotation status is
+ *             <code>false</code> and KMS does not rotate the key material. If you cancel the
  *           deletion, the original key rotation status is restored.</p>
  *             </li>
  *          </ul>
  *          <p>
- *             <b>Cross-account use</b>: Yes. To perform this operation on a CMK in a different AWS account, specify the key
+ *             <b>Cross-account use</b>: Yes. To perform this operation on a KMS key in a different Amazon Web Services account, specify the key
  *   ARN in the value of the <code>KeyId</code> parameter.</p>
  *
  *          <p>

package/commands/GetParametersForImportCommand.ts

@@ -22,23 +22,23 @@ export interface GetParametersForImportCommandOutput extends GetParametersForImp
 
 /**
  * <p>Returns the items you need to import key material into a symmetric, customer managed
- *       customer master key (CMK). For more information about importing key material into AWS KMS, see
+ *       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>AWS Key Management Service Developer Guide</i>.</p>
+ *         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 CMK into which you will import key material.
- *       This CMK's <code>Origin</code> must be <code>EXTERNAL</code>. You must also specify the
+ *          <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 CMK or on any CMK in a different AWS account.</p>
+ *       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
  *         <code>GetParametersForImport</code> request.</p>
- *          <p>The CMK 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 CMK</a> in the <i>AWS 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>
  *          <p>
- *             <b>Cross-account use</b>: No. You cannot perform this operation on a CMK in a different AWS account.</p>
+ *             <b>Cross-account use</b>: No. You cannot perform this operation on a KMS key in a different Amazon Web Services account.</p>
  *
  *          <p>
  *             <b>Required permissions</b>: <a href="https://docs.aws.amazon.com/kms/latest/developerguide/kms-api-permissions-reference.html">kms:GetParametersForImport</a> (key policy)</p>

package/commands/GetPublicKeyCommand.ts

@@ -21,22 +21,22 @@ export interface GetPublicKeyCommandInput extends GetPublicKeyRequest {}
 export interface GetPublicKeyCommandOutput extends GetPublicKeyResponse, __MetadataBearer {}
 
 /**
- * <p>Returns the public key of an asymmetric CMK. Unlike the private key of a asymmetric CMK,
- *       which never leaves AWS KMS unencrypted, callers with <code>kms:GetPublicKey</code> permission
- *       can download the public key of an asymmetric CMK. You can share the public key to allow others
- *       to encrypt messages and verify signatures outside of AWS KMS. For information about symmetric and asymmetric CMKs, see <a href="https://docs.aws.amazon.com/kms/latest/developerguide/symmetric-asymmetric.html">Using Symmetric and Asymmetric CMKs</a> in the <i>AWS 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
- *       AWS KMS by calling the <a>Encrypt</a>, <a>ReEncrypt</a>, or <a>Verify</a> operations with the identifier of an asymmetric CMK. When you use the
- *       public key within AWS KMS, you benefit from the authentication, authorization, and logging that
- *       are part of every AWS KMS operation. You also reduce of risk of encrypting data that cannot be
- *       decrypted. These features are not effective outside of AWS KMS. For details, see <a href="https://docs.aws.amazon.com/kms/latest/developerguide/download-public-key.html#download-public-key-considerations">Special
+ *       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
+ *       are part of every KMS operation. You also reduce of risk of encrypting data that cannot be
+ *       decrypted. These features are not effective outside of KMS. For details, see <a href="https://docs.aws.amazon.com/kms/latest/developerguide/download-public-key.html#download-public-key-considerations">Special
  *         Considerations for Downloading Public Keys</a>.</p>
- *          <p>To help you use the public key safely outside of AWS KMS, <code>GetPublicKey</code> returns
+ *          <p>To help you use the public key safely outside of KMS, <code>GetPublicKey</code> returns
  *       important information about the public key in the response, including:</p>
  *          <ul>
  *             <li>
  *                <p>
- *                   <a href="https://docs.aws.amazon.com/kms/latest/APIReference/API_GetPublicKey.html#KMS-GetPublicKey-response-CustomerMasterKeySpec">CustomerMasterKeySpec</a>: The type of key material in the public key, such as
+ *                   <a href="https://docs.aws.amazon.com/kms/latest/APIReference/API_GetPublicKey.html#KMS-GetPublicKey-response-KeySpec">KeySpec</a>: The type of key material in the public key, such as
  *             <code>RSA_4096</code> or <code>ECC_NIST_P521</code>.</p>
  *             </li>
  *             <li>
@@ -49,16 +49,16 @@ export interface GetPublicKeyCommandOutput extends GetPublicKeyResponse, __Metad
  *           algorithms for the key.</p>
  *             </li>
  *          </ul>
- *          <p>Although AWS KMS cannot enforce these restrictions on external operations, it is crucial
+ *          <p>Although KMS cannot enforce these restrictions on external operations, it is crucial
  *       that you use this information to prevent the public key from being used improperly. For
  *       example, you can prevent a public signing key from being used encrypt data, or prevent a
- *       public key from being used with an encryption algorithm that is not supported by AWS KMS. You
+ *       public key from being used with an encryption algorithm that is not supported by KMS. You
  *       can also avoid errors, such as using the wrong signing algorithm in a verification
  *       operation.</p>
- *          <p>The CMK 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 CMK</a> in the <i>AWS 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>
  *          <p>
- *             <b>Cross-account use</b>: Yes. To perform this operation with a CMK in a different AWS 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/commands/ImportKeyMaterialCommand.ts

@@ -21,13 +21,13 @@ export interface ImportKeyMaterialCommandInput extends ImportKeyMaterialRequest
 export interface ImportKeyMaterialCommandOutput extends ImportKeyMaterialResponse, __MetadataBearer {}
 
 /**
- * <p>Imports key material into an existing symmetric AWS KMS customer master key (CMK) that was
- *       created without key material. After you successfully import key material into a CMK, 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 CMK, 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 CMK or on any CMK in a different AWS account. For more information about creating CMKs with no key material and
+ *          <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>AWS Key Management Service Developer Guide</i>.</p>
+ *       <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.
  *       Then, submit the import token from the same <code>GetParametersForImport</code>
@@ -35,11 +35,11 @@ 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 CMK with no key material. Its <code>Origin</code> must be
+ *                <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 CMK with no key material, call <a>CreateKey</a> and set the
+ *                <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 CMK, call <a>DescribeKey</a>.)</p>
+ *             <code>Origin</code> of a KMS key, call <a>DescribeKey</a>.)</p>
  *             </li>
  *             <li>
  *                <p>The encrypted key material. To get the public key to encrypt the key material, call
@@ -50,23 +50,23 @@ export interface ImportKeyMaterialCommandOutput extends ImportKeyMaterialRespons
  *           a public key and token from the same <code>GetParametersForImport</code> response.</p>
  *             </li>
  *             <li>
- *                <p>Whether the key material expires and if so, when. If you set an expiration date, AWS KMS
- *           deletes the key material from the CMK on the specified date, and the CMK becomes unusable.
- *           To use the CMK again, you must reimport the same key material. The only way to change an
+ *                <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>
  *             </li>
  *          </ul>
- *          <p>When this operation is successful, the key state of the CMK changes from
- *         <code>PendingImport</code> to <code>Enabled</code>, and you can use the CMK.</p>
+ *          <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 CMK and
+ *       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>AWS Key Management Service Developer Guide</i>.</p>
- *          <p>The CMK 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 CMK</a> in the <i>AWS Key Management Service Developer Guide</i>.</p>
+ *         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>
  *          <p>
- *             <b>Cross-account use</b>: No. You cannot perform this operation on a CMK in a different AWS account.</p>
+ *             <b>Cross-account use</b>: No. You cannot perform this operation on a KMS key in a different Amazon Web Services account.</p>
  *
  *          <p>
  *             <b>Required permissions</b>: <a href="https://docs.aws.amazon.com/kms/latest/developerguide/kms-api-permissions-reference.html">kms:ImportKeyMaterial</a> (key policy)</p>

package/commands/ListAliasesCommand.ts

@@ -21,28 +21,26 @@ export interface ListAliasesCommandInput extends ListAliasesRequest {}
 export interface ListAliasesCommandOutput extends ListAliasesResponse, __MetadataBearer {}
 
 /**
- * <p>Gets a list of aliases in the caller's AWS account and region. For more information about
+ * <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 customer master key (CMK), use
+ *       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 CMKs, and aliases that AWS created and associated with AWS managed
- *       CMKs in your account. You can recognize AWS aliases because their names have the format
+ *       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 AWS has created but has not yet associated with a CMK. Aliases
- *       that AWS 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">AWS 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 AWS accounts.</p>
- *
+ *       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>AWS 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/commands/ListGrantsCommand.ts

@@ -21,18 +21,23 @@ export interface ListGrantsCommandInput extends ListGrantsRequest {}
 export interface ListGrantsCommandOutput extends ListGrantsResponse, __MetadataBearer {}
 
 /**
- * <p>Gets a list of all grants for the specified customer master key (CMK). </p>
- *          <p>You must specify the CMK in all requests. You can filter the grant list by grant ID
+ * <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>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>
+ *             </i>. For examples of working with grants in several
+ *       programming languages, see <a href="https://docs.aws.amazon.com/kms/latest/developerguide/programming-grants.html">Programming grants</a>. </p>
  *          <note>
  *             <p>The <code>GranteePrincipal</code> field in the <code>ListGrants</code> response usually contains the
  *         user or role designated as the grantee principal in the grant. However, when the grantee
- *         principal in the grant is an AWS service, the <code>GranteePrincipal</code> field contains
+ *         principal in the grant is an Amazon Web Services service, the <code>GranteePrincipal</code> field contains
  *         the <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_principal.html#principal-services">service
  *           principal</a>, which might represent several different grantee principals.</p>
  *          </note>
  *          <p>
- *             <b>Cross-account use</b>: Yes. To perform this operation on a CMK in a different AWS account, specify the key
+ *             <b>Cross-account use</b>: Yes. To perform this operation on a KMS key in a different Amazon Web Services account, specify the key
  *   ARN in the value of the <code>KeyId</code> parameter.</p>
  *
  *          <p>

package/commands/ListKeyPoliciesCommand.ts

@@ -21,11 +21,11 @@ export interface ListKeyPoliciesCommandInput extends ListKeyPoliciesRequest {}
 export interface ListKeyPoliciesCommandOutput extends ListKeyPoliciesResponse, __MetadataBearer {}
 
 /**
- * <p>Gets the names of the key policies that are attached to a customer master key (CMK). This
+ * <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 CMK in a different AWS account.</p>
+ *             <b>Cross-account use</b>: No. You cannot perform this operation on a KMS key in a different Amazon Web Services account.</p>
  *
  *          <p>
  *             <b>Required permissions</b>: <a href="https://docs.aws.amazon.com/kms/latest/developerguide/kms-api-permissions-reference.html">kms:ListKeyPolicies</a> (key policy)</p>

package/commands/ListKeysCommand.ts

@@ -18,10 +18,10 @@ export interface ListKeysCommandInput extends ListKeysRequest {}
 export interface ListKeysCommandOutput extends ListKeysResponse, __MetadataBearer {}
 
 /**
- * <p>Gets a list of all customer master keys (CMKs) in the caller's AWS account and
+ * <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 CMK in a different AWS account.</p>
+ *             <b>Cross-account use</b>: No. You cannot perform this operation on a KMS key in a different Amazon Web Services account.</p>
  *
  *          <p>
  *             <b>Required permissions</b>: <a href="https://docs.aws.amazon.com/kms/latest/developerguide/kms-api-permissions-reference.html">kms:ListKeys</a> (IAM policy)</p>