

# Modificar as configurações de reserva de capacidade da instância

É possível modificar as configurações da Reserva de capacidade a seguir para uma instância interrompida a qualquer momento:
+ Inicie em qualquer reserva de capacidade que tenha atributos correspondentes (por exemplo, tipo de instância, plataforma, zona de disponibilidade e locação) e capacidade disponível.
+ Execute a instância em uma Reserva de capacidade específica.
+ Inicie em qualquer reserva de capacidade que tenha atributos correspondentes e capacidade disponível em um grupo de reserva de capacidade
+ Impeça que a instância seja iniciada em uma Reserva de capacidade.

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

**Para modificar as configurações de reserva de capacidade de uma instância**

1. Abra o console do Amazon EC2 em [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).

1. Escolha **Instances (Instâncias)** e selecione a instância a ser modificada. Interrompa a instância se ela ainda não tiver sido interrompida.

1. Escolha **Ações**, **Configurações da instância**, **Modificar configurações da reserva de capacidade**.

1. Para **Reserva de capacidade**, selecione uma das seguintes opções:
   + **Aberta**: executa as instâncias em qualquer reserva de capacidade que tenha atributos correspondentes e capacidade suficiente para o número de instâncias selecionadas. Se você não tiver uma Reserva de capacidade correspondente com capacidade suficiente, a instância usará a capacidade sob demanda.
   + **Nenhuma**: impede que as instâncias sejam executadas em uma reserva de capacidade. As instâncias são executadas na capacidade sob demanda.
   + **Especificar reserva de capacidade**: inicia as instâncias na reserva de capacidade selecionada. Se a Reserva de capacidade selecionada não tiver capacidade suficiente para o número de instâncias selecionadas, a execução da instância falhará.
   + **Especificar grupo de reserva de capacidade**: executa as instâncias em qualquer reserva de capacidade com atributos correspondentes e capacidade disponível no grupo de reserva de capacidade selecionado. Se o grupo selecionado não tiver uma Reserva de capacidade com atributos correspondentes e capacidade disponível, as instâncias serão executadas na capacidade sob demanda.
   + **Especificar somente reserva de capacidade**: inicia as instâncias em uma reserva de capacidade. Se um ID de reserva de capacidade não for especificado, as instâncias serão iniciadas em uma reserva de capacidade aberta. Se a capacidade não estiver disponível, as instâncias falharão ao iniciar.
   + **Especificar grupo de recursos de reserva de capacidade somente**: inicia as instâncias em uma reserva de capacidade em um grupo de recursos de reserva de capacidade. Se o ARN de um grupo de recursos de reserva de capacidade não for especificado, as instâncias serão iniciadas em uma reserva de capacidade aberta. Se a capacidade não estiver disponível, as instâncias falharão ao iniciar.

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

**Para modificar as configurações de reserva de capacidade de uma instância**  
Use o comando [modify-instance-capacity-reservation-attributes](https://docs.aws.amazon.com/cli/latest/reference/ec2/modify-instance-capacity-reservation-attributes.html).

O exemplo a seguir altera a preferência de reserva de capacidade para `none`.

```bash
aws ec2 modify-instance-capacity-reservation-attributes \
    --instance-id {{i-1234567890abcdef0}} \
    --capacity-reservation-specification CapacityReservationPreference=none
```

O exemplo a seguir altera o destino para uma reserva de capacidade específica.

```bash
aws ec2 modify-instance-capacity-reservation-attributes \
    --instance-id {{i-1234567890abcdef0}} \
    --capacity-reservation-specification \
    CapacityReservationTarget={CapacityReservationId={{cr-1234567890abcdef0}}}
```

O exemplo a seguir altera o destino para um grupo de reserva de capacidade específico.

```bash
aws ec2 modify-instance-capacity-reservation-attributes \
    --instance-id {{i-1234567890abcdef0}} \
    --capacity-reservation-specification \
        CapacityReservationTarget={CapacityReservationResourceGroupArn=arn:aws:resource-groups:{{us-west-2}}:{{123456789012}}:group/{{my-cr-group}}}
```

O exemplo a seguir altera a preferência de reserva de capacidade para `capacity-reservation-only`. Como uma reserva de capacidade não é especificada, as instâncias são iniciadas em qualquer reserva de capacidade aberta com atributos correspondentes e capacidade disponível.

```bash
aws ec2 modify-instance-capacity-reservation-attributes \
    --instance-id {{i-1234567890abcdef0}} \
    --capacity-reservation-specification CapacityReservationPreference=capacity-reservation-only
```

O exemplo a seguir altera a preferência de reserva de capacidade para `capacity-reservation-only` e altera o destino para uma reserva de capacidade específica. Se a capacidade não estiver disponível na reserva de capacidade especificada, as instâncias falharão ao iniciar.

```bash
aws ec2 modify-instance-capacity-reservation-attributes \
    --instance-id {{i-1234567890abcdef0}} \
    --capacity-reservation-specification \
        CapacityReservationPreference=capacity-reservation-only \
        CapacityReservationTarget={CapacityReservationId={{cr-1234567890abcdef0}}}
```

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

**Para modificar as configurações de reserva de capacidade de uma instância**  
Use o cmdlet [Edit-EC2InstanceCapacityReservationAttribute](https://docs.aws.amazon.com/powershell/latest/reference/items/Edit-EC2InstanceCapacityReservationAttribute.html).

O exemplo a seguir altera a preferência de reserva de capacidade para `none`.

```powershell
Edit-EC2InstanceCapacityReservationAttribute `
    -InstanceId {{i-1234567890abcdef0}} `
    -CapacityReservationSpecification_CapacityReservationPreference "none"
```

O exemplo a seguir altera o destino para uma reserva de capacidade específica.

```powershell
Edit-EC2InstanceCapacityReservationAttribute `
    -InstanceId {{i-1234567890abcdef0}} `
    -CapacityReservationTarget_CapacityReservationId {{cr-1234567890abcdef0}}
```

O exemplo a seguir altera o destino para um grupo de reserva de capacidade específico.

```powershell
Edit-EC2InstanceCapacityReservationAttribute `
    -InstanceId {{i-1234567890abcdef0}} `
    -CapacityReservationTarget_CapacityReservationResourceGroupArn `
        "arn:aws:resource-groups:{{us-west-2}}:{{123456789012}}:group/{{my-cr-group}}"
```

O exemplo a seguir altera a preferência de reserva de capacidade para `capacity-reservation-only`. Como uma reserva de capacidade não é especificada, as instâncias são iniciadas em qualquer reserva de capacidade aberta com atributos correspondentes e capacidade disponível.

```powershell
Edit-EC2InstanceCapacityReservationAttribute `
    -InstanceId {{i-1234567890abcdef0}} `
    -CapacityReservationSpecification_CapacityReservationPreference "capacity-reservation-only"
```

O exemplo a seguir altera a preferência de reserva de capacidade para `capacity-reservation-only` e altera o destino para uma reserva de capacidade específica. Se a capacidade não estiver disponível na reserva de capacidade especificada, as instâncias falharão ao iniciar.

```powershell
Edit-EC2InstanceCapacityReservationAttribute `
    -InstanceId {{i-1234567890abcdef0}} `
    -CapacityReservationSpecification_CapacityReservationPreference "capacity-reservation-only" `
    -CapacityReservationTarget_CapacityReservationId {{cr-1234567890abcdef0}}
```

------