Policy management API - PUT bindings of a policy level
Updates the list of user groups that are using policies of a policy level. The request overwrites any existing bindings.
The request consumes and produces 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 |
| body | CreateLevelPolicyBindingsRequestDto | The JSON body of the request. Contains new policy bindings of a level. Any existing binding not presented in the request is discarded. | body | required |
Request body objects
The CreateLevelPolicyBindingsRequestDto object
| Element | Type | Description | Required |
|---|---|---|---|
| policyBindings | Binding[] | A list of policy bindings of the user group. | required |
The Binding object
| Element | Type | Description | Required |
|---|---|---|---|
| policyUuid | string | The ID of the policy. | required |
| groups | string[] | A list of user groups to which the policy applies. | 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.
1{2 "policyBindings": [3 {4 "policyUuid": "string",5 "groups": [6 "string"7 ]8 }9 ]10}
Response
Response codes
Example
In this example, the request overwrites the list of environment-level policies for the mySampleEnv environment. The policy with the UUID of 0c621587-f978-4c7b-89ee-d2045f611b03 is assigned to user groups with the following UUIDs:
- 541802b0-623c-4193-8728-036ed01d4eb4
- a468e0e0-ef8f-45d8-9b0f-e016984d838b
The response code of 204 indicates a successful request.
Curl
1curl --request PUT \2 --url 'https://api.dynatrace.com/iam/v1/repo/environment/mySampleEnv/bindings' \3 --header 'Authorization: Bearer abcdefjhij1234567890 \4 --header 'Content-Type: application/json' \5 --data '{6 "policyBindings": [7 {8 "policyUuid": "0c621587-f978-4c7b-89ee-d2045f611b03",9 "groups": [10 "a468e0e0-ef8f-45d8-9b0f-e016984d838b",11 "541802b0-623c-4193-8728-036ed01d4eb4"12 ]13 }14 ]15}'
Request URL
1https://api.dynatrace.com/iam/v1/repo/environment/mySampleEnv/bindings
Request body
1{2 "policyBindings": [3 {4 "policyUuid": "0c621587-f978-4c7b-89ee-d2045f611b03",5 "groups": [6 "a468e0e0-ef8f-45d8-9b0f-e016984d838b",7 "541802b0-623c-4193-8728-036ed01d4eb4"8 ]9 }10 ]11}
Response code
204