Gestisci i pool Hyperdisk

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

Nota: gli Exapool Hyperdisk sono disponibili pubblicamente con una lista consentita. Per modificare o eliminare un exapool, contatta il tuo team dell'account.

Prima di iniziare

• Se non l'hai ancora fatto, configura l'autenticazione. L'autenticazione verifica la tua identità per l'accesso ad API e servizi Google Cloud . 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 comando seguente:

     gcloud init

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

     Nota: se hai installato gcloud CLI in precedenza, assicurati di avere l'ultima versione eseguendo gcloud components update.
  2. Set a default region and zone.

  REST

  Per utilizzare gli esempi di API REST in questa pagina in un ambiente di sviluppo locale, utilizzi le credenziali che fornisci a gcloud CLI.

  Installa Google Cloud CLI. Dopo l'installazione, inizializza Google Cloud CLI eseguendo il comando seguente:

  gcloud init

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

  Nota: se hai installato gcloud CLI in precedenza, assicurati di avere l'ultima versione eseguendo gcloud components update.

  Per saperne di più, consulta Autenticati per usare REST nella documentazione sull'autenticazione di Google Cloud .

Ruoli e autorizzazioni richiesti

Per ottenere le autorizzazioni necessarie per gestire un pool, chiedi all'amministratore di concederti i seguenti ruoli IAM nel 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. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per gestire un pool sono necessarie le seguenti autorizzazioni:

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

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

Limitazioni

Limitazioni per la gestione dei pool:

• Non puoi modificare il modello di provisioning per un pool. Ad esempio, 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 puoi spostare i dischi all'interno o all'esterno di un pool. Per spostare un disco all'interno o all'esterno di un pool, 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.

Limitazioni specifiche per i pool di archiviazione:

• 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.
• Puoi eliminare al massimo 5 pool di archiviazione all'ora.
• Il comando di gestione del pool di archiviazione viene completato immediatamente, ma l'azione può richiedere fino a 5 minuti e le modifiche possono richiedere fino a 30 minuti per essere visualizzate.

Limitazioni specifiche per Exapools:

• Devi contattare il team dell'account per modificare la capacità, gli IOPS o il throughput di un exapool.
• Per eliminare un exapool, devi contattare il team dedicato al tuo account.

Per l'elenco completo delle limitazioni dei pool, consulta Limitazioni dei pool.

Intervalli di valori durante la modifica dei pool

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.

Elenca i pool per un progetto

Per visualizzare i pool 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

2. Seleziona la scheda Exapools o Pool di archiviazione.

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

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

gcloud

Per elencare tutti i pool 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 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, ad esempio us-central1-a.

Elenca i dischi in un pool

Per ottenere un elenco dei dischi creati in un pool, 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

2. Seleziona la scheda Exapools o Pool di archiviazione.

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

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

   Viene visualizzata la pagina Gestisci pool di archiviazione.

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

gcloud

Per elencare i dischi creati in un pool, 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.
• ZONE: (Facoltativo) La zona in cui si trova il pool, ad esempio us-central1-a.

REST

Per elencare i dischi che utilizzano un pool, 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, ad esempio us-central1-a.
• STORAGE_POOL_NAME: il nome del pool.

Descrivere un pool

Per visualizzare i dettagli di un pool, 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. Seleziona la scheda Exapools o Pool di archiviazione.

3. Per ogni pool 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

4. Nel campo Nome, fai clic sul nome del pool che vuoi visualizzare.

   Viene visualizzata la pagina Gestisci pool di archiviazione.

5. Nei riquadri nella parte superiore della pagina puoi visualizzare la capacità sottoposta a provisioning e utilizzata, nonché il throughput e le IOPS sottoposti a provisioning e utilizzati per il pool.

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

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

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

gcloud

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

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

Sostituisci quanto segue:

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

REST

Per recuperare i dettagli di un pool, 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
• ZONE: la zona in cui si trova il pool, ad esempio us-central1-a
• STORAGE_POOL_NAME: il nome del pool

Modificare un pool

Puoi aumentare o diminuire la capacità, le IOPS o il throughput sottoposti a provisioning di un pool.

Modifica un pool di archiviazione

Per aumentare la capacità, le IOPS o il throughput di un pool di archiviazione, devi disporre di una quota disponibile per il progetto e la regione. Potrebbero essere necessari fino a 30 minuti prima che i nuovi valori di provisioning vengano visualizzati per il pool di archiviazione.

Console

1. Vai alla pagina Pool di archiviazione nella console Google Cloud .
   Vai alla pagina Pool di archiviazione
2. Seleziona la scheda Pool di archiviazione.

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

   Viene visualizzata la pagina Gestisci pool di archiviazione.

4. Fai clic su Modifica.

   Viene visualizzata la pagina Modifica pool di archiviazione.

5. (Facoltativo) Nel campo Capacità pool di archiviazione, inserisci il nuovo valore per la capacità di cui è stato eseguito il 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.

6. (Facoltativo) Nel campo Throughput riservato, inserisci il nuovo valore per il throughput riservato.

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

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

REST

Per aggiornare un pool, 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, ad esempio us-central1-a.
• STORAGE_POOL_NAME: il nome del pool.
• DESCRIPTION: facoltativo, un campo di testo per descrivere il pool.
• SIZE: (Facoltativo) la capacità sottoposta a provisioning del nuovo pool, in GiB.
• IOPS: (Facoltativo) il nuovo valore per le IOPS sottoposte a provisioning del pool. Puoi specificare questa proprietà solo quando il pool contiene dischi di tipo hyperdisk-balanced.
• THROUGHPUT: (Facoltativo) il nuovo valore del throughput sottoposto a provisioning del pool, specificato in MiB/s.

Modificare un Exapool

Per modificare la capacità, le IOPS o il throughput di un Exapool di cui è stato eseguito il provisioning, contatta il tuo team dedicato all'account.

Eliminare un pool

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

Elimina un pool di archiviazione

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

Console

1. Vai alla pagina Pool di archiviazione nella console Google Cloud .
   Vai alla pagina Pool di archiviazione
2. 1. Seleziona la scheda Pool di archiviazione.

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

   Viene visualizzata la pagina Gestisci pool di archiviazione.

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

5. Fai clic su Elimina pool.

gcloud

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

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

Sostituisci quanto segue:

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

REST

Per rimuovere un pool, 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, ad esempio us-central1-a.
• STORAGE_POOL_NAME: il nome univoco del pool.

Eliminare un Exapool

Per eliminare un exapool, contatta il tuo team dell'account.

Passaggi successivi

• Scopri di più sui pool Hyperdisk.