Questo documento spiega come creare prenotazioni condivise, condivisi tra più progetti e gestisci i progetti della tua organizzazione possono utilizzare le prenotazioni condivise.
Una prenotazione condivisa può essere utilizzata dal progetto che ospita la prenotazione (progetto proprietario) e dai progetti con cui è condivisa la prenotazione (consumer progetti). Utilizza le prenotazioni condivise se la tua organizzazione ha più progetti che richiedono istanze di macchine virtuali (VM) con le stesse proprietà riservate. Utilizzando le prenotazioni condivise, puoi migliorare l'utilizzo delle e ridurre il numero di prenotazioni che dovrai creare gestire. Per scoprire 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 (CUD). 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 che possa essere utilizzata da un solo progetto, consulta Crea una prenotazione per un singolo progetto.
Prima di iniziare
- Leggi lo requisiti e . limitazioni per le prenotazioni.
- Leggi lo requisiti e . limitazioni per le prenotazioni condivise.
- Assicurati che il progetto che utilizzi per creare prenotazioni condivise sia stato aggiunto
Alla lista consentita dei progetti del proprietario di prenotazioni condivise
Criterio dell'organizzazione (
compute.sharedReservationsOwnerProjects
) limitato da un amministratore dei criteri dell'organizzazione. Questa lista consentita è vuota da per impostazione predefinita, quindi non puoi creare prenotazioni condivise finché la tua organizzazione concede questa autorizzazione a uno o più progetti. Per ulteriori dettagli sulla visualizzazione e sulla modifica del vincolo dei criteri dell'organizzazione, consulta Consentire e limitare i progetti creazione e modifica delle prenotazioni condivise in questo documento. -
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
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
- Set a default region and zone.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
Create local authentication credentials for your user account:
gcloud auth application-default login
-
Amministratore Compute (
roles/compute.admin
) del progetto -
Per visualizzare e modificare i criteri dell'organizzazione:
Amministratore criteri organizzazione (
roles/orgpolicy.policyAdmin
) dell'organizzazione -
compute.reservations.create
del progetto -
Per visualizzare i criteri dell'organizzazione:
orgpolicy.policy.get
dell'organizzazione -
Per modificare i criteri dell'organizzazione:
orgpolicy.policy.set
dell'organizzazione -
Per specificare un modello di istanza:
compute.instanceTemplates.useReadOnly
sul modello di istanza -
Fai in modo che il progetto del proprietario crei la prenotazione condivisa, ma non la utilizzi.
- Per distribuire la spesa tra i progetti, si consiglia di avere solo i progetti consumer utilizzano una prenotazione condivisa. Il progetto proprietario deve da utilizzare solo per creare la prenotazione condivisa.
- Il progetto proprietario deve avere una quota sufficiente per il doppio delle risorse per prenotare. Per ulteriori informazioni, vedi Requisiti aggiuntivi per le prenotazioni condivise.
-
Riduci al minimo il numero di progetti nella tua organizzazione a cui consenti di
per creare prenotazioni condivise. Puoi controllare questo comportamento tramite il pulsante
Progetti con proprietario delle prenotazioni
Criterio dell'organizzazione (
compute.sharedReservationsOwnerProjects
) di blocco.- Puoi elencare solo le prenotazioni create da ciascun progetto. Ciò significa che le prenotazioni condivise siano elencate solo nel progetto del proprietario, impossibile elencare le prenotazioni condivise con ciascun progetto o tutte le prenotazioni in ogni organizzazione, perciò avere solo pochi di progetto semplifica il monitoraggio e la gestione prenotazioni.
- Limita la condivisione di una prenotazione condivisa a pochi progetti solo a e gestire più facilmente la quota delle risorse prenotate.
- Per ulteriori informazioni, vedi Consenti e limita i progetti da creazione e modifica delle prenotazioni condivise.
-
Riduci al minimo il numero di prenotazioni condivise separate con una VM identica
proprietà.
- Un'organizzazione può avere fino a 100 prenotazioni condivise per ogni combinazione di VM proprietà. Di conseguenza, riducendo al minimo il numero di prenotazioni condivise, con proprietà VM identiche che crei aiutano a mitigare limite.
- Avere meno prenotazioni condivise migliora la gestibilità.
-
Condividi le prenotazioni solo tra progetti con la stessa fatturazione Cloud
.
- Limita ogni prenotazione condivisa alla condivisione solo con progetti consumer che hanno lo stesso account di fatturazione Cloud del progetto proprietario. In questo modo è più facile vedere se una prenotazione è stata fruita e come è stato fatturato.
- Se hai attivato alla condivisione dello sconto per impegno di utilizzo (CUD) e sei idoneo a ricevere sconti per impegno di utilizzo (CUD) al A livello di account di fatturazione Cloud, quindi, per massimizzare gli sconti per impegno di utilizzo (CUD) ricevi per le prenotazioni che hai utilizzato, limita le prenotazioni condivise a l'account di fatturazione Cloud di tale impegno. In questo modo mantieni una fatturazione coerente tra i progetti che creano e utilizzano prenotazioni.
Scarica il criterio per la tua organizzazione come file denominato
policy.yaml
, utilizzando Comandogcloud resource-manager org-policies describe
:gcloud resource-manager org-policies describe compute.sharedReservationsOwnerProjects --organization=ORGANIZATION_ID > policy.yaml
Sostituisci ORGANIZATION_ID con ID organizzazione della tua organizzazione.
Utilizza un editor di testo per aprire il file
policy.yaml
e visualizzare Vincolocompute.sharedReservationsOwnerProjects
. I progetti a cui è consentito creare e modificare prenotazioni condivise sottoallowedValues
:... constraint: constraints/compute.sharedReservationsOwnerProjects listPolicy: allowedValues: - projects/PROJECT_NUMBER_1 - projects/PROJECT_NUMBER_2 - projects/PROJECT_NUMBER_3 ...
dove PROJECT_NUMBER_1, PROJECT_NUMBER_2 e PROJECT_NUMBER_3 sono i numeri di progetto degli unici progetti nella tua organizzazione a cui è consentito per creare prenotazioni condivise.
(Facoltativo) Elimina il file
policy.yaml
.Se utilizzi un terminale Linux o macOS, usa il seguente comando:
rm policy.yaml
Se utilizzi un terminale Windows, usa il seguente comando:
del policy.yaml
Concedere a un singolo progetto l'autorizzazione alla creazione e alla modifica per le prenotazioni condivise, utilizza Comando
gcloud resource-manager org-policies allow
. Puoi ripetere questo comando per ogni progetto che vuoi concedere questa autorizzazione.gcloud resource-manager org-policies allow compute.sharedReservationsOwnerProjects projects/PROJECT_NUMBER \ --organization=ORGANIZATION_ID
Sostituisci quanto segue:
- PROJECT_NUMBER: il numero progetto (non l'ID progetto) di un progetto nell'organizzazione a cui vuoi permettono di creare e modificare prenotazioni condivise.
- ORGANIZATION_ID: il ID organizzazione della tua organizzazione.
Per concedere o revocare le autorizzazioni per più progetti a creare e modificare prenotazioni condivise, sostituire l'organizzazione vincolo del criterio:
Per scaricare il criterio per la tua organizzazione come file denominato
policy.yaml
, utilizza la Comandogcloud resource-manager org-policies describe
:gcloud resource-manager org-policies describe compute.sharedReservationsOwnerProjects --organization=ORGANIZATION_ID > policy.yaml
Sostituisci ORGANIZATION_ID con ID organizzazione della tua organizzazione.
Utilizza un editor di testo per modificare il file
policy.yaml
in modo che Il vincolocompute.sharedReservationsOwnerProjects
elenca tutte le a cui vuoi consentire la creazione e la modifica di progetti condivisi inallowedValues
.- Per ogni progetto a cui vuoi concedere l'autorizzazione alla creazione.
e modificare le prenotazioni condivise, aggiungi il progetto in una nuova riga
allowedValues
. - Per ogni progetto per cui vuoi revocare l'autorizzazione di creazione. e modificare le prenotazioni condivise, elimina la riga per quel progetto.
Quando hai finito, assicurati che il file
policy.yaml
sia simile al seguente:... constraint: constraints/compute.sharedReservationsOwnerProjects listPolicy: allowedValues: - projects/PROJECT_NUMBER_1 - projects/PROJECT_NUMBER_2 - projects/PROJECT_NUMBER_3 ...
dove PROJECT_NUMBER_1, PROJECT_NUMBER_2 e PROJECT_NUMBER_3 sono i numeri di progetto (non gli ID progetto) di tutti i progetti nella tua organizzazione che vuoi avere l'autorizzazione per creare e modificare prenotazioni condivise.
- Per ogni progetto a cui vuoi concedere l'autorizzazione alla creazione.
e modificare le prenotazioni condivise, aggiungi il progetto in una nuova riga
Salva il file
policy.yaml
e chiudi l'editor di testo.Per aggiornare il criterio per la tua organizzazione con le modifiche, utilizza il Comando
gcloud resource-manager org-policies set-policy
:gcloud resource-manager org-policies set-policy --organization=ORGANIZATION_ID policy.yaml
Sostituisci ORGANIZATION_ID con ID organizzazione della tua organizzazione.
(Facoltativo) Elimina il file
policy.yaml
.Se utilizzi un terminale Linux o macOS, usa il seguente comando:
rm policy.yaml
Se utilizzi un terminale Windows, usa il seguente comando:
del policy.yaml
Consigliato: Specifica un modello di istanza
Questa sezione spiega come utilizzare un modello di istanza per definire le proprietà di una prenotazione condivisa. Utilizzando un modello di istanza, puoi definiscono le proprietà di una prenotazione e le VM che possono utilizzare nello stesso luogo. Tuttavia, poiché i modelli di un progetto specifico, non puoi utilizzare lo stesso modello per creare VM consumare la prenotazione all'esterno del progetto che ha creato la prenotazione. Per i progetti con cui è condivisa la prenotazione, devi creare file i modelli in questi progetti o creare VM specificando direttamente le proprietà.
Specificare le proprietà direttamente
Questa sezione spiega come definire direttamente le proprietà di un elemento prenotazione. Questo metodo richiede di verificare manualmente che le proprietà delle VM e delle prenotazioni corrispondono esattamente: le proprietà non corrispondenti ne impediscono il consumo.
Crea una prenotazione che possa essere utilizzata solo dalle VM che specificamente come descritto nelle sezioni seguenti di questo documento. Quindi, configura le VM in modo che utilizzino quella specifica prenotazione.
Configura le VM che non possono utilizzare nessuna prenotazione.
Un modello di istanza contiene impostazioni specifiche del progetto, quindi puoi e utilizzare un modello di istanza all'interno dello stesso progetto. Se crei un per una prenotazione condivisa specificando un modello di istanza, lo stesso modello per creare VM che possono utilizzare la prenotazione all'esterno al progetto che ha creato la prenotazione.
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.Nella console Google Cloud, vai alla pagina Prenotazioni.
Viene visualizzata la pagina Prenotazioni.
Fai clic su
Crea prenotazione.Viene visualizzata la pagina Crea una prenotazione.
Nel campo Nome, inserisci un nome per la prenotazione.
Seleziona la regione e la zona in cui vuoi prenotare le risorse.
Nella sezione Tipo di condivisione, procedi nel seguente modo:
Per specificare una prenotazione condivisa, fai clic su Condivisa.
Fai clic su
Aggiungi progetti. quindi seleziona i progetti dall'organizzazione del progetto attuale con cui vuoi condividere la prenotazione.
Nella sezione Usa con istanza VM, seleziona una delle seguenti opzioni opzioni:
per consentire alle istanze VM corrispondenti di usare automaticamente questo 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.
Nel campo Numero di istanze VM, inserisci il numero di VM che che vuoi prenotare.
Nella sezione Configurazione macchina, segui questi passaggi:
Per specificare le proprietà delle VM da un modello modello di istanza, seleziona Utilizza modello di istanza.
Nel campo Modello di istanza, seleziona il modello di istanza la tua scelta. Se selezioni un modello di istanza regionale, puoi prenota risorse solo all'interno della regione del modello di istanza.
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.
Per creare la prenotazione, fai clic su Crea.
La creazione della prenotazione condivisa potrebbe richiedere un po' di tempo. Questo ti reindirizza alla pagina Prenotazioni.
RESERVATION_NAME
: il nome della prenotazione per creare.PROJECT_ID
: l'ID del progetto in cui vuoi e dove è presente il modello di istanza.CONSUMER_PROJECT_IDS
: un elenco separato da virgole di ID dei progetti che possono utilizzare questa prenotazione, ad esempioproject-1,project-2
. Puoi includere fino a 100 progetti consumer. Questi progetti devono trovarsi nella stessa organizzazione del progetto del proprietario. Non includere il progetto del proprietario. Per impostazione predefinita, è già consentito la prenotazione.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
. SostituisciREGION
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 una macchina A3 devi includere il valore 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.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
con 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, specificaZ
.
Per eliminare la prenotazione dopo un determinato periodo di tempo, utilizza il metodo Comando
gcloud beta compute reservations create
con 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, specifica30m
per 30 minuti o1d2h3m4s
per 1 giorno, 2 ore, 3 minuti e 4 secondi.
Il campo
projectMap
.Il campo
shareType
è stato impostato suSPECIFIC_PROJECTS
.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.CONSUMER_PROJECT_ID_1
eCONSUMER_PROJECT_ID_2
: il ID dei progetti che possono utilizzare questa prenotazione. Puoi includere fino a 100 segmenti di pubblico in modo programmatico a gestire i progetti. Questi progetti devono trovarsi nella stessa organizzazione del proprietario progetto. Non includere il progetto del proprietario. Per impostazione predefinita, autorizzati a utilizzare la prenotazione.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
. SostituisciREGION
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 una macchina A3 devi includere il valore CampospecificReservationRequired
nel corpo della richiesta e impostare il campo sutrue
. 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.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 sutrue
.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 Metodobeta.reservations.insert
. Nel corpo della richiesta, includi il campodeleteAtTime
.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, specificaZ
.
Per eliminare la prenotazione dopo un determinato periodo di tempo, crea una
POST
richiesta alla Metodobeta.reservations.insert
. Nel corpo della richiesta, includi il campodeleteAfterDuration
.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, specifica86400
per 86.400 secondi (1 giorno).
Nella console Google Cloud, vai alla pagina Prenotazioni.
Viene visualizzata la pagina Prenotazioni.
Fai clic su
Crea prenotazione.Viene visualizzata la pagina Crea una prenotazione.
Nel campo Nome, inserisci un nome per la prenotazione.
Seleziona la regione e la zona in cui vuoi prenotare le risorse.
Nella sezione Tipo di condivisione, procedi nel seguente modo:
Per specificare una prenotazione condivisa, fai clic su Condivisa.
Fai clic su
Aggiungi progetti. quindi seleziona i progetti dall'organizzazione del progetto attuale con cui vuoi condividere la prenotazione.
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.
Nel campo Numero di istanze VM, inserisci il numero di VM che che vuoi prenotare.
Nella sezione Configurazione macchina, seleziona Specifica il tipo di macchina, quindi specifica quanto segue:
In Famiglia di macchine, Serie e Tipo di macchina seleziona una famiglia, una serie e un tipo di macchina.
(Facoltativo) Per specificare una piattaforma CPU minima o collegare GPU a N1 VM:
Per espandere la sezione Piattaforma CPU e GPU, fai clic sul pulsante Espansione
freccia.(Facoltativo) Per specificare una piattaforma CPU minima, nel campo Plaform CPU, seleziona un'opzione.
(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.
(Facoltativo) Per aggiungere dischi SSD locali:
Nel campo Numero di dischi, seleziona il numero di dischi di dischi SSD per ogni VM.
Nel campo Tipo di interfaccia, seleziona l'interfaccia per Dischi SSD locali.
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.
Per creare la prenotazione, fai clic su Crea.
La creazione della prenotazione condivisa potrebbe richiedere un po' di tempo. Questo ti reindirizza alla pagina Prenotazioni.
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.CONSUMER_PROJECT_IDS
: un elenco separato da virgole di ID dei progetti che possono utilizzare questa prenotazione, ad esempioproject-1,project-2
. Puoi includere fino a 100 progetti consumer. Questi progetti devono trovarsi nella stessa organizzazione del progetto del proprietario. Non includere il progetto del proprietario. Per impostazione predefinita, è già consentito la prenotazione.NUMBER_OF_VMS
: il numero di VM da prenotare.ZONE
: la zona in cui prenotare le risorse.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:
NUMBER_OF_ACCELERATORS
: il numero di GPU da aggiungere per VM prenotata.ACCELERATOR_TYPE
: un modello GPU supportato per le VM N1. Assicurati che il modello GPU scelto è disponibile nella zona in cui vuoi prenotare le risorse. In caso contrario, la creazione la prenotazione non va a buon fine.
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 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
eINTERFACE_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 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 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
con 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, specificaZ
.
Per eliminare la prenotazione dopo un determinato periodo di tempo, utilizza il metodo Comando
gcloud beta compute reservations create
con 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, specifica30m
per 30 minuti o1d2h3m4s
per 1 giorno, 2 ore, 3 minuti e 4 secondi.
- Imposta il campo
share_type
suSPECIFIC_PROJECTS
. - Nel blocco
project_map
, specifica ID progetto dei progetti con cui vuoi condividere questa prenotazione. Il campo
projectMap
.Il campo
shareType
è stato impostato suSPECIFIC_PROJECTS
.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.CONSUMER_PROJECT_ID_1
eCONSUMER_PROJECT_ID_2
: il ID dei progetti che possono utilizzare questa prenotazione. Puoi includere fino a 100 segmenti di pubblico in modo programmatico a gestire i progetti. Questi progetti devono trovarsi nella stessa organizzazione del proprietario progetto. Non includere il progetto del proprietario. Per impostazione predefinita, autorizzati a utilizzare la prenotazione.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 CampospecificReservationRequired
in il corpo della richiesta e impostare il campo sutrue
. Questo indica che Le VM che hanno come target specifico la prenotazione possono consumarla.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:
NUMBER_OF_ACCELERATORS
: il numero di GPU da aggiungere per VM prenotata.ACCELERATOR_TYPE
: un modello GPU supportato per le VM N1. Assicurati che il modello GPU scelto è disponibile nella zona in cui vuoi prenotare le risorse. In caso contrario, la creazione la prenotazione non va a buon fine.
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 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
eINTERFACE_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 una specifica 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 che solo le VM scegliere come target questa prenotazione può utilizzarlo, includi il campo
specificReservationRequired
nella corpo della richiesta e impostare il campo sutrue
.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 Metodobeta.reservations.insert
. Nel corpo della richiesta, includi il campodeleteAtTime
.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, specificaZ
.
Per eliminare la prenotazione dopo un determinato periodo di tempo, crea una
POST
richiesta alla Metodobeta.reservations.insert
. Nel corpo della richiesta, includi il campodeleteAfterDuration
.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, specifica86400
per 86.400 secondi (1 giorno).
Scopri come visualizzare le tue prenotazioni.
Scopri come allegare le prenotazioni agli impegni.
Scopri come utilizza prenotazioni.
Scopri come monitorare il consumo delle prenotazioni.
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.
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.
Install the Google Cloud CLI, then initialize it by running the following command:
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 condivise, chiedi all'amministratore di concederti seguenti ruoli IAM:
Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso.
Questi ruoli predefiniti le autorizzazioni necessarie per creare prenotazioni condivise. Per vedere le autorizzazioni esatte obbligatorie, espandi la sezione Autorizzazioni obbligatorie:
Autorizzazioni obbligatorie
Per creare prenotazioni condivise sono necessarie le seguenti autorizzazioni:
Potresti anche riuscire a ottenere queste autorizzazioni con ruoli personalizzati altri ruoli predefiniti.
Best practice
Quando crei prenotazioni condivise, si consiglia di seguire queste best practice. Se li segui, puoi ottimizzare la gestibilità e l'utilizzo prenotazioni condivise nella tua organizzazione.
Consenti e limita la creazione e la modifica di prenotazioni condivise ai progetti
Per impostazione predefinita, nessun progetto è autorizzato a creare o modificare prenotazioni condivise all'interno di un'organizzazione. Aggiungi progetti al Vincolo del criterio dell'organizzazione per i progetti proprietari delle prenotazioni condivise (
compute.sharedReservationsOwnerProjects
) per creare e modificare prenotazioni condivise. Per ulteriori informazioni sui vincoli dei criteri dell'organizzazione, consulta Introduzione al servizio Criteri dell'organizzazione.Per visualizzare e modificare Progetti del proprietario con prenotazioni condivise (
compute.sharedReservationsOwnerProjects
) un vincolo del criterio dell'organizzazione.Visualizza il vincolo del criterio dell'organizzazione delle prenotazioni condivise
Per vedere quali progetti sono autorizzati a creare e modificare le prenotazioni condivise, utilizza la console Google Cloud o gcloud CLI.
Console
Segui i passaggi per Visualizzazione dei criteri dell'organizzazione utilizzando il vincolo Progetti del proprietario delle prenotazioni condivise.
gcloud
Per vedere quali progetti è
compute.sharedReservationsOwnerProjects
consente di creare e modificare prenotazioni condivise:Modifica il vincolo del criterio dell'organizzazione per le prenotazioni condivise
Per modificare i progetti autorizzati a creare e modificare le prenotazioni condivise, utilizza la console Google Cloud o gcloud CLI.
Console
Segui i passaggi per Personalizzazione dei criteri per i vincoli degli elenchi utilizzando il vincolo Progetti del proprietario delle prenotazioni condivise.
gcloud
Per modificare i progetti
compute.sharedReservationsOwnerProjects
consente di creare e modificare prenotazioni condivise, utilizza uno dei seguenti metodi:Potrebbe essere necessario attendere alcuni minuti prima che la modifica abbia effetto.
Crea una prenotazione condivisa
Questa sezione spiega come creare prenotazioni condivise. Dopo aver creato prenotazione condivisa, può essere modificata solo dal progetto del proprietario, le risorse per una prenotazione condivisa possono essere utilizzate dal progetto proprietario o da qualsiasi per i progetti consumer.
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 la prenotazione di Google Cloud, esegui una o più delle seguenti operazioni:
Specifica un modello di istanza
Prima di creare una prenotazione specificando un modello di istanza, assicurati che le seguenti:
Per creare una prenotazione condivisa specificando un modello di istanza, selezionane uno una delle seguenti opzioni:
Console
gcloud
Per creare una prenotazione condivisa, utilizza il Comando
gcloud compute reservations create
con i flag--share-setting=projects
e--share-with
.Per creare una prenotazione condivisa specificando un modello di istanza senza includere flag facoltativi, esegui questo comando:
gcloud compute reservations create RESERVATION_NAME \ --project=PROJECT_ID \ --share-setting=projects \ --share-with=CONSUMER_PROJECT_IDS \ --source-instance-template=projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME \ --vm-count=NUMBER_OF_VMS \ --zone=ZONE
Sostituisci quanto segue:
Ad esempio, per creare una prenotazione specificando un'istanza globale modello nella zona
us-central1-a
, condividi la prenotazione con i progettiproject-1
eproject-2
e prenota dieci VM, ciascuna delle quali utilizza un'istanza N2 un tipo di macchina predefinita con 4 vCPU, esegui questo comando:gcloud compute reservations create my-reservation \ --project=example-project \ --share-setting=projects \ --share-with=project-1,project-2 \ --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:
REST
Per creare una prenotazione condivisa, invia una richiesta
POST
a Metodoreservations.insert
. Nel corpo della richiesta, includi quanto segue:Ad esempio, per creare una prenotazione condivisa specificando un'istanza. senza includere campi facoltativi e condividi la prenotazione con due progetti consumer, effettua la seguente richiesta
POST
:POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations { "name": "RESERVATION_NAME", "shareSettings": { "shareType": "SPECIFIC_PROJECTS", "projectMap": { "CONSUMER_PROJECT_ID_1": { "projectId": "CONSUMER_PROJECT_ID_1" }, "CONSUMER_PROJECT_ID_2": { "projectId": "CONSUMER_PROJECT_ID_2" } } }, "specificReservation": { "count": "NUMBER_OF_VMS", "sourceInstanceTemplate": "projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME" } }
Sostituisci quanto segue:
Ad esempio, per creare una prenotazione per dieci VM nella zona
us-central1-a
specificare un modello di istanza globale e condividere la prenotazione per i progettiproject-1
eproject-2
, effettua la seguente richiestaPOST
:POST https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations { "name": "my-reservation", "shareSettings": { "shareType": "SPECIFIC_PROJECTS", "projectMap": { "project-1": { "projectId": "project-1" }, "project-2": { "projectId": "project-2" } } }, "specificReservation": { "count": "10", "sourceInstanceTemplate": "projects/example-project/global/instanceTemplates/example-instance-template" } }
Facoltativamente, puoi eseguire una o più delle seguenti operazioni:
Specifica direttamente le proprietà della VM
Per creare una prenotazione condivisa specificando direttamente le proprietà, seleziona una di le seguenti opzioni:
Console
gcloud
Per creare una prenotazione condivisa, utilizza il Comando
gcloud compute reservations create
con i flag--share-setting=projects
e--share-with
.Per creare una prenotazione condivisa specificando le proprietà direttamente e senza inclusi eventuali flag facoltativi, esegui questo comando:
gcloud compute reservations create RESERVATION_NAME \ --machine-type=MACHINE_TYPE \ --project=PROJECT_ID \ --share-setting=projects \ --share-with=CONSUMER_PROJECT_IDS \ --vm-count=NUMBER_OF_VMS \ --zone=ZONE
Sostituisci quanto segue:
Ad esempio, per creare una prenotazione nella zona
us-central1-a
per dieci VM che usano ciascuno un tipo di macchina predefinita N2 con 4 vCPU e condividono con i progettiproject-1
eproject-2
, esegui questo comando: :gcloud compute reservations create my-reservation \ --machine-type=n2-standard-4 \ --project=example-project \ --share-setting=projects \ --share-with=project-1,project-2 \ --vm-count=10 \ --zone=us-central1-a
Facoltativamente, puoi eseguire una o più delle seguenti operazioni:
Terraform
Per creare una prenotazione, utilizza
google_compute_reservation
Risorsa Terraform. Per specificare una prenotazione condivisa, definisci il bloccoshare_settings
:Per saperne di più su come utilizzare Terraform, consulta Utilizzo di Terraform con Google Cloud.
REST
Per creare una prenotazione condivisa, invia una richiesta
POST
a Metodoreservations.insert
. Nel corpo della richiesta, includi quanto segue:Ad esempio, per creare una prenotazione condivisa senza includere eventuali elementi facoltativi e condividi la prenotazione con due progetti consumer, seguente richiesta di
POST
:POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations { "name": "RESERVATION_NAME", "shareSettings": { "shareType": "SPECIFIC_PROJECTS", "projectMap": { "CONSUMER_PROJECT_ID_1": { "projectId": "CONSUMER_PROJECT_ID_1" }, "CONSUMER_PROJECT_ID_2": { "projectId": "CONSUMER_PROJECT_ID_2" } } }, "specificReservation": { "count": "NUMBER_OF_VMS", "instanceProperties": { "machineType": "MACHINE_TYPE", } } }
Sostituisci quanto segue:
Ad esempio, per creare una prenotazione specificando un'istanza globale modello nella zona
us-central1-a
, condividi la prenotazione con i progettiproject-1
eproject-2
e prenota dieci VM, ciascuna delle quali utilizza un'istanza N2 un tipo di macchina predefinita con 4 vCPU, imposta quanto seguePOST
richiesta:POST https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations { "name": "my-reservation", "shareSettings": { "shareType": "SPECIFIC_PROJECTS", "projectMap": { "project-1": { "projectId": "project-1" }, "project-2": { "projectId": "project-2" } } }, "specificReservation": { "count": "10", "instanceProperties": { "machineType": "n2-standard-4", } } }
Facoltativamente, puoi eseguire una o più delle seguenti operazioni:
Passaggi successivi
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2024-07-25 UTC.
[{ "type": "thumb-down", "id": "hardToUnderstand", "label":"Hard to understand" },{ "type": "thumb-down", "id": "incorrectInformationOrSampleCode", "label":"Incorrect information or sample code" },{ "type": "thumb-down", "id": "missingTheInformationSamplesINeed", "label":"Missing the information/samples I need" },{ "type": "thumb-down", "id": "translationIssue", "label":"Problema di traduzione" },{ "type": "thumb-down", "id": "otherDown", "label":"Altra" }] [{ "type": "thumb-up", "id": "easyToUnderstand", "label":"Facile da capire" },{ "type": "thumb-up", "id": "solvedMyProblem", "label":"Il problema è stato risolto" },{ "type": "thumb-up", "id": "otherUp", "label":"Altra" }] -