Questa pagina è stata tradotta dall'API Cloud Translation.

Gestisci 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 come segue.

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
  Note: If you installed the gcloud CLI previously, make sure you have the latest version by running gcloud components update.
2. Set a default region and zone.

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 le autorizzazioni necessarie per gestire un pool di archiviazione. Per vedere le autorizzazioni esatte obbligatorie, 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 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 riuscire a ottenere queste autorizzazioni con ruoli personalizzati 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 cui è stato eseguito il 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 Da un pool di archiviazione con capacità standard a un pool di capacità avanzata o a un Da un pool di archiviazione a prestazioni avanzate a uno 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 Cambiare 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 il completamento dell'azione potrebbe richiedere fino a 5 minuti. e fino a 30 minuti per visualizzare le modifiche.

Per l'elenco completo dei limiti del pool di archiviazione Hyperdisk, vedi Limiti dei pool di archiviazione.

Intervalli di valori durante la modifica dei pool di archiviazione

Durante la creazione di un pool di archiviazione, i nuovi valori per dimensione, IOPS e velocità effettiva deve rientrare nei limiti previsti per il tipo di pool di archiviazione che stai modificando. Inoltre, puoi specificare nuovi valori solo utilizzando valori incrementali supportati.

Per informazioni dettagliate sui limiti di provisioning delle prestazioni, consulta Limiti per i pool di archiviazione.

Elenca i pool di archiviazione per un progetto

Per vedere i pool di archiviazione creati in un progetto, utilizza 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 progetto.
(Facoltativo) Utilizza la barra Filtro per visualizzare solo i pool di archiviazione che corrispondono ai parametri del filtro come Location, Type, Name Capacità del 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 --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 un GET tramite l'oggetto 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 lo spazio di archiviazione piscina
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 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.

Si apre la pagina Gestisci il pool di archiviazione.
Nella sezione Dischi del pool di archiviazione, puoi visualizzare i dischi creati nel pool di archiviazione.

gcloud

Per elencare i dischi creati in un pool di archiviazione, utilizza 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 localizzato, ad esempio us-central1-a.

REST

Per elencare i dischi che utilizzano un pool di archiviazione, crea un GET tramite l'oggetto 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 lo spazio di archiviazione piscina
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.

Si apre la pagina Gestisci il pool di archiviazione.
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.
Nella sezione Impostazioni del pool di archiviazione, puoi visualizzare altri alle proprietà del pool di archiviazione, come ora di creazione, tipo di provisioning della capacità, tipo di provisioning delle prestazioni, il totale di dischi nel pool di archiviazione di utilizzo per capacità, velocità effettiva e IOPS.
Nella sezione Dischi del pool di archiviazione, puoi visualizzare le informazioni i 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 un GET tramite l'oggetto 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 la 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 sottoposto a provisioning

Puoi aumentare o diminuire la capacità di provisioning, il numero di 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

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.

Si apre la pagina Gestisci il 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 provisioning del pool. Il nuovo valore deve essere maggiore o minore del valore corrente di almeno 1 TiB e al massimo di 100 TiB. Il minimo la dimensione non può essere inferiore a 10 TiB e la dimensione massima non può essere superiore di 1024 TiB.
(Facoltativo) Nel campo Throughput pianificato, inserisci il nuovo valore per il throughput pianificato.
(Facoltativo) Per i pool di archiviazione di tipo Hyperdisk bilanciato, inserisci il nuovo valore per le IOPS sottoposte a provisioning nel campo IOPS sottoposte a 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à 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 bilanciati Hyperdisk.
THROUGHPUT: (facoltativo) il pool di archiviazione di cui è stato eseguito il provisioning in MBps.
DESCRIPTION: (facoltativo) una stringa descrittiva per il valore 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) il provisioning del nuovo pool di archiviazione 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 pool di archiviazione velocità effettiva sottoposta a provisioning, specificata 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 di archiviazione. 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

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 da rimuovere.

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

Passaggi successivi

Scopri di più sui pool di archiviazione.