创建手动备份

功能介绍

创建手动备份。

该接口计划于2025-03-31下线，建议及时切换到新接口创建手动备份。

• 调用接口前，您需要了解API认证鉴权。
• 调用接口前，您需要提前获取到地区和终端节点，即下文中的Endpoint值。

URI

• URI格式

  POST https://{endpoint}/mysql/v3/{project_id}/backups/create

• URI样例

  POST https://{endpoint}/mysql/v3/0483b6b16e954cb88930a360d2c4e663/backups/create

• 参数说明

  表1 参数说明

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

请求消息

• 请求样例

  {
     "instance_id": "d8e6ca5a624745bcb546a227aa3ae1cfin01",
     "name": "backup-1",
     "description": "manual backup"
  }

响应消息

• 正常响应要素说明

  表3 要素说明

  名称	参数类型	说明
  backup	Object	备份信息。 详情请参见表 backup字段数据结构说明。

  表4 backup字段数据结构说明

  名称	参数类型	说明
  id	String	备份ID。
  name	String	备份名称。
  description	String	备份描述。
  begin_time	String	备份开始时间，格式为“yyyy-mm-ddThh:mm:ssZ”，其中T指时间字段的开始；Z指时区偏移量。
  status	String	备份状态，取值： BUILDING: 备份中。 COMPLETED: 备份完成。 FAILED：备份失败。 AVAILABLE：备份可用。
  type	String	备份类型，取值： manual: 手动全量。
  instance_id	String	实例ID。

• 正常响应样例：

  {
  "backup": {
  "id": "2f4ddb93-b901-4b08-93d8-1d2e472f30fe",
  "name": "backup-1",
  "begin_time": "2020-07-07T01:17:05+0800",
  "status": "BUILDING",
  "type": "manual",
  "instance_id": "d8e6ca5a624745bcb546a227aa3ae1cfin01",
  "description": "desc"
  }
  }

状态码

请参见状态码。

错误码

请参见错误码。