# 管理预留
<a name="capacity-management-managing-reservations"></a>

您可以在**容量预留**页面上查看和管理您的容量预留。您可以执行诸多管理任务，例如添加或减少 DPU、修改工作组分配以及标记或取消预留。

**查看和管理容量预留**

1. 从 [https://console.aws.amazon.com/athena/](https://console.amazonaws.cn/athena/home) 打开 Athena 控制台。

1. 如果控制台导航窗格不可见，请选择左侧的扩展菜单。

1. 选择**管理**、**容量预留**。

1. 在容量预留页面上，可以执行以下任务：
   + 要创建容量预留，请选择**创建容量预留**。
   + 使用搜索框按 DPU 的名称或数量筛选预留。
   + 选择状态下拉菜单以按容量预留状态（例如，**活动**或**已取消**）进行筛选。有关预留状态的更多信息，请参阅 [了解预留状态](#capacity-management-understanding-reservation-status)。
   + 要查看容量预留的详细信息，请选择预留链接。预留的详细信息页面包含用于[编辑容量](capacity-management-editing-capacity-reservations.md)、[添加工作组](capacity-management-adding-workgroups-to-a-reservation.md)、[删除工作组](capacity-management-removing-a-workgroup-from-a-reservation.md)和[取消](capacity-management-cancelling-a-capacity-reservation.md)预留的选项。
   + 要编辑预留（例如，通过添加或移除 DPU），请选择预留对应的按钮，然后选择**编辑**。
   + 要取消预订，请选择预留对应的按钮，然后选择**取消**。

## 了解预留状态
<a name="capacity-management-understanding-reservation-status"></a>

下表描述了容量预留的可能状态值。


****  

| Status | 说明 | 
| --- | --- | 
| 待处理 | Athena 正在处理您的容量请求。容量未就绪，无法运行查询。 | 
| 活跃 | 容量可用于运行查询。 | 
| 已失败 | 您的容量请求未成功完成。请注意，无法保证完成容量请求。失败的预留将计入您的账户 DPU 限制。要释放用量，必须取消预留。 | 
| 待更新 | Athena 正在处理预留更改。例如，在编辑预留以添加或删除 DPU 之后，就会出现该状态。 | 
| 正在取消 | Athena 正在处理取消预留请求。允许正在使用预留的工作组中仍在运行的查询完成，但工作组中的其他查询将使用按需（未预置）容量。 | 
| 已取消 |  容量预留取消已完成。已取消预留将在控制台中保留 45 天。45 天后，Athena 将删除该预留。在 45 天内，您不能重新利用或重复使用该预留，但是可以引用其标签并查看其详细信息以供历史参考。 无法保证已取消容量在未来可以重新预留。容量无法转移到另一个预留 Amazon Web Services 账户 或 Amazon Web Services 区域。  | 

## 了解活动 DPU 和目标 DPU
<a name="capacity-management-understanding-dpu-status"></a>

在 Athena 控制台的容量预留列表中，您的预留会显示两个 DPU 值：**活动 DPU** 和**目标 DPU**。
+ **活动 DPU** - 您的预留中可用于运行查询的 DPU 数。例如，如果您请求 100 个 DPU，并且您的请求已完成，则**活动 DPU** 会显示 **100**。
+ **目标 DPU** - 您的预留正在移至的 DPU 数。在创建预留时或者在等待增加或减少 DPU 数时，**目标 DPU** 显示的值与**活动 DPU** 不同。

例如，在您提交创建具有 24 个 DPU 的预留请求后，预留**状态**将为**待处理**，**活动 DPU** 将为 **0**，**目标 DPU** 将为 **24**。

如果您的预留具有 100 个 DPU，并且编辑您的预留以请求增加 20 个 DPU，则**状态**将为**待更新**，**活动 DPU** 将为 **100**，**目标 DPU** 将为 **120**。

如果您的预留具有 100 个 DPU，并且编辑您的预留以请求减少 20 个 DPU，则**状态**将为**待更新**，**活动 DPU** 将为 **100**，**目标 DPU** 将为 **80**。

在此类转换期间，Athena 会根据您的要求主动获取或减少 DPU 数。当**活动 DPU** 等于**目标 DPU** 时，表示已达到目标数字，并且没有待处理的更改。

要以编程的方式检索这些值，可以调用 [GetCapacityReservation](https://docs.amazonaws.cn/athena/latest/APIReference/API_GetCapacityReservation.html) API 操作。API 将**活动 DPU** 和**目标 DPU** 称为 `AllocatedDpus` 和 `TargetDpus`。

**Topics**
+ [了解预留状态](#capacity-management-understanding-reservation-status)
+ [了解活动 DPU 和目标 DPU](#capacity-management-understanding-dpu-status)
+ [编辑容量预留](capacity-management-editing-capacity-reservations.md)
+ [向预留添加工作组](capacity-management-adding-workgroups-to-a-reservation.md)
+ [从预留中移除工作组](capacity-management-removing-a-workgroup-from-a-reservation.md)
+ [取消容量预留](capacity-management-cancelling-a-capacity-reservation.md)
+ [删除容量预留](capacity-management-deleting-a-capacity-reservation.md)