開始之前

在使用 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 回應中的區域值都是空白。