자산 IP 조회

지정한 자산 IP를 조회합니다.

필요 권한

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

HTTP 요청

cURL 예시

curl -H "Authorization: Bearer <API_KEY>" \
     https://HOSTNAME/api/sonar/ip-addresses/f47ac10b-58cc-4372-a567-0e02b2c3d479

요청 매개변수

정상 응답

{
  "address": {
    "guid": "56654243-bd42-4b67-b21d-3cb21a86c09e",
    "ip": "192.1.1.1",
    "category_name": null,
    "category_guid": null,
    "hostname": "",
    "workgroup": "",
    "description": "중요도 하",
    "priority": "low",
    "confidentiality": "low",
    "integrity": "low",
    "availability": "low",
    "emp_name": "박현재",
    "emp_name2": null,
    "emp_guid": "8d352716-cc2e-4e9b-8e00-4cc707ef78fe",
    "emp_guid2": null,
    "emp_key": "00001",
    "emp_key2": null,
    "dept_name": "개발2팀",
    "dept_name2": null,
    "os_name": "",
    "os_ver": "",
    "created": "2025-08-13 21:31:55+0900",
    "updated": "2025-08-14 10:16:57+0900",
    "mac": "",
    "location": "",
    "installed": null,
    "site_guid": null,
    "site_name": null,
    "ext0": null,
    "ext1": null,
    "ext2": null,
    "ext3": null,
    "ext4": null,
    "ext5": null,
    "ext6": null,
    "ext7": null,
    "ext8": null,
    "ext9": null
  }
}

• address (객체): IP 주소 정보
  • guid (문자열): IP 주소 고유 식별자
  • ip (문자열): IP 주소
  • category_name (문자열): 분류명
  • category_guid (문자열): 분류 GUID
  • hostname (문자열): 호스트명
  • workgroup (문자열): 작업그룹
  • description (문자열): 설명
  • priority (문자열): 중요도 (low, medium, high)
  • confidentiality (문자열): 기밀성 (low, medium, high)
  • integrity (문자열): 무결성 (low, medium, high)
  • availability (문자열): 가용성 (low, medium, high)
  • emp_name (문자열): 담당자명 (정)
  • emp_name2 (문자열): 담당자명 (부)
  • emp_guid (문자열): 담당자 GUID (정)
  • emp_guid2 (문자열): 담당자 GUID (부)
  • emp_key (문자열): 담당자 키 (정)
  • emp_key2 (문자열): 담당자 키 (부)
  • dept_name (문자열): 부서명 (정)
  • dept_name2 (문자열): 부서명 (부)
  • os_name (문자열): 운영체제명
  • os_ver (문자열): 운영체제 버전
  • created (문자열): 생성일시 (yyyy-MM-dd HH:mm:ssZ 형식)
  • updated (문자열): 수정일시 (yyyy-MM-dd HH:mm:ssZ 형식)
  • mac (문자열): MAC 주소
  • location (문자열): 설치 위치
  • installed (문자열): 설치일시 (yyyy-MM-dd HH:mm:ssZ 형식)
  • site_guid (문자열): 사이트 GUID
  • site_name (문자열): 사이트명
  • ext0~ext9 (문자열): 확장 필드 (총 10개)

오류 응답

IP 주소가 존재하지 않는 경우

HTTP 상태 코드 200 응답

{
  "address": null
}

식별자가 GUID 형식이 아닌 경우

HTTP 상태 코드 400 응답

{
  "error_code": "invalid-param-type",
  "error_msg": "guid should be guid type."
}

권한이 없는 경우

HTTP 상태 코드 500 응답

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