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
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 DPUs, la modification des attributions des groupes de travail et le balisage ou l'annulation de réservations.
**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éservations par nom ou par numéro de DPUs.
+ 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éservation (par exemple, en ajoutant ou en supprimant DPUs), sélectionnez le bouton correspondant à la réservation, 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
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, ce statut apparaît une fois que vous avez modifié la réservation pour l'ajouter ou la supprimer DPUs. |
| 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. 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. |
## Comprendre Active DPUs et Target DPUs
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 actif** : le nombre de DPUs DPU disponibles dans votre réservation pour exécuter des requêtes. Par exemple, si vous demandez 100 DPUs et que votre demande est satisfaite, **Active DPU** affiche **100**.
+ **DPU cible** : numéro vers DPUs lequel votre réservation est en train d'être transférée. **Le DPU cible** affiche une valeur différente de celle du **DPU actif** lorsqu'une réservation est créée ou lorsqu'une augmentation ou une diminution du nombre de réservations DPUs est en attente.
**Par exemple, après avoir soumis une demande pour créer une réservation avec 24 DPUs, le **statut** de la réservation sera **En attente**, le **DPU actif** sera **0** et le **DPU cible** sera 24.**
**Si vous avez une réservation de 100 DPUs et que vous modifiez votre réservation pour demander une augmentation de 20 DPUs, le **statut** sera **En attente de mise à jour**, le **DPU actif** sera de **100** et le **DPU cible** de 120.**
**Si vous avez une réservation de 100 DPUs et que vous modifiez votre réservation pour demander une réduction de 20 DPUs, le **statut** sera **En attente de mise à jour**, le **DPU actif** sera de **100** et le **DPU cible** de 80.**
Au cours de ces transitions, Athena travaille activement à acquérir ou à réduire le nombre de en DPUs 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)
+ [Comprendre Active DPUs et Target DPUs](#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)
# Modification des réserves de capacité
Après avoir créé une réservation de capacité, vous pouvez ajuster son nombre DPUs et ajouter ou supprimer ses balises personnalisées.
**Pour modifier une réserve 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. Dans la liste des réserves de capacité, effectuez l'une des opérations suivantes :
+ Sélectionner le bouton en regard de la réserve, puis choisir **Modifier**.
+ Choisir le lien de la réserve, puis choisir **Modifier**.
1. Pour **DPU**, choisissez ou entrez le nombre d'unités de traitement de données que vous souhaitez. Pour de plus amples informations, veuillez consulter [Comprendre DPUs](capacity-management.md#capacity-management-understanding-dpus).
**Note**
Vous pouvez demander à ajouter DPUs à une réservation de capacité active à tout moment.
Vous pouvez demander la réduction d'une réservation DPUs de capacité active lorsqu'une minute s'est écoulée depuis que la réservation est devenue active ou quand elle a DPUs été ajoutée pour la dernière fois.
Lorsque vous demandez une réduction DPUs, Athena donne la priorité à la suppression des périodes d'inactivité par rapport à celles d'activité. DPUs DPUs Si les requêtes marquées pour suppression sont gourmandes, Athena attend DPUs qu'elles soient terminées avant de supprimer le. DPUs
1. (Facultatif) Dans **Balises**, choisissez **Supprimer la balise** pour supprimer une balise ou **Ajouter une balise** pour ajouter une nouvelle balise.
1. Sélectionnez **Soumettre**. La page de détails de la réserve affiche la configuration mise à jour.
# Ajout de groupes de travail à une réserve
Après avoir créé une réserve de capacité, vous pouvez ajouter jusqu'à 20 groupes de travail à la réserve. L'ajout d'un groupe de travail à une réserve indique à Athena quelles requêtes doivent être exécutées sur la capacité réservée. Les requêtes provenant de groupes de travail qui ne sont pas associées à une réserve continuent d'être exécutées selon le modèle de tarification par téraoctet (To) analysé par défaut.
Lorsqu'une réserve comporte deux groupes de travail ou plus, les requêtes provenant de ces groupes de travail peuvent utiliser la capacité de la réserve. Vous pouvez ajouter et supprimer des groupes de travail à tout moment. Lorsque vous ajoutez ou supprimez des groupes de travail, les requêtes en cours d'exécution ne sont pas interrompues.
Lorsque votre réserve est en attente, les requêtes provenant des groupes de travail que vous avez ajoutés continuent de s'exécuter en utilisant le modèle de tarification par téraoctet (To) analysé par défaut jusqu'à ce que la réserve soit active.
**Pour ajouter un ou plusieurs groupes de travail à votre réserve de capacité**
1. Sur la page de détails de la réserve de capacité, choisissez **Ajouter des groupes de travail**.
1. Sur la page **Ajouter des groupes de travail**, sélectionnez les groupes de travail que vous souhaitez ajouter, puis choisissez **Ajouter des groupes de travail**. Vous pouvez attribuer un groupe de travail à plusieurs réserves.
La page de détails de votre réserve de capacité répertorie les groupes de travail que vous avez ajoutés. Les requêtes exécutées dans ces groupes de travail utiliseront la capacité que vous avez réservée lorsque la réserve est active.
# Suppression d’un groupe de travail d’une réserve
Si vous n'avez plus besoin de capacité dédiée pour un groupe de travail ou si vous souhaitez déplacer un groupe de travail vers sa propre réserve, vous pouvez le supprimer à tout moment. La suppression d'un groupe de travail d'une réserve est un processus simple. Une fois que vous avez retiré un groupe de travail d'une réservation, les requêtes du groupe de travail supprimé utilisent à nouveau la capacité à la demande et sont facturées sur la base des téraoctets (To) analysés.
**Pour supprimer un ou plusieurs groupes de travail d'une réserve**
1. Sur la page de détails de la réserve de capacité, sélectionnez les groupes de travail que vous souhaitez supprimer.
1. Choisissez **Supprimer les groupes de travail**. L'invite **Supprimer les groupes de travail ?** vous informe que toutes les requêtes actuellement actives seront terminées avant que le groupe de travail ne soit supprimé de la réserve.
1. Cliquez sur **Supprimer**. La page de détails de votre réserve de capacité indique que les groupes de travail supprimés ne sont plus présents.
# Annulation d’une réserve de capacité
Si vous ne souhaitez plus utiliser la réserve de capacité, vous pouvez l'annuler. Les requêtes toujours en cours d'exécution dans les groupes de travail qui utilisaient la réserve seront autorisées à se terminer, mais les autres requêtes du groupe de travail n'utiliseront plus la réserve.
**Note**
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.
**Pour annuler une réserve 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. Dans la liste des réserves de capacité, effectuez l'une des opérations suivantes :
+ Sélectionner le bouton en regard de la réserve, puis choisir **Annuler**.
+ Choisir le lien de réserve, puis choisir **Annuler la réserve de capacité**.
1. À l'invite **Annuler la réserve de capacité ?**, saisissez **Annuler**, puis choisissez **Annuler la réserve de capacité**.
L'état de la réserve passe à **Annulation**, et une bannière de progression vous informe que l'annulation est en cours.
Lorsque l'annulation est terminée, la réserve de capacité est maintenue, mais son état est **Annulé**. La réserve sera supprimée 45 jours après l'annulation. Pendant les 45 jours, vous ne pouvez pas réaffecter ou réutiliser la réserve annulée, mais vous pouvez vous référer à ses balises et consulter ses détails pour une référence historique.
# Suppression d’une réserve de capacité
Si vous souhaitez supprimer toutes les références à une réserve de capacité annulée, vous pouvez supprimer la réserve. La réserve doit être annulée avant de pouvoir être supprimée. Une réserve supprimée est immédiatement supprimée de votre compte et ne peut plus être référencée, y compris par son ARN.
**Pour supprimer une réserve 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. Dans la liste des réserves de capacité, effectuez l'une des opérations suivantes :
+ Sélectionner le bouton en regard de la réserve annulée, puis choisir **Actions**, **Supprimer**.
+ Choisir le lien de la réserve, puis choisir **Supprimer**.
1. À l'invite **Supprimer la réserve de capacité ?**, choisissez **Supprimer**.
Une bannière vous informe que la réserve de capacité a été supprimée avec succès. La réserve supprimée n'apparaît plus dans la liste des réserves de capacité.