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
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
Para obtener información sobre los parámetros comunes a todas las acciones, consulte Parámetros comunes.
- 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
DBClusterIdentifierexistente.
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úster y clústeres de los Nombres de recursos de Amazon (ARN). La lista de resultados solo incluye información sobre los clústeres identificados por estos ARN.
Tipo: matriz de objetos Filter
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
MaxRecordsespecificado, 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
El servicio devuelve los siguientes elementos.
- DBClusters.DBCluster.N
-
Una lista de clústeres.
Tipo: matriz de objetos DBCluster
- 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
Para obtener información acerca de los errores comunes a todas las acciones, consulte Errores comunes.
- DBClusterNotFoundFault
-
DBClusterIdentifierno hace referencia a un clúster existente.Código de estado HTTP: 404
Véase también
Para obtener más información sobre el uso de esta API en uno de los AWS SDK específicos del idioma, consulta lo siguiente:
