Block Storage for VPC ボリュームの管理

仮想サーバーインスタンスからの Block Storage for VPC ボリュームのデタッチ

仮想サーバー・インスタンスに接続されているブロック・ストレージ・ボリュームを切り離すことができます。 切り離しによってボリュームが解放され、別のインスタンスが使用できるようになります。

ボリュームを切り離すには、以下の手順を実行します。

1. すべてのブロック・ストレージ・ボリュームのリストに移動します。 IBM Cloud コンソールで、 Navigation > Infrastructure > Storage > Block Storage ボリュームをクリックします。
2. ボリュームの位置を確認し、アクションアイコン オプションのリストを開きます。
3. オプション・メニューから、**「インスタンスから切り離し」**をクリックします。
4. 開いたウィンドウで**「インスタンスの切り離し」**をクリックして確認します。

あるいは、すべてのブロック・ストレージ・ボリュームのリストで個別のボリュームをクリックし、そのボリュームの**「ボリューム詳細」**ページに移動します。 **「接続済みインスタンス」**で、仮想サーバー・インスタンスの横にある負符号をクリックして、そのインスタンスからボリュームを切り離します。

IBM Cloud® Virtual Private Cloud インスタンスの Hyper Protect Virtual Servers を使用する場合、実行中のインスタンスに接続されているデータ・ボリュームを切り離すと、インスタンスで実行されているワークロードが失敗します。 そのため、データ・ボリュームを切り離さないことをお勧めします。

ある仮想サーバーインスタンスから別の仮想サーバーインスタンスへの Block Storage for VPC ボリュームの転送

ブロックストレージボリュームを別の仮想サーバーインスタンスに転送するには、以下の手順を実行します。

1. ボリュームをその仮想サーバー・インスタンスから切り離します。
2. ボリュームの転送先の仮想サーバー・インスタンスに移動します。 IBM Cloud コンソールで、ナビゲーションメニュー アイコン インフラストラクチャ コンピュート > 仮想サーバーインスタンス をクリックします。
3. リストから仮想サーバー・インスタンスを選択します。
4. ストレージ ］タブをクリックすると、サーバーに接続されているすべてのボリュームが表示されます。
5. アタッチ＋ ボリュームの追加をクリックします。 利用可能なすべてのブロック・ストレージ・ボリュームが表示される。
6. ボリュームのリストから、前に切り離したボリュームを選択します。
7. 保存 をクリックします。

スタンドアロン Block Storage for VPC データボリュームのアタッチ

インスタンスのプロビジョニング中に複数のブロックストレージデータボリュームを作成することができ、これらのボリュームは新しい仮想サーバーインスタンスに自動的にアタッチされます。 インスタンスからボリュームをデタッチすると、そのボリュームはスタンドアロン・ボリュームとして存在し、アタッチメント・タイプのない すべてのブロック・ストレージ・ボリュームの リストに表示されます。 ブロック・ストレージ・ボリュームのリストから別のインスタンスに接続できます。

1. すべてのブロック・ストレージ・ボリュームのリストに移動します。 IBM Cloud コンソールで、 Navigation > Infrastructure > Storage > Block Storage ボリュームをクリックします。
2. ボリュームを見つけて、 「アクション」 アイコン をクリックし、オプションのリストを開きます。
3. オプション・メニューから**「インスタンスに接続 (Attach to instance)」**をクリックします。
4. 使用可能な仮想サーバー・インスタンスを選択します。
5. Attachをクリックして選択を確定します。

Block Storage for VPC ボリューム名の更新

既存のボリュームの名前を変更して、より分かりやすい名前にすることができます。

1. すべてのブロック・ストレージ・ボリュームのリストに移動します。 IBM Cloud コンソールで、 Navigation > Infrastructure > Storage > Block Storage ボリュームをクリックします。

2. ボリュームを見つけ、ボリュームの名前をクリックして「ボリューム詳細」ページに移動します。

3. 名前を編集するには、ボリューム名の後にある編集アイコン クリックします。 有効なボリューム名を入力してください。

   有効なボリューム名には、英小文字および数字 (a-z、0-9) とハイフン (-) を組み合わせて最大 63 文字まで含めることができます。 ボリューム名の先頭は小文字にする必要があります。 ボリューム名は、VPC インフラストラクチャー全体で固有でなければなりません。 たとえば、同じアカウントリージョンに同じ名前のボリュームを2つ作成すると、 volume name duplicate エラーが発生します。

4. 編集内容を確認します。

コンソールでBlock Storage for VPCボリュームにユーザータグを追加する

ボリュームのリストまたはボリュームの詳細ページから、ブロックストレージにユーザータグを追加する。

1. ブロック・ストレージ・ボリュームのリストに移動する。 IBM Cloud コンソールで、 Navigation > Infrastructure > Storage > Block Storage ボリュームをクリックします。

2. ユーザー・タグを追加するボリュームをリストから見つけます。

3. 「タグ」 列で、 「タグの追加」 をクリックします。

4. このボリュームに適用するユーザータグを入力します。 入力すると、タグが表示されます。

   ボリュームにアクセス管理タグを追加することもできます。 アクセス管理タグの作成および追加について詳しくは、 ボリュームへのアクセス管理タグの適用 を参照してください。

5. タグの追加が完了したら、 「保存」 をクリックします。 画面を更新すると、ボリュームのリストには、 タグ列に追加されたタグの数が表示されます。

ボリュームの詳細ページからタグを追加することもできます。 そのためには、以下の手順に従ってください。

1. ブロック・ストレージ・ボリュームのリストに移動する。
2. ボリュームの詳細で、ボリューム名の横にある 「タグの追加」 をクリックします。
3. このボリュームに適用するユーザータグを入力します。 完了したら、**「保存」**をクリックします。

コンソールでバックアップポリシーに関連付けられたユーザータグをボリュームに追加する

バックアップ ポリシーに関連付けられたユーザー タグをブロック ストレージ ボリュームに追加できます。 バックアップ・ポリシーは、バックアップ・スナップショットの自動作成をスケジュールします。 1 つのボリューム・タグがターゲット・リソースのバックアップ・ポリシー・タグと一致すると、ボリューム内容のバックアップがトリガーされます。 バックアップ・ポリシーは、バックアップ・スナップショットを取得するタイミングをスケジュールするバックアップ計画を定義します。

「ボリュームの詳細」 ページから、ボリュームに適用されているバックアップ・ポリシーを表示したり、バックアップ・ポリシーに関連付けられているユーザー・タグを追加したりすることができます。

1. ブロック・ストレージ・ボリュームのリストに移動する。 IBM Cloud コンソールで、 Navigation > Infrastructure > Storage > Block Storage ボリュームをクリックします。
2. 目的のボリュームを探し、名前のリンクをクリックします。
3. ブロックストレージの詳細ページで、 バックアップポリシータブをクリックします。
4. **「アタッチ」**をクリックします。
5. サイドパネルで、利用可能なポリシーのリストからバックアップポリシーを選択し、ボリュームに適用するポリシータグを選択します。 また、その保険を利用するかどうかの判断材料となるプランの詳細も見ることができる。
6. ポリシーとタグの適用をクリックします。 バックアップポリシーは、ボリュームに関連付けられているバックアップポリシーのリストに表示されます。

「バックアップ・ポリシー」ページに移動すると、タグを追加したボリュームがボリュームのリストに表示されます。

バックアップの作成の詳細については、 バックアップポリシーの作成を 参照してください。 ユーザー・タグについて詳しくは、タグの操作を参照してください。

ボリューム名の更新

ボリューム名を変更するには、ボリューム名またはボリューム ID のいずれかを指定してから、新しい名前を示します。 ボリューム名は、最大 63 文字の英数字で構成でき、特殊文字を含めることができ、先頭は小文字でなければなりません。 ボリューム名は、VPC インフラストラクチャー全体で固有でなければなりません。

ibmcloud is volume-update VOLUME_ID [--name NEW_NAME] [--json]

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

ibmcloud is volume-update r006-5ed4006b-3dac-4c95-8eeb-4aa9a85cbd34 --name my-data-volume

Updating volume r006-5ed4006b-3dac-4c95-8eeb-4aa9a85cbd34 under account Test Account as user test.user@ibm.com...

ID                                     r006-5ed4006b-3dac-4c95-8eeb-4aa9a85cbd34   
Name                                   my-data-volume   
CRN                                    crn:v1:bluemix:public:is:us-south-2:a/a1234567::volume:r006-5ed4006b-3dac-4c95-8eeb-4aa9a85cbd34   
Status                                 available   
Attachment state                       unattached   
Capacity                               100   
IOPS                                   3000   
Bandwidth(Mbps)                        393   
Profile                                general-purpose   
Encryption key                         -   
Encryption                             provider_managed   
Resource group                         defaults   
Created                                2025-01-22T00:54:01+00:00   
Zone                                   us-south-2   
Health State                              
Volume Attachment Instance Reference   -   
Source snapshot                        ID                                          Name      
                                       r006-8428038a-a399-4894-8c84-c8d7a4a75fae   wdc-fst-rstore-c6a092f34118-4505      

Active                                 false   
Adjustable IOPS                        false   
Busy                                   false   
Tags                                   -
Storage Generation                     1

CLIからBlock Storage for VPCボリュームにユーザータグを追加する

ibmcloud is volume-update VOLUME コマンドに'--tags オプションを指定して、ボリュームのユーザータグを更新する。 ボリュームの引数は、ボリュームIDまたはボリューム名で定義できる。

同じオプションを使用して、'ibmcloud is volume-create を使用してボリュームを作成する際に、ボリュームにタグを追加します。

以下の例では、ID で識別されるボリュームにユーザー・タグ env:test および bkp:test を追加します。 出力には、名前、ステータス、容量、パフォーマンスプロファイル、場所などの情報が表示されます。 更新されたタグはレスポンスの最後に表示される。

ibmcloud is volume-update r006-5ed4006b-3dac-4c95-8eeb-4aa9a85cbd34 --tags dev:test

Updating volume r006-5ed4006b-3dac-4c95-8eeb-4aa9a85cbd34 under account Test Account as user test.user@ibm.com...

ID                                     r006-5ed4006b-3dac-4c95-8eeb-4aa9a85cbd34   
Name                                   my-data-volume   
CRN                                    crn:v1:bluemix:public:is:us-south-2:a/a1234567::volume:r006-5ed4006b-3dac-4c95-8eeb-4aa9a85cbd34   
Status                                 available   
Attachment state                       unattached   
Capacity                               100   
IOPS                                   3000   
Bandwidth(Mbps)                        393   
Profile                                general-purpose   
Encryption key                         -   
Encryption                             provider_managed   
Resource group                         defaults   
Created                                2025-01-22T00:54:01+00:00   
Zone                                   us-south-2   
Health State                              
Volume Attachment Instance Reference   -   
Source snapshot                        ID                                          Name      
                                       r006-8428038a-a399-4894-8c84-c8d7a4a75fae   wdc-fst-rstore-c6a092f34118-4505      

Active                                 false   
Adjustable IOPS                        false   
Busy                                   false   
Tags                                   dev:test  
Storage Generation                     1

CLIからのボリューム・アタッチメントの更新

ボリューム添付ファイル名を更新し、デフォルトの自動削除設定を変更するには、 instance-volume-attachment-update コマンドを使用します。

ibmcloud is instance-volume-attachment-update INSTANCE_ID VOLUME_ATTACHMENT_ID [--name NEW_NAME] [--auto-delete true | false] [--json]

--name オプションを使用し、ボリュームのアタッチメントに新しい名前を指定します。 インスタンスの削除時にボリュームが自動的に削除されるようにするには、 --auto-delete true を指定します。 インスタンスが削除された後もボリュームをスタンドアロン・ボリュームとして保持する場合は、 --auto-delete false を指定します。

ibmcloud is instance-volume-attachment-update doc-test-ro otp1 --name one-true-pairing --auto-delete false

Updating volume attachment otp1 of instance doc-test-ro under account Test Account as user test.user@ibm.com...
ID                0757-6757e676-0bf5-4b79-9a5b-29c24e17420c
Name              one-true-pairing
Volume            ID                                          Name
                  r014-dee9736d-08ee-4992-ba8d-3b64a4f0baac   demo-volume-update

Status            attached
Bandwidth(Mbps)   393
Type              data
Device            0757-6757e676-0bf5-4b79-9a5b-29c24e17420c-bxsh7
Auto delete       false
Created           2023-06-29T18:14:57+00:00

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

CLIからボリュームをデタッチする

instance-volume-attachment-detach コマンドを使用して、インスタンスからボリュームを切り離し、ボリューム接続を削除します。 ブロック・ストレージ・ボリュームは削除されません。後で別のインスタンスに接続できます。

このコマンドの構文では、INSTANCE はインスタンスの ID または名前です。 VOLUME_ATTACHMENT は、ボリューム接続の ID または名前です。 複数のボリューム接続を指定できます。 ボリューム接続について詳しくは、 ボリューム接続の作成 の CLI リファレンスを参照してください。

ibmcloud is instance-volume-attachment-detach INSTANCE (VOLUME_ATTACHMENT1 VOLUME_ATTACHMENT2 ...) [--output JSON] [-f, --force] [-q, --quiet]

ibmcloud is instance-volume-attachment-detach kj-test-ro one-true-pairing

This will delete volume attachment one-true-pairing and cannot be undone. Continue [y/N] ?> y
Deleting volume attachment one-true-pairing from instance kj-test-ro under account Test Account as user test.user@ibm.com...
OK
Volume attachment one-true-pairing is deleted.

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

インスタンスが存在する間は、ブート・ボリュームをインスタンスから切り離すことはできません。 インスタンスの削除後もブートボリュームを保持したい場合は、ボリュームアタッチメントの auto-delete オプションが false に設定されていることを確認してください。

APIによるボリューム名の更新

PATCH /volumes/{id} 呼び出しを実行して新しいボリューム名を指定します。

curl -X PATCH "$vpc_api_endpoint/v1/volumes?version=2022-04-22&generation=2" \
-H "Authorization: $iam_token" \
-d '{
      "name": "my-volume-4-update"
    }'

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

{
  "capacity": 50,
  "created_at": "2022-04-22T23:16:53.000Z",
  "crn": "crn:[...]",
  "encryption": "user_managed",
  "encryption_key": {
    "crn": "crn:[...]"
  },
  "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/2d1bb5a8-40a8-447a-acf7-0eadc8aeb054",
  "id": "2d1bb5a8-40a8-447a-acf7-0eadc8aeb054",
  "iops": 100,
  "name": "my-volume-4-update",
  "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/4bbce614c13444cd8fc5e7e878ef8e21",
    "id": "4bbce614c13444cd8fc5e7e878ef8e21",
    "name": "Default"
  },
  "status": "available",
  "status_reasons": [],
  "volume_attachments": [],
  "zone": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-2",
    "name": "us-south-2"
  }
}

APIを使用したBlock Storage for VPCボリュームへのユーザタグの追加

ユーザー・タグをボリュームに追加するには、まず GET /volumes/{volume_id} 呼び出しを行い、応答ヘッダーの Etag プロパティーからハッシュ・ストリングをコピーします。 その後、PATCH /volumes/{volume_id} 要求で If-Match を指定して新規ユーザー・タグを作成するときに、ハッシュ・ストリングを使用します。

ブロック・ストレージ・ボリュームにタグを適用するには、以下の手順を実行します。

1. GET /volumes/{volume_id} 、レスポンス・ヘッダーの Etag プロパティからハッシュ文字列をコピーする。 ステップ2でボリュームのユーザータグを作成するために PATCH /volumes/{volume_id} リクエストで If-Match を指定する際に、ハッシュ文字列を使用する必要があります。 レスポンス・ヘッダー情報を生成するには、以下の例のようなAPIコールを行う：

   curl -sSL -D GET\
   "https://us-south.iaas.cloud.ibm.com/v1/volumes/{volume_id}?version=2022-04-25&generation=2"\
   -H "Authorization: Bearer $TOKEN" -o /dev/null
   

   レスポンス・ヘッダには次のようなものがある：

   HTTP/2 200
   date: Tue, 28 Apr 2022 17:48:03 GMT
   content-type: application/json; charset=utf-8
   content-length: 1049
   cf-ray: 69903d250c4966ef-DFW
   cache-control: max-age=0, no-cache, no-store, must-revalidate
   expires: -1
   strict-transport-security: max-age=31536000; includeSubDomains
   cf-cache-status: DYNAMIC
   expect-ct: max-age=604800, report-uri="[uri...]"
   pragma: no-cache
   x-content-type-options: nosniff
   x-request-id: 1fbe2384-6828-4503-ae7d-050426d1b11b
   x-xss-protection: 1; mode=block
   server: cloudflare
   etag: W/xxxyyyzzz123
   

2. PATCH /volumes/{volume_id} 要求を行います。 ヘッダーの If-Match プロパティーに Etag-hash-string を指定します。 user_tags プロパティにユーザータグを指定する。

   また、「POST /volumes コールを行ってボリュームを作成し、「user_tags プロパティを指定する際にも、タグを追加することができる。

   この例では、ユーザー・タグ env:test および env:prod を指定してボリュームを更新します。 Etag パラメータから取得した値は、呼び出しの「If-Match ヘッダーに指定される。

   curl -X PATCH\
   "$vpc_api_endpoint/v1/volumes/r006-5ed4006b-3dac-4c95-8eeb-4aa9a85cbd34?version=2025-01-21&generation=2"\
      -H "Authorization: Bearer"\
      -H "If-Match: <_Etag-hash-string_>"\
      -d `{
         "user_tags": [
            "env:test",
            "env:prod"
         ]
      }'
   

   応答には、ボリュームに追加されたタグが表示されます：

   {
    "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": "",
    "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": [],
    "adjustable_capacity_states": [
        "attached"
    ],
    "storage_generation": 1,
    "user_tags": [
        "env:test",
        "env:prod"
    ],
    "volume_attachments": [],
    "zone": {
        "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-2",
        "name": "us-south-2"
    }
   }
   

APIを使用したボリューム添付ファイルの更新

PATCH /instances/$instance_id/volume_attachments/$volume_attachment_id 、ボリュームとボリューム・アタッチメントのIDを指定する。 リクエスト・ボディで、添付ファイルの新しい名前か、 delete_volume_on_instance_delete プロパティの新しい値を指定する。 delete_volume_on_instance_delete プロパティが true に設定されている場合、インスタンスが削除されると、アタッチされたボ リュームも削除されます。 インスタンスの削除後もボリュームを保持したい場合は、 delete_volume_on_instance_delete プロパティに値 true を指定します。

curl -X PATCH "$vpc_api_endpoint/v1/instances/$instance_id/volume_attachments/$volume_attachment_id?version=2022-04-22&generation=2" \
-H "Authorization: $iam_token" \
-d '{
      "delete_volume_on_instance_delete": false,
      "name": "my-volume-attachment-data-5iops-updated"
    }'

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

{
  "created_at": "2022-04-22T16:35:47.000Z",
  "delete_volume_on_instance_delete": false,
  "href": "https://us-south.iaas.cloud.ibm.com/v1/instances/8f06378c-ed0e-481e-b98c-9a6dfbee1ed5/volume_attachments/9f2a645e-19c1-4f8f-b062-46b9e0671999",
  "id": "9f2a645e-19c1-4f8f-b062-46b9e0671999",
  "name": "my-volume-attachment-data-5iops-updated",
  "status": "attached",
  "type": "data",
  "volume": {
    "crn": "crn:[...]",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/d8b26921-1409-4c2f-9b46-39b5b6e0b945",
    "id": "d8b26921-1409-4c2f-9b46-39b5b6e0b945",
    "name": "my-volume-data-5iops"
  }
}

API を使用したボリュームの切り離し

ボリューム添付ファイルを削除するには、 DELETE /instances/{instance_id}/volume_attachments/{id} 要求を行い、ボリューム添付ファイル ID を指定します。 ボリューム接続を削除すると、インスタンスからボリュームが切り離されます。

curl -X DELETE "$vpc_api_endpoint/v1/instances/$instance_id/volume_attachments/$volume_attachment_id?version=2022-04-22&generation=2" \
-H "Authorization: $iam_token"

インスタンスが存在する間は、ブート・ボリュームをインスタンスから切り離すことはできません。 インスタンスが削除された後もブート・ボリュームを保持したい場合は、ボリュームのアタッチメントの delete_volume_on_instance_delete プロパティが false に設定されていることを確認してください。

GET /instances/{instance_id} 呼び出しを実行して、 ボリュームがインスタンスから切り離されたことを確認します。

Terraformでボリューム名を更新する

ボリューム名を変更するには、「ibm_is_volume リソースを使用する。 次の例では、ボリューム「r010-bdb8fc70-8afb-4622-826a-d65a9fc477a4 指定し、その新しい名前を「my-new-name-volume」とします。 適用されると、ボリュームの名前が変更されます。

resource "ibm_is_volume" "example" {
  name    = "my-new-name-volume"
  id      = "r010-bdb8fc70-8afb-4622-826a-d65a9fc477a4"
  profile = "10iops-tier"
  zone    = "us-south-1"
}

Terraformでボリュームにタグを適用する

ユーザータグをボリュームに適用するには、「ibm_is_volume リソースを使用する。 次の例では、ボリューム「my-new-volume」と、ボリュームに添付するタグ「dev:test」を指定する。 適用されると、タグがボリュームに追加されます。

resource "ibm_is_volume" "example" {
  name    = "my-new-volume"
  profile = "10iops-tier"
  zone    = "us-south-1"
  tags    = ["dev:test"]
}