Visualizzazione delle informazioni su tutti i volumi Block Storage for VPC nella console

Vai all'elenco di volumi Block Storage for VPC. Nella console IBM Cloud console, fare clic sull'icona Menu di navigazione > Infrastruttura > Storage > Block Storage volumi.

Per impostazione predefinita, i volumi di Block Storage for VPC sono visualizzati in set di 10 per tutti i gruppi di risorse della regione. Per modificare questa impostazione predefinita, fare clic sulla freccia verso il basso del controllo "Pagina" e aumentare il numero di volumi nell'elenco a 20 o 50. Utilizzare le frecce di controllo pagina per passare alla pagina successiva o per tornare indietro. Nell'elenco di tutti i volumi di " Block Storage for VPC " sono riportate le seguenti informazioni.

Dettagli su tutti i volumi

Campo	Descrizione
Regione	La regione in cui si trovano questi volumi, ad esempio, Stati Uniti Sud. Fare clic sulla freccia verso il basso per visualizzare i volumi in una regione differente in cui si dispone di un account.
Nome	Fai clic sul nome del volume per visualizzare i dettagli di quel singolo volume.
Condizione	Lo stato del volume, con funzioni come il filtro predefinito per tutte le righe.
Posizione	La zona di disponibilità nella tua regione, ereditata dal VPC (ad esempio, US South 1).
Dimensione	La dimensione del volume che hai specificato, in GB.
Tipo di collegamento	Dati, per un volume secondario collegato a un'istanza, avvio quando collegato come un volume di avvio o vuoto per un volume non collegato.
Integrità	La sezione "Salute" monitora lo stato generale del volume, ad esempio le prestazioni di I/O e la coerenza dei dati. Gli stati di integrità del volume sono OK o degraded. I volumi in uno stato danneggiato hanno prestazioni, capacità o problemi di connessione degradati. I volumi ripristinati da un'istantanea mostrano anche uno stato danneggiato. Il servizio visualizza un motivo possibile per lo stato danneggiato in modo da poter risolvere eventuali problemi. Per ulteriori informazioni, vedi Block Storage for VPC stati di integrità del volume.
Crittografia	La crittografia con le chiavi gestite da IBM è abilitata per impostazione predefinita su tutti i volumi. È inoltre possibile utilizzare le proprie chiavi root in un'istanza di Key Protect per proteggere i propri dati. Per ulteriori informazioni, consultare la sezione " Creazione di volumi " Block Storage for VPC " con crittografia gestita dal cliente ".
Tag	Numero di tag utente applicate al volume. Fare clic sul numero in questa colonna per visualizzare o modificare i tag nella nuova finestra. Se al volume non è stata applicata alcuna tag, fare clic su Aggiungi tag e aggiungerle nella nuova finestra. Le tag utente possono associare il volume a una politica di backup per la creazione di backup del volume. Per ulteriori informazioni, vedere Aggiunta di tag utente associati a un criterio di backup a un volume nella console.
Azioni	Fare clic su Azioni per visualizzare un menu di azioni specifiche per il contesto.

Dal menu Azioni, nella pagina dell'elenco dei volumi, sono disponibili le seguenti azioni. Alcune azioni sono disponibili solo quando il volume soddisfa determinate condizioni, ad esempio se è collegato o scollegato.

• Rinomina- rinomina questo volume.
• Collega al server: collega un volume non collegato a un'istanza di server virtuale. Questa operazione è disponibile solo quando il volume non è collegato. Per ulteriori informazioni, vedi Collegamento di un volume a un'istanza.
• Scollegare dall'istanza: scollega un volume collegato dalla relativa istanza di server virtuale. Questa operazione è disponibile solo quando il volume è collegato. Per ulteriori informazioni, consultare la sezione " Come scollegare un volume da un'istanza di server virtuale ".
• Crea snapshot: crea uno snapshot di questo volume. Questa azione potrebbe apparire disattivata (in grigio) se non è disponibile. Per ulteriori informazioni, consultare la sezione " Creazione di uno snapshot nella console ".
• Crea immagine: crea un'immagine personalizzata da un volume di avvio. Questa azione potrebbe apparire disattivata (in grigio) se non è disponibile. Per ulteriori informazioni, vedere Creazione di un'immagine da un volume nella console.
• Aggiungi tag o Modifica tag: aggiungi o modifica i tag utente e accedi ai tag di gestione su questo volume. Per ulteriori informazioni, vedi Gestione delle tag.
• Elimina- elimina questo volume. Questa azione risulta disattivata quando il volume è associato a un'istanza. Per ulteriori informazioni, vedere Eliminazione di un volume di dati nella console.
• Migrazione del volume: migra questo volume verso un profilo o una configurazione diversi. Per ulteriori informazioni, consultare la sezione " Migrazione dei volumi di archiviazione a blocchi ".

Visualizzazione dei dettagli di un volume Block Storage for VPC

Per visualizzare i dettagli relativi a un volume " Block Storage for VPC ", accedi all'elenco di tutti i volumi " Block Storage for VPC " e seleziona un volume.

Accanto al nome del volume si trovano lo stato del volume e le tag associate a questo volume. I tag utente identificano la risorsa. Quando i tag utente sono associati a un criterio di backup, vengono utilizzati per creare istantanee di backup del volume. Con Tag di gestione dell'accesso, puoi creare raggruppamenti di risorse flessibili per la gestione degli accessi. Per ulteriori informazioni su queste tag, consultare Gestione delle tag.

Informazioni specifiche per volume

La pagina presenta 4 schede. Per impostazione predefinita, la scheda Panoramica è selezionata per i dettagli del volume.

Dettagli volume

Campo	Descrizione
Dettagli volume
Nome	Il nome del volume specificato al momento della sua creazione. Fare clic sull'icona Modifica per modificare il nome del volume. 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 volume devono essere univoci per l'account e per la regione.
ID volume	L'ID volume generato dal sistema.
Integrità	La sezione "Salute" monitora lo stato generale del volume, ad esempio le prestazioni di I/O e la coerenza dei dati. Gli stati di integrità del volume sono OK o degraded. I volumi in stato degradato hanno prestazioni e capacità inferiori alla norma o presentano problemi di connessione. Anche i volumi ripristinati da un'istantanea mostrano uno stato danneggiato. Il servizio visualizza un motivo possibile per lo stato danneggiato in modo da poterlo risolvere. Per ulteriori informazioni, vedi Block Storage for VPC stati di integrità del volume.
Gruppo di risorse	Il gruppo di risorse definito quando configuri il tuo VPC. I gruppi di risorse gestiscono l'accesso alle risorse ma non influenzano la fatturazione o il monitoraggio.
Tipo di collegamento	Dati: per un volume secondario collegato a un'istanza, i dati presenti al momento dell'avvio se il volume è collegato come volume di avvio; vuoto se il volume non è collegato.
Data di creazione	La data generata dal sistema in cui è stato creato il volume.
Posizione	La zona di disponibilità nella tua regione.
Dimensione	La dimensione del volume che hai specificato. Quando il volume è collegato a un'istanza del server virtuale e il volume non ha la massima capacità per il suo intervallo, puoi fare clic sull'icona per espandere il volume. Per ulteriori informazioni, vedere Espansione della capacità del volume Block Storage for VPC.
Profilo	Questo campo mostra il profilo di volume: sdp, IOPS personalizzati o uno dei profili di livello IOPS.
Numero massimo IOPS	Il valore massimo di IOPS per un livello IOPS predefinito oppure il valore specificato per gli IOPS personalizzati.
Velocità effettiva	Il campo mostra la larghezza di banda allocata del volume di archiviazione, misurata in Gigabit al secondo (Gbps). Il throughput è calcolato come risultato del numero di IOPS per cui il volume è stato fornito per il moltiplicatore del throughput. A seconda del profilo del volume, il moltiplicatore di velocità può essere di 16 KB o 256 KB. Per i volumi creati con il profilo sdp, il valore di throughput è personalizzabile nell'intervallo 1000-8192 Mbps.
Crittografia	La crittografia con le chiavi gestite da IBM è abilitata per impostazione predefinita su tutti i volumi. Puoi anche usare le chiavi root per proteggere i dati. Il campo Codifica mostra il nome del servizio di gestione delle chiavi (KMS) di cui hai eseguito il provisioning (ad esempio, Key Protect) e gestito dal cliente. Per ulteriori informazioni, vedi Creazione di volumi Block Storage for VPC con la crittografia gestita dal cliente.
Istanza di codifica	Facoltativo. Un collegamento all'istanza KMS di cui è stato eseguito il provisioning per un volume di crittografia gestito dal cliente.
Chiave	Facoltativo. Il nome e l'ID copiabile della chiave root utilizzata per codificare la passphrase, che protegge un volume di codifica gestito dal cliente.
Politiche di backup	Il numero di politiche di backup associate al volume. Fare clic sul numero di link per andare alla scheda delle politiche di backup.
Istantanee	Numero di istantanee create del volume. Fare clic sul link del numero per andare alla scheda Istantanea e backup.
Ruolo di replica	Il ruolo di questo volume in una relazione di replica: source, replica o none. Questo campo è presente solo nei volumi con profilo “ sdp ”.
Server virtuale collegato	I volumi collegati a un'istanza del server virtuale sono elencati qui. Fai clic su Collega per selezionare un'istanza per collegare questo volume. Per ulteriori informazioni, vedi Collegamento di un volume a un'istanza.
Condizione	Questo campo tiene traccia dello stato complessivo del ciclo di vita del volume, che va dalla creazione alla cancellazione del volume. Lo stato di collegamento, ad esempio, è attaccato quando il volume è collegato a un'istanza e attaccato quando è in corso.
Nome	Fai click sul nome dell'istanza del server virtuale per vedere i dettagli dell'istanza.
Eliminazione automatica	Quando abilitato, il volume viene eliminato automaticamente quando elimini l'istanza. Fare clic sull'interruttore per abilitare l'eliminazione automatica.
Politiche di backup	Mostra le politiche di backup associate a questo volume. Per associare le politiche di copia di riserva, è possibile aggiungere tag di una politica di copia di riserva per le risorse di destinazione a questo volume. Fare clic su Applica per selezionare una normativa di backup, quindi applicare le relative tag per la risorsa di destinazione al volume.

Dal menu Azioni, nella pagina dei dettagli del volume, sono disponibili le seguenti azioni:

• Visualizza il monitoraggio dell'attività: visualizza il registro di monitoraggio dell'attività relativo a questo volume.
• Crea snapshot: crea uno snapshot da un volume di dati collegato o da un volume di avvio. Per ulteriori informazioni, consultare la sezione " Creazione di uno snapshot nella console ".
• Crea immagine: crea un'immagine personalizzata da un volume di avvio. Questa azione è disattivata quando non è disponibile. Per ulteriori informazioni, vedere Creazione di un'immagine da un volume nella console.
• Espandi volume: aumenta la dimensione di un volume collegato con incrementi di 1 GB. Per ulteriori informazioni, vedere Espansione della capacità del volume di archiviazione a blocchi.
• Modifica del profilo IOPS: consente di modificare le caratteristiche prestazionali di un volume di dati collegato aumentando o diminuendo il valore IOPS tramite la modifica del profilo IOPS.
• Applica politica di backup: applica una politica di backup a questo volume. Per ulteriori informazioni, consultare la sezione " Applicazione delle politiche di backup alle risorse ".
• Migrazione del volume: migra questo volume su un profilo diverso. Per ulteriori informazioni, consultare la sezione " Migrazione dei volumi di archiviazione a blocchi ".
• Elimina- elimina un volume non associato. Per ulteriori informazioni, vedere Eliminazione di un volume di dati nella console.

Per visualizzare un elenco delle istantanee di questo volume create manualmente o tramite una politica di backup, fare clic sulla scheda " Istantanee e backup ".

Visualizzazione dei dettagli del volume collegato Block Storage for VPC nei dettagli dell'istanza

È inoltre possibile visualizzare le informazioni relative a un volume Block Storage for VPC associato dalla pagina dei dettagli dell'istanza del server virtuale:

1. Nella console IBM Cloud console, fare clic sull'icona Menu di navigazione > Infrastruttura > Calcolo > Istanze server virtuali e selezionare un'istanza.

2. In Volumi di archiviazione blocchi collegati, fai clic sul nome di un volume per andare alla pagina dei dettagli del volume.

Visualizzazione di tutti i volumi dalla CLI

Eseguire il seguente comando per visualizzare le informazioni di riepilogo relative a tutti i volumi:

ibmcloud is volumes [--json]

Specificando l'ID o il nome del gruppo di risorse filtri l'elenco di volumi che appartengono a un gruppo di risorse. Se si omette questo argomento, il valore predefinito è “tutti i gruppi di risorse”. Puoi anche visualizzare tutti i volumi in una particolare zona di disponibilità. Per impostazione predefinita, vengono visualizzati i primi 25 volumi per pagina.

Il seguente esempio mostra tutti i volumi per tutti i gruppi di risorse nella tua zona di disponibilità.

ibmcloud is volumes

Listing volumes in all resource groups and region us-south under account Test Account as user test.user@ibm.com...
ID                                          Name                                            Status      Capacity   IOPS    Profile           Attachment state   Attachment type   Zone         Resource group   Catalog Offering Version   Catalog Offering Plan   Storage Generation
r006-1dad641f-3a17-4117-8bb6-e30e09e64dff   my-2nd-data-volume                              available   9600       48000   5iops-tier        unattached         -                 us-south-2   Default          -                          -                       1
r006-f336511e-ece5-4407-9c8e-ef030c94aaa0   my-3rd-data-volume                              available   4800       48000   10iops-tier       unattached         -                 us-south-2   Default          -                          -                       1
r006-45ca6ddd-9942-4dd2-9ae9-d3edcb9fa076   my-data-volume-1                                available   300        3000    5iops-tier        unattached         -                 us-south-2   Default          -                          -                       1
r006-6a1ac889-d232-4beb-84dd-93c63cf9a156   my-data-volume-2                                available   300        3000    5iops-tier        unattached         -                 us-south-2   Default          -                          -                       1
r006-862ddcd3-59a6-4c69-9a10-275c894195b9   my-new-boot-volume                              available   250        3000    general-purpose   unattached         -                 us-south-2   Default          -                          -                       1
r006-145fb6c8-8e03-4a9f-bcd7-3bb131d30f05   my-sdp-volume                                   available   250        3000    sdp               attached.          -                 us-south-2   Default          -                          -                       2
r006-693f555e-fec7-4afb-b1e3-a16bf8b0d744   my-virtual-server-instance-boot-1756849222000   available   100        3000    general-purpose   attached           boot              us-south-2   Default          -                          -                       1

Per ulteriori informazioni relative alle opzioni di comando disponibili, consultare ibmcloud is volumes.

Visualizzazione dei dettagli di un volume dalla CLI

Eseguire il seguente comando per visualizzare i dettagli di un volume specifico. È possibile utilizzare il nome o l'ID del volume per identificarlo.

ibmcloud is volume VOLUME_ID [--json]

Vedi il seguente esempio.

ibmcloud is volume my-sdp-volume

Getting volume my-sdp-volume  under account under account Test Account as user test.user@ibm.com...
ID                                     r006-145fb6c8-8e03-4a9f-bcd7-3bb131d30f05
Name                                   my-sdp-volume
CRN                                    crn:v1:bluemix:public:is:us-south-2:a/a1234567::volume:r006-145fb6c8-8e03-4a9f-bcd7-3bb131d30f05
Status                                 available
Attachment state                       attached
Capacity                               250
IOPS                                   3000
Bandwidth(Mbps)                        1000
Profile                                sdp
Encryption key                         -
Encryption                             provider_managed
Resource group                         Default
Created                                2025-06-23T16:35:10+00:00
Zone                                   us-south-2
Health State                           ok
Volume Attachment Instance Reference   Attachment type   Instance ID                                 Instance name                Auto delete   Attachment ID                               Attachment name
                                       data              0726_6cf2d984-e825-458d-8048-11572b72d040   my-virtual-server-instance   false         0717-beec02ac-7edf-4b59-ab9f-7c004bf4d8fa   outpour-perm-cosmic-gander
Active                                 true
Adjustable IOPS                        true
Adjustable Capacity States             unattached,attached
Adjustable IOPS States                 unattached,attached
Busy                                   false
Tags                                   -
Storage Generation                     2

Nell'esempio, il volume è collegato a un'istanza di server virtuale, quindi i nomi e gli ID dell'allegato al volume e dell'istanza sono visualizzati anche nell'output del comando. La proprietà Active è true perché l'istanza del server virtuale a cui è collegato il volume è in esecuzione. La proprietà Busy con il valore false indica che questo volume non sta eseguendo un'operazione che deve essere serializzata.

Per ulteriori informazioni relative alle opzioni di comando disponibili, consultare ibmcloud is volume.

Proprietà CLI extra per i volumi di avvio

Quando si richiede di visualizzare i dettagli dei volumi di avvio, nella risposta vengono restituite alcune proprietà aggiuntive. Vedi il seguente esempio:

ibmcloud is volume r006-77851646-75da-4bd0-8bbd-ed86fdec0b0e

Getting volume r006-77851646-75da-4bd0-8bbd-ed86fdec0b0e under account Test Account as user test.user@ibm.com...
ID                                     r006-77851646-75da-4bd0-8bbd-ed86fdec0b0e
Name                                   vsi-test-boot-1712686424000
CRN                                    crn:v1:bluemix:public:is:us-south-2:a/a1234567::volume:r006-77851646-75da-4bd0-8bbd-ed86fdec0b0e
Status                                 available
Attachment state                       attached
Capacity                               100
IOPS                                   3000
Bandwidth(Mbps)                        393
Profile                                general-purpose
Encryption key                         -
Encryption                             provider_managed
Resource group                         defaults
Created                                2025-04-01T18:18:57+00:00
Zone                                   us-south-2
Health State                           ok
Volume Attachment Instance Reference   Attachment type   Instance ID                                 Instance name   Auto delete   Attachment ID                               Attachment name
                                       boot              0727_a9910bc9-3ea0-40d2-b3de-2b03e752f989   vsi-lvm-test    true          0727-7ff0df1b-ba0b-40c7-ad99-122819342f39   prissy-reason-unselect-overcome
Operating system                       CentOS Stream 9 - Minimal Install (amd64)
Source image                           ID                                          Name
                                       r006-0950e619-325e-446e-b895-e0bdd21dd1ea   ibm-centos-stream-9-amd64-9
Active                                 true
Adjustable IOPS                        false
Busy                                   false
Tags                                   -
Storage Generation                     1
Allowed Use API Version                2025-03-31
Allowed Use Bare Metal Server          true
Allowed Use Instance                   true

Le proprietà di utilizzo consentito sono ereditate dall'immagine sorgente o dall'istantanea da cui è stato creato il volume di avvio padre. Utilizzando la CLI o l'API, è possibile sovrascrivere questi valori quando si crea un'istanza o quando si aggiorna il volume di avvio. Per effettuare questi aggiornamenti è necessario avere il ruolo IAM is.volume.volume.manage-allowed-use.

Queste proprietà comprendono un'espressione booleana del Common Expression Language. Quando l'espressione è valutata come true, il provisioning dell'istanza del server virtuale o del server bare metal è consentito con il volume di avvio o con un'immagine creata dal volume di avvio. Quando l'espressione viene valutata come false, il provisioning viene bloccato. Per ulteriori informazioni, vedere Aggiunta di espressioni di uso consentito alle immagini personalizzate.

Visualizzazione di tutti i volumi con l'API

Effettuare una chiamata GET /volumes per elencare le informazioni di riepilogo su tutti i volumi. Vedi il seguente esempio.

curl -X GET "$vpc_api_endpoint/v1/volumes?version=2025-01-212&generation=2" \
-H "Authorization: Bearer $iam_token"

Una risposta corretta è simile all’esempio riportato di seguito. Questo esempio mostra tre volumi di dati. Il secondo dell'elenco è collegato a un'istanza.

[
  {
    "active": false,
    "attachment_state": "unattached",
    "bandwidth": 393,
    "busy": false,
    "capacity": 100,
    "created_at": "2025-01-22T00:54:01.000Z",
    "crn": "crn:v1:bluemix:public:is:us-south-2:a/a1234567::volume:r006-5ed4006b-3dac-4c95-8eeb-4aa9a85cbd34",
    "encryption": "provider_managed",
    "health_reasons": [],
    "health_state": "ok",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/r006-5ed4006b-3dac-4c95-8eeb-4aa9a85cbd34",
    "id": "r006-5ed4006b-3dac-4c95-8eeb-4aa9a85cbd34",
    "iops": 3000,
    "name": "my-data-volume",
    "profile": {
        "href": "https://us-south.iaas.cloud.ibm.com/v1/volume/profiles/general-purpose",
        "name": "general-purpose"
    },
    "resource_group": {
        "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/6edefe513d934fdd872e78ee6a8e73ef",
        "id": "6edefe513d934fdd872e78ee6a8e73ef",
        "name": "defaults"
    },
    "source_snapshot": {
        "crn": "crn:v1:bluemix:public:is:us-south:a/a1234567::snapshot:r006-8428038a-a399-4894-8c84-c8d7a4a75fae",
        "href": "https://us-south.iaas.cloud.ibm.com/v1/snapshots/r006-8428038a-a399-4894-8c84-c8d7a4a75fae",
        "id": "r006-8428038a-a399-4894-8c84-c8d7a4a75fae",
        "name": "wdc-fst-rstore-c6a092f34118-4505",
        "resource_type": "snapshot"
    },
    "status": "available",
    "status_reasons": [],
    "storage_generation": 1,
    "adjustable_capacity_states": [
        "attached"
    ],
    "user_tags": [
        "env:prod",
        "env:test"
    ],
    "volume_attachments": [],
    "zone": {
        "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-2",
        "name": "us-south-2"
    }
  },
  {
    "active": false,
    "allowed_use": {
      "api_version": "2025-03-31",
      "instance": "true",
      "bare_metal_server": "false"
    },
    "attachment_state": "attached",
    "bandwidth": 393,
    "busy": false,
    "capacity": 100,
    "created_at": "2024-04-01T16:48:16.000Z",
    "crn": "crn:v1:bluemix:public:is:us-south-1:a/a1234567::volume:r006-b5f15a27-ee2b-4d49-9344-9f3c17d42903",
    "encryption": "provider_managed",
    "health_reasons": [],
    "health_state": "ok",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/r006-b5f15a27-ee2b-4d49-9344-9f3c17d42903",
    "id": "r006-b5f15a27-ee2b-4d49-9344-9f3c17d42903",
    "iops": 3000,
    "name": "my-vsi--boot-volume-1711989834000",
    "operating_system": {
      "architecture": "amd64",
      "dedicated_host_only": false,
      "display_name": "Ubuntu Linux® 20.04 LTS Focal Fossa Minimal Install (amd64)",
      "family": "Ubuntu Linux",
      "gpu_supported": [],
      "href": "https://us-south.iaas.cloud.ibm.com/v1/operating_systems/ubuntu-20-04-amd64",
      "name": "ubuntu-20-04-amd64",
      "resource_type": "operating_system",
      "vendor": "Canonical",
      "version": "20.04 LTS Focal Fossa Minimal Install"
    },
    "profile": {
        "href": "https://us-south.iaas.cloud.ibm.com/v1/volume/profiles/general-purpose",
        "name": "general-purpose"
    },
    "resource_group": {
        "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/6edefe513d934fdd872e78ee6a8e73ef",
        "id": "6edefe513d934fdd872e78ee6a8e73ef",
        "name": "defaults"
    },
    "source_image": {
        "crn": "crn:v1:bluemix:public:is:us-south:a/a1234567::image:r006-0e578411-53ab-44ba-a0f8-d003d0011993",
        "href": "https://us-south.iaas.cloud.ibm.com/v1/images/r006-0e578411-53ab-44ba-a0f8-d003d0011993",
        "id": "r006-0e578411-53ab-44ba-a0f8-d003d0011993",
        "name": "ibm-redhat-8-6-minimal-amd64-7",
        "resource_type": "image"
    },
    "status": "available",
    "status_reasons": [],
    "storage_generation": 1,
    "adjustable_capacity_states": [
        "attached"
    ],
    "user_tags": [
        "backup-policy-tag"
    ],
    "volume_attachments": [
        {
            "delete_volume_on_instance_delete": true,
            "device": {
                "id": ""
            },
            "href": "https://us-south.iaas.cloud.ibm.com/v1/instances/0717_70aa00c6-65c9-4523-8a43-893c6fa0d87d/volume_attachments/0717-0fbaf561-6390-48a4-bb28-240b20ded36e",
            "id": "0717-0fbaf561-6390-48a4-bb28-240b20ded36e",
            "instance": {
                "crn": "crn:v1:bluemix:public:is:us-south-1:a/a1234567::instance:0717_70aa00c6-65c9-4523-8a43-893c6fa0d87d",
                "href": "https://us-south.iaas.cloud.ibm.com/v1/instances/0717_70aa00c6-65c9-4523-8a43-893c6fa0d87d",
                "id": "0717_70aa00c6-65c9-4523-8a43-893c6fa0d87d",
                "name": "my-vsi-test",
                "resource_type": null
            },
            "name": "perfectly-parting-humble-skewer",
            "type": "boot"
        }
    ],
    "zone": {
        "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-1",
        "name": "us-south-1"
    }
  },
  {
    "active": false,
    "attachment_state": "unattached",
    "bandwidth": 393,
    "busy": false,
    "capacity": 10,
    "created_at": "2021-09-10T15:56:30.000Z",
    "crn": "crn:v1:bluemix:public:is:us-south-3:a/a1234567::volume:r006-ed2b09db-36da-4cd1-b862-fed933465fcc",
    "encryption": "provider_managed",
    "health_reasons": [],
    "health_state": "ok",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/r006-ed2b09db-36da-4cd1-b862-fed933465fcc",
    "id": "r006-ed2b09db-36da-4cd1-b862-fed933465fcc",
    "iops": 3000,
    "name": "my-other-data-volume",
    "profile": {
        "href": "https://us-south.iaas.cloud.ibm.com/v1/volume/profiles/general-purpose",
        "name": "general-purpose"
    },
    "resource_group": {
        "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/6edefe513d934fdd872e78ee6a8e73ef",
        "id": "6edefe513d934fdd872e78ee6a8e73ef",
        "name": "defaults"
    },
    "status": "available",
    "status_reasons": [],
    "storage_generation": 1,
    "adjustable_capacity_states": [
        "attached"
    ],
    "user_tags": [],
    "volume_attachments": [],
    "zone": {
        "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-3",
        "name": "us-south-3"
    }
  }
]

Visualizzazione dei dettagli del volume con l'API

Effettuare una chiamata GET /volumes/{id} per visualizzare i dettagli di un volume. Vedi il seguente esempio.

curl -X GET "$vpc_api_endpoint/v1/volumes/$volume_id?version=2025-01-21&generation=2" \
-H "Authorization: Bearer $iam_token"

Una risposta di esito positivo fornisce i dettagli del volume, inclusi la capacità e l'IOPS, lo stato del volume e se il volume è collegato a un'istanza.

{
  "active": false,
  "adjustable_capacity_states": ["attached"],
  "adjustable_iops_states": ["attached"],
  "allowed_use": {
    "api_version": "2025-03-31",
    "instance": "true",
    "bare_metal_server": "false"
  },
  "attachment_state": "attached",
  "bandwidth": 1000,
  "busy": false,
  "capacity": 100,
  "created_at": "2024-10-07T23:16:53.000Z",
  "crn": "crn:v1:bluemix:public:is:us-south-1:a/a1234567::volume:r006-1a6b7274-678d-4dfb-8981-c71dd9d4daa5",
  "encryption": "user_managed",
  "encryption_key": {
    "crn": "crn:v1:bluemix:public:kms:us-south:a/a1234567:e4a29d1a-2ef0-42a6-8fd2-350deb1c647e:key:5437653b-c4b1-447f-9646-b2a2a4cd6179"
  },
  "health_reasons": [],
  "health_state": "ok",
  "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/r006-1a6b7274-678d-4dfb-8981-c71dd9d4daa5",
  "id": "r006-1a6b7274-678d-4dfb-8981-c71dd9d4daa5",
  "iops": 1000,
  "name": "my-volume",
  "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/fee82deba12e4c0fb69c3b09d1f12345",
    "id": "fee82deba12e4c0fb69c3b09d1f12345",
    "name": "Default"
  },
  "resource_type": "volume",
  "status": "available",
  "status_reasons": [],
  "storage_generation": 1,
  "user_tags": [],
  "volume_attachments": [
    {
      "delete_volume_on_instance_delete": false,
      "href": "https://us-south.iaas.cloud.ibm.com/v1/instances/0717_e21b7391-2ca2-4ab5-84a8-b92157a633b0/volume_attachments/0717-82cbf856-9cbb-45fb-b62f-d7bcef32399a",
      "id": "0717-82cbf856-9cbb-45fb-b62f-d7bcef32399a",
      "instance": {
        "crn": "crn:v1:bluemix:public:is:us-south-1:a/a1234567::instance:0717_e21b7391-2ca2-4ab5-84a8-b92157a633b0",
        "href": "https://us-south.iaas.cloud.ibm.com/v1/instances/0717_e21b7391-2ca2-4ab5-84a8-b92157a633b0",
        "id": "0717_e21b7391-2ca2-4ab5-84a8-b92157a633b0",
        "name": "my-instance",
        "resource_type": "instance"
      },
      "name": "my-volume-attachment",
      "type": "data"
    }
  ],
  "zone": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-1",
    "name": "us-south-1"
  }
}

Proprietà API extra per i volumi di avvio

Quando si richiede di visualizzare i dettagli dei volumi di avvio, nella risposta vengono restituite un paio di proprietà extra per le richieste GET /volumes e GET /volumes/{id}.

• La proprietà active indica se l'istanza del server virtuale a cui è collegato un volume è in esecuzione o arrestata. Quando active = true, l'istanza è in esecuzione e funzionano anche le operazioni che richiedono un'istanza in esecuzione, come la creazione di un' immagine dal volume di avvio.

• La proprietà busy indica se questo volume sta eseguendo un'operazione che deve essere serializzata. Se un'operazione richiede la serializzazione, l'operazione ha esito negativo a meno che questa proprietà non sia false.

• Le espressioni di uso consentito sono ereditate dall'immagine sorgente o dall'istantanea da cui è stato creato il volume di avvio padre. È possibile aggiornare le espressioni di uso consentito solo sui volumi di avvio staccati. Utilizzando la CLI o l'API, è possibile sovrascrivere questi valori quando si crea un'istanza o aggiornando il volume di avvio. Per effettuare questi aggiornamenti è necessario avere il ruolo IAM is.volume.volume.manage-allowed-use. Queste proprietà comprendono un'espressione booleana del Common Expression Language. Quando l'espressione viene valutata come true, il provisioning dell'istanza del server virtuale o del server bare metal è consentito con il volume di avvio o con un'immagine creata dal volume di avvio. Quando l'espressione viene valutata come false, il provisioning viene bloccato. Per ulteriori informazioni, vedere Aggiunta di espressioni di uso consentito alle immagini personalizzate.

Vedi il seguente esempio.

  "active": "true",
  "busy": "false",
  "capacity": 100,
  "created_at": "2022-12-08T06:26:17Z",
  "crn": "crn:[...]",
  "encryption": "provider_managed",
  "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/ccbe6fe1-5680-4865-94d3-687076a38293",
  "id": "ccbe6fe1-5680-4865-94d3-687076a38293",
  "iops": 300,
  "name": "boot-volume-1",
  "allowed_use": {
    "api_version": "2025-03-31",
    "instance": "true",
    "bare_metal_server": "false"
  },
  .
  .
  .

Visualizzazione di tutti i volumi con Terraform

Importare l'elenco dei volumi appartenenti a un account come origine dati di sola lettura. È possibile filtrare in base al nome del volume, al nome della zona, allo stato del collegamento, al tipo di crittografia, alla famiglia del sistema operativo (applicabile ai volumi di avvio) o all'architettura del sistema operativo (applicabile ai volumi di avvio).

data "ibm_is_volumes" "example" {
}

Gli attributi esportati includono il conteggio totale dei volumi e l'elenco dei volumi. Gli attributi annidati includono l'ID del volume, il nome, la data di creazione, la dimensione, l'IOPS, il CRN, i tag di accesso e utente, il profilo, il tipo e la chiave di crittografia, lo stato del ciclo di vita, lo stato di salute e il motivo, il sistema operativo e altri attributi.

Per ulteriori informazioni, vedere ibm_is_volumes.

Visualizzazione dei dettagli del volume con Terraform

Importare i dettagli di un volume come origine dati di sola lettura. È necessario identificare il volume con un ID o un nome.

data "ibm_is_volume" "example1" {
  name = ibm_is_volume.example.name
}

Gli attributi esportati includono il conteggio totale dei volumi e l'elenco dei volumi. Gli attributi annidati includono l'ID del volume, il nome, la data di creazione, la dimensione, l'IOPS, il CRN, i tag di accesso e utente, il profilo, il tipo e la chiave di crittografia, lo stato del ciclo di vita, lo stato di salute e il motivo, il sistema operativo e altri attributi.

Per ulteriori informazioni, vedere ibm_is_volume.

Proprietà extra di Terraform per i volumi di avvio

Le espressioni di uso consentito sono ereditate dall'immagine sorgente o dall'istantanea da cui è stato creato il volume di avvio padre. È possibile aggiornare le espressioni di uso consentito solo sui volumi di avvio staccati. Utilizzando Terraform, è possibile sovrascrivere questi valori quando si crea un'istanza o aggiornando il volume di avvio. Per effettuare questi aggiornamenti è necessario avere il ruolo IAM is.volume.volume.manage-allowed-use. Queste proprietà comprendono un'espressione booleana del Common Expression Language. Quando l'espressione viene valutata come true, il provisioning dell'istanza del server virtuale o del server bare metal è consentito con il volume di avvio o con un'immagine creata dal volume di avvio. Quando l'espressione viene valutata come false, il provisioning viene bloccato. Per ulteriori informazioni, vedere Aggiunta di espressioni di uso consentito alle immagini personalizzate.