准备工作

在使用 CLI 之前，您必须先安装 IBM Cloud CLI 以及 VPC CLI 插件。 有关详细信息，请参阅 CLI 先决条件。

登录到 IBM Cloud®。

ibmcloud login --sso -a cloud.ibm.com

此命令会返回 URL 并提示输入密码。 在浏览器中转至该 URL 并登录。 如果成功，您将获得一次性密码。 复制此密码并将其作为响应粘贴到提示上。 验证成功后，系统会提示您选择账户。 如果您拥有多个账户，请选择您要登录的账户。 响应任何剩余提示以完成登录。

开始之前，请收集以下信息：

• 快照的唯一名称。 共享快照名称在共享级别必须是唯一的。 有关如何命名快照的建议，请参阅 命名快照。
• 源共享的名称或 ID。
• 要附加到快照的任何标记。

使用以下 CLI 命令收集所需的信息。

• ibmcloud is shares- 此命令会列出所选区域内的所有可用共享。 在列表中找到共享，验证状态 ( available )。
• ibmcloud is share SHARE_ID- 使用该命令并输入上一条命令输出中的共享 ID，可查看共享的详细信息。 如果输出显示共享可用、连接到实例且不忙，则可以创建快照。

使用 API 创建快照的前提条件

您可以通过调用 VPC API 来创建快照。 开始之前，请收集以下信息：

• 快照的唯一名称。 共享快照名称在共享级别必须是唯一的。 有关如何命名快照的建议，请参阅 命名快照。
• 源共享的 ID。
• 要附加到快照的任何标记。

使用 API 创建快照

您可以通过调用 shares/{share-id}/snapshots API 方法，以编程方式创建文件共享快照。 下面的示例通过使用共享 ID 创建共享快照，并指定可与 备份策略 关联的用户标记。

curl -X POST \
"$vpc_api_endpoint/v1/shares/{share-id}/snapshots?version=2024-12-10&generation=2" \
-H "Authorization: Bearer $iam_token"
-d '{
  "name": "my-first-share-snapshot",
  "user_tags": [
    "env:test"
  ]
}'

成功的响应如下例所示。 创建快照时，快照生命周期状态为 pending。 创建成功后，状态将变为 stable。

{
  "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": "pending",
  "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"
  }
}

对于区域文件共享快照，CLI 和 API 响应中的区域值均为空白。