Delete Active Directory configuration

edit

Deletes a single Active Directory configuration.

Request

edit

DELETE /api/v1/platform/configuration/security/realms/active-directory/{realm_id}

Path parameters

edit
Name Type Required Description

realm_id

string

Y

The Elasticsearch Security realm identifier.

Query parameters

edit
Name Type Required Description

version

integer

N

When specified, checks for conflicts against the version stored in the persistent store (returned in 'x-cloud-resource-version' of the GET request)

Responses

edit
200

(EmptyResponse) The Active Directory configuration was successfully deleted

404

(BasicFailedReply) The realm specified by {realm_id} cannot be found. (code: security_realm.not_found)

409

(BasicFailedReply) There is a version conflict. (code: security_realm.version_conflict)

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

edit
curl -XDELETE {{hostname}}/api/v1/platform/configuration/security/realms/active-directory/{realm_id} \
-u $CLOUD_USER:$CLOUD_KEY