コンソールで

特別なアクセス権を持つお客様は、 sdp プロファイルで Block Storage ボリュームを作成できます。

許可リストに登録されたお客様には、3つのプロファイル（ tiered ）、 custom、新しいプロファイル（ sdp）など、利用可能なすべてのプロファイルのリストが表示されます。 段階的プロファイルのいずれかを選択する場合、容量を指定する必要があります。 カスタム・プロファイルを選択するときは、容量と、容量に該当する範囲のIOPS値を指定する必要があります （表3）。 sdp プロファイルを選択すると、容量ベースの範囲制限なしで容量と IOPS を指定できます。 また、ボリュームの最大スループット制限を指定することもできます。

CLI から

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

ibmcloud is volume-profiles

$ 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 コマンドを実行します。

以下の例は、 10iops-tier の詳細を示しています。

$ ibmcloud is volume-profile 10iops-tier
Getting volume profile 10iops-tier under account Test Account as user test.user@ibm.com...

Name                                   10iops-tier   
Family                                 tiered   
Adjustable IOPS                        false   
Boot capacity                          Max   Min      
                                       250   10      

Capacity                               Max    Min   Default   Step      
                                       4800   10    10        1      

IOPS                                   Max    Min   Default   Step      
                                       48000  10    10        1     
Storage Generation                     1

次の例は、 export IBMCLOUD_IS_FEATURE_VOLUME_ADJUSTABLE_CAPACITY_IOPS_STATES=true コマンドを使用した場合の sdp プロファイルの詳細を示しています。 この機能フラグが true に設定されている場合、 Adjustable Capacity State と Adjustable IOPS State のプロパティが CLI 応答に表示される。

$ 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: $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: $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を参照してください。