导出备份(2.3.16) -ExportBackup2
功能介绍
通过该API,您可以将GES图实例备份导出到OBS。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
URI
POST /v2/{project_id}/graphs/{graph_id}/backups/export
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| project_id | 是 | String | 参数解释: 项目编号。获取方法,请参见获取项目ID。 约束限制: 不涉及。 取值范围: 只能由英文字母和数字组成,且长度为[1-64]个字符。 默认取值: 不涉及。 |
| graph_id | 是 | String | 参数解释: 图ID。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| X-Auth-Token | 是 | String | 参数解释: 用户Token。用于获取操作API的权限。获取方法请参见获取Token接口,响应消息头中X-Subject-Token的值即为Token。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| backup_id | 是 | String | 参数解释: 备份ID。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| export_path | 是 | String | 参数解释: OBS导出路径。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
响应参数
状态码: 200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| job_id | String | 参数解释: 执行异步任务的JobID。 取值范围: 不涉及。 |
状态码: 400
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 参数解释: 系统提示信息。
取值范围: 不涉及。 |
| error_msg | String | 参数解释: 系统提示信息。
取值范围: 不涉及。 |
请求示例
导出备份。
POST https://{Endpoint}/v2/{project_id}/graphs/{graph_id}/backups/export
{
"backup_id": "{backup_id}",
"export_path" : "{obs_path}"
} 响应示例
状态码: 200
成功响应示例
{
"job_id" : "ff8080815f9a3c84015f9a438ff70001"
} 状态码: 400
失败响应示例
{
"errorCode": "GES.7049",
"errorMessage": "The parameter [backup_id] is not exist."
} 状态码
| 返回值 | 说明 |
|---|---|
| 400 Bad Request | 请求错误 |
| 401 Unauthorized | 鉴权失败 |
| 403 Forbidden | 没有操作权限 |
| 404 Not Found | 找不到资源 |
| 500 Internal Server Error | 服务内部错误 |
| 503 Service Unavailable | 服务不可用 |
错误码
请参见错误码。