云服务器内容精选

  • 点集全最短路(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参数参考
  • 响应示例 状态码: 200 成功响应示例 Http Status Code: 200{ "jobId": "f9987cab-64d3-4b3d-ac43-e91ae0c21bef168127124", "jobType": 0} 状态码: 400 失败响应示例 Http Status Code: 400{ "errorMessage": "Bad Request, parameter labels and edgeFilters cannot all be null", "errorCode": "GES.8103"}
  • 响应参数 表2 响应Body参数 参数 类型 说明 errorMessage String 系统提示信息。 执行成功时,字段可能为空。 执行失败时,用于显示错误信息。 errorCode String 系统提示信息。 执行成功时,字段可能为空。 执行失败时,用于显示错误码。 jobId String 查询边任务ID。 说明: 可以查询jobId查看任务执行状态、获取返回结果,详情参考Job管理API。 jobType String 执行该异步任务的jobType。
  • 响应示例 状态码: 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 } ]}
  • 请求示例 (仅支持异步模式)导出满足过滤条件的点集合,导出路径为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"} }
  • 响应参数 表5 响应Body参数 参数 类型 说明 errorMessage String 系统提示信息。 执行成功时,字段可能为空。 执行失败时,用于显示错误信息。 errorCode String 系统提示信息。 执行成功时,字段可能为空。 执行失败时,用于显示错误码。 jobId String 查询边任务ID。 说明: 可以查询jobId查看任务执行状态、获取返回结果,详情参考Job管理API。
  • 响应示例 状态码: 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."}
  • 请求参数 表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的消息信息的对象。
  • 请求示例 POST https://Endpoint/v1.0/{project_id}/graphs/metadatas { "metadataPath": "gesdata/demo_movie/schema.xml", "name": "movie_schema", "description": "xxxxx", "isOverwrite": "true", "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 Body参数说明 参数 是否必选 类型 说明 vertices 是 Json 待添加的点数组,一次最多添加1万个点。数组参数详见vertices参数说明。 overrideExists 否 Boolean 对vertices参数中已经存在的点是否采取覆盖写策略。默认值为false。 当值为false时,会忽略已经存在的点,不做处理。 当值为true时,对vertices参数中已经存在的点采取覆盖写策略。 表3 vertices参数说明 参数 是否必选 类型 说明 vertex 是 String 点ID。 label 是 String 点的label。 properties 否 Json 各个属性的值。
  • 请求示例 批量添加点,待添加的点数组的点名称分别为150,6。 POST http://{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”这个点的属性。
  • 请求示例 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"}], "enableRBAC":false, "enableFullTextIndex" : false, "cryptAlgorithm": "generalCipher", "enableHttps": "false" }}
  • 响应参数 表7 响应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格式。请参见表3。 edgesetPath vertexsetPath和edgesetPath至少有一个 String 边文件目录或边文件名。 edgesetFormat 否 String 边数据集格式。当前仅支持csv。 默认为csv。 edgeProperties 有edgesetPath则必选 Object 边文件中边的label和待更新属性列表信息,JsonArray格式。请参见表4。 targetProperties 有edgesetPath则必选 Object 边文件中用于区分重复边的属性信息,JsonArray格式。请参见表5。 delimiter 否 Character csv格式文件字段分隔符,默认值为逗号(,)。list/set类型的字段内元素分隔符默认为分号(;)。 trimQuote 否 Character csv格式文件字段包围符,默认值为双引号(")。用来包围一个字段,如字段中含有分隔符或者换行等。 obsParameters 是 String OBS认证参数。请参见表6。 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格式。当前仅支持一个属性 表6 obsParameters参数说明 参数 是否必选 类型 说明 accessKey 是 string ak值。 secretKey 是 string sk值。
  • 响应示例 状态码: 200 成功响应示例 Http Status Code: 200{ "jobId": "b4f2e9a0-0439-4edd-a3ad-199bb523b613"} 状态码: 400 失败响应示例 Http Status Code: 400{ "errorMessage": "parameter format error", "errorCode": "GES.8013"}