Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Journalisation des appels d'API avec AWS CloudTrail for AWS Organizations
AWS Organizations est intégré à AWS CloudTrail un service qui fournit un enregistrement des actions entreprises par un utilisateur, un rôle ou un AWS service dans AWS Organizations. CloudTrail capture tous les appels d'API AWS Organizations en tant qu'événements, y compris les appels depuis la AWS Organizations console et les appels de code vers les AWS Organizations API. Si vous créez un historique, vous pouvez activer la diffusion continue d' CloudTrail événements vers un compartiment Amazon S3, y compris des événements pour AWS Organizations. Si vous ne configurez pas de suivi, vous pouvez toujours consulter les événements les plus récents sur la CloudTrail console dans l'historique des événements. À l'aide des informations collectées par CloudTrail, vous pouvez déterminer la demande qui a été faite AWS Organizations, l'adresse IP à partir de laquelle elle a été faite, qui l'a faite, quand elle a été faite et des détails supplémentaires.
Pour en savoir plus CloudTrail, consultez le Guide de AWS CloudTrail l'utilisateur.
Important
Vous pouvez consulter toutes les CloudTrail informations AWS Organizations uniquement pour la région de l'Est des États-Unis (Virginie du Nord). Si vous ne voyez pas votre AWS Organizations activité dans la CloudTrail console, réglez votre console sur USA Est (Virginie du Nord) à l'aide du menu situé dans le coin supérieur droit. Si vous effectuez CloudTrail une requête à l'aide des outils AWS CLI ou du SDK, dirigez votre requête vers le point de terminaison USA East (Virginie du Nord).
AWS Organizations informations dans CloudTrail
CloudTrail est activé Compte AWS lors de la création de votre compte. Lorsqu'une activité se produit AWS Organizations, cette activité est enregistrée dans un CloudTrail événement avec les autres événements de AWS service dans l'historique des événements. Vous pouvez consulter, rechercher et télécharger les événements récents dans votre Compte AWS. Pour plus d'informations, consultez la section Affichage des événements avec l'historique des CloudTrail événements.
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 permet CloudTrail de transmettre des fichiers journaux à un compartiment Amazon S3. Lorsque la CloudTrail journalisation est activée dans votre Compte AWS, les appels d'API effectués pour les AWS Organizations actions sont suivis dans des fichiers CloudTrail journaux, où ils sont écrits avec d'autres enregistrements AWS de service. Vous pouvez en configurer d'autres Services AWS pour analyser plus en profondeur les données d'événements collectées dans les CloudTrail journaux et agir en conséquence. Pour plus d’informations, consultez les ressources suivantes :
Toutes les AWS Organizations actions sont enregistrées CloudTrail et documentées dans la référence de l'AWS Organizations API. Par exemple, les appels CreateAccount (y compris l'CreateAccountResultévénement), ListHandshakesForAccountCreatePolicy, et InviteAccountToOrganization génèrent des entrées dans les fichiers CloudTrail journaux.
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 demande a été faite par un autre AWS service
Pour plus d’informations, consultez la section Élément userIdentity CloudTrail.
Note
CloudTrail enregistrera les événements dans le compte qui effectue une action donnée (c'est-à-dire dans le compte du membre plutôt que dans le compte de gestion si le compte du membre a effectué l'action). Par exemple, un compte de membre quittant une organisation sera connecté à la trace des comptes des membres, et un compte de gestion supprimant un compte membre sera connecté à la piste des comptes de gestion.
Compréhension AWS Organizations entrées de fichier journal
Un journal est une configuration qui permet de transmettre des événements sous forme de fichiers journaux à un compartiment Amazon S3 que vous spécifiez. CloudTrail les fichiers journaux contiennent une ou plusieurs entrées de journal. Un événement représente une demande individuelle à partir d'une source quelconque et comprend des informations sur l'action demandée, sur tous les paramètres, les paramètres de la demande, etc. Les fichiers journaux CloudTrail ne sont pas des séries ordonnées retraçant les appels d'API publics. Ils ne suivent aucun ordre précis.
Exemples d'entrées de journal : CloseAccount
L'exemple suivant montre une entrée de CloudTrail journal pour un exemple d'CloseAccountappel généré lorsque l'API est appelée et que le flux de travail de fermeture du compte commence à être traité 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 CloudTrail journal pour un CloseAccountResult appel une fois que le flux de travail d'arrière-plan visant à fermer le compte s'est 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" }
Exemples d'entrées de journal : CreateAccount
L'exemple suivant montre une entrée de CloudTrail journal pour un exemple d'CreateAccountappel généré lorsque l'API est appelée et que le processus de création du compte commence à être traité 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 CloudTrail journal pour un CreateAccount appel une fois que le flux de travail d'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 CloudTrail journal générée lorsqu'un flux de travail en CreateAccount arrière-plan n'a pas réussi à créer le compte.
{ "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
Lorsqu'il AWS Organizations accepte un transfert de responsabilité de facturation, il publie un événement de ResponsibilityTransferAccepted service sur chaque compte concerné. Pour les transferts en chaîne, notifie AWS Organizations également les participants en amont. Le transferChain champ répertorie les ID de transfert concernés, du transfert accepté au transfert en amont le plus touché.
L'exemple suivant montre une entrée de CloudTrail journal envoyée à un compte de distributeur en amont (111122223333) après avoir AWS Organizations accepté un transfert en aval (rt-5ipg3ess). Le transferChain champ inclut à la fois le transfert accepté et le transfert en amont concerné (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 ResponsibilityTransferTerminated service sur chaque compte concerné. Pour les transferts en chaîne, les participants en amont tels que les distributeurs reçoivent également une notification. Le transferChain champ répertorie les ID de transfert concernés depuis le transfert terminé jusqu'au transfert en amont le plus touché.
L'exemple suivant montre une entrée de CloudTrail journal envoyée à un compte de distributeur en amont (111122223333) après la AWS Organizations fin d'un transfert en aval (rt-5ipg3ess). Le transferChain champ inclut à la fois le transfert terminé et le transfert en amont concerné (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 CloudTrail journal pour un exemple d'CreateOrganizationalUnitappel.
{
"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 CloudTrail journal pour un exemple d'InviteAccountToOrganizationappel.
{
"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 CloudTrail journal pour un exemple d'AttachPolicyappel. 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 montre une entrée de CloudTrail journal pour un exemple d'EffectivePolicyValidationévénement. Cet événement est transmis au compte de gestion de l'organisation chaque fois qu'une mise à jour de l'organisation crée une politique effective non valide pour 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 montre une entrée de CloudTrail journal pour un exemple d'EffectivePolicyValidationévénement. Cet événement est émis sur le compte de gestion de l'organisation chaque fois qu'une mise à jour de l'organisation corrige une politique effective sur un compte qui n'était pas valide auparavant.
{
"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"
}