データリポジトリタスク失敗のトラブルシューティング - FSx for Lustre

データリポジトリタスク失敗のトラブルシューティング

CloudWatch Logs へのログを有効にすると、データリポジトリタスクを使用してファイルをインポートまたはエクスポートする際に発生した、任意の障害に関する情報をログに記録できます。CloudWatch Logs のイベントログの詳細については、「データリポジトリのイベントログ」を参照してください。

データリポジトリタスクが失敗した場合、Amazon FSx が処理に失敗したファイルの数は、コンソールの タスクステータス ページの エクスポートに失敗したファイル で確認できます。または、CLI や API を使用してタスクの Status: FailedCount プロパティを表示することもできます。この情報へのアクセスについては、「データリポジトリタスクへのアクセス」を参照してください。

データリポジトリタスクの場合、Amazon FSx は、完了レポートで失敗した特定のファイルやディレクトリに関する情報もオプションで提供します。タスク完了レポートには、障害が発生した Lustre ファイルシステム上のファイルまたはディレクトリパス、そのステータス、および失敗の理由が含まれます。詳細については、「タスク完了レポートの使用」を参照してください。

データリポジトリタスクは、以下に示すものを含む、いくつかの理由で失敗することがあります。

エラーコード 説明

FileSizeTooLarge

Amazon S3 でサポートされているオブジェクトの最大サイズは 5 TiB です。

InternalError

インポート、エクスポート、またはリリースタスクの Amazon FSx ファイルシステム内でエラーが発生しました。通常、このエラーコードは失敗したタスクが実行された Amazon FSx ファイルシステムが、失敗したライフサイクル状態にあることを意味します。この問題が発生すると、データ損失のために影響を受けるファイルを回復できないことがあります。それ以外の場合は、階層ストレージ管理 (HSM) コマンドを使用して、ファイルとディレクトリを S3 のデータリポジトリにエクスポートできます。詳細については、「HSM コマンドを使用したファイルのエクスポート」を参照してください。

OperationNotPermitted

リンクされている S3 バケットにファイルがエクスポートされていないため、Amazon FSx はファイルをリリースできませんでした。自動エクスポートまたはデータリポジトリのエクスポートタスクを使用して、ファイルが最初にリンクされた Amazon S3 バケットにエクスポートされるようにする必要があります。

PathSizeTooLong

エクスポートのパスが長すぎます。S3 でサポートされているオブジェクトキーの最大長は 1,024 文字です。

ResourceBusy

Amazon FSx は、ファイルシステムで別のクライアントによってアクセスされているため、ファイルをエクスポートまたはリリースできませんでした。ワークフローがファイルへの書き込みを完了した後、データリポジトリタスクを再試行できます。

S3AccessDenied

データリポジトリのエクスポートまたはインポートタスクに対する Simple Storage Service (Amazon S3) へのアクセスが拒否されました。

エクスポートタスクの場合、Amazon FSx ファイルシステムでは、S3 上のリンクされたデータリポジトリにエクスポートする S3:PutObject オペレーションを実行する許可が必要です。この許可は、AWSServiceRoleForFSxS3Access_fs-0123456789abcdef0 サービスにリンクされたロールで許可されています。詳細については、「Amazon FSx のサービスリンクロールの使用」を参照してください。

エクスポートタスクの場合、エクスポートタスクではファイルシステムの VPC の外側にデータが流れる必要があるため、ターゲットリポジトリに aws:SourceVpc または aws:SourceVpce IAM グローバル条件キーの 1 つを含むバケットポリシーがある場合に発生する可能性があります。

インポートタスクの場合、Amazon FSx ファイルシステムに S3 上のリンクされたデータリポジトリからインポートするため、S3:HeadObject および S3:GetObject オペレーションを実行する許可が必要です。

インポートタスクの場合、S3 バケットが AWS Key Management Service (SSE-KMS) に保存されているカスタマー管理キーを使ってサーバー側の暗号化を使用する場合は、サーバー側で暗号化された Simple Storage Service (Amazon S3) バケットの使用 のポリシー設定に従う必要があります。

S3 バケットに、ファイルシステムにリンクされた S3 バケットアカウントとは別の AWS アカウント からアップロードされたオブジェクトが含まれている場合、アップロードされたアカウントに関係なく、データリポジトリタスクが S3 メタデータを変更したり、S3 オブジェクトを上書きしたりできます。S3 バケットで、S3 オブジェクト所有権の機能を有効にすることをお勧めします。この機能を使用すると、アップロードに -/-acl bucket-owner-full-control 固定 ACL を提供させることにより、他の AWS アカウント がバケットにアップロードする新しいオブジェクトの所有権を取得できます。S3 バケットで、バケット所有者優先 内のオプションを選択することにより、S3 オブジェクトの所有権を有効にします。詳細については、「Simple Storage Service (Amazon S3) ユーザーガイド」の「S3 オブジェクトの所有権を使用してアップロードされたオブジェクトの所有権をコントロールする」を参照してください。

S3Error

Amazon FSx で、S3AccessDenied ではない S3 に関連するエラーが発生しました。

S3FileDeleted

Amazon FSx は、ハードリンクファイルをエクスポートできませんでした。ソースファイルがデータリポジトリ内に存在しません。

S3ObjectInUnsupportedTier

Amazon FSx が S3 Glacier または S3 Glacier Deep Archive ストレージクラスから、シンボリックリンク以外のオブジェクトを正常にインポートしました。FileStatus は、タスク完了レポートで succeeded with warning になります。データを取得するには、まず S3 Glacier Flexible Retrieval または S3 Glacier Deep Archive オブジェクトを復元し、hsm_restore コマンドを使用してオブジェクトをインポートする必要があることを、警告が示します。

S3ObjectNotFound

Amazon FSx は、データリポジトリに存在しないため、ファイルをインポートまたはエクスポートできませんでした。

S3ObjectPathNotPosixCompliant

Simple Storage Service (Amazon S3) オブジェクトは存在しますが、POSIX に準拠しているオブジェクトではないため、インポートできません。サポートされている POSIX メタデータについては、「データリポジトリの POSIX メタデータのサポート」を参照してください。

S3ObjectUpdateInProgressFromFileRename

自動エクスポートがファイルの名前変更を処理しているため、Amazon FSx はファイルをリリースできませんでした。ファイルをリリースする前に、エクスポートの自動名前変更プロセスを終了する必要があります。

S3SymlinkInUnsupportedTier

Amazon FSx は、シンボリックリンクオブジェクトをインポートできませんでした。このオブジェクトは、S3 Glacier Flexible Retrieval や S3 Glacier Deep Archive ストレージクラスなど、サポートされていない Amazon S3 ストレージクラスにあります。FileStatus は、タスク完了レポートで failed になります。

SourceObjectDeletedBeforeReleasing

Amazon FSx は、ファイルがリリースされる前にデータリポジトリから削除されたため、ファイルシステムからファイルをリリースできませんでした。