IBM Cloud Docs
更新到 2023-12-05 版本 (备份策略)

更新到 2023-12-05 版本 (备份策略)

正如 VPC API 参考 versioning 策略中所描述的，VPC API 的大多数更改与早期版本完全兼容，并提供给所有客户端，无论客户端请求的 API 版本如何。 但是，2023-12-05 发布的 VPC API 在支持备份策略方法时必须进行不兼容的更改。

在采用发行版 2023-12-05 或更高版本之前，请注意可能需要您更新客户机的以下更改:

  • 备份策略方法只支持备份策略的一种资源类型。 在 2023-12-05 版本中，属性 match_resource_types 变为 match_resource_type。 此更改适用于 创建、更新、 列出、检索 和 删除 备份策略。
  • 当您发起 创建备份策略 的请求时，您必须为 match_resource_type 属性提供一个值，即 volume 或 instance 值。 选择 volume 时，备份策略将分别应用于单个 Block Storage for VPC 卷。 指定 instance 时，会将连接到相同实例的 Block Storage for VPC 卷视为一致性组，并在松散组中一起创建这些卷的备份快照。

所需操作

在指定 version 查询参数为 2023-12-05 或更高版本之前，请执行以下操作以避免客户端功能出现倒退。

如果客户机继续指定 V 2023-12-04 或更低版本，那么不需要进行任何更改。

客户机迁移

在将客户端迁移到 2023-12-05 或更高版本的 API 之前，请检查您的代码是否使用了 POST /backup_policies、PATCH /backup_policies 和 GET /backup_policies 方法。 验证您的代码是否以适合编程语言的方式包含备份策略的 match_resource_type 和 included_content 属性。 有关更多信息，请参阅 API 更改日志。

示例

这些示例比较 2023-12-05 版本化更改前后的差异。

创建备份策略

以下示例使用 API V 2023-12-04 或更低版本为各个卷创建备份策略。 data 对象将 match_resource_types 指定为 array。 无法创建具有 API 版本 2023-12-04 或更低版本的 instance 类型备份策略。

curl -X POST "$vpc_api_endpoint/v1/backup_policies?version=2023-12-04&generation=2"    
-H "Authorization: $iam_token"   
 -d '{
   "match_resource_types": "array",
   "match_user_tags": ["my-daily-backup-policy"],
   "name": "my-backup-policy",
   "plans": [
      {
        "attach_user_tags": ["my-daily-backup-plan"],
         "copy_user_tags": true,
         "cron_spec": "*/5 1,2,3 * * *",
         "deletion_trigger": {"delete_after": 20},
         "name": "my-backup-plan"
       }
     ],
     "resource_group": {}
   }'

以下示例使用 API V 2023-12-05 或更高版本为各个卷创建备份策略。 data 对象将 match_resource_type 指定为 volume。

curl -X POST "$vpc_api_endpoint/v1/backup_policies?version=2023-12-05&generation=2"\
   -H "Authorization: $iam_token"\
   -d '{
     "match_resource_type": "volume",
     "match_user_tags": ["my-daily-backup-policy"],
     "name": "my-backup-policy",
     "plans": [
      {
        "attach_user_tags": ["my-daily-backup-plan"],
         "copy_user_tags": true,
         "cron_spec": "*/5 1,2,3 * * *",
         "deletion_trigger": {"delete_after": 20},
         "name": "my-backup-plan"
       }
     ],
     "resource_group": {}
   }'

以下示例使用 API V 2023-12-05 或更高版本为连接到同一虚拟服务器实例的 Block Storage for VPC 卷的一致性组创建备份策略。 数据对象将 match_resource_type 指定为 instance，将 included_content 指定为 data_volumes。

curl -X POST "$vpc_api_endpoint/v1/backup_policies?version=2023-12-05&generation=2"\
   -H "Authorization: $iam_token"\
   -d '{
      "match_resource_type": "instance",
      "included_content": "data_volumes"
      "match_user_tags": ["my-daily-backup-policy"],
      "name": "my-backup-policy",
      "plans": [
       {
         "attach_user_tags": ["my-daily-backup-plan"],
         "copy_user_tags": true,
         "cron_spec": "*/5 1,2,3 * * *",
         "deletion_trigger": {"delete_after": 20},
         "name": "my-backup-plan"
       }
     ],
     "resource_group": {}
   }'