更新时间:2025-02-13 GMT+08:00

查询指定ID迁移项目详情

功能介绍

查询指定ID的迁移项目详情。

调用方法

请参见如何调用API

URI

GET /v3/migprojects/{mig_project_id}

表1 路径参数

参数

是否必选

参数类型

描述

mig_project_id

String

迁移项目ID

最小长度:0

最大长度:255

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。

通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

最小长度:1

最大长度:16384

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

id

String

迁移项目ID

最小长度:1

最大长度:254

name

String

迁移项目名称

最小长度:2

最大长度:19

description

String

迁移项目描述

最小长度:0

最大长度:255

isdefault

Boolean

是否为默认模板

缺省值:false

region

String

区域名称

最小长度:0

最大长度:255

start_target_server

Boolean

迁移后是否启动目的端虚拟机

缺省值:true

speed_limit

Integer

限制迁移速率,单位:Mbps

最小值:0

最大值:10000

use_public_ip

Boolean

是否使用公网IP迁移

缺省值:true

exist_server

Boolean

是否是已经存在的服务器

缺省值:true

type

String

迁移项目类型

MIGRATE_BLOCK:块级迁移

MIGRATE_FILE:文件级迁移

枚举值:

  • MIGRATE_BLOCK

  • MIGRATE_FILE

enterprise_project

String

企业项目名称

缺省值:default

最小长度:0

最大长度:255

syncing

Boolean

首次复制或者同步后 是否继续持续同步

缺省值:false

start_network_check

Boolean

是否启动网络质量检测

状态码:403

表4 响应Body参数

参数

参数类型

描述

error_code

String

错误代码

最小长度:0

最大长度:255

error_msg

String

错误信息

最小长度:0

最大长度:255

encoded_authorization_message

String

加密授权信息

最小长度:0

最大长度:65535

error_param

Array of strings

错误参数

最小长度:0

最大长度:65535

数组长度:1 - 20

details

Array of details objects

详细错误信息

数组长度:1 - 20

表5 details

参数

参数类型

描述

error_code

String

SMS错误代码

最小长度:0

最大长度:65535

error_msg

String

SMS错误信息

最小长度:0

最大长度:65535

请求示例

查询项目ID为137224b7-8d7c-4919-b33e-ed159778d7a7的项目

GET  https://{endpoint}/v3/migprojects/137224b7-8d7c-4919-b33e-ed159778d7a7

响应示例

状态码:200

查询指定ID迁移项目详情成功

{
  "id" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
  "name" : "456",
  "isdefault" : true,
  "region" : null,
  "start_target_server" : false,
  "speed_limit" : 0,
  "use_public_ip" : true
}

状态码:403

鉴权失败

{
  "error_code" : "SMS.9004",
  "error_msg" : "The current account does not have the permission to execute policy You do not have permission to perform action XXX on resource XXX.",
  "encoded_authorization_message" : "XXXXXX",
  "error_param" : [ "You do not have permission to perform action XXX on resource XXX." ],
  "details" : [ {
    "error_code" : "SMS.9004",
    "error_msg" : "You do not have permission to perform action XXX on resource XXX."
  } ]
}

状态码

状态码

描述

200

查询指定ID迁移项目详情成功

403

鉴权失败

错误码

请参见错误码