Create enrollment token

edit

Creates an enrollment token.

Request

edit

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

Request body

edit

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

Responses

edit
200

(RequestEnrollmentTokenReply) The enrollment token is created. Use the token to start new servers with the requested roles.

400

(BasicFailedReply) The token request format is invalid. For details, refer to the error. (code: 'enrollment_tokens.invalid_token_request')

403

(BasicFailedReply) The signing key is unavailable. Use a different key, then try again. (code: 'enrollment_tokens.signing_key_not_found')

449

(BasicFailedReply) Elevated permissions are required. (code: '"root.needs_elevated_permissions"')

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

Request example

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