CreateKeyVersion
更新時(shí)間:
為密鑰創(chuàng)建新的密鑰版本。
- 僅軟件密鑰管理實(shí)例中的對(duì)稱密鑰支持創(chuàng)建密鑰版本,且密鑰狀態(tài)必須處于啟用中。您可以調(diào)用DescribeKey 接口查詢密鑰狀態(tài)。
- 每創(chuàng)建一個(gè)密鑰版本,就會(huì)消耗一個(gè)密鑰額度。
本文將提供一個(gè)示例,為密鑰ID為key-hzz62f1cb66fa42qo****
的密鑰創(chuàng)建密鑰版本。
調(diào)試
您可以在OpenAPI Explorer中直接運(yùn)行該接口,免去您計(jì)算簽名的困擾。運(yùn)行成功后,OpenAPI Explorer可以自動(dòng)生成SDK代碼示例。
請(qǐng)求參數(shù)
名稱 |
類型 |
是否必選 |
示例值 |
描述 |
Action | String | 是 | CreateKeyVersion | 要執(zhí)行的操作。取值:CreateKeyVersion。 |
KeyId | String | 是 | key-hzz62f1cb66fa42qo*** | 密鑰ID,即密鑰的全局唯一標(biāo)識(shí)符。 |
返回?cái)?shù)據(jù)
名稱 |
類型 |
示例值 |
描述 |
RequestId | String | b96f250a-4b75-498c-91be-22c6928f85be | 本次調(diào)用請(qǐng)求的ID,是由阿里云為該請(qǐng)求生成的唯一標(biāo)識(shí)符,可用于排查和定位問(wèn)題。 |
KeyVersion | Object | 密鑰版本的元數(shù)據(jù)。 |
|
KeyId | String | key-hzz62f1cb66fa42qo**** | 密鑰ID。 |
KeyVersionId | String | key-hzz62f1cb66fa42qo****-20v29b**** | 密鑰版本ID。 |
CreationDate | String | 2023-07-02T10:38:27Z | 創(chuàng)建密鑰版本的時(shí)間(UTC時(shí)間)。 |
示例
請(qǐng)求示例
http(s)://[Endpoint]/?Action=CreateKeyVersion
&KeyId=key-hzz62f1cb66fa42qo***
&公共請(qǐng)求參數(shù)
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<CreateKeyVersionResponse>
<RequestId>b96f250a-4b75-498c-91be-22c6928f85be</RequestId>
<KeyVersion>
<KeyId>key-hzz62f1cb66fa42qo****</KeyId>
<KeyVersionId>key-hzz62f1cb66fa42qo****-20v29b****</KeyVersionId>
<CreationDate>2023-07-02T10:38:27Z</CreationDate>
</KeyVersion>
</CreateKeyVersionResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "b96f250a-4b75-498c-91be-22c6928f85be",
"KeyVersion" : {
"KeyId" : "key-hzz62f1cb66fa42qo****",
"KeyVersionId" : "key-hzz62f1cb66fa42qo****-20v29b****",
"CreationDate" : "2023-07-02T10:38:27Z"
}
}
錯(cuò)誤碼
HttpCode |
錯(cuò)誤碼 |
錯(cuò)誤信息 |
描述 |
400 | Rejected.UnsupportedOperation | Unsupported operation. | 不支持的操作 |
404 | Forbidden.AliasNotFound | The specified Alias is not found. | 指定的別名找不到 |
404 | Forbidden.KeyNotFound | The specified Key is not found. | 指定的密鑰不存在。 |
409 | Rejected.Disabled | The request was rejected because the key state is Disabled. | 請(qǐng)求被拒絕,因?yàn)槊荑€狀態(tài)為已禁用。 |
409 | Rejected.Unavailable | The request was rejected because the key state is Unavailable. | 請(qǐng)求被拒絕,原因是密鑰狀態(tài)為不可用。 |
409 | Rejected.PendingDeletion | The request was rejected because the key state is PendingDeletion. | 請(qǐng)求被拒絕,原因是密鑰狀態(tài)為待刪除。 |
訪問(wèn)錯(cuò)誤中心查看更多錯(cuò)誤碼。
文檔內(nèi)容是否對(duì)您有幫助?