

# iniciar instancias en una Reserva de capacidad existente
<a name="capacity-reservations-launch"></a>

Solo puede lanzar una instancia en una reserva de capacidad que:
+ Tenga atributos coincidentes (tipo de instancia, plataforma, zona de disponibilidad y tenencia)
+ Tenga suficiente capacidad disponible
+ Está en estado `active`

Al iniciar una instancia, puede especificar si desea iniciar la instancia en cualquier Reserva de capacidad `open`, en una Reserva de capacidad determinada o en un grupo de Reservas de capacidad.

También puede configurar la instancia para evitar la ejecución en una Reserva de capacidad, incluso si tiene una Reserva de capacidad `open` que tiene atributos coincidentes y capacidad disponible. 

la inicialización de una instancia en una Reserva de capacidad reduce su capacidad disponible por número de instancias iniciadas. Por ejemplo, si inicia tres instancias, la capacidad disponible de la Reserva de capacidad se reduce en tres.

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

**Para lanzar instancias en una reserva de capacidad existente**

1. Siga el procedimiento para [iniciar una instancia](ec2-launch-instance-wizard.md), pero no la lance hasta que haya completado los siguientes pasos para especificar la configuración del grupo con ubicación y la reserva de capacidad.

1. Expanda **Detalles avanzados** y haga lo siguiente:

   1. En **Grupo de ubicación**, seleccione el grupo con ubicación en clúster en el que se iniciará la instancia.

   1. Para **Capacity Reservation** (Reserva de capacidad), elija una de las siguientes opciones en función de la configuración de la reserva de capacidad:
      + **Ninguna**: impide que las instancias se lancen en un reserva de capacidad. Las instancias se ejecutan en capacidad bajo demanda.
      + **Abierta**: inicia la instancia en cualquier reserva de capacidad que tenga los atributos coincidentes y capacidad suficiente para la cantidad de instancias seleccionadas. Si no hay Reserva de capacidad coincidentes con suficiente capacidad, la instancia se inicia en capacidad bajo demanda.
      + **Especificar reserva de capacidad**: lanza las instancias en la reserva de capacidad seleccionada. Si la Reserva de capacidad seleccionada no tiene suficiente capacidad para la cantidad de instancias seleccionadas, la inicialización de la instancia produce un error.
      + **Especificar grupo de recursos de reserva de capacidad**: lanza las instancias en cualquier reserva de capacidad con atributos coincidentes y capacidad disponible en el grupo de reserva de capacidad seleccionado. Si el grupo seleccionado no tiene una Reserva de capacidad con atributos coincidentes y capacidad disponible, las instancias se inician en capacidad bajo demanda.
      + **Especificar únicamente la reserva de capacidad**: lanza las instancias en una reserva de capacidad. Si no se especifica un ID de reserva de capacidad, las instancias se lanzarán en una reserva de capacidad abierta. Si no hay capacidad disponible, no se lanzarán las instancias.
      + **Especificar únicamente el grupo de recursos de reserva de capacidad**: lanza las instancias en una reserva de capacidad en un grupo de recursos de reserva de capacidad. Si no se especifica un ARN de grupo de recursos de reserva de capacidad, las instancias se lanzarán en una reserva de capacidad abierta. Si no hay capacidad disponible, no se lanzarán las instancias.

1. En el panel **Resumen**, revise la configuración de la instancia y, a continuación, elija **Iniciar instancia**.

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

**Para lanzar una instancia en una reserva de capacidad existente**  
Utilice el comando [run-instances](https://docs.aws.amazon.com/cli/latest/reference/ec2/run-instances.html) y especifique la opción `--capacity-reservation-specification`.

En el siguiente ejemplo se inicia una instancia en cualquier reserva de capacidad abierta con atributos coincidentes y capacidad disponible:

```
aws ec2 run-instances \
    --image-id ami-0abcdef1234567890 \
    --count 1 \
    --instance-type t2.micro \
    --key-name my-key-pair \
    --subnet-id subnet-0abcdef1234567890 \
    --capacity-reservation-specification CapacityReservationPreference=open
```

En el siguiente ejemplo se inicia una instancia `targeted` en una reserva de capacidad:

```
aws ec2 run-instances \
    --image-id ami-0abcdef1234567890 \
    --count 1 \
    --instance-type t2.micro \
    --key-name my-key-pair \
    --subnet-id subnet-0abcdef1234567890 \
    --capacity-reservation-specification \
        CapacityReservationTarget={CapacityReservationId=cr-1234abcd56EXAMPLE}
```

En el siguiente ejemplo se inicia una instancia en un grupo especificado de reserva de capacidad:

```
aws ec2 run-instances \
    --image-id ami-0abcdef1234567890 \
    --count 1 \
    --instance-type t2.micro \
    --key-name my-key-pair \
    --subnet-id subnet-0abcdef1234567890 \
    --capacity-reservation-specification \
        CapacityReservationTarget={CapacityReservationResourceGroupArn=arn:aws:resource-groups:us-west-2:123456789012:group/my-cr-group}
```

En el siguiente ejemplo, se lanza una instancia únicamente en una reserva de capacidad. Dado que no especifica un ID de reserva de capacidad, la instancia se lanza en cualquier reserva de capacidad abierta con atributos coincidentes y capacidad disponible:

```
aws ec2 run-instances \
    --image-id ami-0abcdef1234567890 \
    --count 1 \
    --instance-type t2.micro \
    --key-name my-key-pair \
    --subnet-id subnet-0abcdef1234567890 \
    --capacity-reservation-specification \
        CapacityReservationPreference=capacity-reservations-only
```

En el siguiente ejemplo, se lanza una instancia únicamente en una reserva de capacidad específica. Si no hay capacidad disponible en la reserva de capacidad especificada, la instancia no se lanza.

```
aws ec2 run-instances \
    --image-id ami-0abcdef1234567890 \
    --count 1 \
    --instance-type t2.micro \
    --key-name my-key-pair \
    --subnet-id subnet-0abcdef1234567890 \
    --capacity-reservation-specification \
        CapacityReservationPreference=capacity-reservations-only \
        CapacityReservationTarget={CapacityReservationId=cr-1234abcd56EXAMPLE}
```

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

**Para lanzar una instancia en una reserva de capacidad existente**  
Utilice el cmdlet [New-EC2Instance](https://docs.aws.amazon.com/powershell/latest/reference/items/New-EC2Instance.html).

En el siguiente ejemplo se inicia una instancia en cualquier reserva de capacidad abierta con atributos coincidentes y capacidad disponible:

```
New-EC2Instance `
    -ImageId ami-0abcdef1234567890 `
    -InstanceType t2.micro `
    -KeyName "my-key-pair" `
    -SubnetId subnet-0abcdef1234567890 `
    -CapacityReservationSpecification_CapacityReservationPreference "open"
```

En el siguiente ejemplo se inicia una instancia `targeted` en una reserva de capacidad:

```
New-EC2Instance `
    -ImageId ami-0abcdef1234567890 `
    -InstanceType t2.micro `
    -KeyName "my-key-pair" `
    -SubnetId subnet-0abcdef1234567890 `
    -CapacityReservationTarget_CapacityReservationId cr-1234abcd56EXAMPLE
```

En el siguiente ejemplo se inicia una instancia en un grupo especificado de reserva de capacidad:

```
New-EC2Instance `
    -ImageId ami-0abcdef1234567890 `
    -InstanceType t2.micro `
    -KeyName "my-key-pair" `
    -SubnetId subnet-0abcdef1234567890 `
    -CapacityReservationTarget_CapacityReservationResourceGroupArn `
        "arn:aws:resource-groups:us-west-2:123456789012:group/my-cr-group"
```

En el siguiente ejemplo, se lanza una instancia únicamente en una reserva de capacidad. Dado que no especifica un ID de reserva de capacidad, la instancia se lanza en cualquier reserva de capacidad abierta con atributos coincidentes y capacidad disponible:

```
New-EC2Instance `
    -ImageId ami-0abcdef1234567890 `
    -InstanceType t2.micro `
    -KeyName "my-key-pair" `
    -SubnetId subnet-0abcdef1234567890 `
    -CapacityReservationSpecification_CapacityReservationPreference "capacity-reservations-only"
```

En el siguiente ejemplo, se lanza una instancia únicamente en una reserva de capacidad específica. Si no hay capacidad disponible en la reserva de capacidad especificada, la instancia no se lanza.

```
New-EC2Instance `
    -ImageId ami-0abcdef1234567890 `
    -InstanceType t2.micro `
    -KeyName "my-key-pair" `
    -SubnetId subnet-0abcdef1234567890 `
    -CapacityReservationSpecification_CapacityReservationPreference "capacity-reservations-only" `
    -CapacityReservationTarget_CapacityReservationId cr-1234abcd56EXAMPLE
```

------