# Reservas de capacidade interruptíveis para proprietários de capacidade
O proprietário da capacidade é a conta que possui a Reserva de capacidade de origem e cria a Reserva de capacidade interruptível para compartilhar a capacidade não utilizada com outras equipes, mantendo o controle para recuperá-la quando necessário.
Esta seção aborda como você (o proprietário da capacidade) pode criar, modificar, recuperar e rastrear uma Reserva de capacidade interruptível.
**Topics**
+ [Criar uma Reserva de capacidade interruptível](#creating-interruptible-cr)
+ [Veja sua Reserva de capacidade interruptível](#view-interruptible-cr)
+ [Modificando sua Reserva de capacidade interruptível](#modify-interruptible-cr)
+ [Processo de recuperação e rastreamento](#reclamation-process)
+ [Compartilhamento de reservas interruptíveis](#sharing-interruptible-reservations)
## Criar uma Reserva de capacidade interruptível
Crie uma Reserva de capacidade interruptível para disponibilizar a capacidade não utilizada de sua reserva de origem para outras workloads, mantendo o controle para recuperá-la quando necessário.
### Pré-requisitos
Antes de criar uma alocação interruptível, certifique-se de que sua Reserva de capacidade sob demanda de origem atenda aos seguintes requisitos:
+ Sua Reserva de capacidade deve estar ativa sem data de término definida. Você não pode criar alocações a partir de reservas pendentes, expiradas, canceladas ou com datas de término programadas.
+ Sua Reserva de capacidade deve ter capacidade disponível para alocação. Você só pode alocar instâncias disponíveis (também chamada de capacidade não utilizada).
+ Só é possível criar uma alocação interruptível por Reserva de capacidade de origem. Se uma alocação já existir, você deverá modificá-la ou cancelá-la antes de criar uma nova.
+ Você pode alocar no máximo 1.000 instâncias de uma vez para uma Reserva de capacidade interruptível.
O usuário pode usar o console ou o AWS CLI para criar uma Reserva de capacidade interruptível.
------
#### [ Console ]
**Criar uma Reserva de capacidade interruptível**
1. Abra o console do Amazon EC2 em [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).
1. Escolha **Reservas de capacidade**.
1. Selecione sua Reserva de capacidade.
1. Escolha **Ações**, **Criar alocação interruptível**.
1. Em **Instâncias a alocar**, insira o número de instâncias para alocação.
1. (Opcional) Adicione tags.
1. Escolha **Criar alocação de capacidade interruptível**.
------
#### [ AWS CLI ]
**Para criar uma Reserva de capacidade interruptível**
Use o 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}}
```
------
## Veja sua Reserva de capacidade interruptível
Depois de criar uma Reserva de capacidade interruptível, você pode ver a reserva interruptível em sua conta ou em um recurso específico.
### Visualize todas as Reservas de capacidade interruptíveis em sua conta
Use o procedimento a seguir para visualizar Reservas de capacidade interruptíveis em sua conta.
------
#### [ Console ]
**Para visualizar Reservas de capacidade interruptíveis em sua conta**
1. Acesse a página de Reservas de capacidade no console.
1. Procure reservas com a indicação **Interruptível** na coluna de tipos.
1. Selecione a reserva interruptível para visualizar detalhes.
------
#### [ AWS CLI ]
**Para ver as Reservas de capacidade interruptíveis em sua conta**
```
aws ec2 describe-capacity-reservations \
--capacity-reservation-id {{cr-interruptible-id}} \
--filters Name=interruptible,Values=true
```
------
### Exibir Reserva de capacidade interruptível de uma fonte específica
Use o procedimento a seguir para visualizar a Reserva de capacidade interruptível criada a partir de uma Reserva de capacidade de origem específica.
```
aws ec2 describe-capacity-reservations \
--capacity-reservation-id {{cr-source-id}}
```
Na resposta, você encontrará um objeto `interruptibleCapacityAllocations` que contém o ID de Reserva de capacidade interruptível e os detalhes da alocação. Para obter informações sobre a estrutura de resposta, consulte [InterruptibleCapacityAllocation](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_InterruptibleCapacityAllocation.html) na *Referência da API do Amazon EC2*.
## Modificando sua Reserva de capacidade interruptível
Use os procedimentos a seguir para editar ou cancelar sua Reserva de capacidade interruptível.
**nota**
Quando você reduz a alocação, primeiro recuperamos as instâncias disponíveis e, em seguida, as instâncias em execução, até atingirmos a contagem solicitada. Se conseguirmos atender à contagem inteiramente com as instâncias disponíveis, nenhuma rescisão ocorrerá. Todas as modificações na contagem de instâncias alocadas são feitas por meio da Reserva de capacidade de origem, não diretamente na Reserva de capacidade interruptível.
Você só pode modificar uma Reserva de capacidade interruptível em no máximo 1000 instâncias de uma vez (aumento ou diminuição).
### Edite sua Reserva de capacidade interruptível
Use o procedimento a seguir para editar sua Reserva de capacidade interruptível.
------
#### [ Console ]
1. Na página de detalhes da Reserva de capacidade de origem, escolha **Ações**. Em seguida, **edite a Reserva de capacidade interruptível**.
1. Para **alocar Instâncias**, insira o novo número:
+ Adicione mais capacidade de compartilhamento
+ Recupere a capacidade de sua reserva de capacidade de origem
1. Selecione **Atualizar**.
------
#### [ AWS CLI ]
```
aws ec2 update-interruptible-capacity-reservation-allocation \
--capacity-reservation-id {{cr-1234567890abcdef0}} \
--target-instance-count {{80}}
```
------
### Cancele sua Reserva de capacidade interruptível
Use o procedimento a seguir para remover permanentemente a alocação e retornar toda a capacidade.
------
#### [ Console ]
1. Na página de detalhes da Reserva de capacidade de origem, navegue até os detalhes da alocação de capacidade interruptível.
1. Escolha **Editar alocação interruptível**.
1. Em Contagem de instâncias, insira **0**.
1. Selecione **Atualizar**.
------
#### [ AWS CLI ]
```
aws ec2 update-interruptible-capacity-reservation-allocation \
--capacity-reservation-id {{cr-1234567890abcdef0}} \
--target-instance-count {{0}}
```
------
## Processo de recuperação e rastreamento
Quando você recupera a capacidade:
+ As instâncias em execução recebem um aviso de interrupção de 2 minutos por meio de eventos do EventBridge.
+ Após o período de notificação, as instâncias em execução na capacidade recuperada entram em um estado de desligamento e são encerradas.
+ Quando encerradas, as instâncias recuperadas ficam disponíveis em sua Reserva de capacidade de origem para uso imediato.
+ Seu status de alocação muda de **atualizado** para **ativo** quando concluído.
A recuperação completa pode levar alguns minutos, dependendo do tipo de instância e do tempo de desligamento. Para obter mais informações sobre a notificação do EventBridge que você recebe quando o processo é concluído, consulte [Conclusão de recuperação](monitor-interruptible-cr.md#reclamation-completion).
### Rastrear o status da recuperação
Monitore o progresso da recuperação descrevendo sua reserva de origem:
```
aws ec2 describe-capacity-reservations \
--capacity-reservation-id {{cr-1234567890abcdef0}}
```
A resposta mostra esses campos dentro do objeto `interruptibleCapacityAllocation`:
+ `instance-count`: instâncias alocadas atuais
+ `target-instance-count`: quantidade solicitada após a reclamação
+ `status`: **atualizando** durante a recuperação e **ativo** quando concluído
## Compartilhamento de reservas interruptíveis
Você pode compartilhar reservas interruptíveis somente dentro da sua organização AWS usando o AWS Resource Access Manager (RAM).
Considerações:
+ Se uma conta de consumidor sair da sua organização, a reserva interruptível será automaticamente descompartilhada dessa conta.
+ Todas as instâncias em execução na reserva não compartilhada serão eventualmente encerradas.
+ Todas as outras funcionalidades de compartilhamento funcionam da mesma forma que as Reservas de capacidade padrão.
Para obter os procedimentos completos de compartilhamento, consulte [Compartilhar reservas de capacidade](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/capacity-reservation-sharing.html).