調用ModifyDiskDeployment將云盤遷入、遷出專屬塊存儲集群,或將云盤在不同專屬塊存儲集群之間遷移。
接口說明
說明 專屬塊存儲集群功能目前支持華東1(杭州)、華東2(上海)、華北2(北京)、華北3(張家口)、華北6(烏蘭察布)、華南1(深圳)、華南2(河源)、印度尼西亞(雅加達)、德國(法蘭克福)以及華南1 金融云地域。
請確保在使用該接口前,您已充分了解云盤和專屬塊存儲集群的計費方式和價格,并且專屬塊存儲集群未到期,賬號未處于欠費狀態。更多信息,請參見專屬塊存儲計費和塊存儲計費。
調用該接口時,您需要注意:
- 云盤和專屬塊存儲集群必須在同一個可用區。
- 僅支持按量付費云盤,包年包月云盤需要先轉成按量付費。具體操作,請參見轉換云盤計費方式。
- 遷移時云盤規格需要和目標集群支持的云盤規格保持一致,當在不同專屬塊存儲集群之間遷移時允許變更云盤規格,使其和目標集群支持的云盤規格保持一致。
- 云盤的狀態必須是使用中(In_Use)狀態或者待掛載(Available)狀態。
- 若云盤已掛載到ECS實例上,實例必須處于運行中(Running)狀態或者已停止(Stopped)狀態,ECS實例不能處于已過期狀態。
- 由于ESSD云盤性能級別受容量限制,如果您無法升級性能級別,可以擴容后重新操作。更多信息,請參見ResizeDisk和ESSD云盤。
- 一個賬號在同一地域內最多同時進行5個云盤遷移任務。
- 遷移過程中不允許取消遷移、創建快照、變配、擴容、掛載、卸載、重新初始化云盤等操作。
調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
請求參數
名稱 |
類型 |
是否必選 |
示例值 |
描述 |
Action | String | 是 | ModifyDiskDeployment | 系統規定參數。取值:ModifyDiskDeployment。 |
DiskId | String | 是 | d-bp131n0q38u3a4zi**** | 云盤ID。 |
DiskCategory | String | 否 | cloud_essd | 變更云盤類型,僅在不同專屬塊存儲集群之間遷移時有效。當前僅支持cloud_essd(ESSD云盤)。 默認值:空,表示不變配云盤。 |
PerformanceLevel | String | 否 | PL1 | 修改ESSD云盤的性能級別,僅在不同專屬塊存儲集群之間遷移時有效。取值范圍:
默認值:空,表示不修改性能級別。 |
StorageClusterId | String | 否 | dbsc-cn-c4d2uea**** | 專屬塊存儲集群ID。
默認值:空,表示遷移至公共云塊存儲集群。 |
DryRun | Boolean | 否 | false | 是否只預檢此次請求。取值范圍:
默認值:false。 |
返回數據
名稱 |
類型 |
示例值 |
描述 |
RequestId | String | D69846D9-F17F-51C0-8AC6-B4B71777**** | 請求ID。 |
TaskId | String | t-bp67acfmxazb4p**** | 云盤遷移的任務ID。 |
示例
請求示例
http(s)://ecs.aliyuncs.com/?Action=ModifyDiskDeployment
&DiskId=d-bp131n0q38u3a4zi****
&StorageClusterId=dbsc-cn-c4d2uea****
&DryRun=false
&公共請求參數
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<ModifyDiskDeploymentResponse>
<RequestId>D69846D9-F17F-51C0-8AC6-B4B71777****</RequestId>
<TaskId>t-bp67acfmxazb4p****</TaskId>
</ModifyDiskDeploymentResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "D69846D9-F17F-51C0-8AC6-B4B71777****",
"TaskId" : "t-bp67acfmxazb4p****"
}
錯誤碼
HttpCode |
錯誤碼 |
錯誤信息 |
描述 |
400 | InvalidDiskSpec.Malformed | The specified parameter DiskCategory or PerformanceLevel is not supported. | 指定的參數DiskCategory或PerformanceLevel不支持。 |
400 | AccountInArrears | The account is in arrears. | 賬號已欠費。 |
400 | InvalidStorageClusterId.DiskAlreadyInDestination | The specified disk is already in destination. | 指定的磁盤已經在目的地中。 |
403 | IncorrectDiskStatus | The current disk status does not support this operation. | 當前的磁盤不支持此操作,請您確認磁盤處于正常使用狀態,是否欠費。 |
403 | DiskCreatingSnapshot | The operation is denied due to a snapshot of the specified disk is not completed yet. | 指定的磁盤正在創建快照。 |
403 | InvalidOperation.DiskTypeUnsupported | The type of the disk does not support this operation. | 磁盤類型不支持該操作。 |
403 | InvalidOperation.ChargeTypeUnsupported | The charge type of the disk does not support this operation. | 磁盤的計費方式不支持該操作。 |
403 | InvalidPerformanceLevel.DiskSizeUnsupported | The specified parameter PerformanceLevel does not match the disk size. | 指定的參數PerformanceLevel與磁盤大小不匹配。 |
403 | DiskLimitExceeded | The number of migrated disks at the same time exceeds the limit. | 同一時間遷移的磁盤數量超過限制。 |
403 | OperationDenied.NoStock | The requested resource is sold out in the specified zone; try other types of resources or other regions and zones. | 請求的資源在指定的可用區已售完,請您更換實例規格或者可用區重試,調用 DescribeZones 接口可以獲得庫存結果。 |
403 | InvalidOperation.MultiAttachDisk | Multi attach disk does not support this operation. | 開啟多重掛載特性的云盤不支持該操作。 |
403 | InvalidDisk.DetachedSystemDisk | The specified resource is/has a detached system disk %s , not support current operation. | 指定的磁盤是一塊被卸載的系統盤,不支持當前操作。 |
403 | InvalidOperation.NoPermission | You are not authorized to do this action. | 您沒有被授權進行當前操作,請提交工單進行反饋。 |
403 | InvalidOperation.LimitQosUnsupported | The specified disk has limited bps or iops, can not do this operation. | 指定的磁盤處于性能控制狀態,不能進行該操作。 |
403 | InvalidOperation.AcrossRegionsOrZonesUnsupported | Migration across regions or available zones is not supported. | 不支持跨地域或跨可用區的遷移。 |
404 | InvalidDiskId.NotFound | The specified disk does not exist. | 指定的磁盤不存在。請您檢查磁盤 ID 是否正確。 |
404 | InvalidStorageClusterId.NotFound | The specified dedicated block storage cluster does not exist. | 指定的專屬塊存儲集群不存在。 |
500 | InternalError | The request processing has failed due to some unknown error. | 內部錯誤,請重試。 |
訪問錯誤中心查看更多錯誤碼。
文檔內容是否對您有幫助?