九游平台/ flexus云服务_flexus云数据库rds/ api参考/ api v3/ 备份与恢复/ 创建手动备份
更新时间：2024-08-07 gmt 08:00
查看pdf

创建手动备份-九游平台

功能介绍

创建手动备份。

接口约束

备份名称不能和已有备份重名。

uri

  • uri格式

    post /v3/{project_id}/backups

  • 参数说明
    表1 参数说明

    名称

    是否必选

    参数类型

    说明

    project_id

    是

    string

    参数解释：

    租户在某一region下的项目id。

    获取方法请参见获取项目id。

    约束限制：

    不涉及。

    取值范围：

    不涉及。

    默认取值：

    不涉及。

请求消息

表2 参数说明

名称

是否必选

参数类型

说明

instance_id

是

string

参数解释：

实例id。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

name

是

string

参数解释：

备份名称。

约束限制：

备份名称不能和已有备份重名。

取值范围：

4~64个字符，必须以英文字母开头，区分大小写，可以包含英文字母、数字、中划线或者下划线，不能包含其他特殊字符。

默认取值：

不涉及。

description

否

string

参数解释：

备份描述。

约束限制：

不涉及。

取值范围：

不能包含>!<"&'=特殊字符，不大于256个字符。

默认取值：

不涉及。

请求示例

创建flexusrds实例的手动备份mybackup。 
post https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/backups
{
	"instance_id": "d8e6ca5a624745bcb546a227aa3ae1cfin01",
	"name": "mybackup",
	"description": "manual backup"
}

响应消息

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

    名称

    参数类型

    说明

    backup

    object

    参数解释：

    备份信息。详情请参见表4。
    表4 backup字段数据结构说明

    名称

    参数类型

    说明

    id

    string

    参数解释：

    备份id。

    取值范围：

    不涉及。

    instance_id

    string

    参数解释：

    实例id。

    取值范围：

    不涉及。

    name

    string

    参数解释：

    备份名称。

    取值范围：

    4~64个字符，必须以英文字母开头，区分大小写，可以包含英文字母、数字、中划线或者下划线，不能包含其他特殊字符。

    description

    string

    参数解释：

    备份描述。

    取值范围：

    不能包含>!<"&'=特殊字符，不大于256个字符。

    begin_time

    string

    参数解释：

    备份开始时间，格式为“yyyy-mm-ddthh:mm:ssz”，其中t指时间字段的开始；z指时区偏移量。

    取值范围：

    不涉及。

    status

    string

    参数解释：

    备份状态。

    取值范围：

    • building：备份中
    • completed：备份完成
    • failed：备份失败
    • deleting：备份删除中

    type

    string

    参数解释：

    备份类型。

    取值范围：

    • auto：自动全量
    • manual：手动全量
    • fragment：差异全量
    • incremental：自动增量。
  • 正常响应样例 
    {
	"backup": {
		"id": "cb211c0075104151a748a854bc8bd87dbr01",
		"name": "mybackup",
		"description": "manual backup",
		"begin_time": "2022-08-23t07:41:50z",
		"status": "building",
		"type": "manual",
		"instance_id": "d8e6ca5a624745bcb546a227aa3ae1cfin01"
	}
}
  • 异常响应

    请参见异常请求结果。

状态码

父主题： 备份与恢复

相关文档

网站地图