すべてのプロダクト
Search

このプロダクト

    Elasticsearch:ListShardRecoveries

    ドキュメントセンター

    Elasticsearch:ListShardRecoveries

    最終更新日:Mar 17, 2025

    復旧中のシャードまたは復旧済みのシャードに関する情報をクエリします。デフォルトでは、この操作は、この操作の呼び出し後に復旧中のシャードに関する情報のみを返します。

    説明 シャードの復旧とは、プライマリシャードからセカンダリシャードに同期するプロセスです。復旧が完了すると、セカンダリシャードは検索に使用できるようになります。

    デバッグ

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

    リクエストヘッダー

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

    リクエスト構文

    GET /openapi/instances/{InstanceId}/cat-recovery HTTP/1.1

    リクエストパラメーター

    要素

    タイプ

    位置

    必須

    例

    説明
    InstanceId String Path Yes es-cn-7mz293m9a003j****

    インスタンス ID。
    activeOnly Boolean Query No true

    シャードのデータ復旧に関する情報を返すかどうかを指定します。有効な値：

    • true: 復旧中のシャードのデータ復旧に関する情報を返します。
    • false: すべてのシャードのデータ復旧に関する情報を返します。

    レスポンスパラメーター

    要素

    タイプ

    例

    説明
    RequestId String F99407AB-2FA9-489E-A259-40CF6DCC47D9

    リクエスト ID。
    Result Result の配列

    レスポンスパラメーター。
    index String my-index-000001

    Elasticsearch クラスタ内のインデックスの名前。
    sourceHost String 192.168.XX.XX

    ソースノードの IP アドレス。
    sourceNode String 2Kni3dJ

    ソースノードの名前。
    filesTotal Long 79

    ファイルの総数。
    bytesPercent String 80%

    データ復旧の進捗状況。
    translogOps Long 12086

    復旧するトランザクションログ操作の数。
    translogOpsPercent String 80%

    トランザクションログ操作の復旧の進捗状況。
    bytesTotal Long 12086

    復旧されるデータの総量。
    targetHost String 192.168.XX.XX

    デスティネーションノードの IP アドレス。
    targetNode String YVVKLmW

    デスティネーションノードの名前。
    filesPercent String 80.0%

    ファイルの実行進捗状況。
    stage String done

    データ復旧ステータス。リクエストが成功したかどうかを示します。有効な値：

    • done: データ復旧は完了です。
    • finalize: データはクリア中です。
    • index: インデックスメタデータを読み取り中で、バイトはソースからデスティネーションにコピーされています。
    • init: データ復旧は開始されていません。
    • start: データ復旧が開始されました。
    • translog: トランザクションログは再実行中です。

    例

    リクエストの例

    GET /openapi/instances/es-cn-7mz293m9a003j****/cat-recovery HTTP/1.1

    正常なレスポンスの例

    JSON 形式

    HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "F99407AB-2FA9-489E-A259-40CF6DCC47D9",
  "Result" : [ {
    "index" : "my-index-000001",
    "sourceHost" : "192.168.XX.XX",
    "sourceNode" : "2Kni3dJ",
    "targetHost" : "192.168.XX.XX",
    "targetNode" : "YVVKLmW",
    "stage" : "index",
    "filesTotal" : 79,
    "filesPercent" : "80.0%",
    "bytesTotal" : 12086,
    "bytesPercent" : "80%",
    "translogOps" : 12086,
    "translogOpsPercent" : "80%"
  }, {
    "index" : "my-index-000002",
    "sourceHost" : "192.168.XX.XX",
    "sourceNode" : "2Kni3dJ",
    "targetHost" : "192.168.XX.XX",
    "targetNode" : "YVVKLmW",
    "stage" : "index",
    "filesTotal" : 56,
    "filesPercent" : "100%",
    "bytesTotal" : 11086,
    "bytesPercent" : "100%",
    "translogOps" : 11086,
    "translogOpsPercent" : "100%"
  } ]
}

    エラーコード

    エラーコードの一覧については、「サービスエラーコード」をご参照ください。