全部產品
Search
文件中心

Key Management Service:ScheduleKeyDeletion - 申請刪除一個指定的主要金鑰(CMK)

更新時間:Dec 21, 2025

申請刪除一個指定的主要金鑰(CMK)。

介面說明

  • RAM 使用者或 RAM 角色調用該 OpenAPI 需要被授與權限策略詳情,請參見存取控制

  • 在密鑰預刪除期間,密鑰狀態處於待刪除狀態,無法用於加密、解密、產生資料密鑰操作。

  • 主要金鑰一旦刪除,將無法恢複,使用該主要金鑰加密的內容及產生的資料密鑰也將無法解密。因此,對於主要金鑰的刪除,KMS 只提供計劃刪除的方式,而不提供直接刪除的方式。如果您有刪除密鑰方面的需求,可以通過 DisableKey 禁用密鑰。

  • 在申請刪除主要金鑰的同時,需要指定一個預刪除周期,該周期最少為 7 天,最多為 366 天。從申請刪除主要金鑰的時刻開始,到刪除周期之前,可以通過 CancelKeyDeletion 撤銷密鑰刪除的申請。

調試

您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

當前API暫無授權資訊透出。

請求參數

名稱

類型

必填

描述

樣本值

KeyId

string

金鑰識別碼。CMK 通用唯一識別碼。

7906979c-8e06-46a2-be2d-68e3ccbc****

PendingWindowInDays

integer

密鑰預刪除周期。在這段時間內,您可以撤銷刪除處於待刪除狀態的密鑰;預刪除時間過後無法撤銷刪除。
取值範圍:7~366。
單位:天。

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.

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊,參考變更詳情