更新时间:2022-08-05 GMT+08:00

查询待迁移源端的所有错误

功能介绍

主机迁移过程中可能发生错误,使用该接口可以批量查询迁移过程中出现错误的源端服务器信息,以及它们的错误信息。

URI

GET /v3/errors

表1 Query参数

参数

是否必选

参数类型

描述

limit

Integer

每一页记录的错误数量

最小值:0

最大值:100

缺省值:50

offset

Integer

偏移量

最小值:0

最大值:65535

缺省值:0

migproject

String

需要查询的迁移项目id,添加此字段将只查询对应id下的迁移任务报错信息

最小长度:0

最大长度:255

enterprise_project_id

String

需要查询的企业项目id

最小长度:0

最大长度:255

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

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

最小长度:1

最大长度:16384

响应参数

状态码: 200

表3 响应Body参数

参数

参数类型

描述

count

Integer

迁移过程中发生错误的源端数量

最小值:0

最大值:2147483647

migration_errors

Array of MigrationErrors objects

迁移过程中发生的错误详情

表4 MigrationErrors

参数

参数类型

描述

error_json

String

保存错误信息的json字符串

最小长度:0

最大长度:255

host_name

String

主机名称(从用户系统获取,可能为空)

最小长度:0

最大长度:255

name

String

源端在主机迁移服务中的名称

最小长度:0

最大长度:255

source_id

String

源端服务器id

最小长度:0

最大长度:255

source_ip

String

源端服务器的ip

最小长度:0

最大长度:255

target_ip

String

目的端服务器的ip

最小长度:0

最大长度:255

请求示例

批量查询迁移过程中出现错误的源端服务器信息,每页10个源端,查看第0页。

GET https://{endpoint}/v3/errors?limit=10&offset=0

响应示例

状态码: 200

OK

{
  "count" : 4,
  "migration_errors" : [ {
    "source_id" : "b5d13e46-fb5f-41da-952a-d7a38c1e47fd",
    "source_ip" : "192.168.0.235",
    "target_ip" : null,
    "name" : "sms-ubuntu",
    "host_name" : null,
    "error_json" : "{\"error_code\":\"SMS.1302\",\"error_param\":\"[\\\"/\\\", \\\"/mnt/vdb1\\\"]\"}"
  }, {
    "source_id" : "e7029ea3-fec8-49ca-9cae-9158af0d8419",
    "source_ip" : "192.168.0.163",
    "target_ip" : null,
    "name" : "sms-win08",
    "host_name" : "sms-win08",
    "error_json" : "{\"error_param\":\"[\\\"192.168.0.1\\\"]\",\"error_code\":\"SMS.2802\"}"
  }, {
    "source_id" : "c4d1d596-24c2-49ec-9fcf-32e9d28f750d",
    "source_ip" : "192.168.0.154",
    "target_ip" : null,
    "name" : "sms-win16",
    "host_name" : "sms-win16",
    "error_json" : "{\"error_code\":\"SMS.1114\",\"error_param\":\"[]\"}"
  }, {
    "source_id" : "490d5aac-f8de-4479-811e-72ed30834be4",
    "source_ip" : "192.168.77.77",
    "target_ip" : null,
    "name" : "sms-centos",
    "host_name" : null,
    "error_json" : "{\"error_code\":\"SMS.3805\",\"error_param\":\"[]\"}"
  } ]
}

状态码

状态码

描述

200

OK

错误码

请参见错误码