• Home
  • API
  • Account management
  • Policy management
  • Policies
  • GET a policy

Policy management API - GET a policy

Gets parameters of an access policy.

The request produces an application/json payload.

GET

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

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

ParameterTypeDescriptionInRequired
levelTypestring

The type of the policy level. The following values are available:

  • global: A global policy applies to all accounts and environments. It is defined and managed by Dynatrace.
  • 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
levelIdstring

The ID of the policy level. Use one of the following values, depending on the level type:

  • global: use the global value.
  • account: use the UUID of the account.
  • environment: use the ID of the environment.
pathrequired
policyUuidstring

The ID of the required policy.

pathrequired

Response

Response codes

CodeTypeDescription
200LevelPolicyDto

Success. The response contains the configuration of the policy.

404ErrorDto

Failed. The specified resource is not found.

Response body objects

The LevelPolicyDto object

ElementTypeDescription
uuidstring

The ID of the policy.

namestring

The display name of the policy.

tagsstring[]

A list of tags.

descriptionstring

A short description of the policy.

statementQuerystring

The statement of the policy.

statementsStatement[]

The expanded form of the policy statement.

The Statement object

ElementTypeDescription
effectstring

The effect of the policy (for example, allow something).

servicestring

The service to which the policy applies.

permissionsstring[]

A list of granted permissions.

conditionsCondition[]

A list of conditions limiting the granted permissions.

The Condition object

ElementTypeDescription
namestring

The name of the condition.

It indicates which part of the services is checked by the condition.

operatorstring

The operator of the condition.

valuesstring[]

A list of reference values of the condition.

Response body JSON model

json
{
  "uuid": "string",
  "name": "string",
  "tags": [
    "string"
  ],
  "description": "string",
  "statementQuery": "string",
  "statements": [
    {
      "effect": "string",
      "service": "string",
      "permissions": [
        "string"
      ],
      "conditions": [
        {
          "name": "string",
          "operator": "string",
          "values": [
            "string"
          ]
        }
      ]
    }
  ]
}

Example

In this example, the request lists parameters of the Settings Writer global policy (UUID is d10eb8e0-875a-40c8-821c-6214c23ac0b3).

Curl

bash
curl --request GET \
  --url 'https://api.dynatrace.com/iam/v1/repo/global/global/policies/d10eb8e0-875a-40c8-821c-6214c23ac0b3' \
  --header 'Authorization: Bearer abcdefjhij1234567890'

Request URL

plaintext
https://api.dynatrace.com/iam/v1/repo/global/global/policies/d10eb8e0-875a-40c8-821c-6214c23ac0b3

Response body

json
{
  "uuid": "d10eb8e0-875a-40c8-821c-6214c23ac0b3",
  "name": "Settings Writer",
  "description": "Settings Writer Policy",
  "tags": [],
  "statementQuery": "ALLOW settings:objects:read, settings:objects:write, settings:schemas:read;",
  "statements": [
    {
      "effect": "ALLOW",
      "permissions": [
        "settings:objects:read",
        "settings:objects:write",
        "settings:schemas:read"
      ],
      "conditions": null
    }
  ]
}

Response code

200