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 proporcionarSourceType
. -
Si el tipo de origen es
DBInstance
, debe proporcionarse unDBInstanceIdentifier
. -
Si el tipo de origen es
DBSecurityGroup
, debe proporcionarse unDBSecurityGroupName
. -
Si el tipo de origen es
DBParameterGroup
, debe proporcionarse unDBParameterGroupName
. -
Si el tipo de origen es
DBSnapshot
, debe proporcionarse unDBSnapshotIdentifier
. -
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: