다음을 통해 공유


Farsight DNSDB

Farsight Security DNSDB는 글로벌 인터넷 인프라의 구성에 대한 사실 기반 보기를 제공하는 세계 최대의 DNS 인텔리전스 데이터베이스입니다. DNSDB는 Farsight의 SIE(보안 정보 교환) 데이터 공유 플랫폼을 활용하며 선도적인 DNS 전문가가 설계하고 운영합니다. Farsight는 전역 센서 배열에서 수동 DNS 데이터를 수집, 필터링 및 확인합니다. DNSDB는 최고 품질의 가장 포괄적인 DNS 인텔리전스 데이터 서비스입니다.

이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.

서비스 클래스 Regions
Copilot Studio Premium 다음을 제외한 모든 Power Automate 지역 :
     - 미국 정부(GCC)
     - 미국 정부(GCC High)
     - 21Vianet에서 운영하는 중국 클라우드
     - 미국 국방부(DoD)
논리 앱 스탠다드 다음을 제외한 모든 Logic Apps 지역 :
     - Azure Government 지역
     - Azure 중국 지역
     - 미국 국방부(DoD)
Power Apps Premium 다음을 제외한 모든 Power Apps 지역 :
     - 미국 정부(GCC)
     - 미국 정부(GCC High)
     - 21Vianet에서 운영하는 중국 클라우드
     - 미국 국방부(DoD)
Power Automate Premium 다음을 제외한 모든 Power Automate 지역 :
     - 미국 정부(GCC)
     - 미국 정부(GCC High)
     - 21Vianet에서 운영하는 중국 클라우드
     - 미국 국방부(DoD)
연락처
이름 Farsight 보안 기술 지원
URL https://service.farsightsecurity.com/
전자 메일 support@farsightsecurity.com
커넥터 메타데이터
게시자 Farsight 보안
웹 사이트 https://www.farsightsecurity.com/
개인 정보 보호 정책 https://www.farsightsecurity.com/privacy-policy/
카테고리 안전; 데이터

Pre-requisites

계속하려면 다음이 필요합니다.

  • 사용자 지정 커넥터 기능이 있는 Microsoft Power Apps 또는 Power Automate 계획
  • Azure 구독
  • Farsight DNSDB API 키

자격 증명을 가져오는 방법

에서 https://www.farsightsecurity.com/solutions/dnsdb/ 무료 API 키를 등록합니다.

지원:

모든 지원 요청 및 일반 쿼리에 대해 문의 support@farsightsecurity.com 하거나 문의할 수 있습니다.

연결을 만드는 중

커넥터는 다음 인증 유형을 지원합니다.

기본값 연결을 만들기 위한 매개 변수입니다. 모든 지역 공유할 수 없음

기본값

적용 가능: 모든 지역

연결을 만들기 위한 매개 변수입니다.

공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.

이름 유형 Description 필수
Farsight DNSDB API 키 시큐어스트링 (보안 문자열) 이 API에 대한 Farsight DNSDB API 키 진실

제한 한도

Name 호출 갱신 기간
연결당 API 호출 100 60초

동작

Ping

이 요청은 DNSDB API 엔드포인트에 대한 종단 간 연결 테스트를 위한 것으로, 방화벽 차단이 없음을 알려줍니다. 이 요청에는 API 키가 필요하지 않습니다. JSON 개체 {'ping': 'ok'}만 반환합니다.

RData 조회

RData 조회는 RData 레코드 값에 따라 역 조회를 지원하는 DNSDB의 Rdata 인덱스를 쿼리합니다.

RRSet 조회

RRSet 조회는 RRset의 소유자 이름에 따라 앞으로 조회를 지원하는 DNSDB의 RRset 인덱스를 쿼리합니다.

RRType 및 Bailiwick을 사용하여 RRSet 조회

RRSet 조회는 RRset의 소유자 이름에 따라 앞으로 조회를 지원하는 DNSDB의 RRset 인덱스를 쿼리합니다.

RRType을 사용하여 RData 조회

RData 조회는 RData 레코드 값에 따라 역 조회를 지원하는 DNSDB의 Rdata 인덱스를 쿼리합니다.

RRType을 사용하여 RRSet 조회

RRSet 조회는 RRset의 소유자 이름에 따라 앞으로 조회를 지원하는 DNSDB의 RRset 인덱스를 쿼리합니다.

서비스 제한

서비스 제한 검색

유연한 검색

유연한 검색은 DNSDB API에 정규식 및 Globbing 지원을 모두 추가하여 검색 쿼리 유형을 확장하고 검색에 더 많은 컨트롤을 추가합니다.

Ping

이 요청은 DNSDB API 엔드포인트에 대한 종단 간 연결 테스트를 위한 것으로, 방화벽 차단이 없음을 알려줍니다. 이 요청에는 API 키가 필요하지 않습니다. JSON 개체 {'ping': 'ok'}만 반환합니다.

반환

Name 경로 형식 Description
ping
ping string

ping

RData 조회

RData 조회는 RData 레코드 값에 따라 역 조회를 지원하는 DNSDB의 Rdata 인덱스를 쿼리합니다.

매개 변수

Name 필수 형식 Description
type
type True string

쿼리 유형(이름, 원시) 이름: VALUE는 프레젠테이션 형식의 DNS 도메인 이름 또는 왼쪽('c.example.com') 또는 오른쪽('www.example.') 와일드카드 도메인 이름입니다. 왼쪽 와일드카드 쿼리는 오른쪽 와일드카드 쿼리보다 다소 비용이 많이 듭니다.,ip: VALUE는 접두사 길이 또는 주소 범위가 있는 IPv4 또는 IPv6 단일 주소 중 하나입니다. 접두사를 제공하는 경우 네트워크 주소와 접두사 길이 사이의 구분 기호는 HTTP URI 경로 이름 구분 기호와 충돌하지 않도록 일반적인 슬래시('/') 문자가 아닌 단일 쉼표(',') 문자입니다. raw: VALUE는 원시 8진수 문자열을 지정하는 짝수의 16진수 숫자입니다.

value
value True string

쿼리 값

time_first_before(Unix/Epoch 시간)
time_first_before number

DNS 레코드가 처음 관찰된 시점의 정의된 타임스탬프 앞에 결과를 제공합니다. 예를 들어 URL 매개 변수 'time_first_before=1420070400'은 2015년 1월 1일 이전에 처음 관찰되었거나 이전보다 오래된 DNS 레코드만 제공합니다.

time_first_after(Unix/Epoch 시간)
time_first_after number

DNS 레코드가 처음 관찰된 시간에 대해 정의된 타임스탬프 이후의 결과를 제공합니다. 예를 들어 URL 매개 변수 'time_first_after=-31536000'은 작년에 처음 관찰된 결과만 제공합니다.

time_last_before(Unix/Epoch 시간)
time_last_before number

DNS 레코드가 마지막으로 관찰된 시간에 대해 정의된 타임스탬프 앞에 결과를 제공합니다. 예를 들어 URL 매개 변수 'time_last_before=1356998400'은 2013년 이전에 마지막으로 관찰된 DNS 레코드에 대한 결과만 제공합니다.

time_last_after(Unix/Epoch 시간)
time_last_after number

DNS 레코드가 마지막으로 관찰된 시간에 대해 정의된 타임스탬프 이후의 결과를 제공합니다. 예를 들어 URL 매개 변수 'time_last_after=-2678400'은 31일 전에 마지막으로 관찰된 결과만 제공합니다.

limit
limit number

이러한 조회 메서드를 통해 반환되는 결과 수에 대한 제한입니다. 이러한 조회 메서드를 통해 반환되는 결과 수에는 기본 제공 제한이 있습니다. 기본 제한은 10,000으로 설정됩니다. 이 제한은 'limit' 쿼리 매개 변수를 설정하여 늘리거나 낮출 수 있습니다. 최대 결과 수도 허용됩니다. 최대값보다 큰 제한을 요청하면 최대값만 반환됩니다. 해당 최대값에 대한 자세한 내용은 아래 results_max 참조하세요. '?limit=0'을 사용하는 경우 DNSDB는 허용되는 최대 결과 수를 반환합니다. 요청된 한도보다 쿼리에 대한 결과가 적으면 실제 크기만 반환할 수 있습니다.

aggr
aggr boolean

집계된 결과 그룹은 모든 기간 동안 동일한 rrsets를 그룹화하며 DNSDB 쿼리의 클래식 동작입니다. 즉, rrset이 관찰된 총 횟수를 가져올 수 있지만 관찰된 횟수는 가져올 수 없습니다. 집계되지 않은 결과는 동일한 rrsets의 그룹을 해제하여 DNSDB에서 다루는 전체 시간 범위(시간 펜싱에 따라 다름)에서 도메인 이름이 어떻게 확인되었는지 확인할 수 있습니다. 이렇게 하면 값이 반복되는 레코드의 고유한 타임스탬프가 표시되므로 시간이 지남에 따라 레코드 요청 볼륨의 더 정확한 인상을 줄 수 있습니다. '도메인이 맬웨어를 제공하거나 스팸을 릴레이하기 위해 용도가 변경될 때까지 대부분 사용되지 않고 오랫동안 주차되었으나 다시 중단되었습니까?' 같은 질문에 대답할 수 있습니다. 지난 주에 기록과 수년 동안 지속적으로 관찰된 기록이 많이 관찰되었는지 확인할 수 있습니다. 부울 값입니다. 집계된 결과에는 기본값인 True를 사용하고 집계되지 않은 결과에는 False를 사용합니다.

humantime
humantime boolean

시간 값(time_first, time_last, zone_time_first, zone_time_last)이 사람이 읽을 수 있는 형식(RFC3339 규격) 형식으로 반환되거나 Epoch가 반환된 후 Unix 스타일 시간 값이 초 단위인 경우 False인 경우 True인 부울 값입니다. False는 DNSDB 쿼리의 클래식 동작이며 이 옵션의 기본값입니다.

offset
offset number

결과에서 오프셋할 행 수(예: 건너뛰기)입니다. 이렇게 하면 증분 결과 전송 기능이 구현되므로 단일 쿼리에 사용 가능한 결과를 더 많이 볼 수 있습니다. 행은 제한 매개 변수가 적용되기 전에 오프셋되므로 최대 결과 수와 일치하는 제한을 초과하는 추가 결과를 볼 수 있습니다. DNSDB는 각 쿼리에 대한 결과를 다시 계산하며 결과 순서가 유지되지 않을 수 있습니다. 따라서 이 기능은 여러 쿼리를 통해 모든 결과를 안내하는 유효한 방법이 아닙니다. 일부 결과가 누락되고 일부는 중복될 수 있습니다. 사용할 수 있는 실제 오프셋은 제한되거나 특정 API 키의 경우 오프셋이 허용되지 않습니다. 아래 offset_max rate_limit 키를 참조하세요. 오프셋 값은 양의 정수여야 합니다. 기본값은 0입니다. 즉, 행을 오프셋하지 않습니다.

반환

RRSet 조회

RRSet 조회는 RRset의 소유자 이름에 따라 앞으로 조회를 지원하는 DNSDB의 RRset 인덱스를 쿼리합니다.

매개 변수

Name 필수 형식 Description
type
type True string

쿼리 유형(이름, 원시) 이름: VALUE는 아래 설명된 대로 프레젠테이션 형식 또는 와일드카드의 DNS 소유자 이름입니다. 때때로 이것을 단지 rrset 검색, 원시라고 부릅니다. VALUE는 원시 옥텟 문자열을 지정하는 짝수의 16진수 숫자입니다.

value
value True string

쿼리 값

time_first_before(Unix/Epoch 시간)
time_first_before number

DNS 레코드가 처음 관찰된 시점의 정의된 타임스탬프 앞에 결과를 제공합니다. 예를 들어 URL 매개 변수 'time_first_before=1420070400'은 2015년 1월 1일 이전에 처음 관찰되었거나 이전보다 오래된 DNS 레코드만 제공합니다.

time_first_after(Unix/Epoch 시간)
time_first_after number

DNS 레코드가 처음 관찰된 시간에 대해 정의된 타임스탬프 이후의 결과를 제공합니다. 예를 들어 URL 매개 변수 'time_first_after=-31536000'은 작년에 처음 관찰된 결과만 제공합니다.

time_last_before(Unix/Epoch 시간)
time_last_before number

DNS 레코드가 마지막으로 관찰된 시간에 대해 정의된 타임스탬프 앞에 결과를 제공합니다. 예를 들어 URL 매개 변수 'time_last_before=1356998400'은 2013년 이전에 마지막으로 관찰된 DNS 레코드에 대한 결과만 제공합니다.

time_last_after(Unix/Epoch 시간)
time_last_after number

DNS 레코드가 마지막으로 관찰된 시간에 대해 정의된 타임스탬프 이후의 결과를 제공합니다. 예를 들어 URL 매개 변수 'time_last_after=-2678400'은 31일 전에 마지막으로 관찰된 결과만 제공합니다.

limit
limit number

이러한 조회 메서드를 통해 반환되는 결과 수에 대한 제한입니다. 이러한 조회 메서드를 통해 반환되는 결과 수에는 기본 제공 제한이 있습니다. 기본 제한은 10,000으로 설정됩니다. 이 제한은 'limit' 쿼리 매개 변수를 설정하여 늘리거나 낮출 수 있습니다. 최대 결과 수도 허용됩니다. 최대값보다 큰 제한을 요청하면 최대값만 반환됩니다. 해당 최대값에 대한 자세한 내용은 아래 results_max 참조하세요. '?limit=0'을 사용하는 경우 DNSDB는 허용되는 최대 결과 수를 반환합니다. 요청된 한도보다 쿼리에 대한 결과가 적으면 실제 크기만 반환할 수 있습니다.

aggr
aggr boolean

집계된 결과 그룹은 모든 기간 동안 동일한 rrsets를 그룹화하며 DNSDB 쿼리의 클래식 동작입니다. 즉, rrset이 관찰된 총 횟수를 가져올 수 있지만 관찰된 횟수는 가져올 수 없습니다. 집계되지 않은 결과는 동일한 rrsets의 그룹을 해제하여 DNSDB에서 다루는 전체 시간 범위(시간 펜싱에 따라 다름)에서 도메인 이름이 어떻게 확인되었는지 확인할 수 있습니다. 이렇게 하면 값이 반복되는 레코드의 고유한 타임스탬프가 표시되므로 시간이 지남에 따라 레코드 요청 볼륨의 더 정확한 인상을 줄 수 있습니다. '도메인이 맬웨어를 제공하거나 스팸을 릴레이하기 위해 용도가 변경될 때까지 대부분 사용되지 않고 오랫동안 주차되었으나 다시 중단되었습니까?' 같은 질문에 대답할 수 있습니다. 지난 주에 기록과 수년 동안 지속적으로 관찰된 기록이 많이 관찰되었는지 확인할 수 있습니다. 부울 값입니다. 집계된 결과에는 기본값인 True를 사용하고 집계되지 않은 결과에는 False를 사용합니다.

humantime
humantime boolean

시간 값(time_first, time_last, zone_time_first, zone_time_last)이 사람이 읽을 수 있는 형식(RFC3339 규격) 형식으로 반환되거나 Epoch가 반환된 후 Unix 스타일 시간 값이 초 단위인 경우 False인 경우 True인 부울 값입니다. False는 DNSDB 쿼리의 클래식 동작이며 이 옵션의 기본값입니다.

offset
offset number

결과에서 오프셋할 행 수(예: 건너뛰기)입니다. 이렇게 하면 증분 결과 전송 기능이 구현되므로 단일 쿼리에 사용 가능한 결과를 더 많이 볼 수 있습니다. 행은 제한 매개 변수가 적용되기 전에 오프셋되므로 최대 결과 수와 일치하는 제한을 초과하는 추가 결과를 볼 수 있습니다. DNSDB는 각 쿼리에 대한 결과를 다시 계산하며 결과 순서가 유지되지 않을 수 있습니다. 따라서 이 기능은 여러 쿼리를 통해 모든 결과를 안내하는 유효한 방법이 아닙니다. 일부 결과가 누락되고 일부는 중복될 수 있습니다. 사용할 수 있는 실제 오프셋은 제한되거나 특정 API 키의 경우 오프셋이 허용되지 않습니다. 아래 offset_max rate_limit 키를 참조하세요. 오프셋 값은 양의 정수여야 합니다. 기본값은 0입니다. 즉, 행을 오프셋하지 않습니다.

반환

RRType 및 Bailiwick을 사용하여 RRSet 조회

RRSet 조회는 RRset의 소유자 이름에 따라 앞으로 조회를 지원하는 DNSDB의 RRset 인덱스를 쿼리합니다.

매개 변수

Name 필수 형식 Description
type
type True string

쿼리 유형(이름, 원시) 이름: VALUE는 아래 설명된 대로 프레젠테이션 형식 또는 와일드카드의 DNS 소유자 이름입니다. 때때로 이것을 단지 rrset 검색, 원시라고 부릅니다. VALUE는 원시 옥텟 문자열을 지정하는 짝수의 16진수 숫자입니다.

value
value True string

쿼리 값

rrtype
rrtype True string

쿼리 rrtype

바이리윅 주
bailiwick True string

쿼리 bailiwick

time_first_before(Unix/Epoch 시간)
time_first_before number

DNS 레코드가 처음 관찰된 시점의 정의된 타임스탬프 앞에 결과를 제공합니다. 예를 들어 URL 매개 변수 'time_first_before=1420070400'은 2015년 1월 1일 이전에 처음 관찰되었거나 이전보다 오래된 DNS 레코드만 제공합니다.

time_first_after(Unix/Epoch 시간)
time_first_after number

DNS 레코드가 처음 관찰된 시간에 대해 정의된 타임스탬프 이후의 결과를 제공합니다. 예를 들어 URL 매개 변수 'time_first_after=-31536000'은 작년에 처음 관찰된 결과만 제공합니다.

time_last_before(Unix/Epoch 시간)
time_last_before number

DNS 레코드가 마지막으로 관찰된 시간에 대해 정의된 타임스탬프 앞에 결과를 제공합니다. 예를 들어 URL 매개 변수 'time_last_before=1356998400'은 2013년 이전에 마지막으로 관찰된 DNS 레코드에 대한 결과만 제공합니다.

time_last_after(Unix/Epoch 시간)
time_last_after number

DNS 레코드가 마지막으로 관찰된 시간에 대해 정의된 타임스탬프 이후의 결과를 제공합니다. 예를 들어 URL 매개 변수 'time_last_after=-2678400'은 31일 전에 마지막으로 관찰된 결과만 제공합니다.

limit
limit number

이러한 조회 메서드를 통해 반환되는 결과 수에 대한 제한입니다. 이러한 조회 메서드를 통해 반환되는 결과 수에는 기본 제공 제한이 있습니다. 기본 제한은 10,000으로 설정됩니다. 이 제한은 'limit' 쿼리 매개 변수를 설정하여 늘리거나 낮출 수 있습니다. 최대 결과 수도 허용됩니다. 최대값보다 큰 제한을 요청하면 최대값만 반환됩니다. 해당 최대값에 대한 자세한 내용은 아래 results_max 참조하세요. '?limit=0'을 사용하는 경우 DNSDB는 허용되는 최대 결과 수를 반환합니다. 요청된 한도보다 쿼리에 대한 결과가 적으면 실제 크기만 반환할 수 있습니다.

aggr
aggr boolean

집계된 결과 그룹은 모든 기간 동안 동일한 rrsets를 그룹화하며 DNSDB 쿼리의 클래식 동작입니다. 즉, rrset이 관찰된 총 횟수를 가져올 수 있지만 관찰된 횟수는 가져올 수 없습니다. 집계되지 않은 결과는 동일한 rrsets의 그룹을 해제하여 DNSDB에서 다루는 전체 시간 범위(시간 펜싱에 따라 다름)에서 도메인 이름이 어떻게 확인되었는지 확인할 수 있습니다. 이렇게 하면 값이 반복되는 레코드의 고유한 타임스탬프가 표시되므로 시간이 지남에 따라 레코드 요청 볼륨의 더 정확한 인상을 줄 수 있습니다. '도메인이 맬웨어를 제공하거나 스팸을 릴레이하기 위해 용도가 변경될 때까지 대부분 사용되지 않고 오랫동안 주차되었으나 다시 중단되었습니까?' 같은 질문에 대답할 수 있습니다. 지난 주에 기록과 수년 동안 지속적으로 관찰된 기록이 많이 관찰되었는지 확인할 수 있습니다. 부울 값입니다. 집계된 결과에는 기본값인 True를 사용하고 집계되지 않은 결과에는 False를 사용합니다.

humantime
humantime boolean

시간 값(time_first, time_last, zone_time_first, zone_time_last)이 사람이 읽을 수 있는 형식(RFC3339 규격) 형식으로 반환되거나 Epoch가 반환된 후 Unix 스타일 시간 값이 초 단위인 경우 False인 경우 True인 부울 값입니다. False는 DNSDB 쿼리의 클래식 동작이며 이 옵션의 기본값입니다.

offset
offset number

결과에서 오프셋할 행 수(예: 건너뛰기)입니다. 이렇게 하면 증분 결과 전송 기능이 구현되므로 단일 쿼리에 사용 가능한 결과를 더 많이 볼 수 있습니다. 행은 제한 매개 변수가 적용되기 전에 오프셋되므로 최대 결과 수와 일치하는 제한을 초과하는 추가 결과를 볼 수 있습니다. DNSDB는 각 쿼리에 대한 결과를 다시 계산하며 결과 순서가 유지되지 않을 수 있습니다. 따라서 이 기능은 여러 쿼리를 통해 모든 결과를 안내하는 유효한 방법이 아닙니다. 일부 결과가 누락되고 일부는 중복될 수 있습니다. 사용할 수 있는 실제 오프셋은 제한되거나 특정 API 키의 경우 오프셋이 허용되지 않습니다. 아래 offset_max rate_limit 키를 참조하세요. 오프셋 값은 양의 정수여야 합니다. 기본값은 0입니다. 즉, 행을 오프셋하지 않습니다.

반환

RRType을 사용하여 RData 조회

RData 조회는 RData 레코드 값에 따라 역 조회를 지원하는 DNSDB의 Rdata 인덱스를 쿼리합니다.

매개 변수

Name 필수 형식 Description
type
type True string

쿼리 유형(이름, 원시) 이름: VALUE는 프레젠테이션 형식의 DNS 도메인 이름 또는 왼쪽('c.example.com') 또는 오른쪽('www.example.') 와일드카드 도메인 이름입니다. 왼쪽 와일드카드 쿼리는 오른쪽 와일드카드 쿼리보다 다소 비용이 많이 듭니다.,ip: VALUE는 접두사 길이 또는 주소 범위가 있는 IPv4 또는 IPv6 단일 주소 중 하나입니다. 접두사를 제공하는 경우 네트워크 주소와 접두사 길이 사이의 구분 기호는 HTTP URI 경로 이름 구분 기호와 충돌하지 않도록 일반적인 슬래시('/') 문자가 아닌 단일 쉼표(',') 문자입니다. raw: VALUE는 원시 8진수 문자열을 지정하는 짝수의 16진수 숫자입니다.

value
value True string

쿼리 값

rrtype
rrtype True string

쿼리 rrtype

time_first_before(Unix/Epoch 시간)
time_first_before number

DNS 레코드가 처음 관찰된 시점의 정의된 타임스탬프 앞에 결과를 제공합니다. 예를 들어 URL 매개 변수 'time_first_before=1420070400'은 2015년 1월 1일 이전에 처음 관찰되었거나 이전보다 오래된 DNS 레코드만 제공합니다.

time_first_after(Unix/Epoch 시간)
time_first_after number

DNS 레코드가 처음 관찰된 시간에 대해 정의된 타임스탬프 이후의 결과를 제공합니다. 예를 들어 URL 매개 변수 'time_first_after=-31536000'은 작년에 처음 관찰된 결과만 제공합니다.

time_last_before(Unix/Epoch 시간)
time_last_before number

DNS 레코드가 마지막으로 관찰된 시간에 대해 정의된 타임스탬프 앞에 결과를 제공합니다. 예를 들어 URL 매개 변수 'time_last_before=1356998400'은 2013년 이전에 마지막으로 관찰된 DNS 레코드에 대한 결과만 제공합니다.

time_last_after(Unix/Epoch 시간)
time_last_after number

DNS 레코드가 마지막으로 관찰된 시간에 대해 정의된 타임스탬프 이후의 결과를 제공합니다. 예를 들어 URL 매개 변수 'time_last_after=-2678400'은 31일 전에 마지막으로 관찰된 결과만 제공합니다.

limit
limit number

이러한 조회 메서드를 통해 반환되는 결과 수에 대한 제한입니다. 이러한 조회 메서드를 통해 반환되는 결과 수에는 기본 제공 제한이 있습니다. 기본 제한은 10,000으로 설정됩니다. 이 제한은 'limit' 쿼리 매개 변수를 설정하여 늘리거나 낮출 수 있습니다. 최대 결과 수도 허용됩니다. 최대값보다 큰 제한을 요청하면 최대값만 반환됩니다. 해당 최대값에 대한 자세한 내용은 아래 results_max 참조하세요. '?limit=0'을 사용하는 경우 DNSDB는 허용되는 최대 결과 수를 반환합니다. 요청된 한도보다 쿼리에 대한 결과가 적으면 실제 크기만 반환할 수 있습니다.

aggr
aggr boolean

집계된 결과 그룹은 모든 기간 동안 동일한 rrsets를 그룹화하며 DNSDB 쿼리의 클래식 동작입니다. 즉, rrset이 관찰된 총 횟수를 가져올 수 있지만 관찰된 횟수는 가져올 수 없습니다. 집계되지 않은 결과는 동일한 rrsets의 그룹을 해제하여 DNSDB에서 다루는 전체 시간 범위(시간 펜싱에 따라 다름)에서 도메인 이름이 어떻게 확인되었는지 확인할 수 있습니다. 이렇게 하면 값이 반복되는 레코드의 고유한 타임스탬프가 표시되므로 시간이 지남에 따라 레코드 요청 볼륨의 더 정확한 인상을 줄 수 있습니다. '도메인이 맬웨어를 제공하거나 스팸을 릴레이하기 위해 용도가 변경될 때까지 대부분 사용되지 않고 오랫동안 주차되었으나 다시 중단되었습니까?' 같은 질문에 대답할 수 있습니다. 지난 주에 기록과 수년 동안 지속적으로 관찰된 기록이 많이 관찰되었는지 확인할 수 있습니다. 부울 값입니다. 집계된 결과에는 기본값인 True를 사용하고 집계되지 않은 결과에는 False를 사용합니다.

humantime
humantime boolean

시간 값(time_first, time_last, zone_time_first, zone_time_last)이 사람이 읽을 수 있는 형식(RFC3339 규격) 형식으로 반환되거나 Epoch가 반환된 후 Unix 스타일 시간 값이 초 단위인 경우 False인 경우 True인 부울 값입니다. False는 DNSDB 쿼리의 클래식 동작이며 이 옵션의 기본값입니다.

offset
offset number

결과에서 오프셋할 행 수(예: 건너뛰기)입니다. 이렇게 하면 증분 결과 전송 기능이 구현되므로 단일 쿼리에 사용 가능한 결과를 더 많이 볼 수 있습니다. 행은 제한 매개 변수가 적용되기 전에 오프셋되므로 최대 결과 수와 일치하는 제한을 초과하는 추가 결과를 볼 수 있습니다. DNSDB는 각 쿼리에 대한 결과를 다시 계산하며 결과 순서가 유지되지 않을 수 있습니다. 따라서 이 기능은 여러 쿼리를 통해 모든 결과를 안내하는 유효한 방법이 아닙니다. 일부 결과가 누락되고 일부는 중복될 수 있습니다. 사용할 수 있는 실제 오프셋은 제한되거나 특정 API 키의 경우 오프셋이 허용되지 않습니다. 아래 offset_max rate_limit 키를 참조하세요. 오프셋 값은 양의 정수여야 합니다. 기본값은 0입니다. 즉, 행을 오프셋하지 않습니다.

반환

RRType을 사용하여 RRSet 조회

RRSet 조회는 RRset의 소유자 이름에 따라 앞으로 조회를 지원하는 DNSDB의 RRset 인덱스를 쿼리합니다.

매개 변수

Name 필수 형식 Description
type
type True string

쿼리 유형(이름, 원시) 이름: VALUE는 아래 설명된 대로 프레젠테이션 형식 또는 와일드카드의 DNS 소유자 이름입니다. 때때로 이것을 단지 rrset 검색, 원시라고 부릅니다. VALUE는 원시 옥텟 문자열을 지정하는 짝수의 16진수 숫자입니다.

value
value True string

쿼리 값

rrtype
rrtype True string

쿼리 rrtype

time_first_before(Unix/Epoch 시간)
time_first_before number

DNS 레코드가 처음 관찰된 시점의 정의된 타임스탬프 앞에 결과를 제공합니다. 예를 들어 URL 매개 변수 'time_first_before=1420070400'은 2015년 1월 1일 이전에 처음 관찰되었거나 이전보다 오래된 DNS 레코드만 제공합니다.

time_first_after(Unix/Epoch 시간)
time_first_after number

DNS 레코드가 처음 관찰된 시간에 대해 정의된 타임스탬프 이후의 결과를 제공합니다. 예를 들어 URL 매개 변수 'time_first_after=-31536000'은 작년에 처음 관찰된 결과만 제공합니다.

time_last_before(Unix/Epoch 시간)
time_last_before number

DNS 레코드가 마지막으로 관찰된 시간에 대해 정의된 타임스탬프 앞에 결과를 제공합니다. 예를 들어 URL 매개 변수 'time_last_before=1356998400'은 2013년 이전에 마지막으로 관찰된 DNS 레코드에 대한 결과만 제공합니다.

time_last_after(Unix/Epoch 시간)
time_last_after number

DNS 레코드가 마지막으로 관찰된 시간에 대해 정의된 타임스탬프 이후의 결과를 제공합니다. 예를 들어 URL 매개 변수 'time_last_after=-2678400'은 31일 전에 마지막으로 관찰된 결과만 제공합니다.

limit
limit number

이러한 조회 메서드를 통해 반환되는 결과 수에 대한 제한입니다. 이러한 조회 메서드를 통해 반환되는 결과 수에는 기본 제공 제한이 있습니다. 기본 제한은 10,000으로 설정됩니다. 이 제한은 'limit' 쿼리 매개 변수를 설정하여 늘리거나 낮출 수 있습니다. 최대 결과 수도 허용됩니다. 최대값보다 큰 제한을 요청하면 최대값만 반환됩니다. 해당 최대값에 대한 자세한 내용은 아래 results_max 참조하세요. '?limit=0'을 사용하는 경우 DNSDB는 허용되는 최대 결과 수를 반환합니다. 요청된 한도보다 쿼리에 대한 결과가 적으면 실제 크기만 반환할 수 있습니다.

aggr
aggr boolean

집계된 결과 그룹은 모든 기간 동안 동일한 rrsets를 그룹화하며 DNSDB 쿼리의 클래식 동작입니다. 즉, rrset이 관찰된 총 횟수를 가져올 수 있지만 관찰된 횟수는 가져올 수 없습니다. 집계되지 않은 결과는 동일한 rrsets의 그룹을 해제하여 DNSDB에서 다루는 전체 시간 범위(시간 펜싱에 따라 다름)에서 도메인 이름이 어떻게 확인되었는지 확인할 수 있습니다. 이렇게 하면 값이 반복되는 레코드의 고유한 타임스탬프가 표시되므로 시간이 지남에 따라 레코드 요청 볼륨의 더 정확한 인상을 줄 수 있습니다. '도메인이 맬웨어를 제공하거나 스팸을 릴레이하기 위해 용도가 변경될 때까지 대부분 사용되지 않고 오랫동안 주차되었으나 다시 중단되었습니까?' 같은 질문에 대답할 수 있습니다. 지난 주에 기록과 수년 동안 지속적으로 관찰된 기록이 많이 관찰되었는지 확인할 수 있습니다. 부울 값입니다. 집계된 결과에는 기본값인 True를 사용하고 집계되지 않은 결과에는 False를 사용합니다.

humantime
humantime boolean

시간 값(time_first, time_last, zone_time_first, zone_time_last)이 사람이 읽을 수 있는 형식(RFC3339 규격) 형식으로 반환되거나 Epoch가 반환된 후 Unix 스타일 시간 값이 초 단위인 경우 False인 경우 True인 부울 값입니다. False는 DNSDB 쿼리의 클래식 동작이며 이 옵션의 기본값입니다.

offset
offset number

결과에서 오프셋할 행 수(예: 건너뛰기)입니다. 이렇게 하면 증분 결과 전송 기능이 구현되므로 단일 쿼리에 사용 가능한 결과를 더 많이 볼 수 있습니다. 행은 제한 매개 변수가 적용되기 전에 오프셋되므로 최대 결과 수와 일치하는 제한을 초과하는 추가 결과를 볼 수 있습니다. DNSDB는 각 쿼리에 대한 결과를 다시 계산하며 결과 순서가 유지되지 않을 수 있습니다. 따라서 이 기능은 여러 쿼리를 통해 모든 결과를 안내하는 유효한 방법이 아닙니다. 일부 결과가 누락되고 일부는 중복될 수 있습니다. 사용할 수 있는 실제 오프셋은 제한되거나 특정 API 키의 경우 오프셋이 허용되지 않습니다. 아래 offset_max rate_limit 키를 참조하세요. 오프셋 값은 양의 정수여야 합니다. 기본값은 0입니다. 즉, 행을 오프셋하지 않습니다.

반환

서비스 제한

서비스 제한 검색

반환

유연한 검색

유연한 검색은 DNSDB API에 정규식 및 Globbing 지원을 모두 추가하여 검색 쿼리 유형을 확장하고 검색에 더 많은 컨트롤을 추가합니다.

매개 변수

Name 필수 형식 Description
method
method True string

flex search 메서드(regex - 정규식 검색, glob - 전체 와일드카드)

key
key True string

검색 키

value
value True string

쿼리 값

time_first_before(Unix/Epoch 시간)
time_first_before number

DNS 레코드가 처음 관찰된 시점의 정의된 타임스탬프 앞에 결과를 제공합니다. 예를 들어 URL 매개 변수 'time_first_before=1420070400'은 2015년 1월 1일 이전에 처음 관찰되었거나 이전보다 오래된 DNS 레코드만 제공합니다.

time_first_after(Unix/Epoch 시간)
time_first_after number

DNS 레코드가 처음 관찰된 시간에 대해 정의된 타임스탬프 이후의 결과를 제공합니다. 예를 들어 URL 매개 변수 'time_first_after=-31536000'은 작년에 처음 관찰된 결과만 제공합니다.

time_last_before(Unix/Epoch 시간)
time_last_before number

DNS 레코드가 마지막으로 관찰된 시간에 대해 정의된 타임스탬프 앞에 결과를 제공합니다. 예를 들어 URL 매개 변수 'time_last_before=1356998400'은 2013년 이전에 마지막으로 관찰된 DNS 레코드에 대한 결과만 제공합니다.

time_last_after(Unix/Epoch 시간)
time_last_after number

DNS 레코드가 마지막으로 관찰된 시간에 대해 정의된 타임스탬프 이후의 결과를 제공합니다. 예를 들어 URL 매개 변수 'time_last_after=-2678400'은 31일 전에 마지막으로 관찰된 결과만 제공합니다.

limit
limit number

이러한 조회 메서드를 통해 반환되는 결과 수에 대한 제한입니다. 이러한 조회 메서드를 통해 반환되는 결과 수에는 기본 제공 제한이 있습니다. 기본 제한은 10,000으로 설정됩니다. 이 제한은 'limit' 쿼리 매개 변수를 설정하여 늘리거나 낮출 수 있습니다. 최대 결과 수도 허용됩니다. 최대값보다 큰 제한을 요청하면 최대값만 반환됩니다. 해당 최대값에 대한 자세한 내용은 아래 results_max 참조하세요. '?limit=0'을 사용하는 경우 DNSDB는 허용되는 최대 결과 수를 반환합니다. 요청된 한도보다 쿼리에 대한 결과가 적으면 실제 크기만 반환할 수 있습니다.

제외
exclude string

'exclude' 매개 변수는 일치하는 결과를 제외(예: 필터 아웃)하는 데 사용됩니다. 이 표 아래에 설명되어 있습니다.

offset
offset number

결과에서 오프셋할 행 수(예: 건너뛰기)입니다. 이렇게 하면 증분 결과 전송 기능이 구현되므로 단일 쿼리에 사용 가능한 결과를 더 많이 볼 수 있습니다. 행은 제한 매개 변수가 적용되기 전에 오프셋되므로 최대 결과 수와 일치하는 제한을 초과하는 추가 결과를 볼 수 있습니다. DNSDB는 각 쿼리에 대한 결과를 다시 계산하며 결과 순서가 유지되지 않을 수 있습니다. 따라서 이 기능은 여러 쿼리를 통해 모든 결과를 안내하는 유효한 방법이 아닙니다. 일부 결과가 누락되고 일부는 중복될 수 있습니다. 사용할 수 있는 실제 오프셋은 제한되거나 특정 API 키의 경우 오프셋이 허용되지 않습니다. 아래 offset_max rate_limit 키를 참조하세요. 오프셋 값은 양의 정수여야 합니다. 기본값은 0입니다. 즉, 행을 오프셋하지 않습니다.

반환

정의

RRSet_Results

Name 경로 형식 Description
수량
count number

수동 DNS 복제를 통해 RRset이 관찰된 횟수입니다.

첫 번째 시간
time_first number

RRset이 처음으로 관찰된 시간입니다.

마지막 시간
time_last number

RRset이 관찰된 가장 최근의 시간입니다.

영역 시간 우선
zone_time_first number

영역 파일 가져오기를 통해 RRset이 처음으로 관찰된 경우입니다.

영역 시간 마지막 시간
zone_time_last number

영역 파일 가져오기를 통해 RRset이 마지막으로 관찰된 시간입니다.

RRName
rrname string

DNS 프레젠테이션 형식의 RRset 소유자 이름입니다.

RRType
rrtype string

표준 DNS 형식 니모닉 또는 RFC 3597 제네릭 형식을 사용하는 RRset의 리소스 레코드 형식입니다. 즉, 문자열 TYPE 바로 뒤에 10진수 RRtype 번호가 잇습니다.

바이리윅 주
bailiwick string

RRset을 제공한 이름 서버로 위임된 가장 가까운 바깥쪽 영역이거나 FromZoneFile이 True인 경우 RRset이 포함된 영역의 이름입니다.

RData
rdata array of string

하나 이상의 Rdata 값 배열입니다. Rdata 값은 rrtype 값에 따라 표준 프레젠테이션 형식으로 변환됩니다. 인코더에 RRset의 rrtype에 대한 형식별 프레젠테이션 형식이 없는 경우 RFC 3597 제네릭 Rdata 인코딩이 사용됩니다.

RData_Results

Name 경로 형식 Description
수량
count number

수동 DNS 복제를 통해 리소스 레코드가 관찰된 횟수입니다.

첫 번째 시간
time_first number

리소스 레코드가 처음으로 관찰된 시간입니다.

마지막 시간
time_last number

리소스 레코드가 관찰된 가장 최근 시간입니다.

영역 시간 우선
zone_time_first number

영역 파일 가져오기를 통해 리소스 레코드가 처음으로 관찰된 경우입니다.

영역 시간 마지막 시간
zone_time_last number

영역 파일 가져오기를 통해 리소스 레코드가 마지막으로 관찰된 시간입니다.

RRName
rrname string

DNS 프레젠테이션 형식의 리소스 레코드 소유자 이름입니다.

RRType
rrtype string

표준 DNS 형식 니모닉 또는 RFC 3597 제네릭 형식을 사용하는 리소스 레코드의 리소스 레코드 형식입니다. 즉, 문자열 TYPE 바로 뒤에 10진수 RRtype 번호가 잇습니다.

RData
rdata array of string

레코드 데이터 값입니다. Rdata 값은 rrtype 값에 따라 표준 프레젠테이션 형식으로 변환됩니다. 인코더에 리소스 레코드의 형식에 대한 형식별 프레젠테이션 형식이 없는 경우 RFC 3597 일반 Rdata 인코딩이 사용됩니다.

Flex_Results

Name 경로 형식 Description
RData
rdata string

레코드 데이터 값입니다.

RRName
rrname string

DNS 프레젠테이션 형식의 RRset 소유자 이름입니다.

RRType
rrtype string

표준 DNS 형식 니모닉 또는 RFC 3597 제네릭 형식을 사용하는 RRset/리소스 레코드의 리소스 레코드 형식입니다. 즉, 문자열 TYPE 바로 뒤에 10진수 RRtype 번호가 잇습니다.

RAW_RDATA
raw_rdata string

레코드 데이터 값은 원시 8진수 문자열을 지정하는 16진수 숫자 쌍입니다. 이 값은 rdata에 대한 자세한 내용을 얻기 위해 유연한 검색에서 표준 검색으로 피벗하는 데 사용됩니다.

RateLimit_Results

Name 경로 형식 Description
한계
limit number

수행할 수 있는 최대 API 조회 수입니다. 초기 할당량입니다.

나머지
remaining number

시간 기반 할당량의 경우: 다시 설정 시간까지 수행할 수 있는 나머지 API 조회 수입니다. 블록 기반 할당량의 경우: 블록 할당량의 나머지 API 조회 수입니다.

재설정
reset number

시간 기반 할당량의 경우: 할당량 한도가 다시 설정될 다음 시점을 나타내는 두 번째 세분성이 있는 UNIX epoch 타임스탬프입니다. 일반적으로 00:00(자정) UTC입니다. 블록 기반 할당량의 경우 값은 'n/a'입니다.

만료
expires number

블록 기반 할당량에만 존재합니다. 할당량이 만료되는 시기를 나타내는 두 번째 세분성이 있는 UNIX epoch 타임스탬프입니다.

ResultsMax
results_max number

이러한 조회 메서드에서 반환할 수 있는 최대 결과 수를 반환합니다. 제공된 경우 'limit' 쿼리 매개 변수를 재정의합니다. 예를 들어 URL 경로에 '?limit=20000'이 추가되지만 results_max=1000이면 최대 1000개의 결과만 반환됩니다.

OffsetMax
offset_max number

오프셋 쿼리 매개 변수가 될 수 있는 최대값입니다. 이 값이 더 높으면 HTTP 416 '요청된 범위가 만족할 수 없음' 응답 코드가 '오류: 허용되는 최대값보다 큰 오프셋 값'과 함께 반환됩니다. 값이 'n/a'이면 이 API 키에 대해 오프셋 매개 변수가 허용되지 않으며 유사한 416 오류가 생성됩니다.

버스트 크기 조정
burst_size number

이 burst_window 초 내에 수행할 수 있는 최대 API 조회 수입니다.

BurstWindow
burst_window number

쿼리 버스트가 측정되는 시간(초)입니다.