Gestisci le istanze Google Cloud Managed Lustre

Dopo aver creato un'istanza, Google Cloud Managed Lustre ti consente di elencare, recuperare, 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:

Google Cloud Console

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

    Vai a Managed Lustre

    Vengono elencate le istanze del progetto.

Gcloud CLI

Utilizza il gcloud lustre instances list comando:

gcloud lustre instances list --location=LOCATION

Sostituisci LOCATION con una zona specifica per elencare tutte le istanze in quella località. 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 del tuo Google Cloud progetto.

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

Per ulteriori dettagli, consulta la documentazione di riferimento dell'API instances.list.

Recupera un'istanza

Per recuperare i dettagli di un'istanza:

Google Cloud Console

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

    Vai a Managed Lustre

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

Gcloud CLI

Utilizza il gcloud lustre instances describe comando:

gcloud lustre instances describe INSTANCE_NAME --location=LOCATION

REST

Per recuperare i dettagli di una determinata 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 del tuo Google Cloud progetto.

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

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

Per ulteriori dettagli, consulta la documentazione di riferimento dell'API instances.get.

Aggiorna un'istanza

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

  • descrizione
  • etichette
  • capacità di archiviazione

Per informazioni sull'aumento della capacità di archiviazione di un'istanza, consulta Aumentare la capacità di un'istanza.

Per aggiornare un'istanza:

Google Cloud Console

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

    Vai a Managed Lustre

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

  3. Fai clic su Modifica.

  4. Inserisci i nuovi valori.

  5. Fai clic su Invia.

Google Cloud CLI

Utilizza il gcloud lustre instances update comando:

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 del tuo Google Cloud progetto.
  • ZONE è la zona dell'istanza Google Cloud .
  • INSTANCE_NAME è il nome dell'istanza Managed Lustre da aggiornare.
  • UPDATE_MASK è un elenco separato da virgole di 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 per 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 la documentazione di riferimento dell'API instances.patch.

Elimina un'istanza

Per eliminare un'istanza:

Google Cloud Console

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

    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.

Gcloud CLI

Utilizza il gcloud lustre instances delete comando:

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 del tuo Google Cloud progetto.

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

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

Per ulteriori dettagli, consulta la documentazione di riferimento dell'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 la documentazione di riferimento di operations.get.