csm_setting_host_facet_infos
Creates, updates, deletes, gets or lists a csm_setting_host_facet_infos resource.
Overview
| Name | csm_setting_host_facet_infos |
| Type | Resource |
| Id | datadog.security.csm_setting_host_facet_infos |
Fields
The following fields are returned by SELECT queries:
- get_csmunified_host_facet_info
| Name | Datatype | Description |
|---|---|---|
id | string | The identifier of the facet. (example: cloud_provider) |
attributes | object | Attributes of a facet info response, containing the value distribution for the requested facet. |
meta | object | Metadata for the facet info response. |
type | string | The 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:
| Name | Accessible by | Required Params | Optional Params | Description |
|---|---|---|---|---|
get_csmunified_host_facet_info | select | facet | search, query | Get 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.
| Name | Datatype | Description |
|---|---|---|
facet | string | The 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. |
site | string | The 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. |
query | string | A filter query to scope the facet value counts. |
search | string | A search string to filter the facet values. |
SELECT examples
- get_csmunified_host_facet_info
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 }}'
;