

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Utilizzo di una prenotazione di capacità con un'istanza DB

La capacità riservata viene utilizzata solo quando si imposta esplicitamente come target la prenotazione. Si fa riferimento alla prenotazione tramite il relativo identificatore (`dbcr-`) o il suo nome quando si esegue una delle seguenti operazioni:
+ Create un'istanza DB (`CreateDBInstance`)
+ Crea una replica di lettura (`CreateDBInstanceReadReplica`)
+ Ripristina un'istanza DB da un'istantanea o da un punto nel tempo (`RestoreDBInstance*`)
+ Modificate un'istanza DB per spostarla in una prenotazione (`ModifyDBInstance`)
+ Avvia un'istanza DB interrotta (`StartDBInstance`)

Il motore dell'istanza DB, la classe dell'istanza DB, il modello di licenza (per i motori che ne offrono più di una) e la zona di disponibilità devono corrispondere alla prenotazione e la prenotazione deve avere una capacità disponibile in quella zona di disponibilità (la voce corrispondente in `AvailableCapacityPerAvailabilityZoneList` ha un `AvailableCapacity` maggiore di 0). Se non corrispondono o non è disponibile alcuna capacità, l'operazione ha esito negativo e viene visualizzato un errore che indica che la zona di disponibilità non ha una capacità sufficiente. Per un Multi-AZ L'istanza DB, sia la zona di disponibilità primaria che quella in standby devono avere capacità disponibile.

**Nota**  
Blue/Green Le implementazioni non supportano le prenotazioni di capacità.

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

Quando crei o ripristini un'istanza DB nella console Amazon RDS, nel **Prenotazione della capacità** sezione, scegli la prenotazione in cui lanciarti.

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

Aggiungi il `--db-capacity-reservation-identifier` parametro al comando di creazione, ripristino o modifica. Ad esempio, per creare un'istanza DB che utilizza una prenotazione:

```
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}}
```

Il `--db-capacity-reservation-identifier` il parametro accetta il nome della prenotazione o il suo `dbcr-` ID.

Per effettuare il ripristino in una prenotazione, aggiungi lo stesso parametro al comando di ripristino. Il ripristino di un'istantanea utilizza il motore dell'istantanea, ma è possibile sovrascrivere la classe dell'istanza DB, la zona di disponibilità e il modello di licenza. Qualsiasi elemento ottenuto dall'istanza DB ripristinata deve corrispondere alla prenotazione.

```
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 i ripristini utilizzano lo stesso parametro:

```
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}}
```

Il `restore-db-instance-from-s3` Il comando accetta anche il parametro.

Per spostare un'istanza DB esistente in una prenotazione, specificate la prenotazione in una richiesta di modifica che modifica anche la classe dell'istanza DB, la Multi-AZ impostazione, o modello di licenza, o che converte un'istanza DB RDS per Oracle dall'architettura non CDB all'architettura CDB. Per una conversione CDB, il motore di prenotazione deve essere `oracle-ee-cdb` o `oracle-se2-cdb`. La prenotazione deve corrispondere alla configurazione dell'istanza DB dopo la modifica. Ad esempio, per ridimensionare un'istanza DB su db.r7g.large e inserirla in una prenotazione 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
```

Una richiesta di modifica che specifica una prenotazione senza una di queste modifiche ha esito negativo. Per spostare un'istanza DB in una prenotazione senza modificarne la configurazione, arrestate l'istanza DB e avviatela con la prenotazione. Per ulteriori informazioni, consulta [Arresto e avvio di un'istanza DB in una prenotazione](capacity-reservations.stopstart.md).

Quando le istanze DB vengono inserite nella prenotazione, `AvailableCapacity` per la zona di disponibilità interessata diminuisce. Puoi tenerne traccia con `describe-db-capacity-reservations`.

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

Specificare il `DBCapacityReservationIdentifier` parametro in [istanza db creata](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), [Modifica l'istanza DB](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBInstance.html), o [Avvia istanza DB](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_StartDBInstance.html) operazione.