List the Dynatrace network addresses your components connect to with the Fleet Management API, page by page, for example to configure firewalls.
| GET | SaaS | https://{your-environment-id}.apps.dynatrace.com/v1/network-addresses |
You use this operation to list the Dynatrace addresses of your environment. The response is paginated: set page-size for the number of addresses per page and pass the nextPageKey from a previous response as page-key to get the next page. Typical usage is configuring firewall rules or proxies for your monitoring components.
To execute this request, you need a platform token or OAuth access token with fleet-management:public-addresses:read scope. To learn how to obtain and use it, see Tokens and authentication.
| Parameter | Type | Description | In | Required |
|---|---|---|---|---|
| page-key | string | The cursor for the next page of results. You can find it in the nextPageKey field of the previous response. The first page is always returned if you don't specify the page-key query parameter. When the page-key is set to obtain subsequent pages, you must omit all other query parameters. | query | Optional |
| page-size | integer | The amount of Dynatrace addresses in a single response payload. The maximal allowed page size is 1000 and the minimum size is 10. If not set, 10 is used. | query | Optional |
| Code | Type | Description |
|---|---|---|
| 200 | Network | Success |
| 4XX | Error | Client side error. |
| 5XX | Error | Server side error. |
NetworkAddresses objectList of Dynatrace addresses
| Element | Type | Description |
|---|---|---|
| addresses | string[] | List of Dynatrace addresses. |
| nextPageKey | string | The cursor for the next page of results. Has the value of Use it in the page-key query parameter to obtain subsequent pages of the result. |
| pageSize | integer | The number of entries per page. |
| totalCount | string | The total number of entries in the result. |
ErrorEnvelope object| Element | Type | Description |
|---|---|---|
| error | Error | - |
Error object| Element | Type | Description |
|---|---|---|
| code | integer | The HTTP status code |
| constraintViolations | Constraint | A list of constraint violations |
| message | string | The error message |
ConstraintViolation objectA list of constraint violations
| Element | Type | Description |
|---|---|---|
| location | string | - |
| message | string | - |
| parameterLocation | string | -The element can hold these values
|
| path | string | - |
{"addresses": ["string"],"nextPageKey": "AQAAABQBAAAABQ==","pageSize": 100,"totalCount": "1000"}
{"error": {"code": 1,"constraintViolations": [{"location": "string","message": "string","parameterLocation": "HEADER","path": "string"}],"message": "string"}}