Client Settings
editClient Settings
editYou can’t use an HTTP proxy to connect a gcs
repository to Google Cloud
Storage in 7.17.24. Client settings to support HTTP proxies are only available
in 8.0 and later versions.
For more information on these client settings, check the 8.0 documentation. For upgrade instructions, check Upgrade Elastic.
The client used to connect to Google Cloud Storage has a number of settings available.
Client setting names are of the form gcs.client.CLIENT_NAME.SETTING_NAME
and are specified
inside elasticsearch.yml
. The default client name looked up by a gcs
repository is
called default
, but can be customized with the repository setting client
.
For example:
PUT _snapshot/my_gcs_repository { "type": "gcs", "settings": { "bucket": "my_bucket", "client": "my_alternate_client" } }
Some settings are sensitive and must be stored in the Elasticsearch keystore. This is the case for the service account file:
bin/elasticsearch-keystore add-file gcs.client.default.credentials_file /path/service-account.json
The following are the available client settings. Those that must be stored in the keystore
are marked as Secure
.
-
credentials_file
(Secure, reloadable) - The service account file that is used to authenticate to the Google Cloud Storage service.
-
endpoint
- The Google Cloud Storage service endpoint to connect to. This will be automatically determined by the Google Cloud Storage client but can be specified explicitly.
-
connect_timeout
-
The timeout to establish a connection to the Google Cloud Storage service. The value should
specify the unit. For example, a value of
5s
specifies a 5 second timeout. The value of-1
corresponds to an infinite timeout. The default value is 20 seconds. -
read_timeout
-
The timeout to read data from an established connection. The value should
specify the unit. For example, a value of
5s
specifies a 5 second timeout. The value of-1
corresponds to an infinite timeout. The default value is 20 seconds. -
application_name
-
Name used by the client when it uses the Google Cloud Storage service. Setting
a custom name can be useful to authenticate your cluster when requests
statistics are logged in the Google Cloud Platform. Default to
repository-gcs
-
project_id
- The Google Cloud project id. This will be automatically inferred from the credentials file but can be specified explicitly. For example, it can be used to switch between projects when the same credentials are usable for both the production and the development projects.