Applications detection rules API - GET a rule

  • Reference

Gets parameters of the specified application detection rule.

The request produces an application/json payload.

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

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 application detection rule.

pathrequired

Response

Response codes

CodeTypeDescription
200ApplicationDetectionRuleConfig

Success

Response body objects

The ApplicationDetectionRuleConfig object

Application detection rule.

ElementTypeDescription
applicationIdentifierstring

The Dynatrace entity ID of the application, for example APPLICATION-4A3B43.

You must use an existing ID. If you need to create a rule for an application that doesn't exist yet, create an application first and then configure detection rules for it.

filterConfigApplicationFilter

The condition of an application detection rule.

idstring

The ID of the rule.

metadataConfigurationMetadataDtoImpl

Metadata useful for debugging.

namestring

The unique name of the Application detection rule.

orderstring

The order of the rule in the rules list.

The rules are evaluated from top to bottom. The first matching rule applies.

The ApplicationFilter object

The condition of an application detection rule.

ElementTypeDescription
applicationMatchTargetstring

Where to look for the the pattern value.

  • DOMAIN
  • URL
applicationMatchTypestring

The operator of the matching.

  • BEGINS_WITH
  • CONTAINS
  • ENDS_WITH
  • EQUALS
  • MATCHES
patternstring

The value to look for.

The ConfigurationMetadataDtoImpl object

Metadata useful for debugging.

ElementTypeDescription
clusterVersionstring

Dynatrace version.

configurationVersionsinteger[]

A sorted list of the version numbers of the configuration.

currentConfigurationVersionsstring[]

A sorted list of version numbers of the configuration.

Response body JSON model

{
"applicationIdentifier": "APPLICATION-123456",
"filterConfig": {
"applicationMatchTarget": "DOMAIN",
"applicationMatchType": "EQUALS",
"pattern": "myapp.example.com"
},
"id": "12345678-abcd-1234-abcd-1234567890ab",
"metadata": {
"clusterVersion": "Mock version",
"configurationVersions": [
4,
2
]
},
"name": "uniqueName"
}

Example

In this example, the request gets the properties of the easyTravel rule, which has the ID 95b22afb-4e3d-4f9f-a37d-81bc3d388a33.

The API token is passed in the Authorization header.

Curl

curl -X GET \
https://mySampleEnv.live.dynatrace.com/api/config/v1/applicationDetectionRules/95b22afb-4e3d-4f9f-a37d-81bc3d388a33 \
-H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890'

Request URL

https://mySampleEnv.live.dynatrace.com/api/config/v1/applicationDetectionRules/95b22afb-4e3d-4f9f-a37d-81bc3d388a33

Response body

{
"metadata": {
"configurationVersions": [
0
],
"clusterVersion": "1.188.0.20200203-155649"
},
"id": "95b22afb-4e3d-4f9f-a37d-81bc3d388a33",
"applicationIdentifier": "APPLICATION-900C1E36674F607D",
"filterConfig": {
"pattern": "easyTravel",
"applicationMatchType": "EQUALS",
"applicationMatchTarget": "DOMAIN"
}
}

Response code

200