Policy management API - POST level-bindings for a group

Latest Dynatrace
Reference
Published Jul 22, 2022

Edits bindings of a policy for a group.

The request consumes an application/json payload.

POST

https://api.dynatrace.com/iam/v1/repo/{levelType}/{levelId}/bindings/{policyUuid}/{groupUuid}

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 OAuth clients.

Parameters

Parameter	Type	Description	In	Required
groupUuid	-	The ID of the required user group.	path	Required
policyUuid	-	The ID of the required policy.	path	Required
levelId	-	The ID of the policy level. Use one of the following values, depending on the level type: account: use the UUID of the account. environment: use the ID of the environment.	path	Required
levelType	-	The type of the policy level. The following values are available: `account`: An account policy applies to all environments of an account. `environment`: An environment policy applies to a specific environment. Each level inherits the policies of the higher level and extends them with its own policies.	path	Required
body	AppendLevelPolicyBindingForGroupDto	The JSON body of the request. Contains parameters, metadata and boundaries	body	Required

Request body objects

The `AppendLevelPolicyBindingForGroupDto` object

Element	Type	Description	Required
parameters	object	Parameters provided for bindings	Optional
metadata	object	Metadata provided for bindings	Optional
boundaries	string[]	List of boundary UUIDs used in the binding.	Optional

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.

{
  "parameters": {},
  "metadata": {},
  "boundaries": [
    "string"
  ]
}

Response

Response codes

Code	Type	Description
204	-	Success. Policy bindings created.
400	ErrorDto	Failed. The request is invalid
404	ErrorDto	Failed. The specified resource is not found.
422	ErrorDto	The specified response not found

Response body objects

The `ErrorDto` object

Element	Type	Description
code	number	The code of the error.
message	string	A short description of the error.
errorsMap	object	-

Response body JSON models

{
  "code": 1,
  "message": "string",
  "errorsMap": {}
}