

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.

# Acceso a los eventos registrados mediante el registro de eventos
<a name="ipa-logs"></a>

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.