View a markdown version of this page

Registro de llamadas a la API de con AWS CloudTrail for AWS Organizations - AWS Organizations

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Registro de llamadas a la API de con AWS CloudTrail for AWS Organizations

AWS Organizations está integrado con AWS CloudTrail un servicio que proporciona un registro de las acciones realizadas por un usuario, un rol o un AWS servicio en AWS Organizations. CloudTrail captura todas las llamadas a la API AWS Organizations como eventos, incluidas las llamadas desde la AWS Organizations consola y las llamadas de código a las AWS Organizations API. Si crea un registro, puede habilitar la entrega continua de CloudTrail eventos a un bucket de Amazon S3, incluidos los eventos para AWS Organizations. Si no configuras un registro, puedes seguir viendo los eventos más recientes en la CloudTrail consola, en el Historial de eventos. Con la información recopilada por CloudTrail, puedes determinar la solicitud a la que se hizo AWS Organizations, la dirección IP desde la que se hizo, quién la hizo, cuándo se hizo y otros detalles.

Para obtener más información CloudTrail, consulta la Guía AWS CloudTrail del usuario.

importante

Puede ver toda la CloudTrail información AWS Organizations únicamente en la región EE.UU. Este (Norte de Virginia). Si no ves tu AWS Organizations actividad en la CloudTrail consola, configura la consola en la posición EE.UU. Este (Norte de Virginia) mediante el menú de la esquina superior derecha. Si realizas una consulta CloudTrail con las AWS CLI herramientas del SDK, dirige la consulta al punto final de EE. UU. Este (Virginia del Norte).

AWS Organizations información en CloudTrail

CloudTrail está activado en tu Cuenta de AWS momento de crear la cuenta. Cuando se produce una actividad AWS Organizations, esa actividad se registra en un CloudTrail evento junto con otros eventos de AWS servicio en el historial de eventos. Puedes ver, buscar y descargar los eventos recientes en tu Cuenta de AWS. Para obtener más información, consulta Visualización de eventos con el historial de CloudTrail eventos.

Para mantener un registro continuo de eventos en la Cuenta de AWS, incluidos los eventos de AWS Organizations, cree un registro de seguimiento. Un registro permite CloudTrail enviar los archivos de registro a un bucket de Amazon S3. Cuando se habilita el CloudTrail registro Cuenta de AWS, las llamadas de API realizadas a AWS Organizations las acciones se registran en los archivos de CloudTrail registro, donde se escriben junto con otros registros de AWS servicio. Puede configurar otros Servicios de AWS para analizar más a fondo los datos de eventos recopilados en los CloudTrail registros y actuar sobre la base de ellos. Para más información, consulte los siguientes temas:

Todas AWS Organizations las acciones se registran en la referencia de la AWS Organizations API CloudTrail y se documentan en ella. Por ejemplo, las llamadas a CreateAccount (incluido el CreateAccountResult evento) y las entradas InviteAccountToOrganization generadas en los archivos de CloudTrail registro. ListHandshakesForAccount CreatePolicy

Cada entrada de registro contiene información sobre quién generó la solicitud. La información de identidad del usuario en la entrada de registro le ayuda a determinar lo siguiente:

  • Si la solicitud se realizó con las credenciales del usuario raíz o del usuario de IAM

  • Si la solicitud se realizó con credenciales de seguridad temporales de un rol de IAM o un usuario federado.

  • Si la solicitud fue realizada por otro AWS servicio

Para obtener más información, consulte el Elemento userIdentity de CloudTrail.

nota

CloudTrail registrará los eventos en la cuenta que lleve a cabo una acción determinada (es decir, en la cuenta del miembro en lugar de en la cuenta de administración si la cuenta del miembro realizó la acción). Por ejemplo, si una cuenta de miembro abandona una organización, se registrará en el registro de la cuenta de miembro, y si una cuenta de administración elimina una cuenta de miembro, se registrará en el registro de la cuenta de administración.

Descripción AWS Organizations entradas de archivos de registros

Un registro es una configuración que permite enviar eventos como archivos de registro a un bucket de Amazon S3 que usted especifique. CloudTrail Los archivos de registro contienen una o más entradas de registro. Un evento representa una única solicitud de cualquier origen e incluye información sobre la acción solicitada, la fecha y la hora de la acción, los parámetros de la solicitud, etcétera. Los archivos de registro de CloudTrail no son un rastro de la pila ordenada de las llamadas a la API públicas, por lo que no aparecen en ningún orden específico.

Ejemplos de entradas de registro: CloseAccount

El siguiente ejemplo muestra una entrada de CloudTrail registro para una CloseAccount llamada de ejemplo que se genera cuando se llama a la API y el flujo de trabajo para cerrar la cuenta comienza a procesarse en segundo plano.

{ "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" }

En el siguiente ejemplo, se muestra una entrada de CloudTrail registro para una CloseAccountResult llamada después de que se complete correctamente el flujo de trabajo en segundo plano para cerrar la cuenta.

{ "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" }

Ejemplos de entradas de registro: CreateAccount

El siguiente ejemplo muestra una entrada de CloudTrail registro para una CreateAccount llamada de ejemplo que se genera cuando se llama a la API y el flujo de trabajo para crear la cuenta comienza a procesarse en segundo plano.

{ "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" }

En el siguiente ejemplo, se muestra una entrada de CloudTrail registro para una CreateAccount llamada después de que se complete correctamente el flujo de trabajo en segundo plano para crear la cuenta.

{ "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" } } }

El siguiente ejemplo muestra una entrada de CloudTrail registro que se genera después de que un flujo de trabajo en CreateAccount segundo plano no pueda crear la cuenta.

{ "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 } } }

Ejemplos de entradas de registro: AcceptResponsibilityTransfer

Cuando AWS Organizations acepta una transferencia de responsabilidad de facturación, publica un evento de ResponsibilityTransferAccepted servicio en cada cuenta afectada. En el caso de las transferencias encadenadas, AWS Organizations también notifica a los participantes iniciales. El transferChain campo muestra los ID de transferencia afectados, desde la transferencia aceptada hasta la transferencia ascendente más afectada.

El siguiente ejemplo muestra una entrada de CloudTrail registro que se envía a una cuenta de distribuidor ascendente (111122223333) después de AWS Organizations aceptar una transferencia descendente (rt-5ipg3ess). El transferChain campo incluye tanto la transferencia aceptada como la transferencia ascendente afectada (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" }

Ejemplos de entradas de registro: TerminateResponsibilityTransfer

Cuando finaliza una transferencia de responsabilidad de facturación, AWS Organizations publica un evento de ResponsibilityTransferTerminated servicio en cada cuenta afectada. En el caso de las transferencias encadenadas, los participantes iniciales, como los distribuidores, también reciben una notificación. El transferChain campo muestra los ID de transferencia afectados, desde la transferencia finalizada hasta la transferencia ascendente más afectada.

El siguiente ejemplo muestra una entrada de CloudTrail registro que se envía a una cuenta de distribuidor ascendente (111122223333) después de AWS Organizations finalizar una transferencia descendente (rt-5ipg3ess). El transferChain campo incluye tanto la transferencia finalizada como la transferencia ascendente afectada (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" }

Ejemplo de entrada de registro: CreateOrganizationalUnit

El siguiente ejemplo muestra una entrada de CloudTrail registro para una CreateOrganizationalUnit llamada de ejemplo.

{ "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" }

Ejemplo de entrada de registro: InviteAccountToOrganization

El siguiente ejemplo muestra una entrada de CloudTrail registro para una InviteAccountToOrganization llamada de ejemplo.

{ "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" }

Ejemplo de entrada de registro: AttachPolicy

El siguiente ejemplo muestra una entrada de CloudTrail registro para una AttachPolicy llamada de ejemplo. La respuesta indica que la llamada ha dado un error porque el tipo de política solicitado no está habilitado en la raíz donde se ha intentado adjuntar la solicitud.

{ "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" }

Ejemplo de entrada de registro: política en vigor no válida

El siguiente ejemplo muestra una entrada de CloudTrail registro para un EffectivePolicyValidation evento de ejemplo. Este evento se emite a la cuenta de administración de la organización cada vez que una actualización crea una política en vigor no válida para cualquier cuenta.

{ "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" }

Ejemplo de entrada de registro: política en vigor válida

El siguiente ejemplo muestra una entrada de CloudTrail registro para un EffectivePolicyValidation evento de ejemplo. Este evento se emite a la cuenta de administración de la organización cada vez que una actualización de la organización soluciona una política en vigor en una cuenta que anteriormente no era válida.

{ "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" }