Reinicio de la instancia de Amazon DocumentDB - Amazon DocumentDB

Reinicio de la instancia de Amazon DocumentDB

Es posible que en algún momento necesite reiniciar su instancia de Amazon DocumentDB, normalmente por razones de mantenimiento. Si realiza determinados cambios, como cambiar el grupo de parámetros de clúster asociado a un clúster, debe reiniciar las instancias del clúster para que los cambios surtan efecto. Puede reiniciar una instancia especificada mediante la AWS Management Console o la AWS CLI.

Cuando se reinicia una instancia, se reinicia el servicio del motor de base de datos. Al reiniciar una instancia, se produce una interrupción momentánea, durante la cual su estado se establece en rebooting. Cuando finaliza el reinicio, se crea un evento de Amazon DocumentDB.

El reinicio de una instancia no produce una conmutación por error. Para conmutar por error un clúster de Amazon DocumentDB, utilice la AWS Management Console o la operación failover-db-cluster de la AWS CLI. Para obtener más información, consulte Conmutación por error a Amazon DocumentDB.

No puede reiniciar su instancia si no tiene el estado disponible. La base de datos puede no estar disponible por varias razones, como una modificación solicitada anteriormente o una acción durante un periodo de mantenimiento. Para obtener más información acerca de los estados de las instancias, consulte Supervisión del estado de un clúster de Amazon DocumentDB.

Using the AWS Management Console

El siguiente procedimiento reinicia una instancia especificada mediante la consola.

  1. Inicie sesión en la AWS Management Console y abra la 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. En el cuadro de navegación de clústeres, verá la columna Identificador del clúster. Las instancias se muestran en clústeres, de forma similar a la siguiente captura de pantalla.

    DocumentDB clusters list showing two clusters with their identifiers and roles.
  4. Marque la casilla de verificación situada a la izquierda de la instancia que desea reiniciar.

  5. Elija Actions (Acciones), después Reboot (Reiniciar) y, por último, Reboot (Reiniciar) para confirmar el reinicio.

El reinicio de la instancia puede tardar unos minutos. Solo puede usar la instancia cuando su estado sea available (disponible). Puede monitorizar el estado de la instancia 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

Para reiniciar una instancia de Amazon DocumentDB, utilice la operación reboot-db-instance con el parámetro --db-instance-identifier. Este parámetro especifica el identificador de la instancia que se va a reiniciar.

El siguiente código reinicia la instancia sample-instance.

Para Linux, macOS o Unix:

aws docdb reboot-db-instance \ --db-instance-identifier sample-instance

Para Windows:

aws docdb reboot-db-instance ^ --db-instance-identifier sample-instance

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

{ "DBInstance": { "DBInstanceIdentifier": "sample-instance", "DBInstanceClass": "db.r5.large", "Engine": "docdb", "DBInstanceStatus": "rebooting", "Endpoint": { "Address": "sample-instance.node.us-east-1.docdb.amazonaws.com", "Port": 27017, "HostedZoneId": "ABCDEFGHIJKLM" }, "InstanceCreateTime": "2020-03-27T08:05:56.314Z", "PreferredBackupWindow": "02:00-02:30", "BackupRetentionPeriod": 1, "VpcSecurityGroups": [ { "VpcSecurityGroupId": "sg-abcd0123", "Status": "active" } ], "AvailabilityZone": "us-east-1c", "DBSubnetGroup": { "DBSubnetGroupName": "default", "DBSubnetGroupDescription": "default", "VpcId": "vpc-abcd0123", "SubnetGroupStatus": "Complete", "Subnets": [ { "SubnetIdentifier": "subnet-abcd0123", "SubnetAvailabilityZone": { "Name": "us-east-1a" }, "SubnetStatus": "Active" }, { "SubnetIdentifier": "subnet-wxyz0123", "SubnetAvailabilityZone": { "Name": "us-east-1b" }, "SubnetStatus": "Active" } ] }, "PreferredMaintenanceWindow": "sun:06:53-sun:07:23", "PendingModifiedValues": {}, "EngineVersion": "3.6.0", "AutoMinorVersionUpgrade": true, "PubliclyAccessible": false, "DBClusterIdentifier": "sample-cluster", "StorageEncrypted": true, "KmsKeyId": "arn:aws:kms:us-east-1:<accountID>:key/sample-key", "DbiResourceId": "db-ABCDEFGHIJKLMNOPQRSTUVWXYZ", "CACertificateIdentifier": "rds-ca-2019", "PromotionTier": 1, "DBInstanceArn": "arn:aws:rds:us-east-1:<accountID>:db:sample-instance", "EnabledCloudwatchLogsExports": [ "profiler" ] } }

El reinicio de la instancia puede tardar unos minutos. Solo puede usar la instancia cuando su estado sea available (disponible). Puede monitorizar el estado de la instancia 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.