コンソールでの高速復元ゾーンの編集

コンソールで、高速復元クローンが保存されているゾーンを編集するには、以下の手順に従ってください。 必要に応じてゾーンを追加したり削除したりできます。

1. スナップショットのリスト からスナップショットを選択してください。
2. [アクション]メニュー（ ）から、[ クイック復元を編集 ] を選択します。
3. サイドパネルから、お住まいの地域における「クイック復元」の対象となるゾーンを選択または選択解除してください。 選択内容に基づいて、請求情報の更新内容をご確認ください。
4. 保存 をクリックします。 スナップショットの詳細ページ に戻ります。 「高速復元」セクションでは、新しいゾーンが当初「 保留中 」のステータスで表示されます。

「クイック復元」の情報は、ページを更新すると更新されます。 変更内容に応じて、ゾーン情報が「有効」または「無効」と表示されるように更新されます。

CLI から高速復元用のスナップショットクローンを作成する

スナップショットのゾーンコピーを作成するには、 ibmcloud is snapshot-clone-create コマンドを実行し、スナップショットIDと、コピーを作成するゾーンを指定します。 以下のコマンド例は、 eu-de-3 ゾーン内の r138-4463eb2c-4913-43b1-b9bf-62a94f74c146 の高速復元クローンを作成します。

ibmcloud is snapshot-clone-create r138-4463eb2c-4913-43b1-b9bf-62a94f74c146  --zone eu-de-3

Creating zonal clone of snapshot r138-4463eb2c-4913-43b1-b9bf-62a94f74c146 under account Test Account as user test.user@ibm.com...
Zone        eu-de-3
Available   false
Created     2023-02-17T20:29:21+00:00
Href        https://eu-de.iaas.cloud.ibm.com/v1/regions/eu-de/zones/eu-de-3

スナップショットのクローンが作成されている間は、そのスナップショットのクローンは利用できないようです。 ほんの数秒で済みます。 スナップショット ID とクローン先のゾーンを指定して ibmcloud is snapshot-cl コマンドを実行すると、新しいスナップショットのクローンが利用可能になっていることが確認できます。

ibmcloud is snapshot-cl r138-4463eb2c-4913-43b1-b9bf-62a94f74c146 eu-de-3

Getting zonal clone eu-de-3 of snapshot r138-4463eb2c-4913-43b1-b9bf-62a94f74c146 under account Test Account as user test.user@ibm.com...
Zone        eu-de-3
Available   true
Created     2023-02-17T20:29:21+00:00

利用可能なコマンドオプションの詳細については、以下を参照してください ibmcloud is snapshot-clone-create を参照してください。

CLI からスナップショットのクローンを削除する

スナップショットのクローンを削除するには、 ibmcloud is snapshot-clone-delete コマンドを実行し、スナップショットIDと、スナップショットのコピーを削除したいゾーンを指定します。 次のコマンド例は、 eu-de-3 ゾーンにあるスナップショット「 r138-4463eb2c-4913-43b1-b9bf-62a94f74c146 」の高速復元コピーを削除します。

@$ ibmcloud is snapshot-clone-delete r138-4463eb2c-4913-43b1-b9bf-62a94f74c146 eu-de-3
This will delete zonal clone eu-de-3 for snapshot r138-4463eb2c-4913-43b1-b9bf-62a94f74c146 and cannot be undone. Continue [y/N] ?> y
Deleting zonal clone eu-de-3 for snapshot r138-4463eb2c-4913-43b1-b9bf-62a94f74c146 under account Test Account as user test.user@ibm.com...
OK
Deletion request for zonal snapshot clone eu-de-3 has been accepted.

利用可能なコマンドオプションの詳細については、以下を参照してください ibmcloud is snapshot-clone-delete を参照してください。

API を使用して、高速な復元のためのスナップショットクローンを作成する

高速復元用スナップショット を作成するには、別のゾーンにそのスナップショットのクローンを作成します。 その後、そのクローンから ボリュームを復元します。

API では、 PUT /snapshots/{id}/clones/{zone_name} 呼び出しを行い、既存のスナップショットを指定されたゾーンに複製することで、そのスナップショットのクローンを作成します。 以下の例を参照してください。

curl -X PUT \
"$vpc_api_endpoint/v1/snapshots/5e160469-0837-48a7-8973-e44c8d5fd85a/clones/us-south-1&version=2025-02-18&generation=2" \
     -H "Authorization: Bearer ${API_TOKEN}"

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

{
  "available": true,
  "created_at": "2025-02-18T20:35:38.600Z",
  "zone": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-1",
    "name": "us-south-1"
  },
  "storage_generation": 1,
}

ボリュームのスナップショットを作成する際、 clone プロパティを指定することもできます。 以下の例を参照してください。

curl -X POST \
"$vpc_api_endpoint/v1/snapshots?version=2025-02-18&generation=2" \
-H "Authorization: Bearer $iam_token" \
-d '{
    "clones": [{"zone": {"name": "us-south-1"}}],
    "name": "my-snapshot2",
    "resource_group": {"id": "a342dbfb-3ea7-48d1-96e8-2825ec5feab4"},
    "source_volume": {"id": "8948ad59-bc0f-7510-812f-5dc64f59fab8"},
    "user_tags": ["env:test","env:prod"]
   }'

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

{
  "bootable": false,
  "clones": [
      "available": true,
      "created_at": "2025-02-18T20:18:38.600Z",
      "zone": {
        "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-1",
        "name": "us-south-1"
     }
  ],
  "created_at": "2025-02-18T20:18:18Z",
  "crn": "crn:[...]",
  "deletable": false,
  "encryption": "user_managed",
  "encryption_key": {
    "crn": "crn:[...]"
  },
  "storage_generation": 1
}

API を使用したスナップショットクローンの削除

DELETE /v1/snapshots/{id}/clones/{zone-name} を呼び出して、指定されたゾーンにあるスナップショットのクローンを削除します。 スナップショットのクローンが削除されると、その削除操作を元に戻すことはできません。

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

curl -X DELETE \
"$vpc_api_endpoint/v1/snapshots/fde0b8d5-2d75-4c28-af7d-12ffc3ae2a55/clones/us-south-1&version=2025-02-18&generation=2" \
     -H "Authorization: Bearer ${API_TOKEN}"

Terraform を使用した高速復元のためのスナップショットクローンの作成

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

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

デフォルトの us-south 以外の地域をターゲットとする例を以下に示します。

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

ibm_is_snapshot リソースを使用し、 clones 引数を指定してスナップショットを作成すると、高速復元用クローンを作成できます。 高速復元クローンを作成したいゾーンを指定してください。 次の例では、 us-south-1 および us-south-2 ゾーンに、高速復元可能なクローンを含むスナップショットを作成します。

resource "ibm_is_snapshot" "example_clones" {
  name          = "example-snapshot"
  source_volume = ibm_is_instance.example.volume_attachments[0].volume_id
  clones        = ["us-south-1", "us-south-2"]
}

引数や属性に関する詳細については、 ibm_is_snapshot を参照してください。

Terraform を使用したスナップショットクローンの削除

Terraform を使用してファストリストアクローンを削除するには、 ibm_is_snapshot リソースの clones 引数からゾーンのエントリを削除してください。 変更を適用すると、Terraform は削除されたゾーン内のクローンを削除します。

たとえば、 us-south-2 にあるクローンを削除しつつ、 us-south-1 にあるクローンは残すには：

resource "ibm_is_snapshot" "example_clones" {
  name          = "example-snapshot"
  source_volume = ibm_is_instance.example.volume_attachments[0].volume_id
  clones        = ["us-south-1"]  # Removed us-south-2
}

すべての高速復元クローンを削除するには、 clones という引数を完全に削除してください。

Terraformの設定を更新した後、 terraform apply を実行してクローンを削除してください。 この削除は元に戻すことができません。