文档首页 > > API参考> API v3(推荐)> 备份与恢复> 创建手动备份

创建手动备份

分享
更新时间:2020/10/14 GMT+08:00

功能介绍

创建手动备份。

接口约束

  • SQL Server数据库引擎对单库创建手动备份时,支持批量执行。
  • 只读实例不支持创建手动备份。
  • 备份名称不能和已有备份重名。

URI

  • URI格式

    POST https://{Endpoint}/v3/{project_id}/backups

  • URI样例

    https://rds.cn-north-1.myhuaweicloud.com/v3/0483b6b16e954cb88930a360d2c4e663/backups

  • 参数说明
    表1 参数说明

    名称

    是否必选

    说明

    project_id

    租户在某一region下的project ID。

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

请求消息

  • 参数说明
    表2 参数说明

    名称

    是否必选

    参数类型

    说明

    instance_id

    String

    实例ID。

    name

    String

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

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

    description

    String

    备份描述,不能包含>!<"&'=特殊字符,不大于256个字符。

    databases

    Array of objects

    只支持Microsoft SQL Server,局部备份的用户自建数据库名列表,当有此参数时以局部备份为准。

    详情请参见表3

    表3 databases字段数据结构说明

    名称

    是否必选

    参数类型

    说明

    name

    String

    用户自建数据库名。

  • 请求样例
    MySQL/PostgreSQL实例:
    {
    	"instance_id": "d8e6ca5a624745bcb546a227aa3ae1cfin01",
    	"name": "backup",
    	"description": "manual backup"
    }
    Microsoft SQL Server实例:
    {
    	"instance_id": "d8e6ca5a624745bcb546a227aa3ae1cfin04",
    	"name": "backup",
    	"description": "manual backup",
    	"databases": [{
    		"name": "db1"
    	}, {
    		"name": "db2"
    	}]
    }

响应消息

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

    名称

    参数类型

    说明

    backup

    Object

    备份信息。

    详情请参见表5

    表5 backup字段数据结构说明

    名称

    参数类型

    说明

    id

    String

    备份ID。

    instance_id

    String

    实例ID。

    name

    String

    备份名称。

    description

    String

    备份描述。

    databases

    Array of objects

    只支持Microsoft SQL Server,局部备份的用户自建数据库名列表,当有此参数时以局部备份为准。

    详情请参见表3

    begin_time

    String

    备份开始时间,格式为“yyyy-mm-ddThh:mm:ssZ”,其中T指时间字段的开始;Z指时区偏移量。

    status

    String

    备份状态,取值:

    • BUILDING: 备份中
    • COMPLETED: 备份完成
    • FAILED:备份失败
    • DELETING:备份删除中

    type

    String

    备份类型,取值:

    • auto: 自动全量
    • manual: 手动全量
    • fragment: 差异全量
    • incremental: 自动增量。
  • 正常响应样例
    MySQL/PostgreSQL实例:
    {
    	"backup": {
    		"id": "2f4ddb93-b901-4b08-93d8-1d2e472f30fe",
    		"name": "backupDemo",
    		"description": "This is a description",
    		"begin_time": "2016-09-12T01:17:05",
    		"status": "BUILDING",
    		"type": "manual",
    		"instance_id": "d8e6ca5a624745bcb546a227aa3ae1cfin01"
    	}
    }
    Microsoft SQL Server实例:
    {
    	"backup": {
    		"id": "2f4ddb93-b901-4b08-93d8-1d2e472f30fe",
    		"name": "backupDemo",
    		"description": "This is a description",
    		"begin_time": "2016-09-12T01:17:05",
    		"status": "BUILDING",
    		"type": "manual",
    		"instance_id": "d8e6ca5a624745bcb546a227aa3ae1cfin01",
    		"databases": [{
    			"name": "db1"
    		}]
    	}
    }
  • 异常响应

    请参见异常请求结果

状态码

请参见状态码

错误码

请参见错误码

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!非常感谢您的反馈,我们会继续努力做到更好!
反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

智能客服提问云社区提问