Skip to main content

csm_agents

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

Overview

Namecsm_agents
TypeResource
Iddatadog.security.csm_agents

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
idstringThe ID of the Agent. (example: fffffc5505f6a006fdf7cf5aae053653)
attributesobjectA CSM Agent returned by the API.
typestringThe type of the resource. The value should always be datadog_agent. (datadog_agent) (default: datadog_agent, example: datadog_agent)

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
list_all_csmagentsselectpage, size, query, order_directionGet the list of all CSM Agents running on your hosts and containers.

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
sitestringThe Datadog site (region) for your organization, for example datadoghq.com, us3.datadoghq.com, us5.datadoghq.com, ap1.datadoghq.com, ap2.datadoghq.com, datadoghq.eu, ddog-gov.com. Resolved from the DD_SITE environment variable when set. Optional: defaults to datadoghq.com, or the value of the DD_SITE environment variable when set; a WHERE value overrides both.
order_directionstringThe sort direction for results. Use asc for ascending or desc for descending.
pageinteger (int32)The page index for pagination (zero-based).
querystringA search query string to filter results (for example, hostname:COMP-T2H4J27423).
sizeinteger (int32)The number of items to include in a single page.

SELECT examples

Get the list of all CSM Agents running on your hosts and containers.

SELECT
id,
attributes,
type
FROM datadog.security.csm_agents
WHERE page = '{{ page }}'
AND size = '{{ size }}'
AND query = '{{ query }}'
AND order_direction = '{{ order_direction }}'
;