翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

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

アイデンティティドキュメントを分析し、関連情報を確認します。この情報は抽出され、次のように返されます。`IdentityDocumentFields`。抽出されたテキストの正規化されたフィールドと値の両方を記録します。他の Amazon Textract オペレーションとは異なり、`AnalyzeID`は Geometry データを返しません。

## リクエストの構文
<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>
AnalyzeID に渡されるドキュメント。  
Type: 配列の[Document](API_Document.md)オブジェクト  
配列メンバー: 最小数は 1 項目です。最大数は 2 項目です。  
必須 はい

## レスポンスの構文
<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>
ドキュメントの処理に使用されている AnalyzeIdentity API のバージョン。  
Type: 文字列

 ** [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 はドキュメントを読み取ることができません。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

## 以下の資料も参照してください。
<a name="API_AnalyzeID_SeeAlso"></a>

言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、次を参照してください：
+  [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) 
+  [AWS SDK for Python](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)