查询自动备份策略

功能介绍

查询自动备份策略。

该接口计划于2025-03-31下线，建议及时切换到新接口查询自动备份策略。

• 调用接口前，您需要了解API认证鉴权。
• 调用接口前，您需要提前获取到地区和终端节点，即下文中的Endpoint值。

URI

• URI格式

  GET https://{endpoint}/mysql/v3/{project_id}/instances/{instance_id}/backups/policy

• URI样例

  GET https://{endpoint}/mysql/v3/97b026aa9cc4417888c14c84a1ad9860/instances/c3ec2c6148ad4d71b1a8411a62df0d3cin07/backups/policy

• 参数说明

  表1 参数说明

  名称	参数类型	是否必选	说明
  project_id	String	是	租户在某一Region下的project ID。 获取方法请参见获取项目ID。
  instance_id	String	是	实例ID。

请求消息

无

响应消息

• 正常响应要素说明

  表2 参数说明

  名称	参数类型	说明
  backup_policy	object	备份策略信息。 详情请参见表 backup_policy字段数据结构说明。

  表3 backup_policy字段数据结构说明

  名称	参数类型	说明
  keep_days	Integer	指定已生成的备份文件可以保存的天数。取值范围：1～732。 最小值：1 最大值：732
  start_time	String	备份时间段。自动备份将在该时间段内触发。 取值范围：格式必须为hh:mm-HH:MM且有效，当前时间指UTC时间。
  period	String	备份周期配置。自动备份将在每星期指定的天进行。 取值范围：格式为逗号隔开的数字，数字代表星期。
  retention_num_backup_level1	Integer	1级备份保留数量。当一级备份开关开启时，返回此参数。
• 正常响应样例

  {
  "backup_policy": {
  "keep_days": 7,
  "start_time": "19:00-20:00",
  "period": "1,2",
  " retention_num_backup_level1": 1
  }
  }

状态码

请参见状态码。

错误码

请参见错误码。