

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.

# Afficher et modifier vos réservations de capacité

Après avoir créé une réservation de capacité, vous pouvez consulter son état et son utilisation à tout moment, et modifier la quantité de capacité qu'elle réserve en fonction de l'évolution de vos besoins. L'affichage d'une réservation indique la capacité réservée et toujours disponible dans chaque zone de disponibilité, ainsi que ses dates de début et de fin, ses informations d'engagement et son état du cycle de vie. La modification d'une réservation modifie le nombre d'instances de base de données réservées dans chaque zone de disponibilité lorsque la réservation est active.

**Topics**
+ [Réservations de capacité d'affichage](#capacity-reservations.viewing)
+ [Modifier une réservation de capacité](#capacity-reservations.modifying)

## Réservations de capacité d'affichage
<a name="capacity-reservations.viewing"></a>

Vous pouvez consulter les réservations de capacité Amazon RDS à l'aide du Console de gestion AWS, le AWS CLI, ou l'API Amazon RDS.

### Console
<a name="capacity-reservations.viewing.console"></a>

**Pour consulter les réservations de capacité**

1. Connectez-vous au Console de gestion AWS et ouvrez la console Amazon RDS à l'adresse [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).

1. Dans le volet de navigation, choisissez **Réservations de capacité**.

1. Sélectionnez une réservation pour voir son état, sa capacité réservée, sa capacité disponible dans chaque zone de disponibilité, ses dates de début et de fin et les informations relatives à ses engagements.  
![Page détaillée de my-reservation : PostgreSQL, db.r7g.large, 2 des 2 unités disponibles dans us-east-1a.](https://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/odcr-reservation-details-rds.png)

### AWS CLI
<a name="capacity-reservations.viewing.cli"></a>

Utilisez le [describe-db-capacity reservations](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-capacity-reservations.html) commande.

Répertoriez toutes les réservations de la région :

```
1. aws rds describe-db-capacity-reservations
```

Décrivez une réservation spécifique, par son nom ou par son identifiant :

```
1. aws rds describe-db-capacity-reservations \
2.     --db-capacity-reservation-identifier {{my-reservation}}
```

La réponse inclut `ReservedCapacityPerAvailabilityZone` (capacité réservée dans chaque zone de disponibilité) et `AvailableCapacityPerAvailabilityZoneList` (capacité non encore utilisée, ventilée par zone de disponibilité), que vous pouvez utiliser pour surveiller l'utilisation et identifier la zone de disponibilité dont la capacité disponible est faible.

### API RDS
<a name="capacity-reservations.viewing.api"></a>

Pour consulter les réservations de capacité à l'aide de l'API Amazon RDS, appelez le [DescribeDBCapacityReservations](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBCapacityReservations.html) opération. Vous pouvez préciser les paramètres facultatifs suivants :
+ `DBCapacityReservationIdentifier` — Le nom du `dbcr-` Identifiant de la réservation de capacité. Si vous ne le spécifiez pas, l'opération renvoie toutes les réservations de capacité de la région.
+ `Filters` — Filtres qui limitent le résultat. Les filtres pris en charge sont `db-capacity-reservation-name`, `state`, `engine`, `db-instance-class`, et `availability-zone`.
+ `MaxRecords` — Le nombre maximum d'enregistrements à renvoyer, de 20 à 100. La valeur par défaut est 100.
+ `Marker` — Le jeton de pagination d'une demande précédente.

## Modifier une réservation de capacité
<a name="capacity-reservations.modifying"></a>

Vous pouvez modifier la capacité réservée d'une réservation, c'est-à-dire le nombre d'instances de base de données réservées dans chaque zone de disponibilité. Vous pouvez également modifier sa date de fin.

Vous ne pouvez modifier une réservation que lorsqu'elle est `active` et n'a pas encore atteint sa date de fin. Une réservation à une date ultérieure ne peut pas être modifiée tant qu'elle se trouve dans le `assessing`, `scheduled`, ou `delayed` état : attendez qu'il soit actif à sa date de début. Réservations dans le `pending`, `expired`, `cancelled`, `failed`, ou `unsupported` l'état ne peut pas être modifié.

Les limites suivantes s'appliquent à une modification de la capacité réservée :
+ Vous ne pouvez pas réduire la capacité en dessous de la capacité déjà utilisée. La nouvelle valeur doit correspondre à la zone de disponibilité qui contient le plus d'instances de bases de données.
+ L'augmentation de la capacité dépend de la capacité disponible et du quota de réservation de capacité de votre compte.
+ Tant qu'une réservation est encore dans la limite de sa durée d'engagement, vous ne pouvez pas réduire sa capacité en dessous de la capacité engagée et vous ne pouvez pas fixer de date de fin antérieure à la date de fin de l'engagement. Pour une réservation qui était `delayed`, la limite de capacité s'applique jusqu'à la date de fin de l'engagement initial, mais la limite de date de fin ne s'applique pas.

### Console
<a name="capacity-reservations.modifying.console"></a>

**Pour modifier une réserve de capacité**

1. Connectez-vous au Console de gestion AWS et ouvrez la console Amazon RDS à l'adresse [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).

1. Dans le volet de navigation, choisissez **Réservations de capacité**.

1. Dans la liste des réservations, sélectionnez la réservation.

1. Pour **Actions**, choisissez **Edit**.

1. En dessous **Détails de la réservation de capacité**, procédez comme suit :
   + Pour **Capacité réservée par AZ**, entrez le nouveau nombre d'instances de base de données à réserver dans chaque zone de disponibilité.
   + (Facultatif) Pour **Fin de la réservation de capacité**, choisissez **Manuellement** pour conserver la réservation jusqu'à ce que vous l'annuliez, ou **À un moment précis** pour fixer une date de fin.  
![Modifier la page pour ma réservation : capacité réservée par AZ de 2, la fin étant réglée sur Manuellement.](https://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/odcr-modify-reservation.png)

1. Examinez l'impact sur les coûts, puis choisissez **Enregistrer les modifications**. Une augmentation de capacité ou une date de fin ultérieure entraîne immédiatement des frais. Une diminution de capacité ou une date de fin antérieure ne rembourse pas les frais pour le temps déjà écoulé.

### AWS CLI
<a name="capacity-reservations.modifying.cli"></a>

Utilisez le [modify-db-capacity reservation](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-capacity-reservation.html) commande.

```
1. aws rds modify-db-capacity-reservation \
2.     --db-capacity-reservation-identifier {{my-reservation}} \
3.     --capacity-per-availability-zone {{4}}
```

La nouvelle capacité s'applique à chaque zone de disponibilité de la réservation. Son augmentation est subordonnée à la disponibilité de capacités dans chacun d'entre eux. Sa diminution permet de libérer la différence et de réduire les charges.

### API RDS
<a name="capacity-reservations.modifying.api"></a>

Pour modifier une réservation de capacité à l'aide de l'API Amazon RDS, appelez le [ModifyDBCapacityReservation](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBCapacityReservation.html) opération avec le paramètre suivant :
+ `DBCapacityReservationIdentifier` — Le nom du `dbcr-` Identifiant de la réservation de capacité.

Spécifiez également au moins l'un des paramètres suivants :
+ `CapacityPerAvailabilityZone` — Le nouveau nombre d'instances de base de données à réserver dans chaque zone de disponibilité.
+ `EndDateType` — `limited` pour définir une date de fin, ou `unlimited` pour conserver la réservation jusqu'à ce que vous l'annuliez.
+ `EndDate` — La nouvelle date de fin, en UTC. Obligatoire lorsque `EndDateType` est `limited`.