Extensions API - GET all extension's instances

Lists all instances of the specified extension.

The request produces an application/json payload.

GETSaaShttps://{your-environment-id}.live.dynatrace.com/api/config/v1/extensions/{id}/instances
Environment ActiveGatehttps://{your-activegate-domain}:9999/e/{your-environment-id}/api/config/v1/extensions/{id}/instances

Authentication

To execute this request, you need an access token with ReadConfig scope.

To learn how to obtain and use it, see Tokens and authentication.

Parameters

ParameterTypeDescriptionInRequired
idstring

The ID of the required extension.

pathrequired
pageSizeinteger

The number of results per result page. Must be between 1 and 500

queryoptional
nextPageKeystring

The cursor for the next page of results.

queryoptional

Response

Response codes

CodeTypeDescription
200ExtensionConfigurationList

Success

Response body objects

The ExtensionConfigurationList object

A list of configurations.

ElementTypeDescription
configurationsListEntityShortRepresentation[]

List of configurations.

nextPageKeystring

The cursor for the next page of results. Has the value of null on the last page.

Use it in the nextPageKey query parameter to obtain subsequent pages of the result.

totalResultsinteger

The total number of entries in the result.

The EntityShortRepresentation object

The short representation of a Dynatrace entity.

ElementTypeDescription
descriptionstring

A short description of the Dynatrace entity.

idstring

The ID of the Dynatrace entity.

namestring

The name of the Dynatrace entity.

Response body JSON model

{
"configurationsList": [
{
"id": "HOST-E1550E0AED6A572F"
}
],
"nextPageToken": "LlUdYmu5S2MfX/ppfCInR9M=",
"totalResults": 9
}