调用CreateAlias接口给主密钥(CMK)创建一个别名。

创建别名时,请关注以下注意事项:

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

调试

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

请求参数

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

要执行的操作,取值:CreateAlias。

AliasName String alias/example

要操作的别名。

长度为1~255个字符,必须包含前缀alias/

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

CMK的全局唯一标识符。

返回数据

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

本次请求的ID。

示例

请求示例

https://kms.cn-hangzhou.aliyuncs.com/?Action=CreateAlias
&KeyId=<cmkid>
&AliasName=<alias/example>
&<公共请求参数>

正常返回示例

XML 格式

//xml response
<KMS>
        <RequestId>1d2baaf3-d357-46c2-832e-13560c2bd9cd</RequestId>
</KMS>

JSON 格式

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

错误码

HttpCode 错误码 错误信息 描述
400 Throttling Request was denied due to request throttling. 您这个时段的流量已经超限。如果不能满足现有业务要求可以提工单进行申请。

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