文档首页> 主机迁移服务 SMS> API参考（吉隆坡区域）> 历史API> 源端管理> 查询源端服务器列表
更新时间：2022-08-02 GMT+08:00
查看PDF

查询源端服务器列表

功能介绍

查询源端列表信息。

URI

GET /v1/sms/sources

请求消息

请求参数

请求参数如表1所示。

表1 请求参数

参数

是否必选

参数类型

描述

state

否

String

源端服务器的状态

name

否

String

源端服务器的名称

id

否

String

源端服务器的ID

ip

否

String

源端服务器的IP地址

num_per_page

否

int

每一页记录的源端服务器数量

page_num

否

int

第几页（下标从0开始）

响应消息

响应参数

响应参数如表2所示。

表2 响应参数

参数

参数类型

描述

count

int

源端个数

source_servers

Json数组

源端列表，参见表3
表3 source_servers数据结构

参数

参数类型

描述

id

String

这条记录在SMS数据库中的ID

ip

String

源端服务器的ip

name

String

用来区分不同源端服务器的名称

hostname

String

登录源端服务器后显示的名称

add_date

long

上报到主机迁移服务的时间戳

os_type

String

源端服务器的OS类型，分为WINDOWS或者LINUX

os_version

String

操作系统版本，例如：WINDOWS7_64BIT

oem_system

Boolean

该系统是否为oem操作系统

state

String

源端服务器的检查状态

  • CHECKING：检查中
  • AVAILABLE：检查通过，源端服务器OS和数据可以迁移上云
  • UNAVAILABLE：检查失败，源端服务器OS和数据不能迁移

connected

Boolean

源端服务器上的迁移Agent同SMS服务端的连接状态

  • true：源端服务器同SMS服务端连接正常
  • false：源端服务器同SMS服务端失去连接

current_task

JSON

当前源端服务器绑定的任务信息，参见表6

init_target_server

JSON

推荐迁移到的目的端服务器的规格，参见表4
表4 init_target_server对象

参数

参数类型

描述

disks

JSON数组

建议的目的端服务器的磁盘信息，参见表5
表5 disks数组中成员结构

参数

参数类型

描述

name

String

磁盘名称

size

long

磁盘大小，单位字节

device_use

JSON

磁盘的作用

  • BOOT：启动盘
  • OS：系统盘
  • NORMAL：普通数据盘
表6 current_task信息

参数

参数类型

描述

id

String

源端服务器关联任务的id

name

String

源端服务器关联任务的名称

state

String

源端服务器关联任务的状态

  • READY：等待开始
  • RUNNING：进行中
  • SYNCING：同步增量数据中
  • SUCCESS：迁移/同步成功
  • FAIL：迁移/同步失败
  • ABORTING：迁移/同步任务暂停中
  • ABORT：已停止

示例

  • 请求示例

    无请求消息

  • 响应示例
    {
  "count": 1,
  "source_servers": [
    {
      "id": "80d6d78d-3350-4c6e-92b1-3ad88b16d8d8",
      "ip": "x.x.x.x",
      "name": "first",
      "hostname": "hello",
      "add_date": 1528178836000,
      "os_type": "WINDOWS",
      "os_version": "WINDOWS7_64BIT",
      "os_description": null,
      "oem_system": false,
      "state": "UNAVAILABLE",
      "connected": false,
      "current_task": {
        "id": "dfedc7eb-cadc-4f27-ae3c-b5e4f05e1c83",
        "name": "sms_task_smssrc",
        "state": "SUCCESS"
       },
      "init_target_server": {
        "disks": [
          {
            "name": "Disk 0",
            "size": 171798691840,
            "device_use": "OS"
          },
          {
            "name": "Disk 1",
            "size": 215822106624,
            "device_use": "NORMAL"
          }
        ]
      }
    }
}

状态码

状态码请参见状态码。

父主题： 源端管理