调用UpdateKeyDescription接口更新主密钥的描述信息。
将主密钥(CMK)的描述信息(DescribeKey接口中的Description属性)替换为用户传入的值。使用此API可以对密钥的描述信息进行添加、变更、删除操作。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 |
类型 |
是否必选 |
示例值 |
描述 |
Action | String | 是 | UpdateKeyDescription | 要执行的操作。取值:UpdateKeyDescription。 |
KeyId | String | 是 | 1234abcd-12ab-34cd-56ef-12345678**** | 密钥ID。主密钥的全局唯一标识符。 |
Description | String | 是 | key description example | 主密钥的描述性信息。通常用于描述主密钥的用途,例如主密钥保护的数据类型、可使用主密钥的应用等。 |
返回数据
名称 |
类型 |
示例值 |
描述 |
RequestId | String | 3455b9b4-95c1-419d-b310-db6a53b09a39 | 本次调用请求的ID,是由阿里云为该请求生成的唯一标识符,可用于排查和定位问题。 |
示例
请求示例
http(s)://[Endpoint]/?Action=UpdateKeyDescription
&KeyId=1234abcd-12ab-34cd-56ef-12345678****
&Description=key description example
&公共请求参数
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<UpdateKeyDescriptionResponse>
<RequestId>3455b9b4-95c1-419d-b310-db6a53b09a39</RequestId>
</UpdateKeyDescriptionResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "3455b9b4-95c1-419d-b310-db6a53b09a39"
}
错误码
访问错误中心查看更多错误码。