# ListQueries
ListQueries

ListQueries API fetches the list of running/waiting/cancelling queries on the graph.

## ListQueries syntax
Syntax

```
aws neptune-graph list-queries \
    --graph-identifier <graph-id> \ 
    --region <region> \
    --max-results <result_count>
    --state [all | running | waiting | cancelling]
```

## ListQueries inputs
Inputs
+ graph-identifier (required)

  Type: `String`

  Identifier representing your graph.
+ region (required)

  Type: `String`

  Region where the graph is present.
+ max-results (required)

  Type: `Integer`

  The maximum number of results to be fetched by the API.
+ state (optional)

  Type: `String`

  Supported values: all \$1 running \$1 waiting \$1 cancelling

  If `state` parameter is not specified, the API fetches all types.

## ListQueries outputs
Outputs

```
# Sample Response
{
    "queries": [
        {
            "id": "130ab841-8b4b-46c3-afbe-af00274c7fd9",
            "queryString": "MATCH p=(n)-[*]-(m) RETURN p;",
            "waited": 0,
            "elapsed": 1686,
            "state": "RUNNING"
        }
    ]
}
```

The output contains a list of query objects, each containing:
+ id: `String` - representing the unique identifier of the query.
+ queryString: `String` - The actual query text. The queryString may be truncated if the actual query string is too long.
+ waited: `Integer` - The time in milliseconds for which the query has waited in the waiting queue before being picked up by a worker thread.
+ elapsed: `Integer` - The time in milliseconds representing the running time of the query.
+ state: Current state of the query (running \$1 waiting \$1 cancelling).

The default list order is queries that are `running`, followed by `waiting` and `cancelling`.

## ListQueries Examples
Examples

------
#### [ AWS CLI ]

```
aws neptune-graph list-queries \
    --graph-identifier <graph-id> \ 
    --region us-east-1 \
    --max-results 200
    --state waiting
```

------
#### [ AWSCURL ]

```
awscurl -X GET "https://<graph-id>.<endpoint>/queries?state=WAITING&maxResults=200" \
   -H "Content-Type: application/x-www-form-urlencoded" \
   --region us-east-1 \
   --service neptune-graph
```

------