Gestisci il pool di archiviazione Hyperdisk

Questo documento spiega come elencare, descrivere, modificare ed eliminare i pool di archiviazione.

Prima di iniziare

  • Se non l'hai ancora fatto, configura l'autenticazione. L'autenticazione è il processo di verifica dell'identità per poter accedere a Google Cloud servizi e API. Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi autenticarti su Compute Engine selezionando una delle seguenti opzioni:

    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. Installa Google Cloud CLI. Dopo l'installazione, inizializza Google Cloud CLI eseguendo il seguente comando: 

      gcloud init

      Se utilizzi un provider di identità (IdP) esterno, devi prima accedere alla gcloud CLI con la tua identità federata.

    2. Set a default region and zone.

    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. Dopo l'installazione, inizializza Google Cloud CLI eseguendo il seguente comando: 

      gcloud init

      Se utilizzi un provider di identità (IdP) esterno, devi prima accedere alla gcloud CLI con la tua identità federata.

    Per saperne di più, consulta Autenticarsi per l'utilizzo di REST nella documentazione sull'autenticazione di Google Cloud .

Ruoli e autorizzazioni richiesti

Per ottenere le autorizzazioni necessarie per gestire un pool di archiviazione, chiedi all'amministratore di concederti i seguenti ruoli IAM per il progetto:

  • Compute Instance Admin (v1) (roles/compute.instanceAdmin.v1)
  • Per connetterti a un'istanza VM che può essere eseguita come service account: Service Account User (v1) (ruolo roles/iam.serviceAccountUser)

Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questi ruoli predefiniti contengono le autorizzazioni necessarie per gestire un pool di archiviazione. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per gestire un pool di archiviazione sono necessarie le seguenti autorizzazioni:

  • Per elencare i pool di archiviazione per un progetto e una zona: compute.storagePools.list
  • Per elencare i dischi all'interno di un pool di archiviazione: compute.storagePools.get
  • Per visualizzare le proprietà di un pool di archiviazione: compute.storagePools.get
  • Per aggiornare la capacità o le prestazioni sottoposte a provisioning di un pool di archiviazione:
    • compute.storagePools.get
    • compute.storagePools.update
  • Per eliminare un pool di archiviazione: compute.storagePools.delete

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Limitazioni

Tieni presente le seguenti limitazioni durante la gestione dei pool di archiviazione Hyperdisk:

  • Puoi modificare la capacità o le prestazioni sottoposte a provisioning di un pool di archiviazione al massimo due volte in un periodo di 24 ore.
  • Non puoi modificare il modello di provisioning per un pool; non puoi modificare un pool di archiviazione con capacità standard in un pool di archiviazione con capacità avanzata o un pool di archiviazione con prestazioni avanzate in un pool di archiviazione con prestazioni standard.
  • Non è consentito spostare i dischi all'interno o all'esterno di un pool di archiviazione. Per spostare un disco all'interno o all'esterno di un pool di archiviazione, devi ricrearlo da uno snapshot. Per ulteriori informazioni, consulta Cambia il tipo di disco.
  • Non puoi clonare, creare snapshot istantanei o configurare la replica asincrona per i dischi in un pool di archiviazione.
  • Puoi eliminare al massimo 5 pool di archiviazione all'ora.
  • Il comando di gestione del pool di archiviazione viene completato o non riesce immediatamente, ma l'azione può richiedere fino a 5 minuti e le modifiche possono richiedere fino a 30 minuti.

Per l'elenco completo delle limitazioni del pool di archiviazione Hyperdisk, consulta Limitazioni dei pool di archiviazione.

Intervalli di valori durante la modifica dei pool di archiviazione

Quando crei un pool di archiviazione, i nuovi valori per dimensioni, IOPS e throughput devono rientrare nei limiti per il tipo di pool di archiviazione che stai modificando. Inoltre, puoi specificare nuovi valori solo utilizzando i valori incrementali supportati.

Per limiti di provisioning delle prestazioni dettagliati, consulta Limiti per i pool di archiviazione.

Elenca i pool di archiviazione per un progetto

Per visualizzare i pool di archiviazione creati in un progetto, utilizza la consoleGoogle Cloud , Google Cloud CLI o REST.

Console

  1. Vai alla pagina Pool di archiviazione nella console Google Cloud .
    Vai alla pagina Pool di archiviazione

    La pagina mostra i pool di archiviazione creati all'interno del progetto selezionato.

  2. (Facoltativo) Utilizza la barra Filtro per visualizzare solo i pool di archiviazione che corrispondono ai parametri del filtro, ad esempio Posizione, Tipo, Nome e Capacità rimanente del pool.

gcloud

Per elencare tutti i pool di archiviazione creati all'interno del progetto corrente, utilizza il comando gcloud compute storage-pools list.

gcloud compute storage-pools list

Per limitare i risultati a una regione o una zona specifica, puoi utilizzare il flag --filter, ad esempio:

  • --filter="zone ~ us
  • --filter="zone=us-east4-c"

REST

Per mostrare i pool di archiviazione creati all'interno di un progetto e di una zona, crea una richiesta GET utilizzando il metodo storagePools.list.

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

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto che contiene il pool di archiviazione
  • ZONE: la zona in cui si trova il pool di archiviazione, ad esempio us-central1-a.

Elenca i dischi in un pool di archiviazione

Per ottenere un elenco dei dischi creati in un pool di archiviazione, utilizza la consoleGoogle Cloud , Google Cloud CLI o REST.

Console

  1. Vai alla pagina Pool di archiviazione nella console Google Cloud .
    Vai alla pagina Pool di archiviazione

    La pagina mostra i pool di archiviazione creati all'interno del progetto selezionato.

  2. Nel campo Nome, fai clic sul nome del pool di archiviazione che vuoi visualizzare.

    Viene visualizzata la pagina Gestisci pool di archiviazione.

  3. Nella sezione Dischi del pool di archiviazione, puoi vedere i dischi creati nel pool di archiviazione.

gcloud

Per elencare i dischi creati in un pool di archiviazione, utilizza il comando gcloud compute storage-pools list-disks.

gcloud compute storage-pools list-disks STORAGE_POOL_NAME  \
    [--zone=ZONE]

Sostituisci quanto segue:

  • STORAGE_POOL_NAME: il nome del pool di archiviazione.
  • ZONE: (Facoltativo) La zona in cui si trova il pool di archiviazione, ad esempio us-central1-a.

REST

Per elencare i dischi che utilizzano un pool di archiviazione, crea una richiesta GET utilizzando il metodo storagePools.listDisks.

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/storagePools/STORAGE_POOL_NAME/listDisks

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto che contiene il pool di archiviazione
  • ZONE: la zona in cui si trova il pool di archiviazione, ad esempio us-central1-a.
  • STORAGE_POOL_NAME: il nome del pool di archiviazione.

Descrivi un pool di archiviazione

Per visualizzare i dettagli di un pool di archiviazione, puoi utilizzare la console Google Cloud , Google Cloud CLI o REST.

Console

  1. Vai alla pagina Pool di archiviazione nella console Google Cloud .
    Vai alla pagina Pool di archiviazione

  2. Per ogni pool di archiviazione elencato nella pagina, puoi visualizzare le seguenti informazioni:

    • Stato
    • Nome
    • Località
    • Tipo di pool
    • Capacità del pool
    • Capacità del pool rimanente
    • IOPS pool
    • IOPS del pool rimanenti
    • Numero di dischi creati nel pool

  3. Nel campo Nome, fai clic sul nome del pool di archiviazione che vuoi visualizzare.

    Viene visualizzata la pagina Gestisci pool di archiviazione.

  4. Nei riquadri nella parte superiore della pagina puoi visualizzare la capacità di cui è stato eseguito il provisioning e quella utilizzata, nonché il throughput e le IOPS di cui è stato eseguito il provisioning e quelli utilizzati per il pool di archiviazione.

  5. Nella sezione Impostazioni del pool di archiviazione, puoi visualizzare proprietà aggiuntive del pool di archiviazione, come l'ora di creazione, il tipo di provisioning della capacità, il tipo di provisioning delle prestazioni, il numero totale di dischi nel pool di archiviazione e le percentuali di utilizzo per capacità, throughput e IOPS.

  6. Nella sezione Dischi del pool di archiviazione, puoi visualizzare informazioni sui dischi creati nel pool di archiviazione.

  7. (Facoltativo) Per ulteriori informazioni sull'utilizzo del pool di archiviazione, puoi fare clic sulla scheda Monitoraggio per visualizzare i grafici di varie metriche del pool di archiviazione. Per saperne di più, consulta Monitorare i pool di archiviazione Hyperdisk.

gcloud

Utilizza il comando gcloud compute storage-pools describe per visualizzare i dettagli di un pool di archiviazione.

gcloud compute storage-pools describe STORAGE_POOL_NAME  \
    [--zone=ZONE]

Sostituisci quanto segue:

  • STORAGE_POOL_NAME: il nome univoco del pool di archiviazione.
  • ZONE: (Facoltativo) La zona in cui si trova il pool di archiviazione, ad esempio us-central1-a.

REST

Per recuperare i dettagli di un pool di archiviazione, crea una richiesta GET utilizzando il metodo storagePools.get.

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

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto che contiene il pool di archiviazione
  • ZONE: la zona in cui si trova il pool di archiviazione, ad esempio us-central1-a
  • STORAGE_POOL_NAME: il nome del pool di archiviazione

Aggiorna la capacità di provisioning, le IOPS o il throughput di un pool di archiviazione

Puoi aumentare o diminuire la capacità, le IOPS o il throughput sottoposti a provisioning di un pool di archiviazione. Per aumentare la capacità, gli IOPS o il throughput di un pool di archiviazione, devi disporre di una quota disponibile per il progetto e la regione.

Console

  1. Vai alla pagina Pool di archiviazione nella console Google Cloud .
    Vai alla pagina Pool di archiviazione

  2. Nel campo Nome, fai clic sul nome del pool di archiviazione che vuoi modificare.

    Viene visualizzata la pagina Gestisci pool di archiviazione.

  3. Fai clic su Modifica.

    Viene visualizzata la pagina Modifica pool di archiviazione.

  4. (Facoltativo) Nel campo Capacità pool di archiviazione, inserisci il nuovo valore per la capacità di provisioning del pool. Il nuovo valore deve essere almeno 1 TiB e al massimo 100 TiB in più o in meno rispetto al valore attuale. La dimensione minima non può essere inferiore a 10 TiB e la dimensione massima non può essere superiore a 1024 TiB.

  5. (Facoltativo) Nel campo Throughput sottoposto a provisioning, inserisci il nuovo valore per il throughput sottoposto a provisioning.

  6. (Facoltativo) Per i pool di archiviazione di tipo Hyperdisk bilanciato, nel campo IOPS sottoposte a provisioning, inserisci il nuovo valore per le IOPS sottoposte a provisioning.

  7. Fai clic su Salva per aggiornare il pool di archiviazione.

gcloud

Utilizza il comando gcloud compute storage-pools update per modificare un pool di archiviazione.

gcloud compute storage-pools update STORAGE_POOL_NAME  \
    --zone=ZONE   \
    --provisioned-capacity=POOL_SIZETiB   \
    --provisioned-iops=IOPS   \
    --provisioned-throughput=THROUGHPUT   \
    --description=DESCRIPTION

Sostituisci quanto segue:

  • STORAGE_POOL_NAME: il nome del pool di archiviazione.
  • ZONE: (Facoltativo) la zona in cui si trova il pool di archiviazione, ad esempio us-central1-a.
  • POOL_SIZE: facoltativo, la capacità sottoposta a provisioning del pool di archiviazione, in TiB.
  • IOPS: facoltativo, le IOPS sottoposte a provisioning del pool di archiviazione. Puoi utilizzare questo flag solo con i pool di archiviazione Hyperdisk Balanced.
  • THROUGHPUT: facoltativo, il throughput di cui è stato eseguito il provisioning per il pool di archiviazione, in MiB/s.
  • DESCRIPTION: (Facoltativo) una stringa descrittiva per il pool di archiviazione.

REST

Per aggiornare un pool di archiviazione, crea una richiesta PATCH utilizzando il metodo storagePools.update.

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/storagePools/STORAGE_POOL_NAME

{
    "description": "DESCRIPTION",
    "poolProvisionedCapacityGb": "SIZE",
    "poolProvisionedIops": "IOPS",
    "poolProvisionedThroughput": "THROUGHPUT"
}

Sostituisci quanto segue:

  • PROJECT_ID: l'ID progetto
  • ZONE: la zona in cui si trova il pool di archiviazione, ad esempio us-central1-a.
  • STORAGE_POOL_NAME: il nome del pool di archiviazione.
  • DESCRIPTION: facoltativo, un campo di testo per descrivere il pool di archiviazione.
  • SIZE: (Facoltativo) la capacità sottoposta a provisioning del nuovo pool di archiviazione, in GiB.
  • IOPS: (Facoltativo) il nuovo valore per le IOPS sottoposte a provisioning del pool di archiviazione. Puoi specificare questa proprietà solo quando il pool di archiviazione contiene dischi di tipo hyperdisk-balanced.
  • THROUGHPUT: (facoltativo) il nuovo valore del throughput sottoposto a provisioning del pool di archiviazione, specificato in MiB/s.

Elimina un pool di archiviazione

Per eliminare o rimuovere un pool di archiviazione, devi prima eliminare tutti i dischi al suo interno. Dopodiché, puoi utilizzare la console Google Cloud , Google Cloud CLI o REST per eliminare il pool di archiviazione.

L'eliminazione di un pool di archiviazione è irreversibile. Tuttavia, l'eliminazione di un pool di archiviazione non elimina gli snapshot creati dai dischi creati nel pool di archiviazione. Devi eliminare gli snapshot separatamente.

Console

  1. Vai alla pagina Pool di archiviazione nella console Google Cloud .
    Vai alla pagina Pool di archiviazione

  2. Nel campo Nome, fai clic sul nome del pool di archiviazione che vuoi rimuovere.

    Viene visualizzata la pagina Gestisci pool di archiviazione.

  3. Nella sezione Dischi del pool di archiviazione, verifica che non siano elencati dischi per il pool di archiviazione.

  4. Fai clic su Elimina pool.

gcloud

Utilizza il comando gcloud compute storage-pools delete per eliminare un pool di archiviazione.

gcloud compute storage-pools delete STORAGE_POOL_NAME  \
    --zone=ZONE   \

Sostituisci quanto segue:

  • STORAGE_POOL_NAME: il nome univoco del pool di archiviazione.
  • ZONE: (facoltativo) la zona in cui si trova il pool di archiviazione, ad esempio us-central1-a.

REST

Per rimuovere un pool di archiviazione, crea una richiesta DELETE per il metodo storagePools.delete.

DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/storagePools/STORAGE_POOL_NAME

Sostituisci quanto segue:

  • PROJECT_ID: l'ID progetto
  • ZONE: la zona in cui si trova il pool di archiviazione, ad esempio us-central1-a.
  • STORAGE_POOL_NAME: il nome univoco del pool di archiviazione.

Passaggi successivi