Questa pagina è stata tradotta dall'API Cloud Translation.

Visualizza prenotazioni

Questo documento spiega come visualizzare le prenotazioni.

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. Install the Google Cloud CLI, then initialize it by running the following command:
```
gcloud init
```
  Note: If you installed the gcloud CLI previously, make sure you have the latest version by running gcloud components update.
2. Set a default region and zone.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per visualizzare le prenotazioni, 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 visualizzare le prenotazioni. Per vedere le autorizzazioni esatte obbligatorie, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per visualizzare le prenotazioni sono necessarie le seguenti autorizzazioni:

Per visualizzare un elenco di prenotazioni: compute.reservations.list del progetto
Per visualizzare i dettagli di una prenotazione: compute.reservations.get del progetto

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

Visualizza le tue prenotazioni

Puoi visualizzare solo le prenotazioni create nel tuo progetto attuale.

Solo il progetto del 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 tue prenotazioni

Per visualizzare un elenco delle tue prenotazioni, usa la console Google Cloud, con gcloud CLI o REST.

Console

Nella console Google Cloud, vai alla pagina Prenotazioni.

Vai a Prenotazioni

Viene visualizzata la pagina Prenotazioni.

Nella tabella ogni riga descrive una prenotazione e ogni colonna descrive una proprietà. Ad esempio, la colonna Macchine utilizzate descrive le utilizzo e capacità totale di ogni prenotazione: un valore pari a 25 (50) rappresenta una prenotazione per 50 VM in cui 25 di queste VM sono state consumato.

(Facoltativo) Per modificare le prenotazioni e le proprietà visualizzate, utilizza Filtra e Opzioni di visualizzazione delle colonne rispettivamente.

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 le prenotazioni.

L'output dovrebbe essere simile all'esempio seguente:

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 una espressione di filtro, specifica il flag --filter.

gcloud compute reservations list \
    --filter="FILTER_EXPRESSION" \
    --project=PROJECT_ID

Sostituisci quanto segue:

FILTER_EXPRESSION: un'espressione di filtro.
PROJECT_ID: l'ID del progetto in cui le prenotazioni.

Ad esempio, per visualizzare solo le prenotazioni con un nome che inizia con prefix e si trovano nella zona us-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, invia una richiesta GET a Metodo reservations.list.

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

Sostituisci quanto segue:

PROJECT_ID: l'ID del progetto in cui le prenotazioni.
ZONE: la zona in cui vengono le prenotazioni individuarlo.

L'output è simile all'esempio seguente:

{
  "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"
}

Facoltativamente, per restringere un elenco di prenotazioni utilizzando una 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:

PROJECT_ID: l'ID del progetto in cui le prenotazioni.
ZONE: la zona in cui si trovano le prenotazioni.
FILTER_EXPRESSION: un'espressione di filtro.

Ad esempio, per visualizzare solo le prenotazioni con un nome che inizia con prefix e si trovano nella zona us-central1-a, effettua la seguente richiesta GET 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, usa la console Google Cloud, con gcloud CLI o REST.

Console

Per visualizzare i dettagli di una prenotazione:

Nella console Google Cloud, vai alla pagina Prenotazioni.

Vai a Prenotazioni

Viene visualizzata la pagina Prenotazioni.
Nella colonna Nome, fai clic sul nome della prenotazione da a descrivere.

Viene visualizzata la pagina dei dettagli della prenotazione. Per determinare l'utilizzo di una prenotazione, consulta i campi Totale macchine prenotate e Campi Macchine utilizzate.

gcloud

Per visualizzare i dettagli di una prenotazione, utilizza i Comando gcloud compute reservations describe.

gcloud compute reservations describe RESERVATION_NAME \
    --project=PROJECT_ID \
    --zone=ZONE

Sostituisci quanto segue:

RESERVATION_NAME: il nome di un elemento esistente prenotazione.
PROJECT_ID: l'ID del progetto in cui in cui si trova la prenotazione.
ZONE: la zona in cui si trova la prenotazione.

L'output dovrebbe essere simile all'esempio seguente:

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 count e inUseCount campi. In questo esempio, 50 VM sono prenotate e 25 VM consumato.

REST

Per visualizzare i dettagli di una prenotazione, invia una richiesta GET a Metodo reservations.get.

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

Sostituisci quanto segue:

PROJECT_ID: l'ID del progetto in cui in cui si trova la prenotazione.
ZONE: la zona in cui si trova la prenotazione.
RESERVATION_NAME: il nome di un elemento esistente prenotazione.

L'output dovrebbe essere simile all'esempio seguente:

{
  "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 count e inUseCount campi. In questo esempio, 50 VM sono prenotate e 25 VM consumato.

Passaggi successivi

Scopri come collegare le prenotazioni agli impegni.
Scopri come utilizzare le prenotazioni.
Scopri come modificare le prenotazioni.
Scopri come eliminare le prenotazioni.