Skip to main content

csm_setting_host_facet_infos

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

Overview

Namecsm_setting_host_facet_infos
TypeResource
Iddatadog.security.csm_setting_host_facet_infos

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
idstringThe identifier of the facet. (example: cloud_provider)
attributesobjectAttributes of a facet info response, containing the value distribution for the requested facet.
metaobjectMetadata for the facet info response.
typestringThe JSON:API type for facet info resources. The value should always be facet_info. (facet_info) (default: facet_info, example: facet_info)

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
get_csmunified_host_facet_infoselectfacetsearch, queryGet the value distribution for a specific unified host facet, with optional search 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
facetstringThe facet identifier to retrieve value distribution for. Valid values include resource_name, account_id, resource_type, cloud_provider, agentless_vulnerability_scanning, agentless_posture_management, hostname, agent_version, os, cluster_name, agent_posture_management, agent_cws_enabled, agent_csm_vm_hosts_enabled, and agent_csm_vm_containers_enabled.
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.
querystringA filter query to scope the facet value counts.

SELECT examples

Get the value distribution for a specific unified host facet, with optional search and filtering.

SELECT
id,
attributes,
meta,
type
FROM datadog.security.csm_setting_host_facet_infos
WHERE facet = '{{ facet }}' -- required
AND search = '{{ search }}'
AND query = '{{ query }}'
;