Gestión de volúmenes Block Storage for VPC

Desconectar un volumen de « Block Storage for VPC » de una instancia de servidor virtual

Puede desconectar un volumen de almacenamiento en bloque que esté conectado a una instancia de servidor virtual. Cuando se desconecta un volumen, se libera para que lo utilice otra instancia.

Para desconectar un volumen, sigue estos pasos.

1. Vaya a la lista de todos los volúmenes de almacenamiento en bloque. En la consola IBM Cloud, haga clic en el ícono del menú de navegación > de infraestructura > Almacenamiento > Volúmenes Block Storage.
2. Locate the volume and click the Acciones icon to open a list of options.
3. En el menú de opciones, pulse Desconectar de instancia.
4. Confirme pulsando Desconectar instancia en la ventana abierta.

De forma alternativa, puede pulsar un volumen individual en la lista de todos los volúmenes de almacenamiento en bloque e ir a la página Detalles de volumen para dicho volumen. En Instancias conectadas, pulse el signo menos que hay junto a la instancia de servidor virtual para desconectar el volumen de dicha instancia.

Cuando se utiliza una instancia de Hyper Protect Virtual Servers para IBM Cloud® Virtual Private Cloud, la separación del volumen de datos que se adjunta a una instancia en ejecución provoca el fallo de la carga de trabajo que se está ejecutando en la instancia. Por lo tanto, se recomienda no desconectar el volumen de datos.

Traslado de un volumen de « Block Storage for VPC » de una instancia de servidor virtual a otra

Para transferir un volumen de almacenamiento en bloque a otra instancia de servidor virtual, complete los siguientes pasos.

1. Desconecte el volumen de su instancia de servidor virtual.
2. Vaya a la instancia de servidor virtual a la que desea transferir el volumen. En la IBM Cloud consola, haga clic en el icono Menú de navegación >Infraestructura >Computación >Instancias de servidor virtual.
3. Seleccione una instancia de servidor virtual de la lista.
4. Haga clic en la pestaña Almacenamiento para ver todos los volúmenes conectados al servidor.
5. Haga clic en Adjuntar + añadir un volumen. Se muestran todos los volúmenes de almacenamiento en bloque disponibles.
6. En la lista de volúmenes, seleccione el volumen que ha desconectado anteriormente.
7. Pulse Guardar.

Adjuntar un volumen de datos independiente Block Storage for VPC

Puede crear varios volúmenes de datos de almacenamiento en bloque durante el aprovisionamiento de instancias, estos volúmenes se adjuntan automáticamente a la nueva instancia de servidor virtual. Cuando se separa un volumen de una instancia, existe como volumen independiente y se muestra en la lista de todos los volúmenes de almacenamiento en bloque sin ningún tipo de adjunto. Puede conectarlo a otra instancia de la lista de volúmenes de almacenamiento en bloque.

1. Vaya a la lista de todos los volúmenes de almacenamiento en bloque. En la consola IBM Cloud, haga clic en el ícono del menú de navegación > de infraestructura > Almacenamiento > Volúmenes Block Storage.
2. Localice el volumen y, a continuación, pulse el icono Acciones para abrir una lista de opciones.
3. En el menú de opciones, pulse Conectar a instancia.
4. Seleccione una instancia de servidor virtual disponible.
5. Haz clic en « Adjuntar » para confirmar tu selección.

Actualización del nombre de un volumen de « Block Storage for VPC »

Puede cambiar el nombre de un volumen existente por uno más significativo.

1. Vaya a la lista de todos los volúmenes de almacenamiento en bloque. En la consola IBM Cloud, haga clic en el ícono del menú de navegación > de infraestructura > Almacenamiento > Volúmenes Block Storage.

2. Localice el volumen y luego pulse el nombre del volumen para ir a la página Detalles del volumen.

3. Pulse el icono Editar después del nombre del volumen para editar el nombre. Introduce un nombre de volumen válido.

   Los nombres de volumen válidos pueden incluir una combinación de caracteres alfanuméricos en minúsculas (a-z, 0-9) y el guion (-), con un máximo de 63 caracteres. Los nombres de volumen deben empezar por una letra minúscula. Los nombres de volumen deben ser exclusivos en toda la infraestructura de VPC. Por ejemplo, si creas dos volúmenes con el mismo nombre en la misma cuenta y región, se produce un error de « volume name duplicate ».

4. Confirme la edición.

Añadir etiquetas de usuario a un volumen Block Storage for VPC en la consola

Añade etiquetas de usuario al almacenamiento en bloque desde la lista de volúmenes o la página de detalles de los volúmenes.

1. Accede a la lista de volúmenes de almacenamiento en bloque. En la consola IBM Cloud, haga clic en el ícono del menú de navegación > de infraestructura > Almacenamiento > Volúmenes Block Storage.

2. Localice el volumen de la lista en la que desea añadir etiquetas de usuario.

3. En la columna etiquetas, pulse Añadir etiquetas.

4. Introduce las etiquetas de usuario que quieras aplicar a este volumen. Las etiquetas se muestran a medida que escribe.

   También puedes añadir etiquetas de gestión de acceso a un volumen. Para obtener más información sobre cómo crear y añadir etiquetas de gestión de acceso, consulte Aplicar etiquetas de gestión de acceso a un volumen.

5. Cuando haya terminado de añadir etiquetas, pulse Guardar. Al actualizar la pantalla, la lista de volúmenes muestra el número de etiquetas añadidas en la columna Etiquetas.

También puede añadir etiquetas desde la página de detalles de volumen. Para ello, sigue estos pasos.

1. Accede a la lista de volúmenes de almacenamiento en bloque.
2. En los detalles del volumen, pulse Añadir etiquetas junto al nombre del volumen.
3. Introduce las etiquetas de usuario que quieras aplicar a este volumen. Cuando termine, pulse GUARDAR.

Adición de etiquetas de usuario asociadas a una política de copia de seguridad a un volumen en la consola

Puedes añadir etiquetas de usuario asociadas a una política de copia de seguridad a un volumen de almacenamiento en bloques. Las políticas de copia de seguridad planifican la creación automática de instantáneas de copia de seguridad. Cuando una etiqueta de volumen coincide con una etiqueta de política de copia de seguridad para los recursos de destino, desencadena una copia de seguridad del contenido del volumen. Una política de copia de seguridad define un plan de copia de seguridad que planifica cuándo se toman las instantáneas de copia de seguridad.

En la página detalles de volumen, puede ver las políticas de copia de seguridad que se aplican al volumen y añadir etiquetas de usuario que están asociadas con una política de copia de seguridad.

1. Accede a la lista de volúmenes de almacenamiento en bloque. En la consola IBM Cloud, haga clic en el ícono del menú de navegación > de infraestructura > Almacenamiento > Volúmenes Block Storage.
2. Busca el volumen que desees y haz clic en el enlace del nombre.
3. En la página de detalles del almacenamiento en bloque, haz clic en la pestaña « Políticas de copia de seguridad ».
4. Pulse Conectar.
5. En el panel lateral, selecciona una política de copia de seguridad de la lista de políticas disponibles y, a continuación, selecciona las etiquetas de la política que deseas aplicar al volumen. También puedes consultar los detalles del plan, que te ayudarán a decidir si te conviene contratar esa póliza.
6. Pulse Aplicar política y etiquetas. La política de copias de seguridad aparece en la lista de políticas de copias de seguridad asociadas al volumen.

Cuando vaya al página de políticas de copia, el volumen cuyas etiquetas ha añadido aparecerá en la lista de volúmenes.

Para obtener más información sobre cómo crear copias de seguridad, consulta « Creación de una política de copias de seguridad ». Para obtener más información sobre las etiquetas de usuario, consulte Trabajar con etiquetas.

Actualización de un nombre de volumen

Para cambiar el nombre de un volumen, especifique el nombre o el ID del volumen y luego indique el nuevo nombre. El nombre de volumen puede tener un máximo de 63 caracteres alfanuméricos e incluir caracteres especiales, y debe empezar por una letra minúscula. El nombre de volumen debe ser exclusivo dentro de la infraestructura de VPC.

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

Vea el ejemplo siguiente.

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

Añadir etiquetas de usuario a un volumen Block Storage for VPC desde la CLI

Emita el comando " ibmcloud is volume-update VOLUME " con la opción " --tags " para actualizar las etiquetas de usuario de un volumen. El argumento del volumen puede definirse mediante el ID del volumen o el nombre del volumen.

Utilice la misma opción para añadir etiquetas a un volumen cuando cree un volumen utilizando ' ibmcloud is volume-create.

El ejemplo siguiente añade etiquetas de usuario env:test y bkp:test a un volumen identificado por ID. La salida muestra información como el nombre, el estado, la capacidad, el perfil de rendimiento y la ubicación. Las etiquetas actualizadas aparecen al final de la respuesta.

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

Actualización de una conexión de volumen desde la CLI

Puedes actualizar el nombre del volumen adjunto y modificar la configuración predeterminada de eliminación automática mediante el comando « instance-volume-attachment-update ».

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

Utiliza la opción « --name » y especifica un nuevo nombre para la conexión del volumen. Especifique --auto-delete true para asegurarse de que el volumen se elimina automáticamente cuando se elimina la instancia. Especifique --auto-delete false, si desea mantener el volumen como un volumen autónomo después de suprimir la instancia.

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

Para obtener más información sobre las opciones de mandato disponibles, consulte ibmcloud is instance-volume-attachment-update.

Desconectar un volumen desde la CLI

Utilice el mandato instance-volume-attachment-detach para desconectar un volumen de una instancia y suprimir la conexión del volumen. El volumen de almacenamiento en bloque no se suprime; luego puede conectarlo a otra instancia.

En la sintaxis de este mandato, INSTANCE es el ID o nombre de la instancia. VOLUME_ATTACHMENT es el ID o nombre de la conexión de volumen. Puede especificar varias conexiones de volumen. Para obtener más información sobre las conexiones de volumen, consulte la referencia de CLI para crear una conexión de volumen.

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.

Para obtener más información sobre las opciones de mandato disponibles, consulte ibmcloud is instance-volume-attachment-detach.

Un volumen de arranque no puede separarse de una instancia mientras ésta exista. Si desea conservar el volumen de arranque una vez eliminada la instancia, asegúrese de que la opción auto-delete del anexo de volumen está configurada en false.

Actualización del nombre de un volumen mediante la API

Realice una llamada PATCH /volumes/{id} y especifique un nombre nuevo para el volumen.

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 respuesta satisfactoria tiene un aspecto similar al del ejemplo siguiente.

{
  "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"
  }
}

Añadir etiquetas de usuario a un volumen Block Storage for VPC con la API

Para añadir etiquetas de usuario a un volumen, primero debe realizar una llamada a GET /volumes/{volume_id} y copiar la serie hash de la propiedad Etag en la cabecera de respuesta. A continuación, utilice la serie hash cuando especifique If-Match en una solicitud PATCH /volumes/{volume_id} para crear nuevas etiquetas de usuario.

Para aplicar etiquetas a un volumen de almacenamiento en bloques, siga estos pasos:

1. Realiza una llamada a GET /volumes/{volume_id} y copia la cadena hash de la propiedad Etag del encabezado de la respuesta. Debes utilizar la cadena hash al especificar « If-Match » en la solicitud « PATCH /volumes/{volume_id} » para crear etiquetas de usuario para el volumen en el paso 2. Para generar la información de la cabecera de respuesta, realice una llamada a la API similar a la del siguiente ejemplo:

   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
   

   En el encabezado de la respuesta, verás algo como esto:

   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. Realice una petición de PATCH /volumes/{volume_id}. Especifique la Etag-hash-string de la propiedad If-Match en la cabecera. Especifica la etiqueta de usuario en la propiedad « user_tags ».

   También puedes añadir etiquetas cuando realizas una llamada ' POST /volumes ' para crear un volumen y especificas la propiedad ' user_tags '.

   Este ejemplo actualiza el volumen especificando las etiquetas de usuario env:test y env:prod. El valor que ha obtenido del parámetro ' Etag ' se especifica en la cabecera ' If-Match ' de la llamada.

   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 respuesta muestra las etiquetas que se han añadido al volumen:

   {
    "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"
    }
   }
   

Actualización de una conexión de volumen mediante la API

Realiza una llamada a la función « PATCH /instances/$instance_id/volume_attachments/$volume_attachment_id » y especifica los ID de la instancia y del volumen asociado. En el cuerpo de la solicitud, especifique el nuevo nombre del adjunto o el nuevo valor de la propiedad delete_volume_on_instance_delete. Si la propiedad delete_volume_on_instance_delete se establece en true, cuando se elimina la instancia, se elimina el volumen adjunto. Si deseas conservar el volumen una vez eliminada la instancia, especifica el valor « false » para la propiedad « 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 respuesta satisfactoria tiene un aspecto similar al del ejemplo siguiente.

{
  "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"
  }
}

Desconexión de un volumen con la API

Realiza una solicitud de tipo « DELETE /instances/{instance_id}/volume_attachments/{id} » y especifica el ID de la conexión del volumen para eliminar dicha conexión. La supresión de un adjunto de volúmenes desconecta un volumen de una instancia.

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 volumen de arranque no puede separarse de una instancia mientras ésta exista. Si desea conservar el volumen de arranque después de eliminar la instancia, asegúrese de que la propiedad delete_volume_on_instance_delete en el anexo del volumen está establecida en false.

Verifique que el volumen esté desconecto de la instancia realizando una llamada GET /instances/{instance_id}.

Actualización del nombre de un volumen con Terraform

Para cambiar el nombre de un volumen, utilice el recurso " ibm_is_volume ". El siguiente ejemplo especifica el volumen " r010-bdb8fc70-8afb-4622-826a-d65a9fc477a4 " y su nuevo nombre como " my-new-name-volume. Cuando se aplica, se cambia el nombre del volumen.

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

Aplicación de etiquetas a volúmenes con Terraform

Para aplicar etiquetas de usuario a un volumen, utilice el recurso " ibm_is_volume ". El siguiente ejemplo especifica el volumen " my-new-volume " y la etiqueta " dev:test " que se adjuntará al volumen. Cuando se aplica, la etiqueta se añade al volumen.

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