IBM Cloud Docs
查看备份策略

查看备份策略

您可以在控制台中,通过 CLI,使用 API 或 Terraform 列出和查看为存储资源创建的所有备份策略。 您可以查看各个策略的详细信息,并查看具有与备份策略匹配的标记的资源数。

要使备份操作成功,必须将标记的卷附加到正在运行的虚拟服务器实例。 即使未连接的卷具有正确的标记,也不会备份这些卷。

在控制台中查看备份策略

您可以使用 UI 列出所有备份策略并查看特定策略的详细信息。

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

使用 UI 列出为所选区域的帐户中的卷创建的所有备份策略。

IBM Cloud 控制台中,单击导航菜单图标菜单图标 > 基础架构 VPC 图标 > 存储 > 备份策略

表 1 描述了“备份策略列表”页面上的信息。 已选择帐户的缺省区域。 您可以从菜单中选择不同的区域。 策略列示在页面上,从最新到最旧。

备份策略列表视图
字段
名称 单击策略的名称以查看其详细信息。
状态 保单状态,如_稳定_。 有关策略状态的更多信息,请参阅 备份策略状态
应用的资源 策略 [1] 标记为备份的资源( Block Storage for VPC 卷、File Storage for VPC 共享或虚拟服务器实例)的数量。 此数字是一个链接,用于将您转至适用于策略的资源列表。
目标资源的标记 备份目标卷或共享的标签。
上次运行时间(本地) 最近一次针对备份策略运行作业的时间。 如果此字段为空,那么卷没有要运行的作业的匹配标记。
创建日期(本地) 创建备份的日期和时间。

通过单击“操作”图标 "操作" 图标,可以显示特定于上下文的操作的菜单。

  • 复原
  • 删除(T)

在控制台中查看备份策略的详细信息

您可以使用 UI 来查看备份策略的详细信息。

  1. IBM Cloud 控制台中,单击导航菜单图标菜单图标 > 基础架构 VPC 图标 > 存储 > 备份策略

  2. 单击策略名称。 表 2 和 3 描述了有关所选备份策略及其关联计划的信息。 您可以从操作菜单 操作图标 中添加活动跟踪、事件通知或删除策略。

    备份政策详情
    字段
    名称 备份策略的名称。 单击 编辑图标 <img src="../icons/edit-tagging.svg" alt=""编辑" 图标" title="编辑"> 以进行编辑。
    策略标识 备份策略标识。
    资源组 Block Storage for VPC 卷的 资源组
    地区 所选区域的策略。
    创建日期 保单创建日期。
    CRN 策略的云资源名称。
    应用的资源 策略覆盖的卷数。 该列表包括用户为账户创建的卷和共享。 如果策略是企业范围的策略,那么列表将显示企业帐户的卷,而不是其子帐户的卷。
    目标资源的标记 此字段显示在将用户标记应用于资源时可触发创建备份的用户标记。
    -您可以单击 编辑图标 <img src="../icons/edit-tagging.svg" alt=""编辑" 图标" title="编辑"> 以添加更多标记。 有关更多信息,请参阅 编辑目标资源的标记
    -另请参阅 使用标记将备份策略应用于资源
    目标资源类型 备份策略可以应用于单个块 实例的块卷一致性组。
    上次备份作业 它显示上次备份作业运行的日期和时间。 备份工作根据计划频率和保留设置创建或删除备份快照。 要查看最后运行的作业类型,请单击查看
    企业帐户 CRN 仅当备份策略是企业范围的策略时,才会显示此值。 这是创建策略的企业的云资源名称。
    运行状况 策略的当前运行状况状态。 有关更多信息,请参阅常见问题

    “计划”卡显示计划名称,保留时间策略和计划状态。 (可选) 您可以单击 创建 以针对现有策略添加更多计划。

    备份政策详情
    字段
    计划名称 计划的唯一名称。 展开以查看计划详细信息,例如频率,与此计划关联的标记以及是否启用快速复原和远程拷贝。
    保留时间 为使计划生效而设置的时间段,例如 30 天。
    状态 计划状态。 显示活动计划的 enabled

    通过单击“操作”图标 "操作" 图标,可以显示特定于上下文的操作的菜单。 您可以更改名称和其他计划详细信息,例如保留时间,标记,快速复原和远程拷贝。 有关详细信息,请参阅 在控制台中编辑或删除备份计划

查看与备份策略关联的资源的列表

查看由策略备份的资源的列表。 对于要由策略备份的资源,必须使用目标资源的至少一个策略标记来标记该资源。

您可以使用 Block Storage for VPC 卷、File Storage for VPC 共享或虚拟服务器实例的列表来验证备份策略是否正确应用。

  1. IBM Cloud 控制台中,单击导航菜单图标菜单图标 > 基础架构 VPC 图标 > 存储 > 备份策略

  2. 单击策略名称。

  3. 单击“应用资源”选项卡。

    • 如果策略用于单个 Block Storage for VPC 卷,那么将显示此策略所备份的卷的列表。 有关卷的信息包括卷名称,状态,卷大小和加密类型。

      备份策略的Block Storage for VPC卷列表
      字段 描述
      名称 卷的名称。 单击 编辑图标 <img src="../icons/edit-tagging.svg" alt=""编辑" 图标" title="编辑"> 以进行编辑。
      状态 卷的状态。
      大小 加密卷的大小(GB)。
      加密 IBM管理的加密客户管理的加密

      您可以通过单击 添加卷将其他卷添加到此策略。 参考侧面板提供了可以应用于卷的目标资源的标记列表,以及指向 Block Storage for VPC 卷列表 的链接。 必须将目标资源的至少一个策略标记应用于卷。|

    • 如果策略用于 Block Storage for VPC 卷一致性组的多卷备份,那么将显示虚拟服务器实例列表。 此列表包含其 Block Storage 卷已备份此策略的虚拟服务器实例。 有关虚拟服务器实例的信息包括名称,状态,VPC 和概要文件。

      虚拟服务器实例列表。
      字段 描述
      名称 卷的名称。 单击 编辑图标 <img src="../icons/edit-tagging.svg" alt=""编辑" 图标" title="编辑"> 以进行编辑。
      状态 卷的状态。
      虚拟私有云 虚拟服务器实例所在的 VPC 的名称。 单击它以转至 VPC 的详细信息页面。
      Profile 虚拟服务器实例的计算概要文件。

      单击 添加虚拟服务器实例 以将虚拟服务器实例的附加卷添加到此策略。 参考侧面板提供了可应用于虚拟服务器实例的目标资源的标记列表。 它还包含指向帐户的虚拟服务器实例列表的链接。 必须将目标资源的至少一个策略标记应用于卷。

    • 如果策略针对文件共享,则会显示该策略备份的共享列表。 有关共享的信息包括其名称、状态、卷大小和加密类型。

      备份策略的 File Storage for VPC 共享列表
      字段 描述
      名称 股份名称 单击 编辑图标 <img src="../icons/edit-tagging.svg" alt=""编辑" 图标" title="编辑"> 以进行编辑。
      状态 股份状况。
      大小 共享大小(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]

以下示例显示了您可以期望的输出。

cloudshell:~$ 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 命令并指定备份策略标识或策略名称。

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

以下示例使用策略标识和选项来接收 JSON 格式的响应。 此策略在企业的子帐户中创建一致性组备份。

$ ibmcloud is backup-policy r006-0723c648-9a47-4d51-b1ba-349e21e715b6 --output JSON
{
    "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 卷。

cloudshell:~$ 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 并指定策略标识或策略名称以查看为此策略创建的所有计划。

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

以下示例指定策略名称。 输出提供备份计划的基本信息,例如标识,名称,状态和用于定义备份调度的 CRON 表达式。

cloudshell:~$ 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 * * *

以下示例指定上一示例中策略的策略标识。 输出提供有关套餐 (my-policy-plan-amy-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 命令并指定策略标识或策略名称以及计划标识或计划名称。

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

以下示例指定策略和计划名称。

cloudshell:~$ 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: $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: $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_statelifecycle_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: $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"
    }
  ]
}

要检索有关单个计划的信息,请在请求中指定计划标识:

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

使用快速复原选项检索备份计划

您可以查看有关正在其中创建快速复原备份快照的区域以及每个区域中的快照数的信息。

发出 GET /backup_policy/{backup_policy_id}/plans/{plan_id} 调用。 在响应中,clone_policy 属性显示在其中创建用于快速复原的快照克隆的区域,以及每个保留克隆的卷的最大最近快照数。

您还可以检索备份策略的所有计划,并查看为备份快照克隆设置的计划。 有关更多信息,请参阅 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: $iam_token"

响应显示克隆策略信息。 在此示例中,将为 us-south-2 中的快照创建克隆,每个要保留的快照最多有两个克隆。

{
  "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: $iam_token"

响应显示远程区域策略信息。 在此示例中,输出显示当备份作业在 us-south 区域中创建备份快照时,也会在 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 提供者插件。 有关更多信息,请参阅 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 查看备份策略详细信息

将备份策略的详细信息作为只读数据源导入。 可以指定策略标识或策略名称。

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 查看备份计划详细信息

将备份计划的详细信息作为只读数据源导入。 您可以指定计划标识或计划名称,如以下示例中所示。

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. 要使备份操作成功,必须将标记的卷附加到正在运行的虚拟服务器实例。 即使未连接的卷具有正确的标记,也不会备份这些卷。 ↩︎