更新时间:2024-05-21 GMT+08:00

创建手动备份

功能介绍

创建手动备份。

URI

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

表1 参数说明

参数

是否必选

参数类型

描述

project_id

String

租户在某一Region下的项目ID。

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

请求参数

表2 参数说明

参数

是否必选

参数类型

描述

instance_id

String

实例ID。

name

String

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

最小长度:4

最大长度:64

description

String

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

最大长度:256

请求示例

创建GaussDB手动全量备份。

POST https://gaussdb-opengauss.ap-southeast-1.myhuaweicloud.com/v3/0483b6b16e954cb88930a360d2c4e663/backups
{
  "instance_id" : "7e01ac5ac5274957ba506f3851d11d51in14",
  "name" : "backupwqwq3",
  "description" : "manual backup"
}

响应参数

表3 响应Body参数

参数

参数类型

描述

backup

Object

备份信息。

详情请参见表4

job_id

String

任务ID。

表4 backup字段数据结构说明

参数

参数类型

描述

id

String

备份ID。

name

String

备份名称。

description

String

备份描述。

begin_time

String

备份开始时间,格式为“yyyy-mm-ddThh:mm:ssZ”。

其中,T指某个时间的开始;Z指时区偏移量,例如北京时间偏移显示为+0800。

status

String

备份状态,取值:

  • BUILDING:备份中。
  • COMPLETED:备份完成。
  • FAILED:备份失败。

type

String

备份类型,“manual”表示手动全量备份。

instance_id

String

实例ID。

响应示例

{
    "backup": {
        "id": "e76112bfb2074871bf54cb8df5af7f64br14",
        "name": "backupwqwq32",
        "description": "mannual backup",
        "status": "BUILDING",
        "type": "manual",
        "begin_time": "2022-05-09T18:02:31+0800",
        "instance_id": "fd26e3bf26e5467587eec857e4f66ef0in14"
    },
    "job_id": "e4733090-b2c8-4ea7-a33a-f55f65723fb3"
}

状态码

错误码

请参见错误码