將指定地域區塊儲存帳戶級預設加密使用的 KMS 金鑰 ID 重置為服務金鑰的介面。
介面說明
RAM 使用者(子帳號)需要
AliyunECSFullAccess權限,具體授權操作,請參閱為 RAM 使用者授權。帳戶需要具備雲端硬碟加密使用權限;若介面回傳 UserNotInTheWhiteList,請先申請加入雲端硬碟加密白名單。
指定地域需要先呼叫 EnableDiskEncryptionByDefault 開啟區塊儲存帳戶級預設加密功能,再呼叫本介面重設預設金鑰。
調試
您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
|
操作 |
存取層級 |
資源類型 |
條件關鍵字 |
關聯操作 |
|
ecs:ResetDiskDefaultKMSKeyId |
none |
*全部資源。
|
無 | 無 |
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| RegionId |
string |
是 |
地域 ID。您可以呼叫 DescribeRegions 查看最新的阿里雲地域清單。 |
cn-hangzhou |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
Schema of Response |
||
| RequestId |
string |
請求 ID。 |
473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E |
樣本
正常返回樣本
JSON格式
{
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}
錯誤碼
|
HTTP status code |
錯誤碼 |
錯誤資訊 |
描述 |
|---|---|---|---|
| 400 | InvalidParameter.KMSKeyId.CMKNotEnabled | The CMK needs to be enabled. | 加密雲端硬碟設定了 KMSKeyId 後,CMK必須處於啟用狀態。您可以呼叫金鑰管理服務的 DescribeKey 介面查詢指定CMK的相關資訊。 |
| 400 | InvalidParameter.Encrypted.KmsNotEnabled | KMS must be enabled for encrypted disks. | 加密磁碟需要啟用金鑰管理服務。 |
| 400 | InvalidParameter.KmsNotEnabled | The operation failed because KMS is not activated. Please activate KMS in the KMS console and try again. | |
| 403 | Abs.InvalidAction.RegionNotSupport | This region does not support this action. | 地域不支援該操作。 |
| 403 | InvalidParameter.RegionIdNotExists | The specified region does not exist. | |
| 403 | InvalidParameter.KMSKeyId.KMSUnauthorized | ECS service does not have permission to access your KMS key. Please verify that the specified KMS key has authorized the ECS service. | |
| 403 | InvalidOperation.KMSKeyIdNotFound | The specified KMSKeyId does not exist. Please verify that the key ID is correct and that the key resides in the current region. | |
| 403 | InvalidOperation.KMSServiceNotOpen | KMS service is currently not open. | KMS服務尚未啟用。 |
| 403 | UserNotInTheWhiteList | The user is not in disk white list. | 使用者不在共享區塊儲存白名單中,請您提交工單申請白名單。 |
| 403 | InvalidDefaultEncryption.NotFound | You have not configured default encryption setting in this region. | 該地域尚未開啟雲端硬碟預設加密。 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊,參考變更詳情。