---
title: "FieldDto"
slug: "common-vapidatatype-cifielddto"
tags: ["Classic"]
updated: 2026-09-17T09:25:09Z
published: 2026-09-17T09:25:09Z
canonical: "api.ncloud-docs.com/common-vapidatatype-cifielddto"
---

> ## 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.

# FieldDto

Available in Classic and VPC

It is required when creating and editing a schema.

## Syntax

The syntax is as follows:

```
private String name;
private DataType dataType;
private Boolean metric = false;
private String metricType;
private Boolean dimension = false;
private Boolean counter = false;
private Boolean isIdDimension = false;
private Map<Interval, Set<Calculation>> aggregations;
private String desc;
```

## Field

The following describes the fields:

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `name` | String | Required | Name of product schema |
| `dataType` | DataType | Required | Specify the data type of a metric or dimension. - If the field is a metric: `STRING` \| `INTEGER` \| `FLOAT` \| `LONG` - If the field is a dimension: `STRING` |
| `metric` | Boolean | Optional | Specify that the field is a metric. - `true` \| `false` (default) |
| `metricType` | String | - | Metric type - `BASIC` \| `EXTENDED` \| `CUSTOM` - `BASIC`: default performance/operational metrics - `EXTENDED`: additional performance/operational metrics for detailed monitoring - `CUSTOM`: user-defined performance/operational metrics |
| `dimension` | Boolean | Optional | Specify that the field is a dimension. - `true` \| `false` (default) |
| `counter` | Boolean | Optional | - `true` \| `false` (default) |
| `isIdDimension` | Boolean | Optional | It can only be set when the field is a dimension and is distinguished by that dimension when creating an event rule for a user-defined product. - `default` (default) - At least one dimension must be set to idDimension. |
| `aggregations` | Map<Interval, Set<Calculation>> | Optional | It can only be set when the field is a metric, and sets the aggregation frequency and aggregation function. - Interval: `Min1` \| `Min5` \| `Min30` \| `Hour2` \| `Day1` - Calculation: `COUNT` \| `SUM` \| `MAX` \| `MIN` \| `AVG` |
| `desc` | String | Optional | Description of product schema |

## Examples

See below for an example.

              Note

              

If aggregations is not set, it defaults to performing all aggregation functions for every aggregation interval as shown below.

```
"aggregations": {
    "Min1": [
      "AVG",
      "SUM",
      "MIN",
      "MAX",
      "COUNT"
    ],
    "Min5": [
      "AVG",
      "SUM",
      "MIN",
      "MAX",
      "COUNT"
    ],
    "Min30": [
      "AVG",
      "SUM",
      "MIN",
      "MAX",
      "COUNT"
    ],
    "Hour2": [
      "AVG",
      "SUM",
      "MIN",
      "MAX",
      "COUNT"
    ],
    "Day1": [
      "AVG",
      "SUM",
      "MIN",
      "MAX",
      "COUNT"
    ]
}
```