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

# ExportJournalToS3
<a name="API_ExportJournalToS3"></a>

Mengekspor konten jurnal dalam rentang tanggal dan waktu dari buku besar ke bucket Amazon Simple Storage Service (Amazon S3) tertentu. Pekerjaan ekspor jurnal dapat menulis objek data baik dalam teks atau representasi biner format Amazon Ion, atau dalam format teks *JSON Lines*.

Jika buku besar dengan yang diberikan `Name` tidak ada, maka lempar`ResourceNotFoundException`.

Jika buku besar dengan yang `Name` diberikan dalam `CREATING` status, maka lempar`ResourcePreconditionNotMetException`.

Anda dapat memulai hingga dua permintaan ekspor jurnal bersamaan untuk setiap buku besar. Di luar batas ini, permintaan ekspor jurnal melempar`LimitExceededException`.

## Minta Sintaks
<a name="API_ExportJournalToS3_RequestSyntax"></a>

```
POST /ledgers/name/journal-s3-exports HTTP/1.1
Content-type: application/json

{
   "ExclusiveEndTime": number,
   "InclusiveStartTime": number,
   "OutputFormat": "string",
   "RoleArn": "string",
   "S3ExportConfiguration": { 
      "Bucket": "string",
      "EncryptionConfiguration": { 
         "KmsKeyArn": "string",
         "ObjectEncryptionType": "string"
      },
      "Prefix": "string"
   }
}
```

## Parameter Permintaan URI
<a name="API_ExportJournalToS3_RequestParameters"></a>

Permintaan menggunakan parameter URI berikut.

 ** [name](#API_ExportJournalToS3_RequestSyntax) **   <a name="qldb-ExportJournalToS3-request-uri-Name"></a>
Nama buku besar.  
Batasan Panjang: Panjang minimum 1. Panjang maksimum 32.  
Pola: `(?!^.*--)(?!^[0-9]+$)(?!^-)(?!.*-$)^[A-Za-z0-9-]+$`   
Wajib: Ya

## Isi Permintaan
<a name="API_ExportJournalToS3_RequestBody"></a>

Permintaan menerima data berikut dalam format JSON.

 ** [ExclusiveEndTime](#API_ExportJournalToS3_RequestSyntax) **   <a name="qldb-ExportJournalToS3-request-ExclusiveEndTime"></a>
Tanggal dan waktu akhir eksklusif untuk berbagai konten jurnal untuk diekspor.  
`ExclusiveEndTime` harus berada dalam format tanggal dan waktu `ISO 8601` dan dalam Waktu Terkoordinasi Universal (UTC). Sebagai contoh: `2019-06-13T21:36:34Z`.  
`ExclusiveEndTime`Harus kurang dari atau sama dengan tanggal dan waktu UTC saat ini.  
Tipe: Timestamp  
Wajib: Ya

 ** [InclusiveStartTime](#API_ExportJournalToS3_RequestSyntax) **   <a name="qldb-ExportJournalToS3-request-InclusiveStartTime"></a>
Tanggal dan waktu mulai inklusif untuk berbagai konten jurnal untuk diekspor.  
`InclusiveStartTime` harus berada dalam format tanggal dan waktu `ISO 8601` dan dalam Waktu Terkoordinasi Universal (UTC). Sebagai contoh: `2019-06-13T21:36:34Z`.  
`InclusiveStartTime`Harus sebelumnya`ExclusiveEndTime`.  
Jika Anda memberikan `InclusiveStartTime` yang sebelum buku besar`CreationDateTime`, Amazon QLDB mendefaultkannya ke buku besar. `CreationDateTime`  
Tipe: Timestamp  
Wajib: Ya

 ** [OutputFormat](#API_ExportJournalToS3_RequestSyntax) **   <a name="qldb-ExportJournalToS3-request-OutputFormat"></a>
Format output dari data jurnal yang diekspor. Pekerjaan ekspor jurnal dapat menulis objek data baik dalam teks atau representasi biner format [Amazon Ion](https://docs.aws.amazon.com/qldb/latest/developerguide/ion.html), atau dalam format teks [JSON Lines](https://jsonlines.org/).  
Default: `ION_TEXT`   
Dalam format JSON Lines, setiap blok jurnal dalam objek data yang diekspor adalah objek JSON yang valid yang dibatasi oleh baris baru. Anda dapat menggunakan format ini untuk mengintegrasikan ekspor JSON secara langsung dengan alat analitik seperti Amazon Athena AWS Glue dan karena layanan ini dapat mengurai JSON yang dibatasi baris baru secara otomatis.  
Tipe: String  
Nilai yang Valid: `ION_BINARY | ION_TEXT | JSON`   
Wajib: Tidak

 ** [RoleArn](#API_ExportJournalToS3_RequestSyntax) **   <a name="qldb-ExportJournalToS3-request-RoleArn"></a>
Nama Sumber Daya Amazon (ARN) dari peran IAM yang memberikan izin QLDB untuk pekerjaan ekspor jurnal untuk melakukan hal berikut:  
+ Tulis objek ke dalam ember Amazon S3 Anda.
+ (Opsional) Gunakan kunci terkelola pelanggan Anda di AWS Key Management Service (AWS KMS) untuk enkripsi sisi server dari data yang Anda ekspor.
Untuk meneruskan peran ke QLDB saat meminta ekspor jurnal, Anda harus memiliki izin untuk melakukan `iam:PassRole` tindakan pada sumber daya peran IAM. Ini diperlukan untuk semua permintaan ekspor jurnal.  
Tipe: String  
Batasan Panjang: Panjang minimum 20. Panjang maksimum 1600.  
Wajib: Ya

 ** [S3ExportConfiguration](#API_ExportJournalToS3_RequestSyntax) **   <a name="qldb-ExportJournalToS3-request-S3ExportConfiguration"></a>
Pengaturan konfigurasi tujuan bucket Amazon S3 untuk permintaan ekspor Anda.  
Tipe: Objek [S3ExportConfiguration](API_S3ExportConfiguration.md)  
Wajib: Ya

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

```
HTTP/1.1 200
Content-type: application/json

{
   "ExportId": "string"
}
```

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

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [ExportId](#API_ExportJournalToS3_ResponseSyntax) **   <a name="qldb-ExportJournalToS3-response-ExportId"></a>
UUID (diwakili dalam teks yang disandikan Base62) yang diberikan QLDB untuk setiap pekerjaan ekspor jurnal.  
Untuk menjelaskan permintaan ekspor Anda dan memeriksa status pekerjaan, Anda dapat menggunakan `ExportId` untuk menelepon`DescribeJournalS3Export`.  
Tipe: String  
Kendala Panjang: Panjang tetap 22.  
Pola: `^[A-Za-z-0-9]+$` 

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

Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat [Kesalahan Umum](CommonErrors.md).

 ** ResourceNotFoundException **   
Sumber daya yang ditentukan tidak ada.  
Kode Status HTTP: 404

 ** ResourcePreconditionNotMetException **   
Operasi gagal karena kondisi tidak terpenuhi sebelumnya.  
Kode Status HTTP: 412

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

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS Antarmuka Baris Perintah](https://docs.aws.amazon.com/goto/aws-cli/qldb-2019-01-02/ExportJournalToS3) 
+  [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/qldb-2019-01-02/ExportJournalToS3) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/qldb-2019-01-02/ExportJournalToS3) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/qldb-2019-01-02/ExportJournalToS3) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/qldb-2019-01-02/ExportJournalToS3) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/qldb-2019-01-02/ExportJournalToS3) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/qldb-2019-01-02/ExportJournalToS3) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/qldb-2019-01-02/ExportJournalToS3) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/qldb-2019-01-02/ExportJournalToS3) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/qldb-2019-01-02/ExportJournalToS3)