すべてのBlock Storage for VPCボリュームに関する情報をコンソールで表示する

Block Storage for VPC ボリュームのリストに移動します。 IBM Cloud コンソールで、ナビゲーションメニュー アイコン インフラストラクチャ ストレージ > Block Storage ボリューム をクリックします。

デフォルトでは、お客様の地域におけるすべてのリソースグループの Block Storage for VPC ボリュームは、10個単位で表示されます。 ページコントロールの下向き矢印をクリックしてこのプリセットを変更し、リストの件数を20または50に増やしてください。 ページコントロールの矢印を使用して、次のページに進んだり、前のページに戻ったりします。 すべての Block Storage for VPC ボリュームのリストに、以下の情報が表示されます。

全巻の詳細

フィールド	説明
リージョン	これらのボリュームがあるリージョン (米国南部など)。 下向きの矢印をクリックすると、ご自身がアカウントをお持ちの別の地域の取引高を確認できます。
名前	ボリュームの名前をクリックすると、個別のボリュームの詳細が表示されます。
ステータス	ボリュームの状況。これは、すべての行のデフォルトのフィルターの働きをします。
ロケーション	VPC から継承される、リージョン内のアベイラビリティー・ゾーン (米国南部 1 など)。
サイズ	指定したボリュームのサイズ (GB)。
接続タイプ	インスタンスに接続している 2 次ボリュームの場合はデータ、ブート・ボリュームとして接続している場合はブート、未接続のボリュームの場合はブランク。
health	「Health」は、I/O パフォーマンスやデータの整合性など、ボリュームの全体的な健全性を監視します。 ボリュームの正常性状況は OK または degraded です。 劣化状態のボリュームでは、パフォーマンスの低下、容量の低下、または接続の問題が発生しています。 スナップショットからリストアされるボリュームにも劣化状態が表示されます。 このサービスでは、問題を解決できるように、機能低下状態の考えられる理由が表示されます。 詳しくは、 Block Storage for VPC ボリュームの正常性の状態 を参照してください。
暗号化	IBM 管理鍵による暗号化は、すべてのボリュームでデフォルトで有効になっています。 また、 Key Protect インスタンスで独自のルートキーを使用して、データを保護することもできます。 詳細については、 Block Storage for VPC ボリュームの作成（ お客様暗号化） をご覧ください。
タグ	ボリュームに適用されているユーザータグの数。 この列の番号をクリックすると、新しいウィンドウでタグを表示または編集できます。 ボリュームにタグが設定されていない場合は、「 タグを追加 」をクリックし、新しいウィンドウでタグを追加してください。 ユーザー・タグは、ボリュームのバックアップを作成するために、ボリュームを バックアップ・ポリシー に関連付けることができます。 詳細については、コンソールでバックアップポリシーに関連付けられているユーザータグをボリュームに追加する を参照してください。
アクション	行動 をクリックすると、状況に応じたアクションのメニューが表示されます。

「 アクション 」メニューの「 」にあるボリューム一覧ページでは、以下の操作が可能です。 一部の操作は、ボリュームが「接続済み」または「未接続」といった特定の条件を満たしている場合にのみ利用可能です。

• 名前の変更- このボリュームの名前を変更します。
• サーバーへのアタッチ- アタッチされていないボリュームを仮想サーバーインスタンスにアタッチします。 この操作は、ボリュームがアタッチされていない場合にのみ利用可能です。 詳しくは、インスタンスへのボリュームの接続を参照してください。
• インスタンスからの切り離し- 仮想サーバーインスタンスに接続されているボリュームを切り離します。 この操作は、ボリュームがマウントされている場合にのみ利用可能です。 詳細については、「 仮想サーバーインスタンスからボリュームを取り外す 」を参照してください。
• スナップショットの作成- このボリュームのスナップショットを作成します。 この操作は、利用できない場合、グレー表示されることがあります。 詳細については、「 コンソールでのスナップショットの作成 」を参照してください。
• イメージの作成- ブートボリュームからカスタムイメージを作成します。 この操作は、利用できない場合、グレー表示されることがあります。 詳細については、 コンソールでボリュームからイメージを作成する を参照してください。
• タグを追加する または「 タグを編集する 」 - このボリュームのユーザータグや管理タグを追加・編集できます。 詳しくは、『タグの処理』を参照してください。
• 削除- このボリュームを削除します。 この操作は、ボリュームがインスタンスにアタッチされている場合、グレー表示になります。 詳細は、 コンソールでのデータボリュームの削除 を参照してください。
• ボリュームの移行- このボリュームを別のプロファイルまたは構成に移行します。 詳細については、「 ブロックストレージボリュームの移行 」を参照してください。

Block Storage for VPCボリュームの詳細表示

Block Storage for VPC のボリュームの詳細を表示するには、 Block Storage for VPC のすべてのボリュームの一覧に移動し、ボリュームを選択してください。

ボリュームの名前の横には、 ボリューム状況 と、このボリュームに関連付けられているタグが表示されます。 ユーザータグ はリソースを識別する。 ユーザータグがバックアップポリシーに関連付けられると、ボリュームの バックアップスナップショット の作成に使用されます。 アクセス管理タグ を使用すると、アクセスを管理するための柔軟なリソース・グループを作成できます。 これらのタグについて詳しくは、「 タグの処理」を参照してください。

巻ごとの情報

このページには4つのタブがあります。 デフォルトでは、ボリューム詳細の「概要」タブが選択されています。

ボリュームの詳細

フィールド	説明
ボリュームの詳細
名前	ボリュームの作成時に指定したボリューム名。 「編集」アイコン をクリックして、ボリューム名を編集します。 ボリューム名には、最大 63 文字の英小文字および数字を使用できます。ハイフン (-) も使用できますが、先頭は小文字にする必要があります。 ボリューム名は、アカウントおよび地域に対して固有でなければなりません。
ボリューム ID	システム生成のボリューム ID。
health	「Health」は、I/O パフォーマンスやデータの整合性など、ボリュームの全体的な健全性を監視します。 ボリュームの正常性状況は OK または degraded です。 劣化状態にあるボリュームは、パフォーマンスと容量が十分ではなく、接続の問題が発生しています。 スナップショットからリストアされているボリュームにも劣化状態が表示されます。 サービスは、ユーザーが解決できるように、機能低下状態の考えられる理由を表示します。 詳しくは、 Block Storage for VPC ボリュームの正常性の状態 を参照してください。
リソース・グループ	VPC のセットアップ時に定義されるリソース・グループ。 リソース・グループは各リソースへのアクセスを管理しますが、請求やモニターには影響しません。
接続タイプ	インスタンスにアタッチされているセカンダリボリュームの場合はデータ、ブートボリュームとしてアタッチされた場合はブート、アタッチされていないボリュームの場合は空白。
作成日	ボリュームが作成されたシステム生成の日付。
ロケーション	リージョン内のアベイラビリティー・ゾーン。
サイズ	指定したボリュームのサイズ。 仮想サーバー・インスタンスに接続されているボリュームが、そのボリュームの範囲の最大容量でない場合は、アイコンをクリックしてボリュームを拡張できます。 詳細については、 Block Storage for VPC ボリューム容量の拡張を 参照してください。
プロフィール	このフィールドには、 ボリュームのプロファイル が表示されます： sdp、 カスタムIOPS、または IOPSティア プロファイルのいずれか。
最大IOPS	事前定義されたIOPS階層の最大IOPS値、またはカスタムIOPSとして指定した値。
スループット	このフィールドには、ストレージ容量に割り当てられた帯域幅が表示されます。単位はギガビット毎秒（Gbps）です。 スループットは、ボリュームが提供されたIOPSの数にスループット乗数を掛けた結果として計算されます。 ボリューム・プロファイルに応じ て、スループット倍率は16KBまたは256KBとなる。 sdp プロファイルで作成されたボリュームの場合、スループット値は1000～8192Mbpsの範囲でカスタマイズ可能です。
暗号化	IBM 管理鍵による暗号化は、すべてのボリュームでデフォルトで有効になっています。 お客様所有のルート鍵を使用してデータを保護することもできます。 [暗号化] フィールドには、プロビジョニングしたキー管理サービス (KMS) の名前（例： Key Protect ）と、 お客様管理型 が表示されます。 詳しくは、 お客様管理の暗号化を使用した Block Storage for VPC ボリュームの作成 を参照してください。
暗号化インスタンス	オプション。 お客様管理の暗号化ボリュームのためにプロビジョンした KMS インスタンスへのリンク。
キー	オプション。 お客様暗号化ボリュームを保護するためにパスフレーズを暗号化するのに使用されるルートキーの名前と、コピー可能なID。
バックアップ・ポリシー	ボリュームに関連付けられているバックアップ・ポリシーの数。 バックアップ・ポリシー・タブに移動するには、数値リンクをクリックします。
スナップショット	ボリュームについて作成されたスナップショットの数。 番号リンクをクリックして、「スナップショットおよびバックアップ」タブに移動します。
複製の役割	この論文が再現性研究において果たす役割： source、 replica、または none。 このフィールドは、 sdp プロファイルのボリュームにのみ存在します。
接続済み仮想インスタンス	仮想サーバー・インスタンスに接続されたボリュームがここにリストされます。 [アタッチ ] をクリックして、このボリュームをアタッチするインスタンスを選択してください。 詳しくは、インスタンスへのボリュームの接続を参照してください。
ステータス	このフィールドは、ボリュームのライフサイクル全体の状態を追跡します。ボリュームの作成から削除まで、その範囲は多岐にわたります。 たとえば、アタッチメントの状態は、ボリュームがインスタンスにアタッチされている場合は _添付_、アタッチ処理が進行中の場合は _添付_ となります。
名前	仮想サーバー・インスタンスの名前をクリックすると、インスタンスの詳細が表示されます。
自動削除	有効 になっている場合、インスタンスを削除するとボリュームは自動的に削除されます。 トグルをクリックして、自動削除を有効にします。
バックアップ・ポリシー	このボリュームに関連付けられているバックアップ・ポリシーを表示します。 バックアップ・ポリシーを関連付けるために、ターゲット・リソースのバックアップ・ポリシーのタグをこのボリュームに追加できます。 「適用」 をクリックしてバックアップ・ポリシーを選択し、ターゲット・リソースのタグをボリュームに適用します。

「 アクション 」メニューの「 」にあるボリューム詳細ページでは、以下の操作が可能です：

• アクティビティの追跡を表示- このボリュームのアクティビティ追跡ログを表示します。
• スナップショットの作成- 接続済みのデータボリュームまたはブートボリュームからスナップショットを作成します。 詳細については、「 コンソールでのスナップショットの作成 」を参照してください。
• イメージの作成- ブートボリュームからカスタムイメージを作成します。 この操作は、利用できない場合、グレー表示になります。 詳細については、 コンソールでボリュームからイメージを作成する を参照してください。
• ボリュームの拡張- 接続済みのボリュームのサイズを1 GB単位で拡大します。 詳しくは、ブロック・ストレージ・ボリュームの容量の拡張を参照してください。
• IOPSプロファイルの編集- IOPSプロファイルを編集してIOPS を増減させることで、接続されたデータボリュームのパフォーマンス特性を変更します。
• バックアップポリシーを適用- このボリュームにバックアップポリシーを適用します。 詳細については、「 リソースへのバックアップポリシーの適用 」を参照してください。
• ボリュームの移行- このボリュームを別のプロファイルに移行します。 詳細については、「 ブロックストレージボリュームの移行 」を参照してください。
• 削除- アタッチされていないボリュームを削除します。 詳細は、 コンソールでのデータボリュームの削除 を参照してください。

手動またはバックアップポリシーによって作成されたこのボリュームのスナップショットのリストを表示するには、「 スナップショットとバックアップ 」タブをクリックします。

インスタンスの詳細での接続された Block Storage for VPC ボリュームの詳細の表示

また、 仮想サーバーインスタンスの詳細ページから、接続された Block Storage for VPC ボリュームに関する情報を確認することもできます：

1. IBM Cloud コンソールで、ナビゲーションメニュー アイコン インフラストラクチャ コンピュート > 仮想サーバーインスタンス をクリックし、インスタンスを選択します。

2. **「接続済みブロック・ストレージ・ボリューム」**の下で、ボリュームの名前をクリックして、そのボリュームの詳細ページに移動します。

CLI からすべてのボリュームを表示する

すべてのボリュームに関する概要情報を一覧表示するには、次のコマンドを実行してください：

ibmcloud is volumes [--json]

リソース・グループ ID または名前を指定すると、そのリソース・グループに属するボリュームでリストがフィルターに掛けられます。 この引数を省略した場合、デフォルトですべてのリソースグループが対象となります。 特定のアベイラビリティー・ゾーン内のすべてのボリュームを表示することもできます。 デフォルトでは、1 ページあたり最初の 25 個のボリュームが表示されます。

以下の例では、アベイラビリティー・ゾーン内のすべてのリソース・グループに関するすべてのボリュームを表示します。

ibmcloud is volumes

Listing volumes in all resource groups and region us-south under account Test Account as user test.user@ibm.com...
ID                                          Name                                            Status      Capacity   IOPS    Profile           Attachment state   Attachment type   Zone         Resource group   Catalog Offering Version   Catalog Offering Plan   Storage Generation
r006-1dad641f-3a17-4117-8bb6-e30e09e64dff   my-2nd-data-volume                              available   9600       48000   5iops-tier        unattached         -                 us-south-2   Default          -                          -                       1
r006-f336511e-ece5-4407-9c8e-ef030c94aaa0   my-3rd-data-volume                              available   4800       48000   10iops-tier       unattached         -                 us-south-2   Default          -                          -                       1
r006-45ca6ddd-9942-4dd2-9ae9-d3edcb9fa076   my-data-volume-1                                available   300        3000    5iops-tier        unattached         -                 us-south-2   Default          -                          -                       1
r006-6a1ac889-d232-4beb-84dd-93c63cf9a156   my-data-volume-2                                available   300        3000    5iops-tier        unattached         -                 us-south-2   Default          -                          -                       1
r006-862ddcd3-59a6-4c69-9a10-275c894195b9   my-new-boot-volume                              available   250        3000    general-purpose   unattached         -                 us-south-2   Default          -                          -                       1
r006-145fb6c8-8e03-4a9f-bcd7-3bb131d30f05   my-sdp-volume                                   available   250        3000    sdp               attached.          -                 us-south-2   Default          -                          -                       2
r006-693f555e-fec7-4afb-b1e3-a16bf8b0d744   my-virtual-server-instance-boot-1756849222000   available   100        3000    general-purpose   attached           boot              us-south-2   Default          -                          -                       1

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

CLI からボリュームの詳細を表示する

特定のボリュームの詳細を表示するには、次のコマンドを実行します。 ボリュームの識別には、ボリューム名またはIDを使用できます。

ibmcloud is volume VOLUME_ID [--json]

以下の例を参照してください。

ibmcloud is volume my-sdp-volume

Getting volume my-sdp-volume  under account under account Test Account as user test.user@ibm.com...
ID                                     r006-145fb6c8-8e03-4a9f-bcd7-3bb131d30f05
Name                                   my-sdp-volume
CRN                                    crn:v1:bluemix:public:is:us-south-2:a/a1234567::volume:r006-145fb6c8-8e03-4a9f-bcd7-3bb131d30f05
Status                                 available
Attachment state                       attached
Capacity                               250
IOPS                                   3000
Bandwidth(Mbps)                        1000
Profile                                sdp
Encryption key                         -
Encryption                             provider_managed
Resource group                         Default
Created                                2025-06-23T16:35:10+00:00
Zone                                   us-south-2
Health State                           ok
Volume Attachment Instance Reference   Attachment type   Instance ID                                 Instance name                Auto delete   Attachment ID                               Attachment name
                                       data              0726_6cf2d984-e825-458d-8048-11572b72d040   my-virtual-server-instance   false         0717-beec02ac-7edf-4b59-ab9f-7c004bf4d8fa   outpour-perm-cosmic-gander
Active                                 true
Adjustable IOPS                        true
Adjustable Capacity States             unattached,attached
Adjustable IOPS States                 unattached,attached
Busy                                   false
Tags                                   -
Storage Generation                     2

この例では、ボリュームは仮想サーバーインスタンスにアタッチされているため、コマンドの出力にはボリュームアタッチメントとインスタンスの名前とIDも表示されます。 ボリュームがアタッチされている仮想サーバー・インスタンスが実行中であるため、 Active プロパティは true。 値 false を持つ Busy プロパティは、このボリュームがシリアライズが必要な操作を実行していないことを示す。

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

ブートボリューム用の追加CLIプロパティ

ブートボリュームの詳細を表示するようリクエストすると、レスポンスにいくつかの追加プロパティが返される。 以下の例を参照してください。

ibmcloud is volume r006-77851646-75da-4bd0-8bbd-ed86fdec0b0e

Getting volume r006-77851646-75da-4bd0-8bbd-ed86fdec0b0e under account Test Account as user test.user@ibm.com...
ID                                     r006-77851646-75da-4bd0-8bbd-ed86fdec0b0e
Name                                   vsi-test-boot-1712686424000
CRN                                    crn:v1:bluemix:public:is:us-south-2:a/a1234567::volume:r006-77851646-75da-4bd0-8bbd-ed86fdec0b0e
Status                                 available
Attachment state                       attached
Capacity                               100
IOPS                                   3000
Bandwidth(Mbps)                        393
Profile                                general-purpose
Encryption key                         -
Encryption                             provider_managed
Resource group                         defaults
Created                                2025-04-01T18:18:57+00:00
Zone                                   us-south-2
Health State                           ok
Volume Attachment Instance Reference   Attachment type   Instance ID                                 Instance name   Auto delete   Attachment ID                               Attachment name
                                       boot              0727_a9910bc9-3ea0-40d2-b3de-2b03e752f989   vsi-lvm-test    true          0727-7ff0df1b-ba0b-40c7-ad99-122819342f39   prissy-reason-unselect-overcome
Operating system                       CentOS Stream 9 - Minimal Install (amd64)
Source image                           ID                                          Name
                                       r006-0950e619-325e-446e-b895-e0bdd21dd1ea   ibm-centos-stream-9-amd64-9
Active                                 true
Adjustable IOPS                        false
Busy                                   false
Tags                                   -
Storage Generation                     1
Allowed Use API Version                2025-03-31
Allowed Use Bare Metal Server          true
Allowed Use Instance                   true

使用許可プロパティは、親ブートボリュームが作成されたソースイメージまたはスナップショットから継承されます。 CLIまたはAPIを使用すると、インスタンスの作成時やブートボリュームの更新時にこれらの値を上書きできます。 これらの更新を行うには、 is.volume.volume.manage-allowed-use IAMロールが必要です。

これらのプロパティは、ブール値の 共通表現言語式を構成する。 式が true と評価された場合、仮想サーバーインスタンスまたはベアメタルサーバーのプロビジョニングは、ブートボリュームまたはブートボリュームから作成されたイメージで許可されます。 式が false と評価されると、プロビジョニングはブロックされる。 詳しくは、 カスタム画像への使用許可表現の追加を 参照してください。

APIで全ボリュームを表示

GET /volumes 呼び出しを実行すると、すべてのボリュームに関する要約情報をリストできます。 以下の例を参照してください。

curl -X GET "$vpc_api_endpoint/v1/volumes?version=2025-01-212&generation=2" \
-H "Authorization: Bearer $iam_token"

正常な応答は、次の例のようになります。 この例では、3 つのデータ・ボリュームを示しています。 リストの2番目はインスタンスに関連付けられています。

[
  {
    "active": false,
    "attachment_state": "unattached",
    "bandwidth": 393,
    "busy": false,
    "capacity": 100,
    "created_at": "2025-01-22T00:54:01.000Z",
    "crn": "crn:v1:bluemix:public:is:us-south-2:a/a1234567::volume:r006-5ed4006b-3dac-4c95-8eeb-4aa9a85cbd34",
    "encryption": "provider_managed",
    "health_reasons": [],
    "health_state": "ok",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/r006-5ed4006b-3dac-4c95-8eeb-4aa9a85cbd34",
    "id": "r006-5ed4006b-3dac-4c95-8eeb-4aa9a85cbd34",
    "iops": 3000,
    "name": "my-data-volume",
    "profile": {
        "href": "https://us-south.iaas.cloud.ibm.com/v1/volume/profiles/general-purpose",
        "name": "general-purpose"
    },
    "resource_group": {
        "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/6edefe513d934fdd872e78ee6a8e73ef",
        "id": "6edefe513d934fdd872e78ee6a8e73ef",
        "name": "defaults"
    },
    "source_snapshot": {
        "crn": "crn:v1:bluemix:public:is:us-south:a/a1234567::snapshot:r006-8428038a-a399-4894-8c84-c8d7a4a75fae",
        "href": "https://us-south.iaas.cloud.ibm.com/v1/snapshots/r006-8428038a-a399-4894-8c84-c8d7a4a75fae",
        "id": "r006-8428038a-a399-4894-8c84-c8d7a4a75fae",
        "name": "wdc-fst-rstore-c6a092f34118-4505",
        "resource_type": "snapshot"
    },
    "status": "available",
    "status_reasons": [],
    "storage_generation": 1,
    "adjustable_capacity_states": [
        "attached"
    ],
    "user_tags": [
        "env:prod",
        "env:test"
    ],
    "volume_attachments": [],
    "zone": {
        "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-2",
        "name": "us-south-2"
    }
  },
  {
    "active": false,
    "allowed_use": {
      "api_version": "2025-03-31",
      "instance": "true",
      "bare_metal_server": "false"
    },
    "attachment_state": "attached",
    "bandwidth": 393,
    "busy": false,
    "capacity": 100,
    "created_at": "2024-04-01T16:48:16.000Z",
    "crn": "crn:v1:bluemix:public:is:us-south-1:a/a1234567::volume:r006-b5f15a27-ee2b-4d49-9344-9f3c17d42903",
    "encryption": "provider_managed",
    "health_reasons": [],
    "health_state": "ok",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/r006-b5f15a27-ee2b-4d49-9344-9f3c17d42903",
    "id": "r006-b5f15a27-ee2b-4d49-9344-9f3c17d42903",
    "iops": 3000,
    "name": "my-vsi--boot-volume-1711989834000",
    "operating_system": {
      "architecture": "amd64",
      "dedicated_host_only": false,
      "display_name": "Ubuntu Linux® 20.04 LTS Focal Fossa Minimal Install (amd64)",
      "family": "Ubuntu Linux",
      "gpu_supported": [],
      "href": "https://us-south.iaas.cloud.ibm.com/v1/operating_systems/ubuntu-20-04-amd64",
      "name": "ubuntu-20-04-amd64",
      "resource_type": "operating_system",
      "vendor": "Canonical",
      "version": "20.04 LTS Focal Fossa Minimal Install"
    },
    "profile": {
        "href": "https://us-south.iaas.cloud.ibm.com/v1/volume/profiles/general-purpose",
        "name": "general-purpose"
    },
    "resource_group": {
        "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/6edefe513d934fdd872e78ee6a8e73ef",
        "id": "6edefe513d934fdd872e78ee6a8e73ef",
        "name": "defaults"
    },
    "source_image": {
        "crn": "crn:v1:bluemix:public:is:us-south:a/a1234567::image:r006-0e578411-53ab-44ba-a0f8-d003d0011993",
        "href": "https://us-south.iaas.cloud.ibm.com/v1/images/r006-0e578411-53ab-44ba-a0f8-d003d0011993",
        "id": "r006-0e578411-53ab-44ba-a0f8-d003d0011993",
        "name": "ibm-redhat-8-6-minimal-amd64-7",
        "resource_type": "image"
    },
    "status": "available",
    "status_reasons": [],
    "storage_generation": 1,
    "adjustable_capacity_states": [
        "attached"
    ],
    "user_tags": [
        "backup-policy-tag"
    ],
    "volume_attachments": [
        {
            "delete_volume_on_instance_delete": true,
            "device": {
                "id": ""
            },
            "href": "https://us-south.iaas.cloud.ibm.com/v1/instances/0717_70aa00c6-65c9-4523-8a43-893c6fa0d87d/volume_attachments/0717-0fbaf561-6390-48a4-bb28-240b20ded36e",
            "id": "0717-0fbaf561-6390-48a4-bb28-240b20ded36e",
            "instance": {
                "crn": "crn:v1:bluemix:public:is:us-south-1:a/a1234567::instance:0717_70aa00c6-65c9-4523-8a43-893c6fa0d87d",
                "href": "https://us-south.iaas.cloud.ibm.com/v1/instances/0717_70aa00c6-65c9-4523-8a43-893c6fa0d87d",
                "id": "0717_70aa00c6-65c9-4523-8a43-893c6fa0d87d",
                "name": "my-vsi-test",
                "resource_type": null
            },
            "name": "perfectly-parting-humble-skewer",
            "type": "boot"
        }
    ],
    "zone": {
        "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-1",
        "name": "us-south-1"
    }
  },
  {
    "active": false,
    "attachment_state": "unattached",
    "bandwidth": 393,
    "busy": false,
    "capacity": 10,
    "created_at": "2021-09-10T15:56:30.000Z",
    "crn": "crn:v1:bluemix:public:is:us-south-3:a/a1234567::volume:r006-ed2b09db-36da-4cd1-b862-fed933465fcc",
    "encryption": "provider_managed",
    "health_reasons": [],
    "health_state": "ok",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/r006-ed2b09db-36da-4cd1-b862-fed933465fcc",
    "id": "r006-ed2b09db-36da-4cd1-b862-fed933465fcc",
    "iops": 3000,
    "name": "my-other-data-volume",
    "profile": {
        "href": "https://us-south.iaas.cloud.ibm.com/v1/volume/profiles/general-purpose",
        "name": "general-purpose"
    },
    "resource_group": {
        "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/6edefe513d934fdd872e78ee6a8e73ef",
        "id": "6edefe513d934fdd872e78ee6a8e73ef",
        "name": "defaults"
    },
    "status": "available",
    "status_reasons": [],
    "storage_generation": 1,
    "adjustable_capacity_states": [
        "attached"
    ],
    "user_tags": [],
    "volume_attachments": [],
    "zone": {
        "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-3",
        "name": "us-south-3"
    }
  }
]

API を使用したボリュームの詳細情報の確認

GET /volumes/{id} 呼び出しを実行すると、ボリュームの詳細を表示できます。 以下の例を参照してください。

curl -X GET "$vpc_api_endpoint/v1/volumes/$volume_id?version=2025-01-21&generation=2" \
-H "Authorization: Bearer $iam_token"

応答が成功すると、容量やIOPSなどのボリュームの詳細、ボリュームの状態、およびそのボリュームがインスタンスにアタッチされているかどうかが表示されます。

{
  "active": false,
  "adjustable_capacity_states": ["attached"],
  "adjustable_iops_states": ["attached"],
  "allowed_use": {
    "api_version": "2025-03-31",
    "instance": "true",
    "bare_metal_server": "false"
  },
  "attachment_state": "attached",
  "bandwidth": 1000,
  "busy": false,
  "capacity": 100,
  "created_at": "2024-10-07T23:16:53.000Z",
  "crn": "crn:v1:bluemix:public:is:us-south-1:a/a1234567::volume:r006-1a6b7274-678d-4dfb-8981-c71dd9d4daa5",
  "encryption": "user_managed",
  "encryption_key": {
    "crn": "crn:v1:bluemix:public:kms:us-south:a/a1234567:e4a29d1a-2ef0-42a6-8fd2-350deb1c647e:key:5437653b-c4b1-447f-9646-b2a2a4cd6179"
  },
  "health_reasons": [],
  "health_state": "ok",
  "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/r006-1a6b7274-678d-4dfb-8981-c71dd9d4daa5",
  "id": "r006-1a6b7274-678d-4dfb-8981-c71dd9d4daa5",
  "iops": 1000,
  "name": "my-volume",
  "profile": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/volume/profiles/custom",
    "name": "custom"
  },
  "resource_group": {
    "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/fee82deba12e4c0fb69c3b09d1f12345",
    "id": "fee82deba12e4c0fb69c3b09d1f12345",
    "name": "Default"
  },
  "resource_type": "volume",
  "status": "available",
  "status_reasons": [],
  "storage_generation": 1,
  "user_tags": [],
  "volume_attachments": [
    {
      "delete_volume_on_instance_delete": false,
      "href": "https://us-south.iaas.cloud.ibm.com/v1/instances/0717_e21b7391-2ca2-4ab5-84a8-b92157a633b0/volume_attachments/0717-82cbf856-9cbb-45fb-b62f-d7bcef32399a",
      "id": "0717-82cbf856-9cbb-45fb-b62f-d7bcef32399a",
      "instance": {
        "crn": "crn:v1:bluemix:public:is:us-south-1:a/a1234567::instance:0717_e21b7391-2ca2-4ab5-84a8-b92157a633b0",
        "href": "https://us-south.iaas.cloud.ibm.com/v1/instances/0717_e21b7391-2ca2-4ab5-84a8-b92157a633b0",
        "id": "0717_e21b7391-2ca2-4ab5-84a8-b92157a633b0",
        "name": "my-instance",
        "resource_type": "instance"
      },
      "name": "my-volume-attachment",
      "type": "data"
    }
  ],
  "zone": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-1",
    "name": "us-south-1"
  }
}

ブートボリューム用の追加APIプロパティ

ブートボリュームの詳細を表示するように要求すると、 GET /volumes および GET /volumes/{id} のリクエストに対する応答として、いくつかの追加のプロパティが返されます。

• active プロパティーは、ボリュームが接続されている仮想サーバー・インスタンスが実行中か停止しているかを示します。 active = true を実行すると、インスタンスが起動し、 ブートボリュームからのイメージ 作成など、インスタンスの起動を必要とする操作も正常に動作します。

• busy プロパティーは、シリアライズの必要がある操作をこのボリュームが実行しているかどうかを示します。 操作でシリアライズが必要な場合、このプロパティが false に設定されていないと、その操作は失敗します。

• 使用許可式は、親ブートボリュームが作成されたソースイメージまたはスナップショットから継承されます。 使用許可表現は、デタッチされたブート・ボリュームでのみ更新できます。 CLIまたはAPIを使用して、インスタンスの作成時またはブート・ボリュームの更新時にこれらの値を上書きできます。 これらの更新を行うには、 is.volume.volume.manage-allowed-use IAMロールが必要です。 これらのプロパティは、ブール値の 共通表現言語式を構成する。 式が true と評価された場合、仮想サーバーインスタンスまたはベアメタルサーバーのプロビジョニングは、ブートボリュームまたはブートボリュームから作成されたイメージで許可されます。 式が false と評価されると、プロビジョニングはブロックされる。 詳しくは、 カスタム画像への使用許可表現の追加を 参照してください。

以下の例を参照してください。

  "active": "true",
  "busy": "false",
  "capacity": 100,
  "created_at": "2022-12-08T06:26:17Z",
  "crn": "crn:[...]",
  "encryption": "provider_managed",
  "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/ccbe6fe1-5680-4865-94d3-687076a38293",
  "id": "ccbe6fe1-5680-4865-94d3-687076a38293",
  "iops": 300,
  "name": "boot-volume-1",
  "allowed_use": {
    "api_version": "2025-03-31",
    "instance": "true",
    "bare_metal_server": "false"
  },
  .
  .
  .

Terraformで全ボリュームを表示

アカウントに属するボリュームのリストを読み取り専用データソースとしてインポートします。 ボリューム名、ゾーン名、アタッチメントの状態、暗号化の種類、オペレーティングシステムのファミリー（起動ボリュームに適用）、またはオペレーティングシステムのアーキテクチャ（起動ボリュームに適用）でフィルタリングできます。

data "ibm_is_volumes" "example" {
}

エクスポートされる属性には、ボリュームの総数とボリュームのリストが含まれます。 ネストされた属性には、ボリュームID、名前、作成日、サイズ、IOPS、CRN、アクセスおよびユーザータグ、プロファイル、暗号化タイプおよびキー、ライフサイクル状態、健全性状態および理由、オペレーティングシステム、その他の属性が含まれます。

詳細については、 ibm_is_volumes を参照してください。

Terraformでボリュームの詳細を表示する

ボリュームの詳細を読み取り専用データソースとしてインポートします。 ボリュームをIDまたは名前で識別する必要があります。

data "ibm_is_volume" "example1" {
  name = ibm_is_volume.example.name
}

エクスポートされる属性には、ボリュームの総数とボリュームのリストが含まれます。 ネストされた属性には、ボリュームID、名前、作成日、サイズ、IOPS、CRN、アクセスおよびユーザータグ、プロファイル、暗号化タイプおよびキー、ライフサイクル状態、健全性状態および理由、オペレーティングシステム、その他の属性が含まれます。

詳細はibm_is_volume を参照してください。

ブートボリューム用の追加のTerraformプロパティ

使用許可式は、親ブートボリュームが作成されたソースイメージまたはスナップショットから継承されます。 使用許可表現は、デタッチされたブート・ボリュームでのみ更新できます。 Terraformを使うと、インスタンスを作成するときやブートボリュームを更新するときにこれらの値を上書きすることができます。 これらの更新を行うには、 is.volume.volume.manage-allowed-use IAMロールが必要です。 これらのプロパティは、ブール値の 共通表現言語式を構成する。 式が true と評価された場合、仮想サーバーインスタンスまたはベアメタルサーバーのプロビジョニングは、ブートボリュームまたはブートボリュームから作成されたイメージで許可されます。 式が false と評価されると、プロビジョニングはブロックされる。 詳しくは、 カスタム画像への使用許可表現の追加を 参照してください。