申請刪除一個指定的主要金鑰(CMK)。
介面說明
-
RAM 使用者或 RAM 角色調用該 OpenAPI 需要被授與權限策略詳情,請參見存取控制。
-
在密鑰預刪除期間,密鑰狀態處於待刪除狀態,無法用於加密、解密、產生資料密鑰操作。
-
主要金鑰一旦刪除,將無法恢複,使用該主要金鑰加密的內容及產生的資料密鑰也將無法解密。因此,對於主要金鑰的刪除,KMS 只提供計劃刪除的方式,而不提供直接刪除的方式。如果您有刪除密鑰方面的需求,可以通過 DisableKey 禁用密鑰。
-
在申請刪除主要金鑰的同時,需要指定一個預刪除周期,該周期最少為 7 天,最多為 366 天。從申請刪除主要金鑰的時刻開始,到刪除周期之前,可以通過 CancelKeyDeletion 撤銷密鑰刪除的申請。
調試
您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| KeyId |
string |
是 |
金鑰識別碼。CMK 通用唯一識別碼。 |
7906979c-8e06-46a2-be2d-68e3ccbc**** |
| PendingWindowInDays |
integer |
是 |
密鑰預刪除周期。在這段時間內,您可以撤銷刪除處於待刪除狀態的密鑰;預刪除時間過後無法撤銷刪除。 |
7 |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
|||
| RequestId |
string |
本次調用請求的 ID,是由阿里雲為該請求產生的唯一識別碼,可用於排查和定位問題。 |
3da5b8cc-8107-40ac-a170-793cd181d7b7 |
樣本
正常返回樣本
JSON格式
{
"RequestId": "3da5b8cc-8107-40ac-a170-793cd181d7b7"
}
錯誤碼
|
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. |
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊,參考變更詳情。