HEX
Server: LiteSpeed
System: Linux s3604.bom1.stableserver.net 4.18.0-513.11.1.lve.el8.x86_64 #1 SMP Thu Jan 18 16:21:02 UTC 2024 x86_64
User: dmstechonline (1480)
PHP: 7.4.33
Disabled: NONE
Upload Files
File: //usr/lib/python3.6/site-packages/awscli/examples/kms/list-aliases.rst
**Example 1: To list all aliases in an AWS account and Region**

The following example uses the ``list-aliases`` command to list all aliases in the default Region of the AWS account. The output includes aliases associated with AWS managed CMKs and customer managed CMKs. ::

    aws kms list-aliases

Output::

    {
        "Aliases": [
            {
                "AliasArn": "arn:aws:kms:us-west-2:111122223333:alias/testKey",
                "AliasName": "alias/testKey",
                "TargetKeyId": "1234abcd-12ab-34cd-56ef-1234567890ab"
            },
            {
                "AliasArn": "arn:aws:kms:us-west-2:111122223333:alias/FinanceDept",
                "AliasName": "alias/FinanceDept",
                "TargetKeyId": "0987dcba-09fe-87dc-65ba-ab0987654321"
            },
            {
                "AliasArn": "arn:aws:kms:us-west-2:111122223333:alias/aws/dynamodb",
                "AliasName": "alias/aws/dynamodb",
                "TargetKeyId": "1a2b3c4d-5e6f-1a2b-3c4d-5e6f1a2b3c4d"
            },
            {
                "AliasArn": "arn:aws:kms:us-west-2:111122223333:alias/aws/ebs",
                "AliasName": "alias/aws/ebs",
                "TargetKeyId": "0987ab65-43cd-21ef-09ab-87654321cdef"
            },
            ...
        ]
    }

**Example 2: To list all aliases for a particular CMK**

The following example uses the ``list-aliases`` command and its ``key-id`` parameter to list all aliases that are associated with a particular CMK.

Each alias is associated with only one CMK, but a CMK can have multiple aliases. This command is very useful because the AWS KMS console lists only one alias for each CMK. To find all aliases for a CMK, you must use the ``list-aliases`` command.

This example uses the key ID of the CMK for the ``--key-id`` parameter, but you can use a key ID, key ARN, alias name, or alias ARN in this command. ::

    aws kms list-aliases --key-id 1234abcd-12ab-34cd-56ef-1234567890ab

Output::

    {
        "Aliases": [
            {
                "TargetKeyId": "1234abcd-12ab-34cd-56ef-1234567890ab",
                "AliasArn": "arn:aws:kms:us-west-2:111122223333:alias/oregon-test-key",
                "AliasName": "alias/oregon-test-key"
            },
            {
                "TargetKeyId": "1234abcd-12ab-34cd-56ef-1234567890ab",
                "AliasArn": "arn:aws:kms:us-west-2:111122223333:alias/project121-test",
                "AliasName": "alias/project121-test"
            }
        ]
    }

For more information, see `Working with Aliases <https://docs.aws.amazon.com/kms/latest/developerguide/programming-aliases.html>`__ in the *AWS Key Management Service Developer Guide*.