주소 객체 목록 조회
지정한 주소 그룹에 속한 주소 객체 목록을 조회합니다.
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
요청 매개변수
키 | 필수 | 타입 | 설명 | 비고 |
---|---|---|---|---|
guid | O | 문자열 | 주소 그룹 GUID | 36자 |
offset | X | 32비트 정수 | 건너뛸 갯수 | 기본값 0 |
limit | X | 32비트 정수 | 최대 갯수 | 미지정 시 50건 |
keywords | X | 문자열 | 검색 키워드 | 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."
}