查询待迁移源端的所有错误
功能介绍
主机迁移过程中可能发生错误，使用该接口可以批量查询迁移过程中出现错误的源端服务器信息，以及它们的错误信息。
调用方法
请参见如何调用API。
URI
GET /v3/errors
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| limit | 否 | Integer | 每一页记录的错误数量 最小值：0 最大值：100 缺省值：50 |
| offset | 是 | Integer | 偏移量 最小值：0 最大值：65535 缺省值：0 |
| migproject | 否 | String | 需要查询的迁移项目ID，添加此字段将只查询对应ID下的迁移任务报错信息 最小长度：0 最大长度：255 |
| enterprise_project_id | 否 | String | 需要查询的企业项目ID 最小长度：0 最大长度：255 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| X-Auth-Token | 是 | String | 用户Token。通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 最小长度：1 最大长度：16384 |
响应参数
状态码：200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| count | Integer | 迁移过程中发生错误的源端数量 最小值：0 最大值：2147483647 |
| migration_errors | Array of MigrationErrors objects | 迁移过程中发生的错误详情 数组长度：0 - 65535 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| 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 |
状态码：403
| 参数 | 参数类型 | 描述 |
|---|---|---|
| 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 |
请求示例
批量查询迁移过程中出现错误的源端服务器信息，每页10个源端，查看第0页。
GET https://{endpoint}/v3/errors?limit=10&offset=0 响应示例
状态码：200
查询待迁移源端的所有错误成功
{
"count" : 4,
"migration_errors" : [ {
"source_id" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
"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" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
"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" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
"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" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001",
"source_ip" : "192.168.77.77",
"target_ip" : null,
"name" : "sms-centos",
"host_name" : null,
"error_json" : "{\"error_code\":\"SMS.3805\",\"error_param\":\"[]\"}"
} ]
} 状态码：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 | 查询待迁移源端的所有错误成功 |
| 403 | 鉴权失败 |
错误码
请参见错误码。
