kisa-whois-asn-batch

입력 레코드의 asn 컬럼 값으로 KRNIC 관리 ASN의 등록·할당 정보를 일괄 조회합니다.

문법

kisa-whois-asn-batch profile=STRING [locale=STRING]

옵션

profile=STRING: 필수 옵션. KISA WHOIS 접속 프로파일 식별자. 단일 프로파일만 허용하며, 쉼표로 여러 개를 지정할 수 없습니다. 예: kisa_whois
locale=STRING: 선택 옵션. 출력 언어. ko 또는 en 만 허용합니다. 해외 ASN는 레지스트리·국가 코드만 반환됩니다. (기본값: ko)

입력 필드

필드	타입	필수	설명
asn	문자열	Y	조회할 ASN. 예: `AS9700`

출력 필드

입력 레코드의 기존 컬럼은 그대로 유지되며, 아래 필드가 병합됩니다.

필드	타입	이름	설명
registry	문자열	관리 기관	자원을 관리하는 레지스트리. 예: `KISA`
country	문자열	국가 코드	ISO 2 국가 코드. 예: `KR`
asn	문자열	ASN	ASN. 예: `AS9700`
as_name	문자열	AS 이름	AS 이름
org_name	문자열	할당기관	AS 할당 기관명
org_address	문자열	할당기관 주소	AS 할당 기관 주소
org_postal_code	문자열	할당기관 우편번호	AS 할당 기관 우편번호
tech_name	문자열	담당자	기술 담당자 이름
tech_phone	문자열	담당자 전화번호	기술 담당자 전화번호
tech_email	문자열	담당자 이메일	기술 담당자 이메일. 예: `user@example.com`
_error	문자열	에러	유효하지 않은 입력 또는 API 호출 실패 메시지

오류 코드

파싱 오류

오류 메시지	원인	해결
KISA WHOIS 프로파일 이름을 입력하세요.	`profile` 옵션 누락	`profile=` 에 단일 프로파일 지정
여러 프로파일은 허용되지 않습니다. 단일 KISA WHOIS 프로파일을 입력하세요.	`profile` 에 쉼표로 여러 개 지정	단일 프로파일만 지정
유효하지 않은 locale 입니다. 'ko' 또는 'en'을 사용하세요.	`locale` 값이 `ko`/`en` 이 아님	`locale=ko` 또는 `locale=en`

런타임 오류

일괄 처리 명령어는 행별 오류로 쿼리를 중단하지 않고, 해당 행의 _error 필드에 메시지를 기록한 뒤 다음 행으로 진행합니다.

`_error` 값	원인	해결
asn field is null or empty	입력 행에 `asn` 컬럼 누락/빈 값	`asn` 컬럼을 채워 입력
no available KISA WHOIS profile	프로파일 사용 불가	프로파일 등록 상태 점검
KISA WHOIS API daily quota exceeded - 일일 호출 제한을 초과하였습니다.	일일 호출 한도 초과	다음 날까지 대기하거나 한도 상향
KISA WHOIS API rate limit exceeded - 호출 속도 제한을 초과하였습니다. ...	호출 속도 제한	잠시 후 재시도

설명

이 명령어는 파이프로 들어온 각 입력 레코드의 asn 컬럼 값을 KISA WHOIS OpenAPI(/B551505/whois/as_number)로 조회하여, 조회 결과 필드를 해당 레코드에 병합한 뒤 다음 단계로 전달합니다. 단일 프로파일에 대해 동작하므로 profile 옵션은 필수이며 쉼표로 여러 프로파일을 지정할 수 없습니다.

asn 컬럼이 비어 있거나 API 호출이 실패하면 쿼리 전체를 중단시키지 않고 해당 행의 _error 필드에 사유를 기록합니다. 따라서 처리 후 _error 가 비어 있는 행만 정상 조회된 결과입니다. KRNIC 관리 대상이 아닌 해외 ASN은 registry·country 만 채워집니다. 공공데이터포털 인증키 단위로 일일 호출 한도·속도 제한이 적용되므로, 대량 입력 시 한도 초과로 다수 행이 _error 처리될 수 있습니다.

단건 조회는 kisa-whois-asn 명령어를 사용하세요.

사용 예

예시: 트래픽 상위 ASN의 운영 기관 일괄 보강

상황: 네트워크 플로우 로그에서 집계한 상위 출발지 ASN 목록의 운영 기관 정보를 한 번에 보강합니다.

table xxx
| stats sum(bytes) as total_bytes by src_asn
| sort -total_bytes
| limit 10
| rename src_asn as asn
| kisa-whois-asn-batch profile=kisa_whois
| fields asn, total_bytes, as_name, org_name, country, _error