檢視備份原則

列出並檢視儲存資源的「IBM Cloud」備份政策，包括政策詳細資訊，以及標籤與某項備份政策相符的資源。

在控制台中查看備份策略

您可以使用使用者介面來列出所有備份原則，並檢視特定原則的詳細資料。

在控制台中列出所有備份策略

使用使用者介面，列出您在帳戶中為所選區域的磁區建立的所有備份原則。

在 IBM Cloud 主控台中，按一下「導航」功能表 圖示 > Infrastructure VPC 圖示 > 儲存 > 備份原則。

表 1 說明「備份原則清單」頁面上的資訊。 即會選取帳戶的預設地區。 您可以從選單中選擇其他地區。 原則會在頁面上從最新到最舊列出。

備份策略清單視圖
欄位 值
名稱 按一下原則名稱以查看其詳細資料。
狀態 該政策的狀態，例如「穩定」。 如需原則狀態的相關資訊，請參閱 備份原則狀態。
套用的資源 標記為由策略備份的資源（ Block Storage for VPC區、File Storage for VPC 共用或虛擬伺服器實例）的數量 [1]。 此號碼是一個鏈結，可讓您前往適用於原則的資源清單。
目標資源的標籤 您正在備份的目標磁碟區或共用的標籤。
前次執行時間（本端） 針對備份原則執行工作的最近時間。 如果欄位空白，則磁區沒有相符的標籤可執行工作。
建立日期（本端） 建立備份的日期與時間。

透過按一下「動作」圖示 「動作」圖示，您可以顯示快速特定動作的功能表。

  • 還原
  • 刪除

在控制台中查看備份策略的詳細信息

您可以使用使用者介面來檢視備份原則的詳細資料。

  1. 在 IBM Cloud 主控台中，按一下「導航」功能表 圖示 > Infrastructure VPC 圖示 > 儲存 > 備份原則。

  2. 按一下原則名稱。 表 2 和 3 說明所選備份原則及其相關聯計劃的相關資訊。 您可以從「操作」功能表操作圖示 中新增活動追蹤、事件通知或刪除策略。

備份策略詳細信息
欄位 值
名稱 備份原則的名稱。 按一下要編輯的 「編輯」圖示 「編輯」圖示。
原則 ID 備份原則 ID。
資源群組 Block Storage for VPC 磁區的 資源群組。
位置 所選區域的原則。
建立日期 該保單的建立日期。
CRN 原則的雲端資源名稱。
套用的資源 原則所涵蓋的磁區數目。 此清單包括使用者為該帳戶建立的磁碟區和共用。 如果原則是企業層面原則，則清單會顯示企業帳戶的磁區，而不是其子帳戶的磁區。
目標資源的標籤 此欄位顯示當使用者標籤套用至資源時，可觸發建立備份的使用者標籤。
-您可以按一下 編輯圖示 「編輯」圖示 ，以新增更多標籤。 如需相關資訊，請參閱 編輯目標資源的標籤。
-另請參閱 使用標籤將備份原則套用至資源。
目標資源類型 備份原則可以套用至 實例的個別區塊 磁區 或區塊磁區的一致性群組。
前次備份工作 它會顯示前次執行備份工作的日期和時間。 備份工作會根據計畫的執行頻率與保留設定，建立或刪除備份快照。 若要查看最後執行的工作類型，請按一下「檢視」。
企業帳戶 CRN 只有在備份原則是企業層面原則時，才會顯示此值。 它是建立原則之企業的雲端資源名稱。
性能 原則的現行性能狀態。 如需相關資訊，請參閱常見問題。

「計劃」卡會顯示計劃名稱、保留原則及計劃狀態。 您可以選擇性地按一下 建立，為現有原則新增更多計劃。

備份策略詳細信息
欄位 值
計劃名稱 計劃的唯一名稱。 展開以查看計劃詳細資料，例如頻率、與此計劃相關聯的標籤，以及是否啟用快速還原及遠端副本。
保留 您為計劃設定的有效期間，例如 30 天。
狀態 計劃狀態。 針對作用中計劃顯示 enabled。

透過按一下「動作」圖示 「動作」圖示，您可以顯示快速特定動作的功能表。 您可以變更名稱及其他方案詳細資料，例如保留、標籤、快速還原及遠端副本。 有關更多信息，請參閱 在控制台中編輯或刪除備份計劃。

檢視與備份原則相關聯的資源清單

檢視原則所備份的資源清單。 對於要由原則備份的資源，必須至少使用目標資源的其中一個原則標籤來標記資源。

您可以使用 Block Storage for VPC區、File Storage for VPC 共用或虛擬伺服器實例的清單來驗證是否正確應用了備份原則。

  1. 在 IBM Cloud 主控台中，按一下「導航」功能表 圖示 > Infrastructure VPC 圖示 > 儲存 > 備份原則。

  2. 按一下原則名稱。

  3. 點選「已套用的資源」索引標籤。

    • 如果原則適用於個別 Block Storage for VPC 磁區，則會顯示此原則所備份的磁區清單。 磁區的相關資訊包括磁區名稱、狀態、磁區大小及加密類型。
    備份策略的Block Storage for VPC區列表
    欄位 說明
    名稱 磁區的名稱。 按一下要編輯的 「編輯」圖示 「編輯」圖示。
    狀態 磁區的狀態。
    大小 卷的大小（以 GB 為單位）。
    加密 IBM管理的加密 或 客戶管理的加密。

    您可以按一下 新增磁區，將其他磁區新增至此原則。 資訊端畫面提供您可以套用至磁區之目標資源的標籤清單，以及 Block Storage for VPC 磁區 清單的鏈結。 您必須至少將目標資源的其中一個原則標籤套用至磁區。|

    • 如果原則適用於 Block Storage for VPC 磁區一致性群組的多磁區備份，則會顯示虛擬伺服器實例清單。 此清單包含其 Block Storage 磁區已備份此原則的虛擬伺服器實例。 虛擬伺服器實例的相關資訊包括名稱、狀態、VPC 及設定檔。
    虛擬伺服器實例列表。
    欄位 說明
    名稱 磁區的名稱。 按一下要編輯的 「編輯」圖示 「編輯」圖示。
    狀態 磁區的狀態。
    虛擬私有雲 虛擬伺服器實例所在的 VPC 名稱。 按一下它以移至 VPC 的詳細資料頁面。
    設定檔 虛擬伺服器實例的計算設定檔。 
    按一下 **新增虛擬伺服器實例**，將虛擬伺服器實例的已連接磁區新增至此原則。 資訊端畫面提供目標資源的標籤清單，您可以將這些標籤套用至虛擬伺服器實例。 它也包含指向您帳戶之虛擬伺服器實例清單的鏈結。 您必須至少將目標資源的其中一個原則標籤套用至磁區。
    • 如果該策略用於檔案共用，則會顯示此策略備份的共用清單。 有關共享的資訊包括其名稱、狀態、磁碟區大小和加密類型。
    備份策略的 File Storage for VPC 共享列表
    欄位 說明
    名稱 共享名稱。 按一下要編輯的 「編輯」圖示 「編輯」圖示。
    狀態 共享的狀態。
    大小 共享大小（以 GB 為單位）。
    加密 IBM管理的加密 或 客戶管理的加密。

從 CLI 檢視備份原則

您可以使用 CLI 來檢視備份原則。

開始之前

在使用 CLI 之前，您必須先安裝「IBM Cloud」CLI 以及 VPC CLI 外掛程式。 如需相關資訊，請參閱 CLI 必要條件。

登入 IBM Cloud®。

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

此指令會傳回 URL 並提示輸入密碼。 在瀏覽器中移至該 URL 並登入。 如果成功，您將獲得一次性密碼。 複製此密碼並將其作為回應貼上到提示上。 成功鑑別之後，系統會提示您選擇帳戶。 如果您擁有多個帳戶，請選擇您要登入的帳戶。 回應任何剩餘提示以完成登入。

從 CLI 列出所有備份原則

執行 backup-policies 指令，以列出您在帳戶及地區中建立的所有備份原則。

ibmcloud is backup-policies [--tag TAG_NAME] [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME | --all-resource-groups] [--output JSON] [-q, --quiet]

下列範例顯示您可以預期的輸出。

ibmcloud is backup-policies

Listing backup policies in all resource groups and region eu-de under account Test Account as user test.user@ibm.com...
ID                                          Name                  Status   Resource group
r138-0521986d-963c-4c18-992d-d6a7a99d115f   backup-policy-v1      stable   defaults
r138-a84c2063-e95f-46dc-98a8-9799b0e2fd2f   demo2                 stable   defaults
r138-8c494618-9e4f-4b67-9a08-ee3491404f3b   my-backup-policy-v1   stable   defaults
r138-5c719085-cf26-456e-9216-984866659e29   my-backup-policy-v2   stable   defaults

如需可用指令選項的相關資訊，請參閱 ibmcloud is backup-policies。 如需 Status 直欄中值的相關資訊，請參閱 備份原則狀態

從 CLI 列出依使用者標籤過濾的所有備份原則

執行 backup-policies 指令，以列出您在帳戶及地區中建立的所有備份原則。 --tag 選項會過濾具有確切使用者標籤值的備份原則集合。

ibmcloud is backup-policies --tag

下列範例會產生具有 dev:test 標籤的備份原則清單。

ibmcloud is backup-policies --tag dev:test

Listing backup policies in all resource groups and region eu-de under account Test Account as user test.user@ibm.com...
ID                                          Name                  Status   Resource group
r138-0521986d-963c-4c18-992d-d6a7a99d115f   backup-policy-v1      stable   defaults
r138-8c494618-9e4f-4b67-9a08-ee3491404f3b   my-backup-policy-v1   stable   defaults
r138-5c719085-cf26-456e-9216-984866659e29   my-backup-policy-v2   stable   defaults

如需可用指令選項的相關資訊，請參閱 ibmcloud is backup-policies。

從 CLI 檢視備份原則詳細資料

執行 backup-policy 指令，並指定備份原則 ID 或原則名稱。

ibmcloud is backup-policy POLICY [--output JSON] [-q, --quiet]

下列範例列出備份原則的內容，以及它包含的計劃。

ibmcloud is backup-policy my-backup-policy-v2

Getting backup policy my-backup-policy-v2 under account Test Account as user test.user@ibm.com...
ID                      r006-0723c648-9a47-4d51-b1ba-349e21e715b6
Name                    my-backup-policy-v2
CRN                     crn:v1:bluemix:public:is:us-south:a/a1234567::backup-policy:r006-0723c648-9a47-4d51-b1ba-349e21e715b6
Status                  stable
Last job completed at   2023-09-26T10:13:18.000Z
Plans                   ID                                          Name        Resource type
                        r006-e888bb31-7bf2-4885-a9f3-d448c1c37326   my-plan-b   backup_policy_plan
Backup tags             dev:test
Match resource type    volume
Resource group          ID                                 Name
                        6edefe513d934fdd872e78ee6a8e73ef   defaults
Created at              2023-09-05T16:30:09+00:00

下列範例使用原則 ID 及選項來接收 JSON 格式的回應。 此原則會在企業的子帳戶中建立一致性群組備份。

ibmcloud is backup-policy r006-0723c648-9a47-4d51-b1ba-349e21e715b6 --output JSON

Getting backup policy r006-0723c648-9a47-4d51-b1ba-349e21e715b6 under account Test Account as user test.user@ibm.com...
{
    "created_at": "2023-09-05T16:30:09.000Z",
    "crn": "crn:v1:bluemix:public:is:us-south:a/a1234567::backup-policy:r006-0723c648-9a47-4d51-b1ba-349e21e715b6",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/backup_policies/r006-0723c648-9a47-4d51-b1ba-349e21e715b6",
    "id": "r006-0723c648-9a47-4d51-b1ba-349e21e715b6",
    "lifecycle_state": "stable",
    "match_resource_type": "instance",
    "included_content": "data_volumes",
    "match_user_tags": "dev:test",
    "name": "my-backup-policy-v2",
    "plans": [
        {
            "href": "https://us-south.iaas.cloud.ibm.com/v1/backup_policies/r006-0723c648-9a47-4d51-b1ba-349e21e715b6/plans/r006-e888bb31-7bf2-4885-a9f3-d448c1c37326",
            "id": "r006-e888bb31-7bf2-4885-a9f3-d448c1c37326",
            "name": "my-plan-b",
            "resource_type": "backup_policy_plan"
        }
    ],
    "resource_group": {
        "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/6edefe513d934fdd872e78ee6a8e73ef",
        "id": "6edefe513d934fdd872e78ee6a8e73ef",
        "name": "defaults"
    },
    "resource_type": "backup_policy",
    "scope": {
        "id": "7e44cb4667ba4b88b1b1f8dcc15e33b3",
        "crn": "crn:v1:bluemix:public:enterprise::a/a1234567::enterprise:7e44cb4667ba4b88b1b1f8dcc15e33b3",
        "resource_type": ""
    }
}

下列範例使用原則名稱，而不使用其他選項。 原則適用於個別 Block Storage 磁區。

ibmcloud is backup-policy my-backup-policy-v1

Getting backup policy my-backup-policy-v1 under account Test Account as user test.user@ibm.com...
ID                      r138-8c494618-9e4f-4b67-9a08-ee3491404f3b
Name                    my-backup-policy-v1
CRN                     crn:v1:bluemix:public:is:eu-de:a/a1234567::backup-policy:r138-8c494618-9e4f-4b67-9a08-ee3491404f3b
Status                  stable
Last job completed at   2023-02-22T20:12:44.000Z
Plans                   ID                                          Name                    Resource type
                        r138-4d77d84c-929c-49e9-9f05-952be9486406   not-just-another-plan   backup_policy_plan
                        r138-7734be40-e2a5-4ee6-b4bd-75763639092b   my-policy-plan          backup_policy_plan
Backup tags             dev:test
Match resource type    volume
Resource group          defaults
Created at              2023-02-21T18:37:17+00:00

下列範例列出企業備份原則的內容。 範圍會顯示企業帳戶的 CRN。

ibmcloud is backup-policy r006-0bc533ed-4796-407a-982e-693b418f3de3

Getting backup policy r006-0bc533ed-4796-407a-982e-693b418f3de3 under account Enterprise Test as user test.user@ibm.com...
ID                     r006-0bc533ed-4796-407a-982e-693b418f3de3
Name                   backup-scope-2
CRN                    crn:bluemix:public:is:us-south:a/a1234567::backup-policy:r006-0bc533ed-4796-407a-982e-693b418f3de3
Status                 stable
Plans                  ID                                          Name           Resource type
                       r006-0741b600-e8d5-41b4-88a7-c19b6fbf89ca   scope-plan-2   backup_policy_plan
Backup tags            dev:test
included-content       data_volumes
Match resource type   volume
Resource group         ID                                 Name
                       e579217258f74f42974e6ec4da287fc5   Default
Scope                  ID                                 CRN                                                                                         Resource type
                       7e44cb4667ba4b88b1b1f8dcc15e33b3   crn:v1:bluemix:public:enterprise::a/a1234567::enterprise:7e44cb4667ba4b88b1b1f8dcc15e33b3   -
Health State           ok
Created at             2023-08-30T13:39:10+05:30

如需可用指令選項的相關資訊，請參閱 ibmcloud is backup-policy。

從 CLI 列出備份原則的所有方案

執行 ibmcloud is backup-policy-plans 並指定原則 ID 或原則名稱，以查看針對此原則建立的所有計劃。

ibmcloud is backup-policy-plans POLICY [--output JSON] [-q, --quiet]

下列範例指定原則名稱。 輸出提供備份計劃的基本資訊，例如 ID、名稱、狀態，以及定義備份排程的 CRON 表示式。

ibmcloud is backup-policy-plans backup-policy-v1

Listing plans of backup policy backup-policy-v1 under account Test Account as user test.user@ibm.com...
ID                                          Name               Active   Lifecycle state   Cron specification
r138-2129a79a-5629-4069-bf79-7bb0af3b0bd3   my-policy-plan-a   true     stable            05 15 * * *
r138-6f4f08ba-e0bb-470f-bbfb-f3a22aebbfa9   my-policy-plan-c   true     stable            10 20 * * *

下列範例指定前一個範例中原則的原則 ID。 輸出提供計劃 (my-policy-plan-a 及 my-policy-plan-c) 的更詳細資訊，其中包括快速還原複本及保留原則的相關資訊。

$ ibmcloud is backup-policy-plans r138-0521986d-963c-4c18-992d-d6a7a99d115f  --output JSON
[
    {
        "active": true,
        "attach_user_tags": [
            "daily-backup-plan"
        ],
        "clone_policy": {
            "max_snapshots": 4,
            "zones": [
                {
                    "href": "https://eu-de.iaas.cloud.ibm.com/v1/regions/eu-de/zones/eu-de-1",
                    "name": "eu-de-1"
                },
                {
                    "href": "https://eu-de.iaas.cloud.ibm.com/v1/regions/eu-de/zones/eu-de-2",
                    "name": "eu-de-2"
                }
            ]
        },
        "copy_user_tags": true,
        "created_at": "2023-02-21T22:42:31.000Z",
        "cron_spec": "05 15 * * *",
        "deletion_trigger": {
            "delete_after": 20,
            "delete_over_count": 20
        },
        "href": "https://eu-de.iaas.cloud.ibm.com/v1/backup_policies/r138-0521986d-963c-4c18-992d-d6a7a99d115f/plans/r138-2129a79a-5629-4069-bf79-7bb0af3b0bd3",
        "id": "r138-2129a79a-5629-4069-bf79-7bb0af3b0bd3",
        "lifecycle_state": "stable",
        "name": "my-policy-plan-a",
        "resource_type": "backup_policy_plan"
    },
    {
        "active": true,
        "attach_user_tags": [
            "daily-backup-plan"
        ],
        "clone_policy": {
            "max_snapshots": 3,
            "zones": [
                {
                    "href": "https://eu-de.iaas.cloud.ibm.com/v1/regions/eu-de/zones/eu-de-1",
                    "name": "eu-de-1"
                },
                {
                    "href": "https://eu-de.iaas.cloud.ibm.com/v1/regions/eu-de/zones/eu-de-2",
                    "name": "eu-de-2"
                }
            ]
        },
        "copy_user_tags": true,
        "created_at": "2023-02-21T22:42:32.000Z",
        "cron_spec": "10 20 * * *",
        "deletion_trigger": {
            "delete_after": 20,
            "delete_over_count": 20
        },
        "href": "https://eu-de.iaas.cloud.ibm.com/v1/backup_policies/r138-0521986d-963c-4c18-992d-d6a7a99d115f/plans/r138-6f4f08ba-e0bb-470f-bbfb-f3a22aebbfa9",
        "id": "r138-6f4f08ba-e0bb-470f-bbfb-f3a22aebbfa9",
        "lifecycle_state": "stable",
        "name": "my-policy-plan-c",
        "resource_type": "backup_policy_plan"
    }
]

如需可用指令選項的相關資訊，請參閱 ibmcloud is backup-policy-plans。

從 CLI 檢視備份方案詳細資料

執行 ibmcloud is backup-policy-plan 指令，並指定原則 ID 或原則名稱，以及計劃 ID 或計劃名稱。

ibmcloud is backup-policy-plan POLICY PLAN [--output JSON] [-q, --quiet]

下列範例指定原則及計劃名稱。

ibmcloud is backup-policy-plan backup-policy-v1 my-policy-plan-a

Getting plan my-policy-plan-a under account Test Account as user test.user@ibm.com...
ID                   r138-2129a79a-5629-4069-bf79-7bb0af3b0bd3
Name                 my-policy-plan-a
Active               true
Lifecycle state      stable
Clone policy         Max snapshots   Zones
                     4               eu-de-1,eu-de-2
Deletion trigger     Delete after   Delete over count
                     20             20
Remote Region Policies   Region    Encryption Key   Delete over count
                         us-east   -                99
Attached tags        daily-backup-plan
Copy tags            true
Cron specification   05 15 * * *
Created at           2023-02-21T22:42:31+00:00
Resource type        backup_policy_plan

如需可用指令選項的相關資訊，請參閱 ibmcloud is backup-policy-plan。

使用 API 檢視備份原則及計劃

您可以使用 API 來檢視備份原則及計劃。

使用 API 顯示備份原則的詳細資料

您可以透過在 VPC API 中呼叫 /backup_policies/{backup_policy_id} 方法，以程式化方式擷取備份原則的詳細資料，如下列範例要求中所示。

curl -X GET\
"$vpc_api_endpoint/v1/backup_policies/r006-076191ba-49c2-4763-94fd-c70de73ee2e6?version=2023-09-26&generation=2"\
   -H "Authorization: Bearer $iam_token"

成功的回應如下例所示。

{
  "created_at": "2023-09-26T15:06:03.000Z",
  "crn": "crn:v1:bluemix:public:is:us-south:a/123456::backup-policy:r006-076191ba-49c2-4763-94fd-c70de73ee2e6",
  "included_content": [
        "data_volumes"
      ],
  "health_reasons": [],
  "health_state": "ok",
  "href": "https://us-south.iaas.cloud.ibm.com/v1/backup_policies/r006-076191ba-49c2-4763-94fd-c70de73ee2e6",
  "id": "r006-076191ba-49c2-4763-94fd-c70de73ee2e6",
  "lifecycle_state": "stable",
  "match_resource_type": "volume",
  "match_user_tags": [
    "my-tag-1",
    "my-tag-2"
  ],
  "name": "my-backup-policy",
  "plans": [
    {
      "href": "https://us-south.iaas.cloud.ibm.com/v1/backup_policies/r006-076191ba-49c2-4763-94fd-c70de73ee2e6/plans/r006-4d6074c4-3811-4bb3-af4a-1fd6cb38d6fe",
      "id": "r006-4d6074c4-3811-4bb3-af4a-1fd6cb38d6fe",
      "name": "my-backup-plan-1",
      "resource_type": "backup_policy_plan"
    }
  ],
  "resource_group": {
    "crn": "crn:v1:bluemix:public:resource-controller::a/123456::resource-group:678523bcbe2b4eada913d32640909956",
    "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/678523bcbe2b4eada913d32640909956",
    "id": "678523bcbe2b4eada913d32640909956",
    "name": "Default"
  },
  "resource_type": "backup_policy",
  "scope": {
    "crn": "crn:v1:bluemix:public:enterprise::a/e92d45e305dc4ee0b13e29be392f1c0c::enterprise:ebc2b430240943458b9e91e1432cfcce",
    "id": "fee82deba12e4c0fb69c3b09d1f12345",
    "resource_type": "account"
  }
}

下列範例顯示建立多磁區一致性群組備份之備份原則的詳細資料。

curl -X GET\
"$vpc_api_endpoint/v1/backup_policies/r006-5f45c186-d710-41ed-a4bc-e924a79e47bb?version=2023-12-05&generation=2"\
   -H "Authorization: Bearer $iam_token"

{
  "created_at": "2023-11-14T19:36:29Z",
  "crn": "crn:v1:bluemix:public:is:us-south:a/a1234567::backup-policy:r006-5f45c186-d710-41ed-a4bc-e924a79e47bb",
  "health_reasons": [],
  "health_state": "ok",
  "href": "https://us-south.iaas.cloud.ibm.com/v1/backup_policies/r006-5f45c186-d710-41ed-a4bc-e924a79e47bb",
  "id": "r006-5f45c186-d710-41ed-a4bc-e924a79e47bb",
  "included_content": [
    "boot_volume",
    "data_volumes"
  ],
  "lifecycle_state": "stable",
  "match_resource_type": "instance",
  "match_user_tags": [
    "vsi11"
  ],
  "name": "policy-1699990587",
  "plans": [
    {
      "href": "https://us-south.iaas.cloud.ibm.com/v1/backup_policies/r006-5f45c186-d710-41ed-a4bc-e924a79e47bb/plans/r006-01fb4c96-57db-4fac-98f0-2158dbfd551f",
      "id": "r006-01fb4c96-57db-4fac-98f0-2158dbfd551f",
      "name": "plan-1699990587",
      "resource_type": "backup_policy_plan"
    }
  ],
  "resource_group": {
    "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/f20bdbd6554d48739ad38717e0511fdd",
    "id": "f20bdbd6554d48739ad38717e0511fdd",
    "name": "Default"
  },
  "resource_type": "backup_policy",
  "scope": {
    "id": "53945f147c1441b0940bc00927863af6",
    "resource_type": "account"
  }
}

如需 health_state 及 lifecycle_state 欄位值的相關資訊，請參閱 監視備份原則性能狀態、生命週期狀態及事件。

使用 API 列出備份原則的所有計劃

您可以透過在 VPC API 中呼叫 /backup_policies/{backup_policy_id}/plans 方法，以程式化方式列出備份原則的計劃，如下列範例要求中所示。

curl -X GET\
"$vpc_api_endpoint/v1/backup_policies/fb721535-2cc6-45d6-ade7-3ceb95b7f26f/plans?version=2022-12-16&generation=2"\
   -H "Authorization: Bearer $iam_token"

成功的回應如下例所示。

{
  "plans": [
    {
      "active": true,
      "attach_user_tags": [
        "my-daily-backup-plan"
      ],
      "copy_user_tags": true,
      "created_at": "2022-12-16T00:45:28.421Z",
      "cron_spec": "*/5 1,2,3 * * *",
      "deletion_trigger": {
        "delete_after": 20
      },
      "href": "https://us-south.iaas.cloud.ibm.com/v1/backup_policies/fb721535-2cc6-45d6-ade7-3ceb95b7f26f/plans/4cf9171a-0043-4434-8727-15b53dbc374c",
      "id": "4cf9171a-0043-4434-8727-15b53dbc374c",
      "lifecycle_state": "stable",
      "name": "my-policy-plan",
      "resource_type": "backup_policy_plan"
    }
  ]
}

若要擷取單一計劃的相關資訊，請在要求中指定計劃 ID:

curl -X GET "$vpc_api_endpoint/v1/backup_policies/{backup_policy_id}/plans/{plan_id}?version=2022-12-16&generation=2"

使用快速還原選項擷取備份計劃

您可以查看正在其中建立快速還原備份 Snapshot 之區域的相關資訊，以及每一個區域中的 Snapshot 數目。

發出 GET /backup_policy/{backup_policy_id}/plans/{plan_id} 呼叫。 在回應中，clone_policy 內容顯示在其中建立用於快速還原之 Snapshot 複本的區域，以及每個保留複本之磁區的最近 Snapshot 數目上限。

您也可以擷取備份原則的所有計劃，並檢視您針對備份 Snapshot 複製所設定的計劃。 如需相關資訊，請參閱 API 參考資料中的 列出備份原則的所有計劃。

請參閱下列範例。

curl -X GET\
"$vpc_api_endpoint/v1/backup_policies/fb721535-2cc6-45d6-ade7-3ceb95b7f26f/plan/4d58eb08-d950-498b-8175-b4d617b6ba6a?version=2023-08-29&generation=2"
   -H "Authorization: Bearer $iam_token"

回應會顯示複製原則資訊。 在此範例中，針對 us-south-2 中的 Snapshot 建立複本，每個要保留的 Snapshot 最多兩個複本。

{
  "active": true,
  "attach_user_tags": ["my-plan-2"],
  "clone_policy": {
    "max_snapshots": 2,
    "zones": [
      {"name": "us-south-2"},
      {"href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-1"}]},
  "copy_user_tags": true,
  "created_at": "2022-12-16T15:16:37Z",
  "cron_spec": "45 * * * *",
  "deletion_trigger": {"delete_after": 5},
  "href": "https://us-south.iaas.cloud.ibm.com/v1/backup_policies/fb721535-2cc6-45d6-ade7-3ceb95b7f26f/plans/4d58eb08-d950-498b-8175-b4d617b6ba6a",
  "id": "r006-6da51cfe-6f7b-4638-a6ba-00e9c327b178",
  "lifecycle_state": "stable",
  "name": "my-backup-plan-2",
  "resource_type": "backup_policy_plan"
  }

使用跨區域複製選項擷取備份計劃

提出 GET /backup_policy/{backup_policy_id}/plans/{plan_id} 要求。 在回應中，remote_region_policies 內容顯示在其中建立備份副本的遠端區域。

請參閱下列範例。

curl -X GET\
"$vpc_api_endpoint/v1/backup_policies/fb721535-2cc6-45d6-ade7-3ceb95b7f26f/plan/4d58eb08-d950-498b-8175-b4d617b6ba6a?version=2023-05-09&generation=2"\
   -H "Authorization: Bearer $iam_token"

回應會顯示遠端區域原則資訊。 在此範例中，輸出顯示當備份工作在 us-south 區域中建立備份 Snapshot 時，也會在 us-east 區域中建立備份副本。

{
  "active": true,
  "attach_user_tags": ["hourly-backups"],
  "copy_user_tags": false,
  "created_at": "2023-05-09T15:16:37Z",
  "cron_spec": "0 */2 * * *",
  "deletion_trigger": {"delete_after": 5},
  "href": "https://us-south.iaas.cloud.ibm.com/v1/backup_policies/8758bd18-344b-486a-b606-5b8cb8cdd044/plans/6e251cfe-6f7b-4638-a6ba-00e9c327b178",
  "id": "6e251cfe-6f7b-4638-a6ba-00e9c327b178",
  "lifecycle_state": "stable",
  "name": "my-hourly-plan-2",
  "remote_region_policies": {
    "delete_over_count": 5,
    "encryption_key": "crn:v1:bluemix:public:kms:us-south:a/dffc98a0f1f0f95f6613b3b752286b87:e4a29d1a-2ef0-42a6-8fd2-350deb1c647e:key:5437653b-c4b1-447f-9646-b2a2a4cd617",
    "region": [
      {"name": "us-east"},
      {"href": "https://us-east.iaas.cloud.ibm.com/v1/regions/us-east/zones/us-east-2"}
     ],
    },
  "resource_type": "backup_policy_plan"
}

使用 Terraform 檢視備份原則和計劃

您可以使用 Terraform 來檢視備份原則和計劃。

要使用 Terraform，請下載 Terraform CLI 並配置 IBM Cloud Provider 外掛程式。 如需相關資訊，請參閱 Terraform 入門。

VPC 基礎架構服務使用特定的地區端點，依預設會以 us-south 為目標。 如果您的 VPC 建立在另一個地區中，請確保將 provider.tf 檔案中提供者區塊中的適當地區設為目標。

請參閱下列以非預設 us-south 地區為目標的範例。

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

使用 Terraform 列出所有備份原則

將備份原則集合的詳細資料匯入為唯讀資料來源。 您可以透過指定名稱、資源群組或相關聯標籤來過濾集合。

data "ibm_is_backup_policies" "example" {
}

如需引數及屬性的相關資訊，請參閱 ibm_is_backup_policies。

使用 Terraform 檢視備份原則詳細資料

將備份原則的詳細資料匯入為唯讀資料來源。 您可以指定原則 ID 或原則名稱。

data "ibm_is_backup_policy" "example" {
  identifier = ibm_is_backup_policy.example.id
}

data "ibm_is_backup_policy" "example" {
  name = ibm_is_backup_policy.example.name
}

如需引數及屬性的相關資訊，請參閱 ibm_is_backup_policy。

使用 Terraform 列出備份原則的所有方案

將備份原則中的備份計劃清單匯入為唯讀資料來源。 您可以選擇性地指定要查看的計劃名稱。

data "ibm_is_backup_policy_plans" "example" {
  backup_policy_id = ibm_is_backup_policy.example.id
}

data "ibm_is_backup_policy_plans" "example" {
  backup_policy_id = ibm_is_backup_policy.example.id
  name             = "my-policy-plan"
}

如需引數及屬性的相關資訊，請參閱 ibm_is_backup_policy_plans。

使用 Terraform 檢視備份計劃詳細資料

將備份計劃的詳細資料匯入為唯讀資料來源。 您可以指定計劃 ID 或計劃名稱，如下列範例所示。

data "ibm_is_backup_policy_plan" "example" {
  backup_policy_id = ibm_is_backup_policy.example.id
  identifier       = ibm_is_backup_policy_plan.example.id
}

data "ibm_is_backup_policy_plan" "example" {
  backup_policy_id = ibm_is_backup_policy.example.id
  name             = ibm_is_backup_policy_plan.example.name
}

如需引數及屬性的相關資訊，請參閱 ibm_is_backup_policy_plan。

下一步

您可以執行以下操作。

  1. 若要順利完成備份作業，必須將已標記的磁區連接至執行中的虛擬伺服器實例。 即使未連接的磁區具有正確的標籤，也不會備份。 ↩︎