Creazione di volumi Block Storage for VPC
Creare volumi di archiviazione di tipo “ IBM Cloud ” durante il provisioning delle istanze, come volumi autonomi o tramite ripristino da snapshot. Configurare la capacità, gli IOPS e la crittografia.
Prima di iniziare, assicurati di aver creato un VPC. Quando si crea un volume da una snapshot, è possibile utilizzare una snapshot del proprio account o di un altro account. Se si intende utilizzare una snapshot da un altro account, assicurarsi che siano presenti le giuste autorizzazioni IAM.
Le funzioni Hyper Protect Crypto Services sono obsolete. I clienti possono utilizzare le istanze esistenti fino al 20 marzo 2027. Per ulteriori informazioni, consultare la sezione " Deprecazione di IBM Cloud Hyper Protect Crypto Services ". Per garantire una protezione continua, ti consigliamo di trasferire le tue chiavi di crittografia esistenti su un'istanza dedicata di Key Protect. Per ulteriori informazioni, consultare la Guida alla migrazione.
CreareBlock Storage for VPC volumi nella console
Utilizza la console IBM Cloud per creare un volume Block Storage for VPC quando crei un'istanza del server virtuale o come un volume autonomo.
Creazione e collegamento di un volume Block Storage for VPC quando crei un'istanza
- Nella console IBM Cloud console, fare clic sull'icona Menu di navigazione
> Infrastruttura
> Calcolo > Istanze server virtuali.
- Dall'elenco di istanze server virtuale, fai clic su Crea.
- Nella pagina Virtual server for VPC provisioning, seleziona Tipo di server, Ubicazione, SO, Profilo, Gruppo di posizionamento e così via. Per ulteriori informazioni sul provisioning dell'istanza, vedi Creazione di un'istanza del server virtuale con l'IU.
- I dettagli del volume di avvio da creare vengono visualizzati nella pagina. È possibile modificare il volume di avvio facendo clic sull'icona Mod
la capacità, impostare la crittografia e aggiungere eventuali tag utente per identificare questa risorsa. È possibile modificare il profilo in
sdpogeneral-purpose. - Per creare un volume di dati e collegarlo all'istanza, nel file Volumi di dati sezione della pagina di provisioning dell'istanza, fare clic su Creare. Nel pannello laterale, specificare i dettagli relativi
al volume.
- È possibile creare un volume di dati vuoto o creare un volume con dati importati da un'istantanea. Se si sceglie Importa istantanea esistente, selezionare un'istantanea disponibile dall'elenco. Se si sceglie di importare l'istantanea per CRN, tenere pronto il CRN dell'istantanea da inserire.
- Specificare un nome univoco e significativo per il volume. Ad esempio, può trattarsi di un nome che descrive la funzione del tuo sistema di elaborazione o del tuo carico di lavoro. Il nome del volume deve iniziare con una lettera minuscola. Il nome può contenere fino a 63 caratteri alfanumerici minuscoli e includere il trattino (-). I nomi dei volumi devono essere unici per la VPC. Se vuoi, puoi modificare il nome in un secondo momento.
- La funzione di eliminazione automatica è disattivata per impostazione predefinita. Se desideri che il volume venga eliminato quando viene eliminata l'istanza del server virtuale collegata, fai clic sull'interruttore per abilitare la funzionalità.
- Il gruppo di risorse e la posizione vengono ereditati dall'istanza. Questi valori non possono essere modificati.
- È possibile specificare tag utente facoltativi da associare a questo volume. Per ulteriori informazioni sull'organizzazione delle risorse con le tag utente, vedi Gestione delle tag.
- Nella sezione " Crittografia ", la crittografia gestita dal provider è abilitata per impostazione predefinita. Per utilizzare la propria chiave di crittografia,
fare clic sul pulsante di attivazione/disattivazione per abilitare la crittografia gestita dal cliente. Se disponi già di un'istanza KMS e di una chiave root, il sistema le seleziona automaticamente per te. È possibile fare clic su
" Icona Modifica
" per passare a un'altra chiave o istanza. Per individuare la chiave di crittografia, seleziona una delle seguenti opzioni:
- Ricerca per istanza: il pannello prevede tre passaggi:
- Seleziona un'istanza KMS: l'elenco mostra il nome, l'ID, il tipo (Standard o Dedicata) e la posizione di ciascuna istanza disponibile di Key Protect. Seleziona un'istanza e fai clic su Seleziona. Se non disponi ancora di un'istanza, fai clic su " Crea " per crearne una.
- Chiave associata: l'elenco riporta il nome, l'ID, la data dell'ultimo aggiornamento, gli alias e il portachiavi di ciascuna chiave radice disponibile. Selezionare un tasto e fare clic su “Seleziona ”. Se non disponi ancora di una chiave, fai clic su " Crea nuova chiave ".
- Verifica: confermare le selezioni effettuate, tra cui il servizio di gestione delle chiavi, il tipo di istanza, il nome dell'istanza e il nome della chiave. La sezione " Autorizzazione del servizio " indica se l'autorizzazione richiesta tra Block Storage for VPC e l'istanza KMS è già attiva. In caso contrario, puoi consentire a Key Protect di creare automaticamente l'autorizzazione oppure crearne una manualmente. Per ulteriori informazioni, consultare la sezione " Configurazione delle autorizzazioni da servizio a servizio" all'indirizzo Block Storage for VPC. Fare clic su Conferma per applicare la selezione e tornare alla configurazione del volume.
- Locate by CRN: inserire il CRN della chiave root del cliente da utilizzare per la crittografia del volume. Scegli questa opzione se stai utilizzando il CRK di un altro account. Fare clic su “Seleziona ” per passare alla fase di revisione descritta nell’opzione “Individua per istanza ”.
- Ricerca per istanza: il pannello prevede tre passaggi:
- Seleziona il profilo di archiviazione. Se si sceglie di importare i dati da un'istantanea, il valore di generazione dello storage dell'istantanea deve corrispondere al valore di generazione dello storage del profilo di volume selezionato.
- È possibile selezionare il profilo
sdpquando si desidera specificare la capacità del volume di archiviazione fino a 32.000 GB, con limiti IOPS e Throughput personalizzati. - Quando si desidera utilizzare un volume di prima generazione con livelli IOPS predefiniti, è possibile selezionare uno dei profili a livelli. Quando si seleziona l' uso generale, 5iops-tier, o 10iops-tier è sufficiente specificare la capacità del volume.
- Quando le prestazioni dell'applicazione non rientrano in nessuno dei livelli IOPS, è possibile scegliere il profilo personalizzato. Specificate le dimensioni del volume e gli IOPS nell'intervallo appropriato per la capacità del volume. Le dimensioni del volume possono essere comprese tra 10 e 16.000 GB. Quando immetti il valore IOPS, l'IU mostra l'intervallo accettabile. È inoltre possibile fare clic sul collegamento relativo alle dimensioni dello storage per visualizzare le dimensioni e gli intervalli IOPS del profilo di volume personalizzato.
- È possibile selezionare il profilo
- È possibile applicare un criterio di backup quando si crea il volume. Fare clic su Applica, quindi selezionare un criterio esistente dall'elenco a discesa nel pannello laterale. Selezionare i tag da applicare alla destinazione e fare clic su Applica criterio e tag.
- Fare clic su Salva.
- Ritorni alla pagina di provisioning dell'istanza virtuale per completare la definizione degli attributi rimanenti dell'istanza del server virtuale.
- Quando sei soddisfatto delle tue scelte, fai clic Crea un server virtuale.
Un volume di tipo “ Block Storage for VPC ” può essere associato a un solo server virtuale alla volta. Nella pagina di riepilogo del volume " Block Storage for VPC " è possibile visualizzare i dettagli relativi all'istanza del server virtuale selezionando il nome dell'istanza nella sezione " Istanze collegate ".
Creazione e collegamento di un volume Block Storage for VPC da una istanza esistente
Puoi creare un volume Block Storage for VPC da un'istanza esistente.
- Vai all'elenco delle istanze dei server virtuali. Nella console IBM Cloud console, fare clic sull'icona Menu di navigazione
> Infrastruttura
> Calcolo > Istanze server virtuali.
- Seleziona un'istanza dall'elenco.
- Nella pagina dei dettagli dell'istanza, fare clic sulla scheda Archiviazione.
- Nell'elenco dei volumi di archiviazione collegati, fare clic su Allega.
- Nel pannello laterale, fai clic sulla freccia giù in Block volumes e seleziona Create a data volume. Il pannello laterale si espande con i campi per definire il volume.
- Se hai creato delle istantanee del volume in precedenza, l'opzione per importarne una diventa disponibile. Fare clic sulla levetta per Importare da un'istantanea e selezionare un'istantanea dall'elenco o individuare l'istantanea in base al suo CRN.
- Specificare un nome univoco e significativo per il volume. Ad esempio, può trattarsi di un nome che descrive la funzione del tuo sistema di elaborazione o del tuo carico di lavoro. Il nome del volume deve iniziare con una lettera minuscola. Il nome può contenere fino a 63 caratteri alfanumerici minuscoli e includere il trattino (-). I nomi dei volumi devono essere unici per la VPC. Se vuoi, puoi modificare il nome in un secondo momento.
- La funzione di eliminazione automatica è disattivata per impostazione predefinita. Se desideri che il volume venga eliminato quando viene eliminata l'istanza del server virtuale collegata, fai clic sull'interruttore per abilitare la funzionalità.
- Il gruppo di risorse e la posizione vengono ereditati dall'istanza. Questi valori non possono essere modificati.
- È possibile specificare tag utente facoltativi da associare a questo volume. Per ulteriori informazioni sull'organizzazione delle risorse con le tag utente, vedi Gestione delle tag.
- Nella sezione " Crittografia ", la crittografia gestita dal provider è abilitata per impostazione predefinita. Per utilizzare la propria chiave di crittografia,
fare clic sul pulsante di attivazione/disattivazione per abilitare la crittografia gestita dal cliente. Se disponi già di un'istanza KMS e di una chiave root, il sistema le seleziona automaticamente per te. È possibile fare clic su
" Icona Modifica
" per passare a un'altra chiave o istanza. Per individuare la chiave di crittografia, seleziona una delle seguenti opzioni:
- Ricerca per istanza: il pannello prevede tre passaggi:
- Seleziona un'istanza KMS: l'elenco mostra il nome, l'ID, il tipo (Standard o Dedicata) e la posizione di ciascuna istanza disponibile di Key Protect. Seleziona un'istanza e fai clic su Seleziona. Se non disponi ancora di un'istanza, fai clic su " Crea " per crearne una.
- Chiave associata: l'elenco riporta il nome, l'ID, la data dell'ultimo aggiornamento, gli alias e il portachiavi di ciascuna chiave radice disponibile. Selezionare un tasto e fare clic su “Seleziona ”. Se non disponi ancora di una chiave, fai clic su " Crea nuova chiave ".
- Verifica: confermare le selezioni effettuate, tra cui il servizio di gestione delle chiavi, il tipo di istanza, il nome dell'istanza e il nome della chiave. La sezione " Autorizzazione del servizio " indica se l'autorizzazione richiesta tra Block Storage for VPC e l'istanza KMS è già attiva. In caso contrario, puoi consentire a Key Protect di creare automaticamente l'autorizzazione oppure crearne una manualmente. Per ulteriori informazioni, consultare la sezione " Configurazione delle autorizzazioni da servizio a servizio" all'indirizzo Block Storage for VPC. Fare clic su Conferma per applicare la selezione e tornare alla configurazione del volume.
- Locate by CRN: inserire il CRN della chiave root del cliente da utilizzare per la crittografia del volume. Scegli questa opzione se stai utilizzando il CRK di un altro account. Fare clic su “Seleziona ” per passare alla fase di revisione descritta nell’opzione “Individua per istanza ”.
- Ricerca per istanza: il pannello prevede tre passaggi:
- Fai clic su Next.
- Seleziona il profilo di archiviazione. Se si sceglie di importare i dati da un'istantanea, il valore di generazione dello storage dell'istantanea deve corrispondere al valore di generazione dello storage del profilo di volume selezionato.
- È possibile selezionare il profilo
sdp. Quindi, specificare la capacità del volume, il limite di larghezza di banda richiesto e gli IOPS richiesti. Le dimensioni del volume possono variare da 1 a 32.000 GB. È possibile specificare un intervallo di IOPS compreso tra 100 e 64.000. Il limite di velocità è di 1000-8192 Mbps. - È possibile selezionare uno dei profili a livelli. Dopo aver selezionato l' uso generale, 5iops-tier, o 10iops-tier il passo successivo è quello di specificare la capacità del volume. Le dimensioni del volume possono essere comprese tra 10 e 16.000 GB.
- È possibile selezionare il profilo personalizzato se i requisiti di prestazione dell'applicazione non rientrano in nessuno dei livelli IOPS. Quindi, specificare le dimensioni del volume e gli IOPS nell'intervallo appropriato per la capacità del volume. Le dimensioni del volume possono essere comprese tra 10 e 16.000 GB. Quando immetti il valore IOPS, l'IU mostra l'intervallo accettabile. È inoltre possibile fare clic sul collegamento relativo alle dimensioni dello storage per visualizzare le dimensioni e gli intervalli IOPS del profilo di volume personalizzato.
- È possibile selezionare il profilo
- Fare clic su Salva.
- Una volta terminata la definizione del volume, fare clic su Salva. Il volume viene creato e collegato all'istanza. Ritorni alla pagina dei dettagli dell'istanza. Il nuovo volume viene mostrato nell'elenco dei volumi di memoria.
Creazione di un volume autonomo Block Storage for VPC
È possibile creare un volume " Block Storage for VPC " indipendentemente dal provisioning del server virtuale e collegare il volume a un'istanza in un secondo momento.
-
Nella console IBM Cloud console, fare clic sull'icona Menu di navigazione
> Infrastruttura
> Archiviazione > Block Storage volumi.
-
Fai clic su Crea.
-
SulBlock Storage for VPC pagina di provisioning, rivedere il file Posizione informazione. L'area geografica, la regione e la zona vengono ereditate dal VPC (ad esempio, Nord America, Dallas,Dallas-1 ). Puoi selezionare una zona diversa nella tua posizione dal menu facendo clic su Modifica icona
.
-
Nel Dettagli sezione, è necessario specificare il nome del volume e il gruppo di risorse a cui deve essere aggiunto il volume. Facoltativamente, è possibile aggiungere tag di gestione utente e accesso.
-
Specifica un nome significativo per il tuo volume. Ad esempio, fornisci un nome che descrive la tua funzione di carico di lavoro o calcolo.
Il nome del volume deve iniziare con una lettera minuscola. Il nome del volume può contenere fino a 63 caratteri alfanumerici minuscoli e includere il trattino (-). I nomi dei volumi devono essere univoci nell'intera infrastruttura VPC. Puoi modificare il nome in un secondo momento.
-
Specificare un Gruppo di risorse.
-
Specifica le tag utente per organizzare le tue risorse e per l'utilizzo da parte delle politiche di backup ( backup policies).
-
Specifica le tag di gestione dell'accesso che sono state create in IAM per aiutarti a gestire l'accesso ai tuoi volumi.
-
-
Nel Configurazioni opzionali sezione, è possibile specificare se si desidera creare il volume con i dati da uno snapshot. Per ulteriori informazioni, vedere Crea un file autonomoBlock Storage for VPC volume da un'istantanea. Inoltre, puoi scegliere di applicare una politica di backup. Fai clic su "Applica " per visualizzare le polizze e i piani disponibili.
-
Nella sezione Profilo è possibile specificare il profilo di prestazioni del volume, i limiti di prestazioni e la capacità. Se si sceglie di importare i dati da un'istantanea, il valore di generazione dello storage dell'istantanea deve corrispondere al valore di generazione dello storage del profilo di volume selezionato.
- È possibile selezionare il profilo
sdp. Quindi, specificare la capacità del volume, il limite di throughput richiesto e gli IOPS necessari. Le dimensioni del volume possono variare da 1 a 32.000 GB. È possibile specificare un intervallo di IOPS compreso tra 100 e 64.000. Il limite di velocità è di 1000-8192 Mbps. - È possibile selezionare uno dei profili a livelli. Dopo aver selezionato l' uso generale, 5iops-tier, o 10iops-tier il passo successivo è quello di specificare la capacità del volume. Le dimensioni del volume possono essere comprese tra 10 e 16.000 GB.
- È possibile selezionare il profilo personalizzato se i requisiti di prestazione dell'applicazione non rientrano in nessuno dei livelli IOPS. Quindi, specificare le dimensioni del volume e gli IOPS nell'intervallo appropriato per la capacità del volume. Quando immetti il valore IOPS, l'IU mostra l'intervallo accettabile. È inoltre possibile fare clic sul collegamento relativo alle dimensioni dello storage per visualizzare le dimensioni e gli intervalli IOPS del profilo di volume personalizzato.
- È possibile selezionare il profilo
-
Nella sezione " Crittografia dei dati inattivi ", è possibile scegliere di mantenere la crittografia con le chiavi gestite d IBM, che è abilitata per impostazione predefinita su tutti i volumi. Oppure puoi scegliere di utilizzare la tua chiave di crittografia. Per modificare la chiave o l'istanza, fare clic su " Icona Modifica
" per aprire il pannello laterale " Configurare la crittografia ". Seleziona una delle seguenti opzioni per individuare la tua chiave di crittografia:
- Ricerca per istanza: il pannello prevede tre passaggi:
- Seleziona un'istanza KMS: l'elenco mostra il nome, l'ID, il tipo (Standard o Dedicata) e la posizione di ciascuna istanza disponibile di Key Protect. Seleziona un'istanza e fai clic su Seleziona. Se non disponi ancora di un'istanza, fai clic su " Crea " per crearne una.
- Chiave associata: l'elenco riporta il nome, l'ID, la data dell'ultimo aggiornamento, gli alias e il portachiavi di ciascuna chiave radice disponibile. Selezionare un tasto e fare clic su “Seleziona ”. Se non disponi ancora di una chiave, fai clic su " Crea nuova chiave ".
- Verifica: confermare le selezioni effettuate, tra cui il servizio di gestione delle chiavi, il tipo di istanza, il nome dell'istanza e il nome della chiave. La sezione " Autorizzazione del servizio " indica se l'autorizzazione richiesta tra Block Storage for VPC e l'istanza KMS è già attiva. In caso contrario, puoi consentire a Key Protect di creare automaticamente l'autorizzazione oppure crearne una manualmente. Per ulteriori informazioni, consultare la sezione " Configurazione delle autorizzazioni da servizio a servizio" all'indirizzo Block Storage for VPC. Fai clic su Conferma per applicare la selezione ed tornare alla pagina di configurazione del volume.
- Locate by CRN: inserire il CRN della chiave root del cliente da utilizzare per la crittografia del volume. Scegli questa opzione se stai utilizzando il CRK di un altro account. Fare clic su “Seleziona ” per passare alla fase di revisione descritta nell’opzione “Individua per istanza ”.
Se è stata selezionata una snapshot di seconda generazione per creare il volume, il tipo di crittografia del volume deve corrispondere al tipo di crittografia della snapshot. Se lo snapshot ha chiavi gestite dal provider, non specificare una chiave di un servizio di gestione delle chiavi.
- Ricerca per istanza: il pannello prevede tre passaggi:
-
Quando hai finito, fai clic su Crea volume di archiviazione blocchi.
- Se non sei ancora pronto per ordinare o stai solo cercando informazioni sui prezzi, puoi aggiungere le informazioni che vedi nel pannello laterale a una stima. Per ulteriori informazioni su come funziona questa funzionalità, vedere Stima dei costi.
-
Sei tornato alBlock Storage for VPC pagina dei volumi, dove un messaggio indica che il volume è in fase di creazione (lo stato del volume è_ in attesa di_ ). Un secondo messaggio viene visualizzato quando viene creato il volume (lo stato del volume è_ disponibile_ ).
-
Per visualizzare i dettagli del nuovo volume, seleziona il link View resource nel secondo messaggio per andare alla pagina Volume details.
Quando si aggiorna l'elenco dei volumi " Block Storage " nella console, il nuovo volume compare all'inizio dell'elenco dei volumi. Per i volumi autonomi, la colonna Tipo di allegato è vuota (-). IL Azioni menù
alla fine di una riga della tabella fornisce un collegamento per allegando unBlock Storage volume a un'istanza.
Creazione di un file autonomoBlock Storage for VPC volume da uno snapshot nella console
Quando crei un volume Block Storage for VPC, puoi selezionare un'istantanea e utilizzarne i dati per creare il nuovo volume. Le istantanee presentate si trovano in uno stato stabile. Il volume di dati creato dall'istantanea non è collegato ad un'istanza e viene visualizzato nel elenco di volumi Block Storage for VPC. In seguito potrai associare il volume a un'istanza.
È possibile ripristinare un volume di avvio da un'istantanea "avviabile". Il volume di avvio viene ripristinato quando crei un'istanza del server virtuale.
- Nella console IBM Cloud console, fare clic sull'icona Menu di navigazione
> Infrastruttura
> Archiviazione > Block Storage volumi.
- Seleziona Crea.
- Specificare la posizione del volume, il nome del volume, il gruppo di risorse opzionale e i tag.
- Nel Configurazioni opzionali sezione, fare clic Importa da istantanea. Seleziona una delle seguenti opzioni
- Fare clic su Importa istantanea esistente per visualizzare l'elenco delle istantanee disponibili. Tutte le istantanee presentate sono in uno stato stabile. Per impostazione predefinita, è selezionata la scheda Non avviabile che elenca tutte le istantanee del volume dati. Per ripristinare un volume di avvio, fare clic sulla scheda Bootable. Attacca il volume alla nuova istanza di server virtuale è selezionato per impostazione predefinita. Il volume di boot viene ripristinato quando l'istanza viene creata.
- Fare clic su Importa snapshot per CRN e fornire il CRN dello snapshot che si desidera utilizzare.
- Fare clic su Salva. Le informazioni relative all'istantanea vengono visualizzate nella pagina di provisioning del volume, incluso il nome, la dimensione, la data in cui è stata creata, il volume di origine e se si tratta di un'istantanea avviabile. Le informazioni sull'istantanea avviabile includono il sistema operativo e l'immagine. La codifica viene ereditata dall'istantanea e mostrata nella sezione di codifica.
- Fare clic su " Crea volume di archiviazione a blocchi ".
I profili di volume di prima e seconda generazione non sono intercambiabili. È possibile utilizzare un'istantanea di un volume di seconda generazione per creare un altro volume di seconda generazione, ma non è possibile passare il profilo
del volume a un profilo di volume di prima generazione. Allo stesso modo, è possibile usare un'istantanea di un volume di prima generazione per creare un altro volume di prima generazione con gli stessi dati, ma non è possibile passare il
nuovo volume al profilo sdp.
Quando si aggiorna la pagina dei volumi di Block Storage for VPC, il nuovo volume compare all'inizio dell'elenco dei volumi. Se il volume è stato creato correttamente, viene mostrato uno stato Available. Per volumi autonomi, la colonna Tipo
di allegato è vuota (-). Il menu Azioni alla fine di una riga della tabella fornisce un link per collegare un volume Block Storage for VPC a un'istanza.
Creazione di volumi Block Storage for VPC dalla CLI
Puoi creare i volumi Block Storage for VPC utilizzando la CLI (command-line interface).
Prima di iniziare
Prima di poter utilizzare la CLI, è necessario installare la CLI di “ IBM Cloud ” e il plug-in CLI per VPC. Per ulteriori informazioni, vedi i prerequisiti della CLI.
- Accedi al sito IBM Cloud.
Questo comando restituisce un URL e richiede un passcode. Vai a tale URL nel tuo browser e accedi. Se l'operazione ha esito positivo, ricevi un passcode monouso. Copia questo passcode e incollalo come risposta al prompt. Dopo una corretta autenticazione, ti viene richiesto di scegliere il tuo account. Se hai accesso a più account, seleziona quello con cui desideri effettuare l'accesso. Rispondi alle richieste rimanenti per completare l'accesso.ibmcloud login --sso -a cloud.ibm.com
Creazione di un volume Block Storage for VPC dalla CLI
Eseguire il seguente comando per creare un volume di tipo " Block Storage for VPC ". Fornisci un nome volume, un nome profilo e il nome della zona di disponibilità nella tua regione. Per ulteriori informazioni sui profili Block Storage for VPC, consulta Profili. Le opzioni aggiuntive vengono visualizzate tra parentesi.
I nomi di volume validi possono includere una combinazione di caratteri alfanumerici minuscoli (a-z, 0-9) e il trattino (-), fino a 63 caratteri. I nomi dei volumi devono iniziare con una lettera minuscola. I nomi dei volumi devono essere
univoci nell'intera infrastruttura VPC. Ad esempio, se crei due volumi con lo stesso nome nello stesso account e nella stessa regione, viene attivato un errore volume name duplicate.
ibmcloud is volume-create VOLUME_NAME PROFILE_NAME ZONE_NAME [--capacity CAPACITY] [--iops IOPS] [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME] [--tags TAG_NAME1,TAG_NAME2,...] [--json]
Vedi il seguente esempio.
ibmcloud is volume-create demovolume1 custom us-east-1 --capacity 500 --iops 3000 --tags env:test,env:prod
Creating volume demovolume1 in resource group Default under account Test Account as user test.user@ibm.com...
ID r014-e45f9c8c-4655-4a3e-9d90-70c2d64d1746
Name demovolume1
CRN crn:v1:bluemix:public:is:us-east-1:a/a1234567::volume:r014-e45f9c8c-4655-4a3e-9d90-70c2d64d1746
Status pending
Attachment state unattached
Capacity 500
IOPS 3000
Bandwidth(Mbps) 6291
Profile custom
Encryption key -
Encryption provider_managed
Resource group defaults
Created 2023-07-24T16:20:52+00:00
Zone us-east-1
Health State inapplicable
Volume Attachment Instance Reference -
Active false
Busy false
Tags env:test,env:prod
Storage Generation 1
La capacità, espressa in megabyte, può variare da 10 a 16.000 GB. Se non viene specificata, la capacità predefinita è 100 GB. I valori IOPS possono essere compresi tra 100 e 48.000 IOPS, a seconda del profilo e della dimensione volume. Se non viene specificato, per l'IOPS viene utilizzata per impostazione predefinita il profilo valido di configurazione per ogni volume. Per ulteriori informazioni, vedi la tabella di IOPS personalizzati.
Il nome volume può contenere un massimo di 63 caratteri alfanumerici minuscoli e includere il trattino (-) e deve iniziare con una lettera minuscola. I nomi dei volumi devono essere univoci nell'intera infrastruttura VPC.
Prendi nota dell'ID volume. È necessario specificare l'ID quando si associa un volume Block Storage for VPC a un'istanza di server virtuale, quando si visualizzano i dettagli di un volume Block Storage for VPC o quando si eliminano i volumi.
Lo stato di integrità del volume mostra inapplicable mentre lo stato del volume è pending. Una volta creato il volume, lo stato di integrità mostra OK, a meno che la creazione non abbia avuto esito negativo.
Per ulteriori informazioni, vedi Block Storage for VPC stati di integrità del volume.
Le tag utente vengono aggiunte per identificare la risorsa volume. Quando queste tag corrispondono alle tag in una politica di backup, viene eseguito il backup del volume in base alla pianificazione nel piano di backup. Per ulteriori informazioni, consultare Creazione di una politica di backup.
Per creare un volume autonomo, eseguire il comando ibmcloud is volume-create e specificare il profilo sdp, le dimensioni e le prestazioni richieste per il volume. L'esempio seguente crea un volume di dati nella regione
us-east con una capacità di 200 MB e 100 IOPS.
ibmcloud is volume-create defined-performance-vol sdp us-east-3 --capacity 200 --iops 3000 --bandwidth 2000
Creating volume defined-performance-vol under account Test Account as user test.user@ibm.com...
ID r014-9b41d061-d00c-4571-92c0-f592b91f5cd0
Name defined-performance-vol
CRN crn:v1:bluemix:public:is:us-east-3:a/a1234567::volume:r014-9b41d061-d00c-4571-92c0-f592b91f5cd0
Status pending
Attachment state unattached
Capacity 200
IOPS 3000
Bandwidth(Mbps) 2000
Profile sdp
Encryption key -
Encryption provider_managed
Resource group Default
Created 2025-03-25T09:59:26+05:30
Zone us-east-3
Health State inapplicable
Volume Attachment Instance Reference -
Active false
Adjustable IOPS true
Busy false
Tags -
Storage Generation 2
Creazione di un volume autonomo Block Storage for VPC con la crittografia gestita dal cliente dalla CLI
Per creare un volume di tipo " Block Storage " con crittografia gestita dal cliente tramite la CLI, utilizzare il comando ibmcloud is volume-create con l'opzione --encryption-key .
L'opzione " encryption_key " richiede un CRN valido per la chiave radice nel servizio di gestione delle chiavi.
ibmcloud is volume-create VOLUME_NAME PROFILE_NAME ZONE_NAME [--encryption-key ENCRYPTION_KEY] [--capacity CAPACITY] [--iops IOPS] [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME] [--output JSON]
Il seguente esempio mostra un volume con IOPS personalizzati e capacità creato con la crittografia gestita dal cliente.
ibmcloud is volume-create demo-cli-volume custom us-east-1 --capacity 300 --iops 1500 --encryption-key crn:v1:bluemix:public:kms:us-east:a/a1234567:3b05b403-8f51-4dac-9114-c777d0a760d4:key:7a8a2761-08e3-455f-a348-144ed604bba9
Creating volume demo-cli-volume under account Test Account as user test.user@ibm.com...
ID r014-3984600c-6f4d-4940-82de-519a867fa3c0
Name demo-cli-volume
CRN crn:v1:bluemix:public:is:us-east-1:a/a1234567::volume:r014-3984600c-6f4d-4940-82de-519a867fa3c0
Status pending
Attachment state unattached
Capacity 300
IOPS 1500
Bandwidth(Mbps) 3145
Profile custom
Encryption key crn:v1:bluemix:public:kms:us-east:a/a1234567:3b05b403-8f51-4dac-9114-c777d0a760d4:key:7a8a2761-08e3-455f-a348-144ed604bba9
Encryption user_managed
Resource group defaults
Created 2023-06-29T20:10:52+00:00
Zone us-east-1
Health State inapplicable
Volume Attachment Instance Reference -
Active false
Busy false
Tags -
Storage Generation 1
Creazione di un volume autonomo Block Storage for VPC da un'istantanea dalla CLI
Eseguite il comando 'ibmcloud is volume-create e specificate l'opzione '--snapshot con il nome, l'ID o il CRN della snapshot che state usando per creare il nuovo volume. Il volume è scollegato, come indicato dallo
stato di collegamento nella risposta.
Questo esempio crea il nuovo volume da un'istantanea specificata per nome.
ibmcloud is volume-create volume-4 general-purpose us-south-1 --snapshot r006-4602b3de-3885-4b49-8d46-65aacb72a1d6
Creating volume volume-4 under account Test Account as user test.user@ibm.com...
ID r014-dee9736d-08ee-4992-ba8d-3b64a4f0baac
Name volume-4
CRN crn:v1:bluemix:public:is:us-east-1:a/a1234567::volume:r014-dee9736d-08ee-4992-ba8d-3b64a4f0baac
Status pending
Attachment state unattached
Capacity 100
IOPS 3000
Bandwidth(Mbps) 393
Profile general-purpose
Encryption key -
Encryption provider_managed
Resource group defaults
Created 2023-06-29T16:14:59+00:00
Zone us-east-1
Health State inapplicable
Volume Attachment Instance Reference -
Active false
Busy false
Tags -
Storage Generation 1
Per ulteriori informazioni, vedi ibmcloud is volume - create nel riferimento della CLI.
I profili di volume di prima e seconda generazione non sono intercambiabili. È possibile utilizzare un'istantanea di un volume di seconda generazione per creare un altro volume di seconda generazione, ma non è possibile passare il profilo
del volume a un profilo di volume di prima generazione. Allo stesso modo, è possibile usare un'istantanea di un volume di prima generazione per creare un altro volume di prima generazione con gli stessi dati, ma non è possibile passare il
nuovo volume al profilo sdp.
Creazione di un volume di dati come collegamento a un'istanza del server virtuale esistente
Puoi utilizzare il comando instance-volume-attachment-add per creare un volume e collegarlo a un'istanza. Il seguente esempio crea un volume con il profilo custom, 100 GB di capacità e 100 IOPS.
ibmcloud is instance-volume-attachment-add acd-vol-attach1 my-instance-1 --profile custom --new-volume-name acd-vol-2 --iops 100 --capacity 100
Creating volume attachment acd-vol-attach1 for instance my-instance-1 under account Test Account as user test.user@ibm.com...
ID 730f-5f63eb4d-2683-4dd6-a20a-5ab06b4061c6
Name acd-vol-attach1
Volume -
Status attaching
Bandwidth(Mbps) 14
Type data
Device -
Auto delete false
Created 2023-05-05T07:42:33+05:30
Per ulteriori informazioni, vedi ibmcloud is instance - volume - attachment - add nel riferimento della CLI.
Creazione di un'istanza con i volumi sdp dalla CLI
Per creare un'istanza di server virtuale, eseguire il comando ibmcloud is instance-create e specificare i dettagli dell'istanza e i dettagli dei volumi che si desidera collegare. L'esempio seguente crea un'istanza di server virtuale
con un volume di avvio sdp e allega anche un volume di dati sdp.
ibmcloud is instance-create my-defined-performance-instance test-vpc us-east-3 bx2-2x8 csi-subnet-cidr-3b6k-storage-v5lvug8w-380sal --boot-volume '{"name": "boot-vol-attachment-name-instance-1", "volume": {"name": "boot-vol-name-1", "profile": {"name": "sdp"},"user_tags": ["env:test4", "env:dev4"]}}' --volume-attach '[{"volume": {"capacity": 1000,"iops": 32000,"bandwidth": 3000,"name": "my-data-volume-1","profile": {"name": "sdp"}}}]' --image r006-5f183c60-78a0-4d6e-9be5-84335939255a
Creating instance my-defined-performance instance under account Test Account as user test.user@ibm.com...
ID 730f_59883a41-c943-423c-a6ab-e2b066f2f314
Name my-defined-performance-instance
CRN crn:v1:bluemix:public:is:us-east-3:a/a1234567::instance:730f_59883a41-c943-423c-a6ab-e2b066f2f314
Status pending
Availability policy on host failure restart
Startable true
Profile bx2-2x8
Architecture amd64
vCPU Manufacturer intel
vCPUs 2
Memory(GiB) 8
Bandwidth(Mbps) 4000
Volume bandwidth(Mbps) 1000
Network bandwidth(Mbps) 3000
Lifecycle Reasons Code Message
- -
Lifecycle State pending
Metadata service Enabled Protocol Response hop limit
false http 1
Image ID Name
r006-5f183c60-78a0-4d6e-9be5-84335939255a embolism-lapped-overjoyed-bagel-elated
VPC ID Name
r006-be9d04ab-d10c-4be7-9de6-95cd2208d1de test-vpc-do-not-delete-default
Zone us-east-3
Resource group ID Name
85cbbee12af748eabb6513cf311d4e2d Default
Created 2024-09-24T02:01:10+05:30
Boot volume ID Name Attachment ID Attachment name
- - 730f-e4d7ce78-011e-4dd1-8752-3ceb12bce79f boot-vol-attachment-name-instance-1
Data volumes ID Name Attachment ID Attachment name
- - 730f-78f2db0a-57df-4b5f-9f1e-f800e91e89af upscale-embargo-oops-overeager
Per ulteriori informazioni, vedere ibmcloud is instance-create nel riferimento alla CLI.
Creazione di un'istanza e aggiunta di tag utente ai volumi dalla CLI
Puoi specificare le tag utente per i volumi di avvio e di dati quando crei un'istanza del server virtuale. Eseguire il comando instance-create e specificare le tag utente nell'opzione user_tags. È anche possibile
modificare le tag successivamente o aggiungere ulteriori tag al volume specificato. Per ulteriori informazioni, vedi la Guida di riferimento alla CLI VPC.
Nel comando di esempio,
- Il volume di avvio è definito dall'opzione
--boot-volumeche specifica le tag utenteenv:test4eenv:dev4. - Il collegamento del volume di dati è definito dall'opzione
--volume-attache specifica le stesse tag utente.
Puoi visualizzare le tag utente quando guardi i dettagli del volume di dati o di avvio dopo che l'istanza è stata creata.
ibmcloud is instance-create my-vsi-4 my-vpc-2 us-south-1 bx2-2x8 cli-subnet-1 --image ibm-centos-7-9-minimal-amd64-6 --keys my-keys4 --boot-volume '{"name": "boot-vol-4", "volume": {"name": "my-boot-vol-4", "profile": {"name": "general-purpose"},"user_tags": ["env:test4", "env:dev4"]}}' --volume-attach '[{"name": "my-vol-att1", "volume": {"name":"my-vol-4", "profile": {"name": "general-purpose"}, "capacity": 10,"user_tags": ["env:test4", "env:dev4"]}}]'
Creating instance my-vsi-4 under account vpcdemo1 as user myuser@mycompany.com...
ID efd06503-f514-4ea2-ba6c-2b9c715e6269
Name my-vsi-4
CRN crn:v1:bluemix:public:is:us-south-1:a/a1234567::instance:efd06503-f514-4ea2-ba6c-2b9c715e6269
Status pending
Availability policy on host failure restart
Startable true
Profile bx2-2x8
Architecture amd64
vCPUs 2
Memory(GiB) 8
Bandwidth(Mbps) 4000
Volume bandwidth(Mbps) 1000
Network bandwidth(Mbps) 3000
Metadata service Enabled
false
Image ID Name
r006-c5471ef3-15f5-4468-964b-f9b4d3ca8120 ibm-centos-7-9-minimal-amd64-6
VPC ID Name
r006-dd1c6831-cc4d-4c40-aab2-6b0c17f41424 my-vpc-2
Zone us-south-1
Resource group ID Name
bdd96715c2a44f2bb60df4ff14a543f5 Default
Created 2022-08-09T09:25:06+05:30
Boot volume ID Name Attachment ID Attachment name
- - r006-1bcf5342-c12f-4908-ad0f-99218cd603b9 boot-vol-4
Data volumes ID Name Attachment ID Attachment name
- - r006-c034f0f9-2269-44e4-a76a-4f4ad8c47b65 my-vol-att1
Creazione di un template istanza e aggiunta di tag utente ai volumi dalla CLI
Puoi specificare le tag utente per i volumi di avvio e di dati quando crei un'istanza. Eseguire il comando instance-template-create e specificare le tag utente nel parametro user_tags.
Nel seguente esempio, il comando aggiunge due tag utente al template dell'istanza che devono essere applicati ai volumi.
ibmcloud is instance-template-create my-tpl-1 my-vpc-2 us-south-1 bx2-2x8 cli-subnet-1 --image ibm-centos-7-9-minimal-amd64-6 --keys my-keys4 --boot-volume '{"name": "boot-vol-1", "volume": {"name": "my-boot-vol-1", "profile": {"name": "general-purpose"},"user_tags": ["env:test1", "env:dev1"]}}' --volume-attach '[{"name": "my-vol-att", "volume": {"name":"my-vol-1", "profile": {"name": "general-purpose"}, "capacity": 10,"user_tags": ["env:test1", "env:dev1"] }}]'
Creating instance template my-tpl-1 under account vpcdemo as user myuser@mycompany.com...
ID 38ef87e9-3a4d-4d72-8450-86c16b76ae0d
Name my-tpl-1
CRN crn:v1:bluemix:public:is:us-south-1:a/a1234567::instance-template:38ef87e9-3a4d-4d72-8450-86c16b76ae0d
Resource group Default
Image c5471ef3-15f5-4468-964b-f9b4d3ca8120
VPC dd1c6831-cc4d-4c40-aab2-6b0c17f41424
Zone us-south-1
Profile bx2-2x8
Metadata service Enabled
false
Keys Key IDs
e7d18039-0e0e-4207-8598-de7cca949030
Boot volume Name Capacity Profile IOPS Attachment name Auto delete Tags
my-boot-vol-1 100 general-purpose 0 boot-vol-1 true env:test1,env:dev1
Data volumes ID Name Capacity Profile IOPS Attachment name Auto delete Tags
- my-vol-1 10 general-purpose 0 my-vol-att false env:test1,env:dev1
Primary Network Interface Name Subnet ID Security Groups Allow source IP spoofing Reserved IP Address Reserved IP ID Reserved IP Name Reserved IP Auto Delete
primary 0617-c1f1e468-3283-4f44-9d08-3d57b77817f1 7c2db5ac-19e0-4d83-8226-e6178fedfe56 false - - - -
Created 2022-08-22T09:10:34+05:30
È possibile utilizzare il modello di istanza per creare un'istanza e volumi con tag utente. Vedi il seguente esempio.
ibmcloud is instance-template-create --template my-tpl-1 --name my-vsi-3 --boot-volume '{"name": "boot-vol-3", "volume": {"name": "my-boot-vol-3", "profile": {"name": "general-purpose"},"user_tags": ["env:test3", "env:dev3"]}}' --volume-attach '[{"name": "my-vol-att1", "volume": {"name":"my-vol-3", "profile": {"name": "general-purpose"}, "capacity": 10,"user_tags": ["env:test3", "env:dev3"] }}]'
Creazione di volumi Block Storage for VPC con l'API
Puoi creare volumi Block Storage for VPC richiamando direttamente le API REST VPC. Per ulteriori informazioni sull'API VPC delle condivisioni file, vedi la Guida di riferimento API VPC.
Prima di iniziare
Definisci le variabili per il token IAM, l'endpoint API e la versione API. Per le istruzioni, vedi Configurazione del tuo ambiente API e CLI.
Creazione di un volume di dati come parte del provisioning dell'istanza con l'API
Fai una richiesta POST /instances per creare un'istanza e definisci il volume utilizzando il parametro volume_attachments. Specificare un nome volume, una capacità e un profilo.
I nomi di volume validi possono includere una combinazione di caratteri alfanumerici minuscoli (a-z, 0-9) e il trattino (-), fino a 63 caratteri. I nomi dei volumi devono iniziare con una lettera minuscola. I nomi dei volumi devono essere
univoci nell'intera infrastruttura VPC. Ad esempio, se crei due volumi con lo stesso nome nello stesso account e nella stessa regione, viene attivato un errore volume name duplicate.
Questo esempio specifica la crittografia gestita dal cliente e le tag utente per i volumi di avvio e di dati.
curl -X POST "$vpc_api_endpoint/v1/instances?version=2022-06-14&generation=2" -H "Authorization: Bearer $iam_token" -d '{
"boot_volume_attachment": {
"volume": {
"encryption_key": {"crn": "crn:[...]"},
"name": "my-boot-volume",
"profile": {"name": "general-purpose"},
"storage_generation": 1,
"user_tags": {"env:test","env:prod"}}},
"image": {"id": "9aaf3bcb-dcd7-4de7-bb60-24e39ff9d366"},
"keys": [{"id": "363f6d70-0000-0001-0000-00000013b96c"}],
"name": "my-instance",
"placement_target": {"id": "0787-8c2a09be-ee18-4af2-8ef4-6a6060732221"},
"primary_network_interface": {
"name": "my-network-interface",
"subnet": {"id": "bea6a632-5e13-42a4-b4b8-31dc877abfe4"}},
"profile": {"name": "bx2-2x8"},
"volume_attachments": [
{"volume": {
"capacity": 1000,
"encryption_key": {"crn": "crn:[...]"},
"name": "my-data-volume",
"profile": {"name": "5iops-tier"},
"storage_generation": 1,
"user_tags": {"env:test","env:prod"}}
}],
"vpc": {"id": "f0aae929-7047-46d1-92e1-9102b07a7f6f"},
"zone": {"name": "us-south-1"}
}'
Una risposta corretta è simile alla seguente:
{
"bandwidth": 4000,
"boot_volume_attachment": {
"device": {
"id": "a8a15363-a6f7-4f01-af60-715e85b28141"
},
"href": "https://us-south.iaas.cloud.ibm.com/v1/instances/eb1b7391-2ca2-4ab5-84a8-b92157a633b0/volume_attachments/7389-a8a15363-a6f7-4f01-af60-715e85b28141",
"id": "a8a15363-a6f7-4f01-af60-715e85b28141",
"name": "my-boot-volume-attachment",
"volume": {
"crn": "crn:[...]",
"href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/49c5d61b-41e7-4c01-9b7a-1a97366c6916",
"id": "49c5d61b-41e7-4c01-9b7a-1a97366c6916",
"name": "my-boot-volume"
}
},
"created_at": "2022-06-15T16:11:57Z",
"crn": "crn:[...]",
"dedicated_host": {
"crn": "crn:[...]",
"href": "https://us-south.iaas.cloud.ibm.com/v1/dedicated_hosts/0787-8c2a09be-ee18-4af2-8ef4-6a6060732221",
"id": "0787-8c2a09be-ee18-4af2-8ef4-6a6060732221",
"name": "test-new",
"resource_type": "dedicated_host"
},
"disks": [],
"href": "https://us-south.iaas.cloud.ibm.com/v1/instances/eb1b7391-2ca2-4ab5-84a8-b92157a633b0",
"id": "eb1b7391-2ca2-4ab5-84a8-b92157a633b0",
"image": {
"crn": "crn:[...]",
"href": "https://us-south.iaas.cloud.ibm.com/v1/images/9aaf3bcb-dcd7-4de7-bb60-24e39ff9d366",
"id": "9aaf3bcb-dcd7-4de7-bb60-24e39ff9d366",
"name": "my-image"
},
"memory": 8,
"name": "my-instance",
"network_interfaces": [
{
"href": "https://us-south.iaas.cloud.ibm.com/v1/instances/e402fa1b-96f6-4aa2-a8d7-703aac843651/network_interfaces/7ca88dfb-8962-469d-b1de-1dd56f4c3275",
"id": "7ca88dfb-8962-469d-b1de-1dd56f4c3275",
"name": "my-network-interface",
"primary_ipv4_address": "10.0.0.32",
"resource_type": "network_interface",
"subnet": {
"crn": "crn:[...]",
"href": "https://us-south.iaas.cloud.ibm.com/v1/subnets/7389-bea6a632-5e13-42a4-b4b8-31dc877abfe4",
"id": "bea6a632-5e13-42a4-b4b8-31dc877abfe4",
"name": "my-subnet"
}
}
],
"placement_target": {
"crn": "crn:[...]",
"href": "https://us-south.iaas.cloud.ibm.com/v1/dedicated_hosts/0787-8c2a09be-ee18-4af2-8ef4-6a6060732221",
"id": "0787-8c2a09be-ee18-4af2-8ef4-6a6060732221",
"name": "test-new",
"resource_type": "dedicated_host"
},
"primary_network_interface": {
"href": "https://us-south.iaas.cloud.ibm.com/v1/instances/e402fa1b-96f6-4aa2-a8d7-703aac843651/network_interfaces/7ca88dfb-8962-469d-b1de-1dd56f4c3275",
"id": "7ca88dfb-8962-469d-b1de-1dd56f4c3275",
"name": "my-network-interface",
"primary_ipv4_address": "10.0.0.32",
"resource_type": "network_interface",
"subnet": {
"crn": "crn:[...]",
"href": "https://us-south.iaas.cloud.ibm.com/v1/subnets/bea6a632-5e13-42a4-b4b8-31dc877abfe4",
"id": "bea6a632-5e13-42a4-b4b8-31dc877abfe4",
"name": "my-subnet"
}
},
"profile": {
"href": "https://us-south.iaas.cloud.ibm.com/v1/instance/profiles/bx2-2x8",
"name": "bx2-2x8"
},
"resource_group": {
"href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/4bbce614c13444cd8fc5e7e878ef8e21",
"id": "4bbce614c13444cd8fc5e7e878ef8e21",
"name": "Default"
},
"status": "running",
"status_reasons": [],
"vcpu": {
"architecture": "amd64",
"count": 2
},
"volume_attachments": [
{
"device": {
"id": "a8a15363-a6f7-4f01-af60-715e85b28141"
},
"href": "https://us-south.iaas.cloud.ibm.com/v1/instances/e402fa1b-96f6-4aa2-a8d7-703aac843651/volume_attachments/7389-a8a15363-a6f7-4f01-af60-715e85b28141",
"id": "a8a15363-a6f7-4f01-af60-715e85b28141",
"name": "my-boot-volume-attachment",
"volume": {
"crn": "crn:[...]",
"href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/49c5d61b-41e7-4c01-9b7a-1a97366c6916",
"id": "49c5d61b-41e7-4c01-9b7a-1a97366c6916",
"name": "my-boot-volume"
}
},
{
"device": {
"id": "e77125cb-4df0-4988-a878-531ae0ae0b70"
},
"href": "https://us-south.iaas.cloud.ibm.com/v1/instances/e402fa1b-96f6-4aa2-a8d7-703aac843651/volume_attachments/7389-e77125cb-4df0-4988-a878-531ae0ae0b70",
"id": "e77125cb-4df0-4988-a878-531ae0ae0b70",
"name": "my-volume-attachment-1",
"volume": {
"crn": "crn:[...]",
"href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/2cc091f5-4d46-48f3-99b7-3527ae3f4392",
"id": "2cc091f5-4d46-48f3-99b7-3527ae3f4392",
"name": "my-data-volume"
}
}
],
"vpc": {
"crn": "crn:[...]",
"href": "https://us-south.iaas.cloud.ibm.com/v1/vpcs/f0aae929-7047-46d1-92e1-9102b07a7f6f",
"id": "f0aae929-7047-46d1-92e1-9102b07a7f6f",
"name": "my-vpc"
},
"zone": {
"href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-1",
"name": "us-south-1"
}
}
Creazione di un volume di avvio sdp come parte del provisioning dell'istanza con l'API
Oltre alla capacità e agli IOPS, è possibile specificare un limite di throughput personalizzato con la proprietà bandwidth. Vedi il seguente esempio.
curl -X POST "$vpc_api_endpoint/v1/instances?version=2024-09-24&generation=2"\
-H "Authorization: Bearer $iam_token" \
-d '{
"boot_volume_attachment": {
"volume": {
"encryption_key": {"crn": "crn:[...]"},
"name": "my-defined-performance-boot-volume",
"profile": {"name": "sdp"},
"boot_capacity": 250,
"iops": 3000,
"bandwidth": 1000
"storage_generation": 2,
"user_tags": {"env:test","env:prod"}},
"image": {"id": "9aaf3bcb-dcd7-4de7-bb60-24e39ff9d366"},
"keys": [{"id": "363f6d70-0000-0001-0000-00000013b96c"}],
"name": "my-instance",
"placement_target": {"id": "0787-8c2a09be-ee18-4af2-8ef4-6a6060732221"},
"primary_network_interface": {
"name": "my-network-interface",
"subnet": {"id": "bea6a632-5e13-42a4-b4b8-31dc877abfe4"}},
"profile": {"name": "bx3dc-2x10"},
"vpc": {"id": "f0aae929-7047-46d1-92e1-9102b07a7f6f"},
"zone": {"name": "us-east-1"}
}
}
Per ulteriori informazioni sulla creazione di volumi con l'API, vedere Creazione di volumi Block Storage e il riferimento all'API per la creazione di un'istanza
Creazione di un volume autonomo Block Storage for VPC con l'API
Effettuare una richiesta POST /volumes per creare un volume. Specifica un nome, IOPS, capacità, profilo e zona.
Il seguente esempio ha creato un volume custom con capacità di 50 MB e 100 IOPS nella regione us-south. La richiesta specifica anche una chiave root cliente per la crittografia gestita dal cliente e un gruppo di risorse.
curl -X POST "$vpc_api_endpoint/v1/volumes?version=2022-06-14&generation=2" \
-H "Authorization: Bearer $iam_token" \
-d '{
"name": "my-volume-4",
"iops": 100,
"capacity": 50,
"zone": {"name": "us-south-2"},
"profile": {"name": "custom"},
"encryption_key":{"crn":"crn:[...]"},
"resource_group": {"id": "2d1bb5a8-40a8-447a-acf7-0eadc8aeb054"}
}'
Una risposta corretta è simile all'esempio riportato di seguito.
{
"capacity": 50,
"created_at": "2022-06-14T23:16:53.000Z",
"crn": "crn:[...]",
"encryption": "user_managed",
"encryption_key": {
"crn": "crn:[...]"
},
"health_reasons": [],
"health_state": "ok",
"href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/2d1bb5a8-40a8-447a-acf7-0eadc8aeb054",
"id": "2d1bb5a8-40a8-447a-acf7-0eadc8aeb054",
"iops": 100,
"name": "my-volume-4",
"profile": {
"href": "https://us-south.iaas.cloud.ibm.com/v1/volume/profiles/custom",
"name": "custom"
},
"resource_group": {
"href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/4bbce614c13444cd8fc5e7e878ef8e21",
"id": "4bbce614c13444cd8fc5e7e878ef8e21",
"name": "Default"
},
"status": "available",
"status_reasons": [],
"volume_attachments": [],
"zone": {
"href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-2",
"name": "us-south-2"
}
}
Quando si utilizza il profilo sdp, è possibile creare un volume di dati con capacità e IOPS personalizzati, e si può anche specificare un limite di throughput personalizzato con la proprietà bandwidth. L'esempio seguente
crea un volume di dati autonomo nella regione us-east.
curl -X POST "$vpc_api_endpoint/v2/volumes?version=2024-09-27&generation=2" \
-H "Authorization: Bearer $iam_token" \
-d '{
"name": "my-special-volume-1",
"iops": 3000,
"capacity": 250,
"bandwidth": 5000,
"zone": {"name": "us-east-2"},
"profile": {"name": "sdp"},
"encryption_key":{"crn":"crn:[...]"},
"resource_group": {"id": "2d1bb5a8-40a8-447a-acf7-0eadc8aeb054"}
}'
Una risposta corretta è simile all'esempio riportato di seguito.
{
"adjustable_capacity_states:": "attached, unattached",
"adjustable_iops_states": "attached, unattached",
"bandwidth": 5000,
"capacity": 250,
"created_at": "2024-09-27T23:16:53.000Z",
"crn": "crn:[...]",
"encryption": "user_managed",
"encryption_key": {
"crn": "crn:[...]"
},
"health_reasons": [],
"health_state": "ok",
"href": "https://us-east.iaas.cloud.ibm.com/v2/volumes/2d1bb5a8-40a8-447a-acf7-0eadc8aeb054",
"id": "2d1bb5a8-40a8-447a-acf7-0eadc8aeb054",
"iops": 3000,
"name": "my-special-volume-1",
"profile": {
"href": "https://us-east.iaas.cloud.ibm.com/v2/volume/profiles/sdp",
"name": "sdp"
},
"resource_group": {
"href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/4bbce614c13444cd8fc5e7e878ef8e21",
"id": "2d1bb5a8-40a8-447a-acf7-0eadc8aeb054",
"name": "Default"
},
"status": "available",
"status_reasons": [],
"volume_attachments": [],
"zone": {
"href": "https://us-east.iaas.cloud.ibm.com/v1/regions/us-east/zones/us-east-2",
"name": "us-east-2"
}
}
Per ulteriori informazioni sulla creazione del volume con l'API, vedi Creazione di volumi Block Storage e la guida di riferimento API per la creazione di un volume.
Creazione di un volume di dati da un'istantanea con l'API
È possibile specificare un ID snapshot, un nome o un CRN in una chiamata POST /volumes per creare un volume di dati indipendente. Quando si specifica un'istantanea il cui valore della proprietà " storage_generation " è 1, il nuovo volume di archiviazione a blocchi viene creato con lo stesso valore " storage_generation " e ad esso possono essere applicati solo profili di volume della stessa generazione.
I dati vengono completamente ripristinati quando colleghi il volume di dati a un'istanza del server virtuale. Per ulteriori informazioni, vedere Informazioni sul ripristino di un volume da uno snapshot. Per un esempio di chiamata API, vedere Ripristino di un volume di dati da uno snapshot di un volume non collegato.
Creazione di volumi Block Storage for VPC con Terraform
Per utilizzare Terraform, scaricare la CLI di Terraform e configurare il plug-in IBM Cloud® Provider. Per ulteriori informazioni, vedi Introduzione a Terraform.
I servizi dell'infrastruttura VPC utilizzano uno specifico endpoint regionale, che per impostazione predefinita punta a us-south. Se il tuo VPC viene creato in un'altra regione, assicurati di specificare la regione appropriata nel
blocco del provider nel file provider.tf.
Vedi il seguente esempio di destinazione di una regione diversa da quella predefinita us-south.
provider "ibm" {
region = "eu-de"
}
I nomi di volume validi possono includere una combinazione di caratteri alfanumerici minuscoli (a-z, 0-9) e il trattino (-), fino a 63 caratteri. I nomi dei volumi devono iniziare con una lettera minuscola. I nomi dei volumi devono essere univoci
nell'intera infrastruttura VPC. Ad esempio, se crei due volumi con lo stesso nome nello stesso account e nella stessa regione, viene attivato un errore volume name duplicate.
Creazione di volumi autonomi Block Storage for VPC con Terraform
Per creare un volume Block Storage for VPC, utilizzare la risorsa ibm_is_volume. L'esempio seguente crea un volume di prima generazione con una capacità di 4 TB e il profilo di prestazioni 10iops-tier.
resource "ibm_is_volume" "10iops_volume_example" {
name = "example-volume-10iops"
profile = "10iops-tier"
zone = "us-south-1"
capacity = 4000
}
L'esempio seguente crea un volume di prima generazione con un profilo custom. Il volume creato ha una capacità di 200 MB e può eseguire 1000 IOPS.
resource "ibm_is_volume" "custom_volume_example" {
name = "example-volume-custom"
profile = "custom"
zone = "us-south-1"
iops = 1000
capacity = 200
encryption_key = "crn:v1:bluemix:public:kms:us-south:a/a1234567:e4a29d1a-2ef0-42a6-8fd2-350deb1c647e:key:5437653b-c4b1-447f-9646-b2a2a4cd6179"
}
L'esempio seguente crea un volume di seconda generazione con il profilo sdp. Il volume creato ha una capacità di 250 MB, può eseguire 3000 IOPS con un limite massimo di larghezza di banda di 1000 Mbps.
resource "ibm_is_volume" "sdp_volume_example" {
name = "example-volume-sdp"
profile = "sdp"
zone = "us-south-1"
iops = 3000
capacity = 250
bandwidth = 1000
encryption_key = "crn:v1:bluemix:public:kms:us-south:a/a1234567:e4a29d1a-2ef0-42a6-8fd2-350deb1c647e:key:5437653b-c4b1-447f-9646-b2a2a4cd6179"
}
Per ulteriori informazioni sugli argomenti e gli attributi, vedi ibm_is_volume.
Creazione di un volume autonomo Block Storage for VPC da un'istantanea con Terraform
Per creare un volume Block Storage for VPC da un'istantanea, utilizza la risorsa ibm_is_volume. Il seguente esempio crea un volume in base a un'istantanea identificata dal suo ID. È possibile utilizzare anche il nome o il CRN
per identificare lo snapshot.
resource "ibm_is_volume" "example-volume-from-snapshot" {
name = "example-volume"
profile = "general-purpose"
zone = "us-south-1"
source_snapshot = ibm_is_snapshot.example.id
}
Per ulteriori informazioni sugli argomenti e gli attributi, vedi ibm_is_volume.
I profili di volume di prima e seconda generazione non sono intercambiabili. È possibile utilizzare un'istantanea di un volume di seconda generazione per creare un altro volume di seconda generazione, ma non è possibile passare il profilo
del volume a un profilo di volume di prima generazione. Allo stesso modo, è possibile usare un'istantanea di un volume di prima generazione per creare un altro volume di prima generazione con gli stessi dati, ma non è possibile passare il
nuovo volume al profilo sdp.
Creare un volume di avvio come parte del provisioning dell'istanza con Terraform
Per creare un volume di dati da un'istantanea quando crei un'istanza del server virtuale, utilizza la risorsa ibm_is_instance. L'esempio seguente crea un'istanza di server virtuale con un volume di avvio che utilizza il profilo
di volume sdp ed è protetto da una chiave di crittografia gestita dal cliente. Quando si specifica il profilo sdp per il volume di avvio, è possibile specificare limiti personalizzati di capacità, IOPS e larghezza
di banda.
resource "ibm_is_instance" "example_instance" {
name = "example-instance-reserved-ip"
image = data.ibm_is_image.example_image.id
profile = data.ibm_is_instance_profile.example_profile.name
primary_network_interface {
name = "eth0"
subnet = ibm_is_subnet.example_subnet.id
primary_ip {
reserved_ip = ibm_is_subnet_reserved_ip.example_reserved_ip.reserved_ip
}
}
network_interfaces {
name = "eth1"
subnet = ibm_is_subnet.example_subnet.id
primary_ip {
name = "example-reserved-ip1"
auto_delete = true
address = "${replace(ibm_is_subnet.example_subnet.ipv4_cidr_block, "0/24", "14")}"
}
}
vpc = ibm_is_vpc.example_vpc.id
zone = "us-south-1"
keys = [ibm_is_ssh_key.example_sshkey.id]
boot_volume {
name = "example-boot-volume"
profile = "sdp"
size = 250
iops = 3000
bandwidth = 1000
encryption_key = "crn:v1:bluemix:public:kms:us-south:a/a1234567:e4a29d1a-2ef0-42a6-8fd2-350deb1c647e:key:5437653b-c4b1-447f-9646-b2a2a4cd6179"
}
}
Per ulteriori informazioni sugli argomenti e gli attributi, vedi ibm_is_instance.
Creazione di un volume di avvio da un'istantanea come parte del provisioning dell'istanza con Terraform
Per creare un volume di dati da un'istantanea quando crei un'istanza del server virtuale, utilizza la risorsa ibm_is_instance. Il seguente esempio crea un'istanza del server virtuale con nome "example - vsi - restore".
Il volume di avvio è definito nell'argomento boot_volume con il nome, l'istantanea di origine e le tag utente.
resource "ibm_is_snapshot" "example" {
name = "example-snapshot"
source_volume = ibm_is_instance.example.volume_attachments[0].volume_id
}
resource "ibm_is_instance" "example" {
name = "example-vsi-restore"
profile = "cx2-2x4"
boot_volume {
name = "boot-restore"
snapshot = ibm_is_snapshot.example.id
tags = ["tags-0"]
}
primary_network_interface {
subnet = ibm_is_subnet.example.id
}
vpc = ibm_is_vpc.example.id
zone = "us-south-1"
keys = [ibm_is_ssh_key.example.id]
network_interfaces {
subnet = ibm_is_subnet.example.id
name = "eth1"
}
}
Se si desidera ripristinare un volume da una snapshot di un altro account, è possibile utilizzare l'argomento 'source_snapshot_crn per identificare la snapshot con il suo CRN, invece che con il suo ID.
Per ulteriori informazioni sugli argomenti e gli attributi, vedi ibm_is_instance.
Creazione di un volume di dati da aggiungere a un'istanza esistente con Terraform
Per creare un volume di dati e collegarlo a un'istanza del server virtuale, utilizza la risorsa ibm_is_instance_volume_attachment. L'esempio seguente crea un volume di dati da 20 MB con un profilo di volume general-purpose e lo collega all'istanza ibm_is_instance.example.id.
rresource "ibm_is_instance_volume_attachment" "example" {
instance = ibm_is_instance.example.id
name = "example-vol-att-1"
profile = "general-purpose"
capacity = "20"
delete_volume_on_attachment_delete = true
delete_volume_on_instance_delete = true
volume_name = "example-vol-1"
}
Per ulteriori informazioni sugli argomenti e gli attributi, vedi ibm_is_instance_volume_attachment.
Passi successivi
È possibile continuare a creare altri volumi Block Storage for VPC oppure gestire quelli esistenti.