---
title: "DataQueryRequest"
slug: "common-apidatatype-cidataqueryrequest"
tags: ["Classic"]
updated: 2026-09-17T09:25:01Z
published: 2026-09-17T09:25:01Z
canonical: "api.ncloud-docs.com/common-apidatatype-cidataqueryrequest"
---

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

# DataQueryRequest

Available in Classic and VPC

This is the data query request information.

## Syntax

The syntax is as follows:

```
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;
```

## Field

The following describes the fields.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `timeStart` | long | Required | Query start time (milliseconds) |
| `timeEnd` | long | Required | Query end time (milliseconds) |
| `productName` | String | Optional | Product name |
| `cw_key` | String | Required | cw_key of the product |
| `metric` | String | Required | Metric name to be searched |
| `interval` | Interval | Optional | Aggregation interval for the data you want to query - `Min1`(default) \| `Min5` \| `Min30` \| `Hour2` \| `Day1` |
| `aggregation` | Calculation | Optional | Aggregation function for the data you want to query - `COUNT` \| `SUM` \| `MAX` \| `MIN` \| `AVG` (default) |
| `queryAggregation` | QueryAggregation | Optional | Method of processing query results in case of insufficient query standards - `COUNT` \| `SUM` \| `MAX` \| `MIN` \| `AVG` (default) |
| `dimensions` | Map<String, String> | Required | Specify the dimension to query in JSON format. |

              Note

              

This is the case where multiple data exists as a result of the actual query because the dimension conditions for the metric you are looking at are not clear enough. In such cases, aggregated values are returned by the method specified in queryAggregation.