File Storage for VPC スナップショットの表示

コンソール、CLI、API、またはTerraformを通じて、 File Storage for VPC のスナップショット一覧と詳細を確認できます。 スナップショットの数、サイズ、ステータス、レプリケーションの役割などの情報にアクセスします。

コンソールでのスナップショットの表示

コンソールでは、共有の詳細ページでファイル共有に属するすべてのスナップショットのリストを表示できます。

  1. IBM Cloud コンソール で、 ナビゲーションメニュー アイコン メニューアイコン > インフラストラクチャー VPCアイコン > ストレージ > ファイルストレージ共有 をクリックする。

  2. ファイル共有は、特定の地域について一覧表示される。 別の地域のリソースを見たい場合は、矢印をクリックしてリストを展開し、別の地域を選択してください。 デフォルトでは、最新の共有がリストの一番上に表示されます。

  3. 表示したいファイル共有を選択し、 スナップショットタブをクリックします。

    「スナップショットの概要」セクションには、以下の情報が含まれています：

    スナップショット」タブの概要。
    フィールド 説明
    スナップショット・カウント ファイル共有に対して取得されたスナップショットの数。
    すべてのスナップショットで変更されたデータのサイズ 最初のスナップショットは、ファイル共有の完全なコピーです。 後続のスナップショットは、最後のスナップショットが取られた後に発生した変更をキャプチャします。 このフィールドには、スナップショットで使用されている容量の合計が表示されます。
    可用性の選択 このリリースの地域ファイル共有では、CLI または API を使用してファイル共有操作を実行する場合、スナップショットが作成されると、スナップショット・サイズ・フィールドのデフォルトが 1 になり、それ以外の場合は 0 になります。 この値はスナップショットの実際のサイズを表すものではありません。
    複製の役割 このロールはソース共有のレプリケーションロールと一致します。

    Snapshots] セクションには、このソース共有で取得されたすべてのスナップショットのリストが含まれます。

    スナップショット」タブの概要。
    フィールド 説明
    名前 スナップショットの詳細パネルにリンクされているスナップショットの一意の名前。
    ソース・シェアのサイズ スナップショットが取得されたときのソース共有のサイズ。 このスナップショットを使用してファイル共有を復元する場合、このフィールドのサイズは作成されるファイル共有のサイズを示します。
    ステータス 例えば、stable です。

    アクションアイコンアクションアイコン アクションをクリックすると、コンテキストに応じたアクションメニューが表示されます。

    アクションメニューはダイナミックだ。 共有がレプリカ共有の場合は、Restore アクションのみが表示されます。 共有がソース共有であるか、レプリカがない場合、3つのアクションすべてが利用可能です。

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

スナップショットの詳細情報を見るには、ファイル共有の詳細ページでスナップショットを探してください。 次に、スナップショットの名前をクリックします。 スナップショットの詳細]サイドパネルには、スナップショットの名前、CRNとID、添付されているユーザーとアクセス管理タグなどの情報が表示されます。

レプリカ共有ではスナップショットを作成することはできませんが、ソース共有のスナップショットは、次回のスケジュールされたレプリケーション同期時にレプリカ上で自動的に生成されます。 これらの複製スナップショットはファイル・サービスによって作成される。 オリジナルのスナップショットの名前やタグは引き継がれない。 しかしながら、それらはソーススナップショットと同じフィンガープリント値を持つ。

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

スナップショットの詳細
フィールド 説明
名前 スナップショットの名前。 編集アイコン 編集アイコン をクリックして変更できます。 詳しくは、スナップショットの名前についてを参照してください。
ID スナップショットのコピー可能なUUID。
CRN コピー可能なスナップショットの CRN。
リソース・グループ VPC のセットアップ時に定義されるリソース・グループ。
ステータス 例えば、stable です。
ロケーション ソースファイル共有の場所と同じ。
作成日 スナップショット・リソース作成プロセスが開始された日時。
共有元ファイルのサイズ スナップショット取得時の共有サイズ（GB）。
ソース・ファイル共有 最初のスナップショットが取得されたソースのシェア。 詳細については、リンクをクリックしてください。
暗号化 プロバイダー管理または顧客管理の暗号化。 カスタマー・マネージド暗号化の場合、KMSインスタンス、ルート・キー名、ルート・キーIDが表示される。
指紋 .snapshot フォルダ内のスナップショットを見つけるために使用できる参照 ID。
ユーザー・タグ 追加したタグ レプリカ共有上のスナップショットを見る場合、このフィールドは空です。
作成者 スナップショットがユーザーによって作成されたのか、 バックアップポリシー によって作成されたのかを示します。 このフィールドは、スナップショットがレプリカファイル共有で表示されている場合、 _レプリケーション_を表示します。

アクションアイコンアクションアイコン アクションをクリックすると、コンテキストに応じたアクションメニューが表示されます。

アクションメニューはダイナミックだ。 共有がレプリカ共有の場合は、Restore アクションのみが表示されます。 共有がソース共有であるか、レプリカがない場合、3つのアクションすべてが利用可能です。

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

CLI を使用すると、すべてのスナップショット、特定の共有のすべてのスナップショット、および特定のスナップショットの詳細を一覧表示できます。

レプリカ共有ではスナップショットを作成することはできませんが、ソース共有のスナップショットは、次回のスケジュールされたレプリケーション同期時にレプリカ上で自動的に生成されます。 これらの複製スナップショットはファイル・サービスによって作成される。 オリジナルのスナップショットの名前やタグは引き継がれない。 しかしながら、それらはソーススナップショットと同じフィンガープリント値を持つ。

開始前に

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

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

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

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

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

ゾーンで利用可能なすべてのスナップショットを見るには、 ibmcloud is share-snapshots コマンドを実行する。

ibmcloud is share-snapshots [--share SHARE] [--backup-policy-plan BACKUP_POLICY_PLAN [--backup-policy BACKUP_POLICY]] [--output JSON] [-q, --quiet]

ibmcloud is share-snapshots

Listing share snapshots in all resource groups and region au-syd under account Test Account as user test.user@ibm.com...
ID                                          Name                                Created at                  Fingerprint                            Minimum Size   Lifecycle state   Zone       Status      User Tags
r026-c8fd81f8-3437-424e-8fc0-f9dd2f4766d3   demo-bkp-plan-2-02ae167865c0-44e8   2024-12-09T16:55:13+05:30   15b9509d-b6f8-461b-987a-2333be203e0e   40             stable            au-syd-1   available   dev:tags
r026-9997158e-daa6-409d-8e51-b2bbbc23c5d2   demo-bkp-plan-2-29e97584db07-4e86   2024-12-09T16:55:12+05:30   0b9c1e17-d872-4858-b478-a4d46cfd3dfe   40             stable            au-syd-1   available   dev:tags
r026-d04eb5f7-4159-4fa0-bfdd-83deca3b73b0   demo-bkp-plan-2-2b8c5b1bcadc-496f   2024-12-09T18:55:14+05:30   622a0e1f-7a48-4dce-adf0-c54adb4605c3   40             stable            au-syd-1   available   dev:tags
r026-9289ba15-a922-4b75-9650-7afc9471e9d9   demo-bkp-plan-2-47a13671bf22-47e0   2024-12-09T17:55:11+05:30   9a433610-0134-4162-8af3-d9358af832b5   40             stable            au-syd-1   available   dev:tags
r026-bee1b285-adc3-43e6-b8dd-5645efbe5732   demo-bkp-plan-2-4a90deb0778a-4f1a   2024-12-09T17:55:11+05:30   f8ec608d-9fbc-48cf-9018-01b1a8711449   40             stable            au-syd-1   available   dev:tags

地域ファイル共有のスナップショットの場合、CLIとAPIの両方の応答でゾーンの値は空白になります。

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

CLIから共有のすべてのスナップショットを表示する

ibmcloud is share-snapshots コマンドを実行し、共有名または ID を指定してスナップショット結果をフィルタリングします。 次の例では、共有のスナップショットを r026-734c173e-044f-4d09-a729-950364ea9900。

ibmcloud is share-snapshots r026-734c173e-044f-4d09-a729-950364ea9900

Listing share snapshots in all resource groups and region us-south under account Test Account as user test.user@ibm.com...
ID                                         Name                    Created at               Fingerprint                          Minimum size Lifecycle state Zone      Status    User Tags
r138-4463eb2c-4913-43b1-b9bf-62a94f74c146  my-first-share-snapshot 024-12-18T20:15:43+00:00 7abc3aef-c2bc-4f65-a296-2928e534d498 40           stable          us-south-1 Available env:test

地域ファイル共有のスナップショットの場合、CLIとAPIの両方の応答でゾーンの値は空白になります。

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

CLIからバックアップポリシーによって作成されたすべてのスナップショットを表示する

ibmcloud is share-snapshots コマンドを実行し、バックアップポリシープランを指定する。 バックアップポリシープランのIDまたは名前のいずれかを指定できます。 バックアップポリシープランの名前を使用する場合は、バックアップポリシーの名前またはIDも指定する必要があります。

ibmcloud is share-snapshots [--backup-policy-plan BACKUP_POLICY_PLAN] [--backup-policy BACKUP_POLICY]

次の例は、ID r006-158e0d66-338e-4501-b756-be0732677da8 のバックアップポリシープランによって取得されたスナップショットを示しています。

ibmcloud is share-snapshots --backup-policy-plan r006-158e0d66-338e-4501-b756-be0732677da8 --share my-file-share

Listing share snapshots of share my-file-share under account Test Account as user test.user@ibm.com...
ID                                          Name                                Created at                  Fingerprint                            Minimum Size   LifeCycle State   Zone         Status      User Tags
r006-b4d12d66-18de-4660-9fe7-12e667d5ed5b   demo-bkp-plan-1-d619b2fb4a68-4602   2024-11-19T11:33:27+05:30   643ce8da-bbbd-4515-b988-701aea2667df   40             stable            us-south-1   available   dev:tags
r006-59d25cac-92cd-4076-b988-e5d6746a848f   demo-bkp-plan-1-e4406ae16e8f-4cb0   2024-11-19T12:32:23+05:30   202a5bd4-a1e0-4d89-914c-3574f45fc725   40             stable            us-south-1   available   dev:tags
r006-41785c6b-5d48-4dc1-89b7-21a5b2ada21e   demo-bkp-plan-1-efc6f81b8505-4782   2024-11-19T10:32:19+05:30   acd57e05-ffe2-4eed-8e78-40b5000c53d3   40             stable            us-south-1   available   dev:tags

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

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

スナップショットID、またはスナップショット名と共有名またはIDを指定して、 ibmcloud is share-snapshot コマンドを実行します。 スナップショットIDはアカウント全体で一意です。 ただし、スナップショット名はスナップショットレベルでしか一意ではありません。

ibmcloud is share-snapshot SHARE_SNAPSHOT [--output JSON] [-q, --quiet]

次の例は、スナップショットの詳細を示しています。

ibmcloud is share-snapshot my-file-share r006-6c760e3e-33fc-41a4-b896-8a2c229ddccd

Getting share snapshot ID r006-6c760e3e-33fc-41a4-b896-8a2c229ddccd for share ID my-file-share under account Test Account as user test.user@ibm.com...

ID                   r006-6c760e3e-33fc-41a4-b896-8a2c229ddccd
Name                 my-first-share-snapshot
Fingerprint          7f29bdd5-bc67-4e67-9b24-638a73be4742
Backup Policy Plan   -
Status               available
Created at           2025-03-10T19:17:55+00:00
Captured At          2025-03-10T19:17:58+00:00
CRN                  crn:v1:bluemix:public:is:us-south-2:a/a1234567::share-snapshot:r006-d14e4b29-cb73-4886-a267-b2cd58d67641/r006-6c760e3e-33fc-41a4-b896-8a2c229ddccd
LifeCycle Reasons    Code   Message   More Info
                     -      -

LifeCycle State      stable
Href                 https://us-south.iaas.cloud.ibm.com/v1/shares/r006-d14e4b29-cb73-4886-a267-b2cd58d67641/snapshots/r006-6c760e3e-33fc-41a4-b896-8a2c229ddccd
Minimum Size         10
Zone                 ID   Name
                          us-south-2

Resource group       ID                                 Name
                     6edefe513d934fdd872e78ee6a8e73ef   defaults

Status reasons       Status code   Status message
                     -             -

Resource type        share_snapshot

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

API を使用したスナップショットの一覧表示

VPC APIを使用すれば、同じ共有に属するスナップショットをプログラムで一覧表示できます。

レプリカ共有ではスナップショットを作成することはできませんが、ソース共有のスナップショットは、次回のスケジュールされたレプリケーション同期時にレプリカ上で自動的に生成されます。 これらの複製スナップショットはファイル・サービスによって作成される。 オリジナルのスナップショットの名前やタグは引き継がれない。 しかしながら、それらはソーススナップショットと同じフィンガープリント値を持つ。

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

VPC API の /shares/{share-id}/snapshots メソッドを呼び出すことで、共有のすべてのスナップショットをプログラ ム的に一覧表示できます。 デフォルトでは、リストには最新のスナップショットが最初に表示され、その後に古いスナップショットが降順で表示されます。

curl -X GET \
  "$vpc_api_endpoint/v1/shares/{share-id}/snapshots?version=2024-12-10&generation=2" \
  -H "Authorization: Bearer $iam_token"

バックアップポリシーによって取得されたスナップショットを表示するには、バックアップポリシープランIDを使用してリストをフィルタリングできます。 たとえば、次の呼び出しでは、特定のバックアッププランによって作成されたスナップショットのみを表示するようにリストをフィルタリングし、結果の表示を1ページあたり5件に制限します。

curl -X GET \
"$vpc_api_endpoint/v1/shares/r006-0fe9e5d8-0a4d-4818-96ec-e99708644a58/snapshots?version=2024-12-10&generation=2" \
-H "Authorization: Bearer $iam_token" \
-d '{
      "limit": 5,
      "backup_policy_plan":
        "id": "r006-b470ae68-8325-4a9c-9051-1ade8c3806c3"
      }'

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

{
  "limit": 5,
  "snapshots": [
    {
      "captured_at": "2024-12-10T01:21:12.000Z",
      "created_at": "2024-12-10T01:59:46.000Z",
      "crn": "crn:v1:bluemix:public:is:us-south:a/a1234567::share-snapshot:r006-0fe9e5d8-0a4d-4818-96ec-e99708644a58/r006-e13ee54f-baa4-40d3-b35c-b9ec163972b4",
      "fingerprint": "7abc3aef-c2bc-4f65-a296-2928e534d498",
      "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/r006-0fe9e5d8-0a4d-4818-96ec-e99708644a58/snapshots/r006-e13ee54f-baa4-40d3-b35c-b9ec163972b4",
      "id": "r006-e13ee54f-baa4-40d3-b35c-b9ec163972b4",
      "lifecycle_state": "stable",
      "minimum_size": 10,
      "name": "my-first-share-snapshot",
      "resource_group": {
        "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/fee82deba12e4c0fb69c3b09d1f12345",
        "id": "fee82deba12e4c0fb69c3b09d1f12345",
        "name": "Default"
      },
      "resource_type": "share_snapshot",
      "status": "available",
      "status_reasons": [],
      "user_tags": [],
      "zone": {
        "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-1",
        "name": "us-south-1"
      }
    },
    {
      "captured_at": "2024-12-10T02:21:12.000Z",
      "created_at": "2024-12-10T02:59:46.000Z",
      "crn": "crn:v1:bluemix:public:is:us-south:a/a1234567::share-snapshot:r006-1fe9e5d8-0a4d-4818-96ec-e99708644a58/r006-e13ee54f-baa4-40d3-b35c-b9ec163972b4",
      "fingerprint": "9bbc3aef-c2bc-4f65-a296-2928e534d498",
      "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/r006-1fe9e5d8-0a4d-4818-96ec-e99708644a58/snapshots/r006-d13ee54f-baa4-40d3-b35c-b9ec163972b4",
      "id": "r006-d13ee54f-baa4-40d3-b35c-b9ec163972b4",
      "lifecycle_state": "stable",
      "minimum_size": 10,
      "name": "my-second-share-snapshot",
      "resource_group": {
        "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/fee82deba12e4c0fb69c3b09d1f12345",
        "id": "fee82deba12e4c0fb69c3b09d1f12345",
        "name": "Default"
      },
      "resource_type": "share_snapshot",
      "status": "available",
      "status_reasons": [],
      "user_tags": [],
      "zone": {
        "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-1",
        "name": "us-south-1"
      }
    }
  ],
  "total_count": 1
}

地域ファイル共有のスナップショットの場合、CLIとAPIの両方の応答でゾーンの値は空白になります。

API を使用してスナップショットの詳細情報を取得する

VPC API の /shares/{share-id}/snapshots/{snapshot-id} メソッドを呼び出し、共有 ID とスナップショット ID を指定することで、単一のスナップショットの詳細をプログラムで取得できます。

curl -X GET \
"$vpc_api_endpoint/v1/shares/r006-1fe9e5d8-0a4d-4818-96ec-e99708644a58/snapshots/r006-e13ee54f-baa4-40d3-b35c-b9ec163972b4?version=2024-12-10&generation=2" \
-H "Authorization: Bearer $iam_token"

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

    {
      "captured_at": "2024-12-10T01:21:12.000Z",
      "created_at": "2024-12-10T01:59:46.000Z",
      "crn": "crn:v1:bluemix:public:is:us-south:a/a1234567::share-snapshot:r006-0fe9e5d8-0a4d-4818-96ec-e99708644a58/r006-e13ee54f-baa4-40d3-b35c-b9ec163972b4",
      "fingerprint": "7abc3aef-c2bc-4f65-a296-2928e534d498",
      "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/r006-0fe9e5d8-0a4d-4818-96ec-e99708644a58/snapshots/r006-e13ee54f-baa4-40d3-b35c-b9ec163972b4",
      "id": "r006-e13ee54f-baa4-40d3-b35c-b9ec163972b4",
      "lifecycle_state": "stable",
      "minimum_size": 10,
      "name": "my-share-snapshot",
      "resource_group": {
        "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/fee82deba12e4c0fb69c3b09d1f12345",
        "id": "fee82deba12e4c0fb69c3b09d1f12345",
        "name": "Default"
      },
      "resource_type": "share_snapshot",
      "status": "available",
      "status_reasons": [],
      "user_tags": [],
      "zone": {
        "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-1",
        "name": "us-south-1"
      }
    },

地域ファイル共有のスナップショットの場合、CLIとAPIの両方の応答でゾーンの値は空白になります。

Terraformでスナップショットを見る

Terraformを使ってスナップショットを見ることができる。 Terraformを使うには、Terraform CLIをダウンロードし、 IBM Cloud Providerプラグインを設定する。 詳しくは Terraformを始める を参照。

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

デフォルトの us-south 以外の地域をターゲットとする次の例を参照。

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

Terraformでファイル共有の全スナップショットを一覧表示する

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

data "ibm_is_snapshots" "example" {
}

詳細については、ibm_ is _snapshotsを参照のこと。

Terraformでスナップショットの詳細をリストアップする

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

data "ibm_is_share_snapshot" "example" {
    share_snapshot = ibm_is_share_snapshot.example.share_snapshot
    share = ibm_is_share.example.id
}

詳細については、 ibm_is_share_snapshot を参照してください。

次のステップ

スナップショットの変更、削除、スナップショットからの共有の復元ができます。