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

# DescribeGlobalClusters
<a name="API_DescribeGlobalClusters"></a>

Retorna informações sobre os clusters globais do Amazon DocumentDB. Essa API dá suporte à paginação.

**nota**  
Essa ação se aplica somente aos clusters do Amazon DocumentDB.

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

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

 **Filters.Filter.N**   
Um filtro que especifica um ou mais clusters de banco de dados global a serem descritos.  
Filtros compatíveis: `db-cluster-id` aceita identificadores de cluster e agrupa Amazon Resource Names (ARNs). A lista de resultados incluirá apenas informações sobre os clusters identificados por eles ARNs.  
Tipo: matriz de objetos [Filter](API_Filter.md)  
Obrigatório: não

 ** GlobalClusterIdentifier **   
O identificador de cluster fornecido pelo usuário. Se esse parâmetro for especificado, somente as informações do cluster especificado serão retornadas. Este parâmetro não diferencia maiúsculas de minúsculas.  
Tipo: string  
Restrições de comprimento: tamanho mínimo de 1. Comprimento máximo de 255.  
Padrão: `[A-Za-z][0-9A-Za-z-:._]*`   
Obrigatório: não

 ** Marker **   
Um token de paginação opcional fornecido por uma solicitação `DescribeGlobalClusters` 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 do que o valor `MaxRecords` especificado, um token de paginação chamado de marcador será incluído na resposta para que os resultados restantes possam ser recuperados.   
Tipo: inteiro  
Obrigatório: Não

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

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

 **GlobalClusters. GlobalClusterMemberN.**   
  
Tipo: matriz de objetos [GlobalCluster](API_GlobalCluster.md)

 ** Marker **   
  
Tipo: string

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

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

 ** GlobalClusterNotFoundFault **   
`GlobalClusterIdentifier` não se refere a um cluster global existente.  
Código de status HTTP: 404

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