Skip to main content

agent_versions

Creates, updates, deletes, gets or lists an agent_versions resource.

Overview

Nameagent_versions
TypeResource
Iddatadog.fleet.agent_versions

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
idstringThe agent version string used as the unique identifier. (example: 7.81.1)
attributesobjectAttributes of an available Datadog Agent version.
typestringThe type of the agent version resource. (agent_version) (default: agent_version, example: agent_version)

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
list_fleet_agent_versions_v2selectRetrieve the list of Datadog Agent versions available for deployment.<br /><br />Returns 200 with an empty data array if the Agent package exists in the catalog<br />but has no available versions, and 404 only if the Agent package itself is absent<br />from the catalog.

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.

SELECT examples

Retrieve the list of Datadog Agent versions available for deployment.<br /><br />Returns 200 with an empty data array if the Agent package exists in the catalog<br />but has no available versions, and 404 only if the Agent package itself is absent<br />from the catalog.

SELECT
id,
attributes,
type
FROM datadog.fleet.agent_versions
;