S3 ファイルゲートウェイキャッシュレポートで提供される情報について

バケット — ファイル共有に関連付けられている Amazon S3 バケットまたはアクセスポイント。

S3ObjectKey — このファイルのデータとメタデータを保存する Amazon S3 オブジェクト。このオブジェクトには、S3 にアップロードされた最新のデータがありますが、S3 へのアップロードに失敗したデータが欠落している可能性があります。

FilePath — ゲートウェイキャッシュ内のファイルエントリのファイルパス。これは、ファイル共有をマウントして参照する際にファイルを見つけられる場所です。

RenamedTo — 名前が変更されたファイルの新しいパス。ファイル共有上でファイルの名前を変更すると、ゲートウェイはそのファイルの古い場所と新しい場所の両方を追跡する必要があります。このフィールドには、ファイルが移動された場所が表示され、ファイルが複数回名前変更された場合でも、ファイルの名前変更オペレーションを追跡するのに役立ちます。この情報は、ファイル共有内のファイルが Amazon S3 バケット内のオブジェクトにどのように対応しているかを理解する必要がある場合に特に役立ちます。

次の例は、ファイルが Amazon S3 で直接上書きされ、ファイルゲートウェイを介して名前が変更される複雑なシナリオのキャッシュレポートエントリを示しています。このシナリオでは、ゲートウェイはファイル A.txt を S3 にアップロードした後、ローカルキャッシュの空き容量を確保するためにファイルの内容を削除します。その後、関連付けられた S3 オブジェクトは、ゲートウェイを介さずに直接 S3 上で上書きされます。このため、S3 オブジェクトとゲートウェイが期待する内容との不一致により、InvalidObjectState が発生します。同時に、ファイル A.txt はゲートウェイを通じてファイル B.txt に名前が変更されました。

タイプ — エントリが FILE か DIRECTORY のどちら用であるかを示します。

IsDirty — Amazon S3 にまだアップロードされていないファイルの変更がある場合は、TRUE を報告します。これには、ファイルのデータが変更されていない場合でも、ファイル名や読み取り/書き込みアクセス許可などのメタデータへの変更が含まれます。

IsDataDirty — ファイルのデータに変更があり、まだ Amazon S3 にアップロードされていない場合は、TRUE を報告します。

IsDeleted — ファイルがゲートウェイ上で削除されている場合は、TRUE を報告します。ファイルが削除済みとしてマークされている場合、常にダーティとしてマークされます。

IsFailingToUpload — ファイルの Amazon S3 へのアップロードに問題がある場合は、TRUE を報告します。このステータスは 24 時間ごとにリセットされ、ゲートウェイがアップロードを再試行し、問題が解決されたかどうかを確認できます。ゲートウェイは、アップロードに失敗したファイルの新しい書き込みオペレーションを拒否します。ゲートウェイがファイル全体をキャッシュに保持していない場合、読み取りオペレーションも拒否されます。

UploadError — ファイルの Amazon S3 へのアップロードを妨げているエラー。これらのエラーを解決するための詳細と推奨される手順については、「トラブルシューティング: ファイルゲートウェイに関する問題」を参照してください。

SizeInBytes — ファイルの合計サイズ。

IsWholeFileInCache — ファイルの全データが現在ゲートウェイキャッシュに格納されている場合は、TRUE を報告します。この値が Amazon S3 へのアップロードに失敗しているファイルで TRUE の場合、ゲートウェイはそのファイルの読み取りを許可します。