주소 그룹 조회

지정한 주소 그룹을 조회합니다.

필요 권한

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

HTTP 요청

cURL 예시

curl -H "Authorization: Bearer <API_KEY>" \
     https://HOSTNAME/api/sonar/address-groups/4dc14f3d-ebf8-4032-8a7a-ef9ec6cd3dd2

요청 매개변수

정상 응답

{
  "address_group": {
    "guid": "4dc14f3d-ebf8-4032-8a7a-ef9ec6cd3dd2",
    "name": "방화벽 차단 IP",
    "description": "차단 연동용 IP 블랙리스트",
    "count": 1,
    "version": 7,
    "created": "2022-10-05 15:34:59+0900",
    "updated": "2022-10-06 00:46:35+0900"
  }
}

• address_group (맵): 지정된 주소 그룹
  • guid (문자열): 주소 그룹 고유 식별자
  • name (문자열): 주소 그룹 이름
  • description (문자열): 주소 그룹 설명
  • count (32비트 정수): 주소 그룹에 속한 주소 갯수
  • version (32비트 정수): 단조 증가하는 버전
  • created (문자열): 생성일시 (yyyy-MM-dd HH:mm:ssZ 형식)
  • updated (문자열): 수정일시 (yyyy-MM-dd HH:mm:ssZ 형식)

지정한 주소 그룹이 존재하지 않는 경우

HTTP 상태 코드 200 응답

{
  "address_group": null
}

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

오류 응답

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