Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# API status kueri Gremlin
<a name="gremlin-api-status"></a>

Anda dapat membuat daftar semua kueri Gremlin aktif atau mendapatkan status kueri tertentu. Titik akhir HTTP yang mendasari untuk kedua operasi adalah`https://{{your-neptune-endpoint}}:{{port}}/gremlin/status`.

## Daftar pertanyaan Gremlin aktif
<a name="gremlin-api-status-list"></a>

Untuk mencantumkan semua kueri Gremlin yang aktif, panggil titik akhir tanpa parameter. `queryId`

### Permintaan parameter
<a name="gremlin-api-status-list-request"></a>
+ **IncludeWaiting** (*opsional*) - Jika disetel ke`TRUE`, respons mencakup kueri tunggu selain menjalankan kueri.

### Sintaksis Respons
<a name="gremlin-api-status-list-response"></a>

```
{
  "acceptedQueryCount": integer,
  "runningQueryCount": integer,
  "queries": [
    {
      "queryId": "guid",
      "queryEvalStats": {
        "waited": integer,
        "elapsed": integer,
        "cancelled": boolean
      },
      "queryString": "string"
    }
  ]
}
```
+ **diterima QueryCount** — Jumlah kueri yang telah diterima tetapi belum selesai, termasuk kueri dalam antrian.
+ **running QueryCount** — Jumlah query Gremlin yang sedang berjalan.
+ **queries** — Daftar kueri Gremlin saat ini.

### Contoh
<a name="gremlin-api-status-list-example"></a>

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

```
aws neptunedata list-gremlin-queries \
  --endpoint-url https://{{your-neptune-endpoint}}:{{port}}
```

Untuk informasi selengkapnya, lihat [daftar-gremlin-query di Command Reference](https://docs.aws.amazon.com/cli/latest/reference/neptunedata/list-gremlin-queries.html). AWS CLI 

------
#### [ SDK ]

```
import boto3
from botocore.config import Config

client = boto3.client(
    'neptunedata',
    endpoint_url='https://{{your-neptune-endpoint}}:{{port}}',
    config=Config(read_timeout=None, retries={'total_max_attempts': 1})
)

response = client.list_gremlin_queries()

print(response)
```

Untuk contoh AWS SDK dalam bahasa lain seperti Java, .NET, dan lainnya, lihat[AWS SDK](access-graph-gremlin-sdk.md).

------
#### [ awscurl ]

```
awscurl https://{{your-neptune-endpoint}}:{{port}}/gremlin/status \
  --region {{us-east-1}} \
  --service neptune-db
```

**catatan**  
Contoh ini mengasumsikan bahwa AWS kredensil Anda dikonfigurasi di lingkungan Anda. Ganti {{us-east-1}} dengan Wilayah cluster Neptunus Anda.

Untuk informasi selengkapnya tentang menggunakan **awscurl** autentikasi IAM, lihat. [Menggunakan `awscurl` dengan kredensyal sementara untuk terhubung dengan aman ke cluster DB dengan otentikasi IAM diaktifkan](iam-auth-connect-command-line.md#iam-auth-connect-awscurl)

------
#### [ curl ]

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

------

Output berikut menunjukkan query berjalan tunggal.

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

## Mendapatkan status kueri Gremlin tertentu
<a name="gremlin-api-status-get-single"></a>

Untuk mendapatkan status kueri Gremlin tertentu, berikan parameternya. `queryId`

### Permintaan parameter
<a name="gremlin-api-status-get-request"></a>
+ **QueryID** *(*wajib) - ID dari kueri Gremlin. Neptunus secara otomatis menetapkan nilai ID ini untuk setiap kueri, atau Anda dapat menetapkan ID Anda sendiri (lihat). [Menyuntikkan ID Kustom Ke Dalam Gremlin Neptune atau Kueri SPARQL](features-query-id.md)

### Sintaksis Respons
<a name="gremlin-api-status-get-response-syntax"></a>

```
{
  "queryId": "guid",
  "queryString": "string",
  "queryEvalStats": {
    "waited": integer,
    "elapsed": integer,
    "cancelled": boolean,
    "subqueries": document
  }
}
```
+ **QueryID** — ID kueri.
+ **queryString** — Query yang dikirimkan. Ini dipotong menjadi 1024 karakter jika lebih panjang dari itu.
+ **kueri EvalStats** — Statistik untuk kueri, termasuk `waited` (waktu tunggu dalam milidetik), `elapsed` (waktu berjalan dalam milidetik), `cancelled` (apakah kueri dibatalkan), dan `subqueries` (jumlah subkueri).

### Contoh
<a name="gremlin-api-status-get-example"></a>

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

```
aws neptunedata get-gremlin-query-status \
  --endpoint-url https://{{your-neptune-endpoint}}:{{port}} \
  --query-id "fb34cd3e-f37c-4d12-9cf2-03bb741bf54f"
```

Untuk informasi selengkapnya, lihat [get-gremlin-query-status di Command Reference](https://docs.aws.amazon.com/cli/latest/reference/neptunedata/get-gremlin-query-status.html). AWS CLI 

------
#### [ SDK ]

```
import boto3
from botocore.config import Config

client = boto3.client(
    'neptunedata',
    endpoint_url='https://{{your-neptune-endpoint}}:{{port}}',
    config=Config(read_timeout=None, retries={'total_max_attempts': 1})
)

response = client.get_gremlin_query_status(
    queryId='fb34cd3e-f37c-4d12-9cf2-03bb741bf54f'
)

print(response)
```

Untuk contoh AWS SDK dalam bahasa lain seperti Java, .NET, dan lainnya, lihat[AWS SDK](access-graph-gremlin-sdk.md).

------
#### [ awscurl ]

```
awscurl https://{{your-neptune-endpoint}}:{{port}}/gremlin/status/fb34cd3e-f37c-4d12-9cf2-03bb741bf54f \
  --region {{us-east-1}} \
  --service neptune-db
```

**catatan**  
Contoh ini mengasumsikan bahwa AWS kredensil Anda dikonfigurasi di lingkungan Anda. Ganti {{us-east-1}} dengan Wilayah cluster Neptunus Anda.

Untuk informasi selengkapnya tentang menggunakan **awscurl** autentikasi IAM, lihat. [Menggunakan `awscurl` dengan kredensyal sementara untuk terhubung dengan aman ke cluster DB dengan otentikasi IAM diaktifkan](iam-auth-connect-command-line.md#iam-auth-connect-awscurl)

------
#### [ curl ]

```
curl https://{{your-neptune-endpoint}}:{{port}}/gremlin/status/fb34cd3e-f37c-4d12-9cf2-03bb741bf54f
```

------

Berikut ini adalah contoh respons.

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