Dans la console

Sur la page de provisionnement du stockage en bloc, vous pouvez voir une liste de tous les profils disponibles dans la page Créer un stockage en bloc, tels que le profil sdp, les trois profils tiered et le profil custom. Lorsque vous sélectionnez l'un des profils à plusieurs niveaux, vous devez spécifier la capacité. Lorsque vous sélectionnez le profil personnalisé, vous devez spécifier la capacité et une valeur IOPS qui se situe dans la plage applicable à votre capacité (tableau 3). Lorsque vous sélectionnez le profil sdp, vous pouvez spécifier la capacité et les IOPS sans aucune restriction de capacité. Vous pouvez également spécifier la limite maximale de débit pour votre volume.

Depuis l'interface de ligne de commande :

Pour afficher la liste des profils disponibles à l'aide de l'interface de ligne de commande, exécutez la commande suivante :

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

Pour afficher les détails du profil, exécutez la commande ibmcloud is volume-profile avec le nom du profil que vous souhaitez voir. L'exemple suivant montre les détails du profil 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

Pour plus d'informations sur les options de commande disponibles, voir ibmcloud is volume-profile.

Avec l'API

Pour afficher les profils disponibles, effectuez une demande GET /volume/profiles.

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

Pour la plupart des comptes, l'API répond avec les champs name, href, family. Pour les comptes disposant d'un accès spécial permettant de prévisualiser le profil de performance défini, la réponse est améliorée et comprend les champs suivants :

• boot_capacity indique les valeurs de capacité autorisées pour les volumes de démarrage pour chaque profil. La valeur renvoyée est une plage de valeurs minimales et maximales spécifiées pour chaque profil.
  • Pour les profils custom et tiered, la plage est de 10 GB - 250 GB.
  • Pour le profil sdp, la plage est de 10 Go à 250 Go.
• capacity indique les valeurs de capacité autorisées pour les volumes de données pour chaque profil. La valeur renvoyée est une plage de valeurs minimales et maximales spécifiées pour chaque profil.
  • Pour les profils custom et tiered, la plage est comprise entre 10 Go et 16 To.
  • Pour le profil sdp, la fourchette va de 1 Go à 32 To.
• iops ce champ indique le nombre d'IOPS réalisables pour chaque profil.
  • Pour les profils tiered, cette valeur est fixe : 3 IOPS/GB, 5 IOPS/GB et 10 IOPS/GB.
  • Pour le profil custom, cette valeur peut être comprise entre 1 et 48 000.
  • Pour le profil sdp, cette valeur peut être comprise entre 1 et 64 000.
• family comporte désormais une valeur supplémentaire,defined_performance, en plus des valeurs tiered et custom qui existent actuellement.
• adjustable_capacity_states indique si la capacité du volume peut être modifiée lorsque le volume n'est pas attaché à une instance de serveur virtuel en cours d'exécution. Ce champ est informatif. Il décrit les caractéristiques du profil de volume et ne peut pas être modifié.
  • Pour les profils custom et tiered, cette valeur est attached.
  • Pour le profil sdp, cette valeur est attached, unattached.
• adjustable_iops_states indique si l'IOPS du volume peut être modifié lorsque le volume n'est pas attaché à une instance de serveur virtuel en cours d'exécution. Ce champ est informatif. Il décrit les caractéristiques du profil de volume et ne peut pas être modifié.
  • Pour les profils custom, cette valeur est attached.
  • Pour les profils tiered, cette valeur est vide car les changements d'IOPS ne sont pris en charge dans aucun état. Si vous souhaitez modifier la valeur IOPS d'un volume, vous pouvez passer à un autre profil tiered.
  • Pour le profil sdp, cette valeur est attached, unattached.
• adjustable_bandwidth_supported indique si la limite de bande passante provisionnée peut être ajustée.
  • Pour les profils custom et tiered, cette valeur est false.
  • Pour le profil sdp, cette valeur est true.
• storage_generation indique la génération à laquelle appartient la famille de profil.
  • Pour les profils custom et tiered, cette valeur est 1.
  • Pour le profil sdp, cette valeur est 2.

Le nouveau profil est répertorié comme sdp. Pour voir les détails de ce profil, faites une demande à 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"

Une réponse réussie ressemble à celle de l'exemple ci-après.

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

Pour plus d'informations sur cette méthode, voir la référence d'API pour la liste de tous les profils de volume et l'extraction d'un profil de volume.

Avec Terraform

1. Pour utiliser Terraform, téléchargez l'interface de ligne de commande Terraform et configurez le plug-in IBM Cloud® Provider. Pour plus d'informations, voir Initiation à Terraform.

2. Les services d'infrastructure VPC utilisent un noeud final régional spécifique, qui cible us-south par défaut. Si votre VPC est créé dans une autre région, veillez à cibler la région appropriée dans le bloc fournisseur du fichier provider.tf. Consultez l'exemple suivant de ciblage d'une région autre que la région par défaut us-south.

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

3. Importez la liste des profils de volume disponibles en tant que source de données en lecture seule.

   data "ibm_is_volume_profiles" "example" {
   }
   

   Pour plus d'informations, voir ibm_is_volume_profile.