# 查看所有备份列表(1.0.0) -ListBackups2 #### 功能介绍 查询备份列表。 #### 调试 您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=GES&api=ListBackups2&version=v2)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 #### URI GET /v2/{project_id}/graphs/backups 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | **参数解释：** 项目编号。获取方法，请参见[获取项目ID](https://support.huaweicloud.com/api-ges/ges_03_0111.html)。 **约束限制：** 不涉及。 **取值范围：** 只能由英文字母和数字组成，且长度为\[1-64\]个字符。 **默认取值：** 不涉及。 | 表2Query参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | limit | 否 | Integer | **参数解释：** 每页资源数量的最大值。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 默认为10。 | | offset | 否 | Integer | **参数解释：** 本次请求的起始位置。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 默认为0。 | #### 请求参数 表3请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | X-Auth-Token | 是 | String | **参数解释：** 用户Token。用于获取操作API的权限。获取方法请参见[获取Token接口](https://support.huaweicloud.com/api-ges/ges_03_0005.html)，响应消息头中X-Subject-Token的值即为Token。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 | #### 响应参数 **状态码： 200** 表4响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | backup_count | Integer | **参数解释**： 备份总个数。请求失败时，字段为空。 **取值范围**： 不涉及。 | | backup_list | Array of [backup_list] objects | **参数解释**： 当前Project ID下的所有图的备份列表。请求失败时，字段为空。 **取值范围**： 不涉及。 | 表5backup_list | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | **参数解释**： 备份ID。 **取值范围**： 不涉及。 | | name | String | **参数解释**： 备份名称。 **取值范围**： 不涉及。 | | backup_method | String | **参数解释**： 备份方法。 **取值范围**： - auto：自动备份。 - manual：手动备份。 - import：导入备份。 | | graph_id | String | **参数解释**： 备份关联的图ID。 **取值范围**： 不涉及。 | | graph_name | String | **参数解释**： 备份关联的图Name。 **取值范围**： 不涉及。 | | graph_status | String | **参数解释**： 备份关联的图状态。 **取值范围**： 不涉及。 | | graph_size_type_index | String | **参数解释**： 备份关联的图规格。 **取值范围**： 不涉及。 | | data_store_version | String | **参数解释**： 备份关联的图版本。 **取值范围**： 不涉及。 | | arch | String | **参数解释**： 备份关联的图CPU架构。 **取值范围**： 不涉及。 | | status | String | **参数解释**： 备份状态。 **取值范围** - backing_up：备份中。 - success：备份成功。 - failed：备份失败。 | | start_timestamp | Long | **参数解释**： 备份开始时间戳。 **取值范围**： 不涉及。 | | start_time | String | **参数解释**： 备份开始时间。 **取值范围**： 不涉及。 | | product_type | String | **参数解释**： 图产品类型。 **取值范围**： - InMemory：内存版。 - Persistence：持久化版。 | | end_timestamp | Long | **参数解释**： 备份结束时间戳。 **取值范围**： 不涉及。 | | end_time | String | **参数解释**： 备份结束时间。 **取值范围**： 不涉及。 | | size | Long | **参数解释**： 备份文件大小，单位为MB。 **取值范围**： 不涉及。 | | duration | Long | **参数解释**： 备份时间，单位为秒。 **取值范围**： 不涉及。 | **状态码： 400** 表6响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释**： 系统提示信息。 - 执行成功时，字段可能为空。 - 执行失败时，用于显示错误码。 **取值范围**： 不涉及。 | | error_msg | String | **参数解释**： 系统提示信息。 - 执行成功时，字段可能为空。 - 执行失败时，用于显示错误信息。 **取值范围**： 不涉及。 | #### 请求示例 查询备份列表。 ``` GET https://{Endpoint}/v2/{project_id}/graphs/backups?offset=0&limit=3 ``` #### 响应示例 **状态码： 200** 成功响应示例 ``` { "backup_count" : 3, "backup_list" : [ { "id" : "ada3e720-ab87-48cb-bff7-3ec5ae1a9652", "name" : "ges060803_nodelete-20210608135513", "backup_method" : "manual", "graph_id" : "4c5f882d-a813-4d78-a8e3-6d3212ddd121", "graph_name" : "ges060803_nodelete", "graph_status" : "200", "graph_size_type_index" : "1", "data_store_version" : "2.2.21", "arch" : "x86_64", "status" : "success", "start_timestamp" : 1623160513000, "start_time" : "2021-06-08T13:55:13", "end_timestamp" : 1623160568000, "end_time" : "2021-06-08T13:56:08", "size" : 1, "duration" : 54 }, { "id" : "7ed3f51d-816d-4651-9129-fe21b64b5c91", "name" : "ges060803_nodelete_20210609203323_auto", "backup_method" : "auto", "graph_id" : "4c5f882d-a813-4d78-a8e3-6d3212ddd121", "graph_name" : "ges060803_nodelete", "graph_status" : "200", "graph_size_type_index" : "1", "data_store_version" : "2.2.21", "arch" : "x86_64", "status" : "success", "start_timestamp" : 1623242004000, "start_time" : "2021-06-09T12:33:24", "end_timestamp" : 1623242004000, "end_time" : "2021-06-09T12:33:24", "size" : 1, "duration" : 0 }, { "id" : "604bfb46-04dd-45fc-a9ae-df24a0705b9d", "name" : "ges060802_nodelete-20210608135523", "backup_method" : "manual", "graph_id" : "9b9a05c2-0cdb-41ac-b55f-93caffb0519a", "graph_name" : "ges060802_nodelete", "graph_status" : "400", "graph_size_type_index" : "0", "data_store_version" : "2.2.23", "arch" : "x86_64", "status" : "success", "start_timestamp" : 1623160524000, "start_time" : "2021-06-08T13:55:24", "end_timestamp" : 1623160577000, "end_time" : "2021-06-08T13:56:17", "size" : 1, "duration" : 53 } ] } ``` **状态码： 400** 失败响应示例 ``` { "error_code" : "GES.7006", "error_msg" : "An internal error occurs in the underlying service of the graph engine." } ``` #### 状态码 | 返回值 | 说明 | |:---|:---| | 400 Bad Request | 请求错误 | | 401 Unauthorized | 鉴权失败 | | 403 Forbidden | 没有操作权限 | | 404 Not Found | 找不到资源 | | 500 Internal Server Error | 服务内部错误 | | 503 Service Unavailable | 服务不可用 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-ges/ges_03_0040.html)。