---
title: "DataQueryRequest"
slug: "common-apidatatype-cidataqueryrequest"
tags: ["Classic"]
updated: 2026-09-17T09:57:14Z
published: 2026-09-17T09:57:14Z
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

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 | Required | 照会開始時間(ミリ秒) |
| `timeEnd` | long | Required | 照会終了時間(ミリ秒) |
| `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された値を返します。