Modificación de un clúster de Amazon DocumentDB

Para modificar un clúster, el clúster debe tener el estado available (disponible). No puede modificar un clúster que está detenido. Si el clúster está detenido, inicie primero el clúster, espere a que el clúster esté disponible y, a continuación, realice las modificaciones deseadas. Para obtener más información, consulte Detener e iniciar un clúster de Amazon DocumentDB.

Using the AWS Management Console

Utilice el siguiente procedimiento para modificar un clúster de Amazon DocumentDB específico mediante la consola.

Modificación de un clúster de Amazon DocumentDB

1. Inicie sesión en la consola AWS Management Console de Amazon DocumentDB y ábrala en https://console.aws.amazon.com/docdb.

2. En el panel de navegación, seleccione Clusters (Clústeres).

   sugerencia

   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.

3. Especifique el clúster que desee modificar seleccionando el botón situado a la izquierda del nombre del clúster.

4. Elija Actions (Acciones) y después Modify (Modificar).

5. En el panel Modify Cluster: <cluster-name> (Modificar clúster: <nombre-clúster>, realice los cambios que desee. Puede realizar cambios en las siguientes áreas:

   • Especificaciones del clúster: la contraseña, los grupos de seguridad y el nombre del clúster.

   • Configuración de almacenamiento en clúster: modo de almacenamiento de datos del clúster. Elija entre la configuración estándar y la optimizada para E/S.

   • Opciones del clúster: el grupo de parámetros y el puerto del clúster.

   • Copia de seguridad: el período de copia de seguridad y de retención de la copia de seguridad del clúster.

   • Exportación de registros: permite habilitar o deshabilitar los registros de auditoría o perfiles de exportación.

   • Mantenimiento: permite establecer la ventana de mantenimiento del clúster.

   • Protección de eliminación: permite habilitar o deshabilitar la protección de eliminación en el clúster. La protección contra eliminación está habilitada de forma predeterminada.

6. Cuando haya terminado, elija Continuar para ver un resumen de los cambios.

7. Si está satisfecho con los cambios, puede elegir Modificar clúster para modificar el clúster. También puede elegir Atrás o Cancelar para editar o cancelar los cambios, respectivamente.

Los cambios pueden tardar unos minutos en aplicarse. Solo se puede usar el clúster cuando su estado sea available (disponible). Puede monitorizar el estado del clúster mediante la consola o la AWS CLI. Para obtener más información, consulte Supervisión del estado de un clúster de Amazon DocumentDB.

Using the AWS CLI

Utilice la operación modify-db-cluster para modificar el clúster especificado mediante la AWS CLI. Para obtener más información, consulte ModifyDBCluster en la Referencia de la API de Amazon DocumentDB.

Parámetros

• --db-cluster-identifier: obligatorio. El identificador del clúster de Amazon DocumentDB que va a modificar.

• --backup-retention-period: opcional. El número de días durante los que se retienen las copias de seguridad automatizadas. Los valores válidos están comprendidos entre 1 y 35.

• --storage-type: opcional. La configuración de almacenamiento del clúster. Los valores válidos son standard (estándar) o iopt1 (optimizados para E/S).

• --db-cluster-parameter-group-name: opcional. El nombre del grupo de parámetros de clúster que se va a usar para el clúster.

• --master-user-password: opcional. La nueva contraseña del usuario principal de la base de datos.

  Restricciones para la contraseña:

  • La longitud es de 8 a 100 caracteres ASCII imprimibles.

  • Se puede utilizar cualquier carácter ASCII imprimible, excepto los siguientes:

    • / (barra inclinada)

    • " (comillas dobles)

    • @ (símbolo de arroba)

• --new-db-cluster-identifier: opcional. El nuevo identificador del clúster cuando se cambia el nombre de un clúster. Este valor se almacena como una cadena en minúsculas.

  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 región. Cuenta de AWS

• --preferred-backup-window: opcional. El intervalo de tiempo diario (en Tiempo Universal Coordinado [UTC]) durante el cual se crean copias de seguridad automatizadas.

  • Formato: hh24:mm-hh24:mm

• --preferred-maintenance-window: opcional. El intervalo de tiempo semanal (en UTC) durante el cual puede llevarse a cabo el mantenimiento del sistema.

  • Formato: ddd:hh24:mm-ddd:hh24:mm

  • Días válidos: Sun, Mon, Tue, Wed, Thu, Fri y Sat.

• --deletion-protection o --no-deletion-protection: opcional. Si la protección contra eliminación se debe habilitar en este clúster. La protección contra eliminación evita que el clúster se elimine accidentalmente hasta que se modifique para deshabilitar la protección contra eliminación. Para obtener más información, consulte Eliminar un clúster de Amazon DocumentDB.

• --apply-immediately o --no-apply-immediately: utilice --apply-immediately para aplicar los cambios inmediatamente. Utilice --no-apply-immediately para aplicar el cambio durante el próximo periodo de mantenimiento de su clúster.

El siguiente código cambia el periodo de retención de copia de seguridad del clúster sample-cluster.

Para Linux, macOS o Unix:

aws docdb modify-db-cluster \
       --db-cluster-identifier sample-cluster \
       --apply-immediately \
       --backup-retention-period 7

Para Windows:

aws docdb modify-db-cluster ^
       --db-cluster-identifier sample-cluster ^
       --apply-immediately ^
       --backup-retention-period 7

La salida de esta operación será similar a lo que se indica a continuación.

{
    "DBCluster": {
        "BackupRetentionPeriod": 7,
        "DbClusterResourceId": "cluster-VDP53QEWST7YHM36TTXOPJT5YE",
        "Status": "available",
        "DBClusterMembers": [
            {
                "PromotionTier": 1,
                "DBClusterParameterGroupStatus": "in-sync",
                "DBInstanceIdentifier": "sample-cluster-instance",
                "IsClusterWriter": true
            }
        ],
        "ReadReplicaIdentifiers": [],
        "AvailabilityZones": [
            "us-east-1b",
            "us-east-1c",
            "us-east-1a"
        ],
        "ReaderEndpoint": "sample-cluster.cluster-ro-ctevjxdlur57.us-east-1.rds.amazonaws.com",
        "DBClusterArn": "arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster",
        "PreferredMaintenanceWindow": "sat:09:51-sat:10:21",
        "EarliestRestorableTime": "2018-06-17T00:06:19.374Z",
        "StorageEncrypted": false,
        "MultiAZ": false,
        "AssociatedRoles": [],
        "MasterUsername": "<your-master-user-name>",
        "DBClusterIdentifier": "sample-cluster",
        "VpcSecurityGroups": [
            {
                "Status": "active",
                "VpcSecurityGroupId": "sg-77186e0d"
            }
        ],
        "HostedZoneId": "Z2SUY0A1719RZT",
        "LatestRestorableTime": "2018-06-18T21:17:05.737Z",
        "AllocatedStorage": 1,
        "Port": 27017,
        "Engine": "docdb",
        "DBClusterParameterGroup": "default.docdb3.4",
        "Endpoint": "sample-cluster.cluster-ctevjxdlur57.us-east-1.rds.amazonaws.com",
        "DBSubnetGroup": "default",
        "PreferredBackupWindow": "00:00-00:30",
        "EngineVersion": "3.4",
        "ClusterCreateTime": "2018-06-06T19:25:47.991Z",
        "IAMDatabaseAuthenticationEnabled": false
    }
}

Los cambios pueden tardar unos minutos en aplicarse. Solo se puede usar el clúster cuando su estado sea available (disponible). Puede monitorizar el estado del clúster mediante la consola o la AWS CLI. Para obtener más información, consulte Supervisión del estado de un clúster de Amazon DocumentDB.