Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris. # GetDocumentAnalysis Mendapat hasil untuk operasi asinkron Amazon Texact yang menganalisis teks dalam dokumen. Anda memulai analisis teks asinkron dengan menelepon[StartDocumentAnalysis](API_StartDocumentAnalysis.md), yang mengembalikan pengenal pekerjaan (`JobId`). Ketika operasi analisis teks selesai, Amazon Textract menerbitkan status selesai untuk topik Amazon Simple Notification Service (Amazon SNS) yang terdaftar dalam panggilan awal untuk`StartDocumentAnalysis`. Untuk mendapatkan hasil operasi deteksi teks, periksa terlebih dahulu bahwa nilai status yang diterbitkan ke topik Amazon SNS adalah`SUCCEEDED`. Jika ya, hubungi`GetDocumentAnalysis`, dan lulus pengenal pekerjaan (`JobId`) dari panggilan awal ke`StartDocumentAnalysis`. `GetDocumentAnalysis`mengembalikan array[Block](API_Block.md)objek. Jenis informasi berikut ini dikembalikan: + Data formulir (pasangan nilai kunci). Informasi terkait dikembalikan dua[Block](API_Block.md)objek, masing-masing jenis`KEY_VALUE_SET`: KUNCI`Block`objek dan NILAI`Block`objek. Misalnya,*Nama: Ana Silva*berisi kunci dan nilai. *Nama:*adalah kuncinya. *Ana Silva*adalah nilai. + Tabel dan data sel tabel. TABEL`Block`objek berisi informasi tentang tabel terdeteksi. SEL`Block`objek dikembalikan untuk setiap sel dalam tabel. + Garis dan kata-kata teks. GARIS`Block`objek berisi satu atau lebih WORD`Block`objek. Semua baris dan kata-kata yang terdeteksi dalam dokumen dikembalikan (termasuk teks yang tidak memiliki hubungan dengan nilai`StartDocumentAnalysis` `FeatureTypes`parameter masukan). Elemen seleksi seperti kotak centang dan tombol opsi (tombol radio) dapat dideteksi dalam data formulir dan dalam tabel. SELECTION\$1ELEMENT`Block`objek berisi informasi tentang elemen seleksi, termasuk status seleksi. Gunakan`MaxResults`parameter untuk membatasi jumlah blok yang dikembalikan. Jika hasil yang didapatkan lebih banyak daripada yang ditentukan dalam `MaxResults`, nilai `NextToken` dalam respons operasi berisi token pemberian nomor halaman untuk mendapatkan serangkaian hasil berikutnya. Untuk mendapatkan halaman hasil berikutnya, hubungi`GetDocumentAnalysis`, dan mengisi`NextToken`parameter permintaan dengan nilai token yang dikembalikan dari panggilan sebelumnya ke`GetDocumentAnalysis`. Untuk informasi selengkapnya, lihat[Analisis Teks Dokumen](https://docs.aws.amazon.com/textract/latest/dg/how-it-works-analyzing.html). ## Sintaksis Permintaan ``` { "JobId": "string", "MaxResults": number, "NextToken": "string" } ``` ## Parameter Permintaan Permintaan menerima data berikut dalam format JSON. ** [JobId](#API_GetDocumentAnalysis_RequestSyntax) ** Pengenal unik untuk tugas deteksi teks. `JobId` dikembalikan dari `StartDocumentAnalysis`. SEBUAH`JobId`Nilai hanya berlaku selama 7 hari. Jenis: String Batasan: Panjang minimum 1. Panjang maksimum adalah 64. Pola: `^[a-zA-Z0-9-_]+$` Diperlukan: Ya ** [MaxResults](#API_GetDocumentAnalysis_RequestSyntax) ** Jumlah hasil maksimum untuk mengembalikan per panggilan yang diberi nomor halaman. Nilai terbesar yang dapat Anda tentukan adalah 1.000. Jika Anda menentukan nilai yang lebih besar dari 1.000, maksimum 1.000 hasil dikembalikan. Nilai default adalah 1,000. Jenis: Bulat Rentang yang Valid: Nilai minimum 1. Diperlukan: Tidak ** [NextToken](#API_GetDocumentAnalysis_RequestSyntax) ** Jika respons sebelumnya tidak lengkap (karena ada lebih banyak blok untuk diambil), Amazon Textract token pemberian nomor halaman sebagai responsnya. Anda dapat menggunakan token pemberian nomor halaman ini untuk mengambil set blok berikutnya. Jenis: String Batasan: Panjang minimum 1. Panjang maksimum 255. Pola: `.*\S.*` Diperlukan: Tidak ## Sintaksis Respons ``` { "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 ] } ] } ``` ## Elemen Respons Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200. Layanan mengembalikan data berikut dalam format JSON. ** [AnalyzeDocumentModelVersion](#API_GetDocumentAnalysis_ResponseSyntax) ** Jenis: String ** [Blocks](#API_GetDocumentAnalysis_ResponseSyntax) ** Hasil operasi teks-analisis. Jenis: Array[Block](API_Block.md)objek ** [DocumentMetadata](#API_GetDocumentAnalysis_ResponseSyntax) ** Informasi tentang dokumen yang diproses Amazon Textract Texact.`DocumentMetadata`dikembalikan di setiap halaman respons pemberian nomor halaman dari operasi Amazon Textract video. Tipe: Objek [DocumentMetadata](API_DocumentMetadata.md) ** [JobStatus](#API_GetDocumentAnalysis_ResponseSyntax) ** Status tugas deteksi teks. Jenis: Rangkaian Nilai Valid:` IN_PROGRESS | SUCCEEDED | FAILED | PARTIAL_SUCCESS` ** [NextToken](#API_GetDocumentAnalysis_ResponseSyntax) ** Jika respons terpotong, Amazon Textract mengembalikan token ini. Anda dapat menggunakan token ini dalam permintaan berikutnya untuk mengambil serangkaian hasil deteksi teks berikutnya. Jenis: String Batasan: Panjang minimum 1. Panjang maksimum 255. Pola: `.*\S.*` ** [StatusMessage](#API_GetDocumentAnalysis_ResponseSyntax) ** Pengembalian jika pekerjaan deteksi tidak dapat diselesaikan. Berisi penjelasan tentang kesalahan apa yang terjadi. Jenis: String ** [Warnings](#API_GetDocumentAnalysis_ResponseSyntax) ** Daftar peringatan yang terjadi selama operasi dokumen-analisis. Jenis: Array[Warning](API_Warning.md)objek ## Kesalahan ** 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 ** InternalServerError ** Amazon Textract Texact mengalami masalah layanan. Coba lagi panggilan Anda. Kode Status HTTP: 500 ** InvalidJobIdException ** Pengenal pekerjaan yang tidak valid diteruskan ke[GetDocumentAnalysis](#API_GetDocumentAnalysis)atau untuk[GetDocumentAnalysis](#API_GetDocumentAnalysis). Kode Status HTTP: 400 ** 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,`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 Texact tidak dapat mengakses objek S3 yang ditentukan dalam permintaan. untuk informasi selengkapnya,[Mengkonfigurasi 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 ** ProvisionedThroughputExceededException ** Jumlah permintaan melebihi batas throughput Anda. Jika Anda ingin meningkatkan batas ini, hubungi Amazon Textract. Kode Status HTTP: 400 ** ThrottlingException ** Amazon Textract Texact untuk sementara tidak dapat memproses permintaan. Coba lagi panggilan Anda. Kode Status HTTP: 500 ## Lihat Juga Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khususAWSSDK, lihat yang berikut ini: + [AWSAntarmuka Baris Perintah](https://docs.aws.amazon.com/goto/aws-cli/textract-2018-06-27/GetDocumentAnalysis) + [AWSSDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/textract-2018-06-27/GetDocumentAnalysis) + [AWSSDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/GetDocumentAnalysis) + [AWSSDK 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) + [AWSSDK for JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/textract-2018-06-27/GetDocumentAnalysis) + [AWSSDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/textract-2018-06-27/GetDocumentAnalysis) + [AWSSDK for Python](https://docs.aws.amazon.com/goto/boto3/textract-2018-06-27/GetDocumentAnalysis) + [AWSSDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/GetDocumentAnalysis)