読み取り専用URLリポジトリ
このリポジトリタイプは、Elasticsearchを自分のハードウェアで実行している場合にのみ利用可能です。Elasticsearch Serviceを使用している場合は、Elasticsearch Serviceリポジトリタイプを参照してください。
URLリポジトリを使用すると、クラスターに共有ファイルシステムへの読み取り専用アクセスを提供できます。URLリポジトリは常に読み取り専用であるため、読み取り専用の共有ファイルシステムリポジトリを登録するよりも安全で便利な代替手段です。
Kibanaまたはスナップショットリポジトリ作成APIを使用して、URLリポジトリを登録します。
Python
resp = client.snapshot.create_repository(
name="my_read_only_url_repository",
repository={
"type": "url",
"settings": {
"url": "file:/mount/backups/my_fs_backup_location"
}
},
)
print(resp)
Js
const response = await client.snapshot.createRepository({
name: "my_read_only_url_repository",
repository: {
type: "url",
settings: {
url: "file:/mount/backups/my_fs_backup_location",
},
},
});
console.log(response);
コンソール
PUT _snapshot/my_read_only_url_repository
{
"type": "url",
"settings": {
"url": "file:/mount/backups/my_fs_backup_location"
}
}
リポジトリ設定
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
http
、https
、またはftp
プロトコルを使用するURLは、repositories.url.allowed_urls
クラスター設定で明示的に許可する必要があります。この設定は、URL内のホスト、パス、クエリ、またはフラグメントの場所にワイルドカードをサポートします。file
プロトコルを使用するURLは、クラスター内のすべてのマスターノードおよびデータノードがアクセスできる共有ファイルシステムの場所を指す必要があります。この場所はpath.repo
設定に登録する必要があります。ftp
、http
、https
、またはjar
プロトコルを使用するURLは、path.repo
設定に登録する必要はありません。