Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Gestion des réserves
<a name="capacity-management-managing-reservations"></a>

Vous pouvez consulter et gérer vos réserves de capacité sur la page **Réserves de capacité**. Vous pouvez effectuer des tâches de gestion telles que l'ajout ou la réduction des DPU, la modification des attributions des groupes de travail et le balisage ou l'annulation de réserves.

**Pour consulter et gérer des réserves de capacité**

1. Ouvrez la console à l'adresse [https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home).

1. Si le panneau de navigation de la console n'est pas visible, choisissez le menu d'extension sur la gauche.

1. Choisissez **Administration**, **Réserves de capacité**.

1. Vous pouvez effectuer les tâches suivantes sur la page des réserves de capacité :
   + Pour créer une réserve de capacité, sélectionnez **Créer une réserve de capacité**.
   + Utilisez le champ de recherche pour filtrer les réserves par nom ou par nombre de DPU.
   + Choisissez le menu déroulant d'état pour filtrer par état de réserve de capacité (par exemple, **Actif** ou **Annulé**). Pour de plus amples informations sur l'état des réserves, consultez [Présentation de l’état des réserves](#capacity-management-understanding-reservation-status).
   + Pour consulter les détails d'une réserve de capacité, cliquez sur le lien correspondant à la réserve. La page de détails de la réserve inclut des options relatives à la [modification de la capacité](capacity-management-editing-capacity-reservations.md), à l’[ajout de groupes de travail](capacity-management-adding-workgroups-to-a-reservation.md), à la [suppression de groupes de travail](capacity-management-removing-a-workgroup-from-a-reservation.md) et à l’[annulation](capacity-management-cancelling-a-capacity-reservation.md) de la réserve.
   + Pour modifier une réserve (par exemple, en ajoutant ou en supprimant des DPU), sélectionnez le bouton correspondant à la réserve, puis choisissez **Modifier**.
   + Pour annuler une réserve, sélectionnez le bouton correspondant à la réserve, puis cliquez sur **Annuler**.

## Présentation de l’état des réserves
<a name="capacity-management-understanding-reservation-status"></a>

Le tableau suivant décrit les valeurs d'état possibles pour une réserve de capacité.



| État | Description | 
| --- | --- | 
| En suspens | Athena est en train de traiter votre demande de capacité. La capacité n'est pas prête à exécuter des requêtes. | 
| Actif | La capacité est disponible pour exécuter des requêtes. | 
| Échec | Votre demande de capacité n'a pas été traitée avec succès. Notez que le traitement des demandes de capacité n'est pas garanti. Les réserves qui ont échoué sont prises en compte dans le calcul des limites de DPU de votre compte. Pour libérer l'utilisation, vous devez annuler la réserve. | 
| Mise à jour en attente | Athena est en train de modifier la réserve. Par exemple, cet état apparaît une fois que vous avez modifié la réserve pour ajouter ou supprimer des DPU. | 
| Annulation | Athena est en train de traiter une demande d'annulation de réserve. Les requêtes toujours en cours d'exécution dans les groupes de travail qui utilisaient la réserve sont autorisées à se terminer, mais les autres requêtes du groupe de travail utiliseront la capacité à la demande (non allouée). | 
| Annulée | L'annulation de la réserve de capacité est terminée. Les réserves annulées restent dans la console pendant 45 jours. Après 45 jours, Athena annulera la réserve. Pendant les 45 jours, vous ne pouvez pas réaffecter ou réutiliser la réserve, mais vous pouvez vous référer à ses balises et consulter ses détails pour une référence historique.<br />Il n'est pas garanti que la capacité annulée puisse être réservée à nouveau à une date future. La capacité ne peut pas être transférée à une autre réservation, Compte AWS ou Région AWS.  | 

## Présentation des DPU actives et des DPU cibles
<a name="capacity-management-understanding-dpu-status"></a>

Dans la liste des réserves de capacité de la console Athena, votre réserve affiche deux valeurs DPU : **DPU active** et **DPU cible**.
+ **DPU active** : nombre de DPU disponibles dans votre réserve pour exécuter des requêtes. Par exemple, si vous demandez 100 DPU et que votre demande est satisfaite, **DPU active** affiche **100**.
+ **DPU cible** : nombre de DPU vers lesquelles votre réserve est en cours de déplacement. **DPU cible** affiche une valeur différente de celle de **DPU active** lorsqu'une réserve est créée ou lorsqu'une augmentation ou une diminution du nombre de DPU est en attente.

Par exemple, après avoir soumis une demande de création d'une réserve comprenant 24 DPU, l'**état** de la réserve sera **En attente**, **DPU active** sera **0** et **DPU cible** sera **24**.

Si vous avez une réserve comprenant 100 DPU et que vous modifiez celle-ci pour demander une augmentation de 20 DPU, l'**état** sera **Mise à jour en attente**, **DPU active** sera de **100** et **DPU cible** de **120**.

Si vous avez une réserve comprenant 100 DPU et que vous modifiez celle-ci pour demander une diminution de 20 DPU, l'**état** sera **Mise à jour en attente**, **DPU active** sera de **100** et **DPU cible** de **80**.

Au cours de ces transitions, Athena travaille activement à l'acquisition ou à la réduction du nombre de DPU en fonction de votre demande. Lorsque **DPU active** devient égal à **DPU cible**, le nombre cible est atteint et aucune modification n'est en attente.

Pour récupérer ces valeurs par programmation, vous pouvez appeler l'action [GetCapacityReservation](https://docs.aws.amazon.com/athena/latest/APIReference/API_GetCapacityReservation.html)API. L'API fait référence à **DPU active** et **DPU cible** sous `AllocatedDpus` et `TargetDpus`.

**Topics**
+ [Présentation de l’état des réserves](#capacity-management-understanding-reservation-status)
+ [Présentation des DPU actives et des DPU cibles](#capacity-management-understanding-dpu-status)
+ [Modification des réserves de capacité](capacity-management-editing-capacity-reservations.md)
+ [Ajout de groupes de travail à une réserve](capacity-management-adding-workgroups-to-a-reservation.md)
+ [Suppression d’un groupe de travail d’une réserve](capacity-management-removing-a-workgroup-from-a-reservation.md)
+ [Annulation d’une réserve de capacité](capacity-management-cancelling-a-capacity-reservation.md)
+ [Suppression d’une réserve de capacité](capacity-management-deleting-a-capacity-reservation.md)