Enable elevated permissions
editEnable elevated permissions
editThis endpoint is deprecated and scheduled to be removed in the next major version. Sudo has been retired
Enables the elevated permissions for the current user. Elevated permissions allow the user to complete potentially destructive operations on clusters. Elevated permissions are available for a limited period of time and automatically expire if you do not renew them.
Request
editPOST /api/v1/users/auth/_elevate
Request body
edit(ElevatePermissionsRequest
) The request for elevated permissions
Responses
edit-
200
-
Elevated permissions are enabled and the authorization token was generated.
-
400
-
Missed or invalid MFA token. (code:
authc.invalid_token
)Headers
-
x-cloud-error-codes
(string
; allowed values: [authc.invalid_token
]) - The error codes associated with the response
-
-
401
-
The authentication token is invalid or expired. (code:
root.unauthorized
)Headers
-
x-cloud-error-codes
(string
; allowed values: [root.unauthorized
]) - The error codes associated with the response
-
-
501
-
The administrator needs to configure the authentication cluster. (code:
authc.no_authentication_cluster
)Headers
-
x-cloud-error-codes
(string
; allowed values: [authc.no_authentication_cluster
]) - The error codes associated with the response
-
-
502
-
The authentication cluster failed to process the request. The response body contains details about the error. (code:
authc.authentication_cluster_error
)Headers
-
x-cloud-error-codes
(string
; allowed values: [authc.authentication_cluster_error
]) - The error codes associated with the response
-
Request example
editcurl -XPOST https://{{hostname}}/api/v1/users/auth/_elevate \ -H "Authorization: ApiKey $ECE_API_KEY" \ -H 'Content-Type: application/json' \ -d ' { "token" : "string" } '