

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.

# Actualización de un parche a la versión del motor de un clúster
<a name="db-cluster-version-upgrade"></a>

En esta sección, explicaremos cómo implementar una actualización de parche mediante el Consola de administración de AWS o el AWS CLI. Una actualización de parche es una actualización dentro de la misma versión del motor (por ejemplo, la actualización de una versión del motor 3.6 a una versión del motor 3.6 más reciente). Puede actualizarla inmediatamente o durante el próximo periodo de mantenimiento del clúster. Para determinar si el motor necesita una actualización, consulte [Determinación de las tareas de mantenimiento pendientes](db-cluster-determine-pending-maintenance.md). Tenga en cuenta que, al aplicar la actualización, su clúster sufrirá algún tiempo de inactividad.

**nota**  
Si está intentando actualizar una versión principal del motor a otra, como la 3.6 a la 5.0 o la 5.0 a la 8.0, consulte [Actualización local de la versión principal Amazon DocumentDB](docdb-mvu.md) o[Actualización del clúster de Amazon DocumentDB mediante AWS Database Migration Service](docdb-migration.versions.md).

Existen dos requisitos de configuración para obtener las actualizaciones de parches más recientes para la versión del motor de un clúster:
+ El estado del clúster debe ser *disponible*.
+ El clúster debe estar ejecutando una versión del motor más antigua.

------
#### [ Using the Consola de administración de AWS ]

El siguiente procedimiento actualiza los parches de la versión del motor de su clúster a la versión más reciente con la consola. Puede actualizarla inmediatamente o durante el próximo periodo de mantenimiento del clúster.

1. Inicie sesión en y abra la Consola de administración de AWS consola de Amazon DocumentDB en. [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb)

1. En el panel de navegación, seleccione **Clusters (Clústeres)**. En la lista de clústeres, elija el botón situado a la izquierda del clúster que desee actualizar. El estado del clúster debe ser *disponible*.
**sugerencia**  
Si no ve el panel de navegación del lado izquierdo de la pantalla, seleccione el icono de menú (![Menu button.](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/docdb-menu-icon.png)) en la esquina superior izquierda de la página.

1. En el menú **Actions (Acciones)**, elija una de las opciones siguientes. Estas opciones de menú solo se pueden seleccionar si en el clúster elegido no se está ejecutando la última versión del motor.  
![Imagen: acciones de actualización de Amazon DocumentDB](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/docdb-upgrade-action.png)
   + **Actualizar ahora**: inicia inmediatamente el proceso de actualización. El clúster se quedará sin conexión durante un tiempo mientras se actualiza a la última versión del motor.
   + **Actualizar en el siguiente periodo**: inicia el proceso de actualización durante el próximo periodo de mantenimiento del clúster. El clúster se quedará sin conexión durante un tiempo mientras se actualiza a la última versión del motor.

1. Cuando se abra la ventana de confirmación, seleccione una de las siguientes opciones:
   + **Actualizar**: para actualizar el clúster a la última versión del motor de acuerdo con el plan elegido en el paso anterior.
   + **Cancelar**: para cancelar la actualización del motor del clúster y continuar con la versión actual del motor del clúster.

------
#### [ Using the AWS CLI ]

Puede aplicar actualizaciones de parches a su clúster mediante la `apply-pending-maintenance-action` operación AWS CLI y con los siguientes parámetros.

**Parameters**
+ **--resource-identifier**: obligatorio. El ARN del clúster de Amazon DocumentDB que va a actualizar.
+ **--apply-action**: obligatorio. Se permiten los siguientes valores. Para actualizar la versión de su motor de clúster, utilice `db-upgrade`.
  + **db-upgrade**
  + **system-update**
+ **--opt-in-type**: obligatorio. Se permiten los siguientes valores.
  + `immediate`: aplicar inmediatamente la acción de mantenimiento.
  + `next-maintenance`: aplicar la operación de mantenimiento durante el siguiente período de mantenimiento.
  + `undo-opt-in`: cancelar todas las solicitudes de alta `next-maintenance` existentes.

**Example**  
En el siguiente ejemplo se actualiza la versión del motor de `sample-cluster` a la versión 4.0.0.  
Para Linux, macOS o Unix:  

```
aws docdb apply-pending-maintenance-action \
   --resource-identifier arn:aws:rds:us-east-1:123456789012\:cluster:sample-cluster \
   --apply-action db-upgrade \
   --opt-in-type immediate
```
Para Windows:  

```
aws docdb apply-pending-maintenance-action ^
   --resource-identifier arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster ^
   --apply-action db-upgrade ^
   --opt-in-type immediate
```
El resultado de esta operación será similar a lo que se indica a continuación:  

```
{
    "ResourcePendingMaintenanceActions": {
        "ResourceIdentifier": "arn:aws:rds:us-east-1:444455556666:cluster:docdb-2019-01-09-23-55-38",
        "PendingMaintenanceActionDetails": [
            {
                "CurrentApplyDate": "2019-02-20T20:57:06.904Z",
                "Description": "Bug fixes",
                "ForcedApplyDate": "2019-02-25T21:46:00Z",
                "OptInStatus": "immediate",
                "Action": "db-upgrade",
                "AutoAppliedAfterDate": "2019-02-25T07:41:00Z"
            }
        ]
    }
}
```

------