Updated on 2024-05-11 GMT+08:00

Querying the Migration

Function

This API is used to query the migration result.

Debugging

You can debug this API through automatic authentication in API Explorer or use the SDK sample code generated by API Explorer.

URI

GET /v3/migrates

Table 1 Query Parameters

Parameter

Mandatory

Type

Description

all_regions

No

Boolean

Whether to query the migration results in other regions

Default: true

Request Parameters

None

Response Parameters

Status code: 200

Table 2 Response body parameters

Parameter

Type

Description

status

String

Tenant migration status

Enumeration values:

  • success

  • failed

  • migrating

project_status

Array of DomainMigrateProjectStatus objects

Project migration status

Table 3 DomainMigrateProjectStatus

Parameter

Type

Description

status

String

Migration status

Enumeration values:

  • migrating

  • success

  • failed

project_id

String

Project ID

project_name

String

Project Name

region_id

String

Region ID

progress

Integer

Migration progress

Minimum: 0

Maximum: 100

fail_code

Integer

Error code. This parameter appears only when the project status is failed.

fail_reason

String

Failure cause. This parameter appears only when the project status is failed.

Example Requests

https://{endpoint}/v3/migrates

Example Responses

Status code: 200

OK

{
  "status" : "failed",
  "project_status" : [ {
    "status" : "failed",
    "progress" : 1,
    "project_id" : "fe1431a61f4242dd87e548f8f42ec0b4",
    "project_name" : "cn-north-7",
    "region_id" : "cn-north-7",
    "fail_code" : 4002,
    "fail_reason" : "An error occurred when converting models: dictionary keys changed during iteration."
  }, {
    "status" : "success",
    "progress" : 100,
    "project_id" : "bccd81411c254e6890fe88d2f2ce406b",
    "project_name" : "cn-north-7-virtual",
    "region_id" : "cn-north-7"
  } ]
}

Status Codes

Status Code

Description

200

OK

Error Codes

See Error Codes.