Skip to main content

archive_order

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

Overview

Namearchive_order
TypeResource
Iddatadog.logs.archive_order

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
attributesobjectThe attributes associated with the archive order.
typestringType of the archive order definition. (archive_order) (default: archive_order, example: archive_order)

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
get_logs_archive_orderselectGet the current order of your archives.<br />This endpoint takes no JSON arguments.
update_logs_archive_orderreplaceUpdate the order of your archives. Since logs are processed sequentially, reordering an archive may change<br />the structure and content of the data processed by other archives.<br /><br />Note: Using the PUT method updates your archive's order by replacing the current order<br />with the new one.

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

Get the current order of your archives.<br />This endpoint takes no JSON arguments.

SELECT
attributes,
type
FROM datadog.logs.archive_order
;

REPLACE examples

Update the order of your archives. Since logs are processed sequentially, reordering an archive may change<br />the structure and content of the data processed by other archives.<br /><br />Note: Using the PUT method updates your archive's order by replacing the current order<br />with the new one.

REPLACE datadog.logs.archive_order
SET
data = '{{ data }}'
WHERE
RETURNING
data;