# Reservas de capacidade
As Reservas de capacidade interruptíveis ajudam você a disponibilizar temporariamente a capacidade não utilizada para outras workloads em sua conta. Isso lhe dá controle para recuperar a capacidade quando necessário. Quando você recupera a capacidade, todas as instâncias em execução dentro da reserva interruptível são encerradas. Depois de criar uma reserva interruptível, você pode compartilhá-la com contas AWS adicionais ou com sua organização AWS usando o AWS Resource Access Manager (RAM).
Use Reservas de capacidade interruptíveis quando tiver capacidade reservada não utilizada fora dos períodos de pico, entre implantações ou quando a workload diminui. Se você conhece outra equipe que poderia usar essa capacidade, pode disponibilizá-la criando uma Reserva de capacidade interruptível. Quando sua workload crítica precisar de capacidade de volta, você pode recuperá-la.
Você pode usar Reservas de capacidade interruptíveis como uma das seguintes opções:
+ **Proprietário da capacidade** — Você é o proprietário da 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.
+ **Consumidor de capacidade** — Você inicia instâncias em reservas interruptíveis compartilhadas, entendendo que suas instâncias podem ser encerradas quando o proprietário recupera a capacidade.
**Topics**
+ [
## Como funciona
](#how-interruptible-cr-works)
+ [
## Faturamento
](#interruptible-cr-billing)
+ [
## Considerações
](#interruptible-cr-considerations)
+ [
# Reservas de capacidade interruptíveis para proprietários de capacidade
](capacity-owner-procedures.md)
+ [
# Reservas de capacidade interruptíveis para consumidores de capacidade
](capacity-consumer-procedures.md)
+ [
# Monitore Reservas de capacidade interruptíveis com o EventBridge e o CloudTrail
](monitor-interruptible-cr.md)
## Como funciona
Para disponibilizar a capacidade não utilizada para outras equipes, crie uma reserva interruptível especificando o número de instâncias não utilizadas que você deseja compartilhar da sua reserva de origem. Quando você cria a reserva interruptível, transferimos essas instâncias da sua reserva de origem para a nova reserva interruptível em sua conta.
Mantemos a associação entre a reserva de origem e a Reserva de capacidade interruptível. Como resultado, quando você recupera sua capacidade, todas as instâncias de consumo em execução são encerradas e a capacidade é restaurada para sua reserva de origem original.
Principais recursos:
+ Disponibilize temporariamente a capacidade não utilizada, mantendo o controle para recuperá-la
+ Recupere a capacidade a qualquer momento. Para obter mais informações, consulte . [Processo de recuperação e rastreamento](capacity-owner-procedures.md#reclamation-process)
+ Compartilhe com contas adicionais ou com sua organização AWS usando o AWS Resource Access Manager (RAM)
## Faturamento
Quando você cria uma reserva interruptível, ela é cobrada como uma nova reserva independente. Isso divide seu faturamento:
+ Reserva de origem: você é cobrado pela capacidade total menos a capacidade alocada
+ Reserva interruptível: você é cobrado pela capacidade alocada
Para obter mais informações sobre o faturamento de Reservas de capacidade sob demanda, consulte [Preços e faturamento de Reservas de capacidade](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/capacity-reservations-pricing-billing.html).
## Considerações
Antes de usar Reservas de capacidade interruptíveis, analise as seguintes limitações e requisitos que se aplicam aos proprietários e consumidores de capacidade.
### Proprietários de capacidade
+ Você não pode modificar ou cancelar diretamente uma Reserva de capacidade interruptível. Para editá-la, atualize a capacidade alocada da Reserva de Capacidade de origem.
+ Você só pode visualizar, lançar, marcar, compartilhar e atribuir faturamento para reservas interruptíveis.
+ Só é possível criar uma alocação interruptível por Reserva de capacidade de origem.
### Consumidores de capacidade
+ As Reservas de capacidade interruptíveis são, por padrão, Reservas de capacidade direcionadas, então você precisa direcioná-las na execução da sua instância.
+ Você não pode adicionar Reservas de capacidade interruptíveis aos grupos de reserva de capacidade.
+ Recomendamos que você só use Reservas de capacidade interruptíveis para aplicativos que podem ser interrompidos.
+ Suas instâncias serão encerradas quando o proprietário recuperar a capacidade — não há alternativa para o On-Demand ou o Spot. Para obter mais informações, consulte [Experiência de interrupção](capacity-consumer-procedures.md#interruption-experience).
# 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).
# Reservas de capacidade interruptíveis para consumidores de capacidade
O consumidor de capacidade é a conta que inicia instâncias em Reservas de capacidade interruptíveis compartilhadas, entendendo que suas instâncias podem ser encerradas quando o proprietário recupera a capacidade.
Esta seção aborda como você (o consumidor de capacidade) pode iniciar instâncias em uma Reserva de capacidade interruptível e aprender sobre o que acontece quando a capacidade é recuperada pelo proprietário.
**Topics**
+ [
## Exibir uma Reserva de capacidade interruptível
](#view-interruptible-cr-consumer)
+ [
## Iniciar instâncias em Reservas interruptíveis
](#launch-instances-interruptible)
+ [
## Experiência de interrupção
](#interruption-experience)
## Exibir uma Reserva de capacidade interruptível
Use os procedimentos a seguir para visualizar uma Reserva de capacidade interruptível.
------
#### [ Console ]
**Visualizar Reservas de capacidade interruptíveis em sua conta**
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. Na coluna **Tipo**, procure as reservas marcadas como **Interruptíveis**.
1. Anote os IDs de reserva para uso nas execuções de sua instância.
------
#### [ AWS CLI ]
**Para encontrar todas as Reservas de capacidade interruptíveis em sua conta**
Use o comando [describe-capacity-reservations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-capacity-reservations.html):
```
aws ec2 describe-capacity-reservations \
--filters Name=state,Values=active
```
Procure as reservas onde `Interruptible` está definido como `true` na resposta.
**Para filtrar especificamente por reservas interruptíveis**
Use o seguinte comando:
```
aws ec2 describe-capacity-reservations \
--capacity-reservation-ids cr-example123 \
--query 'CapacityReservations[?Interruptible==`true`]'
```
------
**nota**
As Reservas de capacidade interruptíveis são, por padrão, Reservas de capacidade direcionadas, então você precisa direcioná-las especificamente na execução da sua instância. Ao contrário das reservas abertas, as reservas interruptíveis não cobrirão automaticamente as instâncias correspondentes. Você deve especificar explicitamente o ID da reserva no lançamento.
## Iniciar instâncias em Reservas interruptíveis
Use o procedimento a seguir para iniciar instâncias do Amazon EC2 em Reservas de capacidade interruptíveis em sua conta.
**nota**
Recomendamos que você só use Reservas de capacidade interruptíveis para aplicativos que podem ser interrompidos.
------
#### [ Console ]
**Para iniciar instâncias em Reservas de capacidade interruptíveis**
1. Abra o console do Amazon EC2 em [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).
1. No painel do Amazon EC2, escolha **Launch Instance (Executar instância)**.
1. Defina suas configurações de instância.
1. Em **Detalhes avançados** para Reserva de capacidade, escolha **Iniciar instâncias interruptíveis em sua reserva ativa**.
1. Selecione o ID de reserva interruptível e a nova opção de compra da instância.
1. Escolha **Iniciar instância**.
------
#### [ AWS CLI ]
```
aws ec2 run-instances \
--instance-type m5.large \
--count 2 \
--image-id ami-12345678 \
--instance-market-options '{
"MarketType": "interruptible-capacity-reservation"
}' \
--capacity-reservation-specification '{
"CapacityReservationTarget": {
"CapacityReservationId": "cr-abcdef1234567890"
}
}'
```
------
### Execute instâncias com Grupos do Auto Scaling
Você também pode iniciar instâncias em reservas interruptíveis usando Grupos do Auto Scaling com modelos de lançamento. Configure o modelo de lançamento com o tipo de mercado interruptível e o ID de reserva e, em seguida, crie seu Grupo do Auto Scaling usando esse modelo. Para obter mais informações, consulte [Reservas de capacidade de interrupção com o EC2 Auto Scaling](https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-interruptible-capacity-reservations.html).
## Experiência de interrupção
Quando a capacidade é recuperada pelo proprietário, você recebe um aviso de interrupção 2 minutos antes do encerramento da instância. Esse aviso vem por meio de eventos do EventBridge, dando a você tempo para:
+ Salve seu trabalho ou verifique seus aplicativos
+ Encerrar processos
+ Preparar o término de uma instância
O evento EventBridge inclui detalhes sobre quais instâncias serão encerradas e o horário exato da rescisão. Para obter mais informações, consulte [Alerta de interrupção da instância](monitor-interruptible-cr.md#instance-interruption-warning).
# Monitore Reservas de capacidade interruptíveis com o EventBridge e o CloudTrail
As Reservas de capacidade interruptíveis enviam notificações do EventBridge e eventos do CloudTrail para ajudá-lo a monitorar e responder às mudanças de capacidade.
**Topics**
+ [
## Notificações do EventBridge
](#eventbridge-notifications)
+ [
## Eventos do CloudTrail
](#cloudtrail-events)
## Notificações do EventBridge
Você recebe dois tipos de notificações do EventBridge. Para obter informações sobre a configuração de notificações do EventBridge, consulte [Criação de regras do Amazon EventBridge](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule.html).
### Alerta de interrupção da instância
Se você estiver executando instâncias em uma reserva interruptível, receberá essa notificação 2 minutos antes de suas instâncias serem encerradas:
```
{
"version": "0",
"id": "12345678-1234-1234-1234-123456789012",
"detail-type": "EC2 Capacity Reservation Instance Interruption Warning",
"source": "aws.ec2",
"account": "[instance owner Account ID]",
"time": "[Current time in yyyy-mm-ddThh:mm:ssZ]",
"resources": "[instance arn]",
"region": "[region]",
"detail": {
"instance-id": "[instance-id]",
"instance-action": "terminate",
"instance-termination-time": "yyyy-mm-ddThh:mm:ssZ",
"azId": "[availability-zone-id]"
}
}
```
### Conclusão de recuperação
Se você for proprietário da reserva de origem, receberá esta notificação quando a recuperação de capacidade for concluída:
```
{
"version": "0",
"id": "12345678-1234-1234-1234-123456789012",
"detail-type": "EC2 Interruptible Capacity Reservation Allocation Reclamation Completed",
"source": "aws.ec2",
"account": "[source Capacity Reservation Owner Account ID]",
"time": "[Current time in yyyy-mm-ddThh:mm:ssZ]",
"region": "us-east-1",
"resources": ["source_cr_arn"],
"detail": {
"sourceCapacityReservationId": "string",
"instanceType": "string",
"availabilityZoneId": "string",
"TotalInstanceCount": "current total count in the source",
"ReclaimedInstanceCount": "count of instances added to the source",
"targetInstanceCount": "number"
}
}
```
## Eventos do CloudTrail
O CloudTrail registra esses eventos para Reservas de capacidade interruptíveis:
+ `InterruptibleCapacityReservationCreated`— Quando você cria uma alocação interruptível
+ `InterruptibleCapacityReservationAllocationUpdated`— Quando você modifica a alocação
+ `InterruptibleCapacityReservationCancelled`— Quando você cancela a alocação
+ `CapacityReservationModified`— Quando modificamos a reserva de origem para alocação
+ `InterruptibleCapacityReservationInstancesTerminated`— Quando encerramos instâncias durante a reclamação