DescribeDBClusterSnapshots - Amazon DocumentDB
Parâmetros de SolicitaçãoElementos de RespostaErrosConsulte Também

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

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

Parâmetros de Solicitação

Para obter informações sobre os parâmetros comuns a todas as ações, consulte Parâmetros comuns.

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

Obrigatório: Não

IncludePublic

Definido para true para incluir capturas de tela manuais públicas do cluster públicos, que podem ser copiadas ou restauradas por qualquer Conta da AWS; caso contrário, false. O padrão é false.

Tipo: Booliano

Obrigatório: Não

IncludeShared

Definido para true para incluir capturas de tela manuais compartilhadas do cluster a partir de outros Contas da AWS que esse Conta da AWS tenha recebido permissão para copiar ou restaurar; caso contrário, 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. Você pode incluir capturas de tela do cluster compartilhadas com esses resultados configurando o parâmetro IncludeShared para true. Você pode 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

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

DBClusterSnapshots.DBClusterSnapshot.N

Fornece uma lista de capturas de tela do cluster.

Tipo: matriz de objetos DBClusterSnapshot

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

Para obter informações sobre erros comuns a todas as ações, consulte Erros comuns.

DBClusterSnapshotNotFoundFault

DBClusterSnapshotIdentifier não se refere a um snapshot de cluster existente.

Código de Status HTTP: 404

Consulte Também

Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte: