CreateKeyVersion
更新時間:
為密鑰創(chuàng)建新的密鑰版本。
- 僅軟件密鑰管理實例中的對稱密鑰支持創(chuàng)建密鑰版本,且密鑰狀態(tài)必須處于啟用中。您可以調(diào)用DescribeKey 接口查詢密鑰狀態(tài)。
- 每創(chuàng)建一個密鑰版本,就會消耗一個密鑰額度。
本文將提供一個示例,為密鑰ID為key-hzz62f1cb66fa42qo****
的密鑰創(chuàng)建密鑰版本。
調(diào)試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
請求參數(shù)
名稱 |
類型 |
是否必選 |
示例值 |
描述 |
Action | String | 是 | CreateKeyVersion | 要執(zhí)行的操作。取值:CreateKeyVersion。 |
KeyId | String | 是 | key-hzz62f1cb66fa42qo*** | 密鑰ID,即密鑰的全局唯一標識符。 |
返回數(shù)據(jù)
名稱 |
類型 |
示例值 |
描述 |
RequestId | String | b96f250a-4b75-498c-91be-22c6928f85be | 本次調(diào)用請求的ID,是由阿里云為該請求生成的唯一標識符,可用于排查和定位問題。 |
KeyVersion | Object | 密鑰版本的元數(shù)據(jù)。 |
|
KeyId | String | key-hzz62f1cb66fa42qo**** | 密鑰ID。 |
KeyVersionId | String | key-hzz62f1cb66fa42qo****-20v29b**** | 密鑰版本ID。 |
CreationDate | String | 2023-07-02T10:38:27Z | 創(chuàng)建密鑰版本的時間(UTC時間)。 |
示例
請求示例
http(s)://[Endpoint]/?Action=CreateKeyVersion
&KeyId=key-hzz62f1cb66fa42qo***
&公共請求參數(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"
}
}
錯誤碼
HttpCode |
錯誤碼 |
錯誤信息 |
描述 |
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. | 請求被拒絕,因為密鑰狀態(tài)為已禁用。 |
409 | Rejected.Unavailable | The request was rejected because the key state is Unavailable. | 請求被拒絕,原因是密鑰狀態(tài)為不可用。 |
409 | Rejected.PendingDeletion | The request was rejected because the key state is PendingDeletion. | 請求被拒絕,原因是密鑰狀態(tài)為待刪除。 |
訪問錯誤中心查看更多錯誤碼。
文檔內(nèi)容是否對您有幫助?