CloudTrail Esquema de eventos de integración de Lake

En la siguiente tabla se describen los elementos de esquema obligatorios y opcionales que coinciden con los de los registros de CloudTrail eventos. El contenido de lo eventData proporcionan sus eventos; el resto de los campos los proporcionan CloudTrail después de la ingesta.

CloudTrail el contenido de los registros de eventos se describe con más detalle enCloudTrail contenido del registro.

• Los campos que se proporcionan CloudTrail después de la ingestión

• Campos que proporcionan los eventos

Tras la ingestión, se proporcionan los CloudTrail siguientes campos:

Nombre del campo	Tipo de entrada	Requisito	Descripción
eventVersion	cadena	Obligatoria	La versión del evento.
eventCategory	cadena	Obligatoria	La categoría del evento. En el caso de AWS eventos que no sean eventos, el valor esActivityAuditLog.
eventType	cadena	Obligatoria	Tipo de evento. Para los AWS eventos que no son eventos, el valor válido esActivityLog.
eventID	cadena	Obligatoria	El ID único de un evento.
eventTime	cadena	Obligatoria	Marca de tiempo del evento, en yyyy-MM-DDTHH:mm:ss formato, en hora universal coordinada ()UTC.
awsRegion	cadena	Obligatoria	El Región de AWS lugar donde se realizó la PutAuditEvents llamada.
recipientAccountId	cadena	Obligatoria	Representa el identificador de cuenta que recibió este evento. CloudTrail rellena este campo calculándolo a partir de la carga útil del evento.
addendum	-	Opcional	Muestra información sobre el motivo por el cual se retrasó el procesamiento de eventos. Si falta información de un evento existente, el bloque addendum incluye la información que falta y el motivo por el cual aquella falta.
reason	cadena	Opcional	El motivo por el que faltaba el evento o parte de su contenido.
updatedFields	cadena	Opcional	Los campos de registro de eventos que se actualizan mediante el anexo. Esto solo se proporciona si el motivo es UPDATED_DATA.
original UID	cadena	Opcional	El evento original UID de la fuente. Esto solo se proporciona si el motivo es UPDATED_DATA.
originalEventID	cadena	Opcional	El ID del evento original. Esto solo se proporciona si el motivo es UPDATED_DATA.
metadatos	-	Obligatoria	Información acerca del canal que utilizó el evento.
ingestionTime	cadena	Obligatoria	La marca de tiempo en que se procesó el evento, en yyyy-MM-DDTHH:mm:ss formato, en Universal Coordinated Time ()UTC.
canal ARN	cadena	Obligatoria	El ARN canal que utilizó el evento.

Los siguientes campos los proporcionan los eventos del cliente:

Nombre del campo	Tipo de entrada	Requisito	Descripción
eventData	-	Obligatorio	Los datos de auditoría enviados CloudTrail en una PutAuditEvents llamada.
versión	cadena	Obligatoria	La versión del evento desde el origen. Limitaciones de longitud: longitud máxima de 256 caracteres.
userIdentity	-	Obligatoria	Información acerca del usuario que realizó una solicitud.
type	cadena	Obligatoria	El tipo de identidad de usuario. Limitaciones de longitud: longitud máxima de 128 caracteres.
principalId	cadena	Obligatoria	Un identificador único para el actor del evento. Limitaciones de longitud: longitud máxima de 1024 caracteres.
details	JSONobjeto	Opcional	Información adicional acerca de la identidad.
userAgent	cadena	Opcional	El agente que realizó la solicitud. Limitaciones de longitud: longitud máxima de 1024 caracteres.
eventSource	cadena	Obligatoria	Este es el origen de eventos asociado o la aplicación personalizada en que se registran los eventos. Limitaciones de longitud: longitud máxima de 1024 caracteres.
eventName	cadena	Obligatoria	La acción solicitada, una de las acciones del API servicio o la aplicación de origen. Limitaciones de longitud: longitud máxima de 1024 caracteres.
eventTime	cadena	Obligatoria	Marca de tiempo del evento, en yyyy-MM-DDTHH:mm:ss formato, en hora universal coordinada ()UTC.
UID	cadena	Obligatoria	El UID valor que identifica la solicitud. El servicio o la aplicación que se llama genera este valor. Limitaciones de longitud: longitud máxima de 1024 caracteres.
requestParameters	JSONobjeto	Opcional	Los parámetros, si hay alguno, que se enviaron con la solicitud. Este campo tiene un tamaño máximo de 100 kB y el contenido que supere el límite se rechaza.
responseElements	JSONobjeto	Opcional	El elemento de respuesta de las acciones que realizaron cambios (acciones de creación, actualización o eliminación). Este campo tiene un tamaño máximo de 100 kB y el contenido que supere el límite se rechaza.
errorCode	cadena	Opcional	Una cadena que representa un error para el evento. Limitaciones de longitud: longitud máxima de 256 caracteres.
errorMessage	cadena	Opcional	La descripción del error. Limitaciones de longitud: longitud máxima de 256 caracteres.
sourceIPAddress	cadena	Opcional	La dirección IP desde la que se realizó la solicitud IPv6Se aceptan IPv4 tanto direcciones como direcciones.
recipientAccountId	cadena	Obligatoria	Representa el ID de cuenta que recibió este evento. El ID de la cuenta debe ser el mismo que el ID de la AWS cuenta propietaria del canal.
additionalEventData	JSONobjeto	Opcional	Datos adicionales sobre el evento que no forman parte de la solicitud o la respuesta. Este campo tiene un tamaño máximo de 28 kB y el contenido que supere ese límite se rechaza.

El siguiente ejemplo muestra la jerarquía de los elementos del esquema que coinciden con los de los registros de CloudTrail eventos.

{
    "eventVersion": String,
    "eventCategory": String,
    "eventType": String,
    "eventID": String,
    "eventTime": String,
    "awsRegion": String,
    "recipientAccountId": String,
    "addendum": {
       "reason": String,
       "updatedFields": String,
       "originalUID": String, 
       "originalEventID": String
    },
    "metadata" : { 
       "ingestionTime": String,
       "channelARN": String
    },
    "eventData": {
        "version": String,
        "userIdentity": {
          "type": String,
          "principalId": String,
          "details": {
             JSON
          }
        }, 
        "userAgent": String,
        "eventSource": String,
        "eventName": String,
        "eventTime": String,
        "UID": String,
        "requestParameters": {
           JSON
        },
        "responseElements": {
           JSON
        },
        "errorCode": String,
        "errorMessage": String,
        "sourceIPAddress": String,
        "recipientAccountId": String,
        "additionalEventData": {
           JSON
        }
    }
}