SMC支持將阿里云云服務器ECS遷移到同地域的不同可用區(qū),同時也支持在同規(guī)格族內(nèi)更改實例規(guī)格(vCPU和內(nèi)存),滿足您遷移云服務器ECS和變配實例規(guī)格的業(yè)務需求。您可以通過此接口創(chuàng)建跨可用區(qū)任務。
接口說明
關(guān)于跨可用區(qū)遷移的使用限制及其遷移影響等信息,請參見跨可用區(qū)遷移操作。
調(diào)試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
授權(quán)信息
下表是API對應的授權(quán)信息,可以在RAM權(quán)限策略語句的Action
元素中使用,用來給RAM用戶或RAM角色授予調(diào)用此API的權(quán)限。具體說明如下:
- 操作:是指具體的權(quán)限點。
- 訪問級別:是指每個操作的訪問級別,取值為寫入(Write)、讀取(Read)或列出(List)。
- 資源類型:是指操作中支持授權(quán)的資源類型。具體說明如下:
- 對于必選的資源類型,用背景高亮的方式表示。
- 對于不支持資源級授權(quán)的操作,用
全部資源
表示。
- 條件關(guān)鍵字:是指云產(chǎn)品自身定義的條件關(guān)鍵字。
- 關(guān)聯(lián)操作:是指成功執(zhí)行操作所需要的其他權(quán)限。操作者必須同時具備關(guān)聯(lián)操作的權(quán)限,操作才能成功。
操作 | 訪問級別 | 資源類型 | 條件關(guān)鍵字 | 關(guān)聯(lián)操作 |
---|---|---|---|---|
smc:CreateCrossZoneMigrationJob | create |
|
| 無 |
請求參數(shù)
名稱 | 類型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
RegionId | string | 是 | 遷移源要遷入的目標阿里云地域 ID。 例如,您需要遷移源服務器至杭州,則相應的阿里云地域 ID 為 | cn-hangzhou |
ClientToken | string | 否 | 保證請求冪等性。從您的客戶端生成一個參數(shù)值,確保不同請求間該參數(shù)值唯一。ClientToken 只支持 ASCII 字符,且不能超過 64 個字符。 | 123e4567-e89b-12d3-a456-426655440000 |
InstanceId | string | 否 | 實例 ID。 | i-bp1ff25rzvnul6kr**** |
TargetVSwitchId | string | 否 | 目標阿里云服務器 ecs 的交換機 id。 | vsw-bp1mxqnssl8nafltcx32e |
TargetZoneId | string | 否 | 目標可用區(qū) id。 | cn-hangzhou-i |
TargetInstanceType | string | 否 | 目標實例規(guī)格 | ecs.g7.large |
AutoPay | boolean | 否 | 是否自動付費,取值說明:
| false |
Disk | array<object> | 否 | 云盤列表。 | |
object | 否 | 云盤列表。 | ||
DiskId | string | 否 | 云盤 ID。 | d-bp1eeplkn4j29wf7irpb |
Category | string | 否 | 云盤種類為 cloud_essd,表示 ESSD 云盤。 | cloud_essd |
PerformanceLevel | string | 否 | ESSD 云盤的性能等級。可能值:
| PL0 |
ResourceGroupId | string | 否 | 資源組 ID。 | rg-acfmw3ty5y7**** |
返回參數(shù)
示例
正常返回示例
JSON
格式
{
"RequestId": "A9DBD2F8-DE5A-5844-BA6F-957A996CBD78",
"JobId": "j-bp17bclvg344jlyt****"
}
錯誤碼
HTTP status code | 錯誤碼 | 錯誤信息 | 描述 |
---|---|---|---|
400 | ReplicationJobDataDiskIndex.Invalid | The specified replication job contains data disk index not found in source server. | 遷移任務包含的數(shù)據(jù)盤索引在遷移源中不存在。 |
400 | VSwitchIdVpcId.Mismatch | The specified VSwitchId and VpcId does not match. | 指定的VSwitchId和VpcId不匹配。 |
400 | InvalidSecurityGroupId.IncorrectNetworkType | The network type of the specified security group does not support this action. | 安全組網(wǎng)絡類型不支持該操作,請檢查安全組網(wǎng)絡類型。 |
400 | InvalidSecurityGroupId.VPCMismatch | The specified security group and the specified virtual switch are not in the same VPC. | 指定的安全組和交換機不在一個專有網(wǎng)絡。 |
400 | QuotaExceeded.ReplicationJob | The maximum number of replication jobs is exceeded. Please submit a ticket to raise the quota. | 遷移任務的數(shù)量已超過最大允許值,請?zhí)峤还巍?/span> |
400 | ReplicationJobName.Duplicate | The specified replication job name already exists. | 遷移任務名稱已存在,請修改遷移任務名稱。 |
400 | SourceServerState.Invalid | The specified source server status: %s is invalid. This operation can only be performed in the following status: %s. | 遷移源的狀態(tài):%s 是無效的。該操作只能在以下狀態(tài)進行:%s。 |
403 | EntityNotExist.Role | The account is unauthorized. Please assign the role AliyunServiceRoleForSMC to your account. | 賬號不具備操作權(quán)限,請賦予賬戶AliyunServiceRoleForSMC角色。 |
500 | InternalError | An error occurred while processing your request. Please try again. If the problem still exists, please submit a ticket. | 內(nèi)部錯誤,請重試。如果多次嘗試失敗,請?zhí)峤还巍?/span> |
訪問錯誤中心查看更多錯誤碼。