

# Reservas de capacidad interrumpible para los propietarios de capacidad
<a name="capacity-owner-procedures"></a>

El propietario de capacidad es la cuenta propietaria de la reserva de capacidad de origen. Este crea la reserva de capacidad interrumpible para compartir la capacidad no utilizada con otros equipos, sin dejar de conservar el control para recuperarla cuando sea necesario.

En esta sección, se explica cómo usted (el propietario de la capacidad) puede crear, modificar y recuperar una reserva de capacidad interrumpible, así como hacer un seguimiento.

**Topics**
+ [Cómo crear una reserva de capacidad interrumpible](#creating-interruptible-cr)
+ [Cómo ver la reserva de capacidad interrumpible](#view-interruptible-cr)
+ [Cómo modificar la reserva de capacidad interrumpible](#modify-interruptible-cr)
+ [Proceso de recuperación y seguimiento](#reclamation-process)
+ [Cómo compartir reservas interrumpibles](#sharing-interruptible-reservations)

## Cómo crear una reserva de capacidad interrumpible
<a name="creating-interruptible-cr"></a>

Cree una reserva de capacidad interrumpible para que la capacidad no utilizada de la reserva de origen esté disponible para otras cargas de trabajo sin dejar de mantener el control para recuperarla cuando sea necesario.

### Requisitos previos
<a name="interruptible-cr-prerequisites"></a>

Antes de crear una asignación interrumpible, asegúrese de que la reserva de capacidad bajo demanda de origen cumpla los siguientes requisitos:
+ La reserva de capacidad debe estar activa sin una fecha de finalización establecida. No se pueden crear asignaciones de reservas pendientes, vencidas, canceladas o que tengan fechas de finalización programadas.
+ La reserva de capacidad debe tener capacidad disponible para su asignación. Solo se pueden asignar las instancias disponibles (denominadas también capacidad no utilizada).
+ Asimismo, solo se puede crear una asignación interrumpible por cada reserva de capacidad de origen. Si ya existe una asignación, debe modificarla o cancelarla antes de crear una nueva.
+ Puede asignar hasta 1000 instancias a la vez a una reserva de capacidad interrumpible.

Puede utilizar la consola o AWS CLI para crear una reserva de capacidad interrumpible.

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

**Cómo crear una reserva de capacidad interrumpible**

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

1. Elija **Reservas de capacidad**.

1. Seleccione su reserva de capacidad.

1. Elija **Acciones** y **Crear asignación interrumpible**.

1. En **Instancias para asignar**, indique el número de instancias que desea asignar.

1. (Opcional) Añada etiquetas.

1. Elija **Crear asignación de capacidad interrumpible**.

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

**Cómo crear una reserva de capacidad interrumpible**  
Utilice el comando [create-interruptible-capacity-reservation-allocation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-interruptible-capacity-reservation-allocation.html):

```
aws ec2 create-interruptible-capacity-reservation-allocation \
    --capacity-reservation-id {{cr-1234567890abcdef0}} \
    --instance-count {{10}}
```

------

## Cómo ver la reserva de capacidad interrumpible
<a name="view-interruptible-cr"></a>

Tras crear una reserva de capacidad interrumpible, puede verla en su cuenta o desde un recurso específico.

### Cómo ver todas las reservas de capacidad interrumpible en su cuenta
<a name="view-all-interruptible-cr"></a>

Utilice el siguiente procedimiento para ver las reservas de capacidad interrumpibles en su cuenta.

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

**Cómo ver las reservas de capacidad interrumpibles en su cuenta**

1. Diríjase a la página de reservas de capacidad de la consola.

1. Busque las reservas con **Interrumpible** en la columna de tipos.

1. Seleccione la reserva interrumpible para ver detalles.

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

**Cómo ver las reservas de capacidad interrumpibles en su cuenta**

```
aws ec2 describe-capacity-reservations \
    --capacity-reservation-id {{cr-interruptible-id}} \
    --filters Name=interruptible,Values=true
```

------

### Cómo ver una reserva de capacidad interrumpible desde un origen específico
<a name="view-interruptible-cr-from-source"></a>

Utilice el siguiente procedimiento para ver la reserva de capacidad interrumpible creada a partir de una reserva de capacidad de un origen específico.

```
aws ec2 describe-capacity-reservations \
    --capacity-reservation-id {{cr-source-id}}
```

En la respuesta, encontrará un objeto `interruptibleCapacityAllocations` que contiene el ID de reserva de capacidad interrumpible y los detalles de la asignación. Para obtener información sobre la estructura de respuesta, consulte [InterruptibleCapacityAllocation](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_InterruptibleCapacityAllocation.html) en la *Referencia de la API de Amazon EC2*.

## Cómo modificar la reserva de capacidad interrumpible
<a name="modify-interruptible-cr"></a>

Utilice los siguientes procedimientos para editar o cancelar la reserva de capacidad interrumpible.

**nota**  
Al reducir la asignación, primero recuperamos las instancias disponibles y, después, las ejecutamos hasta alcanzar el recuento solicitado. Si podemos cubrir el recuento en su totalidad con las instancias disponibles, no se produce ninguna cancelación. Todas las modificaciones del recuento de instancias asignado se realizan a través de la reserva de capacidad de origen, no directamente en la reserva de capacidad interrumpible.
Solo puede modificar una reserva de capacidad interrumpible en un máximo de 1000 instancias a la vez (aumentar o disminuir).

### Cómo editar la reserva de capacidad interrumpible
<a name="edit-interruptible-allocation"></a>

Utilice el siguiente procedimiento para editar la reserva de capacidad interrumpible.

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

1. En la página de detalles de la reserva de capacidad de origen, seleccione **Acciones**. A continuación, **Editar reserva de capacidad interrumpible**.

1. En **Instancias para asignar**, ingrese el nuevo número:
   + Agregar más capacidad para compartir
   + Recuperar la capacidad de la reserva de capacidad de origen

1. Seleccione **Actualizar**.

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

```
aws ec2 update-interruptible-capacity-reservation-allocation \
    --capacity-reservation-id {{cr-1234567890abcdef0}} \
    --target-instance-count {{80}}
```

------

### Cómo cancelar la reserva de capacidad interrumpible
<a name="cancel-interruptible-allocation"></a>

Utilice el siguiente procedimiento para eliminar permanentemente la asignación y devolver toda la capacidad.

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

1. En la página de detalles de Reserva de capacidad de origen, diríjase a los detalles de la asignación de capacidad interrumpible.

1. Seleccione **Editar asignación interrumpible**.

1. En Recuento de instancias, ingrese **0**.

1. Elija **Actualizar**.

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

```
aws ec2 update-interruptible-capacity-reservation-allocation \
--capacity-reservation-id {{cr-1234567890abcdef0}} \
--target-instance-count {{0}}
```

------

## Proceso de recuperación y seguimiento
<a name="reclamation-process"></a>

Cuando se recupera la capacidad:
+ las instancias en ejecución reciben una advertencia de interrupción de 2 minutos a través de los eventos de EventBridge,
+ las instancias en ejecución que se encuentren en la capacidad recuperada pasan a un estado de cierre y se terminan tras el periodo de preaviso,
+ las instancias recuperadas, tras ser terminadas, pasan a estar disponibles en la reserva de capacidad de origen para su uso inmediato,
+ el estado de la asignación cambia de **actualizando** a **activo** cuando se completa.

La recuperación completa puede tardar unos minutos según el tipo de instancia y el tiempo de cierre. Para obtener más información sobre la notificación de EventBridge recibida al completar el proceso, consulte [Finalización de recuperación](monitor-interruptible-cr.md#reclamation-completion).

### Como realizar un seguimiento del estado de la recuperación
<a name="track-reclamation-status"></a>

Supervise el progreso de la reclamación describiendo la reserva de origen:

```
aws ec2 describe-capacity-reservations \
--capacity-reservation-id {{cr-1234567890abcdef0}}
```

La respuesta muestra estos campos dentro del objeto `interruptibleCapacityAllocation`:
+ `instance-count`: Instancias asignadas en la actualidad
+ `target-instance-count`: Cantidad solicitada tras la recuperación
+ `status`: Se muestra **actualizando** durante la recuperación y **activo** cuando se completa

## Cómo compartir reservas interrumpibles
<a name="sharing-interruptible-reservations"></a>

Puede compartir reservas interrumpibles solo dentro de su organización de AWS mediante AWS Resource Access Manager (RAM).

Consideraciones:
+ Si una cuenta de consumidor abandona su organización, la reserva interrumpible se deja de compartir automáticamente en esa cuenta.
+ Todas las instancias que se estén ejecutando en la reserva no compartida se terminarán más adelante.
+ Todas las demás funciones de uso compartido funcionan igual que las reservas de capacidad estándar.

Para ver todos los procedimientos de uso compartido, consulte [Reservas de capacidad compartida](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/capacity-reservation-sharing.html).