AWS CloudTrail を用いて請求情報とコスト管理 API コールをログに記録する - AWS Billing and Cost Management

AWS CloudTrail を用いて請求情報とコスト管理 API コールをログに記録する

請求情報とコスト管理は、請求情報とコスト管理でユーザー、ロール、または AWS サービスによって取られたアクションのレコードを提供するサービスである AWS CloudTrail と統合されます。CloudTrail は、請求情報とコスト管理の API コールをイベントとしてキャプチャします。これには、請求情報とコスト管理コンソールからの呼び出しと請求情報とコスト管理 API からの呼び出しも含まれます。請求に関連する CloudTrail イベントの完全なリストについては、「CloudTrail イベントを請求する」を参照してください。

証跡を作成する場合は、請求情報とコスト管理のイベントなど、Amazon S3 バケットへの CloudTrail イベントの継続的な配信を有効にすることができます 証跡を設定しない場合でも、CloudTrail コンソールの [Event history (イベント履歴)] で最新のイベントを表示できます。CloudTrail で収集された情報を使用して、請求情報とコスト管理に対するリクエスト、リクエスト元の IP アドレス、リクエスト者、リクエスト日時などの詳細を確認できます。

設定や有効化の方法など、CloudTrail の詳細については、AWS CloudTrail ユーザーガイドを参照してください。

CloudTrail イベントを請求する

このセクションでは、請求情報とコスト管理に関連する CloudTrail イベントの完全なリストを示しています。

イベント名 定義
AcceptFxPaymentCurrencyTermsAndConditions USD 以外の通貨での支払いに関する利用規約の承諾をログに記録します。
CloseAccount アカウントの閉鎖をログに記録します。
CreateOrigamiReportPreference コストと使用状況レポートの作成をログに記録します (管理アカウントのみ)。
DeleteOrigamiReportPreferences コストと使用状況レポートの削除をログに記録します (管理アカウントのみ)。
DownloadCommercialInvoice コマーシャルインボイスのダウンロードをログに記録します。
DownloadECSVForBillingPeriod 特定の請求期間の eCSV ファイル (月次使用状況レポート) のダウンロードのログを作成します。
DownloadTaxInvoice タックスインボイスのダウンロードをログに記録します。
EnableBillingAlerts 予想請求額の CloudWatch 請求アラートの受信のオプトインをログに記録します。
GetBillsForBillingPeriod 特定の請求期間におけるアカウントの使用状況および料金のアクセスをログに記録します。
GetBillsForLinkedAccount 特定の請求期間における一括請求 (コンソリデーティッドビリング) ファミリー内のメンバーアカウントの 1 つの使用状況および料金を取得する管理アカウントのアクセスをログに記録します。
GetCommercialInvoicesForBillingPeriod 特定の請求期間におけるアカウントのコマーシャルインボイスのメタデータへのアクセスをログに記録します。
GetConsolidatedBillingFamilySummary 一括請求 (コンソリデーティッドビリング) ファミリー全体の概要を取得する管理アカウントのアクセスをログに記録します。
GetLinkedAccountNames 特定の請求期間における一括請求ファミリーに属するメンバーアカウント名の管理アカウントからの取得をログに記録します。
GetTaxInvoicesMetadata 税金請求書のメタデータの取得をログに記録します。
GetTotalAmountForForecast 特定の請求期間における予測料金へのアクセスをログに記録します。
RedeemPromoCode アカウントのプロモーションクレジットの利用をログに記録します。
SetAccountContractMetadata 公共部門のお客様に必要な契約情報の作成、削除、または更新をログに記録します。
SetAccountPreferences アカウント名、E メール、パスワードの更新をログに記録します。
SetAdditionalContacts 請求、オペレーション、セキュリティ通信用の代替連絡先の作成、削除、または更新をログに記録します。
SetContactAddress 住所や電話番号を含む、アカウント所有者の連絡先情報の作成、削除、または更新をログに記録します。
SetCostExplorerPreferences アカウントの AWS Cost Explorer のオプトインの履歴をログに記録します。
SetCreatedByOptIn awscreatedby コスト配分タグ設定のオプトインをログに記録します。
SetCreditSharing 管理アカウントのクレジット共有設定の履歴をログに記録します。
SetFreetierBudgetsPreference 無料利用枠のアラートの受信の設定 (オプトインまたはオプトアウト) をログに記録します。
SetFxPaymentCurrency 請求書の支払いに使用される優先通貨の作成、削除、または更新をログに記録します。
SetIAMAccessPreference IAM ユーザーによる請求コンソールへのアクセスの許可の作成、削除、または更新をログに記録します。この設定は、root アクセスが許可されたお客様のみを対象としています。
SetPayInformation アカウントの支払い方法の履歴 (請求書またはクレジット/デビットカード) をログに記録します。
SetRISharing 管理アカウントの RI/Savings Plans 共有設定の履歴をログに記録します。
SetSecurityQuestions セキュリティチャレンジの質問の作成、削除、または更新をログに記録して、AWS がお客様をアカウントの所有者として識別できるようにします。
SetTagKeysState 特定のコスト配分タグのアクティブまたは非アクティブ状態をログに記録します。
SetTaxRegistration アカウントの税登録番号の作成、削除、または更新をログに記録します。
UpdateOrigamiReportPreference コストと使用状況レポートの更新をログに記録します (管理アカウントのみ)。

CloudTrail の請求情報とコスト管理の情報

CloudTrail は、アカウントを作成すると AWS アカウントで有効になります。請求情報とコスト管理でサポートされているイベントアクティビティが発生すると、そのアクティビティは [Event history] (イベント履歴) で AWS のその他サービスのイベントと共に CloudTrail イベントに記録されます。最近のイベントは、AWS アカウントで表示、検索、ダウンロードできます。詳細については、AWS CloudTrail ユーザーガイドの「CloudTrail イベント履歴でのイベントの表示」を参照してください。

AWS アカウントのイベント (請求情報とコスト管理イベントなど) を継続的に記録するには、証跡を作成します。証跡により、CloudTrail はログファイルを Amazon S3 バケットに配信できます。デフォルトでは、コンソールで証跡を作成するときに、証跡がすべての AWS リージョンに適用されます。証跡は、AWS パーティションのすべてのリージョンからのイベントをログに記録し、指定した Amazon S3 バケットにログファイルを配信します。さらに、その他の AWS サービスを設定して、CloudTrail ログで収集したデータをより詳細に分析し、それに基づく対応を行うことができます。

詳細については、以下を参照してください。

各イベントまたはログエントリには、リクエストの生成者に関する情報が含まれます。この ID 情報は以下のことを確認するのに役立ちます。

  • リクエストが、ルートと IAM ユーザー認証情報のどちらを使用して送信されたか。

  • リクエストが、ロールとフェデレーティッドユーザーのどちらの一時的なセキュリティ認証情報を使用して送信されたか.

  • リクエストが、別の AWS サービスによって送信されたかどうか。

詳細については、AWS CloudTrail ユーザーガイドCloudTrail userIdentity エレメントを参照してください。

例: 請求情報とコスト管理ログファイルエントリ

証跡は、指定した Amazon S3 バケットにイベントをログファイルとして配信するように設定できます。CloudTrail ログファイルには、1 つ以上のログエントリがあります。イベントは任意の発生元からの 1 つのリクエストを表し、リクエストされたアクション、アクションの日時、リクエストのパラメータなどに関する情報が含まれます。CloudTrail ログファイルは、パブリック API コールの順序付けられたスタックトレースではないため、特定の順序では表示されません。

次は、SetContactAddress アクションを示す CloudTrail ログエントリの例です。

{ "eventVersion": "1.05", "userIdentity": { "accountId": "111122223333", "accessKeyId": "AIDACKCEVSQ6C2EXAMPLE" }, "eventTime": "2018-05-30T16:44:04Z", "eventSource": "billingconsole.amazonaws.com", "eventName": "SetContactAddress", "awsRegion": "us-east-1", "sourceIPAddress": "100.100.10.10", "requestParameters": { "website": "https://amazon.com", "city": "Seattle", "postalCode": "98108", "fullName": "Jane Doe", "districtOrCounty": null, "phoneNumber": "206-555-0100", "countryCode": "US", "addressLine1": "Nowhere Estates", "addressLine2": "100 Main Street", "company": "AnyCompany", "state": "Washington", "addressLine3": "Anytown, USA", "secondaryPhone": "206-555-0101" }, "responseElements": null, "eventID": "5923c499-063e-44ac-80fb-b40example9f", "readOnly": false, "eventType": "AwsConsoleAction", "recipientAccountId": "1111-2222-3333" }