云服务器内容精选

  • 响应参数 表4 响应Body参数 参数 类型 说明 errorMessage String 系统提示信息。 执行成功时,字段可能为空。 执行失败时,用于显示错误信息。 errorCode String 系统提示信息。 执行成功时,字段可能为空。 执行失败时,用于显示错误码。 jobId String 查询节点任务ID。请求失败时字段为空。 说明: 可以查询jobId查看任务执行状态、获取返回结果,详情参考查询Job状态(1.0.0)-业务面。
  • 响应示例 状态码: 200 成功响应示例 Http Status Code: 200 { "jobId": "03e774f5-29ea-4187-9508-5435f3892ead016886200", "jobType": 1 } 状态码: 400 失败响应示例 Http Status Code: 400 { "errorMessage": "Bad Request, parameter labels and vertexFilters cannot all be null", "errorCode": "GES.8203" }
  • 请求示例 删除满足过滤条件的顶点集合(仅支持异步模式),顶点类型过滤条件分别为movies和user,属性名称为Age。 POST https://{SERVER_URL}/ges/v1.0/{project_id}/graphs/{graph_name}/vertices/action?action_id=delete { "labels": [ "movies", "user" ], "vertexFilters": [ { "propertyName": "Age", "predicate": "=", "values": [ "18-24" ] } ] }
  • 请求示例 根据批量节点ID删除节点,待删除的顶点ID数组为Vivian和46。 POST http://{SERVER_URL}/ges/v1.0/{project_id}/graphs/{graph_name}/vertices/action?action_id=batch-delete { "vertices": [ "Vivian", "46" ], "ignoreError": true } SERVER_URL:图的访问地址,取值请参考业务面API使用限制。
  • 响应示例 状态码: 200 成功响应示例 Http Status Code: 200 { "result": "success" } 状态码: 400 失败响应示例 Http Status Code: 400 { "errorMessage": " Bad Request, parameter vertices cannot be null", "errorCode": "GES.8214" }
  • URI POST /ges/v1.0/{project_id}/graphs/{graph_name}/vertices/properties/action?action_id={actionId} 表1 路径参数 参数 是否必选 类型 说明 project_id 是 String 项目ID。获取方法请参见获取项目ID。 graph_name 是 String 图名称。 actionId 是 String 操作符。 batch-update 更新该属性的值。 batch-add 添加属性的值。当属性的cardinality为single时,其操作与update一致;当cardinality为list或set时,意为向集合中添加值。 batch-del 删除属性的值。
  • 请求示例 批量更新点属性,待更新的顶点数组的点名称分别为150,6。 POST http://{SERVER_URL}/ges/v1.0/{project_id}/graphs/{graph_name}/vertices/properties/action?action_id=batch-update { "vertices": [ { "vertex": "150", "label": "movie", "properties": { "movieid": [ "150" ], "title": [ "testmoive" ], "genres": [ "Comedy" ] } }, { "vertex": "6", "properties": { "title": [ "testmoive_exist_id" ], "genres": [ "Comedy" ] } } ], } SERVER_URL:图的访问地址,取值请参考业务面API使用限制。
  • 响应示例 状态码: 200 成功响应示例 Http Status Code: 200 { "data": { "vertices": [ { "id": "0", "labels": [ "movie" ], "properties": { "movie": { "movieid": [ 0 ], "title": [ "American Beauty (1999)" ], "genres": [ "Comedy|Drama" ] } } }, { "id": "51", "labels": [ "user" ], "properties": { "user": { "userid": [ 5 ], "gender": [ "F" ], "age": [ "56+" ], "occupation": [ "homemaker" ], "Zip-code": [ "46911" ] } } } ] }, "result": "success" } 状态码: 400 失败响应示例 Http Status Code: 400 { "errorMessage": " Bad Request, parameter vertices cannot be null", "errorCode": "GES.8214" }
  • 响应参数 表3 响应Body参数 参数 类型 说明 errorMessage String 系统提示信息。 执行成功时,字段可能为空。 执行失败时,用于显示错误信息。 errorCode String 系统提示信息。 执行成功时,字段可能为空。 执行失败时,用于显示错误码。 data Object 查询成功时包含data字段,data字段中包含vertices查询结果。 result String 查询结果。成功时值为success,失败时值为failed。
  • URI GET /ges/v1.0/{project_id}/graphs/{graph_name}/vertices/detail?vertexIds={vertex_ids} 表1 路径参数 参数 是否必选 类型 说明 project_id 是 String 项目ID。获取方法请参见获取项目ID。 graph_name 是 String 图名称。 vertex_ids 是 String 需要查询的节点id列表。持久化版规格的图暂时仅支持一个id。
  • 响应示例 状态码: 200 成功响应示例 Http Status Code: 200 { "data": { "vertices": [ { "id": "46", "labels": [ "user" ], "properties": { "user": { "userid": [ 0 ], "gender": [ "F" ], "age": [ "25-34" ], "occupation": [ "artist" ], "Zip-code": [ "98133" ] } } } ] }, "result": "success" } 状态码: 400 失败响应示例 Http Status Code: 400 { "errorMessage":"graph [demo] is not found", "errorCode":"GES.8204" }
  • URI GET /ges/v1.0/{project_id}/graphs/{graph_name}/vertices/detail?vertexIds={vertex_ids} 表1 路径参数 参数 是否必选 类型 说明 project_id 是 String 项目ID。获取方法请参见获取项目ID。 graph_name 是 String 图名称。 vertex_ids 是 String 需要查询的节点id列表。当vertexIds指定多个id时,URL中用“,”隔开。 说明: 图规格为持久化版规格的图暂时仅支持一个id。
  • 响应示例 状态码: 200 成功响应示例 Http Status Code: 200{ "data": { "vertices": [ { "id": "Ray", "label": "user", "properties": { "Occupation": [ "college/grad student" ], "Name": [ "雷" ], "Zip-code": [ "90241" ], "Gender": [ "M" ], "Age": [ "18-24" ] } } ] }} 状态码: 400 失败响应示例 Http Status Code: 400 { "errorMessage":"graph [demo] is not found", "errorCode":"GES.8204" }