Block Storage for VPC スナップショットの管理
既存のスナップショットは、いくつかの方法で管理できます。 既存のスナップショットの名前を変更して、識別しやすくする。 VPC バックアップ・サービスで使用するユーザー・タグをスナップショットに追加します。 スナップショットの高速リストア・コピーを使用不可にします。 不要になったスナップショットを削除し、新しいスナップショットのためのスペースを確保します。 Cloud Identity and Access Management のアクセス権限を確認します。 スナップショット状況を確認します。
現在のリリースでは、高速リストアスナップショットクローン、クロスリージョナルコピー、および整合性グループは、第2世代ストレージボリュームではサポートされていません。 このようなリソースをコンソールやCLI、API、Terraformで作成しようとすると、どうしても失敗します。
スナップショットの名前について
スナップショットには、コピーしたボリュームを表す名前を付けることを検討してください。 例えば、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
以下の例を参照してください。
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_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を使用した認証の削除 を参照してください。
コンソールで高速復元ゾーンを編集する
コンソールで高速復元クローンが保存されるゾーンを編集するには、次の手順に従います。 必要に応じて、ゾーンを追加または削除できます。
- スナップショットのリスト からスナップショットを選択します。
- 「アクション」 メニュー
から、 「高速復元の編集」 を選択します。
- サイド・パネルで、リージョン内の高速リストア用のゾーンを選択または選択解除します。 選択内容に基づいて、請求の更新を確認します。
- 保存 をクリックします。 スナップショットの詳細ページ に戻ります。 高速復元セクションには、最初は 保留 状況の新しいゾーンが表示されます。
高速リストア情報は、リフレッシュ時に更新されます。 変更に応じて、ゾーン情報が更新され、使用可能または使用不可が表示されます。
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 のスナップショット」リストまたは「スナップショットの詳細」ページから、スナップショットのクロス・リージョン・コピーを作成します。
-
コンソールで、ナビゲーションメニューアイコン
インフラストラクチャ
ストレージ > Block Storageスナップショットをクリックします。
-
スナップショットのリストで、別のリージョンに複製するスナップショットを探します。 スナップショットが安定状態であることを確認してください。
-
「アクション」メニュー (
) をクリックし、 「スナップショットのコピー」 を選択します。
-
コピーを作成したいリージョンを選択します。
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
コマンドを使用して、スナップショットの地域間コピーを削除できます。
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
状態である。- ボリュームのリストア中ではない。
スナップショットを削除できるかどうかを判断する簡単な方法は、 コンソールで スナップショットのリストを見て、そのステータスをチェックすることです。 ボリュームのすべてのスナップショットを削除できます。 すべてのスナップショットを削除するには、コンソールでさらに確認する必要があります。
コンソールで単一のスナップショットを削除する
以下の手順を使用して、すべてのスナップショットのリストからスナップショットを削除できます。
- すべてのスナップショットのリストに移動します。 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 ボリュームに進みます。
- リストからボリュームを選択し、ボリューム名をクリックして、ボリューム詳細ページに移動します。
- **「スナップショット」**をクリックして、このボリュームから取得されたスナップショットのリストを表示します。
- このボリュームのすべてのスナップショットを削除するには、**「すべて削除」**をクリックします。
- あるいは、削除する単一スナップショットをリストから選択し、以下のようにします。
- アクション・アイコン
をクリックします。
- **「削除」**を選択します。
- 削除を確認します。
- アクション・アイコン
CLIからスナップショットを削除する
ボリュームの任意のスナップショット、またはボリュームのすべてのスナップショットを削除できます。 スナップショットを削除するには、以下の前提条件を満たしている必要があります。
stable
状態またはpending
状態である。- ボリュームのリストア中ではない。
CLIから単一のスナップショットを削除する
CLI を使用して単一のスナップショットを削除するには、以下の手順を使用します。
-
削除するスナップショットの 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
-
snapshot-delete
コマンドを実行して、スナップショットの ID を指定します。 複数のスナップショットを削除するには、それらのすべての ID を同じコマンドで指定する必要があります。ibmcloud is snapshot-delete SNAPSHOT_ID
-
スナップショットの削除を確認します。 スナップショットが削除されたことが応答メッセージに示されます。
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 を使用してすべてのスナップショットを削除するには、以下の手順を使用します。
-
すべてのスナップショットをリストします。
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
-
スナップショットの削除を確認する。 応答メッセージは、スナップショットの削除要求が受け入れられ、スナップショットが削除される時点を示します。
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のデータソースで確認できる。
スナップショット状況 | 説明 |
---|---|
安定 | スナップショットは、ボリュームのリストアに使用できます。 |
待機中 | スナップショット情報を取得しています。 |
保留中 | スナップショットが作成されている間、完了パーセンテージが表示されます。 |
失敗 | スナップショットの作成に失敗しました。スナップショットからボリュームをリストアできません。 |
中断 | スナップショットは一時的に使用不可になっています。 |
更新中 | スナップショットに関して何かを変更しましたが、更新中です。 |
削除中 | スナップショットが削除されます。 |
削除 | スナップショットは削除されており、ボリュームのリストアに使用できません。 |
次のステップ
スナップショットからボリュームをリストアする ことができます。