Policy management API - PUT bindings of a user group
Updates a list of policies assigned to a user group. The request overwrites an existing set of policies.
The request consumes an application/json
payload.
PUT |
|
Authentication
To execute this request, you need the Allow IAM policy configuration for environments (iam-policies-management
) permission assigned to your token. To learn how to obtain and use it, see Authentication.
Parameters
Parameter | Type | Description | In | Required |
---|---|---|---|---|
levelType | string | The type of the policy level. The following values are available:
Each level inherits the policies of the higher level and extends them with its own policies. | path | required |
levelId | string | The ID of the policy level. Use one of the following values, depending on the level type:
| path | required |
groupUuid | string | The ID of the required user group. | path | required |
body | Policy | The JSON body of the request. Contains new policies for the group. Any policy not presented in the request is discarded. | body | required |
Request body objects
The PolicyUuidsDto
object
Element | Type | Description | Required |
---|---|---|---|
policyUuids | string[] | A list of policies bound to the user group. | required |
Request body JSON model
This is a model of the request body, showing the possible elements. It has to be adjusted for usage in an actual request.
{
"policyUuids": [
"string"
]
}
Response
Response codes
Code | Type | Description |
---|---|---|
204 | Success. The group policies have been updated. The response doesn't have a body. | |
400 | ErrorDto | Failed. The request is invalid |
404 | ErrorDto | Failed. The specified resource is not found. |
422 | ErrorDto | The specified response not found |
Example
In this example, the request assigns the policy with the UUID of 74e51763-1118-4833-8b1e-6b5f0082052a to the user group with the UUID of 541802b0-623c-4193-8728-036ed01d4eb4 from the mySampleEnv environment. The response code of 204 indicates a successful request.
Curl
curl --request PUT \
--url 'https://api.dynatrace.com/iam/v1/repo/environment/mySampleEnv/bindings/groups/541802b0-623c-4193-8728-036ed01d4eb4' \
--header 'Authorization: Bearer abcdefjhij1234567890' \
--header 'Content-Type: application/json' \
--data '{
"policyUuids": [
"74e51763-1118-4833-8b1e-6b5f0082052a"
]
}'
Request URL
https://api.dynatrace.com/iam/v1/repo/environment/mySampleEnv/bindings/groups/541802b0-623c-4193-8728-036ed01d4eb4
Request body
{
"policyUuids": [
"74e51763-1118-4833-8b1e-6b5f0082052a"
]
}
Response code
204