Try it free

List container images of Dynatrace components

  • Latest Dynatrace
  • Reference
  • Published Oct 13, 2026

List container image references for Dynatrace components from a registry with the Fleet Management API, resolved to your configured target versions.

GETSaaShttps://{your-environment-id}.apps.dynatrace.com/v1/components/container-images

Overview

Returns container image references for Dynatrace components from the specified registry. Returned image versions are resolved based on the configured target versions: dynatrace-activegate, dynatrace-eec, dynatrace-sql-extension-executor, and dynatrace-database-datasource-executor image versions are resolved from the ActiveGate target version; dynatrace-oneagent, dynatrace-codemodules, and dynatrace-logmodule image versions are resolved from the OneAgent target version. If no target version is configured for a component, the latest available image is returned.

Authentication

To execute this request, you need a platform token or OAuth access token with fleet-management:container-images:read scope. To learn how to obtain and use it, see Tokens and authentication.

Parameters

ParameterTypeDescriptionInRequired
registrystring

Registry name containing the container images. For a list of registries, see Dynatrace Documentation

queryOptional

Response

Response codes

CodeTypeDescription
200ContainerImageData

Container images data returned

4XXErrorEnvelope

Client side error.

5XXErrorEnvelope

Server side error.

Response body objects

The ContainerImageData object

Information about images registry and components with URI.

ElementTypeDescription
componentsContainerImageComponent[]

List of container image components.

registrystring

Registry name containing container images.

The ContainerImageComponent object

Information about component type and images registry URI.

ElementTypeDescription
imageUristring

Registry URI of the container image component.

typeContainerImageComponentType

Container image component type.

The element can hold these values
  • activegate
  • codemodules
  • database-datasource-executor
  • sql-extension-executor
  • dynatrace-sql-extension-executor
  • eec
  • logmodule
  • oneagent

The ContainerImageComponentType object

Container image component type.

The ErrorEnvelope object

ElementTypeDescription
errorError-

The Error object

ElementTypeDescription
codeinteger

The HTTP status code

constraintViolationsConstraintViolation[]

A list of constraint violations

messagestring

The error message

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

{
"components": [
{
"imageUri": "string",
"type": "activegate"
}
],
"registry": "string"
}
{
"error": {
"code": 1,
"constraintViolations": [
{
"location": "string",
"message": "string",
"parameterLocation": "HEADER",
"path": "string"
}
],
"message": "string"
}
}
Related tags
Platform APIDynatrace Platform