コンソールで

ブロックストレージのプロビジョニングページでは、3つの「 tiered 」と「 custom 」プロファイルを含め、利用可能なすべてのプロファイルの一覧を確認できます。 sdp のプロフィールは、許可リストに登録されたアカウントからのみ閲覧可能です。 段階的プロファイルのいずれかを選択する場合、容量を指定する必要があります。 カスタム・プロファイルを選択するときは、容量と、容量に該当する範囲の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 プロファイルの場合、この値は固定されており、1 GBあたり3 IOPS、1 GBあたり5 IOPS、および1 GBあたり10 IOPSとなっています。
  • 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を参照してください。