As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# DescribeEvents
<a name="API_DescribeEvents"></a>

Retorna os eventos relacionados a instâncias, grupos de segurança, snapshots e grupos de parâmetros de banco de dados dos últimos 14 dias. É possível obter eventos específicos para uma determinada instância, grupo de segurança, snapchot,ou grupo de parâmetros de banco de dados, fornecendo o nome como um parâmetro. Por padrão, os eventos da última hora são retornados.

## Parâmetros da solicitação
<a name="API_DescribeEvents_RequestParameters"></a>

 Para obter informações sobre os parâmetros comuns a todas as ações, consulte [Parâmetros Comuns](CommonParameters.md).

 ** Duration **   
O número de minutos dos quais recuperar eventos.  
Padrão: 60  
Tipo: inteiro  
Obrigatório: não

 ** EndTime **   
 O fim do intervalo de tempo do qual recuperar eventos, especificado no formato ISO 8601.   
Exemplo: 2009-07-08T18:00Z  
Tipo: Carimbo de data/hora  
Obrigatório: não

 **EventCategories. EventCategoryN.**   
Uma lista de categorias que disparam notificações para uma assinatura de notificações de um evento.  
Tipo: matriz de strings  
Obrigatório: Não

 **Filters.Filter.N**   
Não há suporte para esse parâmetro atualmente.  
Tipo: matriz de objetos [Filter](API_Filter.md)  
Obrigatório: não

 ** Marker **   
Um token de paginação opcional fornecido por uma solicitação anterior. Se esse parâmetro for especificado, a resposta incluirá apenas os registros além do marcador, até o valor especificado por `MaxRecords`.  
Tipo: string  
Obrigatório: Não

 ** MaxRecords **   
 O número máximo de registros a serem incluídos na resposta. Se existirem mais registros que o valor `MaxRecords` especificado, um token de paginação (marcador) será incluído na resposta para que os resultados restantes possam ser recuperados.  
Padrão: 100  
Restrições: mínimo de 20, máximo de 100.  
Tipo: número inteiro  
Obrigatório: não

 ** SourceIdentifier **   
O identificador da origem do evento para o qual os eventos são retornados. Se não for especificado, todas as origens serão incluídas na resposta.  
Restrições:  
+ Se `SourceIdentifier` for fornecido, `SourceType` também deve ser fornecido.
+ Se o tipo de fonte for `DBInstance`, um `DBInstanceIdentifier` deve ser fornecido.
+ Se o tipo de fonte for `DBSecurityGroup`, um `DBSecurityGroupName` deve ser fornecido.
+ Se o tipo de fonte for `DBParameterGroup`, um `DBParameterGroupName` deve ser fornecido.
+ Se o tipo de fonte for `DBSnapshot`, um `DBSnapshotIdentifier` deve ser fornecido.
+ Não pode terminar com um hífen ou conter dois hifens consecutivos.
Tipo: string  
Obrigatório: não

 ** SourceType **   
A origem do evento da qual recuperar eventos. Se nenhum valor for especificado, todos os eventos serão retornados.  
Tipo: string  
Valores válidos: `db-instance | db-parameter-group | db-security-group | db-snapshot | db-cluster | db-cluster-snapshot`   
Obrigatório: não

 ** StartTime **   
 O início do intervalo de tempo do qual recuperar eventos, especificado no formato ISO 8601.   
Exemplo: 2009-07-08T18:00Z  
Tipo: Carimbo de data/hora  
Obrigatório: não

## Elementos de Resposta
<a name="API_DescribeEvents_ResponseElements"></a>

O serviço retorna os seguintes elementos.

 **Events.Event.N**   
: informações detalhadas sobre um ou mais eventos.   
Tipo: matriz de objetos [Event](API_Event.md)

 ** Marker **   
Um token de paginação opcional fornecido por uma solicitação anterior. Se esse parâmetro for especificado, a resposta incluirá apenas os registros além do marcador, até o valor especificado por `MaxRecords`.  
Tipo: string

## Erros
<a name="API_DescribeEvents_Errors"></a>

Para obter informações sobre os erros comuns retornados pelas ações, consulte [Erros comuns](CommonErrors.md).

## Consulte também
<a name="API_DescribeEvents_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/docdb-2014-10-31/DescribeEvents) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/DescribeEvents) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/DescribeEvents) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/DescribeEvents) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/DescribeEvents) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/DescribeEvents) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/DescribeEvents) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/DescribeEvents) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/DescribeEvents) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/DescribeEvents)