IBM Cloud Docs

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

すべての Block Storage for VPC ボリュームを一覧表示し、1 つのボリュームの詳細を表示します。インスタンスの詳細で、添付された Block Storage for VPC ボリュームの詳細を表示します。 Block Storage for VPC ボリュームから作成されたすべてのスナップショットを表示します。

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

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

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

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

アクションメニューの選択項目は、ボリュームがブートボリューム、アタッチされたデータボリューム、またはアタッチされていないデータボリュームのいずれであるかによって変わります。

表示中のボリュームが起動ボリュームの場合、利用可能なアクションは 「イメージの作成 」、「スナップショットの作成 」、および 「インスタンスからの切り離し 」です。
表示されているボリュームがアタッチされたデータボリュームの場合、利用可能なアクションは 「スナップショットの作成 」、「インスタンスからの切り離し 」、「削除 」です。
表示されているボリュームがアタッチされていないデータボリュームの場合、実行可能なアクションは 「インスタンスにアタッチ」 と 「削除」 です。

これらのアクションの詳細については、以下のトピックを参照してください：

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

Block Storage for VPC ボリュームの詳細を表示するには、すべての Block Storage for VPC ボリュームのリストに移動し、ボリュームを選択します。

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

ボリューム固有の情報。

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

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

アクション］メニューの選択項目は、ボリュームがブート・ボリューム、アタッチされたデータ・ボリューム、またはアタッチされていないデータ・ボリュームのいずれであるかによって変わります。

スナップショットを作成する- 添付データボリュームまたはブートボリュームからスナップショットを作成できます。詳細は、コンソールでスナップショットを作成するを参照してください。
イメージの作成- 起動ボリュームからイメージを作成できます。詳細については、コンソールでボリュームからイメージを作成するを参照してください。
ボリュームの拡張- 接続されたボリュームのサイズを 1 GB 単位で増やすことができます。詳細については、「データ容量の拡張」および「起動ボリュームの容量拡張」を参照してください。
IOPSプロファイルの編集- IOPSプロファイルを編集してIOPSを増減させることで、接続されたデータボリュームのパフォーマンス特性を変更することができます
削除- 接続されていないボリュームを削除できます。詳細は、コンソールでのデータボリュームの削除を参照してください。

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

Block Storage for VPC ボリュームのすべてのスナップショットを表示

Block Storage for VPC ブートボリュームまたはデータボリュームのスナップショットを作成した場合、ボリュームの詳細ページの2番目のタブでスナップショットを確認できます。

スナップショットとバックアップ] タブをクリックすると、スナップショットの名前、ステータス、サイズ、暗号化の種類、作成日などの情報を含むスナップショットのリストが表示されます。また、スナップショットがユーザーによって作成されたものか、バックアップポリシーによって作成されたものかも表示されます。スナップショットは降順に表示され、最近作成されたスナップショットが最初に表示されます。

ボリュームの詳細ページでは、スナップショットの詳細を確認したり、スナップショットを作成したり、スナップショットを管理したりできます。例えば、「アクション」メニューから、最新のスナップショットを削除できます。詳しくは、以下のいずれかのトピックを参照してください。

ボリュームに関連付けられたすべてのバックアップポリシーを表示する

3rd ボリュームの詳細ページの Block Storage for VPC タブで、そのボリュームに関連するすべてのバックアップポリシーを表示します。このボリュームに適用されているユーザータグを持つすべてのポリシーが一覧表示されます。

バックアップポリシータブをクリックします。このボリュームに適用されているユーザータグを持つすべてのポリシーが一覧表示されます。リストには以下の情報が記載されている：

Block Storage for VPCボリュームに関連付けられたバックアップ・ポリシー。
フィールド	説明
ポリシー名	ポリシー名をクリックすると、そのバックアップ・ポリシーに移動します。
ステータス	バックアップ・ポリシーの状況.
最終実行時刻	バックアップを作成したバックアップ・ポリシーの最終スケジュール実行。

このボリュームに新しいバックアップ・ポリシーを適用するには、［ アタッチ］をクリックします。サイドパネルで、メニューからバックアップポリシーを選択し、ボリュームに適用するポリシータグを選択します。また、その保険を利用するかどうかの判断材料となるプランの詳細も見ることができる。問題がなければ、ポリシーとタグの適用をクリックします。

ポリシーにボリュームを追加したい場合は、バックアップポリシーのターゲットリソースのタグにあるボリュームにユーザータグを追加します。バックアップポリシーに含まれるボリュームからタグを削除すると、そのボリュームはポリシーによってバックアップされなくなります。

詳細については、リソースへのバックアップ・ポリシーの適用を参照してください。

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

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

IBM Cloud コンソールで、ナビゲーションメニュー アイコン インフラストラクチャ コンピュート > 仮想サーバーインスタンス をクリックし、インスタンスを選択します。
**「接続済みブロック・ストレージ・ボリューム」**の下で、ボリュームの名前をクリックして、そのボリュームの詳細ページに移動します。

CLI からの Block Storage for VPC ボリュームの表示

CLI を使用して、1 つの Block Storage for VPC ボリュームに関する詳細、またはすべてのボリュームに関する要約情報を表示できます。

CLI を使用する前に、IBM Cloud CLI および VPC CLI プラグインをインストールする必要があります。詳しくは、CLI の前提条件を参照してください。

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

以下のコマンドを実行して、全ボリュームのサマリー情報を一覧表示する：

ibmcloud is volumes [--json]

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

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

$ ibmcloud is volumes
Listing volumes in all resource groups and region us-east under account Test Account as user test.user@ibm.com...
ID                                          Name                                      Status      Capacity   IOPS   Profile           Attachment state   Attachment type   Zone        Resource group
r014-0a7c28f3-3612-46e6-b874-51136c7f1def   concurrent-vol-09afy4vz700                unusable    20         3000   general-purpose   unattached         -                 us-east-1   defaults
r014-faefcc1d-f899-4688-ae97-67e5079da702   concurrent-vol-1s26tgtqg70                unusable    20         3000   general-purpose   unattached         -                 us-east-1   defaults
r014-f0e809bf-9afb-4006-b2a8-274f81f0f34e   concurrent-vol-8xif5f1tid0                unusable    20         3000   general-purpose   unattached         -                 us-east-1   defaults
r014-b8e23307-e93e-4f7b-918f-7b2c2b14b132   concurrent-vol-gpwucqfpni0                available   20         3000   general-purpose   attached           data              us-east-1   defaults
r014-a64beeee-be50-4c03-8cee-639106cea1e2   concurrent-vol-mh16478vln0                available   20         3000   general-purpose   attached           data              us-east-1   defaults
r014-f14f8d39-2cf3-4f5d-b366-1d234f1c74aa   concurrent-vol-n7fcoxmb860                available   20         3000   general-purpose   attached           data              us-east-1   defaults
r014-84ff8138-4f4f-434b-bdc3-45d1aaaa4329   csi-boot-vol-pgb1-oqpm7een                available   100        3000   general-purpose   attached           boot              us-east-1   Default
r014-a1f6b311-6e4b-4e27-a216-a0b602471268   csi-boot-vol-qgbi-h76dy77d                available   100        3000   general-purpose   attached           boot              us-east-1   Default
r014-158e904d-0d48-4090-b6c1-57617c1fcc20   csi-boot-vol-txmz-54wzen5m                available   100        3000   general-purpose   attached           boot              us-east-1   Default
r014-dee9736d-08ee-4992-ba8d-3b64a4f0baac   demo-volume-update                        available   100        3000   general-purpose   attached           data              us-east-1   defaults
r014-eef16365-17e3-4627-bc8b-c7c3dd1d6a81   kj-test-ro-boot-1629867631000             available   100        3000   general-purpose   attached           boot              us-east-1   defaults

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

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

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

ibmcloud is volume VOLUME_ID [--json]

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

$ ibmcloud is volume demo-volume-update
Getting volume demo-volume-update under account Test Account as user test.user@ibm.com...

ID                                     r014-dee9736d-08ee-4992-ba8d-3b64a4f0baac
Name                                   demo-volume-update
CRN                                    crn:v1:bluemix:public:is:us-east-1:a/a1234567::volume:r014-dee9736d-08ee-4992-ba8d-3b64a4f0baac
Status                                 available
Attachment state                       attached
Capacity                               100
IOPS                                   3000
Bandwidth(Mbps)                        393
Profile                                general-purpose
Encryption key                         -
Encryption                             provider_managed
Resource group                         defaults
Created                                2023-06-29T16:14:59+00:00
Zone                                   us-east-1
Health State                           ok
Volume Attachment Instance Reference   Attachment type   Instance ID                                 Instance name   Auto delete   Attachment ID                               Attachment name
                                       data              0757_11f5db7f-35a1-4678-bcbd-c85204e09507   kj-test-ro      false         0757-4dfc4384-c4b5-497e-bab3-6415f9c4d44b   otp

Active                                 true
Adjustable Capacity States             attached
Adjustable IOPS States                     
Busy                                   false
Tags                                   -
Storage Generation                     1

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

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

API を使用した Block Storage for VPC ボリュームの表示

VPC REST API を呼び出して、 Block Storage for VPC ボリュームをプログラマチックに表示します。すべてのボリュームをリストし、特定のボリュームの詳細を表示することができます。

始める前に、API 環境をセットアップしてください。

APIで全ボリュームを表示

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

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

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

[
  {
    "active": false,
    "adjustable_iops_supported": 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,
    "adjustable_iops_supported": 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/811f8abfbd32425597dc7ba40da98fa6::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,
    "adjustable_iops_supported": 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: $iam_token"

正常に応答すると、容量やIOPSを含むボリュームの詳細、ボリュームのステータス、ボリュームがインスタンスにアタッチされているかどうかが提供されます。

{
  "active": true,
  "bandwidth": 128,
  "busy": false,
  "capacity": 100,
  "created_at": "2022-12-09T06:26:17Z",
  "crn": "crn:[...]",
  "encryption": "provider_managed",
  "health_reasons": [],
  "health_state": "ok",
  "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/ccbe6fe1-5680-4865-94d3-687076a38293",
  "id": "ccbe6fe1-5680-4865-94d3-687076a38293",
  "iops": 1000,
  "name": "my-volume-1",
  "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/4bbce614c13444cd8fc5e7e878ef8e21",
    "id": "4bbce614c13444cd8fc5e7e878ef8e21",
    "name": "Default"
  },
  "status": "available",
  "status_reasons": [],
  "storage_generation": 1,
  "user_tags": [],
  "volume_attachments": [
    {
      "delete_volume_on_instance_delete": true,
      "href": "https://us-south.iaas.cloud.ibm.com/v1/instances/33bd5872-7034-462b-9f3e-d400c49d347a/volume_attachments/b31c1a5a-122a-4e32-a10b-f2c31271de85",
      "id": "b31c1a5a-122a-4e32-a10b-f2c31271de85",
      "instance": {
        "crn": "crn:[...]",
        "href": "https://us-south.iaas.cloud.ibm.com/v1/instances/33bd5872-7034-462b-9f3e-d400c49d347a",
        "id": "33bd5872-7034-462b-9f3e-d400c49d347a",
        "name": "instance-1",
        "resource_type": "instance"
      },
      "name": "volume-attachment-1",
      "type": "data"
    }
  ],
  "zone": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-2",
    "name": "us-south-2"
  }
}

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

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

active プロパティーは、ボリュームが接続されている仮想サーバー・インスタンスが実行中か停止しているかを示します。 active = true の場合、インスタンスは実行中であり、ブート・ボリュームからのイメージ作成など、実行中のインスタンスを必要とする操作も機能します。
busy プロパティーは、シリアライズの必要がある操作をこのボリュームが実行しているかどうかを示します。操作がシリアライズを必要とする場合、このプロパティが 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",
  .
  .
  .

Block Storage for VPC のボリュームをTerraformで表示

Terraformを使用して、 Block Storage for VPC ボリュームに関する情報を表示できます。

Terraform を使用するには、Terraform CLI をダウンロードし、 IBM Cloud プロバイダプラグインを設定します。詳細については、「Terraformの始め方」を参照してください。

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

デフォルト以外の地域をターゲットとする例として、次の例を参照してください。 us-south。

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

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
}