更新时间:2024-03-28 GMT+08:00

查询跨区域备份策略

功能介绍

在备份原区域查询实例的跨区域备份策略。

URI

  • URI格式

    GET /v3/{project_id}/instances/{instance_id}/backups/offsite-policy

  • 参数说明
    表1 参数说明

    名称

    是否必选

    说明

    project_id

    租户在某一Region下的项目ID。

    获取方法请参见获取项目ID

    instance_id

    实例ID。

请求消息

  • 请求参数

    无。

  • URI样例

    GET https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/dsfae23fsfdsae3435in01/backups/offsite-policy

响应消息

  • 正常响应要素说明
    表2 要素说明

    名称

    参数类型

    说明

    policy_para

    Array of objects

    备份策略对象,包括备份类型、备份保留天数、目标区域ID和目标project ID。

    详情请参见表3

    表3 policy_para字段数据结构说明

    名称

    参数类型

    说明

    backup_type

    String

    指定备份的类型。取值如下:

    • auto:自动全量备份。
    • incremental:自动增量备份。
    • manual:手动备份,仅RDS for SQL Server返回该备份类型 。

    keep_days

    Integer

    备份文件可以保存的天数。

    destination_region

    String

    设置跨区域备份策略的目标区域ID。

    destination_project_id

    String

    设置跨区域备份策略的目标project ID。

  • 正常响应样例

    备份策略关闭时:

    {
    	"policy_para": {
    		"keep_days": 0
    	}
    }
    RDS for MySQL、RDS for PostgreSQL自动备份策略和增量备份策略开启时:
    {
    	"policy_para": [
                {
    		"keep_days": 7,
    		"backup_type": "auto",
    		"destination_region": "aaa",
                    "destination_project_id": "0503fd7f7580d3262fc5c001170fbab9"
                },
                {
                    "keep_days": 7,
    		"backup_type": "incremental",
    		"destination_region": "aaa",
                    "destination_project_id": "0503fd7f7580d3262fc5c001170fbab9"
                 }
    	]
    }
    RDS for SQL Server自动备份策略、增量备份策略和手动备份策略开启时:
    {
    	"policy_para": [
                {
    		"keep_days": 7,
    		"backup_type": "incremental",
    		"destination_region": "aaa",
                    "destination_project_id": "0503fd7f7580d3262fc5c001170fbab9"
                },
                {
                    "keep_days": 7,
    		"backup_type": "manual",
    		"destination_region": "aaa",
                    "destination_project_id": "0503fd7f7580d3262fc5c001170fbab9"
                 },
                {
    		"keep_days": 7,
    		"backup_type": "auto",
    		"destination_region": "aaa",
                    "destination_project_id": "0503fd7f7580d3262fc5c001170fbab9"
                }
    	]
    }
  • 异常响应

    请参见异常请求结果

状态码

错误码

请参见错误码