本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 使用 Amazon EventBridge 監控 Amazon Translate 事件 EventBridge
<a name="monitoring-with-eventbridge"></a>

Amazon Translate 與 Amazon EventBridge 整合，以通知您影響翻譯任務和平行資料資源的變更。來自 AWS 服務的事件會以近乎即時的方式交付至 EventBridge。您可編寫簡單的規則，來指示您在意的事件，以及當事件符合規則時所要自動執行的動作。例如，可自動啟動的動作包括：
+ 叫用 AWS Lambda 函數
+ 叫用 AWS Systems Manager Run 命令
+ 將事件轉傳至 Amazon Kinesis Data Streams
+ 啟用 AWS Step Functions 狀態機器
+ 通知 Amazon SNS 主題或 Amazon SQS 佇列

如需詳細資訊，請參閱*「Amazon EventBridge 使用者指南」*中的[建立對事件做出反應的 Amazon EventBridge 規則](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule.html)。

## Amazon Translate 事件
<a name="monitoring-with-eventbridge-events"></a>

以下是來自 Amazon Translate 的範例事件。

### 批次翻譯任務的事件
<a name="monitoring-with-eventbridge-events"></a>

您可以使用 Amazon Translate 主控台或 [StartTextTranslationJob](https://docs.aws.amazon.com/translate/latest/APIReference/API_StartTextTranslationJob.html) 操作來執行批次翻譯任務。Amazon Translate 會在這些任務完成時傳送事件，無論是成功還是失敗。這些事件類似下列範例。

```
{
 "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}}" 
 } 
}
```

`jobStatus` 屬性的值取決於 Amazon Translate 傳送事件的目標任務狀態。這些`jobStatus`值為：
+ `COMPLETED` – 任務已成功完成，且輸出可用。
+ `COMPLETED_WITH_ERROR` – 任務已完成，但發生錯誤。您可以在任務的輸出中分析錯誤。
+ `STOPPED` – 任務已停止。
+ `FAILED` – 任務未完成。若要取得詳細資訊，請使用 [DescribeTextTranslationJob](https://docs.aws.amazon.com/translate/latest/APIReference/API_DescribeTextTranslationJob.html) 操作。

### 平行資料資源的事件
<a name="monitoring-with-eventbridge-events"></a>

當您使用 Amazon Translate 建立或更新平行資料資源時，它會傳送事件以指出操作是否成功。

您可以使用 Amazon Translate 主控台或 [CreateParallelData](https://docs.aws.amazon.com/translate/latest/APIReference/API_CreateParallelData.html) 操作來建立平行資料資源。當您執行此操作時，Amazon Translate 會傳送如下所示的事件。

```
{
 "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}}"
 } 
}
```

`status` 屬性的值為：
+ `ACTIVE` – `CreateParallelData `操作成功，且資源已準備好供您使用。
+ `FAILED` – `CreateParallelData`操作失敗。

您可以使用 Amazon Translate 主控台或 [UpdateParallelData](https://docs.aws.amazon.com/translate/latest/APIReference/API_UpdateParallelData.html) 操作來更新平行資料資源。當您執行此操作時，Amazon Translate 會傳送如下所示的事件。

```
{
 "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"
 } 
}
```

`status` 屬性提供先前版本的平行資料資源狀態，該資源正由更新取代。數值為：
+ `ACTIVE` – 先前版本已成功建立或更新。
+ `FAILED` – 無法建立或更新先前的版本。

`latestUpdateAttemptStatus` 屬性會提供由更新所建立之平行資料資源新版本的狀態。數值為：
+ `ACTIVE` – `UpdateParallelData`操作成功，且已更新的資源已準備好供您使用。
+ `FAILED` – `UpdateParallelData`操作失敗。