List container image references for Dynatrace components from a registry with the Fleet Management API, resolved to your configured target versions.
| GET | SaaS | https://{your-environment-id}.apps.dynatrace.com/v1/components/container-images |
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.
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.
| Parameter | Type | Description | In | Required |
|---|---|---|---|---|
| registry | string | Registry name containing the container images. For a list of registries, see Dynatrace Documentation | query | Optional |
| Code | Type | Description |
|---|---|---|
| 200 | Container | Container images data returned |
| 4XX | Error | Client side error. |
| 5XX | Error | Server side error. |
ContainerImageData objectInformation about images registry and components with URI.
| Element | Type | Description |
|---|---|---|
| components | Container | List of container image components. |
| registry | string | Registry name containing container images. |
ContainerImageComponent objectInformation about component type and images registry URI.
| Element | Type | Description |
|---|---|---|
| imageUri | string | Registry URI of the container image component. |
| type | Container | Container image component type. The element can hold these values
|
ContainerImageComponentType objectContainer image component type.
ErrorEnvelope object| Element | Type | Description |
|---|---|---|
| error | Error | - |
Error object| Element | Type | Description |
|---|---|---|
| code | integer | The HTTP status code |
| constraintViolations | Constraint | A list of constraint violations |
| message | string | The error message |
ConstraintViolation objectA list of constraint violations
| Element | Type | Description |
|---|---|---|
| location | string | - |
| message | string | - |
| parameterLocation | string | -The element can hold these values
|
| path | string | - |
{"components": [{"imageUri": "string","type": "activegate"}],"registry": "string"}
{"error": {"code": 1,"constraintViolations": [{"location": "string","message": "string","parameterLocation": "HEADER","path": "string"}],"message": "string"}}