IBM Cloud Docs

コンソールでスナップショットを一覧表示する

UI を使用して、スナップショットおよび整合性グループをリストできます。

コンソールにすべてのスナップショットを表示する

コンソールでは、作成したすべてのスナップショットのリストを見ることができ、最新のものがリストの先頭に表示されます。リストをフィルターに掛けて、特定のスナップショットを表示できます。

IBM Cloud コンソールで、ナビゲーションメニュー アイコン インフラストラクチャ ストレージ > Block Storage スナップショット をクリックします。このページには、「スナップショット整合性グループ」と「スナップショット」の 2 つのメイン・タブがあります。
スナップショットタブを選択します。特定のリージョンのスナップショットがリストされます。別のリージョンのスナップショットを表示するには、矢印をクリックしてリストを展開し、別のリージョンを選択します。デフォルトでは、最新のスナップショットがリストの最初に表示されます。
スナップショットのリストが増大した場合、フィルターを使用して、1 ページあたりに表示するスナップショットの数を指定します。ページ・ナビゲーション矢印を使用して、リスト内を前後に移動します。

表1に、スナップショット一覧に表示される全スナップショットの情報を示します。

すべてのスナップショットのリスト
フィールド	説明
名前	スナップショット作成時に指定した名前。スナップショットの名前をクリックすると、詳細が表示されます。
ステータス	スナップショットのステータス。使用可能か（_アクティブな_ステータス）、使用不可能か、作成中かによって異なります。詳しくは、スナップショット状況を参照してください。
サイズ	スナップショットのサイズ（GB）。サイズはソースボリュームから継承されます。
ソース・ボリューム	スナップショットが作成されたブートボリュームまたはデータボリュームが表示されます。ボリュームの名前をクリックすると、詳細が表示されます。
スナップショット・コピー	スナップショットが他のリージョンに持っているコピーの数。
作成日	スナップショットが作成されたローカル日時。
整合性グループ	スナップショットがスナップショット・セットのメンバーである場合、このフィールドには整合性グループの名前が表示されます。

設定アイコン「設定」アイコンをクリックして、テーブルに追加できるオプション・フィールドを表示します。

すべてのスナップショットのオプションの情報フィールドのリスト。
フィールド	説明
暗号化	IBM管理の暗号化またはお客様管理の暗号化が表示されます。暗号化はソースボリュームから継承されます。
高速リストア状況	リストアの状況 (使用可能、保留中、または使用不可)。
リソース・グループ	スナップショットが属するリソースグループ。
ブート可能	「はい」または「いいえ」これは、スナップショットがブート・ボリュームまたはデータ・ボリュームのどちらで取得されたかを示します。
作成者	これは、スナップショットがユーザーによって作成されたのか、バックアップ・ポリシーによって作成されたのかを示します。

「アクション」アイコンをクリックすると、コンテキスト固有のアクションのメニューを表示できます。

ボリュームの詳細ページから、 Block Storage for VPC ボリュームから作成されたすべてのスナップショットを一覧表示することもできます。詳しくは、 Block Storage for VPC ボリュームから作成されたすべてのスナップショットの表示を参照してください。

コンソールでスナップショットの詳細を表示する

スナップショットに関する詳細情報を表示するには、VPC リストの Block Storage スナップショットでそのスナップショットを見つけます。次に、スナップショットの名前をクリックします。詳細ページのタイトルには、スナップショットの名前、その状況、および添付ユーザー・タグが表示されます。

スナップショットの詳細パネルには、以下の表で説明されている情報が表示されます。

スナップショットの詳細
フィールド	説明
名前	スナップショットの名前。「編集」アイコンをクリックして変更できます。詳しくは、スナップショットの名前についてを参照してください。
スナップショット ID	コピー可能なスナップショットの GUID。
ブート可能	「はい」または「いいえ」
CRN	コピー可能なスナップショットの CRN。
リソース・グループ	VPC のセットアップ時に定義されるリソース・グループ。
作成日	スナップショット・リソース作成プロセスが開始された日時。
取得された日付	このスナップショットがキャプチャーされた日付と時刻。
作成者	このフィールドには、 `User` または `Backup policy` のいずれかが表示されます。スナップショットがバックアップ・ポリシーによって作成された場合、UI には、バックアップ・スナップショットを作成したバックアップ計画の名前も表示されます。
サイズ	ソース・ボリュームから継承されたスナップショットのサイズ (GB)。
ソース・ボリューム	最初のスナップショットが取得されたソース・ボリューム。リンクをクリックすると、ボリューム詳細が表示されます。ボリュームが削除されている場合、名前はリンクなしで表示されます。
暗号化	プロバイダー管理またはお客様管理の暗号化。お客様管理の暗号化の場合、KMS インスタンス、ルート鍵の名前、およびルート鍵 ID が表示されます。
仮想サーバー式	allowed-use式は、ブータブルスナップショットがどの仮想サーバープロファイルと互換性があるかを定義し、制限します。スナップショットを使用して仮想サーバーインスタンスをプロビジョニングする場合、式は要求されたインスタンスプロパティと照合されます。詳しくは、カスタム画像への使用許可表現の追加を参照してください。
高速復元パネル	高速リストアを使用して、完全にプロビジョンされたこのスナップショットからボリュームを作成します。「編集」をクリックして、ゾーン内の高速リストアを有効または無効にします。
整合性グループ・パネル	スナップショットがメンバーになっている整合性グループに関する情報が表示されます。「仮想サーバーの作成」をクリックして、整合性グループからボリュームをリストアします。

「アクション」アイコンをクリックすると、コンテキスト固有のアクションのメニューを表示できます。

スナップショットからのボリュームの作成
高速リストアの編集、またはスナップショットの削除。

スナップショットのすべての整合性グループをコンソールに一覧表示する

コンソールで、作成したすべての整合性グループのリストを表示できます。最新の整合性グループがリストの先頭に表示されます。リストをフィルタリングして、特定の一貫性グループを表示できます。

IBM Cloud コンソールで、ナビゲーションメニュー アイコン インフラストラクチャ ストレージ > Block Storage スナップショット をクリックします。このページには、「スナップショット整合性グループ」と「スナップショット」の 2 つのメイン・タブがあります。
「スナップショット整合性グループ」 タブを選択します。特定の地域のグループがリストされます。別のリージョンの整合性グループを表示するには、矢印をクリックしてリストを展開し、別のリージョンを選択します。デフォルトでは、最新のスナップショット・グループがリストの先頭に表示されます。
一貫性グループのリストが大きくなったら、フィルタを使用して、ページごとに表示するアイテムの数を指定します。ページ・ナビゲーション矢印を使用して、リスト内を前後に移動します。

以下の表で、リスト内のすべての整合性グループの情報について説明します。

すべての一貫性グループのリスト
フィールド	説明
名前	整合性グループの作成時に指定した名前。グループ名をクリックすると詳細が表示されます。
ステータス	整合性グループの状況。使用可能 (アクティブ状況)、使用不可、または作成中のいずれであるかによって異なります。
ソース VSI	整合性グループ内のスナップショットのソース・ボリュームを含む仮想サーバー・インスタンスが表示されます。仮想サーバーインスタンスの名前をクリックすると、その詳細が表示されます。
スナップショット・メンバー	グループのメンバーになっているスナップショットの数。
作成日	スナップショットが作成されたローカル日時。

設定アイコン「設定」アイコンをクリックして、テーブルに追加できるオプション・フィールドを表示します。

すべてのスナップショットのオプションの情報フィールドのリスト。
フィールド	説明
作成者	これは、スナップショット・セットがユーザーによって作成されたのか、バックアップ・ポリシーによって作成されたのかを示します。
リソース・グループ	整合性グループが属するリソースグループ。
作成者	これは、スナップショットがユーザーによって作成されたのか、バックアップ・ポリシーによって作成されたのかを示します。

「アクション」アイコンをクリックすると、コンテキスト固有のアクションのメニューを表示できます。

名前変更
UUID のコピー
クラウドリソース名（CRN）をコピーする。
仮想サーバーの作成
の削除

コンソールで一貫性グループの詳細を表示する

整合性グループに関する詳細情報を表示するには、VPC リストの Block Storage スナップショットでそのグループを見つけます。次に、整合性グループの名前をクリックします。

概要セクションには、整合性グループ・スナップショットが取られた整合性グループおよび仮想サーバー・インスタンスに関する詳細が表示されます。最初のパネルには、整合性グループに関する情報が表示されます。

一貫性グループの概要。
フィールド	説明
名前	一貫性グループの一意の名前。更新する場合は、「編集」アイコンをクリックします。
整合性グループ ID	このフィールドは、整合性グループの ID ストリングを示します。
CRN	整合性グループのクラウド・リソース名。
作成者	このフィールドには、手動で作成されたスナップショットの場合は `user` が表示され、自動スナップショットの場合はバックアップ・ポリシーが表示されます。
リソース・グループ	整合性グループが属するリソースグループ。
作成日	整合性グループが作成された日付が表示されます。
スナップショット・メンバーの削除	これは、整合性グループの削除時にスナップショットが削除されるか保持されるかを示します。トグルをクリックして状況を変更します。
リージョン	整合性グループが作成された VPC リージョン。

詳しくは、スナップショット整合性グループの管理を参照してください。

2 番目のパネルには、スナップショット・セットのソース・ボリュームが接続されている仮想サーバー・インスタンスに関する情報が表示されます。

仮想サーバーインスタンスの概要。
フィールド	説明
名前	仮想サーバーインスタンスの名前。リンクをクリックすると、インスタンスの詳細ページに移動します。
仮想サーバー・インスタンス ID	CLI、API、Terraform などの他のインターフェースで使用する ID をコピーできます。
Virtual Private Cloud	整合性グループが作成されている VPC の名前。リンクをクリックして、VPC の詳細ページに移動します。
画像	オペレーティング・システム・イメージに関する情報。
リソース・グループ	仮想サーバー・インスタンスが属するリソース・グループ。
タグ	仮想サーバー・インスタンスに使用されるユーザー定義のタグ。

「スナップショット」リストには、整合性グループ内のスナップショットが表示され、表 1 で説明されているものと同じ情報とアクションが示されます。

CLIからのスナップショットの表示

CLIを使用して、すべてのスナップショット、ボリュームのすべてのスナップショット、および特定のスナップショットの詳細を一覧表示できます。

開始前に

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

ログイン IBM Cloud®.

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

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

CLI からのリージョン内のアカウントのすべてのスナップショットの表示

すべてのスナップショットをリストするには、snapshots コマンドを実行します。次の例は、 us-south リージョン内のすべてのリソースグループにあるすべてのスナップショットのリストを提供します。

ibmcloud is snapshots [--json]

Listing snapshots in all resource groups and region us-south under account Test Account as user test.user@ibm.com...
ID                                          Name             Status   Source volume                               Bootable   Resource group   Created                     Catalog Offering Version   Catalog Offering Plan   Storage Generation   
r006-22db5609-69a1-4fe2-bd02-f64fb11230b3   my-test-snapshot stable   r006-ccbc5bc6-cd88-48e0-9a1d-de0f4d024324   true       defaults         2025-07-31T00:04:24+00:00   -                          -                       1   
r006-e799fad8-aefa-4df5-81bd-dac6d13200a6   my-test-snap-1   stable   r006-2c5f577c-8cd0-47ef-8aec-cd8d1423249f   true       defaults         2025-08-06T22:38:01+00:00   -                          -                       1

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

CLIからボリュームのすべてのスナップショットを表示する

snapshots コマンドを実行して、ボリューム ID を指定します。

ibmcloud is snapshots --volume VOLUME-ID [--json]

以下の例は、ボリューム r010-df8ffd90-f2e5-470b-83d7-76e64995a1aa で作成された 3 つのスナップショットをすべて示しています。

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

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

CLI からの整合性グループ内のすべてのスナップショットの表示

snapshots コマンドを実行して、整合性グループの ID、名前、または CRN を指定します。

ibmcloud is snapshots --volume CONSISTENCY_GROUP_ID

以下の例では、整合性グループの ID を使用して、セットのメンバーであるスナップショットをリストします。

ibmcloud is snapshots --snapshot-consistency-group r174-7c8762e2-c1b9-424e-b773-23240d1780dd

Listing snapshots in all resource groups and region us-south under account Test Account as user test.user@ibm.com...
ID                                          Name            Status   Source volume                               Bootable   Resource group   Created
r174-b8cac978-a990-4824-a15c-604856982efe   snapshot-no-2   stable   r174-0641e516-09a1-4291-96ca-af254017123e   true       Default          2023-09-05T23:14:40+05:30
r174-7311f226-8259-46be-9bfa-5b2cd08bdf2f   snapshot-no-1   stable   r174-bf595773-9922-4dd4-9a3c-998b10022e0c   false      Default          2023-09-05T23:14:40+05:30

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

CLIからスナップショットの詳細を表示する

snapshots コマンドを実行し、スナップショットIDを指定する。

ibmcloud is snapshots SNAPSHOT_ID [--json]

以下の例は、 us-south 領域内のブート可能スナップショットの詳細を示しています。

ibmcloud is snapshot r006-e799fad8-aefa-4df5-81bd-dac6d13200a6

Getting snapshot r006-e799fad8-aefa-4df5-81bd-dac6d13200a6 under account Test Account as user test.user@ibm.com...

ID                              r006-e799fad8-aefa-4df5-81bd-dac6d13200a6   
Name                            my-test-snap-1   
CRN                             crn:v1:bluemix:public:is:us-south:a/a1234567::snapshot:r006-e799fad8-aefa-4df5-81bd-dac6d13200a6   
Status                          stable   
Clones                          Zone   Available   Created      

Source volume                   ID                                          Name               Remote Region   CRN                                                                                                                        Resource type      
                                r006-2c5f577c-8cd0-47ef-8aec-cd8d1423249f   test-volume-fast   -               crn:v1:bluemix:public:is:us-south-1:a/a1234567::volume:r006-2c5f577c-8cd0-47ef-8aec-cd8d1423249f   volume      

Backup policy plan              -   
Snapshot Copies                 -   
Bootable                        true   
Encryption                      provider_managed   
Encryption key                  -   
Source Snapshot                 -   
Minimum capacity(GB)            100   
Size(GB)                        10   
Source Image                    ID                                          Name                                 Remote Region   CRN                                                                                                                     Resource type      
                                r006-cec640a3-615e-4364-bae7-d3642d9f9e34   ibm-ubuntu-22-04-5-minimal-amd64-4   -               crn:v1:bluemix:public:is:us-south:a/a1234567::image:r006-cec640a3-615e-4364-bae7-d3642d9f9e34   image      

Operating system                Name                 Vendor      Version                                     Family         Architecture   Display name      
                                ubuntu-22-04-amd64   Canonical   22.04 LTS Jammy Jellyfish Minimal Install   Ubuntu Linux   amd64          Ubuntu Linux 22.04 LTS Jammy Jellyfish Minimal Install (amd64)      

Resource group                  ID                                 Name      
                                6edefe513d934fdd872e78ee6a8e73ef   defaults      

Created                         2025-08-06T22:38:01+00:00   
Captured at                     2025-08-06T22:38:02+00:00   
Tags                            -   
Service Tags                    -   
Storage Generation              1   
Allowed Use API Version         2025-07-17   
Allowed Use Bare Metal Server   true   
Allowed Use Instance            true

allowed-used プロパティは、作成時にソースボリュームまたはスナップショットから継承されます。 is.snapshot.snapshot.manage-allowed-use IAMロールの権限があれば、作成時または後で値を変更できます。プロパティは、ブール値の共通表現言語式で構成される。インスタンス式が true と評価された場合、スナップショットによる仮想サーバーインスタンスのプロビジョニングが許可されます。式が false と評価されると、プロビジョニングはブロックされる。作成時に値が指定されない場合、制約式はソース・リソースから取得される。

以下の例は、 eu-de 領域内のブート不能スナップショットの詳細を示しています。このスナップショットも、 eu-de-1 ゾーン内に高速リストア・クローンを持っています。

ibmcloud is snapshot r138-4463eb2c-4913-43b1-b9bf-62a94f74c146

Getting snapshot r138-4463eb2c-4913-43b1-b9bf-62a94f74c146 under account Test Account as user test.user@ibm.com...

ID                         r138-4463eb2c-4913-43b1-b9bf-62a94f74c146
Name                       cli-snapshot-test
CRN                        crn:v1:bluemix:public:is:eu-de:a/a1234567::snapshot:r138-4463eb2c-4913-43b1-b9bf-62a94f74c146
Status                     stable
Clones                     Zone      Available   Created
                           eu-de-1   true        2023-02-17T20:15:46+00:00

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

Bootable                   false
Encryption                 provider_managed
Encryption key             -
Minimum capacity(GB)       20
Size(GB)                   1
Snapshot Consistency Group ID                                                    Name                    Snapshot Consistency Group ID                                         Name                                   CRN                                                                    Resource type
                           r174-4625d29b-3ac9-4bee-aca8-9366c4fd0c44 multiple-snapshots-consistency-group-1   crn:v1:bluemix:public:is:eu-de:a/a1234567:snapshot-consistency-group:r174-4625d29b-3ac9-4bee-aca8-9366c4fd0c44   snapshot_consistency_group

Resource group             ID                                 Name
                           6edefe513d934fdd872e78ee6a8e73ef   defaults

Created                    2023-12-05T20:15:43+00:00
Captured at                2023-12-05T20:15:44+00:00
Tags                       env:prod,env:test
Service Tags               -
Storage Generation         1

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

CLI からのすべての高速リストア・スナップショット・クローンの表示

ibmcloud is snapshot-clones コマンドを発行して、スナップショットの使用可能なすべての高速リストア・クローンをリストすることができます。以下の例では、 r138-4463eb2c-4913-43b1-b9bf-62a94f74c146 という ID を持つスナップショットの使用可能な高速リストア・スナップショット・クローンをリストします。

ibmcloud is snapshot-clones r138-4463eb2c-4913-43b1-b9bf-62a94f74c146

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

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

CLI からの高速リストア・スナップショット・クローンの詳細の表示

ibmcloud is snapshot-clone コマンドを実行して、特定の高速リストア・スナップショットのクローンの詳細をリストすることができます。次の例は、 eu-de-3 ゾーンにあるスナップショット r138-4463eb2c-4913-43b1-b9bf-62a94f74c146 の高速復元スナップショットクローンの詳細を表示する方法を示しています。

ibmcloud is snapshot-clone 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
Href        https://eu-de.iaas.cloud.ibm.com/v1/regions/eu-de/zones/eu-de-3

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

CLI からのリモート・リージョン・スナップショット・コピーの詳細の表示

ibmcloud is snaphot コマンドを実行すると、特定のリモートリージョンのスナップショットコピーの詳細をリストアップできます。次の例は、 us-south リージョンにあるリモートリージョンのスナップショット (my-cli-snapshot-crc) の詳細を一覧表示する方法を示しています。応答は、親スナップショット（cli-snap-crc-test ）、親ボリューム、およびスナップショットを作成したバックアップポリシーに関する情報を提供します。

ibmcloud is snapshot my-cli-snapshot-crc

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

ID                     r006-8428038a-a399-4894-8c84-c8d7a4a75fae
Name                   my-cli-snapshot-crc
CRN                    crn:v1:bluemix:public:is:us-south:a/a1234567::snapshot:r006-8428038a-a399-4894-8c84-c8d7a4a75fae
Status                 stable
Clones                 Zone   Available   Created

Source volume          ID                                          Name                   Remote Region   CRN                                                                                                                       Resource type
                       r014-77ecae08-4a1e-4d15-94f0-814bfc1e108b   -remote-814bfc1e108b   us-east         crn:v1:bluemix:public:is:us-east-a/a1234567::volume:r014-77ecae08-4a1e-4d15-94f0-814bfc1e108b   volume

Backup policy plan     ID                                          Name                   Resource type
                       r014-d659eb15-ff07-4d54-8dd8-808a037e1b61   -remote-808a037e1b61   backup_policy_plan

Snapshot Copies        -
Bootable               false
Encryption             provider_managed
Encryption key         -
Source Snapshot        ID                                          Name                Remote Region   CRN                                                                                                                       Resource type
                       r014-1b960f89-e5f8-4323-ab81-ceaf15ea2a1c   cli-snap-crc-test   us-east         crn:v1:bluemix:public:is:us-east:a/a1234567::snapshot:r014-1b960f89-e5f8-4323-ab81-ceaf15ea2a1c   snapshot

Minimum capacity(GB)   100
Size(GB)               1
Source Image           -
Resource group         ID                                 Name
                       6edefe513d934fdd872e78ee6a8e73ef   defaults

Created                2024-06-18T17:21:24+00:00
Captured at            2024-06-18T17:21:20+00:00
Tags                   -
Service Tags           -
Storage Generation     1

CLI からのすべてのスナップショット整合性グループの表示

snapshot-consistency-groups コマンドを実行して、リージョン内のすべての整合性グループをリストします。

ibmcloud is snapshot-consistency-groups

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

CLI からのスナップショット整合性グループの詳細の表示

snapshot-consistency-group コマンドを実行して、リージョン内の特定の整合性グループの詳細をリストします。

ibmcloud is snapshot-consistency-group CONSISTENCY_GROUP_ID

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

APIでスナップショットを一覧表示する

API を使用してスナップショットをリストできます。

APIですべてのスナップショットを一覧表示する

以下のサンプル要求に示すように、 VPC API で /snapshots メソッドを呼び出すことにより、ボリュームのすべてのスナップショットをプログラマチックにリストすることができます。デフォルトでは、リストには最新のスナップショットが最初に表示され、その後に古いスナップショットが降順で表示されます。

curl -X GET \
  "$vpc_api_endpoint/v1/snapshots?version=2022-12-16&generation=2" \
  -H "Authorization: $iam_token"

リソースグループID、ソースボリュームID、またはソースボリュームCRNを使用してリストをフィルタリングし、さらに以下のオプションを使用して結果をフィルタリングできます：

制限 - 1 ページに表示されるスナップショットの数を制御します。
開始 - リストを開始するスナップショットを (ID で) 指定します。
ソート - ページをソートする順序を制御します (例えば、作成日順や、スナップショット名によるアルファベット順などです)。

たとえば、次の呼び出しでは、1つのボリュームに対して作成されたスナップショットを表示するようにリストをフィルタリングし、結果を1ページにつき5件に制限します。

curl -X GET \
"$vpc_api_endpoint/v1/snapshots?version=2022-08-16&generation=2" \
-H "Authorization: $iam_token" \
-d '{
      "limit": 5,
      "source_volume":
        "id": "8948ad59-bc0f-7510-812f-5dc64f59fab8"
      }'

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

{
    "first": {
      "href": "https://us-south.iaas.cloud.ibm.com/v1/snapshots?limit=50"
    },
    "limit": 5,
    "snapshots": [
      {
        "allowed_use": {
          "api_version": "2025-03-31",
          "bare_metal_server": "false",
          "instance": "gpu.count > 0 && gpu.manufacturer == 'nvidia'"
        },
        "bootable": true,
        "clones": [],
        "created_at": "2022-12-18T20:18:18Z",
        "crn": "crn:[...]",
        "deletable": true,
        "encryption": "user_managed",
        "encryption_key": {
          "crn": "crn:[...]"
        },
        "href": "https://us-south.iaas.cloud.ibm.com/v1/snapshots/f945d446-0d46-478a-a298-acba907d45d1",
        "id": " f945d446-0d46-478a-a298-acba907d45d1",
        "lifecycle_state": "stable",
        "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",
          "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:[...]",
          "href": "https://us-south.iaas.cloud.ibm.com/v1/images/de066f7d-b95f-4ca2-9aa0-b6362889e933",
          "id": "de066f7d-b95f-4ca2-9aa0-b6362889e933",
          "name": "ubuntu-20-04-minimal-amd64-1"
        },
        "source_volume": {
          "crn": "crn:[...]",
          "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/8948ad59-bc0f-7510-812f-5dc64f59fab8",
          "id": "8948ad59-bc0f-7510-812f-5dc64f59fab8",
          "name": "instance-vol1"
        },
        "storage_generation": 1,
        "user_tags": []
      },
      {
        "allowed_use": {
          "api_version": "2025-03-31",
          "bare_metal_server": "false",
          "instance": "gpu.count > 0 && gpu.manufacturer == 'nvidia'"
        },
        "bootable": true,
        "clones": [],
        "created_at": "2022-12-17T20:11:28Z",
        "crn": "crn:[...]",
        "deletable": true,
        "encryption": "user_managed",
        "encryption_key": {
          "crn": "crn:[...]"
        },
        "href": "https://us-south.iaas.cloud.ibm.com/v1/snapshots/e5bfa329-0e36-433f-a3bb-0df632e79263",
        "id": "e5bfa329-0e36-433f-a3bb-0df632e79263",
        "lifecycle_state": "stable",
        "minimum_capacity": 100,
        "name": "my-snapshot-2",
        "operating_system": {
          "architecture": "amd64",
          "dedicated_host_only": false,
          "display_name": "Ubuntu Linux 20.04 LTS Focal Fossa Minimal Install (amd64)",
          "family": "Ubuntu Linux",
          "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:[...]",
          "href": "https://us-south.iaas.cloud.ibm.com/v1/images/23045dc2-b463-4cda-b424-bc3dcf51dfbb",
          "id": "23045dc2-b463-4cda-b424-bc3dcf51dfbb",
          "name": "ubuntu-20-04-minimal-amd64-1"
        },
        "source_volume": {
          "crn": "crn:[...]",
          "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/8948ad59-bc0f-7510-812f-5dc64f59fab8",
          "id": "8948ad59-bc0f-7510-812f-5dc64f59fab8",
          "name": "instance-vol1"
        },
        "storage_generation": 1,
        "user_tags": []
      }
    ],
    "total_count": 2
  }

APIでスナップショットの詳細を一覧表示する

VPC API で /snapshots メソッドを呼び出し、以下のサンプル要求に示されているようにスナップショット ID を指定することで、単一スナップショットの詳細をプログラマチックに取得できます。

curl -X GET \
"$vpc_api_endpoint/v1/snapshots/7528eb61-bc01-4763-a67a-a414a103f96d?version=2022-12-16&generation=2" \
-H "Authorization: $iam_token"

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

{
  "allowed_use": {
    "api_version": "2025-03-31",
    "instance": "gpu.count >= 2 && gpu.model in ['h100', 'a100'] && gpu.memory > 16 && enable_secure_boot == true",
    "bare_metal_server": "false"
  },
  "bootable": true,
  "clones": [],
  "captured_at": "2022-12-16T20:19:12Z",
  "created_at": "2021-12-16T20:18:18Z",
  "crn": "crn:[...]",
  "deletable": true,
  "encryption": "user_managed",
  "encryption_key": {
    "crn": "crn:[...]"
  },
  "href": "https://us-south.iaas.cloud.ibm.com/v1/snapshots/7528eb61-bc01-4763-a67a-a414a103f96d",
  "id": "7528eb61-bc01-4763-a67a-a414a103f96d",
  "lifecycle_state": "stable",
  "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",
    "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/59ff2d74-b0e5-4b40-a553-b812e50c72e9",
    "id": "59ff2d74-b0e5-4b40-a553-b812e50c72e9",
    "name": "Default"
  },
  "resource_type": "snapshot",
  "service_tags": [],
  "size": 1,
  "source_image": {
    "crn": "crn:[...]",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/images/dc021ec6-759d-4b87-8e0a-04106b8aa635",
    "id": "dc021ec6-759d-4b87-8e0a-04106b8aa635",
    "name": "ubuntu-20-04-minimal-amd64-1"
  },
  "source_volume": {
    "crn": "crn:[...]",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/c90453a6-7b5e-47ce-95fc-f6fff9e5b79c",
    "id": "c90453a6-7b5e-47ce-95fc-f6fff9e5b79c",
    "name": "my-instance-data"
  },
  "storage_generation": 1,
  "user_tags": []
}

allowed-used プロパティは、作成時にソースボリュームまたはスナップショットから継承されます。 is.snapshot.snapshot.manage-allowed-use IAMロールの権限があれば、作成時または後で値を変更できます。プロパティは、ブール値の共通表現言語式で構成される。インスタンス式が true と評価された場合、スナップショットによる仮想サーバーインスタンスのプロビジョニングが許可されます。式が false と評価されると、プロビジョニングはブロックされる。作成時に値が指定されない場合、制約式はソース・リソースから取得される。

API を使用したすべての高速リストア・スナップショット・クローンの表示

以下のサンプル要求に示すように、 VPC API で /snapshots/clones メソッドを呼び出し、スナップショット ID を指定することで、すべての高速リストア・クローンをプログラマチックにリストすることができます。

すべての高速リストア・スナップショット・クローンをリストするには、 GET /v1/snapshots/{id}/clones 要求を行います。

curl -X GET \
"$vpc_api_endpoint/v1/snapshots/7528eb61-bc01-4763-a67a-a414a103f96d/clones?version=2022-12-16&generation=2" \
-H "Authorization: $iam_token"

正常な応答により、高速リストア・スナップショットのクローンに関する情報が提供されます。

{
  "clones": [
    {
      "available": true,
      "created_at": "2022-12-16T19:55:28.537Z",
      "zone": {
        "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-2",
        "name": "us-south-2"
      }
    },
    {
      "available": true,
      "created_at": "2022-12-16T19:58:22.337Z",
      "zone": {
        "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-3",
        "name": "us-south-3"
      }
    }
  ]
}

API を使用した高速リストア・スナップショットのクローンの詳細の表示

以下のサンプル要求に示すように、 VPC API で /snapshots/clones メソッドを呼び出し、スナップショット ID とゾーンを指定することで、単一の高速リストア・クローンの詳細をプログラマチックに取得できます。

ID およびゾーン名で指定された単一の高速リストア・スナップショット・クローンを取得するには、 GET /v1/snapshots/{id}/clones/{zone-name} 要求を行います。

curl -X GET \
"$vpc_api_endpoint/v1/snapshots/7528eb61-bc01-4763-a67a-a414a103f96d/clones/us-south-1?version=2022-12-16&generation=2" \
-H "Authorization: $iam_token"

成功した応答には、高速リストア・スナップショットのクローンに関する以下の情報が表示されます。

{
  "available": true,
  "created_at": "2022-12-16T20:15:35.164Z",
  "zone": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-1",
    "name": "us-south-1"
  }
}

API を使用したリモート・リージョン・スナップショット・コピーの詳細の表示

VPC API で /snapshots メソッドを呼び出し、以下のサンプル要求に示されているようにスナップショット ID を指定することで、単一スナップショットの詳細をプログラマチックに取得できます。

curl -X GET \
"$vpc_api_endpoint/v1/snapshots/7528eb61-bc01-4763-a67a-a414a103f96d?version=2022-12-16&generation=2" \
-H "Authorization: $iam_token"

応答が成功すると、以下の例のような情報が表示されます。

{
  "allowed_use": {
    "api_version": "2025-03-31",
    "instance": "gpu.count >= 2 && gpu.model in ['h100', 'a100'] && gpu.memory > 16 && enable_secure_boot == true",
    "bare_metal_server": "false"
  },
  "bootable": true,
  "created_at": "2023-05-18T20:18:18Z",
  "crn": "crn:[...]",
  "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": "stable",
  "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": [],
  "region": "us-east",
  "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",
    	   "href": "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"
  },
  "storage_generation": 1,
  "user_tags": []
}

API を使用したすべてのスナップショット整合性グループの表示

以下のサンプル要求に示すように、 VPC API で /snapshot_consistency_groups メソッドを呼び出すことによって、すべての整合性グループをプログラマチックにリストすることができます。

GET /snapshot_consistency_groups

API を使用したスナップショット整合性グループの詳細の表示

以下のサンプル要求に示すように、 VPC API で /snapshot_consistency_groups メソッドを呼び出すことにより、整合性グループの詳細をプログラマチックに取得できます。

GET /snapshot_consistency_groups/r006-e8707243-96b3-4c27-be1f-57eff0196207

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

{
    "created_at": "2023-12-05T22:40:42Z",
    "id": "r006-e8707243-96b3-4c27-be1f-57eff0196207",
    "delete_snapshots_on_delete": true,
    "crn": "crn:v1:bluemix:public:is:us-south:a/a1234567::snapshot-consistency-group:r006-e8707243-96b3-4c27-be1f-57eff0196207",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/snapshot_consistency_groups/r006-e8707243-96b3-4c27-be1f-57eff0196207",
    "name": "my-consistency-group-snapshots",
    "resource_group": {
        "id": "a41ca701e1c041c1bb224564ff645770",
        "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/a41ca701e1c041c1bb224564ff645770",
        "name": "Default"
    },
    "lifecycle_state": "stable",
    "resource_type": "snapshot_consistency_group",
    "service_tags": [
        "is.instance:0727_44fda9fe-eeef-4e71-8fa4-4c3f7300e645"
    ],
    "snapshots": [
        {
            "crn": "crn:v1:bluemix:public:is:us-south:a/a1234567::snapshot:r006-540d8d17-5334-4d04-b845-270dbb30233f",
            "id": "r006-540d8d17-5334-4d04-b845-270dbb30233f",
            "href": "https://us-south.iaas.cloud.ibm.com/v1/snapshots/r006-540d8d17-5334-4d04-b845-270dbb30233f",
            "name": "my-test-scg-1",
            "resource_type": "snapshot"
        },
        {
            "crn": "crn:v1:bluemix:public:is:us-south:a/a1234567::snapshot:r006-77cc526a-b21c-4bdc-a2b3-442a1d4e78c0",
            "id": "r006-77cc526a-b21c-4bdc-a2b3-442a1d4e78c0",
            "href": "https://us-south.iaas.cloud.ibm.com/v1/snapshots/r006-77cc526a-b21c-4bdc-a2b3-442a1d4e78c0",
            "name": "my-test-scg-2",
            "resource_type": "snapshot"
        }
    ]
}

Terraform を使用したスナップショットの表示

Terraform を使用してスナップショットを表示できます。

Terraform を使用するには、Terraform CLI をダウンロードして、 IBM Cloud プロバイダー・プラグインを構成します。詳しくは、 Terraform の概要を参照してください。

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

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

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

Terraform を使用したすべてのスナップショットのリスト表示

スナップショットのコレクションの詳細を読み取り専用データ・ソースとしてインポートします。スナップショットのコレクションを source_volume、 resource_group、 name などでフィルターに掛けることができます。

data "ibm_is_snapshots" "example" {
}

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

Terraform を使用したスナップショットの詳細のリスト表示

スナップショットの詳細を読み取り専用データ・ソースとしてインポートします。スナップショット ID またはスナップショット名のいずれかを指定できます。

data "ibm_is_snapshot" "example" {
  identifier = "r138-e6664842-b370-496a-9ae7-da3fb647707c"
}

data "ibm_is_snapshot" "example" {
  name = "snappy-snap-snap"
}

allowed-used プロパティは、作成時にソースボリュームまたはスナップショットから継承されます。 is.snapshot.snapshot.manage-allowed-use IAMロールの権限があれば、作成時または後で値を変更できます。プロパティは、ブール値の共通表現言語式で構成される。インスタンス式が true と評価された場合、スナップショットによる仮想サーバーインスタンスのプロビジョニングが許可されます。式が false と評価されると、プロビジョニングはブロックされる。作成時に値が指定されない場合、制約式はソース・リソースから取得される。

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

すべての高速リストア・スナップショット・クローンのリスト

スナップショットのすべての高速リストア・クローンの詳細を読み取り専用データ・ソースとしてインポートします。

data "ibm_is_snapshot_clones" "ds_snapshotclones" {
  snapshot = "r138-e6664842-b370-496a-9ae7-da3fb647707c"
}

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

Terraform を使用した高速リストア・クローンの詳細のリスト表示

ゾーン内のスナップショットの高速リストア・クローンの詳細を読み取り専用データ・ソースとしてインポートします。

data "ibm_is_snapshot_clone" "ds_snapshotclone" {
  snapshot = "r138-e6664842-b370-496a-9ae7-da3fb647707c"
  zone     = "eu-de-1"
}

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

Terraformですべての一貫性グループをリストアップする

整合性グループのコレクションの詳細を読み取り専用データ・ソースとしてインポートします。

data "ibm_is_snapshot_consistency_groups" "example" {
}

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

Terraform を使用した整合性グループの詳細のリスト

スナップショット整合性グループの詳細を読み取り専用データ・ソースとしてインポートします。整合性グループは、ID または整合性グループの名前のいずれかで指定できます。

data "ibm_is_snapshot_consistency_group" "example" {
  identifier = ibm_is_snapshot_consistency_group.is_snapshot_consistency_group.id
}

data "ibm_is_snapshot_consistency_group" "example" {
  name = "my-data-consistency-group"
}

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

IBM Cloud

Block Storage for VPC スナップショットおよび整合性グループの表示

コンソールでスナップショットを一覧表示する

コンソールにすべてのスナップショットを表示する

コンソールでスナップショットの詳細を表示する

スナップショットのすべての整合性グループをコンソールに一覧表示する

コンソールで一貫性グループの詳細を表示する

CLIからのスナップショットの表示

開始前に

CLI からのリージョン内のアカウントのすべてのスナップショットの表示

CLIからボリュームのすべてのスナップショットを表示する

CLI からの整合性グループ内のすべてのスナップショットの表示

CLIからスナップショットの詳細を表示する

CLI からのすべての高速リストア・スナップショット・クローンの表示

CLI からの高速リストア・スナップショット・クローンの詳細の表示

CLI からのリモート・リージョン・スナップショット・コピーの詳細の表示

CLI からのすべてのスナップショット整合性グループの表示

CLI からのスナップショット整合性グループの詳細の表示

APIでスナップショットを一覧表示する

APIですべてのスナップショットを一覧表示する

APIでスナップショットの詳細を一覧表示する

API を使用したすべての高速リストア・スナップショット・クローンの表示

API を使用した高速リストア・スナップショットのクローンの詳細の表示

API を使用したリモート・リージョン・スナップショット・コピーの詳細の表示

API を使用したすべてのスナップショット整合性グループの表示

API を使用したスナップショット整合性グループの詳細の表示

Terraform を使用したスナップショットの表示

Terraform を使用したすべてのスナップショットのリスト表示

Terraform を使用したスナップショットの詳細のリスト表示

すべての高速リストア・スナップショット・クローンのリスト

Terraform を使用した高速リストア・クローンの詳細のリスト表示

Terraformですべての一貫性グループをリストアップする

Terraform を使用した整合性グループの詳細のリスト

次のステップ