pentest_job_tasks

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

Overview

Name	pentest_job_tasks
Type	Resource
Id	aws.securityagent.pentest_job_tasks

Fields

The following fields are returned by SELECT queries:

batch_get_pentest_job_tasks

Name	Datatype	Description
not_found	array	The list of task identifiers that were not found.
tasks	array	The list of tasks that were found.

list_pentest_job_tasks

Name	Datatype	Description
agent_space_id	string	The unique identifier of the agent space.
created_at	string (date-time)	The date and time the task was created, in UTC format.
execution_status	string	The current execution status of the task. (IN_PROGRESS, ABORTED, COMPLETED, INTERNAL_ERROR, FAILED)
pentest_id	string	The unique identifier of the pentest associated with the task.
pentest_job_id	string	The unique identifier of the pentest job that contains the task.
risk_type	string	Type of security risk. (CROSS_SITE_SCRIPTING, DEFAULT_CREDENTIALS, INSECURE_DIRECT_OBJECT_REFERENCE, PRIVILEGE_ESCALATION, SERVER_SIDE_TEMPLATE_INJECTION, COMMAND_INJECTION, CODE_INJECTION, SQL_INJECTION, ARBITRARY_FILE_UPLOAD, INSECURE_DESERIALIZATION, LOCAL_FILE_INCLUSION, INFORMATION_DISCLOSURE, PATH_TRAVERSAL, SERVER_SIDE_REQUEST_FORGERY, JSON_WEB_TOKEN_VULNERABILITIES, XML_EXTERNAL_ENTITY, FILE_DELETION, OTHER, GRAPHQL_VULNERABILITIES, BUSINESS_LOGIC_VULNERABILITIES, CRYPTOGRAPHIC_VULNERABILITIES, DENIAL_OF_SERVICE, FILE_ACCESS, FILE_CREATION, DATABASE_MODIFICATION, DATABASE_ACCESS, OUTBOUND_SERVICE_REQUEST, UNKNOWN)
task_hours	number (double)	The number of active work hours consumed by the task during execution.
task_id	string	The unique identifier of the task.
title_	string	The title of the task.
updated_at	string (date-time)	The date and time the task was last updated, in UTC format.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
batch_get_pentest_job_tasks	select	region		Retrieves information about one or more tasks within a pentest job.
list_pentest_job_tasks	select	region		Returns a paginated list of task summaries for the specified pentest job, optionally filtered by step name or category.

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.

Name	Datatype	Description
region	string	AWS region (default: us-east-1)

SELECT examples

batch_get_pentest_job_tasks

Retrieves information about one or more tasks within a pentest job.

SELECT
not_found,
tasks
FROM aws.securityagent.pentest_job_tasks
WHERE region = '{{ region }}' -- required
;

list_pentest_job_tasks

Returns a paginated list of task summaries for the specified pentest job, optionally filtered by step name or category.

SELECT
agent_space_id,
created_at,
execution_status,
pentest_id,
pentest_job_id,
risk_type,
task_hours,
task_id,
title_,
updated_at
FROM aws.securityagent.pentest_job_tasks
WHERE region = '{{ region }}' -- required
;