DeleteDBCluster - Amazon DocumentDB

DeleteDBCluster

Elimina un clúster de aprovisionado anteriormente. Al eliminar un clúster, se eliminan todas las copias de seguridad automatizadas para ese clúster y no se pueden recuperar. Las instantáneas manuales del clúster de base de datos del clúster especificado no se eliminan.

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 del clúster del clúster que se va a eliminar. Este parámetro no distingue entre mayúsculas y minúsculas.

Restricciones:

  • Debe coincidir con un DBClusterIdentifier existente.

Tipo: cadena

Obligatorio: sí

FinalDBSnapshotIdentifier

El identificador de instantánea de clúster de la nueva instantánea del clúster creada al configurar SkipFinalSnapshot como false.

nota

Se especifica este parámetro y también el parámetro SkipFinalShapshot en true genera un error.

Restricciones:

  • Debe tener de 1 a 255 letras, números o guiones.

  • El primer carácter debe ser una letra.

  • No puede terminar por un guion ni contener dos guiones consecutivos.

Tipo: cadena

Requerido: no

SkipFinalSnapshot

Determina si se crea una instantánea de clúster final antes de que se elimine el clúster. Si se especifica true, no se crea ninguna instantánea del clúster. Si se especifica false, se crea una instantánea de clúster antes de que se elimine el clúster de base de datos.

nota

Debe especificar un parámetro FinalDBSnapshotIdentifier si SkipFinalSnapshot es false.

Valor predeterminado: false

Tipo: Booleano

Requerido: no

Elementos de respuesta

El servicio devuelve el siguiente elemento.

DBCluster

Información detallada sobre un clúster.

Tipo: objeto DBCluster

Errores

Para obtener información acerca de los errores comunes a todas las acciones, consulte Errores comunes.

DBClusterNotFoundFault

DBClusterIdentifier no hace referencia a un clúster existente.

Código de estado HTTP: 404

DBClusterSnapshotAlreadyExistsFault

El usuario ya tiene una instantánea del clúster con el identificador concreto.

Código de estado HTTP: 400

InvalidDBClusterSnapshotStateFault

El valor proporcionado no es un estado de instantánea de clúster válido.

Código de estado HTTP: 400

InvalidDBClusterStateFault

El clúster no se encuentra en un estado válido.

Código de estado HTTP: 400

SnapshotQuotaExceeded

La solicitud provocaría que superara el número de instantáneas permitido.

Código de estado HTTP: 400

Véase también

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte: