# Gerenciar reservas
Visualize e gerencie suas reservas de capacidade na página **Reservas de capacidade**. Você pode realizar tarefas de gerenciamento, como adicionar ou reduzir DPUs, modificar atribuições de grupos de trabalho e etiquetar ou cancelar reservas.
**Para visualizar e gerenciar reservas de capacidade**
1. Abra o console do Athena em [https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home).
1. Se o painel de navegação do console não estiver visível, escolha o menu de expansão à esquerda.
1. Escolha **Administração**, **Reservas de capacidade**.
1. Na página de reserva de capacidade, é possível realizar estas tarefas:
+ Para criar uma reserva de capacidade, escolha **Criar reserva de capacidade**.
+ Use a caixa de pesquisa para filtrar reservas por nome ou número de DPUs.
+ Escolha o menu suspenso de status para filtrar por status de reserva de capacidade (por exemplo, **Ativa** ou **Cancelada**). Para obter informações sobre status de reservas, consulte [Noções básicas de status de reserva](#capacity-management-understanding-reservation-status).
+ Para visualizar os detalhes de uma reserva de capacidade, escolha o link da reserva. A página de detalhes da reserva contém opções para [editar a capacidade](capacity-management-editing-capacity-reservations.md), [adicionar grupos de trabalho](capacity-management-adding-workgroups-to-a-reservation.md), [remover grupos de trabalho](capacity-management-removing-a-workgroup-from-a-reservation.md) e [cancelar](capacity-management-cancelling-a-capacity-reservation.md) a reserva.
+ Para editar uma reserva (por exemplo, adicionar ou remover DPUs), selecione o botão da reserva e escolha **Editar**.
+ Para cancelar uma reserva, selecione o botão da reserva e escolha **Cancelar**.
## Noções básicas de status de reserva
A tabela a seguir descreve os possíveis valores de status de uma reserva de capacidade.
****
| Status | Descrição |
| --- | --- |
| Pendente | O Athena está processando sua solicitação de capacidade. A capacidade não está pronta para executar consultas. |
| Ativo | A capacidade está disponível para executar consultas. |
| Failed | A solicitação de capacidade não foi concluída com êxito. O cumprimento das solicitações de capacidade não é garantido. As reservas com falha contam para os limites de DPU da conta. Para liberar o uso, é necessário cancelar a reserva. |
| Atualização pendente | O Athena está processando uma alteração na reserva. Por exemplo, esse status ocorre depois que você edita a reserva para adicionar ou remover DPUs. |
| Cancelando | O Athena está processando uma solicitação para cancelar a reserva. As consultas que ainda estiverem em execução nos grupos de trabalho que estavam usando a reserva poderão ser concluídas, mas outras consultas do grupo de trabalho usarão capacidade sob demanda (não provisionada). |
| Cancelado | O cancelamento da reserva de capacidade foi concluído. As reservas canceladas permanecerão no console por 45 dias. Após 45 dias, o Athena excluirá a reserva. Durante os 45 dias, não será possível reaproveitar ou reutilizar a reserva, mas você poderá consultar as etiquetas e visualizar os detalhes para referência histórica. Não é garantido que a capacidade cancelada será reservada novamente em uma data futura. A capacidade não pode ser transferida para outra reserva, Conta da AWS ou Região da AWS. |
## Noções básicas de DPUs ativas e DPUs de destino
Na lista de reservas de capacidade no console Athena, a reserva exibe dois valores de DPU: **DPU ativa** e **DPU de destino**.
+ **DPU ativa**: o número de DPUs que estão disponíveis na reserva para executar consultas. Por exemplo, se você solicitar 100 DPUs e a solicitação for atendida, a **DPU ativa** exibirá **100**.
+ **DPU de destino**: o número de DPUs para as quais a reserva está sendo transferida. A **DPU de destino** exibe um valor diferente da **DPU ativa** quando uma reserva está sendo criada ou há um aumento ou uma diminuição no número de DPUs pendente.
Por exemplo, depois que você enviar uma solicitação para criar uma reserva com 24 DPUs, o **Status** da reserva será **Pendente**, a **DPU ativa** será **0** e a **DPU de destino** será **24**.
Se você tiver uma reserva com 100 DPUs e editar a reserva para solicitar um aumento de 20 DPUs, o **Status** será **Atualização pendente**, a **DPU ativa** será **100** e a **DPU de destino** será **120**.
Se você tiver uma reserva com 100 DPUs e editar a reserva para solicitar uma redução de 20 DPUs, o **Status** será **Atualização pendente**, a **DPU ativa** será **100** e a **DPU de destino** será **80**.
Durante essas transições, o Athena trabalha ativamente para adquirir ou reduzir o número de DPUs com base na solicitação. Quando a **DPU ativa** torna-se igual à **DPU de destino**, o número de destino foi atingido e não há alterações pendentes.
Para recuperar esses valores de forma programática, você pode chamar a ação da API [GetCapacityReservation](https://docs.aws.amazon.com/athena/latest/APIReference/API_GetCapacityReservation.html). A API refere-se à **DPU ativa** e à **DPU de destino** como `AllocatedDpus` e `TargetDpus`.
**Topics**
+ [Noções básicas de status de reserva](#capacity-management-understanding-reservation-status)
+ [Noções básicas de DPUs ativas e DPUs de destino](#capacity-management-understanding-dpu-status)
+ [Editar reservas de capacidade](capacity-management-editing-capacity-reservations.md)
+ [Adicionar grupos de trabalho a uma reserva](capacity-management-adding-workgroups-to-a-reservation.md)
+ [Remover um grupo de trabalho de uma reserva](capacity-management-removing-a-workgroup-from-a-reservation.md)
+ [Cancelar uma reserva de capacidade](capacity-management-cancelling-a-capacity-reservation.md)
+ [Excluir uma reserva de capacidade](capacity-management-deleting-a-capacity-reservation.md)
# Editar reservas de capacidade
Após criar uma reserva de capacidade, você pode ajustar o número de DPUs e adicionar ou remover as etiquetas personalizadas.
**Para editar uma reserva de capacidade**
1. Abra o console do Athena em [https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home).
1. Se o painel de navegação do console não estiver visível, escolha o menu de expansão à esquerda.
1. Escolha **Administração**, **Reservas de capacidade**.
1. Na lista de reservas de capacidade, siga um destes procedimentos:
+ Selecione o botão ao lado da reserva e escolha **Editar**.
+ Escolha o link da reserva e depois **Editar**.
1. Em **DPU**, escolha ou insira o número de unidades de processamento de dados desejada. Para obter mais informações, consulte [Noções básicas de DPUs](capacity-management.md#capacity-management-understanding-dpus).
**nota**
Você pode solicitar a adição de DPUs a uma reserva de capacidade ativa a qualquer momento.
Você pode solicitar a redução das DPUs de uma reserva de capacidade ativa quando tiver decorrido 1 minuto desde que a reserva se tornou ativa ou desde que as DPUs foram adicionadas pela última vez.
Quando você solicita a redução de DPUs, o Athena prioriza a remoção de DPUs ociosas em vez de DPUs ativas. Se as consultas estiverem consumindo DPUs marcadas para remoção, o Athena aguarda a conclusão das consultas antes de remover as DPUs.
1. Em **Etiquetas**, selecione **Remover** para remover uma etiqueta ou escolha **Adicionar etiqueta** para adicionar uma nova etiqueta.
1. Selecione **Enviar**. A página de detalhes da reserva mostra a configuração atualizada.
# Adicionar grupos de trabalho a uma reserva
Depois de criar uma reserva de capacidade, é possível adicionar até 20 grupos de trabalho à reserva. Adicionar um grupo de trabalho a uma reserva informa ao Athena quais consultas deverão ser executadas na capacidade reservada. As consultas de grupos de trabalho que não estão associados a uma reserva continuam sendo executadas usando o modelo de preço padrão por terabyte (TB) verificado.
Quando uma reserva tem dois ou mais grupos de trabalho, as consultas desses grupos de trabalho podem usar a capacidade da reserva. É possível adicionar e remover grupos de trabalho a qualquer momento. Quando você adicionar ou remover grupos de trabalho, as consultas em execução não serão interrompidas.
Quando a reserva está pendente, as consultas dos grupos de trabalho que você adicionou continuam sendo executadas usando o modelo de preço padrão por terabyte (TB) verificado até que a reserva torne-se ativa.
**Para adicionar um ou mais grupos de trabalho à reserva de capacidade**
1. Na página de detalhes da reserva de capacidade, escolha **Adicionar grupos de trabalho**.
1. Na página **Adicionar grupos de trabalho**, selecione os grupos de trabalho que deseja adicionar e escolha **Adicionar grupos de trabalho**. Não é possível atribuir um grupo de trabalho a mais de uma reserva.
A página de detalhes da reserva de capacidade lista os grupos de trabalho que você adicionou. As consultas executadas nesses grupos de trabalho usarão a capacidade que você reservou quando a reserva estiver ativa.
# Remover um grupo de trabalho de uma reserva
Caso não precise mais de capacidade dedicada para um grupo de trabalho ou se quiser mover um grupo de trabalho para sua própria reserva, poderá removê-lo a qualquer momento. A remoção de um grupo de trabalho de uma reserva é um processo simples. Depois de remover um grupo de trabalho de uma reserva, as consultas do grupo de trabalho removido usam como padrão a capacidade sob demanda e são faturadas com base nos terabytes (TB) verificados.
**Para remover um ou mais grupos de trabalho de uma reserva**
1. Na página de detalhes da reserva de capacidade, selecione os grupos de trabalho que deseja remover.
1. Escolha **Remover grupos de trabalho**. O prompt **Remover grupos de trabalho?** informa que todas as consultas ativas no momento serão concluídas antes que o grupo de trabalho seja removido da reserva.
1. Escolha **Remover**. A página de detalhes da reserva de capacidade mostra que os grupos de trabalho removidos não estão mais presentes.
# Cancelar uma reserva de capacidade
Caso não queira mais usar uma reserva de capacidade, você pode cancelá-la. As consultas que ainda estiverem em execução nos grupos de trabalho que estavam usando a reserva poderão ser concluídas, mas outras consultas do grupo de trabalho não usarão mais a reserva.
**nota**
Não é garantido que a capacidade cancelada será reservada novamente em uma data futura. A capacidade não pode ser transferida para outra reserva, Conta da AWS ou Região da AWS.
**Para cancelar uma reserva de capacidade**
1. Abra o console do Athena em [https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home).
1. Se o painel de navegação do console não estiver visível, escolha o menu de expansão à esquerda.
1. Escolha **Administração**, **Reservas de capacidade**.
1. Na lista de reservas de capacidade, siga um destes procedimentos:
+ Selecione o botão ao lado da reserva e escolha **Cancelar**.
+ Escolha o link da reserva e escolha **Cancelar reserva de capacidade**.
1. No prompt **Cancelar reserva de capacidade?**, insira **cancel** e escolha **Cancelar reserva de capacidade**.
O status da reserva é alterado para **Cancelando** e um banner de progresso informa que o cancelamento está em andamento.
Quando o cancelamento for concluído, a reserva de capacidade permanecerá, mas o status será exibido como **Cancelada**. A reserva será excluída 45 dias após o cancelamento. Durante os 45 dias, não será possível reaproveitar ou reutilizar a reserva que foi cancelada, mas você poderá consultar as etiquetas e visualizá-la para referência histórica.
# Excluir uma reserva de capacidade
Se você quiser remover todas as referências a uma reserva de capacidade cancelada, poderá excluir a reserva. Uma reserva deve ser cancelada para poder ser excluída. Uma reserva excluída é imediatamente removida da conta e não pode mais ser referenciada, nem por seu ARN.
**Para excluir uma reserva de capacidade**
1. Abra o console do Athena em [https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home).
1. Se o painel de navegação do console não estiver visível, escolha o menu de expansão à esquerda.
1. Escolha **Administração**, **Reservas de capacidade**.
1. Na lista de reservas de capacidade, siga um destes procedimentos:
+ Selecione o botão ao lado da reserva e escolha **Ações**, **Excluir**.
+ Escolha o link da reserva e depois **Excluir**.
1. No prompt **Excluir reserva de capacidade?**, escolha **Excluir**.
Um banner informa que a reserva de capacidade foi excluída com sucesso. A reserva excluída não aparece mais na lista de reservas de capacidade.