events_detection_jobs

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

Overview

Name	events_detection_jobs
Type	Resource
Id	aws.comprehend.events_detection_jobs

Fields

The following fields are returned by SELECT queries:

describe_events_detection_job

Name	Datatype	Description
data_access_role_arn	string	The Amazon Resource Name (ARN) of the IAM role that grants Amazon Comprehend read access to your input data. (pattern: <code>arn:aws(-[^:]+)?:iam::[0-9]{12}:role/.+</code>)
end_time	string (date-time)	The time that the events detection job completed.
input_data_config	object	The input data configuration that you supplied when you created the events detection job.
job_arn	string	The Amazon Resource Name (ARN) of the events detection job. It is a unique, fully qualified identifier for the job. It includes the Amazon Web Services account, Amazon Web Services Region, and the job ID. The format of the ARN is as follows: arn:<partition>:comprehend:<region>:<account-id>:events-detection-job/<job-id> The following is an example job ARN: arn:aws:comprehend:us-west-2:111122223333:events-detection-job/1234abcd12ab34cd56ef1234567890ab (pattern: <code>arn:aws(-[^:]+)?:comprehend:[a-zA-Z0-9-]:[0-9]{12}:[a-zA-Z0-9-]{1,64}/[a-zA-Z0-9](-[a-zA-Z0-9])((/dataset/[a-zA-Z0-9](-[a-zA-Z0-9]))|(/version/[a-zA-Z0-9](-[a-zA-Z0-9])*))?</code>)
job_id	string	The identifier assigned to the events detection job. (pattern: <code>^([\p{L}\p{Z}\p{N}_.:/=+-%@]*)$</code>)
job_name	string	The name you assigned the events detection job. (pattern: <code>^([\p{L}\p{Z}\p{N}_.:/=+-%@]*)$</code>)
job_status	string	The current status of the events detection job. (SUBMITTED, IN_PROGRESS, COMPLETED, FAILED, STOP_REQUESTED, STOPPED)
language_code	string	The language code of the input documents. (en, es, fr, de, it, pt, ar, hi, ja, ko, zh, zh-TW)
message	string	A description of the status of the events detection job.
output_data_config	object	The output data configuration that you supplied when you created the events detection job.
submit_time	string (date-time)	The time that the events detection job was submitted for processing.
target_event_types	array	The types of events that are detected by the job.

list_events_detection_jobs

Name	Datatype	Description
events_detection_job_properties_list	array	A list containing the properties of each job that is returned.
next_token	string	Identifies the next page of results to return.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
describe_events_detection_job	select	region		Gets the status and details of an events detection job.
list_events_detection_jobs	select	region		Gets a list of the events detection jobs that you have submitted.

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

describe_events_detection_job

Gets the status and details of an events detection job.

SELECT
data_access_role_arn,
end_time,
input_data_config,
job_arn,
job_id,
job_name,
job_status,
language_code,
message,
output_data_config,
submit_time,
target_event_types
FROM aws.comprehend.events_detection_jobs
WHERE region = '{{ region }}' -- required
;

list_events_detection_jobs

Gets a list of the events detection jobs that you have submitted.

SELECT
events_detection_job_properties_list,
next_token
FROM aws.comprehend.events_detection_jobs
WHERE region = '{{ region }}' -- required
;