Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Registrazione delle chiamate API del sistema di approvvigionamento con AWS CloudTrail
Marketplace AWS è integrato con AWS CloudTrail, un servizio che fornisce un registro delle azioni intraprese da un utente, un ruolo o un Servizio AWS Marketplace AWS partecipante. CloudTrail acquisisce le chiamate API Marketplace AWS come eventi. Le chiamate acquisite includono chiamate dalla Marketplace AWS console e chiamate di codice alle operazioni Marketplace AWS API. Se crei un trail, puoi abilitare la distribuzione continua di CloudTrail eventi a un bucket Amazon S3. Se non configuri un percorso, puoi comunque visualizzare gli eventi più recenti nella CloudTrail console nella cronologia degli **eventi**. Per ulteriori informazioni, consulta la [Guida per l'utente CloudTrail ](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/).
## Eventi di fatturazione CloudTrail
La tabella seguente mostra CloudTrail gli eventi per le azioni di fatturazione utilizzate con le integrazioni dei sistemi di approvvigionamento. Questi CloudTrail eventi vengono utilizzati `invoicing.amazonaws.com` come origine degli eventi.
**Eventi di fatturazione CloudTrail**
| Nome evento | Definizione |
| --- | --- |
| CreateProcurementPortalPreference | Registra la creazione di una preferenza per il portale di approvvigionamento. |
| GetProcurementPortalPreference | Registra il recupero di una preferenza del portale di approvvigionamento. |
| ListProcurementPortalPreferences | Registra il recupero e l'elenco delle preferenze del portale di approvvigionamento. |
## Marketplace AWS informazioni in AWS CloudTrail
CloudTrail è abilitato sul tuo account al Account AWS momento della creazione dell'account. Quando si verifica un'attività supportata in Marketplace AWS, tale attività viene registrata in un CloudTrail evento insieme ad altri Servizio AWS eventi nella **Cronologia degli eventi**. Puoi visualizzare, cercare e scaricare eventi recenti in Account AWS. Per ulteriori informazioni, consulta [Visualizzazione degli eventi con cronologia degli CloudTrail eventi](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html) nella *Guida CloudTrail per l'utente*.
Per una registrazione continua degli eventi nell' Account AWS che includa gli eventi per Marketplace AWS, crea un trail. Un trail consente di CloudTrail inviare file di log a un bucket Amazon S3. Per impostazione predefinita, quando si crea un trail nella console, il trail sarà valido in tutte le Regioni AWS . Il trail registra gli eventi di tutte le regioni della AWS partizione e consegna i file di log al bucket Amazon S3 specificato. Inoltre, puoi configurare altri AWS servizi per analizzare ulteriormente e agire in base ai dati sugli eventi raccolti nei log. CloudTrail Per ulteriori informazioni, consulta gli argomenti seguenti:
+ [Panoramica della creazione di un percorso](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html)
+ [CloudTrail servizi e integrazioni supportati](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-aws-service-specific-topics.html#cloudtrail-aws-service-specific-topics-integrations)
+ [Configurazione delle notifiche Amazon SNS per CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/getting_notifications_top_level.html)
+ [Ricezione di file di CloudTrail registro da più regioni](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/receive-cloudtrail-log-files-from-multiple-regions.html)
+ [Ricezione di file di CloudTrail registro da più account](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-receive-logs-from-multiple-accounts.html)
Ogni evento o voce di log contiene informazioni sull’utente che ha generato la richiesta. Le informazioni di identità consentono di determinare quanto segue:
+ Se la richiesta è stata effettuata con credenziali root o AWS Identity and Access Management utente.
+ Se la richiesta è stata effettuata con credenziali di sicurezza temporanee per un ruolo o un utente federato.
+ Se la richiesta è stata effettuata da un altro Servizio AWS.
Per ulteriori informazioni, vedete l'[elemento CloudTrail userIdentity nella Guida](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html) per l'*CloudTrail utente*.
## CloudTrail esempi di immissione di log
Un trail è una configurazione che consente la distribuzione di eventi come file di log in un bucket Amazon S3 specificato dall'utente. CloudTrail i file di registro contengono una o più voci di registro. Un evento rappresenta una singola richiesta proveniente da qualsiasi fonte e include informazioni sull'azione richiesta, la data e l'ora dell'azione, i parametri della richiesta e così via. CloudTrail i file di registro non sono una traccia ordinata dello stack delle chiamate API pubbliche, quindi non vengono visualizzati in un ordine specifico.
L'esempio seguente mostra una voce di CloudTrail registro che illustra l'`CreateProcurementPortalPreference`azione.
```
{
"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"
}
```