Farsight DNSDB
Farsight Security DNSDB, küresel İnternet altyapısının yapılandırmasına ilişkin olgu tabanlı bir görünüm sağlayan dünyanın en büyük DNS zekası veritabanıdır. DNSDB, Farsight'ın Güvenlik Bilgileri Değişimi (SIE) veri paylaşım platformuna sahip olup önde gelen DNS uzmanları tarafından tasarlanmış ve işletilmektedir. Farsight genel algılayıcı dizisinden Pasif DNS verilerini toplar, filtreler ve doğrular. DNSDB, türünün en yüksek kaliteli ve en kapsamlı DNS zekası veri hizmetidir.
Bu bağlayıcı aşağıdaki ürün ve bölgelerde kullanılabilir:
| Hizmet | Class | Bölgeler |
|---|---|---|
| Copilot Studio | Premium | Aşağıdakiler dışında tüm Power Automate bölgeleri : - ABD Kamu (GCC) - US Government (GCC High) - 21Vianet tarafından işletilen Çin Bulutu - ABD Savunma Bakanlığı (DoD) |
| Logic Apps | Standart | Aşağıdakiler dışında tüm Logic Apps bölgeleri : - Azure Kamu bölgeleri - Azure Çin bölgeleri - ABD Savunma Bakanlığı (DoD) |
| Power Apps | Premium | Aşağıdakiler dışında tüm Power Apps bölgeleri : - ABD Kamu (GCC) - US Government (GCC High) - 21Vianet tarafından işletilen Çin Bulutu - ABD Savunma Bakanlığı (DoD) |
| Power Automate | Premium | Aşağıdakiler dışında tüm Power Automate bölgeleri : - ABD Kamu (GCC) - US Government (GCC High) - 21Vianet tarafından işletilen Çin Bulutu - ABD Savunma Bakanlığı (DoD) |
| İletişim | |
|---|---|
| İsim | Farsight Güvenlik Teknik Desteği |
| URL | https://service.farsightsecurity.com/ |
| E-posta | support@farsightsecurity.com |
| Bağlayıcı Meta Verileri | |
|---|---|
| Publisher | Farsight Güvenliği |
| Web sitesi | https://www.farsightsecurity.com/ |
| Gizlilik ilkesi | https://www.farsightsecurity.com/privacy-policy/ |
| Kategoriler | Güvenlik; Veri |
Pre-requisites
Devam etmek için aşağıdakilere ihtiyacınız olacaktır:
- Özel bağlayıcı özelliğine sahip bir Microsoft Power Apps veya Power Automate planı
- Azure aboneliği
- Farsight DNSDB API Anahtarı
Kimlik bilgilerini alma
adresinden ücretsiz bir API anahtarına kaydolun https://www.farsightsecurity.com/solutions/dnsdb/ .
Destek:
Tüm destek istekleri ve genel sorgular için bizimle iletişime geçebilir support@farsightsecurity.com veya bizimle iletişime geçebilirsiniz
Bağlantı oluşturma
Bağlayıcı aşağıdaki kimlik doğrulama türlerini destekler:
| Varsayılan | Bağlantı oluşturmak için parametreler. | Tüm bölgeler | Paylaşılamaz |
Temerrüt
Geçerli: Tüm bölgeler
Bağlantı oluşturmak için parametreler.
Bu, paylaşılabilir bir bağlantı değildir. Power app başka bir kullanıcıyla paylaşılıyorsa, başka bir kullanıcıdan açıkça yeni bağlantı oluşturması istenir.
| İsim | Türü | Description | Gerekli |
|---|---|---|---|
| Farsight DNSDB API Anahtarı | securestring | Bu api için Farsight DNSDB API Anahtarı | Doğru |
Azaltma Sınırları
| Name | Çağrılar | Yenileme Dönemi |
|---|---|---|
| Bağlantı başına API çağrıları | 100 | 60 saniye |
Eylemler
| Esnek Arama |
Esnek Arama, arama sorgusu türlerini genişletmek ve aramalara daha fazla denetim eklemek için DNSDB API'sine hem Normal İfadeler hem de Globbing desteği ekler. |
| Hizmet Sınırları |
Hizmet sınırlarını alma |
| Ping |
Bu istek, DNSDB API uç noktasına yönelik uçtan uca bağlantı testlerine yöneliktir ve güvenlik duvarı engellemesi olmadığını size bildirir. Bu istek bir API anahtarı gerektirmez. Yalnızca bir JSON nesnesi döndürür {'ping': 'ok'}. |
| RData Arama |
RData araması, DNSDB'nin Rdata dizinini sorgular ve bu dizin Rdata kayıt değerlerine göre ters aramaları destekler. |
| RRSet Araması |
RRSet arama, DNSDB'nin RRset dizinini sorgular. Bu dizin, RRset'in sahip adına göre ileriye doğru aramaları destekler. |
| RRType ile RData Araması |
RData araması, DNSDB'nin Rdata dizinini sorgular ve bu dizin Rdata kayıt değerlerine göre ters aramaları destekler. |
| RRType ile RRSet Araması |
RRSet arama, DNSDB'nin RRset dizinini sorgular. Bu dizin, RRset'in sahip adına göre ileriye doğru aramaları destekler. |
| RRType ve Bailiwick ile RRSet Araması |
RRSet arama, DNSDB'nin RRset dizinini sorgular. Bu dizin, RRset'in sahip adına göre ileriye doğru aramaları destekler. |
Esnek Arama
Esnek Arama, arama sorgusu türlerini genişletmek ve aramalara daha fazla denetim eklemek için DNSDB API'sine hem Normal İfadeler hem de Globbing desteği ekler.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
method
|
method | True | string |
flex search yöntemi (regex - normal ifade araması, glob - tam joker karakter) |
|
key
|
key | True | string |
arama tuşu |
|
value
|
value | True | string |
Sorgu değeri |
|
time_first_before (Unix/Dönem süresi)
|
time_first_before | number |
DNS kaydının ilk gözlemlendiği zaman için tanımlı zaman damgasından önce sonuçlar sağlayın. Örneğin, 'time_first_before=1420070400' URL parametresi yalnızca 1 Ocak 2015'ten önce (veya daha eski) gözlemlenen eşleşen DNS kayıtlarını sağlar. |
|
|
time_first_after (Unix/Dönem süresi)
|
time_first_after | number |
DNS kaydının ilk gözlemlendiği zaman için tanımlanan zaman damgasından sonra sonuçlar sağlayın. Örneğin, 'time_first_after=-31536000' URL parametresi yalnızca geçen yıl içinde ilk gözlemlenen sonuçları sağlar. |
|
|
time_last_before (Unix/Dönem süresi)
|
time_last_before | number |
DNS kaydının en son ne zaman gözlemlendiğine ilişkin tanımlı zaman damgasından önce sonuçları sağlayın. Örneğin, 'time_last_before=1356998400' URL parametresi yalnızca en son 2013'e kadar gözlemlenen DNS kayıtları için sonuç sağlar. |
|
|
time_last_after (Unix/Dönem süresi)
|
time_last_after | number |
DNS kaydının en son ne zaman gözlemlendiğine ilişkin tanımlı zaman damgasından sonra sonuçlar sağlayın. Örneğin, 'time_last_after=-2678400' URL parametresi yalnızca en son 31 gün önce gözlemlenen sonuçları sağlar. |
|
|
limit
|
limit | number |
Bu arama yöntemleriyle döndürülen sonuç sayısı sınırı. Bu arama yöntemleri aracılığıyla döndürülen sonuç sayısı için yerleşik bir sınır vardır. Varsayılan sınır 10.000 olarak ayarlanır. Bu sınır, 'limit' sorgu parametresi ayarlanarak artırılabilir veya azaltılabilir. Ayrıca izin verilen en fazla sonuç sayısı da vardır; üst sınırdan büyük bir sınır istemek yalnızca maksimumu döndürür. Bu üst sınır hakkında bilgi için aşağıdaki results_max bakın. '?limit=0' kullanılırsa DNSDB izin verilen en fazla sonuç sayısını döndürür. Sorgu için istenen sınırdan daha az sonuç varsa, yalnızca gerçek tutar döndürülebilir. |
|
|
exclude
|
exclude | string |
'exclude' parametresi, onunla eşleşen sonuçları dışlamak (filtrelemek gibi) için kullanılır. Bu tablonun altında açıklanmıştır. |
|
|
offset
|
offset | number |
Sonuçlarda kaç satır kaydıracak (ör. atla). Bu, artımlı bir sonuç aktarımı özelliği uygulayarak tek bir sorgu için daha fazla kullanılabilir sonuç görüntülemenizi sağlar. Satırlar, limit parametresi uygulanmadan önce kaydırılır, bu nedenle uzaklık, maksimum sonuç sayısıyla eşleşen bir sınırı aşan ek sonuçların görülmesine olanak tanır. DNSDB'nin her sorgu için sonuçları yeniden hesaplayacağını ve sonuçların sırasının korunmayabileceğini unutmayın. Bu nedenle, bu özellik tüm sonuçları birden çok sorgu üzerinde gezdirmek için geçerli bir yol değildir; bazı sonuçlar eksik olabilir ve bazıları yinelenebilir. Kullanılabilecek gerçek uzaklık sınırlıdır veya belirli API anahtarları için uzaklık izin verilmez; aşağıdaki offset_max rate_limit anahtarına bakın. Uzaklık değeri pozitif bir tamsayı olmalıdır. Varsayılan değer 0'dır, yani satırları kaydırmaz. |
Döndürülenler
- response
- array of Flex_Results
Hizmet Sınırları
Ping
Bu istek, DNSDB API uç noktasına yönelik uçtan uca bağlantı testlerine yöneliktir ve güvenlik duvarı engellemesi olmadığını size bildirir. Bu istek bir API anahtarı gerektirmez. Yalnızca bir JSON nesnesi döndürür {'ping': 'ok'}.
Döndürülenler
| Name | Yol | Tür | Description |
|---|---|---|---|
|
ping
|
ping | string |
ping |
RData Arama
RData araması, DNSDB'nin Rdata dizinini sorgular ve bu dizin Rdata kayıt değerlerine göre ters aramaları destekler.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
type
|
type | True | string |
Sorgu türü (ad, ham) adı: DEĞER, sunu biçiminde bir DNS etki alanı adı veya sol taraftaki ('c.example.com') veya sağ taraftaki ('www.example.') joker etki alanı adıdır. Sol joker karakter sorgularının sağ joker karakter sorgularından biraz daha pahalı olduğunu unutmayın.,ip: DEĞER, ön ek uzunluğu veya adres aralığı olan bir IPv4 veya IPv6 tek adreslerinden biridir. Bir ön ek sağlanırsa, HTTP URI yol adı ayırıcısıyla çakışmayı önlemek için ağ adresi ve ön ek uzunluğu arasındaki sınırlayıcı, normal eğik çizgi ('/') karakteri yerine tek bir virgül (',') karakteridir., ham: DEĞER, ham sekizli dizeyi belirten çift sayıda onaltılık basamaktır. |
|
value
|
value | True | string |
Sorgu değeri |
|
time_first_before (Unix/Dönem süresi)
|
time_first_before | number |
DNS kaydının ilk gözlemlendiği zaman için tanımlı zaman damgasından önce sonuçlar sağlayın. Örneğin, 'time_first_before=1420070400' URL parametresi yalnızca 1 Ocak 2015'ten önce (veya daha eski) gözlemlenen eşleşen DNS kayıtlarını sağlar. |
|
|
time_first_after (Unix/Dönem süresi)
|
time_first_after | number |
DNS kaydının ilk gözlemlendiği zaman için tanımlanan zaman damgasından sonra sonuçlar sağlayın. Örneğin, 'time_first_after=-31536000' URL parametresi yalnızca geçen yıl içinde ilk gözlemlenen sonuçları sağlar. |
|
|
time_last_before (Unix/Dönem süresi)
|
time_last_before | number |
DNS kaydının en son ne zaman gözlemlendiğine ilişkin tanımlı zaman damgasından önce sonuçları sağlayın. Örneğin, 'time_last_before=1356998400' URL parametresi yalnızca en son 2013'e kadar gözlemlenen DNS kayıtları için sonuç sağlar. |
|
|
time_last_after (Unix/Dönem süresi)
|
time_last_after | number |
DNS kaydının en son ne zaman gözlemlendiğine ilişkin tanımlı zaman damgasından sonra sonuçlar sağlayın. Örneğin, 'time_last_after=-2678400' URL parametresi yalnızca en son 31 gün önce gözlemlenen sonuçları sağlar. |
|
|
limit
|
limit | number |
Bu arama yöntemleriyle döndürülen sonuç sayısı sınırı. Bu arama yöntemleri aracılığıyla döndürülen sonuç sayısı için yerleşik bir sınır vardır. Varsayılan sınır 10.000 olarak ayarlanır. Bu sınır, 'limit' sorgu parametresi ayarlanarak artırılabilir veya azaltılabilir. Ayrıca izin verilen en fazla sonuç sayısı da vardır; üst sınırdan büyük bir sınır istemek yalnızca maksimumu döndürür. Bu üst sınır hakkında bilgi için aşağıdaki results_max bakın. '?limit=0' kullanılırsa DNSDB izin verilen en fazla sonuç sayısını döndürür. Sorgu için istenen sınırdan daha az sonuç varsa, yalnızca gerçek tutar döndürülebilir. |
|
|
aggr
|
aggr | boolean |
Toplanan sonuçlar tüm dönemlerde aynı rrsets grubunu oluşturur ve DNSDB'yi sorgulamanın klasik davranışıdır. Bu, bir rrset'in gözlemlenen toplam sayısını alabileceğiniz, ancak gözlemlenmediği anlamına gelir. Toplanmamış sonuçlar, aynı rrsets grubunu çözerek ETKI alanı adının DNSDB'de ele alınan tam zamanlı aralıkta (zaman sınırlamasına tabi) DNS'de nasıl çözüldüğünü görmenize olanak sağlar. Bu, değerleri yinelenen kayıtların farklı zaman damgalarını ortaya çıkaracağından, zaman içinde kayıt isteği hacminin daha doğru bir izlenimini verebilir. "Etki alanı, kötü amaçlı yazılım sunma veya istenmeyen posta aktarma amacıyla yeniden kullanıma sunulana kadar uzun süre park edilmiş miydi, çoğunlukla kullanılmadı mı?" gibi soruları yanıtlayabilirsiniz. Bir kaydın geçen hafta yoğun olarak gözlemlenip gözlemlenmediğini ve yıllardır sürekli gözlemlenip gözlemlenmediğini görmenizi sağlar. Bu bir boole değeridir. Toplanan sonuçlar için varsayılan true veya toplanmamış sonuçlar için False kullanın. |
|
|
humantime
|
humantime | boolean |
Zaman değerleri (time_first, time_last, zone_time_first, zone_time_last) insan tarafından okunabilir (RFC3339 uyumlu) biçimde döndürülmesi gerekiyorsa True veya dönem döndürülmesi gerektiğinden Unix stilinde saat değerleri saniye cinsinden false olarak döndürülmelidir. False, DNSDB'yi sorgulamanın klasik davranışıdır ve bu seçenek için varsayılan değerdir. |
|
|
offset
|
offset | number |
Sonuçlarda kaç satır kaydıracak (ör. atla). Bu, artımlı bir sonuç aktarımı özelliği uygulayarak tek bir sorgu için daha fazla kullanılabilir sonuç görüntülemenizi sağlar. Satırlar, limit parametresi uygulanmadan önce kaydırılır, bu nedenle uzaklık, maksimum sonuç sayısıyla eşleşen bir sınırı aşan ek sonuçların görülmesine olanak tanır. DNSDB'nin her sorgu için sonuçları yeniden hesaplayacağını ve sonuçların sırasının korunmayabileceğini unutmayın. Bu nedenle, bu özellik tüm sonuçları birden çok sorgu üzerinde gezdirmek için geçerli bir yol değildir; bazı sonuçlar eksik olabilir ve bazıları yinelenebilir. Kullanılabilecek gerçek uzaklık sınırlıdır veya belirli API anahtarları için uzaklık izin verilmez; aşağıdaki offset_max rate_limit anahtarına bakın. Uzaklık değeri pozitif bir tamsayı olmalıdır. Varsayılan değer 0'dır, yani satırları kaydırmaz. |
Döndürülenler
- response
- array of RData_Results
RRSet Araması
RRSet arama, DNSDB'nin RRset dizinini sorgular. Bu dizin, RRset'in sahip adına göre ileriye doğru aramaları destekler.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
type
|
type | True | string |
Sorgu türü (ad, ham) adı: DEĞER, aşağıda açıklandığı gibi sunu biçiminde veya joker karakterde bir DNS sahibi adıdır. Buna bazen yalnızca bir rrset araması (ham) diyoruz: DEĞER, ham sekizli dizeyi belirten çift sayıda onaltılık basamaktır. |
|
value
|
value | True | string |
Sorgu değeri |
|
time_first_before (Unix/Dönem süresi)
|
time_first_before | number |
DNS kaydının ilk gözlemlendiği zaman için tanımlı zaman damgasından önce sonuçlar sağlayın. Örneğin, 'time_first_before=1420070400' URL parametresi yalnızca 1 Ocak 2015'ten önce (veya daha eski) gözlemlenen eşleşen DNS kayıtlarını sağlar. |
|
|
time_first_after (Unix/Dönem süresi)
|
time_first_after | number |
DNS kaydının ilk gözlemlendiği zaman için tanımlanan zaman damgasından sonra sonuçlar sağlayın. Örneğin, 'time_first_after=-31536000' URL parametresi yalnızca geçen yıl içinde ilk gözlemlenen sonuçları sağlar. |
|
|
time_last_before (Unix/Dönem süresi)
|
time_last_before | number |
DNS kaydının en son ne zaman gözlemlendiğine ilişkin tanımlı zaman damgasından önce sonuçları sağlayın. Örneğin, 'time_last_before=1356998400' URL parametresi yalnızca en son 2013'e kadar gözlemlenen DNS kayıtları için sonuç sağlar. |
|
|
time_last_after (Unix/Dönem süresi)
|
time_last_after | number |
DNS kaydının en son ne zaman gözlemlendiğine ilişkin tanımlı zaman damgasından sonra sonuçlar sağlayın. Örneğin, 'time_last_after=-2678400' URL parametresi yalnızca en son 31 gün önce gözlemlenen sonuçları sağlar. |
|
|
limit
|
limit | number |
Bu arama yöntemleriyle döndürülen sonuç sayısı sınırı. Bu arama yöntemleri aracılığıyla döndürülen sonuç sayısı için yerleşik bir sınır vardır. Varsayılan sınır 10.000 olarak ayarlanır. Bu sınır, 'limit' sorgu parametresi ayarlanarak artırılabilir veya azaltılabilir. Ayrıca izin verilen en fazla sonuç sayısı da vardır; üst sınırdan büyük bir sınır istemek yalnızca maksimumu döndürür. Bu üst sınır hakkında bilgi için aşağıdaki results_max bakın. '?limit=0' kullanılırsa DNSDB izin verilen en fazla sonuç sayısını döndürür. Sorgu için istenen sınırdan daha az sonuç varsa, yalnızca gerçek tutar döndürülebilir. |
|
|
aggr
|
aggr | boolean |
Toplanan sonuçlar tüm dönemlerde aynı rrsets grubunu oluşturur ve DNSDB'yi sorgulamanın klasik davranışıdır. Bu, bir rrset'in gözlemlenen toplam sayısını alabileceğiniz, ancak gözlemlenmediği anlamına gelir. Toplanmamış sonuçlar, aynı rrsets grubunu çözerek ETKI alanı adının DNSDB'de ele alınan tam zamanlı aralıkta (zaman sınırlamasına tabi) DNS'de nasıl çözüldüğünü görmenize olanak sağlar. Bu, değerleri yinelenen kayıtların farklı zaman damgalarını ortaya çıkaracağından, zaman içinde kayıt isteği hacminin daha doğru bir izlenimini verebilir. "Etki alanı, kötü amaçlı yazılım sunma veya istenmeyen posta aktarma amacıyla yeniden kullanıma sunulana kadar uzun süre park edilmiş miydi, çoğunlukla kullanılmadı mı?" gibi soruları yanıtlayabilirsiniz. Bir kaydın geçen hafta yoğun olarak gözlemlenip gözlemlenmediğini ve yıllardır sürekli gözlemlenip gözlemlenmediğini görmenizi sağlar. Bu bir boole değeridir. Toplanan sonuçlar için varsayılan true veya toplanmamış sonuçlar için False kullanın. |
|
|
humantime
|
humantime | boolean |
Zaman değerleri (time_first, time_last, zone_time_first, zone_time_last) insan tarafından okunabilir (RFC3339 uyumlu) biçimde döndürülmesi gerekiyorsa True veya dönem döndürülmesi gerektiğinden Unix stilinde saat değerleri saniye cinsinden false olarak döndürülmelidir. False, DNSDB'yi sorgulamanın klasik davranışıdır ve bu seçenek için varsayılan değerdir. |
|
|
offset
|
offset | number |
Sonuçlarda kaç satır kaydıracak (ör. atla). Bu, artımlı bir sonuç aktarımı özelliği uygulayarak tek bir sorgu için daha fazla kullanılabilir sonuç görüntülemenizi sağlar. Satırlar, limit parametresi uygulanmadan önce kaydırılır, bu nedenle uzaklık, maksimum sonuç sayısıyla eşleşen bir sınırı aşan ek sonuçların görülmesine olanak tanır. DNSDB'nin her sorgu için sonuçları yeniden hesaplayacağını ve sonuçların sırasının korunmayabileceğini unutmayın. Bu nedenle, bu özellik tüm sonuçları birden çok sorgu üzerinde gezdirmek için geçerli bir yol değildir; bazı sonuçlar eksik olabilir ve bazıları yinelenebilir. Kullanılabilecek gerçek uzaklık sınırlıdır veya belirli API anahtarları için uzaklık izin verilmez; aşağıdaki offset_max rate_limit anahtarına bakın. Uzaklık değeri pozitif bir tamsayı olmalıdır. Varsayılan değer 0'dır, yani satırları kaydırmaz. |
Döndürülenler
- response
- array of RRSet_Results
RRType ile RData Araması
RData araması, DNSDB'nin Rdata dizinini sorgular ve bu dizin Rdata kayıt değerlerine göre ters aramaları destekler.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
type
|
type | True | string |
Sorgu türü (ad, ham) adı: DEĞER, sunu biçiminde bir DNS etki alanı adı veya sol taraftaki ('c.example.com') veya sağ taraftaki ('www.example.') joker etki alanı adıdır. Sol joker karakter sorgularının sağ joker karakter sorgularından biraz daha pahalı olduğunu unutmayın.,ip: DEĞER, ön ek uzunluğu veya adres aralığı olan bir IPv4 veya IPv6 tek adreslerinden biridir. Bir ön ek sağlanırsa, HTTP URI yol adı ayırıcısıyla çakışmayı önlemek için ağ adresi ve ön ek uzunluğu arasındaki sınırlayıcı, normal eğik çizgi ('/') karakteri yerine tek bir virgül (',') karakteridir., ham: DEĞER, ham sekizli dizeyi belirten çift sayıda onaltılık basamaktır. |
|
value
|
value | True | string |
Sorgu değeri |
|
rrtype
|
rrtype | True | string |
Sorgu rrtype |
|
time_first_before (Unix/Dönem süresi)
|
time_first_before | number |
DNS kaydının ilk gözlemlendiği zaman için tanımlı zaman damgasından önce sonuçlar sağlayın. Örneğin, 'time_first_before=1420070400' URL parametresi yalnızca 1 Ocak 2015'ten önce (veya daha eski) gözlemlenen eşleşen DNS kayıtlarını sağlar. |
|
|
time_first_after (Unix/Dönem süresi)
|
time_first_after | number |
DNS kaydının ilk gözlemlendiği zaman için tanımlanan zaman damgasından sonra sonuçlar sağlayın. Örneğin, 'time_first_after=-31536000' URL parametresi yalnızca geçen yıl içinde ilk gözlemlenen sonuçları sağlar. |
|
|
time_last_before (Unix/Dönem süresi)
|
time_last_before | number |
DNS kaydının en son ne zaman gözlemlendiğine ilişkin tanımlı zaman damgasından önce sonuçları sağlayın. Örneğin, 'time_last_before=1356998400' URL parametresi yalnızca en son 2013'e kadar gözlemlenen DNS kayıtları için sonuç sağlar. |
|
|
time_last_after (Unix/Dönem süresi)
|
time_last_after | number |
DNS kaydının en son ne zaman gözlemlendiğine ilişkin tanımlı zaman damgasından sonra sonuçlar sağlayın. Örneğin, 'time_last_after=-2678400' URL parametresi yalnızca en son 31 gün önce gözlemlenen sonuçları sağlar. |
|
|
limit
|
limit | number |
Bu arama yöntemleriyle döndürülen sonuç sayısı sınırı. Bu arama yöntemleri aracılığıyla döndürülen sonuç sayısı için yerleşik bir sınır vardır. Varsayılan sınır 10.000 olarak ayarlanır. Bu sınır, 'limit' sorgu parametresi ayarlanarak artırılabilir veya azaltılabilir. Ayrıca izin verilen en fazla sonuç sayısı da vardır; üst sınırdan büyük bir sınır istemek yalnızca maksimumu döndürür. Bu üst sınır hakkında bilgi için aşağıdaki results_max bakın. '?limit=0' kullanılırsa DNSDB izin verilen en fazla sonuç sayısını döndürür. Sorgu için istenen sınırdan daha az sonuç varsa, yalnızca gerçek tutar döndürülebilir. |
|
|
aggr
|
aggr | boolean |
Toplanan sonuçlar tüm dönemlerde aynı rrsets grubunu oluşturur ve DNSDB'yi sorgulamanın klasik davranışıdır. Bu, bir rrset'in gözlemlenen toplam sayısını alabileceğiniz, ancak gözlemlenmediği anlamına gelir. Toplanmamış sonuçlar, aynı rrsets grubunu çözerek ETKI alanı adının DNSDB'de ele alınan tam zamanlı aralıkta (zaman sınırlamasına tabi) DNS'de nasıl çözüldüğünü görmenize olanak sağlar. Bu, değerleri yinelenen kayıtların farklı zaman damgalarını ortaya çıkaracağından, zaman içinde kayıt isteği hacminin daha doğru bir izlenimini verebilir. "Etki alanı, kötü amaçlı yazılım sunma veya istenmeyen posta aktarma amacıyla yeniden kullanıma sunulana kadar uzun süre park edilmiş miydi, çoğunlukla kullanılmadı mı?" gibi soruları yanıtlayabilirsiniz. Bir kaydın geçen hafta yoğun olarak gözlemlenip gözlemlenmediğini ve yıllardır sürekli gözlemlenip gözlemlenmediğini görmenizi sağlar. Bu bir boole değeridir. Toplanan sonuçlar için varsayılan true veya toplanmamış sonuçlar için False kullanın. |
|
|
humantime
|
humantime | boolean |
Zaman değerleri (time_first, time_last, zone_time_first, zone_time_last) insan tarafından okunabilir (RFC3339 uyumlu) biçimde döndürülmesi gerekiyorsa True veya dönem döndürülmesi gerektiğinden Unix stilinde saat değerleri saniye cinsinden false olarak döndürülmelidir. False, DNSDB'yi sorgulamanın klasik davranışıdır ve bu seçenek için varsayılan değerdir. |
|
|
offset
|
offset | number |
Sonuçlarda kaç satır kaydıracak (ör. atla). Bu, artımlı bir sonuç aktarımı özelliği uygulayarak tek bir sorgu için daha fazla kullanılabilir sonuç görüntülemenizi sağlar. Satırlar, limit parametresi uygulanmadan önce kaydırılır, bu nedenle uzaklık, maksimum sonuç sayısıyla eşleşen bir sınırı aşan ek sonuçların görülmesine olanak tanır. DNSDB'nin her sorgu için sonuçları yeniden hesaplayacağını ve sonuçların sırasının korunmayabileceğini unutmayın. Bu nedenle, bu özellik tüm sonuçları birden çok sorgu üzerinde gezdirmek için geçerli bir yol değildir; bazı sonuçlar eksik olabilir ve bazıları yinelenebilir. Kullanılabilecek gerçek uzaklık sınırlıdır veya belirli API anahtarları için uzaklık izin verilmez; aşağıdaki offset_max rate_limit anahtarına bakın. Uzaklık değeri pozitif bir tamsayı olmalıdır. Varsayılan değer 0'dır, yani satırları kaydırmaz. |
Döndürülenler
- response
- array of RData_Results
RRType ile RRSet Araması
RRSet arama, DNSDB'nin RRset dizinini sorgular. Bu dizin, RRset'in sahip adına göre ileriye doğru aramaları destekler.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
type
|
type | True | string |
Sorgu türü (ad, ham) adı: DEĞER, aşağıda açıklandığı gibi sunu biçiminde veya joker karakterde bir DNS sahibi adıdır. Buna bazen yalnızca bir rrset araması (ham) diyoruz: DEĞER, ham sekizli dizeyi belirten çift sayıda onaltılık basamaktır. |
|
value
|
value | True | string |
Sorgu değeri |
|
rrtype
|
rrtype | True | string |
Sorgu rrtype |
|
time_first_before (Unix/Dönem süresi)
|
time_first_before | number |
DNS kaydının ilk gözlemlendiği zaman için tanımlı zaman damgasından önce sonuçlar sağlayın. Örneğin, 'time_first_before=1420070400' URL parametresi yalnızca 1 Ocak 2015'ten önce (veya daha eski) gözlemlenen eşleşen DNS kayıtlarını sağlar. |
|
|
time_first_after (Unix/Dönem süresi)
|
time_first_after | number |
DNS kaydının ilk gözlemlendiği zaman için tanımlanan zaman damgasından sonra sonuçlar sağlayın. Örneğin, 'time_first_after=-31536000' URL parametresi yalnızca geçen yıl içinde ilk gözlemlenen sonuçları sağlar. |
|
|
time_last_before (Unix/Dönem süresi)
|
time_last_before | number |
DNS kaydının en son ne zaman gözlemlendiğine ilişkin tanımlı zaman damgasından önce sonuçları sağlayın. Örneğin, 'time_last_before=1356998400' URL parametresi yalnızca en son 2013'e kadar gözlemlenen DNS kayıtları için sonuç sağlar. |
|
|
time_last_after (Unix/Dönem süresi)
|
time_last_after | number |
DNS kaydının en son ne zaman gözlemlendiğine ilişkin tanımlı zaman damgasından sonra sonuçlar sağlayın. Örneğin, 'time_last_after=-2678400' URL parametresi yalnızca en son 31 gün önce gözlemlenen sonuçları sağlar. |
|
|
limit
|
limit | number |
Bu arama yöntemleriyle döndürülen sonuç sayısı sınırı. Bu arama yöntemleri aracılığıyla döndürülen sonuç sayısı için yerleşik bir sınır vardır. Varsayılan sınır 10.000 olarak ayarlanır. Bu sınır, 'limit' sorgu parametresi ayarlanarak artırılabilir veya azaltılabilir. Ayrıca izin verilen en fazla sonuç sayısı da vardır; üst sınırdan büyük bir sınır istemek yalnızca maksimumu döndürür. Bu üst sınır hakkında bilgi için aşağıdaki results_max bakın. '?limit=0' kullanılırsa DNSDB izin verilen en fazla sonuç sayısını döndürür. Sorgu için istenen sınırdan daha az sonuç varsa, yalnızca gerçek tutar döndürülebilir. |
|
|
aggr
|
aggr | boolean |
Toplanan sonuçlar tüm dönemlerde aynı rrsets grubunu oluşturur ve DNSDB'yi sorgulamanın klasik davranışıdır. Bu, bir rrset'in gözlemlenen toplam sayısını alabileceğiniz, ancak gözlemlenmediği anlamına gelir. Toplanmamış sonuçlar, aynı rrsets grubunu çözerek ETKI alanı adının DNSDB'de ele alınan tam zamanlı aralıkta (zaman sınırlamasına tabi) DNS'de nasıl çözüldüğünü görmenize olanak sağlar. Bu, değerleri yinelenen kayıtların farklı zaman damgalarını ortaya çıkaracağından, zaman içinde kayıt isteği hacminin daha doğru bir izlenimini verebilir. "Etki alanı, kötü amaçlı yazılım sunma veya istenmeyen posta aktarma amacıyla yeniden kullanıma sunulana kadar uzun süre park edilmiş miydi, çoğunlukla kullanılmadı mı?" gibi soruları yanıtlayabilirsiniz. Bir kaydın geçen hafta yoğun olarak gözlemlenip gözlemlenmediğini ve yıllardır sürekli gözlemlenip gözlemlenmediğini görmenizi sağlar. Bu bir boole değeridir. Toplanan sonuçlar için varsayılan true veya toplanmamış sonuçlar için False kullanın. |
|
|
humantime
|
humantime | boolean |
Zaman değerleri (time_first, time_last, zone_time_first, zone_time_last) insan tarafından okunabilir (RFC3339 uyumlu) biçimde döndürülmesi gerekiyorsa True veya dönem döndürülmesi gerektiğinden Unix stilinde saat değerleri saniye cinsinden false olarak döndürülmelidir. False, DNSDB'yi sorgulamanın klasik davranışıdır ve bu seçenek için varsayılan değerdir. |
|
|
offset
|
offset | number |
Sonuçlarda kaç satır kaydıracak (ör. atla). Bu, artımlı bir sonuç aktarımı özelliği uygulayarak tek bir sorgu için daha fazla kullanılabilir sonuç görüntülemenizi sağlar. Satırlar, limit parametresi uygulanmadan önce kaydırılır, bu nedenle uzaklık, maksimum sonuç sayısıyla eşleşen bir sınırı aşan ek sonuçların görülmesine olanak tanır. DNSDB'nin her sorgu için sonuçları yeniden hesaplayacağını ve sonuçların sırasının korunmayabileceğini unutmayın. Bu nedenle, bu özellik tüm sonuçları birden çok sorgu üzerinde gezdirmek için geçerli bir yol değildir; bazı sonuçlar eksik olabilir ve bazıları yinelenebilir. Kullanılabilecek gerçek uzaklık sınırlıdır veya belirli API anahtarları için uzaklık izin verilmez; aşağıdaki offset_max rate_limit anahtarına bakın. Uzaklık değeri pozitif bir tamsayı olmalıdır. Varsayılan değer 0'dır, yani satırları kaydırmaz. |
Döndürülenler
- response
- array of RRSet_Results
RRType ve Bailiwick ile RRSet Araması
RRSet arama, DNSDB'nin RRset dizinini sorgular. Bu dizin, RRset'in sahip adına göre ileriye doğru aramaları destekler.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
type
|
type | True | string |
Sorgu türü (ad, ham) adı: DEĞER, aşağıda açıklandığı gibi sunu biçiminde veya joker karakterde bir DNS sahibi adıdır. Buna bazen yalnızca bir rrset araması (ham) diyoruz: DEĞER, ham sekizli dizeyi belirten çift sayıda onaltılık basamaktır. |
|
value
|
value | True | string |
Sorgu değeri |
|
rrtype
|
rrtype | True | string |
Sorgu rrtype |
|
bailiwick
|
bailiwick | True | string |
Sorgu kurtarma paketi |
|
time_first_before (Unix/Dönem süresi)
|
time_first_before | number |
DNS kaydının ilk gözlemlendiği zaman için tanımlı zaman damgasından önce sonuçlar sağlayın. Örneğin, 'time_first_before=1420070400' URL parametresi yalnızca 1 Ocak 2015'ten önce (veya daha eski) gözlemlenen eşleşen DNS kayıtlarını sağlar. |
|
|
time_first_after (Unix/Dönem süresi)
|
time_first_after | number |
DNS kaydının ilk gözlemlendiği zaman için tanımlanan zaman damgasından sonra sonuçlar sağlayın. Örneğin, 'time_first_after=-31536000' URL parametresi yalnızca geçen yıl içinde ilk gözlemlenen sonuçları sağlar. |
|
|
time_last_before (Unix/Dönem süresi)
|
time_last_before | number |
DNS kaydının en son ne zaman gözlemlendiğine ilişkin tanımlı zaman damgasından önce sonuçları sağlayın. Örneğin, 'time_last_before=1356998400' URL parametresi yalnızca en son 2013'e kadar gözlemlenen DNS kayıtları için sonuç sağlar. |
|
|
time_last_after (Unix/Dönem süresi)
|
time_last_after | number |
DNS kaydının en son ne zaman gözlemlendiğine ilişkin tanımlı zaman damgasından sonra sonuçlar sağlayın. Örneğin, 'time_last_after=-2678400' URL parametresi yalnızca en son 31 gün önce gözlemlenen sonuçları sağlar. |
|
|
limit
|
limit | number |
Bu arama yöntemleriyle döndürülen sonuç sayısı sınırı. Bu arama yöntemleri aracılığıyla döndürülen sonuç sayısı için yerleşik bir sınır vardır. Varsayılan sınır 10.000 olarak ayarlanır. Bu sınır, 'limit' sorgu parametresi ayarlanarak artırılabilir veya azaltılabilir. Ayrıca izin verilen en fazla sonuç sayısı da vardır; üst sınırdan büyük bir sınır istemek yalnızca maksimumu döndürür. Bu üst sınır hakkında bilgi için aşağıdaki results_max bakın. '?limit=0' kullanılırsa DNSDB izin verilen en fazla sonuç sayısını döndürür. Sorgu için istenen sınırdan daha az sonuç varsa, yalnızca gerçek tutar döndürülebilir. |
|
|
aggr
|
aggr | boolean |
Toplanan sonuçlar tüm dönemlerde aynı rrsets grubunu oluşturur ve DNSDB'yi sorgulamanın klasik davranışıdır. Bu, bir rrset'in gözlemlenen toplam sayısını alabileceğiniz, ancak gözlemlenmediği anlamına gelir. Toplanmamış sonuçlar, aynı rrsets grubunu çözerek ETKI alanı adının DNSDB'de ele alınan tam zamanlı aralıkta (zaman sınırlamasına tabi) DNS'de nasıl çözüldüğünü görmenize olanak sağlar. Bu, değerleri yinelenen kayıtların farklı zaman damgalarını ortaya çıkaracağından, zaman içinde kayıt isteği hacminin daha doğru bir izlenimini verebilir. "Etki alanı, kötü amaçlı yazılım sunma veya istenmeyen posta aktarma amacıyla yeniden kullanıma sunulana kadar uzun süre park edilmiş miydi, çoğunlukla kullanılmadı mı?" gibi soruları yanıtlayabilirsiniz. Bir kaydın geçen hafta yoğun olarak gözlemlenip gözlemlenmediğini ve yıllardır sürekli gözlemlenip gözlemlenmediğini görmenizi sağlar. Bu bir boole değeridir. Toplanan sonuçlar için varsayılan true veya toplanmamış sonuçlar için False kullanın. |
|
|
humantime
|
humantime | boolean |
Zaman değerleri (time_first, time_last, zone_time_first, zone_time_last) insan tarafından okunabilir (RFC3339 uyumlu) biçimde döndürülmesi gerekiyorsa True veya dönem döndürülmesi gerektiğinden Unix stilinde saat değerleri saniye cinsinden false olarak döndürülmelidir. False, DNSDB'yi sorgulamanın klasik davranışıdır ve bu seçenek için varsayılan değerdir. |
|
|
offset
|
offset | number |
Sonuçlarda kaç satır kaydıracak (ör. atla). Bu, artımlı bir sonuç aktarımı özelliği uygulayarak tek bir sorgu için daha fazla kullanılabilir sonuç görüntülemenizi sağlar. Satırlar, limit parametresi uygulanmadan önce kaydırılır, bu nedenle uzaklık, maksimum sonuç sayısıyla eşleşen bir sınırı aşan ek sonuçların görülmesine olanak tanır. DNSDB'nin her sorgu için sonuçları yeniden hesaplayacağını ve sonuçların sırasının korunmayabileceğini unutmayın. Bu nedenle, bu özellik tüm sonuçları birden çok sorgu üzerinde gezdirmek için geçerli bir yol değildir; bazı sonuçlar eksik olabilir ve bazıları yinelenebilir. Kullanılabilecek gerçek uzaklık sınırlıdır veya belirli API anahtarları için uzaklık izin verilmez; aşağıdaki offset_max rate_limit anahtarına bakın. Uzaklık değeri pozitif bir tamsayı olmalıdır. Varsayılan değer 0'dır, yani satırları kaydırmaz. |
Döndürülenler
- response
- array of RRSet_Results
Tanımlar
RRSet_Results
| Name | Yol | Tür | Description |
|---|---|---|---|
|
Sayı
|
count | number |
RRset'in pasif DNS çoğaltması yoluyla gözlemlenme sayısı. |
|
İlk Kez
|
time_first | number |
RRset ilk kez gözlemlendi. |
|
Son Zaman
|
time_last | number |
RRset'in en son gözlemlendiği zaman. |
|
İlk Bölge Saati
|
zone_time_first | number |
RRset ilk kez bölge dosyası içeri aktarma yoluyla gözlemlendi. |
|
Son Bölge Saati
|
zone_time_last | number |
RRset'in bölge dosyası içeri aktarma yoluyla son gözlemlendiği zaman. |
|
RRName
|
rrname | string |
DNS sunu biçiminde RRset'in sahip adı. |
|
RRType
|
rrtype | string |
Standart DNS türü anımsatıcı veya RFC 3597 genel türü kullanılarak RRset'in kaynak kayıt türü, yani dize TÜRÜ ve ardından ondalık RRtype sayısı hemen gelir. |
|
Bailiwick
|
bailiwick | string |
RRset'e hizmet veren bir ad sunucusuna temsilci olarak atanan en yakın kapsayan bölge veya FromZoneFile True ise RRset'i içeren bölgenin adı. |
|
RData
|
rdata | array of string |
Bir veya daha fazla Rdata değerinden oluşan bir dizi. Rdata değerleri, rrtype değerine göre standart sunu biçimine dönüştürülür. Kodlayıcıda RRset'in rrtype değeri için türe özgü bir sunu biçimi yoksa RFC 3597 genel Rdata kodlaması kullanılır. |
RData_Results
| Name | Yol | Tür | Description |
|---|---|---|---|
|
Sayı
|
count | number |
Kaynak kaydının pasif DNS çoğaltması aracılığıyla gözlemlenme sayısı. |
|
İlk Kez
|
time_first | number |
Kaynak kaydı ilk kez gözlemlendi. |
|
Son Zaman
|
time_last | number |
Kaynak kaydının en son gözlemlendiği zaman. |
|
İlk Bölge Saati
|
zone_time_first | number |
Kaynak kaydı ilk kez bölge dosyası içeri aktarma yoluyla gözlemlendi. |
|
Son Bölge Saati
|
zone_time_last | number |
Kaynak kaydının bölge dosyası içeri aktarma işlemiyle en son gözlemlendiği zaman. |
|
RRName
|
rrname | string |
DNS sunu biçiminde kaynak kaydının sahip adı. |
|
RRType
|
rrtype | string |
Standart DNS türü anımsatıcı veya RFC 3597 genel türü kullanılarak kaynak kaydının kaynak kaydı türü, yani dize TÜRÜ ve ardından ondalık RRtype sayısı hemen gelir. |
|
RData
|
rdata | array of string |
Kayıt verisi değeri. Rdata değeri, rrtype değerine göre standart sunu biçimine dönüştürülür. Kodlayıcıda kaynak kaydının türü için türe özgü bir sunu biçimi yoksa RFC 3597 genel Rdata kodlaması kullanılır. |
Flex_Results
| Name | Yol | Tür | Description |
|---|---|---|---|
|
RData
|
rdata | string |
Kayıt verisi değeri. |
|
RRName
|
rrname | string |
DNS sunu biçiminde RRset'in sahip adı. |
|
RRType
|
rrtype | string |
Standart DNS türü anımsatıcı veya RFC 3597 genel türü kullanılarak RRset/kaynak kaydının kaynak kaydı türü, yani dize TÜRÜ ve ardından ondalık RRtype sayısı hemen gelir. |
|
RAW_RDATA
|
raw_rdata | string |
Ham sekizli dizeyi belirten onaltılık basamak çiftleri olarak kayıt veri değeri. Bu değer, rdata hakkında daha fazla ayrıntı almak için esnek aramadan standart aramaya özetleme için kullanılır. |
RateLimit_Results
| Name | Yol | Tür | Description |
|---|---|---|---|
|
Sınır
|
limit | number |
Gerçekleştirilebilecek en fazla API araması sayısı. Bu, başlangıç kotasıdır. |
|
Kalan
|
remaining | number |
Zamana bağlı kotalar için: Sıfırlama zamanına kadar gerçekleştirilebilecek kalan API araması sayısı. Blok tabanlı kotalar için: Blok kotasında kalan API araması sayısı. |
|
Ayarla
|
reset | number |
Zamana bağlı kotalar için: Kota sınırının sıfırlanacağı bir sonraki noktayı gösteren ikinci ayrıntı düzeyine sahip UNIX dönem zaman damgası. Genellikle bu saat 00:00 (gece yarısı) UTC'dir. Blok tabanlı kotalar için: değer 'yok' olacaktır |
|
Sona eri -yor
|
expires | number |
Yalnızca blok tabanlı kota için mevcut: Kotanın süresinin ne zaman dolacağını belirten ikinci ayrıntı düzeyine sahip UNIX dönem zaman damgası. |
|
ResultsMax
|
results_max | number |
Bu arama yöntemleri tarafından döndürülebilecek en fazla sonuç sayısını döndürür. Bu, sağlanırsa bir 'limit' sorgu parametresini geçersiz kılar. Örneğin, URL yoluna '?limit=20000' eklenirse ancak results_max=1000 ise en fazla 1000 sonuç döndürülür. |
|
OffsetMax
|
offset_max | number |
Uzaklık sorgu parametresinin olabileceği en büyük değer. Daha yüksekse, 'İstenen Aralık Satisfiable Değil' yanıt kodu 'Hata: uzaklık değeri izin verilen en büyük değerden büyük' iletisiyle döndürülür. Değer 'yok' ise, bu API anahtarı için offset parametresine izin verilmez ve benzer 416 hatası oluşturulur. |
|
BurstSize
|
burst_size | number |
Bu burst_window saniye içinde gerçekleştirilebilecek en fazla API araması sayısı. |
|
BurstWindow
|
burst_window | number |
Sorgu artışlarının ölçüldiği saniye sayısı. |