Crea una prenotazione per un singolo progetto

Questo documento spiega come creare una prenotazione per un singolo progetto, che può essere utilizzato solo dalle istanze di macchine virtuali (VM) nello stesso progetto. A scopri di più sulle prenotazioni, consulta Prenotazioni delle risorse di zona Compute Engine.

Per altri metodi di creazione delle prenotazioni, consulta invece le pagine seguenti:

  • Se hai impegni di 1 o 3 anni nel progetto attuale, le risorse prenotate ricevono automaticamente l'impegno di utilizzo applicabile sconti. Puoi anche creare e collegare una prenotazione a un impegno quando acquisti l'impegno. Per saperne di più, vedi Collegare le prenotazioni agli impegni.

  • Per creare una prenotazione utilizzabile da più progetti, consulta Crea una prenotazione condivisa.

Prima di iniziare

  • Leggi lo requisiti e limitazioni per le prenotazioni.
  • Se non l'hai già fatto, configura l'autenticazione. Autenticazione è Il processo di verifica dell'identità per l'accesso ai servizi e alle API di Google Cloud. Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi eseguire l'autenticazione Compute Engine come segue.

    Select the tab for how you plan to use the samples on this page:

    Console

    When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

    gcloud

    1. Installa Google Cloud CLI, quindi initialize eseguendo questo comando: 

      gcloud init
    2. Set a default region and zone.

      3. Terraform

      Per utilizzare gli esempi di Terraform in questa pagina in un ambiente dell'ambiente di sviluppo, installare e inizializzare gcloud CLI quindi configura Credenziali predefinite dell'applicazione con le tue credenziali utente.

      1. Installa Google Cloud CLI.

      2. Per initialize gcloud CLI, esegui questo comando: 

        gcloud init

      3. Crea credenziali di autenticazione locali per il tuo Account Google: 

        gcloud auth application-default login

      Per ulteriori informazioni, vedi Set up authentication for a local development environment.

      REST

      Per utilizzare gli esempi di API REST in questa pagina in un ambiente di sviluppo locale, utilizzi le credenziali che fornisci a gcloud CLI.

        Installa Google Cloud CLI, quindi initialize eseguendo questo comando: 

        gcloud init

      Per ulteriori informazioni, vedi Esegui l'autenticazione per l'utilizzo di REST nella documentazione sull'autenticazione di Google Cloud.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per creare prenotazioni per singoli progetti, chiedi all'amministratore di concederti Ruolo IAM Amministratore computing (roles/compute.admin) nel progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso.

Questo ruolo predefinito contiene le autorizzazioni necessarie per creare prenotazioni per singoli progetti. Per vedere le autorizzazioni esatte obbligatorie, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per creare prenotazioni per singoli progetti, sono necessarie le seguenti autorizzazioni:

  • compute.reservations.create del progetto
  • Per specificare un modello di istanza: compute.instanceTemplates.useReadOnly sul modello di istanza

Potresti anche riuscire a ottenere queste autorizzazioni con ruoli personalizzati e altri ruoli predefiniti.

Crea una prenotazione per un singolo progetto

Questa sezione spiega come creare prenotazioni per singoli progetti.

Per utilizzare una prenotazione, una VM deve avere proprietà che corrispondono esattamente la prenotazione. Per specificare le proprietà delle VM che vuoi prenotare, seleziona una delle seguenti sezioni di questo documento:

Per impostazione predefinita, una prenotazione può essere utilizzata automaticamente da qualsiasi VM con proprietà che corrispondono. Se vuoi controllare il consumo delle prenotazioni, eseguine una o più dei seguenti:

Inoltre, puoi specificare criterio di posizionamento compatto quando crei una prenotazione per un singolo progetto. Un criterio di posizionamento compatto specifica che le VM devono essere posizionate il più vicino possibile l'una all'altra per ridurre una latenza di pochi millisecondi.

Specifica un modello di istanza

Per evitare errori durante la creazione di una prenotazione specificando un modello di istanza, verifica quanto segue:

  • Crea la prenotazione nella stessa regione e zona delle risorse solo all'interno del modello di istanza. Qualsiasi regionale o risorse di zona specificato in un modello di istanza, come un tipo di macchina Volume Persistent Disk: limita l'utilizzo del modello alle località in cui si trovano queste risorse. Ad esempio, se il modello di istanza specifica un volume di Persistent Disk esistente nella zona us-central1-a, quindi puoi creare la tua prenotazione solo nella stessa zona. Per verificare se un del modello esistente specifica le risorse che associano il modello a un una regione o una zona specifica, visualizza i dettagli del modello di istanza e cercare riferimenti a risorse regionali o di zona al suo interno.

  • Se il modello di istanza specifica criterio di posizionamento compatto, assicurati che il modello specifichi tipo di macchina supportato per i criteri di posizionamento compatto. In caso contrario, la creazione della prenotazione non va a buon fine.

Per creare una prenotazione per un singolo progetto specificando un modello di istanza, seleziona una delle seguenti opzioni:

Console

  1. Nella console Google Cloud, vai alla pagina Prenotazioni.

    Vai a Prenotazioni

  2. Fai clic su Crea prenotazione.

    Viene visualizzata la pagina Crea una prenotazione.

  3. Nel campo Nome, inserisci un nome per la prenotazione.

  4. Seleziona la regione e la zona in cui vuoi prenotare le risorse.

  5. Nella sezione Tipo di condivisione, fai clic su Locale (impostazione predefinita).

  6. Nella sezione Usa con istanza VM, seleziona una delle seguenti opzioni opzioni:

    • Per consentire alle VM corrispondenti di consumare automaticamente questa prenotazione, Seleziona Utilizza prenotazione automaticamente (impostazione predefinita).

    • Per utilizzare le risorse di questa prenotazione solo durante la creazione delle corrispondenze VM che scelgono specificamente come target questa prenotazione per nome, seleziona Seleziona una prenotazione specifica.

  7. Nel campo Numero di istanze VM, inserisci il numero di VM che che vuoi prenotare.

  8. Nella sezione Configurazione macchina, segui questi passaggi:

    1. Per specificare le proprietà delle VM da un modello modello di istanza, seleziona Utilizza modello di istanza.

    2. Nel campo Modello di istanza, seleziona il modello di istanza la tua scelta. Se selezioni un modello di istanza regionale, può prenotare risorse solo all'interno della regione dell'istanza modello.

  9. Nella sezione Eliminazione automatica, puoi attivare l'opzione di eliminazione automatica. per consentire a Compute Engine di eliminare automaticamente la prenotazione una data e un'ora specifiche. L'eliminazione automatica delle prenotazioni può essere è utile per evitare addebiti inutili quando smetti di utilizzare prenotazione.

  10. Per creare la prenotazione, fai clic su Crea.

    Si apre la pagina Prenotazioni. Creazione della prenotazione per un singolo progetto l'operazione potrebbe richiedere fino a un minuto.

gcloud

Per creare una prenotazione per un singolo progetto, utilizza il Comando gcloud compute reservations create.

Creare una prenotazione per un singolo progetto specificando un modello di istanza. e senza includere flag facoltativi, esegui questo comando:

gcloud compute reservations create RESERVATION_NAME \
    --project=PROJECT_ID \
    --source-instance-template=projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME \
    --vm-count=NUMBER_OF_VMS \
    --zone=ZONE

Sostituisci quanto segue:

  • RESERVATION_NAME: il nome della prenotazione per creare.

  • PROJECT_ID: l'ID del progetto in cui vuoi e dove è presente il modello di istanza.

  • LOCATION: la posizione del modello di istanza. Specifica uno dei seguenti valori:

    • Per un modello di istanza globale: global.

    • Per un modello di istanza regionale: regions/REGION. Sostituisci REGION con la regione in cui si trova l'istanza in cui si trova il modello. Se specifichi un modello di istanza regionale, puoi prenotare le VM solo nella regione del modello di istanza.

  • INSTANCE_TEMPLATE_NAME: il nome di un elemento esistente modello di istanza. Se il modello di istanza specifica un tipo di macchina A3 o un criterio di posizionamento compatto, devi includere Flag --require-specific-reservation. Questo indica che solo le VM che hanno come target specifico la prenotazione può utilizzarlo. Per ulteriori informazioni, vedi Utilizza le VM da una prenotazione specifica.

  • NUMBER_OF_VMS: il numero di VM da prenotare.

  • ZONE: la zona in cui prenotare le risorse.

Ad esempio, per creare una prenotazione per dieci VM nella zona us-central1-a specificando un modello di istanza globale, esegui questo comando:

gcloud compute reservations create my-reservation \
    --project=example-project \
    --source-instance-template=projects/example-project/global/example-instance-template \
    --vm-count=10 \
    --zone=us-central1-a

Facoltativamente, puoi eseguire una o più delle seguenti operazioni:

  • Per specificare che solo le VM che scelgono specificamente come target questa prenotazione possono consumarlo, includere --require-specific-reservation flag.

    gcloud compute reservations create example-reservation \
    --require-specific-reservation \
    ...

  • Per abilitare Compute Engine elimini automaticamente la prenotazione, seleziona uno dei seguenti metodi:

    • Per eliminare la prenotazione in una data e un'ora specifiche, utilizza il Comando gcloud beta compute reservations create e includi il flag --delete-at-time.

      gcloud beta compute reservations create reservation-example \
    --delete-at-time=DELETE_AT_TIME \
    ...

      Sostituisci DELETE_AT_TIME con una data e un'ora formattato come Timestamp RFC 3339, che indica deve essere: none YYYY-MM-DDTHH:MM:SSOFFSET

      Sostituisci quanto segue:

      • YYYY-MM-DD: una data formattata come quattro cifre anno, mese a due cifre e giorno del mese a due cifre, separati per trattini (-).

      • HH:MM:SS: un'ora nel formato a due cifre utilizzando un orario di 24 ore, minuti a 2 cifre e secondi a 2 cifre, separate dai due punti (:).

      • OFFSET: il fuso orario formattato come offset di Tempo coordinato universale (UTC). Ad esempio, per utilizzare il fuso orario PST (Pacific Standard Time), specifica -08:00. In alternativa, per non utilizzare alcun offset, specifica Z.

    • Per eliminare la prenotazione dopo un determinato periodo di tempo, utilizza il metodo Comando gcloud beta compute reservations create e includi il flag --delete-after-duration.

      gcloud beta compute reservations create reservation-example \
    --delete-after-duration=DELETE_AFTER_DURATION \
    ...

      Sostituisci DELETE_AFTER_DURATION con una durata tra giorni, ore, minuti o secondi. Ad esempio, specifica 30m per 30 minuti o 1d2h3m4s per 1 giorno, 2 ore, 3 minuti e 4 secondi.

REST

Per creare una prenotazione per un singolo progetto, invia una richiesta POST al Metodo reservations.insert.

Creare una prenotazione per un singolo progetto specificando un modello di istanza. e senza includere flag facoltativi, effettua la seguente richiesta POST:

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations

{
  "name": "RESERVATION_NAME",
  "specificReservation": {
    "count": "NUMBER_OF_VMS",
    "sourceInstanceTemplate": "projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME"
  }
}

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto in cui vuoi e dove è presente il modello di istanza.

  • ZONE: la zona in cui prenotare le risorse.

  • RESERVATION_NAME: il nome della prenotazione per creare.

  • NUMBER_OF_VMS: il numero di VM da prenotare.

  • LOCATION: la posizione del modello di istanza. Specifica uno dei seguenti valori:

    • Per un modello di istanza globale: global.

    • Per un modello di istanza regionale: regions/REGION. Sostituisci REGION con la regione in cui si trova l'istanza in cui si trova il modello. Se specifichi un modello di istanza regionale, puoi prenotare le VM solo nella regione del modello di istanza.

  • INSTANCE_TEMPLATE_NAME: il nome di un elemento esistente modello di istanza. Se il modello di istanza specifica un tipo di macchina A3 o un criterio di posizionamento compatto, devi includere Campo specificReservationRequired nel corpo della richiesta e impostare il campo su true. Ciò indica che solo le VM che hanno come target questa prenotazione possono consumarla. Per ulteriori informazioni, vedi Utilizza le VM da una prenotazione specifica.

Ad esempio, per creare una prenotazione per dieci VM nella zona us-central1-a specificando un modello di istanza globale, effettua la seguente richiesta POST:

POST https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations

{
  "name": "my-reservation",
  "specificReservation": {
    "count": "10",
    "sourceInstanceTemplate": "projects/example-project/global/instanceTemplates/example-instance-template"
  }
}

Facoltativamente, puoi eseguire una o più delle seguenti operazioni:

  • Per specificare che solo le VM che scelgono specificamente come target questa prenotazione possono utilizzalo, includi il campo specificReservationRequired nella corpo della richiesta e impostare il campo su true.

    POST https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations

{
  "name": "example-reservation",
  "specificReservationRequired": true,
  ...
}

  • Per abilitare Compute Engine elimini automaticamente la prenotazione, seleziona uno dei seguenti metodi:

    • Per eliminare la prenotazione in una data e un'ora specifiche, crea un POST richiesta alla Metodo beta.reservations.insert. Nel corpo della richiesta, includi il campo deleteAtTime.

      POST https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/reservations

{
  "name": "example-reservation",
  "deleteAtTime": "DELETE_AT_TIME",
  ...
}

      Sostituisci DELETE_AT_TIME con una data e un'ora formattato come Timestamp RFC 3339, che indica deve essere:

      YYYY-MM-DDTHH:MM:SSOFFSET

      Sostituisci quanto segue:

      • YYYY-MM-DD: una data formattata come quattro cifre anno, mese a due cifre e giorno del mese a due cifre, separati per trattini (-).

      • HH:MM:SS: un'ora nel formato a due cifre utilizzando un orario di 24 ore, minuti a 2 cifre e secondi a 2 cifre, separate dai due punti (:).

      • OFFSET: il fuso orario formattato come offset di Tempo coordinato universale (UTC). Ad esempio, per utilizzare il fuso orario PST (Pacific Standard Time), specifica -08:00. In alternativa, per non utilizzare alcun offset, specifica Z.

    • Per eliminare la prenotazione dopo un determinato periodo di tempo, crea una POST richiesta alla Metodo beta.reservations.insert. Nel corpo della richiesta, includi il campo deleteAfterDuration.

      POST https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/reservations

{
  "name": "example-reservation",
  "deleteAfterDuration": {
    "seconds": "DELETE_AFTER_DURATION"
  },
  ...
}

      Sostituisci DELETE_AFTER_DURATION con una durata tra secondi. Ad esempio, specifica 86400 per 86.400 secondi (1 giorno).

Specifica direttamente le proprietà

Per creare una prenotazione per un singolo progetto specificando direttamente le proprietà, seleziona una delle seguenti opzioni:

Console

  1. Nella console Google Cloud, vai alla pagina Prenotazioni.

    Vai a Prenotazioni

  2. Fai clic su Crea prenotazione.

    Viene visualizzata la pagina Crea una prenotazione.

  3. Nel campo Nome, inserisci un nome per la prenotazione.

  4. Seleziona la regione e la zona in cui vuoi prenotare le risorse.

  5. Nella sezione Tipo di condivisione, fai clic su Locale (impostazione predefinita).

  6. Nella sezione Usa con istanza VM, seleziona una delle seguenti opzioni opzioni:

    • Per consentire alle VM corrispondenti di consumare automaticamente questa prenotazione, Seleziona Utilizza prenotazione automaticamente (impostazione predefinita).

    • Per utilizzare le risorse di questa prenotazione solo durante la creazione delle corrispondenze VM che scelgono specificamente come target questa prenotazione per nome, seleziona Seleziona una prenotazione specifica.

  7. Nel campo Numero di istanze VM, inserisci il numero di VM che che vuoi prenotare.

  8. Nella sezione Configurazione macchina, seleziona Specifica il tipo di macchina, quindi specifica quanto segue:

    1. In Famiglia di macchine, Serie e Tipo di macchina seleziona una famiglia, una serie e un tipo di macchina.

    2. (Facoltativo) Per specificare una piattaforma CPU minima o collegare GPU a N1 VM:

      1. Per espandere la sezione Piattaforma CPU e GPU, fai clic sul pulsante Espansione freccia.

      2. (Facoltativo) Per specificare una piattaforma CPU minima, nel campo Piattaforma CPU, seleziona un'opzione.

      3. (Facoltativo) Per collegare le GPU alle VM N1, fai clic su Aggiungi GPU. Poi, nel i campi Tipo di GPU e Numero di GPU, seleziona il tipo e il numero di GPU da collegare a ogni VM N1.

    3. (Facoltativo) Per aggiungere dischi SSD locali:

      1. Nel campo Numero di dischi, seleziona il numero di dischi di dischi SSD per ogni VM.

      2. Nel campo Tipo di interfaccia, seleziona l'interfaccia per Dischi SSD locali.

    4. (Facoltativo) Per specificare un criterio di posizionamento compatto per una prenotazione. che soddisfa requirements, fai clic sull'elenco Seleziona o crea un criterio di posizionamento del gruppo e quindi esegui una delle seguenti operazioni:

      • Per creare un criterio di posizionamento compatto da specificare in questo per effettuare una prenotazione, segui questi passaggi:

        1. Fai clic su Crea criterio di posizionamento del gruppo.

          Viene visualizzato il riquadro Crea un criterio di posizionamento del gruppo.

        2. Nel campo Nome norma, inserisci un nome per il tuo .

        3. Fai clic su Crea.

          La creazione del criterio di posizionamento compatto potrebbe richiedere alcuni secondi per completare l'operazione.

      • Altrimenti, seleziona un criterio di posizionamento compatto esistente.

  9. Nella sezione Eliminazione automatica, puoi attivare l'opzione di eliminazione automatica. per consentire a Compute Engine di eliminare automaticamente la prenotazione una data e un'ora specifiche. L'eliminazione automatica delle prenotazioni può essere è utile per evitare addebiti inutili quando smetti di utilizzare prenotazione.

  10. Per creare la prenotazione, fai clic su Crea.

    La creazione della prenotazione per un singolo progetto potrebbe richiedere del tempo completato. Questa azione ti reindirizza alla pagina Prenotazioni.

gcloud

Per creare una prenotazione per un singolo progetto, utilizza il Comando gcloud compute reservations create.

Per creare una prenotazione per un singolo progetto specificando direttamente le proprietà e senza includere flag facoltativi, esegui questo comando:

gcloud compute reservations create RESERVATION_NAME \
    --machine-type=MACHINE_TYPE \
    --project=PROJECT_ID \
    --vm-count=NUMBER_OF_VMS \
    --zone=ZONE

Sostituisci quanto segue:

  • RESERVATION_NAME: il nome della prenotazione per creare.

  • MACHINE_TYPE: un tipo di macchina da utilizzare per ogni VM. Se se specifichi un tipo di macchina A3, devi includere Flag --require-specific-reservation. Questo indica che solo le VM che hanno come target specifico la prenotazione può utilizzarlo. Per ulteriori informazioni, vedi Utilizza le VM da una prenotazione specifica.

  • PROJECT_ID: l'ID del progetto in cui vuoi per prenotare le risorse.

  • NUMBER_OF_VMS: il numero di VM da prenotare.

  • ZONE: la zona in cui prenotare le risorse.

Ad esempio, per creare una prenotazione nella zona us-central1-a per dieci VM ognuna con un tipo di macchina predefinita N2 con 4 vCPU, seguente comando:

gcloud compute reservations create my-reservation \
    --machine-type=n2-standard-4 \
    --project=example-project \
    --vm-count=10 \
    --zone=us-central1-a

Facoltativamente, puoi eseguire una o più delle seguenti operazioni:

  • Per collegare le GPU alle VM N1 prenotate, includi --accelerator flag.

    gcloud compute reservations create my-reservation \
    --accelerator=count=NUMBER_OF_ACCELERATORS,type=ACCELERATOR_TYPE
    ...

    Sostituisci quanto segue:

  • Per aggiungere uno o più dischi SSD locali a ogni VM prenotata, includi uno o più flag --local-ssd. Puoi e specificare fino a 24 dischi SSD locali. Ogni disco SSD locale ha una dimensione di 375 GB.

    Ad esempio, per specificare due dischi SSD locali durante la creazione di una prenotazione, includi due flag --local-ssd come segue:

    gcloud compute reservations create my-reservation \
    --local-ssd=size=375,interface=INTERFACE_1 \
    --local-ssd=size=375,interface=INTERFACE_2 \
    ...

    Sostituisci INTERFACE_1 e INTERFACE_2 con il tipo di interfaccia che vuoi Disco SSD locale da utilizzare. Specifica uno dei seguenti valori:

    • Interfacce disco NVME: nvme

    • Interfacce disco SCSI: scsi

    Assicurati che il tipo di macchina specificato per le VM prenotate supporta le interfacce del disco scelte. In caso contrario, la creazione della prenotazione non riesce. Per ulteriori informazioni, scopri come scegli un'interfaccia del disco.

  • Per fare in modo che le VM prenotate utilizzino una specifica piattaforma CPU minima anziché la piattaforma CPU predefinita della zona, includi Flag --min-cpu-platform.

    gcloud compute reservations create my-reservation \
    --min-cpu-platform="MIN_CPU_PLATFORM" \
    ...

    Sostituisci MIN_CPU_PLATFORM con una piattaforma CPU minima. Per assicurarti che sia disponibile una piattaforma CPU nella zona in cui ti trovi prenotare risorse, visualizza le piattaforme CPU disponibili per zona.

  • Per specificare che solo le VM che scelgono specificamente come target questa prenotazione possono consumarlo, includere --require-specific-reservation flag.

    gcloud compute reservations create example-reservation \
    --require-specific-reservation \
    ...

  • Per specificare un criterio di posizionamento compatto per una latenza di rete più bassa tra le VM, includi Flag --resource-policies=policy.

    gcloud compute reservations create example-reservation \
    --resource-policies=policy=COMPACT_PLACEMENT_POLICY_NAME \
    --require-specific-reservation \
    ...

    Sostituisci COMPACT_PLACEMENT_POLICY_NAME con il nome di un criterio di posizionamento compatto esistente. Inoltre, per evitare errori quando creando una prenotazione per un singolo progetto che specifica un posizionamento compatto assicurati di specificare quanto segue:

    • R tipo di macchina supportato e numero massimo di VM per i criteri di posizionamento compatto.

    • Una zona all'interno della regione in cui è individuarlo.

    • Il flag --require-specific-reservation. Questo indica che Le VM che hanno come target specifico la prenotazione possono consumarla.

  • Per abilitare Compute Engine elimini automaticamente la prenotazione, seleziona uno dei seguenti metodi:

    • Per eliminare la prenotazione in una data e un'ora specifiche, utilizza il Comando gcloud beta compute reservations create e includi il flag --delete-at-time.

      gcloud beta compute reservations create reservation-example \
    --delete-at-time=DELETE_AT_TIME \
    ...

      Sostituisci DELETE_AT_TIME con una data e un'ora formattato come Timestamp RFC 3339, che indica deve essere:

      YYYY-MM-DDTHH:MM:SSOFFSET

      Sostituisci quanto segue:

      • YYYY-MM-DD: una data formattata come quattro cifre anno, mese a due cifre e giorno del mese a due cifre, separati per trattini (-).

      • HH:MM:SS: un'ora nel formato a due cifre utilizzando un orario di 24 ore, minuti a 2 cifre e secondi a 2 cifre, separate dai due punti (:).

      • OFFSET: il fuso orario formattato come offset di Tempo coordinato universale (UTC). Ad esempio, per utilizzare il fuso orario PST (Pacific Standard Time), specifica -08:00. In alternativa, per non utilizzare alcun offset, specifica Z.

    • Per eliminare la prenotazione dopo un determinato periodo di tempo, utilizza il metodo Comando gcloud beta compute reservations create e includi il flag --delete-after-duration.

      gcloud beta compute reservations create reservation-example \
    --delete-after-duration=DELETE_AFTER_DURATION \
    ...

      Sostituisci DELETE_AFTER_DURATION con una durata tra giorni, ore, minuti o secondi. Ad esempio, specifica 30m per 30 minuti o 1d2h3m4s per 1 giorno, 2 ore, 3 minuti e 4 secondi.

Terraform

Per creare una prenotazione per un singolo progetto, utilizza il google_compute_reservation Risorsa Terraform.

Ad esempio, per creare una prenotazione per un singolo progetto per una con 2 vCPU, utilizza la risorsa seguente:


resource "google_compute_reservation" "default" {
  name = "gce-reservation-local"
  zone = "us-central1-a"

  /**
   * To specify a single-project reservation, omit the share_settings block
   * (default) or set the share_type field to LOCAL.
   */
  share_settings {
    share_type = "LOCAL"
  }

  specific_reservation {
    count = 1
    instance_properties {
      machine_type = "n2-standard-2"
    }
  }

  /**
   * To let VMs with affinity for any reservation consume this reservation, omit
   * the specific_reservation_required field (default) or set it to false.
   */
  specific_reservation_required = false
}

Per saperne di più su come utilizzare Terraform, consulta Utilizzo di Terraform con Google Cloud.

REST

Per creare una prenotazione per un singolo progetto, invia una richiesta POST al Metodo reservations.insert.

Per creare una prenotazione per un singolo progetto specificando direttamente le proprietà e senza includere campi facoltativi, imposta i seguenti POST richiesta:

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations

{
  "name": "RESERVATION_NAME",
  "specificReservation": {
    "count": "NUMBER_OF_VMS",
    "instanceProperties": {
      "machineType": "MACHINE_TYPE",
    }
  }
}

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto in cui vuoi per prenotare le risorse.

  • ZONE: la zona in cui prenotare le risorse.

  • RESERVATION_NAME: il nome della prenotazione per creare.

  • NUMBER_OF_VMS: il numero di VM da prenotare.

  • MACHINE_TYPE: un tipo di macchina da utilizzare per ogni VM. Se se specifichi un tipo di macchina A3, devi includere Campo specificReservationRequired in il corpo della richiesta e impostare il campo su true. Ciò indica che Le VM che hanno come target specifico la prenotazione possono consumarla. Per ulteriori informazioni le informazioni, vedi Utilizza le VM da una prenotazione specifica.

Ad esempio, per creare una prenotazione nella zona us-central1-a per dieci VM che utilizzano ciascuna un tipo di macchina predefinita N2 con 4 vCPU, seguente richiesta di POST:

POST https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations

{
  "name": "my-reservation",
  "specificReservation": {
    "count": "10",
    "instanceProperties": {
      "machineType": "n2-standard-4",
    }
  }
}

Facoltativamente, puoi eseguire una o più delle seguenti operazioni:

  • Per collegare le GPU alle VM N1 prenotate, includi guestAccelerators nel corpo della richiesta.

    POST https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations

{
  "name": "example-reservation",
  "specificReservation": {
    "instanceProperties": {
      "guestAccelerators": [
        {
          "acceleratorCount": NUMBER_OF_ACCELERATORS,
          "acceleratorType": "ACCELERATOR_TYPE"
        }
      ],
      ...
    },
    ...
  }
}

    Sostituisci quanto segue:

  • Per aggiungere uno o più dischi SSD locali a per ogni VM prenotata, includi il campo localSsds nel corpo della richiesta. Tu può specificare fino a 24 dischi SSD locali. Ogni disco SSD locale 375 GB.

    Ad esempio, per specificare due dischi SSD locali durante la creazione di una prenotazione, specificare quanto segue:

    POST https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations

{
  "name": "example-reservation",
  "specificReservation": {
    "instanceProperties": {
      "localSsds": [
        {
          "diskSizeGb": "375",
          "interface": "INTERFACE_1"
        },
        {
          "diskSizeGb": "375",
          "interface": "INTERFACE_2"
        }
      ],
      ...
    },
    ...
  }
}

    Sostituisci INTERFACE_1 e INTERFACE_2 con il tipo di interfaccia desiderato Disco SSD locale da utilizzare. Specifica uno dei seguenti valori:

    • Interfacce dei dischi NVME: NVME

    • Interfacce disco SCSI: SCSI

    Assicurati che il tipo di macchina specificato per le VM prenotate supporta le interfacce del disco scelte. In caso contrario, la creazione della prenotazione non riesce. Per ulteriori informazioni, scopri come scegli un'interfaccia del disco.

  • Per fare in modo che le VM prenotate utilizzino un modello piattaforma CPU minima anziché la piattaforma CPU predefinita della zona, includi minCpuPlatform nel corpo della richiesta.

    POST https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations

{
  "name": "example-reservation",
  "specificReservation": {
    "instanceProperties": {
      "minCpuPlatform": "MIN_CPU_PLATFORM",
      ...
    },
    ...
  }
}

    Sostituisci MIN_CPU_PLATFORM con una piattaforma CPU minima. Per assicurarti che sia disponibile una piattaforma CPU nella zona in cui ti trovi prenotare risorse, visualizza le piattaforme CPU disponibili per zona.

  • Per specificare un criterio di posizionamento compatto per ridurre la latenza di rete tra le VM prenotate, includi resourcePolicies nel corpo della richiesta.

    POST https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations

{
  "name": "example-reservation",
  "resourcePolicies": {
    "policy" : "projects/example-project/regions/REGION/resourcePolicies/COMPACT_PLACEMENT_POLICY_NAME"
  },
  "specificReservationRequired": true,
  ...
}

    Sostituisci quanto segue:

    • REGION: la regione in cui il posizionamento compatto . Puoi creare la prenotazione solo all'interno regione del criterio di posizionamento.

    • COMPACT_PLACEMENT_POLICY_NAME: il nome di un criterio di posizionamento compatto esistente.

    Inoltre, per evitare errori durante la creazione di una prenotazione per un singolo progetto che specifica un criterio di posizionamento compatto, assicurati di specificare seguenti:

    • R tipo di macchina supportato per i criteri di posizionamento compatto.

    • Il campo specificReservationRequired è stato impostato su true. Questo indica che solo le VM che scelgono specificamente come target questa prenotazione può utilizzarlo.

  • Per specificare che solo le VM che scelgono specificamente come target questa prenotazione possono utilizzalo, includi il campo specificReservationRequired nella corpo della richiesta e impostare il campo su true.

    POST https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations

{
  "name": "example-reservation",
  "specificReservationRequired": true,
  ...
}

  • Per abilitare Compute Engine elimini automaticamente la prenotazione, seleziona uno dei seguenti metodi:

    • Per eliminare la prenotazione in una data e un'ora specifiche, crea un POST richiesta alla Metodo beta.reservations.insert. Nel corpo della richiesta, includi il campo deleteAtTime.

      POST https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/reservations

{
  "name": "example-reservation",
  "deleteAtTime": "DELETE_AT_TIME",
  ...
}

      Sostituisci DELETE_AT_TIME con una data e un'ora formattato come Timestamp RFC 3339, che indica deve essere:

      YYYY-MM-DDTHH:MM:SSOFFSET

      Sostituisci quanto segue:

      • YYYY-MM-DD: una data formattata come quattro cifre anno, mese a due cifre e giorno del mese a due cifre, separati per trattini (-).

      • HH:MM:SS: un'ora nel formato a due cifre utilizzando un orario di 24 ore, minuti a 2 cifre e secondi a 2 cifre, separate dai due punti (:).

      • OFFSET: il fuso orario formattato come offset di Tempo coordinato universale (UTC). Ad esempio, per utilizzare il fuso orario PST (Pacific Standard Time), specifica -08:00. In alternativa, per non utilizzare alcun offset, specifica Z.

    • Per eliminare la prenotazione dopo un determinato periodo di tempo, crea una POST richiesta alla Metodo beta.reservations.insert. Nel corpo della richiesta, includi il campo deleteAfterDuration.

      POST https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/reservations

{
  "name": "example-reservation",
  "deleteAfterDuration": {
    "seconds": "DELETE_AFTER_DURATION"
  },
  ...
}

      Sostituisci DELETE_AFTER_DURATION con una durata tra secondi. Ad esempio, specifica 86400 per 86.400 secondi (1 giorno).

Passaggi successivi