重新初始化一塊磁盤至創(chuàng)建時(shí)的初始狀態(tài)。
接口說明
調(diào)用該接口時(shí)，您需要注意：
- 磁盤的狀態(tài)必須為使用中（
In_use），云盤掛載的 ECS 實(shí)例的狀態(tài)必須為已停止（Stopped）。 - 實(shí)例首次啟動(dòng)前，不能重新初始化掛載在其上的磁盤。
- 已存在本地快照的云盤，不能重新初始化。
- 開啟多重掛載特性的云盤，不能重新初始化。
- 對于系統(tǒng)盤，初始化到鏡像的最初狀態(tài)。若創(chuàng)建云盤的源鏡像被刪除，則無法初始化。
- 對于直接創(chuàng)建的數(shù)據(jù)盤，初始化到空盤狀態(tài)；對于通過快照創(chuàng)建的數(shù)據(jù)盤，初始化到快照狀態(tài)。若源快照已被刪除，則無法初始化并返回錯(cuò)誤。
調(diào)試
您可以在OpenAPI Explorer中直接運(yùn)行該接口，免去您計(jì)算簽名的困擾。運(yùn)行成功后，OpenAPI Explorer可以自動(dòng)生成SDK代碼示例。
授權(quán)信息
下表是API對應(yīng)的授權(quán)信息，可以在RAM權(quán)限策略語句的Action元素中使用，用來給RAM用戶或RAM角色授予調(diào)用此API的權(quán)限。具體說明如下：
- 操作：是指具體的權(quán)限點(diǎn)。
- 訪問級(jí)別：是指每個(gè)操作的訪問級(jí)別，取值為寫入（Write）、讀取（Read）或列出（List）。
- 資源類型：是指操作中支持授權(quán)的資源類型。具體說明如下：
- 對于必選的資源類型，用背景高亮的方式表示。
- 對于不支持資源級(jí)授權(quán)的操作，用
全部資源表示。
- 條件關(guān)鍵字：是指云產(chǎn)品自身定義的條件關(guān)鍵字。
- 關(guān)聯(lián)操作：是指成功執(zhí)行操作所需要的其他權(quán)限。操作者必須同時(shí)具備關(guān)聯(lián)操作的權(quán)限，操作才能成功。
| 操作 | 訪問級(jí)別 | 資源類型 | 條件關(guān)鍵字 | 關(guān)聯(lián)操作 |
|---|---|---|---|---|
| ecs:ReInitDisk | update | *Disk acs:ecs:{#regionId}:{#accountId}:disk/{#diskId} |
| 無 |
請求參數(shù)
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| DiskId | string | 是 | 待初始化的磁盤 ID。 | d-bp67acfmxazb4ph**** |
| Password | string | 否 | 重新初始化系統(tǒng)盤時(shí)，是否重置 ECS 實(shí)例的用戶名密碼。長度為 8 至 30 個(gè)字符，必須同時(shí)包含大小寫英文字母、數(shù)字和特殊符號(hào)中的三類字符。特殊符號(hào)可以是： 其中，Windows 實(shí)例不能以斜線號(hào)（/）為密碼首字符。 說明
如果傳入 Password參數(shù)，建議您使用 HTTPS 協(xié)議發(fā)送請求，避免密碼泄露。
| EcsV587! |
| KeyPairName | string | 否 | 密鑰對名稱。 說明
該參數(shù)僅適用于 Linux 實(shí)例。重新初始化系統(tǒng)盤時(shí)，您可以為 ECS 實(shí)例綁定一個(gè) SSH 密鑰對，作為登錄憑證。使用了 SSH 密鑰對后，用戶名密碼的登錄憑證方式將被禁用。
| testKeyPairName |
| AutoStartInstance | boolean | 否 | 重新初始化磁盤后，是否自動(dòng)啟動(dòng)實(shí)例。取值范圍：
默認(rèn)值：false。 | true |
| SecurityEnhancementStrategy | string | 否 | 當(dāng)指定的云盤為系統(tǒng)盤時(shí)，重新初始化云盤后是否免費(fèi)使用云安全中心服務(wù)。取值范圍：
默認(rèn)值：Deactive。 | Active |
返回參數(shù)
示例
正常返回示例
JSON格式
{
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}錯(cuò)誤碼
| HTTP status code | 錯(cuò)誤碼 | 錯(cuò)誤信息 | 描述 |
|---|---|---|---|
| 400 | LoginAsNonRoot.ImageNotSupport | The specified image does not support login as non-root. | 此鏡像不支持NonRoot登錄。 |
| 400 | DiskHasSnapshotsWithInstantAccessEnabled.OperationNotSupported | The operation is not supported to the specified disk that have snapshots with InstantAccess enabled. | - |
| 400 | InvalidPassword.Malformed | The specified parameter "Password" is not valid. | 指定的參數(shù) Password 不合法 |
| 400 | InvalidKeyPairName.NotFound | The specified KeyPairName does not exist. | 指定的 KeyPairName 不存在。 |
| 400 | DependencyViolation.IoOptimize | The specified parameter InstanceId is not valid. | 指定的實(shí)例 IO 優(yōu)化配置不合法。 |
| 400 | DiskCategory.OperationNotSupported | The operation is not supported to the specified disk due to its disk category. | 由于磁盤種類限制，指定的磁盤不支持該操作。 |
| 400 | InvalidRegionId.MalFormed | The specified RegionId is not valid. | 指定的地域不存在，請檢查該參數(shù)是否正確。 |
| 403 | LoginAsNonRoot.RegionNotSupport | The specified region does not support login as non-root. | - |
| 403 | IncorrectDiskStatus | The current disk status does not support this operation. | 當(dāng)前的磁盤不支持此操作，請您確認(rèn)磁盤處于正常使用狀態(tài)，是否欠費(fèi)。 |
| 403 | IncorrectInstanceStatus | The current status of the resource does not support this operation. | 該資源目前的狀態(tài)不支持此操作。 |
| 403 | InstanceLockedForSecurity | The instance is locked due to security. | 您的資源被安全鎖定，拒絕操作。 |
| 403 | InvalidSnapshot.TooOld | The disk is created from a snapshotId made before 2013-07-15, it cannot be re-initiated the specified disk any more since the detached first time. | 創(chuàng)建于2013年7月15日之前的快照不支持此操作。 |
| 403 | OperationDenied | The snapshot which is used to create the specified disk has been deleted. | 用來創(chuàng)建指定磁盤的快照不存在。 |
| 403 | InstanceExpiredOrInArrears | The specified operation is denied as your prepay instance is expired (prepay mode) or in arrears (afterpay mode). | 實(shí)例已過期或者欠費(fèi)，請您續(xù)費(fèi)或者結(jié)清后再進(jìn)行操作。 |
| 403 | DiskCreatingSnapshot | The operation is denied due to a snapshot of the specified disk is not completed yet. | 指定的磁盤正在創(chuàng)建快照。 |
| 403 | InvalidSourceSnapshot | The snapshot which is used to create the specified disk has been deleted. | 用于創(chuàng)建指定磁盤的快照已被刪除。 |
| 403 | SharedImageDeleted | The specified image by others shared is deleted. | 指定的共享鏡像已刪除。 |
| 403 | DependencyViolation.WindowsInstance | The instance creating is windows, cannot use ssh key pair to login. | - |
| 403 | UserNotInTheWhiteList | The user is not in volume white list. | 用戶不在共享塊存儲(chǔ)白名單中，請您提交工單申請白名單。 |
| 403 | InvalidParameter.KMSKeyId.CMKNotEnabled | The CMK needs to be enabled. | 加密云盤設(shè)置了 KMSKeyId 后，CMK必須處于啟用狀態(tài)。您可以調(diào)用密鑰管理服務(wù)的 DescribeKey 接口查詢指定CMK的相關(guān)信息。 |
| 403 | InvalidParameter.KMSKeyId.KMSUnauthorized | ECS service have no right to access your KMS. | ECS 服務(wù)無權(quán)訪問您的 KMS。 |
| 403 | HibernationConfigured.InstanceOperationForbidden | The operation is not permitted due to limit of the hibernation configured instance. | 不符合開啟休眠選項(xiàng)的實(shí)例的相關(guān)限制，操作不被允許。 |
| 403 | InvalidOperation.MultiAttachDisk | Multi attach disk does not support this operation. | 開啟多重掛載特性的云盤不支持該操作。 |
| 403 | InvalidParameter.KMSKeyId.CMKUnauthorized | The CMK needs to be added ECS tag. | CMK 未授權(quán) |
| 404 | InvalidDiskId.NotFound | The specified disk does not exist. | 指定的磁盤不存在。請您檢查磁盤 ID 是否正確。 |
| 404 | InvalidImageId.NotFound | The specified ImageId does not exist. | 指定的鏡像在該用戶賬號(hào)下不存在，請您檢查鏡像 ID 是否正確。 |
| 404 | InvalidDiskId.OperationNotSupported | The operation is not supported due to image not exist. | 指定的鏡像不存在。 |
| 500 | InternalError | The request processing has failed due to some unknown error, exception or failure. | 內(nèi)部錯(cuò)誤，請重試。 |
訪問錯(cuò)誤中心查看更多錯(cuò)誤碼。
變更歷史
| 變更時(shí)間 | 變更內(nèi)容概要 | 操作 |
|---|---|---|
| 2024-12-04 | OpenAPI 描述信息更新、OpenAPI 錯(cuò)誤碼發(fā)生變更 | 查看變更詳情 |
| 2023-08-25 | OpenAPI 錯(cuò)誤碼發(fā)生變更 | 查看變更詳情 |
| 2021-06-18 | OpenAPI 錯(cuò)誤碼發(fā)生變更 | 查看變更詳情 |