Policy management API - GET bindings of a policy level
Lists all user groups, using policies of a policy level.
The request produces an application/json
payload.
GET |
|
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 |
Response
Response codes
Code | Type | Description |
---|---|---|
200 | LevelPolicyBindingDto | Success. The response contains bindings of the level policies. |
404 | ErrorDto | Failed. The specified resource is not found. |
Response body objects
The LevelPolicyBindingDto
object
Element | Type | Description |
---|---|---|
levelType | string | The type of the policy level. |
levelId | string | The ID of the policy level. |
policyBindings | Binding[] | - |
The Binding
object
Element | Type | Description |
---|---|---|
policyUuid | string | The ID of the policy. |
groups | string[] | A list of user groups to which the policy applies. |
Response body JSON model
1{2 "levelType": "string",3 "levelId": "string",4 "policyBindings": [5 {6 "policyUuid": "string",7 "groups": [8 "string"9 ]10 }11 ]12}
Example
In this example, the request lists all user groups that are using environment-level policies for the mySampleEnv environment.
Curl
1curl --request GET \2 --url 'https://api.dynatrace.com/iam/v1/repo/environment/mySampleEnv/bindings' \3 --header 'Authorization: Bearer abcdefjhij1234567890'
Request URL
1https://api.dynatrace.com/iam/v1/repo/environment/mySampleEnv/bindings
Response body
1{2 "levelType": "environment",3 "levelId": "mySampleEnv",4 "policyBindings": [5 {6 "policyUuid": "0c621587-f978-4c7b-89ee-d2045f611b03",7 "groups": [8 "a468e0e0-ef8f-45d8-9b0f-e016984d838b"9 ]10 },11 {12 "policyUuid": "74e51763-1118-4833-8b1e-6b5f0082052a",13 "groups": [14 "541802b0-623c-4193-8728-036ed01d4eb4"15 ]16 }17 ]18}
Response code
200