---
title: "Operation"
slug: "gov-global-dns-v2-type-operation"
updated: 2026-10-26T05:02:01Z
published: 2026-10-26T05:02:01Z
canonical: "api-gov.ncloud-docs.com/gov-global-dns-v2-type-operation"
---

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

# Operation

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

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

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

Operation(네이버클라우드 정의 데이터 타입)에 대해 설명합니다.

## 스키마 정의

Operation의 구조는 다음과 같습니다.

```
{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "done": false,
  "metadata": {
    "operationType": "UPDATE",
    "resourceType": "records",
    "startDateTime": "2026-06-30T12:00:00Z",
    "endDateTime": "2026-06-30T12:00:05Z",
    "phase": "SYNCHRONIZING"
  },
  "error": {
    "errorCode": "string",
    "message": "string",
    "detail": "string",
    "fieldErrors": [
      {
        "message": "string",
        "field": "string"
      }
    ]
  }
}
```

## 스키마 필드

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

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `id` | String (uuid) | Required | 작업 ID - <예시> 3fa85f64-5717-4562-b3fc-2c963f66afa6 |
| `done` | Boolean | Required | 작업 완료 여부 - 저장소 반영 시점이 아니라 네임서버에 실제로 반영된 것까지 확인된 시점에 true - true 이면 변경이 DNS 질의에 반영된 상태 - `true` \| `false` - <예시> false |
| `metadata` | Object<[OperationMetadata](/docs/gov-global-dns-v2-type-operationmetadata)> | Required | 작업 메타데이터 |
| `error` | Object<[Error](/docs/gov-global-dns-v2-type-operation#Error)> \| Null | Optional | 실패 사유 (완료 및 실패 시에만 존재) - 실패는 변경분을 검증해 반영하는 구간(APPLYING)에서만 발생 - 네임서버 동기화 구간(SYNCHRONIZING)에 들어선 작업은 이미 반영된 변경을 되돌리지 않으므로 실패로 끝나지 않으며, 동기화가 지연되면 완료될 때까지 진행 중으로 남음 |

#### Error

에러 정보

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `errorCode` | String | Required | 에러 코드 |
| `message` | String | Required | 에러 메시지 (기본 영어, 다국어 지원 가능) |
| `detail` | String | Optional | 에러 상세 정보 (기본 영어, 다국어 지원 가능) |
| `fieldErrors` | List<[FieldError](/docs/type-fielderror)> | Optional | 입력값 에러가 발생한 경우 각 필드별 에러 상세 정보 목록 |

## 연관 리소스

Operation와(과) 연관된 데이터 타입은 다음과 같습니다.

- [OperationMetadata](/docs/gov-global-dns-v2-type-operationmetadata)