Extensions 2.0 API - GET the status of a monitoring configuration

Gets the most recent execution of a monitoring configuration.

The request produces an application/json payload.

GETSaaShttps://{your-environment-id}.live.dynatrace.com/api/v2/extensions/{extensionName}/monitoringConfigurations/{configurationId}/status
Environment ActiveGateCluster ActiveGatehttps://{your-activegate-domain}:9999/e/{your-environment-id}/api/v2/extensions/{extensionName}/monitoringConfigurations/{configurationId}/status

Authentication

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

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

Parameters

ParameterTypeDescriptionInRequired
extensionNamestring

The name of the requested extension 2.0.

pathrequired
configurationIdstring

The ID of the requested monitoring configuration.

pathrequired

Response

Response codes

CodeTypeDescription
200ExtensionStatusDto

Success

404ErrorEnvelope

Failed. The requested resource doesn't exist.

4XXErrorEnvelope

Client side error.

5XXErrorEnvelope

Server side error.

Response body objects

The ExtensionStatusDto object

ElementTypeDescription
statusstring

Latest status of given configuration.

  • ERROR
  • OK
  • UNKNOWN
timestampinteger

Timestamp of the latest status of given configuration.

Response body JSON model

{
"status": "ERROR",
"timestamp": 1
}