Gestione di volumi Block Storage for VPC

Scollegamento di un volume “ Block Storage for VPC ” da un’istanza di server virtuale

Puoi scollegare un volume di archiviazione blocchi che è collegato a una VSI (virtual server instance). Lo scollegamento libera il volume in modo che possa essere utilizzato da un'altra istanza.

Per scollegare un volume, seguire la procedura riportata di seguito.

1. Vai all'elenco di tutti i volumi di archiviazione a blocchi. Nella console IBM Cloud, fai clic del menu di navigazione > infrastruttura > Archiviazione > Volumi Block Storage.
2. Individuare il volume e fare clic sull'icona Azioni per aprire un elenco di opzioni.
3. Dal menu delle opzioni, fare clic su " Scollega dall'istanza ".
4. Conferma facendo clic su “Scollega istanza ” nella finestra aperta.

In alternativa, è possibile fare clic su un singolo volume nell'elenco di tutti i volumi di archiviazione a blocchi e accedere alla pagina " Dettagli volume " relativa a quel volume. In Istanze collegate, fai clic sul segno meno accanto alla VSI (virtual server instance) per scollegare il volume da tale istanza.

Quando si utilizza un'istanza Hyper Protect Virtual Servers for IBM Cloud® Virtual Private Cloud, il distacco del volume di dati collegato a un'istanza in esecuzione provoca il fallimento del carico di lavoro in esecuzione sull'istanza. Pertanto, si consiglia di non scollegare il volume di dati.

Trasferimento di un volume “ Block Storage for VPC ” da un’istanza di server virtuale a un’altra

Per trasferire un volume di archiviazione a blocchi a un'altra istanza di server virtuale, completare i passaggi seguenti.

1. Scollega il volume dalla sua VSI (virtual server instance).
2. Accedere all'istanza del server virtuale su cui si desidera trasferire il volume. Nella console IBM Cloud console, fare clic sull'icona Menu di navigazione > Infrastruttura > Calcolo > Istanze server virtuali.
3. Seleziona una VSI (virtual server instance) dall'elenco.
4. Fare clic sulla scheda Storage per visualizzare tutti i volumi collegati al server.
5. Fare clic su Allega + aggiungi un volume. Vengono visualizzati tutti i volumi di archiviazione a blocchi disponibili.
6. Dall'elenco dei volumi, seleziona quello che hai precedentemente scollegato.
7. Fare clic su Salva.

Collegamento di un volume di dati indipendente Block Storage for VPC

È possibile creare più volumi di dati di archiviazione a blocchi durante il provisioning dell'istanza; questi volumi vengono automaticamente collegati alla nuova istanza del server virtuale. Quando si stacca un volume da un'istanza, questo esiste come volume indipendente e viene visualizzato nell'elenco di tutti i volumi di archiviazione a blocchi senza tipo di allegato. Puoi collegarlo a un'altra istanza dall'elenco di volumi di archiviazione blocchi.

1. Vai all'elenco di tutti i volumi di archiviazione a blocchi. Nella console IBM Cloud, fai clic del menu di navigazione > infrastruttura > Archiviazione > Volumi Block Storage.
2. Individua il volume e fai clic sull'icona Azioni per aprire un elenco di opzioni.
3. Dal menu delle opzioni, fare clic su " Allega all'istanza ".
4. Seleziona una VSI (virtual server instance).
5. Fai clic su " Allega " per confermare la tua selezione.

Aggiornamento del nome di un volume Block Storage for VPC

Puoi modificare il nome di un volume esistente per renderlo più significativo.

1. Vai all'elenco di tutti i volumi di archiviazione a blocchi. Nella console IBM Cloud, fai clic del menu di navigazione > infrastruttura > Archiviazione > Volumi Block Storage.

2. Individua il volume e fai poi clic sul nome del volume per andare alla pagina Dettagli volume.

3. Fai clic sull'icona Modifica dopo il nome del volume per modificare il nome. Specificare un nome di volume valido.

   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 si creano due volumi con lo stesso nome nello stesso account e nella stessa regione, viene generato un errore volume name duplicate.

4. Conferma la tua modifica.

Aggiunta di tag utente a un volume Block Storage for VPC nella console

Aggiungere tag utente all'archiviazione a blocchi dall'elenco dei volumi o dalla pagina dei dettagli dei volumi.

1. Vai all'elenco dei volumi di archiviazione a blocchi. Nella console IBM Cloud, fai clic del menu di navigazione > infrastruttura > Archiviazione > Volumi Block Storage.

2. Individua il volume dall'elenco a cui vuoi aggiungere le tag utente.

3. Nella colonna tag, fare clic su Aggiungi tag.

4. Immettere i tag utente che si desidera applicare a questo volume. I tag vengono visualizzati quando si digita.

   È anche possibile aggiungere tag di gestione degli accessi a un volume. Per ulteriori informazioni sulla creazione e l'aggiunta di tag di gestione dell'accesso, consulta Applica tag di gestione dell'accesso a un volume.

5. Una volta terminata l'aggiunta di tag, fare clic su Salva. Quando si aggiorna la schermata, l'elenco dei volumi mostra il numero di tag aggiunti nella colonna Tag.

Puoi anche aggiungere tag dalla pagina dei dettagli del volume. Per farlo, segui questi passaggi.

1. Vai all'elenco dei volumi di archiviazione a blocchi.
2. Nei dettagli del volume, fai clic su Aggiungi tag accanto al nome volume.
3. Immettere i tag utente che si desidera applicare a questo volume. Al termine, fai clic su SALVA.

Aggiunta di tag utente associati a un criterio di backup a un volume nella console

È possibile aggiungere i tag utente associati a un criterio di backup a un volume di archiviazione a blocchi. Le politiche di backup pianificano la creazione automatica delle istantanee di backup. Quando una tag volume corrisponde a una tag della normativa di backup per le risorse di destinazione, attiva un backup del contenuto del volume. Una politica di backup definisce un piano di backup che pianifica quando vengono eseguite le istantanee di backup.

Dalla pagina Dettagli volume, è possibile visualizzare le politiche di backup applicate al volume e aggiungere le tag utente associate a una politica di backup.

1. Vai all'elenco dei volumi di archiviazione a blocchi. Nella console IBM Cloud, fai clic del menu di navigazione > infrastruttura > Archiviazione > Volumi Block Storage.
2. Individuare il volume desiderato e fare clic sul link del nome.
3. Nella pagina dei dettagli dell'archiviazione a blocchi, fare clic sulla scheda Criteri di backup.
4. Fai clic su Attach.
5. Nel pannello laterale, selezionare una politica di backup dall'elenco di politiche disponibili, quindi selezionare le tag della politica da applicare al volume. È inoltre possibile visualizzare i dettagli del piano che consentono di decidere se utilizzare tale politica.
6. Fai clic su " Applica criteri e tag ". La politica di copia di backup viene visualizzata nell'elenco delle politiche di copia di backup associate al volume.

Quando si passa alla pagina della politica di backup, il volume per cui sono stati aggiunti i tag viene visualizzato nell'elenco di volumi.

Per ulteriori informazioni sulla creazione di backup, consultare Creazione di una politica di backup. Per ulteriori informazioni sulle tag utente, consultare Utilizzo delle tag.

Aggiornamento di un nome volume

Per modificare un nome volume, specifica l'ID o il nome del volume e quindi indica un nuovo nome. Il nome del volume può contenere fino a 63 caratteri alfanumerici, compresi i caratteri speciali, e deve iniziare con una lettera minuscola. Il nome del volume deve essere univoco nell'infrastruttura VPC.

ibmcloud is volume-update VOLUME_ID [--name NEW_NAME] [--json]

Vedi il seguente esempio.

ibmcloud is volume-update r006-5ed4006b-3dac-4c95-8eeb-4aa9a85cbd34 --name my-data-volume

Updating volume r006-5ed4006b-3dac-4c95-8eeb-4aa9a85cbd34 under account Test Account as user test.user@ibm.com...
ID                                     r006-5ed4006b-3dac-4c95-8eeb-4aa9a85cbd34
Name                                   my-data-volume
CRN                                    crn:v1:bluemix:public:is:us-south-2:a/a1234567::volume:r006-5ed4006b-3dac-4c95-8eeb-4aa9a85cbd34
Status                                 available
Attachment state                       unattached
Capacity                               100
IOPS                                   3000
Bandwidth(Mbps)                        393
Profile                                general-purpose
Encryption key                         -
Encryption                             provider_managed
Resource group                         defaults
Created                                2025-01-22T00:54:01+00:00
Zone                                   us-south-2
Health State
Volume Attachment Instance Reference   -
Source snapshot                        ID                                          Name
                                       r006-8428038a-a399-4894-8c84-c8d7a4a75fae   wdc-fst-rstore-c6a092f34118-4505
Active                                 false
Adjustable IOPS                        false
Busy                                   false
Tags                                   -
Storage Generation                     1

Aggiunta di tag utente a un volume Block Storage for VPC da CLI

Per aggiornare i tag utente di un volume, eseguire il comando 'ibmcloud is volume-update VOLUME con l'opzione '--tags. L'argomento volume può essere definito dall'ID del volume o dal nome del volume.

Usare la stessa opzione per aggiungere tag a un volume quando si crea un volume usando 'ibmcloud is volume-create.

L'esempio seguente aggiunge i tag utente 'env:test e 'bkp:test a un volume identificato da ID. L'output mostra informazioni quali il nome, lo stato, la capacità, il profilo delle prestazioni e la posizione. I tag aggiornati appaiono alla fine della risposta.

ibmcloud is volume-update r006-5ed4006b-3dac-4c95-8eeb-4aa9a85cbd34 --tags dev:test

Updating volume r006-5ed4006b-3dac-4c95-8eeb-4aa9a85cbd34 under account Test Account as user test.user@ibm.com...
ID                                     r006-5ed4006b-3dac-4c95-8eeb-4aa9a85cbd34
Name                                   my-data-volume
CRN                                    crn:v1:bluemix:public:is:us-south-2:a/a1234567::volume:r006-5ed4006b-3dac-4c95-8eeb-4aa9a85cbd34
Status                                 available
Attachment state                       unattached
Capacity                               100
IOPS                                   3000
Bandwidth(Mbps)                        393
Profile                                general-purpose
Encryption key                         -
Encryption                             provider_managed
Resource group                         defaults
Created                                2025-01-22T00:54:01+00:00
Zone                                   us-south-2
Health State
Volume Attachment Instance Reference   -
Source snapshot                        ID                                          Name
                                       r006-8428038a-a399-4894-8c84-c8d7a4a75fae   wdc-fst-rstore-c6a092f34118-4505
Active                                 false
Adjustable IOPS                        false
Busy                                   false
Tags                                   dev:test
Storage Generation                     1

Aggiornamento di un collegamento di volume dalla CLI

È possibile aggiornare il nome dell'attaccamento del volume e modificare l'impostazione predefinita di eliminazione automatica utilizzando il comando instance-volume-attachment-update .

ibmcloud is instance-volume-attachment-update INSTANCE_ID VOLUME_ATTACHMENT_ID [--name NEW_NAME] [--auto-delete true | false] [--json]

Utilizza l'opzione " --name " e specifica un nuovo nome per l'associazione del volume. Specificare --auto-delete true per assicurarsi che il volume venga eliminato automaticamente quando l'istanza viene cancellata. Specificare --auto-delete false, se si desidera mantenere il volume come volume autonomo dopo che l'istanza è stata eliminata.

ibmcloud is instance-volume-attachment-update doc-test-ro otp1 --name one-true-pairing --auto-delete false

Updating volume attachment otp1 of instance doc-test-ro under account Test Account as user test.user@ibm.com...
ID                0757-6757e676-0bf5-4b79-9a5b-29c24e17420c
Name              one-true-pairing
Volume            ID                                          Name
                  r014-dee9736d-08ee-4992-ba8d-3b64a4f0baac   demo-volume-update
Status            attached
Bandwidth(Mbps)   393
Type              data
Device            0757-6757e676-0bf5-4b79-9a5b-29c24e17420c-bxsh7
Auto delete       false
Created           2023-06-29T18:14:57+00:00

Per ulteriori informazioni relative alle opzioni di comando disponibili, consultare ibmcloud is instance-volume-attachment-update.

Scollegamento di un volume dalla CLI

Utilizza il comando instance-volume-attachment-detach per scollegare un volume da un'istanza ed eliminare il collegamento di volumi. Il volume di archiviazione blocchi non viene eliminato; puoi successivamente collegarlo a un'altra istanza.

Nella sintassi di questo comando, INSTANCE è l'ID o il nome dell'istanza. VOLUME_ATTACHMENT è l'ID o il nome del collegamento volume. È possibile specificare più collegamenti volume. Per ulteriori informazioni sui collegamenti dei volumi, consultare il riferimento CLI per la creazione di un collegamento dei volumi.

ibmcloud is instance-volume-attachment-detach INSTANCE (VOLUME_ATTACHMENT1 VOLUME_ATTACHMENT2 ...) [--output JSON] [-f, --force] [-q, --quiet]

ibmcloud is instance-volume-attachment-detach kj-test-ro one-true-pairing

This will delete volume attachment one-true-pairing and cannot be undone. Continue [y/N] ?> y
Deleting volume attachment one-true-pairing from instance kj-test-ro under account Test Account as user test.user@ibm.com...
OK
Volume attachment one-true-pairing is deleted.

Per ulteriori informazioni relative alle opzioni di comando disponibili, consultare ibmcloud is instance-volume-attachment-detach.

Un volume di avvio non può essere staccato da un'istanza finché questa esiste. Se si desidera mantenere il volume di avvio dopo l'eliminazione dell'istanza, assicurarsi che l'opzione auto-delete nell'allegato del volume sia impostata su false.

Aggiornamento del nome di un volume con l'API

Effettuare una chiamata PATCH /volumes/{id} e specificare un nuovo nome per il volume.

curl -X PATCH "$vpc_api_endpoint/v1/volumes/$volume_id?version=2022-04-22&generation=2"  \
-H "Authorization: Bearer $iam_token" \
-d '{
      "name": "my-volume-4-update"
    }'

Una risposta corretta è simile all'esempio riportato di seguito.

{
  "capacity": 50,
  "created_at": "2022-04-22T23:16:53.000Z",
  "crn": "crn:[...]",
  "encryption": "user_managed",
  "encryption_key": {
    "crn": "crn:[...]"
  },
  "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-update",
  "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"
  }
}

Aggiunta di tag utente a un volume Block Storage for VPC con l'API

Per aggiungere le tag utente a un volume, esegui prima una chiamata GET /volumes/{volume_id} e copia la stringa hash dalla proprietà Etag nell'intestazione della risposta. Utilizzare quindi la stringa hash quando si specifica If-Match in una richiesta PATCH /volumes/{volume_id} per creare nuove tag utente.

Per applicare i tag a un volume di archiviazione a blocchi, procedere come segue:

1. Eseguire una chiamata 'GET /volumes/{volume_id} e copiare la stringa hash dalla proprietà 'Etag nell'intestazione della risposta. È necessario utilizzare la stringa di hash quando si specifica 'If-Match nella richiesta 'PATCH /volumes/{volume_id} per creare i tag utente per il volume al punto 2. Per generare le informazioni sull'intestazione della risposta, effettuare una chiamata API simile all'esempio seguente:

   curl -sSL -D GET\
   "https://us-south.iaas.cloud.ibm.com/v1/volumes/{volume_id}?version=2022-04-25&generation=2"\
   -H "Authorization: Bearer $TOKEN" -o /dev/null
   

   Nell'intestazione della risposta si vede qualcosa di simile:

   HTTP/2 200
   date: Tue, 28 Apr 2022 17:48:03 GMT
   content-type: application/json; charset=utf-8
   content-length: 1049
   cf-ray: 69903d250c4966ef-DFW
   cache-control: max-age=0, no-cache, no-store, must-revalidate
   expires: -1
   strict-transport-security: max-age=31536000; includeSubDomains
   cf-cache-status: DYNAMIC
   expect-ct: max-age=604800, report-uri="[uri...]"
   pragma: no-cache
   x-content-type-options: nosniff
   x-request-id: 1fbe2384-6828-4503-ae7d-050426d1b11b
   x-xss-protection: 1; mode=block
   server: cloudflare
   etag: W/xxxyyyzzz123
   

2. Effettuare una richiesta di " PATCH /volumes/{volume_id}. Specificare la stringa Etag-hash per la proprietà 'If-Match nell'intestazione. Specificare il tag utente nella proprietà 'user_tags.

   È possibile aggiungere tag anche quando si effettua una chiamata 'POST /volumes per creare un volume e si specifica la proprietà 'user_tags.

   Questo esempio aggiorna il volume specificando i tag utente 'env:test e 'env:prod. Il valore ottenuto dal parametro 'Etag viene specificato nell'intestazione 'If-Match della chiamata.

   curl -X PATCH\
   "$vpc_api_endpoint/v1/volumes/r006-5ed4006b-3dac-4c95-8eeb-4aa9a85cbd34?version=2025-01-21&generation=2"\
      -H "Authorization: Bearer $iam_token"\
      -H "If-Match: <_Etag-hash-string_>"\
      -d `{
         "user_tags": [
            "env:test",
            "env:prod"
         ]
      }'
   

   La risposta mostra i tag aggiunti al volume:

   {
    "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": "",
    "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": [],
    "adjustable_capacity_states": [
        "attached"
    ],
    "storage_generation": 1,
    "user_tags": [
        "env:test",
        "env:prod"
    ],
    "volume_attachments": [],
    "zone": {
        "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-2",
        "name": "us-south-2"
    }
   }
   

Aggiornamento di un collegamento di volume con l'API

Eseguire una chiamata PATCH /instances/$instance_id/volume_attachments/$volume_attachment_id e specificare gli ID dell'istanza e del volume collegato. Nel corpo della richiesta, specificare il nuovo nome dell'allegato o il nuovo valore della proprietà delete_volume_on_instance_delete. Se la proprietà delete_volume_on_instance_delete è impostata su true, quando l'istanza viene eliminata, il volume collegato viene eliminato. Se si desidera mantenere il volume dopo l'eliminazione dell'istanza, specificare il valore " false " per la proprietà " delete_volume_on_instance_delete ".

curl -X PATCH "$vpc_api_endpoint/v1/instances/$instance_id/volume_attachments/$volume_attachment_id?version=2022-04-22&generation=2" \
-H "Authorization: Bearer $iam_token" \
-d '{
      "delete_volume_on_instance_delete": false,
      "name": "my-volume-attachment-data-5iops-updated"
    }'

Una risposta corretta è simile all'esempio riportato di seguito.

{
  "created_at": "2022-04-22T16:35:47.000Z",
  "delete_volume_on_instance_delete": false,
  "href": "https://us-south.iaas.cloud.ibm.com/v1/instances/8f06378c-ed0e-481e-b98c-9a6dfbee1ed5/volume_attachments/9f2a645e-19c1-4f8f-b062-46b9e0671999",
  "id": "9f2a645e-19c1-4f8f-b062-46b9e0671999",
  "name": "my-volume-attachment-data-5iops-updated",
  "status": "attached",
  "type": "data",
  "volume": {
    "crn": "crn:[...]",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/d8b26921-1409-4c2f-9b46-39b5b6e0b945",
    "id": "d8b26921-1409-4c2f-9b46-39b5b6e0b945",
    "name": "my-volume-data-5iops"
  }
}

Scollegamento di un volume con l'API

Effettuare una richiesta DELETE /instances/{instance_id}/volume_attachments/{id} e specificare l'ID collegamento volume per eliminare un collegamento volume. L'eliminazione di un volume collegato comporta il distacco del volume dall'istanza.

curl -X DELETE "$vpc_api_endpoint/v1/instances/$instance_id/volume_attachments/$volume_attachment_id?version=2022-04-22&generation=2" \
-H "Authorization: Bearer $iam_token"

Un volume di avvio non può essere staccato da un'istanza finché questa esiste. Se si desidera mantenere il volume di avvio dopo l'eliminazione dell'istanza, assicurarsi che la proprietà delete_volume_on_instance_delete nell'allegato del volume sia impostata su false.

Verifica che il volume sia scollegato dall'istanza effettuando una chiamata GET /instances/{instance_id}.

Aggiornamento del nome di un volume con Terraform

Per modificare il nome di un volume, utilizzare la risorsa 'ibm_is_volume. L'esempio seguente specifica il volume 'r010-bdb8fc70-8afb-4622-826a-d65a9fc477a4 e il suo nuovo nome 'my-new-name-volume. Una volta applicato, il volume viene rinominato.

resource "ibm_is_volume" "example" {
  name    = "my-new-name-volume"
  id      = "r010-bdb8fc70-8afb-4622-826a-d65a9fc477a4"
  profile = "10iops-tier"
  zone    = "us-south-1"
}

Applicazione di tag ai volumi con Terraform

Per applicare i tag utente a un volume, utilizzare la risorsa 'ibm_is_volume. L'esempio seguente specifica il volume 'my-new-volume e il tag 'dev:test da allegare al volume. Quando viene applicato, il tag viene aggiunto al volume.

resource "ibm_is_volume" "example" {
  name    = "my-new-volume"
  profile = "10iops-tier"
  zone    = "us-south-1"
  tags    = ["dev:test"]
}