子图查询

功能介绍

查询输入的节点和它们之间所有边所构成的子图。

URI

• URI格式

  POST /ges/v1.0/{project_id}/graphs/{graph_name}/subgraphs/action?action_id=query

• 参数说明

  表1 URI参数说明

  参数	是否必选	类型	说明
  project_id	是	String	项目编号，用于资源隔离。请参考获取项目ID。
  graph_name	是	String	图名称。

请求

• 请求样例

  {
      "vertices":[
                 "Ray",
                 "Ella",
                 "Lethal Weapon"        
                 ]
  }

• 参数说明

  表2

  名称	是否必选	参数类型	说明
  vertices	是	String	子图中应包含的顶点ID数组。 说明： 当前支持输入的顶点个数最大值为100000，超过最大值时，会报错。

响应

• 请求成功样例

  Http Status Code: 200
  {
      "data":{
          "vertices":[
              {
                  "id":"Ray",
                  "label":"user",
                  "properties":{
                      "Name":["雷"],
                      "Gender":["M"],
                      "Age":["18-24"],
                      "Occupation":["college/grad student"],
                      "Zip-code":["90241"]
                  }
              },
              {
                  "id":"Ella",
                  "label":"user",
                  "properties":{
                      "Occupation":["other or not specified"],
                      "Name":["埃拉"],
                      "Zip-code":["94402"],
                      "Gender":["F"],
                      "Age":["25-34"]
                  }
              }
          ],
          "edges":[
              {
                  "source":"Ray",
                  "target":"Lethal Weapon",
                  "index":"1",
                  "label":"rate",
                  "properties":{
                      "Score":[2],
                      "Datetime":["2000-11-22 19:16:16"]
                  }
              },
              {
                  "index":"0",
                  "source":"Ella",
                  "label":"rate",
                  "properties":{
                      "Score":[5],
                      "Datetime":["2000-11-23 02:30:29"]
                  },
                  "target":"Lethal Weapon"
              },
              {
                  "index":"5",
                  "source":"Ella",
                  "label":"friends",
                  "properties":{},
                  "target":"Ray"
              }
          ]
      }
  }

• 请求失败样例

  Http Status Code: 400
  {
    "errorMessage": " Bad Request, parameter vertices cannot be null",
    "errorCode": "GES.8214"
  }

返回值

• 正常

  200

• 异常

  表4 异常返回值说明

  返回值	说明
  400 Bad Request	请求错误。
  401 Unauthorized	鉴权失败。
  403 Forbidden	没有操作权限。
  404 Not Found	找不到资源。
  500 Internal Server Error	服务内部错误。
  503 Service Unavailable	服务不可用。