Binds an existing alias to a different customer master key (CMK) ID.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes UpdateAlias

The operation that you want to perform. Set the value to UpdateAlias.

KeyId String Yes 1234abcd-12ab-34cd-56ef-12345678****

The ID of the CMK. The ID must be globally unique.

AliasName String Yes alias/example

The alias that you want to bind.

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

Response parameters

Parameter Type Example Description
RequestId String 1d2baaf3-d357-46c2-832e-13560c2bd9cd

The ID of the request, which is used to locate and troubleshoot issues.

Examples

Sample requests

http(s)://[Endpoint]/?Action=UpdateAlias
&KeyId=1234abcd-12ab-34cd-56ef-12345678****
&AliasName=alias/example
&<Common request parameters>

Sample success responses

XML format 

HTTP/1.1 200 OK
Content-Type:application/xml

<UpdateAliasResponse>
    <RequestId>1d2baaf3-d357-46c2-832e-13560c2bd9cd</RequestId>
</UpdateAliasResponse>

JSON format 

HTTP/1.1 200 OK
Content-Type:application/json

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

Error codes

For a list of error codes, visit the API Error Center.