- 产品介绍
- 快速入门
- 用户指南
- API参考
-
常见问题
- 什么是云硬盘备份?
- 什么是备份策略?
- 备份和容灾的区别是什么?
- 云硬盘备份如何购买和续费?
- 云硬盘备份和云服务器备份的区别是什么?
- VBS支持对服务器中所有云硬盘同时进行备份吗?
- 云硬盘备份时,需要停止服务器吗?
- 云硬盘能否跨区域备份和恢复?
- 使用VBS恢复数据时,需要停止服务器吗?
- 通过备份创建的云硬盘是按需收费还是包月/包年?
- 为什么CSBS产生的备份也会出现在VBS界面?
- 系统盘备份能恢复弹性云服务器吗?
- 扩容后的云硬盘能否使用备份恢复数据?
- 云硬盘备份有配额限制吗?
- 云硬盘备份出现异常该如何处理?
- 为备份或备份策略添加标签的作用是什么?
- 云硬盘支持每天多次备份吗?
- 一个磁盘能绑定多少个策略?
- 什么是全量备份和增量备份?
- 备份和快照的区别是什么?
- 为什么备份已删除但显示的剩余空间依旧没有变化?
- 为什么备份中文件系统容量和备份大小不一致?
- 保留策略修改后为什么没有生效?
- 如何停止自动备份?
- 如何查看资源包的使用量?
- 资源包是否支持退订?
- 视频帮助
- 文档下载
- 通用参考
链接复制成功!
创建备份策略
功能介绍
创建一个备份策略,一个租户最多只能创建10个备份策略。
请求
- 参数说明
参数
是否必选
参数类型
描述
backup_policy_name
是
string
备份策略名称
只能由数字、字母、汉字、下划线、中划线组成,长度1到64位。
scheduled_policy
是
dict
调度策略详情。
start_time
是
string
备份开始时间,格式为HH:mm
需要转化成本地时间对应的UTC时间(目前只支持整点),支持选择多个整点,多个整点间以逗号分隔。多个时间点启用备份时,请按照本地时间顺序编排,如UTC+02:00时区的00:00、02:00和04:00启动备份,转化为UTC时间后,start_time应取值“22:00,00:00,02:00”,time_zone取值"UTC+02:00"。
frequency
否(该字段和week_frequency字段必须二选一)
integer
备份间隔(1-30天),该字段和week_frequency字段二选一,如果同时设置,默认以该字段为准。
week_frequency
否(该字段和frequency字段必须二选一)
list<string>
按指定周进行备份,取值为以下值的一个或者多个:
SUN,MON,TUE,WED,THU,FRI,SAT
rentention_num
否(该字段和rentention_day字段必须二选一)
integer
备份保留个数,取值为2-99的整型,该字段和rentention_day字段二选一,如果同时设置,默认以该字段为准。
rentention_day
否(该字段和rentention_num字段必须二选一)
integer
备份保留天数。取值为2-99999的整型,如果输入的是浮点数,则会在发送请求的时候自动向下取整转化为整型。
remain_first_backup_of_curMonth
否
string
是否保留当月的第一个备份。
- Y
- N
status
是
string
策略状态:启用或停用。
- ON
- OFF
tags
否
list<dict>
待设置到该备份策略上的标签。
key
是
string
键。最大长度36个字符,不能为空。 字符集:不能包含非打印字ASCII(0-31),"=","*","<",">","\",",","|","/"
value
是
string
值。最大长度43个字符,可以为空字符串。字符集:不能包含非打印字ASCII(0-31),"=","*","<",">","\",",","|","/"
time_zone
否
string
时区参数。取值为UTC+/-HH:mm
对应本地调度时间所在的时区,包含夏令时偏移。如UTC+08:00、UTC-02:00。当本地时间转化为UTC时间跨天后,需配合week_frequency、start_time字段使用。
- 请求样例
{ "backup_policy_name": "policy_01", "scheduled_policy" : { "remain_first_backup_of_curMonth" : "Y", "rentention_day" : 30, "week_frequency" : ["SUN","WED"], "start_time" : "12:00", "status" : "ON" }, "tags":[{ "key":"key", "value":"value" }], "time_zone": "UTC+08:00" }
响应
- 要素说明
参数
参数类型
描述
backup_policy_id
string
正常返回时,返回的策略ID。
message
string
出现错误时,返回的错误消息。
code
string
出现错误时,返回的错误码。
错误码的具体含义请参考错误码。
- 响应样例
{ "backup_policy_id": "af8a20b0-117d-4fc3-ae53-aa3968a4f870" }
或
{ "error": { "code": "XXXX", "message": "XXX" } }
状态码
- 正常
- 异常
状态码
说明
400 Bad Request
服务器未能处理请求。
401 Unauthorized
被请求的页面需要用户名和密码。
403 Forbidden
对被请求页面的访问被禁止。
404 Not Found
服务器无法找到被请求的页面。
405 Method Not Allowed
请求中指定的方法不被允许。
406 Not Acceptable
服务器生成的响应无法被客户端所接受。
407 Proxy Authentication Required
用户必须首先使用代理服务器进行验证,这样请求才会被处理。
408 Request Timeout
请求超出了服务器的等待时间。
409 Conflict
由于冲突,请求无法被完成。
500 Internal Server Error
请求未完成。服务异常。
501 Not Implemented
请求未完成。服务器不支持所请求的功能。
502 Bad Gateway
请求未完成。服务器从上游服务器收到一个无效的响应。
503 Service Unavailable
请求未完成。系统暂时异常。
504 Gateway Timeout
网关超时。
错误码
请参考错误码。