読み取り専用URLリポジトリ

このリポジトリタイプは、Elasticsearchを自分のハードウェアで実行している場合にのみ利用可能です。Elasticsearch Serviceを使用している場合は、Elasticsearch Serviceリポジトリタイプを参照してください。

URLリポジトリを使用すると、クラスターに共有ファイルシステムへの読み取り専用アクセスを提供できます。URLリポジトリは常に読み取り専用であるため、読み取り専用の共有ファイルシステムリポジトリを登録するよりも安全で便利な代替手段です。

Kibanaまたはスナップショットリポジトリ作成APIを使用して、URLリポジトリを登録します。

Python

  1. resp = client.snapshot.create_repository(
  2. name="my_read_only_url_repository",
  3. repository={
  4. "type": "url",
  5. "settings": {
  6. "url": "file:/mount/backups/my_fs_backup_location"
  7. }
  8. },
  9. )
  10. print(resp)

Js

  1. const response = await client.snapshot.createRepository({
  2. name: "my_read_only_url_repository",
  3. repository: {
  4. type: "url",
  5. settings: {
  6. url: "file:/mount/backups/my_fs_backup_location",
  7. },
  8. },
  9. });
  10. console.log(response);

コンソール

  1. PUT _snapshot/my_read_only_url_repository
  2. {
  3. "type": "url",
  4. "settings": {
  5. "url": "file:/mount/backups/my_fs_backup_location"
  6. }
  7. }

リポジトリ設定

  • chunk_size
  • (オプション、バイト値) スナップショット内のファイルの最大サイズ。このサイズを超えるファイルは、このサイズまたはそれ以下のチャンクに分割されます。デフォルトはnull(無制限のファイルサイズ)です。
  • http_max_retries
  • (オプション、整数) httpおよびhttps URLの最大再試行回数。デフォルトは5です。
  • http_socket_timeout
  • (オプション、時間値) 接続を介したデータ転送の最大待機時間。デフォルトは50sです。
  • compress
  • (オプション、ブール値) trueの場合、メタデータファイル(インデックスマッピングや設定など)がスナップショット内で圧縮されます。データファイルは圧縮されません。デフォルトはtrueです。
  • max_number_of_snapshots
  • (オプション、整数) リポジトリが含むことができるスナップショットの最大数。デフォルトはInteger.MAX_VALUEで、2^31-1または2147483647です。
  • max_restore_bytes_per_sec
  • (オプション、バイト値) ノードごとの最大スナップショット復元率。デフォルトは無制限です。復元はリカバリ設定を通じても制限されます。
  • max_snapshot_bytes_per_sec
  • (オプション、バイト値) ノードごとの最大スナップショット作成率。デフォルトは40mb毎秒です。管理サービスのリカバリ設定が設定されている場合、デフォルトは無制限であり、さらにリカバリ設定を通じて制限されます。
  • url
  • (必須、文字列) 共有ファイルシステムリポジトリのルートのURL位置。以下のプロトコルがサポートされています:
    • file
    • ftp
    • http
    • https
    • jar
      httphttps、またはftpプロトコルを使用するURLは、repositories.url.allowed_urlsクラスター設定で明示的に許可する必要があります。この設定は、URL内のホスト、パス、クエリ、またはフラグメントの場所にワイルドカードをサポートします。
      fileプロトコルを使用するURLは、クラスター内のすべてのマスターノードおよびデータノードがアクセスできる共有ファイルシステムの場所を指す必要があります。この場所はpath.repo設定に登録する必要があります。ftphttphttps、またはjarプロトコルを使用するURLは、path.repo設定に登録する必要はありません。