네트워크 대역 그룹 목록 조회

검색 조건과 일치하는 네트워크 대역 그룹 목록을 조회합니다. 특정 그룹의 상세 정보는 네트워크 대역 그룹 조회 API로 확인할 수 있습니다.

필요 권한

사용자 이상의 계정으로 이용할 수 있습니다.

HTTP 요청

cURL 예시

curl -H "Authorization: Bearer <API_KEY>" \
     "https://HOSTNAME/api/sonar/subnet-groups?offset=0&limit=20"

요청 매개변수

정상 응답

{
  "total_count": 1,
  "subnet_groups": [
    {
      "guid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "name": "내부망 대역",
      "description": "본사 내부망 IP 대역",
      "subnet_count": 2,
      "user_guid": "11111111-2222-3333-4444-555555555555",
      "user_name": "관리자",
      "app_code": null,
      "app_built_in": null,
      "created": "2026-07-24 09:31:14+0900",
      "updated": "2026-07-24 09:31:14+0900"
    }
  ]
}

• total_count (64비트 정수): 검색 조건과 일치하는 전체 네트워크 대역 그룹 개수
• subnet_groups (배열): 검색 조건과 일치하는 네트워크 대역 그룹 목록
  • guid (문자열): 네트워크 대역 그룹 GUID
  • name (문자열): 네트워크 대역 그룹 이름
  • description (문자열): 네트워크 대역 그룹 설명
  • subnet_count (32비트 정수): 그룹에 속한 네트워크 대역 개수
  • share (불리언, 선택적): 그룹 공유 여부. 공유된 경우에만 포함됩니다.
  • user_guid (문자열): 그룹을 생성한 계정의 GUID
  • user_name (문자열): 그룹을 생성한 계정의 이름
  • app_code (문자열): 그룹을 등록한 앱의 코드
  • app_built_in (불리언): 앱 기본 제공 그룹 여부
  • created (문자열): 생성일시 (yyyy-MM-dd HH:mm:ssZ 형식)
  • updated (문자열): 수정일시 (yyyy-MM-dd HH:mm:ssZ 형식)

오류 응답

offset, limit 값이 정수가 아닌 경우

HTTP 상태 코드 400 응답

{
  "error_code": "invalid-argument",
  "error_msg": "'offset' parameter should be int type"
}

offset, limit 값이 음수인 경우

HTTP 상태 코드 400 응답

{
  "error_code": "invalid-argument",
  "error_msg": "'offset' must be greater than or equal to 0."
}

권한이 없는 경우

HTTP 상태 코드 500 응답

{
  "error_code": "illegal-state",
  "error_msg": "no-permission"
}