Skip to main content

containers

Creates, updates, deletes, gets or lists a containers resource.

Overview

Namecontainers
TypeResource
Iddatadog.infrastructure.containers

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
list_containersselectregionfilter[tags], group_by, sort, page[size], page[cursor]Get all containers for your organization.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
regionstring(default: datadoghq.com)
filter[tags]stringComma-separated list of tags to filter containers by. (example: env:prod,short_image:cassandra)
group_bystringComma-separated list of tags to group containers by. (example: datacenter,cluster)
page[cursor]stringString to query the next page of results. This key is provided with each valid response from the API in meta.pagination.next_cursor.
page[size]integer (int32)Maximum number of results returned.
sortstringAttribute to sort containers by. (example: started_at)

SELECT examples

Get all containers for your organization.

SELECT
*
FROM datadog.infrastructure.containers
WHERE region = '{{ region }}' -- required
AND filter[tags] = '{{ filter[tags] }}'
AND group_by = '{{ group_by }}'
AND sort = '{{ sort }}'
AND page[size] = '{{ page[size] }}'
AND page[cursor] = '{{ page[cursor] }}'
;