本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # StartExpenseAnalysis 開始對聯繫信息、購買物料和供應商名稱等數據的發票或收據進行異步分析。 `StartExpenseAnalysis`可以分析 JPEG、PNG 和 PDF 格式的文檔中的文本。文件必要儲存在 Amazon S3 儲存貯體中。使用[DocumentLocation](API_DocumentLocation.md)參數指定您的 S3 儲存貯體名稱以及該儲存貯體中檔案的名稱。 `StartExpenseAnalysis`返回一個作業標識符 (`JobId`），您將提供給`GetExpenseAnalysis`檢索操作的結果。完成對輸入發票/收據的分析後，Amazon Textract 會向您提供的亞馬遜 Simple Notification Service (Amazon SNS) 主題發佈完成狀態。`NotificationChannel`。要獲得發票和收據分析操作的結果，請確保發佈到 Amazon SNS 主題的狀態值為`SUCCEEDED`。如果是這樣，請調用[GetExpenseAnalysis](API_GetExpenseAnalysis.md)，並傳遞作業標識符（`JobId`），您通過調用`StartExpenseAnalysis`。 如需詳細資訊，請參閱「」[分析發票和收款](https://docs.aws.amazon.com/textract/latest/dg/invoice-receipts.html)。 ## 請求語法 ``` { "ClientRequestToken": "string", "DocumentLocation": { "S3Object": { "Bucket": "string", "Name": "string", "Version": "string" } }, "JobTag": "string", "KMSKeyId": "string", "NotificationChannel": { "RoleArn": "string", "SNSTopicArn": "string" }, "OutputConfig": { "S3Bucket": "string", "S3Prefix": "string" } } ``` ## 請求參數 請求接受採用 JSON 格式的下列資料。 ** [ClientRequestToken](#API_StartExpenseAnalysis_RequestSyntax) ** 用於標識啟動請求的冪等令牌。如果您將相同的令牌與多個`StartDocumentTextDetection`請求，相同`JobId`傳回。使用`ClientRequestToken`以防止同一作業意外多次啟動。如需詳細資訊，請參閱「」[調用 Amazon Textract 異步操作](https://docs.aws.amazon.com/textract/latest/dg/api-async.html) 類型：字串 長度限制：長度下限為 1。長度上限為 64。 模式：`^[a-zA-Z0-9-_]+$` ：必要 否 ** [DocumentLocation](#API_StartExpenseAnalysis_RequestSyntax) ** 要處理的文檔的位置。 類型：[DocumentLocation](API_DocumentLocation.md) 物件 ：必要 是 ** [JobTag](#API_StartExpenseAnalysis_RequestSyntax) ** 您指定的標識符，該編碼包含在發佈到 Amazon SNS 主題的完成通知中。例如，您可以使用`JobTag`標識完成通知對應的單據類型（例如納税表或收據）。 類型：字串 長度限制：長度下限為 1。長度上限為 64。 模式：`[a-zA-Z0-9_.\-:]+` ：必要 否 ** [KMSKeyId](#API_StartExpenseAnalysis_RequestSyntax) ** 用來加密推理結果的 KMS 金鑰。此格式可以是密鑰 ID 或密鑰別名格式。提供 KMS 密鑰後，KMS 密鑰將用於客户存儲桶中的對象的服務器端加密。如果未啟用此參數，則結果將使用 SSE-S3 加密服務器端。 類型：字串 長度限制：長度下限為 1。長度上限為 2048。 模式：`^[A-Za-z0-9][A-Za-z0-9:_/+=,@.-]{0,2048}$` ：必要 否 ** [NotificationChannel](#API_StartExpenseAnalysis_RequestSyntax) ** 您希望亞馬 Amazon Textract 將操作的完成狀態發佈到的 Amazon SNS 主題 ARN。 類型：[NotificationChannel](API_NotificationChannel.md) 物件 ：必要 否 ** [OutputConfig](#API_StartExpenseAnalysis_RequestSyntax) ** 設置輸出是否轉到客户定義的存儲段。默認情況下，Amazon Textract 會在內部保存結果，以便`GetExpenseAnalysis`operation. 類型：[OutputConfig](API_OutputConfig.md) 物件 ：必要 否 ## 回應語法 ``` { "JobId": "string" } ``` ## 回應元素 如果動作成功，則服務傳回 HTTP 200 回應。 服務會傳回下列 JSON 格式的資料。 ** [JobId](#API_StartExpenseAnalysis_ResponseSyntax) ** 文本檢測任務的唯一識別符。所以此`JobId`從傳回`StartExpenseAnalysis`。一個`JobId`值僅在 7 天內有效。 類型：字串 長度限制：長度下限為 1。長度上限為 64。 模式：`^[a-zA-Z0-9-_]+$` ## 錯誤 ** AccessDeniedException ** 您未獲授權執行動作。使用已獲授權之使用者或 IAM 角色的 Amazon Resource Name (ARN) 來執行操作。 HTTP 狀態碼：400 ** BadDocumentException ** Amazon Textract 無法閲讀該文檔。有關 Amazon Textract 中文檔限制的更多信息，請參閲[亞馬遜文字中的硬性限制](limits.md)。 HTTP 狀態碼：400 ** DocumentTooLargeException ** 無法處理該文檔，因為它太大。同步操作的最大檔案大小為 10 MB。對於 PDF 文件，異步操作的最大文檔大小為 500 MB。 HTTP 狀態碼：400 ** IdempotentParameterMismatchException ** 一個`ClientRequestToken`輸入參數重複用於一個操作，但至少有一個其他輸入參數不同於先前對操作的呼叫。 HTTP 狀態碼：400 ** InternalServerError ** Amazon Textract 發生服務問題。請再次嘗試呼叫。 HTTP 狀態碼：500 ** InvalidKMSKeyException ** 表示您沒有使用輸入的 KMS 密鑰進行解密權限，或者 KMS 密鑰輸入錯誤。 HTTP 狀態碼：400 ** InvalidParameterException ** 輸入參數違反限制。例如，在同步操作中，`InvalidParameterException`異常發生時，`S3Object`或者`Bytes`值提供在`Document`請求參數。請驗證您的參數，然後再次呼叫 API 操作。 HTTP 狀態碼：400 ** InvalidS3ObjectException ** Amazon Textract 無法存取請求中指定的 S3 物件。有關詳細信息，請[設定對 Amazon S3 的存取](https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html)如需故障診斷資訊，請參閱 。[故障診斷 Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/dev/troubleshooting.html) HTTP 狀態碼：400 ** LimitExceededException ** 超出 Amazon Textract 服務限制。例如，如果您同時啟動太多的異步作業，則調用以啟動操作 (`StartDocumentTextDetection`）引發限制拒絕例外狀況 (HTTP 狀態碼：400)，直到數量同時執行任務的數量低於 Amazon Textract 服務限制。 HTTP 狀態碼：400 ** ProvisionedThroughputExceededException ** 請求數超過您的傳輸量限制。如果您希望提高此限制，請聯絡 Amazon Textract。 HTTP 狀態碼：400 ** ThrottlingException ** Amazon Textract 暫時無法處理請求。請再次嘗試呼叫。 HTTP 狀態碼：500 ** UnsupportedDocumentException ** 輸入檔案的格式不受支持。操作文檔可以採用 PNG、JPEG、PDF 或 TIFF 格式。 HTTP 狀態碼：400 ## 另請參閱 如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明： + [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/textract-2018-06-27/StartExpenseAnalysis) + [適用於 .NET 的 AWS 開發套件](https://docs.aws.amazon.com/goto/DotNetSDKV3/textract-2018-06-27/StartExpenseAnalysis) + [適用於 C\$1\$1 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/StartExpenseAnalysis) + [適用於 Go 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/StartExpenseAnalysis) + [AWS適用於 Java 的開發套件第 2 版](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/StartExpenseAnalysis) + [適用於 JavaScript 的 AWS 開發套件](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/textract-2018-06-27/StartExpenseAnalysis) + [適用於 PHP V3 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForPHPV3/textract-2018-06-27/StartExpenseAnalysis) + [適用於 Python 的 AWS 開發套件](https://docs.aws.amazon.com/goto/boto3/textract-2018-06-27/StartExpenseAnalysis) + [適用於 Ruby V3 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/StartExpenseAnalysis)