Imports Elastic Compute Service (ECS) instances into an ECS cluster.

Limits

When you call this operation to import an ECS instance, the operating system of the ECS instance is reinstalled. After the operating system is reinstalled, all data of the ECS instance is deleted. You must set a logon password for the ECS instance. Make sure that no important data exists or data has been backed up on the ECS instance that you want to import.

Note We recommend that you call the InstallAgent operation instead of this operation to import ECS instances into an ECS cluster. For more information, see InstallAgent.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request headers

This operation uses only common request headers. For more information, see the topic about common request parameters.

Request syntax

POST /pop/v5/resource/cluster_member HTTP/1.1

Request parameters

Parameter Type Position Required Example Description
clusterId String Query Yes b3e3f77b-462e-****-****-bec8727a4dc8

The ID of the cluster into which you want to import ECS instances.

instanceIds String Query Yes i-2ze7s2v0b789k60p****

The ID of the ECS instance that you want to import into the cluster. Separate multiple IDs with commas (,).

password String Query Yes YourPassword

The logon password of the ECS instance that you want to import into the cluster.

Response parameters

Parameter Type Example Description
Code Integer 200

The HTTP status code.

Data String Transform submit success!

The data returned for the request.

Message String success

The returned message that indicates whether the request is successful.

RequestId String 01B49A88-B06F-423B-A5EF-E5C0A892709D

The ID of the request.

Examples

Sample requests

POST /pop/v5/resource/cluster_member HTTP/1.1
Common request headers
{
  "clusterId": "b3e3f77b-462e-****-****-bec8727a4dc8"
  "instanceIds": "i-2ze7s2v0b789k60p****"
  "password": "********"
}

Sample success responses

XML format

<RequestId>01B49A88-B06F-423B-A5EF-E5C0A892709D</RequestId>
<Data>Transform submit success!</Data>
<Message>success</Message>
<Code>200</Code>

JSON format

{
    "RequestId": "01B49A88-B06F-423B-A5EF-E5C0A892709D",
    "Data": "Transform submit success!",
    "Message": "success",
    "Code": 200
}

Error codes

For a list of error codes, visit the API Error Center.