기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# Gremlin 쿼리 상태 API
<a name="gremlin-api-status"></a>

Gremlin 쿼리의 상태를 가져오려면 HTTP `GET` 또는 `POST`를 사용하여 `https://your-neptune-endpoint:port/gremlin/status` 엔드포인트에 대한 요청을 생성합니다.

## Gremlin 쿼리 상태 요청 파라미터
<a name="gremlin-api-status-get-request"></a>
+ **queryId** (*선택 사항*)   –   실행 중인 Gremlin 쿼리의 ID입니다. 지정된 쿼리의 상태만 표시합니다.
+ **IncludeWaiting** (*선택 사항*)   –   대기 중인 모든 쿼리의 상태를 반환합니다.

  일반적으로 실행 중인 쿼리만 응답에 포함되지만, `includeWaiting` 파라미터를 지정하면 대기 중인 모든 쿼리의 상태도 반환됩니다.

## Gremlin 쿼리 상태 응답 구문
<a name="gremlin-api-status-get-response-syntax"></a>

```
{
  "acceptedQueryCount": integer,
  "runningQueryCount": integer,
  "queries": [
    {
      "queryId":"guid",
      "queryEvalStats":
        {
          "waited": integer,
          "elapsed": integer,
          "cancelled": boolean
        },
      "queryString": "string"
    }
  ]
}
```

## Gremlin 쿼리 상태 응답 값
<a name="gremlin-api-status-get-response-values"></a>
+ **acceptedQueryCount**   –   대기열에 있는 쿼리를 포함하여 수락되었지만 아직 완료되지 않은 쿼리 수입니다.
+ **runningQueryCount**   –   현재 실행 중인 Gremlin 쿼리의 수입니다.
+ **queries**   –   현재 Gremlin 쿼리 목록입니다.
+ **queryId**   –   쿼리의 GUID ID입니다. Neptune이 ID 값을 각 쿼리에 자동 할당하거나 사용자가 자체 ID를 할당할 수 있습니다([Neptune Gremlin 또는 SPARQL 쿼리에 사용자 지정 ID 주입](features-query-id.md) 참조).
+ **QueryEvalStats**   –   이 쿼리에 대한 통계입니다.
+ **subqueries**   –   이 쿼리에 있는 하위 쿼리의 수입니다.
+ **elapsed**   –   지금까지 쿼리가 실행된 시간(밀리초)입니다.
+ **cancelled**   –   True는 쿼리가 취소되었음을 나타냅니다.
+ **queryString**   –   제출된 쿼리입니다. 이보다 길면 1024자로 잘립니다.
+ **waited**   –   쿼리가 대기한 시간을 밀리초 단위로 나타냅니다.

## Gremlin 쿼리 상태 예제
<a name="gremlin-api-status-get-example"></a>

다음은 상태 명령 실행 시 `curl` 및 HTTP `GET`을 사용한 예입니다.

```
curl https://your-neptune-endpoint:port/gremlin/status
```

이 출력은 실행 중인 쿼리 한 개를 보여줍니다.

```
{
  "acceptedQueryCount":9,
  "runningQueryCount":1,
  "queries": [
    {
      "queryId":"fb34cd3e-f37c-4d12-9cf2-03bb741bf54f",
      "queryEvalStats":
        {
          "waited": 0,
          "elapsed": 23,
          "cancelled": false
        },
      "queryString": "g.V().out().count()"
    }
  ]
}
```