Registrar llamadas a la API de Billing and Cost Management con AWS CloudTrail

Billing and Cost Management está integrado con AWS CloudTrail un servicio que proporciona un registro de las acciones realizadas por un usuario, un rol o un AWS servicio en Billing and Cost Management. CloudTrail captura las llamadas a la API de Billing and Cost Management como eventos, incluidas las llamadas desde la consola de Billing and Cost Management y las llamadas en código a las API de Billing and Cost Management. Para obtener una lista completa de CloudTrail los eventos relacionados con la facturación, consulte CloudTrail Eventos de facturación.

Si crea un registro, puede habilitar la entrega continua de CloudTrail eventos a un bucket de Amazon S3, incluidos los eventos de Billing and Cost Management. Si no configura una ruta, podrá ver los eventos más recientes en la CloudTrail consola, en el historial de eventos. Con la información recopilada por CloudTrail, puede determinar la solicitud que se realizó a Billing and Cost Management, la dirección IP desde la que se realizó la solicitud, quién la hizo, cuándo se realizó y detalles adicionales.

Para obtener más información CloudTrail, incluido cómo configurarlo y habilitarlo, consulte la Guía del AWS CloudTrail usuario.

CloudTrail Eventos de facturación

En esta sección se muestra una lista completa de los CloudTrail eventos relacionados con Billing and Cost Management.

Notas

Los siguientes CloudTrail eventos utilizan una fuente de eventos diferente en lugar debillingconsole.amazonaws.com:

• CreateCustomerCase, GetTaxExemptionTypes y BatchGetTaxExemptions utilizan taxconsole.amazonaws.com.

• CreateCustomerVerificationDetails, GetCustomerVerificationDetails GetCustomerVerificationEligibility y UpdateCustomerVerificationDetails usan customer-verification.amazonaws.com.

• AddPurchaseOrder, DeletePurchaseOrder, ListPurchaseOrders, GetPurchaseOrder, ListPurchaseOrderInvoices, UpdatePurchaseOrderStatus, UpdatePurchaseOrder, TagResource, UntagResource y ListTagsForResource usan purchase-orders.amazonaws.com.

Nombre de evento	Definición
AddPurchaseOrder	Registra la creación de una orden de compra.
AcceptFxPaymentCurrencyTermsAndConditions	Registra la aceptación de los términos y condiciones de pago en una divisa distinta a USD.
BatchGetTaxExemptions	Registra el acceso a las exenciones fiscales estadounidenses de una cuenta y todas las cuentas vinculadas.
CloseAccount	Registra el cierre de una cuenta.
CreateCustomerCase	Registra la creación de un caso de atención al cliente para validar la exención fiscal estadounidense de una cuenta.
CreateCustomerVerificationDetails	(Solo para clientes con una dirección de facturación o de contacto en la India) Registra la creación de los detalles de verificación del cliente de la cuenta.
CreateOrigamiReportPreference	Registra la creación del informe de uso y costos; solo la cuenta de administración.
DeletePurchaseOrder	Registra la eliminación de una orden de compra.
DeleteOrigamiReportPreferences	Registra la eliminación del informe de uso y costos; solo la cuenta de administración.
DownloadCommercialInvoice	Registra la descarga de una factura comercial.
DownloadECSVForBillingPeriod	Registra la descarga del archivo eCSV (informe de uso mensual) para un periodo de facturación específico.
DownloadRegistrationDocument	Registra la descarga del documento de registro fiscal.
DownloadTaxInvoice	Registra la descarga de una factura fiscal.
EnableBillingAlerts	Registra la opción de recibir alertas de CloudWatch facturación sobre los cargos estimados.
FindECSVForBillingPeriod	Registra la recuperación del archivo ECSV para un periodo de facturación específico.
GetAccountEDPStatus	Registra la recuperación del estado de EDP de la cuenta.
GetAddresses	Registra el acceso a la dirección fiscal, la dirección de facturación y la dirección de contacto de una cuenta.
GetAllAccounts	Registra el acceso a todos los números de cuenta de miembro de la cuenta de administración.
GetAllAccountDetails	Registra el acceso a la información de identificación fiscal de todas las cuentas de miembro de la cuenta de administración.
GetBillsForBillingPeriod	Registra el acceso del uso y de los cargos de la cuenta para un periodo de facturación específico.
GetBillsForLinkedAccount	Registra el acceso de una cuenta de administración que recupera el uso y los cargos de una de las cuentas de miembro de la familia de facturación unificada para un periodo de facturación específico.
GetCommercialInvoicesForBillingPeriod	Registra el acceso a los metadatos de las facturas comerciales de la cuenta para un periodo de facturación específico.
GetConsolidatedBillingFamilySummary	Registra el acceso de la cuenta de administración que recupera el resumen de toda la familia de facturación unificada.
GetCustomerVerificationEligibility	(Solo para clientes con una dirección de facturación o de contacto en la India) Registra la recuperación de la elegibilidad de verificación del cliente de la cuenta.
GetCustomerVerificationDetails	(Solo para clientes con una dirección de facturación o de contacto en la India) Registra la recuperación de los detalles de verificación del cliente de la cuenta.
GetLinkedAccountNames	Registra la recuperación desde una cuenta de administración de los nombres de las cuentas de miembro pertenecientes a su familia de facturación unificada para un periodo de facturación específico.
GetPurchaseOrder	Registra la recuperación de una orden de compra.
GetSupportedCountryCodes	Registra el acceso a todos los códigos de país admitidos por la consola de impuestos.
GetTaxExemptionTypes	Registra el acceso a la consola de todos los tipos de exenciones estadounidenses admitidos por impuesto.
GetTaxInheritance	Registra el acceso a la preferencia de herencia fiscal (activar o desactivar) de una cuenta.
GetTaxInvoicesMetadata	Registra la recuperación de los metadatos de las facturas fiscales.
GetTaxRegistration	Registra el acceso al número de registro fiscal de una cuenta.
GetTotal	Registra la recuperación de los cargos totales de la cuenta.
GetTotalAmountForForecast	Registra el acceso a los cargos estimados para el periodo de facturación especificado.
ListCostAllocationTags	Registra la recuperación y la lista de etiquetas de asignación de costos.
ListPurchaseOrders	Registra la recuperación y el listado de una orden de compra.
ListPurchaseOrderInvoices	Registra la recuperación y el listado de facturas asociadas a una orden de compra.
ListTagsForResource	Muestra las etiquetas asociadas a un recurso para una orden de compra.
PreviewTaxRegistrationChange	Registra la vista previa de los cambios de registro fiscal antes de la confirmación.
RedeemPromoCode	Registra el canje de créditos promocionales para una cuenta.
SetAccountContractMetadata	Registra la creación, eliminación o actualización de la información de contrato necesaria para los clientes del sector público.
SetAccountPreferences	Registra las actualizaciones del nombre de la cuenta, el correo electrónico y la contraseña.
SetAdditionalContacts	Registra la creación, eliminación o actualización de los contactos alternativos para las comunicaciones de facturación, operaciones y seguridad.
SetContactAddress	Registra la creación, la eliminación o la actualización de la información de contacto del propietario de la cuenta, incluidos el domicilio y el número de teléfono.
SetCreatedByOptIn	Registra el alta de la preferencia de etiqueta de asignación de costos awscreatedby.
SetCreditSharing	Registra el historial de la preferencia de crédito compartido para la cuenta de administración.
SetFreetierBudgetsPreference	Registra la preferencia (alta o baja) de recibir alertas de uso de capa gratuita.
SetFxPaymentCurrency	Registra la creación, eliminación o actualización de la divisa de preferencia utilizada para pagar la factura.
SetIAMAccessPreference	Registra la creación, la eliminación o la actualización de la capacidad de los usuarios de IAM para acceder a la consola de facturación. Esta configuración es solo para clientes con acceso raíz.
SetPANInformation	Registra la creación, eliminación o actualización de la información del PAN en AWS India.
SetPayInformation	Registra el historial de métodos de pago (factura o tarjeta de crédito/débito) de la cuenta.
SetRISharing	Registra el historial de la preferencia de instancias reservadas/Savings Plans compartidos para la cuenta de administración.
SetSecurityQuestions	Registra la creación, eliminación o actualización de las preguntas de seguridad para ayudarte a AWS identificarte como propietario de la cuenta.
SetTagKeysState	Registra el estado activo o inactivo de una etiqueta de asignación de costo concreta.
SetTaxInheritance	Registra la preferencia (darse de alta o de baja) de herencia fiscal.
SetTaxRegistration	Registra la creación, eliminación o actualización del número de registro fiscal de una cuenta.
TagResource	Registra el etiquetado de un recurso para una orden de compra.
UntagResource	Registra la eliminación de etiquetas de un recurso para una orden de compra.
UpdateCustomerVerificationDetails	(Solo para clientes con una dirección de facturación o de contacto en la India) Registra la recuperación de los detalles de verificación del cliente de la cuenta.
UpdateOrigamiReportPreference	Registra la actualización del informe de uso y costos; solo la cuenta de administración.
UpdatePurchaseOrder	Registra la actualización de una orden de compra.
UpdatePurchaseOrderStatus	Registra la actualización del estado de una orden de compra.
ValidateAddress	Registra la validación de la dirección fiscal de una cuenta.

Información sobre Billing and Cost Management en CloudTrail

CloudTrail está habilitada en su AWS cuenta al crear la cuenta. Cuando se produce una actividad de eventos admitida en Billing and Cost Management, esa actividad se registra en un CloudTrail evento junto con otros eventos de AWS servicio en el historial de eventos. Puedes ver, buscar y descargar los eventos recientes en tu AWS cuenta. Para obtener más información, consulte Visualización de eventos con el historial de CloudTrail eventos en la Guía del AWS CloudTrail usuario.

Para tener un registro continuo de los eventos de su AWS cuenta, incluidos los eventos de Billing and Cost Management, cree un registro. Un rastro permite CloudTrail entregar archivos de registro a un bucket de Amazon S3. De forma predeterminada, cuando crea una ruta en la consola, la ruta se aplica a todas AWS las regiones. La ruta registra los eventos de todas las regiones de la AWS partición y envía los archivos de registro al bucket de Amazon S3 que especifique. Además, puede configurar otros AWS servicios para analizar más a fondo los datos de eventos recopilados en los CloudTrail registros y actuar en función de ellos.

Para más información, consulte los siguientes temas:

• Introducción a la creación de registros de seguimiento

• CloudTrail Integraciones y servicios compatibles

• Configuración de las notificaciones de Amazon SNS para CloudTrail

• Recibir archivos de CloudTrail registro de varias regiones y recibir archivos de CloudTrail registro de varias cuentas

Cada entrada de registro o evento contiene información sobre quién generó la solicitud. La información de identidad del usuario lo ayuda a determinar lo siguiente:

• Si la solicitud se realizó con las credenciales raíz o del usuario de IAM.

• Si la solicitud se realizó con credenciales de seguridad temporales de un rol o fue un usuario federado.

• Si la solicitud la realizó otro AWS servicio.

Para obtener más información, consulte el elemento CloudTrail UserIdentity en la Guía del usuario.AWS CloudTrail

CloudTrail ejemplos de entradas de registro

Los siguientes ejemplos se proporcionan para escenarios específicos de entrada en el CloudTrail registro de Billing and Cost Management.

Entradas del archivo de registros Administración y facturación de costos

Un rastro es una configuración que permite la entrega de eventos como archivos de registro a un bucket de Amazon S3 que usted especifique. CloudTrail Los archivos de registro contienen una o más entradas de registro. Un evento representa una solicitud única de cualquier fuente e incluye información sobre la acción solicitada, la fecha y la hora de la acción, los parámetros de la solicitud, etc. CloudTrail Los archivos de registro no son un seguimiento ordenado de las llamadas a la API pública, por lo que no aparecen en ningún orden específico.

En el siguiente ejemplo, se muestra una entrada de CloudTrail registro que demuestra la SetContactAddress acción.

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

Consola fiscal

El siguiente ejemplo muestra una entrada de CloudTrail registro que utiliza la CreateCustomerCase acción.

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