HEX
Server: Apache
System: Linux vmi1259262.contaboserver.net 5.15.0-170-generic #180-Ubuntu SMP Fri Jan 9 16:10:31 UTC 2026 x86_64
User: aqarnomics (1008)
PHP: 8.1.34
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*.