コンソールで

ブロック・ストレージのプロビジョニング・ページでは、 sdp プロファイル、3 つの tiered プロファイル、 custom プロファイルなど、ブロック・ストレージの作成ページで利用可能なすべてのプロファイルのリストを見ることができます。 段階的プロファイルのいずれかを選択する場合、容量を指定する必要があります。 カスタム・プロファイルを選択するときは、容量と、容量に該当する範囲のIOPS値を指定する必要があります （表3）。 sdp プロファイルを選択すると、容量ベースの範囲制限なしで容量と IOPS を指定できます。 また、ボリュームの最大スループット制限を指定することもできます。

CLI から

CLI を使用して使用可能なプロファイルのリストを表示するには、以下のコマンドを実行します。

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

プロファイルの詳細を表示するには、表示するプロファイルの名前を指定して ibmcloud is volume-profile コマンドを実行します。 次の例は、 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

使用可能なコマンド・オプションについて詳しくは、「 ibmcloud is volume-profile」を参照してください。

API を使用する場合

使用可能なプロファイルを表示するには、 GET /volume/profiles 要求を行います。

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

ほとんどのアカウントについて、APIはフィールド name、 href、 family で応答する。定義されたパフォーマンス・プロファイルをプレビューするための特別なアクセス権を持つアカウントの場合、応答は以下のフィールドを含むように強化される：

• boot_capacity は、各プロファイルのブートボリュームに許容される容量値を示します。 返される値は、プロファイルごとに指定された最小値と最大値の範囲です。
  • custom および tiered プロファイルの場合、範囲は10GB～250GBです。
  • sdp プロファイルでは、10GB～250GBの範囲です。
• capacity は、各プロファイルのデータボリュームに許容される容量値を示します。 返される値は、プロファイルごとに指定された最小値と最大値の範囲です。
  • custom および tiered プロファイルの場合、範囲は10 GB～16 TBです。
  • sdp 、1GBから32TBまで。
• iops このフィールドは、各プロファイルで達成可能なIOPSを示す。
  • tiered プロファイルでは、この値は固定である：3 IOPS/GB、5 IOPS/GB、および 10 IOPS/GB。
  • custom プロファイルの場合、この値は1～48,000の範囲となる。
  • sdp プロファイルの場合、この値は1～64,000の範囲で設定できる。
• family enumには、現在存在する と に加えて、 という値が追加された。 tiered custom``defined_performance
• adjustable_capacity_states は、ボリュームが実行中の仮想サーバーインスタンスにアタッチされていないときに、ボリュームの容量を変更できるかどうかを示します。 このフィールドは情報提供である。 これはボリューム・プロファイルの特徴を記述したもので、変更することはできません。
  • custom および tiered プロファイルの場合、この値は attached となります。
  • sdp プロファイルの場合、この値は attached, unattached となる。
• adjustable_iops_states は、ボリュームが実行中の仮想サーバーインスタンスにアタッチされていないときに、ボリュームのIOPSを変更できるかどうかを示します。 このフィールドは情報提供である。 これはボリューム・プロファイルの特徴を記述したもので、変更することはできません。
  • custom プロファイルの場合、この値は attached です。
  • tiered プロファイルでは、IOPSの変更はどの状態でもサポートされていないため、この値は空です。 ボリュームのIOPS値を変更したい場合は、別の tiered プロファイルに変更できます。
  • sdp プロファイルの場合、この値は attached, unattached となる。
• adjustable_bandwidth_supported は、プロビジョニングされた帯域幅の上限を調整できるかどうかを示します。
  • custom と tiered のプロフィールでは、この値は false です。
  • sdp プロファイルの場合、この値は true となる。
• storage_generation は、プロファイルファミリーがどの世代に属するかを示します。
  • custom と tiered のプロフィールでは、この値は 1 です。
  • sdp プロファイルの場合、この値は 2 となる。

新しいプロフィールは sdp。 このプロフィールの詳細を見るには、 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"

正常な応答は、次の例のようになります。

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

この方法について詳しくは、 すべてのボリューム・プロファイルのリスト表示 および ボリューム・プロファイルの取得 に関する API リファレンスを参照してください。

Terraform を使用する場合

1. Terraform を使用するには、Terraform CLI をダウンロードして、 IBM Cloud® プロバイダー・プラグインを構成します。 詳しくは、 Terraform の概要 を参照してください。

2. VPC インフラストラクチャー・サービスは、デフォルトで us-south をターゲットとする特定のリージョン・エンドポイントを使用します。 VPC が別のリージョンに作成されている場合は、 provider.tf ファイル内のプロバイダー・ブロックで適切なリージョンをターゲットにしてください。 デフォルトの us-south 以外の領域をターゲットにする例を以下に示します。

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

3. 使用可能なボリューム・プロファイルのリストを読み取り専用データ・ソースとしてインポートします。

   data "ibm_is_volume_profiles" "example" {
   }
   

   詳しくは、 ibm_is_volume_profileを参照してください。