Operation

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>	Required	작업 메타데이터
`error`	Object<Error> \| Null	Optional	실패 사유 (완료 및 실패 시에만 존재) 실패는 변경분을 검증해 반영하는 구간(APPLYING)에서만 발생 네임서버 동기화 구간(SYNCHRONIZING)에 들어선 작업은 이미 반영된 변경을 되돌리지 않으므로 실패로 끝나지 않으며, 동기화가 지연되면 완료될 때까지 진행 중으로 남음

Error

에러 정보

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

연관 리소스

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

OperationMetadata