更新时间:2025-06-05 GMT+08:00
        
          
          
        
      
      
      
      
      
      
      
      
  
      
      
      
        
导出备份(2.3.16)
功能介绍
通过该API,您可以将GES图实例备份导出到OBS。
URI
POST /v2/{project_id}/graphs/{graph_id}/backups/export
| 
        参数  | 
      
        是否必选  | 
      
        参数类型  | 
      
        描述  | 
     
|---|---|---|---|
| 
        project_id  | 
      
        是  | 
      
        String  | 
      
        项目ID。获取方法请参见获取项目ID。  | 
     
| 
        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  | 
      
        服务不可用  | 
     
错误码
请参见错误码。
   父主题: 备份管理API