Attributes of a unified host, combining data from agent and agentless sources.
account_id
string
The ID of the cloud account that the host belongs to. Present only when the host was discovered through agentless scanning.
agent_csm_vm_containers_enabled
boolean
Whether CSM Vulnerabilities is enabled for containers through the Datadog Agent. true if enabled; false if disabled.
agent_csm_vm_hosts_enabled
boolean
Whether CSM Vulnerabilities is enabled for hosts through the Datadog Agent. true if enabled; false if disabled.
agent_cws_enabled
boolean
Whether CSM Threats is enabled for this host through the Datadog Agent. true if enabled; false if disabled.
agent_posture_management
boolean
Whether CSM Misconfigurations is enabled for this host through the Datadog Agent. true if enabled; false if disabled.
agent_version
string
The version of the Datadog Agent running on this host.
agentless_posture_management
boolean
Whether CSM Misconfigurations is enabled for this host via agentless scanning. true if enabled; false if disabled.
agentless_vulnerability_scanning
boolean
Whether CSM Vulnerabilities is enabled for this host via agentless scanning. true if enabled; false if disabled.
cloud_provider
enum
The cloud provider of a host resource.
Allowed enum values: aws,gcp,azure,oci
cluster_name
string
The name of the Kubernetes cluster the host belongs to, if applicable.
datadog_agent_key
string
The Datadog Agent key associated with this host. Present only for agent-sourced hosts.
env
[string]
The list of environment tags associated with this host.
host_id
int64
The internal Datadog host identifier. Present only for agent-sourced hosts.
install_method_tool
string
The tool used to install the Datadog Agent on this host.
os
string
The operating system of the host. Present only for agent-sourced hosts.
resource_type
enum
The type of cloud resource for an agentless host.
Allowed enum values: aws_ec2_instance,azure_virtual_machine_instance,gcp_compute_instance,oci_instance
source [required]
enum
The source of a unified host entry, indicating whether it was discovered via agent, agentless scanning, or both.
Allowed enum values: agent,agentless,both
id [required]
string
The resource identifier of the unified host.
type [required]
enum
The JSON:API type for unified host resources. The value should always be unified_host.
Allowed enum values: unified_host
default: unified_host
meta [required]
object
Pagination metadata for a unified hosts list response.
page_index [required]
int64
The current page index (zero-based).
page_size [required]
int64
The number of hosts returned per page.
total_filtered [required]
int64
The total number of hosts matching the filter criteria.
DD_SITE="datadoghq.comus3.datadoghq.comus5.datadoghq.comdatadoghq.euap1.datadoghq.comap2.datadoghq.comuk1.datadoghq.comddog-gov.comus2.ddog-gov.com"DD_API_KEY="<API-KEY>"DD_APP_KEY="<APP-KEY>"cargo run
/**
* List unified hosts returns "OK" response
*/import{client,v2}from"@datadog/datadog-api-client";constconfiguration=client.createConfiguration();configuration.unstableOperations["v2.listCSMUnifiedHosts"]=true;constapiInstance=newv2.CSMSettingsApi(configuration);apiInstance.listCSMUnifiedHosts().then((data: v2.CsmUnifiedHostsResponse)=>{console.log("API called successfully. Returned data: "+JSON.stringify(data));}).catch((error: any)=>console.error(error));