バッチオペレーションのトラブルシューティング - Amazon Simple Storage Service
NoSuchJobExceptionAccessDeniedExceptionSlowDownErrorInvalidManifestContent

バッチオペレーションのトラブルシューティング

次のトピックは、Amazon S3 バッチオペレーションの実行中に発生する可能性がある問題のトラブルシューティングを取り上げています。

S3 バッチレプリケーションに関する問題のトラブルシューティングについては、「バッチレプリケーションエラー」を参照してください。

バッチオペレーションエラーが発生する障害には、主に 2 つのタイプがあります。

  • API の失敗 – リクエストされた API (CreateJob など) の実行に失敗しました。

  • ジョブの失敗 – 最初の API リクエストは成功しましたが、例えば、マニフェストの問題やマニフェストで指定されたオブジェクトへのアクセス許可が原因でジョブが失敗しました。

NoSuchJobException

タイプ: API の失敗

これは、ジョブの有効期限が切れた場合、または CreateJob リクエストで使用される ID が DescribeJob または UpdateJobStatus リクエストで使用される ID と異なる場合に発生する可能性があります。

ジョブは終了状態 (Complete、Cancelled、または Failed) で 90 日後に期限切れになります。詳細については、「ジョブステータスと完了レポートの追跡」を参照してください。

関連するエラーメッセージ

No such job

推奨されるアクション

NoSuchJobException のトラブルシューティングを行うには、以下を試してください。

  1. ジョブが存在し、ご自身のアカウントにあることを確認します。次の AWS CLI コマンドを使用できます。aws s3control list-jobs --account-id 111122223333

  2. CreateJob リクエストで受信した ID が、DescribeJob または UpdateJobStatus リクエストで使用した ID と同じであることを確認します。

AccessDeniedException

タイプ: API の失敗

AccessDeniedException は、サポートされていないオペレーションが原因で S3 バッチオペレーションリクエストがブロックされた場合、またはリクエストを行う IAM アイデンティティにアクションを実行するための十分なアクセス許可がない場合に発生します。

関連するエラーメッセージ

Access Denied

推奨されるアクション

AccessDeniedException のトラブルシューティングを行うには、以下を試してください。

  1. S3 バッチオペレーションがリージョンのオペレーションまたは機能をサポートしていることを確認します。サポートされているオペレーションのリストについては、S3 バッチ操作でサポートされるオペレーションを参照してください。バッチオペレーションはすべてのリージョンの汎用バケットでサポートされていますが、ディレクトリバケットのオペレーションは、ディレクトリバケットのリージョンエンドポイントとゾーンエンドポイントでのみ使用できます。

  2. リクエストを行う IAM ID にバッチオペレーションを作成および管理するためのアクセス許可があることを確認します。アクセス許可のリストについては、「バッチオペレーションに対するアクセス許可の付与」を参照してください。

SlowDownError

タイプ: API の失敗

この SlowDownError 例外は、アカウントが S3 バッチオペレーションのリクエストレート制限を超えた場合に発生します。

推奨されるアクション

SlowDownError 例外を解決するには、以下を試すことができます。

  1. リクエストレートを遅くして再試行します。詳細については、「AWS 規範ガイダンス」の「Retry with backoff pattern」を参照してください。

InvalidManifestContent

タイプ: ジョブの失敗

この InvalidManifestContent 例外は、マニフェストファイル形式に問題がある場合、または S3 バッチオペレーションがオブジェクトの処理に使用するコンテンツに問題がある場合に発生します。

関連するエラーメッセージ

  • Required fields are missing in the schema: + missingFields

  • Invalid Manifest Content

  • The S3 Batch Operations job failed because it contains more keys than the maximum allowed in a single job. Please split the job into multiple smaller jobs or reach out to customer support for next steps.

推奨されるアクション

InvalidManifestContent のトラブルシューティングを行うには、以下を試してください。

マニフェスト形式の問題の場合

  1. マニフェストが必要な形式の仕様に従っていることを確認します。必要なすべての列が存在し、適切にフォーマットされ、マニフェスト全体で一貫している必要があります。例については「マニフェストの指定」を参照してください。

コンテンツの問題の場合

  1. オブジェクトキーの特殊文字を XML エンティティコードに置き換え、オブジェクトキーが Amazon S3 の命名規則を満たしていることを確認します。詳細については、「Amazon S3 オブジェクトに命名する」を参照してください。

  2. すべてのオブジェクトキーが URL エンコードされていることを確認します。

  3. 大きなジョブを小さなジョブに分割します。S3 バッチ操作でサポートされるオペレーション で、オペレーションごとにサポートされているオブジェクトの数を確認できます。