

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à.

# Creazione di una prenotazione di capacità

Quando si crea una prenotazione di capacità, si specificano una classe di istanza DB, un motore di database e una o più zone di disponibilità in un'unica AWS Regione, insieme alla quantità di capacità da riservare in ciascuna zona di disponibilità. È possibile creare la prenotazione per un utilizzo immediato o programmarla in modo che inizi in una data futura prima di un evento pianificato. Una volta che la prenotazione diventa attiva, si fa riferimento ad essa per nome o per identificatore per inserire le istanze DB nella capacità riservata.

La creazione di una prenotazione senza una data di inizio la rende immediatamente attiva. La capacità è riservata e la fatturazione inizia immediatamente.

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

**Per creare una prenotazione della capacità**

1. Accedi al Console di gestione AWS e apri la console Amazon RDS all'indirizzo [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).

1. Nel pannello di navigazione, scegli **Prenotazioni di capacità**.

1. Scegli **Crea prenotazione della capacità**.

1. Sotto **Opzioni del motore**, scegli il tipo di motore per la tua prenotazione di capacità.  
![Tipi di motore che puoi scegliere per una prenotazione di capacità, con PostgreSQL selezionato.](https://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/odcr-create-engine-options-rds.png)

1. Sotto **Configurazione dell'istanza**, scegli la configurazione dell'istanza DB.  
![La classe di istanza DB db.r7g.large selezionata.](https://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/odcr-create-instance-config.png)

1. Sotto **Dettagli sulla prenotazione della capacità**, procedi come segue:
   + Per **Nome della prenotazione della capacità DB**, inserisci un nome per la prenotazione. Il nome deve iniziare con una lettera minuscola e può contenere lettere minuscole, cifre e trattini, fino a 63 caratteri. Non può terminare con un trattino o contenere due trattini consecutivi.
   + Sotto **Zone di disponibilità**, seleziona una o più zone di disponibilità nella regione corrente. Selezionane almeno due se intendi piazzare Multi-AZ Istanze DB.
   + Per **Capacità riservata per AZ**, inserisci il numero di istanze DB da prenotare in ciascuna zona di disponibilità.
   + In **Inizia la prenotazione della capacità**, scegli **Immediatamente**.
   + (Facoltativo) Sotto **La prenotazione della capacità termina**, scegli **Nessun orario di fine** per mantenere la prenotazione fino alla cancellazione, oppure **In un momento specifico** per impostare una data di fine.  
![Dettagli sulla prenotazione della capacità: my-reservation, us-east-1a, 2 per AZ, inizia immediatamente, nessun orario di fine.](https://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/odcr-create-details.png)

1. (Facoltativo) Aggiungi dei tag.

1. Scegli **Crea prenotazione della capacità**.

La prenotazione appare nell'elenco. Quando il suo stato diventa `active`, la capacità è riservata ed è possibile avviare istanze DB facendo riferimento alla prenotazione per nome o per identificatore. La creazione di una prenotazione non modifica il posizionamento delle istanze DB non destinate alla prenotazione.

La fatturazione di una prenotazione immediatamente attiva inizia quando la crei. Per bloccare gli addebiti, annulla la prenotazione quando non ti serve più. Per ulteriori informazioni, consulta [Annullamento di una prenotazione di capacità](capacity-reservations.canceling.md).

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

Crea una prenotazione immediatamente attiva con [create-db-capacity-reservation](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-capacity-reservation.html) comando.

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

Riservare la capacità per Multi-AZ Istanze DB, elenca due o più zone di disponibilità. La stessa capacità è riservata in ognuna di esse.

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

Risposta di esempio:

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

Per i motori che offrono più di un'opzione di licenza, includi `--license-model` in modo che la prenotazione corrisponda alle istanze DB che intendi avviare. Un'istanza DB il cui modello di licenza è diverso da quello della prenotazione non può utilizzare la capacità riservata.

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

Per creare una prenotazione di capacità utilizzando l'API Amazon RDS, chiama [CreateDBCapacityReservation](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBCapacityReservation.html) operazione con i seguenti parametri:
+ `DBCapacityReservationName` — Un nome per la prenotazione. Il nome deve iniziare con una lettera minuscola e può contenere lettere minuscole, cifre e trattini, fino a 63 caratteri. Non può terminare con un trattino, contenere due trattini consecutivi o iniziare con `dbcr-`.
+ `Engine` — Il motore di database per cui riservare capacità, ad esempio `postgres`.
+ `DBInstanceClass` — La classe di istanza DB per cui riservare la capacità, ad esempio `db.r7g.large`.
+ `AvailabilityZones` — Una o più zone di disponibilità nell'attuale AWS Regione.
+ `CapacityPerAvailabilityZone` — Il numero di istanze DB da riservare in ciascuna zona di disponibilità.

È inoltre possibile specificare i parametri opzionali seguenti:
+ `LicenseModel` — Il modello di licenza, per i motori che ne offrono più di una. Il modello di licenza di un'istanza DB deve corrispondere al modello di licenza della prenotazione.
+ `EndDate` — La data e l'ora di scadenza della prenotazione, in UTC. Se non lo specifichi, la prenotazione non scade.
+ `Tags` — Tag da assegnare alla prenotazione della capacità.

## Creazione di una prenotazione di capacità con data futura
<a name="capacity-reservations.future-dated"></a>

Per programmare l'inizio di una prenotazione in una data futura, fornisci una data di inizio e una durata dell'impegno. Amazon RDS valuta la richiesta e, se è in grado di fornire la capacità, sposta la prenotazione al `scheduled` stato. Non si applica alcun costo fino alla data di inizio, quando Amazon RDS attiva la prenotazione.

Durante la valutazione di una richiesta, Amazon RDS potrebbe stabilire che è in grado di supportare una durata di impegno più breve. In tal caso, Amazon RDS pianifica la prenotazione con una durata dell'impegno più breve e ti impegni a mantenere la prenotazione per un periodo più breve di quello richiesto. Per vedere l'impegno applicabile, controlla `CommitmentInfo.CommitmentEndDate` nell'output di `describe-db-capacity-reservations`.

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

Segui la procedura riportata in [Creazione di una prenotazione di capacità](capacity-reservations.creating.md). Sotto **Inizia la prenotazione della capacità**, procedi come segue:

**Per creare una prenotazione di capacità con data futura**

1. Scegli **In un momento specifico**.

1. Impostare il **Data di inizio** e **Ora di inizio** (deve avvenire almeno 5 giorni nel futuro).

1. Imposta il **Durata dell'impegno** (minimo 14 giorni). Questo è il periodo in cui ti impegni a mantenere la prenotazione dopo che è diventata attiva.  
![Una prenotazione con data futura che inizia in un momento specifico con un impegno di 14 giorni.](https://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/odcr-create-future-dated.png)

Completa i passaggi rimanenti e scegli **Crea una prenotazione di capacità**. La prenotazione viene creata nel `assessing` stato e si trasferisce in `scheduled` dopo che Amazon RDS ha accettato la richiesta.

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

Inserisci `--start-date` e `--commitment-duration` al `create-db-capacity-reservation` comando. `--commitment-duration` è specificato in secondi (ad esempio, `1209600` per 14 giorni).

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

Risposta di esempio:

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

**Nota**  
Omettendo `--start-date` e `--commitment-duration` crea una prenotazione immediatamente attiva. I due parametri con data futura vengono utilizzati insieme.

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

Per creare una prenotazione di capacità con data futura utilizzando l'API Amazon RDS, chiama [CreateDBCapacityReservation](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBCapacityReservation.html) operazione con i parametri per una prenotazione immediatamente attiva e con i seguenti parametri:
+ `StartDate` — La data e l'ora di inizio della prenotazione, in UTC. Devono essere compresi tra 5 e 120 giorni nel futuro.
+ `CommitmentDuration` — La durata dell'impegno, in secondi. Il minimo è `1209600` (14 giorni). Per la famiglia X, il minimo è `7257600` (12 settimane).