

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.

# DescribeDBClusterSnapshots
<a name="API_DescribeDBClusterSnapshots"></a>

Devuelve información acerca de instantáneas del clúster. La operación API admite la paginación.

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

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

 ** DBClusterIdentifier **   
El ID del clúster para recuperar la lista de instantáneas del clúster. Este parámetro no puede utilizarse con el parámetro `DBClusterSnapshotIdentifier`. Este parámetro no distingue entre mayúsculas y minúsculas.   
Restricciones:  
+ De ser proporcionado, debe coincidir con el identificador de un `DBCluster` existente.
Tipo: cadena  
Requerido: no

 ** DBClusterSnapshotIdentifier **   
Un identificador de instantánea de clúster específica para describir. Este parámetro no puede utilizarse con el parámetro `DBClusterIdentifier`. Este valor se almacena como una cadena en minúsculas.   
Restricciones:  
+ De ser proporcionado, debe coincidir con el identificador de un `DBClusterSnapshot` existente.
+ Si este identificador es para una instantánea automatizada, también se debe especificar el parámetro `SnapshotType`.
Tipo: cadena  
Requerido: no

 **Filters.Filter.N**   
Este parámetro es incompatible en estos momentos.  
Tipo: matriz de objetos [Filter](API_Filter.md)  
Obligatorio: no

 ** IncludePublic **   
Configúrelo `true` para incluir instantáneas de clústeres manuales que sean públicas y que cualquiera pueda copiar o restaurar Cuenta de AWS, o de cualquier otra manera. `false` El valor predeterminado es `false`.  
Tipo: Booleano  
Obligatorio: no

 ** IncludeShared **   
Configúrelo `true` para incluir instantáneas de clústeres manuales compartidas de otros clústeres para las Cuentas de AWS que se le Cuenta de AWS haya dado permiso para copiar o restaurar, o de cualquier otro modo. `false` El valor predeterminado es `false`.  
Tipo: Booleano  
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

 ** SnapshotType **   
El tipo de instantáneas del clúster que se van a devolver. Puede especificar uno de los siguientes valores:  
+  `automated`: se devuelven todas las instantáneas del clúster que Amazon DocumentDB haya creado automáticamente para su Cuenta de AWS.
+  `manual`: se devuelven todas las instantáneas del clúster que haya creado manualmente para su Cuenta de AWS.
+  `shared`: se devuelven todas las instantáneas manuales del clúster que se han compartido a su Cuenta de AWS.
+  `public`: se devuelven todas las instantáneas del clúster que se han marcado como públicas.
Si no se especifica ningún valor para `SnapshotType`, se devuelve las instantáneas del clúster automatizadas y manuales. Puede incluir instantáneas del clúster compartidas con estos resultados estableciendo el parámetro `IncludeShared` en `true`. Puede incluir instantáneas del clúster de base de datos públicas con estos resultados estableciendo el parámetro `IncludePublic` en `true`.  
Los parámetros `IncludeShared` y `IncludePublic` no se aplican para los valores de `SnapshotType` de `manual` o `automated`. El parámetro `IncludePublic` no se aplica cuando se establece `SnapshotType` en `shared`. El parámetro `IncludeShared` no se aplica cuando se establece `SnapshotType` en `public`.  
Tipo: cadena  
Requerido: no

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

El servicio devuelve los siguientes elementos.

 **DBClusterInstantáneas. DBClusterInstantánea.**   
Proporciona una lista de instantáneas del clúster.  
Tipo: matriz de objetos [DBClusterSnapshot](API_DBClusterSnapshot.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_DescribeDBClusterSnapshots_Errors"></a>

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

 ** DBClusterSnapshotNotFoundFault **   
 `DBClusterSnapshotIdentifier` no hace referencia a una instantánea de un clúster existente.   
Código de estado HTTP: 404

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