jobs_by_consumable_resources

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

Overview

Name	jobs_by_consumable_resources
Type	Resource
Id	aws.batch.jobs_by_consumable_resources

Fields

The following fields are returned by SELECT queries:

list_jobs_by_consumable_resource

Name	Datatype	Description
consumable_resource_properties	object	Contains a list of consumable resources required by the job.
created_at	integer (int64)	The Unix timestamp (in milliseconds) for when the consumable resource was created.
job_arn	string	The Amazon Resource Name (ARN) of the job.
job_definition_arn	string	The Amazon Resource Name (ARN) of the job definition.
job_name	string	The name of the job.
job_queue_arn	string	The Amazon Resource Name (ARN) of the job queue.
job_status	string	The status of the job. Can be one of: SUBMITTED PENDING RUNNABLE STARTING RUNNING SUCCEEDED FAILED
quantity	integer (int64)	The total amount of the consumable resource that is available.
share_identifier	string	The fair-share scheduling identifier for the job.
started_at	integer (int64)	The Unix timestamp for when the job was started. More specifically, it's when the job transitioned from the STARTING state to the RUNNING state.
status_reason	string	A short, human-readable string to provide more details for the current status of the job.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
list_jobs_by_consumable_resource	select	region		Returns a list of Batch jobs that require a specific consumable resource.

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

list_jobs_by_consumable_resource

Returns a list of Batch jobs that require a specific consumable resource.

SELECT
consumable_resource_properties,
created_at,
job_arn,
job_definition_arn,
job_name,
job_queue_arn,
job_status,
quantity,
share_identifier,
started_at,
status_reason
FROM aws.batch.jobs_by_consumable_resources
WHERE region = '{{ region }}' -- required
;