

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

# S3 ファイルゲートウェイのキャッシュレポートを作成する
<a name="create-cache-report"></a>

S3 ファイルゲートウェイは、特定のファイル共有のローカルアップロードキャッシュ内にあるファイルのメタデータのレポートを生成できます。フィルターと追加の条件を適用して、レポートに表示されるキャッシュされたファイルの特定のタイプを決定できます。このレポートを使用すると、ゲートウェイの問題を特定し、解決するのに役立ちます。たとえば、ゲートウェイから Amazon S3 へのファイルのアップロードが失敗している場合、アップロードに失敗している特定のファイルとその失敗原因を一覧にしたレポートを作成できます。レポートは、指定したフィルターパラメータのセットと一致するファイルのリストを含む CSV ファイルです。出力ファイルは、レポートを設定する際に指定したバケットの場所に Amazon S3 オブジェクトとして保存されます。 AWS Storage Gateway API を使用してキャッシュレポートを作成するには、*Storage Gateway API リファレンス*の [StartCacheReport](https://docs.aws.amazon.com/storagegateway/latest/APIReference/API_StartCacheReport.html) を参照してください。Storage Gateway コンソールでキャッシュレポートを作成するには、次の手順を使用します。

**前提条件**
+ ゲートウェイには、キャッシュレポートを保存する Amazon S3 バケットに対する `s3:PutObject` および `s3:AbortMultipartUpload` アクセス許可が必要です。
+ ファイル共有に関する他のキャッシュレポートと同時には実行できません。
+ ファイル共有の既存のキャッシュレポートは 10 個未満でなければなりません。
+ ゲートウェイはオンラインであり、 に接続されている必要があります AWS。
+ ゲートウェイルートディスクには、20 GB 以上の空き容量が必要です。

**Storage Gateway コンソールを使用してキャッシュレポートを作成するには**

1. Storage Gateway コンソール ([https://console.aws.amazon.com/storagegateway/home/](https://console.aws.amazon.com/storagegateway/home/)) を開きます。

1. ページの左側にあるナビゲーションペインで **[ファイル共有]** を選択し、キャッシュレポートを作成するファイル共有を選択します。

1. [**アクション**] ドロップダウンメニューから、[**キャッシュレポートの作成**] を選択します。

1. **Amazon S3 ロケーション** には、完了したキャッシュレポートの CSV ファイルオブジェクトを Amazon S3 に保存したい場所の、Amazon S3 バケットとプレフィックスを入力します。既存の Amazon S3 ストレージからバケットとプレフィックスを選択するには、[**S3 を参照**]を選択します。

1. **IAM ロール**の場合は、次のいずれかを実行して、キャッシュレポートを生成して保存するためのアクセス許可をファイルゲートウェイに付与する IAM ロールを指定します。
   + 既存の IAM ロールを指定するには、ドロップダウンリストからロールを選択します。
   + 新しい IAM ロールを手動で作成するには、[**ロールの作成**]を選択し、IAM コンソールを使用して新しいロールを作成します。
**注記**  
指定する IAM ロールには、レポートバケットの **Amazon S3 ロケーション**へのオブジェクトの書き込み、およびレポートバケットへのマルチパートアップロードを停止するための次のアクセス許可が必要です。  
`s3:PutObject`
`s3:AbortMultipartUpload`
ロールは、`storagegateway.amazonaws.com`サービスが `sts:AssumeRole`アクションを使用してロールを引き受けることも許可する必要があります。

1. **レポートフィルター**では、次のいずれかを実行して、キャッシュレポートに含めるファイルを決定します。
   + 現在 Amazon S3 へのアップロードに失敗したすべてのキャッシュ済みファイルを含めるには、**アップロードに失敗したすべてのファイル**を選択します。
   + 特定の理由で Amazon S3 へのアップロードに失敗したファイルのみを含めるには、**特定のアップロード失敗の理由のみ**を選択します。次に、**失敗理由**で、以下の理由のいずれか一つ以上を選択します。
     + アクセスできないストレージクラス – ゲートウェイは、オブジェクトが保存されている Amazon S3 ストレージクラスにアクセスできません。詳細については、「[エラー: InaccessibleStorageClass](https://docs.aws.amazon.com/filegateway/latest/files3/troubleshooting-file-gateway-issues.html#troubleshoot-logging-errors-inaccessiblestorageclass)」を参照してください。
     + 無効なオブジェクトの状態 – ゲートウェイ上のファイルの状態が Amazon S3 での状態と一致しません。詳細については、「[エラー: InvalidObjectState](https://docs.aws.amazon.com/filegateway/latest/files3/troubleshooting-file-gateway-issues.html#troubleshoot-logging-errors-invalidobjectstate)」を参照してください。
     + 見つからないオブジェクト – オブジェクトは Amazon S3 で削除または移動されました。詳細については、「[エラー: ObjectMissing](https://docs.aws.amazon.com/filegateway/latest/files3/troubleshooting-file-gateway-issues.html#troubleshoot-logging-errors-objectmissing)」を参照してください。
     + S3 アクセス拒否 – Amazon S3 バケットアクセス IAM ロールでは、ゲートウェイがアップロード操作を実行することを許可していません。詳細については、「[エラー: S3AccessDenied](https://docs.aws.amazon.com/filegateway/latest/files3/troubleshooting-file-gateway-issues.html#troubleshoot-logging-errors-s3accessdenied)」を参照してください。
**注記**  
**ファイルのアップロード失敗**フラグは、24 時間ごとに、およびゲートウェイの再起動時にリセットされます。リセット後、再びフラグが立てられる前にこのレポートでファイルがキャプチャされた場合、それらのファイルは**ファイルのアップロード失敗**として報告されません。

1. **[VPC エンドポイントを使用して S3 に接続する場合]** には、次のいずれかを実行して、ゲートウェイが Amazon S3 バケットに接続する方法を指定します。
   + Amazon VPC を使用せずに直接接続するには、[**バケットに直接接続**]を選択します。
   + 既存の Amazon VPC エンドポイントのリストを参照するには、[**VPC エンドポイントの選択**] を選択し、表示される **[VPC エンドポイント]** のドロップダウンリストからエンドポイントを指定します。
   + DNS 名で既存の Amazon VPC エンドポイントを指定するには、**VPC エンドポイント DNS 名の入力**を選択し、表示される **VPC エンドポイント DNS 名フィールドに DNS 名**を入力します。
**注記**  
ファイル共有で VPC エンドポイントを使用して通常のオペレーションで Amazon S3 に接続する場合は、キャッシュレポートを設定するときに同じ VPC を使用することをお勧めします。無効な VPC 設定など、何らかの理由でゲートウェイが Amazon S3 バケットに接続できない場合、キャッシュレポートの作成は失敗します。

1. (オプション) **[タグ - オプション]** で **[新しいタグの追加]** を選択し、**キー**とキャッシュレポートの**値**を入力します。

   タグは、Storage Gateway リソースの分類に役立つ大文字と小文字を区別するキーと値のペアです。タグを追加すると、キャッシュレポートのフィルタリングと検索が容易になります。この手順を繰り返して、最大 50 個のタグを追加できます。

1. 終了したら、[**レポートを作成**] を選択します。

   Storage Gateway がレポートの生成を開始します。ファイル共有の詳細ページの **[キャッシュレポート]** タブで進行状況を確認し、ステータスを表示できます。