Executing Gremlin Queries

Function

This API is used to return the query result of a Gremlin statement.

URI

Request Parameters

Response Parameters

Example Request

Perform the Gremlin query operation. If the query command is g.V().limit(100), all vertices are queried, but the number of returned vertices is limited to 100.

POST http://{SERVER_URL}/ges/v1.0/{project_id}/graphs/{graph_name}/action?action_id=execute-gremlin-query
{       
    "command":"g.V().limit(100)" 
}

• SERVER_URL: Address for accessing a graph. For details about its value, see Using Service Plane APIs.
• The size of the request body cannot exceed 64 MB.

Example Response

Status code: 200

Example response for a successful request

Http Status Code: 200

{
    "data": {
        "runtime": 0.775425022,
        "vertices": [
            {
                "id": "Vivian",
                "label": "user",
                "properties": {
                    "Occupation": [
                        "artist"
                    ],
                    "Name": [
                        "Vivian"
                    ],
                    "Zip-code": [
                        "98133"
                    ],
                    "Gender": [
                        "F"
                    ],
                    "Age": [
                        "25-34"
                    ]
                }
            },
            ......
        ]
    }
}

Status code: 400

Example response for a failed request

Http Status Code: 400
{
    "errorMessage": "org.apache.tinkerpop.gremlin.driver.exception.ResponseException: No such property: g1 for class: Script4",
    "errorCode": "GES.8503"
}

Status Code

Error Code

See Error Code.