View a markdown version of this page

Registrare le chiamate API con AWS CloudTrail per AWS Organizations - AWS Organizations

Registrare le chiamate API con AWS CloudTrail per AWS Organizations

AWS Organizations è integrato con AWS CloudTrail, un servizio che offre un record delle operazioni eseguite da un utente, un ruolo o un servizio AWS in AWS Organizations. CloudTrail acquisisce tutte le chiamate API per AWS Organizations come eventi, incluse le chiamate dalla console AWS Organizations e dalle chiamate di codice alle API AWS Organizations. Se viene creato un trail, è possibile abilitare la distribuzione continua di eventi CloudTrail in un bucket Amazon S3, inclusi gli eventi per AWS Organizations. Se non si configura un trail, è comunque possibile visualizzare gli eventi più recenti nella console di CloudTrail in Event history (Cronologia eventi). Le informazioni raccolte da CloudTrail consentono di determinare la richiesta effettuata ad AWS Organizations, l'indirizzo IP da cui è partita la richiesta, l'autore della richiesta, il momento in cui è stata eseguita e altri dettagli.

Per ulteriori informazioni su CloudTrail, consulta la Guida per l'utente di AWS CloudTrail.

Importante

È possibile visualizzare tutte le informazioni di CloudTrail solo per AWS Organizations nella Regione Stati Uniti orientali (Virginia settentrionale). Se non vedi l'attività AWS Organizations nella console CloudTrail, impostala su Stati Uniti orientali (Virginia settentrionale) utilizzando il menu nell'angolo superiore destro. Se interroghi CloudTrail con il comando AWS CLI o gli strumenti SDK, indirizza la query all'endpoint Stati Uniti orientali (Virginia settentrionale).

AWS OrganizationsInformazioni su in CloudTrail

CloudTrail è abilitato sul tuo Account AWSal momento della sua creazione. Quando si verifica un'attività su AWS Organizations, questa viene registrata in un evento CloudTrail insieme ad altri eventi di servizio AWS nella Cronologia degli eventi. Puoi visualizzare, cercare e scaricare gli eventi recenti in Account AWS. Per ulteriori informazioni, consulta Visualizzazione di eventi mediante la cronologia eventi di CloudTrail.

Per una registrazione continua degli eventi nell'Account AWS che includa gli eventi per AWS Organizations, crea un trail. Un percorso abilita l’implementazione da parte di CloudTrail dei file di log in un bucket Amazon S3. Quando la registrazione di CloudTrail è abilitata nell'Account AWS, le chiamate API effettuate alle operazioni AWS Organizations vengono tracciate in file di log di CloudTrail, dove vengono scritte con altri record del servizio AWS. Puoi configurare altri Servizi AWS per analizzare con maggiore dettaglio e agire sui dati dell’evento raccolti nei log di CloudTrail. Per ulteriori informazioni, consulta gli argomenti seguenti:

Tutte le operazioni AWS Organizations vengono registrate da CloudTrail e sono documentate nella documentazione di riferimento delle API di AWS Organizations. Ad esempio, le chiamate a CreateAccount (incluso l'evento CreateAccountResult), ListHandshakesForAccount, CreatePolicy e InviteAccountToOrganization generano voci nei file di log di CloudTrail.

Ogni voce di log contiene informazioni sull'utente che ha generato la richiesta. Le informazioni sull'identità dell'utente nella voce di log ti permettono di determinare quanto segue:

  • Se la richiesta è stata effettuata con le credenziali utente root o utente IAM

  • Se la richiesta è stata effettuata con le credenziali di sicurezza temporanee per un ruolo IAM o un utente federato

  • Se la richiesta è stata effettuata da un altro servizio AWS.

Per ulteriori informazioni, consultare l'argomento relativo all'elemento userIdentity di CloudTrail.

Nota

CloudTrail registrerà gli eventi nell’account che esegue una determinata azione (ad esempio nell’account membro anziché nell’account di gestione se l’account membro ha intrapreso l’azione). Ad esempio, un account membro che lascia un’organizzazione verrà registrato nella traccia dell’account membro e un account di gestione che rimuove un account membro verrà registrato nella traccia dell’account di gestione.

Informazioni sulle voci dei file di log di AWS Organizations

Un trail è una configurazione che consente la distribuzione di eventi come i file di log in un bucket Amazon S3 specificato. I file di log di CloudTrail possono contenere una o più voci di log. Un evento rappresenta una singola richiesta da un'origine e include informazioni sull'operazione richiesta, sulla data e sull'ora dell'operazione, sui parametri richiesti e così via. I file di log CloudTrail non sono una traccia dello stack ordinata delle chiamate API pubbliche e di conseguenza non devono apparire in base a un ordine specifico.

Esempio di voci di log: CreateAccount

L'esempio seguente mostra una voce di log di CloudTrail per una chiamata CloseAccount di esempio, che viene generata quando l'API viene invocata e il flusso di lavoro per la chiusura dell'account avvia l'elaborazione in background.

{ "eventVersion": "1.08", "userIdentity": { "type": "IAMUser", "principalId": "AIDAMVNPBQA3EXAMPLE:my-admin-role", "arn": "arn:aws:sts::111122223333:assumed-role/my-admin-role/my-session-id", "accountId": "111122223333", "accessKeyId": "AKIAIOSFODNN7EXAMPLE", "sessionContext": { "sessionIssuer": { "type": "Role", "principalId": "AIDAMVNPBQA3EXAMPLE", "arn": "arn:aws:iam::111122223333:role/my-admin-role", "accountId": "111122223333", "userName": "my-session-id" }, "webIdFederationData": {}, "attributes": { "mfaAuthenticated": "false", "creationDate": "2022-03-18T18:17:06Z" } } }, "eventTime": "2022-03-18T18:17:06Z", "eventSource": "organizations.amazonaws.com", "eventName": "CloseAccount", "awsRegion": "us-east-1", "sourceIPAddress": "192.168.0.1", "userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)...", "requestParameters": { "accountId": "555555555555" }, "responseElements": null, "requestID": "e28932f8-d5da-4d7a-8238-ef74f3d5c09a", "eventID": "19fe4c10-f57e-4cb7-a2bc-6b5c30233592", "readOnly": false, "eventType": "AwsApiCall", "managementEvent": true, "recipientAccountId": "111122223333", "eventCategory": "Management" }

L'esempio seguente mostra una voce di log di CloudTrail per una chiamata CloseAccountResult dopo il corretto completamento del flusso di lavoro in background per la chiusura dell'account.

{ "eventVersion": "1.08", "userIdentity": { "accountId": "111122223333", "invokedBy": "organizations.amazonaws.com" }, "eventTime": "2022-03-18T18:17:06Z", "eventSource": "organizations.amazonaws.com", "eventName": "CloseAccountResult", "awsRegion": "us-east-1", "sourceIPAddress": "organizations.amazonaws.com", "userAgent": "organizations.amazonaws.com", "requestParameters": null, "responseElements": null, "eventID": "EXAMPLE8-90ab-cdef-fedc-ba987EXAMPLE", "readOnly": false, "eventType": "AwsServiceEvent", "readOnly": false, "eventType": "AwsServiceEvent", "managementEvent": true, "recipientAccountId": "111122223333", "serviceEventDetails": { "closeAccountStatus": { "accountId": "555555555555", "state": "SUCCEEDED", "requestedTimestamp": "Mar 18, 2022 6:16:58 PM", "completedTimestamp": "Mar 18, 2022 6:16:58 PM" } }, "eventCategory": "Management" }

Esempio di voci di log: CreateAccount

L'esempio seguente mostra una voce di log di CloudTrail per una chiamata CreateAccount di esempio, che viene generata quando l'API viene invocata e il flusso di lavoro per la creazione dell'account avvia l'elaborazione in background.

{ "eventVersion": "1.05", "userIdentity": { "type": "IAMUser", "principalId": "AIDAMVNPBQA3EXAMPLE:my-admin-role", "arn": "arn:aws:sts::111122223333:assumed-role/my-admin-role/my-session-id", "accountId": "111122223333", "accessKeyId": "AKIAIOSFODNN7EXAMPLE", "sessionContext": { "sessionIssuer": { "type": "Role", "principalId": "AIDAMVNPBQA3EXAMPLE", "arn": "arn:aws:iam::111122223333:role/my-admin-role", "accountId": "111122223333", "userName": "my-session-id" }, "webIdFederationData": {}, "attributes": { "mfaAuthenticated": "false", "creationDate": "2020-09-16T21:16:45Z" } } }, "eventTime": "2018-06-21T22:06:27Z", "eventSource": "organizations.amazonaws.com", "eventName": "CreateAccount", "awsRegion": "us-east-1", "sourceIPAddress": "192.168.0.1", "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64)...", "requestParameters": { "tags": [], "email": "****", "accountName": "****" }, "responseElements": { "createAccountStatus": { "accountName": "****", "state": "IN_PROGRESS", "id": "car-examplecreateaccountrequestid111", "requestedTimestamp": "Sep 16, 2020 9:20:50 PM" } }, "requestID": "EXAMPLE8-90ab-cdef-fedc-ba987EXAMPLE", "eventID": "EXAMPLE8-90ab-cdef-fedc-ba987EXAMPLE", "eventType": "AwsApiCall", "recipientAccountId": "111111111111" }

L'esempio seguente mostra una voce di log di CloudTrail per una chiamata CreateAccountdopo il corretto completamento del flusso di lavoro in background per la creazione dell'account.

{ "eventVersion": "1.05", "userIdentity": { "accountId": "111122223333", "invokedBy": "..." }, "eventTime": "2020-09-16T21:20:53Z", "eventSource": "organizations.amazonaws.com", "eventName": "CreateAccountResult", "awsRegion": "us-east-1", "sourceIPAddress": "192.0.2.0", "userAgent": "....", "requestParameters": null, "responseElements": null, "eventID": "EXAMPLE8-90ab-cdef-fedc-ba987EXAMPLE", "readOnly": false, "eventType": "AwsServiceEvent", "recipientAccountId": "111122223333", "serviceEventDetails": { "createAccountStatus": { "id": "car-examplecreateaccountrequestid111", "state": "SUCCEEDED", "accountName": "****", "accountId": "444455556666", "requestedTimestamp": "Sep 16, 2020 9:20:50 PM", "completedTimestamp": "Sep 16, 2020 9:20:53 PM" } } }

L'esempio seguente mostra una voce di log di CloudTrail generata dopo che un flusso di lavoro CreateAccount in background non completa la creazione dell'account.

{ "eventVersion": "1.06", "userIdentity": { "accountId": "111122223333", "invokedBy": "AWS Internal" }, "eventTime": "2018-06-21T22:06:27Z", "eventSource": "organizations.amazonaws.com", "eventName": "CreateAccountResult", "awsRegion": "us-east-1", "sourceIPAddress": "AWS Internal", "userAgent": "AWS Internal", "requestParameters": null, "responseElements": null, "eventID": "EXAMPLE8-90ab-cdef-fedc-ba987EXAMPLE", "readOnly": false, "eventType": "AwsServiceEvent", "recipientAccountId": "111122223333", "serviceEventDetails": { "createAccountStatus": { "id": "car-examplecreateaccountrequestid111", "state": "FAILED", "accountName": "****", "failureReason": "EMAIL_ALREADY_EXISTS", "requestedTimestamp": Jun 21, 2018 10:06:27 PM, "completedTimestamp": Jun 21, 2018 10:07:15 PM } } }

Esempio di voci di log: AcceptResponsibilityTransfer

Quando AWS Organizations accetta un trasferimento della responsabilità di fatturazione, pubblica un evento di servizio ResponsibilityTransferAccepted su ciascun account interessato. Per i trasferimenti concatenati, AWS Organizations avvisa anche i partecipanti a monte. Il campo transferChain elenca gli ID di trasferimento interessati, compresi quelli accettati fino al trasferimento upstream maggiormente interessato.

L’esempio seguente mostra una voce di log di CloudTrail inviata a un account di distribuzione upstream (111122223333) dopo che AWS Organizations accetta un trasferimento a valle (rt-5ipg3ess). Il campo transferChain include sia il trasferimento accettato che il trasferimento upstream interessato (rt-9zpzuocg).

{ "eventVersion": "1.11", "userIdentity": { "type": "AWSService", "invokedBy": "AWS Internal" }, "eventTime": "2026-08-12T19:50:27Z", "eventSource": "organizations.amazonaws.com", "eventName": "ResponsibilityTransferAccepted", "awsRegion": "us-east-1", "sourceIPAddress": "AWS Internal", "userAgent": "AWS Internal", "requestParameters": null, "responseElements": null, "eventID": "EXAMPLE8-90ab-cdef-fedc-ba987EXAMPLE", "readOnly": false, "eventType": "AwsServiceEvent", "managementEvent": true, "recipientAccountId": "111122223333", "sharedEventID": "EXAMPLEa-121c-425d-bb01-1d94aEXAMPLE", "serviceEventDetails": { "id": "rt-5ipg3ess", "transferChain": [ "rt-5ipg3ess", "rt-9zpzuocg" ], "type": "BILLING", "status": "ACCEPTED", "source": { "managementAccountId": "555555555555" }, "target": { "managementAccountId": "444455556666" }, "requester": "555555555555", "startTimestamp": 1790812800000 }, "eventCategory": "Management" }

Voci di log di esempio: TerminateResponsibilityTransfer

Quando termina un trasferimento di responsabilità di fatturazione, AWS Organizations pubblica un evento di servizio ResponsibilityTransferTerminated su ciascun account interessato. Per i trasferimenti concatenati, anche i partecipanti a monte, come i distributori, ricevono una notifica. Il campo transferChain elenca gli ID di trasferimento interessati, compresi quelli terminati fino al trasferimento upstream maggiormente interessato.

L’esempio seguente mostra una voce di log di CloudTrail inviata a un account di distribuzione upstream (111122223333) dopo che AWS Organizations termina un trasferimento a valle (rt-5ipg3ess). Il campo transferChain include sia il trasferimento terminato che il trasferimento upstream interessato (rt-9zpzuocg).

{ "eventVersion": "1.11", "userIdentity": { "type": "AWSService", "invokedBy": "AWS Internal" }, "eventTime": "2026-08-12T18:17:06Z", "eventSource": "organizations.amazonaws.com", "eventName": "ResponsibilityTransferTerminated", "awsRegion": "us-east-1", "sourceIPAddress": "AWS Internal", "userAgent": "AWS Internal", "requestParameters": null, "responseElements": null, "eventID": "EXAMPLE8-90ab-cdef-fedc-ba987EXAMPLE", "readOnly": false, "eventType": "AwsServiceEvent", "managementEvent": true, "recipientAccountId": "111122223333", "sharedEventID": "EXAMPLEa-121c-425d-bb01-1d94aEXAMPLE", "serviceEventDetails": { "id": "rt-5ipg3ess", "transferChain": [ "rt-5ipg3ess", "rt-9zpzuocg" ], "type": "BILLING", "status": "WITHDRAWN", "source": { "managementAccountId": "444455556666" }, "target": { "managementAccountId": "555555555555" }, "requester": "444455556666", "startTimestamp": 1790812800000, "endTimestamp": 1790812800000 }, "eventCategory": "Management" }

Esempio di voce di log: CreateOrganizationalUnit

Nell'esempio seguente viene mostrata una voce di log di CloudTrail per una chiamata CreateOrganizationalUnit di esempio.

{ "eventVersion": "1.05", "userIdentity": { "type": "IAMUser", "principalId": "AIDAMVNPBQA3EXAMPLE", "arn": "arn:aws:iam::111111111111:user/diego", "accountId": "111111111111", "accessKeyId": "AKIAIOSFODNN7EXAMPLE", "userName": "diego" }, "eventTime": "2017-01-18T21:40:11Z", "eventSource": "organizations.amazonaws.com", "eventName": "CreateOrganizationalUnit", "awsRegion": "us-east-1", "sourceIPAddress": "192.0.2.0", "userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_11_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/55.0.2883.95 Safari/537.36", "requestParameters": { "name": "OU-Developers-1", "parentId": "r-a1b2" }, "responseElements": { "organizationalUnit": { "arn": "arn:aws:organizations::111111111111:ou/o-aa111bb222/ou-examplerootid111-exampleouid111", "id": "ou-examplerootid111-exampleouid111", "name": "test-cloud-trail", "path": "o-aa111bb222/r-a1b2/ou-examplerootid111-exampleouid111/" } }, "requestID": "EXAMPLE8-90ab-cdef-fedc-ba987EXAMPLE", "eventID": "EXAMPLE8-90ab-cdef-fedc-ba987EXAMPLE", "eventType": "AwsApiCall", "recipientAccountId": "111111111111" }

Esempio di voce di log: InviteAccountToOrganization

Nell'esempio seguente viene mostrata una voce di registro di CloudTrail per una chiamata InviteAccountToOrganization di esempio.

{ "eventVersion": "1.05", "userIdentity": { "type": "IAMUser", "principalId": "AIDAMVNPBQA3EXAMPLE", "arn": "arn:aws:iam::111111111111:user/diego", "accountId": "111111111111", "accessKeyId": "AKIAIOSFODNN7EXAMPLE", "userName": "diego" }, "eventTime": "2017-01-18T21:41:17Z", "eventSource": "organizations.amazonaws.com", "eventName": "InviteAccountToOrganization", "awsRegion": "us-east-1", "sourceIPAddress": "192.0.2.0", "userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_11_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/55.0.2883.95 Safari/537.36", "requestParameters": { "notes": "This is a request for Mary's account to join Diego's organization.", "target": { "type": "ACCOUNT", "id": "111111111111" } }, "responseElements": { "handshake": { "requestedTimestamp": "Jan 18, 2017 9:41:16 PM", "state": "OPEN", "arn": "arn:aws:organizations::111111111111:handshake/o-aa111bb222/invite/h-examplehandshakeid111", "id": "h-examplehandshakeid111", "parties": [ { "type": "ORGANIZATION", "id": "o-aa111bb222" }, { "type": "ACCOUNT", "id": "222222222222" } ], "action": "invite", "expirationTimestamp": "Feb 2, 2017 9:41:16 PM", "resources": [ { "resources": [ { "type": "MASTER_EMAIL", "value": "diego@example.com" }, { "type": "MASTER_NAME", "value": "Management account for organization" }, { "type": "ORGANIZATION_FEATURE_SET", "value": "ALL" } ], "type": "ORGANIZATION", "value": "o-aa111bb222" }, { "type": "ACCOUNT", "value": "222222222222" }, { "type": "NOTES", "value": "This is a request for Mary's account to join Diego's organization." } ] } }, "requestID": "EXAMPLE8-90ab-cdef-fedc-ba987EXAMPLE", "eventID": "EXAMPLE8-90ab-cdef-fedc-ba987EXAMPLE", "eventType": "AwsApiCall", "recipientAccountId": "111111111111" }

Esempio di voce di log: AttachPolicy

Nell'esempio seguente viene mostrata una voce di registro di CloudTrail per una chiamata AttachPolicy di esempio. La risposta indica che la chiamata non è riuscita perché il tipo di policy richiesto non è abilitato nella root in cui si è verificato il tentativo di richiesta di collegamento.

{ "eventVersion": "1.06", "userIdentity": { "type": "IAMUser", "principalId": "AIDAMVNPBQA3EXAMPLE", "arn": "arn:aws:iam::111111111111:user/diego", "accountId": "111111111111", "accessKeyId": "AKIAIOSFODNN7EXAMPLE", "userName": "diego" }, "eventTime": "2017-01-18T21:42:44Z", "eventSource": "organizations.amazonaws.com", "eventName": "AttachPolicy", "awsRegion": "us-east-1", "sourceIPAddress": "192.0.2.0", "userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_11_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/55.0.2883.95 Safari/537.36", "errorCode": "PolicyTypeNotEnabledException", "errorMessage": "The given policy type ServiceControlPolicy is not enabled on the current view", "requestParameters": { "policyId": "p-examplepolicyid111", "targetId": "ou-examplerootid111-exampleouid111" }, "responseElements": null, "requestID": "EXAMPLE8-90ab-cdef-fedc-ba987EXAMPLE", "eventID": "EXAMPLE8-90ab-cdef-fedc-ba987EXAMPLE", "eventType": "AwsApiCall", "recipientAccountId": "111111111111" }

Esempio di voce di log: policy effettiva non valida

Nell’esempio seguente viene mostrata una voce di log di CloudTrail per un evento EffectivePolicyValidation di esempio. Questo evento viene inviato all’account di gestione dell’organizzazione ogni volta che un aggiornamento nell’organizzazione crea una policy effettiva non valida per qualsiasi account.

{ "eventVersion": "1.11", "userIdentity": { "accountId": "111122223333", "invokedBy": "AWS Internal" }, "eventTime": "2025-07-17T14:53:40Z", "eventSource": "organizations.amazonaws.com", "eventName": "EffectivePolicyValidation", "awsRegion": "us-east-1", "sourceIPAddress": "AWS Internal", "userAgent": "AWS Internal", "requestParameters": null, "responseElements": null, "eventID": "EXAMPLE8-90ab-cdef-fedc-ba987EXAMPLE", "readOnly": true, "eventType": "AwsServiceEvent", "managementEvent": true, "recipientAccountId": "111111111111", "serviceEventDetails": { "accountId": "111111111111", "policyType": "BACKUP_POLICY", "state": "INVALID", "requestTimestamp": "Jul 17, 2025, 2:53:40 PM", "info": "All validation errors listed", "validationErrors": [ { "accountPath": "o-aa111bb222/r-a1b2/111111111111/", "evaluationTimestamp": "Jul 17, 2025, 2:53:40 PM", "errorCode": "ELEMENTS_TOO_MANY", "errorMessage": "'hourly_rule' exceeds the allowed maximum limit 10", "pathToError": "plans/hourly-backup/rules/hourly_rule", "contributingPolicies": [ "p-examplepolicyid111" ] } ] }, "eventCategory": "Management" }

Esempio di voce di log: policy effettiva valida

Nell’esempio seguente viene mostrata una voce di log di CloudTrail per un evento EffectivePolicyValidation di esempio. Questo evento viene inviato all’account di gestione dell’organizzazione ogni volta che un aggiornamento nell’organizzazione sistema una policy effettiva per qualsiasi account precedentemente non valido.

{ "eventVersion": "1.11", "userIdentity": { "accountId": "111111111111", "invokedBy": "AWS Internal" }, "eventTime": "2025-07-17T14:54:40Z", "eventSource": "organizations.amazonaws.com", "eventName": "EffectivePolicyValidation", "awsRegion": "us-east-1", "sourceIPAddress": "AWS Internal", "userAgent": "AWS Internal", "requestParameters": null, "responseElements": null, "eventID": "EXAMPLE8-90ab-cdef-fedc-ba987EXAMPLE", "readOnly": true, "eventType": "AwsServiceEvent", "managementEvent": true, "recipientAccountId": "111111111111", "serviceEventDetails": { "accountId": "111111111111", "policyType": "BACKUP_POLICY", "state": "VALID", "requestTimestamp": "Jul 17, 2025, 2:54:40 PM", "info": "Previous effective policy validation error(s) resolved for this account/policyType" }, "eventCategory": "Management" }