

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á.

# DescribeDBClusterSnapshots
<a name="API_DescribeDBClusterSnapshots"></a>

Retorna informações sobre captura de tela do cluster. A operação API oferece suporte à paginação.

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

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

 ** DBClusterIdentifier **   
ID do cluster para recuperar a lista de captura de tela de cluster. Esse parâmetro não pode ser usado com o parâmetro `DBClusterSnapshotIdentifier`. Esse parâmetro não diferencia maiúsculas de minúsculas.   
Restrições:  
+ Caso fornecido, deve corresponder ao identificador de um `DBCluster` existente.
Tipo: string  
Obrigatório: não

 ** DBClusterSnapshotIdentifier **   
Um identificador de captura de tela de cluster específico a ser descrito. Esse parâmetro não pode ser usado com o parâmetro `DBClusterIdentifier`. Esse valor é armazenado como uma string em minúsculas.   
Restrições:  
+ Caso fornecido, deve corresponder ao identificador de um `DBClusterSnapshot` existente.
+ Se esse identificador for uma captura de tela automatizada, o parâmetro `SnapshotType` também deverá ser especificado.
Tipo: string  
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

 ** IncludePublic **   
Defina `true` para incluir instantâneos manuais de cluster que sejam públicos e possam ser copiados ou restaurados por qualquer pessoa Conta da AWS, ou de outra forma. `false` O padrão é `false`.  
Tipo: booliano  
Obrigatório: não

 ** IncludeShared **   
Defina `true` para incluir instantâneos de cluster manuais compartilhados de outros Contas da AWS que Conta da AWS tenham permissão para copiar ou restaurar, entre outros. `false` O padrão é `false`.  
Tipo: booliano  
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

 ** SnapshotType **   
O tipo de snapshots de cluster a ser retornado. É possível especificar um dos seguintes valores:  
+  `automated` - Retorne todas as capturas de tela de cluster que o Amazon DocumentDB criou automaticamente para sua Conta da AWS.
+  `manual` - Retorne todas as capturas de tela de cluster que você criou manualmente para sua Conta da AWS.
+  `shared` – retorna todas as capturas de tela manuais do cluster compartilhadas para a minha Conta da AWS.
+  `public` – retorna todos os snapshots do cluster que foram marcados como públicos.
Se você não especificar um valor `SnapshotType`, as captura de tela de cluster automatizadas e manuais serão retornadas. É possível incluir capturas de tela do cluster compartilhadas com esses resultados configurando o parâmetro `IncludeShared` para `true`. É possível incluir capturas de tela públicas do cluster com esses resultados configurando o parâmetro `IncludePublic` para `true`.  
Os parâmetros `IncludeShared` e `IncludePublic` não se aplicam aos valores `SnapshotType` de `manual` ou `automated`. O parâmetro `IncludePublic` não se aplica quando `SnapshotType` está definido como `shared`. O parâmetro `IncludeShared` não se aplica quando `SnapshotType` está definido como `public`.  
Tipo: string  
Obrigatório: Não

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

Os seguintes elementos são retornados pelo serviço.

 **DBClusterInstantâneos. DBClusterInstantâneo**. N   
Fornece uma lista de capturas de tela do cluster.  
Tipo: matriz de objetos [DBClusterSnapshot](API_DBClusterSnapshot.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_DescribeDBClusterSnapshots_Errors"></a>

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

 ** DBClusterSnapshotNotFoundFault **   
 `DBClusterSnapshotIdentifier` não se refere a um snapshot de cluster existente.   
Código de status HTTP: 404

## Consulte Também
<a name="API_DescribeDBClusterSnapshots_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/DescribeDBClusterSnapshots) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/DescribeDBClusterSnapshots) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/DescribeDBClusterSnapshots) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/DescribeDBClusterSnapshots) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/DescribeDBClusterSnapshots) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/DescribeDBClusterSnapshots) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/DescribeDBClusterSnapshots) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/DescribeDBClusterSnapshots) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/DescribeDBClusterSnapshots) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/DescribeDBClusterSnapshots) 