共用方式為


遠視DNSDB

Farsight Security DNSDB 是世界上最大的 DNS 情報資料庫,可提供全球網際網路基礎設施配置的基於事實的視圖。 DNSDB 利用 Farsight 的安全信息交換 (SIE) 數據共享平台,由領先的 DNS 專家設計和運營。 Farsight 從其全球感測器陣列收集、過濾和驗證被動 DNS 資料。 DNSDB 是同類產品中質量最高、最全面的 DNS 智能數據服務。

此連接器適用於以下產品和區域:

服務 Class Regions
副駕駛工作室 進階 除下列區域外的所有 Power Automate 區域
     - 美國政府 (GCC)
     - 美國政府(海灣合作委員會高中)
     - 由 21Vianet 營運的中國雲
     - 美國國防部 (DoD)
邏輯應用程式 標準 所有 Logic Apps 區域, 但下列區域除外:
     - Azure Government 區域
     - Azure 中國區域
     - 美國國防部 (DoD)
Power Apps 進階 除下列區域外的所有 Power Apps 區域
     - 美國政府 (GCC)
     - 美國政府(海灣合作委員會高中)
     - 由 21Vianet 營運的中國雲
     - 美國國防部 (DoD)
Power Automate(自動化服務) 進階 除下列區域外的所有 Power Automate 區域
     - 美國政府 (GCC)
     - 美國政府(海灣合作委員會高中)
     - 由 21Vianet 營運的中國雲
     - 美國國防部 (DoD)
連絡人​​
名稱 Farsight 安全技術支持
URL https://service.farsightsecurity.com/
Email support@farsightsecurity.com
連接器中繼資料
Publisher 遠見安全
網站 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或聯繫我們

正在建立連線

連接器支援下列驗證類型:

預設值 建立連線的參數。 所有區域 不可共享

預設

適用:所有地區

建立連線的參數。

這不是可共用的連線。 如果 Power App 與其他使用者共用,系統會明確提示其他使用者建立新連線。

名稱 類型 Description 為必填項目
Farsight DNSDB API 金鑰 securestring 此 API 的 Farsight DNSDB API 金鑰

節流限制

名稱 呼叫 續約期間
每個連線的 API 呼叫 100 60 秒

動作

Ping

此要求用於 DNSDB API 端點的端對端連線測試,讓您知道沒有防火牆封鎖。 此請求不需要 API 金鑰。 它只傳回一個 JSON 物件 {'ping': 'ok'}。

RData 查詢

RData 查詢會查詢 DNSDB 的 Rdata 索引,該索引支援根據 Rdata 記錄值進行反向查詢。

RRSet 查詢

RRSet 查閱會查詢 DNSDB 的 RRset 索引,該索引支援根據 RRset 的擁有者名稱進行正向查閱。

使用 RRType 和 Bailiwick 進行 RRSet 查詢

RRSet 查閱會查詢 DNSDB 的 RRset 索引,該索引支援根據 RRset 的擁有者名稱進行正向查閱。

使用 RRType 進行 RData 查找

RData 查詢會查詢 DNSDB 的 Rdata 索引,該索引支援根據 Rdata 記錄值進行反向查詢。

使用 RRType 進行 RRSet 查詢

RRSet 查閱會查詢 DNSDB 的 RRset 索引,該索引支援根據 RRset 的擁有者名稱進行正向查閱。

服務限制

擷取服務限制

靈活搜尋

彈性搜尋將正則運算式和 Globbing 支援新增至 DNSDB API,以擴充搜尋查詢的類型,並為搜尋新增更多控制。

Ping

此要求用於 DNSDB API 端點的端對端連線測試,讓您知道沒有防火牆封鎖。 此請求不需要 API 金鑰。 它只傳回一個 JSON 物件 {'ping': 'ok'}。

傳回

名稱 路徑 類型 Description
ping
ping string

ping

RData 查詢

RData 查詢會查詢 DNSDB 的 Rdata 索引,該索引支援根據 Rdata 記錄值進行反向查詢。

參數

名稱 機碼 必要 類型 Description
型別
type True string

查詢類型(名稱,原始)名稱:VALUE 是簡報格式的 DNS 網域名稱,或左側 ('c.example.com') 或右側 ('www.example.') 萬用字元網域名稱。 請注意,左側萬用字元查詢比右側萬用字元查詢更昂貴。,ip:VALUE 是 IPv4 或 IPv6 單一位址之一,具有前綴長度或位址範圍。 如果提供字首,則網路位址與字首長度之間的分隔符號是單一逗號 (',') 字元,而不是通常的斜線 ('/') 字元,以避免與 HTTP URI 路徑名稱分隔符號衝突。, raw: VALUE 是偶數十六進位數字,指定原始八位字串。

value
value True string

查詢值

time_first_before(Unix/紀元時間)
time_first_before number

在第一次觀察 DNS 記錄的定義時間戳記之前提供結果。 例如,URL 參數「time_first_before=1420070400」只會提供在 2015 年 1 月 1 日之前 (或更早) 首次觀察到的相符 DNS 記錄。

time_first_after(Unix/紀元時間)
time_first_after number

在定義的時間戳記之後提供第一次觀察 DNS 記錄的結果。 舉例來說,網址參數「time_first_after=-31536000」只會提供去年首次觀察到的結果。

time_last_before(Unix/紀元時間)
time_last_before number

在定義的時間戳記之前提供結果,以表示上次觀察 DNS 記錄的時間。 例如,URL 參數 'time_last_before=1356998400' 只會提供 2013 年之前最後觀察到的 DNS 記錄的結果。

time_last_after(Unix/紀元時間)
time_last_after number

在定義的時間戳記之後提供上次觀察 DNS 記錄的結果。 舉例來說,網址參數「time_last_after=-2678400」只會提供 31 天前最後一次觀察到的結果。

limit
limit number

透過這些查閱方法傳回的結果數目限制。 透過這些查閱方法傳回的結果數目有內建限制。 預設限制設定為 10,000。 可以透過設定 'limit' 查詢參數來提高或降低此限制。 還允許結果數量上限;請求大於最大值的限制只會傳回最大值。 有關該最大值的信息,請參閱下面的results_max。 如果使用 '?limit=0',則 DNSDB 將傳回允許的結果數目上限。 如果查詢的結果少於要求的限制,則只能傳回實際金額。

總計
aggr boolean

彙總結果會將所有時段內相同的 rrset 分組,這是查詢 DNSDB 的經典行為。 這表示您可以取得觀察到 rrset 的總次數,但無法取得觀察到的時間。 未彙總的結果會取消相同的 rrset 分組,讓您查看 DNSDB 涵蓋的全時範圍內 DNS 中網域名稱的解析方式 (受時間柵欄限制)。 這可以更準確地反映一段時間內的記錄請求量,因為它將顯示值重複的記錄的不同時間戳記。 您可以回答這樣的問題:“一個域名是否被停放了很長時間,大部分未使用,直到它被重新用於提供惡意軟件或中繼垃圾郵件,但隨後又被放棄了? 它允許您查看記錄是否在上週被大量觀察,還是多年來一直被觀察。 這是一個布林值。 針對彙總結果使用 True (預設值),或針對未彙總結果使用 False。

人類時間
humantime boolean

如果時間值 (以 time_first、time_last、zone_time_first、zone_time_last) 應以人類可讀 (符合 RFC3339) 格式傳回,則為 True,如果應傳回自紀元以來的 Unix 樣式時間值 (以秒為單位),則為 False。 False 是查詢 DNSDB 的傳統行為,也是此選項的預設值。

位移
offset number

在結果中偏移(例如略過)的行數。 這會實作增量結果傳輸功能,可讓您檢視單一查詢的更多可用結果。 列會在套用限制參數之前偏移,因此偏移允許查看超過符合結果數目上限的限制的其他結果。 請注意,DNSDB 會重新計算每個查詢的結果,而且可能不會保留結果的順序。 因此,這項功能不是在多個查詢上遍歷所有結果的有效方式 - 某些結果可能會遺失,有些結果可能會重複。 實際可以使用的偏移量是有限的,或者對於某些 API 金鑰,不允許偏移量 - 請參閱下面的offset_max rate_limit鍵。 偏移值必須是正整數。 預設值為 0,這表示不偏移列。

傳回

RRSet 查詢

RRSet 查閱會查詢 DNSDB 的 RRset 索引,該索引支援根據 RRset 的擁有者名稱進行正向查閱。

參數

名稱 機碼 必要 類型 Description
型別
type True string

查詢類型 (name, raw) 名稱:VALUE 是呈現格式或萬用字元的 DNS 擁有者名稱,如下所述。 我們有時稱之為 rrset 搜索,原始:VALUE 是指定原始八位字串的偶數十六進位數字。

value
value True string

查詢值

time_first_before(Unix/紀元時間)
time_first_before number

在第一次觀察 DNS 記錄的定義時間戳記之前提供結果。 例如,URL 參數「time_first_before=1420070400」只會提供在 2015 年 1 月 1 日之前 (或更早) 首次觀察到的相符 DNS 記錄。

time_first_after(Unix/紀元時間)
time_first_after number

在定義的時間戳記之後提供第一次觀察 DNS 記錄的結果。 舉例來說,網址參數「time_first_after=-31536000」只會提供去年首次觀察到的結果。

time_last_before(Unix/紀元時間)
time_last_before number

在定義的時間戳記之前提供結果,以表示上次觀察 DNS 記錄的時間。 例如,URL 參數 'time_last_before=1356998400' 只會提供 2013 年之前最後觀察到的 DNS 記錄的結果。

time_last_after(Unix/紀元時間)
time_last_after number

在定義的時間戳記之後提供上次觀察 DNS 記錄的結果。 舉例來說,網址參數「time_last_after=-2678400」只會提供 31 天前最後一次觀察到的結果。

limit
limit number

透過這些查閱方法傳回的結果數目限制。 透過這些查閱方法傳回的結果數目有內建限制。 預設限制設定為 10,000。 可以透過設定 'limit' 查詢參數來提高或降低此限制。 還允許結果數量上限;請求大於最大值的限制只會傳回最大值。 有關該最大值的信息,請參閱下面的results_max。 如果使用 '?limit=0',則 DNSDB 將傳回允許的結果數目上限。 如果查詢的結果少於要求的限制,則只能傳回實際金額。

總計
aggr boolean

彙總結果會將所有時段內相同的 rrset 分組,這是查詢 DNSDB 的經典行為。 這表示您可以取得觀察到 rrset 的總次數,但無法取得觀察到的時間。 未彙總的結果會取消相同的 rrset 分組,讓您查看 DNSDB 涵蓋的全時範圍內 DNS 中網域名稱的解析方式 (受時間柵欄限制)。 這可以更準確地反映一段時間內的記錄請求量,因為它將顯示值重複的記錄的不同時間戳記。 您可以回答這樣的問題:“一個域名是否被停放了很長時間,大部分未使用,直到它被重新用於提供惡意軟件或中繼垃圾郵件,但隨後又被放棄了? 它允許您查看記錄是否在上週被大量觀察,還是多年來一直被觀察。 這是一個布林值。 針對彙總結果使用 True (預設值),或針對未彙總結果使用 False。

人類時間
humantime boolean

如果時間值 (以 time_first、time_last、zone_time_first、zone_time_last) 應以人類可讀 (符合 RFC3339) 格式傳回,則為 True,如果應傳回自紀元以來的 Unix 樣式時間值 (以秒為單位),則為 False。 False 是查詢 DNSDB 的傳統行為,也是此選項的預設值。

位移
offset number

在結果中偏移(例如略過)的行數。 這會實作增量結果傳輸功能,可讓您檢視單一查詢的更多可用結果。 列會在套用限制參數之前偏移,因此偏移允許查看超過符合結果數目上限的限制的其他結果。 請注意,DNSDB 會重新計算每個查詢的結果,而且可能不會保留結果的順序。 因此,這項功能不是在多個查詢上遍歷所有結果的有效方式 - 某些結果可能會遺失,有些結果可能會重複。 實際可以使用的偏移量是有限的,或者對於某些 API 金鑰,不允許偏移量 - 請參閱下面的offset_max rate_limit鍵。 偏移值必須是正整數。 預設值為 0,這表示不偏移列。

傳回

使用 RRType 和 Bailiwick 進行 RRSet 查詢

RRSet 查閱會查詢 DNSDB 的 RRset 索引,該索引支援根據 RRset 的擁有者名稱進行正向查閱。

參數

名稱 機碼 必要 類型 Description
型別
type True string

查詢類型 (name, raw) 名稱:VALUE 是呈現格式或萬用字元的 DNS 擁有者名稱,如下所述。 我們有時稱之為 rrset 搜索,原始:VALUE 是指定原始八位字串的偶數十六進位數字。

value
value True string

查詢值

rr類型
rrtype True string

查詢 rrtype

管轄區
bailiwick True string

查詢管轄區

time_first_before(Unix/紀元時間)
time_first_before number

在第一次觀察 DNS 記錄的定義時間戳記之前提供結果。 例如,URL 參數「time_first_before=1420070400」只會提供在 2015 年 1 月 1 日之前 (或更早) 首次觀察到的相符 DNS 記錄。

time_first_after(Unix/紀元時間)
time_first_after number

在定義的時間戳記之後提供第一次觀察 DNS 記錄的結果。 舉例來說,網址參數「time_first_after=-31536000」只會提供去年首次觀察到的結果。

time_last_before(Unix/紀元時間)
time_last_before number

在定義的時間戳記之前提供結果,以表示上次觀察 DNS 記錄的時間。 例如,URL 參數 'time_last_before=1356998400' 只會提供 2013 年之前最後觀察到的 DNS 記錄的結果。

time_last_after(Unix/紀元時間)
time_last_after number

在定義的時間戳記之後提供上次觀察 DNS 記錄的結果。 舉例來說,網址參數「time_last_after=-2678400」只會提供 31 天前最後一次觀察到的結果。

limit
limit number

透過這些查閱方法傳回的結果數目限制。 透過這些查閱方法傳回的結果數目有內建限制。 預設限制設定為 10,000。 可以透過設定 'limit' 查詢參數來提高或降低此限制。 還允許結果數量上限;請求大於最大值的限制只會傳回最大值。 有關該最大值的信息,請參閱下面的results_max。 如果使用 '?limit=0',則 DNSDB 將傳回允許的結果數目上限。 如果查詢的結果少於要求的限制,則只能傳回實際金額。

總計
aggr boolean

彙總結果會將所有時段內相同的 rrset 分組,這是查詢 DNSDB 的經典行為。 這表示您可以取得觀察到 rrset 的總次數,但無法取得觀察到的時間。 未彙總的結果會取消相同的 rrset 分組,讓您查看 DNSDB 涵蓋的全時範圍內 DNS 中網域名稱的解析方式 (受時間柵欄限制)。 這可以更準確地反映一段時間內的記錄請求量,因為它將顯示值重複的記錄的不同時間戳記。 您可以回答這樣的問題:“一個域名是否被停放了很長時間,大部分未使用,直到它被重新用於提供惡意軟件或中繼垃圾郵件,但隨後又被放棄了? 它允許您查看記錄是否在上週被大量觀察,還是多年來一直被觀察。 這是一個布林值。 針對彙總結果使用 True (預設值),或針對未彙總結果使用 False。

人類時間
humantime boolean

如果時間值 (以 time_first、time_last、zone_time_first、zone_time_last) 應以人類可讀 (符合 RFC3339) 格式傳回,則為 True,如果應傳回自紀元以來的 Unix 樣式時間值 (以秒為單位),則為 False。 False 是查詢 DNSDB 的傳統行為,也是此選項的預設值。

位移
offset number

在結果中偏移(例如略過)的行數。 這會實作增量結果傳輸功能,可讓您檢視單一查詢的更多可用結果。 列會在套用限制參數之前偏移,因此偏移允許查看超過符合結果數目上限的限制的其他結果。 請注意,DNSDB 會重新計算每個查詢的結果,而且可能不會保留結果的順序。 因此,這項功能不是在多個查詢上遍歷所有結果的有效方式 - 某些結果可能會遺失,有些結果可能會重複。 實際可以使用的偏移量是有限的,或者對於某些 API 金鑰,不允許偏移量 - 請參閱下面的offset_max rate_limit鍵。 偏移值必須是正整數。 預設值為 0,這表示不偏移列。

傳回

使用 RRType 進行 RData 查找

RData 查詢會查詢 DNSDB 的 Rdata 索引,該索引支援根據 Rdata 記錄值進行反向查詢。

參數

名稱 機碼 必要 類型 Description
型別
type True string

查詢類型(名稱,原始)名稱:VALUE 是簡報格式的 DNS 網域名稱,或左側 ('c.example.com') 或右側 ('www.example.') 萬用字元網域名稱。 請注意,左側萬用字元查詢比右側萬用字元查詢更昂貴。,ip:VALUE 是 IPv4 或 IPv6 單一位址之一,具有前綴長度或位址範圍。 如果提供字首,則網路位址與字首長度之間的分隔符號是單一逗號 (',') 字元,而不是通常的斜線 ('/') 字元,以避免與 HTTP URI 路徑名稱分隔符號衝突。, raw: VALUE 是偶數十六進位數字,指定原始八位字串。

value
value True string

查詢值

rr類型
rrtype True string

查詢 rrtype

time_first_before(Unix/紀元時間)
time_first_before number

在第一次觀察 DNS 記錄的定義時間戳記之前提供結果。 例如,URL 參數「time_first_before=1420070400」只會提供在 2015 年 1 月 1 日之前 (或更早) 首次觀察到的相符 DNS 記錄。

time_first_after(Unix/紀元時間)
time_first_after number

在定義的時間戳記之後提供第一次觀察 DNS 記錄的結果。 舉例來說,網址參數「time_first_after=-31536000」只會提供去年首次觀察到的結果。

time_last_before(Unix/紀元時間)
time_last_before number

在定義的時間戳記之前提供結果,以表示上次觀察 DNS 記錄的時間。 例如,URL 參數 'time_last_before=1356998400' 只會提供 2013 年之前最後觀察到的 DNS 記錄的結果。

time_last_after(Unix/紀元時間)
time_last_after number

在定義的時間戳記之後提供上次觀察 DNS 記錄的結果。 舉例來說,網址參數「time_last_after=-2678400」只會提供 31 天前最後一次觀察到的結果。

limit
limit number

透過這些查閱方法傳回的結果數目限制。 透過這些查閱方法傳回的結果數目有內建限制。 預設限制設定為 10,000。 可以透過設定 'limit' 查詢參數來提高或降低此限制。 還允許結果數量上限;請求大於最大值的限制只會傳回最大值。 有關該最大值的信息,請參閱下面的results_max。 如果使用 '?limit=0',則 DNSDB 將傳回允許的結果數目上限。 如果查詢的結果少於要求的限制,則只能傳回實際金額。

總計
aggr boolean

彙總結果會將所有時段內相同的 rrset 分組,這是查詢 DNSDB 的經典行為。 這表示您可以取得觀察到 rrset 的總次數,但無法取得觀察到的時間。 未彙總的結果會取消相同的 rrset 分組,讓您查看 DNSDB 涵蓋的全時範圍內 DNS 中網域名稱的解析方式 (受時間柵欄限制)。 這可以更準確地反映一段時間內的記錄請求量,因為它將顯示值重複的記錄的不同時間戳記。 您可以回答這樣的問題:“一個域名是否被停放了很長時間,大部分未使用,直到它被重新用於提供惡意軟件或中繼垃圾郵件,但隨後又被放棄了? 它允許您查看記錄是否在上週被大量觀察,還是多年來一直被觀察。 這是一個布林值。 針對彙總結果使用 True (預設值),或針對未彙總結果使用 False。

人類時間
humantime boolean

如果時間值 (以 time_first、time_last、zone_time_first、zone_time_last) 應以人類可讀 (符合 RFC3339) 格式傳回,則為 True,如果應傳回自紀元以來的 Unix 樣式時間值 (以秒為單位),則為 False。 False 是查詢 DNSDB 的傳統行為,也是此選項的預設值。

位移
offset number

在結果中偏移(例如略過)的行數。 這會實作增量結果傳輸功能,可讓您檢視單一查詢的更多可用結果。 列會在套用限制參數之前偏移,因此偏移允許查看超過符合結果數目上限的限制的其他結果。 請注意,DNSDB 會重新計算每個查詢的結果,而且可能不會保留結果的順序。 因此,這項功能不是在多個查詢上遍歷所有結果的有效方式 - 某些結果可能會遺失,有些結果可能會重複。 實際可以使用的偏移量是有限的,或者對於某些 API 金鑰,不允許偏移量 - 請參閱下面的offset_max rate_limit鍵。 偏移值必須是正整數。 預設值為 0,這表示不偏移列。

傳回

使用 RRType 進行 RRSet 查詢

RRSet 查閱會查詢 DNSDB 的 RRset 索引,該索引支援根據 RRset 的擁有者名稱進行正向查閱。

參數

名稱 機碼 必要 類型 Description
型別
type True string

查詢類型 (name, raw) 名稱:VALUE 是呈現格式或萬用字元的 DNS 擁有者名稱,如下所述。 我們有時稱之為 rrset 搜索,原始:VALUE 是指定原始八位字串的偶數十六進位數字。

value
value True string

查詢值

rr類型
rrtype True string

查詢 rrtype

time_first_before(Unix/紀元時間)
time_first_before number

在第一次觀察 DNS 記錄的定義時間戳記之前提供結果。 例如,URL 參數「time_first_before=1420070400」只會提供在 2015 年 1 月 1 日之前 (或更早) 首次觀察到的相符 DNS 記錄。

time_first_after(Unix/紀元時間)
time_first_after number

在定義的時間戳記之後提供第一次觀察 DNS 記錄的結果。 舉例來說,網址參數「time_first_after=-31536000」只會提供去年首次觀察到的結果。

time_last_before(Unix/紀元時間)
time_last_before number

在定義的時間戳記之前提供結果,以表示上次觀察 DNS 記錄的時間。 例如,URL 參數 'time_last_before=1356998400' 只會提供 2013 年之前最後觀察到的 DNS 記錄的結果。

time_last_after(Unix/紀元時間)
time_last_after number

在定義的時間戳記之後提供上次觀察 DNS 記錄的結果。 舉例來說,網址參數「time_last_after=-2678400」只會提供 31 天前最後一次觀察到的結果。

limit
limit number

透過這些查閱方法傳回的結果數目限制。 透過這些查閱方法傳回的結果數目有內建限制。 預設限制設定為 10,000。 可以透過設定 'limit' 查詢參數來提高或降低此限制。 還允許結果數量上限;請求大於最大值的限制只會傳回最大值。 有關該最大值的信息,請參閱下面的results_max。 如果使用 '?limit=0',則 DNSDB 將傳回允許的結果數目上限。 如果查詢的結果少於要求的限制,則只能傳回實際金額。

總計
aggr boolean

彙總結果會將所有時段內相同的 rrset 分組,這是查詢 DNSDB 的經典行為。 這表示您可以取得觀察到 rrset 的總次數,但無法取得觀察到的時間。 未彙總的結果會取消相同的 rrset 分組,讓您查看 DNSDB 涵蓋的全時範圍內 DNS 中網域名稱的解析方式 (受時間柵欄限制)。 這可以更準確地反映一段時間內的記錄請求量,因為它將顯示值重複的記錄的不同時間戳記。 您可以回答這樣的問題:“一個域名是否被停放了很長時間,大部分未使用,直到它被重新用於提供惡意軟件或中繼垃圾郵件,但隨後又被放棄了? 它允許您查看記錄是否在上週被大量觀察,還是多年來一直被觀察。 這是一個布林值。 針對彙總結果使用 True (預設值),或針對未彙總結果使用 False。

人類時間
humantime boolean

如果時間值 (以 time_first、time_last、zone_time_first、zone_time_last) 應以人類可讀 (符合 RFC3339) 格式傳回,則為 True,如果應傳回自紀元以來的 Unix 樣式時間值 (以秒為單位),則為 False。 False 是查詢 DNSDB 的傳統行為,也是此選項的預設值。

位移
offset number

在結果中偏移(例如略過)的行數。 這會實作增量結果傳輸功能,可讓您檢視單一查詢的更多可用結果。 列會在套用限制參數之前偏移,因此偏移允許查看超過符合結果數目上限的限制的其他結果。 請注意,DNSDB 會重新計算每個查詢的結果,而且可能不會保留結果的順序。 因此,這項功能不是在多個查詢上遍歷所有結果的有效方式 - 某些結果可能會遺失,有些結果可能會重複。 實際可以使用的偏移量是有限的,或者對於某些 API 金鑰,不允許偏移量 - 請參閱下面的offset_max rate_limit鍵。 偏移值必須是正整數。 預設值為 0,這表示不偏移列。

傳回

服務限制

擷取服務限制

傳回

靈活搜尋

彈性搜尋將正則運算式和 Globbing 支援新增至 DNSDB API,以擴充搜尋查詢的類型,並為搜尋新增更多控制。

參數

名稱 機碼 必要 類型 Description
方法
method True string

flex 搜尋方法 (regex - 正則運算式搜尋,glob - 完整通配符)

Key
key True string

搜尋鍵

value
value True string

查詢值

time_first_before(Unix/紀元時間)
time_first_before number

在第一次觀察 DNS 記錄的定義時間戳記之前提供結果。 例如,URL 參數「time_first_before=1420070400」只會提供在 2015 年 1 月 1 日之前 (或更早) 首次觀察到的相符 DNS 記錄。

time_first_after(Unix/紀元時間)
time_first_after number

在定義的時間戳記之後提供第一次觀察 DNS 記錄的結果。 舉例來說,網址參數「time_first_after=-31536000」只會提供去年首次觀察到的結果。

time_last_before(Unix/紀元時間)
time_last_before number

在定義的時間戳記之前提供結果,以表示上次觀察 DNS 記錄的時間。 例如,URL 參數 'time_last_before=1356998400' 只會提供 2013 年之前最後觀察到的 DNS 記錄的結果。

time_last_after(Unix/紀元時間)
time_last_after number

在定義的時間戳記之後提供上次觀察 DNS 記錄的結果。 舉例來說,網址參數「time_last_after=-2678400」只會提供 31 天前最後一次觀察到的結果。

limit
limit number

透過這些查閱方法傳回的結果數目限制。 透過這些查閱方法傳回的結果數目有內建限制。 預設限制設定為 10,000。 可以透過設定 'limit' 查詢參數來提高或降低此限制。 還允許結果數量上限;請求大於最大值的限制只會傳回最大值。 有關該最大值的信息,請參閱下面的results_max。 如果使用 '?limit=0',則 DNSDB 將傳回允許的結果數目上限。 如果查詢的結果少於要求的限制,則只能傳回實際金額。

排除
exclude string

'exclude' 參數用於排除(即過濾掉)與其匹配的結果。 此表下方有說明。

位移
offset number

在結果中偏移(例如略過)的行數。 這會實作增量結果傳輸功能,可讓您檢視單一查詢的更多可用結果。 列會在套用限制參數之前偏移,因此偏移允許查看超過符合結果數目上限的限制的其他結果。 請注意,DNSDB 會重新計算每個查詢的結果,而且可能不會保留結果的順序。 因此,這項功能不是在多個查詢上遍歷所有結果的有效方式 - 某些結果可能會遺失,有些結果可能會重複。 實際可以使用的偏移量是有限的,或者對於某些 API 金鑰,不允許偏移量 - 請參閱下面的offset_max rate_limit鍵。 偏移值必須是正整數。 預設值為 0,這表示不偏移列。

傳回

定義

RRSet_Results

名稱 路徑 類型 Description
Count
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 擁有者名稱。

RR類型
rrtype string

RRset 的資源記錄類型,使用標準 DNS 類型助記符或 RFC 3597 泛型類型,即字串 TYPE 緊接十進位 RRtype 號碼。

轄區
bailiwick string

委派給提供 RRset 之名稱伺服器的最接近的封閉區域,或包含 RRset 的區域名稱 (如果 FromZoneFile 為 True)。

RData
rdata array of string

一或多個 Rdata 值的陣列。 Rdata 值會根據 rrtype 值轉換成標準呈現格式。 如果編碼器缺少 RRset 的 rrtype 類型特定呈現格式,則會使用 RFC 3597 泛型 Rdata 編碼。

RData_Results

名稱 路徑 類型 Description
Count
count number

透過被動 DNS 複寫觀察到資源記錄的次數。

時間優先
time_first number

第一次觀察資源記錄的時間。

最後時間
time_last number

觀察到資源記錄的最近時間。

區域時間優先
zone_time_first number

第一次透過區域檔案匯入觀察到資源記錄。

區域時間最後
zone_time_last number

上次透過區域檔案匯入觀察到資源記錄的時間。

RRName
rrname string

DNS 呈現格式的資源記錄擁有者名稱。

RR類型
rrtype string

資源記錄的資源記錄類型,使用標準 DNS 類型助記符或 RFC 3597 泛型類型,即字串 TYPE 緊接十進位 RRtype 號碼。

RData
rdata array of string

記錄資料值。 Rdata 值會根據 rrtype 值轉換成標準呈現格式。 如果編碼器缺少資源記錄類型的類型特定呈現格式,則會使用 RFC 3597 泛型 Rdata 編碼。

Flex_Results

名稱 路徑 類型 Description
RData
rdata string

記錄資料值。

RRName
rrname string

DNS 呈現格式的 RRset 擁有者名稱。

RR類型
rrtype string

RRset/資源記錄的資源記錄類型,使用標準 DNS 類型助記詞或 RFC 3597 泛型類型,即字串 TYPE 緊接十進位 RRtype 號碼。

RAW_RDATA
raw_rdata string

將資料值記錄為指定原始八位元字串的十六進位數字對。 此值用於從彈性搜尋樞紐至標準搜尋,以取得 rdata 的詳細資訊。

RateLimit_Results

名稱 路徑 類型 Description
限制
limit number

可執行的 API 查閱數目上限。 這是初始配額。

remaining number

對於基於時間的配額:在重置時間之前可以執行的剩餘 API 查詢次數。對於區塊型配額:區塊配額中的剩餘 API 查詢次數。

重設
reset number

對於基於時間的配額:UNIX 紀元時間戳記,其第二個粒度表示將重置配額限制的下一個時間點。 通常這是在 UTC 時間 00:00(午夜)。對於區塊型配額:值將為「n/a」

過期
expires number

僅適用於區塊型配額:UNIX 紀元時間戳記,其第二個粒度指出配額何時到期。

結果最大
results_max number

傳回這些查閱方法可傳回的結果數目上限。 如果提供,這會覆寫 'limit' 查詢參數。 例如,如果 '?limit=20000' 附加至 URL 路徑,但 results_max=1000,則最多只會傳回 1000 個結果。

偏移最大值
offset_max number

偏移查詢參數可以是的最大值。 如果它更高,則會傳回 HTTP 416「請求範圍無法滿足」回應代碼,並顯示訊息「錯誤:偏移值大於允許的最大值」。 如果值為 'n/a',則此 API 金鑰不允許使用偏移參數,並且會產生類似的 416 錯誤。

BurstSize (連載大小)
burst_size number

在此burst_window秒數內可執行的 API 查詢數目上限。

BurstWindow
burst_window number

測量突發查詢的秒數。