Skip to main content

csm_setting_hosts

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

Overview

Namecsm_setting_hosts
TypeResource
Iddatadog.security.csm_setting_hosts

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
idstringThe resource identifier of the unified host. (example: i-0123456789abcdef0)
attributesobjectAttributes of a unified host, combining data from agent and agentless sources.
typestringThe JSON:API type for unified host resources. The value should always be unified_host. (unified_host) (default: unified_host, example: unified_host)

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
list_csmunified_hostsselectpage, size, queryGet the list of unified hosts for CSM, combining agent and agentless host data, with optional pagination and filtering.

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.
pageinteger (int32)The page index for pagination (zero-based).
querystringA search query string to filter unified hosts.
sizeinteger (int32)The number of hosts to return per page.

SELECT examples

Get the list of unified hosts for CSM, combining agent and agentless host data, with optional pagination and filtering.

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