Turn the IP allowlist policy on or off for any dashboard share in your Dynatrace environment as an admin with the Public Access API to restrict access.
| PUT | SaaS | https://{your-environment-id}.apps.dynatrace.com/v1/admin/shares/{shareId}/ip-allowlist |
You use this admin operation with the shareId path parameter and the enabled field in the request body to turn the IP allowlist policy of any dashboard share configuration on or off. With the policy on, only viewers from allowed IP addresses can open the public link. A 200 response confirms the new setting.
To execute this request, you need a platform token or OAuth access token with public-access:shares:admin scope. To learn how to obtain and use it, see Tokens and authentication.
| Parameter | Type | Description | In | Required |
|---|---|---|---|---|
| shareId | string | The UUID of the share config | path | Required |
| body | object | - | body | Required |
RequestBody object| Element | Type | Description | Required |
|---|---|---|---|
| enabled | boolean | Enables or disables the IP allowlist for the shared config | Required |
This is a model of the request body, showing the possible elements. It has to be adjusted for usage in an actual request.
{"enabled": true}
| Code | Description |
|---|---|
| 200 | IP allowlist set |
| 404 | - |
| 4XX | - |
| 5XX | - |