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.

# DescribeDBInstances
<a name="API_DescribeDBInstances"></a>

Devuelve información acerca de las instancias de Amazon DocumentDB aprovisionadas. Esta API admite la paginación.

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

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

 ** DBInstanceIdentifier **   
El identificador de instancia proporcionado por el usuario. Si se especifica este parámetro, solo se devuelve información de la instancia específica. Este parámetro no distingue entre mayúsculas y minúsculas.  
Restricciones:  
+ De ser proporcionado, debe coincidir con el identificador de un `DBInstance` existente.
Tipo: cadena  
Requerido: no

 **Filters.Filter.N**   
Un filtro que especifica una o varias instancias para 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 incluye solo la información sobre las instancias asociadas a los clústeres que estos ARNs identifican.
+  `db-instance-id`- Acepta los identificadores de instancia y la instancia ARNs. La lista de resultados incluye solo la información sobre las instancias identificadas por estos 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_DescribeDBInstances_ResponseElements"></a>

El servicio devuelve los siguientes elementos.

 **DBInstances. DBInstance**N.   
Información detallada sobre una o varias instancias.   
Tipo: matriz de objetos [DBInstance](API_DBInstance.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_DescribeDBInstances_Errors"></a>

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

 ** DBInstanceNotFound **   
 `DBInstanceIdentifier` no hace referencia a una instancia existente.   
Código de estado HTTP: 404

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