Skip to main content

aws_on_demand_tasks

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

Overview

Nameaws_on_demand_tasks
TypeResource
Iddatadog.security.aws_on_demand_tasks

Fields

The following fields are returned by SELECT queries:

OK.

NameDatatypeDescription
idstringThe UUID of the task. (example: 6d09294c-9ad9-42fd-a759-a0c1599b4828)
attributesobjectAttributes for the AWS on demand task.
typestringThe type of the on demand task. The value should always be aws_resource. (default: aws_resource, example: aws_resource)

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
get_aws_on_demand_taskselecttask_id, regionFetch the data of a specific on demand task.
list_aws_on_demand_tasksselectregionFetches the most recent 1000 AWS on demand tasks.
create_aws_on_demand_taskinsertregion, data__dataTrigger the scan of an AWS resource with a high priority. Agentless scanning must be activated for the AWS account containing the resource to scan.

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
regionstring(default: datadoghq.com)
task_idstringThe UUID of the task. (example: 6d09294c-9ad9-42fd-a759-a0c1599b4828)

SELECT examples

Fetch the data of a specific on demand task.

SELECT
id,
attributes,
type
FROM datadog.security.aws_on_demand_tasks
WHERE task_id = '{{ task_id }}' -- required
AND region = '{{ region }}' -- required
;

INSERT examples

Trigger the scan of an AWS resource with a high priority. Agentless scanning must be activated for the AWS account containing the resource to scan.

INSERT INTO datadog.security.aws_on_demand_tasks (
data__data,
region
)
SELECT
'{{ data }}' /* required */,
'{{ region }}'
RETURNING
data
;