为主密钥(CMK)创建一个别名。
接口说明
-
RAM 用户或 RAM 角色调用该 OpenAPI 需要被授予的权限策略详情,请参见访问控制。
-
每个别名只能表示一个 CMK。
-
同一地域内的 CMK 别名必须唯一。
本文将提供一个示例,为密钥7906979c-8e06-46a2-be2d-68e3ccbc****创建名为alias/example的别名。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
当前API暂无授权信息透出。
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| KeyId | string | 是 | CMK 的全局唯一标识符。 | 7906979c-8e06-46a2-be2d-68e3ccbc**** |
| AliasName | string | 是 | CMK 的别名名称。 | alias/example |
返回参数
示例
正常返回示例
JSON格式
{
"RequestId": "1d2baaf3-d357-46c2-832e-13560c2bd9cd"
}错误码
| HTTP status code | 错误码 | 错误信息 | 描述 |
|---|---|---|---|
| 400 | InvalidParameter | The specified parameter is not valid. | 参数非法。 |
| 404 | InvalidAccessKeyId.NotFound | The Access Key ID provided does not exist in our records. | - |
| 404 | Forbidden.KeyNotFound | The specified Key is not found. | 指定的密钥不存在。 |
访问错误中心查看更多错误码。
