Registrando chamadas de Billing and Cost API Management com AWS CloudTrail - AWS Faturamento

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Registrando chamadas de Billing and Cost API Management com AWS CloudTrail

O Billing and Cost Management é integrado AWS CloudTrail com, um serviço que fornece um registro das ações realizadas por um usuário, função ou AWS serviço no Billing and Cost Management. CloudTrail captura API chamadas para o Billing and Cost Management como eventos, incluindo chamadas do console Billing and Cost Management e de chamadas de código para o Billing and Cost Management. APIs Para obter uma lista completa de CloudTrail eventos relacionados ao faturamento, consulteAWS Billing CloudTrail eventos.

Se você criar uma trilha, poderá habilitar a entrega contínua de CloudTrail eventos para um bucket do Amazon S3, incluindo eventos para Billing and Cost Management. Se você não configurar uma trilha, ainda poderá ver os eventos mais recentes no CloudTrail console no Histórico de eventos. Usando as informações coletadas por CloudTrail, você pode determinar a solicitação que foi feita ao Billing and Cost Management, o endereço IP a partir do qual a solicitação foi feita, quem fez a solicitação, quando ela foi feita e detalhes adicionais.

Para saber mais CloudTrail, inclusive como configurá-lo e ativá-lo, consulte o Guia AWS CloudTrail do usuário.

AWS Billing CloudTrail eventos

Esta seção mostra uma lista completa dos CloudTrail eventos relacionados ao Billing and Cost Management.

Nome do evento Definição Origem do evento.

AddPurchaseOrder

Registra a criação de um pedido de compra.

purchase-orders.amazonaws.com

AcceptFxPaymentCurrencyTermsAndConditions

Registra a aceitação dos termos e condições de pagamento em uma moeda diferente deUSD. billingconsole.amazonaws.com

BatchGetTaxExemptions

Registra em log o acesso de uma conta a isenções fiscais dos EUA, e quaisquer contas vinculadas. billingconsole.amazonaws.com

CloseAccount

Registra em log o fechamento de uma conta. billingconsole.amazonaws.com

CreateCustomerVerificationDetails

(Somente para clientes com endereço de cobrança ou contato na Índia)

Registra a criação dos detalhes de verificação do cliente da conta.

customer-verification.amazonaws.com

CreateOrigamiReportPreference

Registra a criação do relatório de uso e de custo; somente para a conta de gerenciamento. billingconsole.amazonaws.com

DeletePurchaseOrder

Registra a exclusão de um pedido de compra.

purchase-orders.amazonaws.com

DeleteOrigamiReportPreferences

Registra a exclusão do relatório de uso e de custo; somente para a conta de gerenciamento. billingconsole.amazonaws.com

DownloadCommercialInvoice

Registra o download de uma fatura comercial. billingconsole.amazonaws.com

DownloadECSVForBillingPeriod

Registra o download do CSV arquivo eletrônico (relatório de uso mensal) de um período de cobrança específico. billingconsole.amazonaws.com

DownloadRegistrationDocument

Registra em log o download do documento de registro fiscal. billingconsole.amazonaws.com

DownloadTaxInvoice

Registra o download de uma fatura fiscal. billingconsole.amazonaws.com

EnableBillingAlerts

Registra a opção de receber alertas de CloudWatch cobrança para cobranças estimadas. billingconsole.amazonaws.com

FindECSVForBillingPeriod

Registra a recuperação do ECSV arquivo para um período de cobrança específico. billingconsole.amazonaws.com

GetAccountEDPStatus

Registra a recuperação do EDP status da conta. billingconsole.amazonaws.com

GetAddresses

Registra em log o acesso ao endereço fiscal, endereço de cobrança e endereço de contato de uma conta. billingconsole.amazonaws.com

GetAllAccounts

Registra em log o acesso a todos os números de conta-membro da conta de gerenciamento. billingconsole.amazonaws.com

GetBillsForBillingPeriod

Registra o acesso ao uso da conta e as cobranças para um período de faturamento específico. billingconsole.amazonaws.com

GetBillsForLinkedAccount

Registra o acesso de uma conta de gerenciamento recuperando o uso e as cobranças de uma das contas-membro na família de faturamento consolidado para um período de faturamento específico. billingconsole.amazonaws.com

GetCommercialInvoicesForBillingPeriod

Registra o acesso aos metadados das faturas comerciais da conta para o período de faturamento específico. billingconsole.amazonaws.com

GetConsolidatedBillingFamilySummary

Registra o acesso da conta de gerenciamento recuperando o resumo de toda a família de faturamento consolidado. billingconsole.amazonaws.com

GetCustomerVerificationEligibility

(Somente para clientes com endereço de cobrança ou contato na Índia)

Registra a recuperação da elegibilidade da conta para verificação do cliente.

customer-verification.amazonaws.com

GetCustomerVerificationDetails

(Somente para clientes com endereço de cobrança ou contato na Índia)

Registra a recuperação dos detalhes de verificação do cliente da conta.

customer-verification.amazonaws.com

GetLinkedAccountNames

Registra a recuperação de uma conta de gerenciamento dos nomes de contas-membro pertencentes à sua família de faturamento consolidado para um período de faturamento específico. billingconsole.amazonaws.com

GetPurchaseOrder

Registra a recuperação de um pedido de compra.

purchase-orders.amazonaws.com

GetSupportedCountryCodes

Registra em log o acesso a todos os códigos de país compatíveis com o console fiscal. billingconsole.amazonaws.com

GetTaxInvoicesMetadata

Registra a recuperação de metadados de faturas fiscais. billingconsole.amazonaws.com

GetTaxRegistration

Registra em log o acesso ao número de registro fiscal de uma conta. billingconsole.amazonaws.com

GetTotal

Registra a recuperação das cobranças totais da conta. billingconsole.amazonaws.com

GetTotalAmountForForecast

Registra o acesso às cobranças previstas para o período de faturamento específico. billingconsole.amazonaws.com

ListCostAllocationTags

Registra em log a recuperação e a listagem de tags de alocação de custos. billingconsole.amazonaws.com

ListPurchaseOrders

Registra a recuperação e a listagem de pedidos de compra.

purchase-orders.amazonaws.com

ListPurchaseOrderInvoices

Registra a recuperação e a lista de faturas associadas a um pedido de compra.

purchase-orders.amazonaws.com

ListTagsForResource

Lista as tags associadas a um recurso. Para payments, essa ação se refere a um método de pagamento. Para purchase-orders, essa ação se refere a uma ordem de compra.

purchase-orders.amazonaws.com

RedeemPromoCode

Registra em log o resgate de créditos promocionais de uma conta. billingconsole.amazonaws.com

SetAccountContractMetadata

Registra em log a criação, a exclusão ou a atualização das informações de contrato necessárias para clientes do setor público. billingconsole.amazonaws.com

SetAccountPreferences

Registra em log as atualizações do nome da conta, do e-mail e da senha. billingconsole.amazonaws.com

SetAdditionalContacts

Registra em a criação, a exclusão ou a atualização dos contatos alternativos para comunicações de faturamento, operações e segurança. billingconsole.amazonaws.com

SetContactAddress

Registra a criação, a exclusão ou a atualização das informações de contato do proprietário da conta, incluindo o endereço e o número de telefone. billingconsole.amazonaws.com

SetCreatedByOptIn

Registra em log a opção de inclusão da preferência de tag de alocação de custos awscreatedby. billingconsole.amazonaws.com

SetCreditSharing

Registra o histórico da preferência de compartilhamento de crédito da conta de gerenciamento. billingconsole.amazonaws.com

SetFreetierBudgetsPreference

Registra em log a preferência de receber ou não alertas de uso do nível gratuito. billingconsole.amazonaws.com

SetFxPaymentCurrency

Registra em log a criação, a exclusão ou a atualização da moeda de preferência usada para pagar a fatura. billingconsole.amazonaws.com

SetIAMAccessPreference

Registra a criação, exclusão ou atualização da capacidade dos IAM usuários de acessar o console de faturamento. Essa configuração é somente para clientes com acesso raiz. billingconsole.amazonaws.com

SetPANInformation

Registra a criação, exclusão ou atualização de PAN informações AWS na Índia. billingconsole.amazonaws.com

SetPayInformation

Registra o histórico da forma de pagamento (fatura ou cartão de crédito/débito) da conta. billingconsole.amazonaws.com

SetRISharing

Registra o histórico da preferência de compartilhamento de RI/Savings Plans da conta de gerenciamento. billingconsole.amazonaws.com

SetSecurityQuestions

Registra a criação, exclusão ou atualização das perguntas do desafio de segurança para ajudar a AWS identificar você como o proprietário da conta. billingconsole.amazonaws.com

SetTagKeysState

Registra em log o estado ativo ou inativo de determinada tag de alocação de custos. billingconsole.amazonaws.com

TagResource

Registra em log a atribuição de tags a um recurso. Para payments, essa ação se refere a um método de pagamento. Para purchase-orders, essa ação se refere a uma ordem de compra.

purchase-orders.amazonaws.com

UntagResource

Registra em log a exclusão de tags de um recurso. Para payments, essa ação se refere a um método de pagamento. Para purchase-orders, essa ação se refere a uma ordem de compra.

purchase-orders.amazonaws.com

UpdateCustomerVerificationDetails

(Somente para clientes com endereço de cobrança ou contato na Índia)

Registra a atualização dos detalhes de verificação do cliente da conta.

customer-verification.amazonaws.com

UpdateOrigamiReportPreference

Registra a atualização do relatório de uso e de custo; somente para a conta de gerenciamento. billingconsole.amazonaws.com

UpdatePurchaseOrder

Registra a atualização de um pedido de compra.

purchase-orders.amazonaws.com

UpdatePurchaseOrderStatus

Registra a atualização do status de uma ordem de compra.

purchase-orders.amazonaws.com

ValidateAddress

Registra em log a validação do endereço fiscal de uma conta. billingconsole.amazonaws.com

CloudTrail Eventos de pagamentos

Esta seção mostra uma lista completa dos CloudTrail eventos do recurso Pagamentos no AWS Billing console. Esses CloudTrail eventos usam payments.amazonaws.com em vez debillingconsole.amazonaws.com.

Nome do evento Definição

Financing_AcceptFinancingApplicationTerms

Registra a aceitação dos termos em um pedido de financiamento.

Financing_CreateFinancingApplication

Registra a criação de um aplicativo de financiamento.

Financing_GetFinancingApplication

Registra o acesso de um aplicativo de financiamento.

Financing_GetFinancingApplicationDocument

Registra o acesso de um documento associado a um aplicativo de financiamento.

Financing_GetFinancingLine

Registra o acesso de uma linha de financiamento.

Financing_GetFinancingLineWithdrawal

Registra o acesso de uma retirada de linha de financiamento.

Financing_GetFinancingLineWithdrawalDocument

Registra o acesso de um documento associado à retirada de uma linha de financiamento.

Financing_GetFinancingLineWithdrawalStatements

Registra o acesso aos extratos associados à retirada de uma linha de financiamento.

Financing_GetFinancingOption

Registra o acesso a uma opção de financiamento.

Financing_ListFinancingApplications

Registra a lista de metadados do aplicativo de financiamento.

Financing_ListFinancingLines

Registra a lista de metadados da linha de financiamento.

Financing_ListFinancingLineWithdrawals

Registra a lista de metadados de retirada da linha de financiamento.

Financing_UpdateFinancingApplication

Registra a atualização de um aplicativo de financiamento.

Instruments_Authenticate

Registra em log a autenticação do instrumento de pagamento.

Instruments_Create

Registra em log a criação de instrumentos de pagamento.

Instruments_Delete

Registra em log a exclusão de instrumentos de pagamento.

Instruments_Get

Registra em log o acesso a instrumentos de pagamento.

Instruments_List

Registra em log a lista de metadados do instrumento de pagamento.

Instruments_StartCreate

Registra em log as operações antes da criação do instrumento de pagamento.

Instruments_Update

Registra em log a atualização dos instrumentos de pagamento.

ListTagsForResource

Registra em log a lista de tags associadas a um recurso de pagamento.

Policy_GetPaymentInstrumentEligibility

Registra em log o acesso à elegibilidade de instrumentos de pagamento.

Preferences_BatchGetPaymentProfiles

Registra em log o acesso a perfis de pagamento.

Preferences_CreatePaymentProfile

Registra em log a criação de perfis de pagamento.

Preferences_DeletePaymentProfile

Registra em log a exclusão de perfis de pagamento.

Preferences_ListPaymentProfiles

Registra em log a lista de metadados de perfis de pagamento.

Preferences_UpdatePaymentProfile

Registra em log a atualização de perfis de pagamento.

Programs_ListPaymentProgramOptions

Registra a lista de opções do programa de pagamento.

Programs_ListPaymentProgramStatus

Registra a lista de elegibilidade do programa de pagamento e o status da inscrição.

TagResource

Registra em log a atribuição de tags a um recurso de pagamento.

TermsAndConditions_AcceptTermsAndConditionsForProgramByAccountId

Registra em log os termos e condições de pagamentos aceitos.

TermsAndConditions_GetAcceptedTermsAndConditionsForProgramByAccountId

Registra em log o acesso a termos e condições aceitos.

TermsAndConditions_GetRecommendedTermsAndConditionsForProgram

Registra em log o acesso a termos e condições recomendados.

UntagResource

Registra em log a exclusão de tags de um recurso de pagamento.

CloudTrail Eventos de configurações fiscais

Esta seção mostra uma lista completa dos CloudTrail eventos do recurso de configurações fiscais no AWS Billing console. Esses CloudTrail eventos usam taxconsole.amazonaws.com ou tax.amazonaws.com em vez debillingconsole.amazonaws.com.

Nome do evento Definição Origem do evento.

BatchGetTaxExemptions

Registra em log o acesso de uma conta a isenções fiscais dos EUA, e quaisquer contas vinculadas. taxconsole.amazon.com

CreateCustomerCase

Registra em log a criação de um caso de suporte ao cliente para validar a isenção fiscal dos EUA para uma conta. taxconsole.amazonaws.com

DeleteTaxRegistration

Registra em log a exclusão do número de registro fiscal de uma conta.

tax.amazonaws.com

DownloadTaxInvoice

Registra o download de uma fatura fiscal. taxconsole.amazon.com

GetTaxExemptionTypes

Registra em log o acesso a todos os tipos de isenção dos EUA pelo console fiscal. taxconsole.amazon.com

GetTaxInheritance

Registra em log o acesso à preferência de herança fiscal (ativado ou desativado) de uma conta. taxconsole.amazon.com

GetTaxInvoicesMetadata

Registra a recuperação de metadados de faturas fiscais. taxconsole.amazon.com

GetTaxRegistration

Registra em log o acesso ao número de registro fiscal de uma conta. taxconsole.amazon.com

ListTaxRegistrations

Registra em log o acesso aos detalhes do registro fiscal de todas as contas-membro da conta de gerenciamento.

tax.amazonaws.com

PreviewTaxRegistrationChange

Registra a pré-visualização das alterações de registro de impostos antes da confirmação. taxconsole.amazon.com

SetTaxInheritance

Registra em log a preferência da herança fiscal (inclusão ou exclusão). taxconsole.amazon.com

Informações sobre Billing and Cost Management em CloudTrail

CloudTrail é ativado em sua AWS conta quando você cria a conta. Quando uma atividade de evento suportada ocorre no Billing and Cost Management, essa atividade é registrada em CloudTrail um evento junto com AWS outros eventos de serviço no histórico de eventos. Você pode visualizar, pesquisar e baixar eventos recentes em sua AWS conta. Para obter mais informações, consulte Visualização de CloudTrail eventos com histórico de eventos no Guia AWS CloudTrail do usuário.

Para um registro contínuo de eventos em sua AWS conta, incluindo eventos para Billing and Cost Management, crie uma trilha. Uma trilha permite CloudTrail entregar arquivos de log para um bucket do Amazon S3. Por padrão, quando você cria uma trilha no console, a trilha se aplica a todas as AWS regiões. A trilha registra eventos de todas as regiões na AWS partição e entrega os arquivos de log ao bucket do Amazon S3 que você especificar. Além disso, você pode configurar outros AWS serviços para analisar e agir com base nos dados de eventos coletados nos CloudTrail registros.

Para obter mais informações, consulte as informações a seguir.

Cada entrada de log ou evento contém informações sobre quem gerou a solicitação. As informações de identidade ajudam a determinar o seguinte:

  • Se a solicitação foi feita com credenciais raiz ou de IAM usuário.

  • Se a solicitação foi feita com credenciais de segurança temporárias de um perfil ou de um usuário federado.

  • Se a solicitação foi feita por outro AWS serviço.

Para obter mais informações, consulte o CloudTrail userIdentityelemento no Guia AWS CloudTrail do usuário.

CloudTrail exemplos de entrada de registro

Os exemplos a seguir são fornecidos para cenários específicos de entrada de registros do Billing and Cost CloudTrail Management.

Entradas de arquivo de log do Gerenciamento de Faturamento e Custos

Uma trilha é uma configuração que permite a entrega de eventos como arquivos de log para um bucket do Amazon S3 que você especificar. CloudTrail os arquivos de log contêm uma ou mais entradas de log. Um evento representa uma única solicitação de qualquer fonte e inclui informações sobre a ação solicitada, a data e a hora da ação, os parâmetros da solicitação e assim por diante. CloudTrail os arquivos de log não são um rastreamento de pilha ordenado das API chamadas públicas, portanto, eles não aparecem em nenhuma ordem específica.

O exemplo a seguir mostra uma entrada de CloudTrail registro que demonstra a SetContactAddress ação.

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

O exemplo a seguir mostra uma entrada de CloudTrail registro que usa a CreateCustomerCase ação.

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

Pagamentos

O exemplo a seguir mostra uma entrada de CloudTrail registro que usa a Instruments_Create ação.

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