管理 File Storage for VPC 快照

您可以通过控制台、CLI、API 或 Terraform 管理现有快照。您可以更新快照的用户标签，删除不再需要的快照，为新快照腾出空间。

虽然不能在副本共享上创建快照，但在下一次计划同步时，源共享的快照会从源复制到副本。这些副本快照由文件服务创建。它们不会继承原始快照的标记或名称。不过，它们的指纹值与源快照相同。它们不能从副本共享中手动删除，但如果源共享上的源快照被删除，则会在下一次复制同步时从副本共享中删除。

在控制台中更新快照的用户标记

使用以下步骤在控制台中更新快照的用户标记。

转到快照列表。在 IBM Cloud 控制台中，单击导航菜单图标 > 基础架构 > 存储 > 文件存储共享。
列出特定区域的文件共享。如果您想查看其他地区的资源，请单击箭头展开列表并选择不同的地区。默认情况下，最新的共享会显示在列表的开头。
选择要查看的文件共享，然后单击快照选项卡。
单击快照名称打开快照详细信息面板。
单击用户标签旁边的编辑图标 。
您可以删除任何现有标签并添加新标签。单击保存。

从 CLI 更新快照的用户标记

您可以通过 CLI 更新分配给快照的用户标记。发出 ibmcloud is share-snapshot-update 命令并提供快照 ID 和新标签。

ibmcloud is share-snapshot-update SHARE SNAPSHOT --tags NEW_TAG1,NEW_TAG2 [--output JSON] [-q, --quiet]

请看下面的示例，其中添加了一个用户标签。

ibmcloud is share-snapshot-update my-file-share r134-6ce54f3b-8971-4b5d-95a7-7dfa897ddfb3 --user-tags test:cli
Updating file share snapshot share-snapshot-cli-update for share my-file-share under account Test Account as user test.user@ibm.com...

ID                   r134-6ce54f3b-8971-4b5d-95a7-7dfa897ddfb3   
Name                 share-snapshot-cli-update   
Fingerprint          c25fdce4-6e0a-433f-99c0-9985f127cd54   
Backup Policy Plan   -   
Status               available   
Status reasons       Status code   Status message      
                     -             -  
Created at           2024-12-17T11:19:33+05:30   
Captured At          2024-12-17T11:19:34+05:30   
CRN                  crn:v1:bluemix:public:is:us-south-1:a/a123456::share-snapshot:r134-2ae87eb2-b26c-4126-ab34-e6e64f6f1773/r134-6ce54f3b-8971-4b5d-95a7-7dfa897ddfb3   
LifeCycle State      stable
LifeCycle Reasons    Code   Message   More Info      
                      -      -         
Href                 https://us-south.iaas.cloud.ibm.com/v1/shares/r134-2ae87eb2-b26c-4126-ab34-e6e64f6f1773/snapshots/r134-6ce54f3b-8971-4b5d-95a7-7dfa897ddfb3   
Minimum Size         40   
User Tags            test:cli   
Zone                 ID   Name      
                          us-south-1      

Resource group       ID                                 Name      
                     11caaa983d9c4beb82690daab08717e9   Default      

Resource type        share_snapshot

使用应用程序接口更新用户标签

您可以使用 API 更新快照的用户标记。提出 PATCH /shares/{share-id}/snapshots/{snapshot-id} 请求，并指定快照 ID 和希望快照具有的标记。

curl -X PATCH \
"$vpc_api_endpoint/v1/shares/r006-0fe9e5d8-0a4d-4818-96ec-e99708644a58/snapshots/r006-e13ee54f-baa4-40d3-b35c-b9ec163972b4?version=2024-12-10&generation=2" \
   -H "Authorization: Bearer ${API_TOKEN}" \
   -d '{
     "user_tags": ["env:test","dev:test"]
    }'

使用 Terraform 更新快照

要使用 Terraform，请下载 Terraform CLI 并配置 IBM Cloud 提供商插件。提供商插件。更多信息，请参阅 Terraform 入门。

VPC 基础设施服务使用特定的区域端点，默认情况下以 us-south 为目标。如果您的 VPC 是在其他区域创建的，请确保在 provider.tf 文件的提供程序块中以相应区域为目标。

请参阅下面的示例，了解除默认 us-south 之外的目标区域。

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

要更新快照，请使用 ibm_is_share_snapshot 资源。您可以通过 tags 参数添加标签来更改快照的标签。

resource "ibm_is_share_snapshot" "example" {
  tags          = "dev:test"
  source_share  = ibm_is_share.example.id
  }

有关参数和属性的更多信息，请参阅 ibm _ is_snapshot。

在控制台中删除快照

您可以删除共享的任何快照。要删除快照，必须满足以下前提条件：

处于 stable 或 pending 状态。
不积极恢复股份。

确定是否可以删除快照的简单方法是在控制台中查看快照列表并检查其状态。

在控制台中删除单个快照

您可以通过以下步骤从快照列表中删除快照。

转到所有 File Storage for VPC 共享的列表。在 IBM Cloud 控制台中，转到菜单 > 基础架构 > 存储 > 文件存储共享。
从列表中选择一个共享，然后单击共享名称转到共享详细信息页面。
单击快照选项卡，查看该共享的快照列表。
找到要删除的快照。
单击操作图标。
选择删除。
确认此删除操作。

从 CLI 删除快照

您可以删除共享的任何快照或共享的所有快照。要删除快照，必须满足以下前提条件：

处于 stable 或 pending 状态。
不积极恢复股份。

使用以下步骤通过 CLI 删除单个快照。

列出共享可用的快照，以确认要删除的快照的 ID。

ibmcloud is share-snapshots SHARE [--output JSON] [-q, --quiet]

ibmcloud is share-snapshots my-file-share

运行 ibmcloud is share-snapshot-delete 命令并指定快照的 ID。要删除多个快照，必须在同一命令中指定所有快照的 ID。
```
ibmcloud is share-snapshot-delete SHARE (SNAPSHOT1 SNAPSHOT2 ...) [-f, --force] [--output JSON] [-q, --quiet]
```

确认删除快照。响应信息表示快照已删除。

$ ibmcloud is share-snapshot-delete my-file-share r134-6ce54f3b-8971-4b5d-95a7-7dfa897ddfb3
This will delete share snapshot r134-6ce54f3b-8971-4b5d-95a7-7dfa897ddfb3 for share ID my-file-share and cannot be undone. Continue [y/N] ?> y
Deleting share snapshot r134-6ce54f3b-8971-4b5d-95a7-7dfa897ddfb3 for share ID my-file-share under account Test Account as user test.user@ibm.com...
OK
Share snapshot r134-6ce54f3b-8971-4b5d-95a7-7dfa897ddfb3 is deleted.

有关可用命令选项的更多信息、ibmcloud is snaphot-delete.

使用 API 删除快照

您可以删除共享的任何快照或共享的所有快照。要删除快照，必须满足以下前提条件：

处于 stable 或 pending 状态。
不积极恢复股份。

调用 DELETE /shares/{share-id}/snapshots/{snapshot-id} 方法按 ID 删除特定快照。

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

使用 Terraform 删除快照

您可以删除共享的任何快照或共享的所有快照。要删除快照，必须满足以下前提条件：

处于 stable 或 pending 状态。
不积极恢复股份。

使用 terraform destroy 命令可以方便地删除单个快照等远程对象。下面的示例删除了 my-snapshot。

terraform destroy --target ibm_is_snapshot.my-snapshot

更多信息，请参阅 Terraform destroy。

快照生命周期状态

表 2 描述了快照生命周期中的快照状态。

文件共享快照生命周期状态
快照状态	说明
稳定	快照已创建，可用于恢复共享。
正在等待	正在检索快照信息。
暂挂	快照正在复制到远程共享。复制过程中会显示完成百分比。
失败	创建快照失败，无法从快照恢复共享。
已暂挂	快照暂时不可用。
正在更新	您更改了快照的名称，它正在更新中。
正在删除	快照正在删除。
已删除	快照已删除，无法还原共享。

后续步骤

您可以从快照还原共享。