Modificación de un clúster de Amazon DocumentDB - Amazon DocumentDB

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.

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 y abra la AWS Management Console consola de Amazon DocumentDB 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ú (Hamburger menu icon with three horizontal lines.) 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 ModifyDBClusterla referencia de Amazon DocumentDB. API

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—100] caracteres imprimiblesASCII.

    • Puede utilizar cualquier ASCII carácter 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 AmazonRDS, Amazon Neptune y Amazon DocumentDB Cuenta de AWS por región.

  • --preferred-backup-window: opcional. El intervalo de tiempo diario durante el cual se crean las copias de seguridad automatizadas, en tiempo universal coordinado ()UTC.

    • Formato: hh24:mm-hh24:mm

  • --preferred-maintenance-window: opcional. El intervalo de tiempo semanal durante el cual se puede realizar el mantenimiento del sistema, enUTC.

    • 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.