本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。 # 操作 支持以下操作： + [AnalyzeDocument](API_AnalyzeDocument.md) + [AnalyzeExpense](API_AnalyzeExpense.md) + [AnalyzeID](API_AnalyzeID.md) + [DetectDocumentText](API_DetectDocumentText.md) + [GetDocumentAnalysis](API_GetDocumentAnalysis.md) + [GetDocumentTextDetection](API_GetDocumentTextDetection.md) + [GetExpenseAnalysis](API_GetExpenseAnalysis.md) + [StartDocumentAnalysis](API_StartDocumentAnalysis.md) + [StartDocumentTextDetection](API_StartDocumentTextDetection.md) + [StartExpenseAnalysis](API_StartExpenseAnalysis.md) # AnalyzeDocument 分析输入文档以了解检测到的项目间的关系。 返回的信息类型如下： + 表单数据（键值对）。两个相关信息会分两个返回[Block](API_Block.md)对象，每种类型`KEY_VALUE_SET`键：Key`Block`对象和一个 VALUE`Block`对象。例如，*名称：安娜·席尔瓦*包含密钥和值。*名称：*是关键。*安娜·席尔瓦*是值。 + 表格和表格单元格数据。一张桌子`Block`对象包含有关检测到的表的信息。一个单元格`Block`对象将为表中的每个单元格返回。 + 文本的行和单词。一行`Block`对象包含一个或多个 WORD`Block`对象。返回文档中检测到的所有行和单词（包括与`FeatureTypes`)。 可以在表单数据和表格中检测到选择元素，例如复选框和选项按钮（单选按钮）。一个选择 \$1 元素`Block`对象包含有关选择元素的信息，包括选择状态。 您可以通过指定`FeatureTypes`列表。 输出将在列表中返回`Block`对象。 `AnalyzeDocument`是一个同步操作。要异步分析文档，请使用[StartDocumentAnalysis](API_StartDocumentAnalysis.md). 有关更多信息，请参阅 。[文档文本分析](https://docs.aws.amazon.com/textract/latest/dg/how-it-works-analyzing.html). ## 请求语法 ``` { "Document": { "Bytes": blob, "S3Object": { "Bucket": "string", "Name": "string", "Version": "string" } }, "FeatureTypes": [ "string" ], "HumanLoopConfig": { "DataAttributes": { "ContentClassifiers": [ "string" ] }, "FlowDefinitionArn": "string", "HumanLoopName": "string" } } ``` ## 请求参数 请求接受采用 JSON 格式的以下数据。 ** [Document](#API_AnalyzeDocument_RequestSyntax) ** 作为 base64 编码的字节或 Amazon S3 对象的输入文档。如果您使用 AWS CLI 调用 Amazon Textract 操作，则无法传递图像字节。文档必须是 JPEG、PNG、PDF 或 TIFF 格式的图像。 如果您使用 AWS 开发工具包调用 Amazon Textract，则可能不需要对使用`Bytes`字段中返回的子位置类型。 类型：[Document](API_Document.md) 对象 必填项：是 ** [FeatureTypes](#API_AnalyzeDocument_RequestSyntax) ** 要执行的分析类型的列表。将 TABLES 添加到列表以返回有关在输入文档中检测到的表的信息。添加 FORMS 以返回检测到的表单数据。要执行这两种类型的分析，请将 TABLES 和 FORMS 添加到`FeatureTypes`. 在文档中检测到的所有行和单词都包含在响应中（包括与值无关的文本`FeatureTypes`)。 类型: 字符串数组 有效值:` TABLES | FORMS` 必填项：是 ** [HumanLoopConfig](#API_AnalyzeDocument_RequestSyntax) ** 设置用于分析文档的循环中人员工作流程的配置。 类型：[HumanLoopConfig](API_HumanLoopConfig.md) 对象 必填项：否 ## 响应语法 ``` { "AnalyzeDocumentModelVersion": "string", "Blocks": [ { "BlockType": "string", "ColumnIndex": number, "ColumnSpan": number, "Confidence": number, "EntityTypes": [ "string" ], "Geometry": { "BoundingBox": { "Height": number, "Left": number, "Top": number, "Width": number }, "Polygon": [ { "X": number, "Y": number } ] }, "Id": "string", "Page": number, "Relationships": [ { "Ids": [ "string" ], "Type": "string" } ], "RowIndex": number, "RowSpan": number, "SelectionStatus": "string", "Text": "string", "TextType": "string" } ], "DocumentMetadata": { "Pages": number }, "HumanLoopActivationOutput": { "HumanLoopActivationConditionsEvaluationResults": "string", "HumanLoopActivationReasons": [ "string" ], "HumanLoopArn": "string" } } ``` ## 响应元素 如果此操作成功，则该服务将会发送回 HTTP 200 响应。 服务以 JSON 格式返回的以下数据。 ** [AnalyzeDocumentModelVersion](#API_AnalyzeDocument_ResponseSyntax) ** 用于分析文档的模型的版本。 类型: 字符串 ** [Blocks](#API_AnalyzeDocument_ResponseSyntax) ** 检测到和分析的物品`AnalyzeDocument`. 类型: 的数组数组[Block](API_Block.md)对象 ** [DocumentMetadata](#API_AnalyzeDocument_ResponseSyntax) ** 有关分析文档的元数据。一个例子是页数。 类型：[DocumentMetadata](API_DocumentMetadata.md) 对象 ** [HumanLoopActivationOutput](#API_AnalyzeDocument_ResponseSyntax) ** 显示循环中的人类评估结果。 类型：[HumanLoopActivationOutput](API_HumanLoopActivationOutput.md) 对象 ## 错误 ** AccessDeniedException ** 您无权执行该操作。使用授权用户或 IAM 角色的 Amazon 资源名称 (ARN) 来执行操作。 HTTP 状态代码：400 ** BadDocumentException ** Amazon Textract 无法阅读文档。有关 Amazon Textract 中文档限制的更多信息，请参阅[Amazon Textract 中的硬性限制](limits.md). HTTP 状态代码：400 ** DocumentTooLargeException ** 无法处理该文档，因为它太大。同步操作的最大文档大小为 10 MB。对于 PDF 文件，异步操作的最大文档大小为 500 MB。 HTTP 状态代码：400 ** HumanLoopQuotaExceededException ** 表示您已超出可用循环工作流程中的最大活跃人员数量。 HTTP 状态代码：400 ** InternalServerError ** Amazon Textract 遇到了一个服务问题。重新尝试您的调用。 HTTP 状态代码：500 ** 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 ** 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/AnalyzeDocument) + [适用于 .NET 的AWS开发工具包](https://docs.aws.amazon.com/goto/DotNetSDKV3/textract-2018-06-27/AnalyzeDocument) + [适用于 C\$1\$1 的AWS开发工具包](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/AnalyzeDocument) + [适用于 Go 的AWS开发工具包](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/AnalyzeDocument) + [AWS适用于 Java V2 的开发工具包](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/AnalyzeDocument) + [适用于 JavaScript 的AWS开发工具包](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/textract-2018-06-27/AnalyzeDocument) + [适用于 PHP V3 的 AWS 开发工具包](https://docs.aws.amazon.com/goto/SdkForPHPV3/textract-2018-06-27/AnalyzeDocument) + [适用于 Python 的 AWS 开发工具包](https://docs.aws.amazon.com/goto/boto3/textract-2018-06-27/AnalyzeDocument) + [适用于 Ruby V3 的 AWS 开发工具包](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/AnalyzeDocument) # AnalyzeExpense `AnalyzeExpense`同步分析输入文档以了解文本之间的财务相关关系。 信息将返回为`ExpenseDocuments`并分开如下。 + `LineItemGroups`-包含的数据集`LineItems`它们存储有关文本行的信息，例如购买的物品及收据上的价格。 + `SummaryFields`-收据包含所有其他信息，例如标题信息或供应商名称。 ## 请求语法 ``` { "Document": { "Bytes": blob, "S3Object": { "Bucket": "string", "Name": "string", "Version": "string" } } } ``` ## 请求参数 请求接受采用 JSON 格式的以下数据。 ** [Document](#API_AnalyzeExpense_RequestSyntax) ** 输入文档，可以是字节或作为 S3 对象。 您可以使用`Bytes`财产。例如，您应使用`Bytes`属性来传递从本地文件系统加载的文档。使用`Bytes`属性必须采用 base64 编码。如果您使用 AWS 开发工具包调用 Amazon Textract API 操作，则代码可能不需要对文档文件字节进行编码。 您可以使用存储在 S3 存储桶中的图像传递给 Amazon Textract API 操作。`S3Object`财产。存储在 S3 存储桶中的文档不需要 base64 编码。 包含 S3 对象的 S3 存储桶的 AWS 区域必须与您用于 Amazon Textract 操作的 AWS 区域匹配。 如果您使用 AWS CLI 调用 Amazon Textract 操作，则不支持使用字节属性传递图像字节。您必须先将文档上传到 Amazon S3 存储桶，然后使用 S3Oject 属性调用操作。 要使 Amazon Textract 处理 S3 对象，用户必须具有访问 S3 对象的权限。 类型：[Document](API_Document.md) 对象 必填项：是 ## 响应语法 ``` { "DocumentMetadata": { "Pages": number }, "ExpenseDocuments": [ { "ExpenseIndex": number, "LineItemGroups": [ { "LineItemGroupIndex": number, "LineItems": [ { "LineItemExpenseFields": [ { "LabelDetection": { "Confidence": number, "Geometry": { "BoundingBox": { "Height": number, "Left": number, "Top": number, "Width": number }, "Polygon": [ { "X": number, "Y": number } ] }, "Text": "string" }, "PageNumber": number, "Type": { "Confidence": number, "Text": "string" }, "ValueDetection": { "Confidence": number, "Geometry": { "BoundingBox": { "Height": number, "Left": number, "Top": number, "Width": number }, "Polygon": [ { "X": number, "Y": number } ] }, "Text": "string" } } ] } ] } ], "SummaryFields": [ { "LabelDetection": { "Confidence": number, "Geometry": { "BoundingBox": { "Height": number, "Left": number, "Top": number, "Width": number }, "Polygon": [ { "X": number, "Y": number } ] }, "Text": "string" }, "PageNumber": number, "Type": { "Confidence": number, "Text": "string" }, "ValueDetection": { "Confidence": number, "Geometry": { "BoundingBox": { "Height": number, "Left": number, "Top": number, "Width": number }, "Polygon": [ { "X": number, "Y": number } ] }, "Text": "string" } } ] } ] } ``` ## 响应元素 如果此操作成功，则该服务将会发送回 HTTP 200 响应。 服务以 JSON 格式返回的以下数据。 ** [DocumentMetadata](#API_AnalyzeExpense_ResponseSyntax) ** 有关输入文档的信息。 类型：[DocumentMetadata](API_DocumentMetadata.md) 对象 ** [ExpenseDocuments](#API_AnalyzeExpense_ResponseSyntax) ** Amazon Textract 检测到的费用。 类型: 数组的[ExpenseDocument](API_ExpenseDocument.md)对象 ## 错误 ** AccessDeniedException ** 您无权执行该操作。使用授权用户或 IAM 角色的 Amazon 资源名称 (ARN) 来执行操作。 HTTP 状态代码：400 ** BadDocumentException ** Amazon Textract 无法阅读文档。有关 Amazon Textract 中文档限制的更多信息，请参阅[Amazon Textract 中的硬性限制](limits.md). HTTP 状态代码：400 ** DocumentTooLargeException ** 无法处理该文档，因为它太大。同步操作的最大文档大小为 10 MB。对于 PDF 文件，异步操作的最大文档大小为 500 MB。 HTTP 状态代码：400 ** InternalServerError ** Amazon Textract 遇到了一个服务问题。重新尝试您的调用。 HTTP 状态代码：500 ** 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 ** 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/AnalyzeExpense) + [适用于 .NET 的AWS开发工具包](https://docs.aws.amazon.com/goto/DotNetSDKV3/textract-2018-06-27/AnalyzeExpense) + [适用于 C\$1\$1 的AWS开发工具包](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/AnalyzeExpense) + [适用于 Go 的AWS开发工具包](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/AnalyzeExpense) + [AWS适用于 Java V2 的开发工具包](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/AnalyzeExpense) + [适用于 JavaScript 的AWS开发工具包](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/textract-2018-06-27/AnalyzeExpense) + [适用于 PHP V3 的 AWS 开发工具包](https://docs.aws.amazon.com/goto/SdkForPHPV3/textract-2018-06-27/AnalyzeExpense) + [适用于 Python 的 AWS 开发工具包](https://docs.aws.amazon.com/goto/boto3/textract-2018-06-27/AnalyzeExpense) + [适用于 Ruby V3 的 AWS 开发工具包](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/AnalyzeExpense) # AnalyzeID 分析身份证件以获取相关信息。此信息被提取并返回为`IdentityDocumentFields`，它记录了提取的文本的标准化字段和值。与其他 Amazon Textract 操作不同，`AnalyzeID`不返回任何几何数据。 ## 请求语法 ``` { "DocumentPages": [ { "Bytes": blob, "S3Object": { "Bucket": "string", "Name": "string", "Version": "string" } } ] } ``` ## 请求参数 请求接受采用 JSON 格式的以下数据。 ** [DocumentPages](#API_AnalyzeID_RequestSyntax) ** 文档正在传递给 AnalyZeID。 类型: 数组数组[Document](API_Document.md)对象 数组成员：最少 1 项。最多 2 项。 必填项：是 ## 响应语法 ``` { "AnalyzeIDModelVersion": "string", "DocumentMetadata": { "Pages": number }, "IdentityDocuments": [ { "DocumentIndex": number, "IdentityDocumentFields": [ { "Type": { "Confidence": number, "NormalizedValue": { "Value": "string", "ValueType": "string" }, "Text": "string" }, "ValueDetection": { "Confidence": number, "NormalizedValue": { "Value": "string", "ValueType": "string" }, "Text": "string" } } ] } ] } ``` ## 响应元素 如果此操作成功，则该服务将会发送回 HTTP 200 响应。 服务以 JSON 格式返回的以下数据。 ** [AnalyzeIDModelVersion](#API_AnalyzeID_ResponseSyntax) ** 用于处理文档的 AnalyzeIdentity API 的版本。 类型: 字符串 ** [DocumentMetadata](#API_AnalyzeID_ResponseSyntax) ** 有关输入文档的信息。 类型：[DocumentMetadata](API_DocumentMetadata.md) 对象 ** [IdentityDocuments](#API_AnalyzeID_ResponseSyntax) ** AnalyzeID 处理的文档清单。包括一个数字，表示它们在列表中的位置以及文档的响应结构。 类型: 数组数组[IdentityDocument](API_IdentityDocument.md)对象 ## 错误 ** AccessDeniedException ** 您无权执行该操作。使用授权用户或 IAM 角色的 Amazon 资源名称 (ARN) 来执行操作。 HTTP 状态代码：400 ** BadDocumentException ** Amazon Textract 无法阅读文档。有关 Amazon Textract 中文档限制的更多信息，请参阅[Amazon Textract 中的硬性限制](limits.md). HTTP 状态代码：400 ** DocumentTooLargeException ** 无法处理该文档，因为它太大。同步操作的最大文档大小为 10 MB。对于 PDF 文件，异步操作的最大文档大小为 500 MB。 HTTP 状态代码：400 ** InternalServerError ** Amazon Textract 遇到了一个服务问题。重新尝试您的调用。 HTTP 状态代码：500 ** 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 ** 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/AnalyzeID) + [适用于 .NET 的AWS开发工具包](https://docs.aws.amazon.com/goto/DotNetSDKV3/textract-2018-06-27/AnalyzeID) + [适用于 C\$1\$1 的AWS开发工具包](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/AnalyzeID) + [适用于 Go 的AWS开发工具包](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/AnalyzeID) + [AWS适用于 Java V2 的开发工具包](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/AnalyzeID) + [适用于 JavaScript 的AWS开发工具包](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/textract-2018-06-27/AnalyzeID) + [适用于 PHP V3 的 AWS 开发工具包](https://docs.aws.amazon.com/goto/SdkForPHPV3/textract-2018-06-27/AnalyzeID) + [适用于 Python 的 AWS 开发工具包](https://docs.aws.amazon.com/goto/boto3/textract-2018-06-27/AnalyzeID) + [适用于 Ruby V3 的 AWS 开发工具包](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/AnalyzeID) # DetectDocumentText 检测输入文档中的文本。Amazon Textract 可以检测文本行和构成一行文本的单词。输入文档必须是 JPEG、PNG、PDF 或 TIFF 格式的图像。`DetectDocumentText`在数组中返回检测到的文本[Block](API_Block.md)对象。 每个文档页面都有关联`Block`的类型 PAGE。每页`Block`对象是 LINE 的父`Block`表示页面上检测到的文本行的对象。一行`Block`对象是构成该行的每个单词的父项。单词的表示为`Block`WORD 类型的对象。 `DetectDocumentText`是一个同步操作。要异步分析文档，请使用[StartDocumentTextDetection](API_StartDocumentTextDetection.md). 有关更多信息，请参阅 。[文本检测](https://docs.aws.amazon.com/textract/latest/dg/how-it-works-detecting.html). ## 请求语法 ``` { "Document": { "Bytes": blob, "S3Object": { "Bucket": "string", "Name": "string", "Version": "string" } } } ``` ## 请求参数 请求接受采用 JSON 格式的以下数据。 ** [Document](#API_DetectDocumentText_RequestSyntax) ** 作为 base64 编码的字节或 Amazon S3 对象的输入文档。如果您使用 AWS CLI 调用 Amazon Textract 操作，则无法传递图像字节。文档必须为 JPEG 或 PNG 格式的图像。 如果您使用 AWS 开发工具包调用 Amazon Textract，则可能不需要对使用`Bytes`字段中返回的子位置类型。 类型：[Document](API_Document.md) 对象 是必需的：是 ## 响应语法 ``` { "Blocks": [ { "BlockType": "string", "ColumnIndex": number, "ColumnSpan": number, "Confidence": number, "EntityTypes": [ "string" ], "Geometry": { "BoundingBox": { "Height": number, "Left": number, "Top": number, "Width": number }, "Polygon": [ { "X": number, "Y": number } ] }, "Id": "string", "Page": number, "Relationships": [ { "Ids": [ "string" ], "Type": "string" } ], "RowIndex": number, "RowSpan": number, "SelectionStatus": "string", "Text": "string", "TextType": "string" } ], "DetectDocumentTextModelVersion": "string", "DocumentMetadata": { "Pages": number } } ``` ## 响应元素 如果此操作成功，则该服务将会发送回 HTTP 200 响应。 服务以 JSON 格式返回的以下数据。 ** [Blocks](#API_DetectDocumentText_ResponseSyntax) ** 数组`Block`包含文档中检测到的文本的对象。 类型: 数组[Block](API_Block.md)对象 ** [DetectDocumentTextModelVersion](#API_DetectDocumentText_ResponseSyntax) ** 类型: 字符串 ** [DocumentMetadata](#API_DetectDocumentText_ResponseSyntax) ** 关于文档的元数据。它包含文档中检测到的页数。 类型：[DocumentMetadata](API_DocumentMetadata.md) 对象 ## 错误 ** AccessDeniedException ** 您无权执行该操作。使用授权用户或 IAM 角色的 Amazon 资源名称 (ARN) 来执行操作。 HTTP 状态代码：400 ** BadDocumentException ** Amazon Textract 无法阅读文档。有关 Amazon Textract 中文档限制的更多信息，请参阅[Amazon Textract 中的硬性限制](limits.md). HTTP 状态代码：400 ** DocumentTooLargeException ** 无法处理该文档，因为它太大。同步操作的最大文档大小为 10 MB。对于 PDF 文件，异步操作的最大文档大小为 500 MB。 HTTP 状态代码：400 ** InternalServerError ** Amazon Textract 遇到了一个服务问题。重新尝试您的调用。 HTTP 状态代码：500 ** 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 ** 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/DetectDocumentText) + [适用于 .NET 的AWS开发工具包](https://docs.aws.amazon.com/goto/DotNetSDKV3/textract-2018-06-27/DetectDocumentText) + [适用于 C\$1\$1 的AWS开发工具包](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/DetectDocumentText) + [适用于 Go 的AWS开发工具包](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/DetectDocumentText) + [AWS适用于 Java V2 的开发工具包](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/DetectDocumentText) + [适用于 JavaScript 的AWS开发工具包](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/textract-2018-06-27/DetectDocumentText) + [适用于 PHP V3 的 AWS 开发工具包](https://docs.aws.amazon.com/goto/SdkForPHPV3/textract-2018-06-27/DetectDocumentText) + [适用于 Python 的 AWS 开发工具包](https://docs.aws.amazon.com/goto/boto3/textract-2018-06-27/DetectDocumentText) + [适用于 Ruby V3 的 AWS 开发工具包](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/DetectDocumentText) # GetDocumentAnalysis 获取分析文档中文本的 Amazon Textract 异步操作的结果。 通过调用来开始异步文本分析[StartDocumentAnalysis](API_StartDocumentAnalysis.md)，它返回作业标识符 (`JobId`)。文本分析操作完成后，Amazon Textract 将完成状态发布到亚马逊 Simple Notification Service (Amazon SNS) 主题，该主题在首次调用时注册`StartDocumentAnalysis`. 要获得文本检测操作的结果，请首先检查发布到 Amazon SNS 主题的状态值是否为`SUCCEEDED`. 如果是的话，打电话`GetDocumentAnalysis`，然后传递作业标识符（`JobId`) 从最初的电话到`StartDocumentAnalysis`. `GetDocumentAnalysis`返回一个数组[Block](API_Block.md)对象。返回以下类型的信息： + 表单数据（键值对）。两个相关信息返回[Block](API_Block.md)对象，每种类型`KEY_VALUE_SET`: Key`Block`对象和一个 VALUE`Block`对象。例如，*名称：安娜·席尔瓦*包含密钥和值。*名称：*是关键。*安娜·席尔瓦*是值。 + 表格和表格单元格数据。一张桌子`Block`对象包含有关检测到的表的信息。一个单元格`Block`对象将为表中的每个单元格返回。 + 文本的行和单词。一行`Block`对象包含一个或多个 WORD`Block`对象。返回文档中检测到的所有行和单词（包括与`StartDocumentAnalysis` `FeatureTypes`输入参数)。 可以在表单数据和表格中检测到选择元素，例如复选框和选项按钮（单选按钮）。一个选择 \$1 元素`Block`对象包含有关选择元素的信息，包括选择状态。 使用`MaxResults`参数以限制返回的块数。如果结果超过中指定的结果`MaxResults`，的价值`NextToken`在操作响应中包含一个用于获取下一组结果的分页令牌。要获取下一页结果，请致电`GetDocumentAnalysis`，然后填充`NextToken`具有从上一次调用返回的令牌值的请求参数`GetDocumentAnalysis`. 有关更多信息，请参阅 。[文档文本分析](https://docs.aws.amazon.com/textract/latest/dg/how-it-works-analyzing.html). ## 请求语法 ``` { "JobId": "string", "MaxResults": number, "NextToken": "string" } ``` ## 请求参数 请求接受采用 JSON 格式的以下数据。 ** [JobId](#API_GetDocumentAnalysis_RequestSyntax) ** 文本检测任务的唯一标识符。这些区域有：`JobId`从返回`StartDocumentAnalysis`. 一个`JobId`值仅在 7 天内有效。 类型: 字符串 长度约束：最小长度为 1。最大长度为 64。 模式：`^[a-zA-Z0-9-_]+$` ：必需 是 ** [MaxResults](#API_GetDocumentAnalysis_RequestSyntax) ** 每次分页呼叫返回的最大结果数。您可以指定的最大值是 1,000。如果指定的值大于 1,000，则返回最多 1000 个结果。默认值是 1,000。 类型: 整数 有效范围：最小值为 1。 ：必需 否 ** [NextToken](#API_GetDocumentAnalysis_RequestSyntax) ** 如果之前的响应不完整（因为需要检索更多块），Amazon Textract 将在响应中返回分页令牌。您可以使用此分页令牌来检索下一组块块。 类型: 字符串 长度约束：最小长度为 1。长度上限为 255。 模式：`.*\S.*` ：必需 否 ## 响应语法 ``` { "AnalyzeDocumentModelVersion": "string", "Blocks": [ { "BlockType": "string", "ColumnIndex": number, "ColumnSpan": number, "Confidence": number, "EntityTypes": [ "string" ], "Geometry": { "BoundingBox": { "Height": number, "Left": number, "Top": number, "Width": number }, "Polygon": [ { "X": number, "Y": number } ] }, "Id": "string", "Page": number, "Relationships": [ { "Ids": [ "string" ], "Type": "string" } ], "RowIndex": number, "RowSpan": number, "SelectionStatus": "string", "Text": "string", "TextType": "string" } ], "DocumentMetadata": { "Pages": number }, "JobStatus": "string", "NextToken": "string", "StatusMessage": "string", "Warnings": [ { "ErrorCode": "string", "Pages": [ number ] } ] } ``` ## 响应元素 如果此操作成功，则该服务将会发送回 HTTP 200 响应。 服务以 JSON 格式返回的以下数据。 ** [AnalyzeDocumentModelVersion](#API_GetDocumentAnalysis_ResponseSyntax) ** 类型: 字符串 ** [Blocks](#API_GetDocumentAnalysis_ResponseSyntax) ** 文本分析操作的结果。 类型: 的数组[Block](API_Block.md)对象 ** [DocumentMetadata](#API_GetDocumentAnalysis_ResponseSyntax) ** 有关 Amazon Textract 处理的文档的信息。`DocumentMetadata`在 Amazon Textract 视频操作的分页响应的每一页中返回。 类型：[DocumentMetadata](API_DocumentMetadata.md) 对象 ** [JobStatus](#API_GetDocumentAnalysis_ResponseSyntax) ** 文本检测任务的当前状态。 类型: 字符串 有效值:` IN_PROGRESS | SUCCEEDED | FAILED | PARTIAL_SUCCESS` ** [NextToken](#API_GetDocumentAnalysis_ResponseSyntax) ** 如果响应被截断，Amazon Textract 将返回此令牌。您可以在后续请求中使用此令牌来检索下一组文本检测结果。 类型: 字符串 长度约束：最小长度为 1。长度上限为 255。 模式：`.*\S.*` ** [StatusMessage](#API_GetDocumentAnalysis_ResponseSyntax) ** 如果无法完成检测任务，则返回。包含发生什么错误的解释。 类型: 字符串 ** [Warnings](#API_GetDocumentAnalysis_ResponseSyntax) ** 文档分析操作期间发生的警告列表。 类型: 的数组[Warning](API_Warning.md)对象 ## 错误 ** AccessDeniedException ** 您无权执行该操作。使用授权用户或 IAM 角色的 Amazon 资源名称 (ARN) 来执行操作。 HTTP 状态代码：400 ** InternalServerError ** Amazon Textract 遇到了一个服务问题。重新尝试您的调用。 HTTP 状态代码：500 ** InvalidJobIdException ** 向传递了无效的作业标识符[GetDocumentAnalysis](#API_GetDocumentAnalysis)或者去[GetDocumentAnalysis](#API_GetDocumentAnalysis). HTTP 状态代码：400 ** 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 ** ProvisionedThroughputExceededException ** 请求数超出了您的吞吐量限制。如要增加此限制，请联系 Amazon Textract。 HTTP 状态代码：400 ** ThrottlingException ** Amazon Textract 暂时无法处理该请求。重新尝试您的调用。 HTTP 状态代码：500 ## 另请参阅 有关在特定语言的AWS软件开发工具包中使用此 API 的更多信息，请参阅以下内容： + [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/textract-2018-06-27/GetDocumentAnalysis) + [适用于 .NET 的AWS开发工具包](https://docs.aws.amazon.com/goto/DotNetSDKV3/textract-2018-06-27/GetDocumentAnalysis) + [适用于 C\$1\$1 的AWS开发工具包](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/GetDocumentAnalysis) + [适用于 Go 的AWS开发工具包](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/GetDocumentAnalysis) + [AWS适用于 Java V2 的开发工具包](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/GetDocumentAnalysis) + [适用于 JavaScript 的AWS开发工具包](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/textract-2018-06-27/GetDocumentAnalysis) + [适用于 PHP V3 的 AWS 开发工具包](https://docs.aws.amazon.com/goto/SdkForPHPV3/textract-2018-06-27/GetDocumentAnalysis) + [适用于 Python 的 AWS 开发工具包](https://docs.aws.amazon.com/goto/boto3/textract-2018-06-27/GetDocumentAnalysis) + [适用于 Ruby V3 的 AWS 开发工具包](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/GetDocumentAnalysis) # GetDocumentTextDetection 获取用于检测文档中文本的 Amazon Textract 异步操作的结果。Amazon Textract 可以检测文本行和构成一行文本的单词。 通过调用来开始异步文本检测[StartDocumentTextDetection](API_StartDocumentTextDetection.md)，它返回作业标识符 (`JobId`)。当文本检测操作完成后，Amazon Textract 向亚马逊 Simple Notification Service (Amazon SNS) 主题发布完成状态，该主题已在首次调用时注册`StartDocumentTextDetection`. 要获得文本检测操作的结果，请首先检查发布到 Amazon SNS 主题的状态值是否为`SUCCEEDED`. 如果是的话，打电话`GetDocumentTextDetection`，然后传递作业标识符（`JobId`) 从最初的电话到`StartDocumentTextDetection`. `GetDocumentTextDetection`返回一个数组[Block](API_Block.md)对象。 每个文档页面都有关联`Block`的类型 PAGE。每个页面`Block`对象是 LINE 的父`Block`表示页面上检测到的文本行的对象。一行`Block`对象是构成该行的每个单词的父项。单词的表示为`Block`WORD 类型的对象。 使用 MaxResults 参数限制返回的数据块数。如果结果超过中指定的结果`MaxResults`，的价值`NextToken`在操作响应中包含用于获取下一组结果的分页令牌。要获取下一页结果，请致电`GetDocumentTextDetection`，然后填充`NextToken`具有从上一次调用返回的令牌值的请求参数`GetDocumentTextDetection`. 有关更多信息，请参阅 。[文本检测](https://docs.aws.amazon.com/textract/latest/dg/how-it-works-detecting.html). ## 请求语法 ``` { "JobId": "string", "MaxResults": number, "NextToken": "string" } ``` ## 请求参数 请求接受采用 JSON 格式的以下数据。 ** [JobId](#API_GetDocumentTextDetection_RequestSyntax) ** 文本检测作业的唯一标识符。这些区域有：`JobId`从返回的`StartDocumentTextDetection`. 一个`JobId`该值仅在 7 天内有效。 类型: 字符串 长度约束：最小长度为 1。最大长度为 64。 模式：`^[a-zA-Z0-9-_]+$` ：必需 是 ** [MaxResults](#API_GetDocumentTextDetection_RequestSyntax) ** 每个分页呼叫返回的最大结果数。您可以指定的最大值是 1,000。如果指定的值大于 1,000，则返回最多 1000 个结果。默认值是 1,000。 类型: 整数 有效范围：最小值为 1。 ：必需 否 ** [NextToken](#API_GetDocumentTextDetection_RequestSyntax) ** 如果之前的响应不完整（因为需要检索更多块），Amazon Textract 将在响应中返回分页令牌。您可以使用此分页令牌来检索下一组区块。 类型: 字符串 长度约束：最小长度为 1。长度上限为 255。 模式：`.*\S.*` ：必需 否 ## 响应语法 ``` { "Blocks": [ { "BlockType": "string", "ColumnIndex": number, "ColumnSpan": number, "Confidence": number, "EntityTypes": [ "string" ], "Geometry": { "BoundingBox": { "Height": number, "Left": number, "Top": number, "Width": number }, "Polygon": [ { "X": number, "Y": number } ] }, "Id": "string", "Page": number, "Relationships": [ { "Ids": [ "string" ], "Type": "string" } ], "RowIndex": number, "RowSpan": number, "SelectionStatus": "string", "Text": "string", "TextType": "string" } ], "DetectDocumentTextModelVersion": "string", "DocumentMetadata": { "Pages": number }, "JobStatus": "string", "NextToken": "string", "StatusMessage": "string", "Warnings": [ { "ErrorCode": "string", "Pages": [ number ] } ] } ``` ## 响应元素 如果此操作成功，则该服务将会发送回 HTTP 200 响应。 服务以 JSON 格式返回的以下数据。 ** [Blocks](#API_GetDocumentTextDetection_ResponseSyntax) ** 文本检测操作的结果。 类型: 数组的数组[Block](API_Block.md)对象 ** [DetectDocumentTextModelVersion](#API_GetDocumentTextDetection_ResponseSyntax) ** 类型: 字符串 ** [DocumentMetadata](#API_GetDocumentTextDetection_ResponseSyntax) ** 有关 Amazon Textract 处理的文档的信息。`DocumentMetadata`在 Amazon Textract 视频操作的分页响应的每一页中返回。 类型：[DocumentMetadata](API_DocumentMetadata.md) 对象 ** [JobStatus](#API_GetDocumentTextDetection_ResponseSyntax) ** 文本检测作业的当前状态。 类型: 字符串 有效值:` IN_PROGRESS | SUCCEEDED | FAILED | PARTIAL_SUCCESS` ** [NextToken](#API_GetDocumentTextDetection_ResponseSyntax) ** 如果响应被截断，Amazon Textract 将返回此令牌。您可以在后续请求中使用此令牌来检索下一组文本检测结果。 类型: 字符串 长度约束：最小长度为 1。长度上限为 255。 模式：`.*\S.*` ** [StatusMessage](#API_GetDocumentTextDetection_ResponseSyntax) ** 如果无法完成检测作业，则返回该函数。包含发生什么错误的解释。 类型: 字符串 ** [Warnings](#API_GetDocumentTextDetection_ResponseSyntax) ** 文档的文本检测操作期间发生的警告列表。 类型: 数组的数组[Warning](API_Warning.md)对象 ## 错误 ** AccessDeniedException ** 您无权执行该操作。使用授权用户或 IAM 角色的 Amazon 资源名称 (ARN) 来执行操作。 HTTP 状态代码：400 ** InternalServerError ** Amazon Textract 遇到了一个服务问题。重新尝试您的调用。 HTTP 状态代码：500 ** InvalidJobIdException ** 向传递了无效的作业标识符[GetDocumentAnalysis](API_GetDocumentAnalysis.md)或者去[GetDocumentAnalysis](API_GetDocumentAnalysis.md). HTTP 状态代码：400 ** 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 ** ProvisionedThroughputExceededException ** 请求数超出了您的吞吐量限制。如要增加此限制，请联系 Amazon Textract。 HTTP 状态代码：400 ** ThrottlingException ** Amazon Textract 暂时无法处理该请求。重新尝试您的调用。 HTTP 状态代码：500 ## 另请参阅 有关在特定语言的AWS软件开发工具包中使用此 API 的更多信息，请参阅以下内容： + [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/textract-2018-06-27/GetDocumentTextDetection) + [适用于 .NET 的AWS开发工具包](https://docs.aws.amazon.com/goto/DotNetSDKV3/textract-2018-06-27/GetDocumentTextDetection) + [适用于 C\$1\$1 的AWS开发工具包](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/GetDocumentTextDetection) + [适用于 Go 的AWS开发工具包](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/GetDocumentTextDetection) + [AWS适用于 Java V2 的开发工具包](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/GetDocumentTextDetection) + [适用于 JavaScript 的AWS开发工具包](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/textract-2018-06-27/GetDocumentTextDetection) + [适用于 PHP V3 的 AWS 开发工具包](https://docs.aws.amazon.com/goto/SdkForPHPV3/textract-2018-06-27/GetDocumentTextDetection) + [适用于 Python 的 AWS 开发工具包](https://docs.aws.amazon.com/goto/boto3/textract-2018-06-27/GetDocumentTextDetection) + [适用于 Ruby V3 的 AWS 开发工具包](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/GetDocumentTextDetection) # GetExpenseAnalysis 获取分析发票和收据的 Amazon Textract 异步操作的结果。Amazon Textract 从输入的发票和收据中查找联系信息、购买的商品和供应商名称。 通过调用开始异步发票/收据分析[StartExpenseAnalysis](API_StartExpenseAnalysis.md)，它返回一个作业标识符 (`JobId`)。Amazon Textract 在完成发票/收据分析后，将完成状态发布到 Amazon Simple Notification Service (Amazon SNS) 主题。必须在初次调用时注册此主题`StartExpenseAnalysis`. 要获取发票/收据分析操作的结果，请先确保向 Amazon SNS 主题发布的状态值为`SUCCEEDED`. 如果是的话，打电话`GetExpenseAnalysis`，然后传递作业标识符（`JobId`) 从最初的电话到`StartExpenseAnalysis`. 使用 MaxResults 参数限制返回的块数量。如果结果超过中指定的结果`MaxResults`，的价值`NextToken`在操作响应中包含用于获取下一组结果的分页令牌。要获取下一页结果，请致电`GetExpenseAnalysis`，然后填充`NextToken`具有从上一次调用返回的令牌值的请求参数`GetExpenseAnalysis`. 有关更多信息，请参阅 。[分析发票和收据](https://docs.aws.amazon.com/textract/latest/dg/invoices-receipts.html). ## 请求语法 ``` { "JobId": "string", "MaxResults": number, "NextToken": "string" } ``` ## 请求参数 请求接受采用 JSON 格式的以下数据。 ** [JobId](#API_GetExpenseAnalysis_RequestSyntax) ** 文本检测作业的唯一标识符。这些区域有：`JobId`从返回`StartExpenseAnalysis`. 一个`JobId`值仅在 7 天内有效。 类型: 字符串 长度约束：最小长度为 1。最大长度为 64。 模式：`^[a-zA-Z0-9-_]+$` 必填项：是 ** [MaxResults](#API_GetExpenseAnalysis_RequestSyntax) ** 每个分页呼叫返回的最大结果数量。您可以指定的最大值是 20。如果您指定的值大于 20，则最多返回 20 个结果。默认值为 20。 类型: 整数 有效范围：最小值为 1。 必填项：否 ** [NextToken](#API_GetExpenseAnalysis_RequestSyntax) ** 如果之前的响应不完整（因为需要检索更多块），Amazon Textract 将在响应中返回分页令牌。您可以使用此分页令牌检索下一组块块。 类型: 字符串 长度约束：最小长度为 1。长度上限为 255。 模式：`.*\S.*` 必填项：否 ## 响应语法 ``` { "AnalyzeExpenseModelVersion": "string", "DocumentMetadata": { "Pages": number }, "ExpenseDocuments": [ { "ExpenseIndex": number, "LineItemGroups": [ { "LineItemGroupIndex": number, "LineItems": [ { "LineItemExpenseFields": [ { "LabelDetection": { "Confidence": number, "Geometry": { "BoundingBox": { "Height": number, "Left": number, "Top": number, "Width": number }, "Polygon": [ { "X": number, "Y": number } ] }, "Text": "string" }, "PageNumber": number, "Type": { "Confidence": number, "Text": "string" }, "ValueDetection": { "Confidence": number, "Geometry": { "BoundingBox": { "Height": number, "Left": number, "Top": number, "Width": number }, "Polygon": [ { "X": number, "Y": number } ] }, "Text": "string" } } ] } ] } ], "SummaryFields": [ { "LabelDetection": { "Confidence": number, "Geometry": { "BoundingBox": { "Height": number, "Left": number, "Top": number, "Width": number }, "Polygon": [ { "X": number, "Y": number } ] }, "Text": "string" }, "PageNumber": number, "Type": { "Confidence": number, "Text": "string" }, "ValueDetection": { "Confidence": number, "Geometry": { "BoundingBox": { "Height": number, "Left": number, "Top": number, "Width": number }, "Polygon": [ { "X": number, "Y": number } ] }, "Text": "string" } } ] } ], "JobStatus": "string", "NextToken": "string", "StatusMessage": "string", "Warnings": [ { "ErrorCode": "string", "Pages": [ number ] } ] } ``` ## 响应元素 如果此操作成功，则该服务将会发送回 HTTP 200 响应。 服务以 JSON 格式返回的以下数据。 ** [AnalyzeExpenseModelVersion](#API_GetExpenseAnalysis_ResponseSyntax) ** 分析费用的当前模型版本。 类型: 字符串 ** [DocumentMetadata](#API_GetExpenseAnalysis_ResponseSyntax) ** 有关 Amazon Textract 处理的文档的信息。`DocumentMetadata`在 Amazon Textract 操作的分页回复的每一页中返回。 类型：[DocumentMetadata](API_DocumentMetadata.md) 对象 ** [ExpenseDocuments](#API_GetExpenseAnalysis_ResponseSyntax) ** Amazon Textract 检测到的费用。 类型: 数组[ExpenseDocument](API_ExpenseDocument.md)对象 ** [JobStatus](#API_GetExpenseAnalysis_ResponseSyntax) ** 文本检测作业的当前状态。 类型: 字符串 有效值:` IN_PROGRESS | SUCCEEDED | FAILED | PARTIAL_SUCCESS` ** [NextToken](#API_GetExpenseAnalysis_ResponseSyntax) ** 如果响应被截断，Amazon Textract 将返回此令牌。您可以在后续请求中使用此令牌检索下一组文本检测结果。 类型: 字符串 长度约束：最小长度为 1。长度上限为 255。 模式：`.*\S.*` ** [StatusMessage](#API_GetExpenseAnalysis_ResponseSyntax) ** 如无法完成检测作业，则返回该项。包含发生什么错误的解释。 类型: 字符串 ** [Warnings](#API_GetExpenseAnalysis_ResponseSyntax) ** 文档的文本检测操作期间发生的警告列表。 类型: 数组[Warning](API_Warning.md)对象 ## 错误 ** AccessDeniedException ** 您无权执行该操作。使用授权用户或 IAM 角色的 Amazon 资源名称 (ARN) 来执行操作。 HTTP 状态代码：400 ** InternalServerError ** Amazon Textract 遇到了一个服务问题。重新尝试您的调用。 HTTP 状态代码：500 ** InvalidJobIdException ** 向传递了无效的作业标识符[GetDocumentAnalysis](API_GetDocumentAnalysis.md)或者去[GetDocumentAnalysis](API_GetDocumentAnalysis.md). HTTP 状态代码：400 ** 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 ** ProvisionedThroughputExceededException ** 请求数超出了您的吞吐量限制。如要增加此限制，请联系 Amazon Textract。 HTTP 状态代码：400 ** ThrottlingException ** Amazon Textract 暂时无法处理该请求。重新尝试您的调用。 HTTP 状态代码：500 ## 另请参阅 有关在特定语言的AWS软件开发工具包中使用此 API 的更多信息，请参阅以下内容： + [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/textract-2018-06-27/GetExpenseAnalysis) + [适用于 .NET 的AWS开发工具包](https://docs.aws.amazon.com/goto/DotNetSDKV3/textract-2018-06-27/GetExpenseAnalysis) + [适用于 C\$1\$1 的AWS开发工具包](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/GetExpenseAnalysis) + [适用于 Go 的AWS开发工具包](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/GetExpenseAnalysis) + [AWS适用于 Java V2 的开发工具包](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/GetExpenseAnalysis) + [适用于 JavaScript 的AWS开发工具包](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/textract-2018-06-27/GetExpenseAnalysis) + [适用于 PHP V3 的 AWS 开发工具包](https://docs.aws.amazon.com/goto/SdkForPHPV3/textract-2018-06-27/GetExpenseAnalysis) + [适用于 Python 的 AWS 开发工具包](https://docs.aws.amazon.com/goto/boto3/textract-2018-06-27/GetExpenseAnalysis) + [适用于 Ruby V3 的 AWS 开发工具包](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/GetExpenseAnalysis) # StartDocumentAnalysis 启动对输入文档的异步分析，以了解检测到的项目（例如键值对、表和选择元素）之间的关系。 `StartDocumentAnalysis`可以分析 JPEG、PNG、TIFF 和 PDF 格式的文档中的文本。这些文档存储在 Amazon S3 存储桶中。使用[DocumentLocation](API_DocumentLocation.md)指定文档的存储桶名称和文件名。 `StartDocumentAnalysis`返回作业标识符 (`JobId`）您用来获取操作结果。当文本分析完成后，Amazon Textract 将完成状态发布到您在中指定的 Amazon Simple Notification Service (Amazon SNS) 主题。`NotificationChannel`. 要获得文本分析操作的结果，请首先检查发布到 Amazon SNS 主题的状态值是否为`SUCCEEDED`. 如果是的话，打电话[GetDocumentAnalysis](API_GetDocumentAnalysis.md)，然后传递作业标识符（`JobId`) 从最初的电话到`StartDocumentAnalysis`. 有关更多信息，请参阅 。[文档文本分析](https://docs.aws.amazon.com/textract/latest/dg/how-it-works-analyzing.html). ## 请求语法 ``` { "ClientRequestToken": "string", "DocumentLocation": { "S3Object": { "Bucket": "string", "Name": "string", "Version": "string" } }, "FeatureTypes": [ "string" ], "JobTag": "string", "KMSKeyId": "string", "NotificationChannel": { "RoleArn": "string", "SNSTopicArn": "string" }, "OutputConfig": { "S3Bucket": "string", "S3Prefix": "string" } } ``` ## 请求参数 请求接受采用 JSON 格式的以下数据。 ** [ClientRequestToken](#API_StartDocumentAnalysis_RequestSyntax) ** 用于标识启动请求的幂等令牌。如果你对多个使用同一个令牌`StartDocumentAnalysis`请求，同样`JobId`返回。使用`ClientRequestToken`以防止同样的工作不止一次被意外启动。有关更多信息，请参阅 。[调用 Amazon Textract 异步操作](https://docs.aws.amazon.com/textract/latest/dg/api-async.html). 类型: 字符串 长度约束：最小长度为 1。最大长度为 64。 模式：`^[a-zA-Z0-9-_]+$` ：必需 否 ** [DocumentLocation](#API_StartDocumentAnalysis_RequestSyntax) ** 要处理的文档的位置。 类型：[DocumentLocation](API_DocumentLocation.md) 对象 ：必需 是 ** [FeatureTypes](#API_StartDocumentAnalysis_RequestSyntax) ** 要执行的分析类型的列表。将 TABLES 添加到列表以返回有关输入文档中检测到的表的信息。添加 FORMS 以返回检测到的表单数据。要执行这两种类型的分析，请将 TABLES 和 FORMS 添加到`FeatureTypes`. 在文档中检测到的所有行和单词都包含在响应中（包括与值无关的文本）`FeatureTypes`)。 类型: 字符串数组 有效值:` TABLES | FORMS` ：必需 是 ** [JobTag](#API_StartDocumentAnalysis_RequestSyntax) ** 您指定的标识符包含在发布到 Amazon SNS 主题的完成通知中。例如，您可以使用`JobTag`以确定完成通知对应的文件类型（例如纳税表或收据）。 类型: 字符串 长度约束：最小长度为 1。最大长度为 64。 模式：`[a-zA-Z0-9_.\-:]+` ：必需 否 ** [KMSKeyId](#API_StartDocumentAnalysis_RequestSyntax) ** 用于加密推理结果的 KMS 密钥。这可以是密钥 ID 或密钥别名格式。提供 KMS 密钥后，KMS 密钥将用于对客户存储桶中的对象进行服务器端加密。如果未启用此参数，结果将使用 SSE-S3 加密服务器端。 类型: 字符串 长度约束：最小长度为 1。长度上限为 2048。 模式：`^[A-Za-z0-9][A-Za-z0-9:_/+=,@.-]{0,2048}$` ：必需 否 ** [NotificationChannel](#API_StartDocumentAnalysis_RequestSyntax) ** 您希望 Amazon Textract 将操作的完成状态发布到的 Amazon SNS 主题 ARN。 类型：[NotificationChannel](API_NotificationChannel.md) 对象 ：必需 否 ** [OutputConfig](#API_StartDocumentAnalysis_RequestSyntax) ** 设置输出是否转到客户定义的存储桶。默认情况下，Amazon Textract 将在内部保存结果以供 getDocumentAnalysis 操作访问。 类型：[OutputConfig](API_OutputConfig.md) 对象 ：必需 否 ## 响应语法 ``` { "JobId": "string" } ``` ## 响应元素 如果此操作成功，则该服务将会发送回 HTTP 200 响应。 服务以 JSON 格式返回的以下数据。 ** [JobId](#API_StartDocumentAnalysis_ResponseSyntax) ** 文档文本检测作业的标识符。使用`JobId`在接下来的电话中确定任务`GetDocumentAnalysis`. 一个`JobId`值仅在 7 天内有效。 类型: 字符串 长度约束：最小长度为 1。最大长度为 64。 模式：`^[a-zA-Z0-9-_]+$` ## 错误 ** AccessDeniedException ** 您无权执行该操作。使用授权用户或 IAM 角色的 Amazon 资源名称 (ARN) 来执行操作。 HTTP 状态代码：400 ** BadDocumentException ** Amazon Textract 无法阅读文档。有关 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`例如）引发 LimitExceededException 异常 (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/StartDocumentAnalysis) + [适用于 .NET 的AWS开发工具包](https://docs.aws.amazon.com/goto/DotNetSDKV3/textract-2018-06-27/StartDocumentAnalysis) + [适用于 C\$1\$1 的AWS开发工具包](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/StartDocumentAnalysis) + [适用于 Go 的AWS开发工具包](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/StartDocumentAnalysis) + [AWS适用于 Java V2 的开发工具包](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/StartDocumentAnalysis) + [适用于 JavaScript 的AWS开发工具包](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/textract-2018-06-27/StartDocumentAnalysis) + [适用于 PHP V3 的 AWS 开发工具包](https://docs.aws.amazon.com/goto/SdkForPHPV3/textract-2018-06-27/StartDocumentAnalysis) + [适用于 Python 的 AWS 开发工具包](https://docs.aws.amazon.com/goto/boto3/textract-2018-06-27/StartDocumentAnalysis) + [适用于 Ruby V3 的 AWS 开发工具包](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/StartDocumentAnalysis) # StartDocumentTextDetection 启动对文档中的文本开始异步检测。Amazon Textract 可以检测文本行和构成一行文本的单词。 `StartDocumentTextDetection`可以分析 JPEG、PNG、TIFF 和 PDF 格式的文档中的文本。这些文档存储在 Amazon S3 存储桶中。使用[DocumentLocation](API_DocumentLocation.md)以指定文档的存储桶名称和文件名。 `StartTextDetection`返回作业标识符 (`JobId`）您用来获取操作结果。当文本检测完成后，Amazon Textract 将完成状态发布到您在中指定的 Amazon Simple Notification Service (Amazon SNS) 主题。`NotificationChannel`. 要获得文本检测操作的结果，请首先检查发布到 Amazon SNS 主题的状态值是否为`SUCCEEDED`. 如果是的话，打电话[GetDocumentTextDetection](API_GetDocumentTextDetection.md)，然后传递作业标识符（`JobId`) 从最初的电话到`StartDocumentTextDetection`. 有关更多信息，请参阅 。[文档文本检测](https://docs.aws.amazon.com/textract/latest/dg/how-it-works-detecting.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_StartDocumentTextDetection_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_StartDocumentTextDetection_RequestSyntax) ** 要处理的文档的位置。 类型：[DocumentLocation](API_DocumentLocation.md) 对象 ：必需 是 ** [JobTag](#API_StartDocumentTextDetection_RequestSyntax) ** 您指定的标识符包含在发布到 Amazon SNS 主题的完成通知中。例如，您可以使用`JobTag`以确定完成通知对应的文件类型（例如纳税表或收据）。 类型: 字符串 长度约束：最小长度为 1。最大长度为 64。 模式：`[a-zA-Z0-9_.\-:]+` ：必需 否 ** [KMSKeyId](#API_StartDocumentTextDetection_RequestSyntax) ** 用于加密推断结果的 KMS 密钥。这可以是密钥 ID 或密钥别名格式。提供 KMS 密钥后，KMS 密钥将用于对客户存储桶中的对象进行服务器端加密。如果未启用此参数，结果将使用 SSE-S3 加密服务器端。 类型: 字符串 长度约束：最小长度为 1。长度上限为 2048。 模式：`^[A-Za-z0-9][A-Za-z0-9:_/+=,@.-]{0,2048}$` ：必需 否 ** [NotificationChannel](#API_StartDocumentTextDetection_RequestSyntax) ** 您希望 Amazon Textract 将操作的完成状态发布到的 Amazon SNS 主题 ARN。 类型：[NotificationChannel](API_NotificationChannel.md) 对象 ：必需 否 ** [OutputConfig](#API_StartDocumentTextDetection_RequestSyntax) ** 设置输出是否转到客户定义的存储桶。默认情况下，Amazon Textract 将在内部保存结果，以便通过 getDocumentTextTectIncect 操作访问。 类型：[OutputConfig](API_OutputConfig.md) 对象 ：必需 否 ## 响应语法 ``` { "JobId": "string" } ``` ## 响应元素 如果此操作成功，则该服务将会发送回 HTTP 200 响应。 服务以 JSON 格式返回的以下数据。 ** [JobId](#API_StartDocumentTextDetection_ResponseSyntax) ** 文档的文本检测作业的标识符。使用`JobId`在接下来的电话中确定任务`GetDocumentTextDetection`. 一个`JobId`值仅在 7 天内有效。 类型: 字符串 长度约束：最小长度为 1。最大长度为 64。 模式：`^[a-zA-Z0-9-_]+$` ## 错误 ** AccessDeniedException ** 您无权执行该操作。使用授权用户或 IAM 角色的 Amazon 资源名称 (ARN) 来执行操作。 HTTP 状态代码：400 ** BadDocumentException ** Amazon Textract 无法阅读文档。有关 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`例如）引发 LimitExceededException 异常 (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/StartDocumentTextDetection) + [适用于 .NET 的AWS开发工具包](https://docs.aws.amazon.com/goto/DotNetSDKV3/textract-2018-06-27/StartDocumentTextDetection) + [适用于 C\$1\$1 的AWS开发工具包](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/StartDocumentTextDetection) + [适用于 Go 的AWS开发工具包](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/StartDocumentTextDetection) + [AWS适用于 Java V2 的开发工具包](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/StartDocumentTextDetection) + [适用于 JavaScript 的AWS开发工具包](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/textract-2018-06-27/StartDocumentTextDetection) + [适用于 PHP V3 的 AWS 开发工具包](https://docs.aws.amazon.com/goto/SdkForPHPV3/textract-2018-06-27/StartDocumentTextDetection) + [适用于 Python 的 AWS 开发工具包](https://docs.aws.amazon.com/goto/boto3/textract-2018-06-27/StartDocumentTextDetection) + [适用于 Ruby V3 的 AWS 开发工具包](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/StartDocumentTextDetection) # StartExpenseAnalysis 开始对发票或收据进行异步分析，以获取联系信息、购买物品和供应商名称等数据。 `StartExpenseAnalysis`可以分析 JPEG、PNG 和 PDF 格式的文档中的文本。必须将这些文档存储在 Amazon S3 存储桶中。使用[DocumentLocation](API_DocumentLocation.md)参数，指定您的 S3 存储桶的名称和该存储桶中的文档名称。 `StartExpenseAnalysis`返回作业标识符 (`JobId`) 你将提供给`GetExpenseAnalysis`检索操作结果。完成对输入发票/收据的分析后，Amazon Textract 将完成状态发布到您提供给`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 资源名称 (ARN) 来执行操作。 HTTP 状态代码：400 ** BadDocumentException ** Amazon Textract 无法阅读文档。有关 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`例如）引发 LimitExceededException 异常 (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 V2 的开发工具包](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)