En la consola

En la página de aprovisionamiento de almacenamiento en bloque, puede ver una lista de todos los perfiles disponibles en la página Crear almacenamiento en bloque, como el perfil sdp, los tres perfiles tiered y el perfil custom. Cuando selecciones uno de los perfiles por niveles, deberás especificar la capacidad. Cuando selecciones el perfil personalizado, tendrás que especificar la capacidad y un valor de IOPS que esté en el rango aplicable para tu capacidad (Tabla 3 ). Al seleccionar el perfil sdp, puede especificar la capacidad y las IOPS sin ninguna restricción de rango basada en la capacidad. También puede especificar el límite máximo de caudal para su volumen.

Desde la CLI

Para ver la lista de perfiles disponibles utilizando la CLI, ejecute el mandato siguiente:

ibmcloud is volume-profiles

Listing volume profiles in region us-east under account TEST as user test.user@ibm.com...
Name              Family                Bandwidth(Mbps) default value   Storage Generation
general-purpose   tiered                -                               1
5iops-tier        tiered                -                               1
10iops-tier       tiered                -                               1
sdp               defined_performance   1000                            2
custom            custom                -                               1

Para ver los detalles del perfil, ejecute el mandato ibmcloud is volume-profile con el nombre del perfil que está interesado en ver. El siguiente ejemplo muestra los detalles del perfil sdp.

ibmcloud is volume-profile sdp

Getting volume profile sdp under account Test Account as user test.user@ibm.com...
Name                                   sdp
Family                                 defined_performance
Adjustable IOPS                        true
Boot capacity                          Max     Min
                                       32000   1
Capacity                               Max     Min   Default   Step
                                       32000   1     -         1
IOPS                                   Max     Min    Default   Step
                                       64000   3000   3000      1
Bandwidth(Mbps)                        Max    Min    Default   Step   Value
                                       8192   1000   1000      1      -
Storage Generation                     2
Adjustable Bandwidth Supported         true
Adjustable Capacity States             attached, unattached
Adjustable IOPS State                  attached, unattached

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

Con la API

Para ver los perfiles disponibles, realice una solicitud GET /volume/profiles.

curl -X GET \
$vpc_api_endpoint/v1/volume/profiles?$api_version&generation=2 \
-H "Authorization: Bearer $iam_token"

Para la mayoría de las cuentas, la API responde con los campos name, href, family. Para las cuentas con acceso especial para previsualizar el perfil de rendimiento definido, la respuesta se mejora para incluir los siguientes campos:

• boot_capacity denota los valores de capacidad admisibles para los volúmenes de arranque de cada perfil. El valor devuelto es un rango con valores mínimos y máximos que se especifican para cada perfil.
  • Para los perfiles custom y tiered, el rango es de 10 GB - 250 GB.
  • Para el perfil sdp, el rango es de 10 GB - 250 GB.
• capacity denota los valores de capacidad admisibles para los volúmenes de datos de cada perfil. El valor devuelto es un rango con valores mínimos y máximos que se especifican para cada perfil.
  • Para los perfiles custom y tiered, el rango es de 10 GB - 16 TB.
  • Para el perfil sdp, la gama va de 1 GB a 32 TB.
• iops este campo indica las IOPS alcanzables con cada perfil.
  • Para los perfiles tiered, este valor es fijo: 3 IOPS/GB, 5 IOPS/GB y 10 IOPS/GB.
  • Para el perfil custom, este valor puede oscilar entre 1 y 48.000.
  • Para el perfil sdp, este valor puede oscilar entre 1 y 64.000.
• family enum tiene ahora un valor adicional,defined_performance, junto con los valores tiered y custom que existen actualmente.
• adjustable_capacity_states indica si la capacidad para el volumen se puede cambiar cuando el volumen no está unido a una instancia de servidor virtual en ejecución. Este campo es informativo. Describe las características del perfil de volumen y no puede modificarse.
  • Para los perfiles custom y tiered, este valor es attached.
  • Para el perfil sdp, este valor es attached, unattached.
• adjustable_iops_states indica si las IOPS del volumen se pueden cambiar cuando el volumen no está conectado a una instancia de servidor virtual en ejecución. Este campo es informativo. Describe las características del perfil de volumen y no puede modificarse.
  • Para los perfiles custom, este valor es attached.
  • Para los perfiles tiered, este valor está vacío porque los cambios de IOPS no se admiten en ningún estado. Si quieres cambiar el valor de IOPS de un volumen, puedes cambiar a otro perfil tiered.
  • Para el perfil sdp, este valor es attached, unattached.
• adjustable_bandwidth_supported indica si se puede ajustar el límite de ancho de banda provisionado.
  • Para los perfiles custom y tiered, este valor es false.
  • Para el perfil sdp, este valor es true.
• storage_generation indica a qué generación pertenece la familia de perfiles.
  • Para los perfiles custom y tiered, este valor es 1.
  • Para el perfil sdp, este valor es 2.

El nuevo perfil aparece como sdp. Para ver los detalles de este perfil, haga una solicitud a GET /volume/profiles/sdp.

curl -X GET "https://us-south.iaas.cloud.ibm.com/v1/volume/profiles/sdp?version=2024-09-24&generation=2"\
 -H "Authorization: Bearer $iam_token"

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

{
    "boot_capacity": {
        "max": 32000,
        "min": 1,
        "type": "dependent_range"
    },
    "capacity": {
        "default": 1,
        "max": 32000,
        "min": 1,
        "step": 1,
        "type": "range"
    },
    "family": "defined_performance",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/volume/profiles/sdp",
    "iops": {
        "default": 100,
        "max": 64000,
        "min": 100,
        "step": 1,
        "type": "range"
    },
    "name": "sdp",
    "adjustable_capacity_states": {
        "type": "fixed",
        "value": "attached, unattached"
    },
    "adjustable_iops_states": {
        "type": "fixed",
        "value": "attached, unattached"
    },
    "adjustable_bandwidth_supported": true,
    "max_throughput": 8192,
    "max_bandwidth_mbps": 8192,
    "min_bandwidth_mbps": 1000,
    "default_bandwidth_mbps": 1000,
    "storage_generation": 2
}

Para obtener más información sobre este método, consulte la referencia de la API para listar todos los perfiles de volumen y recuperar un perfil de volumen.

Con Terraform

1. Para utilizar Terraform, descargue la CLI de Terraform y configure el plug-in de proveedor IBM Cloud®. Para obtener más información, consulte Cómo empezar con Terraform.

2. 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 siguiente ejemplo de destino de una región distinta de la predeterminada us-south.

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

3. Importe la lista de perfiles de volumen disponibles como un origen de datos de sólo lectura.

   data "ibm_is_volume_profiles" "example" {
   }
   

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