Gestisci le istanze Google Cloud Managed Lustre

Una volta creata un'istanza, Google Cloud Managed Lustre ti consente di elencare, ottenere, aggiornare ed eliminare le istanze.

Quando aggiorni le istanze Managed Lustre, puoi modificare solo la descrizione e le etichette.

Elenca istanze

Per elencare tutte le istanze in un progetto:

Console Google Cloud

  1. Vai alla pagina Managed Lustre nella console Google Cloud .

    Vai a Managed Lustre

    Viene visualizzato l'elenco delle istanze del progetto.

Interfaccia a riga di comando gcloud

Utilizza il comando gcloud lustre instances list:

gcloud lustre instances list --location=LOCATION

Sostituisci LOCATION con una zona specifica per elencare tutte le istanze in quella posizione. Per visualizzare i progetti in tutte le località, inserisci - come valore. Ad esempio:

gcloud lustre instances list --location=-

REST

Per elencare le istanze utilizzando l'API REST, invia una richiesta al seguente endpoint:

GET https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/instances
Authorization: Bearer [YOUR_ACCESS_TOKEN]

Dove devono essere specificati i seguenti valori:

  • PROJECT_ID è l'ID progetto Google Cloud .

  • ZONE è la zona per cui elencare tutte le istanze. Per elencare le istanze di tutte le zone, utilizza - come valore.

Per ulteriori dettagli, consulta il riferimento API instances.list.

Ottenere un'istanza

Per ottenere i dettagli di un'istanza:

Console Google Cloud

  1. Vai alla pagina Managed Lustre nella console Google Cloud .

    Vai a Managed Lustre

  2. Fai clic sul nome dell'istanza per visualizzare i dettagli di un'istanza specifica.

Interfaccia a riga di comando gcloud

Utilizza il comando gcloud lustre instances describe:

gcloud lustre instances describe INSTANCE_NAME --location=LOCATION

REST

Per ottenere dettagli su una particolare istanza utilizzando l'API REST, invia una richiesta al seguente endpoint:

GET https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/instances/INSTANCE_NAME
Authorization: Bearer [YOUR_ACCESS_TOKEN]

Dove devono essere specificati i seguenti valori:

  • PROJECT_ID è l'ID progetto Google Cloud .

  • ZONE deve essere una zona Google Cloud valida supportata da Managed Lustre. Per un elenco completo, vedi Località supportate.

  • INSTANCE_NAME è il nome dell'istanza Managed Lustre da restituire.

Per ulteriori dettagli, consulta il riferimento API instances.get.

Aggiorna un'istanza

Puoi aggiornare le seguenti proprietà di un'istanza esistente:

  • descrizione
  • etichette
  • capacità di archiviazione

Per informazioni su come aumentare la capacità di archiviazione di un'istanza, consulta Aumenta la capacità di un'istanza.

Per aggiornare un'istanza:

Console Google Cloud

  1. Vai alla pagina Managed Lustre nella console Google Cloud .

    Vai a Managed Lustre

  2. Fai clic sul nome dell'istanza da aggiornare. Viene visualizzata la pagina Panoramica dell'istanza.

  3. Fai clic su Modifica.

  4. Inserisci i nuovi valori.

  5. Fai clic su Invia.

Google Cloud CLI

Utilizza il comando gcloud lustre instances update:

gcloud lustre instances update INSTANCE_NAME \
  --location=LOCATION \
  --capacity-gib=NEW_CAPACITY \
  --description=NEW_DESCRIPTION

Dove:

  • INSTANCE_NAME è l'istanza da aggiornare.
  • LOCATION è la zona in cui risiede l'istanza.
  • NEW_CAPACITY è la nuova capacità di archiviazione per questa istanza in gibibyte (GiB). Il valore non può superare la capacità massima consentita e deve essere un multiplo della dimensione del passo. Per ulteriori dettagli, consulta Aumentare la capacità di un'istanza.
  • NEW_DESCRIPTION è un nuovo valore per il campo della descrizione, che sovrascrive qualsiasi descrizione esistente.

Per aggiornare le etichette, consulta i comandi disponibili nella documentazione di gcloud lustre instances update.

REST

Per aggiornare un'istanza utilizzando l'API REST, invia una richiesta PATCH al relativo endpoint specifico:

PATCH https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/instances/INSTANCE_NAME?updateMask=UPDATE_MASK
Authorization: Bearer [YOUR_ACCESS_TOKEN]

{
  "capacityGib": 72000,
  "description": "updated description",
  "labels": {
    "key1": "value1"
  }
}

Dove devono essere specificati i seguenti valori:

  • PROJECT_ID è l'ID progetto Google Cloud .
  • ZONE è la zona Google Cloud dell'istanza.
  • INSTANCE_NAME è il nome dell'istanza Managed Lustre da aggiornare.
  • UPDATE_MASK è un elenco separato da virgole dei campi da aggiornare. Un campo verrà sovrascritto solo se si trova nella maschera.

Il corpo della richiesta deve contenere uno o più dei seguenti campi:

  • capacityGiB è la nuova capacità di archiviazione per questa istanza in gibibyte (GiB). Il valore non può superare la capacità massima consentita e deve essere un multiplo della dimensione del passo. Per ulteriori dettagli, consulta Aumentare la capacità di un'istanza.
  • description è la nuova descrizione di questa istanza.
  • labels è il nuovo insieme di etichette per questa istanza. Il valore di labels è un oggetto JSON contenente una o più coppie chiave-valore.

Per ulteriori dettagli, consulta il riferimento API instances.patch.

Elimina un'istanza

Per eliminare un'istanza:

Console Google Cloud

  1. Vai alla pagina Managed Lustre nella console Google Cloud .

    Vai a Managed Lustre

  2. Seleziona il menu con tre puntini accanto all'istanza da eliminare.

  3. Seleziona Elimina istanza. Conferma l'eliminazione facendo di nuovo clic su Elimina.

Interfaccia a riga di comando gcloud

Utilizza il comando gcloud lustre instances delete:

gcloud lustre instances delete INSTANCE_NAME --location=LOCATION

Ti viene chiesto di confermare l'eliminazione. Digita Y o premi Invio per continuare.

REST

Per eliminare un'istanza utilizzando l'API REST, invia una richiesta al seguente endpoint:

DELETE https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/instances/INSTANCE_NAME
Authorization: Bearer [YOUR_ACCESS_TOKEN]

Dove devono essere specificati i seguenti valori:

  • PROJECT_ID è l'ID progetto Google Cloud .

  • ZONE è la zona Google Cloud in cui si trova l'istanza.

  • INSTANCE_NAME è il nome dell'istanza Managed Lustre da eliminare.

Per ulteriori dettagli, consulta il riferimento API instances.delete.

Le richieste di eliminazione sono richieste a lunga esecuzione e restituiscono un ID operazione su cui è possibile eseguire query per lo stato dell'operazione. Per i dettagli, consulta il riferimento operations.get.