Update cluster password policy

The ServiceProviderAPI (Service Provider API) Api-Token scope is required to update the cluster password policy configuration using the Dynatrace API.

Endpoint

/api/v1.0/onpremise/passwordPolicy

Parameter

Parameter Type Description In Required
body PasswordPolicy

The JSON body of the request. Contains parameters of password policy configuration.

body optional

Body format

The PasswordPolicy object

Password policy configuration.

Element Type Description Required
realmId string optional
minPasswordLength integer

Minimum password length

required
minNumberOfUppercaseChars integer

Minimum number of uppercase characters

required
minNumberOfLowercaseChars integer

Minimum number of lowercase characters

required
minNumberOfDigits integer

Minimum number of digits

required
minNumberOfNonAlphanumericChars integer

Minimum number of non-alphanumeric characters

required

Response

Response codes

Code Description
204

Successfully updated. Response doesn't have a body.

400

Failed. The input is invalid.

404

Realm not found

Response body

A successful request doesn't return any content.

Example

In this example, you update the password policy for your managed deployment (myManaged.cluster.com). You define:

  • Minimum password length
  • Minimum number of uppercase characters
  • Minimum number of lowercase characters
  • Minimum number of digits
  • Minimum number of non-alphanumeric characters

In return you receive a response code 204 indicating that the password policy was updated successfully.

Curl

curl -X PUT "https://myManaged.cluster.com/api/v1.0/onpremise/passwordPolicy" -H  "accept: */*" -H  "Content-Type: application/json" -d "{\"realmId\":\"string\",\"minPasswordLength\":16,\"minNumberOfUppercaseChars\":2,\"minNumberOfLowercaseChars\":4,\"minNumberOfDigits\":2,\"minNumberOfNonAlphanumericChars\":4}"

Request URL

https://myManaged.cluster.com/api/v1.0/onpremise/passwordPolicy

Response body

Successfully updated. Response doesn't have a body.

Response code

204