停用和删除 File Storage for Classic 卷

在删除 File Storage for Classic 卷之前，请完成删除前检查清单，以确认该卷未被使用，并避免意外的数据丢失。

取消操作将无法撤销。 24小时的恢复期结束后，数据将被销毁且无法恢复。在进行删除操作之前，请按照检查清单逐一完成每个步骤。

删除前检查清单

在取消卷之前，请按顺序完成每个步骤。

步骤 1：确认所有权和用途

请查看卷详细信息页面上的 “备注”字段，以确定该卷的原始用途或所有者。请联系订购该卷的团队，确认是否已不再需要该卷。

有关如何在控制台中查看注释的更多信息，请参阅 “在控制台中更新卷的注释”。
有关如何通过命令行界面（CLI）查看注释的更多信息，请参阅 “通过命令行界面（CLI）更新卷的注释”。
有关如何通过 API 检查注释的更多信息，请参阅《使用 API 更新卷的注释》。

第 2 步：了解“授权主机”的含义

授权主机有权挂载该卷。授权主机列表为空并不意味着该卷未被使用，也不意味着可以安全地将其删除。可以暂时卸载卷以进行维护。该列表可根据用户在 Classic 基础设施中的设备权限进行筛选。用户无权查看的主机将不会显示在结果中。

不要将空的授权主机列表视为确认该卷可以安全删除的依据。

步骤 3：在正确用户下验证授权主机列表

ibmcloud sl file access-list 命令以及 SoftLayer API （SoftLayer_Network_Storage::getObject ）仅返回调用用户拥有“经典基础设施设备”查看权限的主机。相关的对象掩码包括 allowedVirtualGuests、allowedHardware、allowedSubnets 和 allowedIpAddresses。对于没有服务器设备权限的用户，会收到 HTTP 200状态码，且返回列表为空，而非显示错误或警告。该卷可能仍已授权给该服务器，并且正在使用中。

请务必以账户所有者身份，或以拥有该账户中所有设备“经典基础设施设备”权限的用户身份，执行授权主机检查。有关分配这些权限的信息，请参阅《管理经典基础设施访问权限》。

在控制台中，请参阅“在控制台中查看获准访问卷的主机列表”。
在 CLI 中，请参阅 “从 CLI 查看授权主机列表”。

第 4 步：检查主机上的实际数据使用情况

与 Block Storage 不同，File Storage for Classic 卷会报告已使用的字节数。请检查 ibmcloud sl file volume-list 输出中的 bytes_used 列，以确认该卷是否存储了数据。您还可以通过 API 直接查询使用情况：

curl -g -u $SL_USER:$SL_APIKEY -X GET \
'https://api.softlayer.com/rest/v3.1/SoftLayer_Network_Storage/{volume_ID}/collectBytesUsed'

在任何已挂载该卷的 NFS 客户端上，可通过以下命令验证使用情况：

df -h /mount/point

在继续操作之前，请与应用团队确认没有工作负载依赖于该卷。

第 5 步：从每台主机上卸载 NFS 共享

在撤销访问权限之前，请先从每台主机上卸载该卷。在共享处于挂载状态时撤销访问权限，可能会导致主机上出现过期的 NFS 句柄，并造成数据损坏。

请参阅 Red Hat Linux 中的 “卸载文件系统”部分。
在 Ubuntu 上，请参阅 “卸载文件系统”部分。

第 6 步：撤销所有主机授权

卸载后，请撤销所有授权主机和子网的访问权限。

在控制台中，请参阅“在控制台中撤销主机的访问权限”。
在 CLI 中，请参阅“通过 CLI 撤销主机的访问权限”。

第 7 步：取消正在进行的复制并删除相关的重复项

活动副本和依赖的重复卷会阻止父卷的回收。在尝试删除父对象之前，请先取消这些操作。

取消复制：请参阅“取消复制”。
取消依赖的重复项：请参阅 “取消具有依赖重复项的存储卷”。

第 8 步：了解土地复垦的时间表

取消卷后，将进入为期 24 小时的回收等待期。在此期间，该卷在控制台中仍然可见，但处于非活动状态。收费将立即停止。回收期结束后，数据将被永久销毁，且该卷将从控制台中移除。

若要在撤销期届满前阻止一笔待处理的取消操作，请提交支持工单。

在控制台中删除存储卷

如果您不再需要某个特定卷，可以删除该文件共享。

访问 IBM Cloud® 控制台。在菜单中，选择 “基础设施” > > “经典基础设施”。
点击 “存储” > File Storage for Classic。
点击操作选择要注销的号码，然后选择 删除 File Storage for Classic。
请确认您是希望立即删除该卷，还是在该卷分配的周年纪念日当天删除。

如果选择在卷的周年日期取消卷的选项，那么可以在卷的周年日期之前使取消请求失效。
单击继续或关闭。
勾选“确认”复选框，然后单击“确认”。

从命令行界面（CLI）中删除存储卷

从 IBM Cloud 命令行界面（CLI）中删除存储卷

您可以使用 ibmcloud sl file volume-cancel 命令取消文件共享。以下示例将立即取消文件共享 12345678。

ibmcloud sl file volume-cancel 12345678 --immediate -f

有关此命令所有可用参数的更多信息，请参阅 ibmcloud sl file volume-cancel。

从 SLCLI 中删除存储卷

使用以下命令删除存储卷。

$ slcli file volume-cancel --help
Usage: slcli file volume-cancel [OPTIONS] VOLUME_ID
Options:
  --reason TEXT  An optional reason for cancellation.
  --immediate    Cancels the File Storage volume immediately instead of on the
                 billing anniversary.
  -h, --help     Show this message and exit.

使用 API 删除存储卷

在 Python Client API 中使用 cancel_volume 方法。请指定“volume_id”，并说明您是希望立即注销该保单，还是在保单周年日注销（immediate=False 或 immediate=True ）。此外，您还可以选择提供取消的原因（reason='No longer needed' ）。

使用 Terraform 删除存储卷

删除由 Terraform 管理的文件共享的首选方法是，从配置中移除其 ibm_storage_file 资源块，然后运行 terraform apply``。 Terraform 会检测到缺失的资源并将其销毁，从而确保您的配置与状态保持同步。

打开您的 Terraform 配置文件，并删除卷对应的 ibm_storage_file 资源块。
运行 terraform apply 以应用更改。
```
terraform apply
```
Terraform 会显示一个计划，其中表明该资源已被标记为待销毁。请确认继续执行该计划。

如果你想在不修改配置的情况下删除某个特定的文件共享，可以使用 terraform destroy --target 代替。以下示例通过 Terraform 地址定位单个资源。

terraform destroy --target ibm_storage_file.example

使用此方法会保留配置中的资源块，这会导致配置与基础设施状态之间出现偏差。在确认卷已删除后，请从配置中移除该资源块。

如需了解更多信息，请参阅 terraform apply 和 terraform destroy。