• Elastic Cloud Server

ecs
  1. Help Center
  2. Elastic Cloud Server
  3. API Reference
  4. Extension ECS APIs
  5. Status Management
  6. Cold Migrating an ECS

Cold Migrating an ECS

Function Description

  • An ECS deployed on a DeH can be migrated to another DeH.
  • An ECS deployed on a DeH can be migrated to a public resource pool.
  • An ECS deployed in a public resource pool can be migrated to a DeH.

Constraints

  • Only a stopped ECS can be cold migrated.
  • Existing constraints of the native cold migration interface are inherited.

URI

POST /v1/{project_id}/cloudservers/{server_id}/migrate

Table 1 describes the parameters in the URI.
Table 1 Parameter description

Parameter

Mandatory

Description

project_id

Yes

Specifies the project ID.

server_id

Yes

Specifies the ECS ID.

Request

Request parameters

Table 2 describes the request parameters.
Table 2 Request parameters

Parameter

Mandatory

Type

Description

migrate

Yes

Dictionary data structure

Specifies the ECS to be migrated. For details, see Table 3.

When migrating an ECS from a DeH to a public resource pool, the migrate value is null.

Table 3 migrate field description

Parameter

Mandatory

Type

Description

dedicated_host_id

No

String

Specifies the DeH ID.

This parameter takes effect when an ECS is migrated from a public resource pool to a DeH or when an ECS is migrated between DeHs.

Response

See Responses (Task).

Examples

  • Example request
    {
    "migrate": {
            "dedicated_host_id": "459a2b9d-804a-4745-ab19-a113bb1b4ddc"
        }
    }
    Or
    {
    "migrate": null
    }

Returned Values

See General Request Returned Values.

Error Code

See Error Code Description.