Listing Failed Source Servers

Function

This API is used to query the list of source servers that failed to be migrated and the error messages.

URI

GET /v3/errors

**Table 1** Query parameters
Parameter	Mandatory	Type	Description
limit	No	Integer	Specifies the number of failed source servers recorded on each page. Minimum value: 0 Maximum value: 100 Default value: 50
offset	Yes	Integer	Specifies the offset. Minimum value: 0 Maximum value: 65535 Default value: 0
migproject	No	String	Specifies the ID of the migration project in which the failed source servers will be queried. If this parameter is specified, only the failed source servers in migration tasks under the project are queried. Minimum length: 0 characters Maximum length: 255 characters
enterprise_project_id	No	String	Specifies the ID of the enterprise project to be queried. Minimum length: 0 characters Maximum length: 255 characters

Request

**Table 2** Request header parameter
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	Specifies the user token. It can be obtained by calling the IAM API (value of X-Subject-Token in the response header). Minimum length: 1 character Maximum length: 16,384 characters

Response

Status code: 200

**Table 3** Response body parameters
Parameter	Type	Description
count	Integer	Specifies the number of source servers that failed to be migrated due to errors. Minimum value: 0 Maximum value: 2147483647
migration_errors	Array of MigrationErrors objects	Specifies the details of the failed source servers.

**Table 4** **MigrationErrors** field description
Parameter	Type	Description
error_json	String	Specifies the error message in JSON format. Minimum length: 0 characters Maximum length: 255 characters
host_name	String	Specifies the host name of the source server, which is obtained from the user system and may be empty. Minimum length: 0 characters Maximum length: 255 characters
name	String	Specifies the source server name defined on the SMS console. Minimum length: 0 characters Maximum length: 255 characters
source_id	String	Specifies the source server ID. Minimum length: 0 characters Maximum length: 255 characters
source_ip	String	Specifies the IP address of the source server. Minimum length: 0 characters Maximum length: 255 characters
target_ip	String	Specifies the IP address of the target server. Minimum length: 0 characters Maximum length: 255 characters

Example Request

Query the list of source servers that failed to be migrated due to errors. Record 10 source servers on each page, and display the servers recorded on page 0.

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

Example Response

Status code: 200

{
  "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\":\"[]\"}"
  } ]
}