All Products
Search

This Product

    Key Management Service:UpdateAlias

    Document Center

    Key Management Service:UpdateAlias

    Last Updated:Aug 28, 2026

    Binds an existing alias to a different CMK.

    Operation description

    For information about the RAM permissions required to call this operation, see Resource Access Management.

    Try it now

    Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

    Test

    RAM authorization

    No authorization for this operation. If you encounter issues with this operation, contact technical support.

    Request parameters

    Parameter

    Type

    Required

    Description

    Example
    KeyId

    string

    Yes

    The globally unique ID of the CMK.

    1234abcd-12ab-34cd-56ef-12345678****
    AliasName

    string

    Yes

    The alias to bind to the specified CMK.

    The value must be 1 to 255 characters in length and include the alias/ prefix.

    alias/example

    Response elements

    Element

    Type

    Description

    Example

    object

    RequestId

    string

    The request ID.

    1d2baaf3-d357-46c2-832e-13560c2bd9cd

    Examples

    Success response

    JSON format

    {
  "RequestId": "1d2baaf3-d357-46c2-832e-13560c2bd9cd"
}

    Error codes

    See Error Codes for a complete list.

    Release notes

    See Release Notes for a complete list.