Update LDAP configurationedit
Updates an existing LDAP configuration.
Requestedit
PUT /api/v1/platform/configuration/security/realms/ldap/{realm_id}
Path parametersedit
| Name | Type | Required | Description |
|---|---|---|---|
|
|
Y |
The Elasticsearch Security realm identifier. |
Query parametersedit
| Name | Type | Required | Description |
|---|---|---|---|
|
|
N |
When specified, checks for conflicts against the version stored in the persistent store (returned in 'x-cloud-resource-version' of the GET request) |
Request bodyedit
(LdapSettings) (required) The LDAP configuration
Responsesedit
-
200 -
(
EmptyResponse) The LDAP configuration was successfully updatedHeaders
-
x-cloud-resource-created(string) - The date-time when the resource was created (ISO format relative to UTC)
-
x-cloud-resource-last-modified(string) - The date-time when the resource was last modified (ISO format relative to UTC)
-
x-cloud-resource-version(string) - The resource version, which is used to avoid update conflicts with concurrent operations
-
-
400 -
(
BasicFailedReply) * The realm id is already in use. (code:security_realm.id_conflict) * The selected id is not valid. (code:security_realm.invalid_id) * Order must be greater than zero. (code:security_realm.invalid_order) * Invalid Elasticsearch Security realm type. (code:security_realm.invalid_type) * The realm order is already in use. (code:security_realm.order_conflict) * Advanced YAML format is invalid. (code:security_realm.invalid_yaml) * The url format is invalid. (code:security_realm.invalid_url) * Invalid LDAP URL. (code:security_realm.ldap.invalid_url) * Invalid certificate bundle URL. (code:security_realm.invalid_bundle_url) -
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 exampleedit
curl -XPUT {{hostname}}/api/v1/platform/configuration/security/realms/ldap/{realm_id} \
-u $CLOUD_USER:$CLOUD_KEY \
-H 'Content-Type: application/json' \
-d '
{
"bind_anonymously" : true,
"bind_dn" : "string",
"bind_password" : "string",
"bind_type" : "string",
"certificate_url" : "string",
"certificate_url_truststore_password" : "string",
"certificate_url_truststore_type" : "string",
"enabled" : true,
"group_search" : {
"base_dn" : "string",
"filter" : "string",
"scope" : "string",
"user_attribute" : "string"
},
"id" : "string",
"load_balance" : {
"cache_ttl" : "string",
"type" : "string"
},
"name" : "string",
"order" : 0,
"override_yaml" : "string",
"role_mappings" : {
"default_roles" : [
"string"
],
"rules" : [
{
"roles" : [
"string"
],
"type" : "string",
"value" : "string"
}
]
},
"urls" : [
"string"
],
"user_dn_templates" : [
"string"
],
"user_group_attribute" : "string",
"user_search" : {
"base_dn" : "string",
"filter" : "string",
"scope" : "string"
}
}
'