文档首页 > > API参考> API> 源端管理> 查询指定ID的源端服务器

查询指定ID的源端服务器

分享
更新时间: 2019/03/19 GMT+08:00

功能介绍

迁移Agent将源端服务器信息上报到主机迁移服务后,主机迁移服务会对迁移的可行性进行检测,该接口返回源端服务器的基本信息和检查结果。

URI

GET /v1/sms/sources/{source_id}

参数说明请参见 表1
表1 参数说明

参数

是否必选

描述

source_id

源端服务器的ID

请求消息

不涉及

响应消息

响应参数

响应参数如表2所示。

表2 响应参数

参数

参数类型

描述

id

String

该源端服务器在主机迁移服务上的ID

ip

String

源端服务器的IP地址

os_type

String

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

os_version

String

操作系统版本,如WINDOWS7_64BIT

name

String

源端服务器的名称,可以更改

hostname

String

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

add_date

long

源端服务器被添加到主机迁移服务的时间。单位毫秒

oem_system

Boolean

源端服务器是否为oem操作系统

state

String

源端服务器的检查状态

  • CHECKING:检查中
  • AVAILABLE:检查通过,可以迁移上云
  • UNAVAILABLE:检查失败,不能迁移

connected

Boolean

该源端服务器与主机迁移服务是否处于连接状态

  • true:源端服务器同主机迁移服务连接正常
  • false:源端服务器同主机迁移服务失去连接

firmware

String

源端服务器启动类型,如BIOS或者UEFI

cpu_quantity

Integer

CPU个数,单位个

memory

long

内存大小,单位MB

disks

JSON数组

源端服务器的磁盘信息,参见表3

volume_groups

JSON数组

Linux主机的卷组信息,参见表5

network

JSON数组

源端服务器的网卡信息,参见表7

checks

JSON数组

源端服务器的检查项,参见表8

init_target_server

JSON

推荐的目的端服务器配置,参见表9

表3 disks数据结构

参数

参数类型

描述

name

String

磁盘名称

partition_style

String

磁盘的分区类型。如MBR、GPT等

size

long

磁盘总大小,以字节为单位

used_size

long

磁盘已使用大小,以字节为单位

device_use

String

磁盘用途

  • BOOT:引导分区在该磁盘上
  • OS:系统分区在该磁盘上

os_disk

Boolean

是否是系统盘

  • true:该磁盘为系统盘
  • false:该磁盘为数据盘

physical_volumes

JSON数组

磁盘上的物理分区信息,参见表4

表4 physical_volumes中数据元素的数据结构

参数

参数类型

描述

uuid

String

该分区的UUID

index

Integer

该物理分区的序号

  • 0:第一个分区
  • 1:第二个分区

name

String

分区名称,如Windows的C和Linux的/dev/vda1

device_use

String

分区的用户,取值OS或者BOOT

file_system

String

分区的文件系统类型

mount_point

String

挂载点

size

Long

分区总共大小

used_size

Long

分区已使用大小

表5 volume_groups数据结构

参数

参数类型

描述

name

String

卷组名称

components

String

组成该卷组的物理分区和磁盘的名称

size

long

卷组总大小

free_size

long

剩余空间大小,单位:字节

logic_volumes

JSON数组

卷组上的逻辑卷信息,参见表6

表6 logic_volumes数据结构

参数

参数类型

描述

name

String

该逻辑分区名称

size

long

该分区总大小

used_size

long

该分区已使用大小,单位:字节

free_size

long

该分区剩余空间大小,单位:字节

file_system

String

该分区的文件系统类型

mount_point

String

逻辑卷的挂载点

uuid

String

该分区的UUID

inode_size

int

文件系统Inode大小

block_size

int

文件系统块大小,单位:字节

block_count

long

该逻辑分区块的总个数

表7 network数据结构

参数

参数类型

描述

name

String

网卡的名称

ip

String

该网卡绑定的IP

netmask

String

掩码

gateway

String

网关

mtu

Integer

网卡的MTU

表8 checks数据结构

参数

参数类型

描述

id

String

该检查项的ID

name

String

检查项名称

result

String

检查结果

  • OK:检查通过
  • WARN:告警
  • ERROR:检查不通过

error_code

String

检查不通过的错误码

error_params

Integer

检查不通过的错误参数

表9 init_target_server 数据结构

参数

参数类型

描述

disks

JSON数组

推荐的目的端服务器的磁盘信息,参见表10

表10 disks数组中成员结构

参数

参数类型

描述

name

String

磁盘名称

size

long

磁盘大小,单位字节

device_use

String

磁盘作用

  • OS:系统盘
  • NORMAL:数据盘

示例

  • 请求示例

    无请求消息。

  • 响应示例
    • 源端服务器为Windows操作系统时的响应
      {
        "id": "f36fa247-ac20-48b7-ba80-941b31d7718c",
        "ip": "10.40.45.118",
        "name": "szxy2",
        "hostname": "szxy2",
        "add_date": 1528675263000,
        "os_type": "WINDOWS",
        "os_version": "WINDOWS7_64BIT",
        "oem_system": false,
        "state": "AVAILABLE",
        "connected": false,
        "firmware": "BIOS",
        "cpu_quantity": 4,
        "memory": 17171075072,
        "current_task": null,
        "disks": [
          {
            "name": "Disk 0",
            "partition_style": "MBR",
            "relation_name": null,
            "size": 85897247744,
            "used_size": 85897247744,
            "device_use": "BOOT",
            "os_disk": false,
            "physical_volumes": [
              {
                "uuid": "\\?\Volume{e36afecb-24da-11e7-b949-806e6f6e6963}\",
                "index": 0,
                "name": "(Reserved)",
                "dos_name": null,
                "relation_name": null,
                "file_system": "NTFS",
                "size_per_cluster": 4096,
                "start_offset": 1048576,
                "total_sectors": 0,
                "hiden_sectors": 0,
                "sectors_per_track": 0,
                "start_sectors": 2048,
                "mount_point": null,
                "size": 104857088,
                "used_size": 25878016,
                "snap_mount_point": null,
                "device_use": "BOOT"
              },
              {
                "uuid": "\\?\Volume{e36afecc-24da-11e7-b949-806e6f6e6963}\",
                "index": 0,
                "name": "C:\\",
                "dos_name": null,
                "relation_name": null,
                "file_system": "NTFS",
                "size_per_cluster": 4096,
                "start_offset": 105906176,
                "total_sectors": 0,
                "hiden_sectors": 0,
                "sectors_per_track": 0,
                "start_sectors": 206848,
                "mount_point": null,
                "size": 85792390656,
                "used_size": 55866973696,
                "snap_mount_point": null,
                "device_use": "OS"
              }
            ]
          },
          {
            "name": "Disk 1",
            "partition_style": "MBR",
            "relation_name": null,
            "size": 214745218560,
            "used_size": 214745218560,
            "device_use": "",
            "os_disk": false,
            "physical_volumes": [
              {
                "uuid": "\\?\Volume{e36afecd-24da-11e7-b949-806e6f6e6963}\",
                "index": 0,
                "name": "D:\\",
                "dos_name": null,
                "relation_name": null,
                "file_system": "NTFS",
                "size_per_cluster": 4096,
                "start_offset": 1048576,
                "total_sectors": 0,
                "hiden_sectors": 0,
                "sectors_per_track": 0,
                "start_sectors": 2048,
                "mount_point": null,
                "size": 214745218560,
                "used_size": 128071798272,
                "snap_mount_point": null,
                "device_use": ""
              }
            ]
          }
        ],
        "volume_groups": [],
        "networks": [
          {
            "name": null,
            "ip": null,
            "netmask": null,
            "gateway": null,
            "mtu": 0,
            "mac": "0XB93064096C2C"
          }
        ],
        "checks": [
          {
            "id": 20749,
            "params": [
              ""
            ],
            "name": "OS_VERSION",
            "result": "OK",
            "error_code": null,
            "error_params": ""
          },
          {
            "id": 20756,
            "params": [
              ""
            ],
            "name": "FIRMWARE",
            "result": "OK",
            "error_code": null,
            "error_params": ""
          },
          {
            "id": 20763,
            "params": [
              ""
            ],
            "name": "CPU",
            "result": "OK",
            "error_code": null,
            "error_params": ""
          },
          {
            "id": 20770,
            "params": [
              ""
            ],
            "name": "MEMORY",
            "result": "OK",
            "error_code": null,
            "error_params": ""
          },
          {
            "id": 20777,
            "params": [
              ""
            ],
            "name": "SYSTEM_ROOT",
            "result": "OK",
            "error_code": null,
            "error_params": ""
          },
          {
            "id": 20784,
            "params": [
              ""
            ],
            "name": "PARTITION_STYLE",
            "result": "OK",
            "error_code": null,
            "error_params": ""
          },
          {
            "id": 20791,
            "params": [
              ""
            ],
            "name": "FILE_SYSTEM",
            "result": "OK",
            "error_code": null,
            "error_params": ""
          },
          {
            "id": 20798,
            "params": [
              ""
            ],
            "name": "FREE_SPACE",
            "result": "OK",
            "error_code": null,
            "error_params": ""
          },
          {
            "id": 20805,
            "params": [
              ""
            ],
            "name": "OEM_SYSTEM",
            "result": "OK",
            "error_code": null,
            "error_params": ""
          },
          {
            "id": 20812,
            "params": [
              ""
            ],
            "name": "DRIVER_FILE",
            "result": "OK",
            "error_code": null,
            "error_params": ""
          },
          {
            "id": 20819,
            "params": [
              ""
            ],
            "name": "SERVICE",
            "result": "OK",
            "error_code": null,
            "error_params": ""
          },
          {
            "id": 20826,
            "params": [
              ""
            ],
            "name": "ACCOUNT_RIGHTS",
            "result": "OK",
            "error_code": null,
            "error_params": ""
          }
        ],
        "init_target_server": null
      }         
    • 当源端服务器为Linux操作系统时的响应
      {
        "id": "45a02115-28a9-40c2-8604-0abfc9889c9d",
        "ip": "192.168.0.151",
        "name": "novalocal",
        "hostname": null,
        "add_date": 1532658611000,
        "os_type": "LINUX",
        "os_version": "CENTOS_7_2_64BIT",
        "oem_system": false,
        "state": "AVAILABLE",
        "connected": false,
        "firmware": "BIOS",
        "cpu_quantity": 2,
        "memory": 4,
        "current_task": null,
        "disks": [
          {
            "name": "/dev/xvda",
            "relation_name": null,
            "partition_style": "MBR",
            "size": 42949672960,
            "used_size": 42948606976,
            "device_use": "NORMAL",
            "os_disk": false,
            "physical_volumes": [
              {
                "uuid": null,
                "index": 0,
                "name": "/dev/xvda1",
                "device_use": "NORMAL",
                "file_system": "ext3",
                "mount_point": "/",
                "size": 42948606976,
                "used_size": 2853855232
              }
            ]
          },
          {
            "name": "/dev/xvdb",
            "relation_name": null,
            "partition_style": "MBR",
            "size": 10737418240,
            "used_size": 6442450944,
            "device_use": "NORMAL",
            "os_disk": false,
            "physical_volumes": [
              {
                "uuid": null,
                "index": 0,
                "name": "/dev/xvdb1",
                "device_use": "NORMAL",
                "file_system": "swap",
                "mount_point": "",
                "size": 1073741824,
                "used_size": 1073741824
              },
              {
                "uuid": null,
                "index": 0,
                "name": "/dev/xvdb2",
                "device_use": "VOLUME_GROUP",
                "file_system": "LVM2_member",
                "mount_point": "",
                "size": 5368709120,
                "used_size": 5368709120
              }
            ]
          },
          {
            "name": "/dev/xvdc",
            "relation_name": null,
            "partition_style": "MBR",
            "size": 10737418240,
            "used_size": 10737418240,
            "device_use": "VOLUME_GROUP",
            "os_disk": false,
            "physical_volumes": []
          }
        ],
        "volume_groups": [
          {
            "name": "vgtest",
            "components": "/dev/xvdb2;/dev/xvdc",
            "size": 16106127360,
            "free_size": 0,
            "logical_volumes": [
              {
                "name": "/dev/mapper/vgtest-data",
                "size": 1073741824,
                "used_size": 3047424,
                "file_system": "ext4",
                "mount_point": "/data",
                "uuid": null,
                "inode_size": 256,
                "block_size": 0,
                "block_count": 0
              }
            ]
          }
        ],
        "networks": [
          {
            "name": "eth0",
            "ip": "192.168.0.151",
            "netmask": null,
            "gateway": null,
            "mtu": 0,
            "mac": "fa:16:3e:35:97:71"
          }
        ],
        "checks": [
          {
            "id": 6463,
            "params": [
              ""
            ],
            "name": "OS_VERSION",
            "result": "OK",
            "error_code": null,
            "error_params": ""
          },
          {
            "id": 6470,
            "params": [
              ""
            ],
            "name": "CPU",
            "result": "OK",
            "error_code": null,
            "error_params": ""
          },
          {
            "id": 6477,
            "params": [
              ""
            ],
            "name": "MEMORY",
            "result": "OK",
            "error_code": null,
            "error_params": ""
          },
          {
            "id": 6484,
            "params": [
              ""
            ],
            "name": "PARAVIRTUALIZATION",
            "result": "OK",
            "error_code": null,
            "error_params": ""
          },
          {
            "id": 6491,
            "params": [
              ""
            ],
            "name": "FIRMWARE",
            "result": "OK",
            "error_code": null,
            "error_params": ""
          },
          {
            "id": 6498,
            "params": [
              ""
            ],
            "name": "BOOT_LOADER",
            "result": "OK",
            "error_code": null,
            "error_params": ""
          },
          {
            "id": 6505,
            "params": [
              ""
            ],
            "name": "RSYNC",
            "result": "OK",
            "error_code": null,
            "error_params": ""
          },
          {
            "id": 6512,
            "params": [
              ""
            ],
            "name": "RAW_DEVICES",
            "result": "OK",
            "error_code": null,
            "error_params": ""
          },
          {
            "id": 6519,
            "params": [
              ""
            ],
            "name": "DISK_INFO",
            "result": "OK",
            "error_code": null,
            "error_params": ""
          },
          {
            "id": 6526,
            "params": [
              ""
            ],
            "name": "PARTITION_STYLE",
            "result": "OK",
            "error_code": null,
            "error_params": ""
          },
          {
            "id": 6533,
            "params": [
              ""
            ],
            "name": "FILE_SYSTEM",
            "result": "OK",
            "error_code": null,
            "error_params": ""
          }
        ],
        "init_target_server": {
          "disks": [
            {
              "name": "/dev/xvda",
              "size": 42949672960,
              "used_size": 42948606976,
              "device_use": "NORMAL",
              "physical_volumes": [
                {
                  "uuid": null,
                  "index": 0,
                  "name": "/dev/xvda1",
                  "device_use": "NORMAL",
                  "file_system": "ext3",
                  "mount_point": "/",
                  "size": 42948606976,
                  "used_size": 2853855232
                }
              ]
            },
            {
              "name": "/dev/xvdb",
              "size": 10737418240,
              "used_size": 6442450944,
              "device_use": "NORMAL",
              "physical_volumes": [
                {
                  "uuid": null,
                  "index": 0,
                  "name": "/dev/xvdb1",
                  "device_use": "NORMAL",
                  "file_system": "swap",
                  "mount_point": "",
                  "size": 1073741824,
                  "used_size": 1073741824
                },
                {
                  "uuid": null,
                  "index": 0,
                  "name": "/dev/xvdb2",
                  "device_use": "VOLUME_GROUP",
                  "file_system": "LVM2_member",
                  "mount_point": "",
                  "size": 5368709120,
                  "used_size": 5368709120
                }
              ]
            },
            {
              "name": "/dev/xvdc",
              "size": 10737418240,
              "used_size": 10737418240,
              "device_use": "VOLUME_GROUP",
              "physical_volumes": []
            }
          ]
        }
      }

状态码

状态码请参见状态码

错误码

请参见错误码

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

跳转到云社区