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

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

既存のスナップショットは、いくつかの方法で管理できます。 既存のスナップショットの名前を変更して、識別しやすくする。 VPC バックアップ・サービスで使用するユーザー・タグをスナップショットに追加します。 スナップショットの高速リストア・コピーを使用不可にします。 不要になったスナップショットを削除し、新しいスナップショットのためのスペースを確保します。 Cloud Identity and Access Management のアクセス権限を確認します。 スナップショット状況を確認します。

現在のリリースでは、高速リストアスナップショットクローン、クロスリージョナルコピー、および整合性グループは、第2世代ストレージボリュームではサポートされていません。 このようなリソースをコンソールやCLI、API、Terraformで作成しようとすると、どうしても失敗します。

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

スナップショットには、コピーしたボリュームを表す名前を付けることを検討してください。 例えば、my-volumemy-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 という名前になります。 スナップショットのクロス・リージョン・コピーは、ソース・スナップショットおよびソース・ボリュームから独立しており、コピーは他の通常のスナップショットと同様に管理できます。

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

コンソールでスナップショットの名前を変更するには、次の手順を使用します。

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

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

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

cloudshell:~$ 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」を参照してください。

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 プロバイダー・プラグインを構成します。 詳しくは、 Terraform の概要 を参照してください。

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

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

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

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

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

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

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

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

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

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

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

  1. スナップショットのリストに移動します。 IBM Cloud コンソールで、メニュー メニューアイコン インフラストラクチャ VPCアイコン ストレージ>スナップショットに進みます。

  2. アクションメニューアクションアイコン から、共有許可の管理を選択します。

  3. サイドパネルにはスナップショットを共有したアカウントのリストが表示されます。

    リストには、スナップショット用に設定されたすべての認証が表示されます。 例えば、あるアカウントがこの特定のスナップショットに対する権限と、アカウント内のすべてのスナップショットに対する権限を持っている場合、そのアカウントは2回表示されます。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

cloudshell:~$ 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"
       ]
    }'

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

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

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

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

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

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

スナップショットのゾーン・コピーを作成するには、スナップショット ID と、コピーを作成するゾーン (複数可) を指定して ibmcloud is snapshot-clone-create コマンドを発行します。 以下のコマンド例では、 eu-de-3 ゾーンに r138-4463eb2c-4913-43b1-b9bf-62a94f74c146 の高速リストア・クローンを作成します。

cloudshell:~$ 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 コマンドを発行し、新規スナップショット・クローンが使用可能として表示されるようにします。

cloudshell:~$ 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 の高速リストア・コピーを削除します。

@cloudshell:~$ 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: $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 のスナップショット」リストまたは「スナップショットの詳細」ページから、スナップショットのクロス・リージョン・コピーを作成します。

  1. コンソールで、ナビゲーションメニューアイコン メニューアイコン インフラストラクチャ VPCアイコン ストレージ > Block Storageスナップショットをクリックします。

  2. スナップショットのリストで、別のリージョンに複製するスナップショットを探します。 スナップショットが安定状態であることを確認してください。

  3. 「アクション」メニュー (「アクション」メニュー) をクリックし、 「スナップショットのコピー」 を選択します。

  4. コピーを作成したいリージョンを選択します。

    1つのリージョンにつき、1つのコピーしか持つことができません。 コピーに使用可能な領域がない場合、オプション「スナップショットのコピー」は使用不可になります。

  5. 「作成」 をクリックします。

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

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

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

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

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

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 コマンドを使用して、スナップショットの地域間コピーを削除できます。

cloudshell:~$ 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 状態である。
  • ボリュームのリストア中ではない。

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

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

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

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

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

  1. Block Storage for VPC の全巻リストへ。 IBM Cloud コンソールで、ナビゲーションメニュー アイコン メニューアイコン インフラストラクチャ VPC アイコン ストレージ > Block Storage ボリューム をクリックします。
  2. リストからボリュームを選択し、ボリューム名をクリックしてボリュームの詳細ページに移動します。
  3. **「スナップショット」**をクリックします。 このボリュームのスナップショットのリストが表示され、以下のアクションを実行できます:
    • このボリュームのすべてのスナップショットを削除するには、**「すべて削除」**をクリックします。
    • 特定のスナップショットを削除するには、 「アクション」 アイコン 「アクション」アイコン をクリックします。
  4. **「削除」**を選択します。 スナップショットがアクティブにボリュームをリストアしている場合、削除操作は機能しません。
  5. 削除を確認します。

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

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

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

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

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

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

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

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

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

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

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

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

    ibmcloud is snapshots --volume VOLUME [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME]
    
    cloudshell:~$ 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
    
  2. snapshot-delete コマンドを実行して、スナップショットの ID を指定します。 複数のスナップショットを削除するには、それらのすべての ID を同じコマンドで指定する必要があります。

    ibmcloud is snapshot-delete SNAPSHOT_ID
    
  3. スナップショットの削除を確認します。 スナップショットが削除されたことが応答メッセージに示されます。

    cloudshell:~$ 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 を使用してすべてのスナップショットを削除するには、以下の手順を使用します。

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

    ibmcloud is snapshots --volume VOLUME [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME | --all-resource-groups]
    
  2. snapshots-delete コマンドを入力し、ボリュームIDを指定する。

    ibmcloud is snapshots-delete --volume VOLUME_ID
    
  3. スナップショットの削除を確認する。 応答メッセージは、スナップショットの削除要求が受け入れられ、スナップショットが削除される時点を示します。

    cloudshell:~$ 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を使用したスナップショットの削除

特定のスナップショットをIDで削除するには、 DELETE /snapshots/{snapshot_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のデータソースで確認できる。

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

次のステップ

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