

# Habilitación de la protección de detención para sus instancias de EC2
<a name="ec2-stop-protection"></a>

Para evitar que una instancia se detenga de forma accidental, puede habilitar la protección de detención para la instancia. La protección de detención también protege la instancia de una terminación accidental. 

El atributo `DisableApiStop` de la API [https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_ModifyInstanceAttribute.html](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_ModifyInstanceAttribute.html) de Amazon EC2 controla si la instancia se puede detener mediante la consola de Amazon EC2, la AWS CLI o la API de Amazon EC2. Puede establecer el valor de este atributo cuando inicia la instancia, mientras la instancia se encuentre en ejecución o cuando está detenida.

**Consideraciones**
+ La protección contra detención no evita que detenga accidentalmente una instancia cuando comienza el cierre desde la instancia con un comando del sistema operativo, como **shutdown** o **poweroff**.
+ La habilitación de la protección contra detención no impide que AWS detenga la instancia cuando hay un [evento programado](monitoring-instances-status-check_sched.md) para detener la instancia.
+ La habilitación de la protección de detención no impide que Amazon EC2 Auto Scaling termine una instancia cuando la instancia no está en buen estado o durante eventos de reducción horizontal. Es posible controlar si un grupo de escalado automático puede terminar una instancia concreta durante la reducción horizontal al utilizar la [protección frente a la reducción horizontal de instancias](https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-instance-protection.html). 
+ La protección de detención no solo evita que la instancia se detenga accidentalmente, sino que también evita una terminación accidental cuando se utiliza la consola, la AWS CLI o la API. Sin embargo, no configura de manera automática el atributo `DisableApiTermination`. Tenga en cuenta que cuando el atributo `DisableApiStop` se establece en `false`, el atributo `DisableApiTermination` se usa para determinar si la instancia se puede terminar mediante la consola, la AWS CLI o la API. Para obtener más información consulte () [Terminación de las instancias de Amazon EC2](terminating-instances.md).
+ No puede habilitar la protección contra detención para una instancia con un volumen raíz del almacén de instancias.
+ No puede habilitar la protección contra detención para instancias de spot.
+ La API de Amazon EC2 sigue un modelo de coherencia final cuando habilita o deshabilita la protección de detención. Esto significa que es posible que el resultado de ejecutar comandos para establecer el atributo de protección contra la detención no esté inmediatamente visible para todos los comandos posteriores que ejecute. Para obtener más información, consulte [Consistencia eventual](https://docs.aws.amazon.com/ec2/latest/devguide/eventual-consistency.html) en la *Guía para desarrolladores de Amazon EC2*.

**Topics**
+ [Habilitar la protección de detención para una instancia en la inicialización](#enable-stop-protection-at-launch)
+ [Para habilitar la protección de detención para una instancia en ejecución o detenida](#enable-stop-protection-on-running-or-stopped-instance)
+ [Deshabilitar la protección de detención para una instancia en ejecución o detenida](#disable-stop-protection-on-running-or-stopped-instance)

## Habilitar la protección de detención para una instancia en la inicialización
<a name="enable-stop-protection-at-launch"></a>

Puede habilitar la protección de detención para una instancia cuando lanza la instancia.

------
#### [ Console ]

**Para habilitar la protección de detención para una instancia en el lanzamiento**

1. Abra la consola de Amazon EC2 en [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).

1. En el panel, elija **iniciar instancia**.

1. Configure la instancia en el [nuevo asistente de inicialización de instancias](ec2-launch-instance-wizard.md).

1. Para habilitar la protección de detención, elija **Habilitar** para **Protección de detención** dentro de **Detalles avanzados** en el asistente.

------
#### [ AWS CLI ]

**Para habilitar la protección de detención para una instancia en la inicialización**  
Utilice el comando [run-instances](https://docs.aws.amazon.com/cli/latest/reference/ec2/run-instances.html) para lanzar la instancia. Agregue el siguiente parámetro.

```
--disable-api-stop
```

------
#### [ PowerShell ]

**Para habilitar la protección de detención para una instancia en la inicialización**  
Utilice el cmdlet [New-EC2Instance](https://docs.aws.amazon.com/powershell/latest/reference/items/New-EC2Instance.html) para lanzar la instancia. Agregue el siguiente parámetro.

```
-DisableApiStop $true
```

------

## Para habilitar la protección de detención para una instancia en ejecución o detenida
<a name="enable-stop-protection-on-running-or-stopped-instance"></a>

Puede habilitar la protección de detención para una instancia mientras esta se encuentre en ejecución o detenida.

------
#### [ Console ]

**Habilitación de la protección de detención para una instancia**

1. Abra la consola de Amazon EC2 en [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).

1. En el panel de navegación izquierdo, elija **instancias**.

1. Seleccione la instancia y, a continuación, elija **Acciones**>**Configuración de la instancia**>**Cambiar protección de detención**.

1. Seleccione la casilla de verificación **Habilitar** y, luego, elija **Guardar**.

------
#### [ AWS CLI ]

**Habilitación de la protección de detención para una instancia**  
Utilice el comando [modify-instance-attribute](https://docs.aws.amazon.com/cli/latest/reference/ec2/modify-instance-attribute.html).

```
aws ec2 modify-instance-attribute \
    --instance-id i-1234567890abcdef0 \
    --disable-api-stop
```

------
#### [ PowerShell ]

**Habilitación de la protección de detención para una instancia**  
Utilice el cmdlet [Edit-EC2InstanceAttribute](https://docs.aws.amazon.com/powershell/latest/reference/items/Edit-EC2InstanceAttribute.html).

```
Edit-EC2InstanceAttribute `
    -InstanceId i-1234567890abcdef0 `
    -DisableApiStop $true
```

------

## Deshabilitar la protección de detención para una instancia en ejecución o detenida
<a name="disable-stop-protection-on-running-or-stopped-instance"></a>

Puede deshabilitar la protección de detención para una instancia en ejecución o detenida mediante uno de los métodos a continuación.

------
#### [ Console ]

**Deshabilitar la protección de detención para una instancia en ejecución o detenida**

1. Abra la consola de Amazon EC2 en [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).

1. En el panel de navegación izquierdo, elija **instancias**.

1. Seleccione la instancia y, a continuación, elija **Actions** (Acciones), **Instance Settings** (Configuración de instancia), **Change Stop Protection** (Cambiar protección de detención).

1. Desactive la casilla de verificación **Habilitar** y, luego, elija **Guardar**.

------
#### [ AWS CLI ]

**Deshabilitar la protección de detención para una instancia en ejecución o detenida**  
Utilice el comando [modify-instance-attribute](https://docs.aws.amazon.com/cli/latest/reference/ec2/modify-instance-attribute.html).

```
aws ec2 modify-instance-attribute \
    --instance-id i-1234567890abcdef0 \
    --no-disable-api-stop
```

------
#### [ PowerShell ]

**Deshabilitación de la protección de detención para una instancia**  
Utilice el cmdlet [Edit-EC2InstanceAttribute](https://docs.aws.amazon.com/powershell/latest/reference/items/Edit-EC2InstanceAttribute.html).

```
Edit-EC2InstanceAttribute `
    -InstanceId i-1234567890abcdef0 `
    -DisableApiStop $false
```

------