批量边查

功能介绍

根据批量边的起点、终点以及索引，查询这些边的详细信息，返回边的标签和属性等。

URI

• URI格式

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

• 参数说明

  表1 URI参数说明

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

请求

• 请求样例（不包括图规格为一千亿边）

  POST http://{SERVER_URL}/ges/v1.0/{project_id}/graphs/{graph_name}/edges/action?action_id=batch-query  
  {
             "edges": [{
                  "source": "39631050_景观",
                  "target": "27803870_地标建筑"
              },{
                  "index": "0",
                  "source": "27803870_地标建筑",
                  "target": "27661363_九华山庄温泉"
              }]
  } 

• 请求样例（一千亿边）

  POST http://{SERVER_URL}/ges/v1.0/{project_id}/graphs/{graph_name}/edges/action?action_id=batch-query  
  {
      "edges": [
             {
                 "source": "Vivian",
                 "target": "Lethal Weapon",
                 "label": "rate"
             },
             {
                 "source": "Vivian",
                 "target": "Raising Arizona"
             }
         ]
  }

  

  SERVER_URL：图的访问地址，取值请参考业务面API使用限制。

• Body参数说明

  表2 Body参数说明

  参数	是否必选	类型	说明
  edges	是	Json	待查询的边数组。

  表3 edges参数说明

  参数	是否必选	类型	说明
  source	是	String	边的source节点。
  target	是	String	边的target节点。
  index	否	String	边的index。 说明： 图规格为一千亿边的图暂不支持该参数。
  label（一千亿边）	否	String	边的label。

响应

• 要素说明

  表4 要素说明

  参数	是否必选	类型	说明
  errorMessage	否	String	系统提示信息，执行成功时，字段可能为空。执行失败时，用于显示错误信息。
  errorCode	否	String	系统提示信息，执行成功时，字段可能为空。执行失败时，用于显示错误码。
  data	否	String	查询成功时包含data字段，data字段中包含edges查询结果。
  result（一千亿边）	是	String	查询成功时值为success,失败时值为failed。

• 请求成功样例（不包括图规格为一千亿边）

  {
      "data": {
          "edges": [
              {
                  "index": "24",
                  "source": "39631050_景观",
                  "label": "superclassOf",
                  "properties": {
                      "popularity": [
                          0
                      ]
                  },
                  "target": "27803870_地标建筑"
              },
              {
                  "index": "0",
                  "source": "27803870_地标建筑",
                  "label": "superclassOf",
                  "properties": {
                      "popularity": [
                          0
                      ]
                  },
                  "target": "27661363_九华山庄温泉"
              }
          ]
      }
  }

• 请求成功样例（一千亿边）

  {
      "data": {
          "edges": [
              {
                  "source": "Vivian",
                  "target": "Raising Arizona",
                  "label": "rate",
                  "properties": {
                      "Score": [
                          4
                      ],
                      "Datetime": [
                          "2000-12-27 23:51:42"
                      ]
                  }
              },
              {
                  "source": "Vivian",
                  "target": "Lethal Weapon",
                  "label": "rate",
                  "properties": {
                      "Score": [
                          5
                      ],
                      "Datetime": [
                          "2000-12-27 23:44:41"
                      ]
                  }
              }
          ]
      },
      "result": "success"
  }

• 请求失败样例

  Http Status Code: 400
  {
   "errorMessage":"parameter does not contain 'source'",
   "errorCode":"GES.8000"
  }