查询自动备份策略 - ShowBackupPolicy

功能介绍

查询自动备份策略。

• 调用接口前，您需要了解API认证鉴权。
• 调用接口前，您需要了解请求Header参数说明。

调试

您可以在API Explorer中调试该接口。

授权信息

URI

• URI格式

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

• 参数说明

  表1 参数说明

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

请求消息

• 请求参数

  无。

• URI样例

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

响应消息

• 正常响应要素说明

  表2 要素说明

  名称	参数类型	说明
  backup_policy	Object	备份策略对象，包括备份保留的天数和备份开始时间。 详情请参见表3。

  表3 backup_policy字段数据结构说明

  名称	参数类型	说明
  keep_days	Integer	备份文件可以保存的天数。
  start_time	String	备份时间段。自动备份将在该时间段内触发，当前时间段为UTC时间。
  period	String	备份周期配置。自动备份将在每星期指定的天进行。

• 正常响应样例

  自动备份策略关闭时：

  {
  	"backup_policy": {
  		"keep_days": 0
  	}
  }

  自动备份策略开启时：

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

• 异常响应

  请参见异常请求结果。

状态码

• 正常

  200

• 异常

  请参见状态码。

错误码

请参见错误码。