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

# Amazon Textract 結果通知
<a name="async-notification-payload"></a>

Amazon Textract 會將分析請求的狀態傳送至 Amazon Simple Notification Service (Amazon SNS) 主題。若要從 Amazon SNS 主題取得通知，請使用 Amazon SQS 佇列或 AWS Lambda 函數。如需詳細資訊，請參閱[呼叫 Amazon Textract 非同步操作](api-async.md)。如需範例，請參閱 [偵測或分析多頁文件中的文字](async-analyzing-with-sqs.md)。

Amazon Simple Notification Service 傳送至 Amazon SQS 的狀態訊息具有下列 JSON 格式：

```
{
  "JobId": "String",
  "Status": "String",
  "API": "String",
  "JobTag": "String",
  "Timestamp": Number,
  "DocumentLocation": {
    "S3ObjectName": "String",
    "S3Bucket": "String"
  }
}
```

此資料表說明 Amazon SNS 狀態中的不同參數。


| 參數 | 說明 | 
| --- | --- | 
| JobId | Amazon Textract 指派給任務的唯一識別符。它符合從 `Start`操作傳回的任務識別符，例如 [StartDocumentTextDetection](https://docs.aws.amazon.com/textract/latest/APIReference/API_StartDocumentTextDetection.html)。 | 
| 狀態 | 任務的狀態。有效值為「SUCCEEDED」(成功)、「FAILED」(失敗) 或「ERROR」(錯誤)。 | 
| API | 用於分析輸入文件的 Amazon Textract 操作，例如 [StartDocumentTextDetection](https://docs.aws.amazon.com/textract/latest/APIReference/API_StartDocumentTextDetection.html) 或 [StartDocumentAnalysis](https://docs.aws.amazon.com/textract/latest/APIReference/API_StartDocumentAnalysis.html)。 | 
| JobTag | 任務的使用者指定識別符。您可以在呼叫 `Start`操作`JobTag`時指定 ，例如 [StartDocumentTextDetection](https://docs.aws.amazon.com/textract/latest/APIReference/API_StartDocumentTextDetection.html)。 | 
| 時間戳記 | Unix 時間戳記，指出任務完成的時間，以毫秒為單位傳回。 | 
| DocumentLocation | 已處理文件的詳細資訊。包含檔案名稱與檔案所存放的 Amazon S3 儲存貯體。 | 

如果 Amazon SNS 通知中的「狀態」值為「失敗」，這表示分析任務發生錯誤。在此情況下，請檢查 Amazon Textract API 操作傳回的錯誤訊息，並確保您的文件符合 指定的配額[在 Amazon Textract 中設定配額在 Amazon Textract 中修改預設配額](limits-document.md)