You are viewing documentation for version 2 of the AWS SDK for Ruby. Version 3 documentation can be found here.

Class: Aws::KMS::Types::DescribeKeyRequest

  • Object
show all
Defined in:



When passing DescribeKeyRequest as input to an Aws::Client method, you can use a vanilla Hash:

  key_id: "KeyIdType", # required
  grant_tokens: ["GrantTokenType"],

Instance Attribute Summary collapse

Instance Attribute Details


A list of grant tokens.

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


  • (Array<String>)

    A list of grant tokens.


Describes the specified customer master key (CMK).

If you specify a predefined AWS alias (an AWS alias with no key ID), KMS associates the alias with an AWS managed CMK and returns its KeyId and Arn in the response.

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.


  • (String)

    Describes the specified customer master key (CMK).