/** * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved. * SPDX-License-Identifier: Apache-2.0. */ #pragma once #include #include #include #include #include #include #include namespace Aws { namespace KMS { namespace Model { /** */ class AWS_KMS_API GenerateDataKeyWithoutPlaintextRequest : public KMSRequest { public: GenerateDataKeyWithoutPlaintextRequest(); // Service request name is the Operation name which will send this request out, // each operation should has unique request name, so that we can get operation's name from this request. // Note: this is not true for response, multiple operations may have the same response name, // so we can not get operation's name from response. inline virtual const char* GetServiceRequestName() const override { return "GenerateDataKeyWithoutPlaintext"; } Aws::String SerializePayload() const override; Aws::Http::HeaderValueCollection GetRequestSpecificHeaders() const override; /** *

The identifier of the symmetric customer master key (CMK) that encrypts the * data key.

To specify a CMK, use its key ID, Amazon Resource Name (ARN), * alias name, or alias ARN. When using an alias name, prefix it with * "alias/". To specify a CMK in a different AWS account, you must use * the key ARN or alias ARN.

For example:

  • Key ID: * 1234abcd-12ab-34cd-56ef-1234567890ab

  • Key ARN: * arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab *

  • Alias name: alias/ExampleAlias

  • *

    Alias ARN: arn:aws:kms:us-east-2:111122223333:alias/ExampleAlias *

To get the key ID and key ARN for a CMK, use ListKeys * or DescribeKey. To get the alias name and alias ARN, use * ListAliases.

*/ inline const Aws::String& GetKeyId() const{ return m_keyId; } /** *

The identifier of the symmetric customer master key (CMK) that encrypts the * data key.

To specify a CMK, use its key ID, Amazon Resource Name (ARN), * alias name, or alias ARN. When using an alias name, prefix it with * "alias/". To specify a CMK in a different AWS account, you must use * the key ARN or alias ARN.

For example:

  • Key ID: * 1234abcd-12ab-34cd-56ef-1234567890ab

  • Key ARN: * arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab *

  • Alias name: alias/ExampleAlias

  • *

    Alias ARN: arn:aws:kms:us-east-2:111122223333:alias/ExampleAlias *

To get the key ID and key ARN for a CMK, use ListKeys * or DescribeKey. To get the alias name and alias ARN, use * ListAliases.

*/ inline bool KeyIdHasBeenSet() const { return m_keyIdHasBeenSet; } /** *

The identifier of the symmetric customer master key (CMK) that encrypts the * data key.

To specify a CMK, use its key ID, Amazon Resource Name (ARN), * alias name, or alias ARN. When using an alias name, prefix it with * "alias/". To specify a CMK in a different AWS account, you must use * the key ARN or alias ARN.

For example:

  • Key ID: * 1234abcd-12ab-34cd-56ef-1234567890ab

  • Key ARN: * arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab *

  • Alias name: alias/ExampleAlias

  • *

    Alias ARN: arn:aws:kms:us-east-2:111122223333:alias/ExampleAlias *

To get the key ID and key ARN for a CMK, use ListKeys * or DescribeKey. To get the alias name and alias ARN, use * ListAliases.

*/ inline void SetKeyId(const Aws::String& value) { m_keyIdHasBeenSet = true; m_keyId = value; } /** *

The identifier of the symmetric customer master key (CMK) that encrypts the * data key.

To specify a CMK, use its key ID, Amazon Resource Name (ARN), * alias name, or alias ARN. When using an alias name, prefix it with * "alias/". To specify a CMK in a different AWS account, you must use * the key ARN or alias ARN.

For example:

  • Key ID: * 1234abcd-12ab-34cd-56ef-1234567890ab

  • Key ARN: * arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab *

  • Alias name: alias/ExampleAlias

  • *

    Alias ARN: arn:aws:kms:us-east-2:111122223333:alias/ExampleAlias *

To get the key ID and key ARN for a CMK, use ListKeys * or DescribeKey. To get the alias name and alias ARN, use * ListAliases.

*/ inline void SetKeyId(Aws::String&& value) { m_keyIdHasBeenSet = true; m_keyId = std::move(value); } /** *

The identifier of the symmetric customer master key (CMK) that encrypts the * data key.

To specify a CMK, use its key ID, Amazon Resource Name (ARN), * alias name, or alias ARN. When using an alias name, prefix it with * "alias/". To specify a CMK in a different AWS account, you must use * the key ARN or alias ARN.

For example:

  • Key ID: * 1234abcd-12ab-34cd-56ef-1234567890ab

  • Key ARN: * arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab *

  • Alias name: alias/ExampleAlias

  • *

    Alias ARN: arn:aws:kms:us-east-2:111122223333:alias/ExampleAlias *

To get the key ID and key ARN for a CMK, use ListKeys * or DescribeKey. To get the alias name and alias ARN, use * ListAliases.

*/ inline void SetKeyId(const char* value) { m_keyIdHasBeenSet = true; m_keyId.assign(value); } /** *

The identifier of the symmetric customer master key (CMK) that encrypts the * data key.

To specify a CMK, use its key ID, Amazon Resource Name (ARN), * alias name, or alias ARN. When using an alias name, prefix it with * "alias/". To specify a CMK in a different AWS account, you must use * the key ARN or alias ARN.

For example:

  • Key ID: * 1234abcd-12ab-34cd-56ef-1234567890ab

  • Key ARN: * arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab *

  • Alias name: alias/ExampleAlias

  • *

    Alias ARN: arn:aws:kms:us-east-2:111122223333:alias/ExampleAlias *

To get the key ID and key ARN for a CMK, use ListKeys * or DescribeKey. To get the alias name and alias ARN, use * ListAliases.

*/ inline GenerateDataKeyWithoutPlaintextRequest& WithKeyId(const Aws::String& value) { SetKeyId(value); return *this;} /** *

The identifier of the symmetric customer master key (CMK) that encrypts the * data key.

To specify a CMK, use its key ID, Amazon Resource Name (ARN), * alias name, or alias ARN. When using an alias name, prefix it with * "alias/". To specify a CMK in a different AWS account, you must use * the key ARN or alias ARN.

For example:

  • Key ID: * 1234abcd-12ab-34cd-56ef-1234567890ab

  • Key ARN: * arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab *

  • Alias name: alias/ExampleAlias

  • *

    Alias ARN: arn:aws:kms:us-east-2:111122223333:alias/ExampleAlias *

To get the key ID and key ARN for a CMK, use ListKeys * or DescribeKey. To get the alias name and alias ARN, use * ListAliases.

*/ inline GenerateDataKeyWithoutPlaintextRequest& WithKeyId(Aws::String&& value) { SetKeyId(std::move(value)); return *this;} /** *

The identifier of the symmetric customer master key (CMK) that encrypts the * data key.

To specify a CMK, use its key ID, Amazon Resource Name (ARN), * alias name, or alias ARN. When using an alias name, prefix it with * "alias/". To specify a CMK in a different AWS account, you must use * the key ARN or alias ARN.

For example:

  • Key ID: * 1234abcd-12ab-34cd-56ef-1234567890ab

  • Key ARN: * arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab *

  • Alias name: alias/ExampleAlias

  • *

    Alias ARN: arn:aws:kms:us-east-2:111122223333:alias/ExampleAlias *

To get the key ID and key ARN for a CMK, use ListKeys * or DescribeKey. To get the alias name and alias ARN, use * ListAliases.

*/ inline GenerateDataKeyWithoutPlaintextRequest& WithKeyId(const char* value) { SetKeyId(value); return *this;} /** *

Specifies the encryption context that will be used when encrypting the data * key.

An encryption context is a collection of non-secret key-value * pairs that represents additional authenticated data. When you use an encryption * context to encrypt data, you must specify the same (an exact case-sensitive * match) encryption context to decrypt the data. An encryption context is optional * when encrypting with a symmetric CMK, but it is highly recommended.

For * more information, see Encryption * Context in the AWS Key Management Service Developer Guide.

*/ inline const Aws::Map& GetEncryptionContext() const{ return m_encryptionContext; } /** *

Specifies the encryption context that will be used when encrypting the data * key.

An encryption context is a collection of non-secret key-value * pairs that represents additional authenticated data. When you use an encryption * context to encrypt data, you must specify the same (an exact case-sensitive * match) encryption context to decrypt the data. An encryption context is optional * when encrypting with a symmetric CMK, but it is highly recommended.

For * more information, see Encryption * Context in the AWS Key Management Service Developer Guide.

*/ inline bool EncryptionContextHasBeenSet() const { return m_encryptionContextHasBeenSet; } /** *

Specifies the encryption context that will be used when encrypting the data * key.

An encryption context is a collection of non-secret key-value * pairs that represents additional authenticated data. When you use an encryption * context to encrypt data, you must specify the same (an exact case-sensitive * match) encryption context to decrypt the data. An encryption context is optional * when encrypting with a symmetric CMK, but it is highly recommended.

For * more information, see Encryption * Context in the AWS Key Management Service Developer Guide.

*/ inline void SetEncryptionContext(const Aws::Map& value) { m_encryptionContextHasBeenSet = true; m_encryptionContext = value; } /** *

Specifies the encryption context that will be used when encrypting the data * key.

An encryption context is a collection of non-secret key-value * pairs that represents additional authenticated data. When you use an encryption * context to encrypt data, you must specify the same (an exact case-sensitive * match) encryption context to decrypt the data. An encryption context is optional * when encrypting with a symmetric CMK, but it is highly recommended.

For * more information, see Encryption * Context in the AWS Key Management Service Developer Guide.

*/ inline void SetEncryptionContext(Aws::Map&& value) { m_encryptionContextHasBeenSet = true; m_encryptionContext = std::move(value); } /** *

Specifies the encryption context that will be used when encrypting the data * key.

An encryption context is a collection of non-secret key-value * pairs that represents additional authenticated data. When you use an encryption * context to encrypt data, you must specify the same (an exact case-sensitive * match) encryption context to decrypt the data. An encryption context is optional * when encrypting with a symmetric CMK, but it is highly recommended.

For * more information, see Encryption * Context in the AWS Key Management Service Developer Guide.

*/ inline GenerateDataKeyWithoutPlaintextRequest& WithEncryptionContext(const Aws::Map& value) { SetEncryptionContext(value); return *this;} /** *

Specifies the encryption context that will be used when encrypting the data * key.

An encryption context is a collection of non-secret key-value * pairs that represents additional authenticated data. When you use an encryption * context to encrypt data, you must specify the same (an exact case-sensitive * match) encryption context to decrypt the data. An encryption context is optional * when encrypting with a symmetric CMK, but it is highly recommended.

For * more information, see Encryption * Context in the AWS Key Management Service Developer Guide.

*/ inline GenerateDataKeyWithoutPlaintextRequest& WithEncryptionContext(Aws::Map&& value) { SetEncryptionContext(std::move(value)); return *this;} /** *

Specifies the encryption context that will be used when encrypting the data * key.

An encryption context is a collection of non-secret key-value * pairs that represents additional authenticated data. When you use an encryption * context to encrypt data, you must specify the same (an exact case-sensitive * match) encryption context to decrypt the data. An encryption context is optional * when encrypting with a symmetric CMK, but it is highly recommended.

For * more information, see Encryption * Context in the AWS Key Management Service Developer Guide.

*/ inline GenerateDataKeyWithoutPlaintextRequest& AddEncryptionContext(const Aws::String& key, const Aws::String& value) { m_encryptionContextHasBeenSet = true; m_encryptionContext.emplace(key, value); return *this; } /** *

Specifies the encryption context that will be used when encrypting the data * key.

An encryption context is a collection of non-secret key-value * pairs that represents additional authenticated data. When you use an encryption * context to encrypt data, you must specify the same (an exact case-sensitive * match) encryption context to decrypt the data. An encryption context is optional * when encrypting with a symmetric CMK, but it is highly recommended.

For * more information, see Encryption * Context in the AWS Key Management Service Developer Guide.

*/ inline GenerateDataKeyWithoutPlaintextRequest& AddEncryptionContext(Aws::String&& key, const Aws::String& value) { m_encryptionContextHasBeenSet = true; m_encryptionContext.emplace(std::move(key), value); return *this; } /** *

Specifies the encryption context that will be used when encrypting the data * key.

An encryption context is a collection of non-secret key-value * pairs that represents additional authenticated data. When you use an encryption * context to encrypt data, you must specify the same (an exact case-sensitive * match) encryption context to decrypt the data. An encryption context is optional * when encrypting with a symmetric CMK, but it is highly recommended.

For * more information, see Encryption * Context in the AWS Key Management Service Developer Guide.

*/ inline GenerateDataKeyWithoutPlaintextRequest& AddEncryptionContext(const Aws::String& key, Aws::String&& value) { m_encryptionContextHasBeenSet = true; m_encryptionContext.emplace(key, std::move(value)); return *this; } /** *

Specifies the encryption context that will be used when encrypting the data * key.

An encryption context is a collection of non-secret key-value * pairs that represents additional authenticated data. When you use an encryption * context to encrypt data, you must specify the same (an exact case-sensitive * match) encryption context to decrypt the data. An encryption context is optional * when encrypting with a symmetric CMK, but it is highly recommended.

For * more information, see Encryption * Context in the AWS Key Management Service Developer Guide.

*/ inline GenerateDataKeyWithoutPlaintextRequest& AddEncryptionContext(Aws::String&& key, Aws::String&& value) { m_encryptionContextHasBeenSet = true; m_encryptionContext.emplace(std::move(key), std::move(value)); return *this; } /** *

Specifies the encryption context that will be used when encrypting the data * key.

An encryption context is a collection of non-secret key-value * pairs that represents additional authenticated data. When you use an encryption * context to encrypt data, you must specify the same (an exact case-sensitive * match) encryption context to decrypt the data. An encryption context is optional * when encrypting with a symmetric CMK, but it is highly recommended.

For * more information, see Encryption * Context in the AWS Key Management Service Developer Guide.

*/ inline GenerateDataKeyWithoutPlaintextRequest& AddEncryptionContext(const char* key, Aws::String&& value) { m_encryptionContextHasBeenSet = true; m_encryptionContext.emplace(key, std::move(value)); return *this; } /** *

Specifies the encryption context that will be used when encrypting the data * key.

An encryption context is a collection of non-secret key-value * pairs that represents additional authenticated data. When you use an encryption * context to encrypt data, you must specify the same (an exact case-sensitive * match) encryption context to decrypt the data. An encryption context is optional * when encrypting with a symmetric CMK, but it is highly recommended.

For * more information, see Encryption * Context in the AWS Key Management Service Developer Guide.

*/ inline GenerateDataKeyWithoutPlaintextRequest& AddEncryptionContext(Aws::String&& key, const char* value) { m_encryptionContextHasBeenSet = true; m_encryptionContext.emplace(std::move(key), value); return *this; } /** *

Specifies the encryption context that will be used when encrypting the data * key.

An encryption context is a collection of non-secret key-value * pairs that represents additional authenticated data. When you use an encryption * context to encrypt data, you must specify the same (an exact case-sensitive * match) encryption context to decrypt the data. An encryption context is optional * when encrypting with a symmetric CMK, but it is highly recommended.

For * more information, see Encryption * Context in the AWS Key Management Service Developer Guide.

*/ inline GenerateDataKeyWithoutPlaintextRequest& AddEncryptionContext(const char* key, const char* value) { m_encryptionContextHasBeenSet = true; m_encryptionContext.emplace(key, value); return *this; } /** *

The length of the data key. Use AES_128 to generate a 128-bit * symmetric key, or AES_256 to generate a 256-bit symmetric key.

*/ inline const DataKeySpec& GetKeySpec() const{ return m_keySpec; } /** *

The length of the data key. Use AES_128 to generate a 128-bit * symmetric key, or AES_256 to generate a 256-bit symmetric key.

*/ inline bool KeySpecHasBeenSet() const { return m_keySpecHasBeenSet; } /** *

The length of the data key. Use AES_128 to generate a 128-bit * symmetric key, or AES_256 to generate a 256-bit symmetric key.

*/ inline void SetKeySpec(const DataKeySpec& value) { m_keySpecHasBeenSet = true; m_keySpec = value; } /** *

The length of the data key. Use AES_128 to generate a 128-bit * symmetric key, or AES_256 to generate a 256-bit symmetric key.

*/ inline void SetKeySpec(DataKeySpec&& value) { m_keySpecHasBeenSet = true; m_keySpec = std::move(value); } /** *

The length of the data key. Use AES_128 to generate a 128-bit * symmetric key, or AES_256 to generate a 256-bit symmetric key.

*/ inline GenerateDataKeyWithoutPlaintextRequest& WithKeySpec(const DataKeySpec& value) { SetKeySpec(value); return *this;} /** *

The length of the data key. Use AES_128 to generate a 128-bit * symmetric key, or AES_256 to generate a 256-bit symmetric key.

*/ inline GenerateDataKeyWithoutPlaintextRequest& WithKeySpec(DataKeySpec&& value) { SetKeySpec(std::move(value)); return *this;} /** *

The length of the data key in bytes. For example, use the value 64 to * generate a 512-bit data key (64 bytes is 512 bits). For common key lengths * (128-bit and 256-bit symmetric keys), we recommend that you use the * KeySpec field instead of this one.

*/ inline int GetNumberOfBytes() const{ return m_numberOfBytes; } /** *

The length of the data key in bytes. For example, use the value 64 to * generate a 512-bit data key (64 bytes is 512 bits). For common key lengths * (128-bit and 256-bit symmetric keys), we recommend that you use the * KeySpec field instead of this one.

*/ inline bool NumberOfBytesHasBeenSet() const { return m_numberOfBytesHasBeenSet; } /** *

The length of the data key in bytes. For example, use the value 64 to * generate a 512-bit data key (64 bytes is 512 bits). For common key lengths * (128-bit and 256-bit symmetric keys), we recommend that you use the * KeySpec field instead of this one.

*/ inline void SetNumberOfBytes(int value) { m_numberOfBytesHasBeenSet = true; m_numberOfBytes = value; } /** *

The length of the data key in bytes. For example, use the value 64 to * generate a 512-bit data key (64 bytes is 512 bits). For common key lengths * (128-bit and 256-bit symmetric keys), we recommend that you use the * KeySpec field instead of this one.

*/ inline GenerateDataKeyWithoutPlaintextRequest& WithNumberOfBytes(int value) { SetNumberOfBytes(value); return *this;} /** *

A list of grant tokens.

For more information, see Grant * Tokens in the AWS Key Management Service Developer Guide.

*/ inline const Aws::Vector& GetGrantTokens() const{ return m_grantTokens; } /** *

A list of grant tokens.

For more information, see Grant * Tokens in the AWS Key Management Service Developer Guide.

*/ inline bool GrantTokensHasBeenSet() const { return m_grantTokensHasBeenSet; } /** *

A list of grant tokens.

For more information, see Grant * Tokens in the AWS Key Management Service Developer Guide.

*/ inline void SetGrantTokens(const Aws::Vector& value) { m_grantTokensHasBeenSet = true; m_grantTokens = value; } /** *

A list of grant tokens.

For more information, see Grant * Tokens in the AWS Key Management Service Developer Guide.

*/ inline void SetGrantTokens(Aws::Vector&& value) { m_grantTokensHasBeenSet = true; m_grantTokens = std::move(value); } /** *

A list of grant tokens.

For more information, see Grant * Tokens in the AWS Key Management Service Developer Guide.

*/ inline GenerateDataKeyWithoutPlaintextRequest& WithGrantTokens(const Aws::Vector& value) { SetGrantTokens(value); return *this;} /** *

A list of grant tokens.

For more information, see Grant * Tokens in the AWS Key Management Service Developer Guide.

*/ inline GenerateDataKeyWithoutPlaintextRequest& WithGrantTokens(Aws::Vector&& value) { SetGrantTokens(std::move(value)); return *this;} /** *

A list of grant tokens.

For more information, see Grant * Tokens in the AWS Key Management Service Developer Guide.

*/ inline GenerateDataKeyWithoutPlaintextRequest& AddGrantTokens(const Aws::String& value) { m_grantTokensHasBeenSet = true; m_grantTokens.push_back(value); return *this; } /** *

A list of grant tokens.

For more information, see Grant * Tokens in the AWS Key Management Service Developer Guide.

*/ inline GenerateDataKeyWithoutPlaintextRequest& AddGrantTokens(Aws::String&& value) { m_grantTokensHasBeenSet = true; m_grantTokens.push_back(std::move(value)); return *this; } /** *

A list of grant tokens.

For more information, see Grant * Tokens in the AWS Key Management Service Developer Guide.

*/ inline GenerateDataKeyWithoutPlaintextRequest& AddGrantTokens(const char* value) { m_grantTokensHasBeenSet = true; m_grantTokens.push_back(value); return *this; } private: Aws::String m_keyId; bool m_keyIdHasBeenSet; Aws::Map m_encryptionContext; bool m_encryptionContextHasBeenSet; DataKeySpec m_keySpec; bool m_keySpecHasBeenSet; int m_numberOfBytes; bool m_numberOfBytesHasBeenSet; Aws::Vector m_grantTokens; bool m_grantTokensHasBeenSet; }; } // namespace Model } // namespace KMS } // namespace Aws