記錄 Billing and Cost Management API 呼叫 AWS CloudTrail - AWS 帳單

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

記錄 Billing and Cost Management API 呼叫 AWS CloudTrail

Billing and Cost Management 整合在一起 AWS CloudTrail,可提供使用者、角色或服務在 Billing and Cost Management 中所採取的動作記錄的 AWS 服務。 CloudTrail 將 Billing and Cost Management 的API呼叫擷取為事件,包括來自 Billing and Cost Management 主控台的呼叫,以及從程式碼呼叫到 Billing and Cost Management APIs。如需與計費相關 CloudTrail 事件的完整清單,請參閱AWS Billing CloudTrail 事件

如果您建立追蹤,您可以啟用持續交付 CloudTrail 事件到 Amazon S3 儲存貯體,包括 Billing and Cost Management 的事件。如果您未設定追蹤,您仍然可以在 [事件歷程記錄] 中檢視 CloudTrail主控台中最近的事件。使用收集的資訊 CloudTrail,您可以判斷向「Billing and Cost Management 系統」提出的要求、提出要求的 IP 位址、提出要求的人員、提出要求的時間,以及其他詳細資訊。

若要進一步了解 CloudTrail,包括如何設定和啟用它,請參閱AWS CloudTrail 使用者指南

AWS Billing CloudTrail 事件

本節顯示與 Billing and Cost Management 相關 CloudTrail 事件的完整清單。如需「付款」事件的 CloudTrail 清單,請參閱付款 CloudTrail 事件

備註

下列 CloudTrail 事件會使用不同的事件來源,而非billingconsole.amazonaws.com

  • CreateCustomerCaseGetTaxExemptionTypes、和 BatchGetTaxExemptions 使用 taxconsole.amazonaws.com

  • CreateCustomerVerificationDetailsGetCustomerVerificationDetailsGetCustomerVerificationEligibility 和 UpdateCustomerVerificationDetails 使用 customer-verification.amazonaws.com

  • AddPurchaseOrderDeletePurchaseOrderListPurchaseOrdersGetPurchaseOrderListPurchaseOrderInvoicesUpdatePurchaseOrderStatusUpdatePurchaseOrderTagResourceUntagResource 和 ListTagsForResource 使用 purchase-orders.amazonaws.com

事件名稱 定義

AddPurchaseOrder

記錄採購單的建立。

AcceptFxPaymentCurrencyTermsAndConditions

記錄接受以外的貨幣支付的條款和條件USD。

BatchGetTaxExemptions

記錄對帳戶和任何連結帳戶的美國免稅資料之存取。

CloseAccount

記錄關閉帳戶。

CreateCustomerCase

記錄客戶支援案例之建立以驗證帳戶的美國免稅資料。

CreateCustomerVerificationDetails

(僅適用於擁有印度帳單或聯絡地址的客戶)

記錄帳戶的客戶驗證詳細資訊的建立。

CreateOrigamiReportPreference

記錄建立成本與用量報告;僅限管理帳戶。

DeletePurchaseOrder

記錄採購單的刪除。

DeleteOrigamiReportPreferences

記錄刪除成本與用量報告;僅限管理帳戶。

DownloadCommercialInvoice

記錄下載商業發票。

DownloadECSVForBillingPeriod

記錄特定計費週期內電子CSV檔案(每月使用量報告)的下載。

DownloadRegistrationDocument

記錄稅務登記文件之下載。

DownloadTaxInvoice

記錄下載稅務發票。

EnableBillingAlerts

記錄選擇接收預估費用的 CloudWatch 帳單警示。

FindECSVForBillingPeriod

記錄特定計費週期內的ECSV檔案擷取。

GetAccountEDPStatus

記錄帳戶EDP狀態的擷取。

GetAddresses

記錄對帳戶的稅務地址、帳單地址和聯絡地址之存取。

GetAllAccounts

記錄對管理帳戶所有成員帳戶之存取。

GetAllAccountDetails

記錄對管理帳戶所有成員帳戶的稅務登記詳細資訊之存取。

GetBillsForBillingPeriod

記錄特定帳單期間內帳戶用量和費用之存取。

GetBillsForLinkedAccount

在特定帳單期間內,記錄擷取合併帳單系列中其中一個成員帳戶的用量和費用之管理帳戶的存取。

GetCommercialInvoicesForBillingPeriod

記錄特定帳單期間內對帳戶商業發票中繼資料之存取。

GetConsolidatedBillingFamilySummary

記錄管理帳戶的存取權,以擷取整個合併帳單系列的摘要。

GetCustomerVerificationEligibility

(僅適用於擁有印度帳單或聯絡地址的客戶)

記錄帳戶的客戶驗證資格的擷取。

GetCustomerVerificationDetails

(僅適用於擁有印度帳單或聯絡地址的客戶)

記錄帳戶的客戶驗證詳細資訊的擷取。

GetLinkedAccountNames

在特定帳單期間內,記錄從屬於其合併帳單系列之成員帳戶名稱的管理帳戶中擷取的內容。

GetPurchaseOrder

記錄採購單的擷取。

GetSupportedCountryCodes

記錄對稅務主控台所支援的所有國家/地區代碼之存取。

GetTaxExemptionTypes

記錄對稅務主控台所支援的所有美國免稅類型之存取。

GetTaxInheritance

記錄對帳戶之稅務繼承偏好 (開啟或關閉) 之存取。

GetTaxInvoicesMetadata

記錄稅務發票中繼資料的擷取內容。

GetTaxRegistration

記錄對帳戶稅務登記號碼之存取。

GetTotal

記錄擷取的帳戶總費用。

GetTotalAmountForForecast

記錄特定帳單期間對預測費用之存取。

ListCostAllocationTags

記錄成本分配標籤的擷取和清單。

ListPurchaseOrders

記錄採購單的擷取和清單。

ListPurchaseOrderInvoices

記錄與採購單關聯的發票擷取和清單。

ListTagsForResource

列出與資源關聯的標籤。對於payments,此操作指的是付款方式。對於purchase-orders,此作業是指採購單。

PreviewTaxRegistrationChange

在確認前記錄税務登記變更預覽。

RedeemPromoCode

記錄帳戶的促銷點數兌換。

SetAccountContractMetadata

記錄建立、刪除或更新公共部門客戶必要的合約資訊。

SetAccountPreferences

記錄更新帳戶名稱、電子郵件和密碼。

SetAdditionalContacts

記錄建立、刪除或更新帳單、作業和安全性通訊的替代聯絡人。

SetContactAddress

記錄建立、刪除或更新帳戶擁有者聯絡資訊,包括地址和電話號碼。

SetCreatedByOptIn

記錄加入 awscreatedby 成本分配標籤偏好設定。

SetCreditSharing

記錄管理帳戶的抵用金共用偏好設定歷史記錄。

SetFreetierBudgetsPreference

記錄接收免費方案用量警示的篇好設定 (加入或退出)。

SetFxPaymentCurrency

記錄建立、刪除或更新用於支付發票的偏好貨幣。

SetIAMAccessPreference

記錄建立、刪除或更新IAM使用者存取帳單主控台的能力。此設定僅適用於具有根存取權的客戶。

SetPANInformation

記錄下 AWS 印度PAN資訊的建立、刪除或更新。

SetPayInformation

記錄帳戶的付款方式歷程記錄 (發票或信用卡/簽帳金融卡)。

SetRISharing

記錄管理帳戶的 RI/Savings Plans 共用偏好設定歷史記錄。

SetSecurityQuestions

記錄安全性挑戰問題的建立、刪除或更新,以協助 AWS 識別您是帳戶的擁有者。

SetTagKeysState

記錄特定成本分配標籤的作用中或非作用中狀態。

SetTaxInheritance

記錄税務繼承的偏好設定 (加入或退出)。

SetTaxRegistration

記錄建立、刪除或更新科目的稅務登記號碼。

TagResource

記錄資源的標記。對於payments,此操作指的是付款方式。對於purchase-orders,此作業是指採購單。

UntagResource

記錄刪除資源中的標籤。對於payments,此操作指的是付款方式。對於purchase-orders,此作業是指採購單。

UpdateCustomerVerificationDetails

(僅適用於擁有印度帳單或聯絡地址的客戶)

記錄帳戶的客戶驗證詳細資訊的更新。

UpdateOrigamiReportPreference

記錄成本與用量報告的更新;僅限管理帳戶。

UpdatePurchaseOrder

記錄採購單的更新。

UpdatePurchaseOrderStatus

記錄採購單狀態的更新。

ValidateAddress

記錄帳戶稅務地址的驗證。

付款 CloudTrail 事件

本節顯示 AWS Billing 主控台中「付款」功能的 CloudTrail 事件完整清單。這些 CloudTrail 事件使用payments.amazonaws.com而不是billingconsole.amazonaws.com.

事件名稱 定義

Instruments_Authenticate

記錄付款工具驗證。

Instruments_Create

記錄支付工具的創建。

Instruments_Delete

記錄支付工具的刪除。

Instruments_Get

記錄支付工具的訪問。

Instruments_List

記錄支付工具元數據的列表。

Instruments_StartCreate

在創建付款工具之前記錄操作。

Instruments_Update

記錄支付工具的更新。

ListTagsForResource

記錄與付款資源相關聯的標籤清單。

Policy_GetPaymentInstrumentEligibility

記錄支付工具資格的訪問。

Preferences_BatchGetPaymentProfiles

記錄付款設定檔的存取。

Preferences_CreatePaymentProfile

記錄付款設定檔的建立。

Preferences_DeletePaymentProfile

記錄付款設定檔的刪除。

Preferences_ListPaymentProfiles

記錄付款設定檔中繼資料的清單。

Preferences_UpdatePaymentProfile

記錄付款設定檔的更新。

TagResource

記錄付款資源的標記。

TermsAndConditions_AcceptTermsAndConditionsForProgramByAccountId

記錄接受的付款條款和條件。

TermsAndConditions_GetAcceptedTermsAndConditionsForProgramByAccountId

記錄接受的條款和條件的訪問。

TermsAndConditions_GetRecommendedTermsAndConditionsForProgram

記錄建議的條款和條件的訪問。

UntagResource

記錄從付款資源刪除標籤。

Billing and Cost Management 資訊 CloudTrail

CloudTrail 在您創建 AWS 帳戶時,您的帳戶已啟用。當「Billing and Cost Management」中發生支援的事件活動時,該活動會與 CloudTrail 事件歷史記錄中的其他 AWS 服務事件一起記錄在事件中。您可以在帳戶中查看,搜索和下載最近的事 AWS 件。如需詳細資訊,請參閱AWS CloudTrail 使用指南中的檢視具有 CloudTrail 事件歷程記錄的事件。

如需 AWS 帳戶中持續的事件記錄 (包括 Billing and Cost Management 的事件),請建立追蹤。追蹤可 CloudTrail 將日誌檔交付到 Amazon S3 儲存貯體。根據預設,當您在主控台中建立追蹤時,追蹤會套用至所有 AWS 區域。追蹤記錄來自 AWS 分區中所有區域的事件,並將日誌檔傳送到您指定的 Amazon S3 儲存貯體。此外,您還可以設定其他 AWS 服務,以進一步分析 CloudTrail 記錄中收集的事件資料並採取行動。

如需詳細資訊,請參閱下列內容:

每一筆事件或日誌專案都會包含產生請求者的資訊。身分資訊可協助您判斷下列事項:

  • 要求是使用根憑證還是IAM使用者認證提出。

  • 提出該請求時,是否使用了特定角色或聯合身分使用者的暫時安全憑證。

  • 請求是否由其他 AWS 服務提出。

若要取得更多資訊,請參閱《使用指南》中的AWS CloudTrail 〈CloudTrail userIdentity元素

CloudTrail 記錄項目範例

下列範例是針對特定的「Billing and Cost Management」 CloudTrail 記錄項目案例提供。

Billing and Cost Management 日誌檔案項目

追蹤是一種組態,可讓事件以日誌檔的形式傳遞到您指定的 Amazon S3 儲存貯體。 CloudTrail 記錄檔包含一或多個記錄項目。事件代表來自任何來源的單一請求,包括有關請求的操作,動作的日期和時間,請求參數等信息。 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" }

稅務主控台

下列範例顯示使用CreateCustomerCase動作的 CloudTrail 記錄項目。

{ "eventVersion":"1.05", "userIdentity":{ "accountId":"111122223333", "accessKeyId":"AIDACKCEVSQ6C2EXAMPLE" }, "eventTime":"2018-05-30T16:44:04Z", "eventSource":"taxconsole.amazonaws.com", "eventName":"CreateCustomerCase", "awsRegion":"us-east-1", "sourceIPAddress":"100.100.10.10", "requestParameters":{ "state":"NJ", "exemptionType":"501C", "exemptionCertificateList":[ { "documentName":"ExemptionCertificate.png" } ] }, "responseElements":{ "caseId":"case-111122223333-iris-2022-3cd52e8dbf262242" }, "eventID":"5923c499-063e-44ac-80fb-b40example9f", "readOnly":false, "eventType":"AwsConsoleAction", "recipientAccountId":"1111-2222-3333" }

付款

下列範例顯示使用Instruments_Create動作的 CloudTrail 記錄項目。

{ "eventVersion": "1.08", "userIdentity": { "type": "Root", "principalId": "111122223333", "arn": "arn:aws:iam::111122223333:<iam>", "accountId": "111122223333", "accessKeyId": "AIDACKCEVSQ6C2EXAMPLE", "sessionContext": { "sessionIssuer": {}, "webIdFederationData": {}, "attributes": { "creationDate": "2024-05-01T00:00:00Z", "mfaAuthenticated": "false" } } }, "eventTime": "2024-05-01T00:00:00Z", "eventSource": "payments.amazonaws.com", "eventName": "Instruments_Create", "awsRegion": "us-east-1", "sourceIPAddress": "100.100.10.10", "userAgent": "AWS", "requestParameters": { "accountId": "111122223333", "paymentMethod": "CreditCard", "address": "HIDDEN_DUE_TO_SECURITY_REASONS", "accountHolderName": "HIDDEN_DUE_TO_SECURITY_REASONS", "cardNumber": "HIDDEN_DUE_TO_SECURITY_REASONS", "cvv2": "HIDDEN_DUE_TO_SECURITY_REASONS", "expirationMonth": "HIDDEN_DUE_TO_SECURITY_REASONS", "expirationYear": "HIDDEN_DUE_TO_SECURITY_REASONS", "tags": { "Department": "Finance" } }, "responseElements": { "paymentInstrumentArn": "arn:aws:payments::111122223333:payment-instrument:4251d66c-1b05-46ea-890c-6b4acf6b24ab", "paymentInstrumentId": "111122223333", "paymentMethod": "CreditCard", "consent": "NotProvided", "creationDate": "2024-05-01T00:00:00Z", "address": "HIDDEN_DUE_TO_SECURITY_REASONS", "accountHolderName": "HIDDEN_DUE_TO_SECURITY_REASONS", "expirationMonth": "HIDDEN_DUE_TO_SECURITY_REASONS", "expirationYear": "HIDDEN_DUE_TO_SECURITY_REASONS", "issuer": "Visa", "tail": "HIDDEN_DUE_TO_SECURITY_REASONS" }, "requestID": "7c7df9c2-c381-4880-a879-2b9037ce0573", "eventID": "c251942f-6559-43d2-9dcd-2053d2a77de3", "readOnly": true, "eventType": "AwsApiCall", "managementEvent": true, "recipientAccountId": "111122223333", "eventCategory": "Management", "sessionCredentialFromConsole": "true" }