Policy management API - POST level-bindings for a group

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

ParameterTypeDescriptionInRequired
groupUuid-

The ID of the required user group.

pathrequired
policyUuid-

The ID of the required policy.

pathrequired
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.
pathrequired
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.

pathrequired
bodyAppendLevelPolicyBindingForGroupDto

The JSON body of the request. Contains parameters and metadata

bodyrequired

Request body objects

The AppendLevelPolicyBindingForGroupDto object

ElementTypeDescriptionRequired
parametersobject

Parameters provided for bindings

optional
metadataobject

Metadata provided for bindings

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": {}
}

Response

Response codes

CodeTypeDescription
204-

Success. Policy bindings created.

400ErrorDto

Failed. The request is invalid

404ErrorDto

Failed. The specified resource is not found.

422ErrorDto

The specified response not found