

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

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

Ruft die Ergebnisse für einen asynchronen Amazon Textract Textract-Vorgang ab, der Rechnungen und Belege analysiert. Amazon Textract findet Kontaktinformationen, gekaufte Artikel und den Namen des Lieferanten aus Eingaberechnungen und Quittungen.

Sie starten die asynchrone Rechnungs-/Beleganalyse, indem Sie anrufen[StartExpenseAnalysis](API_StartExpenseAnalysis.md), die eine Job-ID zurückgibt (`JobId`) enthalten. Nach Abschluss der Rechnungs-/Belegungsanalyse veröffentlicht Amazon Textract den Erledigungsstatus im Amazon Simple Notification Service (Amazon SNS) -Thema. Dieses Thema muss im ersten Aufruf von`StartExpenseAnalysis`aus. Um die Ergebnisse des Rechnungs-/Beleganalysevorgangs zu erhalten, stellen Sie zunächst sicher, dass der für das Amazon SNS-Thema veröffentlichte Status Wert lautet`SUCCEEDED`aus. Wenn ja, ruf an`GetExpenseAnalysis`und übergeben Sie die Job-ID (`JobId`) vom ersten Anruf an`StartExpenseAnalysis`aus.

Verwenden Sie den MaxResults-Parameter, um die Anzahl der zurückgegebenen Blöcke einzuschränken. Wenn es mehr Ergebnisse gibt als angegeben in`MaxResults`, der Wert von`NextToken`In der Operationsantwort enthält ein Paginierungs-Token für den Abruf des nächsten Ergebnissatzes. Um die nächste Ergebnisseite abzurufen, rufen Sie`GetExpenseAnalysis`und bevölkern Sie das`NextToken`Anforderungsparameter mit dem Token-Wert, der vom vorherigen Aufruf an`GetExpenseAnalysis`aus.

Weitere Informationen finden Sie unter[Rechnungen und Belege analysieren](https://docs.aws.amazon.com/textract/latest/dg/invoices-receipts.html)aus.

## Anforderungssyntax
<a name="API_GetExpenseAnalysis_RequestSyntax"></a>

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

## Anfrageparameter
<a name="API_GetExpenseAnalysis_RequestParameters"></a>

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

 ** [JobId](#API_GetExpenseAnalysis_RequestSyntax) **   <a name="Textract-GetExpenseAnalysis-request-JobId"></a>
Ein eindeutiger Bezeichner für den Texterkennungsauftrag. Die`JobId`wird zurückgegeben`StartExpenseAnalysis`aus. EIN`JobId`Wert ist nur 7 Tage lang gültig.  
Type: String (Zeichenfolge)  
Längenbeschränkungen: Mindestlänge 1. Höchstlänge = 64 Zeichen.  
Pattern: `^[a-zA-Z0-9-_]+$`   
Erforderlich: Ja

 ** [MaxResults](#API_GetExpenseAnalysis_RequestSyntax) **   <a name="Textract-GetExpenseAnalysis-request-MaxResults"></a>
Die maximale Anzahl der Ergebnisse, die pro paginierten Aufruf zurückgegeben werden sollen. Der größte Wert, den Sie angeben können, ist 20. Wenn Sie einen Wert größer als 20 angeben, werden maximal 20 Ergebnisse zurückgegeben. Der Standardwert ist 20.  
Type: Ganzzahl  
Gültiger Bereich: Der Mindestwert ist 1.  
Erforderlich: Nein

 ** [NextToken](#API_GetExpenseAnalysis_RequestSyntax) **   <a name="Textract-GetExpenseAnalysis-request-NextToken"></a>
Wenn die vorherige Antwort unvollständig war (da mehr Blöcke abgerufen werden müssen), gibt Amazon Textract ein Paginierungstoken in der Antwort zurück. Sie können dieses Paginierungs-Token verwenden, um den nächsten Satz von Blöcken abzurufen.  
Type: String (Zeichenfolge)  
Längenbeschränkungen: Mindestlänge 1. Höchstlänge = 255 Zeichen.  
Pattern: `.*\S.*`   
Erforderlich: Nein

## Antwortsyntax
<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 ]
      }
   ]
}
```

## Antwortelemente
<a name="API_GetExpenseAnalysis_ResponseElements"></a>

Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP 200-Antwort zurück.

Die folgenden Daten werden vom Service im JSON-Format zurückgegeben.

 ** [AnalyzeExpenseModelVersion](#API_GetExpenseAnalysis_ResponseSyntax) **   <a name="Textract-GetExpenseAnalysis-response-AnalyzeExpenseModelVersion"></a>
Die aktuelle Modellversion von AnalyzeExpense.  
Type: String (Zeichenfolge)

 ** [DocumentMetadata](#API_GetExpenseAnalysis_ResponseSyntax) **   <a name="Textract-GetExpenseAnalysis-response-DocumentMetadata"></a>
Informationen über ein Dokument, das Amazon Textract verarbeitet hat.`DocumentMetadata`wird auf jeder Seite mit paginierten Antworten eines Amazon Textract Textract-Vorgangs zurückgegeben.  
Typ: [DocumentMetadata](API_DocumentMetadata.md) Objekt

 ** [ExpenseDocuments](#API_GetExpenseAnalysis_ResponseSyntax) **   <a name="Textract-GetExpenseAnalysis-response-ExpenseDocuments"></a>
Die von Amazon Textract festgestellten Kosten.  
Type: Array-Anordnung[ExpenseDocument](API_ExpenseDocument.md)Objekte

 ** [JobStatus](#API_GetExpenseAnalysis_ResponseSyntax) **   <a name="Textract-GetExpenseAnalysis-response-JobStatus"></a>
Der aktuelle Status des Texterkennungsauftrags.  
Type: String (Zeichenfolge)  
Zulässige Werte:` IN_PROGRESS | SUCCEEDED | FAILED | PARTIAL_SUCCESS` 

 ** [NextToken](#API_GetExpenseAnalysis_ResponseSyntax) **   <a name="Textract-GetExpenseAnalysis-response-NextToken"></a>
Wenn die Antwort abgeschnitten wird, gibt Amazon Textract dieses Token zurück. Sie können dieses Token in der nachfolgenden Anforderung verwenden, um den nächsten Satz von Ergebnissen zur Texterkennung abzurufen.  
Type: String (Zeichenfolge)  
Längenbeschränkungen: Mindestlänge 1. Höchstlänge = 255 Zeichen.  
Pattern: `.*\S.*` 

 ** [StatusMessage](#API_GetExpenseAnalysis_ResponseSyntax) **   <a name="Textract-GetExpenseAnalysis-response-StatusMessage"></a>
Gibt zurück, wenn der Erkennungsauftrag nicht abgeschlossen werden konnte. Enthält eine Erklärung dafür, welcher Fehler aufgetreten ist.   
Type: String (Zeichenfolge)

 ** [Warnings](#API_GetExpenseAnalysis_ResponseSyntax) **   <a name="Textract-GetExpenseAnalysis-response-Warnings"></a>
Eine Liste der Warnungen, die während des Texterkennungsvorgangs für das Dokument aufgetreten sind.  
Type: Array-Anordnung[Warning](API_Warning.md)Objekte

## Fehler
<a name="API_GetExpenseAnalysis_Errors"></a>

 ** AccessDeniedException **   
Sie sind nicht berechtigt, die Aktion auszuführen. Verwenden Sie den Amazon-Ressourcennamen (ARN) der IAM-Rolle oder eines autorisierten Benutzers, um den Vorgang auszuführen.  
HTTP-Statuscode: 400

 ** InternalServerError **   
Amazon Textract hat ein Service-Problem festgestellt. Wiederholen Sie den Aufruf.  
HTTP-Statuscode: 500

 ** InvalidJobIdException **   
Eine ungültige Job-ID wurde übergeben an[GetDocumentAnalysis](API_GetDocumentAnalysis.md)oder zu[GetDocumentAnalysis](API_GetDocumentAnalysis.md)aus.  
HTTP-Statuscode: 400

 ** InvalidKMSKeyException **   
 Zeigt an, dass Sie keine Entschlüsselungsberechtigungen mit dem eingegebenen KMS-Schlüssel haben oder der KMS-Schlüssel falsch eingegeben wurde.   
HTTP-Statuscode: 400

 ** InvalidParameterException **   
Ein Eingabeparameter verletzt eine Beschränkung. Zum Beispiel wird bei synchronen Operationen ein`InvalidParameterException`Ausnahme tritt auf, wenn keiner der`S3Object`oder`Bytes`Werte werden im`Document`Anforderungsparameter. Validieren Sie den Parameter, bevor Sie den API-Vorgang erneut aufrufen.  
HTTP-Statuscode: 400

 ** InvalidS3ObjectException **   
Amazon Textract kann auf das in der Anforderung angegebene S3-Objekt nicht zugreifen. für weitere Informationen,[Konfigurieren des Zugriffs auf Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html)Informationen zur Problembehebung finden Sie unter[Fehlerbehebung für Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/dev/troubleshooting.html)   
HTTP-Statuscode: 400

 ** ProvisionedThroughputExceededException **   
Die Anzahl der Anforderungen hat das Durchsatzlimit überschritten. Wenn Sie dieses Limit erhöhen müssen, wenden Sie sich an Amazon Textract.  
HTTP-Statuscode: 400

 ** ThrottlingException **   
Amazon Textract kann die Anforderung vorübergehend nicht verarbeiten. Wiederholen Sie den Aufruf.  
HTTP-Statuscode: 500

## Weitere Informationen finden Sie unter:
<a name="API_GetExpenseAnalysis_SeeAlso"></a>

Weitere Informationen zur Verwendung dieser API in einem der sprachspezifischen AWS-SDKs finden Sie unter:
+  [AWS-Befehlszeilenschnittstelle](https://docs.aws.amazon.com/goto/aws-cli/textract-2018-06-27/GetExpenseAnalysis) 
+  [AWS-SDK für .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/textract-2018-06-27/GetExpenseAnalysis) 
+  [AWS-SDK für 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 für JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/textract-2018-06-27/GetExpenseAnalysis) 
+  [AWS SDK für PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/textract-2018-06-27/GetExpenseAnalysis) 
+  [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/textract-2018-06-27/GetExpenseAnalysis) 
+  [AWS SDK für Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/GetExpenseAnalysis) 