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.

# DescribeDBClusters
<a name="API_DescribeDBClusters"></a>

Devuelve información acerca de los clústeres de Amazon DocumentDB. La operación API admite la paginación. Para ciertas características de administración, como la administración del ciclo de vida de clúster y de instancia, Amazon DocumentDB aprovecha la tecnología operativa que se comparte con Amazon RDS and Amazon Neptune. Utilice el parámetro de filtro `filterName=engine,Values=docdb` para devolver únicamente los clústeres de Amazon DocumentDB.

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

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

 ** DBClusterIdentifier **   
El identificador de clúster proporcionado 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.  
Restricciones:  
+ Si se suministra, debe coincidir con un `DBClusterIdentifier` existente.
Tipo: cadena  
Requerido: no

 **Filters.Filter.N**   
Un filtro que especifica uno o varios clústeres por 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 incluye información sobre los clústeres identificados por ellos ARNs.
Tipo: matriz de objetos [Filter](API_Filter.md)  
Obligatorio: no

 ** Marker **   
Un token de paginación opcional proporcionado por una solicitud 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 (marcador) de modo que se puedan recuperar el resto de los resultados.  
Predeterminado: 100  
Restricciones: mínimo 20, máximo 100.  
Tipo: entero  
Obligatorio: no

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

El servicio devuelve los siguientes elementos.

 **DBClusters. DBCluster**N.   
Una lista de clústeres.  
Tipo: matriz de objetos [DBCluster](API_DBCluster.md)

 ** Marker **   
Un token de paginación opcional proporcionado por una solicitud 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

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

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

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

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