Ver información sobre todos los volúmenes Block Storage for VPC en la consola

Vaya a la lista de volúmenes Block Storage for VPC. En la IBM Cloud consola, haga clic en el icono Menú de navegación >Infraestructura >Almacenamiento > Block Storage.

Por defecto, los volúmenes de Block Storage for VPC se muestran en conjuntos de 10 para todos los grupos de recursos de su región. Para modificar esta configuración predeterminada, haz clic en la flecha hacia abajo del control de página y amplía la lista a 20 o 50 volúmenes. Utilice las flechas de control de página para ir a la página siguiente o volver. En la lista de todos los volúmenesBlock Storage for VPC, verá la información siguiente.

Detalles sobre todos los volúmenes

Campo	Descripción
Región	La región en la que se encuentran estos volúmenes, por ejemplo, EE.UU. sur. Haz clic en la flecha hacia abajo para ver los volúmenes de otra región en la que tengas una cuenta.
Nombre	Pulse el nombre del volumen para ver los detalles del volumen individual.
Estado	Estado del volumen, que funciona como el filtro predeterminado para todas las filas.
Ubicación	Zona de disponibilidad en su región, heredada de la VPC (por ejemplo, US South 1).
Tamaño	Tamaño del volumen que ha especificado, en GB.
Tipo de conexión	Datos para un volumen secundario conectado a una instancia, arranque cuando esté conectado como un volumen de arranque, o en blanco para un volumen que no esté conectado.
Estado	La función de supervisión comprueba el estado general del volumen, como el rendimiento de E/S y la coherencia de los datos. Los estados de salud del volumen son OK o degraded. Los volúmenes en estado degradado han degradado el rendimiento, la capacidad o han experimentado problemas de conexión. Los volúmenes que se restauran desde una instantánea también muestran un estado degradado. El servicio muestra una posible razón del estado degradado para que pueda resolver cualquier problema. Para obtener más información, consulte Block Storage for VPC estados de salud del volumen.
Cifrado	El cifrado con claves gestionadas por IBM está habilitado de forma predeterminada en todos los volúmenes. También puede utilizar sus propias claves raíz en una instancia de Key Protect para proteger sus datos. Para obtener más información, consulta Creación de volúmenes de Block Storage for VPC con cifrado gestionado por el cliente.
Etiquetas	Número de etiquetas de usuario aplicadas al volumen. Haz clic en el número de esta columna para ver o editar las etiquetas en una nueva ventana. Si no se han aplicado etiquetas al volumen, haz clic en Añadir etiquetas y añádelas en la nueva ventana. Las etiquetas de usuario pueden asociar el volumen con una política de copia de seguridad para crear copias de seguridad del volumen. Para obtener más información, consulte Adición de etiquetas de usuario asociadas a una política de copia de seguridad a un volumen en la consola.
Acciones	Haga clic en Acciones para mostrar un menú de acciones específicas del contexto que puede realizar.

Desde el menú Acciones ( de la página de la lista de volúmenes, están disponibles las siguientes acciones. Algunas acciones solo están disponibles cuando el volumen cumple determinadas condiciones, como estar conectado o desconectado.

• Cambiar nombre: cambia el nombre de este volumen.
• Conectar al servidor: conectar un volumen no conectado a una instancia de servidor virtual. Esta acción solo está disponible cuando el volumen no está conectado. Para obtener más información, consulte Conexión de un volumen a una instancia.
• Desconectar de la instancia: desconecta un volumen conectado de su instancia de servidor virtual. Esta acción solo está disponible cuando el volumen está conectado. Para obtener más información, consulta Desconectar un volumen de una instancia de servidor virtual.
• Crear instantánea: crea una instantánea de este volumen. Esta acción puede aparecer desactivada si no está disponible. Para obtener más información, consulta Creación de una instantánea en la consola.
• Crear imagen: crear una imagen personalizada a partir de un volumen de arranque. Esta acción puede aparecer desactivada si no está disponible. Para obtener más información, consulte Creación de una imagen a partir de un volumen en la consola.
• Añadir etiquetas o editar etiquetas: añade o edita etiquetas de usuario y accede a las etiquetas de gestión de este volumen. Para obtener más información, consulte Cómo trabajar con etiquetas.
• Eliminar: eliminar este volumen. Esta acción aparece desactivada cuando el volumen está asociado a una instancia. Para más información, consulta Eliminar un volumen de datos en la consola.
• Migrar volumen: migra este volumen a un perfil o configuración diferente. Para obtener más información, consulta Migración de volúmenes de almacenamiento en bloque.

Ver detalles de un volumen Block Storage for VPC

Para ver detalles sobre un volumen de Block Storage for VPC, ve a la lista de todos los volúmenes de Block Storage for VPC y selecciona uno.

Junto al nombre del volumen se encuentra el estado del volumen y las etiquetas asociadas con este volumen. Las etiquetas de usuario identifican el recurso. Cuando las etiquetas de usuario están asociadas a una política de copia de seguridad, se utilizan para crear instantáneas de copia de seguridad del volumen. Con Etiquetas de gestión de acceso, puede crear agrupaciones de recursos flexibles para gestionar el acceso. Para obtener más información sobre estas etiquetas, consulte Trabajar con etiquetas.

Información específica sobre el volumen

La página tiene 4 pestañas. De forma predeterminada, se selecciona la pestaña Visión general para los detalles del volumen.

Detalles del volumen

Campo	Descripción
Detalles del volumen
Nombre	El nombre del volumen que especificó al crearlo. Pulse el icono Editar para editar el nombre del volumen. El nombre de volumen puede tener un máximo de 63 caracteres alfanuméricos en minúsculas, puede incluir el guion (-) y debe empezar por una letra minúscula. Los nombres de volumen deben ser exclusivos para la cuenta y para la región.
ID de volumen	ID de volumen generado por el sistema.
Estado	La función de supervisión comprueba el estado general del volumen, como el rendimiento de E/S y la coherencia de los datos. Los estados de salud del volumen son OK o degraded. Los volúmenes en estado degradado tienen un rendimiento y una capacidad inferiores a OK, o experimentan problemas de conexión. Los volúmenes que se están restaurando desde una instantánea también muestran un estado degradado. El servicio muestra una posible razón del estado degradado para que pueda resolverlo. Para obtener más información, consulte Block Storage for VPC estados de salud del volumen.
Grupo de recursos	Grupo de recursos definido al configurar la VPC. Los grupos de recursos gestionan el acceso a los recursos, pero no influyen sobre la facturación ni la supervisión.
Tipo de conexión	Datos: para un volumen secundario conectado a una instancia, se arranca cuando se conecta como volumen de arranque, o queda en blanco si se trata de un volumen no conectado.
Fecha de creación	Fecha generada por el sistema en que se creó el volumen.
Ubicación	Zona de disponibilidad en su región.
Tamaño	Tamaño del volumen que ha especificado. Cuando el volumen está conectado a una instancia de servidor virtual y el volumen no tiene la capacidad máxima para su rango, puede pulsar el icono para expandir el volumen. Para más información, consulte la ampliación de la capacidad del volumen Block Storage for VPC.
Perfil	Este campo muestra el perfil de volumen: sdp, IOPS personalizadas o uno de los perfiles de nivel de IOPS.
IOPS máximas	El valor máximo de IOPS para un nivel de IOPS predefinido o el valor que haya especificado para las IOPS personalizadas.
Rendimiento	El campo muestra el ancho de banda asignado al volumen de almacenamiento, que se mide en Gigabits por segundo (Gbps). El rendimiento se calcula como el resultado del número de IOPS para el que se aprovisiona el volumen multiplicado por el multiplicador de rendimiento. En función del perfil de volumen, el multiplicador de rendimiento puede ser de 16 KB o 256 KB. Para los volúmenes creados con el perfil sdp, el valor de rendimiento es personalizable en el rango de 1000-8192 Mbps.
Cifrado	El cifrado con claves gestionadas por IBM está habilitado de forma predeterminada en todos los volúmenes. También puede utilizar sus propias claves raíz para proteger sus datos. El campo Cifrado muestra el nombre del servicio de gestión de claves (KMS) que ha aprovisionado (por ejemplo, Key Protect ) y que gestiona el cliente. Para obtener más información, consulte Creación de volúmenes de Block Storage for VPC con cifrado gestionado por el cliente.
Instancia de cifrado	Opcional. Enlace a la instancia de KMS suministrada para un volumen de cifrado gestionado por el cliente.
Clave	Opcional. El nombre y el identificador copiable de la clave raíz que se utiliza para cifrar la frase de contraseña, la cual protege un volumen cifrado gestionado por el cliente.
Políticas de copia de seguridad	El número de políticas de copia de seguridad que están asociadas con el volumen. Pulse el enlace de número para ir a la pestaña Políticas de copia de seguridad.
Instantáneas	El número de instantáneas que se han creado del volumen. Pulse el enlace de número para ir a la pestaña Instantáneas y copias de seguridad.
Rol de réplica	El papel de este volumen en una relación de replicación: source, replica, o none. Este campo solo aparece en los volúmenes de perfil sdp.
Servidor virtual conectado	Los volúmenes conectados a una instancia de servidor virtual se listan a continuación. Haz clic en Adjuntar para seleccionar una instancia a la que adjuntar este volumen. Para obtener más información, consulte Conexión de un volumen a una instancia.
Estado	Este campo rastrea el estado general del ciclo de vida del volumen, que va desde la creación hasta la eliminación del volumen. El estado de conexión, por ejemplo, es conectado cuando el volumen está conectado a una instancia y conectando cuando el proceso está en curso.
Nombre	Pulse el nombre de la instancia de servidor virtual para ver los detalles de la instancia.
Autosuprimir	Cuando está habilitado, el volumen se suprime automáticamente al suprimir la instancia. Pulse el conmutador para habilitar la supresión automática.
Políticas de copia de seguridad	Muestra las políticas de copia de seguridad que están asociadas con este volumen. Para asociar políticas de copia de seguridad, puede añadir etiquetas de política de copia de seguridad para recursos de destino a este volumen. Pulse Aplicar para seleccionar una política de copia de seguridad y, a continuación, aplicar sus etiquetas para el recurso de destino al volumen.

Desde el menú Acciones ( de la página de detalles del volumen, están disponibles las siguientes acciones:

• Ver seguimiento de la actividad: consulta el registro de seguimiento de la actividad de este volumen.
• Crear instantánea: crea una instantánea a partir de un volumen de datos adjunto o de un volumen de arranque. Para obtener más información, consulta Creación de una instantánea en la consola.
• Crear imagen: crear una imagen personalizada a partir de un volumen de arranque. Esta acción aparece en gris cuando no está disponible. Para obtener más información, consulte Creación de una imagen a partir de un volumen en la consola.
• Ampliar volumen: aumentar el tamaño de un volumen conectado en incrementos de 1 GB. Para obtener más información, consulte Cómo ampliar la capacidad de un volumen de almacenamiento en bloque.
• Editar el perfil de IOPS: modifique las características de rendimiento de un volumen de datos conectado aumentando o reduciendo las IOPS mediante la edición del perfil de IOPS.
• Aplicar política de copias de seguridad: aplicar una política de copias de seguridad a este volumen. Para obtener más información, consulta Aplicación de políticas de copia de seguridad a los recursos.
• Migrar volumen: migra este volumen a un perfil diferente. Para obtener más información, consulta Migración de volúmenes de almacenamiento en bloque.
• Eliminar: elimina un volumen no adjunto. Para más información, consulta Eliminar un volumen de datos en la consola.

Para ver una lista de instantáneas de este volumen creadas manualmente o mediante una política de copias de seguridad, haz clic en la pestaña Instantáneas y copias de seguridad.

Visualización de los detalles del volumen Block Storage for VPC adjunto en los detalles de la instancia

También puede consultar información sobre un volumen de Block Storage for VPC adjunto desde la página de detalles de la instancia del servidor virtual:

1. En la IBM Cloud consola, haga clic en el icono Menú de navegación >Infraestructura >Computación >Instancias de servidor virtual y seleccione una instancia.

2. En Volúmenes de almacenamiento en bloque conectados, pulse el nombre de un volumen para ir a la página de detalles del volumen.

Visualización de todos los volúmenes desde la CLI

Ejecuta el siguiente comando para mostrar información resumida sobre todos los volúmenes:

ibmcloud is volumes [--json]

Si se especifica el ID o el nombre del grupo de recursos, la lista se filtra a los volúmenes que pertenecen a un grupo de recursos. Si omites este argumento, el valor predeterminado es todos los grupos de recursos. También puede ver todos los volúmenes de una zona de disponibilidad determinada. De forma predeterminada, se muestran los primeros 25 volúmenes por página.

En el ejemplo siguiente se muestran todos los volúmenes de todos los grupos de recursos de la zona de disponibilidad.

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

Para obtener más información sobre las opciones de mandato disponibles, consulte ibmcloud is volumes.

Cómo consultar los detalles de un volumen desde la CLI

Ejecute el siguiente comando para mostrar detalles sobre un volumen específico. Puedes utilizar el nombre o ID del volumen para identificarlo.

ibmcloud is volume VOLUME_ID [--json]

Vea el ejemplo siguiente.

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

En el ejemplo, el volumen está adjunto a una instancia de servidor virtual, por lo que los nombres e IDs del volumen adjunto y de la instancia también se muestran en la salida del comando. La propiedad Active es true porque la instancia de servidor virtual a la que se adjunta el volumen está en ejecución. La propiedad Busy con el valor false indica que este volumen no está realizando una operación que deba serializarse.

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

Propiedades CLI adicionales para volúmenes de arranque

Cuando se solicita ver los detalles de los volúmenes de arranque, se devuelven algunas propiedades extra en la respuesta. Consulte el ejemplo siguiente:

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

Las propiedades de uso permitido se heredan de la imagen de origen o instantánea a partir de la cual se creó el volumen de arranque padre. Mediante la CLI o la API, puede anular estos valores al crear una instancia o al actualizar el volumen de arranque. Debe tener el rol IAM is.volume.volume.manage-allowed-use para realizar estas actualizaciones.

Estas propiedades comprenden una expresión booleana de Common Expression Language. Cuando la expresión se evalúa como true, se permite la instancia de servidor virtual o el aprovisionamiento de servidor bare metal con el volumen de arranque o una imagen creada a partir del volumen de arranque. Cuando la expresión se evalúa como false, la provisión se bloquea. Para obtener más información, consulte Adición de expresiones de uso permitido a imágenes personalizadas.

Ver todos los volúmenes con la API

Realice una llamada GET /volumes para obtener la información de resumen correspondiente a todos los volúmenes. Vea el ejemplo siguiente.

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

Una respuesta satisfactoria tiene un aspecto similar al del ejemplo siguiente. En este ejemplo, se muestran tres volúmenes de datos. El segundo de la lista está asociado a una instancia.

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

Visualización de detalles de volumen con la API

Haga una llamada a GET /volumes/{id} para ver los detalles de un volumen. Vea el ejemplo siguiente.

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

Una respuesta correcta proporciona detalles sobre el volumen, incluyendo la capacidad y las IOPS, el estado del volumen y si este está conectado a una instancia.

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

Propiedades API adicionales para volúmenes de arranque

Cuando se solicita ver los detalles de los volúmenes de arranque, se devuelven un par de propiedades extra en la respuesta para las peticiones GET /volumes y GET /volumes/{id}.

• La propiedad active indica si la instancia de servidor virtual a la que está conectado un volumen se está ejecutando o se ha detenido. Cuando esto ocurre active = true, la instancia está en funcionamiento y las operaciones que requieren una instancia en funcionamiento, como la creación de una imagen a partir del volumen de arranque, también funcionan.

• La propiedad busy indica si este volumen está realizando una operación que se debe serializar. Si una operación requiere serialización, la operación fallará a menos que esta propiedad sea false.

• Las expresiones de uso permitido se heredan de la imagen de origen o instantánea a partir de la cual se creó el volumen de arranque principal. Puede actualizar las expresiones de uso permitido sólo en volúmenes de arranque desconectados. Mediante la CLI o la API, puede anular estos valores al crear una instancia o actualizando el volumen de arranque. Debe tener el rol IAM is.volume.volume.manage-allowed-use para realizar estas actualizaciones. Estas propiedades comprenden una expresión booleana de Common Expression Language. Cuando la expresión se evalúa como true, se permite la instancia de servidor virtual o el aprovisionamiento de servidor bare metal con el volumen de arranque o una imagen creada a partir del volumen de arranque. Cuando la expresión se evalúa como false, se bloquea la provisión. Para obtener más información, consulte Adición de expresiones de uso permitido a imágenes personalizadas.

Vea el ejemplo siguiente.

  "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"
  },
  .
  .
  .

Visualización de todos los volúmenes con Terraform

Importe la lista de volúmenes que pertenecen a una cuenta como fuente de datos de sólo lectura. Puede filtrar por nombre de volumen, nombre de zona, estado de adjunto, tipo de cifrado, familia de sistema operativo (aplicable a volúmenes de arranque) o arquitectura de sistema operativo (aplicable a volúmenes de arranque).

data "ibm_is_volumes" "example" {
}

Los atributos que se exportan incluyen el recuento total de volúmenes y la lista de volúmenes. Los atributos anidados incluyen ID de volumen, nombre, fecha de creación, tamaño, IOPS, CRN, etiquetas de acceso y usuario, perfil, tipo y clave de cifrado, estado del ciclo de vida, estado de salud y motivo, sistema operativo y otros atributos.

Para obtener más información, consulte ibm_is_volumes.

Visualización de los detalles del volumen con Terraform

Importa los detalles de un volumen como fuente de datos de sólo lectura. Debe identificar el volumen por ID o nombre.

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

Los atributos que se exportan incluyen el recuento total de volúmenes y la lista de volúmenes. Los atributos anidados incluyen ID de volumen, nombre, fecha de creación, tamaño, IOPS, CRN, etiquetas de acceso y usuario, perfil, tipo y clave de cifrado, estado del ciclo de vida, estado de salud y motivo, sistema operativo y otros atributos.

Para obtener más información, consulte ibm_is_volume.

Propiedades extra de Terraform para volúmenes de arranque

Las expresiones de uso permitido se heredan de la imagen de origen o instantánea a partir de la cual se creó el volumen de arranque principal. Puede actualizar las expresiones de uso permitido sólo en volúmenes de arranque desconectados. Usando Terraform, puedes anular estos valores cuando creas una instancia o actualizando el volumen de arranque. Debe tener el rol IAM is.volume.volume.manage-allowed-use para realizar estas actualizaciones. Estas propiedades comprenden una expresión booleana de Common Expression Language. Cuando la expresión se evalúa como true, se permite la instancia de servidor virtual o el aprovisionamiento de servidor bare metal con el volumen de arranque o una imagen creada a partir del volumen de arranque. Cuando la expresión se evalúa como false, se bloquea la provisión. Para obtener más información, consulte Adición de expresiones de uso permitido a imágenes personalizadas.