backlog_tasks

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

Overview

Name	backlog_tasks
Type	Resource
Id	aws.devops_agent.backlog_tasks

Fields

The following fields are returned by SELECT queries:

get_backlog_task

Name	Datatype	Description
agent_space_id	string	The unique identifier for the agent space containing this task
created_at	string (date-time)	Timestamp when this task was created
description	string	Optional detailed description of the task
execution_id	string	The execution ID associated with this task, if any
has_linked_tasks	boolean	Indicates if this task has other tasks linked to it
metadata	object	Optional metadata for the task
primary_task_id	string	The task ID of the primary investigation this task is linked to
priority	string	Priority levels for tasks, from highest to lowest urgency (CRITICAL, HIGH, MEDIUM, LOW, MINIMAL)
reference	object	Optional reference information linking this task to external systems
status	string	The current status of this task (PENDING_TRIAGE, LINKED, PENDING_START, IN_PROGRESS, PENDING_CUSTOMER_APPROVAL, COMPLETED, FAILED, TIMED_OUT, CANCELED, SKIPPED)
status_reason	string	Explanation for why the task status was changed (e.g., linked reason)
support_metadata	object	Optional support metadata for the task
task_id	string	The unique identifier for this task
task_type	string	Types of tasks that can be created in the backlog (INVESTIGATION, EVALUATION, RELEASE_READINESS_REVIEW, RELEASE_TESTING)
title_	string	The title of the task
updated_at	string (date-time)	Timestamp when this task was last updated
version	integer	Version number for optimistic locking

list_backlog_tasks

Name	Datatype	Description
agent_space_id	string	The unique identifier for the agent space containing this task
created_at	string (date-time)	Timestamp when this task was created
description	string	Optional detailed description of the task
execution_id	string	The execution ID associated with this task, if any
has_linked_tasks	boolean	Indicates if this task has other tasks linked to it
metadata	object	Optional metadata for the task
primary_task_id	string	The task ID of the primary investigation this task is linked to
priority	string	Priority levels for tasks, from highest to lowest urgency (CRITICAL, HIGH, MEDIUM, LOW, MINIMAL)
reference	object	Optional reference information linking this task to external systems
status	string	The current status of this task (PENDING_TRIAGE, LINKED, PENDING_START, IN_PROGRESS, PENDING_CUSTOMER_APPROVAL, COMPLETED, FAILED, TIMED_OUT, CANCELED, SKIPPED)
status_reason	string	Explanation for why the task status was changed (e.g., linked reason)
support_metadata	object	Optional support metadata for the task
task_id	string	The unique identifier for this task
task_type	string	Types of tasks that can be created in the backlog (INVESTIGATION, EVALUATION, RELEASE_READINESS_REVIEW, RELEASE_TESTING)
title_	string	The title of the task
updated_at	string (date-time)	Timestamp when this task was last updated
version	integer	Version number for optimistic locking

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get_backlog_task	select	agent_space_id, task_id, region		Gets a backlog task for the specified agent space and task id
list_backlog_tasks	select	agent_space_id, region		Lists backlog tasks in the specified agent space with optional filtering and sorting
create_backlog_task	insert	agent_space_id, region, taskType, title, priority		Creates a new backlog task in the specified agent space
update_backlog_task	update	agent_space_id, task_id, region		Update an existing backlog task.

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
agent_space_id	string	The unique identifier for the agent space containing the task
region	string	AWS region (default: us-east-1)
task_id	string	The unique identifier of the task to update

SELECT examples

get_backlog_task

Gets a backlog task for the specified agent space and task id

SELECT
agent_space_id,
created_at,
description,
execution_id,
has_linked_tasks,
metadata,
primary_task_id,
priority,
reference,
status,
status_reason,
support_metadata,
task_id,
task_type,
title_,
updated_at,
version
FROM aws.devops_agent.backlog_tasks
WHERE agent_space_id = '{{ agent_space_id }}' -- required
AND task_id = '{{ task_id }}' -- required
AND region = '{{ region }}' -- required
;

list_backlog_tasks

Lists backlog tasks in the specified agent space with optional filtering and sorting

SELECT
agent_space_id,
created_at,
description,
execution_id,
has_linked_tasks,
metadata,
primary_task_id,
priority,
reference,
status,
status_reason,
support_metadata,
task_id,
task_type,
title_,
updated_at,
version
FROM aws.devops_agent.backlog_tasks
WHERE agent_space_id = '{{ agent_space_id }}' -- required
AND region = '{{ region }}' -- required
;

INSERT examples

create_backlog_task

Creates a new backlog task in the specified agent space

INSERT INTO aws.devops_agent.backlog_tasks (
reference,
taskType,
title,
description,
priority,
clientToken,
agent_space_id,
region
)
SELECT 
'{{ reference }}',
'{{ taskType }}' /* required */,
'{{ title }}' /* required */,
'{{ description }}',
'{{ priority }}' /* required */,
'{{ clientToken }}',
'{{ agent_space_id }}',
'{{ region }}'
RETURNING
task
;

Manifest

# Description fields are for documentation purposes
- name: backlog_tasks
props:
  - name: agent_space_id
    value: "{{ agent_space_id }}"
    description: Required parameter for the backlog_tasks resource.
  - name: region
    value: "{{ region }}"
    description: Required parameter for the backlog_tasks resource.
  - name: reference
    description: |
      Reference information linking a task to external systems - for input with validation
    value:
      system: "{{ system }}"
      title_: "{{ title_ }}"
      referenceId: "{{ referenceId }}"
      referenceUrl: "{{ referenceUrl }}"
      associationId: "{{ associationId }}"
  - name: taskType
    value: "{{ taskType }}"
    description: |
      Types of tasks that can be created in the backlog
    valid_values: ['INVESTIGATION', 'EVALUATION', 'RELEASE_READINESS_REVIEW', 'RELEASE_TESTING']
  - name: title
    value: "{{ title }}"
    description: |
      Title for a backlog task (allows printable ASCII characters, tabs, and newlines; 1-400 characters)
  - name: description
    value: "{{ description }}"
    description: |
      Description for a backlog task (allows printable ASCII characters, tabs, and newlines; up to 10000 characters)
  - name: priority
    value: "{{ priority }}"
    description: |
      Priority levels for tasks, from highest to lowest urgency
    valid_values: ['CRITICAL', 'HIGH', 'MEDIUM', 'LOW', 'MINIMAL']
  - name: clientToken
    value: "{{ clientToken }}"

UPDATE examples

update_backlog_task

Update an existing backlog task.

UPDATE aws.devops_agent.backlog_tasks
SET 
taskStatus = '{{ taskStatus }}',
clientToken = '{{ clientToken }}'
WHERE 
agent_space_id = '{{ agent_space_id }}' --required
AND task_id = '{{ task_id }}' --required
AND region = '{{ region }}' --required
RETURNING
task;