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.

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

Devuelve información sobre los clústeres globales de Amazon DocumentDB. Esta API admite la paginación.

**nota**  
Esta acción solo se aplica a los clústeres de Amazon DocumentDB.

## Parámetros de la solicitud
<a name="API_DescribeGlobalClusters_RequestParameters"></a>

 Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

 **Filters.Filter.N**   
Un filtro que especifica uno o varios clústeres de bases de datos globales a describir.  
Filtros compatibles: `db-cluster-id` acepta identificadores de clústeres y nombres de recursos de Amazon para clústeres (ARNs). La lista de resultados solo incluirá información sobre los clústeres identificados por ellos ARNs.  
Tipo: matriz de objetos [Filter](API_Filter.md)  
Obligatorio: no

 ** GlobalClusterIdentifier **   
El identificador de clúster de base de datos suministrado por el usuario. Si se especifica este parámetro, se devuelve información solo del clúster específico. Este parámetro no distingue entre mayúsculas y minúsculas.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 255 caracteres.  
Patrón: `[A-Za-z][0-9A-Za-z-:._]*`   
Obligatorio: no

 ** Marker **   
Un token de paginación opcional proporcionado por una solicitud `DescribeGlobalClusters` 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 que se conoce como marcador, de modo que usted pueda recuperar el resto de los resultados.   
Tipo: entero  
Obligatorio: no

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

El servicio devuelve los siguientes elementos.

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

 ** Marker **   
  
Tipo: cadena

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

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Errores comunes](CommonErrors.md).

 ** GlobalClusterNotFoundFault **   
`GlobalClusterIdentifier` no hace referencia a un clúster global existente.  
Código de estado HTTP: 404

## Véase también
<a name="API_DescribeGlobalClusters_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos 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)