Try it free

List PMI processes

  • Latest Dynatrace
  • Reference
  • Published Oct 13, 2026
  • Early Access

List Java processes available for PMI metric collection in Dynatrace with the Extensions 2.0 API, and filter the discovered processes.

GETSaaShttps://{your-environment-id}.apps.dynatrace.com/platform/extensions/v2/discovery/pmi/processes

Overview

You use the filter query parameter to narrow the Java processes discovered in the environment for PMI metric collection. The operation returns a success response with the matching processes.

Authentication

To execute this request, you need a platform token or OAuth access token with extensions:discovery.pmi:read scope. To learn how to obtain and use it, see Tokens and authentication.

Parameters

ParameterTypeDescriptionInRequired
filterstring

The filter parameter, as explained here.

Filtering is supported on the following field:

  • hostId - the ID of the host the process is running on, in the form HOST-XXXXXXXXXXXXXXXX.

If the parameter is omitted, all processes are returned.

Example: hostId = 'HOST-1234ABCD5678EFAB'

queryOptional

Response

Response codes

CodeTypeDescription
200JavaProcessContainerList

Success.

4XXErrorEnvelope

Client error.

5XXErrorEnvelope

Server error.

Response body objects

The JavaProcessContainerList object

ElementTypeDescription
itemsJavaProcessContainer[]-

The JavaProcessContainer object

ElementTypeDescription
agentVersionstring-
idstring-
namestring-
propertiesobject-

The ErrorEnvelope object

ElementTypeDescription
errorError-

The Error object

ElementTypeDescription
codeinteger

The HTTP status code.

detailsErrorDetails

The error details.

messagestring

The error message.

The ErrorDetails object

The error details.

ElementTypeDescription
constraintViolationsConstraintViolation[]

A list of constraint violations.

The ConstraintViolation object

A list of constraint violations.

ElementTypeDescription
locationstring-
messagestring-
parameterLocationstring-
The element can hold these values
  • HEADER
  • PATH
  • PAYLOAD_BODY
  • QUERY
pathstring-

Response body JSON models

{
"items": [
{
"agentVersion": "string",
"id": "string",
"name": "string",
"properties": {}
}
]
}
{
"error": {
"code": 1,
"details": {
"constraintViolations": [
{
"location": "string",
"message": "string",
"parameterLocation": "HEADER",
"path": "string"
}
]
},
"message": "string"
}
}
Related tags
Platform APIDynatrace PlatformInfrastructure Observability