View a markdown version of this page

Registrazione delle chiamate API di con AWS CloudTrail for AWS Organizations - AWS Organizations

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 di con AWS CloudTrail for AWS Organizations

AWS Organizations è integrato con AWS CloudTrail un servizio che fornisce una registrazione delle azioni intraprese da un utente, ruolo o AWS servizio in AWS Organizations. CloudTrail acquisisce tutte le chiamate API AWS Organizations come eventi, incluse le chiamate dalla AWS Organizations console e dalle chiamate in codice alle AWS Organizations API. Se crei un percorso, puoi abilitare la distribuzione continua di CloudTrail eventi a un bucket Amazon S3, inclusi gli eventi per. AWS Organizations Se non configuri un percorso, puoi comunque visualizzare gli eventi più recenti nella CloudTrail console nella cronologia degli eventi. Utilizzando le informazioni raccolte da CloudTrail, puoi determinare la richiesta a cui è stata effettuata AWS Organizations, l'indirizzo IP da cui è stata effettuata, chi l'ha effettuata, quando è stata effettuata e dettagli aggiuntivi.

Per saperne di più CloudTrail, consulta la Guida AWS CloudTrail per l'utente.

Importante

È possibile visualizzare tutte le CloudTrail informazioni AWS Organizations solo nella regione Stati Uniti orientali (Virginia settentrionale). Se non vedi la tua AWS Organizations attività nella CloudTrail console, imposta la console su Stati Uniti orientali (Virginia settentrionale) utilizzando il menu nell'angolo in alto a destra. Se esegui una query CloudTrail con gli strumenti AWS CLI o SDK, indirizza la richiesta all'endpoint Stati Uniti orientali (Virginia settentrionale).

AWS Organizations informazioni in CloudTrail

CloudTrail è abilitato sull'utente al Account AWS momento della creazione dell'account. Quando si verifica un'attività in AWS Organizations, tale attività viene registrata in un CloudTrail evento insieme ad altri eventi AWS di servizio nella cronologia degli eventi. Puoi visualizzare, cercare e scaricare gli eventi recenti nel tuo Account AWS. Per ulteriori informazioni, consulta Visualizzazione degli eventi con la cronologia degli CloudTrail eventi.

Per una registrazione continua degli eventi nell' Account AWS che includa gli eventi per AWS Organizations, crea un trail. Un percorso consente di CloudTrail inviare file di log a un bucket Amazon S3. Quando la CloudTrail registrazione è abilitata nel tuo Account AWS, le chiamate API effettuate alle AWS Organizations azioni vengono registrate nei file di CloudTrail registro, dove vengono scritte con altri record di servizio. AWS È possibile configurarne altri Servizi AWS per analizzare ulteriormente e agire sui dati degli eventi raccolti nei CloudTrail registri. Per ulteriori informazioni, consulta gli argomenti seguenti:

Tutte AWS Organizations le azioni vengono registrate CloudTrail e documentate nell'API Reference. AWS Organizations Ad esempio, chiama CreateAccount (incluso l'CreateAccountResultevento) e InviteAccountToOrganization genera voci nei file di CloudTrail registro. ListHandshakesForAccount CreatePolicy

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 AWS servizio

Per ulteriori informazioni, consulta Elemento CloudTrail userIdentity.

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.

Comprensione AWS Organizations voci del file di log

Un trail è una configurazione che consente l'invio di eventi come file di log a un bucket Amazon S3 specificato. CloudTrail i file di log contengono una o più voci di registro. Un evento rappresenta una singola richiesta da qualsiasi sorgente e include informazioni sull'azione richiesta, la data e l'ora dell'operazione, i parametri della richiesta e così via. I file di log di CloudTrail non sono una traccia di stack ordinata delle chiamate API pubbliche, pertanto non vengono visualizzati in un ordine specifico.

Esempi di voci di registro: CloseAccount

L'esempio seguente mostra una voce di CloudTrail registro per una CloseAccount chiamata di esempio che viene generata quando viene chiamata l'API e il flusso di lavoro per chiudere l'account inizia 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 CloudTrail registro per una CloseAccountResult chiamata dopo il 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" }

Esempi di voci di registro: CreateAccount

L'esempio seguente mostra una voce di CloudTrail registro per una CreateAccount chiamata di esempio che viene generata quando viene chiamata l'API e il flusso di lavoro per creare l'account inizia 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 CloudTrail registro per una CreateAccount chiamata al termine 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 CloudTrail registro generata dopo che un flusso di lavoro in CreateAccount background non riesce a creare l'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 } } }

Esempi di voci di registro: AcceptResponsibilityTransfer

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

L'esempio seguente mostra una voce di CloudTrail registro inviata a un account Distributor upstream (111122223333) dopo aver AWS Organizations accettato un trasferimento downstream (rt-5ipg3ess). Il transferChain campo 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" }

Esempi di voci di registro: TerminateResponsibilityTransfer

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

L'esempio seguente mostra una voce di CloudTrail registro inviata a un account Distributor upstream (111122223333) dopo aver AWS Organizations terminato un trasferimento downstream (rt-5ipg3ess). Il transferChain campo 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 inserimento nel registro: CreateOrganizationalUnit

L'esempio seguente mostra una voce di CloudTrail registro per una CreateOrganizationalUnit chiamata 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 registro: InviteAccountToOrganization

L'esempio seguente mostra una voce di CloudTrail registro per una InviteAccountToOrganization chiamata 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 registro: AttachPolicy

L'esempio seguente mostra una voce di CloudTrail registro per una AttachPolicy chiamata 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 registro: politica efficace non valida

L'esempio seguente mostra una voce di CloudTrail registro per un EffectivePolicyValidation evento di esempio. Questo evento viene inviato all'account di gestione dell'organizzazione ogni volta che un aggiornamento nell'organizzazione crea una policy efficace 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 registrazione: Politica valida ed efficace

L'esempio seguente mostra una voce di CloudTrail registro per un EffectivePolicyValidation evento di esempio. Questo evento viene inviato all'account di gestione dell'organizzazione ogni volta che un aggiornamento nell'organizzazione corregge una politica efficace su un account che in precedenza non era 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" }