遠視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/ |
| 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,這表示不偏移列。 |
傳回
- response
- array of RData_Results
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,這表示不偏移列。 |
傳回
- response
- array of RRSet_Results
使用 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,這表示不偏移列。 |
傳回
- response
- array of RRSet_Results
使用 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,這表示不偏移列。 |
傳回
- response
- array of RData_Results
使用 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,這表示不偏移列。 |
傳回
- response
- array of RRSet_Results
服務限制
靈活搜尋
彈性搜尋將正則運算式和 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,這表示不偏移列。 |
傳回
- response
- array of Flex_Results
定義
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 |
測量突發查詢的秒數。 |