matchnet()

matchnet() 함수는 지정한 네트워크 대역에 특정 IP 주소가 포함되어 있는지 확인합니다.

문법

매개변수

STR_GUID

네트워크 대역 GUID입니다. 유효한 네트워크 대역 식별자여야 합니다. 존재하지 않는 GUID를 지정하면 쿼리 파싱 단계에서 오류가 발생합니다.

IP_ADDR_EXPR

IP 주소 표현식입니다. IPv4 주소 타입 또는 IPv4 형식의 문자열만 허용됩니다. 허용되지 않는 타입이면 false를 반환합니다.

설명

matchnet() 함수는 지정한 네트워크 대역에 IP_ADDR_EXPR 값이 포함되어 있으면 true, 없으면 false를 반환합니다.

IP_ADDR_EXPR 값이 null이면 false를 반환합니다. IPv4 주소 타입이면 그대로 검색합니다. 문자열 타입이면 IPv4 주소로 변환한 후 검색합니다. IPv4 주소 또는 IPv4 형식의 문자열이 아닌 경우에는 false를 반환합니다.

네트워크 대역은 소나 웹 콘솔의 정책 > 네트워크 대역 메뉴에서 관리합니다.

오류 코드

해당 사항 없음

사용 예

1. src_ip 필드 값이 지정한 네트워크 대역에 포함되어 있는지 확인합니다.

   json "{'src_ip': '192.0.2.1'}"
   | eval result = matchnet("550e8400-e29b-41d4-a716-446655440000", src_ip)
   | # result: false
   

2. IP_ADDR_EXPR 값이 null인 경우

   json "{'src_ip': null}"
   | eval result = matchnet("550e8400-e29b-41d4-a716-446655440000", null)
   | # result: false
   

3. IP_ADDR_EXPR 값이 IPv4 형식이 아닌 경우

   json "{'src_ip': 'not-an-ip'}"
   | eval result = matchnet("550e8400-e29b-41d4-a716-446655440000", src_ip)
   | # result: false
   

호환성

matchnet() 함수는 소나 4.0 이전 버전부터 제공되었습니다.