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

# 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)