# 管理面API概览 GES管理面API包括系统管理，图管理，备份管理，元数据管理和任务中心。 表1系统管理API | 名称 | 版本 | URL | 功能描述 | |:---|:---|:---|:---| | [查询配额](https://support.huaweicloud.com/api-ges/ges_03_0343.html) | 1.0.0 | GET /v2/{project_id}/graphs/quotas | 查询图个数、边数以及备份个数配额。创建图或者图备份操作时，可以调用该API查看配额，避免报错配额不足。 | 表2图管理API | 名称 | 版本 | URL | 功能描述 | |:---|:---|:---|:---| | [查询图列表](https://support.huaweicloud.com/api-ges/ges_03_0345.html) | 2.1.18 | GET /v2/{project_id}/graphs | 查看已经创建的所有图的列表。 | | [查询图详情](https://support.huaweicloud.com/api-ges/ges_03_0346.html) | 1.0.0 | GET /v2/{project_id}/graphs/{graph_id} | 查询某个图的详情，包括图内网、公网访问地址，图版本号，图已经导入的点、边数据集。 | | [创建图](https://support.huaweicloud.com/api-ges/ges_03_0347.html) | 2.2.2 | POST /v2/{project_id}/graphs | 用户定义好图的元数据和点、边数据集后，下一步就是创建一个图。 | | [关闭图](https://support.huaweicloud.com/api-ges/ges_03_0348.html) | 1.0.0 | POST /v2/{project_id}/graphs/{graph_id}/stop | 用户的业务不需要连续性，可以随时关闭图。停止后，图停止计费。 | | [启动图](https://support.huaweicloud.com/api-ges/ges_03_0349.html) | 1.0.0 | POST /v2/{project_id}/graphs/{graph_id}/start | 用户关闭图后要再次使用图，可以把数据恢复到上次关闭状态或者恢复到某个备份时间点。 | | [删除图](https://support.huaweicloud.com/api-ges/ges_03_0350.html) | 1.0.0 | DELETE /v2/{project_id}/graphs/{graph_id} | 用户不需要时可以删除图，删除后图停止计费。 | | [增量导入图](https://support.huaweicloud.com/api-ges/ges_03_0073.html) | 2.1.14 | POST /v2/{project_id}/graphs/{graph_id}/import-graph | 用户需要增量导入图数据。 | | [导出图](https://support.huaweicloud.com/api-ges/ges_03_0352.html) | 1.0.5 | POST /v2/{project_id}/graphs/{graph_id}/export-graph | 用户需要把图的所有数据导出为文本文件。 | | [清空图](https://support.huaweicloud.com/api-ges/ges_03_0353.html) | 2.1.2 | POST /v2/{project_id}/graphs/{graph_id}/clear-graph | 用户要把图的所有数据清空，包括点、边数据。 | | [升级图](https://support.huaweicloud.com/api-ges/ges_03_0354.html) | 1.0.5 | POST /v2/{project_id}/graphs/{graph_id}/upgrade | 老版本的图有Bug或者需要增加新功能时，需要把老版本的图升级到新版本。 | | [绑定EIP](https://support.huaweicloud.com/api-ges/ges_03_0355.html) | 1.0.6 | POST /v2/{project_id}/graphs/{graph_id}/bind-eip | 用户需要在公网访问图时，需要绑定一个弹性公网IP。 | | [解绑EIP](https://support.huaweicloud.com/api-ges/ges_03_0356.html) | 1.0.6 | POST /v2/{project_id}/graphs/{graph_id}/unbind-eip | 用户不需要在公网访问图时，可以把该图绑定的弹性公网IP解绑。 | | [变更规格](https://support.huaweicloud.com/api-ges/ges_03_0357.html) | 2.2.21 | POST /v2/{project_id}/graphs/{graph_id}/resize | 变更图规格。 | | [强制重启图](https://support.huaweicloud.com/api-ges/ges_03_0358.html) | 2.2.21 | POST /v2/{project_id}/graphs/{graph_id}/restart | 强制启动一个图。 | | [扩副本](https://support.huaweicloud.com/api-ges/ges_03_0359.html) | 2.2.23 | POST /v2/{project_id}/graphs/{graph_id}/expand | 扩副本能力允许动态扩容多个从节点，扩容的从节点可以处理读请求，从而提高读请求性能。 | 表3备份管理API | 名称 | 版本 | URL | 功能描述 | |:---|:---|:---|:---| | [查看所有备份列表](https://support.huaweicloud.com/api-ges/ges_03_0361.html) | 1.0.0 | GET /v2/{project_id}/graphs/backups | 查看所有图的所有备份详情。 | | [查看某个图的备份列表](https://support.huaweicloud.com/api-ges/ges_03_0362.html) | 1.0.0 | GET /v2/{project_id}/graphs/{graph_id}/backups | 查看某个图下所有备份的详情，包括备份开始、结束时间等。 | | [新增备份](https://support.huaweicloud.com/api-ges/ges_03_0363.html) | 1.0.0 | POST /v2/{project_id}/graphs/{graph_id}/backups | 备份用于增加数据可靠性，同时可以作为一个图的快照，方便恢复到该快照。 | | [删除备份](https://support.huaweicloud.com/api-ges/ges_03_0364.html) | 1.0.0 | DELETE /v2/{project_id}/graphs/{graph_id}/backups/{backup_id} | 删除某个图的备份。 | | [导出备份](https://support.huaweicloud.com/api-ges/ges_03_0534.html) | 2.3.16 | POST /v2/{project_id}/graphs/{graph_id}/backups/export | 通过该API，您可以将GES图实例备份导出到OBS。 | | [导入备份](https://support.huaweicloud.com/api-ges/ges_03_0535.html) | 2.3.16 | POST /v2/{project_id}/graphs/{graph_id}/backups/import | 通过该API，您可以从OBS上的备份文件导入备份。 | 表4元数据管理API | 名称 | 版本 | URL | 功能描述 | |:---|:---|:---|:---| | [查询元数据列表](https://support.huaweicloud.com/api-ges/ges_03_0367.html) | 1.0.2 | GET /v2/{project_id}/graphs/metadatas | 查询所有元数据详情，包括状态、OBS存储路径。 | | [查询元数据](https://support.huaweicloud.com/api-ges/ges_03_0368.html) | 1.0.2 | GET /v2/{project_id}/graphs/metadatas/{metadata_id} | 查询某个元数据详情。 | | [新增元数据](https://support.huaweicloud.com/api-ges/ges_03_0369.html) | 2.1.18 | POST /v2/{project_id}/graphs/metadatas | 新增元数据为创建图之前的准备操作，用户必须先创建元数据才能创建图。 | | [删除元数据](https://support.huaweicloud.com/api-ges/ges_03_0370.html) | 1.0.2 | DELETE /v2/{project_id}/graphs/metadatas/{metadata_id} | 删除一个元数据。 | | [从OBS导入元数据](https://support.huaweicloud.com/api-ges/ges_03_0371.html) | 1.0.0 | POST /v2/{project_id}/graphs/metadata/upload-from-obs | 从OBS导入元数据。 | 表5任务中心API | 名称 | 版本 | URL | 功能描述 | |:---|:---|:---|:---| | [查询Job状态](https://support.huaweicloud.com/api-ges/ges_03_0373.html) | 1.0.0 | GET /v2/{project_id}/graphs/{graph_id}/jobs/{job_id}/status | 图删除、关闭、启动、恢复、增量导入、清空、升级等API为异步任务，API会返回jobId，可以通过该接口查看异步任务执行状态。 | | [查询任务中心](https://support.huaweicloud.com/api-ges/ges_03_0374.html) | 1.1.8 | GET /v2/{project_id}/graphs/jobs | 用户查看所有的异步任务。 | 表6GraphPlugins管理API | 名称 | 版本 | URL | 功能描述 | |:---|:---|:---|:---| | [查询获取场景应用分析插件](https://support.huaweicloud.com/api-ges/ges_03_0376.html) | 2.3.11 | GET /v2/{project_id}/graphs/scenes | 查询scenes场景下的应用分析能力详情，可以获得对应场景下的application、参数和功能介绍详情。 | | [订阅场景分析插件](https://support.huaweicloud.com/api-ges/ges_03_0377.html) | 2.3.11 | POST /v2/{project_id}/graphs/{graph_id}/scenes/register | 订阅scenes应用场景分析能力，便于业务面API使用对应功能。 | | [取消订阅场景分析插件](https://support.huaweicloud.com/api-ges/ges_03_0378.html) | 2.3.11 | POST /v2/{project_id}/graphs/{graph_id}/scenes/unregister | 取消订阅scenes场景应用分析能力，取消订阅后，对应scene下的application业务面API将不能使用。 |