cat repositories API

cat APIは、コマンドラインまたはKibanaコンソールを使用して人間が消費することを目的としています。アプリケーションによる使用は意図されていません。アプリケーションでの使用には、get snapshot repository APIを使用してください。

クラスターのsnapshot repositoriesを返します。

Request

GET /_cat/repositories

Prerequisites

  • Elasticsearchのセキュリティ機能が有効になっている場合、このAPIを使用するにはmonitor_snapshotcreate_snapshot、またはmanage クラスター権限が必要です。

Query parameters

  • format
  • (オプション、文字列) HTTP accept headerの短縮版。 有効な値にはJSON、YAMLなどが含まれます。
  • h
  • (オプション、文字列) 表示する列名のカンマ区切りリスト。
  • help
  • (オプション、Boolean) trueの場合、レスポンスにはヘルプ情報が含まれます。 デフォルトはfalseです。
  • local
  • (オプション、Boolean) trueの場合、リクエストはローカルノードからのみ情報を取得します。 デフォルトはfalseで、これはマスターノードから情報を取得することを意味します。
  • master_timeout
  • (オプション、時間単位) マスターノードを待機する期間。 タイムアウトが切れる前にマスターノードが利用できない場合、リクエストは失敗し、エラーが返されます。 デフォルトは30sです。 リクエストが決してタイムアウトしないことを示すために-1に設定することもできます。
  • s
  • (オプション、文字列) レスポンスをソートするために使用される列名または列エイリアスのカンマ区切りリスト。
  • v
  • (オプション、Boolean) trueの場合、レスポンスには列見出しが含まれます。 デフォルトはfalseです。

Examples

Python

  1. resp = client.cat.repositories(
  2. v=True,
  3. )
  4. print(resp)

Ruby

  1. response = client.cat.repositories(
  2. v: true
  3. )
  4. puts response

Js

  1. const response = await client.cat.repositories({
  2. v: "true",
  3. });
  4. console.log(response);

Console

  1. GET /_cat/repositories?v=true

APIは次のレスポンスを返します:

Txt

  1. id type
  2. repo1 fs
  3. repo2 s3