DescribeEvents - Amazon DocumentDB

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.

DescribeEvents

Devuelve eventos relacionados con las instancias, grupos de seguridad, instantáneas y grupos de parámetros de base de datos para los últimos 14 días. Los eventos específicos de una instancia de base de datos concreta, grupo de seguridad, instantánea o grupo de parámetros se pueden obtener proporcionando el nombre como parámetro. De forma predeterminada, se devuelven los eventos de la última hora.

Parámetros de la solicitud

Para obtener información sobre los parámetros comunes a todas las acciones, consulte Parámetros comunes.

Duration

El número de minutos para los que recuperar eventos.

Predeterminado: 60

Tipo: entero

Obligatorio: no

EndTime

El final del intervalo de tiempo para el que recuperar eventos, especificado en formato ISO 8601.

Ejemplo: 2009-07-08T18:00Z

Tipo: marca temporal

Obligatorio: no

EventCategories. EventCategoryN.

Una lista de categorías de eventos que desencadena notificaciones para la suscripción a notificaciones de eventos.

Tipo: matriz de cadenas

Obligatorio: no

Filters.Filter.N

Este parámetro es incompatible en estos momentos.

Tipo: matriz de objetos Filter

Obligatorio: no

Marker

Un token de paginación opcional proporcionado por una solicitud anterior. Si se especifica este parámetro, la respuesta solo incluye registros más allá del marcador, hasta el valor especificado por MaxRecords.

Tipo: cadena

Requerido: no

MaxRecords

El número máximo de registros que se deben incluir en la respuesta. Si el número de registros es superior al valor MaxRecords especificado, se incluye en la respuesta un token de paginación (marcador) de modo que se puedan recuperar el resto de los resultados.

Predeterminado: 100

Restricciones: mínimo 20, máximo 100.

Tipo: entero

Obligatorio: no

SourceIdentifier

El identificador del origen de eventos para el que se devuelven eventos. Si no se especifica, se incluyen todos los orígenes en la respuesta.

Restricciones:

  • Si se proporciona SourceIdentifier, también se debe proporcionar SourceType.

  • Si el tipo de origen es DBInstance, debe proporcionarse un DBInstanceIdentifier.

  • Si el tipo de origen es DBSecurityGroup, debe proporcionarse un DBSecurityGroupName.

  • Si el tipo de origen es DBParameterGroup, debe proporcionarse un DBParameterGroupName.

  • Si el tipo de origen es DBSnapshot, debe proporcionarse un DBSnapshotIdentifier.

  • No puede terminar por un guion ni contener dos guiones consecutivos.

Tipo: cadena

Requerido: no

SourceType

El origen del evento para el que recuperar eventos. Si no se especifica ningún valor, se devuelven todos los eventos.

Tipo: cadena

Valores válidos: db-instance | db-parameter-group | db-security-group | db-snapshot | db-cluster | db-cluster-snapshot

Obligatorio: no

StartTime

El principio del intervalo de tiempo para el que recuperar eventos, especificado en formato ISO 8601.

Ejemplo: 2009-07-08T18:00Z

Tipo: marca temporal

Obligatorio: no

Elementos de respuesta

El servicio devuelve los siguientes elementos.

Events.Event.N

Información detallada sobre uno o varios eventos.

Tipo: matriz de objetos Event

Marker

Un token de paginación opcional proporcionado por una solicitud anterior. Si se especifica este parámetro, la respuesta solo incluye registros más allá del marcador, hasta el valor especificado por MaxRecords.

Tipo: cadena

Errores

Para obtener información acerca de los errores comunes a todas las acciones, consulte Errores comunes.

Véase también

Para obtener más información sobre el uso de esta API en uno de los AWS SDK específicos del idioma, consulta lo siguiente: