IBM Cloud Docs
查看 File Storage for VPC 快照

查看 File Storage for VPC 快照

您可以查看所有快照的列表，并深入查看特定快照的信息。 选择用户界面、CLI、API 或 Terraform 来检索此信息。

在控制台中列出快照

在控制台中，您可以在共享的详细信息页面上查看属于文件共享的所有快照的列表。

  1. 在 IBM Cloud 控制台中，单击导航菜单图标菜单图标 > 基础架构 VPC 图标 > 存储 > 文件存储共享。

  2. 列出特定区域的文件共享。 如果您想查看其他地区的资源，请单击箭头展开列表并选择不同的地区。 默认情况下，最新的共享会显示在列表的开头。

  3. 选择要查看的文件共享，然后单击快照选项卡。

    快照摘要部分包含以下信息：

    快照 选项卡摘要。"
    字段 描述
    快照计数 您创建快照时提供的名称。 单击快照的名称查看其 详细信息。
    所有快照中已更改数据的大小 第一个快照是文件共享的完整副本。 后续快照会捕捉自上次快照后发生的更改。 此字段显示快照使用的容量总和。
    复制角色 该角色与源共享的复制角色相匹配。

    快照 "部分包含该源共享的所有快照列表。

    快照 选项卡摘要。"
    字段 描述
    名称 与快照详细信息面板链接的快照的唯一名称。
    源份额大小 拍摄快照时源共享的大小。 如果使用此快照还原文件共享，则此字段中的大小表示将要创建的文件共享的大小。
    状态 例如，stable。

    点击操作图标 操作图标，可以显示上下文特定操作菜单。

    操作菜单是动态的。 如果共享是复制共享，则只显示还原操作。 如果共享是源共享或没有副本，则所有 3 个操作都可用。

在控制台中查看快照详细信息

要查看快照的详细信息，请在文件共享的详细信息页面找到该快照。 然后，单击快照的名称。 快照详细信息侧面板显示快照名称、其 CRN 和 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]
```sh
{: pre}

```sh {: screen}
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

有关可用命令选项的更多信息，请参阅 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 snapshot under account Test Account as user test.user@ibm.com...
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

有关可用命令选项的更多信息，请参阅 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 为 r134-158e0d66-338e-4501-b756-be0732677da8 的备份策略计划拍摄的快照。

ibmcloud is share-snapshots --backup-policy-plan r134-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   
r134-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   
r134-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   
r134-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: $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: $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
}

使用 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: $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"
      }
    },

使用 Terraform 查看快照

您可以使用 Terraform 查看快照。 要使用 Terraform，请下载 Terraform CLI 并配置 IBM Cloud 提供商插件。提供商插件。 更多信息，请参阅 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 或快照名称。

resource "ibm_is_share_snapshot" "example" {
  name = "my-example-share-snapshot"
  share = ibm_is_share.example.id
  tags = ["my-example-share-snapshot-tag"]
}
data "ibm_is_share_snapshot" "example" {
    share_snapshot = ibm_is_share_snapshot.is_share_snapshot_instance.is_share_snapshot_id
    share = ibm_is_share.example.id
}

有关详细信息，请参阅 ibm _is_snapshot。

后续步骤

您可以修改或删除快照，并从快照中还原共享。