查看 File Storage for VPC 快照

透過控制台、CLI、API 或 Terraform 檢視 File Storage for VPC 的快照清單與詳細資訊。 存取相關資訊，包括快照數量、大小、狀態及複製角色。

在控制台中列出快照

在控制台中，您可以在共用的「詳細資料」頁面上查看屬於該檔案共用的所有快照的清單。

  1. 在 IBM Cloud 控制台中，按一下導航選單圖示選單圖示> 基礎架構VPC 圖示> 儲存 > 檔案儲存共用。

  2. 文件共享針對特定區域列出。 如果您想查看其他區域的資源，請按一下箭頭展開清單並選擇不同的區域。 預設情況下，最新共享顯示在清單的開頭。

  3. 選擇要查看的檔案共享，然後按一下 「快照」 標籤。

    「快照摘要」部分包含以下資訊：

    快照選項卡的摘要。
    欄位 說明
    Snapshot 計數 檔案共用的快照數量。
    在所有 Snapshot 中變更資料的大小 第一個快照是檔案共享的完整副本。 後續快照擷取自上次拍攝快照以來發生的變更。 此欄位顯示快照使用的容量總和。
    選擇可用性 在此版本的區域檔案共用中，使用 CLI 或 API 執行檔案共用作業時，當建立快照時，回應中的快照大小欄位預設為 1，否則為 0。 此值不代表快照的實際大小。
    抄寫角色 此角色與來源共用的複製角色相符。

    快照部分包含從此來源共用拍攝的所有快照的清單。

    快照選項卡的摘要。
    欄位 說明
    名稱 連結到快照詳細資訊面板的快照的唯一名稱。
    來源共享的大小 拍攝快照時來源共享的大小。 如果您使用此快照還原檔案共用，則此欄位中的大小表示將要建立的檔案共用的大小。
    狀態 例如，stable。

    透過點擊操作圖標操作圖標，您可以顯示上下文特定動作的選單。

    操作選單是動態的。 如果共享是副本共享，則僅顯示「還原」操作。 如果共用是來源共用或沒有副本，則所有 3 個操作均可用。

在主控台中檢視快照詳細資訊

要查看有關快照的詳細信息，請在文件共享的詳細信息頁面上找到該快照。 然後，按一下快照的名稱。 快照詳細資料側面板顯示快照名稱、其 CRN 和 ID 以及附加的使用者和存取管理標籤等資訊。

雖然您無法在複本共用資料夾上建立快照，但來源共用資料夾的快照會在下次排定的複製同步時，自動在複本上產生。 這些複製的快照是由檔案服務建立的。 它們不會繼承原始快照的名稱或標籤。 但是，它們與來源快照具有相同的指紋值。

下表描述了可以在快照詳細資料面板上查看的資訊。

Snapshot 詳細資料
欄位 說明
名稱 快照的名稱，您可以透過點擊編輯圖標來更改該名稱編輯圖標。 有關更多信息，請參閱 命名快照。
ID 快照的可複製 UUID。
CRN 快照的可複製 CRN。
資源群組 設定 VPC 時所定義的資源群組。
狀態 例如，stable。
位置 與來源檔案共享的位置相同。
建立日期 快照資源建立過程開始的日期和時間。
來源檔案共用的大小 拍攝快照時的共享大小（以 GB 為單位）。
來源檔案共用 從中取得第一個快照的來源共用。 點擊連結查看分享詳情。
加密 提供者管理或客戶管理的加密。 對於客戶管理的加密，會顯示 KMS 實例、根金鑰名稱和根金鑰 ID。
指紋 您可以使用它來定位快照的參考 ID .snapshot 資料夾。
使用者標籤 您新增的標籤。 當您查看副本共用上的快照時，此欄位為空。
建立者 它顯示快照是由使用者還是 備份策略 建立的。 在副本文件共用上查看快照時，此欄位顯示_複製_。

透過點擊操作圖標操作圖標，您可以顯示上下文特定動作的選單。

操作選單是動態的。 如果共享是副本共享，則僅顯示「還原」操作。 如果共用是來源共用或沒有副本，則所有 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 查看快照的詳細信息

運行 ibmcloud is share-snapshot 命令以及快照 ID、或快照名稱和共用名稱或 ID。 快照 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 列出所有快照

您可以透過呼叫以程式設計方式列出您的共享的所有快照 /shares/{share-id}/snapshotsVPC API 中的方法，如下列範例請求所示。 預設情況下，該清單首先顯示最新的快照，然後按降序顯示較舊的快照。

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

您可以使用備份策略計畫 ID 來篩選列表，以顯示備份策略拍攝的快照。 例如，以下呼叫篩選清單以顯示由特定備份計畫建立的快照，並將結果限制為每頁 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 列出快照的詳細信息

您可以透過呼叫以程式設計方式檢索單一快照的詳細信息 /shares/{share-id}/snapshots/{snapshot-id}VPC API 中的方法並指定共用 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。

下一步

您可以修改或刪除快照以及從快照還原共用。