调用CreateAlias接口为主密钥（CMK）创建一个别名。

使用说明：

  • 每个别名只能表示一个CMK。
  • 同一地域内的CMK别名必须唯一。

本文将提供一个示例，为密钥7906979c-8e06-46a2-be2d-68e3ccbc****创建名为alias/example的别名。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 CreateAlias

要执行的操作。取值：CreateAlias。

KeyId String 是 7906979c-8e06-46a2-be2d-68e3ccbc****

CMK的全局唯一标识符。
AliasName String 是 alias/example

CMK的别名名称。

长度为1~255个字符，必须包含前缀alias/，但不能以alias/acs保留字为前缀。

返回数据

名称 类型 示例值 描述
RequestId String 1d2baaf3-d357-46c2-832e-13560c2bd9cd

本次调用请求的ID，是由阿里云为该请求生成的唯一标识符，可用于排查和定位问题。

示例

请求示例

http(s)://[Endpoint]/?Action=CreateAlias
&KeyId=7906979c-8e06-46a2-be2d-68e3ccbc****
&AliasName=alias/example
&公共请求参数

正常返回示例

XML格式 

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

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

JSON格式 

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

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

错误码

访问错误中心查看更多错误码。