Gestione di una prenotazione per VPC

Una volta effettuata la prenotazione, è possibile gestire la prenotazione con le seguenti azioni.

Azioni per la gestione delle prenotazioni dei server virtuali
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.

  1. In " IBM Cloud console", fare clic sull'icona " Menu di navigazione " l'icona del menu > Infrastrutture Icona VPC > Prenotazioni.
  2. Selezionare una prenotazione nella pagina Dettagli prenotazione.
  3. Dall'elenco dei server virtuali, fai clic su Azioni > Collega.
  4. 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.

  1. In " IBM Cloud console", fare clic sull'icona " Menu di navigazione " l'icona del menu > Infrastrutture Icona VPC > Prenotazioni.
  2. 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.
  3. 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.

  1. In " IBM Cloud console", fare clic sull'icona " Menu di navigazione " l'icona del menu > Infrastrutture Icona VPC > Prenotazioni.
  2. Dall'elenco Prenotazioni, fare clic su Azioni > Elimina prenotazione.
  3. 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à.

  • name
  • resource_group.id
  • zone.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"