ファイル共有スナップショットからのデータ復元

スナップショットから新しい共有を作成して、ファイル共有のデータを復元します。復元されたシェアは、スナップショットと同じプロファイルと場所を使用します。完全復元および単一ファイル復元に対応しています。

共有は、スナップショットのオリジン共有と同じ場所にのみ作成できます。新しい共有が作成されると、元の共有へのポインタだけが含まれ、データのコピー処理が始まる。データがコピーされている間、共有は_保留_状態にある。新しい共有は_保留_状態で読み取り/書き込みのためにマウントできるが、レプリカの作成やスナップショットのようないくつかの操作は許可されない。データコピー操作が完了すると、新しいシェアは親シェアから分割されて独立し、初期化プロセスが完了する。初期化プロセスが完了すると、共有は_安定_状態に移行し、他の共有と同様に使用できる。

新しいゾーンファイル共有が作成されるときに、顧客が管理する暗号化キーを変更することが可能です。このプロセスにより、新しい共有が新しい鍵とともに鍵管理サービスに登録される。新しい鍵は新しいShareの暗号化に使われる。

可用性を選択するこのリリースの地域ファイル共有では、新しい地域ファイル共有が作成されるときに、顧客が管理する暗号化キーを変更することはできません。

制限

スナップショットから共有を復元する場合、以下の制限事項が適用されます。

共有をリストアするには、スナップショットが_安定した_ _利用可能な_状態でなければなりません。
初期化が完了しない限り、共有の復元元のスナップショットを削除することはできません。
スナップショットがカスタマ管理暗号化で保護されていて、別のルートキーCRNを指定しない場合、復元された共有はスナップショットの暗号化キーで暗号化されます。暗号化は後から変更できない。新しい共有の初期化中に親共有の暗号鍵が削除されると、初期化プロセスが中断され、失敗する。

コンソールでスナップショットから共有をリストアする

IBM Cloud コンソールの様々なページから共有を作成できます。

コンソールでスナップショットから共有を作成する

File Storage for VPC のスナップショットの一覧から、 File Storage for VPC の共有を作成できます。新しい共有は File Storage for VPC 共有リストに追加されます。

File Storage for VPC のスナップショット一覧へ移動してください。 IBM Cloud コンソールで、 ナビゲーションメニュー アイコン > インフラストラクチャー > ストレージ > ファイルストレージ共有 をクリックする。
別の共有を作成するために使用したいデータがある共有を選択します。
共有の詳細ページのスナップショットタブで、使用するスナップショットを見つけます。 stable 状態でなければなりません。
Actionsメニューの Actionsから Restore を選択します。
プロビジョニングページでは、スナップショットの詳細が表示されます。ゾーンや暗号化タイプなど、一部のファイル共有設定はスナップショットから継承され、変更できません。

必要な共有の詳細を入力してください。

共有オプションを作成する。
フィールド	説明
シェアの詳細	新しいシェアを定義する。
名前	新しい共有の名前を入力してください。
リソース・グループ	デフォルトを使用するか、リストから選択する。
ユーザー・タグ	リソースを整理し、バックアップポリシーで使用するためのユーザータグを指定します
アクセス管理タグ	IAMで作成したアクセス管理タグを指定し、共有へのアクセス管理に役立てる。
プロファイル	ゾーナルシェアのデフォルトは `dp2` 、リージョナルシェアのデフォルトは `rfs`。新しい共有のプロファイルとストレージ生成値は、スナップショットのプロファイルとストレージ生成値と一致する必要があります。
サイズ	プロファイルで許可されている共有サイズを入力します。スナップショットのサイズより大きいか等しくなければならない。
IOPS	共有プロファイルが許可する範囲内のIOPSを選択します。
マウント・ターゲット	マウントターゲットの作成は任意ですが、仮想サーバーインスタンスからファイル共有に接続する場合はマウントターゲットが必要です。
暗号化	スナップショットから継承されます。

完了したら、「作成」をクリックしてください。新しい株式が発行されました。

CLIからスナップショットから共有をリストアする

CLIからスナップショットから File Storage for VPC 共有を作成できます。共有が作成されたら、マウントターゲットを作成し、後でインスタンスに共有をマウントすることができます。

開始前に

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

IBM Cloud® にログインしてください。
```
ibmcloud login --sso -a cloud.ibm.com
```
このコマンドを実行すると、URL が返され、パスコードの入力を求めるプロンプトが表示されます。ブラウザーでその URL にアクセスしてログインします。成功すると、ワンタイム・パスコードが表示されます。そのパスコードをコピーし、プロンプトに応答として貼り付けます。認証に成功すると、アカウントを選択するプロンプトが表示されます。複数のアカウントアクセスできる場合は、ログインしたいアカウントを選択してください。残りのプロンプトにすべて応答して、ログインを完了します。
共有の復元に使用するスナップショットに関する情報を収集します。
1. CLIを使用して、特定の共有のすべてのスナップショットを一覧表示し、出力から1つを選択することができます。
2. 次に、 ibmcloud is share-snapshot SHARE SNAPSHOT コマンドを使用して、選択したスナップショットの詳細を一覧表示します。

ibmcloud is share-create コマンドを実行し、 --snapshot パラメータとスナップショットの ID または CRN を指定します。

ibmcloud is share-create --name my-file-share-from-snapshot --snapshot r006-de41f19f-204c-4d4c-a630-1971ba85ed1d  --profile dp2 --size 100 --iops 2000  --user-tags env:test

Creating file share my-file-share-from-snapshot under account Test Account as user test.user@ibm.com...

ID                                 r006-ef44c3ac-2cc3-49bd-8c4f-27f46936644d
Name                               my-file-share-from-snapshot
CRN                                crn:v1:bluemix:public:is:us-south-2:a/a1234567::share:r006-ef44c3ac-2cc3-49bd-8c4f-27f46936644d
Lifecycle state                    pending
Access control mode                security_group
Accessor binding role              none
Allowed transit encryption modes   none,user_managed
Zone                               us-south-2
Profile                            dp2
Size(GB)                           100
IOPS                               2000
User Tags                          env:test
Encryption                         provider_managed
Mount Targets                      ID                          Name
                                   No mounted targets found.

Resource group                     ID                                 Name
                                   6edefe513d934fdd872e78ee6a8e73ef   defaults

Created                            2025-09-17T12:35:03-05:00
Replication role                   none
Replication status                 none
Replication status reasons         Status code   Status message
                                   -             -

Snapshot count                     0
Snapshot size                      0
Source snapshot                    ID                                          Name
                                   r006-de41f19f-204c-4d4c-a630-1971ba85ed1d   my-test-snap
Allowed Access Protocols           nfs4
Availability Mode                  zonal
Bandwidth(Mbps)                    1
Storage Generation                 1

次の例では、スナップショットのCRNを使用してスナップショットから共有を作成します。新しい共有に名前を指定しない場合、名前が自動的に生成されます。サイズとIOPSの値はスナップショットから継承され、共有の作成後に変更できます。

ibmcloud is share-create --profile dp2 --snapshot crn:v1:bluemix:public:is:us-south-2:a/a1234567::share-snapshot:r006-ed78dc15-048f-4077-b7a2-88c213d53463/r006-de41f19f-204c-4d4c-a630-1971ba85ed1d

Creating file share  under account Test Account as user test.user@ibm.com...

ID                                 r006-683e075d-30b6-429c-aba6-1eeb44d06dc2
Name                               giggling-maturing-remnant-unworldly
CRN                                crn:v1:bluemix:public:is:us-south-2:a/a1234567::share:r006-683e075d-30b6-429c-aba6-1eeb44d06dc2
Lifecycle state                    pending
Access control mode                security_group
Accessor binding role              none
Allowed transit encryption modes   user_managed,none
Zone                               us-south-2
Profile                            dp2
Size(GB)                           10
IOPS                               100
Encryption                         provider_managed
Mount Targets                      ID                          Name
                                   No mounted targets found.

Resource group                     ID                                 Name
                                   6edefe513d934fdd872e78ee6a8e73ef   defaults

Created                            2025-09-17T12:37:01-05:00
Replication role                   none
Replication status                 none
Replication status reasons         Status code   Status message
                                   -             -

Snapshot count                     0
Snapshot size                      0
Source snapshot                    ID                                          Name
                                   r006-de41f19f-204c-4d4c-a630-1971ba85ed1d   my-test-snap
Allowed Access Protocols           nfs4
Availability Mode                  zonal
Bandwidth(Mbps)                    1
Storage Generation                 1

定義されたパフォーマンス・プロファイル・ファミリーの第一世代と第二世代のファイル共有プロファイルは、互換性がありません。第2世代のスナップショットを使用して、ゾーンファイル共有を作成することはできません。同様に、第一世代のファイル共有のスナップショットを使用して、 rfs プロファイルで共有を作成することはできません。

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

API を使用してスナップショットから共有を復元する

VPC API の /shares メソッドを呼び出すことで、プログラムで共有を復元できます。

開始する前に、共有の復元に使用するスナップショットに関する情報を収集します。

まず、スナップショットを見つけ、その詳細を表示します。 APIを使用して、ファイル共有のすべてのスナップショットを一覧表示し、リストから選択することができます。
それから、スナップショットを取得する。

スナップショットから共有を復元するには、 POST /shares 要求を行い、 source_snapshot プロパティにスナップショットの ID または CRN を指定します。復元後の共有容量（GB単位）は、スナップショットの minimum_capacity 以上である必要があります。

次のリクエスト例は、ソーススナップショット r006-e13ee54f-baa4-40d3-b35c-b9ec163972b4 に基づいて100GBの共有を作成します。

curl -X POST \
"$vpc_api_endpoint/v1/shares/?version=2024-12-10&generation=2" \
-H "Authorization: Bearer $iam_token" \
-H "Content-Type: application/json" \
-d '{
     "name": "my-share-from-snapshot",
     "capacity": 100,
     "iops": 2000,
     "source_snapshot:" {"id": "r006-e13ee54f-baa4-40d3-b35c-b9ec163972b4"},
     "profile": {"name": "dp2"},
     "encryption_key":{"crn":"crn:[...]"},
     "mount_targets": [
        {"virtual_network_interface": {"subnet": {"id": "2302-ea5fe79f-52c3-4f05-86ae-9540a10489f5"}},
        {"vpc": {"id": "7ec86020-1c6e-4889-b3f0-a15f2e50f87e"}}],
     "allowed_transit_encryption_modes": ["none","user_managed"],
     "resource_group": {},
     "user_tags": ["env:test"]
   }`

Terraformでスナップショットから共有をリストアする

Terraformを使うには、Terraform CLIをダウンロードし、 IBM Cloud Providerプラグインを設定する。詳しくは Terraformを始めるを参照。

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

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

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

スナップショットから共有を作成するには、 ibm_is_share リソースを使用します。以下の例では、 dp2 プロファイルでスナップショットから共有を作成しています。

resource "ibm_is_share" "storage" {
  name            = "restore-share-new"
  profile         = "dp2"
  zone            = "us-south-1"
  source_snapshot = "ibm_is_snapshot.example.crn"
}

引数と属性の詳細については、 ibm_is_share を参照のこと。

スナップショットからのファイルの復元

単一ファイルの復元を実行するには、OSのネイティブ関数を使用することができます。共有の NFS マウントターゲットをブラウズし、隠しスナップショットディレクトリを開くことができます（通常、ファイル共有の種類に応じて、 /.snapshot または .snap のいずれかの名前が付けられます）。このディレクトリの中には、共有の各スナップショットを表すサブディレクトリがあります。これらのファイルを開いて場所を特定し、選択したファイルを別の場所にコピーすることができる。

スナップショットディレクトリは隠されていますが、 cd .snapshot や ls .snapshot/ のようなコマンドで直接アクセスすることができます。各スナップショットは、コンソール、CLI、またはAPIで表示されるものと一致する、一意のフィンガープリントで命名されたサブディレクトリとして表示されます。

[root@server .snapshot]# ls -lah
total 34K
drwxr-xr-x  3 root root  3 May 10 08:28 .
drwxr-xr-x 22 root root 56 May 10 08:28 ..
drwxr-xr-x  2 root root  2 May 10 08:28 c2c2439c-cbeb-4f12-8d9d-6059a3b85502

これらのサブディレクトリは、スナップショットが取られた時点の共有の状態を表します。サブディレクトリは読み取り専用である。これらのスナップショットから NFSの方法でデータを削除することはできない。同様に、新しいサブディレクトリを作成することも禁止されている。このビューは、単一ファイルのリストアやデータのポイントインタイム検査を行う際の利便性のためだけのものである。

次のステップ

さらにスナップショットを作成したり、既存のスナップショットを管理することができます。

ファイル共有スナップショットからのデータ復元

ファイル共有スナップショットからのデータ復元

制限

コンソールでスナップショットから共有をリストアする

コンソールでスナップショットから共有を作成する

CLIからスナップショットから共有をリストアする

開始前に

CLIでスナップショットから共有を作成する

API を使用してスナップショットから共有を復元する

API を使用してスナップショットから共有を作成する

Terraformでスナップショットから共有をリストアする

Terraformでスナップショットから共有を作成する

スナップショットからのファイルの復元

次のステップ