---
title: "listQueryStatistics"
slug: "fin-global-dns-v2-query-statistics-listquerystatistics"
updated: 2026-10-21T05:09:56Z
published: 2026-10-23T09:00:07Z
canonical: "api-fin.ncloud-docs.com/fin-global-dns-v2-query-statistics-listquerystatistics"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://api-fin.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# listQueryStatistics

이 가이드는 API 명세를 기반으로 AI가 자동 생성했습니다.

Ncloud 표준 표현을 적용한 API입니다.

도메인 1건의 질의수를 조회합니다. 결과는 `baseTimeUnit` 간격으로 끊어진 연속 시계열이며 기준 시각 오름차순으로 반환되고, 질의가 없던 구간도 `queryCount` 0 으로 채워집니다. 조회 구간은 `filter` 표현식으로 지정하며, 생략하면 `baseTimeUnit` 별 기본 조회 기간이 적용됩니다. 조회 가능한 과거 구간은 `baseTimeUnit` 별 보관 기간(MINUTE_1·MINUTE_5·MINUTE_30 60일, HOUR_3 90일, DAY_1 730일)까지이며, 그보다 앞선 구간을 지정해도 오류 없이 데이터가 없는 구간으로 반환됩니다. 한 번에 조회할 수 있는 구간에는 상한이 있습니다. `baseTimeUnit` 별 최대 조회 구간은 MINUTE_1 7일, MINUTE_5 30일, MINUTE_30 60일, HOUR_3 90일, DAY_1 730일이며, 이를 넘는 구간을 `filter` 로 지정하면 400 InvalidParameter 로 응답합니다. 이 API 는 삭제된 도메인의 과거 질의수도 조회할 수 있습니다. 도메인 조회·수정 등 다른 API 는 삭제된 도메인 번호에 403 Forbidden 으로 응답하지만, 질의수는 도메인이 삭제된 뒤에도 보관 기간 동안 남아 있어 이 API 에서만 예외적으로 허용합니다. 이 예외는 삭제 여부만 검사에서 제외할 뿐 소유 검증은 그대로 적용되므로, 호출자가 보유했던 도메인에만 해당합니다. 소유 이력이 없는 도메인 번호는 삭제 여부와 실재 여부에 관계없이 다른 API 와 동일하게 403 Forbidden 으로 응답합니다. 회원이 보유한 전체 도메인의 합계는 `GET /query-statistics` 를 사용합니다.

## 요청

요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.

| 메서드 | URI |
| --- | --- |
| GET | /domains/{domainNo}/query-statistics |

### 요청 헤더

Global DNS API에서 공통으로 사용하는 헤더에 대한 정보는 [Global DNS 요청 헤더](/docs/fin-global-dns-v2-overview#%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94)를 참조해 주십시오.

### 요청 경로 파라미터

요청 경로 파라미터에 대한 설명은 다음과 같습니다.

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `domainNo` | Integer (int64) | Required | 도메인 번호 - 보유하지 않았거나 존재하지 않는 번호는 403 Forbidden (두 경우를 구분하지 않음) - <예시> 120 |

### 요청 쿼리 파라미터

요청 쿼리 파라미터에 대한 설명은 다음과 같습니다.

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `baseTimeUnit` | String | Required | 기준 시간 단위 (집계 간격) - 한 응답의 데이터 포인트 수는 약 10,000개 이하 - `MINUTE_1` \| `MINUTE_5` \| `MINUTE_30` \| `HOUR_3` \| `DAY_1` - `MINUTE_1`: 1분. 기본 조회 기간 12시간, 최대 조회 구간 7일 - `MINUTE_5`: 5분. 기본 조회 기간 2일, 최대 조회 구간 30일 - `MINUTE_30`: 30분. 기본 조회 기간 14일, 최대 조회 구간 60일 - `HOUR_3`: 3시간. 기본 조회 기간 70일, 최대 조회 구간 90일 - `DAY_1`: 1일. 기본 조회 기간 730일, 최대 조회 구간 730일 - <예시> HOUR_3 |
| `filter` | String | Optional | 조회 구간 필터 표현식 - 응답 필드 `baseTimestamp`(Unix epoch 밀리초)에 대한 범위 조건만 지원 - 지원 연산자: `&gt;=`, `&gt;`, `&lt;=`, `&lt;` (시작과 끝을 함께 지정할 때는 `AND` 로 결합) - 시작 조건을 생략하면 종료 시각에서 `baseTimeUnit` 별 기본 조회 기간만큼 앞선 시각 적용 - 종료 조건을 생략하면 현재 시각을 `baseTimeUnit` 간격으로 내림한 값 적용 - 시작과 끝의 간격은 `baseTimeUnit` 별 최대 조회 구간 이하 (`filter` 를 생략하면 기본 조회 기간이 적용되어 상한에 걸리지 않음) - 지원하지 않는 필드·연산자를 쓰거나 최대 조회 구간을 넘으면 400 InvalidParameter - 길이: ~ 255 - <예시> baseTimestamp >= 1568111263000 AND baseTimestamp < 1568711263000 |

### 요청 예시

요청 예시는 다음과 같습니다.

```
curl --location --request GET 'https://globaldns.apigw.fin-ntruss.com/dns/v2/domains/120/query-statistics?baseTimeUnit=HOUR_3' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}'
```

## 응답

응답 형식을 설명합니다.

### 응답 바디

응답 바디에 대한 설명은 다음과 같습니다.

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `queryStatistics` | List<[QueryStatistic](/docs/fin-global-dns-v2-query-statistics-listquerystatistics#QueryStatistic)> | - | 질의수 시계열 (기준 시각 오름차순, 질의가 없던 구간은 queryCount 0) |

#### QueryStatistic

질의수 데이터 포인트

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `queryCount` | Integer (int64) | - | 구간 질의 수 - <예시> 1234 |
| `baseTimestamp` | Integer (int64) | - | 구간 기준 시각 (Unix epoch 밀리초) - <예시> 1568111263000 |

### 응답 상태 코드

Global DNS API에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 [Global DNS 응답 상태 코드](/docs/fin-global-dns-v2-overview#%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C)를 참조해 주십시오.

이 API에만 해당하는 응답 상태 코드는 다음과 같습니다.

| HTTP 상태 코드 | 코드 | 메시지 | 설명 |
| --- | --- | --- | --- |
| 200 | - | - | OK |

### 응답 예시

응답 예시는 다음과 같습니다.

```
{
  "queryStatistics": [
    {
      "queryCount": 1234,
      "baseTimestamp": 1568111263000
    }
  ]
}
```