5.1 源端管理
5.1.3 查询源端服务器列表
} ],
"cpu_quantity" : 1, "memory" : 934752256, "networks" : [ { "name" : "eth0", "ip" : "192.168.136.161",
"mac" : "1a9660eb8a3ffcf4df6d7865b52eb54f7b0cd194029e0eadd8e2c7f1267d80c0"
} ],
"ip" : "192.168.136.161", "agent_version" : "2.2.1"
}
响应示例
状态码： 200 源端注册成功
{ "id" : "8abda8635e09d185015e09d188dd0001xx"
}
状态码
状态码 描述
200 源端注册成功
错误码
请参见错误码。
5.1.3 查询源端服务器列表
功能介绍
用户在源端安装并成功启动Agent后，Agent会将源端服务器信息注册在主机迁移服务 中，调用该接口查询已注册的源端服务器列表信息。
调试
您可以在API Explorer中调试该接口。
URI
GET /v3/sources
表5-15 Query 参数
参数 是否必选 参数类型 描述
state 否 String 源端服务器状态
枚举值：
● unavailable
● waiting
● initialize
● replicate
● syncing
● stopping
● stopped
● deleting
● error
● cloning
● cutovering
● finished
name 否 String 源端服务器名称
最小长度：0 最大长度：255
id 否 String 源端服务器ID
最小长度：0 最大长度：255
ip 否 String 源端服务器IP地址
最小长度：0 最大长度：255
migproject 否 String 迁移项目id，填写该参数将查询 迁移项目下的所有虚拟机 最小长度：0
最大长度：255
limit 否 Integer 每一页记录的源端服务器数量，
0表示用默认值 200 最小值：0
最大值：200 缺省值：200
offset 否 Integer 偏移量，默认值0
最小值：0 最大值：65535 缺省值：0
参数 是否必选 参数类型 描述 migration_cyc
le 否 String 根据迁移周期查询
最小长度：0 最大长度：255 枚举值：
● checking
● setting
● replicating
● syncing
● cutovering
● cutovered connected 否 Boolean 查询失去连接的源端 enterprise_pro
ject_id 否 String 需要查询的企业项目id
最小长度：0 最大长度：255
请求参数
表5-16 请求 Header 参数
参数 是否必选 参数类型 描述
X-Auth-Token 是 String 用户Token。
通过调用IAM服务获取用户 Token接口获取(响应消息头中X-Subject-Token的值)。
最小长度：1 最大长度：16384
响应参数
状态码： 200
表5-17 响应 Body 参数
参数 参数类型 描述
count Integer 符合查询条件的源端总数量，不受limit和offset影 响
最小值：0
最大值：2147483647
参数 参数类型 描述 source_servers Array of
SourceServer sResponseBo dy objects
批量查询的源端服务器详列表
表5-18 SourceServersResponseBody
参数 参数类型 描述
id String 源端服务器id
最小长度：0 最大长度：255
ip String 源端服务器的ip地址
最小长度：0 最大长度：255
name String 源端服务器名称
最小长度：0 最大长度：255 enterprise_pro
ject_id String 企业项目id 最小长度：0 最大长度：255
add_date Long 源端服务器的注册时间 最小值：0
最大值：9223372036854775807
os_type String 操作系统类型，OS_TYPE (WINDOWS/LINUX) 最小长度：0
最大长度：255 枚举值：
● WINDOWS
● LINUX
os_version String 系统详细版本号，如CENTOS7.6等 最小长度：0
最大长度：255
oem_system Boolean 是否是OEM操作系统(Windows)
参数 参数类型 描述
state String 源端服务器状态 最小长度：0 最大长度：255 枚举值：
● unavailable
● waiting
● initialize
● replicate
● syncing
● stopping
● stopped
● deleting
● error
● cloning
● cutovering
● finished
connected Boolean 源端服务器与主机迁移服务端是否连接 cpu_quantity Integer 源端CPU核心数
最小值：0
最大值：2147483647
memory Long 源端物理内存大小（单位：字节）
最小值：0
最大值：9223372036854775807 current_task TaskByServer
Sources object
源端列表中关联的任务
checks Array of Environment Check objects
源端校验检查项列表
init_target_ser
ver InitTargetSer
ver object 推荐的目的端服务器配置 replicatesize Long 已复制的大小（单位：字节）
最小值：0
最大值：9223372036854775807 stage_action_t
ime Long 迁移周期（migration_cycle）上一次变化的时间 最小值：0
最大值：9223372036854775807
参数 参数类型 描述
totalsize Long 需要迁移的数据量总大小（单位：字节）
最小值：0
最大值：9223372036854775807 last_visit_time Long Agent上一次连接状态发生变化的时间
最小值：0
最大值：9223372036854775807 migration_cyc
le String 迁移周期
最小长度：0 最大长度：255 枚举值：
● cutovering
● cutovered
● checking
● setting
● replicating
● syncing state_action_t
ime Long 源端状态（state）上次发生变化的时间 最小值：0
最大值：9223372036854775807
表5-19 TaskByServerSources
参数 参数类型 描述
id String 任务id
最小长度：1 最大长度：255
name String 任务名称
最小长度：0 最大长度：255
type String 任务类型
最小长度：0 最大长度：255 state String 任务状态
最小长度：0 最大长度：255
参数 参数类型 描述 estimate_com
plete_time Long 预估结束时间 最小值：0
最大值：9223372036854775807 start_date Long 开始时间
最小值：0
最大值：9223372036854775807 speed_limit Integer 限速
最小值：0 最大值：10000 migrate_spee
d Double 迁移速率
最小值：0 最大值：10000 compress_rate Double 压缩率
最小值：0 最大值：10000 start_target_s
erver Boolean 是否启动虚拟机 vm_template_
id String 虚拟机模板id
最小长度：0 最大长度：255 region_id String region_id
最小长度：0 最大长度：255 project_name String 项目名称
最小长度：0 最大长度：255 project_id String 项目id
最小长度：0 最大长度：255 target_server TargetServer
ById object 目的端 log_collect_st
atus String 日志收集状态
最小长度：0 最大长度：255 exist_server Boolean 是否使用已有虚拟机
参数 参数类型 描述
use_public_ip Boolean 是否使用公网ip clone_server CloneServer
object 克隆服务器类 remain_secon
ds Long 已迁移时长
最小值：0
最大值：9223372036854775807
表5-20 TargetServerById
参数 参数类型 描述
vm_id String 目的端服务器ID 最小长度：0 最大长度：255
name String 目的端服务器名称
最小长度：0 最大长度：255
表5-21 CloneServer
参数 参数类型 描述
vm_id String 克隆服务器ID 最小长度：0 最大长度：255
name String 克隆虚拟机的名称
最小长度：0 最大长度：255 clone_error String 克隆错误信息
最小长度：0 最大长度：255 clone_state String 克隆状态
最小长度：0 最大长度：255 error_msg String 克隆错误信息描述
最小长度：0 最大长度：1024
表5-22 EnvironmentCheck
参数 参数类型 描述
id Long 该检查项的ID
最小值：0
最大值：9223372036854775807 params Array of
strings 参数
name String 检查项名称
最小长度：0 最大长度：255 result String 检查结果
最小长度：0 最大长度：255 枚举值：
● OK
● WARN
● ERROR
error_code String 检查不通过的错误码 最小长度：0
最大长度：255
error_params String 检查不通过的错误参数 最小长度：0
最大长度：255
表5-23 InitTargetServer
参数 参数类型 描述
disks Array of DiskIntarget Server objects
推荐的目的端服务器的磁盘信息
表5-24 DiskIntargetServer
参数 参数类型 描述
name String 磁盘名称
最小长度：0 最大长度：255
参数 参数类型 描述
size Long 磁盘大小，单位：字节
最小值：0
最大值：9223372036854775807 device_use String 磁盘的作用
最小长度：0 最大长度：255 枚举值：
● BOOT
● OS
● NORMAL
状态码： 500
表5-25 响应 Body 参数
参数 参数类型 描述
error_code String 错误码 最小长度：0 最大长度：255 error_msg String 错误信息
最小长度：0 最大长度：1024
请求示例
查询源端列表信息，每页10个源端，查看第0页。
GET https://{endpoint}/v3/sources?limit=10&offset=0
响应示例
状态码： 200
查询源端服务器列表成功。
{ "count" : 10, "source_servers" : [ {
"id" : "7583895d-627b-4643-82bc-c2aec1576a75", "ip" : "192.168.0.1",
"name" : "sms-test", "hostname" : "sms-test", "enterprise_project_id" : 0, "add_date" : 1598417717000, "os_type" : "WINDOWS",
"os_version" : "WINDOWS2008_R2_64BIT", "oem_system" : false,
"state" : "finished", "connected" : true, "cpu_quantity" : 1, "memory" : 2146557952, "current_task" : {
"id" : "57ea3129-a808-488b-90c5-30861de60676", "name" : "MigrationTask",
"type" : "MIGRATE_BLOCK", "state" : "MIGRATE_SUCCESS", "estimate_complete_time" : null, "start_date" : 1598417771000, "speed_limit" : 0,
"migrate_speed" : 0.0, "start_target_server" : true,
"vm_template_id" : "26885d76-0d65-4f4b-9e9b-19c7d69ccc13", "region_id" : "region_id",
"project_name" : "project_name",
"project_id" : "b276e6fb38c74aa2ba4598f049745ce9", "target_server" : {
"vm_id" : "23d74c12-b78b-4163-ba33-a898f79b8260", "name" : "sms-test"
},
"log_collect_status" : "INIT", "exist_server" : false,
"error_params" : ""
}, {
"id" : 524067, "params" : [ "" ],
"name" : "PARTITION_STYLE", "result" : "OK",
"init_target_server" : { "disks" : [ {
"stage_action_time" : 1598419352959, "totalsize" : 0,
"last_visit_time" : 1598434312002,
"migration_cycle" : "cutovered", "state_action_time" : 1598419352959 }, {
"id" : "4f63b0e6-9624-4472-b811-bedfbf52a9b6", "ip" : "192.168.0.154",
"name" : "sms-win16", "hostname" : "sms-win16", "add_date" : 1598417612000, "os_type" : "WINDOWS",
"os_version" : "WINDOWS2016_64BIT", "oem_system" : false,
"state" : "finished", "connected" : true, "cpu_quantity" : 1, "memory" : 2146553856, "current_task" : {
"id" : "5297077e-8b2a-487a-87b3-f3d11d5cf0be", "name" : "MigrationTask",
"type" : "MIGRATE_BLOCK", "state" : "MIGRATE_SUCCESS", "estimate_complete_time" : null, "start_date" : 1598417627000, "speed_limit" : 0,
"migrate_speed" : 0.0, "start_target_server" : true,
"vm_template_id" : "d67d6f9b-fa72-46c3-8a90-15cab3190907", "region_id" : "region_id",
"project_name" : "project_name",
"project_id" : "b276e6fb38c74aa2ba4598f049745ce9", "target_server" : {
"vm_id" : "0b1b1aa6-1364-4395-8556-e9cb5afe8538", "name" : "e2e-sms-win16"
},
"log_collect_status" : "INIT", "exist_server" : false,
"error_or_warn" : null,
"name" : "PARTITION_STYLE", "result" : "OK",
"init_target_server" : { "disks" : [ {
"name" : "Disk 0",
"stage_action_time" : 1598419339661, "totalsize" : 0,
"last_visit_time" : 1598434316810, "migration_cycle" : "cutovered", "state_action_time" : 1598419339661 }, {
"id" : "ebe80818-605e-430e-9d2e-bf71af50bbb6", "ip" : "192.168.77.77",
"name" : "sms-centos", "hostname" : null,
"add_date" : 1598417551000, "os_type" : "LINUX",
"os_version" : "CENTOS_7_4_64BIT", "oem_system" : false,
"id" : "a42013ab-1ebb-4dd8-8284-1a678ef1ccac", "name" : "MigrationTask",
"type" : "MIGRATE_BLOCK", "state" : "MIGRATE_FAIL", "estimate_complete_time" : null, "start_date" : 1598417588000, "speed_limit" : 0,
"migrate_speed" : 0.0, "start_target_server" : true,
"vm_template_id" : "f909c6ec-aafd-4e85-94bc-aad03a756bb5", "region_id" : "region_id",
"project_name" : "project_name",
"project_id" : "b276e6fb38c74aa2ba4598f049745ce9", "target_server" : {
"vm_id" : "e9eeb550-ba71-4940-a75a-94931955179d", "name" : "e2e-sms-centos"
},
"log_collect_status" : "INIT", "exist_server" : false,
"error_code" : null,
"name" : "PARAVIRTUALIZATION", "result" : "OK",
"name" : "PARTITION_STYLE", "result" : "OK",
"params" : [ "" ],
"name" : "LINUX_BLOCK_SUPPORT", "result" : "OK",
"error_code" : null, "error_or_warn" : null, "error_params" : ""
} ],
"init_target_server" : { "disks" : [ {
"replicatesize" : 42949672960, "stage_action_time" : 1598428182454, "totalsize" : 42949672960,
"last_visit_time" : 1598434308889, "migration_cycle" : "syncing", "state_action_time" : 1598428182454 }, {
"id" : "766b8952-61e3-444d-8b7f-bc76c4c0d3f6", "ip" : "192.168.0.235",
"name" : "sms-ubuntu", "hostname" : null,
"add_date" : 1598417522000, "os_type" : "LINUX",
"os_version" : "UBUNTU_18_4_64BIT", "oem_system" : false,
"state" : "unavailable", "connected" : false, "cpu_quantity" : 1, "memory" : 1032556544, "current_task" : null, "checks" : [ ], "init_target_server" : { "disks" : [ {
"stage_action_time" : 1598417521797, "totalsize" : 0,
"last_visit_time" : 1598417521795, "migration_cycle" : "checking", "state_action_time" : null }, {
"id" : "5aaddbd6-6c47-472d-ab67-95c07d251d3c", "ip" : "192.168.178.214",
"name" : "sms-sms2", "hostname" : "sms-sms2", "add_date" : 1598403465000, "os_type" : "WINDOWS",
"os_version" : "WINDOWS2012_R2_64BIT", "oem_system" : false,
"name" : "OS_VERSION",
"name" : "PARTITION_STYLE", "result" : "OK",
}, {
"init_target_server" : { "disks" : [ {
"stage_action_time" : 1598403465315, "totalsize" : 0,
"last_visit_time" : 1598403588140, "migration_cycle" : "checking", "state_action_time" : 1598403465414 }, {
"id" : "1a9aee6c-eadb-4269-89af-57b4b734a809", "ip" : "192.168.0.1",
"name" : "linux sources", "hostname" : "sms-console", "add_date" : 1598369476000, "os_type" : "LINUX",
"os_version" : "REDHAT_7_3_64BIT", "oem_system" : false,
"state" : "unavailable", "connected" : false, "cpu_quantity" : 4, "memory" : 8581140480, "current_task" : null, "checks" : [ ], "init_target_server" : { "disks" : [ {
"stage_action_time" : 1598369475726, "totalsize" : 0,
"last_visit_time" : 1598369475725, "migration_cycle" : "checking",
"state_action_time" : null }, {
"id" : "2d41ea08-eb93-4a0a-a0c3-fd7a92828347", "ip" : "192.168.0.1",
"name" : "linux sources", "hostname" : "sms-console", "add_date" : 1598351694000, "os_type" : "LINUX",
"os_version" : "REDHAT_7_3_64BIT", "oem_system" : false,
"state" : "unavailable", "connected" : false, "cpu_quantity" : 4, "memory" : 8581140480, "current_task" : null, "checks" : [ ], "init_target_server" : { "disks" : [ {
"stage_action_time" : 1598351693858, "totalsize" : 0,
"last_visit_time" : 1598351693857, "migration_cycle" : "checking", "state_action_time" : null }, {
"id" : "d8ab16fe-4cdc-402e-a700-533dd8901bd5", "ip" : "192.168.0.1",
"name" : "linux sources", "hostname" : "sms-console", "add_date" : 1598348080000, "os_type" : "LINUX",
"os_version" : "REDHAT_7_3_64BIT", "oem_system" : false,
"state" : "unavailable", "connected" : false, "cpu_quantity" : 4, "memory" : 8581140480, "current_task" : null, "checks" : [ ], "init_target_server" : { "disks" : [ {
"stage_action_time" : 1598348079782, "totalsize" : 0,
"last_visit_time" : 1598348079781, "migration_cycle" : "checking", "state_action_time" : null }, {
"id" : "02d6a461-b7a4-44ef-b37a-13abe57a715f", "ip" : "192.168.0.239",
"name" : "sms-centos7",
"hostname" : null,
"add_date" : 1598326505000, "os_type" : "LINUX",
"os_version" : "CENTOS_8_5_64BIT", "oem_system" : false,
"state" : "unavailable", "connected" : false,
"name" : "PARAVIRTUALIZATION", "result" : "OK",
}, {
"name" : "PARTITION_STYLE", "result" : "OK",
"name" : "LINUX_BLOCK_SUPPORT", "result" : "OK",
"error_code" : null, "error_or_warn" : null, "error_params" : ""
} ],
"init_target_server" : { "disks" : [ {
"stage_action_time" : 1598326505378, "totalsize" : 0,
"last_visit_time" : 1598423828868, "migration_cycle" : "checking", "state_action_time" : 1598326505459 }, {
"id" : "ee28ac0d-4f5d-479d-869c-e904aafbba70", "ip" : "192.168.0.65",
"name" : "smsc-test", "hostname" : null,
"add_date" : 1598238727000, "os_type" : "LINUX",
"os_version" : "CENTOS_6_5_64BIT", "oem_system" : false,
"state" : "finished", "connected" : true,
"cpu_quantity" : 1, "memory" : 1043931136, "current_task" : {
"id" : "c943d962-dc48-4d2c-80a1-b1102363bf9c", "name" : "MigrationTask",
"type" : "MIGRATE_FILE", "state" : "MIGRATE_SUCCESS", "estimate_complete_time" : null, "start_date" : 1598239243000, "speed_limit" : 0,
"migrate_speed" : 0.0, "start_target_server" : true,
"vm_template_id" : "8751d34d-a79c-4f32-a3aa-24389db219a9", "region_id" : "region_id",
"project_name" : "project_name",
"project_id" : "06334e957c80d2642f39c0030856abdb", "target_server" : {
"vm_id" : "705e6fd0-53d9-47e1-b58d-484730ba9ba9", "name" : "smsc-test"
},
"log_collect_status" : "INIT", "exist_server" : false,
"name" : "PARAVIRTUALIZATION", "result" : "OK",
"name" : "BOOT_LOADER",
"name" : "PARTITION_STYLE", "result" : "OK",
"name" : "LINUX_BLOCK_SUPPORT", "result" : "WARN",
"error_code" : "SMS.6617", "error_or_warn" : null, "error_params" : ""
} ],
"init_target_server" : { "disks" : [ {
"stage_action_time" : 1598240178677, "totalsize" : 0,
"last_visit_time" : 1598434314748,
"migration_cycle" : "cutovered", "state_action_time" : 1598240178677 } ]
}
状态码
状态码 描述
200 查询源端服务器列表成功。
500 Internal Server Error
错误码
请参见错误码。