CreateAlias - 给主密钥(CMK)创建一个别名

为主密钥(CMK)创建一个别名。

接口说明

  • RAM 用户或 RAM 角色调用该 OpenAPI 需要被授予的权限策略详情,请参见访问控制

  • 每个别名只能表示一个 CMK。

  • 同一地域内的 CMK 别名必须唯一。

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

调试

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

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
KeyIdstring

CMK 的全局唯一标识符。

7906979c-8e06-46a2-be2d-68e3ccbc****
AliasNamestring

CMK 的别名名称。
长度为 1~255 个字符,必须包含前缀alias/,但不能以alias/acs保留字为前缀。

alias/example

返回参数

名称类型描述示例值
object
RequestIdstring

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

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

示例

正常返回示例

JSON格式

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

错误码

HTTP status code错误码错误信息描述
400InvalidParameterThe specified parameter is not valid.参数非法。
404InvalidAccessKeyId.NotFoundThe Access Key ID provided does not exist in our records.-
404Forbidden.KeyNotFoundThe specified Key is not found.指定的密钥不存在。

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