Journalisation des appels d’API avec AWS CloudTrail pour AWS Organizations
AWS Organizations est intégré avec AWS CloudTrail, un service qui fournit un registre des actions prises par un utilisateur, un rôle ou un service AWS dans AWS Organizations. CloudTrail capture tous les appels d'API pour AWS Organizations en tant qu'événements, y compris les appels émis par la console AWS Organizations et les appels de code transmis aux API AWS Organizations. Si vous créez un journal d'activité, vous pouvez activer la livraison continue d'événements CloudTrail à un compartiment Amazon S3, y compris des événements pour AWS Organizations. Si vous ne configurez pas de journal de suivi, vous pouvez toujours afficher les événements les plus récents dans la console CloudTrail dans Historique des événements. Avec les informations collectées par CloudTrail, vous pouvez déterminer la demande qui a été envoyée à AWS Organizations, l'adresse IP à partir de laquelle elle a été effectuée, l'auteur et la date de la demande, ainsi que d'autres détails.
Pour en savoir plus sur CloudTrail, consultez le Guide de l'utilisateur AWS CloudTrail.
Vous pouvez afficher toutes les informations CloudTrail pour AWS Organizations uniquement dans la région USA Est (Virginie du Nord). Si vous ne voyez pas votre activité AWS Organizations dans la console CloudTrail, définissez le paramètre de région de votre console sur USA Est (Virginie du Nord) à l'aide du menu dans le coin supérieur droit. Si vous interrogez CloudTrail avec la AWS CLI ou les outils SDK, adressez votre requête au point de terminaison USA Est (Virginie du Nord).
AWS OrganizationsInformations dans CloudTrail
CloudTrail est activé dans votre Compte AWS lors de la création de ce dernier. Quand une activité a lieu dans AWS Organizations, cette activité est enregistrée dans un événement CloudTrail avec d'autres événements de service AWS dans l'Historique des événements. Vous pouvez afficher, rechercher et télécharger les événements récents dans votre Compte AWS. Pour de plus amples informations, veuillez consulter Affichage des événements avec l'historique des événements CloudTrail.
Pour un enregistrement continu des événements dans votre Compte AWS, y compris les événements pour AWS Organizations, créez un journal d'activité. Un journal d'activité permet à CloudTrail de livrer des fichiers journaux dans un compartiment Amazon S3. Lorsque la journalisation CloudTrail est activée dans votre Compte AWS, les appels d'API passés aux actions AWS Organizations sont suivis dans des fichiers journaux CloudTrail, où ils sont consignés avec d'autres enregistrements de service AWS. Vous pouvez configurer d’autres Services AWS pour approfondir l’analyse des données d’événement collectées dans les journaux CloudTrail et agir sur ces données. Pour plus d’informations, consultez les ressources suivantes :
Toutes les actions AWS Organizations sont consignées par CloudTrail et documentées dans la Référence des API AWS Organizations. À titre d'exemple, les appels à CreateAccount (y compris l'événement CreateAccountResult), ListHandshakesForAccount, CreatePolicy et InviteAccountToOrganization génèrent des entrées dans les fichiers journaux CloudTrail.
Chaque entrée du journal contient des informations sur la personne qui a généré la demande. Les informations d'identité de l'utilisateur dans l'entrée de journal permettent de déterminer les éléments suivants :
-
Si la demande a été effectuée avec des informations d'identification d'utilisateur root ou d'utilisateur IAM.
-
Si la demande a été effectuée avec des informations d'identification de sécurité temporaires pour un rôle IAM ou un utilisateur fédéré
-
Si la requête a été effectuée par un autre service AWS
Pour plus d’informations, consultez Élément d’identité d’utilisateur CloudTrail.
CloudTrail journalise les événements dans le compte qui effectue une action donnée (c’est-à-dire dans le compte membre plutôt que dans le compte de gestion si le compte membre a effectué l’action). Par exemple, le départ d’un compte membre d’une organisation est journalisé dans la piste du compte membre, et le retrait d’un compte membre par un compte de gestion est journalisé dans la piste du compte de gestion.
Présentation des AWS Organizations entrées des fichiers journaux
Un journal d'activité est une configuration qui permet d'envoyer les événements dans des fichiers journaux à un compartiment Amazon S3 que vous spécifiez. Les fichiers journaux CloudTrail peuvent contenir une ou plusieurs entrées. Un événement représente une demande unique provenant de n’importe quelle source et comprend des informations sur l’action demandée, la date et l’heure de l’action, les paramètres de la demande, etc. Les fichiers journaux CloudTrail ne constituent pas une série ordonnée retraçant les appels d'API publics. Ils ne suivent aucun ordre précis.
Exemple d'entrées de journal : CloseAccount
L'exemple suivant montre une entrée de journal CloudTrail pour un exemple d'appel CloseAccount qui est générée lorsque l'API est appelée et que le flux de travail pour clôturer le compte démarre le traitement en arrière-plan.
{
"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'exemple suivant montre une entrée de journal CloudTrail pour un appel CloseAccountResult après que le flux de travail de clôture de compte en arrière-plan se soit terminé avec succès.
{ "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" }
Exemple d'entrées de journal : CreateAccount
L'exemple suivant montre une entrée de journal CloudTrail pour un exemple d'appel CreateAccount qui est générée lorsque l'API est appelée et que le flux de travail pour créer le compte commence le traitement en arrière-plan.
{
"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'exemple suivant montre une entrée de journal CloudTrail pour un appel CreateAccount après que le flux de travail en arrière-plan pour créer le compte s'est terminé avec succès.
{ "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'exemple suivant montre une entrée de journal CloudTrail générée après qu'un flux de travail en arrière-plan CreateAccount pour créer le compte a échoué.
{ "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 } } }
Exemples d’entrées de journal : AcceptResponsibilityTransfer
Lorsque AWS Organizations accepte un transfert de la responsabilité de facturation, il publie un événement de service ResponsibilityTransferAccepted dans chaque compte concerné. Pour les transferts en chaîne, AWS Organizations avertit également les participants en amont. Le champ transferChain répertorie les ID de transfert concernés, du transfert accepté jusqu’au transfert concerné situé le plus en amont.
L’exemple suivant présente une entrée de journal CloudTrail transmise à un compte de distributeur en amont (111122223333) après qu’AWS Organizations a accepté un transfert en aval (rt-5ipg3ess). Le champ transferChain inclut à la fois le transfert accepté et le transfert en amont affecté (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"
}
Exemples d’entrées de journal : TerminateResponsibilityTransfer
Lorsqu’un transfert de responsabilité de facturation prend fin, AWS Organizations publie un événement de service ResponsibilityTransferTerminated dans chaque compte affecté. Pour les transferts en chaîne, les participants en amont, comme les distributeurs, reçoivent également une notification. Le champ transferChain répertorie les ID de transfert concernés, du transfert terminé jusqu’au transfert concerné situé le plus en amont.
L’exemple suivant présente une entrée de journal CloudTrail transmise à un compte de distributeur en amont (111122223333) après que AWS Organizations a terminé un transfert en aval (rt-5ipg3ess). Le champ transferChain inclut à la fois le transfert terminé et le transfert en amont affecté (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"
}
Exemple d'entrée de journal : CreateOrganizationalUnit
L'exemple suivant montre une entrée de journal CloudTrail pour un exemple d'appel CreateOrganizationalUnit.
{
"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"
}
Exemple d'entrée de journal : InviteAccountToOrganization
L'exemple suivant montre une entrée de journal CloudTrail pour un exemple d'appel InviteAccountToOrganization.
{
"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"
}
Exemple d'entrée de journal : AttachPolicy
L'exemple suivant montre une entrée de journal CloudTrail pour un exemple d'appel AttachPolicy. La réponse indique que l'appel a échoué parce que le type de politique demandé n'est pas activé dans la racine où la demande d'attachement a été lancée.
{
"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"
}
Exemple d’entrée de journal : politique effective non valide
L’exemple suivant présente une entrée de journal CloudTrail pour un événement EffectivePolicyValidation donné en exemple. Cet événement est émis vers le compte de gestion de l’organisation chaque fois qu’une mise à jour dans l’organisation crée une politique effective non valide sur un compte.
{
"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"
}
Exemple d’entrée de journal : politique effective valide
L’exemple suivant présente une entrée de journal CloudTrail pour un événement EffectivePolicyValidation donné en exemple. Cet événement est émis vers le compte de gestion de l’organisation chaque fois qu’une mise à jour dans l’organisation corrige une politique effective auparavant non valide sur un compte.
{
"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"
}