AWS Billing CloudTrail événements Informations de facturation et de gestion des coûts dans CloudTrail CloudTrail exemples de saisie de journal

Enregistrement des appels de l'API Billing and Cost Management avec AWS CloudTrail

Billing and Cost Management est intégré à AWS CloudTrail un service qui fournit un enregistrement des actions entreprises par un utilisateur, un rôle ou un AWS service dans Billing and Cost Management. CloudTrail capture les appels d'API pour Billing and Cost Management sous forme d'événements, y compris les appels depuis la console Billing and Cost Management et les appels de code vers les API Billing and Cost Management. Pour une liste complète des CloudTrail événements liés à la facturation, consultezAWS Billing CloudTrail événements.

Si vous créez un suivi, vous pouvez activer la diffusion continue d' CloudTrail événements vers un compartiment Amazon S3, y compris des événements pour Billing and Cost Management. Si vous ne configurez pas de suivi, vous pouvez toujours consulter les événements les plus récents dans la CloudTrail console dans Historique des événements. À l'aide des informations collectées par CloudTrail, vous pouvez déterminer la demande qui a été faite à Billing and Cost Management, l'adresse IP à partir de laquelle la demande a été faite, l'auteur de la demande, la date à laquelle elle a été faite et des informations supplémentaires.

Pour en savoir plus CloudTrail, notamment comment le configurer et l'activer, consultez le guide de AWS CloudTrail l'utilisateur.

AWS Billing CloudTrail événements

Cette section présente une liste complète des CloudTrail événements liés à Billing and Cost Management. Pour obtenir CloudTrail la liste des événements liés aux paiements, consultez CloudTrail Événements liés aux paiements.

Remarques

Les CloudTrail événements suivants utilisent une source d'événements différente au lieu de billingconsole.amazonaws.com :

CreateCustomerCase, GetTaxExemptionTypes et BatchGetTaxExemptions utilisent taxconsole.amazonaws.com.
CreateCustomerVerificationDetails, GetCustomerVerificationDetails, GetCustomerVerificationEligibility et UpdateCustomerVerificationDetails utilisent customer-verification.amazonaws.com.
AddPurchaseOrder, DeletePurchaseOrder, ListPurchaseOrders, GetPurchaseOrder, ListPurchaseOrderInvoices, UpdatePurchaseOrderStatus, UpdatePurchaseOrder, TagResource, UntagResource et ListTagsForResource utilisent purchase-orders.amazonaws.com.

Nom de l’événement	Définition
`AddPurchaseOrder`	Enregistre la création d'un bon de commande.
`AcceptFxPaymentCurrencyTermsAndConditions`	Enregistre l'acceptation des conditions générales de paiement dans une devise autre que le dollar américain.
`BatchGetTaxExemptions`	Journalise l'accès aux exonérations fiscales américaines d'un compte et tous les comptes liés.
`CloseAccount`	Enregistre la fermeture d'un compte.
`CreateCustomerCase`	Journalise la création d'un cas de support client pour valider l'exonération fiscale américaine pour un compte.
`CreateCustomerVerificationDetails`	(Pour les clients ayant une adresse de facturation ou de contact en Inde uniquement) Journalise la création des informations de vérification des clients du compte.
`CreateOrigamiReportPreference`	Journalise la création du rapport d'utilisation et de coûts ; compte de gestion uniquement.
`DeletePurchaseOrder`	Enregistre la suppression d'un bon de commande.
`DeleteOrigamiReportPreferences`	Journalise la suppression du rapport d'utilisation et de coûts ; compte de gestion uniquement.
`DownloadCommercialInvoice`	Journalise le téléchargement d'une facture commerciale.
`DownloadECSVForBillingPeriod`	Journalise le téléchargement du fichier eCSV (rapport d'utilisation mensuel) pour une période de facturation spécifique.
`DownloadRegistrationDocument`	Journalise le téléchargement du document d'enregistrement fiscal.
`DownloadTaxInvoice`	Journalise le téléchargement d'une facture fiscale.
`EnableBillingAlerts`	Enregistre le consentement à recevoir des alertes de CloudWatch facturation pour les frais estimés.
`FindECSVForBillingPeriod`	Journalise la récupération du fichier ECSV pour une période de facturation spécifique.
`GetAccountEDPStatus`	Journalise la récupération du statut EDP du compte.
`GetAddresses`	Journalise l'accès à l'adresse fiscale, l'adresse de facturation et l'adresse de contact d'un compte.
`GetAllAccounts`	Journalise l'accès à tous les numéros de comptes membres du compte de gestion.
`GetAllAccountDetails`	Journalise l'accès aux détails de l'enregistrement fiscal de tous les comptes membres du compte de gestion.
`GetBillsForBillingPeriod`	Journalise l'accès à l'utilisation et aux frais du compte pour une période de facturation spécifique.
`GetBillsForLinkedAccount`	Journalise l'accès d'un compte de gestion en récupérant l'utilisation et les frais de l'un des comptes membres de la famille de facturation consolidée pour une période de facturation spécifique.
`GetCommercialInvoicesForBillingPeriod`	Journalise l'accès aux métadonnées des factures commerciales du compte pour la période de facturation spécifique.
`GetConsolidatedBillingFamilySummary`	Journalise l'accès du compte de gestion en récupérant le résumé de l'ensemble de la famille de facturation consolidée.
`GetCustomerVerificationEligibility`	(Pour les clients ayant une adresse de facturation ou de contact en Inde uniquement) Journalise la récupération de l'éligibilité de la vérification des clients du compte.
`GetCustomerVerificationDetails`	(Pour les clients ayant une adresse de facturation ou de contact en Inde uniquement) Journalise la récupération des informations de vérification des clients du compte.
`GetLinkedAccountNames`	Journalise la récupération à partir d'un compte de gestion des noms de compte membre appartenant à sa famille de facturation consolidée pour une période de facturation spécifique.
`GetPurchaseOrder`	Enregistre la récupération d'un bon de commande.
`GetSupportedCountryCodes`	Journalise l'accès à tous les codes pays supportés par la console fiscale.
`GetTaxExemptionTypes`	Journalise l'accès à tous les types d'exonérations américaines pris en charge par console fiscale.
`GetTaxInheritance`	Journalise l'accès aux préférences en matière d'héritage fiscal (activation ou désactivation) d'un compte.
`GetTaxInvoicesMetadata`	Journalise la récupération des métadonnées des factures fiscales.
`GetTaxRegistration`	Journalise l'accès au numéro d'enregistrement fiscal d'un compte.
`GetTotal`	Journalise la récupération du total des frais du compte.
`GetTotalAmountForForecast`	Journalise l'accès aux frais prévus pour la période de facturation spécifique.
`ListCostAllocationTags`	Journalise l'accès à la récupération et à la liste des balises d'allocation des coûts.
`ListPurchaseOrders`	Enregistre la récupération et la liste des bons de commande.
`ListPurchaseOrderInvoices`	Enregistre la récupération et la liste des factures associées à un bon de commande.
`ListTagsForResource`	Répertorie les balises associées à une ressource. En `payments` effet, cette action fait référence à un mode de paiement. En `purchase-orders` effet, cette action fait référence à un bon de commande.
`PreviewTaxRegistrationChange`	Journalise l'aperçu des modifications apportées à l'enregistrement fiscal avant la confirmation.
`RedeemPromoCode`	Enregistre l'échange de crédits promotionnels pour un compte.
`SetAccountContractMetadata`	Enregistre la création, la suppression ou la mise à jour des informations contractuelles nécessaires pour les clients du secteur public.
`SetAccountPreferences`	Enregistre les mises à jour du nom du compte, de l'e-mail et du mot de passe.
`SetAdditionalContacts`	Enregistre la création, la suppression ou la mise à jour des autres contacts pour la facturation, les opérations et les communications de sécurité.
`SetContactAddress`	Journalise la création, la suppression ou la mise à jour des informations de contact du propriétaire du compte, y compris l'adresse et le numéro de téléphone.
`SetCreatedByOptIn`	Enregistre l'acceptation de la préférence de balise de répartition des coûts `awscreatedby`.
`SetCreditSharing`	Journalise l'historique de la préférence de partage de crédit pour le compte de gestion.
`SetFreetierBudgetsPreference`	Enregistre la préférence (acceptation ou refus) de recevoir des alertes d'utilisation du niveau gratuit.
`SetFxPaymentCurrency`	Enregistre la création, la suppression ou la mise à jour de la préférence de devise pour le règlement de votre facture.
`SetIAMAccessPreference`	Journalise la création, la suppression ou la mise à jour de la capacité de l'utilisateur IAM à accéder à la console de facturation. Ce paramètre est réservé uniquement aux clients disposant d'un accès racine.
`SetPANInformation`	Enregistre la création, la suppression ou la mise à jour des informations PAN AWS en Inde.
`SetPayInformation`	Enregistre l'historique du mode de paiement (facture ou carte de crédit/débit) pour le compte.
`SetRISharing`	Journalise l'historique de la préférence de partage des instances réservées/Savings Plans pour le compte de gestion.
`SetSecurityQuestions`	Enregistre la création, la suppression ou la mise à jour des questions de sécurité afin de vous AWS identifier en tant que propriétaire du compte.
`SetTagKeysState`	Enregistre l'état actif ou inactif d'une balise de répartition des coûts particulière.
`SetTaxInheritance`	Journalise la préférence (inscription ou désinscription) de l'héritage fiscal.
`SetTaxRegistration`	Enregistre la création, la suppression ou la mise à jour du numéro d'enregistrement fiscal d'un compte.
`TagResource`	Enregistre le balisage d'une ressource. En `payments` effet, cette action fait référence à un mode de paiement. En `purchase-orders` effet, cette action fait référence à un bon de commande.
`UntagResource`	Enregistre la suppression de balises d'une ressource. En `payments` effet, cette action fait référence à un mode de paiement. En `purchase-orders` effet, cette action fait référence à un bon de commande.
`UpdateCustomerVerificationDetails`	(Pour les clients ayant une adresse de facturation ou de contact en Inde uniquement) Journalise la mise à jour des informations de vérification des clients du compte.
`UpdateOrigamiReportPreference`	Journalise la mise à jour du rapport d'utilisation et de coûts ; compte de gestion uniquement.
`UpdatePurchaseOrder`	Enregistre la mise à jour d'un bon de commande.
`UpdatePurchaseOrderStatus`	Enregistre la mise à jour du statut d'un bon de commande.
`ValidateAddress`	Journalise la validation de l'adresse fiscale d'un compte.

CloudTrail Événements liés aux paiements

Cette section présente la liste complète des CloudTrail événements liés à la fonctionnalité Paiements de la AWS Billing console. Ces CloudTrail événements utilisent payments.amazonaws.com au lieu debillingconsole.amazonaws.com.

Nom de l’événement	Définition
`Instruments_Authenticate`	Enregistre l'authentification de l'instrument de paiement.
`Instruments_Create`	Enregistre la création d'instruments de paiement.
`Instruments_Delete`	Enregistre la suppression des instruments de paiement.
`Instruments_Get`	Enregistre l'accès aux instruments de paiement.
`Instruments_List`	Enregistre la liste des métadonnées des instruments de paiement.
`Instruments_StartCreate`	Enregistre les opérations avant la création de l'instrument de paiement.
`Instruments_Update`	Enregistre la mise à jour des instruments de paiement.
`ListTagsForResource`	Enregistre la liste des balises associées à une ressource de paiement.
`Policy_GetPaymentInstrumentEligibility`	Enregistre l'accès à l'éligibilité des instruments de paiement.
`Preferences_BatchGetPaymentProfiles`	Enregistre l'accès aux profils de paiement.
`Preferences_CreatePaymentProfile`	Enregistre la création de profils de paiement.
`Preferences_DeletePaymentProfile`	Enregistre la suppression des profils de paiement.
`Preferences_ListPaymentProfiles`	Enregistre la liste des métadonnées des profils de paiement.
`Preferences_UpdatePaymentProfile`	Enregistre la mise à jour des profils de paiement.
`TagResource`	Enregistre le balisage d'une ressource de paiement.
`TermsAndConditions_AcceptTermsAndConditionsForProgramByAccountId`	Enregistre les termes et conditions des paiements acceptés.
`TermsAndConditions_GetAcceptedTermsAndConditionsForProgramByAccountId`	Enregistre l'accès aux termes et conditions acceptés.
`TermsAndConditions_GetRecommendedTermsAndConditionsForProgram`	Enregistre l'accès aux termes et conditions recommandés.
`UntagResource`	Enregistre la suppression de balises d'une ressource de paiement.

Informations de facturation et de gestion des coûts dans CloudTrail

CloudTrail est activé sur votre AWS compte lorsque vous le créez. Lorsqu'une activité événementielle prise en charge se produit dans Billing and Cost Management, cette activité est enregistrée dans un CloudTrail événement avec les autres événements de AWS service dans l'historique des événements. Vous pouvez consulter, rechercher et télécharger les événements récents dans votre AWS compte. Pour plus d'informations, consultez la section Affichage des événements avec l'historique des CloudTrail événements dans le guide de AWS CloudTrail l'utilisateur.

Pour un enregistrement continu des événements enregistrés sur votre AWS compte, y compris les événements relatifs à Billing and Cost Management, créez un historique. Un suivi permet CloudTrail de fournir des fichiers journaux à un compartiment Amazon S3. Par défaut, lorsque vous créez un parcours dans la console, celui-ci s'applique à toutes les AWS régions. Le journal enregistre les événements de toutes les régions de la AWS partition et transmet les fichiers journaux au compartiment Amazon S3 que vous spécifiez. En outre, vous pouvez configurer d'autres AWS services pour analyser plus en détail les données d'événements collectées dans les CloudTrail journaux et agir en conséquence.

Pour plus d’informations, consultez les ressources suivantes :

Chaque événement ou entrée de journal contient des informations sur la personne ayant initié la demande. Les informations relatives à l’identité permettent de déterminer les éléments suivants :

Si la demande a été effectuée avec des informations d’identification d’utilisateur root ou IAM.
Si la demande a été effectuée avec des informations d’identification de sécurité temporaires pour un rôle ou un utilisateur fédéré.
Si la demande a été faite par un autre AWS service.

Pour plus d'informations, consultez l'élément CloudTrail UserIdentity dans le guide de l'AWS CloudTrail utilisateur.

CloudTrail exemples de saisie de journal

Les exemples suivants sont fournis pour des scénarios spécifiques de saisie dans le CloudTrail journal Billing and Cost Management.

Rubriques

Entrées du fichier journal de la Gestion de la facturation et des coûts
Console fiscale
Paiements

Entrées du fichier journal de la Gestion de la facturation et des coûts

Un suivi est une configuration qui permet de transmettre des événements sous forme de fichiers journaux à un compartiment Amazon S3 que vous spécifiez. CloudTrail les fichiers journaux contiennent une ou plusieurs entrées de journal. Un événement représente une demande unique provenant de n'importe quelle source et inclut des informations sur l'action demandée, la date et l'heure de l'action, les paramètres de la demande, etc. CloudTrail les fichiers journaux ne constituent pas une trace ordonnée des appels d'API publics, ils n'apparaissent donc pas dans un ordre spécifique.

L'exemple suivant montre une entrée de CloudTrail journal illustrant l'SetContactAddressaction.


{
        "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"
    }

Console fiscale

L'exemple suivant montre une entrée de CloudTrail journal qui utilise l'CreateCustomerCaseaction.


{
   "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"
}

Paiements

L'exemple suivant montre une entrée de CloudTrail journal qui utilise l'Instruments_Createaction.


{
    "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"
}

Avertissement JavaScript est désactivé ou n'est pas disponible dans votre navigateur.

Pour que vous puissiez utiliser la documentation AWS, Javascript doit être activé. Vous trouverez des instructions sur les pages d'aide de votre navigateur.

Conventions de rédaction

Journalisation et surveillance

Validation de conformité