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 mediante il quale viene verificata l'identità per l'accesso ai servizi e alle API Google Cloud. Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi autenticarti in Compute Engine nel seguente modo.

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, quindi initialize eseguendo questo comando:
```
gcloud init
```
  Nota: se hai già installato gcloud CLI in precedenza, assicurati di disporre della versione più recente eseguendo gcloud components update.
2. Set a default region and zone.

Autorizzazioni e ruoli richiesti

Per ottenere le autorizzazioni necessarie per gestire un pool di archiviazione, chiedi all'amministratore di concederti i seguenti ruoli IAM sul 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.

Questi ruoli predefiniti contengono le autorizzazioni necessarie per gestire un pool di archiviazione. Per visualizzare le autorizzazioni esatte necessarie, 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 cui è stato eseguito il provisioning di un pool di archiviazione:
- compute.storagePools.get
- compute.storagePools.update
Per eliminare un pool di archiviazione: compute.storagePools.delete

Potresti anche essere in grado di ottenere queste autorizzazioni con i ruoli personalizzati o altri ruoli predefiniti.

Limitazioni

Tieni presente le seguenti limitazioni quando gestisci i pool di archiviazione Hyperdisk:

Puoi modificare la capacità di cui è stato eseguito il provisioning di un pool di archiviazione al massimo due volte in un periodo di 24 ore.
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 maggiori informazioni, consulta Cambiare il tipo di disco.
Non puoi clonare, creare snapshot istantanei, o configurare la replica asincrona del disco permanente per i dischi in un pool di archiviazione.
Puoi eliminare un massimo di 5 pool di archiviazione all'ora.
Il comando di gestione del pool di archiviazione ha esito positivo o negativo immediatamente, ma il completamento dell'azione può richiedere fino a 5 minuti e fino a 30 minuti prima che le modifiche vengano visualizzate.

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

Intervalli di valori durante la modifica dei pool di archiviazione

La capacità minima di cui è stato eseguito il provisioning per un pool di archiviazione è di 10 TiB e la capacità massima di cui è stato eseguito il provisioning è di 1 PiB. Puoi modificare la capacità del pool di archiviazione di cui è stato eseguito il provisioning in incrementi di 1 TiB.

Per i limiti di provisioning delle prestazioni, fai riferimento a quanto segue:

Elenco dei 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

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.
(Facoltativo) Utilizza la barra Filtro per visualizzare solo i pool di archiviazione che corrispondono ai parametri del filtro, come Località, Tipo, Nome e Capacità del pool rimanente.

gcloud

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

gcloud compute storage-pools list

REST

Per visualizzare 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.

Elenco dei 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

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.
Nel campo Nome, fai clic sul nome del pool di archiviazione che vuoi visualizzare.

Viene visualizzata la pagina Gestisci pool di archiviazione.
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

Vai alla pagina Pool di archiviazione nella console Google Cloud.
Vai alla pagina Pool di archiviazione
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
Nel campo Nome, fai clic sul nome del pool di archiviazione che vuoi visualizzare.

Viene visualizzata la pagina Gestisci pool di archiviazione.
Nella sezione Impostazioni del pool di archiviazione, puoi visualizzare proprietà aggiuntive del pool di archiviazione, come ora di creazione e tipo di provisioning della capacità.
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

Aggiorna capacità, IOPS o velocità effettiva sottoposta a provisioning di un pool di archiviazione

Puoi aumentare o diminuire la capacità sottoposta a provisioning, il numero di IOPS o la velocità effettiva di un pool di archiviazione. Per aumentare la capacità, il numero di IOPS o la velocità effettiva di un pool di archiviazione, devi disporre di una quota per il progetto e la regione.

Console

Vai alla pagina Pool di archiviazione nella console Google Cloud.
Vai alla pagina Pool di archiviazione
Nel campo Nome, fai clic sul nome del pool di archiviazione che vuoi modificare.

Viene visualizzata la pagina Gestisci pool di archiviazione.
Fai clic su Modifica.

Viene visualizzata la pagina Modifica pool di archiviazione.
(Facoltativo) Nel campo Capacità del 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 massimo 100 TiB in più o in meno rispetto al valore corrente. La dimensione minima non può essere inferiore a 10 TiB e la dimensione massima non può essere superiore a 1024 TiB.
(Facoltativo) Nel campo Velocità effettiva sottoposta a provisioning, inserisci il nuovo valore per la velocità effettiva sottoposta a provisioning.
(Facoltativo) Per i pool di archiviazione di tipo Hyperdisk bilanciato, nel campo IOPS di cui è stato eseguito il provisioning, inserisci il nuovo valore per le IOPS di cui è stato eseguito il provisioning.
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à di cui è stato eseguito il provisioning del pool di archiviazione, in TiB.
IOPS: (facoltativo) le IOPS di cui è stato eseguito il provisioning del pool di archiviazione. Puoi utilizzare questo flag solo con i pool di archiviazione bilanciati di Hyperdisk.
THROUGHPUT: facoltativo: la velocità effettiva di provisioning del pool di archiviazione, in MBps.
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 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 per la velocità effettiva sottoposta a provisioning 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 all'interno del pool. Poi puoi usare 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 creati dai dischi creati nel pool. Devi eliminare gli snapshot separatamente.

Console

Vai alla pagina Pool di archiviazione nella console Google Cloud.
Vai alla pagina Pool di archiviazione
Nel campo Nome, fai clic sul nome del pool di archiviazione che vuoi rimuovere.

Viene visualizzata la pagina Gestisci pool di archiviazione.
Nella sezione Dischi del pool di archiviazione, verifica che non siano elencati dischi per il pool di archiviazione.
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.

Che cosa succede dopo?

Scopri di più sui pool di spazio di archiviazione.