

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.

# Utilisation d'une réservation de capacité avec une instance de base de données

La capacité réservée n'est utilisée que lorsque vous ciblez explicitement la réservation. Vous référencez la réservation par son identifiant (`dbcr-`) ou son nom lorsque vous effectuez l'une des opérations suivantes :
+ Créez une instance de base de données (`CreateDBInstance`)
+ Créez une réplique de lecture (`CreateDBInstanceReadReplica`)
+ Restaurez une instance de base de données à partir d'un instantané ou à un moment donné (`RestoreDBInstance*`)
+ Modifiez une instance de base de données pour la déplacer dans une réservation (`ModifyDBInstance`)
+ Démarrez une instance de base de données arrêtée (`StartDBInstance`)

Le moteur, la classe d'instance de base de données, le modèle de licence (pour les moteurs qui en proposent plusieurs) et la zone de disponibilité doivent correspondre à la réservation, et la réservation doit disposer de capacité disponible dans cette zone de disponibilité (l'entrée correspondante dans `AvailableCapacityPerAvailabilityZoneList` possède un `AvailableCapacity` supérieur à 0). S'ils ne correspondent pas ou si aucune capacité n'est disponible, l'opération échoue et une erreur indique que la capacité de la zone de disponibilité est insuffisante. Pour un Multi-AZ Instance de base de données, la zone de disponibilité principale et la zone de disponibilité de secours doivent disposer de capacité disponible.

**Note**  
Blue/Green Les déploiements ne prennent pas en charge les réservations de capacité.

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

Lorsque vous créez ou restaurez une instance de base de données dans la console Amazon RDS, dans le **Réservation de capacité** section, choisissez la réservation dans laquelle vous souhaitez vous lancer.

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

Ajoutez le `--db-capacity-reservation-identifier` paramètre de la commande de création, de restauration ou de modification. Par exemple, pour créer une instance de base de données qui utilise une réservation :

```
1. aws rds create-db-instance \
2.     --db-instance-identifier {{my-db-instance}} \
3.     --engine {{postgres}} \
4.     --db-instance-class {{db.r7g.large}} \
5.     --availability-zone {{us-east-1a}} \
6.     --allocated-storage {{100}} \
7.     --master-username {{admin}} \
8.     --manage-master-user-password \
9.     --db-capacity-reservation-identifier {{my-reservation}}
```

Le `--db-capacity-reservation-identifier` le paramètre accepte soit le nom de la réservation, soit son `dbcr-` IDENTIFIANT.

Pour restaurer une réservation, ajoutez le même paramètre à la commande de restauration. Une restauration de snapshot extrait le moteur de l'instantané, mais vous pouvez modifier la classe d'instance de base de données, la zone de disponibilité et le modèle de licence. L'objet final de l'instance de base de données restaurée doit correspondre à la réservation.

```
1. aws rds restore-db-instance-from-db-snapshot \
2.     --db-instance-identifier {{my-restored-instance}} \
3.     --db-snapshot-identifier {{my-snapshot}} \
4.     --db-instance-class {{db.r7g.large}} \
5.     --availability-zone {{us-east-1a}} \
6.     --db-capacity-reservation-identifier {{my-reservation}}
```

Point-in-time les restaurations prennent le même paramètre :

```
1. aws rds restore-db-instance-to-point-in-time \
2.     --source-db-instance-identifier {{my-source-instance}} \
3.     --target-db-instance-identifier {{my-restored-instance}} \
4.     --use-latest-restorable-time \
5.     --db-instance-class {{db.r7g.large}} \
6.     --availability-zone {{us-east-1a}} \
7.     --db-capacity-reservation-identifier {{my-reservation}}
```

Le `restore-db-instance-from-s3` la commande accepte également le paramètre.

Pour déplacer une instance de base de données existante vers une réservation, spécifiez la réservation dans une demande de modification qui modifie également la classe d'instance de base de données, le Multi-AZ paramètre, ou modèle de licence, ou qui convertit une instance de base de données RDS pour Oracle de l'architecture non CDB à l'architecture CDB. Pour une conversion CDB, le moteur de réservation doit être `oracle-ee-cdb` ou `oracle-se2-cdb`. La réservation doit correspondre à la configuration de l'instance de base de données après la modification. Par exemple, pour redimensionner une instance de base de données vers db.r7g.large et la placer dans une réservation db.r7g.large :

```
1. aws rds modify-db-instance \
2.     --db-instance-identifier {{my-db-instance}} \
3.     --db-instance-class {{db.r7g.large}} \
4.     --db-capacity-reservation-identifier {{my-reservation}} \
5.     --apply-immediately
```

Une demande de modification qui spécifie une réservation sans l'une de ces modifications échoue. Pour déplacer une instance de base de données vers une réservation sans modifier sa configuration, arrêtez l'instance de base de données, puis démarrez-la avec la réservation. Pour plus d’informations, consultez [Arrêt et démarrage d'une instance de base de données dans une réservation](capacity-reservations.stopstart.md).

Lorsque des instances de base de données sont placées dans la réservation, `AvailableCapacity` pour les baisses de zone de disponibilité concernées. Vous pouvez suivre cela avec `describe-db-capacity-reservations`.

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

Spécifiez le `DBCapacityReservationIdentifier` paramètre dans [Instance B créée](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBInstance.html), [CreateDBInstanceReadReplica](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBInstanceReadReplica.html), [RestoreDBInstanceFromDBSnapshot](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_RestoreDBInstanceFromDBSnapshot.html), [RestoreDBInstanceToPointInTime](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_RestoreDBInstanceToPointInTime.html), [RestoreDBInstanceFromS3](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_RestoreDBInstanceFromS3.html), [Modifier l'instance de base de données](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBInstance.html), ou [Démarrer une instance de base de données](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_StartDBInstance.html) opération.