從文件共享快照恢復數據

透過從快照建立新的共用資料夾，來還原檔案共用資料。還原的股權將採用與快照相同的設定檔和位置。支援完整還原與單一檔案還原。

共用只能在與快照的原始共用相同的位置建立。建立新共用時，它僅包含指向原始共用的指針，並且資料複製過程開始。複製資料時，共享處於_掛起_狀態。雖然可以掛載新共用以在_掛起_狀態下進行讀取/寫入，但不允許建立副本或快照等一些操作。資料複製操作完成後，新共享從父共享中分離出來，成為獨立的，完成初始化過程。初始化過程完成後，共享將進入_穩定_狀態並可用作任何其他共享。

在建立新的區域檔案共用時，可以變更客戶管理的加密金鑰。此過程使用新密鑰在密鑰管理服務中註冊新共享。新密鑰用於加密新共享。

選擇可用性在此版本的區域檔案共用中，當建立新的區域檔案共用時，無法變更客戶管理的加密金鑰。

限制

從快照還原共用時，存在以下限制。

若要恢復共享，快照必須處於_穩定_且_可用的_狀態。
除非初始化完成，否則無法刪除從中還原共用的快照。
如果快照受客戶管理的加密保護，且您沒有指定不同的根金鑰 CRN，則復原的共用將使用快照的加密金鑰進行加密。加密後無法變更。如果在初始化新共用時刪除父共用的加密金鑰，則會中斷初始化過程並導致初始化失敗。

在控制台中從快照恢復共享

您可以從 IBM Cloud 控制台中的各個頁面建立共用。

在控制台中從快照建立共享

從 File Storage for VPC 快照清單中，您可以建立 File Storage for VPC 共用。新共用將會加入 File Storage for VPC 共用清單中。

前往 File Storage for VPC 快照清單。在 IBM Cloud 控制台中，按一下導航選單圖示> 基礎架構> 儲存 > 檔案儲存共用。
選擇包含要用於建立另一個共享的資料的共用。
在共享詳細資訊頁面的快照標籤上，找到您要使用的快照。它必須處於 stable 狀態。
從“操作”選單，選擇恢復。
在配置頁面中，顯示快照的詳細資訊。某些檔案共用配置（例如區域和加密類型）是從快照繼承的，無法變更。

提供所需的共享詳細資訊。

建立共享選項。
欄位	說明
共用詳細資料	定義新共享。
名稱	請輸入新共用資料夾的名稱。
資源群組	使用預設值或從清單中選擇。
使用者標籤	指定使用者標籤來組織資源並供備份策略使用
存取管理標籤	指定在 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 列出特定共享的所有快照，並從輸出中選擇一個。
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

已定義的效能設定檔系列中的第一代和第二代檔案共用設定檔不可互換。您無法使用第二代快照來建立區域檔案共用。同樣地，您無法使用第一代檔案共用的快照來建立具有 rfs 設定檔的共用。

有關可用命令選項的詳細信息，請參閱 ibmcloud is share-create。

使用 API 從快照恢復共享

您可以透過呼叫以程式設計方式恢復共享 /sharesVPC API 中的方法。

在開始之前，請收集有關要用於還原共享的快照的資訊。

首先，找到快照並查看其詳細資訊。您可以使用 API 列出檔案共用的所有快照並從清單中進行選擇。
然後，檢索快照詳細資訊。

若要從快照恢復共享，請建立 POST /shares 請求並指定快照的 ID 或 CRN source_snapshot 財產。恢復的共享容量（以GB為單位）必須至少為快照的minimum_capacity。

以下範例請求建立基於來源快照的 100 GB 共用 r006-e13ee54f-baa4-40d3-b35c-b9ec163972b4。

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。

從快照還原檔案

若要執行單一檔案恢復，您可以使用本機作業系統功能。您可以瀏覽到共用的 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 從快照建立共享

從快照還原檔案

下一步