Gestione di una prenotazione per VPC
Una volta effettuata la prenotazione, è possibile gestire la prenotazione con le seguenti azioni.
| Azione | Descrizione |
|---|---|
| Elenca tutte le prenotazioni | Elenca tutte le prenotazioni nella regione. |
| Crea una prenotazione | Creare una prenotazione nella regione. |
| Elimina una riserva | Eliminare una riserva inactive. Impossibile eliminare una prenotazione active. I risultati prodotti da questa azione non possono essere annullati. |
| Richiama una riserva | Recupera una prenotazione come specificato dal suo identificatore in URL. |
| Aggiorna una riserva | Aggiorna la prenotazione con nuove informazioni. |
| Attiva una prenotazione | Attivare una prenotazione inactive. |
Prima di iniziare
Devi eseguire il provisioning della prenotazione prima di collegare i server virtuali. Per ulteriori informazioni, vedi Provisioning delle prenotazioni per i server virtuali.
Se non sei l'amministratore dell'account, il tuo account utente deve includere l'autorizzazione Gestisci capacità riservate. Per ulteriori informazioni sull'aggiornamento delle autorizzazioni, consulta Gestione dell'accesso IAM per i servizi dell'infrastruttura VPC.
Gestione di una prenotazione con l'IU
È possibile utilizzare l'interfaccia utente per gestire la prenotazione e i server collegati.
Collegare un'istanza di server virtuale alla prenotazione con l'interfaccia utente
È possibile collegare un server virtuale a una riserva.
- In " IBM Cloud console", fare clic sull'icona " Menu di navigazione "
> Infrastrutture
> Prenotazioni.
- Selezionare una prenotazione nella pagina Dettagli prenotazione.
- Dall'elenco dei server virtuali, fai clic su Azioni > Collega.
- Selezionare il server che si desidera allegare alla prenotazione e fare clic su Allega.
Scollegamento di un server dalla prenotazione con l'interfaccia utente
Puoi scollegare un server virtuale dalla tua prenotazione.
- In " IBM Cloud console", fare clic sull'icona " Menu di navigazione "
> Infrastrutture
> Prenotazioni.
- Dal tuo elenco di server virtuali o nella pagina dei dettagli della prenotazione, fai clic sul server che vuoi scollegare e fai quindi clic su Azioni > Scollega.
- Per confermare, fare clic su Scollega.
Se l'istanza viene arrestata e avviata, anche se punta a una prenotazione scaduta, può essere avviata e viene fatturata a prezzi pay-go.
Considerazioni speciali per l'eliminazione di una prenotazione
È possibile eliminare una prenotazione 'inactive e modificare i seguenti campi.
- politica_affinità
- capacity.total
- committed_use.expiration_policy
- committed_use.term
- nome
- profilo
Se si desidera modificare altri campi, è necessario cancellare la prenotazione e ricrearla.
Tuttavia, dopo che una prenotazione è stata attivata ed è stata " active, molti aspetti della prenotazione sono permanenti per tutta la durata della stessa. Assicurarsi di rivedere la prenotazione prima di attivarla per verificare
che la configurazione sia corretta. Gli unici campi che possono essere patchati per una prenotazione " active sono " name e " committed_use.expiration_policy.
Eliminazione di una prenotazione con l'interfaccia utente
È possibile cancellare una prenotazione.
- In " IBM Cloud console", fare clic sull'icona " Menu di navigazione "
> Infrastrutture
> Prenotazioni.
- Dall'elenco Prenotazioni, fare clic su Azioni > Elimina prenotazione.
- Per confermare, fare clic su Elimina.
Gestione di una prenotazione con la CLI
Puoi gestire una prenotazione utilizzando la CLI.
Attiva una prenotazione
Puoi attivare una prenotazione utilizzando la CLI (command - line interface). Per attivare una prenotazione specifica utilizzando la CLI, utilizza il comando ibmcloud is reservation-activate. È necessario specificare il nome o
ID della prenotazione specifica utilizzando RESERVATION_NAME per la prenotazione specifica che si desidera ottenere.
ibmcloud is reservation-activate RESERVATION
Vedi il seguente esempio.
ibmcloud is reservation-activate b4735ce6-f83d-45d1-b41b-4d47451c8396
Activating reservation b4735ce6-f83d-45d1-b41b-4d47451c8396 under account ACCOUNT as user user@ibm.com...
Successfully activated reservation.
Dove vengono utilizzati i seguenti valori di argomenti e opzioni
- PRENOTAZIONE: ID o nome della prenotazione.
- --output: Specificare il formato di output; è supportato solo JSON. Uno di: JSON.
- -q, --quiet: sopprimere l'output verboso
Ottenere un'istanza con prenotazione
Puoi ottenere l'istanza con prenotazione nella tua regione utilizzando la CLI (command - line interface). Per ottenere una prenotazione dell'istanza specifica utilizzando la CLI, utilizza il comando ibmcloud is instance. È necessario
specificare il nome o l'ID dell'istanza specifica utilizzando il sito INSTANCE_NAME per l'istanza specifica che si desidera ottenere.
ibmcloud is instance INSTANCE_NAME
Vedi il seguente esempio.
ibmcloud is instance instance-cli-test-patch-reservation-1
Getting instance instance-cli-test-patch-reservation-1 under account VPCUI-DEV as user user@ibm.com...
ID aaaaaaaa-aaaa-default-reservation2-aaaaaaaaaaaa
Name aaa-default-reservation-2
CRN crn:v1:bluemix:public:is:jp-tok:a/823bd195e9fd4f0db40ac2e1bffef3e0::reservation:aaaaaaaa-aaaa-default-reservation2-aaaaaaaaaaaa
Status active
Zone us-east-1
Lifecycle state stable
Affinity Policy open
Resource group -
Profile Name mx2-2x16
Created At 2023-06-05T10:41:51.401+05:30
Expiration At Policy Term
2026-08-28T05:11:51.401Z renew three_year
Capacity Allocated Available Total Used Status
8 8 8 0 -
Eliminazione di una prenotazione
Puoi eliminare IBM Cloud VPC una riserva nella tua regione utilizzando la CLI (command - line interface). Per eliminare una prenotazione utilizzando la CLI, utilizza il comando ibmcloud is reservation-delete. È necessario specificare
il nome o l'ID della prenotazione specifica utilizzando RESERVATION_NAME per la prenotazione specifica che si desidera eliminare.
ibmcloud is reservation-delete RESERVATION_NAME
Vedi il seguente esempio.
ibmcloud is reservation-delete e9e537f0-59f5-4759-b06e-86bb5cd4068e
This will delete reservation e9e537f0-59f5-4759-b06e-86bb5cd4068e and cannot be undone. Continue [y/N] ?> y
Deleting reservation e9e537f0-59f5-4759-b06e-86bb5cd4068e under account ACCOUNT as user user@ibm.com...
OK
Reservation e9e537f0-59f5-4759-b06e-86bb5cd4068e is deleted.
Dove vengono utilizzati i seguenti valori di argomenti e opzioni
- RESERVATION1: ID o nome della prenotazione.
- RESERVATION2: ID o nome della prenotazione.
- --force, -f: Esegue l'operazione senza richiesta di conferma
- --output: Specificare il formato di output; è supportato solo JSON. Uno di: JSON.
- -q, --quiet: sopprime l'output verboso.
Elenco di tutte le prenotazioni
Puoi elencare tutte le prenotazioni IBM Cloud VPC nella tua regione utilizzando la CLI (command - line interface). Per elencare tutte le prenotazioni utilizzando la CLI, utilizza il comando ibmcloud is reservations.
ibmcloud is reservations
Vedi il seguente esempio.
ibmcloud is reservations
Listing reservations in all resource groups and region us-south under account VPCUI-DEV as user user@ibm.com...
ID Name Status Zone Profile Resource group
0735_73b1e3e5-10a2-44b0-a113-c8d6cd8c42e7 reservation-cli-test-1 active us-south-3 cx2-2x4 Default
0735_4e245881-c9c8-49f3-a21b-d890a13835bb reservation-cli-test-3 active us-south-3 cx2-2x4 Default
Recupero di una prenotazione
Puoi richiamare una prenotazione IBM Cloud VPC specifica nella tua regione utilizzando la CLI (command - line interface). Per richiamare una prenotazione specifica utilizzando la CLI, utilizza il comando ibmcloud is reservation.
È necessario specificare il nome o l'ID della prenotazione specifica utilizzando RESERVATION_NAME per la prenotazione specifica che si desidera richiamare.
ibmcloud is reservation RESERVATION_NAME
Vedi il seguente esempio.
ibmcloud is reservation aaaaaaaa-aaaa-default-reservation2-aaaaaaaaaaaa
Getting reservation aaaaaaaa-aaaa-default-reservation2-aaaaaaaaaaaa under account ACCOUNT as user user@ibm.com...
ID aaaaaaaa-aaaa-default-reservation2-aaaaaaaaaaaa
Name aaa-default-reservation-2
CRN crn:v1:bluemix:public:is:jp-tok:a/823bd195e9fd4f0db40ac2e1bffef3e0::reservation:aaaaaaaa-aaaa-default-reservation2-aaaaaaaaaaaa
Status active
Zone us-east-1
Lifecycle state stable
Affinity Policy open
Resource group -
Profile Name mx2-2x16
Created At 2023-06-05:10:41:51.401+05:30
Expiration At Policy Term
2026-08-28T05:11:51.401Z renew three_year
Capacity Allocated Available Total Used Status
8 8 8 0 -
Aggiornamento di una prenotazione
È possibile aggiornare una specifica prenotazione IBM Cloud VPC nella propria regione utilizzando l'interfaccia a riga di comando (CLI). Per aggiornare una prenotazione specifica utilizzando la CLI, utilizza il comando ibmcloud is reservation-update.
È necessario specificare il nome o l'ID della prenotazione specifica utilizzando RESERVATION_NAME per la prenotazione specifica che si desidera aggiornare. Utilizzare la variabile NEW_NAME nell'opzione --name per rinominare la prenotazione.
ibmcloud is reservation-update RESERVATION_NAME [--name NEW_NAME]
Vedi il seguente esempio.
ibmcloud is reservation-update aaaaaaaa-aaaa-default-reservation2-aaaaaaaaaaaa --name aaa-default-reservation-2-renamed
Updating reservation aaaaaaaa-aaaa-default-reservation2-aaaaaaaaaaaa under account ACCOUNT as user user@ibm.com...
ID aaaaaaaa-aaaa-default-reservation2-aaaaaaaaaaaa
Name aaa-default-reservation-2-renamed
CRN crn:v1:bluemix:public:is:us-east:a/823bd195e9fd4f0db40ac2e1bffef3e0::reservation:aaaaaaaa-aaaa-default-reservation2-aaaaaaaaaaaa
Status active
Zone us-east-1
Lifecycle state stable
Affinity Policy open
Resource group -
Profile Name mx2-2x16
Created At 2023-06-14T10:58:17.92+05:30
Expiration At Policy Term
2026-08-28T05:28:17.920Z release three_year
Capacity Allocated Available Total Used Status
5 - 5 - -
Dove vengono utilizzati i seguenti valori di argomenti e opzioni
- --name: Nuovo nome della prenotazione.
- --capacity: La configurazione della capacità per questa prenotazione.
- --term: Durata della prenotazione. Uno di: one_year, three_year.
- --profile: Il nome del profilo da utilizzare per questa prenotazione.
- --profile-resource-type: Il tipo di risorsa del profilo. Uno di: instance_profile.
- ----expiration-policy: La politica che si applica quando scade il termine d'uso impegnato. Uno di: rilasciare, rinnovare.
- --output: Specificare il formato di output; è supportato solo JSON. Uno di: JSON.
- -q, --quiet: sopprime l'output verboso.
Elenco dei profili di istanza con termini di prenotazione
Puoi elencare i profili dell'istanza con termini di riserva nella tua regione utilizzando la CLI (command - line interface). Per elencare i profili dell'istanza con termini di riserva utilizzando la CLI, utilizza il comando ibmcloud is instance-profiles.
ibmcloud is instance-profiles
Vedi il seguente esempio.
ibmcloud is instance-profiles
Listing instance profiles in region us-south under account VPCUI-DEV as user user@ibm.com...
Name vCPU Manufacturer Architecture Family vCPUs Memory(GiB) Bandwidth(Mbps) Volume bandwidth(Mbps) GPUs Storage(GB) Min NIC Count Max NIC Count Status Reservation Terms
bx2-2x8 intel amd64 balanced 2 8 4000 1000 - - 1 5 current -
bx2-2x8-sriov intel amd64 balanced 2 8 4000 1000 - - 1 5 current -
bx2a-2x8 amd amd64 balanced 2 8 2000 500 - - 1 5 current -
bx2d-2x8 intel amd64 balanced 2 8 4000 1000 - 1x75 1 5 previous one_year,three_year
bx3-2x10 intel amd64 balanced 2 10 4000 1000 - - 1 5 current -
bx3d-2x10 intel amd64 balanced 2 10 4000 1000 - 1x65 1 5 current one_year,three_year
Elencare le istanze con una prenotazione
Puoi elencare le istanze con termini di prenotazione nella tua regione utilizzando la CLI (command - line interface). Per elencare istanze con termini di prenotazione utilizzando la CLI, utilizza il comando ibmcloud is instances.
È necessario specificare il nome o l'ID dell'istanza specifica utilizzando il " INSTANCE_NAME per le istanze specifiche che si desidera elencare.
ibmcloud is instances
Vedi il seguente esempio.
ibmcloud is instance instance-cli-test-patch-reservation-1
Getting instance instance-cli-test-patch-reservation-1 under account VPCUI-DEV as user user@ibm.com...
ID 0735_78c1b310-6dc3-45d4-9c01-0335dc526135
Name instance-cli-test-patch-reservation-1
CRN crn:v1:bluemix:public:is:us-south-3:a/a1234567::instance:0735_78c1b310-6dc3-45d4-9c01-0335dc526135
Status running
Availability policy on host failure restart
Startable true
Profile cx2-2x4
Architecture amd64
vCPU Manufacturer intel
vCPUs 2
Memory(GiB) 4
Bandwidth(Mbps) 4000
Volume bandwidth(Mbps) 1000
Network bandwidth(Mbps) 3000
Lifecycle Reasons Code Message
- -
Lifecycle State stable
Metadata service Enabled Protocol Response hop limit
false http 1
Image ID Name
r006-f47cc24c-e020-4db5-ad96-1e5be8b5853b ibm-centos-7-9-minimal-amd64-11
Numa Count 1
VPC ID Name
r006-832aa717-816d-4351-8c44-65399dbfe069 test
Zone us-south-3
Resource group ID Name
11caaa983d9c4beb82690daab08717e9 Default
Created 2023-10-18T18:39:48+05:30
Network Interfaces Interface Name ID Subnet Subnet ID Floating IP Security Groups Allow source IP spoofing Reserved IP
Primary primary 0735-a51439ba-9a96-4f17-867c-89cffcd76c31 sn-20231006-01 0735-3edc7506-bece-4ee6-9c5c-916c750dab57 - dream-grove-spleen-tinwork false 10.240.128.18
Boot volume ID Name Attachment ID Attachment name
r006-4ca2ad61-98c8-4182-a095-82cbd5db2f1f dynastic-thyself-hunter-compile 0735-7cd56e60-025d-4dda-ab17-003457d2df30 sterilize-handlebar-transpire-blender
Reservation Affinity Policy manual
Reservation Affinity Pool ID Name CRN Resource type
0735-4d504e68-b22b-41ed-9a13-6df324301a9f reservation-cli-test-1 crn:v1:bluemix:public:is:us-south-3:a/a1234567::reservation:0735-4d504e68-b22b-41ed-9a13-6df324301a9f reservation
Reservation ID Name CRN Resource type
0735-4d504e68-b22b-41ed-9a13-6df324301a9f reservation-cli-test-1 crn:v1:bluemix:public:is:us-south-3:a/a1234567::reservation:0735-4d504e68-b22b-41ed-9a13-6df324301a9f reservation
Health State ok
Ottenere profili di istanza con termini di prenotazione
Puoi ottenere i profili dell'istanza con termini di prenotazione nella tua regione utilizzando la CLI (command - line interface). Per ottenere i profili dell'istanza con i termini di riserva utilizzando la CLI, utilizza il comando ibmcloud is instance-profile.
ibmcloud is instance-profile PROFILE_NAME
Vedi il seguente esempio.
ibmcloud is instance-profile bx2-2x8
Getting instance profile bx2-2x8 under account VPCUI-DEV as user user@ibm.com...
Name vCPU Manufacturer Architecture Family vCPUs Memory(GiB) Bandwidth(Mbps) Volume bandwidth(Mbps) GPUs Storage(GB) Min NIC Count Max NIC Count Status Reservation Terms
bx2-2x8 intel amd64 balanced 2 8 4000 1000 - - 1 5 current -
Gestione delle prenotazioni tramite l'API
Per gestire una prenotazione tramite l'interfaccia di programmazione dell'applicazione (API), è necessario un ruolo IAM che includa le seguenti azioni. Per ulteriori informazioni, vedi Gestione dell'accesso IAM per i servizi dell'infrastruttura VPC.
- is.reservation.reservation.list
- is.reservation.reservation.read
- is.reservation.reservation.create
- is.reservation.reservation.delete
- is.reservation.reservation.read
- is.reservation.reservation.update
Elenco di tutte le prenotazioni
Puoi elencare tutte le prenotazioni IBM Cloud VPC nella tua regione utilizzando l'API (application programming interface). Per elencare tutte le prenotazioni utilizzando l'API, utilizza List all images.
Specificare una richiesta GET /reservations per elencare tutte le prenotazioni. Vedi il seguente esempio.
curl -X GET "$vpc_api_endpoint/v1/reservations?version=2024-01-27&generation=2" -H "Authorization: Bearer $iam_token"
Le prenotazioni vengono ordinate per prime in base al valore della proprietà create_at. Le prenotazioni più recenti sono elencate per prime. Se le prenotazioni hanno valori di proprietà created_at identici, vengono
ordinate in base ai relativi valori di proprietà name. L'elenco delle prenotazioni è impostato su 50 prenotazioni, ma è possibile aumentarlo fino a 100.
È possibile filtrare ulteriormente l'elenco con i seguenti valori di proprietà.
nameresource_group.idzone.name
Eliminazione di una prenotazione
Puoi eliminare una riserva IBM Cloud VPC nella tua regione utilizzando l'API (application programming interface). Per eliminare una prenotazione utilizzando l'API, utilizza Elimina una prenotazione.
Specificare una richiesta " DELETE /reservation per eliminare una prenotazione. Vedi il seguente esempio.
curl -X DELETE "$vpc_api_endpoint/v1/reservations/$id?version=2024-01-27&generation=2" - H "Authorization: Bearer $iam_token"
Recupero di una prenotazione
Puoi recuperare una prenotazione IBM Cloud VPC specifica nella tua regione utilizzando l'API (application programming interface). Per richiamare una prenotazione specifica utilizzando l'API, utilizza Richiama una prenotazione.
Specificare una richiesta " GET /reservation/{id} per recuperare una prenotazione specifica, dove " id è l'identificativo della prenotazione che si sta recuperando. L'identificatore si trova nel sito URL.
Vedi il seguente esempio.
curl -X GET "$vpc_api_endpoint/v1/reservations/$id?version=2024-01-27&generation=2" - H "Authorization: Bearer $iam_token"
Aggiornamento di una prenotazione
Aggiorni una prenotazione IBM Cloud VPC specifica nella tua regione utilizzando l'API (application programming interface). Per aggiornare una prenotazione specifica utilizzando l'API, utilizza Aggiorna una prenotazione.
Specificare una richiesta PATCH /reservations/{id} per aggiornare una prenotazione specifica dove id è l'identificativo della prenotazione che si sta richiamando. L'identificatore si trova nel sito URL. Vedi il seguente
esempio.
curl -X PATCH "$vpc_api_endpoint/v1/reservations/$id?version=2024-01-27&generation=2" -H "Authorization: Bearer $iam_token" -d '{
"committed_use": {
"expiration_policy": "release"
}
}'
Attivazione di una prenotazione
È possibile attivare una prenotazione specifica IBM Cloud VPC nella propria regione utilizzando l'interfaccia di programmazione delle applicazioni (API). Per attivare una prenotazione specifica tramite l'API, utilizzare Attiva una prenotazione.
Specificare una richiesta POST /reservations/{id}/activate per aggiornare una prenotazione specifica dove id è l'identificativo della prenotazione che si sta richiamando. L'identificatore si trova nel sito URL. Vedi
il seguente esempio.
curl -X POST "$vpc_api_endpoint/v1/reservations/$id/activate?version=2024-01-27&generation=2" -H "Authorization: Bearer $iam_token"