Call GetTransferableNodes to specify the type and number of nodes to obtain the nodes that can be migrated.
Debugging
Request header
This operation uses common request parameters only. For more information, see Common parameters.
Request syntax
GET /openapi/instances/[InstanceId]/transferable-nodes HTTPS|HTTP
Request parameters
Parameter | Type | Required | Example | Description |
---|---|---|---|---|
count | Integer | Yes | 1 |
The number of nodes to be migrated. |
InstanceId | String | Yes | es-cn-nif1q9o8r0008**** |
The ID of the instance. |
nodeType | String | Yes | WORKER |
The type of nodes.WORKER represents a hot node, WORKER_WARM represents a warm node. |
Response parameters
Parameter | Type | Example | Description |
---|---|---|---|
RequestId | String | F99407AB-2FA9-489E-A259-40CF6DCC**** |
The ID of the request. |
Result | Array of Result |
The return results. |
|
host | String | 192.168.**. ** |
The IP address of the node. |
port | Integer | 9200 |
The access port of the node. |
The Result also contains the following parameters.
Parameter |
Type |
Example |
Description |
---|---|---|---|
nodeType |
String |
WORKER |
The type of the node. Valid values: MASTER (dedicated MASTER node), WORKER (hot node), WORKER_WARM (warm node), COORDINATING (client node), and KIBANA(Kibana node). |
zoneId |
String |
cn-hangzhou-b |
The ID of the zone to which the node belongs. |
Examples
Sample requests
GET /openapi/instances/es-cn-nif1q9o8r0008****/transferable-nodes? nodeType=WORKER&count=1 HTTP/1.1
Common request header
Sample success responses
JSON
format
{
"Result":[
{
"nodeType":"WORKER",
"host":"192.168. **.**",
"port":9300,
"zoneId":"cn-hangzhou-b"
}
],
"RequestId":"3760F67B-691D-4663-B4E5-6783554F****"
}
Error codes
HttpCode | Error code | Error message | Description |
---|---|---|---|
400 | InstanceNotFound | The instanceId provided does not exist. | The error message returned because the specified instance cannot be found. Check the instance status. |
For a list of error codes, visit the API Error Center.