HEX
Server: Apache
System: Linux pdx1-shared-a1-38 6.6.104-grsec-jammy+ #3 SMP Tue Sep 16 00:28:11 UTC 2025 x86_64
User: mmickelson (3396398)
PHP: 8.1.31
Disabled: NONE
Upload Files
File: //usr/share/doc/awscli/examples/kms/update-alias.rst
**To associate an alias with a different CMK**

The following ``update-alias`` example associates the alias ``alias/test-key`` with a different CMK.

* The ``--alias-name`` parameter specifies the alias. The alias name value must begin with ``alias/``. 
* The ``--target-key-id`` parameter specifies the CMK to associate with the alias. You don't need to specify the current CMK for the alias. ::

    aws kms update-alias \
        --alias-name alias/test-key \
        --target-key-id 1234abcd-12ab-34cd-56ef-1234567890ab

This command produces no output. To find the alias, use the ``list-aliases`` command.

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*.