엣지 서버 API 개요

엣지 서버 API와 객체 구조를 설명합니다.

마지막 업데이트: 2026년 3월 26일

Edge Server in ArchitectureEdge Server of Deeply AI System

엣지 서버 객체

Edge Server 객체는 Deeply 시스템 아키텍처에서 엣지 장치와 중앙 서버 사이의 데이터 처리와 통신을 담당하는 서버 구성 요소입니다. 이 객체에는 엣지 서버의 고유 ID, 이름, 네트워크 정보, 상태 등 핵심 정보가 포함됩니다.

속성

id

  • Type: string
  • Description: 엣지 서버의 고유 식별자입니다.

name

  • Type: string
  • Description: 일반적으로 기능이나 위치를 설명하는 엣지 서버 이름입니다.

description

  • Type: string
  • Description: 서버에 대한 추가 설명이나 메모를 담는 선택 필드입니다.

host

  • Type: string
  • Description: 엣지 서버의 호스트명 또는 IP 주소입니다. 네트워크 식별과 통신에 사용됩니다.

port

  • Type: integer
  • Description: 엣지 서버에 접근할 수 있는 포트 번호입니다. 일반적으로 HTTP 또는 API 연결을 설정할 때 사용합니다.

status

  • Type: enum(active | inactive)
  • Description: 엣지 서버의 현재 운영 상태입니다. 가능한 값은 다음과 같습니다.
    • "active": 서버가 온라인이며 정상 동작 중인 상태
    • "inactive": 서버가 오프라인이거나 사용 중이 아닌 상태

created_at

  • Type: string, ISO 8601 format
  • Description: 엣지 서버가 시스템에 처음 생성된 시각입니다. ISO 8601 형식을 사용합니다.

updated_at

  • Type: string, ISO 8601 format
  • Description: 엣지 서버 정보가 마지막으로 갱신된 시각입니다. ISO 8601 형식을 사용합니다.

단일 엣지 서버 조회 문서를 참고하면 응답 예시를 더 자세히 확인할 수 있습니다.