S3 File Gateway のキャッシュレポートを作成する - AWS Storage Gateway

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

S3 File Gateway のキャッシュレポートを作成する

S3 File Gateway は、特定のファイル共有のローカルアップロードキャッシュに現在存在するファイルのメタデータのレポートを生成できます。フィルターと追加の条件を適用して、レポートに表示されるキャッシュされたファイルの特定のタイプを決定できます。このレポートを使用して、ゲートウェイの問題を特定して解決できます。たとえば、ゲートウェイから Amazon S3 へのアップロードに失敗したファイルがある場合、アップロードに失敗した特定のファイルと、アップロードに失敗した理由を示すレポートを生成できます。レポートは、指定したフィルターパラメータのセットに一致するファイルのリストを含む CSV ファイルです。出力ファイルは、レポートの設定時に指定したバケットの場所に Amazon S3 オブジェクトとして保存されます。 AWS Storage Gateway API を使用してキャッシュレポートを作成するには、Storage Gateway API リファレンスのStartCacheReport」を参照してください。Storage Gateway コンソールでキャッシュレポートを作成するには、次の手順を使用します。

前提条件

  • ゲートウェイには、キャッシュレポートを保存する Amazon S3 バケットに対する s3:PutObjectおよび アクセスs3:AbortMultipartUpload許可が必要です。

  • 現在、ファイル共有に対して進行中のキャッシュレポートは他にありません。

  • ファイル共有の既存のキャッシュレポートは 10 未満である必要があります。

  • ゲートウェイはオンラインであり、 に接続されている必要があります AWS。

  • ゲートウェイルートディスクには少なくとも 20GB の空き容量が必要です。

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

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

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

  3. Actions ドロップダウンメニューから、キャッシュレポートの作成を選択します。

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

  5. IAM ロールの場合は、次のいずれかを実行して、キャッシュレポートを生成して保存するためのアクセス許可をファイルゲートウェイに付与する IAM ロールを指定します。

    • 既存の IAM ロールを指定するには、ドロップダウンリストからロールを選択します。

    • 新しい IAM ロールを手動で作成するには、ロールの作成を選択し、IAM コンソールを使用して新しいロールを作成します。

    注記

    指定する IAM ロールには、レポートバケット Amazon S3 の場所にオブジェクトを書き込み、レポートバケットへのマルチパートアップロードを停止するための次のアクセス許可が必要です。

    • s3:PutObject

    • s3:AbortMultipartUpload

    ロールは、storagegateway.amazonaws.comサービスが sts:AssumeRoleアクションを使用してロールを引き受けることも許可する必要があります。

  6. レポートフィルターでは、次のいずれかを実行して、キャッシュレポートに含めるファイルを決定します。

    • 現在 Amazon S3 へのアップロードに失敗したすべてのキャッシュ済みファイルを含めるには、アップロードに失敗したすべてのファイルを選択します。

    • 特定の理由で Amazon S3 へのアップロードに失敗したファイルのみを含めるには、特定のアップロード失敗の理由のみを選択します。次に、失敗の理由で、次の 1 つ以上の理由を選択します。

      • アクセスできないストレージクラス — ゲートウェイは、オブジェクトが保存されている Amazon S3 ストレージクラスにアクセスできません。詳細については、「エラー: InaccessibleStorageClass」を参照してください。

      • 無効なオブジェクト状態 — ゲートウェイ上のファイルの状態が Amazon S3 の状態と一致しません。詳細については、「エラー: InvalidObjectState」を参照してください。

      • オブジェクトがありません — オブジェクトが Amazon S3 で削除または移動されました。詳細については、「エラー: ObjectMissing」を参照してください。

      • S3 アクセス拒否 — Amazon S3 バケットアクセス IAM ロールでは、ゲートウェイがアップロードオペレーションを実行できません。詳細については、「エラー: S3AccessDenied」を参照してください。

    注記

    ファイルのアップロード失敗フラグは、24 時間ごと、およびゲートウェイの再起動中にリセットされます。このレポートがリセット後、再度フラグ付けされる前にファイルをキャプチャする場合、アップロードに失敗したファイルとして報告されません。

  7. 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 バケットに接続できない場合、キャッシュレポートの作成は失敗します。

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

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

  9. 完了したら、レポートの作成を選択します。

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