调用GetTransferableNodes,指定节点类型和个数,获取可进行数据迁移的节点。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求头
该接口使用公共请求头,无特殊请求头。请参见公共请求参数文档。
请求语法
GET /openapi/instances/[InstanceId]/transferable-nodes HTTP/1.1
请求参数
名称 | 类型 | 位置 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|---|
count | Integer | Query | 是 | 1 |
期望获取进行数据迁移节点的数量。 |
InstanceId | String | Path | 是 | es-cn-nif1q9o8r0008**** |
实例ID。 |
nodeType | String | Query | 是 | WORKER |
需要进行数据迁移的节点类型。WORKER表示热节点,WORKER_WARM表示冷节点。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | F99407AB-2FA9-489E-A259-40CF6DCC**** |
请求ID。 |
Result | Array of Result |
返回结果。 |
|
host | String | 192.168.**.** |
节点的IP地址。 |
port | Integer | 9200 |
节点的访问端口。 |
Result中还包含以下参数。
名称 |
类型 |
示例值 |
描述 |
---|---|---|---|
nodeType |
String |
WORKER |
节点类型,取值包括:MASTER(专有主节点)、WORKER(热节点)、WORKER_WARM(冷节点)、COORDINATING(协调节点)、KIBANA(Kibana节点)。 |
zoneId |
String |
cn-hangzhou-b |
节点所在的可用区ID。 |
示例
请求示例
GET /openapi/instances/es-cn-nif1q9o8r0008****/transferable-nodes?nodeType=WORKER&count=1 HTTP/1.1
公共请求头
正常返回示例
JSON
格式
{
"Result":[
{
"nodeType":"WORKER",
"host":"192.168.**.**",
"port":9300,
"zoneId":"cn-hangzhou-b"
}
],
"RequestId":"3760F67B-691D-4663-B4E5-6783554F****"
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | InstanceNotFound | The instanceId provided does not exist. | 实例找不到,请核对实例状态。 |
访问错误中心查看更多错误码。