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 API do sistema de compras com AWS CloudTrail
AWS Marketplace é integrado com AWS CloudTrail, um serviço que fornece um registro das ações realizadas por um usuário, uma função ou um AWS service (Serviço da AWS) usuário AWS Marketplace. CloudTrail captura chamadas de API AWS Marketplace como eventos. As chamadas capturadas incluem chamadas do AWS Marketplace console e chamadas de código para as operações AWS Marketplace da API. Se você criar uma trilha, poderá habilitar a entrega contínua de CloudTrail eventos para um bucket do Amazon S3. Se você não configurar uma trilha, ainda poderá ver os eventos mais recentes no CloudTrail console no **Histórico de eventos**. Para obter mais informações, consulte o [Guia do usuário do CloudTrail ](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/).
## Eventos de faturamento CloudTrail
A tabela a seguir mostra os CloudTrail eventos das ações de faturamento usadas com as integrações do sistema de compras. Esses CloudTrail eventos são usados `invoicing.amazonaws.com` como fonte do evento.
**Eventos de faturamento CloudTrail**
| Nome do evento | Definição |
| --- | --- |
| CreateProcurementPortalPreference | Registra a criação de uma preferência no portal de compras. |
| GetProcurementPortalPreference | Registra a recuperação de uma preferência do portal de compras. |
| ListProcurementPortalPreferences | Registra a recuperação e a listagem das preferências do portal de compras. |
## AWS Marketplace informações em AWS CloudTrail
CloudTrail é ativado no seu Conta da AWS quando você cria a conta. Quando uma atividade de evento suportada ocorre em AWS Marketplace, essa atividade é registrada em um CloudTrail evento junto com outros AWS service (Serviço da AWS) eventos no **histórico de eventos**. Você pode visualizar, pesquisar e baixar eventos recentes no seu Conta da AWS. Para obter mais informações, consulte [Visualização de CloudTrail eventos com histórico](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html) de eventos no *Guia CloudTrail do usuário*.
Para obter um registro contínuo de eventos na sua Conta da AWS, incluindo eventos para o AWS Marketplace, crie uma trilha. Uma trilha permite CloudTrail entregar arquivos de log para um bucket do Amazon S3. Por padrão, quando uma trilha é criada no console, a mesma é aplicada a todas as regiões da AWS . 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 saber mais, consulte:
+ [Visão geral da criação de uma trilha](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html)
+ [CloudTrail serviços e integrações suportados](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-aws-service-specific-topics.html#cloudtrail-aws-service-specific-topics-integrations)
+ [Configurando notificações do Amazon SNS para CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/getting_notifications_top_level.html)
+ [Recebendo arquivos de CloudTrail log de várias regiões](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/receive-cloudtrail-log-files-from-multiple-regions.html)
+ [Recebendo arquivos de CloudTrail log de várias contas](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-receive-logs-from-multiple-accounts.html)
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 AWS Identity and Access Management usuário.
+ Se a solicitação foi feita com credenciais de segurança temporárias de uma função ou de um usuário federado.
+ Se a solicitação foi feita por outro AWS service (Serviço da AWS).
Para obter mais informações, consulte o [elemento CloudTrail userIdentity](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html) no Guia do *CloudTrail usuário*.
## CloudTrail exemplos de entrada de registro
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 chamadas públicas de API, portanto, eles não aparecem em nenhuma ordem específica.
O exemplo a seguir mostra uma entrada de CloudTrail registro que demonstra a `CreateProcurementPortalPreference` ação.
```
{
"eventVersion": "1.11",
"userIdentity": {
"type": "AssumedRole",
"principalId": "AROAEXAMPLEID:ExampleUser",
"arn": "arn:aws:sts::111122223333:assumed-role/Admin/ExampleUser",
"accountId": "111122223333",
"accessKeyId": "AKIAIOSFODNN7EXAMPLE",
"sessionContext": {
"sessionIssuer": {
"type": "Role",
"principalId": "AROAEXAMPLEID",
"arn": "arn:aws:iam::111122223333:role/Admin",
"accountId": "111122223333",
"userName": "Admin"
},
"attributes": {
"creationDate": "2026-03-16T15:44:15Z",
"mfaAuthenticated": "false"
}
},
"inScopeOf": {}
},
"eventTime": "2026-03-16T15:45:27Z",
"eventSource": "invoicing.amazonaws.com",
"eventName": "CreateProcurementPortalPreference",
"awsRegion": "us-east-1",
"sourceIPAddress": "192.0.2.1",
"userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:148.0) Gecko/20100101 Firefox/148.0",
"requestParameters": {
"ProcurementPortalName": "COUPA",
"BuyerDomain": "NetworkID",
"BuyerIdentifier": "da1307f028f21a95876634f3afaf23a8",
"SupplierDomain": "NetworkID",
"SupplierIdentifier": "da1307f028f21a95876634f3afaf23a8",
"EinvoiceDeliveryEnabled": true,
"PurchaseOrderRetrievalEnabled": false,
"Contacts": "HIDDEN_DUE_TO_SECURITY_REASONS",
"Selector": {
"InvoiceUnitArns": [],
"SellerOfRecords": []
},
"ProcurementPortalSharedSecret": "HIDDEN_DUE_TO_SECURITY_REASONS",
"ProcurementPortalInstanceEndpoint": "https://example.com",
"EinvoiceDeliveryPreference": {
"EinvoiceDeliveryDocumentTypes": [
"AWS_MARKETPLACE_INVOICE"
],
"Protocol": "CXML",
"PurchaseOrderDataSources": [
{
"EinvoiceDeliveryDocumentType": "AWS_MARKETPLACE_INVOICE",
"PurchaseOrderDataSourceType": "ASSOCIATED_PURCHASE_ORDER_REQUIRED"
}
],
"ConnectionTestingMethod": "PROD_ENV_DOLLAR_TEST",
"EinvoiceDeliveryActivationDate": 1773619200,
"EinvoiceDeliveryAttachmentTypes": []
},
"ClientToken": "c333a7e9-17d6-4f58-a4a1-EXAMPLE"
},
"responseElements": {
"ProcurementPortalPreferenceArn": "arn:aws:invoicing::111122223333:procurement-portal-preference/090d2e03-EXAMPLE"
},
"requestID": "935ec8a3-b9dd-4309-b975-EXAMPLE",
"eventID": "b15c33a2-36a3-4b0a-b2e4-EXAMPLE",
"readOnly": false,
"eventType": "AwsApiCall",
"managementEvent": true,
"recipientAccountId": "111122223333",
"eventCategory": "Management",
"tlsDetails": {
"clientProvidedHostHeader": "invoicing.us-east-1.api.aws"
},
"sessionCredentialFromConsole": "true"
}
```