

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.

# Création d'une réservation de capacité

Lorsque vous créez une réservation de capacité, vous spécifiez une classe d'instance de base de données, un moteur de base de données et une ou plusieurs zones de disponibilité en une seule AWS Région, ainsi que le niveau de capacité à réserver dans chaque zone de disponibilité. Vous pouvez créer la réservation pour une utilisation immédiate ou la programmer pour qu'elle commence à une date ultérieure avant un événement prévu. Une fois la réservation active, vous la référencez par son nom ou par un identifiant pour placer les instances de base de données dans la capacité réservée.

La création d'une réservation sans date de début la rend immédiatement active. La capacité est réservée et la facturation commence immédiatement.

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

**Pour créer 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. Choisissez **Créer une réserve de capacité**.

1. En dessous **Options de moteur**, choisissez le type de moteur pour votre réservation de capacité.  
![Types de moteurs que vous pouvez choisir pour une réservation de capacité, avec PostgreSQL sélectionné.](https://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/odcr-create-engine-options-rds.png)

1. En dessous **Configuration de l'instance**, choisissez la configuration de l'instance de base de données.  
![Classe d'instance de base de données db.r7g.large sélectionnée.](https://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/odcr-create-instance-config.png)

1. En dessous **Détails de la réservation de capacité**, procédez comme suit :
   + Pour **Nom de réservation de capacité de base de données**, entrez un nom pour la réservation. Le nom doit commencer par une lettre minuscule et peut contenir des lettres minuscules, des chiffres et des tirets, jusqu'à 63 caractères. Il ne peut pas se terminer par un trait d’union ou contenir deux traits d’union consécutifs.
   + En dessous **Zones de disponibilité**, sélectionnez une ou plusieurs zones de disponibilité dans la région actuelle. Sélectionnez-en au moins deux si vous prévoyez de placer Multi-AZ Instances de base de données.
   + Pour **Capacité réservée par AZ**, entrez le nombre d'instances de base de données à réserver dans chaque zone de disponibilité.
   + En dessous **Début de la réservation des capacités**, choisissez **Immédiatement**.
   + (Facultatif) Moins **Fin de la réservation de capacité**, choisissez **Aucune heure de fin** pour conserver la réservation jusqu'à ce que vous l'annuliez, ou **À un moment précis** pour fixer une date de fin.  
![Détails de la réservation de la capacité : my-reservation, us-east-1a, 2 par AZ, commence immédiatement, pas d'heure de fin.](https://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/odcr-create-details.png)

1. (Facultatif) Ajoutez des balises.

1. Choisissez **Créer une réserve de capacité**.

La réservation apparaît dans la liste. Quand son état devient `active`, la capacité est réservée et vous pouvez y lancer des instances de base de données en référençant la réservation par son nom ou son identifiant. La création d'une réservation ne modifie pas le placement des instances de base de données qui ne la ciblent pas.

La facturation d'une réservation immédiatement active commence lorsque vous la créez. Pour arrêter les frais, annulez la réservation lorsque vous n'en avez plus besoin. Pour plus d’informations, consultez [Annulation d'une réservation de capacité](capacity-reservations.canceling.md).

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

Créez une réservation immédiatement active avec [create-db-capacity reservation](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-capacity-reservation.html) commande.

```
1. aws rds create-db-capacity-reservation \
2.     --db-capacity-reservation-name {{my-reservation}} \
3.     --engine {{postgres}} \
4.     --db-instance-class {{db.r7g.large}} \
5.     --availability-zones {{us-east-1a}} \
6.     --capacity-per-availability-zone {{3}}
```

Pour réserver de la capacité pour Multi-AZ Instances de base de données, répertoriez deux zones de disponibilité ou plus. La même capacité est réservée dans chacun d'entre eux.

```
1. aws rds create-db-capacity-reservation \
2.     --db-capacity-reservation-name {{my-multi-az-reservation}} \
3.     --engine {{postgres}} \
4.     --db-instance-class {{db.r7g.large}} \
5.     --availability-zones {{us-east-1a}} {{us-east-1b}} \
6.     --capacity-per-availability-zone {{2}}
```

Exemple de réponse :

```
 1. {
 2.     "DBCapacityReservation": {
 3.         "DBCapacityReservationName": "my-multi-az-reservation",
 4.         "DBInstanceClass": "db.r7g.large",
 5.         "Engine": "postgres",
 6.         "ReservedCapacityPerAvailabilityZone": 2,
 7.         "AvailableCapacityPerAvailabilityZoneList": [
 8.             {
 9.                 "AvailabilityZone": "us-east-1a",
10.                 "AvailableCapacity": 2
11.             },
12.             {
13.                 "AvailabilityZone": "us-east-1b",
14.                 "AvailableCapacity": 2
15.             }
16.         ],
17.         "CreateDate": "2026-09-21T21:44:50.147000+00:00",
18.         "State": "active",
19.         "DBCapacityReservationArn": "arn:aws:rds:us-east-1:123456789012:db-capacity-reservation:dbcr-abc123example",
20.         "DBCapacityReservationIdentifier": "dbcr-abc123example",
21.         "TagList": []
22.     }
23. }
```

Pour les moteurs qui proposent plusieurs options de licence, incluez `--license-model` afin que la réservation corresponde aux instances de base de données que vous souhaitez y lancer. Une instance de base de données dont le modèle de licence diffère de celui de la réservation ne peut pas utiliser la capacité réservée.

```
1. aws rds create-db-capacity-reservation \
2.     --db-capacity-reservation-name {{oracle-reservation}} \
3.     --engine {{oracle-se2}} \
4.     --db-instance-class {{db.r7i.large}} \
5.     --availability-zones {{us-east-1a}} \
6.     --capacity-per-availability-zone {{2}} \
7.     --license-model {{bring-your-own-license}}
```

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

Pour créer une réservation de capacité à l'aide de l'API Amazon RDS, appelez le [CreateDBCapacityReservation](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBCapacityReservation.html) fonctionnement avec les paramètres suivants :
+ `DBCapacityReservationName` — Un nom pour la réservation. Le nom doit commencer par une lettre minuscule et peut contenir des lettres minuscules, des chiffres et des tirets, jusqu'à 63 caractères. Il ne peut pas se terminer par un trait d'union, contenir deux traits d'union consécutifs ou commencer par `dbcr-`.
+ `Engine` — Le moteur de base de données pour lequel réserver de la capacité, par exemple `postgres`.
+ `DBInstanceClass` — La classe d'instance de base de données pour laquelle réserver de la capacité, par exemple `db.r7g.large`.
+ `AvailabilityZones` — Une ou plusieurs zones de disponibilité dans la zone actuelle AWS Région.
+ `CapacityPerAvailabilityZone` — Le nombre d'instances de base de données à réserver dans chaque zone de disponibilité.

Vous pouvez également préciser les paramètres suivants :
+ `LicenseModel` — Le modèle de licence, pour les moteurs qui en proposent plusieurs. Le modèle de licence d'une instance de base de données doit correspondre au modèle de licence de la réservation.
+ `EndDate` — La date et l'heure d'expiration de la réservation, en UTC. Si vous ne le spécifiez pas, la réservation n'expire pas.
+ `Tags` — Tags à attribuer à la réservation de capacité.

## Création d'une réservation de capacité à une date ultérieure
<a name="capacity-reservations.future-dated"></a>

Pour planifier une réservation qui débutera à une date ultérieure, indiquez une date de début et une durée d'engagement. Amazon RDS évalue la demande et, s'il peut fournir la capacité requise, déplace la réservation vers `scheduled` état. Aucuns frais ne s'appliquent jusqu'à la date de début, date à laquelle Amazon RDS active la réservation.

Lors de l'évaluation d'une demande, Amazon RDS peut déterminer qu'il peut prendre en charge une durée d'engagement plus courte. Dans ce cas, Amazon RDS planifie la réservation avec la durée d'engagement la plus courte, et vous vous engagez à conserver la réservation pendant une période plus courte que celle que vous avez demandée. Pour voir l'engagement qui s'applique, consultez `CommitmentInfo.CommitmentEndDate` dans la sortie de `describe-db-capacity-reservations`.

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

Suivez les étapes de [Création d'une réservation de capacité](capacity-reservations.creating.md). En dessous **Début de la réservation des capacités**, procédez comme suit :

**Pour créer une réservation de capacité à une date ultérieure**

1. Choisissez **À un moment précis**.

1. Réglez le **Date de début** et **Heure de début** (doit se situer au moins 5 jours dans le futur).

1. Réglez le **Durée de l'engagement** (minimum 14 jours). Il s'agit de la période pendant laquelle vous vous engagez à conserver la réservation une fois qu'elle est devenue active.  
![Une réservation à une date ultérieure qui commence à une heure précise avec un engagement de 14 jours.](https://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/odcr-create-future-dated.png)

Effectuez les étapes restantes et choisissez **Créer une réservation de capacité**. La réservation est créée dans le `assessing` état et passe à `scheduled` une fois qu'Amazon RDS a accepté la demande.

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

Ajouter `--start-date` et `--commitment-duration` à la `create-db-capacity-reservation` commande. `--commitment-duration` est spécifié en secondes (par exemple, `1209600` pendant 14 jours).

```
1. aws rds create-db-capacity-reservation \
2.     --db-capacity-reservation-name {{peak-reservation}} \
3.     --engine {{postgres}} \
4.     --db-instance-class {{db.r7g.large}} \
5.     --availability-zones {{us-east-1a}} \
6.     --capacity-per-availability-zone {{16}} \
7.     --start-date {{2026-11-01T00:00:00Z}} \
8.     --commitment-duration {{1209600}}
```

Exemple de réponse :

```
 1. {
 2.     "DBCapacityReservation": {
 3.         "DBCapacityReservationName": "peak-reservation",
 4.         "DBInstanceClass": "db.r7g.large",
 5.         "Engine": "postgres",
 6.         "ReservedCapacityPerAvailabilityZone": 16,
 7.         "StartDate": "2026-11-01T00:00:00Z",
 8.         "CommitmentInfo": {
 9.             "CommittedCapacityPerAvailabilityZone": 16,
10.             "CommitmentEndDate": "2026-11-15T00:00:00Z"
11.         },
12.         "CreateDate": "2026-09-21T21:44:50.147000+00:00",
13.         "State": "assessing",
14.         "DBCapacityReservationArn": "arn:aws:rds:us-east-1:123456789012:db-capacity-reservation:dbcr-def456example",
15.         "DBCapacityReservationIdentifier": "dbcr-def456example",
16.         "TagList": []
17.     }
18. }
```

**Note**  
En omettant `--start-date` et `--commitment-duration` crée une réservation immédiatement active. Les deux paramètres prospectifs sont utilisés conjointement.

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

Pour créer une réservation de capacité à date ultérieure à l'aide de l'API Amazon RDS, appelez le [CreateDBCapacityReservation](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBCapacityReservation.html) fonctionnement avec les paramètres d'une réservation immédiatement active, et avec les paramètres suivants :
+ `StartDate` — La date et l'heure de début de la réservation, en UTC. Cela doit prendre 5 à 120 jours dans le futur.
+ `CommitmentDuration` — La durée de l'engagement, en secondes. Le minimum est `1209600` (14 jours). Pour la famille X, le minimum est `7257600` (12 semaines).