Questo documento spiega come visualizzare le prenotazioni.
Prima di iniziare
- Esamina i requisiti e le limitazioni per le prenotazioni.
-
Se non l'hai ancora fatto, configura l'autenticazione.
L'autenticazione è il processo mediante il quale viene verificata l'identità per l'accesso ai servizi e alle API Google Cloud.
Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi autenticarti in Compute Engine nel seguente modo.
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
-
Installa Google Cloud CLI, quindi initialize eseguendo questo comando:
gcloud init
- Set a default region and zone.
-
Per visualizzare un elenco di prenotazioni:
compute.reservations.list
nel progetto -
Per visualizzare i dettagli di una prenotazione:
compute.reservations.get
nel progetto FILTER_EXPRESSION
: un'espressione di filtro.PROJECT_ID
: l'ID del progetto in cui si trovano le prenotazioni.PROJECT_ID
: l'ID del progetto in cui si trovano le prenotazioni.ZONE
: la zona in cui si trovano le prenotazioni.PROJECT_ID
: l'ID del progetto in cui si trovano le prenotazioni.ZONE
: la zona in cui si trovano le prenotazioni.FILTER_EXPRESSION
: un'espressione di filtro.Nella console Google Cloud, vai alla pagina Prenotazioni.
Viene visualizzata la pagina Prenotazioni.
Nella colonna Nome, fai clic sul nome della prenotazione che vuoi descrivere.
Viene visualizzata la pagina dei dettagli della prenotazione. Per determinare l'utilizzo di una prenotazione, consulta i campi Totale macchine riservate e Macchine utilizzate.
RESERVATION_NAME
: il nome di una prenotazione esistente.PROJECT_ID
: l'ID del progetto in cui si trova la prenotazione.ZONE
: la zona in cui si trova la prenotazione.PROJECT_ID
: l'ID del progetto in cui si trova la prenotazione.ZONE
: la zona in cui si trova la prenotazione.RESERVATION_NAME
: il nome di una prenotazione esistente.- Scopri come associare le prenotazioni agli impegni.
- Scopri come utilizzare le prenotazioni.
- Scopri come modificare le prenotazioni.
- Scopri come eliminare le prenotazioni.
REST
Per utilizzare gli esempi di API REST in questa pagina in un ambiente di sviluppo locale, devi utilizzare le credenziali che fornisci a gcloud CLI.
Installa Google Cloud CLI, quindi initialize eseguendo questo comando:
gcloud init
Per maggiori informazioni, consulta Autenticazione per REST nella documentazione sull'autenticazione di Google Cloud.
Ruoli obbligatori
Per ottenere le autorizzazioni necessarie per visualizzare le prenotazioni, chiedi all'amministratore di concederti il ruolo IAM Amministratore Compute (
roles/compute.admin
) per il progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso.Questo ruolo predefinito contiene le autorizzazioni necessarie per visualizzare le prenotazioni. Per visualizzare le autorizzazioni esatte necessarie, espandi la sezione Autorizzazioni richieste:
Autorizzazioni obbligatorie
Per visualizzare le prenotazioni sono necessarie le seguenti autorizzazioni:
Potresti anche essere in grado di ottenere queste autorizzazioni con i ruoli personalizzati o altri ruoli predefiniti.
Visualizza le tue prenotazioni
Puoi visualizzare solo le prenotazioni create nel tuo progetto attuale.
Solo il progetto proprietario può visualizzare una prenotazione condivisa. Se vuoi visualizzare i progetti con cui è condivisa una prenotazione condivisa, visualizza i dettagli della prenotazione.
Visualizzare un elenco delle prenotazioni
Per visualizzare un elenco delle tue prenotazioni, utilizza la console Google Cloud, gcloud CLI o REST.
Console
Nella console Google Cloud, vai alla pagina Prenotazioni.
Viene visualizzata la pagina Prenotazioni.
Nella tabella, ogni riga descrive una prenotazione e ogni colonna descrive una proprietà. Ad esempio, la colonna Macchine usate descrive l'utilizzo e la capacità totale di ogni prenotazione: un valore
25 (50)
rappresenta una prenotazione per 50 VM in cui sono state consumate 25 di queste VM.(Facoltativo) Per modificare le prenotazioni e le proprietà visualizzate, utilizza rispettivamente
Filtro e Opzioni di visualizzazione delle colonne.gcloud
Per visualizzare un elenco delle tue prenotazioni, utilizza il comando
gcloud compute reservations list
.gcloud compute reservations list \ --project=PROJECT_ID
Sostituisci
PROJECT_ID
con l'ID del progetto in cui si trovano le prenotazioni.L'output dovrebbe essere simile al seguente esempio:
NAME: r-01 IN_USE_COUNT: 0 COUNT: 5 ZONE: us-central1-a SHARE_TYPE: LOCAL NAME: r-02 IN_USE_COUNT: 3 COUNT: 10 ZONE: us-central1-f SHARE_TYPE: LOCAL
Facoltativamente, per restringere un elenco di prenotazioni utilizzando un'espressione di filtro, specifica il flag
--filter
.gcloud compute reservations list \ --filter="FILTER_EXPRESSION" \ --project=PROJECT_ID
Sostituisci quanto segue:
Ad esempio, per visualizzare solo le prenotazioni il cui nome inizia con
prefix
e si trova nella zonaus-central1-a
, esegui questo comando:gcloud compute reservations list \ --filter="name~prefix AND zone=us-central1-a" \ --project=example-project
REST
Per visualizzare un elenco delle tue prenotazioni, effettua una richiesta
GET
utilizzando il metodoreservations.list
.GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations
Sostituisci quanto segue:
L'output è simile al seguente esempio:
{ "id": "4100668622331754141", "creationTimestamp": "2019-09-27T08:21:14.707-07:00", "selfLink": "https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a/reservations/reservation-05", "zone": "https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a", "name": "reservation-05", "specificReservation": { "instanceProperties": { "machineType": "n1-standard-2", "minCpuPlatform": "Any CPU Platform", }, "count": "100", "inUseCount": "0" }, "specificReservationRequired": false, "status": "READY", "kind": "compute#reservation" }, { "id": "2533514314332214789", "creationTimestamp": "2019-09-27T08:21:14.707-07:00", "selfLink": "https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a/reservations/reservation-04", "zone": "https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a", "name": "reservation-04", "specificReservation": { "instanceProperties": { "machineType": "n1-standard-2", "guestAccelerators": [ { "acceleratorType": "nvidia-tesla-t4", "acceleratorCount": 1 } ], "minCpuPlatform": "Any CPU Platform", "localSsds": [ { "diskSizeGb": "375", "interface": "SCSI" } ] }, "count": "50", "inUseCount": "25" }, "specificReservationRequired": false, "status": "READY", "kind": "compute#reservation" }
Se vuoi, per restringere un elenco di prenotazioni utilizzando un'espressione di filtro, effettua la seguente richiesta
GET
:GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations?filter=FILTER_EXPRESSION
Sostituisci quanto segue:
Ad esempio, per visualizzare solo le prenotazioni il cui nome inizia con
prefix
e si trova nella zonaus-central1-a
, effettua la seguente richiestaGET
utilizzando valori codificati nell'URL:GET https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations?filter=name%7Eprefix%20AND%20zone=us-central1-a
Visualizzare i dettagli di una prenotazione
Per visualizzare i dettagli di una prenotazione, utilizza la console Google Cloud, gcloud CLI o REST.
Console
Per visualizzare i dettagli di una prenotazione:
gcloud
Per visualizzare i dettagli di una prenotazione, utilizza il comando
gcloud compute reservations describe
.gcloud compute reservations describe RESERVATION_NAME \ --project=PROJECT_ID \ --zone=ZONE
Sostituisci quanto segue:
L'output dovrebbe essere simile al seguente esempio:
kind: compute#reservation name: reservation-04 selfLink: https://compute.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a/reservations/reservation-04 specificReservation: count: '50' inUseCount: '25' instanceProperties: guestAccelerators: - acceleratorCount: 1 acceleratorType: nvidia-tesla-t4 localSsds: - diskSizeGb: '375' interface: SCSI machineType: n1-standard-2 minCpuPlatform: Any CPU Platform specificReservationRequired: false status: READY zone: https://compute.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a
Per determinare l'utilizzo di una prenotazione, consulta i campi
count
einUseCount
. In questo esempio, 50 VM sono prenotate e 25 VM sono state consumate.REST
Per visualizzare i dettagli di una prenotazione, effettua una richiesta
GET
utilizzando il metodoreservations.get
.GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME
Sostituisci quanto segue:
L'output dovrebbe essere simile al seguente esempio:
{ "id": "2533514314332214789", "creationTimestamp": "2019-09-27T08:21:14.707-07:00", "selfLink": "https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a/reservations/reservation-04", "zone": "https://www.googleapis.com/compute/v1/projects/my-project/zones/us-centra1-a", "name": "reservation-04", "specificReservationRequired": false, "status": "READY", "kind": "compute#reservation", "specificReservation": { "instanceProperties": { "machineType": "n1-standard-2", "guestAccelerators": [ { "acceleratorType": "nvidia-tesla-t4", "acceleratorCount": 1 } ], "minCpuPlatform": "Any CPU Platform", "localSsds": [ { "diskSizeGb": "375", "interface": "SCSI" } ] }, "count": "50", "inUseCount": "25" } }
Per determinare l'utilizzo di una prenotazione, consulta i campi
count
einUseCount
. In questo esempio, 50 VM sono prenotate e 25 VM sono state consumate.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-05-29 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" }] -