Block Storage for VPC スナップショットの管理

Block Storage for VPC のスナップショットを、名前の変更、タグ付け、高速復元の有効化、削除、およびアクセス権とステータスの確認を通じて管理します。

スナップショットの名前について

スナップショットには、コピーしたボリュームを表す名前を付けることを検討してください。例えば、my-volume は my-volume-snapshot1 になります。また、素早く識別できるように、接頭部として boot を追加して (boot_my-volume-snapshot1 など) ブート・ボリュームに名前を付けることを検討してください。スナップショットのリストが増大した場合に、スナップショットの作成元のボリュームの名前とタイプを素早く識別できます。

スナップショット名は、ボリューム名と同じ要件に従います。有効な名前には、英小文字および数字 (a-z、0-9) とハイフン (-) を組み合わせて最大 63 文字まで含めることができます。スナップショット名の先頭は小文字にする必要があり、スナップショット名は VPC 全体で固有にする必要があります。 UI では利便性のために名前の検査が提供されます。例えば、スナップショット名の末尾にハイフン (-) を付けると、UI でエラーが通知されます。また、重複する名前も検査されます。

スナップショットのクロス・リージョン・コピーを作成すると、新規スナップショットの名前は [copy]-[source-snapshot-name] になります。例えば、 snapshot-my-volume-snapshot1_ の地域間コピーは、ターゲット・リージョンに配置されると、自動的に copy-my-volume-snapshot1 という名前になります。スナップショットのクロス・リージョン・コピーは、ソース・スナップショットおよびソース・ボリュームから独立しており、コピーは他の通常のスナップショットと同様に管理できます。

コンソールでスナップショットの名前を変更する

コンソールでスナップショットの名前を変更するには、以下の手順に従ってください。

スナップショットのリストに移動します。 IBM Cloud コンソールで、メニュー インフラストラクチャ ストレージ>スナップショットに進みます。
リストからスナップショットの名前をクリックします。
「編集」アイコン をクリックします。
スナップショットの新規名を指定し、保存して変更を確認します。

CLI からスナップショットの名前を変更する

CLI からコマンドを発行するための前提条件

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

IBM Cloud® にログインしてください。

ibmcloud login --sso -a cloud.ibm.com

このコマンドを実行すると、URL が返され、パスコードの入力を求めるプロンプトが表示されます。ブラウザーでその URL にアクセスしてログインします。成功すると、ワンタイム・パスコードが表示されます。そのパスコードをコピーし、プロンプトに応答として貼り付けます。認証が成功すると、アカウントの選択を求めるプロンプトが表示されます。複数のアカウントアクセスできる場合は、ログインしたいアカウントを選択してください。残りのプロンプトにすべて応答して、ログインを完了します。

CLI からスナップショットの名前を変更する

CLI からスナップショットの名前を変更することができます。

スナップショットの名前を変更するには、 ibmcloud is snapshot-update コマンドを発行して、スナップショット ID と新しい名前を指定します。

ibmcloud is snapshot-update SNAPSHOT_ID --name SNAPSHOT_NAME

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

ibmcloud is snapshot-update r138-e6664842-b370-496a-9ae7-da3fb647707c --name snappy-snap-snap

Updating snapshot r138-e6664842-b370-496a-9ae7-da3fb647707c under account Test Account as user test.user@ibm.com...

ID                     r138-e6664842-b370-496a-9ae7-da3fb647707c
Name                   snappy-snap-snap
CRN                    crn:v1:bluemix:public:is:eu-de:a/a1234567::snapshot:r138-e6664842-b370-496a-9ae7-da3fb647707c
Status                 stable
Clones                 Zone      Available   Created
                       eu-de-3   true        2023-02-17T20:28:53+00:00
                       eu-de-1   true        2023-02-17T18:53:57+00:00

Source volume          ID                                          Name
                       r010-df8ffd90-f2e5-470b-83d7-76e64995a1aa   vicky-block-test1

Bootable               false
Encryption             provider_managed
Encryption key         -
Minimum capacity(GB)   20
Size(GB)               1
Resource group         ID                                 Name
                       a0eb5d9062af485fa5bb2c6999c74eac   test-snap

Created                2023-02-17T18:53:57+00:00
Captured at            2023-02-17T18:53:57+00:00
Tags                   -

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

CLIからスナップショットの使用許可プロパティを変更する

Allowed Use プロパティは親ボリュームから継承されます。これらの値を変更するには、 ibmcloud is snapshot-update コマンドを使用します。

スナップショットのこれらのプロパティを変更するには、 is.volume.volume.manage-allowed-use IAMロールが必要です。

ibmcloud is snapshot-update r006-b6b5e2ad-e60a-40c9-bbc2-356dad292fe3 --allowed-use-api-version "2025-03-03" --allowed-use-bare-metal-server "enable_secure_boot==true" --allowed-use-instance true

Updating snapshot r006-b6b5e2ad-e60a-40c9-bbc2-356dad292fe3 under account Test Account as user test.user@ibm.com...

ID                              r006-b6b5e2ad-e60a-40c9-bbc2-356dad292fe3
Name                            my-bootable-snapshot
CRN                             crn:v1:bluemix:public:is:us-south:a/a1234567::snapshot:r006-b6b5e2ad-e60a-40c9-bbc2-356dad292fe3
Status                          stable
Clones                          Zone   Available   Created

Source volume                   ID                                          Name                         Remote Region   CRN                                                                                                                        Resource type
                                r006-9a40241d-d116-4fc3-83ea-6134d30ee33c   fence-denture-mosaic-royal   -               crn:v1:bluemix:public:is:us-south-1:a/a1234567::volume:r006-9a40241d-d116-4fc3-83ea-6134d30ee33c   volume

Backup policy plan              -
Snapshot Copies                 -
Bootable                        true
Encryption                      provider_managed
Encryption key                  -
Source Snapshot                 -
Minimum capacity(GB)            100
Size(GB)                        1
Source Image                    ID                                          Name                                 Remote Region   CRN                                                                                                                     Resource type
                                r006-d734b459-b5a0-4777-8600-9fa3254d2cea   ibm-ubuntu-24-04-6-minimal-amd64-2   -               crn:v1:bluemix:public:is:us-south:a/a1234567::image:r006-d734b459-b5a0-4777-8600-9fa3254d2cea   image

Operating system                Name                 Vendor      Version                                  Family         Architecture   Display name
                                ubuntu-24-04-amd64   Canonical   24.04 LTS Noble Numbat Minimal Install   Ubuntu Linux   amd64          Ubuntu Linux 24.04 LTS Noble Numbat Minimal Install (amd64)

Resource group                  ID                                 Name
                                6edefe513d934fdd872e78ee6a8e73ef   defaults

Created                         2025-02-17T17:08:15+00:00
Captured at                     2025-02-17T17:08:15+00:00
Tags                            -
Service Tags                    -
Storage Generation              1
Allowed Use API Version         2025-03-03
Allowed Use Bare Metal Server   enable_secure_boot==true
Allowed Use Instance            true

プロパティは、ブール値の共通表現言語式で構成される。式が true と評価された場合、スナップショットを使用した仮想サーバーインスタンスまたはベアメタルサーバーのプロビジョニングが許可されます。式が false と評価されると、プロビジョニングはブロックされる。

API を使用してスナップショットの名前を変更する

API を使用してスナップショットの名前を変更できます。

PATCH /snapshots 呼び出しを行い、スナップショットの ID と新しい名前を指定します。

curl -X PATCH \
"$vpc_api_endpoint/v1/snapshots/7528eb61-bc01-4763-a67a-a414a103f96d?version=2022-01-12&generation=2" \
   -H "Authorization: Bearer ${API_TOKEN}" \
   -d '{
     "name": "my-snapshot-renamed"
   }'

同じ呼び出しを使用して、地域間コピーの名前を変更することができます。地域間コピーは、ソース・スナップショットおよびソース・ボリュームから独立しており、他のスナップショットと同様に管理できます。

Terraform を使用したスナップショットの更新

Terraformを使うには、Terraform CLIをダウンロードし、 IBM Cloud Providerプラグインを設定する。詳しくは、 Terraform の概要を参照してください。

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

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

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

スナップショットを更新するには、 ibm_is_snapshot リソースを使用します。スナップショットの名前、高速リストア・ゾーン、およびタグを変更できます。しかし、 resource_group と source_volume の値を変更すると、Terraformはスナップショットを削除し、異なるスナップショットを作成します。

resource "ibm_is_snapshot" "example" {
  name          = "my-snapshot"
  source_volume = ibm_is_volume.example.id
  }

引数および属性について詳しくは、 ibm_is_snapshotを参照してください。

コンソールで別のアカウントとスナップショットを共有する

コンソールでスナップショットを別のアカウントと共有できます。

スナップショットのリストに移動します。 IBM Cloud コンソールで、メニュー インフラストラクチャ ストレージ>スナップショットに進みます。
アクションメニューから、スナップショットの共有を選択します。
スナップショットを共有したいアカウントのアカウントIDを入力します。
カスタムIAM権限を作成するをクリックします。

あるいは、Manage > Access (IAM) > Authorizations メニューからサービス間認証を作成することもできます。詳細については、コンソールでクロスアカウント・リストア用のサービス間認証を作成するを参照してください。

コンソールでスナップショットの共有権限を管理する。

スナップショットのリストに移動します。 IBM Cloud コンソールで、メニュー インフラストラクチャ ストレージ>スナップショットに進みます。
アクションメニューから、共有許可の管理を選択します。
サイドパネルにはスナップショットを共有したアカウントのリストが表示されます。

リストには、スナップショットに設定されたすべての認証が表示されます。例えば、あるアカウントがこの特定のスナップショットに対する権限と、アカウント内のすべてのスナップショットに対する権限を持っている場合、そのアカウントは2回表示されます。
Manage IAM Authorization をクリックして Authorization ページに移動し、権限を変更または取り消します。

あるいは、Manage > Access (IAM) > Authorizations メニューからサービス間の承認ポリシーを直接管理することもできます。詳しくは、許可を使用した、サービス間のアクセス権限の付与を参照してください。

CLIから別のアカウントとスナップショットを共有する

ibmcloud iam authorization-policy-create コマンドを使用して、CLIから特定のスナップショットのサービス間認証を作成できます。詳細については、CLIからクロスアカウント・リストア用のサービス間認証を作成するを参照してください。

CLIからスナップショットの共有権限を管理する

authorization-policy-delete コマンドを使用して、CLIから特定のスナップショットのサービス間認証を削除できます。詳細については、CLIを使用した認証の削除を参照してください。

APIを使用してスナップショットを別のアカウントと共有する

IAM Policy Management API の policies メソッドを呼び出すことで、特定のスナップショットのサービス間認可をプログラムで作成できます。詳細については、APIを使用したクロスアカウント・リストアのためのサービス間認証の作成を参照してください。

APIでスナップショットの共有権限を管理する

IAM Policy Management API の policies メソッドを呼び出すことで、特定のスナップショットのサービス間承認をプログラムで取り消すことができます。詳細については、APIを使用した認証の削除を参照してください。

コンソールでスナップショットにタグを追加する

ユーザー・タグおよびアクセス管理タグを Block Storage for VPC スナップショットに追加できます。既存のスナップショットに、またはスナップショットを作成する際に、ユーザータグを追加することができます。これらのタグは、バックアップポリシーでスナップショットのバックアップを作成する際に使用できます。

スナップショット・リスト画面からのユーザー・タグの追加

スナップショット・リスト画面からユーザー・タグを追加するには、以下の手順を使用します。

スナップショットのリストに移動します。
見つける_利用可能_スナップショットは_ユーザー_。（バックアップポリシーによって作成されたスナップショットは、その_バックアップポリシー_ によって作成されたものとして識別されます。）
「タグ」 列には、タグを持つスナップショットに、既に適用されているタグを示す数値が表示されます。タグのないスナップショットには、**「タグの追加」**リンクがあります。 **「タグの追加」**をクリックします。
新しいウィンドウで、「ユーザータグ」テキストボックスにタグを入力してください。
保存をクリックします。

スナップショットの詳細ページからのタグの追加

スナップショットの詳細ページからタグを追加するには、以下の手順を使用します。

スナップショットのリストに移動します。
リスト内のスナップショットの名前をクリックしてください。
スナップショットの詳細ページで、 「タグの追加」 リンクをクリックします。
新しいウィンドウで、それぞれのフィールドにユーザー・タグまたはアクセス管理タグを入力します。
保存をクリックします。

ユーザータグがバックアップポリシーと一致すると、バックアッププランのスケジュールに基づいてバックアップが実行されます。詳しくは、『バックアップ・ポリシーの作成』を参照してください。

CLI からスナップショットにタグを追加する

CLI からスナップショットにタグを追加できます。

ボリュームにユーザータグを追加するには、 --tags オプションを指定した snapshot-update コマンドを実行します。

ibmcloud is snapshot-create を使用してスナップショットを作成するときに、同じオプションを使用してボリュームにタグを追加します。

以下の例では、ユーザー・タグ env:test および env:prod を、その ID で識別されるボリュームに追加します。

ibmcloud is snapshot-update r138-e6664842-b370-496a-9ae7-da3fb647707c --name snappy-snap-snap --tags env:test,env:prod

Updating snapshot r138-e6664842-b370-496a-9ae7-da3fb647707c under account Test Account as user test.user@ibm.com...

ID                     r138-e6664842-b370-496a-9ae7-da3fb647707c
Name                   snappy-snap-snap
CRN                    crn:v1:bluemix:public:is:eu-de:a/a1234567::snapshot:r138-e6664842-b370-496a-9ae7-da3fb647707c
Status                 stable
Clones                 Zone      Available   Created
                       eu-de-3   true        2023-02-17T20:28:53+00:00
                       eu-de-1   true        2023-02-17T18:53:57+00:00

Source volume          ID                                          Name
                       r010-df8ffd90-f2e5-470b-83d7-76e64995a1aa   vicky-block-test1

Bootable               false
Encryption             provider_managed
Encryption key         -
Minimum capacity(GB)   20
Size(GB)               1
Resource group         ID                                 Name
                       a0eb5d9062af485fa5bb2c6999c74eac   test-snap

Created                2023-02-17T18:53:57+00:00
Captured at            2023-02-17T18:53:57+00:00
Tags                   env:test,env:prod

API を使用してスナップショットにユーザータグを追加する

API を使用して、ユーザー・タグをスナップショットに追加できます。

PATCH /snapshots 呼び出しを行い、スナップショット ID とユーザー・タグを指定します。以下の例では、ユーザー・タグ env:test および env:prod をスナップショットに追加します。

curl -X PATCH \
"$vpc_api_endpoint/v1/snapshots/7528eb61-bc01-4763-a67a-a414a103f96d?version=2022-01-12&generation=2" \
    -H "Authorization: Bearer ${API_TOKEN}" \
    -d `{
       "user_tags": [
         "env:test",
         "env:prod"
       ]
    }'

コンソールで高速復元ゾーンを編集する

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

スナップショットのリストからスナップショットを選択します。
「アクション」 メニューから、 「高速復元の編集」 を選択します。
サイド・パネルで、リージョン内の高速リストア用のゾーンを選択または選択解除します。選択内容に基づいて、請求の更新を確認します。
保存をクリックします。スナップショットの詳細ページに戻ります。高速復元セクションには、最初は保留状況の新しいゾーンが表示されます。

高速リストア情報は、リフレッシュ時に更新されます。変更に応じて、ゾーン情報が更新され、使用可能または使用不可が表示されます。

CLI からの高速リストア用のスナップショット・クローンの作成

スナップショットのゾーン・コピーを作成するには、スナップショット ID と、コピーを作成するゾーン (複数可) を指定して ibmcloud is snapshot-clone-create コマンドを発行します。以下のコマンド例では、 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 からのスナップショット・クローンの削除

スナップショット・クローンを削除するには、スナップショット ID とスナップショット・コピーを削除するゾーンを指定して ibmcloud is snapshot-clone-delete コマンドを発行します。以下のコマンド例は、 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}"

コンソールでリモートコピーを作成する

以下のステップを使用して、「VPC のスナップショット」リストまたは「スナップショットの詳細」ページから、スナップショットのクロス・リージョン・コピーを作成します。

コンソールで、ナビゲーションメニューアイコン インフラストラクチャ ストレージ > Block Storageスナップショットをクリックします。
スナップショットのリストで、別のリージョンに複製するスナップショットを探します。スナップショットが安定状態であることを確認してください。
Actions メニュー Actions をクリックし、 Copy snapshot を選択します。
コピーを作成したい地域を選択してください。

1地域につき1部のみお持ちいただけます。コピーに使用可能な領域がない場合、オプション「スナップショットのコピー」は使用不可になります。
「作成」 をクリックします。

あるいは、スナップショットの名前をクリックして詳細を表示します。 Actions メニューから Copy Snapshot オプションにアクセスするか、リモートコピーカードまでスクロールして Create copy をクリックします。同じプロビジョニング・パネルが開き、そこで地域を選択できます。

コンソールでリモートリージョンコピーを削除する

リモート領域内のスナップショット・コピーは、親スナップショットおよび親ボリュームから独立しています。これらは、「VPC のスナップショット」リストを使用していつでも削除できます。

コンソールでリモートリージョンコピーを削除するには、次の手順に従います。

IBM Cloud コンソールで、メニュー インフラストラクチャ ストレージ>スナップショットに進みます。
削除するスナップショットの行にある 「アクション」 アイコンをクリックします。
**「削除」**を選択します。
削除内容を確認して、**「削除」**をクリックします。

CLI からのリモート・リージョン・コピーの作成

--source-snapshot-crn オプションを指定した snapshot-create コマンドと、ソース・スナップショット CRN を使用して、スナップショットの地域間コピーを作成できます。これにより、ソース・リージョンからのスナップショットの CRN を使用して、ターゲット・リージョンにスナップショットが作成されます。暗号鍵の CRN も指定されている場合、作成されたスナップショットは、ユーザー定義の暗号鍵を使用します。コピーが正常に作成されるためには、ソーススナップショットがStableステータスである必要があります。

ibmcloud is snapshot-create --name my-cli-snapshot-crc --source-snapshot-crn crn:v1:bluemix:public:is:us-south:a/a1234567::snapshot:r006-b9590a48-63a3-445e-b819-3f2c0b82daf8

Creating snapshot my-cli-snapshot-crc under account Test Account as user test.user@ibm.com...

ID                     r142-bd4532c0-e73c-44f9-a017-89e5368c521a
Name                   my-cli-snapshot-crc
CRN                    crn:v1:bluemix:public:is:us-east:a/a1234567::snapshot:r142-bd4532c0-e73c-44f9-a017-89e5368c521a
Status                 pending
Clones                 Zone   Available   Created

Source volume          ID                                          Name                   Remote Region
                       r006-be21061a-4dc6-4c9f-b17d-421838fde399   -remote-421838fde399   us-south

Snapshot Copies        ID   Name   Remote Region   CRN   Resource type

Bootable               true
Encryption             provider_managed
Encryption key         -
Source Snapshot        ID                                          Name                   Remote Region   CRN                                                                                                                        Resource type
                       r006-b9590a48-63a3-445e-b819-3f2c0b82daf8   cli-snap-crc-test-sn   us-south        crn:v1:bluemix:public:is:us-south:a/a1234567::snapshot:r006-b9590a48-63a3-445e-b819-3f2c0b82daf8   snapshot

Minimum capacity(GB)   100
Size(GB)               1
Source Image           ID                                          Name                   Remote Region
                       r006-24d856e2-6aec-41c2-8f36-5a8a3766f0d6   -remote-5a8a3766f0d6   us-south

Operating system       Name             Vendor   Version                 Family   Architecture   Display name
                       centos-7-amd64   CentOS   7.x - Minimal Install   CentOS   amd64          CentOS 7.x - Minimal Install (amd64)

Resource group         ID                                 Name
                       cdc21b72d4e647b195de988b175e3d82   Default

Created                2023-04-24T18:54:29+05:30
Captured at            2023-04-24T09:48:03+05:30
Tags                   -
Service Tags           -

使用可能なコマンド・オプションの詳細については ibmcloud is snapshot-create

CLI からのリモート・リージョン・コピーの削除

スナップショット ID を指定した ibmcloud is snapshot-delete コマンドを使用して、スナップショットの地域間コピーを削除できます。

ibmcloud is snapshot-delete r142-bd4532c0-e73c-44f9-a017-89e5368c521a

This will delete snapshot r142-bd4532c0-e73c-44f9-a017-89e5368c521a and cannot be undone. Continue [y/N] ?> y
Deleting snapshot r142-bd4532c0-e73c-44f9-a017-89e5368c521a under account Test Account as user test.user@ibm.com...
    OK
Snapshot r142-bd4532c0-e73c-44f9-a017-89e5368c521a is deleted.

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

API を使用したリモート・リージョン・コピーの作成

ターゲット・リージョンで API 呼び出しを行うことにより、スナップショットの地域間コピーを作成できます。ターゲット領域にコピーを作成するソーススナップショットのCRNを指定します。暗号鍵の CRN も指定されている場合、作成されたスナップショットは、ユーザー定義の暗号鍵を使用します。コピーが正常に作成されるためには、ソーススナップショットがStableステータスである必要があります。以下の例を参照してください。ここで、ターゲット・リージョンは us-east で、元のスナップショットは us-south です。

POST https://us-east.iaas.cloud.ibm.com/v1/snapshots
{
     "name": "my-snapshot",    // required
     "source_snapshot": {      // required
      	"crn": "crn:[...]"
     },
     "resource_group": {       // optional
       "id": "2d1bb5a8-40a8-447a-acf7-0eadc8aeb054"
     },
     "encryption_key": "crn:[...]"     // optional
}

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

{
  "created_at": "2023-05-18T20:18:18Z",
  "deletable": false,
  "encryption": "user_managed",
  "encryption_key": {
    "crn": "crn:[...]"
  },
  "href": "https://us-east.iaas.cloud.ibm.com/v1/snapshots/r139-f6bfa329-0e36-433f-a3bb-0df632e79263",
  "id": "r139-f6bfa329-0e36-433f-a3bb-0df632e79263",
  "lifecycle_state": "pending",
  "minimum_capacity": 100,
  "name": "my-snapshot",
  "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",
    "vendor": "Canonical",
    "version": "20.04 LTS Focal Fossa Minimal Install"
  },
  "resource_group": {
    "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/678523bcbe2b4eada913d32640909956",
    "id": "678523bcbe2b4eada913d32640909956",
    "name": "Default"
  },
  "resource_type": "snapshot",
  "service_tags": [],
  "size": 1,
  "source_image": {
    "crn": "crn:[...]",
    "remote": {
    	"region": {
    	   "name": "us-south",
    	   "hfef": "https://us-east.iaas.cloud.ibm.com/v1/regions/us-south"
    	}
    },
    "href": "https://us-south.iaas.cloud.ibm.com/v1/images/r006-32045dc2-b463-4cda-b424-bc3dcf51dfbb",
    "id": "r006-32045dc2-b463-4cda-b424-bc3dcf51dfbb",
    "name": "ibm-ubuntu-20-04-minimal-amd64-1"
  },
  "source_snapshot": {
    "crn": "crn:[...]",
    "remote": {
    	"region": {
    	   "name": "us-south",
    	   "hfef": "https://us-east.iaas.cloud.ibm.com/v1/regions/us-south"
    	}
    },
    "href": "https://us-south.iaas.cloud.ibm.com/v1/snapshots/r006-511a798c-5816-4082-8ecb-554a440f83de",
    "id": "r006-511a798c-5816-4082-8ecb-554a440f83de",
    "name": "my-snapshot-data"
  },
  "source_volume": {
    "crn": "crn:[...]",
    "remote": {
    	"region": {
    	   "name": "us-south",
    	   "hfef": "https://us-east.iaas.cloud.ibm.com/v1/regions/us-south"
    	}
    },
    "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/r006-411a798c-5816-4082-8ecb-554a440f83de",
    "id": "r006-411a798c-5816-4082-8ecb-554a440f83de",
    "name": "my-instance-data"
  },
  "user_tags": []
}

API を使用したスナップショットのリモート・リージョン・コピーの削除

リモート・コピーが配置されているターゲット領域に DELETE /snapshots/{id} を作成します。

curl -X DELETE https://us-east.iaas.cloud.ibm.com/v1/snapshots/{id}

Terraform を使用した地域間コピーの作成

リモート・リージョンにスナップショットのコピーを作成するには、 ibm_is_snapshot リソースを使用します。コピーが正常に作成されるためには、ソーススナップショットがStableステータスである必要があります。暗号鍵の CRN も指定されている場合、作成されたスナップショットは、ユーザー定義の暗号鍵を使用します。以下の例では、ソース・スナップショットの ID を使用して、ターゲット・リージョンにコピーを作成します。コピーは、その CRN で指定された暗号鍵によって暗号化されます。

resource "ibm_is_snapshot" "snapshot" {
  name 		        = "my-cross-regional-snapshot"
  source_snapshot = "r138-4463eb2c-4913-43b1-b9bf-62a94f74c146"
  encryption_key  = "crn:bluemix:public:kms:us-south:a/df0564dd126042ebb03e0224728ce939:4957299d-0ba0-487f-a1a0-c724a729b8b4:key:0cb88b98-9261-4d07-8329-8f594b6641b5"
}

引数および属性について詳しくは、 ibm_is_snapshotを参照してください。

Terraform を使用したリモート・リージョン・コピーの削除

terraform destroy コマンドを使用すると、スナップショットの地域間コピーなどのリモートオブジェクトを簡単に削除できます。以下の例は、スナップショットを削除するための構文を示しています。 ibm_is_snapshot.example.id の代わりに、スナップショットの実際の ID を使用してください。

terraform destroy --target ibm_is_snapshot.example.id

詳しくは、 terraform destroyを参照してください。

コンソールでのスナップショットの削除

ボリュームの任意のスナップショット、またはボリュームのすべてのスナップショットを削除できます。スナップショットを削除するには、以下の前提条件を満たしている必要があります。

stable 状態または pending 状態である。
ボリュームのリストア中ではない。

スナップショットを削除できるかどうかを判断する便利な方法は、コンソールでスナップショットのリストを見て、そのステータスをチェックすることです。ボリュームのすべてのスナップショットを削除できます。すべてのスナップショットを削除するには、コンソールでさらに確認が必要です。

コンソールで単一のスナップショットを削除する

以下の手順を使用して、すべてのスナップショットのリストからスナップショットを削除できます。

すべてのスナップショットのリストに移動します。 IBM Cloud コンソールで、メニュー インフラストラクチャ ストレージ>スナップショットに進みます。
削除するスナップショットの行にある 「アクション」 アイコンをクリックします。
**「削除」**を選択します。
削除内容を確認して、**「削除」**をクリックします。

また、 Block Storage for VPC ボリュームの詳細ページからスナップショットを削除することもできます。

「 Block Storage for VPC 」の全巻一覧へ移動します。 IBM Cloud コンソールで、ナビゲーションメニュー アイコン インフラストラクチャ ストレージ > Block Storage ボリューム をクリックします。
リストからボリュームを選択し、ボリューム名をクリックして、そのボリュームの詳細ページに移動します。
**「スナップショット」**をクリックします。このボリュームに対して作成されたスナップショットのリストが表示され、以下の操作を行うことができます：
- このボリュームのすべてのスナップショットを削除するには、**「すべて削除」**をクリックします。
- 特定のスナップショットを削除するには、 「アクション」 アイコンをクリックします。
**「削除」**を選択します。スナップショットがボリュームの復元を現在実行中の場合、削除操作は実行できません。
削除を確認します。

コンソールでボリュームのすべてのスナップショットを削除する

コンソールでボリュームのすべてのスナップショットを削除するには、以下の手順に従ってください。

すべてのスナップショットのリストに移動します。 IBM Cloud コンソールで、メニュー インフラストラクチャ ストレージ>スナップショットに進みます。
削除したいスナップショットを選択するには、その行をクリックしてください。
「アクション」 メニューので、 「ボリュームのすべてを削除」 を選択します。
_「削除」_と入力して削除を確認し、**「削除」**をクリックします。

スナップショットを削除するBlock Storage for VPCコンソールの詳細ページ

Block Storage for VPC のボリューム詳細ページにあるスナップショットの一覧から、最も新しく作成されたスナップショットを削除できます。任意で、このビューからすべてのスナップショットを削除することもできます。

「 Block Storage for VPC 」の全巻一覧へ移動します。 IBM Cloud コンソールで、メニュー インフラストラクチャ ストレージ > Block Storage ボリュームに進みます。
リストからボリュームを選択し、ボリューム名をクリックして、ボリューム詳細ページに移動します。
**「スナップショット」**をクリックして、このボリュームから取得されたスナップショットのリストを表示します。
このボリュームのすべてのスナップショットを削除するには、**「すべて削除」**をクリックします。
あるいは、削除する単一スナップショットをリストから選択し、以下のようにします。
1. アクション・アイコンをクリックします。
2. **「削除」**を選択します。
3. 削除を確認します。

CLI からのスナップショットの削除

stable 状態または pending 状態である。
ボリュームのリストア中ではない。

CLI から単一のスナップショットを削除する

CLI を使用して単一のスナップショットを削除するには、以下の手順を使用します。

削除するスナップショットの ID を確認するために、ボリュームで使用可能なスナップショットをリストします。

ibmcloud is snapshots --volume VOLUME [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME]

$ ibmcloud is snapshots --volume  r010-df8ffd90-f2e5-470b-83d7-76e64995a1aa
Listing snapshots in all resource groups and region eu-de under account Test Account as user test.user@ibm.com...
ID                                          Name                             Status   Source volume                               Bootable   Resource group   Created
r138-7cac80af-63bb-4a1b-83dd-5f6d550a5db7   bear-peroxide-viewable-oxidant   stable   r010-df8ffd90-f2e5-470b-83d7-76e64995a1aa   false      test-snap        2023-02-17T18:49:48+00:00
r138-4463eb2c-4913-43b1-b9bf-62a94f74c146   cli-snapshot-test                stable   r010-df8ffd90-f2e5-470b-83d7-76e64995a1aa   false      defaults         2023-02-17T20:15:43+00:00
r138-e6664842-b370-496a-9ae7-da3fb647707c   snappy-snap-snap                 stable   r010-df8ffd90-f2e5-470b-83d7-76e64995a1aa   false      test-snap        2023-02-17T18:53:57+00:00

snapshot-delete コマンドを実行して、スナップショットの ID を指定します。複数のスナップショットを削除するには、それらのすべての ID を同じコマンドで指定する必要があります。
```
ibmcloud is snapshot-delete SNAPSHOT_ID
```

スナップショットの削除を確認してください。スナップショットが削除されたことが応答メッセージに示されます。

$ ibmcloud is snapshot-delete r138-e6664842-b370-496a-9ae7-da3fb647707c
This will delete snapshot r138-e6664842-b370-496a-9ae7-da3fb647707c and cannot be undone. Continue [y/N] ?> y
Deleting snapshot r138-e6664842-b370-496a-9ae7-da3fb647707c under account Test Account as user test.user@ibm.com...
OK
Snapshot r138-e6664842-b370-496a-9ae7-da3fb647707c is deleted.

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

CLI からすべてのスナップショットを削除する

CLI を使用してすべてのスナップショットを削除するには、以下の手順を使用します。

すべてのスナップショットをリストします。

ibmcloud is snapshots --volume VOLUME [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME | --all-resource-groups]

「 snapshots-delete 」コマンドを入力し、ボリュームIDを指定します。
```
ibmcloud is snapshots-delete --volume VOLUME_ID
```

スナップショットの削除を確認してください。応答メッセージは、スナップショットの削除要求が受け入れられ、スナップショットが削除される時点を示します。

$ ibmcloud is snapshots-delete --volume  r010-df8ffd90-f2e5-470b-83d7-76e64995a1aa
This will delete snapshot by volume r010-df8ffd90-f2e5-470b-83d7-76e64995a1aa and cannot be undone. Continue [y/N] ?> y
Deleting snapshot by volume r010-df8ffd90-f2e5-470b-83d7-76e64995a1aa under account Test Account as user test.user@ibm.com...
OK
Deletion request for snapshots by volume r010-df8ffd90-f2e5-470b-83d7-76e64995a1aa has been accepted.

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

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

stable 状態または pending 状態である。
ボリュームのリストア中ではない。

API を使用して単一のスナップショットを削除する

DELETE /snapshots/{snapshot_ID} を呼び出して、IDを指定して特定のスナップショットを削除します。

curl -X DELETE \
"$vpc_api_endpoint/v1/snapshots/7528eb61-bc01-4763-a67a-a414a103f96d?version=2022-12-22&generation=2" \
     -H "Authorization: Bearer ${API_TOKEN}"

API を使用してボリュームのすべてのスナップショットを削除する

DELETE/snapshots 呼び出しを行い、要求の source_volume.id パラメーターにソース・ボリューム ID を指定します。

curl -X DELETE \
"$vpc_api_endpoint/v1/snapshots?source_volume.id=_volume-id_&version=2022-12-22&generation=2" \
     -H "Authorization: Bearer ${API_TOKEN}"

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

stable 状態または pending 状態である。
ボリュームのリストア中ではない。

Terraform を使用した単一スナップショットの削除

terraform destroy コマンドを使用すると、単一のスナップショットなどのリモートオブジェクトを簡単に削除できます。次の例では、 my-snapshot を削除します。

terraform destroy --target ibm_is_snapshot.my-snapshot

詳しくは、 terraform destroyを参照してください。

Terraform を使用したボリュームのすべてのスナップショットの削除

Terraform を使用してボリュームのすべてのスナップショットを削除するには、 ibm_is_volume リソースを使用します。

resource "ibm_is_volume" "storage" {
  name                 = "example-volume"
  profile              = "general-purpose"
  zone                 = "us-south-1"
  delete_all_snapshots = true
}

引数および属性について詳しくは、 ibm_is_volumeを参照してください。

スナップショットのライフサイクル状態の監視

表2は、スナップショットのライフサイクルにおける各状態について説明しています。これらの状態は、コンソール、CLIのコマンド出力、APIのレスポンス、Terraformのデータソースで確認できる。

スナップショットのライフサイクル状態
スナップショット状況	説明
安定	スナップショットは、ボリュームのリストアに使用できます。
待機中	スナップショット情報を取得しています。
保留中	スナップショットが作成されている間、完了パーセンテージが表示されます。
失敗	スナップショットの作成に失敗しました。このボリュームはスナップショットから復元できません。
中断	スナップショットは一時的に使用不可になっています。
更新	スナップショットに関して何かを変更しましたが、更新中です。
削除中	スナップショットが削除されています。
削除	スナップショットは削除されており、ボリュームのリストアに使用できません。

次のステップ

スナップショットからボリュームをリストアすることができます。