华为云用户手册

URI POST /v1.0/{projectId}/graphs/{graphId}/action?action_id=import-graph 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID。获取方法请参见获取项目ID。 graph_id 是 String 图ID。 表2 Query参数 参数 是否必选 参数类型 描述 action_id 是 String 图actionId。 枚举值：import-graph

响应示例 状态码： 200 成功响应示例 Http Status Code: 200{ "result":"success", "data": { "edges": [ { "index": "7", "source": "46", "target": "39" }, { "index": "0", "source": "46", "target": "38" } ] }} 状态码： 400 失败响应示例 Http Status Code: 400{ "errorMessage":"edge source vertex [Lily] does not exist", "errorCode":"GES.8000"}

请求示例 批量添加点，待添加的顶点数组的点名称分别为150，6。 POSThttp://{SERVER_URL}/ges/v1.0/{project_id}/graphs/{graph_name}/vertices/action?action_id=batch-add{ "vertices": [ { "vertex": "150", "label": "movie", "properties": { "movieid": [ "150" ], "title": [ "testmoive" ], "genres": [ "Comedy" ] } }, { "vertex": "6", "label": "movie", "properties": { "movieid": [ "6" ], "title": [ "testmoive_exist_id" ], "genres": [ "Comedy" ] } } ], "overrideExists": true} SERVER_URL：图的访问地址，取值请参考业务面API使用限制。 样例中，假设“6”这个点已存在图中，则覆盖“6”这个点的属性。

请求参数 表2 Body参数说明 参数 是否必选 类型 说明 vertices 是 Array of String 待添加的顶点数组，一次最多添加1万个点。数组参数详见vertices参数说明。 overrideExists 否 Boolean 对vertices参数中已经存在的点是否采取覆盖写策略。默认值为“false”，会忽略已经存在的点，不做处理。 （但是图规格为持久化版规格的图，当点存在时，会报错）。 当值为“true”时，表示对vertices参数中已经存在的点采取覆盖写策略。 表3 vertices参数说明 参数 是否必选 类型 说明 vertex 是 String 点名称。 label 是 String 点的label。 properties 否 Object 各个属性的值。

响应示例 状态码： 200 OK { "id" : "ff8080815f9a3c84015f9a438ff70001", "name" : "movie_schema"} 状态码： 500 Internal Server Error { "errorCode" : "GES.2067", "errorMessage" : "name: 1 to 64 characters, only letters, digits, and underscores(_) are allowed."}

请求示例 POST https://Endpoint/v1.0/{project_id}/graphs/metadatas { "metadataPath": "gesdata/demo_movie/schema.xml", "name": "movie_schema", "description": "xxxxx", "isOverwrite": "true", "encryption":{ "enable":true, "masterKeyId":"2fc79d04-7010-4f63-9534-d8de74ab67e0" }, "gesMetadata": { "labels": [ { "name": "friends", "properties": null }, { "name": "movie", "properties": [ { "dataType": "string", "name": "ChineseTitle", "cardinality": "single" }, { "dataType": "int", "name": "Year", "cardinality": "single" }, { "dataType": "string", "name": "Genres", "cardinality": "set" } ] }, { "name": "user", "properties": [ { "dataType": "string", "name": "Name", "cardinality": "single" }, { "typeName1": "F", "typeName2": "M", "typeNameCount": "2", "dataType": "enum", "name": "Gender", "cardinality": "single" }, { "typeName1": "Under 18", "typeName2": "18-24", "typeName3": "25-34", "typeName4": "35-44", "typeNameCount": "7", "dataType": "enum", "name": "Age", "typeName5": "45-49", "typeName6": "50-55", "cardinality": "single", "typeName7": "56+" }, { "dataType": "string", "name": "Occupation", "cardinality": "single" }, { "dataType": "char array", "name": "Zip-code", "maxDataSize": "12", "cardinality": "single" } ] }, { "name": "rate", "properties": [ { "dataType": "int", "name": "Score", "cardinality": "single" }, { "dataType": "date", "name": "Datetime", "cardinality": "single" } ] } ] }}

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 用于获取操作API的权限。获取方法请参见 获取Token 接口，响应消息头中X-Subject-Token的值即为Token。 表3 请求Body参数 参数 是否必选 参数类型 描述 metadataPath 是 String 元数据存储地址。 name 是 String 元数据的名称，限制为1-64个字符，且只能包含字母，数字或下划线。 description 是 String 对元数据的描述信息。 isOverwrite 是 Boolean 是否覆盖文件。取值为true或false，默认值为false。 true表示覆盖文件。 false表示不覆盖文件。 gesMetadata 是 Object 存储metadata的消息信息的对象。

响应示例 状态码： 200 OK { "graphCount": 2, "graphs": [ { "id": "f1529b88-c958-493e-8452-fccfe932cde1", "name": "demo", "regionCode": "cn-north-1", "azCode": "cn-north-1a", "schemaPath": [ { "path": "ges-graphs/demo_movie/schema.xml", "jobId": "ff80808167bb90340167bc7445670428", "status": "success" } ], "edgesetPath": [ { "path": "ges-graphs/demo_movie/edge.csv", "jobId": "ff80808167bb90340167bc7445670428", "status": "success" } ], "vertexsetPath": [ { "path": "", "jobId": "ff80808167bb90340167bc7445670428", "status": "success" } ], "status": "200", "graphSizeTypeIndex": "1", "vpcId": "2d8af840-fd57-4e3b-a8f1-cda0f55ccd99", "subnetId": "dc018ec3-67d1-46c9-b2fc-19d83367f4e2", "securityGroupId": "11d27338-8649-4076-8579-5ebc1a60f79e", "created": "2018-07-23T04:09:44", "updated": "2018-07-23T04:09:44", "privateIp": "192.168.0.4", "publicIp": "49.4.81.183", "dataStoreVersion": "1.0.5", "arch": "x86_64", "enableFullTextIndex" : false }, { "id": "53205529-026b-455a-9e07-228fae4b12b9", "name": "ges_c5de", "regionCode": "cn-north-1", "azCode": "cn-north-1a", "schemaPath": [ { "path": "ges-graphs/demo_movie/schema.xml", "jobId": "ff80808167bb90340167bc7445670428", "status": "success" } ], "edgesetPath": [ { "path": "ges-graphs/demo_movie/edge.csv", "jobId": "ff80808167bb90340167bc7445670428", "status": "success" } ], "vertexsetPath": [ { "path": "", "jobId": "ff80808167bb90340167bc7445670428", "status": "success" } ], "status": "200", "graphSizeTypeIndex": "2", "vpcId": "2d8af840-fd57-4e3b-a8f1-cda0f55ccd99", "subnetId": "dc018ec3-67d1-46c9-b2fc-19d83367f4e2", "securityGroupId": "11d27338-8649-4076-8579-5ebc1a60f79e", "created": "2018-07-18T13:30:16", "updated": "2018-07-18T13:30:16", "privateIp": "192.168.0.168", "dataStoreVersion": "1.0.5", "arch": "aarch64", "enableFullTextIndex" : false } ]}

响应参数 同步返回 表10 响应Body参数说明 参数 类型 说明 errorMessage String 系统提示信息。 执行成功时，字段可能为空。 执行失败时，用于显示错误信息。 errorCode String 系统提示信息。 执行成功时，字段可能为空。 执行失败时，用于显示错误码。 data Object 查询结果。查询失败时，字段为空。 表11 data参数说明 参数 类型 说明 vertices List 点的结果集合。filters最后一层为点过滤时，data中将包含vertices。 edges List 边的结果集合。filters最后一层为边过滤时，data中将包含edges。 paths List 路径信息集合。with_path为true时可输出。格式见表12。 表12 path参数说明 参数 类型 说明 source String 源点ID。 target String 终点ID。 index String 边index。 label String 边label。 异步返回 表13 响应Body参数说明 参数 类型 说明 errorMessage String 系统提示信息。 执行成功时，字段可能为空。 执行失败时，用于显示错误信息。 errorCode String 系统提示信息。 执行成功时，字段可能为空。 执行失败时，用于显示错误码。 jobId String 执行算法任务ID。请求失败时，该字段为空。 jobType Integer 任务类型。请求失败时，该字段为空。

请求示例 （同步模式）列出满足过滤条件的第k跳节点或边，执行模式是同步，不进行可视化即查询job结果分页返回。 POST /ges/v1.0/{project_id}/graphs/{graph_name}/action?action_id=filtered-query{ "executionMode": "sync", "visulized": "false", "filters": [ { "operator": "outV" }, { "operator": "out", "edge_filter": { "property_filter": { "leftvalue": { "label_name": "labelName" }, "predicate": "=", "rightvalue": { "value": "rate" } } } } ], "full_path": false, "vertices": [ "tr_10" ]} （异步模式）列出满足过滤条件的第k跳节点或边，执行模式是异步，不进行可视化即查询job结果分页返回。 POST /ges/v1.0/{project_id}/graphs/{graph_name}/action?action_id=filtered-query{ "executionMode": "async", "visulized": "false", "filters": [ { "operator": "outV" }, { "operator": "out", "edge_filter": { "property_filter": { "leftvalue": { "label_name": "labelName" }, "predicate": "=", "rightvalue": { "value": "rate" } } } } ], "full_path": false, "vertices": [ "tr_10" ]} 嵌套property_filter，列出满足过滤条件的第k跳节点或边，执行模式是同步，不进行可视化即查询job结果分页返回。 POST /ges/v1.0/{project_id}/graphs/{graph_name}/action?action_id=filtered-query{ "executionMode": "sync", "filters": [ { "operator": "outV", "vertex_filter": { "property_filter": { "leftvalue": { "property_filter": { "leftvalue": { "property_name": "genres" }, "predicate": "PREFIX", "rightvalue": { "value": "A|" } } }, "predicate": "&", "rightvalue": { "property_filter": { "leftvalue": { "label_name": "labelName" }, "predicate": "=", "rightvalue": { "value": "movie" } } } } } } ], "vertices": [ "tr_3" ]}

响应示例 同步返回 状态码： 200 成功响应示例 Http Status Code: 200{ "data": { "edges": [ { "index": "1", "source": "tr_1", "label": "rate", "properties": { "Rating": [ 0 ], "Datetime": [ "" ] }, "target": "tr_3" }, ……, { "index": "199998", "source": "tr_1", "label": "rate", "properties": { "Rating": [ 0 ], "Datetime": [ "" ] }, "target": "tr_200000" } ] }} 状态码： 400 失败响应示例 Http Status Code: 400{ "errorMessage": "graph [tesdt_117] is not found", "errorCode": "GES.8806"}

请求示例 POST https://Endpoint/v1.0/{project_id}/graphs{ "graph":{ "name":"demo", "graphSizeTypeIndex": "1", "arch":"x86_64", "vpcId":"2d8af840-fd57-4e3b-a8f1-cda0f55ccd99", "subnetId":"dc018ec3-67d1-46c9-b2fc-19d83367f4e2", "securityGroupId":"11d27338-8649-4076-8579-5ebc1a60f79e", "publicIp":{ "publicBindType":"bind_existing", "eipId":"30ef2d58-08a9-4481-b526-b2cbe67d020d" }, "enableMultiAz":false, "sys_tags": [{"key": "_sys_enterprise_project_id", "value": "54c0b33c-8627-462f-948e-bae08c0887b4"}],"encryption":{ "enable":true, "masterKeyId":"b00b9356-73fb-4d49-8f79-f0a5da5354d1" }, "enableRBAC":false, "enableFullTextIndex" : false, "cryptAlgorithm": "generalCipher", "enableHttps": "false" }}

边中介中心度（edge_betweenness）(2.2.4) 表1 parameters参数说明 参数 是否必选 说明 类型 取值范围 默认值 directed 否 是否考虑边的方向 Boolean true或者false true weight 否 边上权重 String 空或字符串 * 空：边上的权重、距离默认为“1”。 * 字符串：对应的边上的属性将作为权重，当某边没有对应属性时，权重将默认为1。 说明： 边上权重应大于0。 - seeds 否 节点ID String 当图较大时，运行精确betweenness较慢，可以设置seeds作为采样节点，进行近似运算，seeds节点越多越接近精确解。输入节点个数不大于100000。 - k 否 采样个数 Integer 当图较大时，运行精确betweenness较慢，可以设置k，算法将从图中随机选取k各点，进行采样运算，k值越大约接近精确解。k不大于100000。 - 表2 response_data参数说明 参数 类型 说明 edge_betweenness List 各边的betweenness值，格式： [{“source”: sourceId, “target”: targetId , “index”: indexValue , “betweenness”: betweennessValue },...]，其中： betweennessValue：double类型 父主题： 算法API参数参考

请求 参数说明 表1 parameters参数说明 参数 是否必选 类型 说明 source 是 String 输入路径的起点ID。 target 是 String 输入路径的终点ID。 directed 否 Boolean 是否考虑边的方向。默认值为“false”。 num_thread 否 Integer 并发线程数。范围为[1,40]，小于“1”会自动置为“1”，大于“40”则自动置为“40”。默认值为“4”。 请求样例 同步 { "executionMode": "sync", "algorithmName": "filtered_shortest_path", "edge_filter": { "property_filter": { "leftvalue": { "label_name": "labelName" }, "predicate": "IN", "rightvalue": { "value": [ "xxx", "rate" ] } } }, "vertex_filter": { "property_filter": { "leftvalue": { "property_name": "title" }, "predicate": "PREFIX", "rightvalue": { "value": "tr_" } } }, "parameters": { "source": "tr_1", "target": "tr_117", "directed": true }} 异步 { "executionMode": "async", "algorithmName": "filtered_shortest_path", "edge_filter": { "property_filter": { "leftvalue": { "label_name": "labelName" }, "predicate": "IN", "rightvalue": { "value": [ "xxx", "rate" ] } } }, "vertex_filter": { "property_filter": { "leftvalue": { "property_name": "title" }, "predicate": "PREFIX", "rightvalue": { "value": "tr_" } } }, "parameters": { "source": "tr_1", "target": "tr_117", "directed": true }}

响应 同步参数说明 表2 response_data参数说明 参数 是否必选 类型 说明 path 是 List 点的结果集合。filters最后一层为点过滤时，data中将包含vertices。 source 是 String 源节点ID。 target 是 String 目标节点ID。 runtime 是 Double 算法运行时间 。 响应样例 同步成功响应样例 { "data": { "outputs": { "path": [ "tr_1", "tr_5", "tr_26", "tr_117" ], "runtime": 0.735766, "source": "tr_1", "target": "tr_117" } }} 同步失败响应样例 {"errorMessage": "graph [tesdt_117] is not found","errorCode": "GES.8402"}

中介中心度算法（betweenness）(2.2.4) 表1 parameters参数说明 参数 是否必选 说明 类型 取值范围 默认值 directed 否 是否考虑边的方向 Boolean true或者false true weight 否 边上权重 String 空或字符串 * 空：边上的权重、距离默认为“1”。 * 字符串：对应的边上的属性将作为权重，当某边没有对应属性时，权重将默认为1。 说明： 边上权重应大于0。 - seeds 否 节点ID String 当图较大时，运行精确betweenness较慢，可以设置seeds作为采样节点，进行近似运算，seeds节点越多越接近精确解。输入节点个数不大于100000。 - k 否 采样个数 Integer 当图较大时，运行精确betweenness较慢，可以设置k，算法将从图中随机选取k各点，进行采样运算，k值越大约接近精确解。k不大于100000。 - 表2 response_data参数说明 参数 类型 说明 betweenness List 各节点的betweenness值，格式： [{vertexId: betweennessValue},...], 其中： vertexId：string类型 betweennessValue：double类型 父主题： 算法API参数参考

OD中介中心度（od_betweenness）（2.2.4） 表1 parameters参数说明 参数 是否必选 说明 类型 取值范围 默认值 directed 否 是否考虑边的方向 Boolean true或者false true weight 否 边上权重 String 空或字符串 * 空：边上的权重、距离默认为“1”。 * 字符串：对应的边上的属性将作为权重，当某边没有对应属性时，权重将默认为1。 说明： 边上权重应大于0。 - OD 否 起点终点对 String 标准csv格式，起点和终点以英文逗号分隔，各起点和终点对之间以换行符“\n”分隔，例如：“Alice,Nana\nLily,Amy”。 - seeds 否 热点事件发生地的节点ID String 当未知OD数据时，输入seeds数据。 - modes 否 与seeds对应的热点事件类别 String IN： 表示以热点事件发生地点的节点ID作为起点 。 OUT：表示以热点事件发生地点的节点ID作为终点。 - capacity 否 与seeds对应的热点事件参加人数 Integer - - 表2 response_data参数说明 参数 类型 说明 betweenness List 各边的betweenness值，格式： [{“source”: sourceId, “target”: targetId , “index”: indexValue , “betweenness”: betweennessValue },...]，其中： betweennessValue：double类型 父主题： 算法API参数参考

响应参数 表5 响应Body参数说明 参数 类型 说明 errorMessage String 系统提示信息。 执行成功时，字段可能为空。 执行失败时，用于显示错误信息。 errorCode String 系统提示信息。 执行成功时，字段可能为空。 执行失败时，用于显示错误码。 jobId String 查询边任务ID。 说明： 可以查询jobId查看任务执行状态、获取返回结果，详情参考Job管理API。 jobType Integer 任务类型。请求失败时，字段为空。

点集共同邻居(common_neighbors_of_vertex_sets)(2.2.13) 表1 parameters参数说明 参数 是否必选 说明 类型 取值范围 默认值 sources（2.2.6） 是 起点ID集合 String 标准csv格式，ID之间以英文逗号分隔，例如：“Alice,Nana”。 个数不大于100000。 - targets（2.2.6） 是 终点ID集合 String 标准csv格式，ID之间以英文逗号分隔，例如：“Mike,Amy”。 个数不大于100000。 - restricted（2.2.13） 否 是否带其他约束 Boolean true或false。 false：不带额外约束，即找到的共同邻居为起点集和终点集对应邻域的交集。 true，带额外约束，这里指找到的共同邻居不仅是起点集和终点集邻域的交集，同时共同邻居集合中的每个点都至少有2个以上邻居节点在起点集和终点集中。 true 表2 response_data参数说明 参数 类型 说明 vertices List 公共邻居节点，格式： [vertexId,...], 其中, vertexId：string类型 common_neighbors Integer 公共邻居节点个数。 父主题： 算法API参数参考

响应示例 状态码： 200 成功响应示例 Http Status Code: 200{ "jobId": "b4f2e9a0-0439-4edd-a3ad-199bb523b613"} 状态码： 400 失败响应示例 Http Status Code: 400{ "errorMessage": "parameter format error", "errorCode": "GES.8013"}

请求示例 导入文件更新点边的指定属性，点文件目录为datasets/movie/movie.csv，点数据集格式为csv，边文件目录为datasets/movie/ranking_edge.csv，边数据集格式为csv。 POST http://Endpoint/ges/v1.0/{project_id}/graphs/{graph_name}/action?action_id=import-properties{ "vertexsetPath": "datasets/movie/movie.csv", "vertexsetFormat": "csv", "vertexProperties": [ { "label": "movie", "properties": [ "genres" ] } ], "edgesetPath": "datasets/movie/ranking_edge.csv", "edgesetFormat": "csv", "edgeProperties": [ { "label": "rate", "properties": [ "Datetime" ] } ], "targetProperties": [ { "label": "rate", "properties": [ "Rating" ] } ], "delimiter": ",", "trimQuote": "\"", "obsParameters": {"accessKey": "XXXXXXX","secretKey": "XXXXXXX" }, "vertexFileContainLabel": true}

响应参数 表6 响应Body参数说明 参数 类型 说明 errorMessage String 系统提示信息。 执行成功时，字段可能为空。 执行失败时，用于显示错误信息。 errorCode String 系统提示信息。 执行成功时，字段可能为空。 执行失败时，用于显示错误码。 jobId String 执行该异步任务的jobId。 说明： 可以查询jobId查看任务执行状态、获取返回结果，详情参考Job管理API。

请求参数 导入文件更新属性的csv文件格式如下： 点文件（包含label）：点ID,label,property_1,…property_n 点文件（不包含label）：点ID,property_1,…property_n 边文件：源点ID,目的点ID,label,边ID属性,property_1,…property_n 表2 Body参数说明 参数 是否必选 类型 说明 vertexsetPath vertexsetPath和edgesetPath至少有一个 String 点文件目录或点文件名。 vertexsetFormat 否 String 点数据集格式。当前仅支持csv。 默认为csv。 vertexProperties 有vertexsetPath则必选 Object 点文件中点的label和待更新属性列表信息，JsonArray格式。 edgesetPath vertexsetPath和edgesetPath至少有一个 String 边文件目录或边文件名。 edgesetFormat 否 String 边数据集格式。当前仅支持csv。 默认为csv。 edgeProperties 有edgesetPath则必选 Object 边文件中边的label和待更新属性列表信息，JsonArray格式。 targetProperties 有edgesetPath则必选 Object 边文件中用于区分重复边的属性信息，JsonArray格式。 delimiter 否 Character csv格式文件字段分隔符，默认值为逗号（,）。list/set类型的字段内元素分隔符默认为分号（;）。 trimQuote 否 Character csv格式文件字段包围符，默认值为双引号（"）。用来包围一个字段，如字段中含有分隔符或者换行等。 obsParameters 是 String OBS认证参数。请参见表 obsParameters参数说明。 vertexFileContainLabel 否 Boolean 点文件是否包含label信息。可选选项，默认值是true。 表3 vertexProperties参数说明 参数 是否必选 类型 说明 label 是 String label名称。 properties 是 Object 待更新属性列表，需要与点文件中属性顺序一致，JsonArray格式。 表4 edgeProperties参数说明 参数 是否必选 类型 说明 label 是 String label名称。 properties 是 Object 待更新属性列表，需要与边文件中属性顺序一致，JsonArray格式。 表5 targetProperties参数说明 参数 是否必选 类型 说明 label 是 String label名称。 properties 是 Object 边ID属性信息，JsonArray格式。当前仅支持一个属性

请求示例 （仅支持异步模式）导出满足过滤条件的顶点集合，导出路径为demo_movie/，导出文件名export_movie_and_user.csv。 POST https://{SERVER_URL}/ges/v1.0/{project_id}/graphs/{graph_name}/vertices/action?action_id=export {"labels": ["movies","user"],"vertexFilters": [{"propertyName": "Age","predicate": "=","values": ["18-24"]}],"exportPath": "demo_movie/","fileName": "export_movie_and_user.csv","obsParameters": {"accessKey": "XXXX","secretKey": "XXXX"} }

响应参数 表6 响应Body参数 参数 类型 说明 errorMessage String 系统提示信息。 执行成功时，字段可能为空。 执行失败时，用于显示错误信息。 errorCode String 系统提示信息。 执行成功时，字段可能为空。 执行失败时，用于显示错误码。 jobId String 查询边任务ID。 说明： 可以查询jobId查看任务执行状态、获取返回结果，详情参考Job管理API。 jobType String 执行该异步任务的jobType。

响应参数 表2 响应Body参数说明 参数 类型 说明 errorMessage String 系统提示信息。 执行成功时，字段可能为空。 执行失败时，用于显示错误信息。 errorCode String 系统提示信息。 执行成功时，字段可能为空。 执行失败时，用于显示错误码。 result String 查询成功时值为success,失败时值为failed。 jobs Object 查询成功时包含jobs字段，jobs字段中包含系统中保存的job状态列表，单个job的状态结构如表3。 表3 job状态结构 参数 类型 说明 jobId String Job名称。 request Object 请求内容，包括command、url和body体。 status String Job执行状态，取值为pending/running/complete。

响应示例 状态码： 200 成功响应示例（持久化版） Http Status Code: 200 { "jobs": [ { "jobId": "62582163123991943683d0f9aa3-f701-48be-a662-360e6a0455da", "status": "complete", "request": { "command": "import_graph", "url": "/ges/v1.0/10001/graphs/moviejx/action?action_id=import-graph", "body": { "edgesetPath": "file:///root/ges-install/auDatas/ranking_edge-sp.csv", "vertexsetPath": "file:///root/ges-install/auDatas/movies_vertex_new.csv", "schemaPath": "file:///root/ges-install/auDatas/schema_aikv.xml.bak" } } }, { "jobId": "62582163123991943683fe74caf-f4d3-48b3-b3ee-66daaedcd2ca", "status": "complete", "request": { "command": "import_graph", "url": "/ges/v1.0/10001/graphs/moviejx/action?action_id=import-graph", "body": { "edgesetPath": "file:///root/ges-install/auDatas/ranking_edge-sp.csv", "vertexsetPath": "file:///root/ges-install/auDatas/movies_vertex_new.csv", "schemaPath": "file:///root/ges-install/auDatas/schema_aikv.xml.bak" } } }, { "jobId": "6258216312399194368daa80df3-e3bd-440d-9764-74f4622a550f", "status": "complete", "request": { "command": "import_graph", "url": "/ges/v1.0/10001/graphs/moviejx/action?action_id=import-graph", "body": { "edgesetPath": "file:///root/ges-install/auDatas/ranking_edge-sp.csv", "vertexsetPath": "file:///root/ges-install/auDatas/movies_vertex_new.csv", "schemaPath": "file:///root/ges-install/auDatas/schema_aikv.xml.bak" } } }, { "jobId": "62582163123991943680ed2761f-01f7-4fbf-b867-0a9aae6d9c12", "status": "complete", "request": { "command": "import_graph", "url": "/ges/v1.0/10001/graphs/moviejx/action?action_id=import-graph", "body": { "edgesetPath": "file:///root/ges-install/auDatas/ranking_edge-sp.csv", "vertexsetPath": "file:///root/ges-install/auDatas/movies_vertex_new.csv", "schemaPath": "file:///root/ges-install/auDatas/schema_aikv.xml.bak" } } } ], "result": "success"} 状态码： 400 失败响应示例（持久化版） Http Status Code: 400 { "errorMessage": "graph : movidde not exist", "errorCode": "GES.8000", "result": "failed"}

URI GET /ges/v1.0/{project_id}/graphs/{graph_name}/jobs/status?limit={limit}&offset={offset} 表1 路径参数 参数 是否必选 类型 说明 project_id 是 String 项目ID。获取方法请参见获取项目ID。 offset 否 Integer 本次查询偏移量，默认为0。 图规格为持久化版的图，暂不支持该参数。 job_id 是 String Response对应的任务Job ID。 limit 否 Integer 本次查询返回最大数量(最大100000)，默认为100000。 图规格为持久化版的图，暂不支持该参数。

点集全最短路(all_shortest_paths_of_vertex_sets)(2.2.15) 表1 parameters参数说明 参数 是否必选 说明 类型 取值范围 默认值 sources 是 起点ID集合 String 标准csv格式，ID之间以英文逗号分隔，例如：“Alice,Nana”。 个数不大于100000。 - targets 是 终点ID集合 String 标准csv格式，ID之间以英文逗号分隔，例如：“Alice,Nana”。 个数不大于100000。 - directed 否 是否考虑边的方向 Boolean true 或false，布尔型。 false 表2 response_data参数说明 参数 类型 说明 paths List source节点和target节点之间所有的最短路径，格式： [[path1],[path2]] 其中，路径（path）的格式可参考：最短路径（Shortest Path）。 source String 路径的起点ID。 target String 路径的终点ID。 父主题： 算法API参数参考

参数说明 表1 parameters参数说明 参数 是否必选 说明 类型 取值范围 默认值 sources 否 查询的起始节点ID集合 String - 标准csv格式，ID之间以英文逗号分隔，例如:“Alice,Nana” n 否 枚举的满足过滤条件的圈的个数的上限 Integer [1,100000] 100 statistics 否 是否输出所有满足过滤条件的圈的个数 Boolean true或false false batch_number 否 批量处理的起始节点的个数 Integer [1,1000] 10 output_format 否 输出结果的格式 String vertexId,edgeId或edgeObject edgeObject filters 是 过滤条件列表，数组的每个元素分别对应每一层要做的查询和过滤条件。 Object - -