Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

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

Memulai analisis asinkron faktur atau tanda terima untuk data seperti informasi kontak, item yang dibeli, dan nama vendor.

 `StartExpenseAnalysis`dapat menganalisis teks dalam dokumen yang dalam format JPEG, PNG, dan PDF. Dokumen harus disimpan di bucket Amazon S3. Gunakan[DocumentLocation](API_DocumentLocation.md)parameter untuk menentukan nama bucket S3 Anda dan nama dokumen dalam ember itu. 

 `StartExpenseAnalysis`mengembalikan pengenal pekerjaan (`JobId`) yang akan Anda berikan`GetExpenseAnalysis`untuk mengambil hasil operasi. Ketika analisis faktur input/tanda terima selesai, Amazon Textract menerbitkan status penyelesaian ke topik Amazon Simple Notification Service (Amazon SNS) yang Anda berikan kepada`NotificationChannel`. Untuk mendapatkan hasil operasi analisis faktur dan penerimaan, pastikan bahwa nilai status yang diterbitkan ke topik Amazon SNS adalah`SUCCEEDED`. Jika ya, hubungi[GetExpenseAnalysis](API_GetExpenseAnalysis.md), dan lulus pengenal pekerjaan (`JobId`) yang dikembalikan oleh panggilan Anda ke`StartExpenseAnalysis`.

Untuk informasi selengkapnya, lihat[Menganalisis Faktur dan Penerimaan](https://docs.aws.amazon.com/textract/latest/dg/invoice-receipts.html).

## Sintaksis Permintaan
<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"
   }
}
```

## Parameter Permintaan
<a name="API_StartExpenseAnalysis_RequestParameters"></a>

Permintaan menerima data berikut dalam format JSON.

 ** [ClientRequestToken](#API_StartExpenseAnalysis_RequestSyntax) **   <a name="Textract-StartExpenseAnalysis-request-ClientRequestToken"></a>
Token idempotensi yang digunakan untuk mengidentifikasi permintaan mulai. Jika Anda menggunakan token yang sama dengan beberapa permintaan `StartDocumentTextDetection`, `JobId` yang sama dikembalikan. Gunakan`ClientRequestToken`untuk mencegah agar tidak ada tugas yang sama yang dimulai lebih dari sekali. Untuk informasi selengkapnya, lihat[Memanggil Operasi Asinkron Amazon Texact](https://docs.aws.amazon.com/textract/latest/dg/api-async.html)   
Jenis: String  
Batasan: Panjang minimum 1. Panjang maksimum adalah 64.  
Pola: `^[a-zA-Z0-9-_]+$`   
Diperlukan: Tidak

 ** [DocumentLocation](#API_StartExpenseAnalysis_RequestSyntax) **   <a name="Textract-StartExpenseAnalysis-request-DocumentLocation"></a>
Lokasi dokumen yang akan diproses.  
Tipe: Objek [DocumentLocation](API_DocumentLocation.md)  
Diperlukan: Ya

 ** [JobTag](#API_StartExpenseAnalysis_RequestSyntax) **   <a name="Textract-StartExpenseAnalysis-request-JobTag"></a>
Pengidentifikasi yang Anda tentukan yang disertakan dalam notifikasi penyelesaian yang diterbitkan ke topik Amazon SNS. Misalnya, Anda dapat menggunakan`JobTag`untuk mengidentifikasi jenis dokumen yang sesuai dengan pemberitahuan penyelesaian (seperti formulir pajak atau tanda terima).  
Jenis: String  
Batasan: Panjang minimum 1. Panjang maksimum adalah 64.  
Pola: `[a-zA-Z0-9_.\-:]+`   
Diperlukan: Tidak

 ** [KMSKeyId](#API_StartExpenseAnalysis_RequestSyntax) **   <a name="Textract-StartExpenseAnalysis-request-KMSKeyId"></a>
Kunci KMS yang digunakan untuk mengenkripsi hasil kesimpulan. Hal ini dapat baik dalam Key ID atau Key Alias format. Ketika kunci KMS disediakan, kunci KMS akan digunakan untuk enkripsi sisi server dari objek dalam ember pelanggan. Ketika parameter ini tidak diaktifkan, hasilnya akan dienkripsi sisi server, menggunakan SSE-S3.  
Jenis: String  
Batasan: Panjang minimum 1. Panjang maksimum 2048.  
Pola: `^[A-Za-z0-9][A-Za-z0-9:_/+=,@.-]{0,2048}$`   
Diperlukan: Tidak

 ** [NotificationChannel](#API_StartExpenseAnalysis_RequestSyntax) **   <a name="Textract-StartExpenseAnalysis-request-NotificationChannel"></a>
ARN topik Amazon SNS yang Anda inginkan Amazon Textract mempublikasikan status penyelesaian operasi.   
Tipe: Objek [NotificationChannel](API_NotificationChannel.md)  
Diperlukan: Tidak

 ** [OutputConfig](#API_StartExpenseAnalysis_RequestSyntax) **   <a name="Textract-StartExpenseAnalysis-request-OutputConfig"></a>
Set jika output akan pergi ke ember pelanggan didefinisikan. Secara default, Amazon Textract akan menyimpan hasil secara internal untuk diakses oleh`GetExpenseAnalysis`operasi.  
Tipe: Objek [OutputConfig](API_OutputConfig.md)  
Diperlukan: Tidak

## Sintaksis Respons
<a name="API_StartExpenseAnalysis_ResponseSyntax"></a>

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

## Elemen Respons
<a name="API_StartExpenseAnalysis_ResponseElements"></a>

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [JobId](#API_StartExpenseAnalysis_ResponseSyntax) **   <a name="Textract-StartExpenseAnalysis-response-JobId"></a>
Pengidentifikasi unik untuk tugas deteksi teks. `JobId` dikembalikan dari `StartExpenseAnalysis`. SEBUAH`JobId`Nilai hanya berlaku selama 7 hari.  
Jenis: String  
Batasan: Panjang minimum 1. Panjang maksimum adalah 64.  
Pola: `^[a-zA-Z0-9-_]+$` 

## Kesalahan
<a name="API_StartExpenseAnalysis_Errors"></a>

 ** AccessDeniedException **   
Anda tidak berwenang untuk melakukan tindakan. Gunakan Amazon Resource Name (ARN) dari pengguna resmi atau IAM role untuk melakukan operasi.  
Kode Status HTTP: 400

 ** BadDocumentException **   
Amazon Textract tidak dapat membaca dokumen. Untuk informasi selengkapnya tentang batas dokumen di Amazon Textract, lihat[Batas Keras di Amazon Textract](limits.md).  
Kode Status HTTP: 400

 ** DocumentTooLargeException **   
Dokumen tidak dapat diproses karena terlalu besar. Ukuran dokumen maksimum untuk operasi sinkron 10 MB. Ukuran dokumen maksimum untuk operasi asinkron adalah 500 MB untuk file PDF.  
Kode Status HTTP: 400

 ** IdempotentParameterMismatchException **   
Parameter input `ClientRequestToken` digunakan kembali dengan suatu operasi, tapi setidaknya salah satu parameter input lainnya berbeda dari panggilan ke operasi sebelumnya.   
Kode Status HTTP: 400

 ** InternalServerError **   
Amazon Textract mengalami masalah layanan. Coba lagi panggilan Anda.  
Kode Status HTTP: 500

 ** InvalidKMSKeyException **   
 Menunjukkan bahwa Anda tidak memiliki izin mendekripsi dengan kunci KMS yang dimasukkan, atau kunci KMS dimasukkan secara tidak benar.   
Kode Status HTTP: 400

 ** InvalidParameterException **   
Parameter input melanggar batasan. Misalnya, dalam operasi sinkron, sebuah`InvalidParameterException`pengecualian terjadi ketika salah satu`S3Object`atau`Bytes`nilai-nilai yang disediakan dalam`Document`parameter permintaan. Validasi parameter Anda sebelum memanggil operasi API lagi.  
Kode Status HTTP: 400

 ** InvalidS3ObjectException **   
Amazon Textract tidak dapat mengakses objek S3 yang ditentukan dalam permintaan. untuk informasi selengkapnya,[Mengonfigurasi Akses ke Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html)Untuk informasi pemecahan masalah, lihat[Pemecahan Masalah Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/dev/troubleshooting.html)   
Kode Status HTTP: 400

 ** LimitExceededException **   
Batas layanan Amazon Textract terlampaui. Misalnya, jika Anda memulai terlalu banyak pekerjaan asinkron secara bersamaan, panggilan untuk memulai operasi (`StartDocumentTextDetection`, misalnya) menaikkan pengecualian LimitExceededException (kode status HTTP: 400) hingga jumlah tugas yang berjalan bersamaan di bawah batas layanan Amazon Textract TExceededException.   
Kode Status HTTP: 400

 ** ProvisionedThroughputExceededException **   
Jumlah permintaan melebihi batas throughput Anda. Jika Anda ingin meningkatkan batas ini, hubungi Amazon Textract.  
Kode Status HTTP: 400

 ** ThrottlingException **   
Amazon Textract untuk sementara tidak dapat memproses permintaan. Coba lagi panggilan Anda.  
Kode Status HTTP: 500

 ** UnsupportedDocumentException **   
Format dokumen input tidak didukung. Dokumen untuk operasi dapat dalam format PNG, JPEG, PDF, atau TIFF.  
Kode Status HTTP: 400

## Lihat Juga
<a name="API_StartExpenseAnalysis_SeeAlso"></a>

Untuk informasi selengkapnya tentang penggunaan API di salah satu bahasaAWSSDK, lihat yang berikut ini:
+  [AWSAntarmuka Baris Perintah](https://docs.aws.amazon.com/goto/aws-cli/textract-2018-06-27/StartExpenseAnalysis) 
+  [AWSSDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/textract-2018-06-27/StartExpenseAnalysis) 
+  [AWSSDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/StartExpenseAnalysis) 
+  [AWSSDK 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) 
+  [AWSSDK for JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/textract-2018-06-27/StartExpenseAnalysis) 
+  [AWSSDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/textract-2018-06-27/StartExpenseAnalysis) 
+  [AWSSDK for Python](https://docs.aws.amazon.com/goto/boto3/textract-2018-06-27/StartExpenseAnalysis) 
+  [AWSSDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/StartExpenseAnalysis)