---
title: "DataQueryRequest"
slug: "common-vapidatatype-cidataqueryrequest"
updated: 2026-10-22T10:46:25Z
published: 2026-10-22T10:46:25Z
canonical: "api-gov.ncloud-docs.com/common-vapidatatype-cidataqueryrequest"
---

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

# DataQueryRequest

Classic/VPC 환경에서 이용 가능합니다.

데이터 조회 요청 정보입니다.

## 구문

구문은 다음과 같습니다.

```
private long timeStart;
private long timeEnd;
private String productName;
private String cw_key;
private String metric;
private Interval interval;
private Calculation aggregation;
private QueryAggregation queryAggregation;
private Map<String, String> dimensions;
```

## 필드

필드에 대한 설명은 다음과 같습니다.

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `timeStart` | long | Optional | 조회 시작 시간(밀리초) |
| `timeEnd` | long | Optional | 조회 종료 시간(밀리초) |
| `productName` | String | Optional | 상품명 |
| `cw_key` | String | Required | 상품의 cw_key |
| `metric` | String | Required | 조회하려는 Metric 이름 |
| `interval` | Interval | Optional | 조회하려는 데이터의 집계 주기 - `Min1`(기본값) \| `Min5` \| `Min30` \| `Hour2` \| `Day1` |
| `aggregation` | Calculation | Optional | 조회하려는 데이터의 집계 함수 - `COUNT` \| `SUM` \| `MAX` \| `MIN` \| `AVG` (기본값) |
| `queryAggregation` | QueryAggregation | Optional | 쿼리 기준이 충분하지 않을 때 쿼리 결과를 처리하는 방법 - `COUNT` \| `SUM` \| `MAX` \| `MIN` \| `AVG` (기본값) |
| `dimensions` | Map<String, String> | Required | 조회하려는 Dimension을 JSON으로 명시 |

          참고

          

쿼리 기준이 충분하지 않을 때는 조회하려는 Metric에 대한 Dimension 조건이 명확하지 않아 실제 조회 결과 여러 개의 데이터가 존재하는 경우입니다. 이러한 경우 queryAggregation에 명시된 메소드로 aggregation 된 값이 리턴됩니다.