文档首页 > > API参考> 业务面API> 子图操作API>

子图查询(2.1.13)

子图查询(2.1.13)

分享
更新时间:2021/05/08 GMT+08:00

功能介绍

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

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,超过最大值时,会报错。

响应

表3 要素说明

名称

是否必选

参数类型

说明

errorMessage

String

系统提示信息,执行成功时,字段可能为空。执行失败时,用于显示错误信息。

errorCode

String

系统提示信息,执行成功时,字段可能为空。执行失败时,用于显示错误码。

data

Json

查询成功时包含data字段,data字段中包含子图查询结果。

说明:

当前支持返回的子图边数最大值为100000,超过返回最大值时,会报错。

  • 请求成功样例
    Http Status Code: 200
    {
        "data":{
            "vertices":[
                {
                    "id":"Ray",
                    "label":"user",
                    "properties":{
                        "ChineseName":["雷"],
                        "Gender":["M"],
                        "Age":["18-24"],
                        "Occupation":["college/grad student"],
                        "Zip-code":["90241"]
                    }
                },
                {
                    "id":"Ella",
                    "label":"user",
                    "properties":{
                        "Occupation":["other or not specified"],
                        "ChineseName":["埃拉"],
                        "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

    服务不可用。

分享:

    相关文档

    相关产品