주소 객체 목록 조회

지정한 주소 그룹에 속한 주소 객체 목록을 조회합니다.

HTTP 요청

GET /api/sonar/address-groups/:guid/addresses
cURL 예시
curl -H "Authorization: Bearer <API_KEY>" \
     https://HOSTNAME/api/sonar/address-groups/8df64276-a16e-4bae-93cd-c207c8155159/addresses
요청 매개변수
필수타입설명비고
guidO문자열주소 그룹 GUID36자
offsetX32비트 정수건너뛸 갯수기본값 0
limitX32비트 정수최대 갯수미지정 시 50건
keywordsX문자열검색 키워드ip, description 대상으로 검색

정상 응답

{
  "total_count": 1,
  "addresses": [
    {
      "guid": "d4915ba2-763f-4ec0-a875-38b292a99a24",
      "ip": "20.214.237.145",
      "country": "US",
      "count": 1,
      "description": "Web app attack",
      "created": "2022-11-07 01:30:40+0900",
      "updated": "2022-11-07 01:30:40+0900"
    }
  ]
}
  • total_count (32비트 정수): 검색 조건과 일치하는 전체 주소 수
  • addresses (배열): 주소 목록
    • guid (문자열): 주소 고유 식별자
    • ip (문자열): IP 주소
    • country (문자열): IP 주소 할당 국가 (ISO 2자리 국가 코드)
    • count (32비트 정수): 등록 건수
    • description (문자열): 설명
    • 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."
}