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.
Eliminación de un clúster de Amazon DocumentDB
Elimine un clúster de Amazon DocumentDB mediante la AWS Management Console o la AWS CLI. Para eliminar un clúster, el clúster debe tener el estado disponible y no debe tener ninguna instancia asociada a él. Si el clúster está detenido, inicie primero el clúster, espere a que el clúster esté disponible, y, a continuación, elimine el clúster. Para obtener más información, consulte Detención e inicio de un clúster de bases de datos de Amazon DocumentDB.
Protección contra eliminación
Para proteger su clúster contra la eliminación accidental, puede habilitar la protección contra eliminación. La protección contra eliminación se habilita de forma predeterminada cuando crea un clúster mediante la consola. Sin embargo, la protección contra eliminación está deshabilitada de forma predeterminada si crea un clúster con la AWS CLI.
Amazon DocumentDB aplica la protección contra eliminación para un clúster si realiza la operación de eliminación mediante la consola o la AWS CLI. Si la protección contra eliminación está habilitada, no podrá eliminar un clúster. Para eliminar un clúster con la protección contra eliminación habilitada, primero debe modificar el clúster y deshabilitar la protección contra eliminación.
Cuando use la consola con la protección contra eliminación habilitada en un clúster, no podrá eliminar la última instancia del clúster, ya que también se eliminará el clúster. Puede eliminar la última instancia de un clúster con protección contra eliminación con la AWS CLI. Sin embargo, el propio clúster sigue existiendo y se conservan los datos. Puede acceder a los datos mediante la creación de nuevas instancias para el clúster. Para obtener más información sobre cómo habilitar y deshabilitar la protección contra eliminación, consulte:
- Using the AWS Management Console
-
Para eliminar un clúster mediante la AWS Management Console, la protección contra eliminación debe estar deshabilitada.
Para determinar si un clúster tiene habilitada la protección contra eliminación, realice el siguiente procedimiento:
-
Inicie sesión en la AWS Management Console y abra la consola de Amazon DocumentDB en https://console.aws.amazon.com/docdb.
-
En el panel de navegación, seleccione Clusters (Clústeres).
Si no ve el panel de navegación del lado izquierdo de la pantalla, seleccione el icono de menú () en la esquina superior izquierda de la página.
-
Tenga en cuenta que en el cuadro de navegación de clústeres, la columna Identificador de clústeres muestra tanto los clústeres como las instancias. Las instancias se muestran en clústeres, de forma similar a la siguiente captura de pantalla.
-
Elija el nombre del clúster y seleccione la pestaña Configuración. En la sección Detalles del clúster busque Protección contra eliminación. Si la protección contra eliminación está habilitada, modifique el clúster para deshabilitar la protección contra eliminación. Para obtener más información sobre la modificación de un clúster, consulte Modificación de un clúster de Amazon DocumentDB.
Una vez que se deshabilite la protección contra eliminación, podrá eliminar el clúster.
Para eliminar un clúster:
-
En el panel de navegación, seleccione Clusters (Clústeres).
-
Compruebe la columna Instances (Instancias) para conocer si el clúster dispone de instancias. Para poder eliminar un clúster, debe eliminar todas sus instancias. Para obtener más información, consulte Eliminación de una instancia de Amazon DocumentDB.
-
Si su clúster dispone de instancias, realice uno de los siguientes pasos.
-
Si el clúster no tiene instancias, seleccione el botón situado a la izquierda del nombre del clúster y elija Acciones. En el menú desplegable, seleccione Eliminar. Complete el cuadro de diálogo Delete <cluster-name> (Eliminar <nombre de clúster>) y, a continuación, elija Delete (Eliminar).
Si el clúster tiene una o varias instancias, haga lo siguiente:
-
En el panel de navegación, seleccione Instances (Instancia[s]).
-
Elimine cada una de las instancias del clúster. Cuando elimine la última instancia, el clúster también se eliminará. Para obtener información sobre la eliminación de instancias, consulte Eliminación de una instancia de Amazon DocumentDB.
La eliminación del clúster puede tardar varios minutos. Para monitorizar el estado del clúster, consulte Supervisión del estado de un clúster de Amazon DocumentDB.
- Using the AWS CLI
-
No puede eliminar un clúster que tenga instancias asociadas. Para determinar qué instancias están asociadas al clúster, ejecute el comando describe-db-clusters
y elimine todas las instancias del clúster. A continuación, si es necesario, deshabilite la protección contra eliminación de su clúster y, por último, elimine el clúster.
-
En primer lugar, elimine todas las instancias del clúster.
Para determinar qué instancias necesita eliminar, ejecute el siguiente comando.
aws docdb describe-db-clusters \
--db-cluster-identifier sample-cluster \
--query 'DBClusters[*].[DBClusterIdentifier,DBClusterMembers[*].DBInstanceIdentifier]'
La salida de esta operación será similar a lo que se indica a continuación (formato JSON).
[
[
"sample-cluster",
[
"sample-instance-1",
"sample-instance-2"
]
]
]
Si el clúster que desea eliminar tiene instancias, elimínelas como se muestra a continuación.
aws docdb delete-db-instance \
--db-instance-identifier sample-instance
-
En segundo lugar, deshabilite la protección contra eliminación.
Si se usa la AWS CLI para eliminar todas las instancias de un clúster, no se elimina el clúster. También debe eliminar el clúster, pero puede hacerlo solo si se deshabilita la protección contra eliminación.
Para determinar si el clúster tiene la protección contra eliminación habilitada, ejecute el siguiente comando.
Para ver el estado de la protección contra eliminación de todos los clústeres de Amazon DocumentDB, omita el parámetro --db-cluster-identifier
.
aws docdb describe-db-clusters \
--db-cluster-identifier sample-cluster \
--query 'DBClusters[*].[DBClusterIdentifier,DeletionProtection]'
La salida de esta operación será similar a lo que se indica a continuación.
[
[
"sample-cluster",
"true"
]
]
Si el clúster tiene la protección contra eliminación habilitada, modifique el clúster y deshabilite la protección contra eliminación. Para deshabilitar la protección contra eliminación en el clúster, ejecute el siguiente comando.
aws docdb modify-db-cluster \
--db-cluster-identifier sample-cluster \
--no-deletion-protection \
--apply-immediately
-
Por último, elimine el clúster.
Una vez que la protección contra eliminación esté deshabilitada, podrá eliminar el clúster. Para eliminar un clúster, utilice la operación delete-db-cluster
con los siguientes parámetros.
-
--db-cluster-identifier
: obligatorio. El identificador del clúster que desee eliminar.
-
--final-db-snapshot-identifier
: opcional. Si desea una instantánea final, debe incluir este parámetro con un nombre para la instantánea final. Debe incluir --final-db-snapshot-identifier
o --skip-final-snapshot
.
Restricciones en la nomenclatura:
-
Debe tener [1-63] letras, números o guiones.
-
El primer carácter debe ser una letra.
-
No puede terminar por un guion ni contener dos guiones consecutivos.
-
Debe ser único para todos los clústeres de Amazon RDS, Amazon Neptune y Amazon DocumentDB por Cuenta de AWS y por región.
-
--skip-final-snapshot
: opcional. Use este parámetro solo si no desea realizar una instantánea final antes de eliminar el clúster. El comportamiento predeterminado es realizar una instantánea final. Debe incluir --final-db-snapshot-identifier
o --skip-final-snapshot
.
El siguiente código de la AWS CLI elimina el clúster sample-cluster
con una instantánea final. La operación genera un error si hay las instancias asociadas al clúster o si está habilitada la protección contra eliminación.
Para Linux, macOS o Unix:
aws docdb delete-db-cluster \
--db-cluster-identifier sample-cluster \
--final-db-snapshot-identifier sample-cluster-final-snapshot
Para Windows:
aws docdb delete-db-cluster ^
--db-cluster-identifier sample-cluster ^
--final-db-snapshot-identifier sample-cluster-final-snapshot
El siguiente código de la AWS CLI elimina el clúster sample-cluster
sin tomar una instantánea final.
Para Linux, macOS o Unix:
aws docdb delete-db-cluster \
--db-cluster-identifier sample-cluster \
--skip-final-snapshot
Para Windows:
aws docdb delete-db-cluster ^
--db-cluster-identifier sample-cluster ^
--skip-final-snapshot
El resultado de la operación delete-db-cluster
es el clúster que se va a eliminar.
La eliminación del clúster puede tardar varios minutos. Para monitorizar el estado del clúster, consulte Monitorización del estado de un clúster.