すべてのプロダクト
Search
ドキュメントセンター

Elasticsearch:GetTransferableNodes

最終更新日:Mar 17, 2025

GetTransferableNodes を呼び出して、移行可能なノードを取得するノードの種類と数を指定します。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。便宜上、OpenAPI Explorer でこの操作を呼び出すことをお勧めします。 OpenAPI Explorer は、さまざまな SDK の操作のサンプルコードを動的に生成します。

リクエストヘッダー

この操作では、共通のリクエストパラメーターのみを使用します。 詳細については、「共通パラメーター」をご参照ください。

リクエスト構文

GET /openapi/instances/[InstanceId]/transferable-nodes HTTPS|HTTP

リクエストパラメーター

パラメータータイプ必須説明
countIntegerはい1

移行するノードの数。

InstanceIdStringはいes-cn-nif1q9o8r0008****

インスタンス ID。

nodeTypeStringはいWORKER

ノードのタイプ。 WORKER はホットノードを、 WORKER_WARM はウォームノードを表します。

レスポンスパラメーター

パラメータータイプ説明
RequestIdStringF99407AB-2FA9-489E-A259-40CF6DCC****

リクエスト ID。

ResultResult の配列

戻り値。

hostString192.168.**. **

ノードの IP アドレス。

portInteger9200

ノードのアクセス ポート。

Result には、次のパラメーターも含まれています。

パラメーター

タイプ

説明

nodeType

String

WORKER

ノードのタイプ。有効な値:MASTER(専用 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エラーコードエラーメッセージ説明
400InstanceNotFoundThe instanceId provided does not exist.指定されたインスタンスが見つからないため返されたエラーメッセージ。 インスタンスの状態を確認してください。

エラーコードのリストについては、API エラーセンターをご覧ください。