Docs
Elastic Cloud Enterprise Reference [2.4] » RESTful API » API reference » Platform - Configuration - Security
« Platform - Configuration - Instances - CRUD Platform - Configuration - Security Deployment »

Platform - Configuration - Security

Get enrollment tokens

Retrieves a list of active enrollment tokens.

Request

GET /api/v1/platform/configuration/security/enrollment-tokens

Responses

200

(ListEnrollmentTokenReply) A token has been generated that can be used to start new servers with the requested roles

449

(BasicFailedReply) elevated permissions are required. (code: '"root.unauthorized.rbac.elevated_permissions_required"')

To perform this operation, you must be authenticated by means of one of the following methods: apiKey, basicAuth.

Request example

curl -XGET {{hostname}}/api/v1/platform/configuration/security/enrollment-tokens \
-H "Authorization: ApiKey $ECE_API_KEY"

Create enrollment token

Creates an enrollment token.

Request

POST /api/v1/platform/configuration/security/enrollment-tokens

Request body

(EnrollmentTokenRequest) (required) Request parameters for the enrollment token

Responses

200

(RequestEnrollmentTokenReply) A token has been generated that can be used to start new servers with the requested roles

400

(BasicFailedReply) The token request format was invalid, details in the error (code: 'enrollment_tokens.invalid_token_request')

403

(BasicFailedReply) No signing key is available to generate a token (code: 'enrollment_tokens.signing_key_not_found')

449

(BasicFailedReply) elevated permissions are required. (code: '"root.unauthorized.rbac.elevated_permissions_required"')

To perform this operation, you must be authenticated by means of one of the following methods: apiKey, basicAuth.

Request example

curl -XPOST {{hostname}}/api/v1/platform/configuration/security/enrollment-tokens \
-H "Authorization: ApiKey $ECE_API_KEY" \
-H 'Content-Type: application/json' \
-d '
{
   "persistent" : true,
   "roles" : [
      "string"
   ],
   "validity_in_seconds" : 0
}
'

Delete enrollment token

Revokes and deletes the enrollment token.

Request

DELETE /api/v1/platform/configuration/security/enrollment-tokens/{token}

Path parameters

Name Type Required Description

token

string

Y

The token or token identifier to revoke.

Responses

200

(EmptyResponse) The supplied token has been revoked and can no longer be used to start services on new servers

404

(BasicFailedReply) Token not found (code: 'enrollment_tokens.invalid_token_id')

449

(BasicFailedReply) elevated permissions are required. (code: '"root.unauthorized.rbac.elevated_permissions_required"')

To perform this operation, you must be authenticated by means of one of the following methods: apiKey, basicAuth.

Request example

curl -XDELETE {{hostname}}/api/v1/platform/configuration/security/enrollment-tokens/{token} \
-H "Authorization: ApiKey $ECE_API_KEY"
« Platform - Configuration - Instances - CRUD Platform - Configuration - Security Deployment »