Queries the Elastic Compute Service (ECS) instances that can be imported to a specified cluster. This operation is applicable to ECS clusters.

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 the common request header. For more information, see Common request parameters.

Request syntax

GET /pop/v5/resource/convertable_ecu_list HTTP/1.1

Request parameters

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

The ID of the cluster. You can call the ListCluster operation to query the cluster ID. For more information, see ListCluster.

Response parameters

Parameter Type Example Description
Code Integer 200

The HTTP status code.

InstanceList Array of Instance

The ECS instances that can be imported to the cluster.

Instance
Cpu Integer 2

The number of CPU cores of the ECS instance.

EcuId String b197-40ab-9155-7ca7

ECU ID

Eip String 13.xx.xxx.xx

The elastic IP address (EIP) associated with the ECS instance. The EIP can be changed.

Expired Boolean false

Indicates whether the ECS instance has expired.

InnerIp String 192.168.13.xx

The internal IP address of the ECS instance. This parameter is valid only when the ECS instance is deployed in a virtual private cloud (VPC).

InstanceId String i-2ze7s2v0b***********

The ID of the ECS instance.

InstanceName String worker-k8s

The name of the ECS instance.

Mem Integer 4096

The size of memory for the ECS instance.

PrivateIp String 192.XX.XX.123

The private IP address of the ECS instance. This parameter is valid only when the ECS instance is deployed in a VPC.

PublicIp String 13.xx.xx.xxx

The public IP address of the ECS instance. This IP address can be used only by the ECS instance.

RegionId String cn-beijing

The ID of the region where the ECS instance is located.

Status String Running

The status of the ECS instance. Valid values:

  • Pending
  • Running
  • Starting
  • Stopping
  • Stopped
VpcId String vpc-2zef6ob8m************

The ID of the VPC.

VpcName String jianwei-test

The name of the VPC.

Message String success

The returned message.

RequestId String b197-40ab-9155-7ca7

The ID of the request.

Examples

Sample requests

GET /pop/v5/resource/convertable_ecu_list HTTP/1.1
Common request header
{
  "clusterId": "b3e3f77b-462e-xxxx-bec8727a4dc8"
}

Sample success responses

XML format

<Message>success</Message>
<Code>200</Code>
<InstanceList>
    <Instance>
        <Status> Running</Status>
        <VpcName>test</VpcName>
        <Cpu>2</Cpu>
        <InnerIp/>
        <Mem>4096</Mem>
        <RegionId>cn-beijing</RegionId>
        <Expired>false</Expired>
        <InstanceId>i-2ze7s2v0b789k60p****</InstanceId>
        <PrivateIp>192.168.0.86</PrivateIp>
        <Eip/>
        <VpcId>vpc-2zef6ob8mrlzv8x3q****</VpcId>
        <InstanceName>worker-k8s</InstanceName>
    </Instance>
</InstanceList>

JSON format

{
	"Message": "success",
	"Code": 200,
	"InstanceList": {
		"Instance": [
			{
				"Status": " Running",
				"VpcName": "test",
				"Cpu": 2,
				"InnerIp": "192.168.13.xx",
				"Mem": 4096,
				"RegionId": "cn-beijing",
				"Expired": false,
				"InstanceId": "i-2ze7s2v0b789k60p****",
				"PrivateIp": "192.168.0.86",
				"Eip": "13.xx.xxx.xx",
				"VpcId": "vpc-2zef6ob8mrlzv8x3q****",
				"InstanceName": "worker-k8s"
			}
		]
	}
}

Error codes

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