Creación de volúmenes de Block Storage for VPC

Crea volúmenes de almacenamiento en bloque de IBM Cloud, ya sea durante el aprovisionamiento de instancias, como volúmenes independientes o mediante la restauración a partir de instantáneas. Configura la capacidad, las IOPS y el cifrado.

Antes de empezar, asegúrese de que ha creado una VPC. Cuando creas un volumen a partir de una instantánea, puedes utilizar una instantánea de tu propia cuenta o de otra cuenta. Si tiene previsto utilizar una instantánea de otra cuenta, asegúrese de que dispone de las autorizaciones de IAM adecuadas.

Los Hyper Protect Crypto Services han quedado obsoletos. Los clientes pueden utilizar las instancias existentes hasta el 20 de marzo de 2027. Para obtener más información, consulta IBM Cloud Hyper Protect Crypto Services: fin de la soporte. Para garantizar una protección continua, plantéate migrar tus claves de cifrado actuales a una instancia dedicada de Key Protect. Para obtener más información, consulta la guía de migración.

CreandoBlock Storage for VPC volúmenes en la consola

Utilice la consola de IBM Cloud para crear un volumen Block Storage for VPC al crear una instancia de servidor virtual o como volumen independiente.

Creación y conexión de un volumen Block Storage for VPC al crear una instancia

  1. En la IBM Cloud consola, haga clic en el icono Menú de navegación icono del menú >Infraestructura icono VPC >Computación >Instancias de servidor virtual.
  2. En la lista de instancias de servidor virtual, pulse Crear.
  3. En la página Servidor virtual para suministro de VPC, seleccione Tipo de servidor, Ubicación, SO, Perfil, Grupo de colocación, etc. Para obtener más información sobre el suministro de la instancia, consulte Creación de una instancia de servidor virtual con la interfaz de usuario.
  4. Los detalles del volumen de arranque que se va a crear se muestran en la página. Puede editar el volumen de arranque haciendo clic en el icono para Icono de edición cambiar la capacidad, especificar el cifrado y añadir etiquetas de usuario para identificar este recurso. Puedes cambiar el perfil a o sdp general-purpose.
  5. Para crear un volumen de datos y adjuntarlo a la instancia, en el Volúmenes de datos sección de la página de aprovisionamiento de instancias, haga clic en Crear. En el panel lateral, especifica los detalles del volumen.
    1. Puedes crear un volumen de datos en blanco o crear un volumen con datos importados de una instantánea. Si selecciona Importar instantánea existente, seleccione una instantánea disponible de la lista. Si selecciona Importar instantánea por CRN, tenga preparado el CRN de la instantánea para introducirlo.
    2. Especifica un nombre único y significativo para tu volumen. Por ejemplo, puede ser un nombre que describa su función de computación o de carga de trabajo. El nombre del volumen debe comenzar con una letra minúscula. El nombre puede tener hasta 63 caracteres alfanuméricos en minúsculas e incluir el guión (-). Los nombres de volumen deben ser exclusivos de su VPC. Puedes editar el nombre más adelante si lo deseas.
    3. La función de eliminación automática está desactivada por defecto. Si desea que el volumen se elimine cuando se elimine la instancia del servidor virtual adjunto, haga clic en el botón para habilitar la función.
    4. El grupo de recursos y la ubicación se heredan de la instancia. Estos valores no se pueden cambiar.
    5. Puede especificar etiquetas de usuario opcionales para asociar con este volumen. Para obtener más información sobre la organización de recursos con etiquetas de usuario, consulte Trabajar con etiquetas.
    6. En la sección Cifrado, el cifrado gestionado por el proveedor está activado de forma predeterminada. Para utilizar su propia clave de cifrado, haga clic en el botón de alternancia para activar el cifrado gestionado por el cliente. Si ya dispone de una instancia de KMS y una clave raíz, el sistema las selecciona automáticamente por usted. Puede hacer clic en el para Icono de edición cambiar a otra clave o instancia. Para localizar su clave de cifrado, seleccione una de las siguientes opciones:
      • Localizar por instancia: El panel consta de tres pasos:
        1. Seleccionar instancia de KMS: La lista muestra el nombre, el ID, el tipo (Estándar o Dedicada) y la ubicación de cada instancia disponible de Key Protect. Selecciona una instancia y haz clic en Seleccionar. Si aún no tienes una instancia, haz clic en Crear para aprovisionar una.
        2. Clave asociada: La lista muestra el nombre, el ID, la fecha de la última actualización, los alias y el llavero de cada clave raíz disponible. Selecciona una clave y haz clic en Seleccionar. Si aún no tienes una clave, haz clic en Crear nueva clave.
        3. Revisión: Confirma tus selecciones, incluyendo el servicio de gestión de claves, el tipo de instancia, el nombre de la instancia y el nombre de la clave. La sección Autorización del servicio muestra si ya existe la autorización necesaria entre Block Storage for VPC y la instancia de KMS. Si no es así, puede permitir que Key Protect cree la autorización automáticamente, o bien crearla manualmente. Para obtener más información, consulta Establecimiento de autorizaciones de servicio a servicio para Block Storage for VPC. Haga clic en Confirmar para aplicar su selección y volver a la configuración del volumen.
      • Localizar por CRN: Introduzca el CRN de la clave raíz del cliente que se utilizará para cifrar el volumen. Selecciona esta opción si estás utilizando el CRK de otra cuenta. Haga clic en Seleccionar para pasar al paso Revisar descrito en la opción Buscar por instancia.
    7. Seleccione el perfil de almacenamiento. Si eliges importar datos de una instantánea, el valor de generación de almacenamiento de la instantánea debe coincidir con el valor de generación de almacenamiento del perfil de volumen seleccionado.
      • Puede seleccionar el perfil sdp cuando desee especificar una capacidad de volumen de almacenamiento de hasta 32.000 GB, con límites personalizados de IOPS y rendimiento.
      • Cuando quieras utilizar un volumen de primera generación con niveles de IOPS predefinidos, puedes seleccionar uno de los perfiles por niveles. Si _seleccionas _5iops-tier o 10iops-tier todo lo que necesita especificar es la capacidad de volumen.
      • Cuando los requisitos de rendimiento de su aplicación no entran dentro de ninguno de los niveles de IOPS, puede elegir el perfil personalizado. Especifica el tamaño de tu volumen y las IOPS en el rango apropiado para la capacidad del volumen. El tamaño del volumen puede oscilar entre 10 y 16 000 GB. A medida que escribe el valor de IOPS, la interfaz de usuario muestra el rango aceptable. También puedes hacer clic en el enlace de tamaño de almacenamiento para ver el tamaño y los rangos de IOPS del perfil de volumen personalizado.
    8. Puede aplicar una política de copia de seguridad al crear el volumen. Haga clic en Aplicar y, a continuación, seleccione una política existente en la lista desplegable del panel lateral. Seleccione las etiquetas que desea aplicar al destino y haga clic en Aplicar política y etiquetas.
    9. Pulse Guardar.
  6. Regresará a la página de aprovisionamiento de instancia virtual para terminar de definir los atributos restantes de su instancia de servidor virtual.
  7. Cuando esté satisfecho con sus opciones, haga clic en Crear servidor virtual.

Un volumen de Block Storage for VPC solo se puede asociar a un servidor virtual a la vez. En la página de resumen del volumen de Block Storage for VPC, puede consultar los detalles de la instancia de servidor virtual seleccionando el nombre de la instancia en Instancias conectadas.

Creación y conexión de un volumen Block Storage for VPC a partir de una instancia existente

Puede crear un volumen Block Storage for VPC a partir de una instancia existente.

  1. Ir a la lista de instancias de servidores virtuales. En la IBM Cloud consola, haga clic en el icono Menú de navegación icono del menú >Infraestructura icono VPC >Computación >Instancias de servidor virtual.
  2. Seleccione una instancia de la lista.
  3. En la página de detalles de la instancia, haga clic en la pestaña Almacenamiento.
  4. En la lista de volúmenes de almacenamiento adjuntos, haga clic en Adjuntar.
  5. En el panel lateral, pulse la flecha abajo bajo Volúmenes de bloque y seleccione Crear un volumen de datos. El panel lateral se expande con campos para definir el volumen.
    1. Si ha creado anteriormente instantáneas de volumen, la opción para importar una pasa a estar disponible. Haga clic en el conmutador para Importar desde instantánea, y seleccione una instantánea de la lista o localice la instantánea por su CRN.
    2. Especifica un nombre único y significativo para tu volumen. Por ejemplo, puede ser un nombre que describa su función de computación o de carga de trabajo. El nombre del volumen debe comenzar con una letra minúscula. El nombre puede tener hasta 63 caracteres alfanuméricos en minúsculas e incluir el guión (-). Los nombres de volumen deben ser exclusivos de su VPC. Puedes editar el nombre más adelante si lo deseas.
    3. La función de eliminación automática está desactivada por defecto. Si desea que el volumen se elimine cuando se elimine la instancia del servidor virtual adjunto, haga clic en el botón para habilitar la función.
    4. El grupo de recursos y la ubicación se heredan de la instancia. Estos valores no se pueden cambiar.
    5. Puede especificar etiquetas de usuario opcionales para asociar con este volumen. Para obtener más información sobre la organización de recursos con etiquetas de usuario, consulte Trabajar con etiquetas.
    6. En la sección Cifrado, el cifrado gestionado por el proveedor está activado de forma predeterminada. Para utilizar su propia clave de cifrado, haga clic en el botón de alternancia para activar el cifrado gestionado por el cliente. Si ya dispone de una instancia de KMS y una clave raíz, el sistema las selecciona automáticamente por usted. Puede hacer clic en el para Icono de edición cambiar a otra clave o instancia. Para localizar su clave de cifrado, seleccione una de las siguientes opciones:
      • Localizar por instancia: El panel consta de tres pasos:
        1. Seleccionar instancia de KMS: La lista muestra el nombre, el ID, el tipo (Estándar o Dedicada) y la ubicación de cada instancia disponible de Key Protect. Selecciona una instancia y haz clic en Seleccionar. Si aún no tienes una instancia, haz clic en Crear para aprovisionar una.
        2. Clave asociada: La lista muestra el nombre, el ID, la fecha de la última actualización, los alias y el llavero de cada clave raíz disponible. Selecciona una clave y haz clic en Seleccionar. Si aún no tienes una clave, haz clic en Crear nueva clave.
        3. Revisión: Confirma tus selecciones, incluyendo el servicio de gestión de claves, el tipo de instancia, el nombre de la instancia y el nombre de la clave. La sección Autorización del servicio muestra si ya existe la autorización necesaria entre Block Storage for VPC y la instancia de KMS. Si no es así, puede permitir que Key Protect cree la autorización automáticamente, o bien crearla manualmente. Para obtener más información, consulta Establecimiento de autorizaciones de servicio a servicio para Block Storage for VPC. Haga clic en Confirmar para aplicar su selección y volver a la configuración del volumen.
      • Localizar por CRN: Introduzca el CRN de la clave raíz del cliente que se utilizará para cifrar el volumen. Selecciona esta opción si estás utilizando el CRK de otra cuenta. Haga clic en Seleccionar para pasar al paso Revisar descrito en la opción Buscar por instancia.
    7. Pulse Siguiente.
    8. Seleccione el perfil de almacenamiento. Si eliges importar datos de una instantánea, el valor de generación de almacenamiento de la instantánea debe coincidir con el valor de generación de almacenamiento del perfil de volumen seleccionado.
      • Puede seleccionar el perfil sdp. A continuación, especifica la capacidad de tu volumen, el límite de ancho de banda necesario y las IOPS requeridas. El tamaño del volumen puede oscilar entre 1 y 32.000 GB. Puede especificar IOPS en el rango de 100 - 64.000. El límite de rendimiento es de 1000-8192 Mbps.
      • Puede seleccionar uno de los perfiles escalonados. Después de seleccionar propósito general, 5iops-tier o 10iops-tier, el siguiente paso es especificar la capacidad del volumen. El tamaño del volumen puede oscilar entre 10 y 16 000 GB.
      • Puedes seleccionar el perfil personalizado si los requisitos de rendimiento de tu aplicación no entran dentro de ninguno de los niveles de IOPS. A continuación, especifica el tamaño de tu volumen y las IOPS en el rango apropiado para la capacidad del volumen. El tamaño del volumen puede oscilar entre 10 y 16 000 GB. A medida que escribe el valor de IOPS, la interfaz de usuario muestra el rango aceptable. También puedes hacer clic en el enlace de tamaño de almacenamiento para ver el tamaño y los rangos de IOPS del perfil de volumen personalizado.
    9. Pulse Guardar.
  6. Cuando haya terminado de definir el volumen, pulse Guardar. El volumen se crea y se asigna a la instancia. Volverá a la página de detalles de la instancia. El nuevo volumen aparece en la lista de volúmenes de almacenamiento.

Creación de un volumen Block Storage for VPC autónomo

Puedes crear un volumen Block Storage for VPC independiente del aprovisionamiento del servidor virtual y asociarlo a una instancia más adelante.

  1. En la IBM Cloud consola, haga clic en el icono Menú de navegación icono del menú >Infraestructura icono VPC >Almacenamiento > Block Storage.

  2. Pulse Crear.

  3. Sobre elBlock Storage for VPC página de aprovisionamiento, revise la Ubicación información. La geografía, la región y la zona se heredan del VPC (por ejemplo, Norteamérica, Dallas,Dallas-1 ). Puede seleccionar una zona diferente en su ubicación desde el menú haciendo clic en el Editar iconoEditar icono.

  4. En el Detalles sección, debe especificar el nombre del volumen y el grupo de recursos al que se agregará el volumen. Opcionalmente, puede añadir etiquetas de gestión de usuarios y acceso.

    1. Especifique un nombre significativo para el volumen. Por ejemplo, especifique un nombre que describa la función de cálculo o de carga de trabajo.

      El nombre del volumen debe comenzar con una letra minúscula. El nombre del volumen puede tener hasta 63 caracteres alfanuméricos en minúscula e incluir el guión (-). Los nombres de los volúmenes deben ser únicos en toda la infraestructura de VPC. Puedes editar el nombre más adelante.

    2. Especifique un grupo de recursos.

    3. Especifique etiquetas de usuario para organizar los recursos y para que los utilicen las políticas de copia de seguridad.

    4. Especifique las etiquetas de gestión de acceso que se han creado en IAM para ayudarle a gestionar el acceso a los volúmenes.

  5. En el Configuraciones opcionales En la sección, puede especificar si desea crear el volumen con datos de una instantánea. Para más información, ver Crear un independienteBlock Storage for VPC volumen de una instantánea. Además, puede optar por aplicar una política de respaldo. Haz clic en Aplicar para ver las pólizas y los planes disponibles.

  6. En la sección Perfil, puedes especificar el perfil de rendimiento de tu volumen, sus límites de rendimiento y capacidad. Si eliges importar datos de una instantánea, el valor de generación de almacenamiento de la instantánea debe coincidir con el valor de generación de almacenamiento del perfil de volumen seleccionado.

    • Puede seleccionar el perfil sdp. A continuación, especifica la capacidad de tu volumen, el límite de rendimiento solicitado y las IOPS requeridas. El tamaño del volumen puede oscilar entre 1 y 32.000 GB. Puede especificar IOPS en el rango de 100 - 64.000. El límite de rendimiento es de 1000-8192 Mbps.
    • Puede seleccionar uno de los perfiles escalonados. Después de seleccionar propósito general, 5iops-tier o 10iops-tier, el siguiente paso es especificar la capacidad del volumen. El tamaño del volumen puede oscilar entre 10 y 16 000 GB.
    • Puedes seleccionar el perfil personalizado si los requisitos de rendimiento de tu aplicación no entran dentro de ninguno de los niveles de IOPS. A continuación, especifica el tamaño de tu volumen y las IOPS en el rango apropiado para la capacidad del volumen. A medida que escribe el valor de IOPS, la interfaz de usuario muestra el rango aceptable. También puedes hacer clic en el enlace de tamaño de almacenamiento para ver el tamaño y los rangos de IOPS del perfil de volumen personalizado.
  7. En la sección Cifrado en reposo, puede optar por mantener el cifrado con claves gestionadas por IBM, que está habilitado de forma predeterminada en todos los volúmenes. O bien, puede optar por utilizar su propia clave de cifrado. Para cambiar la clave o la instancia, haz clic en el icono Editar para abrir el panel lateral Configurar cifrado. Selecciona una de las siguientes opciones para localizar tu clave de cifrado:

    • Localizar por instancia: El panel consta de tres pasos:
      1. Seleccionar instancia de KMS: La lista muestra el nombre, el ID, el tipo (Estándar o Dedicada) y la ubicación de cada instancia disponible de Key Protect. Selecciona una instancia y haz clic en Seleccionar. Si aún no tienes una instancia, haz clic en Crear para aprovisionar una.
      2. Clave asociada: La lista muestra el nombre, el ID, la fecha de la última actualización, los alias y el llavero de cada clave raíz disponible. Selecciona una clave y haz clic en Seleccionar. Si aún no tienes una clave, haz clic en Crear nueva clave.
      3. Revisión: Confirma tus selecciones, incluyendo el servicio de gestión de claves, el tipo de instancia, el nombre de la instancia y el nombre de la clave. La sección Autorización del servicio muestra si ya existe la autorización necesaria entre Block Storage for VPC y la instancia de KMS. Si no es así, puede permitir que Key Protect cree la autorización automáticamente, o bien crearla manualmente. Para obtener más información, consulta Establecimiento de autorizaciones de servicio a servicio para Block Storage for VPC. Haga clic en Confirmar para aplicar su selección y volver a la página de aprovisionamiento de volúmenes.
    • Localizar por CRN: Introduzca el CRN de la clave raíz del cliente que se utilizará para cifrar el volumen. Selecciona esta opción si estás utilizando el CRK de otra cuenta. Haga clic en Seleccionar para pasar al paso Revisar descrito en la opción Buscar por instancia.

    Si seleccionaste una instantánea de segunda generación para crear el volumen, el tipo de cifrado de tu volumen debe coincidir con el tipo de cifrado de la instantánea. Si la instantánea tiene claves gestionadas por el proveedor, no especifique una clave de un servicio de gestión de claves.

  8. Cuando hayas terminado, haz clic Crear volumen de almacenamiento en bloque.

    • Si usted no está listo para pedir todavía o simplemente buscando información de precios, puede añadir la información que se ve en el panel lateral a una estimación. Para obtener más información sobre cómo funciona esta característica, consulte Estimando sus costos.
  9. Volverás a la página de volúmenes de Block Storage for VPC, donde aparecerá un mensaje que indica que se está creando el volumen (el estado del volumen es pendiente ). Aparece un segundo mensaje cuando se crea el volumen (el estado del volumen es disponible ).

  10. Para ver los detalles del nuevo volumen, seleccione el enlace Ver recurso en el segundo mensaje para ir a la página Detalles de volumen.

Al actualizar la lista de volúmenes de Block Storage en la consola, el nuevo volumen aparece al principio de la lista de volúmenes. En el caso de los volúmenes independientes, la columna Tipo de conexión aparece en blanco (-). El de acciones situado al final de una fila de la tabla proporciona un enlace para conectar un volumen de Block Storage a una instancia.

Creando un independienteBlock Storage for VPC volumen de una instantánea en la consola

Cuando crea un volumen Block Storage for VPC, puede seleccionar una instantánea y utilizar sus datos para crear el nuevo volumen. Las instantáneas que se presentan están en un estado estable. El volumen de datos que se crea a partir de la instantánea no está conectado a una instancia y aparece en la lista de Block Storage for VPC. Más adelante, puede adjuntar el volumen a una instancia.

Puede restaurar un volumen de arranque a partir de una instantánea "arrancable". El volumen de arranque se restaura al crear una instancia de servidor virtual.

  1. En la IBM Cloud consola, haga clic en el icono Menú de navegación icono del menú >Infraestructura icono VPC >Almacenamiento > Block Storage.
  2. Seleccione Crear.
  3. Especifique la ubicación del volumen, el nombre del volumen, el grupo de recursos opcional y las etiquetas.
  4. En el Configuraciones opcionales sección, haga clic Importar desde instantánea. Selecciona una de las siguientes opciones
    • Haga clic en Importar instantánea existente para ver la lista de instantáneas disponibles. Todas las instantáneas que se presentan están en estado estable. De forma predeterminada, se selecciona la pestaña No arrancable que enumera todas las instantáneas de volumen de datos. Para restaurar un volumen de arranque, haz clic en la pestaña Boteable. Adjuntar volumen a nueva instancia de servidor virtual está seleccionada por defecto. El volumen de arranque se restaura cuando se crea la instancia.
    • Haga clic en Importar instantánea por CRN e indique el CRN de la instantánea que desea utilizar.
  5. Pulse Guardar. La información sobre la instantánea se muestra en la página de suministro de volúmenes, incluyendo el nombre, su tamaño, la fecha en que se creó, su volumen de origen y si se trata de una instantánea arrancable. La información de instantánea arrancable incluye el sistema operativo y la imagen. El cifrado se hereda de la instantánea y se muestra en la sección de cifrado.
  6. Haz clic en Crear volumen de almacenamiento en bloque.

Los perfiles de volumen de primera y segunda generación no son intercambiables. Puedes utilizar una instantánea de un volumen de segunda generación para crear otro volumen de segunda generación, pero no puedes cambiar el perfil de volumen a un perfil de volumen de primera generación. Del mismo modo, puedes utilizar una instantánea de un volumen de primera generación para crear otro volumen de primera generación con los mismos datos, y no puedes cambiar el nuevo volumen al perfil sdp.

Al actualizar la página de volúmenes de Block Storage for VPC, el nuevo volumen aparece al principio de la lista de volúmenes. Si el volumen se ha creado correctamente, muestra el estado Disponible. Para volúmenes autónomos, la columna Tipo de conexión está en blanco (-). El menú Acciones icono Acciones al final de una fila de tabla proporciona un enlace para adjuntar un volumen Block Storage for VPC a una instancia.

Creación de volúmenes Block Storage for VPC desde la CLI

Puede crear volúmenes de Block Storage for VPC mediante la interfaz de línea de mandatos (CLI).

Antes de empezar

Para poder utilizar la CLI, debe instalar la CLI de IBM Cloud y el plugin de la CLI de VPC. Para obtener más información, consulte los Requisitos previos de la CLI.

  1. Inicie la sesión en IBM Cloud.
    ibmcloud login --sso -a cloud.ibm.com
    
    Este mandato devuelve un URL y solicita un código de acceso. Vaya a ese URL en el navegador e inicie la sesión. Si se ejecuta correctamente, recibe un código de acceso de un solo uso. Copie este código de acceso y péguelo como respuesta en la solicitud. Después de una autenticación correcta, se le solicitará que elija su cuenta. Si tiene acceso a varias cuentas, seleccione la cuenta con la que desea iniciar sesión. Responda a cualquier solicitud restante para finalizar el inicio de sesión.

Creación de un volumen Block Storage for VPC desde la CLI

Ejecuta el siguiente comando para crear un volumen de Block Storage for VPC. Especifique el nombre del volumen, el nombre del perfil y el nombre de la zona de disponibilidad en su región. Para obtener más información sobre los perfiles Block Storage for VPC, consulte Perfiles. Las opciones adicionales se muestran entre corchetes.

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 se crean dos volúmenes con el mismo nombre en la misma cuenta y región, se produce un error volume name duplicate.

ibmcloud is volume-create VOLUME_NAME PROFILE_NAME ZONE_NAME [--capacity CAPACITY] [--iops IOPS] [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME] [--tags  TAG_NAME1,TAG_NAME2,...] [--json]

Vea el ejemplo siguiente.

ibmcloud is volume-create demovolume1 custom us-east-1 --capacity 500 --iops 3000 --tags env:test,env:prod
Creating volume demovolume1 in resource group Default under account Test Account as user test.user@ibm.com...
ID                                     r014-e45f9c8c-4655-4a3e-9d90-70c2d64d1746
Name                                   demovolume1
CRN                                    crn:v1:bluemix:public:is:us-east-1:a/a1234567::volume:r014-e45f9c8c-4655-4a3e-9d90-70c2d64d1746
Status                                 pending
Attachment state                       unattached
Capacity                               500
IOPS                                   3000
Bandwidth(Mbps)                        6291
Profile                                custom
Encryption key                         -
Encryption                             provider_managed
Resource group                         defaults
Created                                2023-07-24T16:20:52+00:00
Zone                                   us-east-1
Health State                           inapplicable
Volume Attachment Instance Reference   -
Active                                 false
Busy                                   false
Tags                                   env:test,env:prod
Storage Generation                     1

La capacidad, expresada en megabytes, puede oscilar entre 10 y 16 000 GB. Si no se especifica, la capacidad predeterminada es 100 GB. Los valores de IOPS pueden situarse en el rango entre 100 y 48.000 IOPS, en función del tamaño del perfil y del volumen. Si no se especifica, el valor de IOPS toma como valor predeterminado la configuración válida por perfil de volumen. Para obtener más información, consulte la tabla de IOPS personalizados.

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 en toda la infraestructura de VPC.

Anote el ID de volumen. Debes especificar el ID al asociar Block Storage for VPC a una instancia de servidor virtual, al consultar Block Storage for VPC los detalles de un volumen o al eliminar volúmenes.

El estado de salud del volumen muestra inapplicable mientras que el estado del volumen es pending. Después de crear el volumen, el estado de salud muestra OK, a menos que la creación haya fallado. Para obtener más información, consulte Block Storage for VPC estados de salud del volumen.

Se añaden etiquetas de usuario para identificar el recurso de volumen. Cuando estas etiquetas coinciden con las etiquetas de una política de copia de seguridad, se realiza una copia de seguridad del volumen de acuerdo con la planificación del plan de copia de seguridad. Puede obtener información adicional consultando Creación de una política de seguridad.

Para crear un volumen independiente, ejecute el comando ibmcloud is volume-create y especifique el perfil sdp, el tamaño y los requisitos de rendimiento del volumen. El siguiente ejemplo crea un volumen de datos en la región us-east con 200 MB de capacidad y 100 IOPS.

ibmcloud is volume-create defined-performance-vol sdp us-east-3 --capacity 200 --iops 3000 --bandwidth 2000
Creating volume defined-performance-vol under account Test Account as user test.user@ibm.com...
ID                                     r014-9b41d061-d00c-4571-92c0-f592b91f5cd0
Name                                   defined-performance-vol
CRN                                    crn:v1:bluemix:public:is:us-east-3:a/a1234567::volume:r014-9b41d061-d00c-4571-92c0-f592b91f5cd0
Status                                 pending
Attachment state                       unattached
Capacity                               200
IOPS                                   3000
Bandwidth(Mbps)                        2000
Profile                                sdp
Encryption key                         -
Encryption                             provider_managed
Resource group                         Default
Created                                2025-03-25T09:59:26+05:30
Zone                                   us-east-3
Health State                           inapplicable
Volume Attachment Instance Reference   -
Active                                 false
Adjustable IOPS                        true
Busy                                   false
Tags                                   -
Storage Generation                     2

Creación de un volumen Block Storage for VPC autónomo con cifrado gestionado por el cliente desde la CLI

Para crear un volumen de Block Storage con cifrado gestionado por el cliente desde la CLI, utilice el comando ibmcloud is volume-create con la opción --encryption-key. La opción encryption_key requiere un CRN válido para la clave raíz en el servicio de gestión de claves.

ibmcloud is volume-create VOLUME_NAME PROFILE_NAME ZONE_NAME [--encryption-key ENCRYPTION_KEY] [--capacity CAPACITY] [--iops IOPS] [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME] [--output JSON]

El ejemplo siguiente muestra un volumen con IOPS personalizado y capacidad que se crea con cifrado gestionado por el cliente.

ibmcloud is volume-create demo-cli-volume custom us-east-1 --capacity 300 --iops 1500 --encryption-key crn:v1:bluemix:public:kms:us-east:a/a1234567:3b05b403-8f51-4dac-9114-c777d0a760d4:key:7a8a2761-08e3-455f-a348-144ed604bba9
Creating volume demo-cli-volume under account Test Account as user test.user@ibm.com...
ID                                     r014-3984600c-6f4d-4940-82de-519a867fa3c0
Name                                   demo-cli-volume
CRN                                    crn:v1:bluemix:public:is:us-east-1:a/a1234567::volume:r014-3984600c-6f4d-4940-82de-519a867fa3c0
Status                                 pending
Attachment state                       unattached
Capacity                               300
IOPS                                   1500
Bandwidth(Mbps)                        3145
Profile                                custom
Encryption key                         crn:v1:bluemix:public:kms:us-east:a/a1234567:3b05b403-8f51-4dac-9114-c777d0a760d4:key:7a8a2761-08e3-455f-a348-144ed604bba9
Encryption                             user_managed
Resource group                         defaults
Created                                2023-06-29T20:10:52+00:00
Zone                                   us-east-1
Health State                           inapplicable
Volume Attachment Instance Reference   -
Active                                 false
Busy                                   false
Tags                                   -
Storage Generation                     1

Creación de un volumen Block Storage for VPC autónomo a partir de una instantánea desde la CLI

Ejecuta el comando ' ibmcloud is volume-create ' y especifica la opción ' --snapshot ' con el nombre, ID o CRN de la instantánea que estás utilizando para crear el nuevo volumen. El volumen está desconectado, tal como indica el estado de conexión en la respuesta.

Este ejemplo crea el nuevo volumen a partir de una instantánea especificada por nombre.

ibmcloud is volume-create volume-4 general-purpose us-south-1 --snapshot r006-4602b3de-3885-4b49-8d46-65aacb72a1d6
Creating volume volume-4 under account Test Account as user test.user@ibm.com...
ID                                     r014-dee9736d-08ee-4992-ba8d-3b64a4f0baac
Name                                   volume-4
CRN                                    crn:v1:bluemix:public:is:us-east-1:a/a1234567::volume:r014-dee9736d-08ee-4992-ba8d-3b64a4f0baac
Status                                 pending
Attachment state                       unattached
Capacity                               100
IOPS                                   3000
Bandwidth(Mbps)                        393
Profile                                general-purpose
Encryption key                         -
Encryption                             provider_managed
Resource group                         defaults
Created                                2023-06-29T16:14:59+00:00
Zone                                   us-east-1
Health State                           inapplicable
Volume Attachment Instance Reference   -
Active                                 false
Busy                                   false
Tags                                   -
Storage Generation                     1

Para obtener más información, consulte ibmcloud is volume-create en la referencia de CLI.

Los perfiles de volumen de primera y segunda generación no son intercambiables. Puedes utilizar una instantánea de un volumen de segunda generación para crear otro volumen de segunda generación, pero no puedes cambiar el perfil de volumen a un perfil de volumen de primera generación. Del mismo modo, puedes utilizar una instantánea de un volumen de primera generación para crear otro volumen de primera generación con los mismos datos, y no puedes cambiar el nuevo volumen al perfil sdp.

Creación de un volumen de datos como conexión a una instancia de servidor virtual existente

Puede utilizar el mandato instance-volume-attachment-add para crear un volumen y conectarlo a una instancia. El ejemplo siguiente crea un volumen con el perfil custom, 100 GB de capacidad y 100 IOPS.

ibmcloud is instance-volume-attachment-add acd-vol-attach1 my-instance-1 --profile custom --new-volume-name acd-vol-2 --iops 100 --capacity 100
Creating volume attachment acd-vol-attach1 for instance my-instance-1 under account Test Account as user test.user@ibm.com...
ID                730f-5f63eb4d-2683-4dd6-a20a-5ab06b4061c6
Name              acd-vol-attach1
Volume            -
Status            attaching
Bandwidth(Mbps)   14
Type              data
Device            -
Auto delete       false
Created           2023-05-05T07:42:33+05:30

Para obtener más información, consulte ibmcloud is instance-volume-attachment-add en la referencia de CLI.

Creación de una instancia con volúmenes sdp desde la CLI

Para crear una instancia de servidor virtual, ejecute el comando ibmcloud is instance-create y especifique los detalles de su instancia y los detalles de los volúmenes que desea adjuntar. El siguiente ejemplo crea una instancia de servidor virtual con un volumen de arranque sdp y también adjunta un volumen de datos sdp.

ibmcloud is instance-create my-defined-performance-instance test-vpc us-east-3 bx2-2x8 csi-subnet-cidr-3b6k-storage-v5lvug8w-380sal --boot-volume '{"name": "boot-vol-attachment-name-instance-1", "volume": {"name": "boot-vol-name-1", "profile": {"name": "sdp"},"user_tags": ["env:test4", "env:dev4"]}}' --volume-attach '[{"volume": {"capacity": 1000,"iops": 32000,"bandwidth": 3000,"name": "my-data-volume-1","profile": {"name": "sdp"}}}]' --image r006-5f183c60-78a0-4d6e-9be5-84335939255a
Creating instance my-defined-performance instance under account Test Account as user test.user@ibm.com...
ID                                    730f_59883a41-c943-423c-a6ab-e2b066f2f314
Name                                  my-defined-performance-instance
CRN                                   crn:v1:bluemix:public:is:us-east-3:a/a1234567::instance:730f_59883a41-c943-423c-a6ab-e2b066f2f314
Status                                pending
Availability policy on host failure   restart
Startable                             true
Profile                               bx2-2x8
Architecture                          amd64
vCPU Manufacturer                     intel
vCPUs                                 2
Memory(GiB)                           8
Bandwidth(Mbps)                       4000
Volume bandwidth(Mbps)                1000
Network bandwidth(Mbps)               3000
Lifecycle Reasons                     Code   Message
                                      -      -
Lifecycle State                       pending
Metadata service                      Enabled   Protocol   Response hop limit
                                      false     http       1
Image                                 ID                                          Name
                                      r006-5f183c60-78a0-4d6e-9be5-84335939255a   embolism-lapped-overjoyed-bagel-elated
VPC                                   ID                                          Name
                                      r006-be9d04ab-d10c-4be7-9de6-95cd2208d1de   test-vpc-do-not-delete-default
Zone                                  us-east-3
Resource group                        ID                                 Name
                                      85cbbee12af748eabb6513cf311d4e2d   Default
Created                               2024-09-24T02:01:10+05:30
Boot volume                           ID   Name   Attachment ID                               Attachment name
                                      -    -      730f-e4d7ce78-011e-4dd1-8752-3ceb12bce79f   boot-vol-attachment-name-instance-1
Data volumes                          ID   Name   Attachment ID                               Attachment name
                                      -    -      730f-78f2db0a-57df-4b5f-9f1e-f800e91e89af   upscale-embargo-oops-overeager

Para obtener más información, consulte ibmcloud is instance-create en la referencia CLI.

Creación de una instancia y adición de etiquetas de usuario a volúmenes desde la CLI

Puede especificar etiquetas de usuario para los volúmenes de arranque y de datos al crear una instancia de servidor virtual. Ejecute el mandato instance-create y especifique las etiquetas de usuario en la opción user_tags. También puede editar las etiquetas más adelante o añadir más etiquetas al volumen especificado. Para obtener más información, consulta la referencia de la CLI de VPC.

En el mandato de ejemplo,

  • El volumen de arranque se define mediante la opción --boot-volume que especifica las etiquetas de usuario env:test4 y env:dev4.
  • La conexión de volumen de datos se define mediante la opción --volume-attach y especifica los mismos códigos de usuario.

Puede ver las etiquetas de usuario cuando consulte los detalles del volumen de arranque o de datos después de crear la instancia.

ibmcloud is instance-create my-vsi-4 my-vpc-2 us-south-1 bx2-2x8 cli-subnet-1 --image ibm-centos-7-9-minimal-amd64-6 --keys my-keys4 --boot-volume '{"name": "boot-vol-4", "volume": {"name": "my-boot-vol-4", "profile": {"name": "general-purpose"},"user_tags": ["env:test4", "env:dev4"]}}' --volume-attach  '[{"name": "my-vol-att1", "volume": {"name":"my-vol-4", "profile": {"name": "general-purpose"}, "capacity": 10,"user_tags": ["env:test4", "env:dev4"]}}]'
Creating instance my-vsi-4 under account vpcdemo1 as user myuser@mycompany.com...
ID                                    efd06503-f514-4ea2-ba6c-2b9c715e6269
Name                                  my-vsi-4
CRN                                   crn:v1:bluemix:public:is:us-south-1:a/a1234567::instance:efd06503-f514-4ea2-ba6c-2b9c715e6269
Status                                pending
Availability policy on host failure   restart
Startable                             true
Profile                               bx2-2x8
Architecture                          amd64
vCPUs                                 2
Memory(GiB)                           8
Bandwidth(Mbps)                       4000
Volume bandwidth(Mbps)                1000
Network bandwidth(Mbps)               3000
Metadata service                      Enabled
                                      false
Image                                 ID                                          Name
                                      r006-c5471ef3-15f5-4468-964b-f9b4d3ca8120   ibm-centos-7-9-minimal-amd64-6
VPC                                   ID                                          Name
                                      r006-dd1c6831-cc4d-4c40-aab2-6b0c17f41424   my-vpc-2
Zone                                  us-south-1
Resource group                        ID                                 Name
                                      bdd96715c2a44f2bb60df4ff14a543f5   Default
Created                               2022-08-09T09:25:06+05:30
Boot volume                           ID   Name   Attachment ID                               Attachment name
                                      -    -      r006-1bcf5342-c12f-4908-ad0f-99218cd603b9   boot-vol-4
Data volumes                          ID   Name   Attachment ID                               Attachment name
                                      -    -      r006-c034f0f9-2269-44e4-a76a-4f4ad8c47b65   my-vol-att1

Creación de una plantilla de instancia y adición de etiquetas de usuario a volúmenes desde la CLI

Puede especificar etiquetas de usuario para los volúmenes de arranque y de datos al crear una instancia. Ejecute el mandato instance-template-create y especifique las etiquetas de usuario en el parámetro user_tags.

En el ejemplo siguiente, el mandato añade dos etiquetas de usuario a la plantilla de instancia que se van a aplicar a los volúmenes.

ibmcloud is instance-template-create my-tpl-1 my-vpc-2 us-south-1 bx2-2x8 cli-subnet-1 --image ibm-centos-7-9-minimal-amd64-6 --keys my-keys4 --boot-volume '{"name": "boot-vol-1", "volume": {"name": "my-boot-vol-1", "profile": {"name": "general-purpose"},"user_tags": ["env:test1", "env:dev1"]}}' --volume-attach  '[{"name": "my-vol-att", "volume": {"name":"my-vol-1", "profile": {"name": "general-purpose"}, "capacity": 10,"user_tags": ["env:test1", "env:dev1"] }}]'
Creating instance template my-tpl-1 under account vpcdemo as user myuser@mycompany.com...
ID                          38ef87e9-3a4d-4d72-8450-86c16b76ae0d
Name                        my-tpl-1
CRN                         crn:v1:bluemix:public:is:us-south-1:a/a1234567::instance-template:38ef87e9-3a4d-4d72-8450-86c16b76ae0d
Resource group              Default
Image                       c5471ef3-15f5-4468-964b-f9b4d3ca8120
VPC                         dd1c6831-cc4d-4c40-aab2-6b0c17f41424
Zone                        us-south-1
Profile                     bx2-2x8
Metadata service            Enabled
                            false
Keys                        Key IDs
                            e7d18039-0e0e-4207-8598-de7cca949030
Boot volume                 Name            Capacity   Profile           IOPS   Attachment name   Auto delete   Tags
                            my-boot-vol-1   100        general-purpose   0      boot-vol-1     true          env:test1,env:dev1
Data volumes                ID   Name       Capacity   Profile           IOPS   Attachment name   Auto delete   Tags
                            -    my-vol-1   10         general-purpose   0      my-vol-att        false         env:test1,env:dev1
Primary Network Interface   Name      Subnet ID                                   Security Groups                             Allow source IP spoofing   Reserved IP Address   Reserved IP ID   Reserved IP Name   Reserved IP Auto Delete
                            primary   0617-c1f1e468-3283-4f44-9d08-3d57b77817f1   7c2db5ac-19e0-4d83-8226-e6178fedfe56   false                      -                     -                -                  -
Created                     2022-08-22T09:10:34+05:30

Puede utilizar la plantilla de instancia para crear una instancia y volúmenes con etiquetas de usuario. Vea el ejemplo siguiente.

ibmcloud is instance-template-create --template my-tpl-1 --name my-vsi-3 --boot-volume '{"name": "boot-vol-3", "volume": {"name": "my-boot-vol-3", "profile": {"name": "general-purpose"},"user_tags": ["env:test3", "env:dev3"]}}' --volume-attach  '[{"name": "my-vol-att1", "volume": {"name":"my-vol-3", "profile": {"name": "general-purpose"}, "capacity": 10,"user_tags": ["env:test3", "env:dev3"] }}]'

Creación de volúmenes Block Storage for VPC con la API

Puede crear Block Storage for VPC volúmenes llamando directamente a las API REST de VPC. Para obtener más información sobre el API de VPC de comparticiones de archivos, consulte la referencia del API de VPC.

Antes de empezar

Defina variables correspondientes a señal de IAM, punto final de API y versión de API. Para obtener instrucciones, consulte Configuración del entorno de API y de CLI.

Creación de un volumen de datos como parte del aprovisionamiento de una instancia mediante la API

Realice una solicitud de POST /instances para crear una instancia y defina el volumen utilizando el parámetro volume_attachments. Especifique un nombre de volumen, la capacidad y el perfil.

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 se crean dos volúmenes con el mismo nombre en la misma cuenta y región, se produce un error volume name duplicate.

Este ejemplo especifica el cifrado gestionado por el cliente y las etiquetas de usuario para los volúmenes de arranque y de datos.

curl -X POST "$vpc_api_endpoint/v1/instances?version=2022-06-14&generation=2" -H "Authorization: Bearer $iam_token" -d '{
  "boot_volume_attachment": {
    "volume": {
      "encryption_key": {"crn": "crn:[...]"},
      "name": "my-boot-volume",
      "profile": {"name": "general-purpose"},
      "storage_generation": 1,
      "user_tags": {"env:test","env:prod"}}},
  "image": {"id": "9aaf3bcb-dcd7-4de7-bb60-24e39ff9d366"},
  "keys": [{"id": "363f6d70-0000-0001-0000-00000013b96c"}],
  "name": "my-instance",
  "placement_target": {"id": "0787-8c2a09be-ee18-4af2-8ef4-6a6060732221"},
  "primary_network_interface": {
    "name": "my-network-interface",
    "subnet": {"id": "bea6a632-5e13-42a4-b4b8-31dc877abfe4"}},
  "profile": {"name": "bx2-2x8"},
  "volume_attachments": [
    {"volume": {
        "capacity": 1000,
        "encryption_key": {"crn": "crn:[...]"},
        "name": "my-data-volume",
        "profile": {"name": "5iops-tier"},
        "storage_generation": 1,
        "user_tags": {"env:test","env:prod"}}
    }],
  "vpc": {"id": "f0aae929-7047-46d1-92e1-9102b07a7f6f"},
  "zone": {"name": "us-south-1"}
}'

Una respuesta satisfactoria tiene el aspecto siguiente:

{
  "bandwidth": 4000,
  "boot_volume_attachment": {
    "device": {
      "id": "a8a15363-a6f7-4f01-af60-715e85b28141"
    },
    "href": "https://us-south.iaas.cloud.ibm.com/v1/instances/eb1b7391-2ca2-4ab5-84a8-b92157a633b0/volume_attachments/7389-a8a15363-a6f7-4f01-af60-715e85b28141",
    "id": "a8a15363-a6f7-4f01-af60-715e85b28141",
    "name": "my-boot-volume-attachment",
    "volume": {
      "crn": "crn:[...]",
      "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/49c5d61b-41e7-4c01-9b7a-1a97366c6916",
      "id": "49c5d61b-41e7-4c01-9b7a-1a97366c6916",
      "name": "my-boot-volume"
    }
  },
  "created_at": "2022-06-15T16:11:57Z",
  "crn": "crn:[...]",
  "dedicated_host": {
    "crn": "crn:[...]",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/dedicated_hosts/0787-8c2a09be-ee18-4af2-8ef4-6a6060732221",
    "id": "0787-8c2a09be-ee18-4af2-8ef4-6a6060732221",
    "name": "test-new",
    "resource_type": "dedicated_host"
  },
  "disks": [],
  "href": "https://us-south.iaas.cloud.ibm.com/v1/instances/eb1b7391-2ca2-4ab5-84a8-b92157a633b0",
  "id": "eb1b7391-2ca2-4ab5-84a8-b92157a633b0",
  "image": {
    "crn": "crn:[...]",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/images/9aaf3bcb-dcd7-4de7-bb60-24e39ff9d366",
    "id": "9aaf3bcb-dcd7-4de7-bb60-24e39ff9d366",
    "name": "my-image"
  },
  "memory": 8,
  "name": "my-instance",
  "network_interfaces": [
    {
      "href": "https://us-south.iaas.cloud.ibm.com/v1/instances/e402fa1b-96f6-4aa2-a8d7-703aac843651/network_interfaces/7ca88dfb-8962-469d-b1de-1dd56f4c3275",
      "id": "7ca88dfb-8962-469d-b1de-1dd56f4c3275",
      "name": "my-network-interface",
      "primary_ipv4_address": "10.0.0.32",
      "resource_type": "network_interface",
      "subnet": {
        "crn": "crn:[...]",
        "href": "https://us-south.iaas.cloud.ibm.com/v1/subnets/7389-bea6a632-5e13-42a4-b4b8-31dc877abfe4",
        "id": "bea6a632-5e13-42a4-b4b8-31dc877abfe4",
        "name": "my-subnet"
      }
    }
  ],
  "placement_target": {
    "crn": "crn:[...]",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/dedicated_hosts/0787-8c2a09be-ee18-4af2-8ef4-6a6060732221",
    "id": "0787-8c2a09be-ee18-4af2-8ef4-6a6060732221",
    "name": "test-new",
    "resource_type": "dedicated_host"
  },
  "primary_network_interface": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/instances/e402fa1b-96f6-4aa2-a8d7-703aac843651/network_interfaces/7ca88dfb-8962-469d-b1de-1dd56f4c3275",
    "id": "7ca88dfb-8962-469d-b1de-1dd56f4c3275",
    "name": "my-network-interface",
    "primary_ipv4_address": "10.0.0.32",
    "resource_type": "network_interface",
    "subnet": {
      "crn": "crn:[...]",
      "href": "https://us-south.iaas.cloud.ibm.com/v1/subnets/bea6a632-5e13-42a4-b4b8-31dc877abfe4",
      "id": "bea6a632-5e13-42a4-b4b8-31dc877abfe4",
      "name": "my-subnet"
    }
  },
  "profile": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/instance/profiles/bx2-2x8",
    "name": "bx2-2x8"
  },
  "resource_group": {
    "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/4bbce614c13444cd8fc5e7e878ef8e21",
    "id": "4bbce614c13444cd8fc5e7e878ef8e21",
    "name": "Default"
  },
  "status": "running",
  "status_reasons": [],
  "vcpu": {
    "architecture": "amd64",
    "count": 2
  },
  "volume_attachments": [
    {
      "device": {
        "id": "a8a15363-a6f7-4f01-af60-715e85b28141"
      },
      "href": "https://us-south.iaas.cloud.ibm.com/v1/instances/e402fa1b-96f6-4aa2-a8d7-703aac843651/volume_attachments/7389-a8a15363-a6f7-4f01-af60-715e85b28141",
      "id": "a8a15363-a6f7-4f01-af60-715e85b28141",
      "name": "my-boot-volume-attachment",
      "volume": {
        "crn": "crn:[...]",
        "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/49c5d61b-41e7-4c01-9b7a-1a97366c6916",
        "id": "49c5d61b-41e7-4c01-9b7a-1a97366c6916",
        "name": "my-boot-volume"
      }
    },
    {
      "device": {
        "id": "e77125cb-4df0-4988-a878-531ae0ae0b70"
      },
      "href": "https://us-south.iaas.cloud.ibm.com/v1/instances/e402fa1b-96f6-4aa2-a8d7-703aac843651/volume_attachments/7389-e77125cb-4df0-4988-a878-531ae0ae0b70",
      "id": "e77125cb-4df0-4988-a878-531ae0ae0b70",
      "name": "my-volume-attachment-1",
      "volume": {
        "crn": "crn:[...]",
        "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/2cc091f5-4d46-48f3-99b7-3527ae3f4392",
        "id": "2cc091f5-4d46-48f3-99b7-3527ae3f4392",
        "name": "my-data-volume"
      }
    }
  ],
  "vpc": {
    "crn": "crn:[...]",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/vpcs/f0aae929-7047-46d1-92e1-9102b07a7f6f",
    "id": "f0aae929-7047-46d1-92e1-9102b07a7f6f",
    "name": "my-vpc"
  },
  "zone": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-1",
    "name": "us-south-1"
  }
}

Creación de un volumen de arranque sdp como parte del aprovisionamiento de instancias con la API

Además de la capacidad y las IOPS, también puede especificar un límite de rendimiento personalizado con la propiedad bandwidth. Vea el ejemplo siguiente.

curl -X POST "$vpc_api_endpoint/v1/instances?version=2024-09-24&generation=2"\
-H "Authorization: Bearer $iam_token" \
-d '{
  "boot_volume_attachment": {
    "volume": {
      "encryption_key": {"crn": "crn:[...]"},
      "name": "my-defined-performance-boot-volume",
      "profile": {"name": "sdp"},
      "boot_capacity": 250,
      "iops": 3000,
      "bandwidth": 1000
      "storage_generation": 2,
      "user_tags": {"env:test","env:prod"}},
  "image": {"id": "9aaf3bcb-dcd7-4de7-bb60-24e39ff9d366"},
  "keys": [{"id": "363f6d70-0000-0001-0000-00000013b96c"}],
  "name": "my-instance",
  "placement_target": {"id": "0787-8c2a09be-ee18-4af2-8ef4-6a6060732221"},
  "primary_network_interface": {
    "name": "my-network-interface",
    "subnet": {"id": "bea6a632-5e13-42a4-b4b8-31dc877abfe4"}},
  "profile": {"name": "bx3dc-2x10"},
  "vpc": {"id": "f0aae929-7047-46d1-92e1-9102b07a7f6f"},
  "zone": {"name": "us-east-1"}
  }
}

Para obtener más información sobre la creación de volúmenes con la API, consulte Creación de volúmenes Block Storage y la referencia de la API para crear una instancia

Creación de un volumen Block Storage for VPC autónomo con la API

Realice una solicitud POST /volumes para crear un volumen. Especifique un nombre, un valor de IOPS, una capacidad, el perfil y la zona.

El ejemplo siguiente ha creado un volumen custom con 50 MB de capacidad y 100 IOPS en la región us-south. La solicitud también especifica una clave raíz de cliente para el cifrado gestionado por el cliente y un grupo de recursos.

curl -X POST "$vpc_api_endpoint/v1/volumes?version=2022-06-14&generation=2" \
-H "Authorization: Bearer $iam_token" \
-d '{
      "name": "my-volume-4",
      "iops": 100,
      "capacity": 50,
      "zone": {"name": "us-south-2"},
      "profile": {"name": "custom"},
      "encryption_key":{"crn":"crn:[...]"},
      "resource_group": {"id": "2d1bb5a8-40a8-447a-acf7-0eadc8aeb054"}
    }'

Una respuesta satisfactoria tiene un aspecto similar al del ejemplo siguiente.

{
  "capacity": 50,
  "created_at": "2022-06-14T23:16:53.000Z",
  "crn": "crn:[...]",
  "encryption": "user_managed",
  "encryption_key": {
    "crn": "crn:[...]"
  },
  "health_reasons": [],
  "health_state": "ok",
  "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/2d1bb5a8-40a8-447a-acf7-0eadc8aeb054",
  "id": "2d1bb5a8-40a8-447a-acf7-0eadc8aeb054",
  "iops": 100,
  "name": "my-volume-4",
  "profile": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/volume/profiles/custom",
    "name": "custom"
  },
  "resource_group": {
    "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/4bbce614c13444cd8fc5e7e878ef8e21",
    "id": "4bbce614c13444cd8fc5e7e878ef8e21",
    "name": "Default"
  },
  "status": "available",
  "status_reasons": [],
  "volume_attachments": [],
  "zone": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-2",
    "name": "us-south-2"
  }
}

Cuando se utiliza el perfil sdp, se puede crear un volumen de datos con capacidad e IOPS personalizadas, y también se puede especificar un límite de rendimiento personalizado con la propiedad bandwidth. El siguiente ejemplo crea un volumen de datos autónomo de este tipo en la región us-east.

curl -X POST "$vpc_api_endpoint/v2/volumes?version=2024-09-27&generation=2" \
-H "Authorization: Bearer $iam_token" \
-d '{
      "name": "my-special-volume-1",
      "iops": 3000,
      "capacity": 250,
      "bandwidth": 5000,
      "zone": {"name": "us-east-2"},
      "profile": {"name": "sdp"},
      "encryption_key":{"crn":"crn:[...]"},
      "resource_group": {"id": "2d1bb5a8-40a8-447a-acf7-0eadc8aeb054"}
    }'

Una respuesta satisfactoria tiene un aspecto similar al del ejemplo siguiente.

{
  "adjustable_capacity_states:": "attached, unattached",
  "adjustable_iops_states": "attached, unattached",
  "bandwidth": 5000,
  "capacity": 250,
  "created_at": "2024-09-27T23:16:53.000Z",
  "crn": "crn:[...]",
  "encryption": "user_managed",
  "encryption_key": {
    "crn": "crn:[...]"
  },
  "health_reasons": [],
  "health_state": "ok",
  "href": "https://us-east.iaas.cloud.ibm.com/v2/volumes/2d1bb5a8-40a8-447a-acf7-0eadc8aeb054",
  "id": "2d1bb5a8-40a8-447a-acf7-0eadc8aeb054",
  "iops": 3000,
  "name": "my-special-volume-1",
  "profile": {
    "href": "https://us-east.iaas.cloud.ibm.com/v2/volume/profiles/sdp",
    "name": "sdp"
  },
  "resource_group": {
    "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/4bbce614c13444cd8fc5e7e878ef8e21",
    "id": "2d1bb5a8-40a8-447a-acf7-0eadc8aeb054",
    "name": "Default"
  },
  "status": "available",
  "status_reasons": [],
  "volume_attachments": [],
  "zone": {
    "href": "https://us-east.iaas.cloud.ibm.com/v1/regions/us-east/zones/us-east-2",
    "name": "us-east-2"
  }
}

Para obtener más información sobre la creación de volúmenes con la API, consulte Creación de volúmenes de Block Storage y la referencia de la API para crear un volumen.

Creación de un volumen de datos a partir de una instantánea mediante la API

Puede especificar un ID, nombre o CRN de instantánea en una llamada POST /volumes para crear un volumen de datos independiente. Cuando especifica una instantánea cuyo valor de propiedad storage_generation es 1, el nuevo volumen de almacenamiento en bloque se crea con el mismo valor storage_generation y solo se le pueden aplicar perfiles de volumen de la misma generación.

Los datos se restauran completamente cuando se conecta el volumen de datos a una instancia de servidor virtual. Para más información, ver Acerca de restaurar un volumen a partir de una instantánea. Para ver un ejemplo de llamada API, consulte Restaurar un volumen de datos a partir de una instantánea de un volumen no asociado.

Creación de volúmenes Block Storage for VPC con Terraform

Para utilizar Terraform, descargue Terraform CLI y configure el complemento IBM Cloud® Provider. Para obtener más información, consulte Cómo empezar con Terraform.

Los servicios de infraestructura de VPC utilizan un punto final regional específico, que se dirige a us-south de forma predeterminada. Si la VPC se crea en otra región, asegúrese de que el destino sea la región adecuada en el bloque de proveedor en el archivo provider.tf.

Consulte el ejemplo siguiente de destino de una región que no sea la predeterminada us-south.

provider "ibm" {
   region = "eu-de"
}

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 se crean dos volúmenes con el mismo nombre en la misma cuenta y región, se produce un error volume name duplicate.

Creación de volúmenes Block Storage for VPC autónomos con Terraform

Para crear un volumen Block Storage for VPC, utilice el recurso ibm_is_volume. El siguiente ejemplo crea un volumen de primera generación con 4 TB de capacidad y el perfil de rendimiento 10iops-tier.

resource "ibm_is_volume" "10iops_volume_example" {
  name     = "example-volume-10iops"
  profile  = "10iops-tier"
  zone     = "us-south-1"
  capacity = 4000
}

El siguiente ejemplo crea un volumen de primera generación con un perfil custom. El volumen que se crea tiene 200 MB de capacidad y puede realizar 1000 IOPS.

resource "ibm_is_volume" "custom_volume_example" {
  name           = "example-volume-custom"
  profile        = "custom"
  zone           = "us-south-1"
  iops           = 1000
  capacity       = 200
  encryption_key = "crn:v1:bluemix:public:kms:us-south:a/a1234567:e4a29d1a-2ef0-42a6-8fd2-350deb1c647e:key:5437653b-c4b1-447f-9646-b2a2a4cd6179"
}

El siguiente ejemplo crea un volumen de segunda generación con el perfil sdp. El volumen que se crea tiene 250 MB de capacidad, puede realizar 3000 IOPS con el límite máximo de ancho de banda de 1000 Mbps.

resource "ibm_is_volume" "sdp_volume_example" {
  name           = "example-volume-sdp"
  profile        = "sdp"
  zone           = "us-south-1"
  iops           = 3000
  capacity       = 250
  bandwidth      = 1000
  encryption_key = "crn:v1:bluemix:public:kms:us-south:a/a1234567:e4a29d1a-2ef0-42a6-8fd2-350deb1c647e:key:5437653b-c4b1-447f-9646-b2a2a4cd6179"
}

Para obtener más información sobre los argumentos y atributos, consulte ibm_is_volume.

Creación de un volumen Block Storage for VPC autónomo a partir de una instantánea con Terraform

Para crear un volumen Block Storage for VPC a partir de una instantánea, utilice el recurso ibm_is_volume. El ejemplo siguiente crea un volumen basado en una instantánea identificada por su ID. También puede utilizar el nombre o el CRN para identificar la instantánea.

resource "ibm_is_volume" "example-volume-from-snapshot" {
  name            = "example-volume"
  profile         = "general-purpose"
  zone            = "us-south-1"
  source_snapshot = ibm_is_snapshot.example.id
}

Para obtener más información sobre los argumentos y atributos, consulte ibm_is_volume.

Los perfiles de volumen de primera y segunda generación no son intercambiables. Puedes utilizar una instantánea de un volumen de segunda generación para crear otro volumen de segunda generación, pero no puedes cambiar el perfil de volumen a un perfil de volumen de primera generación. Del mismo modo, puedes utilizar una instantánea de un volumen de primera generación para crear otro volumen de primera generación con los mismos datos, y no puedes cambiar el nuevo volumen al perfil sdp.

Creación de un volumen de arranque como parte del aprovisionamiento de instancias con Terraform

Para crear un volumen de datos a partir de una instantánea al crear una instancia de servidor virtual, utilice el recurso ibm_is_instance. El siguiente ejemplo crea una instancia de servidor virtual con un volumen de arranque que utiliza el perfil de volumen sdp y está protegido por una clave de cifrado gestionada por el cliente. Al especificar el perfil sdp para el volumen de arranque, puede especificar límites personalizados de capacidad, IOPS y ancho de banda.

   resource "ibm_is_instance" "example_instance" {
     name    = "example-instance-reserved-ip"
     image   = data.ibm_is_image.example_image.id
     profile = data.ibm_is_instance_profile.example_profile.name
     primary_network_interface {
       name   = "eth0"
       subnet = ibm_is_subnet.example_subnet.id
       primary_ip {
         reserved_ip = ibm_is_subnet_reserved_ip.example_reserved_ip.reserved_ip
       }
     }
     network_interfaces {
       name   = "eth1"
       subnet = ibm_is_subnet.example_subnet.id
       primary_ip {
         name = "example-reserved-ip1"
         auto_delete = true
         address = "${replace(ibm_is_subnet.example_subnet.ipv4_cidr_block, "0/24", "14")}"
       }
     }
     vpc  = ibm_is_vpc.example_vpc.id
     zone = "us-south-1"
     keys = [ibm_is_ssh_key.example_sshkey.id]
     boot_volume {
       name           = "example-boot-volume"
       profile        = "sdp"
       size           = 250
       iops           = 3000
       bandwidth      = 1000
       encryption_key = "crn:v1:bluemix:public:kms:us-south:a/a1234567:e4a29d1a-2ef0-42a6-8fd2-350deb1c647e:key:5437653b-c4b1-447f-9646-b2a2a4cd6179"
      }
   }

Para obtener más información sobre los argumentos y atributos, consulte ibm_is_instance.

Creación de un volumen de arranque a partir de una instantánea como parte del suministro de instancias con Terraform

Para crear un volumen de datos a partir de una instantánea al crear una instancia de servidor virtual, utilice el recurso ibm_is_instance. El ejemplo siguiente crea una instancia de servidor virtual con el nombre "example-vsi-restore". El volumen de arranque se define en el argumento boot_volume con su nombre, su instantánea de origen y las etiquetas de usuario.

resource "ibm_is_snapshot" "example" {
  name          = "example-snapshot"
  source_volume = ibm_is_instance.example.volume_attachments[0].volume_id
}
resource "ibm_is_instance" "example" {
  name    = "example-vsi-restore"
  profile = "cx2-2x4"
  boot_volume {
    name     = "boot-restore"
    snapshot = ibm_is_snapshot.example.id
    tags     = ["tags-0"]
  }
  primary_network_interface {
    subnet = ibm_is_subnet.example.id
  }
  vpc  = ibm_is_vpc.example.id
  zone = "us-south-1"
  keys = [ibm_is_ssh_key.example.id]
  network_interfaces {
    subnet = ibm_is_subnet.example.id
    name   = "eth1"
  }
}

Si quieres restaurar un volumen a partir de una instantánea de otra cuenta, puedes utilizar el argumento ' source_snapshot_crn ' para identificar la instantánea por su CRN, en lugar de por su ID.

Para obtener más información sobre los argumentos y atributos, consulte ibm_is_instance.

Creación de un volumen de datos para añadir a una instancia existente con Terraform

Para crear un volumen de datos y conectarlo a una instancia de servidor virtual, utilice el recurso ibm_is_instance_volume_attachment. El siguiente ejemplo crea un volumen de datos de 20 MB con un perfil de volumen general-purpose y lo adjunta a la instancia ibm_is_instance.example.id.

rresource "ibm_is_instance_volume_attachment" "example" {
  instance = ibm_is_instance.example.id
  name                               = "example-vol-att-1"
  profile                            = "general-purpose"
  capacity                           = "20"
  delete_volume_on_attachment_delete = true
  delete_volume_on_instance_delete   = true
  volume_name                        = "example-vol-1"
}

Para obtener más información sobre los argumentos y atributos, consulte ibm_is_instance_volume_attachment.

Próximos pasos

Puede seguir creando más volúmenes de Block Storage for VPC o gestionar los volúmenes existentes.