Amazon ya no CodeCatalyst está abierto a nuevos clientes. Los clientes existentes pueden seguir utilizando el servicio con normalidad. Para obtener más información, consulte [Cómo migrar desde CodeCatalyst](migration.md). 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. # Supervisión de eventos y llamadas a la API mediante el registro En Amazon CodeCatalyst, los eventos de administración del espacio se recopilan AWS CloudTrail y se registran en el registro de la cuenta de facturación del espacio. CloudTrail El registro es el método principal para gestionar el registro de CodeCatalyst eventos, y un método secundario es ver el registro de eventos CodeCatalyst. Los eventos de la cuenta se registran con el registro de seguimiento y el bucket designado que se haya establecido para la Cuenta de AWS. En el siguiente diagrama se muestra cómo se registran todos los eventos de administración del espacio en CloudTrail la cuenta de facturación, mientras que connections/billing los eventos de la cuenta y los eventos de AWS recursos se registran en CloudTrail la cuenta correspondiente. ![\[Diagrama donde se ve cómo se administra el registro de eventos en los espacios\]](http://docs.aws.amazon.com/es_es/codecatalyst/latest/userguide/images/ipa/logging-codecatalyst.png) El siguiente diagrama muestra los siguientes pasos: 1. Cuando se crea un espacio, una Cuenta de AWS se conecta al espacio y se designa como cuenta de facturación. El registro utilizado es el registro que se creó CloudTrail para la cuenta de facturación, donde se registran los eventos relacionados con el espacio. CloudTrail captura las llamadas a la API y los eventos relacionados realizados por un CodeCatalyst espacio o en su nombre y envía los archivos de registro a un depósito de S3 que usted especifique. Si la cuenta de facturación cambia a otra cuenta de AWS, los eventos del espacio se registran en el registro de seguimiento y el bucket de esa cuenta. Para obtener más información sobre los eventos de CodeCatalyst administración que registra CloudTrail, consulte[CodeCatalyst información en CloudTrail](ipa-logging-connections.md#info-in-cloudtrail). 1. Otras cuentas conectadas al espacio, incluida la cuenta de facturación, registran un subconjunto de eventos para las conexiones de cuentas y los eventos de facturación. CodeCatalyst Los flujos de trabajo que generan eventos de cuenta para AWS los recursos desplegados en esa cuenta también se registran en la ruta y el Cuenta de AWS bucket de. CloudTrail captura las llamadas a la API y los eventos relacionados realizados por un CodeCatalyst espacio o en su nombre y envía los archivos de registro a un depósito de S3 que usted especifique. Para obtener más información sobre los eventos de CodeCatalyst administración que registra CloudTrail, consulte[Acceso a los eventos registrados mediante el registro de eventos](ipa-logging-connections.md). 1. También puede supervisar CodeCatalyst las acciones en su espacio dentro de un tiempo específico en el espacio con el [https://docs.aws.amazon.com//cli/latest/reference/codecatalyst/list-event-logs.html](https://docs.aws.amazon.com//cli/latest/reference/codecatalyst/list-event-logs.html)comando que utiliza el AWS CLI. Para obtener más información, consulta [la Guía de referencia de las CodeCatalyst API de Amazon](https://docs.aws.amazon.com/codecatalyst/latest/APIReference/Welcome.html). Debes tener la función de **administrador del espacio** para acceder a la lista de eventos y CodeCatalyst realizar acciones en tu espacio. Para obtener más información, consulte [Acceso a los eventos registrados mediante el registro de eventos](ipa-logging-connections.md). **nota** `ListEventLogs` garantiza los eventos de los últimos 30 días en un espacio determinado. También puedes ver y recuperar una lista de los eventos de gestión de los últimos 90 días CodeCatalyst en la AWS CloudTrail consola consultando el **historial de eventos** o creando un registro para crear y mantener un registro de los eventos que se prolonguen más de 90 días. Para obtener más información, consulte [Trabajar con el historial de CloudTrail eventos](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html) y [Trabajar con CloudTrail rutas](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-getting-started.html). **nota** AWS los recursos que se implementan en las cuentas conectadas para los CodeCatalyst flujos de trabajo no se registran como parte del CloudTrail registro del CodeCatalyst espacio. Por ejemplo, CodeCatalyst los recursos incluyen un espacio o un proyecto. AWS los recursos incluyen un servicio Amazon ECS o una función Lambda. Debe configurar el CloudTrail registro por separado para cada Cuenta de AWS lugar en el que se implementen los recursos. Este es un flujo posible para la supervisión de eventos CodeCatalyst. Mary Major es la **administradora** de un CodeCatalyst espacio y consulta todos los eventos de gestión en CodeCatalyst busca de recursos a nivel de espacio y de proyecto en el espacio en el que se ha iniciado sesión. CloudTrail Consulte, [CodeCatalyst información en CloudTrail](ipa-logging-connections.md#info-in-cloudtrail) por ejemplo, los eventos en los que se ha iniciado sesión. CloudTrail En el **caso de los recursos que se crean en CodeCatalyst, como los entornos de desarrollo, Mary consulta el historial** de eventos en la cuenta de facturación del espacio e investiga los eventos en CodeCatalyst los que los miembros del proyecto crearon entornos de desarrollo. El evento proporciona el almacén de identidades, el tipo de identidad de IAM y las credenciales para el AWS ID de creación del usuario que creó el entorno de desarrollo. En el caso de los recursos que se crean AWS cuando los flujos de trabajo los implementan CodeCatalyst, como una función Lambda para un despliegue sin servidor, el Cuenta de AWS propietario puede ver el historial de eventos del registro asociado a la acción independiente Cuenta de AWS (que también es una cuenta conectada CodeCatalyst) de la acción de despliegue del flujo de trabajo. Para seguir investigando, Mary también puede ver los eventos de todo CodeCatalyst APIs el espacio mediante el [https://docs.aws.amazon.com//cli/latest/reference/codecatalyst/list-event-logs.html](https://docs.aws.amazon.com//cli/latest/reference/codecatalyst/list-event-logs.html)comando del. AWS CLI **Topics** + [Supervisión de las llamadas a la API Cuentas de AWS mediante el AWS CloudTrail registro](ipa-logging-connections.md) + [Acceso a los eventos registrados mediante el registro de eventos](ipa-logs.md) # Supervisión de las llamadas a la API Cuentas de AWS mediante el AWS CloudTrail registro Amazon CodeCatalyst está integrado con AWS CloudTrail un servicio que proporciona un registro de las acciones realizadas por un usuario, rol o un Servicio de AWS. CloudTrail captura las llamadas a la API realizadas en nombre de CodeCatalyst in connected Cuentas de AWS as events. Si crea un registro, puede habilitar la entrega continua de CloudTrail eventos a un bucket de S3, incluidos los eventos de CodeCatalyst. Si no configuras una ruta, podrás ver los eventos más recientes en la CloudTrail consola, en el **historial de eventos**. CodeCatalyst admite el registro de las siguientes acciones como eventos en los archivos de CloudTrail registro: + Los eventos de administración de CodeCatalyst los espacios se registrarán en la Cuenta de AWS cuenta de facturación designada para el espacio. Para obtener más información, consulte [CodeCatalyst eventos espaciales](#cloudtrail-logs-spaces-projects). **nota** Se puede acceder a los eventos de datos de los CodeCatalyst espacios mediante la CLI, como se detalla en[Acceso a los eventos registrados mediante el registro de eventos](ipa-logs.md). + Los eventos de los recursos que se utilizan en las acciones del CodeCatalyst flujo de trabajo que se producen en un Cuenta de AWS entorno conectado se registrarán como eventos en ese entorno Cuenta de AWS. Para obtener más información, consulte [CodeCatalyst conexiones de cuentas y eventos de facturación](#cloudtrail-logs-connections). **importante** Si bien se pueden asociar varias cuentas a un espacio, el CloudTrail registro de eventos en CodeCatalyst espacios y proyectos solo se aplica a la cuenta de facturación. La cuenta de facturación de espacios es tuya y se cobran los CodeCatalyst recursos Cuenta de AWS que superen el nivel AWS gratuito. Se pueden conectar varias cuentas a un espacio, pero solo una cuenta puede ser la cuenta de facturación designada. La cuenta de facturación o las cuentas conectadas adicionales del espacio pueden tener funciones de IAM que se utilizan para implementar AWS recursos e infraestructura, como un clúster de Amazon ECS o un bucket de S3, a partir de CodeCatalyst flujos de trabajo. Puede usar el flujo de trabajo YAML para identificar el flujo de trabajo en el Cuenta de AWS que realizó la implementación. **nota** AWS los recursos que se implementan en las cuentas conectadas para los CodeCatalyst flujos de trabajo no se registran como parte del CloudTrail registro del CodeCatalyst espacio. Por ejemplo, CodeCatalyst los recursos incluyen un espacio o un proyecto. AWS los recursos incluyen un servicio Amazon ECS o una función Lambda. CloudTrail el registro debe configurarse por separado para cada Cuenta de AWS lugar en el que se implementen los recursos. CodeCatalyst al iniciar sesión en las cuentas conectadas se incluyen las siguientes consideraciones: + El acceso a CloudTrail los eventos se gestiona con IAM en la cuenta conectada y no en CodeCatalyst ella. + Las conexiones de terceros, como la vinculación a un GitHub repositorio, harán que los nombres de los recursos de terceros se registren en CloudTrail los registros. **nota** CloudTrail El registro de CodeCatalyst eventos se realiza a nivel de espacio y no aísla los eventos según los límites del proyecto. Para obtener más información al respecto CloudTrail, consulte la [Guía AWS CloudTrail del usuario](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-user-guide.html). **nota** En esta sección se describe el CloudTrail registro de todos los eventos registrados en un CodeCatalyst espacio y a los Cuentas de AWS que están conectados CodeCatalyst. Además, para revisar todos los eventos registrados en un CodeCatalyst espacio, también puede utilizar el **aws codecatalyst list-event-logs** comando AWS CLI y. Para obtener más información, consulte [Acceso a los eventos registrados mediante el registro de eventos](ipa-logs.md). ## CodeCatalyst eventos espaciales Las acciones CodeCatalyst para administrar los recursos a nivel de espacio y de proyecto se registran en la cuenta de facturación del espacio. Para CloudTrail iniciar sesión en un CodeCatalyst espacio, los eventos se registran teniendo en cuenta las siguientes consideraciones. + CloudTrail los eventos se aplican a todo el espacio y no se centran en un solo proyecto. + Al conectar y Cuenta de AWS a un CodeCatalyst espacio, los eventos que se puedan registrar para las conexiones de cuentas se registrarán en él. Cuenta de AWS Tras habilitar esta conexión, no podrá deshabilitarla. + Cuando conectas un Cuenta de AWS CodeCatalyst espacio y lo designas como la cuenta de facturación del espacio, los eventos se registrarán en él. Cuenta de AWS Tras habilitar esta conexión, no podrá deshabilitarla. Los eventos de los recursos en el nivel del espacio y el nivel del proyecto solo se registran en la cuenta de facturación. Para cambiar la cuenta de CloudTrail destino, actualiza la cuenta de facturación en CodeCatalyst. Al comienzo del siguiente ciclo de facturación mensual, el cambio se aplicará a la nueva cuenta de facturación en CodeCatalyst. Después de eso, se actualiza la cuenta de CloudTrail destino. Los siguientes son ejemplos de eventos relacionados con acciones CodeCatalyst para administrar los recursos a nivel de espacio y de proyecto. AWS Lo siguiente APIs se publica a través del SDK y la CLI. Los eventos se registrarán en la cuenta Cuenta de AWS especificada como cuenta de facturación del CodeCatalyst espacio. + `[CreateDevEnvironment](https://docs.aws.amazon.com/codecatalyst/latest/APIReference/API_CreateDevEnvironment.html)` + `[CreateProject](https://docs.aws.amazon.com/codecatalyst/latest/APIReference/API_CreateProject.html)` + `[DeleteDevEnvironment](https://docs.aws.amazon.com/codecatalyst/latest/APIReference/API_DeleteDevEnvironment.html)` + `[GetDevEnvironment](https://docs.aws.amazon.com/codecatalyst/latest/APIReference/API_GetDevEnvironment.html)` + `[GetProject](https://docs.aws.amazon.com/codecatalyst/latest/APIReference/API_GetProject.html)` + `[GetSpace](https://docs.aws.amazon.com/codecatalyst/latest/APIReference/API_GetSpace.html)` + `[GetSubscription](https://docs.aws.amazon.com/codecatalyst/latest/APIReference/API_GetSubscription.html)` + `[ListDevEnvironments](https://docs.aws.amazon.com/codecatalyst/latest/APIReference/API_ListDevEnvironments.html)` + `[ListDevEnvironmentSessions](https://docs.aws.amazon.com/codecatalyst/latest/APIReference/API_ListDevEnvironmentSessions.html)` + `[ListEventLogs](https://docs.aws.amazon.com/codecatalyst/latest/APIReference/API_ListEventLogs.html)` + `[ListProjects](https://docs.aws.amazon.com/codecatalyst/latest/APIReference/API_ListProjects.html)` + `[ListSourceRepositories](https://docs.aws.amazon.com/codecatalyst/latest/APIReference/API_ListSourceRepositories.html)` + `[StartDevEnvironment](https://docs.aws.amazon.com/codecatalyst/latest/APIReference/API_StartDevEnvironment.html)` + `[StartDevEnvironmentSession](https://docs.aws.amazon.com/codecatalyst/latest/APIReference/API_StartDevEnvironmentSession.html)` + `[StopDevEnvironment](https://docs.aws.amazon.com/codecatalyst/latest/APIReference/API_StopDevEnvironment.html)` + `[StopDevEnvironmentSession](https://docs.aws.amazon.com/codecatalyst/latest/APIReference/API_StopDevEnvironmentSession.html)` + `[UpdateDevEnvironment](https://docs.aws.amazon.com/codecatalyst/latest/APIReference/API_UpdateDevEnvironment.html)` ## CodeCatalyst conexiones de cuentas y eventos de facturación Los siguientes son ejemplos de eventos relacionados con acciones relacionadas con las conexiones CodeCatalyst de cuentas o la facturación: AWS + `AcceptConnection` + `AssociateIAMRoletoConnection` + `DeleteConnection` + `DissassociateIAMRolefromConnection` + `GetBillingAuthorization` + `GetConnection` + `GetPendingConnection` + `ListConnections` + `ListIAMRolesforConnection` + `PutBillingAuthorization` + `RejectConnection` ## CodeCatalyst información en CloudTrail CloudTrail está habilitada Cuenta de AWS al crear esa cuenta y al crearla. Cuando lo conectas Cuenta de AWS a un CodeCatalyst espacio, los eventos de ese espacio que se registran en ese espacio Cuenta de AWS se CloudTrail registran en esa cuenta de AWS. Los eventos que se pueden registrar CodeCatalyst se registran como CloudTrail eventos en los CloudTrail registros de la cuenta conectada y en el **historial de eventos** de la CloudTrail consola, junto con otros AWS eventos que se pueden registrar en esa cuenta. Cada entrada de registro o evento contiene información sobre quién generó la solicitud. La información de identidad del usuario le ayuda a determinar lo siguiente: + Si la solicitud la realizó un usuario con su ID de creador. AWS + Si la solicitud se realizó con credenciales de usuario root o AWS Identity and Access Management (IAM). + Si la solicitud se realizó con credenciales de seguridad temporales de un rol o fue un usuario federado. + Si la solicitud la realizó otro AWS servicio. Para obtener más información, consulte el [elemento userIdentity de CloudTrail ](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html). ## Acceder a CloudTrail los eventos Para tener un registro continuo de los eventos que se produzcan en su entorno Cuenta de AWS, incluidos los eventos relacionados con su CodeCatalyst actividad Cuenta de AWS, cree un sendero. Un *registro de seguimiento* permite a CloudTrail que pueda enviar archivos de registro a un bucket de S3. De forma predeterminada, cuando se crea un registro de seguimiento en la consola, el registro de seguimiento se aplica a todas las Regiones de AWS. El registro registra los eventos de todas las regiones de la AWS partición y envía los archivos de registro al depósito de S3 que especifique. Además, puede configurar otros AWS servicios para analizar más a fondo los datos de eventos recopilados en los CloudTrail registros y actuar en función de ellos. Para más información, consulte los siguientes temas: + [Introducción a la creación de registros de seguimiento](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html) + [CloudTrail servicios e integraciones compatibles](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-aws-service-specific-topics.html) + [Configuración de notificaciones de Amazon SNS para CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/configure-sns-notifications-for-cloudtrail.html) + [Recepción de archivos de CloudTrail registro de varias regiones](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/receive-cloudtrail-log-files-from-multiple-regions.html) y [recepción de archivos de CloudTrail registro de varias cuentas](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-receive-logs-from-multiple-accounts.html) Un registro es una configuración que permite la entrega de eventos como archivos de registro a un bucket de S3 que usted especifique. CloudTrail Los archivos de registro contienen una o más entradas de registro. Un evento representa una solicitud única de cualquier fuente 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. CloudTrail Los archivos de registro no son un registro ordenado de las llamadas a la API pública, por lo que no aparecen en ningún orden específico. ## Ejemplo de evento de conexiones de CodeCatalyst cuentas en AWS El siguiente ejemplo muestra una entrada de CloudTrail registro que demuestra la `ListConnections` acción. En el caso de una Cuenta de AWS que esté conectada al espacio, `ListConnections` se utiliza para ver todas las conexiones de cuentas a las que CodeCatalyst se ha conectado Cuenta de AWS. El evento se registrará según lo Cuenta de AWS especificado y el valor de `arn` será el nombre de recurso de Amazon (ARN) del rol utilizado para la acción. `accountId` ``` { "eventVersion": "1.08", "userIdentity": { "type": "AssumedRole", "principalId": "AKIAI44QH8DHBEXAMPLE", "arn": "role-ARN", "accountId": "account-ID", "accessKeyId": "AKIAIOSFODNN7EXAMPLE", "sessionContext": { "sessionIssuer": { "type": "Role", "principalId": "AKIAI44QH8DHBEXAMPLE", "arn": "role-ARN", "accountId": "account-ID", "userName": "user-name" }, "webIdFederationData": {}, "attributes": { "creationDate": "2022-09-06T15:04:31Z", "mfaAuthenticated": "false" } } }, "eventTime": "2022-09-06T15:08:43Z", "eventSource": "account-ID", "eventName": "ListConnections", "awsRegion": "us-west-2", "sourceIPAddress": "192.168.0.1", "userAgent": "aws-cli/1.18.147 Python/2.7.18 Linux/5.4.207-126.363.amzn2int.x86_64 botocore/1.18.6", "requestParameters": null, "responseElements": null, "requestID": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 ", "eventID": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 ", "readOnly": true, "eventType": "AwsApiCall", "managementEvent": true, "recipientAccountId": "account-ID", "eventCategory": "Management" } ``` ## Ejemplo de evento de recurso de CodeCatalyst proyecto en AWS El siguiente ejemplo muestra una entrada de CloudTrail registro que demuestra la `CreateDevEnvironment` acción. Una cuenta Cuenta de AWS que esté conectada al espacio y que sea la cuenta de facturación designada para el espacio se usa para eventos a nivel de proyecto en el espacio, como la creación de un entorno de desarrollo. Debajo`userIdentity`, en el `accountId` campo, se encuentra el ID de cuenta del IAM Identity Center (`432677196278`) que aloja el conjunto de identidades de todas las identidades de AWS Builder ID. Este ID de cuenta contiene la siguiente información sobre el CodeCatalyst usuario del evento. + El campo `type` indica el tipo de entidad de IAM de la solicitud. En el CodeCatalyst caso de los eventos relacionados con el espacio y los recursos del proyecto, este valor es`IdentityCenterUser`. El campo `accountId` especifica la cuenta que posee la entidad empleada para obtener las credenciales. + El `userId` campo contiene el identificador de AWS Builder ID del usuario. + El campo `identityStoreArn` contiene el ARN del rol para el usuario y la cuenta del almacén de identidades. El campo `recipientAccountId` contiene el ID de cuenta de la cuenta de facturación del espacio (en este caso, con 111122223333 como valor de ejemplo). Para obtener más información, consulte el [elemento userIdentity de CloudTrail ](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html). ``` { "eventVersion": "1.09", "userIdentity": { "type": "IdentityCenterUser", "accountId": "432677196278", "onBehalfOf": { "userId": "user-ID", "identityStoreArn": "arn:aws:identitystore::432677196278:identitystore/d-9067642ac7" }, "credentialId": "ABCDefGhiJKLMn11Lmn_1AbCDEFgHijk-AaBCdEFGHIjKLmnOPqrs11abEXAMPLE" }, "eventTime": "2023-05-18T17:10:50Z", "eventSource": "codecatalyst.amazonaws.com", "eventName": "CreateDevEnvironment", "awsRegion": "us-west-2", "sourceIPAddress": "192.168.0.1", "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:102.0) Gecko/20100101 Firefox/102.0", "requestParameters": { "spaceName": "MySpace", "projectName": "MyProject", "ides": [{ "runtime": "public.ecr.aws/q6e8p2q0/cloud9-ide-runtime:2.5.1", "name": "Cloud9" }], "instanceType": "dev.standard1.small", "inactivityTimeoutMinutes": 15, "persistentStorage": { "sizeInGiB": 16 } }, "responseElements": { "spaceName": "MySpace", "projectName": "MyProject", "id": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 " }, "requestID": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "eventID": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "readOnly": false, "eventType": "AwsApiCall", "managementEvent": true, "recipientAccountId": "111122223333", "sharedEventID": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "eventCategory": "Management" } ``` **nota** En algunos eventos, es posible que el agente de usuario sea desconocido. En este caso, CodeCatalyst proporcionará un valor de `Unknown` en el `userAgent` campo del CloudTrail evento. ## Consultando las rutas de tus CodeCatalyst eventos Puede crear y administrar consultas para sus CloudTrail registros mediante una tabla de consultas en Amazon Athena. Para obtener más información sobre la creación de consultas, vaya a [Consulta de registros de AWS CloudTrail](https://docs.aws.amazon.com/athena/latest/ug/cloudtrail-logs.html) en la *Guía del usuario de Amazon Athena*. # Acceso a los eventos registrados mediante el registro de eventos Cuando los usuarios llevan a cabo acciones en Amazon CodeCatalyst, estas se registran como eventos. Puede utilizar la AWS CLI para ver los registros de eventos en un espacio dentro de un período de tiempo específico. Puede ver estos eventos para revisar las acciones realizadas en el espacio; esto incluye la fecha y la hora de las acciones, el nombre del usuario que las llevó a cabo y la dirección IP en la que el usuario hizo la solicitud. **nota** Los eventos de administración de un espacio de CodeCatalyst se registran en CloudTrail para la cuenta de facturación conectada. Para obtener más información sobre los eventos de administración de CodeCatalyst registrados por CloudTrail, consulte [CodeCatalyst información en CloudTrail](ipa-logging-connections.md#info-in-cloudtrail). A fin de ver un registro de eventos de un espacio, debe haber instalado y configurado la AWS CLI con un perfil para CodeCatalyst y debe tener el rol de **administrador del espacio** en ese espacio. Para obtener más información, consulte [Configuración para usar el AWS CLI con CodeCatalyst](set-up-cli.md) y [Rol de administrador del espacio](ipa-role-types.md#ipa-role-space-admin). **nota** Para ver el registro de eventos que han ocurrido en nombre de CodeCatalyst en Cuentas de AWS conectadas, o para ver el registro de eventos en recursos de proyectos o espacios en la cuenta de facturación conectada, puede utilizar AWS CloudTrail. Para obtener más información, consulte [Supervisión de las llamadas a la API Cuentas de AWS mediante el AWS CloudTrail registro](ipa-logging-connections.md). 1. Abra un terminal o una línea de comandos y ejecute el comando **aws codecatalyst list-event-logs** especificando lo siguiente: + El nombre del espacio con la opción **--space-name**. + La fecha y la hora en las que desea empezar a revisar los eventos, en el formato de hora universal coordinada (UTC), tal y como se especifica en [RFC 3339](https://www.rfc-editor.org/rfc/rfc3339#section-5.6), con la opción **--start-time**. + La fecha y la hora en las que desea dejar de revisar los eventos, en el formato de hora universal coordinada (UTC), tal y como se especifica en [RFC 3339](https://www.rfc-editor.org/rfc/rfc3339#section-5.6), con la opción **--end-time**. + (opcional) El número máximo de resultados que se devuelven en una única respuesta, con la opción **--max-results**. Si el número de resultados es mayor que el número que especifique, la respuesta incluirá un elemento `nextToken` que puede usar para devolver los siguientes resultados. + (Opcional) Limite los resultados a un tipo de evento específico que desee que se devuelva, con la opción **--event-name**. En este ejemplo, se devuelven los eventos registrados en el espacio con el nombre *ExampleCorp* desde el *30 de noviembre de 2022* hasta el *1 de diciembre de 2022*; también se especifica que se devuelvan, como máximo, *2* eventos en la respuesta. ``` aws codecatalyst list-event-logs --space-name ExampleCorp --start-time 2022-11-30 --end-time 2022-12-01 --event-name list-event-logs --max-results 2 ``` 1. Si los eventos ocurrieron en este período de tiempo, el comando devuelve resultados similares a los siguientes: ``` { "nextToken": "EXAMPLE", "items": [ { "id": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "eventName": "listEventLogs", "eventType": "AwsApiCall", "eventCategory": "MANAGEMENT", "eventSource": "manage", "eventTime": "2022-12-01T22:47:24.605000+00:00", "operationType": "READONLY", "userIdentity": { "userType": "USER", "principalId": "a1b2c3d4e5-678fgh90-1a2b-3c4d-e5f6-EXAMPLE11111" "userName": "MaryMajor" }, "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "requestPayload": { "contentType": "application/json", "data": "{\"spaceName\":\"ExampleCorp\",\"startTime\":\"2022-12-01T00:00:00Z\",\"endTime\":\"2022-12-10T00:00:00Z\",\"maxResults\":\"2\"}" }, "sourceIpAddress": "127.0.0.1", "userAgent": "aws-cli/2.9.0 Python/3.9.11 Darwin/21.3.0 exe/x86_64 prompt/off command/codecatalyst.list-event-logs" }, { "id": "a1b2c3d4-5678-90ab-cdef-EXAMPLEaaaaa", "eventName": "createProject", "eventType": "AwsApiCall", "eventCategory": "MANAGEMENT", "eventSource": "manage", "eventTime": "2022-12-01T09:15:32.068000+00:00", "operationType": "MUTATION", "userIdentity": { "userType": "USER", "principalId": "a1b2c3d4e5-678fgh90-1a2b-3c4d-e5f6-EXAMPLE11111", "userName": "MaryMajor" }, "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE33333", "requestPayload": { "contentType": "application/json", "data": "{\"spaceName\":\"ExampleCorp\",\"name\":\"MyFirstProject\",\"displayName\":\"MyFirstProject\"}" }, "responsePayload": { "contentType": "application/json", "data": "{\"spaceName\":\"ExampleCorp\",\"name\":\"MyFirstProject\",\"displayName\":\"MyFirstProject\",\"id\":\"a1b2c3d4-5678-90ab-cdef-EXAMPLE4444\"}" }, "sourceIpAddress": "192.0.2.23", "userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:102.0) Gecko/20100101 Firefox/102.0" } ] } ``` 1. Ejecute de nuevo el comando **list-event-logs** con la opción **--next-token** y el valor del token devuelto para recuperar el siguiente conjunto de eventos registrados que coincida con la solicitud.