

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 작업
<a name="API_Operations"></a>

다음 작업이 지원됩니다.
+  [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
<a name="API_AnalyzeDocument"></a>

검색된 항목 간의 관계에 대한 입력 문서를 분석합니다.

반환되는 정보의 유형은 다음과 같습니다.
+ 양식 데이터 (키-값 페어) 관련 정보는 2로 반환됩니다.[Block](API_Block.md)객체, 각 유형`KEY_VALUE_SET`: 키`Block`객체 및 값`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).

## 요청 구문
<a name="API_AnalyzeDocument_RequestSyntax"></a>

```
{
   "Document": { 
      "Bytes": blob,
      "S3Object": { 
         "Bucket": "string",
         "Name": "string",
         "Version": "string"
      }
   },
   "FeatureTypes": [ "string" ],
   "HumanLoopConfig": { 
      "DataAttributes": { 
         "ContentClassifiers": [ "string" ]
      },
      "FlowDefinitionArn": "string",
      "HumanLoopName": "string"
   }
}
```

## 요청 파라미터
<a name="API_AnalyzeDocument_RequestParameters"></a>

요청은 JSON 형식의 다음 데이터를 받습니다.

 ** [Document](#API_AnalyzeDocument_RequestSyntax) **   <a name="Textract-AnalyzeDocument-request-Document"></a>
입력 문서인 base64로 인코딩된 바이트 또는 Amazon S3 객체입니다. AWS CLI를 사용하여 Amazon Textract 작업을 호출하는 경우 이미지 바이트를 전달할 수 없습니다. 문서는 JPEG, PNG, PDF 또는 TIFF 형식의 이미지여야 합니다.  
AWS SDK를 사용하여 Amazon Textract Textract를 호출하는 경우 다음을 사용하여 전달된 이미지 바이트를 base64로 인코딩할 필요가 없습니다.`Bytes`필드.  
유형: [Document](API_Document.md) 객체  
: 필수 프로세스는 페이지 쓰기 후 세그먼트화된 가장 오래전에 사용된(SLRU) 데이터가 내구성 있는 스토리지에 도달할 때까지 기다리고 있습니다.

 ** [FeatureTypes](#API_AnalyzeDocument_RequestSyntax) **   <a name="Textract-AnalyzeDocument-request-FeatureTypes"></a>
수행할 분석 유형의 목록입니다. 목록에 TABLES를 추가하여 입력 문서에서 검색된 테이블에 대한 정보를 반환합니다. FORMS를 추가하여 검색된 양식 데이터를 반환합니다. 두 가지 유형의 분석을 모두 수행하려면 TABLES 및 FORMS를`FeatureTypes`. 문서에서 감지된 모든 줄과 단어가 응답에 포함됩니다 (값과 관련이 없는 텍스트 포함)`FeatureTypes`).  
Type: 문자열 배열  
유효한 값:` TABLES | FORMS`   
: 필수 프로세스는 페이지 쓰기 후 세그먼트화된 가장 오래전에 사용된(SLRU) 데이터가 내구성 있는 스토리지에 도달할 때까지 기다리고 있습니다.

 ** [HumanLoopConfig](#API_AnalyzeDocument_RequestSyntax) **   <a name="Textract-AnalyzeDocument-request-HumanLoopConfig"></a>
문서 분석을 위한 루프 워크플로우에서 사람에 대한 구성을 설정합니다.  
유형: [HumanLoopConfig](API_HumanLoopConfig.md) 객체  
: 필수 아니요

## 응답 구문
<a name="API_AnalyzeDocument_ResponseSyntax"></a>

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

## 응답 요소
<a name="API_AnalyzeDocument_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 다시 전송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [AnalyzeDocumentModelVersion](#API_AnalyzeDocument_ResponseSyntax) **   <a name="Textract-AnalyzeDocument-response-AnalyzeDocumentModelVersion"></a>
문서를 분석하는 데 사용된 모델 버전입니다.  
Type: String

 ** [Blocks](#API_AnalyzeDocument_ResponseSyntax) **   <a name="Textract-AnalyzeDocument-response-Blocks"></a>
에 의해 감지되고 분석되는 항목`AnalyzeDocument`.  
Type: 어레이[Block](API_Block.md)사물

 ** [DocumentMetadata](#API_AnalyzeDocument_ResponseSyntax) **   <a name="Textract-AnalyzeDocument-response-DocumentMetadata"></a>
분석된 문서에 대한 메타데이터입니다. 페이지 수를 예로 들 수 있습니다.  
유형: [DocumentMetadata](API_DocumentMetadata.md) 객체

 ** [HumanLoopActivationOutput](#API_AnalyzeDocument_ResponseSyntax) **   <a name="Textract-AnalyzeDocument-response-HumanLoopActivationOutput"></a>
루프 평가에서 사람의 결과를 표시합니다.  
유형: [HumanLoopActivationOutput](API_HumanLoopActivationOutput.md) 객체

## 오류
<a name="API_AnalyzeDocument_Errors"></a>

 ** AccessDeniedException **   
작업을 수행할 권한이 없습니다. 권한 있는 사용자 또는 IAM 역할의 Amazon 리소스 이름(ARN)을 사용하여 작업을 수행하십시오.  
HTTP 상태 코드: 400

 ** BadDocumentException **   
Amazon Textract Textract는 문서를 읽을 수 없습니다. Amazon Textract Textract의 문서 한도에 대한 자세한 내용은 단원을 참조하십시오.[Amazon Textract TEXTRACT에서의 하드 제한](limits.md).  
HTTP 상태 코드: 400

 ** DocumentTooLargeException **   
문서가 너무 크기 때문에 처리할 수 없습니다. 동기 작업의 최대 문서 크기입니다. 10MB 비동기 작업의 최대 문서 크기는 PDF 파일의 경우 500MB입니다.  
HTTP 상태 코드: 400

 ** HumanLoopQuotaExceededException **   
사용 가능한 루프 워크플로의 최대 개수를 초과했음을 나타냅니다.  
HTTP 상태 코드: 400

 ** InternalServerError **   
Amazon Textract Textract에 서비스 문제가 발생했습니다. 호출을 다시 시도하십시오.  
HTTP 상태 코드: 500

 ** InvalidParameterException **   
입력 파라미터가 제약 조건을 위반했습니다. 예를 들어, 동기 작업에서는`InvalidParameterException`예외가 발생하지 않을 때`S3Object`또는`Bytes`값은 다음에 제공됩니다.`Document`요청 파라미터입니다. 파라미터를 확인한 다음 API 작업을 다시 호출하십시오.  
HTTP 상태 코드: 400

 ** InvalidS3ObjectException **   
Amazon Textract 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 Textract에 문의하십시오.  
HTTP 상태 코드: 400

 ** ThrottlingException **   
Amazon Textract Textract가 요청을 일시적으로 처리할 수 없습니다. 호출을 다시 시도하십시오.  
HTTP 상태 코드: 500

 ** UnsupportedDocumentException **   
입력 문서의 형식은 지원되지 않습니다. 작업 문서는 PNG, JPEG, PDF 또는 TIFF 형식일 수 있습니다.  
HTTP 상태 코드: 400

## 참고 항목
<a name="API_AnalyzeDocument_SeeAlso"></a>

이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.
+  [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/textract-2018-06-27/AnalyzeDocument) 
+  [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/textract-2018-06-27/AnalyzeDocument) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/AnalyzeDocument) 
+  [AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/AnalyzeDocument) 
+  [AWSSDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/AnalyzeDocument) 
+  [AWS SDK for JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/textract-2018-06-27/AnalyzeDocument) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/textract-2018-06-27/AnalyzeDocument) 
+  [AWSPython용 SDK](https://docs.aws.amazon.com/goto/boto3/textract-2018-06-27/AnalyzeDocument) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/AnalyzeDocument) 

# AnalyzeExpense
<a name="API_AnalyzeExpense"></a>

 `AnalyzeExpense`텍스트 간의 재정적으로 관련된 관계에 대한 입력 문서를 동기적으로 분석합니다.

정보는 다음과 같이 반환됩니다.`ExpenseDocuments`다음과 같이 분리됩니다.
+  `LineItemGroups`- 다음을 포함하는 데이터 세트`LineItems`구매한 품목과 영수증에 가격 등 텍스트 줄에 대한 정보를 저장합니다.
+  `SummaryFields`- 헤더 정보 또는 공급업체 이름과 같은 영수증에 다른 모든 정보가 들어 있습니다.

## 요청 구문
<a name="API_AnalyzeExpense_RequestSyntax"></a>

```
{
   "Document": { 
      "Bytes": blob,
      "S3Object": { 
         "Bucket": "string",
         "Name": "string",
         "Version": "string"
      }
   }
}
```

## 요청 파라미터
<a name="API_AnalyzeExpense_RequestParameters"></a>

요청은 JSON 형식의 다음 데이터를 받습니다.

 ** [Document](#API_AnalyzeExpense_RequestSyntax) **   <a name="Textract-AnalyzeExpense-request-Document"></a>
입력 문서 (바이트 또는 S3 객체) 입니다.  
를 사용하여 Amazon Textract API 작업에 이미지 바이트를 전달합니다.`Bytes`속성입니다. 예를 들어 를 사용합니다.`Bytes`로컬 파일 시스템에서 로드된 문서를 전달하는 속성입니다. 를 사용하여 전달된 이미지 바이트`Bytes`속성입니다 base64로 인코딩해야 합니다. AWS SDK를 사용하여 Amazon Textract API 작업을 호출하는 경우 코드가 문서 파일 바이트를 인코딩하지 않아도 될 수 있습니다.  
다음을 사용하여 S3 버킷에 저장된 이미지를 Amazon Textract API 작업으로 전달합니다.`S3Object`속성입니다. S3 버킷에 저장된 문서는 base64로 인코딩할 필요가 없습니다.  
S3 객체가 있는 S3 버킷의 AWS 리전과 Amazon Textract 작업에 사용하는 AWS 리전이 일치해야 합니다.  
AWS CLI를 사용하여 Amazon Textract 작업을 호출하는 경우 바이트 속성을 사용하여 이미지 바이트를 전달하는 작업은 지원되지 않습니다. 먼저 문서를 Amazon S3 버킷에 업로드한 다음 S3Object 속성을 사용하여 작업을 호출해야 합니다.  
Amazon Textract Textract가 S3 객체를 처리하려면 사용자에게 S3 객체에 액세스할 수 있는 권한이 있어야 합니다.  
유형: [Document](API_Document.md) 객체  
: 필수 프로세스는 페이지 쓰기 후 세그먼트화된 가장 오래전에 사용된(SLRU) 데이터가 내구성 있는 스토리지에 도달할 때까지 기다리고 있습니다.

## 응답 구문
<a name="API_AnalyzeExpense_ResponseSyntax"></a>

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

## 응답 요소
<a name="API_AnalyzeExpense_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 다시 전송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [DocumentMetadata](#API_AnalyzeExpense_ResponseSyntax) **   <a name="Textract-AnalyzeExpense-response-DocumentMetadata"></a>
입력 문서에 대한 정보입니다.  
유형: [DocumentMetadata](API_DocumentMetadata.md) 객체

 ** [ExpenseDocuments](#API_AnalyzeExpense_ResponseSyntax) **   <a name="Textract-AnalyzeExpense-response-ExpenseDocuments"></a>
Amazon Textract Textract에서 감지한 비용입니다.  
Type: 배열[ExpenseDocument](API_ExpenseDocument.md)사물

## 오류
<a name="API_AnalyzeExpense_Errors"></a>

 ** AccessDeniedException **   
작업을 수행할 권한이 없습니다. 권한 있는 사용자 또는 IAM 역할의 Amazon 리소스 이름(ARN)을 사용하여 작업을 수행하십시오.  
HTTP 상태 코드: 400

 ** BadDocumentException **   
Amazon Textract Textract는 문서를 읽을 수 없습니다. Amazon Textract Textract의 문서 한도에 대한 자세한 내용은 단원을 참조하십시오.[Amazon Textract TEXTRACT에서의 하드 제한](limits.md).  
HTTP 상태 코드: 400

 ** DocumentTooLargeException **   
문서가 너무 크기 때문에 처리할 수 없습니다. 동기 작업의 최대 문서 크기입니다. 10MB 비동기 작업의 최대 문서 크기는 PDF 파일의 경우 500MB입니다.  
HTTP 상태 코드: 400

 ** InternalServerError **   
Amazon Textract Textract에 서비스 문제가 발생했습니다. 호출을 다시 시도하십시오.  
HTTP 상태 코드: 500

 ** InvalidParameterException **   
입력 파라미터가 제약 조건을 위반했습니다. 예를 들어, 동기 작업에서는`InvalidParameterException`예외가 발생하지 않을 때`S3Object`또는`Bytes`값은 다음 위치에 제공됩니다.`Document`요청 파라미터입니다. 파라미터를 확인한 다음 API 작업을 다시 호출하십시오.  
HTTP 상태 코드: 400

 ** InvalidS3ObjectException **   
Amazon Textract 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 Textract에 문의하십시오.  
HTTP 상태 코드: 400

 ** ThrottlingException **   
Amazon Textract Textract가 요청을 일시적으로 처리할 수 없습니다. 호출을 다시 시도하십시오.  
HTTP 상태 코드: 500

 ** UnsupportedDocumentException **   
출력 문서의 형식은 지원되지 않습니다. 작업 문서는 PNG, JPEG, PDF 또는 TIFF 형식일 수 있습니다.  
HTTP 상태 코드: 400

## 참고 항목
<a name="API_AnalyzeExpense_SeeAlso"></a>

이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.
+  [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/textract-2018-06-27/AnalyzeExpense) 
+  [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/textract-2018-06-27/AnalyzeExpense) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/AnalyzeExpense) 
+  [AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/AnalyzeExpense) 
+  [AWSSDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/AnalyzeExpense) 
+  [AWS SDK for JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/textract-2018-06-27/AnalyzeExpense) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/textract-2018-06-27/AnalyzeExpense) 
+  [AWSPython용 SDK](https://docs.aws.amazon.com/goto/boto3/textract-2018-06-27/AnalyzeExpense) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/AnalyzeExpense) 

# AnalyzeID
<a name="API_AnalyzeID"></a>

관련 정보에 대한 ID 문서를 분석합니다. 이 정보는 추출되어 다음과 같이 반환됩니다.`IdentityDocumentFields`추출된 텍스트의 정규화된 필드와 값을 모두 기록합니다. 다른 Amazon Textract 작업과 달리`AnalyzeID`는 지오메트리 데이터를 반환하지 않습니다.

## 요청 구문
<a name="API_AnalyzeID_RequestSyntax"></a>

```
{
   "DocumentPages": [ 
      { 
         "Bytes": blob,
         "S3Object": { 
            "Bucket": "string",
            "Name": "string",
            "Version": "string"
         }
      }
   ]
}
```

## 요청 파라미터
<a name="API_AnalyzeID_RequestParameters"></a>

요청은 JSON 형식의 다음 데이터를 받습니다.

 ** [DocumentPages](#API_AnalyzeID_RequestSyntax) **   <a name="Textract-AnalyzeID-request-DocumentPages"></a>
애널리제이드에 전달되는 문서입니다.  
Type: 배열[Document](API_Document.md)사물  
어레이 멤버: 최소 항목 수는 1개입니다. 최대 항목 수는 2개입니다.  
필수 항목: 프로세스는 페이지 쓰기 후 세그먼트화된 가장 오래전에 사용된(SLRU) 데이터가 내구성 있는 스토리지에 도달할 때까지 기다리고 있습니다.

## 응답 구문
<a name="API_AnalyzeID_ResponseSyntax"></a>

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

## 응답 요소
<a name="API_AnalyzeID_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 다시 전송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [AnalyzeIDModelVersion](#API_AnalyzeID_ResponseSyntax) **   <a name="Textract-AnalyzeID-response-AnalyzeIDModelVersion"></a>
문서를 처리하는 데 사용되는 애널리틱스 아이덴티티 API의 버전입니다.  
Type: String

 ** [DocumentMetadata](#API_AnalyzeID_ResponseSyntax) **   <a name="Textract-AnalyzeID-response-DocumentMetadata"></a>
입력 문서에 대한 정보입니다.  
유형: [DocumentMetadata](API_DocumentMetadata.md) 객체

 ** [IdentityDocuments](#API_AnalyzeID_ResponseSyntax) **   <a name="Textract-AnalyzeID-response-IdentityDocuments"></a>
AnalyzeID에서 처리한 문서 목록입니다. 목록에 있는 위치를 나타내는 번호와 문서에 대한 응답 구조를 포함합니다.  
Type: 배열[IdentityDocument](API_IdentityDocument.md)사물

## 오류
<a name="API_AnalyzeID_Errors"></a>

 ** AccessDeniedException **   
작업을 수행할 권한이 없습니다. 권한 있는 사용자 또는 IAM 역할의 Amazon 리소스 이름(ARN)을 사용하여 작업을 수행하십시오.  
HTTP 상태 코드: 400

 ** BadDocumentException **   
Amazon Textract Textract는 문서를 읽을 수 없습니다. Amazon Textract Textract의 문서 한도에 대한 자세한 내용은 단원을 참조하십시오.[Amazon Textract TEXTRACT에서의 하드 제한](limits.md).  
HTTP 상태 코드: 400

 ** DocumentTooLargeException **   
문서가 너무 크기 때문에 처리할 수 없습니다. 동기 작업의 최대 문서 크기입니다. 10MB 비동기 작업의 최대 문서 크기는 PDF 파일의 경우 500MB입니다.  
HTTP 상태 코드: 400

 ** InternalServerError **   
Amazon Textract Textract에 서비스 문제가 발생했습니다. 호출을 다시 시도하십시오.  
HTTP 상태 코드: 500

 ** InvalidParameterException **   
입력 파라미터가 제약 조건을 위반했습니다. 예를 들어, 동기 작업에서는`InvalidParameterException`예외가 발생하지 않을 때`S3Object`또는`Bytes`값은 다음 위치에 제공됩니다.`Document`요청 파라미터를 지정합니다. 파라미터를 확인한 다음 API 작업을 다시 호출하십시오.  
HTTP 상태 코드: 400

 ** InvalidS3ObjectException **   
Amazon Textract 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 Textract에 문의하십시오.  
HTTP 상태 코드: 400

 ** ThrottlingException **   
Amazon Textract Textract가 요청을 일시적으로 처리할 수 없습니다. 호출을 다시 시도하십시오.  
HTTP 상태 코드: 500

 ** UnsupportedDocumentException **   
입력 문서의 형식은 지원되지 않습니다. 작업 문서는 PNG, JPEG, PDF 또는 TIFF 형식일 수 있습니다.  
HTTP 상태 코드: 400

## 참고 항목
<a name="API_AnalyzeID_SeeAlso"></a>

이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.
+  [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/textract-2018-06-27/AnalyzeID) 
+  [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/textract-2018-06-27/AnalyzeID) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/AnalyzeID) 
+  [AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/AnalyzeID) 
+  [AWSSDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/AnalyzeID) 
+  [AWS SDK for JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/textract-2018-06-27/AnalyzeID) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/textract-2018-06-27/AnalyzeID) 
+  [AWSPython용 SDK](https://docs.aws.amazon.com/goto/boto3/textract-2018-06-27/AnalyzeID) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/AnalyzeID) 

# DetectDocumentText
<a name="API_DetectDocumentText"></a>

입력 문서에서 텍스트를 감지합니다. Amazon Textract Textract는 텍스트 줄과 텍스트 한 줄을 구성하는 단어를 감지할 수 있습니다. 입력 문서는 JPEG, PNG, PDF 또는 TIFF 형식의 이미지여야 합니다.`DetectDocumentText`검색된 텍스트를 다음 배열로 반환합니다.[Block](API_Block.md)객체.

각 문서 페이지에는 연결된 페이지가 있습니다.`Block`페이지 유형입니다. 각 페이지`Block`객체가 LINE의 상위`Block`페이지에서 감지된 텍스트 행을 나타내는 개체입니다. 줄 바꿈`Block`object는 선을 구성하는 각 단어의 부모입니다. 단어는 다음과 같이 표시됩니다.`Block`WORD 유형의 객체입니다.

 `DetectDocumentText`은 동기식 작업입니다. 문서를 비동기적으로 분석하려면[StartDocumentTextDetection](API_StartDocumentTextDetection.md).

자세한 내용은 단원을 참조하십시오.[문서 텍스트 감지](https://docs.aws.amazon.com/textract/latest/dg/how-it-works-detecting.html).

## 요청 구문
<a name="API_DetectDocumentText_RequestSyntax"></a>

```
{
   "Document": { 
      "Bytes": blob,
      "S3Object": { 
         "Bucket": "string",
         "Name": "string",
         "Version": "string"
      }
   }
}
```

## 요청 파라미터
<a name="API_DetectDocumentText_RequestParameters"></a>

요청은 JSON 형식의 다음 데이터를 받습니다.

 ** [Document](#API_DetectDocumentText_RequestSyntax) **   <a name="Textract-DetectDocumentText-request-Document"></a>
입력 문서인 base64로 인코딩된 바이트 또는 Amazon S3 객체입니다. AWS CLI를 사용하여 Amazon Textract 작업을 호출하는 경우 이미지 바이트를 전달할 수 없습니다. 이 문서는 JPEG 또는 PNG 형식의 이미지여야 합니다.  
AWS SDK를 사용하여 Amazon Textract Textract를 호출하는 경우 다음을 사용하여 전달된 이미지 바이트를 base64로 인코딩할 필요가 없습니다.`Bytes`필드.  
유형: [Document](API_Document.md) 객체  
: 필수 프로세스는 페이지 쓰기 후 세그먼트화된 가장 오래전에 사용된(SLRU) 데이터가 내구성 있는 스토리지에 도달할 때까지 기다리고 있습니다.

## 응답 구문
<a name="API_DetectDocumentText_ResponseSyntax"></a>

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

## 응답 요소
<a name="API_DetectDocumentText_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 다시 전송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [Blocks](#API_DetectDocumentText_ResponseSyntax) **   <a name="Textract-DetectDocumentText-response-Blocks"></a>
의 어레이`Block`문서에서 검색된 텍스트를 포함하는 개체입니다.  
Type: 배열[Block](API_Block.md)사물

 ** [DetectDocumentTextModelVersion](#API_DetectDocumentText_ResponseSyntax) **   <a name="Textract-DetectDocumentText-response-DetectDocumentTextModelVersion"></a>
  
Type: String

 ** [DocumentMetadata](#API_DetectDocumentText_ResponseSyntax) **   <a name="Textract-DetectDocumentText-response-DocumentMetadata"></a>
문서에 대한 메타데이터입니다. 이 문서에는 문서에서 검색된 페이지 수가 포함됩니다.  
유형: [DocumentMetadata](API_DocumentMetadata.md) 객체

## 오류
<a name="API_DetectDocumentText_Errors"></a>

 ** AccessDeniedException **   
작업을 수행할 권한이 없습니다. 권한 있는 사용자 또는 IAM 역할의 Amazon 리소스 이름(ARN)을 사용하여 작업을 수행하십시오.  
HTTP 상태 코드: 400

 ** BadDocumentException **   
Amazon Textract Textract는 문서를 읽을 수 없습니다. Amazon Textract Textract의 문서 한도에 대한 자세한 내용은 단원을 참조하십시오.[Amazon Textract TEXTRACT에서의 하드 제한](limits.md).  
HTTP 상태 코드: 400

 ** DocumentTooLargeException **   
문서가 너무 크기 때문에 처리할 수 없습니다. 동기 작업의 최대 문서 크기입니다. 10MB입니다. 비동기 작업의 최대 문서 크기는 PDF 파일의 경우 500MB입니다.  
HTTP 상태 코드: 400

 ** InternalServerError **   
Amazon Textract 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 Textract에 문의하십시오.  
HTTP 상태 코드: 400

 ** ThrottlingException **   
Amazon Textract Textract이 요청을 일시적으로 처리할 수 없습니다. 호출을 다시 시도하십시오.  
HTTP 상태 코드: 500

 ** UnsupportedDocumentException **   
출력 문서의 형식은 지원되지 않습니다. 작업 문서는 PNG, JPEG, PDF 또는 TIFF 형식일 수 있습니다.  
HTTP 상태 코드: 400

## 참고 항목
<a name="API_DetectDocumentText_SeeAlso"></a>

이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.
+  [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/textract-2018-06-27/DetectDocumentText) 
+  [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/textract-2018-06-27/DetectDocumentText) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/DetectDocumentText) 
+  [AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/DetectDocumentText) 
+  [AWSSDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/DetectDocumentText) 
+  [AWS SDK for JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/textract-2018-06-27/DetectDocumentText) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/textract-2018-06-27/DetectDocumentText) 
+  [AWSPython용 SDK](https://docs.aws.amazon.com/goto/boto3/textract-2018-06-27/DetectDocumentText) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/DetectDocumentText) 

# GetDocumentAnalysis
<a name="API_GetDocumentAnalysis"></a>

문서의 텍스트를 분석하는 Amazon Textract 비동기 작업의 결과를 가져옵니다.

다음을 호출하여 비동기 텍스트 분석을 시작합니다.[StartDocumentAnalysis](API_StartDocumentAnalysis.md)를 반환하는 작업 식별자 (`JobId`). 텍스트 분석 작업이 완료되면 Amazon Textract Textract는 초기 호출에 등록된 Amazon Simple Notification Service (Amazon SNS) 주제에 완료 상태를 게시합니다.`StartDocumentAnalysis`. 텍스트 감지 작업의 결과를 얻으려면 먼저 Amazon SNS 주제에 게시된 상태 값이 다음과 같은지 확인하십시오.`SUCCEEDED`. 그렇다면 전화하십시오.`GetDocumentAnalysis`작업 식별자를 전달하고 (`JobId`) 초기 통화부터`StartDocumentAnalysis`.

 `GetDocumentAnalysis`의 배열을 반환합니다.[Block](API_Block.md)객체. 다음 정보 유형이 반환됩니다.
+ 양식 데이터 (키-값 쌍). 관련 정보는 2개로 반환됩니다.[Block](API_Block.md)객체, 각 유형`KEY_VALUE_SET`: 키`Block`객체 및 값`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).

## 요청 구문
<a name="API_GetDocumentAnalysis_RequestSyntax"></a>

```
{
   "JobId": "string",
   "MaxResults": number,
   "NextToken": "string"
}
```

## 요청 파라미터
<a name="API_GetDocumentAnalysis_RequestParameters"></a>

요청은 JSON 형식의 다음 데이터를 받습니다.

 ** [JobId](#API_GetDocumentAnalysis_RequestSyntax) **   <a name="Textract-GetDocumentAnalysis-request-JobId"></a>
텍스트 감지 작업의 고유 식별자입니다. 이`JobId`에서 반환됩니다.`StartDocumentAnalysis`. A`JobId`값은 7일 동안만 유효합니다.  
Type: String  
길이 제약 조건: 최소 길이는 1이고, 최대 길이 64.  
Pattern: `^[a-zA-Z0-9-_]+$`   
: 필수 프로세스는 페이지 쓰기 후 세그먼트화된 가장 오래전에 사용된(SLRU) 데이터가 내구성 있는 스토리지에 도달할 때까지 기다리고 있습니다.

 ** [MaxResults](#API_GetDocumentAnalysis_RequestSyntax) **   <a name="Textract-GetDocumentAnalysis-request-MaxResults"></a>
페이지가 지정된 호출당 반환할 최대 결과 수입니다. 지정할 수 있는 가장 큰 값은 1,000입니다. 1,000보다 큰 값을 지정한 경우 최대 1,000개의 결과가 반환됩니다. 기본값은 1000입니다.  
Type: 정수  
유효 범위: 최소값 1.  
: 필수 아니요

 ** [NextToken](#API_GetDocumentAnalysis_RequestSyntax) **   <a name="Textract-GetDocumentAnalysis-request-NextToken"></a>
이전 응답이 불완전한 경우 (검색할 블록이 더 많기 때문에) Amazon Textract Textract는 응답에 페이지 매김 토큰을 반환합니다. 이 페이지 매김 토큰을 사용하여 다음 블록 세트를 검색할 수 있습니다.  
Type: String  
길이 제약 조건: 최소 길이는 1이고, 최대 길이 255.  
Pattern: `.*\S.*`   
: 필수 아니요

## 응답 구문
<a name="API_GetDocumentAnalysis_ResponseSyntax"></a>

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

## 응답 요소
<a name="API_GetDocumentAnalysis_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 다시 전송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [AnalyzeDocumentModelVersion](#API_GetDocumentAnalysis_ResponseSyntax) **   <a name="Textract-GetDocumentAnalysis-response-AnalyzeDocumentModelVersion"></a>
  
Type: String

 ** [Blocks](#API_GetDocumentAnalysis_ResponseSyntax) **   <a name="Textract-GetDocumentAnalysis-response-Blocks"></a>
텍스트 분석 작업의 결과입니다.  
Type: 배열[Block](API_Block.md)사물

 ** [DocumentMetadata](#API_GetDocumentAnalysis_ResponseSyntax) **   <a name="Textract-GetDocumentAnalysis-response-DocumentMetadata"></a>
Amazon Textract Textract가 처리한 문서에 대한 정보입니다.`DocumentMetadata`는 Amazon Textract 비디오 작업에서 페이지 매겨진 응답의 모든 페이지에서 반환됩니다.  
유형: [DocumentMetadata](API_DocumentMetadata.md) 객체

 ** [JobStatus](#API_GetDocumentAnalysis_ResponseSyntax) **   <a name="Textract-GetDocumentAnalysis-response-JobStatus"></a>
텍스트 검색 작업의 현재 상태입니다.  
Type: String  
유효한 값:` IN_PROGRESS | SUCCEEDED | FAILED | PARTIAL_SUCCESS` 

 ** [NextToken](#API_GetDocumentAnalysis_ResponseSyntax) **   <a name="Textract-GetDocumentAnalysis-response-NextToken"></a>
응답이 잘린 경우 Amazon Textract Textract는 이 토큰을 반환합니다. 이 토큰을 후속 요청에서 사용하여 다음 텍스트 검색 결과 집합을 가져올 수 있습니다.  
Type: String  
길이 제약 조건: 최소 길이는 1이고, 최대 길이 255.  
Pattern: `.*\S.*` 

 ** [StatusMessage](#API_GetDocumentAnalysis_ResponseSyntax) **   <a name="Textract-GetDocumentAnalysis-response-StatusMessage"></a>
검색 작업을 완료할 수 없는 경우 반환합니다. 발생한 오류에 대한 설명이 들어 있습니다.  
Type: String

 ** [Warnings](#API_GetDocumentAnalysis_ResponseSyntax) **   <a name="Textract-GetDocumentAnalysis-response-Warnings"></a>
문서 분석 작업 중에 발생한 경고 목록입니다.  
Type: 배열[Warning](API_Warning.md)사물

## 오류
<a name="API_GetDocumentAnalysis_Errors"></a>

 ** AccessDeniedException **   
작업을 수행할 권한이 없습니다. 권한 있는 사용자 또는 IAM 역할의 Amazon 리소스 이름(ARN)을 사용하여 작업을 수행하십시오.  
HTTP 상태 코드: 400

 ** InternalServerError **   
Amazon Textract 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 Textract에 문의하십시오.  
HTTP 상태 코드: 400

 ** ThrottlingException **   
Amazon Textract 이 요청을 일시적으로 처리할 수 없습니다. 호출을 다시 시도하십시오.  
HTTP 상태 코드: 500

## 참고 항목
<a name="API_GetDocumentAnalysis_SeeAlso"></a>

이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.
+  [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/textract-2018-06-27/GetDocumentAnalysis) 
+  [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/textract-2018-06-27/GetDocumentAnalysis) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/GetDocumentAnalysis) 
+  [AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/GetDocumentAnalysis) 
+  [AWSSDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/GetDocumentAnalysis) 
+  [AWS SDK for JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/textract-2018-06-27/GetDocumentAnalysis) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/textract-2018-06-27/GetDocumentAnalysis) 
+  [AWSPython용 SDK](https://docs.aws.amazon.com/goto/boto3/textract-2018-06-27/GetDocumentAnalysis) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/GetDocumentAnalysis) 

# GetDocumentTextDetection
<a name="API_GetDocumentTextDetection"></a>

문서에서 텍스트를 감지하는 Amazon Textract 비동기 작업에 대한 결과를 가져옵니다. Amazon Textract Textract는 텍스트 줄과 텍스트 한 줄을 구성하는 단어를 감지할 수 있습니다.

를 호출하여 비동기 텍스트 감지를 시작합니다.[StartDocumentTextDetection](API_StartDocumentTextDetection.md)를 반환하는 작업 식별자 (`JobId`). 텍스트 검색 작업이 완료되면 Amazon Textract Textract는 초기 호출에 등록된 Amazon Simple Notification Service (Amazon SNS) 주제에 완료 상태를 게시합니다.`StartDocumentTextDetection`. 텍스트 감지 작업의 결과를 얻으려면 먼저 Amazon SNS 주제에 게시된 상태 값이 다음과 같은지 확인하십시오.`SUCCEEDED`. 그렇다면 전화하십시오.`GetDocumentTextDetection`작업 식별자를 전달하고 (`JobId`) 초기 통화부터`StartDocumentTextDetection`.

 `GetDocumentTextDetection`의 배열을 반환합니다.[Block](API_Block.md)객체.

각 문서 페이지는 연결된 상태로`Block`페이지 유형입니다. 각 페이지`Block`객체가 LINE에 있는 상위`Block`페이지에서 감지된 텍스트 행을 나타내는 개체입니다. 줄 바꿈`Block`object는 선을 구성하는 각 단어의 부모입니다. 단어는 다음과 같이 표시됩니다.`Block`WORD 유형의 객체입니다.

MaxResulent 파라미터를 사용하여 반환되는 블록 수를 제한합니다. 에 지정된 것보다 많은 결과가 있는 경우`MaxResults`, 의 가치`NextToken`작업 응답에 다음 결과 집합을 가져오기 위한 페이지 매김 토큰이 포함되어 있습니다. 결과의 다음 페이지를 가져오려면`GetDocumentTextDetection`를 채우고`NextToken`이전 호출에서 반환된 토큰 값이 있는 요청 매개 변수`GetDocumentTextDetection`.

자세한 내용은 단원을 참조하십시오.[문서 텍스트 감지](https://docs.aws.amazon.com/textract/latest/dg/how-it-works-detecting.html).

## 요청 구문
<a name="API_GetDocumentTextDetection_RequestSyntax"></a>

```
{
   "JobId": "string",
   "MaxResults": number,
   "NextToken": "string"
}
```

## 요청 파라미터
<a name="API_GetDocumentTextDetection_RequestParameters"></a>

요청은 JSON 형식의 다음 데이터를 받습니다.

 ** [JobId](#API_GetDocumentTextDetection_RequestSyntax) **   <a name="Textract-GetDocumentTextDetection-request-JobId"></a>
텍스트 감지 작업의 고유 식별자입니다. 이`JobId`에서 반환됩니다.`StartDocumentTextDetection`. A`JobId`값은 7일 동안만 유효합니다.  
Type: String  
길이 제약 조건: 최소 길이는 1이고, 최대 길이 64.  
Pattern: `^[a-zA-Z0-9-_]+$`   
: 필수 프로세스는 페이지 쓰기 후 세그먼트화된 가장 오래전에 사용된(SLRU) 데이터가 내구성 있는 스토리지에 도달할 때까지 기다리고 있습니다.

 ** [MaxResults](#API_GetDocumentTextDetection_RequestSyntax) **   <a name="Textract-GetDocumentTextDetection-request-MaxResults"></a>
페이지가 지정된 호출당 반환할 결과의 최대 수입니다. 지정할 수 있는 가장 큰 값은 1,000입니다. 1,000보다 큰 값을 지정한 경우 최대 1,000개의 결과가 반환됩니다. 기본값은 1000입니다.  
Type: 정수  
유효 범위: 최소값 1.  
: 필수 아니요

 ** [NextToken](#API_GetDocumentTextDetection_RequestSyntax) **   <a name="Textract-GetDocumentTextDetection-request-NextToken"></a>
이전 응답이 불완전한 경우 (검색할 블록이 더 많기 때문에) Amazon Textract Textract는 응답에 페이지 매김 토큰을 반환합니다. 이 페이지 매김 토큰을 사용하여 다음 블록 세트를 검색할 수 있습니다.  
Type: String  
길이 제약 조건: 최소 길이는 1이고, 최대 길이 255.  
Pattern: `.*\S.*`   
: 필수 아니요

## 응답 구문
<a name="API_GetDocumentTextDetection_ResponseSyntax"></a>

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

## 응답 요소
<a name="API_GetDocumentTextDetection_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 다시 전송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [Blocks](#API_GetDocumentTextDetection_ResponseSyntax) **   <a name="Textract-GetDocumentTextDetection-response-Blocks"></a>
텍스트 감지 작업의 결과입니다.  
Type: 배열[Block](API_Block.md)사물

 ** [DetectDocumentTextModelVersion](#API_GetDocumentTextDetection_ResponseSyntax) **   <a name="Textract-GetDocumentTextDetection-response-DetectDocumentTextModelVersion"></a>
  
Type: String

 ** [DocumentMetadata](#API_GetDocumentTextDetection_ResponseSyntax) **   <a name="Textract-GetDocumentTextDetection-response-DocumentMetadata"></a>
Amazon Textract Textract가 처리한 문서에 대한 정보입니다.`DocumentMetadata`는 Amazon Textract 비디오 작업에서 페이지 매겨진 응답의 모든 페이지에서 반환됩니다.  
유형: [DocumentMetadata](API_DocumentMetadata.md) 객체

 ** [JobStatus](#API_GetDocumentTextDetection_ResponseSyntax) **   <a name="Textract-GetDocumentTextDetection-response-JobStatus"></a>
텍스트 검색 작업의 현재 상태입니다.  
Type: String  
유효한 값:` IN_PROGRESS | SUCCEEDED | FAILED | PARTIAL_SUCCESS` 

 ** [NextToken](#API_GetDocumentTextDetection_ResponseSyntax) **   <a name="Textract-GetDocumentTextDetection-response-NextToken"></a>
응답이 잘린 경우 Amazon Textract Textract는 이 토큰을 반환합니다. 후속 요청에서 이 토큰을 사용하여 다음 텍스트 감지 결과 집합을 가져올 수 있습니다.  
Type: String  
길이 제약 조건: 최소 길이는 1이고, 최대 길이 255.  
Pattern: `.*\S.*` 

 ** [StatusMessage](#API_GetDocumentTextDetection_ResponseSyntax) **   <a name="Textract-GetDocumentTextDetection-response-StatusMessage"></a>
검색 작업을 완료할 수 없는 경우 반환합니다. 발생한 오류에 대한 설명이 들어 있습니다.  
Type: String

 ** [Warnings](#API_GetDocumentTextDetection_ResponseSyntax) **   <a name="Textract-GetDocumentTextDetection-response-Warnings"></a>
문서에 대한 텍스트 감지 작업 중에 발생한 경고 목록입니다.  
Type: 배열[Warning](API_Warning.md)사물

## 오류
<a name="API_GetDocumentTextDetection_Errors"></a>

 ** AccessDeniedException **   
작업을 수행할 권한이 없습니다. 권한 있는 사용자 또는 IAM 역할의 Amazon 리소스 이름(ARN)을 사용하여 작업을 수행하십시오.  
HTTP 상태 코드: 400

 ** InternalServerError **   
Amazon Textract 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 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 Textract에 문의하십시오.  
HTTP 상태 코드: 400

 ** ThrottlingException **   
Amazon Textract Textract이 요청을 일시적으로 처리할 수 없습니다. 호출을 다시 시도하십시오.  
HTTP 상태 코드: 500

## 참고 항목
<a name="API_GetDocumentTextDetection_SeeAlso"></a>

이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.
+  [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/textract-2018-06-27/GetDocumentTextDetection) 
+  [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/textract-2018-06-27/GetDocumentTextDetection) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/GetDocumentTextDetection) 
+  [AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/GetDocumentTextDetection) 
+  [AWSSDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/GetDocumentTextDetection) 
+  [AWS SDK for JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/textract-2018-06-27/GetDocumentTextDetection) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/textract-2018-06-27/GetDocumentTextDetection) 
+  [AWSPython용 SDK](https://docs.aws.amazon.com/goto/boto3/textract-2018-06-27/GetDocumentTextDetection) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/GetDocumentTextDetection) 

# GetExpenseAnalysis
<a name="API_GetExpenseAnalysis"></a>

송장 및 영수증을 분석하는 Amazon Textract 비동기 작업에 대한 결과를 가져옵니다. Amazon Textract 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).

## 요청 구문
<a name="API_GetExpenseAnalysis_RequestSyntax"></a>

```
{
   "JobId": "string",
   "MaxResults": number,
   "NextToken": "string"
}
```

## 요청 파라미터
<a name="API_GetExpenseAnalysis_RequestParameters"></a>

요청은 JSON 형식의 다음 데이터를 받습니다.

 ** [JobId](#API_GetExpenseAnalysis_RequestSyntax) **   <a name="Textract-GetExpenseAnalysis-request-JobId"></a>
텍스트 검색 작업의 고유 식별자입니다. 이`JobId`에서 반환됩니다.`StartExpenseAnalysis`. A`JobId`값은 7일 동안만 유효합니다.  
Type: String  
길이 제약 조건: 최소 길이는 1이고, 최대 길이 64.  
Pattern: `^[a-zA-Z0-9-_]+$`   
: 필수 프로세스는 페이지 쓰기 후 세그먼트화된 가장 오래전에 사용된(SLRU) 데이터가 내구성 있는 스토리지에 도달할 때까지 기다리고 있습니다.

 ** [MaxResults](#API_GetExpenseAnalysis_RequestSyntax) **   <a name="Textract-GetExpenseAnalysis-request-MaxResults"></a>
페이지가 지정된 호출당 반환할 결과의 최대 수입니다. 지정할 수 있는 가장 큰 값은 20입니다. 20보다 큰 값을 지정한 경우 최대 20개의 결과가 반환됩니다. 기본값은 20입니다.  
Type: 정수  
유효 범위: 최소값은 1이고,  
: 필수 아니요

 ** [NextToken](#API_GetExpenseAnalysis_RequestSyntax) **   <a name="Textract-GetExpenseAnalysis-request-NextToken"></a>
이전 응답이 불완전한 경우 (검색할 블록이 더 많기 때문에) Amazon Textract Textract는 응답에 페이지 매김 토큰을 반환합니다. 이 페이지 매김 토큰을 사용하여 다음 블록 세트를 검색할 수 있습니다.  
Type: String  
길이 제약 조건: 최소 길이는 1이고, 최대 길이 255.  
Pattern: `.*\S.*`   
: 필수 아니요

## 응답 구문
<a name="API_GetExpenseAnalysis_ResponseSyntax"></a>

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

## 응답 요소
<a name="API_GetExpenseAnalysis_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 다시 전송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [AnalyzeExpenseModelVersion](#API_GetExpenseAnalysis_ResponseSyntax) **   <a name="Textract-GetExpenseAnalysis-response-AnalyzeExpenseModelVersion"></a>
분석의 현재 모델 버전입니다.  
Type: String

 ** [DocumentMetadata](#API_GetExpenseAnalysis_ResponseSyntax) **   <a name="Textract-GetExpenseAnalysis-response-DocumentMetadata"></a>
Amazon Textract Textract가 처리한 문서에 대한 정보입니다.`DocumentMetadata`는 Amazon Textract 작업에서 페이지 매겨진 응답의 모든 페이지에서 반환됩니다.  
유형: [DocumentMetadata](API_DocumentMetadata.md) 객체

 ** [ExpenseDocuments](#API_GetExpenseAnalysis_ResponseSyntax) **   <a name="Textract-GetExpenseAnalysis-response-ExpenseDocuments"></a>
Amazon Textract Textract에서 감지한 비용입니다.  
Type: 배열[ExpenseDocument](API_ExpenseDocument.md)사물

 ** [JobStatus](#API_GetExpenseAnalysis_ResponseSyntax) **   <a name="Textract-GetExpenseAnalysis-response-JobStatus"></a>
텍스트 검색 작업의 현재 상태입니다.  
Type: String  
유효한 값:` IN_PROGRESS | SUCCEEDED | FAILED | PARTIAL_SUCCESS` 

 ** [NextToken](#API_GetExpenseAnalysis_ResponseSyntax) **   <a name="Textract-GetExpenseAnalysis-response-NextToken"></a>
응답이 잘린 경우 Amazon Textract Textract는 이 토큰을 반환합니다. 이 토큰을 후속 요청에서 사용하여 다음 텍스트 검색 결과 집합을 가져올 수 있습니다.  
Type: String  
길이 제약 조건: 최소 길이는 1이고, 최대 길이 255.  
Pattern: `.*\S.*` 

 ** [StatusMessage](#API_GetExpenseAnalysis_ResponseSyntax) **   <a name="Textract-GetExpenseAnalysis-response-StatusMessage"></a>
검색 작업을 완료할 수 없는 경우 반환합니다. 발생한 오류에 대한 설명이 들어 있습니다.  
Type: String

 ** [Warnings](#API_GetExpenseAnalysis_ResponseSyntax) **   <a name="Textract-GetExpenseAnalysis-response-Warnings"></a>
문서에 대한 텍스트 감지 작업 중에 발생한 경고 목록입니다.  
Type: 배열[Warning](API_Warning.md)사물

## 오류
<a name="API_GetExpenseAnalysis_Errors"></a>

 ** AccessDeniedException **   
작업을 수행할 권한이 없습니다. 권한 있는 사용자 또는 IAM 역할의 Amazon 리소스 이름(ARN)을 사용하여 작업을 수행하십시오.  
HTTP 상태 코드: 400

 ** InternalServerError **   
Amazon Textract 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 Textract에 문의하십시오.  
HTTP 상태 코드: 400

 ** ThrottlingException **   
Amazon Textract Textract가 요청을 일시적으로 처리할 수 없습니다. 호출을 다시 시도하십시오.  
HTTP 상태 코드: 500

## 참고 항목
<a name="API_GetExpenseAnalysis_SeeAlso"></a>

이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.
+  [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/textract-2018-06-27/GetExpenseAnalysis) 
+  [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/textract-2018-06-27/GetExpenseAnalysis) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/GetExpenseAnalysis) 
+  [AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/GetExpenseAnalysis) 
+  [AWSSDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/GetExpenseAnalysis) 
+  [AWS SDK for JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/textract-2018-06-27/GetExpenseAnalysis) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/textract-2018-06-27/GetExpenseAnalysis) 
+  [AWSPython용 SDK](https://docs.aws.amazon.com/goto/boto3/textract-2018-06-27/GetExpenseAnalysis) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/GetExpenseAnalysis) 

# StartDocumentAnalysis
<a name="API_StartDocumentAnalysis"></a>

키-값 페어, 테이블 및 선택 요소와 같은 감지된 항목 간의 관계에 대한 입력 문서의 비동기식 분석을 시작합니다.

 `StartDocumentAnalysis`에서는 JPEG, PNG, TIFF 및 PDF 형식의 문서에서 텍스트를 분석할 수 있습니다. Amazon S3 버킷에 저장됩니다. 사용[DocumentLocation](API_DocumentLocation.md)을 눌러 문서의 버킷 이름과 파일 이름을 지정합니다.

 `StartDocumentAnalysis`작업 식별자를 반환합니다 (`JobId`) 을 사용하여 작업 결과를 얻습니다. 텍스트 분석이 완료되면 Amazon Textract 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).

## 요청 구문
<a name="API_StartDocumentAnalysis_RequestSyntax"></a>

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

## 요청 파라미터
<a name="API_StartDocumentAnalysis_RequestParameters"></a>

요청은 JSON 형식의 다음 데이터를 받습니다.

 ** [ClientRequestToken](#API_StartDocumentAnalysis_RequestSyntax) **   <a name="Textract-StartDocumentAnalysis-request-ClientRequestToken"></a>
시작 요청을 식별하는 데 사용하는 멱등성 토큰입니다. 동일한 토큰을 여러 개 사용하여 사용하는 경우`StartDocumentAnalysis`요청, 동일`JobId`이 반환됩니다. 사용`ClientRequestToken`같은 작업이 실수로 두 번 이상 시작되지 않도록 합니다. 자세한 내용은 단원을 참조하십시오.[Amazon Textract 비동기 작업 호출](https://docs.aws.amazon.com/textract/latest/dg/api-async.html).  
Type: String  
길이 제약 조건: 최소 길이는 1이고, 최대 길이 64.  
Pattern: `^[a-zA-Z0-9-_]+$`   
: 필수 아니요

 ** [DocumentLocation](#API_StartDocumentAnalysis_RequestSyntax) **   <a name="Textract-StartDocumentAnalysis-request-DocumentLocation"></a>
처리할 문서의 위치입니다.  
유형: [DocumentLocation](API_DocumentLocation.md) 객체  
: 필수 프로세스는 페이지 쓰기 후 세그먼트화된 가장 오래전에 사용된(SLRU) 데이터가 내구성 있는 스토리지에 도달할 때까지 기다리고 있습니다.

 ** [FeatureTypes](#API_StartDocumentAnalysis_RequestSyntax) **   <a name="Textract-StartDocumentAnalysis-request-FeatureTypes"></a>
수행할 분석 유형의 목록입니다. 목록에 TABLES를 추가하여 입력 문서에서 검색된 테이블에 대한 정보를 반환합니다. FORMS를 추가하여 검색된 양식 데이터를 반환합니다. 두 가지 유형의 분석을 모두 수행하려면 TABLES 및 FORMS를`FeatureTypes`. 문서에서 감지된 모든 줄과 단어가 응답에 포함됩니다 (값과 관련이 없는 텍스트 포함)`FeatureTypes`).  
Type: 문자열 배열  
유효한 값:` TABLES | FORMS`   
: 필수 프로세스는 페이지 쓰기 후 세그먼트화된 가장 오래전에 사용된(SLRU) 데이터가 내구성 있는 스토리지에 도달할 때까지 기다리고 있습니다.

 ** [JobTag](#API_StartDocumentAnalysis_RequestSyntax) **   <a name="Textract-StartDocumentAnalysis-request-JobTag"></a>
지정한 식별자로, Amazon SNS 주제에 게시된 완료 알림에 포함됩니다. 예를 들어 를 사용할 수 있습니다.`JobTag`완료 통지가 해당하는 문서 유형 (예: 세금 양식 또는 영수증) 을 식별합니다.  
Type: String  
길이 제약 조건: 최소 길이는 1이고, 최대 길이 64.  
Pattern: `[a-zA-Z0-9_.\-:]+`   
: 필수 아니요

 ** [KMSKeyId](#API_StartDocumentAnalysis_RequestSyntax) **   <a name="Textract-StartDocumentAnalysis-request-KMSKeyId"></a>
추론 결과를 암호화하는 데 사용되는 KMS 키입니다. 키 ID 또는 키 별칭 형식일 수 있습니다. KMS 키가 제공되면 고객 버킷에 있는 객체의 서버 측 암호화에 KMS 키가 사용됩니다. 이 매개 변수를 활성화하지 않으면 결과는 SSE-S3 를 사용하여 서버 측에서 암호화됩니다.  
Type: String  
길이 제약 조건: 최소 길이는 1이고, 최대 길이 2048.  
Pattern: `^[A-Za-z0-9][A-Za-z0-9:_/+=,@.-]{0,2048}$`   
: 필수 아니요

 ** [NotificationChannel](#API_StartDocumentAnalysis_RequestSyntax) **   <a name="Textract-StartDocumentAnalysis-request-NotificationChannel"></a>
Amazon Textract가 작업의 완료 상태를 게시하도록 하려는 Amazon SNS 주제 ARN입니다.  
유형: [NotificationChannel](API_NotificationChannel.md) 객체  
: 필수 아니요

 ** [OutputConfig](#API_StartDocumentAnalysis_RequestSyntax) **   <a name="Textract-StartDocumentAnalysis-request-OutputConfig"></a>
출력이 고객 정의 버킷으로 이동할지 여부를 설정합니다. 기본적으로 Amazon Textract Textract는 GetDocumentAnalysis 작업에서 액세스할 수 있도록 결과를 내부적으로 저장합니다.  
유형: [OutputConfig](API_OutputConfig.md) 객체  
: 필수 아니요

## 응답 구문
<a name="API_StartDocumentAnalysis_ResponseSyntax"></a>

```
{
   "JobId": "string"
}
```

## 응답 요소
<a name="API_StartDocumentAnalysis_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 다시 전송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [JobId](#API_StartDocumentAnalysis_ResponseSyntax) **   <a name="Textract-StartDocumentAnalysis-response-JobId"></a>
문서 텍스트 감지 작업의 식별자입니다. 사용`JobId`후속 호출에서 작업을 식별합니다.`GetDocumentAnalysis`. A`JobId`값은 7일 동안만 유효합니다.  
Type: String  
길이 제약 조건: 최소 길이는 1이고, 최대 길이 64.  
Pattern: `^[a-zA-Z0-9-_]+$` 

## 오류
<a name="API_StartDocumentAnalysis_Errors"></a>

 ** AccessDeniedException **   
작업을 수행할 권한이 없습니다. 권한 있는 사용자 또는 IAM 역할의 Amazon 리소스 이름(ARN)을 사용하여 작업을 수행하십시오.  
HTTP 상태 코드: 400

 ** BadDocumentException **   
Amazon Textract Textract는 문서를 읽을 수 없습니다. Amazon Textract Textract의 문서 한도에 대한 자세한 내용은 단원을 참조하십시오.[Amazon Textract TEXTRACT에서의 하드 제한](limits.md).  
HTTP 상태 코드: 400

 ** DocumentTooLargeException **   
문서가 너무 크기 때문에 처리할 수 없습니다. 동기 작업의 최대 문서 크기입니다. 10MB 비동기 작업의 최대 문서 크기는 PDF 파일의 경우 500MB입니다.  
HTTP 상태 코드: 400

 ** IdempotentParameterMismatchException **   
A`ClientRequestToken`input 파라미터가 작업과 함께 재사용되었지만 하나 이상의 다른 입력 파라미터가 이전의 작업 호출과 다릅니다.  
HTTP 상태 코드: 400

 ** InternalServerError **   
Amazon Textract Textract에 서비스 문제가 발생했습니다. 호출을 다시 시도하십시오.  
HTTP 상태 코드: 500

 ** InvalidKMSKeyException **   
 KMS 키를 입력한 상태에서 암호 해독 권한이 없거나 KMS 키가 잘못 입력되었음을 나타냅니다.  
HTTP 상태 코드: 400

 ** InvalidParameterException **   
입력 파라미터가 제약 조건을 위반했습니다. 예를 들어, 동기 작업에서는`InvalidParameterException`예외가 발생하지 않을 때`S3Object`또는`Bytes`값은 다음 위치에 제공됩니다.`Document`요청 파라미터입니다. 파라미터를 확인한 다음 API 작업을 다시 호출하십시오.  
HTTP 상태 코드: 400

 ** InvalidS3ObjectException **   
Amazon Textract 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`예를 들어) 을 발생시키면 동시 실행 작업의 수가 Amazon Textract 서비스 제한 미만이 될 때까지 (HTTP 상태 코드: 400) 이 발생합니다.  
HTTP 상태 코드: 400

 ** ProvisionedThroughputExceededException **   
요청의 수가 처리량 한도를 초과했습니다. 이 한도를 늘려야 하는 경우 Amazon Textract Textract에 문의하십시오.  
HTTP 상태 코드: 400

 ** ThrottlingException **   
Amazon Textract Textract가 요청을 일시적으로 처리할 수 없습니다. 호출을 다시 시도하십시오.  
HTTP 상태 코드: 500

 ** UnsupportedDocumentException **   
출력 문서의 형식은 지원되지 않습니다. 작업 문서는 PNG, JPEG, PDF 또는 TIFF 형식일 수 있습니다.  
HTTP 상태 코드: 400

## 참고 항목
<a name="API_StartDocumentAnalysis_SeeAlso"></a>

이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.
+  [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/textract-2018-06-27/StartDocumentAnalysis) 
+  [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/textract-2018-06-27/StartDocumentAnalysis) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/StartDocumentAnalysis) 
+  [AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/StartDocumentAnalysis) 
+  [AWSSDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/StartDocumentAnalysis) 
+  [AWS SDK for JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/textract-2018-06-27/StartDocumentAnalysis) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/textract-2018-06-27/StartDocumentAnalysis) 
+  [AWSPython용 SDK](https://docs.aws.amazon.com/goto/boto3/textract-2018-06-27/StartDocumentAnalysis) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/StartDocumentAnalysis) 

# StartDocumentTextDetection
<a name="API_StartDocumentTextDetection"></a>

문서에서 텍스트의 비동기 감지를 시작합니다. Amazon Textract Textract는 텍스트 줄과 텍스트 한 줄을 구성하는 단어를 감지할 수 있습니다.

 `StartDocumentTextDetection`에서는 JPEG, PNG, TIFF 및 PDF 형식의 문서에서 텍스트를 분석할 수 있습니다. 문서는 Amazon S3 버킷에 저장됩니다. 사용[DocumentLocation](API_DocumentLocation.md)을 눌러 문서의 버킷 이름과 파일 이름을 지정합니다.

 `StartTextDetection`작업 식별자를 반환합니다 (`JobId`) 을 사용하여 작업 결과를 얻습니다. 텍스트 감지가 완료되면 Amazon Textract 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).

## 요청 구문
<a name="API_StartDocumentTextDetection_RequestSyntax"></a>

```
{
   "ClientRequestToken": "string",
   "DocumentLocation": { 
      "S3Object": { 
         "Bucket": "string",
         "Name": "string",
         "Version": "string"
      }
   },
   "JobTag": "string",
   "KMSKeyId": "string",
   "NotificationChannel": { 
      "RoleArn": "string",
      "SNSTopicArn": "string"
   },
   "OutputConfig": { 
      "S3Bucket": "string",
      "S3Prefix": "string"
   }
}
```

## 요청 파라미터
<a name="API_StartDocumentTextDetection_RequestParameters"></a>

요청은 JSON 형식의 다음 데이터를 받습니다.

 ** [ClientRequestToken](#API_StartDocumentTextDetection_RequestSyntax) **   <a name="Textract-StartDocumentTextDetection-request-ClientRequestToken"></a>
시작 요청을 식별하는 데 사용되는 멱등 토큰입니다. 동일한 토큰을 여러 개 사용하여 사용하는 경우`StartDocumentTextDetection`요청, 동일`JobId`이 반환됩니다. 사용`ClientRequestToken`같은 작업이 실수로 두 번 이상 시작되지 않도록 합니다. 자세한 내용은 단원을 참조하십시오.[Amazon Textract 비동기 작업 호출](https://docs.aws.amazon.com/textract/latest/dg/api-async.html).  
Type: String  
길이 제약 조건: 최소 길이는 1이고, 최대 길이 64.  
Pattern: `^[a-zA-Z0-9-_]+$`   
: 필수 아니요

 ** [DocumentLocation](#API_StartDocumentTextDetection_RequestSyntax) **   <a name="Textract-StartDocumentTextDetection-request-DocumentLocation"></a>
처리할 문서의 위치입니다.  
유형: [DocumentLocation](API_DocumentLocation.md) 객체  
: 필수 프로세스는 페이지 쓰기 후 세그먼트화된 가장 오래전에 사용된(SLRU) 데이터가 내구성 있는 스토리지에 도달할 때까지 기다리고 있습니다.

 ** [JobTag](#API_StartDocumentTextDetection_RequestSyntax) **   <a name="Textract-StartDocumentTextDetection-request-JobTag"></a>
지정한 식별자로, Amazon SNS 주제에 게시된 완료 알림에 포함됩니다. 예를 들어 를 사용할 수 있습니다.`JobTag`완료 통지가 해당하는 문서 유형 (예: 세금 양식 또는 영수증) 을 식별합니다.  
Type: String  
길이 제약 조건: 최소 길이는 1이고, 최대 길이 64.  
Pattern: `[a-zA-Z0-9_.\-:]+`   
: 필수 아니요

 ** [KMSKeyId](#API_StartDocumentTextDetection_RequestSyntax) **   <a name="Textract-StartDocumentTextDetection-request-KMSKeyId"></a>
추론 결과를 암호화하는 데 사용되는 KMS 키입니다. 키 ID 또는 키 별칭 형식일 수 있습니다. KMS 키가 제공되면 고객 버킷에 있는 객체의 서버 측 암호화에 KMS 키가 사용됩니다. 이 매개 변수를 활성화하지 않으면 결과는 SSE-S3 를 사용하여 서버 측에서 암호화됩니다.  
Type: String  
길이 제약 조건: 최소 길이는 1이고, 최대 길이 2048.  
Pattern: `^[A-Za-z0-9][A-Za-z0-9:_/+=,@.-]{0,2048}$`   
: 필수 아니요

 ** [NotificationChannel](#API_StartDocumentTextDetection_RequestSyntax) **   <a name="Textract-StartDocumentTextDetection-request-NotificationChannel"></a>
Amazon Textract가 작업의 완료 상태를 게시하도록 하려는 Amazon SNS 주제 ARN입니다.  
유형: [NotificationChannel](API_NotificationChannel.md) 객체  
: 필수 아니요

 ** [OutputConfig](#API_StartDocumentTextDetection_RequestSyntax) **   <a name="Textract-StartDocumentTextDetection-request-OutputConfig"></a>
출력이 고객 정의 버킷으로 이동할지 여부를 설정합니다. 기본적으로 Amazon Textract Textract는 GetDocumentTextDetection 작업을 통해 액세스할 수 있도록 결과를 내부적으로 저장합니다.  
유형: [OutputConfig](API_OutputConfig.md) 객체  
: 필수 아니요

## 응답 구문
<a name="API_StartDocumentTextDetection_ResponseSyntax"></a>

```
{
   "JobId": "string"
}
```

## 응답 요소
<a name="API_StartDocumentTextDetection_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 다시 전송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [JobId](#API_StartDocumentTextDetection_ResponseSyntax) **   <a name="Textract-StartDocumentTextDetection-response-JobId"></a>
문서에 대한 텍스트 검색 작업의 식별자입니다. 사용`JobId`후속 호출에서 작업을 식별합니다.`GetDocumentTextDetection`. A`JobId`값은 7일 동안만 유효합니다.  
Type: String  
길이 제약 조건: 최소 길이는 1이고, 최대 길이 64.  
Pattern: `^[a-zA-Z0-9-_]+$` 

## 오류
<a name="API_StartDocumentTextDetection_Errors"></a>

 ** AccessDeniedException **   
작업을 수행할 권한이 없습니다. 권한 있는 사용자 또는 IAM 역할의 Amazon 리소스 이름(ARN)을 사용하여 작업을 수행하십시오.  
HTTP 상태 코드: 400

 ** BadDocumentException **   
Amazon Textract Textract는 문서를 읽을 수 없습니다. Amazon Textract Textract의 문서 한도에 대한 자세한 내용은 단원을 참조하십시오.[Amazon Textract TEXTRACT에서의 하드 제한](limits.md).  
HTTP 상태 코드: 400

 ** DocumentTooLargeException **   
문서가 너무 크기 때문에 처리할 수 없습니다. 동기 작업의 최대 문서 크기 10MB. 비동기 작업의 최대 문서 크기는 PDF 파일의 경우 500MB입니다.  
HTTP 상태 코드: 400

 ** IdempotentParameterMismatchException **   
A`ClientRequestToken`입력 파라미터가 작업에서 재사용되었지만 하나 이상의 다른 입력 파라미터가 이전의 작업 호출과 다릅니다.  
HTTP 상태 코드: 400

 ** InternalServerError **   
Amazon Textract Textract에 서비스 문제가 발생했습니다. 호출을 다시 시도하십시오.  
HTTP 상태 코드: 500

 ** InvalidKMSKeyException **   
 KMS 키를 입력한 상태에서 암호 해독 권한이 없거나 KMS 키가 잘못 입력되었음을 나타냅니다.  
HTTP 상태 코드: 400

 ** InvalidParameterException **   
입력 파라미터가 제약 조건을 위반했습니다. 예를 들어, 동기 작업에서는`InvalidParameterException`예외가 발생하지 않을 때`S3Object`또는`Bytes`값은 다음 위치에 제공됩니다.`Document`요청 파라미터입니다. 파라미터를 확인한 다음 API 작업을 다시 호출하십시오.  
HTTP 상태 코드: 400

 ** InvalidS3ObjectException **   
Amazon Textract 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 Service 제한을 초과했습니다. 예를 들어 너무 많은 비동기 작업을 동시에 시작하면 시작 작업을 호출합니다 (`StartDocumentTextDetection`예를 들어) 을 발생시킬 경우에는 동시 실행 작업의 수가 Amazon Textract Service 제한 미만이 될 때까지 제한 Excepeption 예외 (HTTP 상태 코드: 400) 가 발생합니다.  
HTTP 상태 코드: 400

 ** ProvisionedThroughputExceededException **   
요청의 수가 처리량 한도를 초과했습니다. 이 한도를 늘려야 하는 경우 Amazon Textract Textract에 문의하십시오.  
HTTP 상태 코드: 400

 ** ThrottlingException **   
Amazon Textract Textract가 요청을 일시적으로 처리할 수 없습니다. 호출을 다시 시도하십시오.  
HTTP 상태 코드: 500

 ** UnsupportedDocumentException **   
입력 문서의 형식은 지원되지 않습니다. 작업 문서는 PNG, JPEG, PDF 또는 TIFF 형식일 수 있습니다.  
HTTP 상태 코드: 400

## 참고 항목
<a name="API_StartDocumentTextDetection_SeeAlso"></a>

이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.
+  [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/textract-2018-06-27/StartDocumentTextDetection) 
+  [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/textract-2018-06-27/StartDocumentTextDetection) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/StartDocumentTextDetection) 
+  [AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/StartDocumentTextDetection) 
+  [AWSSDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/StartDocumentTextDetection) 
+  [AWS SDK for JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/textract-2018-06-27/StartDocumentTextDetection) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/textract-2018-06-27/StartDocumentTextDetection) 
+  [AWSPython용 SDK](https://docs.aws.amazon.com/goto/boto3/textract-2018-06-27/StartDocumentTextDetection) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/StartDocumentTextDetection) 

# StartExpenseAnalysis
<a name="API_StartExpenseAnalysis"></a>

연락처 정보, 구매한 항목 및 공급업체 이름과 같은 데이터에 대한 송장 또는 영수증의 비동기 분석을 시작합니다.

 `StartExpenseAnalysis`에서는 JPEG, PNG 및 PDF 형식의 문서에서 텍스트를 분석할 수 있습니다. 문서는 Amazon S3 버킷에 저장되어야 합니다. 사용[DocumentLocation](API_DocumentLocation.md)파라미터를 사용하여 S3 버킷 이름과 해당 버킷에 있는 문서의 이름을 지정합니다.

 `StartExpenseAnalysis`작업 식별자를 반환합니다 (`JobId`) 귀하가 제공할 것`GetExpenseAnalysis`을 사용하여 작업 결과를 검색합니다. 입력 송장/영수증 분석이 완료되면 Amazon Textract 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).

## 요청 구문
<a name="API_StartExpenseAnalysis_RequestSyntax"></a>

```
{
   "ClientRequestToken": "string",
   "DocumentLocation": { 
      "S3Object": { 
         "Bucket": "string",
         "Name": "string",
         "Version": "string"
      }
   },
   "JobTag": "string",
   "KMSKeyId": "string",
   "NotificationChannel": { 
      "RoleArn": "string",
      "SNSTopicArn": "string"
   },
   "OutputConfig": { 
      "S3Bucket": "string",
      "S3Prefix": "string"
   }
}
```

## 요청 파라미터
<a name="API_StartExpenseAnalysis_RequestParameters"></a>

요청은 JSON 형식의 다음 데이터를 받습니다.

 ** [ClientRequestToken](#API_StartExpenseAnalysis_RequestSyntax) **   <a name="Textract-StartExpenseAnalysis-request-ClientRequestToken"></a>
시작 요청을 식별하는 데 사용되는 멱등성 토큰입니다. 동일한 토큰을 여러 개 사용하여 사용하는 경우`StartDocumentTextDetection`요청, 동일`JobId`가 반환됩니다. 사용`ClientRequestToken`같은 작업이 실수로 두 번 이상 시작되지 않도록 합니다. 자세한 내용은 단원을 참조하십시오.[Amazon Textract 비동기 작업 호출](https://docs.aws.amazon.com/textract/latest/dg/api-async.html)   
Type: String  
길이 제약 조건: 최소 길이는 1이고, 최대 길이 64.  
Pattern: `^[a-zA-Z0-9-_]+$`   
: 필수 아니요

 ** [DocumentLocation](#API_StartExpenseAnalysis_RequestSyntax) **   <a name="Textract-StartExpenseAnalysis-request-DocumentLocation"></a>
처리할 문서의 위치입니다.  
유형: [DocumentLocation](API_DocumentLocation.md) 객체  
: 필수 프로세스는 페이지 쓰기 후 세그먼트화된 가장 오래전에 사용된(SLRU) 데이터가 내구성 있는 스토리지에 도달할 때까지 기다리고 있습니다.

 ** [JobTag](#API_StartExpenseAnalysis_RequestSyntax) **   <a name="Textract-StartExpenseAnalysis-request-JobTag"></a>
지정한 식별자로, Amazon SNS 주제에 게시된 완료 알림에 포함됩니다. 예를 들어 를 사용할 수 있습니다.`JobTag`완료 통지가 해당하는 문서 유형 (예: 세금 양식 또는 영수증) 을 식별합니다.  
Type: String  
길이 제약 조건: 최소 길이는 1이고, 최대 길이 64.  
Pattern: `[a-zA-Z0-9_.\-:]+`   
: 필수 아니요

 ** [KMSKeyId](#API_StartExpenseAnalysis_RequestSyntax) **   <a name="Textract-StartExpenseAnalysis-request-KMSKeyId"></a>
추론 결과를 암호화하는 데 사용되는 KMS 키입니다. 키 ID 또는 키 별칭 형식일 수 있습니다. KMS 키가 제공되면 고객 버킷에 있는 객체의 서버 측 암호화에 KMS 키가 사용됩니다. 이 매개 변수를 활성화하지 않으면 결과는 SSE-S3 를 사용하여 서버 측에서 암호화됩니다.  
Type: String  
길이 제약 조건: 최소 길이는 1이고, 최대 길이 2048.  
Pattern: `^[A-Za-z0-9][A-Za-z0-9:_/+=,@.-]{0,2048}$`   
: 필수 아니요

 ** [NotificationChannel](#API_StartExpenseAnalysis_RequestSyntax) **   <a name="Textract-StartExpenseAnalysis-request-NotificationChannel"></a>
Amazon Textract가 작업의 완료 상태를 게시하도록 하려는 Amazon SNS 주제 ARN입니다.  
유형: [NotificationChannel](API_NotificationChannel.md) 객체  
: 필수 아니요

 ** [OutputConfig](#API_StartExpenseAnalysis_RequestSyntax) **   <a name="Textract-StartExpenseAnalysis-request-OutputConfig"></a>
출력이 고객 정의 버킷으로 이동할지 여부를 설정합니다. 기본적으로 Amazon Textract Textract는 다음에 액세스할 수 있도록 결과를 내부적으로 저장합니다.`GetExpenseAnalysis`작업.  
유형: [OutputConfig](API_OutputConfig.md) 객체  
: 필수 아니요

## 응답 구문
<a name="API_StartExpenseAnalysis_ResponseSyntax"></a>

```
{
   "JobId": "string"
}
```

## 응답 요소
<a name="API_StartExpenseAnalysis_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 다시 전송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [JobId](#API_StartExpenseAnalysis_ResponseSyntax) **   <a name="Textract-StartExpenseAnalysis-response-JobId"></a>
텍스트 검색 작업의 고유 식별자입니다. 이`JobId`에서 반환됩니다.`StartExpenseAnalysis`. A`JobId`값은 7일 동안만 유효합니다.  
Type: String  
길이 제약 조건: 최소 길이는 1이고, 최대 길이 64.  
Pattern: `^[a-zA-Z0-9-_]+$` 

## 오류
<a name="API_StartExpenseAnalysis_Errors"></a>

 ** AccessDeniedException **   
작업을 수행할 권한이 없습니다. 권한 있는 사용자 또는 IAM 역할의 Amazon 리소스 이름(ARN)을 사용하여 작업을 수행하십시오.  
HTTP 상태 코드: 400

 ** BadDocumentException **   
Amazon Textract Textract는 문서를 읽을 수 없습니다. Amazon Textract Textract의 문서 한도에 대한 자세한 내용은 단원을 참조하십시오.[Amazon Textract TEXTRACT에서의 하드 제한](limits.md).  
HTTP 상태 코드: 400

 ** DocumentTooLargeException **   
문서가 너무 크기 때문에 처리할 수 없습니다. 동기 작업의 최대 문서 크기입니다. 10MB입니다. 비동기 작업의 최대 문서 크기는 PDF 파일의 경우 500MB입니다.  
HTTP 상태 코드: 400

 ** IdempotentParameterMismatchException **   
A`ClientRequestToken`입력 파라미터가 작업에서 재사용되었지만 하나 이상의 다른 입력 파라미터가 이전의 작업 호출과 다릅니다.  
HTTP 상태 코드: 400

 ** InternalServerError **   
Amazon Textract Textract에 서비스 문제가 발생했습니다. 호출을 다시 시도하십시오.  
HTTP 상태 코드: 500

 ** InvalidKMSKeyException **   
 KMS 키를 입력한 상태에서 암호 해독 권한이 없거나 KMS 키가 잘못 입력되었음을 나타냅니다.  
HTTP 상태 코드: 400

 ** InvalidParameterException **   
입력 파라미터가 제약 조건을 위반했습니다. 예를 들어, 동기 작업에서는`InvalidParameterException`예외가 발생하지 않을 때`S3Object`또는`Bytes`값은 다음 위치에 제공됩니다.`Document`요청 파라미터를 지정합니다. 파라미터를 확인한 다음 API 작업을 다시 호출하십시오.  
HTTP 상태 코드: 400

 ** InvalidS3ObjectException **   
Amazon Textract 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`예를 들어) 을 발생시킬 경우에는 동시 실행 작업의 수가 Amazon Textract 서비스 제한 미만이 될 때까지 예외 (HTTP 상태 코드: 400) 가 발생합니다.  
HTTP 상태 코드: 400

 ** ProvisionedThroughputExceededException **   
요청의 수가 처리량 한도를 초과했습니다. 이 한도를 늘려야 하는 경우 Amazon Textract Textract에 문의하십시오.  
HTTP 상태 코드: 400

 ** ThrottlingException **   
Amazon Textract Textract가 요청을 일시적으로 처리할 수 없습니다. 호출을 다시 시도하십시오.  
HTTP 상태 코드: 500

 ** UnsupportedDocumentException **   
출력 문서의 형식은 지원되지 않습니다. 작업 문서는 PNG, JPEG, PDF 또는 TIFF 형식일 수 있습니다.  
HTTP 상태 코드: 400

## 참고 항목
<a name="API_StartExpenseAnalysis_SeeAlso"></a>

이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.
+  [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/textract-2018-06-27/StartExpenseAnalysis) 
+  [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/textract-2018-06-27/StartExpenseAnalysis) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/StartExpenseAnalysis) 
+  [AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/StartExpenseAnalysis) 
+  [AWSSDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/StartExpenseAnalysis) 
+  [AWS SDK for JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/textract-2018-06-27/StartExpenseAnalysis) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/textract-2018-06-27/StartExpenseAnalysis) 
+  [AWSPython용 SDK](https://docs.aws.amazon.com/goto/boto3/textract-2018-06-27/StartExpenseAnalysis) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/StartExpenseAnalysis) 