Updates or creates a policy boundary by uuid within a level. You can't edit a global-level boundary, as these are managed by Dynatrace.
If the specified boundary doesn't exist, a new boundary is created instead.
The request consumes and produces an application/json payload.
PUT |
|
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.
| Parameter | Type | Description | In | Required |
|---|---|---|---|---|
| policyBoundaryUuid | - | The ID of the required boundary. | path | required |
| accountId | - | The ID of the policy boundary level. Use the UUID of the account. | path | required |
| body | Policy | The JSON body of the request. Contains policy boundary | body | required |
PolicyBoundaryDto object| Element | Type | Description | Required |
|---|---|---|---|
| name | string | The display name of the policy boundary. | required |
| boundaryQuery | string | The boundary query of the policy boundary. | required |
| metadata | Map | The metadata of the policy boundary. | required |
Map objectThis is a model of the request body, showing the possible elements. It has to be adjusted for usage in an actual request.
{"name": "string","boundaryQuery": "string","metadata": {}}
| Code | Type | Description |
|---|---|---|
| 201 | Policy | Successful response - policy boundary created |
| 204 | - | Successful response - policy boundary updated |
| 400 | Error | Failed. The request is invalid |
| 404 | Error | Failed. The specified resource is not found. |
PolicyBoundaryOverview object| Element | Type | Description |
|---|---|---|
| uuid | string | - |
| levelType | string | - |
| levelId | string | - |
| name | string | The display name of the policy boundary. |
| boundaryQuery | string | The boundary query of the policy boundary. |
| boundaryConditions | Condition[] | - |
| metadata | Map | The metadata of the policy boundary. |
Condition object| Element | Type | Description |
|---|---|---|
| name | string | The name of the condition. It indicates which part of the services is checked by the condition. |
| operator | string | The operator of the condition. |
| values | string[] | A list of reference values of the condition. |
Map object{"uuid": "string","levelType": "string","levelId": "string","name": "string","boundaryQuery": "string","boundaryConditions": [{"name": "string","operator": "string","values": ["string"]}],"metadata": {}}
We recommend that you validate the payload before submitting it with an actual request. A response code of 200 indicates a valid payload.
The request consumes an application/json payload.
POST |
|
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.
| Parameter | Type | Description | In | Required |
|---|---|---|---|---|
| policyUuid | - | The ID of the policy to be validated. | path | required |
| levelId | - | The ID of the policy level. Use one of the following values, depending on the level type:
| path | required |
| levelType | - | 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 |
| body | Create | The JSON body of the request. Contains the configuration of a policy to be validated. | body | required |
CreateOrUpdateLevelPolicyRequestDto object| Element | Type | Description | Required |
|---|---|---|---|
| name | string | The display name of the policy. | required |
| description | string | A short description of the policy. | required |
| tags | string[] | A list of tags. | optional |
| statementQuery | string | The statement of the policy. | required |
This is a model of the request body, showing the possible elements. It has to be adjusted for usage in an actual request.
{"name": "string","description": "string","tags": ["string"],"statementQuery": "string"}
In this example, the request updates the name of the policy boundary with UUID of 3c9f1a72-bd84-4e6c-9f03-7a1e2c4d5b68 for the account with the accountId f1a2b3c4-d5e6-7890-ab12-34cd56ef7890.
curl --request PUT \--url https://api.dynatrace.com/iam/v1/repo/account/f1a2b3c4-d5e6-7890-ab12-34cd56ef7890/boundaries/3c9f1a72-bd84-4e6c-9f03-7a1e2c4d5b68 \--header 'Authorization: Bearer abcdefjhij1234567890' \--header 'Content-Type: application/json' \--data '{"name": "host name","description": "storage:host.name = \"myHost\"","metadata": {}}'
https://api.dynatrace.com/iam/v1/repo/account/f1a2b3c4-d5e6-7890-ab12-34cd56ef7890/boundaries/3c9f1a72-bd84-4e6c-9f03-7a1e2c4d5b68
{"name": "host name","boundaryQuery": "storage:host.name = \"myHost\";","metadata": {}}
204 - Successful response - policy boundary updated.