レポートのバージョンを確認する - AWS Data Exports

レポートのバージョンを確認する

AWS は、請求が確定するまで、コストと使用状況レポートを少なくとも 1 日 1 回更新します。レポートを作成するときに、新しいレポートバージョンを作成するか、更新ごとに既存のレポートバージョンを上書きするかを選択できます。

レポートファイルには、1個または複数のcsv ファイルと1個のマニフェストファイルが含まれます。Amazon Athena、Amazon Redshift、または Quick Suite とデータを統合できるようにデータをレポートに追加することもできます。

以下のセクションでは、選択したレポートのバージョン管理に基づくファイル構成と命名規則について説明します。

コストと使用状況レポートの配信タイムライン

レポート期間中、AWS でレポートが更新されるたびに、AWS は新しいレポートと新しいマニフェストファイルを配信します。AWS は、請求期間が終了するまで、以前のレポートの内容に追加して新しいレポートを構築します。レポート対象の請求期間の終了後に、AWS は以前のレポートの内容を含まない新しいレポートを生成します。

コストと使用状況レポートの新しいバージョンの作成

以前のコストと使用状況レポートを保持するように選択すると、AWS CUR は次の Amazon S3 構成と命名規則を使用します。

<example-report-prefix>/<example-report-name>/yyyymmdd-yyyymmdd/<assemblyId>/<example-report-name>-<file-number>.csv.<zip|gz>
  • report-prefix = レポートに割り当てるプレフィックス。

  • report-name = レポートに割り当てる名前。

  • yyyymmdd-yyyymmdd = レポートの対象となる日付の範囲。レポートは、日付範囲の終了時に確定されます。

  • assemblyId = レポートが更新されるたびに AWS が作成する ID。

  • file-number = 更新に大容量ファイルが含まれる場合、AWS は複数のファイルに分割する場合があります。file-number で単一更新内の複数のファイルが追跡されます。

  • csv = レポートファイルの形式。

  • zip または gz = レポートファイルに適用される圧縮タイプ。

例えば、レポートは以下のファイルの集まりとして配信される場合があります。

<example-report-prefix>/<example-report-name>/20160101-20160131/<123456789>/<example-report-name>-<1>.csv.<zip> <example-report-prefix>/<example-report-name>/20160101-20160131/<123456789>/<example-report-name>-<2>.csv.<zip> <example-report-prefix>/<example-report-name>/20160101-20160131/<123456789>/<example-report-name>-<3>.csv.<zip> <example-report-prefix>/<example-report-name>/20160101-20160131/<123456789>/<example-report-name>-Manifest.json <example-report-prefix>/<example-report-name>/20160101-20160131/<example-report-name>-Manifest.json

AWS は、日付範囲内のすべてのレポートを同じ report-prefix/report-name/yyyymmdd-yyyymmdd フォルダに配信します。AWS によって各レポートに一意の ID が付けられ、日付範囲フォルダの assemblyId サブフォルダに配信されます。レポートのサイズが大きすぎて 1 つのファイルに収まらない場合は、複数のファイルに分割されて同じ assemblyId フォルダに配信されます。

以前のレポートを保持するときのマニフェストファイルの詳細については、「コストと使用状況レポートのマニフェストファイル」を参照してください。

以前のコストと使用状況レポートの上書き

以前のコストと使用状況レポートを上書きするように選択すると、AWS CUR は次の Amazon S3 構成と命名規則を使用します。

<example-report-prefix>/<example-report-name>/yyyymmdd-yyyymmdd/<example-report-name>-<file-number>.csv.<zip|gz>
  • report-prefix = レポートに割り当てるプレフィックス。

  • report-name = レポートに割り当てる名前。

  • yyyymmdd-yyyymmdd = レポートの対象となる日付の範囲。AWS は日付範囲の終了時にレポートを確定します。

  • file-number = 更新に大容量ファイルが含まれる場合、AWS は複数のファイルに分割する場合があります。file-number で単一更新内の複数のファイルが追跡されます。

  • csv = レポートファイルの形式。

  • zip または gz = レポートファイルに適用される圧縮タイプ。

例えば、レポートは以下のファイルの集まりとして配信される場合があります。

<example-report-prefix>/<example-report-name>/yyyymmdd-yyyymmdd/<example-report-name>-<1>.csv.<zip> <example-report-prefix>/<example-report-name>/yyyymmdd-yyyymmdd/<example-report-name>-<2>.csv.<zip><example-report-prefix>/<example-report-name>/yyyymmdd-yyyymmdd/<example-report-name>-<3>.csv.<zip> <example-report-prefix>/<example-report-name>/yyyymmdd-yyyymmdd/<example-report-name>-Manifest.json

Athena の仕様

AWS CUR の作成時に Athena サポートを選択すると、ファイルの命名規則は、形式と圧縮を除いて AWS CUR の上書きを選択した場合と同じになります。Athena AWS CUR ファイルでは、代わりに.parquetが使用されます。例えば、レポートは以下のファイルの集まりとして配信される場合があります。

<example-report-prefix>/<example-report-name>/yyyymmdd-yyyymmdd/<example-report-name>.parquet <example-report-prefix>/<example-report-name>/yyyymmdd-yyyymmdd/<cost_and_usage_data_status> <example-report-prefix>/<example-report-name>/yyyymmdd-yyyymmdd/<example-report-name>-Manifest.json <example-report-prefix>/<example-report-name>/yyyymmdd-yyyymmdd/<example-report-name>-create-table.sql <example-report-prefix>/<example-report-name>/yyyymmdd-yyyymmdd/crawler-cfn.yml

CloudFormation の仕様

AWS CUR ファイルに加えて、AWS は CloudFormation テンプレートも配信します。このテンプレートにより、Athena を使用して Amazon S3 データのクエリを実行するための CloudFormation スタックをセットアップできます。CloudFormation テンプレートを使用しない場合は、提供されている SQL を使用して独自の Athena テーブルを作成できます。詳細については、「Amazon Athena を使用したコストと使用状況レポートのクエリ」を参照してください。

コストと使用状況レポートのマニフェストファイル

AWS で AWS CUR を更新するときに、AWS は、Amazon Athena、Amazon Redshift、または Quick Suite に使用できるマニフェストファイルも作成して配信します。

マニフェストファイルは、命名規則を使用し、以下の項目を一覧表示します。

  • これまでにレポートに含まれたすべての詳細列

  • レポートが複数のファイルに分割された場合のレポートファイルのリスト

  • レポートの対象期間およびその他の情報。

<example-report-prefix>/<example-report-name>/yyyymmdd-yyyymmdd/<example-report-name>-Manifest.json <example-report-prefix>/<example-report-name>/yyyymmdd-yyyymmdd/<assemblyId>/<example-report-name>-Manifest.json <example-report-prefix>/<example-report-name>/<example-report-name>/year=2018/month=12/<example-report-name>-Manifest.json

コストと使用状況レポートの新しいバージョンの作成

以前のコストと使用状況レポートを保持する場合、マニフェストファイルは日付範囲フォルダと assemblyId フォルダの両方に配信されます。AWS は、日付範囲の新しい AWS CUR を作成するたびに、その日付範囲フォルダに保存されているマニフェストファイルを、更新されたマニフェストファイルで上書きします。AWS は、同じ更新されたマニフェストファイルを、その更新のファイルとともに assemblyId フォルダに配信します。assemblyId フォルダのマニフェストファイルは上書きされません。

以前のコストと使用状況レポートの上書き

以前の AWS CUR を上書きすると、マニフェストファイルが month=mm フォルダに配信されます。マニフェストファイルは、レポートファイルとともに上書きされます。

Amazon Redshift の仕様

AWS CUR で Amazon Redshift サポートのオプションを選択すると、AWS は、レポートを Amazon Redshift にアップロードするために必要な SQL コマンドを含むファイルも作成して配信します。SQL ファイルは通常のテキストエディタで開くことができます。この SQL ファイルには次の命名規則が使用されます。

<example-report-prefix>/<example-report-name>/yyyymmdd-yyyymmdd/<assemblyId>/<example-report-name>-RedshiftCommands.sql

RedshiftCommands ファイルでコマンドを使用する場合、RedshiftManifest ファイルを開く必要はありません。

重要

manifest ファイルは、copy ファイルの RedshiftCommands コマンドを使用してアップロードするファイルを決定します。manifest ファイルを削除すると、RedshiftCommands ファイルのコピーコマンドで問題が生じます。

Amazon Athena の仕様

AWS CUR で Amazon Athena サポートのオプションを選択した場合、AWS は必要なすべてのリソースをセットアップするために役立つ複数のファイルも作成して配信します。AWS は、CloudFormation テンプレート、手動で Athena テーブルを作成するための SQL を含む SQL ファイル、AWS CUR の更新ステータスを確認するための SQL を含むファイルを配信します。これらのファイルでは次の命名規則が使用されます。

<example-report-prefix>/<example-report-name>/<example-report-name>/yyyymmdd-yyyymmdd/crawler-cfn.yml <example-report-prefix>/<example-report-name>/<example-report-name>/yyyymmdd-yyyymmdd/<example-report-name>-create-table.sql <example-report-prefix>/<example-report-name>/<example-report-name>/yyyymmdd-yyyymmdd/<cost_and_usage_data_status>