Skip to main content

rule_version_history

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

Overview

Namerule_version_history
TypeResource
Iddatadog.security.rule_version_history

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
idstringID of the rule.
attributesobjectResponse object containing the version history of a rule.
typestringType of data. (GetRuleVersionHistoryResponse)

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
get_rule_version_historyselectrule_idpage[size], page[number]Get a rule's version history.

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
rule_idstringThe ID of the rule.
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.
page[number]integer (int64)Specific page number to return.
page[size]integer (int64)Number of items to return per page. The maximum allowed value is 100.

SELECT examples

Get a rule's version history.

SELECT
id,
attributes,
type
FROM datadog.security.rule_version_history
WHERE rule_id = '{{ rule_id }}' -- required
AND page[size] = '{{ page[size] }}'
AND page[number] = '{{ page[number] }}'
;