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 è la procedura mediante la quale la tua identità viene verificata per l'accesso alle API e ai 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. Install the Google Cloud CLI, then initialize it by running the following command: 

      gcloud init
    2. Set a default region and zone.

      3. REST

      Per utilizzare gli esempi dell'API REST in questa pagina in un ambiente di sviluppo locale, utilizza le credenziali fornite a gcloud CLI.

        Install the Google Cloud CLI, then initialize it by running the following command: 

        gcloud init

      Per ulteriori informazioni, consulta Eseguire l'autenticazione 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 nel progetto:

  • Amministratore istanze Compute (v1) (roles/compute.instanceAdmin.v1)
  • Per connetterti a un'istanza VM che può essere eseguita come account di servizio: Utente account di servizio (v1) (ruolo roles/iam.serviceAccountUser)

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

Questi ruoli predefiniti contengono le autorizzazioni necessarie per gestire un pool di archiviazione. Per visualizzare le autorizzazioni esatte richieste, espandi la sezione Autorizzazioni richieste:

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 di un pool di archiviazione sottoposte a provisioning:
    • 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 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 cambiare un pool di archiviazione con capacità standard in un pool di archiviazione con capacità avanzata o da un pool di archiviazione con capacità avanzata in pool di archiviazione per 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 Modificare il tipo di disco.
  • Non puoi clonare, creare snapshot istantanei o configurare la replica asincrona dei dischi permanenti 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 ha esito positivo o negativo immediatamente, ma possono essere necessari fino a 5 minuti per completare l'azione e fino a 30 minuti per visualizzare le modifiche.

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

Intervalli di valori per 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 i limiti dettagliati del provisioning del rendimento, 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 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

    La pagina mostra i pool di archiviazione creati nel progetto selezionato.

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

gcloud

Per elencare tutti i pool di archiviazione creati nel 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 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

    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 provisioning e in uso, nonché la velocità effettiva e le IOPS di provisioning e in uso per il pool di archiviazione.

  5. Nella sezione Impostazioni del pool di archiviazione, puoi visualizzare proprietà aggiuntive del pool di archiviazione, ad esempio la data 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.

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

Aggiornare la capacità, le IOPS o la velocità effettiva di un pool di archiviazione sottoposte a provisioning

Puoi aumentare o diminuire la capacità di provisioning, le IOPS o la velocità effettiva di un pool di archiviazione. Per aumentare la capacità, le IOPS o la velocità effettiva di un pool di archiviazione, devi disporre di 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à del pool di archiviazione, inserisci il nuovo valore per la capacità di provisioning del pool. Il nuovo valore deve essere maggiore o minore del valore corrente di almeno 1 TiB e al massimo di 100 TiB. 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 pianificato, inserisci il nuovo valore per il throughput pianificato.

  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à provisionata 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 del pool di archiviazione provisionato in MB/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à del nuovo pool di archiviazione di cui è stato eseguito il provisioning in GiB.
  • IOPS: facoltativo, il nuovo valore per le IOPS con 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 per il throughput provisionato del pool di archiviazione, specificato in MBps.

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 comporta l'eliminazione degli snapshot realizzati 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