# 内存版 内存版业务面API包括点操作、边操作、元数据操作、索引操作、Gremlin操作、算法、路径、图统计、图操作、子图操作、Job管理、Cypher操作API。 表1点操作API | 名称 | 版本 | URL | 功能描述 | |:---|:---|:---|:---| | [点过滤查询](https://support.huaweicloud.com/api-ges/ges_03_0023.html) | 1.0.0 | POST /ges/v1.0/{project_id}/graphs/{graph_name}/vertices/action?action_id=query | 根据某个过滤条件查询点，比如点元数据中含有age属性，过滤条件可以为age\>18。 | | [查询点详情](https://support.huaweicloud.com/api-ges/ges_03_0025.html) | 1.0.0 | GET /ges/v1.0/{project_id}/graphs/{graph_name}/vertices/detail?vertexIds={vertex_ids} | 给定一个点或者一组点的集合，查询这些点的详情，包括Label信息。 | | [添加点](https://support.huaweicloud.com/api-ges/ges_03_0052.html) | 1.0.6 | POST /ges/v1.0/{project_id}/graphs/{graph_name}/vertices | 添加一个点。 | | [删除点](https://support.huaweicloud.com/api-ges/ges_03_0053.html) | 1.0.6 | DELETE /ges/v1.0/{project_id}/graphs/{graph_name}/vertices/{vertex_id} | 删除一个点。 | | [更新点属性](https://support.huaweicloud.com/api-ges/ges_03_0097.html) | 1.1.6 | POST /ges/v1.0/{project_id}/graphs/{graph_name}/vertices/{vertex_id}/properties/action?action_id={actionId} | 对点属性进行修改，包括新增、修改和删除。 | | [批量点查询](https://support.huaweicloud.com/api-ges/ges_03_0106.html) | 1.1.9 | POST /ges/v1.0/{project_id}/graphs/{graph_name}/vertices/action?action_id=batch-query | 批量查询点的详情。 | | [批量添加点](https://support.huaweicloud.com/api-ges/ges_03_0163.html) | 2.1.16 | POST /ges/v1.0/{project_id}/graphs/{graph_name}/vertices/action?action_id=batch-add | 批量添加点的操作。 | | [批量删除点](https://support.huaweicloud.com/api-ges/ges_03_0152.html) | 2.1.9 | POST /ges/v1.0/{project_id}/graphs/{graph_name}/vertices/action?action_id=batch-delete | 根据批量节点ID删除节点。 | | [批量更新点属性](https://support.huaweicloud.com/api-ges/ges_03_0153.html) | 2.1.10 | POST /ges/v1.0/{project_id}/graphs/{graph_name}/vertices/properties/action?action_id={actionId} | 批量更新点的属性。 | | [添加点label](https://support.huaweicloud.com/api-ges/ges_03_0099.html) | 1.1.6 | POST /ges/v1.0/{project_id}/graphs/{graph_name}/vertices/{vertex_id}/labels | 添加点的标签。 | | [删除点label](https://support.huaweicloud.com/api-ges/ges_03_0100.html) | 1.1.6 | DELETE /ges/v1.0/{project_id}/graphs/{graph_name}/vertices/{vertex_id}/labels/{label_name} | 删除点的标签。 | | [导出过滤后的点](https://support.huaweicloud.com/api-ges/ges_03_0189.html) | 2.2.7 | POST /ges/v1.0/{project_id}/graphs/{graph_name}/vertices/action?action_id=export | 导出满足过滤条件的点集合。 | | [删除过滤后的点](https://support.huaweicloud.com/api-ges/ges_03_0210.html) | 2.2.7 | POST /ges/v1.0/{project_id}/graphs/{graph_name}/vertices/action?action_id=delete | 删除满足过滤条件的点集合。 | 表2边操作API | 名称 | 版本 | URL | 功能描述 | |:---|:---|:---|:---| | [边过滤查询](https://support.huaweicloud.com/api-ges/ges_03_0024.html) | 1.0.0 | POST /ges/v1.0/{project_id}/graphs/{graph_name}/edges/action?action_id=query | 根据边的属性上的过滤条件进行过滤，查询符合过滤条件的边。 | | [查询边详情](https://support.huaweicloud.com/api-ges/ges_03_0026.html) | 1.0.0 | GET /ges/v1.0/{project_id}/graphs/{graph_name}/edges/detail?source={sourceVertex}\&target={targetVertex}\&index={index} | 根据边的起点、终点以及索引，查询边的详细信息，返回边上的标签和属性等。 | | [添加边](https://support.huaweicloud.com/api-ges/ges_03_0127.html) | 1.0.6 | POST /ges/v1.0/{project_id}/graphs/{graph_name}/edges | 添加一条边。 | | [删除边](https://support.huaweicloud.com/api-ges/ges_03_0055.html) | 1.0.6 | DELETE /ges/v1.0/{project_id}/graphs/{graph_name}/edges?source*={sourceVertex}* \&target*={targetVertex}* \&index=*{index}* | 删除一条边。 | | [更新边属性](https://support.huaweicloud.com/api-ges/ges_03_0098.html) | 1.1.6 | POST /ges/v1.0/{project_id}/graphs/{graph_name}/edges/properties/action?action_id={actionId}\&source={sourceVertex}\&target={targetVertex}\&index={index} | 对边属性进行修改，包括新增、修改和删除。 | | [批量边查询](https://support.huaweicloud.com/api-ges/ges_03_0107.html) | 1.1.6 | POST /ges/v1.0/{project_id}/graphs/{graph_name}/edges/action?action_id=batch-query | 批量查询边的详情。 | | [批量添加边](https://support.huaweicloud.com/api-ges/ges_03_0164.html) | 2.1.16 | POST /ges/v1.0/{project_id}/graphs/{graph_name}/edges/action?action_id=batch-add | 批量添加边的操作。 | | [批量删除边](https://support.huaweicloud.com/api-ges/ges_03_0155.html) | 2.1.9 | POST /ges/v1.0/{project_id}/graphs/{graph_name}/edges/action?action_id=batch-delete | 根据批量边的起点、终点以及索引，删除这些边。 | | [批量更新边属性](https://support.huaweicloud.com/api-ges/ges_03_0156.html) | 2.1.10 | POST /ges/v1.0/{project_id}/graphs/{graph_name}/edges/properties/action?action_id={actionId} | 批量更新边属性。 | | [导出过滤后的边](https://support.huaweicloud.com/api-ges/ges_03_0201.html) | .2.2.7 | POST /ges/v1.0/{project_id}/graphs/{graph_name}/edges/action?action_id=export | 导出满足过滤条件的边集合。 | | [删除过滤后的边](https://support.huaweicloud.com/api-ges/ges_03_0202.html) | 2.2.7 | POST /ges/v1.0/{project_id}/graphs/{graph_name}/edges/action?action_id=delete | 删除满足过滤条件的边集合。 | 表3元数据操作API | 名称 | 版本 | URL | 功能描述 | |:---|:---|:---|:---| | [添加label](https://support.huaweicloud.com/api-ges/ges_03_0056.html) | 1.1.6 | POST /ges/v1.0/{project_id}/graphs/{graph_name}/schema/labels | 添加label。 | | [更新label](https://support.huaweicloud.com/api-ges/ges_03_0141.html) | 1.1.7 | POST /ges/v1.0/{project_id}/graphs/{graph_name}/schema/labels/{label_name}/properties | 更新label。 | | [查询图元数据详情](https://support.huaweicloud.com/api-ges/ges_03_0027.html) | 1.0.0 | GET /ges/v1.0/{project_id}/graphs/{graph_name}/schema | 查询元数据详情。 | | [删除label](https://support.huaweicloud.com/api-ges/ges_03_0218.html) | 2.2.18 | DELETE /ges/v1.0/{project_id}/graphs/{graph_name}/schema/labels/{labelName} | 删除label，同时删除该label相关的点、边。 | | [批量添加label](https://support.huaweicloud.com/api-ges/ges_03_0219.html) | 2.2.21 | POST /ges/v1.0/{project_id}/graphs/{graph_name}/schema/labels/action?action_id=batch-add | 批量添加label。 | 表4索引操作API | 名称 | 版本 | URL | 功能描述 | |:---|:---|:---|:---| | [新建索引](https://support.huaweicloud.com/api-ges/ges_03_0057.html) | 1.1.6 | POST /ges/v1.0/{project_id}/graphs/{graph_name}/indices | 新建索引。 | | [删除索引](https://support.huaweicloud.com/api-ges/ges_03_0058.html) | 1.1.6 | DELETE /ges/v1.0/{project_id}/graphs/{graph_name}/indices/{indexName} | 删除索引。 | | [查询索引](https://support.huaweicloud.com/api-ges/ges_03_0059.html) | 1.1.6 | GET /ges/v1.0/{project_id}/graphs/{graph_name}/indices | 查询索引。 | 表5Gremlin操作API | 名称 | 版本 | URL | 功能描述 | |:---|:---|:---|:---| | [执行Gremlin查询](https://support.huaweicloud.com/api-ges/ges_03_0029.html) | 1.0.0 | POST /ges/v1.0/{project_id}/graphs/{graph_name}/action?action_id=execute-gremlin-query | 执行Gremlin查询。 | 表6算法API | 名称 | 版本 | URL | 功能描述 | |:---|:---|:---|:---| | [执行算法](https://support.huaweicloud.com/api-ges/ges_03_0030.html) | 1.0.0 | POST /ges/v1.0/{project_id}/graphs/{graph_name}/action?action_id=execute-algorithm | 执行算法。 | 表7动态图分析API | 名称 | 版本 | URL | 功能描述 | |:---|:---|:---|:---| | [动态群体演化（temporal_graph)](https://support.huaweicloud.com/api-ges/ges_03_0380.html) | 2.3.9 | POST /ges/v1.0/{project_id}/graphs/{graph_name}/dynamicgraphs/action?action_id=execute-analysis | 针对包含某些节点的群体，结合时间轴观察其结构的动态演化过程 。 | | [动态拓展（temporal_bfs）](https://support.huaweicloud.com/api-ges/ges_03_0381.html) | 2.3.9 | POST /ges/v1.0/{project_id}/graphs/{graph_name}/dynamicgraphs/action?action_id=execute-analysis | 指定某个起始节点id，结合消息传递时间递增和BFS遍历顺序（Temporal BFS算法），搜索周围与之相关联的点，输出对应各节点的到达时间，以及与源起点之间的距离。 | | [时序路径分析（Temporal Paths）](https://support.huaweicloud.com/api-ges/ges_03_0383.html) | 2.3.9 | POST /ges/v1.0/{project_id}/graphs/{graph_name}/dynamicgraphs/action?action_id=execute-analysis | 根据输入参数，执行时序路径分析算法。两点之间仅返回一条满足条件的时序路径。 | 表8路径API | 名称 | 版本 | URL | 功能描述 | |:---|:---|:---|:---| | [查询路径详情](https://support.huaweicloud.com/api-ges/ges_03_0044.html) | 1.1.6 | POST /ges/v1.0/{project_id}/graphs/{graph_name}/paths/action?action_id=query-detail | 查询路径详情。 | 表9图统计API | 名称 | 版本 | URL | 功能描述 | |:---|:---|:---|:---| | [查询图概要信息](https://support.huaweicloud.com/api-ges/ges_03_0028.html) | 1.0.0 | GET /ges/v1.0/{project_id}/graphs/{graph_name}/summary | 查询图概要信息。 | | [查询图版本](https://support.huaweicloud.com/api-ges/ges_03_0122.html) | 2.0.0 | GET /ges/v1.0/{project_id}/graphs/{graph_name}/version | 查询图版本。 | 表10图操作API | 名称 | 版本 | URL | 功能描述 | |:---|:---|:---|:---| | [导入图](https://support.huaweicloud.com/api-ges/ges_03_0228.html) | 2.1.14 | POST /ges/v1.0/{project_id}/graphs/{graph_name}/action?action_id= import-graph | 导入图数据 。 | | [导出图](https://support.huaweicloud.com/api-ges/ges_03_0229.html) | 1.0.5 | POST /ges/v1.0/{project_id}/graphs/{graph_name}/action?action_id=export-graph | 导出图数据。 | | [清空图](https://support.huaweicloud.com/api-ges/ges_03_0230.html) | 2.1.2 | POST /ges/v1.0/{project_id}/graphs/{graph_name}/action?action_id=clear-graph | 清空图数据。 | 表11子图操作API | 名称 | 版本 | URL | 功能描述 | |:---|:---|:---|:---| | [子图查询](https://support.huaweicloud.com/api-ges/ges_03_0159.html) | 2.1.13 | POST /ges/v1.0/{project_id}/graphs/{graph_name}/subgraphs/action?action_id=query | 查询输入的节点和它们之间所有边所构成的子图。 | | [执行子图算法](https://support.huaweicloud.com/api-ges/ges_03_0240.html) | 2.1.13 | POST /ges/v1.0/{project_id}/graphs/{graph_name}/subgraphs/action?action_id=execute-algorithm | 根据输入调整子图生成方式，在生成的子图上，执行特定算法。 | 表12Job管理API | 名称 | 版本 | URL | 功能描述 | |:---|:---|:---|:---| | [查询Job状态](https://support.huaweicloud.com/api-ges/ges_03_0037.html) | 1.0.0 | GET /ges/v1.0/{project_id}/graphs/{graph_name}/jobs/{job_id}/status?offset=*offset* \&limit=*limit* | 查询Job状态。 | | [取消Job](https://support.huaweicloud.com/api-ges/ges_03_0038.html) | 1.0.0 | DELETE https://{Endpoint}/ges/v1.0/{project_id}/graphs/{graph_name}/jobs/{job_id} | 取消Job。 | | [导出job返回结果到文件](https://support.huaweicloud.com/api-ges/ges_03_0172.html) | 2.2.1 | POST /ges/v1.0/{project_id}/graphs/{graph_name}/jobs/{job_id}/action?action_id=export-result | 用于将异步任务（job_id）的执行结果（result）导出到文件。 | | [查询job列表](https://support.huaweicloud.com/api-ges/ges_03_0204.html) | 2.2.13 | GET /ges/v1.0/{project_id}/graphs/{graph_name}/jobs/status?limit={limit}\&offset={offset} | 异步任务jobId返回后，若jobId业务层丢失无法通过接口重新获取，现在提供一个新的接口用于查询engine中保存的所有异步任务，返回每个任务的jobId、job状态、原始请求。 | 表13自定义操作API | 名称 | 版本 | URL | 功能描述 | |:---|:---|:---|:---| | [执行自定义操作](https://support.huaweicloud.com/api-ges/ges_03_0329.html) | 2.3.6 | POST /ges/v1.0/{project_id}/graphs/{graph_name}/action?action_id=execute-operation | 查询Job状态。 | 表14其他业务面API | 名称 | 版本 | URL | 功能描述 | |:---|:---|:---|:---| | [Filtered-query API](https://support.huaweicloud.com/api-ges/ges_03_0175.html) | 2.2.15 | POST /ges/v1.0/{project_id}/graphs/{graph_name}/action?action_id=filtered-query | 对k跳过程进行逐层过滤，列出满足过滤条件的第k跳节点或边。 | | [通过导入文件更新点边的指定属性](https://support.huaweicloud.com/api-ges/ges_03_0203.html) | 2.2.13 | POST /v1.0/{project_id}/graphs/{graph_name}/action?action_id=import-properties | 通过导入文件更新点边的指定属性。 | | [通过读取文件删除点边](https://support.huaweicloud.com/api-ges/ges_03_0209.html) | 2.2.15 | POST /v1.0/{project_id}/graphs/{graph_name}/action?action_id=delete-by-file | 通过读取文件删除点边。 | | [Cypher操作API](https://support.huaweicloud.com/api-ges/ges_03_0212.html) | 2.2.16 | POST /ges/v1.0/{project_id}/graphs/{graph_name}/action?action_id=execute-cypher-query | 使用Cypher语句可以查询GES中的数据，并返回结果 |