為使用者主要金鑰（CMK）建立密鑰版本。
介面說明
-
RAM 使用者或 RAM 角色調用該 OpenAPI 需要被授與權限策略詳情，請參見存取控制。
-
僅軟體密鑰管理執行個體中的對稱金鑰支援建立密鑰版本，且密鑰狀態必須處於啟用中。您可以調用 DescribeKey 介面查詢密鑰狀態。
-
每建立一個密鑰版本，就會消耗一個密鑰額度。
本文將提供一個樣本，為金鑰識別碼 為key-hzz62f1cb66fa42qo****的密鑰建立密鑰版本。
調試
您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| KeyId |
string |
是 |
金鑰識別碼，即密鑰的通用唯一識別碼。 |
key-hzz62f1cb66fa42qo*** |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
|||
| RequestId |
string |
本次調用請求的 ID，是由阿里雲為該請求產生的唯一識別碼，可用於排查和定位問題。 |
b96f250a-4b75-498c-91be-22c6928f85be |
| KeyVersion |
object |
密鑰版本的中繼資料。 |
|
| KeyId |
string |
金鑰識別碼。 |
key-hzz62f1cb66fa42qo**** |
| KeyVersionId |
string |
密鑰版本 ID。 |
key-hzz62f1cb66fa42qo****-20v29b**** |
| CreationDate |
string |
建立密鑰版本的時間（UTC 時間）。 |
2023-07-02T10:38:27Z |
樣本
正常返回樣本
JSON格式
{
"RequestId": "b96f250a-4b75-498c-91be-22c6928f85be",
"KeyVersion": {
"KeyId": "key-hzz62f1cb66fa42qo****",
"KeyVersionId": "key-hzz62f1cb66fa42qo****-20v29b****",
"CreationDate": "2023-07-02T10:38:27Z"
}
}錯誤碼
|
HTTP status code |
錯誤碼 |
錯誤資訊 |
描述 |
|---|---|---|---|
| 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. | 請求被拒絕，因為密鑰狀態為已禁用。 |
| 409 | Rejected.Unavailable | The request was rejected because the key state is Unavailable. | 請求被拒絕，原因是密鑰狀態為不可用。 |
| 409 | Rejected.PendingDeletion | The request was rejected because the key state is PendingDeletion. | 請求被拒絕，原因是密鑰狀態為待刪除。 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊，參考變更詳情。