ジャーナルエクスポートの一般的なエラー

このセクションでは、ジャーナルエクスポートのリクエストに対して Amazon QLDB がスローするランタイムエラーについて説明します。

以下は、サービスによって返される一般的な例外のリストです。それぞれの例外には、特定のエラーメッセージに加え、簡単な説明と考えられる解決方法に関する推奨事項が記載されています。

AccessDeniedException

メッセージ: ユーザー: userARN には、iam:PassRole on resource: roleARN を実行する権限がありません。

IAM ロールを QLDB サービスに渡す許可がありません。QLDB には、すべてのジャーナルエクスポートリクエストに対応するロールが必要であり、このロールを QLDB に渡す許可が必要です。このロールにより、指定した Amazon S3 バケットへの書き込みアクセス許可が QLDB に付与されます。

指定した IAM ロールリソースに対して PassRole API オペレーションを実行する許可を付与する IAM ポリシーを QLDB サービス (qldb.amazonaws.com) に定義していることを確認します。ポリシーの例については、「Amazon QLDB のアイデンティティベースのポリシー例」を参照してください。

IllegalArgumentException

メッセージ: QLDB encountered an error validating S3 configuration (QLDB で S3 設定の検証中にエラーが発生しました): errorCode errorMessage

このエラーの原因として考えられるのは、指定したバケットが Simple Storage Service (Amazon S3) に存在しないことです。または、指定した Simple Storage Service (Amazon S3) バケットにオブジェクトを書き込むための権限が QLDB にないと考えられます。

エクスポートジョブリクエストで指定した S3 バケット名が正しいか確認します。バケットの命名規則の詳細については、「Amazon Simple Storage Service ユーザーガイド」の「バケットの制約と制限」を参照してください。

また、指定したバケットに対する PutObject および PutObjectAcl アクセス許可を QLDB サービス (qldb.amazonaws.com) に付与するポリシーを定義していることを確認します。詳細については、「エクスポートアクセス許可」を参照してください。

IllegalArgumentException

メッセージ: Unexpected response from Amazon S3 while validating the S3 configuration. (S3 設定の検証中に、Amazon S3 から不測のレスポンスがありました。) S3 からのレスポンス: errorCode errorMessage

指定した S3 バケットにジャーナルエクスポートデータを書き込もうとしましたが、Simple Storage Service (Amazon S3) エラーレスポンスがあり失敗しました。考えられる原因の詳細については、「Amazon Simple Storage Service ユーザーガイド」の「Amazon S3 のトラブルシューティング」を参照してください。

IllegalArgumentException

メッセージ: Amazon S3 bucket prefix must not exceed 128 characters (Amazon S3 バケットプレフィックスは 128 文字以下でなければなりません)

ジャーナルエクスポートのリクエストで指定したプレフィックスが 128 文字を超えています。

IllegalArgumentException

メッセージ: Start date must not be greater than end date (開始日は終了日よりも前の日付でなければなりません)

InclusiveStartTime と ExclusiveEndTime を両方とも、ISO 8601 の日時形式、協定世界時 (UTC) にしてください。

IllegalArgumentException

メッセージ: End date cannot be in future (終了日を現在よりも後の日付にすることはできません)

InclusiveStartTime と ExclusiveEndTime を両方とも、ISO 8601 の日時形式、UTC にしてください。

IllegalArgumentException

メッセージ: 指定されたオブジェクト暗号化設定 (S3EncryptionConfiguration) は AWS Key Management Service （AWS KMS) キーと互換性がありません

ObjectEncryptionType が NO_ENCRYPTION または SSE_S3 の KMSKeyArn が指定されています。SSE_KMS のオブジェクトの暗号化タイプに対してのみ、カスタマーマネージド AWS KMS key を指定できます。Simple Storage Service (Amazon S3) のサーバー側の暗号化オプションの詳細については、「Amazon S3 デベロッパーガイド」の「サーバー側の暗号化を使用したデータの保護」を参照してください。

LimitExceededException

メッセージ: Exceeded the limit of 2 concurrently running Journal export jobs (ジャーナルエクスポートジョブの同時実行の上限数 2 を超えています)

QLDB では、デフォルトで、ジャーナルエクスポートジョブの同時実行は最大 2 件までという制限が適用されます。