Creating an Online Data Migration Task

Function

This API is used to create an online data migration task.

URI

POST /v2/{project_id}/migration/instance

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID.

Request Parameters

**Table 2** Request body parameters
Parameter	Mandatory	Type	Description
name	Yes	String	Name of the online migration task.
description	No	String	Description of the online migration task.
vpc_id	Yes	String	VPC ID. Log in to the VPC console, and click the name of a VPC to view the VPC ID on the displayed details page.
subnet_id	Yes	String	Subnet network ID. Log in to the VPC console and click the target subnet on the Subnets page. You can view the network ID on the displayed page.
security_group_id	Yes	String	ID of the security group to which the instance belongs. A security group implements access control for associated ECSs, improving security. You can define different access rules for a security group to protect the VMs that are added to this security group. Log in to the VPC console and choose Access Control > Security Groups. You can create and configure a security group, and obtain the security group ID.

Response Parameters

Status code: 200

**Table 3** Response body parameters
Parameter	Type	Description
instance_id	String	Online migration task ID.

Status code: 400

**Table 4** Response body parameters
Parameter	Type	Description
error_msg	String	Error message. Maximum: 1024
error_code	String	Error code. Maximum: 9
error_ext_msg	String	Extended error information. This parameter is not used currently and is set to null. Maximum: 1024

Status code: 401

**Table 5** Response body parameters
Parameter	Type	Description
error_msg	String	Error message. Maximum: 1024
error_code	String	Error code. Maximum: 9
error_ext_msg	String	Extended error information. This parameter is not used currently and is set to null. Maximum: 1024

Status code: 403

**Table 6** Response body parameters
Parameter	Type	Description
error_msg	String	Error message. Maximum: 1024
error_code	String	Error code. Maximum: 9
error_ext_msg	String	Extended error information. This parameter is not used currently and is set to null. Maximum: 1024

Status code: 404

**Table 7** Response body parameters
Parameter	Type	Description
error_msg	String	Error message. Maximum: 1024
error_code	String	Error code. Maximum: 9
error_ext_msg	String	Extended error information. This parameter is not used currently and is set to null. Maximum: 1024

Status code: 500

**Table 8** Response body parameters
Parameter	Type	Description
error_msg	String	Error message. Maximum: 1024
error_code	String	Error code. Maximum: 9
error_ext_msg	String	Extended error information. This parameter is not used currently and is set to null. Maximum: 1024

Example Requests

POST https://{dcs_endpoint}/v2/{project_id}/migration/instance

{
  "name" : "dcs-migration-thrc",
  "description" : "Creating an online data migration task",
  "vpc_id" : "5e37b3be-950a-48e1-b498-65b63d336481",
  "subnet_id" : "40f15ed6-7f85-49d5-ba0e-65b940d4812c",
  "security_group_id" : "9df96622-24b7-4813-84b8-ab74552a21d7"
}

Example Responses

Status code: 200

Online data migration task created.

{
  "instance_id" : "b21989ec-2889-4b8e-99db-19c073425ec2"
}

Status Codes

Status Code	Description
200	Online data migration task created.
400	Invalid request.
401	Invalid authentication information.
403	The request is rejected.
404	The requested resource is not found.
500	Internal service error.