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

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

日時範囲内のジャーナルコンテンツを、台帳から指定先の Amazon Simple Storage Service (Amazon S3) バケットにエクスポートします。ジャーナルエクスポートジョブは、Amazon Ion 形式のテキストまたはバイナリ表現、または JSON Lines テキスト形式でデータオブジェクトを書き込むことができます。

指定された `Name` を持つ台帳が存在しない場合は、`ResourceNotFoundException` をスローします。

指定された `Name` を持つ台帳が `CREATING` ステータスの場合は、`ResourcePreconditionNotMetException` をスローします。

各台帳に対して最大 2 つの同時ジャーナルエクスポートリクエストを開始できます。この制限を超えると、ジャーナルエクスポートリクエストで `LimitExceededException` がスローされます。

## リクエストの構文
<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"
   }
}
```

## URI リクエストパラメータ
<a name="API_ExportJournalToS3_RequestParameters"></a>

リクエストでは、次の URI パラメータを使用します。

 ** [name](#API_ExportJournalToS3_RequestSyntax) **   <a name="qldb-ExportJournalToS3-request-uri-Name"></a>
台帳の名前。  
長さの制限：最小長 1、最大長は 32 です。  
パターン: `(?!^.*--)(?!^[0-9]+$)(?!^-)(?!.*-$)^[A-Za-z0-9-]+$`   
必須: はい

## リクエストボディ
<a name="API_ExportJournalToS3_RequestBody"></a>

リクエストは以下の JSON 形式のデータを受け入れます。

 ** [ExclusiveEndTime](#API_ExportJournalToS3_RequestSyntax) **   <a name="qldb-ExportJournalToS3-request-ExclusiveEndTime"></a>
エクスポートするジャーナルコンテンツの範囲の終了日時 (この日時は含まれません)。  
`ExclusiveEndTime` は、`ISO 8601` の日付と時刻の形式および協定世界時 (UTC) である必要があります。例: `2019-06-13T21:36:34Z`。  
`ExclusiveEndTime` は、協定世界時 (UTC) における現在の日時よりも前の時刻にしてください。  
タイプ: タイムスタンプ  
必須: はい

 ** [InclusiveStartTime](#API_ExportJournalToS3_RequestSyntax) **   <a name="qldb-ExportJournalToS3-request-InclusiveStartTime"></a>
エクスポートするジャーナルコンテンツの範囲の開始日時 (この日時は含まれます)。  
`InclusiveStartTime` は、`ISO 8601` の日付と時刻の形式および協定世界時 (UTC) である必要があります。例: `2019-06-13T21:36:34Z`。  
`InclusiveStartTime` は `ExclusiveEndTime` より前の日時にする必要があります。  
台帳の `CreationDateTime` より前の `InclusiveStartTime` を指定した場合、Amazon QLDB のデフォルトは台帳の `CreationDateTime` になります。  
タイプ: タイムスタンプ  
必須: はい

 ** [OutputFormat](#API_ExportJournalToS3_RequestSyntax) **   <a name="qldb-ExportJournalToS3-request-OutputFormat"></a>
エクスポートするジャーナルデータの出力形式。ジャーナルエクスポートジョブは、[Amazon Ion](https://docs.aws.amazon.com/qldb/latest/developerguide/ion.html) 形式のテキストまたはバイナリ表現、または [JSON Lines](https://jsonlines.org/) テキスト形式でデータオブジェクトを書き込むことができます。  
デフォルト: `ION_TEXT`   
JSON Lines 形式では、エクスポートされたデータオブジェクト内の各ジャーナルブロックは、改行で区切られた有効な JSON オブジェクトです。これらのサービスは改行区切りのJSON を自動的に解析できるため、この形式を使用して、JSON エクスポートを Amazon Athena や AWS Glue などの分析ツールと直接統合できます。  
型: 文字列  
有効な値：`ION_BINARY | ION_TEXT | JSON`  
必須：いいえ

 ** [RoleArn](#API_ExportJournalToS3_RequestSyntax) **   <a name="qldb-ExportJournalToS3-request-RoleArn"></a>
次のことを実行するジャーナルエクスポートジョブに対する QLDB アクセス許可を付与する IAM ロールの Amazon リソースネーム (ARN)。  
+ Amazon S3 バケットにオブジェクトを書き込みます。
+ （オプション) ( AWS Key Management Service AWS KMS) のカスタマーマネージドキーを使用して、エクスポートされたデータのサーバー側の暗号化を行います。
ジャーナルエクスポートをリクエストするときに QLDB にロールを渡すには、IAM ロールリソースで `iam:PassRole` アクションを実行するためのアクセス許可が必要です。これはすべてのジャーナルエクスポートリクエストに必要です。  
タイプ: 文字列  
長さの制限: 最小長は 20 です。最大長は 1600 です。  
必須: はい

 ** [S3ExportConfiguration](#API_ExportJournalToS3_RequestSyntax) **   <a name="qldb-ExportJournalToS3-request-S3ExportConfiguration"></a>
エクスポートリクエストの Simple Storage Service (Amazon S3) バケット送信先の構成設定。  
型: [S3ExportConfiguration](API_S3ExportConfiguration.md) オブジェクト  
必須: はい

## レスポンスの構文
<a name="API_ExportJournalToS3_ResponseSyntax"></a>

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

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

## レスポンス要素
<a name="API_ExportJournalToS3_ResponseElements"></a>

アクションが成功すると、サービスは HTTP 200 レスポンスを返します。

サービスから以下のデータが JSON 形式で返されます。

 ** [ExportId](#API_ExportJournalToS3_ResponseSyntax) **   <a name="qldb-ExportJournalToS3-response-ExportId"></a>
QLDB が各ジャーナルエクスポートジョブに割り当てる UUID (Base62 でエンコードされたテキストで表されます)。  
エクスポートリクエストを記述してジョブのステータスを確認するには、`ExportId` を使用して `DescribeJournalS3Export` を呼び出します。  
タイプ: 文字列  
長さの制限: 22 の固定長  
パターン: `^[A-Za-z-0-9]+$` 

## エラー
<a name="API_ExportJournalToS3_Errors"></a>

すべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。

 ** ResourceNotFoundException **   
指定されたリソースは存在しません。  
HTTP ステータスコード: 404

 ** ResourcePreconditionNotMetException **   
事前に条件が満たされていなかったため、オペレーションが失敗しました。  
HTTP ステータスコード: 412

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

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS コマンドラインインターフェイス](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 for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/qldb-2019-01-02/ExportJournalToS3) 
+  [AWS SDK for 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 for 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)