# Blocos de capacidade para ML
Os blocos de capacidade para ML permitem que você reserve instâncias de computação acelerada baseadas em GPU em uma data futura para acomodar suas workloads de machine learning (ML) de curta duração. As instâncias executadas em um bloco de capacidade são automaticamente colocadas próximas umas das outras nos [ Amazon EC2 UltraClusters](https://aws.amazon.com/ec2/ultraclusters/) para redes sem bloqueio de baixa latência com escala de petabits.
Também é possível usar os blocos de capacidade para reservar capacidade nos servidores UltraServers do Amazon EC2. Os servidores UltraServers conectam várias instâncias do Amazon EC2 em uma interconexão aceleradora de baixa latência e alta largura de banda. Você pode usar os servidores UltraServers para lidar com as workloads de IA e ML que mais utilizam computação e memória em treinamento, ajuste e inferência. Para obter mais informações, consulte [Amazon EC2 UltraServers](https://aws.amazon.com/ec2/ultraservers/).
Com blocos de capacidade, você pode ver quando a capacidade da instância de GPU está disponível em datas futuras e agendar um bloco de capacidade para começar na hora que for melhor para você. Quando você reserva um bloco de capacidade, garante capacidade previsível de instâncias de GPU e pagando apenas pelo tempo que precisar. Recomendamos blocos de capacidade quando você precisa de GPUs para lidar com workloads de ML durante dias ou semanas seguidos e não deseja pagar por uma reserva enquanto as instâncias de GPU não estão em uso.
Estes são alguns casos de uso comuns de blocos de capacidade.
+ **Treinamento e ajuste fino de modelo de ML**: tenha acesso ininterrupto às instâncias de GPU que você reservou para realizar treinamento e ajuste fino do modelo de ML.
+ **Experimentos e protótipos de ML**: executar experimentos e desenvolver protótipos que exigem instâncias de GPU por períodos curtos.
Os Blocos de capacidade estão disponíveis para determinados tipos de instância em algumas regiões da AWS. Para obter mais informações, consulte [Tipos de instância e regiões compatíveis](#capacity-blocks-prerequisites).
É possível reservar um bloco de capacidade para uma hora de início em até oito semanas no futuro. Cada bloco de capacidade pode ter até 64 instâncias, e você pode ter até 256 instâncias nos blocos de capacidade.
**Topics**
+ [Tipos de instância e regiões compatíveis](#capacity-blocks-prerequisites)
+ [Plataformas compatíveis](#capacity-blocks-platforms)
+ [Considerações](#capacity-blocks-considerations)
+ [Recursos relacionados](#capacity-blocks-related-resources)
+ [Como funcionam os blocos de capacidade do Amazon EC2](capacity-blocks-how.md)
+ [Preços e faturamento de blocos de capacidade](capacity-blocks-pricing-billing.md)
+ [Encontrar e comprar blocos de capacidade](capacity-blocks-purchase.md)
+ [Iniciar instâncias usando blocos de capacidade](capacity-blocks-launch.md)
+ [Visualizar blocos de capacidade](capacity-blocks-view.md)
+ [Estender blocos de capacidade](capacity-blocks-extend.md)
+ [Compartilhar Blocos de capacidade](capacity-blocks-share.md)
+ [Criar um grupo de recursos para Blocos de capacidade do UltraServer](cb-group.md)
+ [Monitorar blocos de capacidade usando o EventBridge](capacity-blocks-monitor.md)
+ [Registrar em log chamadas de API de blocos de capacidade com o AWS CloudTrail](capacity-blocks-logging-using-cloudtrail.md)
## Tipos de instância e regiões compatíveis
Os blocos de capacidade da instância e UltraServer podem ser usados com os seguintes tipos de instância e regiões da AWS.
**nota**
Tamanhos de blocos de capacidade de 64 instâncias não são compatíveis com todos os tipos de instância em todas as Regiões da AWS.
### Blocos de capacidade da instância
+ **`p6-b300.48xlarge`**
+ Oeste dos EUA (Oregon): \$1 \$1 \$1 ) — `us-west-2`
+ **`p6-b200.48xlarge`**
+ Leste dos EUA (Norte da Virgínia) — `us-east-1`
+ Leste dos EUA (Ohio): `us-east-2`
+ Oeste dos EUA (Oregon): \$1 \$1 \$1 ) — `us-west-2`
+ **`p5.4xlarge`**
+ Leste dos EUA (Norte da Virgínia) — `us-east-1`
+ Leste dos EUA (Ohio): `us-east-2`
+ Oeste dos EUA (Oregon): \$1 \$1 \$1 ) — `us-west-2`
+ Europa (Londres): `eu-west-2`
+ Ásia-Pacífico (Mumbai): `ap-south-1`
+ Ásia-Pacífico (Tóquio): `ap-northeast-1`
+ Ásia-Pacífico (Sydney): `ap-southeast-2`
+ América do Sul (São Paulo): `sa-east-1`
+ **`p5.48xlarge`**
+ Leste dos EUA (Norte da Virgínia) — `us-east-1`
+ Leste dos EUA (Ohio): `us-east-2`
+ Oeste dos EUA (Norte da Califórnia): `us-west-1`
+ Oeste dos EUA (Oregon): \$1 \$1 \$1 ) — `us-west-2`
+ Europa (Estocolmo): `eu-north-1`
+ Europa (Londres): `eu-west-2`
+ América do Sul (São Paulo): `sa-east-1`
+ Ásia-Pacífico (Tóquio): `ap-northeast-1`
+ Ásia-Pacífico (Mumbai): `ap-south-1`
+ Ásia-Pacífico (Sydney): `ap-southeast-2`
+ Ásia-Pacífico (Jacarta): `ap-southeast-3`
+ Zona local do Leste dos EUA (Atlanta) — `us-east-1-atl-2a`
+ **`p5e.48xlarge`**
+ Leste dos EUA (Norte da Virgínia) — `us-east-1`
+ Leste dos EUA (Ohio): `us-east-2`
+ Oeste dos EUA (Norte da Califórnia): `us-west-1`
+ Oeste dos EUA (Oregon): \$1 \$1 \$1 ) — `us-west-2`
+ Europa (Estocolmo): `eu-north-1`
+ Europa (Londres): `eu-west-2`
+ Europa (Espanha): `eu-south-2`
+ América do Sul (São Paulo): `sa-east-1`
+ Ásia-Pacífico (Tóquio): `ap-northeast-1`
+ Ásia-Pacífico (Seul): `ap-northeast-2`
+ Ásia-Pacífico (Mumbai): `ap-south-1`
+ Ásia-Pacífico (Jacarta): `ap-southeast-3`
+ Zona local do Oeste dos EUA (Phoenix) — `us-west-2-phx-2a`
+ **`p4d.24xlarge`**
+ Leste dos EUA (Norte da Virgínia) — `us-east-1`
+ Leste dos EUA (Ohio): `us-east-2`
+ Oeste dos EUA (Oregon): \$1 \$1 \$1 ) — `us-west-2`
+ **`p4de.24xlarge`**
+ Leste dos EUA (Norte da Virgínia): ) — `us-east-1`
+ Oeste dos EUA (Oregon): ) — `us-west-2`
+ **`trn1.32xlarge`**
+ Leste dos EUA (Norte da Virgínia) — `us-east-1`
+ Leste dos EUA (Ohio): `us-east-2`
+ Oeste dos EUA (Norte da Califórnia): `us-west-1`
+ Oeste dos EUA (Oregon): \$1 \$1 \$1 ) — `us-west-2`
+ Europa (Estocolmo): `eu-north-1`
+ Ásia-Pacífico (Mumbai): `ap-south-1`
+ Ásia-Pacífico (Sydney): `ap-southeast-2`
+ Ásia-Pacífico (Melbourne): `ap-southeast-4`
+ **`trn2.3xlarge `**
+ Ásia-Pacífico (Melbourne): `ap-southeast-4`
+ América do Sul (São Paulo): `sa-east-1`
+ **`trn2.48xlarge`**
+ Leste dos EUA (Ohio): `us-east-2`
### Blocos de capacidade UltraServer
+ **`Trn2`**
+ Leste dos EUA (Ohio): `us-east-2`
+ **`P6e-GB200`**
+ Zona local do Leste dos EUA (Dallas) — `us-east-1-dfw-2a`
## Plataformas compatíveis
Atualmente, os blocos de capacidade para ML são compatíveis apenas com instâncias e UltraServers que tenham locação padrão. Quando você usa o Console de gerenciamento da AWS para comprar um bloco de capacidade, a opção de plataforma padrão é a Linux/UNIX. Quando você usa a AWS Command Line Interface (AWS CLI) ou o AWS SDK para comprar um bloco de capacidade, as seguintes opções de plataforma estão disponíveis:
+ Linux/UNIX
+ Red Hat Enterprise Linux
+ RHEL com HA
+ SUSE Linux
+ Ubuntu Pro
## Considerações
Antes de usar os blocos de capacidade, considere os seguintes detalhes e limitações.
+ Se detectarmos uma deficiência afetando um Bloco de Capacidade do UltraServer, notificaremos você, mas geralmente não tomaremos medidas para encerrar suas instâncias no Bloco de Capacidade. O objetivo é minimizar a interrupção não intencional em suas workloads. Você pode continuar usando o Bloco de Capacidade do UltraServer como está após receber essa notificação ou solicitar a correção encerrando todas as instâncias no bloco de capacidade e enviando um caso de suporte. AWS Após recebermos seu caso de suporte, notificaremos você quando concluirmos a correção e você poderá reiniciar as instâncias em seu Bloco de Capacidade UltraServer.
+ Nos blocos de capacidade do UltraServer `P6e-GB200`, é necessário encerrar suas instâncias pelo menos 60 minutos antes do horário de término do bloco de capacidade.
+ Para comprar e usar blocos de capacidade em zonas locais, você deve se inscrever na zona local.
+ Cada bloco de capacidade pode ter até 64 instâncias, e você pode ter até 256 instâncias nos blocos de capacidade.
+ É possível descrever as ofertas do bloco de capacidade que podem começar em apenas 30 minutos.
+ Os blocos de capacidade terminam às 11h30, Horário Universal Coordenado (UTC).
+ O processo de encerramento de instâncias em execução em um bloco de capacidade começa às 11h, Horário Universal Coordenado (UTC) no último dia da reserva.
+ Os blocos de capacidade podem ser reservados para uma hora de início em até oito semanas no futuro.
+ Não são permitidos cancelamentos de bloqueios de capacidade.
+ Os Blocos de capacidade do UltraServer não podem ser compartilhados entre contas da AWS nem dentro da sua organização da AWS.
+ O bloco de capacidade não pode ser [movido](capacity-reservations-move.md) ou [dividido](capacity-reservations-split.md).
+ Apenas blocos de capacidade UltraServer podem ser utilizados com grupos de recursos. Blocos de capacidade de instância não podem ser utilizados com grupos de recursos. Para obter mais informações, consulte [Criar um grupo de recursos para Blocos de capacidade do UltraServer](cb-group.md).
+ O número total de instâncias que podem ser reservadas em blocos de capacidade entre todas as contas da sua organização da AWS não pode ultrapassar 256 instâncias em uma determinada data.
+ Para usar um bloco de capacidade, as instâncias devem ser direcionadas especificamente para o ID da reserva.
+ As instâncias em um bloco de capacidade não contam para seus limites de instâncias sob demanda.
+ Para instâncias P5 usando uma AMI personalizada, verifique se você tem [os softwares e a configuração necessários para EFA](gpu-instances-started.md).
+ Para grupos de nós gerenciados do Amazon EKS, consulte [Criar um grupo de nós gerenciados com blocos de capacidade do Amazon EC2 para ML](https://docs.aws.amazon.com/eks/latest/userguide/capacity-blocks-mng.html). Para grupos de nós autogerenciados do Amazon EKS, consulte [Usar blocos de capacidade para ML com nós autogerenciados](https://docs.aws.amazon.com/eks/latest/userguide/capacity-blocks.html).
## Recursos relacionados
Após criar um bloco de capacidade, será possível fazer o seguinte com ele:
+ Iniciar instâncias no bloco de capacidade. Para obter mais informações, consulte [Iniciar instâncias usando blocos de capacidade](capacity-blocks-launch.md).
+ Crie um grupo do Amazon EC2 Auto Scaling. Para obter mais informações, consulte [Usar blocos de capacidade para workloads de machine learning](https://docs.aws.amazon.com/autoscaling/ec2/userguide/launch-template-capacity-blocks.html) no *Guia do usuário do Amazon EC2 Auto Scaling*.
**nota**
Se você usa o Amazon EC2 Auto Scaling ou o Amazon EKS, é possível programar a escalabilidade para ser executada no início da reserva do bloco de capacidade. Com o escalamento programado, o AWS gerencia automaticamente as novas tentativas para que você não precise se preocupar em implementar uma lógica de repetições para lidar com falhas transitórias.
+ Melhore os fluxos de trabalho de ML com o AWS Parallel Computing Service. Para obter mais informações, consulte [Suporte de blocos de capacidade para AWS Parallel Computing Service](https://aws.amazon.com/blogs/hpc/announcing-capacity-blocks-support-for-aws-parallel-computing-service/).
+ Melhore os fluxos de trabalho de ML com o AWS ParallelCluster. Para obter mais informações, consulte [Aprimorar fluxos de trabalho de ML com o AWS ParallelCluster e os Blocos de Capacidade do Amazon EC2 para ML](https://aws.amazon.com/blogs/hpc/enhancing-ml-workflows-with-aws-parallelcluster-and-amazon-ec2-capacity-blocks-for-ml/).
Para obter mais informações sobre o AWS Parallel Computing Service, consulte [O que é o AWS Parallel Computing Service](https://docs.aws.amazon.com/pcs/latest/userguide/what-is-service.html).
Para obter mais informações sobre o AWS ParallelCluster, consulte [O que é o AWS ParallelCluster](https://docs.aws.amazon.com/parallelcluster/latest/ug/what-is-aws-parallelcluster.html).
# Como funcionam os blocos de capacidade do Amazon EC2
Você pode reservar um bloco de capacidade com as seguintes especificações:
+ Reserve um horário de início com até oito semanas de antecedência
+ Defina a duração de uma reserva de 1 a 14 dias ou um múltiplo de 7 dias, até 182 dias (exemplos: 21 dias, 28 dias)
+ Configure até 64 instâncias por bloco de capacidade
+ Configure até 256 instâncias em vários blocos de capacidade
Nos servidores UltraServers do Amazon EC2, cada um corresponde a um bloco de capacidade. Você pode fazer uma única solicitação para vários servidores UltraServers.
Você pode usar blocos de capacidade para reservar instâncias `p6-b200`, `p5`, `p5e`, `p5en`, `p4d`, `p4de`, `trn1` e `trn2`. Compre os seguintes tipos de servidores UltraServer usando blocos de capacidade: `P6e-GB200` e `Trn2` (em pré-visualização).
Para reservar um bloco de capacidade, você começa especificando suas necessidades de capacidade, incluindo o tipo de instância ou o tipo de servidor UltraServer, o número de instâncias ou de UltraServers, a quantidade de tempo, a data de início mais antiga e a última data de término de que precisa. Depois, você vê uma oferta disponível do bloco de capacidade que atende às suas especificações. A oferta do bloco de capacidade inclui detalhes como hora de início, zona de disponibilidade e preço da reserva. O preço de oferta de um bloco de capacidade depende da disponibilidade e da demanda no momento em que a oferta é feita. Depois que você reserva um bloco de capacidade, o preço não muda mais. Para obter mais informações, consulte [Preços e faturamento de blocos de capacidade](capacity-blocks-pricing-billing.md).
Quando você compra uma oferta de bloco de capacidade, a reserva é criada para a data e o número de instâncias selecionados. Quando sua reserva de bloco de capacidade começa, você pode direcionar as inicializações de instância especificando o ID da reserva nas solicitações de inicialização.
É possível usar todas as instâncias reservadas por até 30 minutos (para os tipos de instância) ou 60 minutos (para o tipo de servidor UltraServer) antes da hora de término do bloco de capacidade. Faltando 30 minutos (para os tipos de instância) ou 60 minutos (para os tipos de servidor UltraServer) para o fim da reserva do bloco de capacidade, começamos a encerrar todas as instâncias em execução no bloco de capacidade. Usamos esse tempo para limpar as instâncias antes de entregar o bloco de capacidade ao próximo cliente. Emitimos um evento por meio do EventBridge 10 minutos antes do início do processo de encerramento. Para obter mais informações, consulte [Monitorar blocos de capacidade usando o EventBridge](capacity-blocks-monitor.md).
# Preços e faturamento de blocos de capacidade
Com os blocos de capacidade para ML do Amazon EC2, você só paga pelo que reserva. O preço de um bloco de capacidade depende da disponibilidade e da demanda de blocos de capacidade no momento da compra. É possível ver o preço de uma oferta de bloco de capacidade antes de fazer a reserva. O preço do bloco de capacidade é cobrado à vista no momento em que a reserva é feita. Quando você pesquisa um bloco de capacidade em um intervalo de datas, retornamos a oferta de bloco de capacidade com o menor preço disponível. Depois que você reservou um bloco de capacidade, o preço não muda mais.
Quando você usa um bloco de capacidade, paga pelo sistema operacional que usa quando as instâncias estão em execução. Para obter mais informações sobre os preços de sistemas operacionais, consulte [Amazon EC2 Capacity Blocks for ML Pricing](https://aws.amazon.com/ec2/capacityblocks/pricing/).
## Faturamento
O preço de uma oferta de bloco de capacidade é cobrado à vista. O pagamento é faturado na sua conta da AWS dentro de 5 minutos a 12 horas após a compra de um bloco de capacidade. Enquanto seu pagamento é processado, o recurso de reserva do bloco de capacidade permanece em um estado `payment-pending`. Se o pagamento não puder ser processado pelo menos cinco minutos antes do horário de início do bloco ou em 12 horas (o que ocorrer primeiro), o bloco de capacidade será liberado e o estado da reserva passará a ser `payment-failed`.
Depois que o pagamento é processado com sucesso, o estado do recurso do bloco de capacidade passa de `payment-pending` para `scheduled`. Você recebe uma fatura que reflete o pagamento antecipado à vista. Na fatura, você pode associar o valor pago ao ID da reserva do bloco de capacidade.
Quando a reserva do bloco de capacidade começa, você é cobrado com base apenas no sistema operacional que usa enquanto as instâncias estão em execução na reserva. É possível ver o uso e as cobranças associadas até a data de fechamento da sua fatura mensal de uso no AWS Cost and Usage Report.
**nota**
Os descontos dos Savings Plans e das instâncias reservadas não se aplicam aos blocos de capacidade.
**Visualizar sua fatura**
É possível visualizar sua conta no console do Gerenciamento de Faturamento e Custos da AWS. O pagamento antecipado do bloco de capacidade aparece no mês em que você adquiriu a reserva.
Depois que sua reserva começa, sua fatura mostra linhas separadas para o tempo usado e não usado da reserva do bloco. É possível usar esses itens de linha para ver quanto tempo foi usado de sua reserva. Você só verá uma cobrança por uso na linha de tempo usado se usar um sistema operacional premium. Para obter mais informações, consulte [Preços e faturamento de blocos de capacidade](#capacity-blocks-pricing-billing). Não há custo adicional por tempo não usado.
Para obter mais informações, consulte [Exibição da sua fatura](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/getting-viewing-bill.html) no *Guia do usuário do Gerenciamento de Faturamento e Custos da AWS*.
Se o bloco de capacidade começar em um mês diferente do mês em que você adquiriu a reserva, o preço inicial e o uso da reserva aparecerão em meses de cobrança diferentes. No seu AWS Cost and Usage Report, o ID da reserva do bloco de capacidade está listado no item da linha **reservation/ReservationARN** do pagamento antecipado e o **lineItem/ResourceID** na fatura mensal fechada para que você possa associar o uso ao preço pago antecipadamente correspondente.
# Encontrar e comprar blocos de capacidade
Para reservar um bloco de capacidade, primeiro, você precisa encontrar um bloco de tempo durante o qual a capacidade esteja disponível e que atenda às suas necessidades. Para encontrar um bloco de capacidade disponível para reservar, você deve especificar os itens a seguir.
+ O número de instâncias de que você precisa
+ O tempo durante o qual você precisa das instâncias
+ O intervalo de datas quando você precisa da reserva
Para pesquisar uma oferta disponível de bloco de capacidade, você especifica a duração da reserva e o número de instâncias. É necessário especificar durações de reserva em **incrementos de 1 dia até um total de 14 dias e incrementos de 7 dias até um total de 182 dias**. Cada bloco de capacidade pode ter até 64 instâncias, e você pode ter até 256 instâncias nos blocos de capacidade.
Ao solicitar um bloco de capacidade que atenda às suas especificações, fornecemos os detalhes de até seis blocos disponíveis. Todos os blocos de capacidade terminam às 11h30 UTC, então os blocos que começam no mesmo dia terão durações mais próximas da duração desejada. Um bloco terá uma duração um pouco menor que a duração desejada, enquanto a de outro será um pouco maior.
Os detalhes da oferta incluem a hora de início da reserva, a zona de disponibilidade da reserva e o preço da reserva. Para obter mais informações, consulte [Preços e faturamento de blocos de capacidade](capacity-blocks-pricing-billing.md).
É possível comprar a oferta de bloco de capacidade exibida ou modificar os critérios de pesquisa para ver as outras opções disponíveis. Não há prazo de validade predefinido para a oferta, mas as ofertas só estão disponíveis por ordem de chegada.
Ao comprar uma oferta de bloco de capacidade, você recebe uma resposta imediata confirmando que o bloco de capacidade foi reservado. Após a confirmação, você verá uma nova reserva de capacidade em sua conta com um tipo de reserva de `capacity-block` e uma `start-date` definida como a hora de início da oferta que você comprou. A reserva do bloco de capacidade é criada em um estado de `payment-pending`. Depois que o pagamento antecipado é processado com sucesso, o estado da reserva passa a ser `scheduled`. Para obter mais informações, consulte [Faturamento](capacity-blocks-pricing-billing.md#capacity-blocks-billing).
**nota**
Para comprar e usar blocos de capacidade em zonas locais, você deve se inscrever na zona local.
------
#### [ Console ]
**Para encontrar e comprar um bloco de capacidade**
1. Abra o console do Amazon EC2 em [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).
1. Na barra de navegação na parte superior da tela, selecione uma Região da AWS. Essa escolha é importante porque os tamanhos de blocos de capacidade de 64 instâncias não são compatíveis com todos os tipos de instância em todas as regiões.
1. No painel de navegação, escolha **Reservas de capacidade**, **Criar bloco de capacidade**.
1. Em **Tipos de blocos de capacidade**, escolha **Instâncias** ou **UltraServers**.
1. Em **Atributos de capacidade**, você pode definir os parâmetros da pesquisa de bloco de capacidade. Por padrão, a plataforma é Linux. Se você quiser selecionar outro sistema operacional, use a AWS CLI. Para obter mais informações, consulte [Plataformas compatíveis](ec2-capacity-blocks.md#capacity-blocks-platforms).
1. Em **Capacidade total** (para instâncias) ou **Contagem de UltraServer** (para UltraServers), especifique o número de instâncias ou UltraServers que deseja reservar.
1. Em **Duração**, insira o número de dias ou semanas durante os quais você precisa da reserva.
1. Em **Intervalo de datas para pesquisar blocos de capacidade**, insira a data mais antiga em que você deseja que a reserva comece.
1. Escolha **Encontrar blocos de capacidade**.
1. Se houver um bloco de capacidade disponível que atenda às suas especificações, você verá uma oferta em **Blocos de capacidade recomendados**. Se houver várias ofertas que atendam às suas especificações, a oferta de bloco de capacidade disponível mais antiga será exibida. Para ver outras ofertas de blocos de capacidade, ajuste as entradas da pesquisa e escolha **Localizar blocos de capacidade novamente**.
1. Quando encontrar uma oferta do bloco de capacidade que você queira comprar, escolha **Avançar**.
1. (Opcional) Na página **Adicionar tags**, escolha **Adicionar nova tag**.
1. A página **Revisar e comprar** lista a data de início e a data de término, a duração, o número total de instâncias e o preço.
**nota**
Blocos de capacidade não podem ser cancelados depois que você os reserva.
1. Na janela pop-up **Comprar um bloco de capacidade**, digite confirmar e depois escolha **Comprar**.
------
#### [ AWS CLI ]
**Para encontrar um Bloco de Capacidade de instância**
Use o comando [describe-capacity-block-extension-offerings](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-capacity-block-offerings.html).
O exemplo a seguir encontra Blocos de Capacidade de instância.
```
aws ec2 describe-capacity-block-offerings \
--instance-type p5.48xlarge \
--instance-count 16 \
--start-date-range 2023-08-14T00:00:00Z \
--end-date-range 2023-10-22-T00:00:00Z \
--capacity-duration-hours 48 \
--all-availability-zones
```
O exemplo a seguir encontra Blocos de Capacidade do UltraServer.
```
aws ec2 describe-capacity-block-offerings \
--ultraserver-type u-p6e-gb200x72 \
--ultraserver-count 1 \
--start-date-range 2023-08-14T00:00:00Z \
--end-date-range 2023-10-22-T00:00:00Z \
--capacity-duration-hours 48
```
**Para comprar um bloco de capacidade**
Use o comando [ purchase-capacity-block](https://docs.aws.amazon.com/cli/latest/reference/ec2/purchase-capacity-block.html) com o ID de oferta do Bloco de Capacidade da saída do exemplo anterior.
```
aws ec2 purchase-capacity-block \
--capacity-block-offering-id cb-0123456789abcdefg \
--instance-platform Linux/UNIX
```
------
#### [ PowerShell ]
**Para encontrar Blocos de Capacidade**
Use o cmdlet [Get-EC2CapacityBlockOffering](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2CapacityBlockOffering.html).
O exemplo a seguir encontra Blocos de Capacidade de instância.
```
Get-EC2CapacityBlockOffering `
-InstanceType p5.48xlarge `
-InstanceCount 16 `
-CapacityDurationHour 48 `
-StartDateRange 2023-08-14T00:00:00Z `
-EndDateRange 2023-10-22-T00:00:00Z `
-AllAvailabilityZones $true
```
O exemplo a seguir encontra Blocos de Capacidade do UltraServer.
```
Get-EC2CapacityBlockOffering `
-UltraserverType u-p6e-gb200x72 `
-UltraserverCount 1 `
-CapacityDurationHour 48 `
-StartDateRange 2023-08-14T00:00:00Z `
-EndDateRange 2023-10-22-T00:00:00Z
```
**Para comprar um bloco de capacidade**
Use o cmdlet [New-EC2EC2CapacityBlock](https://docs.aws.amazon.com/powershell/latest/reference/items/New-EC2EC2CapacityBlock.html) com o ID de oferta do bloco de capacidade da saída do exemplo anterior.
```
New-EC2EC2CapacityBlock `
-CapacityBlockOfferingId cb-0123456789abcdefg `
-InstancePlatform Linux/UNIX
```
------
# Iniciar instâncias usando blocos de capacidade
Para usar o bloco de capacidade, você deve especificar o ID da reserva do bloco de capacidade ao iniciar as instâncias. A inicialização de uma instância em uma reserva de capacidade reduz a capacidade disponível de acordo com o número de instâncias iniciadas. Por exemplo, se a capacidade de instância comprada for de oito instâncias e você executar quatro instâncias, a capacidade disponível será reduzida em quatro.
Se você encerrar uma instância em execução no bloco de capacidade antes que a reserva termine, poderá iniciar uma nova instância em seu lugar. Quando você interrompe ou encerra uma instância em um bloco de capacidade, são necessários vários minutos para limpar sua instância antes que você possa executar outra instância para substituí-la. Durante esse tempo, a instância ficará em um estado de Interrompendo ou `shutting-down`. Depois que esse processo é concluído, o estado da sua instância passa para `stopped` ou `terminated`. Em seguida, a capacidade disponível no bloco de capacidade é atualizada para mostrar outra instância disponível para uso.
**Requisitos**
+ A instância não pode ser iniciada em uma sub-rede em uma zona de disponibilidade diferente da zona de disponibilidade em que o bloco de capacidade está localizado.
+ Sua instância não pode ser iniciada usando uma AMI com uma plataforma diferente da plataforma em seu bloco de capacidade.
+ Para usar blocos de capacidade em zonas locais, você deve se inscrever na zona local.
------
#### [ Console ]
**Para iniciar instâncias em um bloco de capacidade**
1. Abra o console do Amazon EC2 em [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).
1. Na barra de navegação na parte superior da tela, selecione uma região para a reserva do bloco de capacidade.
1. No painel do console do Amazon EC2, selecione **Launch instance (Executar instância)**.
1. Siga o procedimento para [iniciar uma instância](ec2-launch-instance-wizard.md).
1. Expanda **Detalhes avançados** e, para **Opção de compra**, escolha **Blocos de capacidade**. Depois, siga um destes procedimentos:
+ Para iniciar as instâncias em um bloco de capacidade específico, em **Reserva de capacidade**, escolha **Especificar reserva de capacidade** e selecione o bloco de capacidade.
+ (*Apenas UltraServers*) Para iniciar as instâncias em um grupo de recursos do Bloco de capacidade do UltraServer, em **Reserva de capacidade**, escolha **Especificar grupo de recursos de Reserva de capacidade** e depois selecione o grupo de recursos.
1. Escolha **Iniciar instância**.
------
#### [ AWS CLI ]
**Para iniciar instâncias usando um Bloco de capacidade**
Use o comando [run-instances](https://docs.aws.amazon.com/cli/latest/reference/ec2/run-instances.html) com a opção `instance-market-options MarketType`.
O exemplo a seguir inicia uma instância em um Bloco de capacidade específico.
```
aws ec2 run-instances \
--image-id ami-0abcdef1234567890 \
--count 1 \
--instance-type p5.48xlarge \
--key-name my-key-pair \
--subnet-id subnet-0abcdef1234567890 \
--instance-market-options MarketType='capacity-block' \
--capacity-reservation-specification CapacityReservationTarget={CapacityReservationId=capacity_block_id}
```
O exemplo a seguir inicia uma instância em um grupo de recursos de Bloco de capacidade do UltraServer.
```
aws ec2 run-instances \
--image-id ami-0abcdef1234567890 \
--count 1 \
--instance-type p6e-gb200.36xlarge \
--key-name my-key-pair \
--subnet-id subnet-0abcdef1234567890 \
--instance-market-options MarketType='capacity-block' \
--capacity-reservation-specification CapacityReservationTarget={CapacityReservationResourceGroupArn=resource_group_arn}
```
------
#### [ PowerShell ]
**Para iniciar instâncias em um bloco de capacidade**
Use o cmdlet [New-EC2Instance](https://docs.aws.amazon.com/powershell/latest/reference/items/New-EC2Instance.html) com a opção `-InstanceMarketOption` definida da seguinte maneira.
```
$marketoption = New-Object Amazon.EC2.Model.InstanceMarketOptionsRequest
$marketoption.MarketType = "capacity-block"
```
O exemplo a seguir inicia uma instância em um Bloco de capacidade específico.
```
New-EC2Instance `
-ImageId ami-0abcdef1234567890 `
-InstanceType p5.48xlarge `
-KeyName "my-key-pair" `
-SubnetId subnet-0abcdef1234567890 `
-InstanceMarketOptions $marketoption `
-CapacityReservationTarget_CapacityReservationId capacity_block_id
```
O exemplo a seguir inicia uma instância em um grupo de recursos de Bloco de capacidade do UltraServer.
```
New-EC2Instance `
-ImageId ami-0abcdef1234567890 `
-InstanceType p6e-gb200.36xlarge `
-KeyName "my-key-pair" `
-SubnetId subnet-0abcdef1234567890 `
-InstanceMarketOptions $marketoption `
-CapacityReservationTarget_CapacityReservationResourceGroupArn "resource_group_arn"
```
------
**Recursos relacionados**
+ Para criar um modelo de execução direcionado para um bloco de capacidade, consulte [Armazenar os parâmetros de execução de instâncias nos modelos de execução do Amazon EC2](ec2-launch-templates.md)
+ Para iniciar instâncias em um bloco de capacidade usando a Frota do EC2, consulte [Tutorial: configurar o EC2 Fleet para executar instâncias em blocos de capacidade](ec2-fleet-launch-instances-capacity-blocks-walkthrough.md).
+ Para configurar um grupo de nós gerenciados do EKS com um bloco de capacidade, consulte [Criar um grupo de nós gerenciados com blocos de capacidade para ML](https://docs.aws.amazon.com/eks/latest/userguide/capacity-blocks-mng.html) no **Guia do usuário do Amazon EKS**.
+ Para configurar AWS ParallelCluster usando um Bloco de Capacidade, consulte [ML em AWS ParallelCluster](https://catalog.workshops.aws/ml-on-aws-parallelcluster/en-US).
# Visualizar blocos de capacidade
Depois que reservar um bloco de capacidade, será possível visualizar a reserva do bloco de capacidade em sua conta da AWS. É possívelrá visualizar a `start-date` e a `end-date` para saber quando sua reserva começará e terminará. Antes do início de uma reserva do bloco de capacidade, a capacidade disponível aparece como zero. É possível ver quantas instâncias estarão disponíveis em seu bloco de capacidade pelo valor da tag da chave de tag `aws:ec2capacityreservation:incrementalRequestedQuantity`.
Quando uma reserva de bloco de capacidade começa, o estado da reserva passa de `scheduled` para `active`. Emitimos um evento por meio do Amazon EventBridge para notificar você de que o bloco de capacidade está disponível para uso. Para obter mais informações, consulte [Monitorar blocos de capacidade usando o EventBridge](capacity-blocks-monitor.md).
Os blocos de capacidade têm os seguintes status:
+ `payment-pending`: o pagamento antecipado ainda não foi processado.
+ `payment-failed`: não foi possível processar o pagamento no prazo de 12 horas. O bloco de capacidade foi liberado.
+ `scheduled`: o pagamento foi processado e a reserva do bloco de capacidade ainda não começou.
+ `active`: a capacidade reservada está disponível para seu uso.
+ `expired`: a reserva do bloco de capacidade expirou automaticamente na data e hora especificadas na solicitação da reserva. A capacidade reservada não está mais disponível para uso.
------
#### [ Console ]
**Para visualizar blocos de capacidade**
1. Abra o console do Amazon EC2 em [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).
1. No painel de navegação, escolha **Reservas de Capacidade**.
1. Na página **Visão geral das reservas de capacidade**, você vê uma tabela de recursos com detalhes sobre todos os seus recursos de reserva de capacidade. Para encontrar suas reservas de blocos de capacidade, selecione **Blocos de capacidade** na lista suspensa acima de **ID da reserva de capacidade**. Na tabela, você pode ver informações sobre os blocos de capacidade, como datas de início e término, duração e status.
1. Para obter mais detalhes sobre um bloco de capacidade, selecione o ID da reserva do bloco de capacidade que você deseja visualizar. A página **Detalhes da reserva de capacidade** exibe todas as propriedades da reserva e o número de instâncias que estão em uso ou que estão disponíveis no bloco de capacidade.
**nota**
Antes do início de uma reserva do bloco de capacidade, a capacidade disponível aparece como zero. É possível ver quantas instâncias estarão disponíveis quando a reserva de bloco de capacidade começar usando o seguinte valor de tag para a chave de tag: `aws:ec2capacityreservation:incrementalRequestedQuantity`.
------
#### [ AWS CLI ]
**Para visualizar blocos de capacidade**
Por padrão, quando você usa o comando [describe-capacity-reservations](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-capacity-reservations.html), as reservas de capacidade sob demanda e as reservas de blocos de capacidade são listadas. Para visualizar somente as suas reservas de bloco de capacidade, filtre as reservas do tipo `capacity-block`.
```
aws ec2 describe-capacity-reservations \
--filters Name=reservation-type,Values=capacity-block
```
------
#### [ PowerShell ]
**Para visualizar blocos de capacidade**
Use o cmdlet [Get-EC2CapacityReservation](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2CapacityReservation.html). Por padrão, tanto as reservas de capacidade sob demanda quanto as reservas de blocos de capacidade são listadas. Para visualizar somente as suas reservas de bloco de capacidade, filtre as reservas do tipo `capacity-block`.
```
Get-EC2CapacityReservation `
-Filter @{Name="reservation-type"; Values="capacity-block"}
```
------
# Estender blocos de capacidade
Com os blocos de capacidade, você reserva a capacidade computacional das workloads, garantindo disponibilidade e consistência. Para acomodar suas necessidades em constante mudança, você pode estender a duração dos blocos de capacidade existentes conforme necessário.
Para estender um bloco de capacidade, ele deve ter um status de `active` ou `scheduled` e não ter extensões que estejam como `payment-pending`. Você pode solicitar a prorrogação da duração do seu bloco de capacidade até no mínimo 1 hora ou no máximo 56 dias antes que ele expire. É possível estender o bloco de capacidade em incrementos de 1 a 14 dias e em incrementos de 7 dias até 182 dias (26 semanas) no total. Ao estender o bloco de capacidade, a data de término dele será atualizada para que suas instâncias possam continuar funcionando sem interrupções.
+ Não há limite para o número de extensões que você pode aplicar a um bloco de capacidade
+ O ID de reserva de capacidade permanecerá o mesmo após a extensão do bloco
+ Os blocos de capacidade só podem ser estendidos se houver capacidade suficiente disponível para comportá-los, o que não é garantido.
## Faturamento
O preço de uma oferta de bloco de capacidade é cobrado à vista. A extensão permanecerá como `payment-pending` até que a fatura seja paga. Se o pagamento não puder ser processado dentro de 12 horas ou até 35 minutos antes do término programado do bloco de capacidade (o que ocorrer primeiro), sua extensão não terá êxito e o status mudará para `payment-failed`. A reserva do bloco de capacidade permanecerá `active` e será encerrada na data de término original.
Depois que o pagamento for processado com êxito, o status da extensão do bloco de capacidade mudará para `payment-succeeded` e a data de término da reserva do bloco de capacidade será atualizada para a nova. Os detalhes da extensão podem ser consultados na seção **Detalhes da extensão do bloco de capacidade** do console ou usando o comando [describe-capacity-block-extension-history](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-capacity-block-extension-history.html).
## Estender blocos de capacidade
------
#### [ Console ]
**Para estender um bloco de capacidade**
1. Abra o console do Amazon EC2 em [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).
1. No painel de navegação, escolha **Reservas de Capacidade**.
1. Na página **Visão geral das reservas de capacidade**, você vê uma tabela de recursos com detalhes sobre todos os seus recursos das reservas de capacidade. Selecione o ID da reserva referente ao bloco de capacidade que você deseja estender.
1. No menu suspenso **Ações**, escolha **Estender bloco de capacidade**.
1. Em **Duração**, insira o número de dias ou semanas pelos quais você precisa estender a reserva.
1. Escolha **Encontrar bloco de capacidade**.
1. Se houver um bloco de capacidade disponível que atenda às suas especificações, uma oferta aparecerá em **Blocos de capacidade recomendados**. Para ver outras ofertas de blocos de capacidade, ajuste as entradas da pesquisa e escolha **Localizar blocos de capacidade novamente**.
1. Quando encontrar uma oferta do bloco de capacidade que deseja comprar, escolha **Estender**.
1. Na janela pop-up **Estender bloco de capacidade**, insira *confirmar* e escolha **Estender**.
------
#### [ AWS CLI ]
**Para encontrar uma extensão de bloco de capacidade**
Use o comando [describe-capacity-block-extension-offerings](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-capacity-block-extension-offerings.html). O exemplo a seguir pesquisa uma extensão de bloco de capacidade de 48 horas para a reserva especificada.
```
aws ec2 describe-capacity-block-extension-offerings \
--capacity-reservation-id cr-1234567890abcdefg \
--capacity-block-extension-duration-hours 48
```
**Para estender um bloco de capacidade**
Use o comando [purchase-capacity-block-extension](https://docs.aws.amazon.com/cli/latest/reference/ec2/purchase-capacity-block-extension.html). Especifique o ID da oferta de extensão da saída do exemplo anterior.
```
aws ec2 purchase-capacity-block-extension \
--capacity-block-extension-offering-id cbe-0123456789abcdefg \
--capacity-reservation-id cr-1234567890abcdefg
```
------
#### [ PowerShell ]
**Para encontrar uma extensão de bloco de capacidade**
Use o cmdlet [Get-EC2CapacityBlockExtensionOffering](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2CapacityBlockExtensionOffering.html). O exemplo a seguir pesquisa uma extensão de bloco de capacidade de 48 horas para a reserva especificada.
```
Get-EC2CapacityBlockExtensionOffering `
-CapacityReservationId cr-1234567890abcdefg `
-CapacityBlockExtensionDurationHour 48
```
**Para estender um bloco de capacidade**
Use o cmdlet [Invoke-EC2CapacityBlockExtension](https://docs.aws.amazon.com/powershell/latest/reference/items/Invoke-EC2CapacityBlockExtension.html). Especifique o ID da oferta de extensão da saída do exemplo anterior.
```
Invoke-EC2CapacityBlockExtension `
-CapacityBlockExtensionOfferingId cbe-0123456789abcdefg `
-CapacityReservationId cr-1234567890abcdefg
```
------
# Compartilhar Blocos de capacidade
O compartilhamento de Blocos de capacidade permite que os proprietários do Bloco de Capacidade compartilhem os Blocos de Capacidade do Amazon EC2 com outras contas da AWS dentro de uma organização da AWS. Assim você pode maximizar o uso da capacidade reservada da GPU em diferentes equipes e projetos para usar com eficiência os Blocos de capacidade.
A conta da AWS proprietária do Bloco de capacidade (proprietário) pode compartilhá-lo com outras contas da AWS (consumidores). Um proprietário pode compartilhar um Bloco de capacidade com contas da AWS específicas dentro de sua organização da AWS, uma unidade organizacional dentro de sua organização da AWS ou toda a organização da AWS. Os consumidores podem iniciar instâncias em Blocos de capacidade que foram compartilhados da mesma forma que iniciam instâncias em Blocos de capacidade de sua propriedade.
## Pré-requisitos para compartilhar Blocos de capacidade
Para que você possa compartilhar um Bloco de capacidade, as seguintes condições devem ser atendidas:
+ **Você deve possuir o Bloco de capacidade**: não é possível compartilhar um Bloco de capacidade que tenha sido compartilhado com você.
+ **O estado do Bloco de capacidade deve estar ativo ou programado**: Blocos de capacidade que estão em outros [estados](https://docs.aws.amazon.com/cli/latest/reference/ec2/purchase-capacity-block.html), como `expired` ou `payment-pending` não podem ser compartilhados.
+ **Compartilhamento somente dentro da sua organização da AWS**: um proprietário pode compartilhar um Bloco de capacidade com contas da AWS específicas dentro de sua organização da AWS, uma unidade organizacional dentro de sua organização da AWS ou toda a organização da AWS.
+ **Blocos de capacidade do UltraServer não compatíveis**: você não pode compartilhar Blocos de capacidade para Amazon EC2 UltraServers.
+ **Qualificação da conta**: o compartilhamento de Blocos de capacidade não está disponível para novas contas da AWS ou contas da AWS com histórico de faturamento limitado.
## Serviços relacionados
O compartilhamento de Blocos de capacidade integra-se ao AWS Resource Access Manager (AWS RAM). O AWS RAM é um serviço que permite compartilhar seus recursos da AWS com qualquer conta da AWS ou por meio do AWS Organizations. Com o AWS RAM, você compartilha recursos que possui criando um *compartilhamento de recursos*. Um compartilhamento de recursos especifica os recursos a serem compartilhados, e os consumidores com os quais compartilhá-los. Os consumidores podem ser contas individuais da AWS, unidades organizacionais ou toda uma organização do AWS Organizations.
Para obter mais informações sobre o AWS RAM, consulte o *[Manual do usuário do AWS RAM](https://docs.aws.amazon.com/ram/latest/userguide/)*.
## Permissões de Blocos de capacidade compartilhada
### Permissões para proprietários
O proprietário do Bloco de capacidade permanece responsável pelo gerenciamento do Bloco de capacidade (por exemplo, extensão, compartilhamento) e pelas instâncias que executa nele. Os proprietários não podem modificar as instâncias que os consumidores executam nos Blocos de capacidade que compartilharam.
### Permissões para clientes
Os consumidores podem iniciar instâncias na capacidade compartilhada e são responsáveis por gerenciar essas instâncias. Os consumidores não podem visualizar ou modificar instâncias de propriedade de outros consumidores ou do proprietário do Bloco de capacidade. Os consumidores também podem visualizar apenas a capacidade total e a capacidade disponível no Bloco de capacidade compartilhado.
## Compartilhar Blocos de capacidade
Para compartilhar um Bloco de capacidade, é necessário adicioná-lo um compartilhamento de recursos. Um compartilhamento de recursos é um recurso do AWS RAM que permite que você compartilhe seus recursos entre Contas da AWS.
Se você adicionar o Bloco de capacidade a um compartilhamento de recursos compartilhado com toda organização da AWS, os consumidores da organização terão acesso ao Bloco de capacidade compartilhado.
------
#### [ Console ]
**Para compartilhar um Bloco de capacidade de sua propriedade usando o console do Amazon EC2**
1. Abra o console do Amazon EC2 em [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).
1. No painel de navegação, escolha **Reservas de Capacidade**.
1. Escolha o Bloco de capacidade a ser compartilhado e escolha **Ações, Compartilhar reserva**.
1. Selecione o compartilhamento de recursos ao qual adicionar o Bloco de capacidade e escolha **Compartilhar Reserva de capacidade)**.
Pode levar alguns minutos para que os consumidores obtenham acesso ao Bloco de capacidade compartilhado.
**Para adicionar um Bloco de capacidade para um novo recurso compartilhado**
Primeiro, você precisa criar o compartilhamento de recursos usando o console do AWS RAM. Para obter mais informações, consulte [Criar um compartilhamento de recurso](https://docs.aws.amazon.com/ram/latest/userguide/working-with-sharing.html#working-with-sharing-create) no *Guia do usuário do AWS RAM*.
------
#### [ AWS CLI ]
**Para compartilhar um Bloco de capacidade de sua propriedade**
Use os comandos [create-resource-share](https://docs.aws.amazon.com/cli/latest/reference/ram/create-resource-share.html) e [associate-resource-share](https://docs.aws.amazon.com/cli/latest/reference/ram/associate-resource-share.html).
```
aws ram create-resource-share \
--name my-resource-share \
--resource-arns arn:aws:ec2:us-east-2:123456789012:capacity-reservation/cr-1234abcd56EXAMPLE
```
```
aws ram associate-resource-share \
--resource-share-arn arn:aws:ram:us-east-2:123456789012:resource-share/7ab63972-b505-7e2a-420d-6f5d3EXAMPLE \
--resource-arns arn:aws:ec2:us-east-2:123456789012:capacity-reservation/cr-1234abcd56EXAMPLE
```
------
#### [ PowerShell ]
**Para compartilhar um Bloco de capacidade de sua propriedade**
Use os cmdlets [New-RAMResourceShare](https://docs.aws.amazon.com/powershell/latest/reference/items/New-RAMResourceShare.html) e [Connect-RAMResourceShare](https://docs.aws.amazon.com/powershell/latest/reference/items/Connect-RAMResourceShare.html).
```
New-RAMResourceShare `
-Name my-resource-share `
-ResourceArn "arn:aws:ec2:us-east-2:123456789012:capacity-reservation/cr-1234abcd56EXAMPLE"
```
```
Connect-RAMResourceShare `
-ResourceShareArn "arn:aws:ram:us-east-2:123456789012:resource-share/7ab63972-b505-7e2a-420d-6f5d3EXAMPLE" `
-ResourceArn "arn:aws:ec2:us-east-2:123456789012:capacity-reservation/cr-1234abcd56EXAMPLE"
```
------
Os Blocos de capacidade operam por **ordem de chegada** para todas as contas, independentemente do status de propriedade. Quando você compartilha um Bloco de capacidade, se um consumidor inicia instâncias antes do proprietário, essas instâncias ocupam a capacidade até que o consumidor encerre as instâncias ou até 30 minutos antes da expiração do Bloco de capacidade.
## Parar de compartilhar um Bloco de capacidade
Você pode parar de compartilhar um Bloco de capacidade a qualquer momento até 30 minutos antes da data de expiração do bloco.
**O que acontece quando você para de compartilhar:**
+ Os consumidores não podem mais executar novas instâncias no Bloco de capacidade que não era compartilhado.
+ Todas as instâncias em execução continuam funcionando até 30 minutos antes da data de expiração do Bloco de capacidade, a menos que sejam encerradas pelo consumidor.
------
#### [ Console ]
**Para interromper o compartilhamento de um Bloco de capacidade que você possui usando o console do Amazon EC2, clique aqui.**
1. Abra o console do Amazon EC2 em [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).
1. No painel de navegação, escolha **Reservas de Capacidade**.
1. Selecione o Bloco de capacidade e escolha a guia **Compartilhamento**.
1. A guia **Compartilhamento** lista os compartilhamentos de recursos aos quais o Bloco de capacidade foi adicionado. Selecione o compartilhamento de recursos do qual remover o Bloco de capacidade.
1. Escolha **Remover do compartilhamento de recursos**.
------
#### [ AWS CLI ]
**Para parar de compartilhar um Bloco de capacidade de sua propriedade**
Use o comando [disassociate-resource-share](https://docs.aws.amazon.com/cli/latest/reference/ram/disassociate-resource-share.html).
```
aws ram disassociate-resource-share \
--resource-share-arn arn:aws:ram:us-east-2:123456789012:resource-share/7ab63972-b505-7e2a-420d-6f5d3EXAMPLE \
--resource-arns arn:aws:ec2:us-east-2:123456789012:capacity-reservation/cr-1234abcd56EXAMPLE
```
------
#### [ PowerShell ]
**Para parar de compartilhar um Bloco de capacidade de sua propriedade**
Use o cmdlet [Disconnect-RAMResourceShare](https://docs.aws.amazon.com/powershell/latest/reference/items/Disconnect-RAMResourceShare.html).
```
Disconnect-RAMResourceShare `
-ResourceShareArn "arn:aws:ram:us-east-2:123456789012:resource-share/7ab63972-b505-7e2a-420d-6f5d3EXAMPLE" `
-ResourceArn "arn:aws:ec2:us-east-2:123456789012:capacity-reservation/cr-1234abcd56EXAMPLE"
```
------
## Monitore o uso compartilhado do Bloco de capacidade
Os proprietários do Bloco de capacidade podem monitorar quais contas estão usando seus Blocos de capacidade compartilhados e monitorar o uso de instâncias por conta.
------
#### [ AWS CLI ]
**Para monitorar o uso de um Bloco de capacidade**
Use o comando [get-capacity-reservation-usage](https://docs.aws.amazon.com/cli/latest/reference/ec2/get-capacity-reservation-usage.html).
```
aws ec2 get-capacity-reservation-usage \
--capacity-reservation-id cr-1234abcd56EXAMPLE
```
**Essa API permite que os proprietários:**
+ Ver quais contas estão usando o Bloco de capacidade no momento.
+ Ver o número de instâncias que cada conta está executando.
------
## Notificações de encerramento de instância
As contas do proprietário e do consumidor que tiverem instâncias em execução no Bloco de capacidade receberão um evento do EventBridge 40 minutos antes do término da reserva do Bloco de capacidade, indicando que todas as instâncias em execução na reserva começarão a ser encerradas em dez minutos. Para obter mais informações, consulte [Monitorar blocos de capacidade usando o EventBridge](capacity-blocks-monitor.md).
## Extensões do Bloco de capacidade
Os Blocos de capacidade podem ser estendidos enquanto são compartilhados. Somente a conta do proprietário pode estender um Bloco de capacidade compartilhado.
Quando um Bloco de capacidade é estendido, as instâncias em execução lançadas pelo proprietário ou pelos consumidores herdam automaticamente a nova data de expiração, e os consumidores podem continuar usando a capacidade compartilhada até a nova data de expiração sem nenhuma interrupção da instância.
## Definição de preço e faturamento
Os proprietários são cobrados pelos Blocos de capacidade que compartilham e pagam antecipadamente pelo Bloco de capacidade quando o compram. Os proprietários também pagam pelas taxas do sistema operacional pelas instâncias que executam no Bloco de capacidade.
Os consumidores são cobrados somente pelas cobranças do sistema operacional pelas instâncias que executam no Bloco de capacidade compartilhado. Os consumidores não são cobrados pela reserva do Bloco de capacidade em si.
# Criar um grupo de recursos para Blocos de capacidade do UltraServer
É possível usar o AWS Resource Groups para criar coleções lógicas de Blocos de capacidade do UltraServer. Depois de criar o grupo de recursos, é possível adicionar Blocos de capacidade do UltraServer que você possui em sua conta. Depois de adicionar os Blocos de capacidade do UltraServer, é possível direcionar o lançamento de instâncias para o grupo de recursos em vez dos blocos de capacidade individuais. As instâncias direcionadas a um grupo de recursos correspondem a qualquer Bloco de capacidade do UltraServer no grupo que tenha atributos correspondentes e capacidade disponível. Se o grupo de recursos não tiver um Bloco de capacidade do UltraServer com atributos correspondentes e capacidade disponível, a inicialização da instância falhará.
Se um Bloco de capacidade do UltraServer for removido de um grupo de recursos enquanto houver instâncias em execução, essas instâncias continuarão em execução no Bloco de capacidade. Se um Bloco de capacidade do UltraServer em um grupo terminar enquanto houver instâncias em execução, as instâncias serão encerradas.
Não é possível adicionar Blocos de capacidade de instância a um grupo de recursos.
Para criar um grupo de recursos para Blocos de capacidade do UltraServer, use um dos métodos a seguir.
------
#### [ AWS CLI ]
**Para criar um grupo de recursos para Blocos de capacidade do UltraServer**
[Use o comando AWS CLIcreate-group](https://docs.aws.amazon.com/cli/latest/reference/resource-groups/create-group.html) e, para `--configuration`, especifique o seguinte:
```
{
"Configuration": [
{
"Type": "AWS::EC2::CapacityReservationPool",
"Parameters": [
{
"Name": "instance-type",
"Values": [
"instance_type"
]
},
{
"Name": "reservation-type",
"Values": [
"capacity-block"
]
}
]
},
{
"Type": "AWS::ResourceGroups::Generic",
"Parameters": [
{
"Name": "allowed-resource-types",
"Values": [
"AWS::EC2::CapacityReservation"
]
}
]
}
]
}
```
------
#### [ PowerShell ]
**Para criar um grupo de recursos para Blocos de capacidade do UltraServer**
Use o cmdlet [New-RGGroup](https://docs.aws.amazon.com/powershell/latest/reference/items/New-RGGroup.html). Para `-Configuration`, especifique o seguinte:
```
{
"Configuration": [
{
"Type": "AWS::EC2::CapacityReservationPool",
"Parameters": [
{
"Name": "instance-type",
"Values": [
"instance_type"
]
},
{
"Name": "reservation-type",
"Values": [
"capacity-block"
]
}
]
},
{
"Type": "AWS::ResourceGroups::Generic",
"Parameters": [
{
"Name": "allowed-resource-types",
"Values": [
"AWS::EC2::CapacityReservation"
]
}
]
}
]
}
```
------
Depois de criar um grupo de recursos para o Bloco de capacidade do UltraServer, utilize um dos métodos a seguir para adicionar Blocos de capacidade do UltraServer existentes a ele.
------
#### [ AWS CLI ]
**Para adicionar um Bloco de capacidade do UltraServer a um grupo de recursos**
Use o comando [group-resources](https://docs.aws.amazon.com/cli/latest/reference/resource-groups/group-resources.html). Para `--group`, especifique o nome do grupo de recursos que você criou. Para `--resource-arns`, especifique os ARNs dos Blocos de capacidade do UltraServer a serem adicionados.
```
aws resource-groups group-resources \
--group MyCRGroup \
--resource-arns CapacityReservationArn
```
------
#### [ PowerShell ]
**Para adicionar um Bloco de capacidade do UltraServer a um grupo de recursos**
Use o cmdlet [Add-RGResource](https://docs.aws.amazon.com/powershell/latest/reference/items/Add-RGResource.html). Para `-Group`, especifique o nome do grupo de recursos que você criou. Para `-ResourceArn `, especifique os ARNs dos Blocos de capacidade do UltraServer a serem adicionados.
O exemplo a seguir adiciona duas reservas de capacidade ao grupo especificado.
```
Add-RGResource `
-Group MyCRGroup `
-ResourceArn CapacityReservationArn
```
------
# Monitorar blocos de capacidade usando o EventBridge
Quando a reserva do bloco de capacidade começa, o Amazon EC2 emite um evento por meio do EventBridge que indica que a capacidade está pronta para ser usada. Quarenta minutos antes do término da reserva do bloco de capacidade, você recebe outro evento do EventBridge informando que todas as instâncias em execução na reserva começarão a ser encerradas em dez minutos. Para obter mais informações sobre eventos do EventBridge, consulte [Eventos do Amazon EventBridge](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html).
As seguintes estruturas de eventos para eventos emitidos para blocos de capacidade:
**Bloco de capacidade fornecido**
O exemplo a seguir mostra um evento para o bloco de capacidade fornecido.
```
{
"customer_event_id": "[Capacity Reservation Id]-delivered",
"detail_type": "Capacity Block Reservation Delivered",
"source": "aws.ec2",
"account": "[Customer Account ID]",
"time": "[Current time]",
"resources": [
"[ODCR ARN]"
],
"detail": {
"capacity-reservation-id": "[ODCR ID]",
"end-date": "[ODCR End Date]"
}
}
```
**Aviso de expiração do bloco de capacidade**
O exemplo a seguir mostra um evento para aviso de expiração do bloco de capacidade.
```
{
"customer_event_id": "[Capacity Reservation Id]-approaching-expiry",
"detail_type": "Capacity Block Reservation Expiration Warning",
"source": "aws.ec2",
"account": "[Customer Account ID]",
"time": "[Current time]",
"resources": [
"[ODCR ARN]"
],
"detail": {
"capacity-reservation-id": "[ODCR ID]",
"end-date": "[ODCR End Date]"
}
}
```
**Aviso de interrupção da instância de reserva de capacidade**
O exemplo a seguir mostra um evento para aviso de interrupção da instância de reserva de capacidade do EC2.
```
{
"version": "0",
"id": "12345678-1234-1234-1234-123456789012",
"detail_type": "EC2 Capacity Reservation Instance Interruption Warning",
"source": "aws.ec2",
"account": "[Customer Account ID]",
"time": "[Current time]",
"region": "[Region]",
"resources": [
"[Instance ARN]"
],
"detail": {
"instance-id": "[Instance ID]",
"instance-action": "terminate",
"instance-termination-time": "[Current time]",
"availability-zone-id": "[Availability Zone ID]",
"instance-lifecycle": "capacity-block"
}
}
```
# Registrar em log chamadas de API de blocos de capacidade com o AWS CloudTrail
Os blocos de capacidade são integrados ao AWS CloudTrail, um serviço que fornece um registro das ações realizadas por um usuário, um perfil ou um serviço da AWS em blocos de capacidade. O CloudTrail captura chamadas de API para blocos de capacidade como eventos. As chamadas capturadas incluem chamadas do console de blocos de capacidade e chamadas de código para as operações de API de blocos de capacidade. Se você criar uma trilha, poderá habilitar a entrega contínua de eventos do CloudTrail a um bucket do Amazon S3, incluindo eventos para blocos de capacidade. Se você não configurar uma trilha, ainda poderá visualizar os eventos mais recentes no console do CloudTrail no **Histórico de eventos**. Com as informações coletadas pelo CloudTrail, você pode determinar a solicitação que foi feita para os blocos de capacidade, o endereço IP do qual a solicitação foi feita, quem fez a solicitação, quando ela foi feita e outros detalhes.
Para saber mais sobre o CloudTrail, consulte o [Guia do usuário do AWS CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-user-guide.html).
## Informações sobre blocos de capacidade no CloudTrail
O CloudTrail é habilitado em sua Conta da AWS quando ela é criada. Quando ocorre alguma atividade nos blocos de capacidade, essa atividade é registrada em um evento do CloudTrail junto com outros eventos de serviço da AWS em **Histórico de eventos**. Você pode visualizar, pesquisar e baixar eventos recentes em sua Conta da AWS. Para saber mais, consulte [Como visualizar eventos com o histórico de eventos do CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html).
Para ter um registro contínuo de eventos na Conta da AWS, incluindo os para blocos de capacidade, crie uma trilha. Uma *trilha* permite que o CloudTrail entregue arquivos de log a um bucket do Amazon S3. Por padrão, quando você cria uma trilha no console, ela é aplicada a todas as Regiões da AWS. A trilha registra eventos de todas as regiões na partição da AWS e entrega os arquivos de log no bucket do Amazon S3 que você especifica. Além disso, é possível configurar outros AWS serviços para melhor analisar e agir de acordo com dados coletados do evento nos logs CloudTrail. Para saber mais, consulte:
+ [Visão geral da criação de uma trilha](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html)
+ [Serviços e integrações compatíveis com o CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-aws-service-specific-topics.html)
+ [Configuração notificações do Amazon SNS para o CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/configure-sns-notifications-for-cloudtrail.html)
+ [Como receber arquivos de log do CloudTrail de várias regiões](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/receive-cloudtrail-log-files-from-multiple-regions.html) e [Como receber arquivos de log do CloudTrail de várias contas](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-receive-logs-from-multiple-accounts.html)
Todas os blocos de capacidade são registrados em log pelo CloudTrail e são documentados na Amazon EC2 API Reference. Por exemplo, as chamadas para as ações `CapacityBlockScheduled` e `CapacityBlockActive` geram entradas nos arquivos de log do CloudTrail.
Cada entrada de log ou evento contém informações sobre quem gerou a solicitação. As informações de identidade ajudam a determinar:
+ Se a solicitação foi feita com credenciais de usuário-raiz ou usuário do AWS Identity and Access Management (IAM).
+ Se a solicitação foi feita com credenciais de segurança temporárias de um perfil ou de um usuário federado.
+ Se a solicitação foi feita por outro serviço da AWS.
Para saber mais, consulte [Elemento userIdentity do CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html).
## Entender as entradas nos arquivos de log de capacidade
Uma trilha é uma configuração que permite a entrega de eventos como arquivos de log a um bucket Amazon S3 especificado. Os arquivos de log do CloudTrail contêm uma ou mais entradas de log. Um evento representa uma única solicitação de qualquer fonte, e inclui informações sobre a ação solicitada, data e hora da ação, parâmetros da solicitação e assim por diante. Os arquivos de log do CloudTrail não são um rastreamento de pilha ordenada de chamadas de API pública, portanto, não são exibidos em uma ordem específica.
Os seguintes exemplos mostram entradas no log do CloudTrail para:
+ [TerminateCapacityBlocksInstances](#understanding-capacity-blocks-entries-terminatecapacityblockinstances)
+ [CapacityBlockPaymentFailed](#understanding-capacity-blocks-entries-capacityblockpaymentfailed)
+ [CapacityBlockScheduled](#understanding-capacity-blocks-entries-capacityblockscheduled)
+ [CapacityBlockActive](#understanding-capacity-blocks-entries-capacityblockactive)
+ [CapacityBlockFailed](#understanding-capacity-blocks-entries-capacityblockfailed)
+ [CapacityBlockExpired](#understanding-capacity-blocks-entries-capacityblockexpired)
**nota**
Alguns campos foram ocultados nos exemplos por questão de privacidade dos dados.
### TerminateCapacityBlocksInstances
```
{
"eventVersion": "1.05",
"userIdentity": {
"accountId": "123456789012",
"invokedBy": "AWS Internal;"
},
"eventTime": "2023-10-02T00:06:08Z",
"eventSource": "ec2.amazonaws.com",
"eventName": "TerminateCapacityBlockInstances",
"awsRegion": "us-east-1",
"sourceIPAddress": "203.0.113.25",
"userAgent": "aws-cli/1.15.61 Python/2.7.10 Darwin/16.7.0 botocore/1.10.60",
"requestParameters": null,
"responseElements": null,
"eventID": "a1b2c3d4-EXAMPLE",
"readOnly": false,
"resources": [
{
"accountId": "123456789012",
"type": "AWS::EC2::Instance",
"ARN": "arn:aws:ec2:us-east-1:123456789012:instance/i-1234567890abcdef0"
}
{
"accountId": "123456789012",
"type": "AWS::EC2::Instance",
"ARN": "arn:aws:ec2:us-east-1:123456789012:instance/i-0598c7d356eba48d7"
}
],
"eventType": "AwsServiceEvent",
"recipientAccountId": "123456789012",
"serviceEventDetails": {
"capacityReservationId": "cr-12345678",
}
}
```
### CapacityBlockPaymentFailed
```
{
"eventVersion": "1.05",
"userIdentity": {
"accountId": "123456789012",
"invokedBy": "AWS Internal;"
},
"eventTime": "2023-10-02T00:06:08Z",
"eventSource": "ec2.amazonaws.com",
"eventName": "CapacityBlockPaymentFailed",
"awsRegion": "us-east-1",
"sourceIPAddress": "203.0.113.25",
"userAgent": "aws-cli/1.15.61 Python/2.7.10 Darwin/16.7.0 botocore/1.10.60",
"requestParameters": null,
"responseElements": null,
"eventID": "a1b2c3d4-EXAMPLE",
"readOnly": false,
"resources": [
{
"ARN": "arn:aws:ec2:us-east-1:123456789012:capacity-reservation/cr-12345678",
"accountId": "123456789012",
"type": "AWS::EC2::CapacityReservation"
}
],
"eventType": "AwsServiceEvent",
"recipientAccountId": "123456789012",
"serviceEventDetails": {
"capacityReservationId": "cr-12345678",
"capacityReservationState": "payment-failed"
}
}
```
### CapacityBlockScheduled
```
{
"eventVersion": "1.05",
"userIdentity": {
"accountId": "123456789012",
"invokedBy": "AWS Internal;"
},
"eventTime": "2023-10-02T00:06:08Z",
"eventSource": "ec2.amazonaws.com",
"eventName": "CapacityBlockScheduled",
"awsRegion": "us-east-1",
"sourceIPAddress": "203.0.113.25",
"userAgent": "aws-cli/1.15.61 Python/2.7.10 Darwin/16.7.0 botocore/1.10.60",
"requestParameters": null,
"responseElements": null,
"eventID": "a1b2c3d4-EXAMPLE",
"readOnly": false,
"resources": [
{
"ARN": "arn:aws:ec2:us-east-1:123456789012:capacity-reservation/cr-12345678",
"accountId": "123456789012",
"type": "AWS::EC2::CapacityReservation"
}
],
"eventType": "AwsServiceEvent",
"recipientAccountId": "123456789012",
"serviceEventDetails": {
"capacityReservationId": "cr-12345678",
"capacityReservationState": "scheduled"
}
}
```
### CapacityBlockActive
```
{
"eventVersion": "1.05",
"userIdentity": {
"accountId": "123456789012",
"invokedBy": "AWS Internal;"
},
"eventTime": "2023-10-02T00:06:08Z",
"eventSource": "ec2.amazonaws.com",
"eventName": "CapacityBlockActive",
"awsRegion": "us-east-1",
"sourceIPAddress": "203.0.113.25",
"userAgent": "aws-cli/1.15.61 Python/2.7.10 Darwin/16.7.0 botocore/1.10.60",
"requestParameters": null,
"responseElements": null,
"eventID": "a1b2c3d4-EXAMPLE",
"readOnly": false,
"resources": [
{
"ARN": "arn:aws:ec2:us-east-1:123456789012:capacity-reservation/cr-12345678",
"accountId": "123456789012",
"type": "AWS::EC2::CapacityReservation"
}
],
"eventType": "AwsServiceEvent",
"recipientAccountId": "123456789012",
"serviceEventDetails": {
"capacityReservationId": "cr-12345678",
"capacityReservationState": "active"
}
}
```
### CapacityBlockFailed
```
{
"eventVersion": "1.05",
"userIdentity": {
"accountId": "123456789012",
"invokedBy": "AWS Internal;"
},
"eventTime": "2023-10-02T00:06:08Z",
"eventSource": "ec2.amazonaws.com",
"eventName": "CapacityBlockFailed",
"awsRegion": "us-east-1",
"sourceIPAddress": "203.0.113.25",
"userAgent": "aws-cli/1.15.61 Python/2.7.10 Darwin/16.7.0 botocore/1.10.60",
"requestParameters": null,
"responseElements": null,
"eventID": "a1b2c3d4-EXAMPLE",
"readOnly": false,
"resources": [
{
"ARN": "arn:aws:ec2:us-east-1:123456789012:capacity-reservation/cr-12345678",
"accountId": "123456789012",
"type": "AWS::EC2::CapacityReservation"
}
],
"eventType": "AwsServiceEvent",
"recipientAccountId": "123456789012",
"serviceEventDetails": {
"capacityReservationId": "cr-12345678",
"capacityReservationState": "failed"
}
}
```
### CapacityBlockExpired
```
{
"eventVersion": "1.05",
"userIdentity": {
"accountId": "123456789012",
"invokedBy": "AWS Internal;"
},
"eventTime": "2023-10-02T00:06:08Z",
"eventSource": "ec2.amazonaws.com",
"eventName": "CapacityBlockExpired",
"awsRegion": "us-east-1",
"sourceIPAddress": "203.0.113.25",
"userAgent": "aws-cli/1.15.61 Python/2.7.10 Darwin/16.7.0 botocore/1.10.60",
"requestParameters": null,
"responseElements": null,
"eventID": "a1b2c3d4-EXAMPLE",
"readOnly": false,
"resources": [
{
"ARN": "arn:aws:ec2:us-east-1:123456789012:capacity-reservation/cr-12345678",
"accountId": "123456789012",
"type": "AWS::EC2::CapacityReservation"
}
],
"eventType": "AwsServiceEvent",
"recipientAccountId": "123456789012",
"serviceEventDetails": {
"capacityReservationId": "cr-12345678",
"capacityReservationState": "expired"
}
}
```