Resolve the calling user's effective settings permissions in Dynatrace with the App Settings API from a permissions request body.
| POST | SaaS | https://{your-environment-id}.apps.dynatrace.com/v2/effective-permissions:resolve |
You send a permissions request body to resolve the calling user's effective settings permissions in the environment. Dynatrace returns success for the App Settings API operation when the request is accepted.
To execute this request, you need a platform token or OAuth access token with all of the following scopes:
app-settings:objects:readapp-settings:objects:writeTo learn how to obtain and use it, see Tokens and authentication.
| Parameter | Type | Description | In | Required |
|---|---|---|---|---|
| body | Resolution | - | body | Required |
ResolutionRequest object| Element | Type | Description | Required |
|---|---|---|---|
| permissions | Single | - | Required |
SinglePermissionRequest objectoptional generic set of context data
| Element | Type | Description | Required |
|---|---|---|---|
| permission | string | -The element can hold these values
| Required |
| context | Permission | - | Optional |
PermissionContext object| Element | Type | Description | Required |
|---|---|---|---|
| schemaId | string | - | Required |
This is a model of the request body, showing the possible elements. It has to be adjusted for usage in an actual request.
{"permissions": [{"permission": "app-settings:objects:read","context": {"schemaId": "string"}}]}
| Code | Type | Description |
|---|---|---|
| 200 | - | - |
| 400 | Error | Failed. The input is invalid. |
| 403 | Error | Failed. Forbidden. No access to any schema. |
| 4XX | - | - |
| 5XX | - | - |
ErrorResponse object| Element | Type | Description |
|---|---|---|
| error | Error | Standard error response |
Error objectStandard error response
| Element | Type | Description |
|---|---|---|
| code | number | The error code (HTTP response) |
| message | string | The error message |
| retryAfterSeconds | number | Number of seconds a request can be retried after a 'too many requests' error response. |
| details | Error | Optional details of the error |
ErrorDetails objectOptional details of the error
| Element | Type | Description |
|---|---|---|
| errorRef | string | reference to the error occurrence in the internal self-monitoring, logging, etc. |
| constraintViolations | Constraint | A list of constraint violations of input parameters (path, query, request body) |
| missingScopes | string[] | In case of a 403 - Forbidden response, a list of missing scopes necessary to successfully execute the request |
ConstraintViolation objectContains information about a constraint violation caused by invalid input.
| Element | Type | Description |
|---|---|---|
| path | string | The path of the parameter that caused the constraint violation |
| message | string | The constraint violation description message |
| parameterLocation | string | Describes the general location of the violating parameter The element can hold these values
|
{"error": {"code": 1,"message": "string","retryAfterSeconds": 1,"details": {"errorRef": "string","constraintViolations": [{"path": "string","message": "string","parameterLocation": "PATH"}],"missingScopes": ["string"]}}}