Monitoring Amazon Translate events with Amazon EventBridge

Amazon Translate integrates with Amazon EventBridge to notify you about changes that affect your translation jobs and parallel data resources. Events from AWS services are delivered to EventBridge in near real time. You can write simple rules to indicate which events are of interest to you, and what automated actions to take when an event matches a rule. For example, actions that can be automatically started include:

• Invoking an AWS Lambda function

• Invoking AWS Systems Manager Run Command

• Relaying the event to Amazon Kinesis Data Streams

• Activating an AWS Step Functions state machine

• Notifying an Amazon SNS topic or an Amazon SQS queue

For more information, see Creating Amazon EventBridge rules that react to events in the Amazon EventBridge User Guide.

Amazon Translate events

The following are example events from Amazon Translate.

Events for batch translation jobs

You run batch translation jobs by using the Amazon Translate console or the StartTextTranslationJob operation. Amazon Translate sends events when these jobs are complete, either successfully or unsuccessfully. These events resemble the following example.

{
 "version": "0", 
 "id": "CWE-event-id", 
 "detail-type": "Translate TextTranslationJob State Change", 
 "source": "aws.translate", 
 "account": "111122223333", 
 "time": "2017-04-22T03:31:47Z", 
 "region": "us-east-1", 
 "resources": [], 
 "detail": {
    "jobId": "01234567-0123-0123-0123-012345678901", 
    "jobStatus": "STATUS" 
 } 
}

The value for the jobStatus attribute depends on the job state that Amazon Translate sent the event for. The jobStatus values are:

• COMPLETED – The job has successfully completed and the output is available.

• COMPLETED_WITH_ERROR – The job has completed with errors. The errors can be analyzed in the job's output.

• STOPPED – The job has been stopped.

• FAILED – The job did not complete. To get details, use the DescribeTextTranslationJob operation.

Events for parallel data resources

When you use Amazon Translate to create or update a parallel data resource, it sends an event to indicate whether the operation succeeded or failed.

You create parallel data resources by using the Amazon Translate console or the CreateParallelData operation. When you do this, Amazon Translate sends an event like the following.

{
 "version": "0", 
 "id": "CWE-event-id", 
 "detail-type": "Translate Parallel Data State Change", 
 "source": "aws.translate", 
 "account": "111122223333", 
 "time": "2017-04-22T03:31:47Z", 
 "region": "us-east-1", 
 "resources": [arn:aws:translate:us-east-1:111122223333:parallel-data/ExampleParallelData], 
 "detail": {
    "operation": "CreateParallelData",
    "name": "ExampleParallelData", 
    "status": "STATUS"
 } 
}

Values for the status attribute are:

• ACTIVE – The CreateParallelData operation succeeded, and the resource is ready for you to use.

• FAILED – The CreateParallelData operation failed.

You update parallel data resources by using the Amazon Translate console or the UpdateParallelData operation. When you do this, Amazon Translate sends an event like the following.

{
 "version": "0", 
 "id": "CWE-event-id", 
 "detail-type": "Translate Parallel Data State Change", 
 "source": "aws.translate", 
 "account": "111122223333", 
 "time": "2017-04-22T03:31:47Z", 
 "region": "us-east-1", 
 "resources": [arn:aws:translate:us-east-1:111122223333:parallel-data/ExampleParallelData], 
 "detail": {
    "operation": "UpdateParallelData",
    "name": "ExampleParallelData", 
    "status": "STATUS",
    "latestUpdateAttemptStatus": "STATUS",
    "latestUpdateAttemptAt": "2017-04-22T03:31:47Z"
 } 
}

The status attribute provides the status of the prior version of the parallel data resource, which is being replaced by the update. Values are:

• ACTIVE – The prior version was created or updated successfully.

• FAILED – The prior version failed to be created or updated.

The latestUpdateAttemptStatus attribute provides the status of the new version of the parallel data resource, which is being created by the update. Values are:

• ACTIVE – The UpdateParallelData operation succeeded, and the updated resource is ready for you to use.

• FAILED – The UpdateParallelData operation failed.