Provisioning di una prenotazione per VPC

Puoi eseguire il provisioning di una prenotazione tramite l'IU, la CLI o l'API.

Prima di iniziare

Assicurati che il tuo account disponga delle autorizzazioni utente necessarie. Al tuo account deve essere assegnato il ruolo Administrator o Editor per il servizio Servizi dell'infrastruttura VPC e Prenotazioni per il tipo di risorsa VPC. È necessaria una di queste autorizzazioni utente per creare una prenotazione. Sono disponibili ulteriori ruoli.

Per ulteriori informazioni sulla gestione dell'accesso IAM, vedi Gestione dell'accesso IAM per i servizi dell'infrastruttura VPC.

Quando si crea una prenotazione, la risorsa di prenotazione viene creata, ma non è fornita o utilizzabile. Lo stato della prenotazione è 'inactive. Per effettuare il provisioning della prenotazione, è necessario attivarla. Quando è attivo, lo stato della prenotazione è 'active.

Provisioning di una riserva con l'IU

In IBM Cloud, segui questi passaggi per attivare la tua prenotazione.

  1. In " IBM Cloud console", fare clic sull'icona " Menu di navigazione " l'icona del menu > Infrastrutture Icona VPC > Prenotazioni.
  2. Per creare una nuova prenotazione, clicca su " Crea".
  3. Dalla pagina Nuova prenotazione per VPC, immettere o selezionare le seguenti informazioni:
Selezioni di provisioning dell'interfaccia utente della prenotazione
Campo Valore
Area geografica Selezionare l'ubicazione specifica per il carico di lavoro. Le località sono composte da regioni. Ogni regione è un'area geografica separata. Tieni presente che non puoi selezionare singole ubicazioni per ogni server virtuale di cui esegui il provisioning all'interno di questa prenotazione. La selezione effettuata rappresenta la posizione in cui verranno collocate tutte le istanze di server virtuali che verranno create nell'ambito di questa prenotazione.
Nome Inserisci un nome per la tua prenotazione.
Gruppo di risorse Seleziona un gruppo di risorse.
Tag Immettere eventuali tag applicabili.
Tag di gestione accesso Immettere eventuali tag di gestione accessi applicabili.
Tipo di prenotazione Disponibile per server virtuali e server bare metal.
Quantità server Immettere il numero di istanze che si desidera assegnare a questa prenotazione (limite di 200 vCPUs).
Durata del periodo Scegliere una durata di 1 o 3 anni.
Profilo server Seleziona un profilo per la tua prenotazione. Quando prenoti la capacità, tieni presenti le seguenti regole.
Non è possibile modificare il profilo una volta effettuata la prenotazione.
Non è possibile combinare profili di dimensioni diverse.
I server virtuali riservati devono avere tutti le stesse dimensioni (tutte le risorse devono essere identiche).
Politica di collegamento alla prenotazione Scegliere un criterio di allegato automatico o limitato.
Opzioni avanzate Attivare Ricaricamento automatico su Attivo se si desidera continuare la prenotazione dopo il completamento della durata selezionata.
  1. Fai clic su " Crea una prenotazione ".

Quando una prenotazione scade, i server collegati a una prenotazione passano alla tariffa on-demand non scontata alla scadenza o al mancato rinnovo della prenotazione e gli eventuali consumi vengono fatturati mensilmente.

Collegamento di un server virtuale esistente a una prenotazione con la IU

È possibile collegare i server virtuali esistenti alla prenotazione se questa ha un criterio di collegamento limitato. Tenete presente che tutti i server virtuali esistenti devono avere lo stesso profilo, le stesse dimensioni, la stessa posizione e la stessa politica di collegamento manuale.

I server virtuali con un criterio di attacco automatico si collegano automaticamente a una prenotazione che ha un criterio di attacco automatico.

Per collegare un server virtuale esistente a una prenotazione, procedere come segue.

  1. Dal tuo elenco di server virtuale, fai clic su Collega.
  2. Selezionare la prenotazione a cui collegare il server e fare clic su Attacca.

Collegamento di un server bare metal esistente a una prenotazione con l'interfaccia utente

È possibile collegare un server bare metal esistente alla prenotazione. Tenete presente che tutti i server bare metal esistenti collegati a una prenotazione devono avere lo stesso profilo, le stesse dimensioni, la stessa posizione e lo stesso criterio di collegamento manuale.

I server bare metal con un criterio di attacco automatico si collegano automaticamente alle prenotazioni con un criterio di attacco automatico.

Usate i seguenti passaggi per collegare un server bare metal esistente a una prenotazione che ha un criterio di collegamento automatico.

  1. Nell'elenco dei server bare metal, fare clic su Attacca.
  2. Selezionare la prenotazione a cui collegare il server e fare clic su Attacca.

Provisioning di una riserva con la CLI

Puoi eseguire il provisioning di una prenotazione utilizzando la CLI (command - line interface). Se vuoi utilizzare le tag utente o le tag di gestione dell'accesso per gestire le tue risorse, vedi Gestione delle tag.

Deprecato IBM Cloud CLI non è supportata su LinuxONE (architettura del processore s390x ). Tuttavia, è possibile installare la CLI su un'altra piattaforma supportata e utilizzarla con le istanze del server virtuale LinuxONE (architettura del processore s390x ).

Prima di iniziare

Raccolta di informazioni per effettuare una prenotazione tramite la CLI

Sei pronto a creare una prenotazione con la CLI? Prima di eseguire il comando is.reservation-create, è necessario conoscere i dettagli relativi alla riserva che si desidera riservare, ad esempio il tipo di prenotazione e la quantità del server.

Raccogliere le seguenti informazioni utilizzando i comandi associati.

Dati di prenotazione richiesti per il CLI
Dettagli prenotazione Opzioni di elenco
Capacità Quantità di capacità da riservare (limite di 200 vCPUs).
Durata del periodo (durata di 1 o 3 anni)
Profilo server

Tieni a mente le regole seguenti quando esegui il provisioning di una prenotazione.

  • Non puoi modificare i profili dopo che la prenotazione è stata creata.
  • Non puoi combinare diverse dimensioni del profilo.
  • I tuoi server virtuali riservati devono avere tutti la stessa dimensione (tutte le risorse devono essere identiche).
Zona Selezionare l'ubicazione specifica per il carico di lavoro. Le ubicazioni sono composte da regioni; ciascuna regione è un'area geografica separata. Tieni presente che non è possibile selezionare posizioni specifiche per ciascun server virtuale che configuri all'interno di questa capacità riservata. La selezione effettuata rappresenta la posizione in cui verranno collocate tutte le istanze di server virtuali che verranno create nell'ambito di questa prenotazione.
Nome Il nome per la tua prenotazione.
Politica di collegamento alla prenotazione Scegliere se si desidera un criterio di allegato automatico o limitato.

Provisioning di una prenotazione utilizzando la CLI

Puoi creare una prenotazione IBM Cloud VPC nella tua regione utilizzando la CLI (command - line interface). Per creare una prenotazione tramite la CLI, utilizzare il comando ibmcloud is reservation-create.

  1. Esegui il provisioning di una prenotazione utilizzando il seguente comando con i dettagli associati.
ibmcloud is reservation-create --capacity NUMBER --term TIME --profile PROFILE --profile-resource-type PROFILE_TYPE --zone ZONE --name NAME

Vedi il seguente esempio.

ibmcloud is reservation-create --capacity 10 --term one_year --profile ba2-2x8 --profile-resource-type instance_profile --zone us-east-1 --name reservation-mock-test-1
Creating reservation with name reservation-mock-test-1 under account ACCOUNT as user user@ibm.com...
ID                22d3ec3b-d798-454a-ad88-fe608ae86ad6
Name              reservation-mock-test-1
CRN               crn:v1:bluemix:public:is:us-east:a/823bd195e9fd4f0db40ac2e1bffef3e0::reservation:22d3ec3b-d798-454a-ad88-fe608ae86ad6
Status            active
Zone              us-east-1
Lifecycle state   stable
Affinity Policy   open
Resource group    -
Profile Name      ba2-2x8
Created At        2023-07-21T10:54:46.29+05:30
Expiration        At   Policy   Term
                  -    -        one_year
Capacity          Allocated   Available   Total   Used   Status
                  10          -           10      -      -

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.
  • --zone: Nome della zona
  • ----affinity-policy: La politica di affinità per questa prenotazione.
  • --expiration-policy: La politica da applicare alla scadenza del periodo di utilizzo impegnato. Uno di: rilasciare, rinnovare.
  • --resource-group-id: ID del gruppo di risorse. Questo ID è mutuamente esclusivo rispetto a --resource-group-name.
  • --resource-group-name: Nome del gruppo di risorse. Questo nome è incompatibile con --resource-group-id.
  • --output: Specificare il formato di output; è supportato solo JSON. Uno di: JSON.
  • -q, --quiet: sopprime l'output verboso.

Passi successivi

Dopo che la tua prenotazione è stata fornita e attiva, puoi Collegare o creare server virtuali utilizzando la console IBM Cloud, la CLI o l'API. Per ulteriori informazioni sulla creazione di un server virtuale, vedi Creazione di istanze del server virtuale.

Collegamento di un server virtuale esistente a una prenotazione con la CLI

È possibile collegare un server virtuale esistente a una prenotazione con un criterio di affinità limitato utilizzando la CLI. Per collegare una prenotazione riservata tramite la CLI, utilizzare il comando ibmcloud is instance-update.

  1. Collega un server virtuale a una prenotazione utilizzando il seguente comando con i dettagli associati.
ibmcloud is instance-update <instance-name> --reservation-affinity-policy manual --reservation-affinity-pool <reservation-name>

Collegamento di un server bare metal esistente a una prenotazione con la CLI

È possibile collegare un server bare metal esistente a una prenotazione con un criterio di affinità limitato utilizzando la CLI. Per creare una prenotazione riservata utilizzando la CLI, utilizza il comando ibmcloud is bare-metal-server-update.

  1. Collegare un server bare metal a una prenotazione utilizzando il seguente comando con i dettagli associati.
ibmcloud is bare-metal-server-update SERVER [--name NEW_NAME] [--enable-secure-boot false | true] [--tpm-mode tpm_2 | disabled] [--bandwidth BANDWIDTH] [--reservation-affinity-policy disabled | manual] [--reservation-affinity-pool RESERVATION_AFFINITY_POOL] [--output JSON] [-q, --quiet]

Creazione di una prenotazione tramite l'API

Puoi creare una riserva IBM Cloud VPC nella tua regione utilizzando l'API (application programming interface). Per creare una prenotazione utilizzando l'API, utilizza Crea una prenotazione.

Specificare una richiesta Post /reservations per creare una nuova prenotazione. Vedi il seguente esempio.

curl -X POST "$vpc_api_endpoint/v1/reservations?version=2024-01-27&generation=2" -H "Authorization: Bearer $iam_token" -d '{
      "capacity": {
        "total": 10
      },
      "committed_use": {
        "expiration_policy": "renew",
        "term": "one_year"
      },
      "name": "my-reservation",
      "profile": {
        "name": "bx2-4x16",
        "resource_type": "instance_profile"
      },
      "zone": {
        "name": "us-south-1"
      }
    }'

Passi successivi

Una volta che la prenotazione è stata creata e attivata, è possibile collegare un server esistente alla prenotazione. In alternativa, è possibile creare server nella propria prenotazione utilizzando la console IBM Cloud, la CLI o l'API. Per ulteriori informazioni sulla creazione di server, vedere Creazione di istanze di server virtuali e Creazione di Bare Metal Servers su VPC.

Creazione di una prenotazione con Terraform

Puoi creare una prenotazione utilizzando Terraform.

Prima di iniziare

Assicurati di configurare Terraform per VPC

Creazione di una prenotazione utilizzando Terraform

Creare una prenotazione utilizzando uno dei seguenti esempi. Per ulteriori informazioni, consulta la documentazione di Terraform su ibm_is_reservation.

Immetti i seguenti comandi Terraform per creare una riserva.

Le prenotazioni sono specifiche della regione e si basano sull'endpoint. Per impostazione predefinita, la regione di destinazione è us - south. Se il tuo VPC si trova in un'altra regione diversa da us - south, assicurati di puntare alla regione corretta nel provider provider.tf.

  • Impostare la region di destinazione.
provider "ibm" {
  region = "us-south"
}
  • Creare una prenotazione.
resource "ibm_is_reservation" "example" {
capacity {
 total = 5
}
committed_use {
 term = "one_year"
}
profile {
 name          = "ba2-2x8"
 resource_type = "instance_profile"
}
zone = "us-east-3"
name = "reservation-terraform-1"
}