The DC/OS Elastic Service implements a REST API that may be accessed from outside the cluster. The
REST API Authentication
REST API requests must be authenticated. This authentication is only applicable for interacting with the Elastic REST API directly. You do not need the token to access the Elasticsearch nodes themselves.
If you are using Enterprise DC/OS, follow these instructions to create a service account and an authentication token. You can then configure your service to automatically refresh the authentication token when it expires. To get started more quickly, you can also get the authentication token without a service account, but you will need to manually refresh the token.
If you are using open source DC/OS, follow these instructions to [pass your HTTP API token to the DC/OS endpoint]https://dcos.io/docs/1.9/security/iam-api/).
Once you have the authentication token, you can store it in an environment variable and reference it in your REST API calls:
$ export auth_token=uSeR_t0k3n
The curl
examples in this document assume that an auth token has been stored in an environment variable named auth_token
.
If you are using Enterprise DC/OS, the security mode of your installation may also require the --ca-cert
flag when making REST calls. Refer to Obtaining and passing the DC/OS certificate in cURL requests for information on how to use the --cacert
flag. If your security mode is disabled
, do not use the --ca-cert
flag.
Plan API
The Plan API provides endpoints for monitoring and controlling service installation and configuration updates.
$ curl -H "Authorization:token=$auth_token" <dcos_url>/service/elastic/v1/plans/deploy
Pause Installation
The installation will pause after completing installation of the current node and wait for user input.
$ curl -X POST -H "Authorization:token=$auth_token" <dcos_url>/service/elastic/v1/plans/deploy/interrupt
Resume Installation
The REST API request below will resume installation at the next pending node.
$ curl -X PUT <dcos_surl>/service/elastic/v1/plans/deploy/continue
Nodes API
The pod API provides endpoints for retrieving information about nodes, restarting them, and replacing them.
List Nodes
A list of available node ids can be retrieved by sending a GET request to /v1/pod
:
CLI Example
$ dcos beta-elastic pod list
HTTP Example
$ curl -H "Authorization:token=$auth_token" <dcos_url>/service/elastic/v1/pod
Node Info
You can retrieve node information by sending a GET request to /v1/pod/<node-id>/info
:
$ curl -H "Authorization:token=$auth_token" <dcos_url>/service/elastic/v1/pod/<node-id>/info
CLI Example
$ dcos beta-elastic pod info journalnode-0
HTTP Example
$ curl -H "Authorization:token=$auth_token" <dcos_url>/service/elastic/v1/pod/journalnode-0/info
Replace a Node
The replace endpoint can be used to replace a node with an instance running on another agent node.
CLI Example
$ dcos beta-elastic pod replace <node-id>
HTTP Example
$ curl -X POST -H "Authorization:token=$auth_token" <dcos_url>/service/elastic/v1/pod/<node-id>/replace
If the operation succeeds, a 200 OK
is returned.
Restart a Node
The restart endpoint can be used to restart a node in place on the same agent node.
CLI Example
$ dcos beta-elastic pod restart <node-id>
HTTP Example
$ curl -X POST -H "Authorization:token=$auth_token" <dcos_url>/service/elastic/v1/pod/<node-id>/restart
If the operation succeeds a 200 OK
is returned.
Pause a Node
The pause endpoint can be used to relaunch a node in an idle command state for debugging purposes.
CLI example
dcos beta-elastic debug pod pause <node-id>
HTTP Example
$ curl -X POST -H "Authorization:token=$auth_token" <dcos_url>/service/elastic/v1/pod/<node-id>/pause
Configuration API
The configuration API provides an endpoint to view current and previous configurations of the cluster.
View Target Config
You can view the current target configuration by sending a GET request to /v1/configurations/target
.
CLI Example
$ dcos beta-elastic config target
HTTP Example
$ curl -H "Authorization:token=$auth_token" <dcos_url>/service/elastic/v1/configurations/target
List Configs
You can list all configuration IDs by sending a GET request to /v1/configurations
.
CLI Example
$ dcos beta-elastic config list
HTTP Example
$ curl -H "Authorization:token=$auth_token" <dcos_url>/service/elastic/v1/configurations
View Specified Config
You can view a specific configuration by sending a GET request to /v1/configurations/<config-id>
.
CLI Example
$ dcos beta-elastic config show 9a8d4308-ab9d-4121-b460-696ec3368ad6
HTTP Example
$ curl -H "Authorization:token=$auth_token" <dcos_url>/service/elastic/v1/configurations/9a8d4308-ab9d-4121-b460-696ec3368ad6
Service Status Info
Send a GET request to the /v1/state/properties/suppressed
endpoint to learn if Elastic is in a suppressed
state and not receiving offers. If a service does not need offers, Mesos can “suppress” it so that other services are not starved for resources.
You can use this request to troubleshoot: if you think Elastic should be receiving resource offers, but is not, you can use this API call to see if Elastic is suppressed.
```
curl -H “Authorization: token=$auth_token” “