Farsight DNSDB
Farsight Security DNSDB ist die weltweit größte DNS-Intelligence-Datenbank, die eine faktenbasierte Ansicht der Konfiguration der globalen Internetinfrastruktur bietet. DNSDB nutzt farsights Data-Sharing-Plattform (Security Information Exchange, SIE) und wird von führenden DNS-Experten entwickelt und betrieben. Farsight sammelt, filtert und überprüft passive DNS-Daten aus seinem globalen Sensorarray. DNSDB ist der umfassendste und umfassendste DNS-Intelligence-Datendienst seiner Art.
Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:
| Dienstleistung | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Logik-Apps | Norm | Alle Logik-Apps-Regionen mit Ausnahme der folgenden Bereiche: – Azure Government-Regionen - Azure China-Regionen - US Department of Defense (DoD) |
| Power Apps | Premium | Alle Power Apps-Regionen mit Ausnahme der folgenden: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Power Automate | Premium | Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Kontakt | |
|---|---|
| Name | Technischer Support für Farsight Security |
| URL | https://service.farsightsecurity.com/ |
| support@farsightsecurity.com |
| Connectormetadaten | |
|---|---|
| Herausgeber | Farsight Security |
| Webseite | https://www.farsightsecurity.com/ |
| Datenschutzrichtlinie | https://www.farsightsecurity.com/privacy-policy/ |
| Kategorien | Sicherheit; Daten |
Voraussetzungen
Sie benötigen Folgendes, um fortzufahren:
- Ein Microsoft Power Apps- oder Power Automate-Plan mit benutzerdefiniertem Connectorfeature
- Ein Azure-Abonnement
- Farsight DNSDB-API-Schlüssel
So erhalten Sie Anmeldeinformationen
Registrieren Sie sich für einen kostenlosen API-Schlüssel unter https://www.farsightsecurity.com/solutions/dnsdb/ .
Unterstützen:
Für alle Supportanfragen und allgemeine Anfragen können Sie sich an support@farsightsecurity.com oder kontaktieren
Eine Verbindung wird erstellt
Der Connector unterstützt die folgenden Authentifizierungstypen:
| Vorgabe | Parameter zum Erstellen einer Verbindung. | Alle Regionen | Nicht teilbar |
Vorgabe
Anwendbar: Alle Regionen
Parameter zum Erstellen einer Verbindung.
Dies ist keine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird ein anderer Benutzer aufgefordert, eine neue Verbindung explizit zu erstellen.
| Name | Typ | Description | Erforderlich |
|---|---|---|---|
| Farsight DNSDB-API-Schlüssel | securestring | Der Farsight DNSDB-API-Schlüssel für diese API | Richtig |
Drosselungsgrenzwerte
| Name | Aufrufe | Verlängerungszeitraum |
|---|---|---|
| API-Aufrufe pro Verbindung | 100 | 60 Sekunden |
Aktionen
| Dienstbeschränkungen |
Diensteinschränkung abrufen |
| Flexible Suche |
Die flexible Suche fügt sowohl reguläre Ausdrücke als auch Globbing-Unterstützung zur DNSDB-API hinzu, um die Suchabfragetypen zu erweitern und Suchvorgängen mehr Kontrolle hinzuzufügen. |
| Ping |
Diese Anforderung ist für End-to-End-Konnektivitätstests mit dem DNSDB-API-Endpunkt vorgesehen und informiert Sie, dass keine Firewallblockagen vorhanden sind. Für diese Anforderung ist kein API-Schlüssel erforderlich. Es gibt nur ein JSON-Objekt {'ping': 'ok'} zurück. |
| RData-Nachschlagevorgang |
Die RData-Suche fragt den Rdata-Index von DNSDB ab, der umgekehrte Nachschlagevorgänge basierend auf Rdata-Eintragswerten unterstützt. |
| RData-Nachschlagevorgang mit RRType |
Die RData-Suche fragt den Rdata-Index von DNSDB ab, der umgekehrte Nachschlagevorgänge basierend auf Rdata-Eintragswerten unterstützt. |
| RRSet Lookup mit RRType und Bailiwick |
Die RRSet-Suche fragt den RRset-Index von DNSDB ab, der Forward-Lookups basierend auf dem Besitzernamen eines RRsets unterstützt. |
| RRSet-Nachschlagevorgang |
Die RRSet-Suche fragt den RRset-Index von DNSDB ab, der Forward-Lookups basierend auf dem Besitzernamen eines RRsets unterstützt. |
| RRSet-Nachschlagevorgang mit RRType |
Die RRSet-Suche fragt den RRset-Index von DNSDB ab, der Forward-Lookups basierend auf dem Besitzernamen eines RRsets unterstützt. |
Dienstbeschränkungen
Flexible Suche
Die flexible Suche fügt sowohl reguläre Ausdrücke als auch Globbing-Unterstützung zur DNSDB-API hinzu, um die Suchabfragetypen zu erweitern und Suchvorgängen mehr Kontrolle hinzuzufügen.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
method
|
method | True | string |
flex search method (regex - regular expression search, glob - full wildcarding) |
|
key
|
key | True | string |
Suchschlüssel |
|
value
|
value | True | string |
Abfragewert |
|
time_first_before (Unix/Epoche)
|
time_first_before | number |
Geben Sie Ergebnisse vor dem definierten Zeitstempel für den zeitpunkt der ersten Beobachtung des DNS-Eintrags an. Der URL-Parameter "time_first_before=1420070400" stellt beispielsweise nur übereinstimmende DNS-Einträge bereit, die zuerst vor dem 1. Januar 2015 (oder älter als) beobachtet wurden. |
|
|
time_first_after (Unix/Epoche)
|
time_first_after | number |
Geben Sie Ergebnisse nach dem definierten Zeitstempel für den Zeitpunkt der ersten Beobachtung des DNS-Eintrags an. Der URL-Parameter "time_first_after=-31536000" liefert beispielsweise nur Ergebnisse, die im letzten Jahr zuerst beobachtet wurden. |
|
|
time_last_before (Unix/Epoche)
|
time_last_before | number |
Geben Sie Ergebnisse vor dem definierten Zeitstempel für den zeitpunkt der letzten Beobachtung des DNS-Eintrags an. Der URL-Parameter "time_last_before=1356998400" stellt beispielsweise nur Ergebnisse für DNS-Einträge bereit, die vor 2013 zuletzt beobachtet wurden. |
|
|
time_last_after (Unix/Epoche)
|
time_last_after | number |
Geben Sie Ergebnisse nach dem definierten Zeitstempel für den zeitpunkt der letzten Beobachtung des DNS-Eintrags an. Beispielsweise stellt der URL-Parameter "time_last_after=-2678400" nur Ergebnisse bereit, die vor 31 Tagen zuletzt beobachtet wurden. |
|
|
Begrenzung
|
limit | number |
Grenzwert für die Anzahl der Ergebnisse, die über diese Nachschlagemethoden zurückgegeben werden. Es gibt ein integriertes Limit für die Anzahl der Ergebnisse, die über diese Nachschlagemethoden zurückgegeben werden. Der Standardgrenzwert wird auf 10.000 festgelegt. Dieser Grenzwert kann durch Festlegen des Abfrageparameters "limit" ausgelöst oder herabgesetzt werden. Es gibt auch eine maximale Anzahl zulässiger Ergebnisse; Das Anfordern eines Grenzwerts, der größer als der Höchstwert ist, gibt nur das Maximum zurück. Weitere Informationen zu diesem Maximum finden Sie unter results_max weiter unten. Wenn "?limit=0" verwendet wird, gibt DNSDB die maximale Anzahl zulässiger Ergebnisse zurück. Wenn für die Abfrage weniger Ergebnisse als der angeforderte Grenzwert vorhanden sind, kann nur der tatsächliche Betrag zurückgegeben werden. |
|
|
ausschließen
|
exclude | string |
Der Parameter "exclude" wird verwendet, um Ergebnisse auszuschließen (d. h. Filterout), die dem Parameter entsprechen. Es wird unten in dieser Tabelle beschrieben. |
|
|
offset
|
offset | number |
Wie viele Zeilen in den Ergebnissen versetzt werden sollen (z. B. überspringen). Dadurch wird ein inkrementelles Ergebnisübertragungsfeature implementiert, mit dem Sie mehr der verfügbaren Ergebnisse für eine einzelne Abfrage anzeigen können. Die Zeilen werden vor dem angewendeten Limitparameter versetzt, sodass offset zusätzliche Ergebnisse über einen Grenzwert hinaus sehen kann, der der maximalen Anzahl von Ergebnissen entspricht. Beachten Sie, dass DNSDB die Ergebnisse für jede Abfrage neu berechnet und die Reihenfolge der Ergebnisse möglicherweise nicht beibehalten wird. Daher ist diese Funktion kein gültiger Weg, um alle Ergebnisse über mehrere Abfragen zu durchlaufen – einige Ergebnisse fehlen möglicherweise, und einige werden möglicherweise dupliziert. Der tatsächliche Offset, der verwendet werden kann, ist begrenzt oder für bestimmte API-Schlüssel, Offset ist nicht zulässig . Siehe den offset_max rate_limit Schlüssel unten. Der Offsetwert muss eine positive ganze Zahl sein. Der Standardwert ist 0, was bedeutet, dass die Zeilen nicht versetzt werden. |
Gibt zurück
- response
- array of Flex_Results
Ping
Diese Anforderung ist für End-to-End-Konnektivitätstests mit dem DNSDB-API-Endpunkt vorgesehen und informiert Sie, dass keine Firewallblockagen vorhanden sind. Für diese Anforderung ist kein API-Schlüssel erforderlich. Es gibt nur ein JSON-Objekt {'ping': 'ok'} zurück.
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
ping
|
ping | string |
ping |
RData-Nachschlagevorgang
Die RData-Suche fragt den Rdata-Index von DNSDB ab, der umgekehrte Nachschlagevorgänge basierend auf Rdata-Eintragswerten unterstützt.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
type
|
type | True | string |
Abfragetyp(Name, unformatierter) Name: Der WERT ist ein DNS-Domänenname im Präsentationsformat oder ein linker ('c.example.com') oder ein rechtshändiger ('www.example.')-Wildcarddomänenname. Beachten Sie, dass linkshändige Wildcardabfragen etwas teurer sind als Rechts-Wildcard-Abfragen.,ip: Der WERT ist eine der einzelnen IPv4- oder IPv6-Adressen, mit Präfixlänge oder adressbereich. Wenn ein Präfix angegeben wird, ist das Trennzeichen zwischen der Netzwerkadresse und der Präfixlänge ein einzelnes Komma (',') anstelle des üblichen Schrägstrichs ('/'), um Konflikte mit dem HTTP-URI-Pfadnamentrennzeichen zu vermeiden., unformatiert: Der WERT ist eine gerade Anzahl hexadezimaler Ziffern, die eine unformatierte Oktettzeichenfolge angeben. |
|
value
|
value | True | string |
Abfragewert |
|
time_first_before (Unix/Epoche)
|
time_first_before | number |
Geben Sie Ergebnisse vor dem definierten Zeitstempel für den zeitpunkt der ersten Beobachtung des DNS-Eintrags an. Der URL-Parameter "time_first_before=1420070400" stellt beispielsweise nur übereinstimmende DNS-Einträge bereit, die zuerst vor dem 1. Januar 2015 (oder älter als) beobachtet wurden. |
|
|
time_first_after (Unix/Epoche)
|
time_first_after | number |
Geben Sie Ergebnisse nach dem definierten Zeitstempel für den Zeitpunkt der ersten Beobachtung des DNS-Eintrags an. Der URL-Parameter "time_first_after=-31536000" liefert beispielsweise nur Ergebnisse, die im letzten Jahr zuerst beobachtet wurden. |
|
|
time_last_before (Unix/Epoche)
|
time_last_before | number |
Geben Sie Ergebnisse vor dem definierten Zeitstempel für den zeitpunkt der letzten Beobachtung des DNS-Eintrags an. Der URL-Parameter "time_last_before=1356998400" stellt beispielsweise nur Ergebnisse für DNS-Einträge bereit, die vor 2013 zuletzt beobachtet wurden. |
|
|
time_last_after (Unix/Epoche)
|
time_last_after | number |
Geben Sie Ergebnisse nach dem definierten Zeitstempel für den zeitpunkt der letzten Beobachtung des DNS-Eintrags an. Beispielsweise stellt der URL-Parameter "time_last_after=-2678400" nur Ergebnisse bereit, die vor 31 Tagen zuletzt beobachtet wurden. |
|
|
Begrenzung
|
limit | number |
Grenzwert für die Anzahl der Ergebnisse, die über diese Nachschlagemethoden zurückgegeben werden. Es gibt ein integriertes Limit für die Anzahl der Ergebnisse, die über diese Nachschlagemethoden zurückgegeben werden. Der Standardgrenzwert wird auf 10.000 festgelegt. Dieser Grenzwert kann durch Festlegen des Abfrageparameters "limit" ausgelöst oder herabgesetzt werden. Es gibt auch eine maximale Anzahl zulässiger Ergebnisse; Das Anfordern eines Grenzwerts, der größer als der Höchstwert ist, gibt nur das Maximum zurück. Weitere Informationen zu diesem Maximum finden Sie unter results_max weiter unten. Wenn "?limit=0" verwendet wird, gibt DNSDB die maximale Anzahl zulässiger Ergebnisse zurück. Wenn für die Abfrage weniger Ergebnisse als der angeforderte Grenzwert vorhanden sind, kann nur der tatsächliche Betrag zurückgegeben werden. |
|
|
aggr
|
aggr | boolean |
Aggregierte Ergebnisse gruppieren identische rrsets über alle Zeiträume hinweg und ist das klassische Verhalten beim Abfragen der DNSDB. Dies bedeutet, dass Sie die Gesamtanzahl der Beobachteten eines Rrsets abrufen können, aber nicht, wenn es beobachtet wurde. Nicht aggregierte Ergebnisse heben die Gruppierung identischer Rrsets auf, sodass Sie sehen können, wie der Domänenname im DNS im vollständigen Bereich aufgelöst wurde, der in DNSDB behandelt wird (vorbehaltlich des Zeitfencings). Dies kann einen genaueren Eindruck des Datensatzanforderungsvolumens im Lauf der Zeit geben, da dadurch die unterschiedlichen Zeitstempel von Datensätzen angezeigt werden, deren Werte wiederholt werden. Sie können Fragen beantworten, z. B. "Wurde eine Domäne lange geparkt, meist nicht verwendet, bis sie für die Bereitstellung von Schadsoftware oder das Weiterleiten von Spam verwendet wurde, aber dann erneut abgebrochen wurde?". Es ermöglicht Ihnen zu sehen, ob ein Datensatz in der letzten Woche stark beobachtet wurde, vs. seit Jahren konstant beobachtet wurde. Dies ist ein boolescher Wert. Verwenden Sie "True", die Standardeinstellung für die aggregierten Ergebnisse oder "False" für nicht aggregierte Ergebnisse. |
|
|
Menschliche Zeit
|
humantime | boolean |
Ein boolescher Wert, der True ist, wenn Zeitwerte (in time_first, time_last, zone_time_first, zone_time_last) im lesbaren (RFC3339 konformen) Format oder False zurückgegeben werden sollen, wenn Unix-Zeitwerte in Sekunden seit der Rückgabe der Epoche zurückgegeben werden sollen. False ist das klassische Verhalten beim Abfragen der DNSDB und ist der Standardwert für diese Option. |
|
|
offset
|
offset | number |
Wie viele Zeilen in den Ergebnissen versetzt werden sollen (z. B. überspringen). Dadurch wird ein inkrementelles Ergebnisübertragungsfeature implementiert, mit dem Sie mehr der verfügbaren Ergebnisse für eine einzelne Abfrage anzeigen können. Die Zeilen werden vor dem angewendeten Limitparameter versetzt, sodass offset zusätzliche Ergebnisse über einen Grenzwert hinaus sehen kann, der der maximalen Anzahl von Ergebnissen entspricht. Beachten Sie, dass DNSDB die Ergebnisse für jede Abfrage neu berechnet und die Reihenfolge der Ergebnisse möglicherweise nicht beibehalten wird. Daher ist diese Funktion kein gültiger Weg, um alle Ergebnisse über mehrere Abfragen zu durchlaufen – einige Ergebnisse fehlen möglicherweise, und einige werden möglicherweise dupliziert. Der tatsächliche Offset, der verwendet werden kann, ist begrenzt oder für bestimmte API-Schlüssel, Offset ist nicht zulässig . Siehe den offset_max rate_limit Schlüssel unten. Der Offsetwert muss eine positive ganze Zahl sein. Der Standardwert ist 0, was bedeutet, dass die Zeilen nicht versetzt werden. |
Gibt zurück
- response
- array of RData_Results
RData-Nachschlagevorgang mit RRType
Die RData-Suche fragt den Rdata-Index von DNSDB ab, der umgekehrte Nachschlagevorgänge basierend auf Rdata-Eintragswerten unterstützt.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
type
|
type | True | string |
Abfragetyp(Name, unformatierter) Name: Der WERT ist ein DNS-Domänenname im Präsentationsformat oder ein linker ('c.example.com') oder ein rechtshändiger ('www.example.')-Wildcarddomänenname. Beachten Sie, dass linkshändige Wildcardabfragen etwas teurer sind als Rechts-Wildcard-Abfragen.,ip: Der WERT ist eine der einzelnen IPv4- oder IPv6-Adressen, mit Präfixlänge oder adressbereich. Wenn ein Präfix angegeben wird, ist das Trennzeichen zwischen der Netzwerkadresse und der Präfixlänge ein einzelnes Komma (',') anstelle des üblichen Schrägstrichs ('/'), um Konflikte mit dem HTTP-URI-Pfadnamentrennzeichen zu vermeiden., unformatiert: Der WERT ist eine gerade Anzahl hexadezimaler Ziffern, die eine unformatierte Oktettzeichenfolge angeben. |
|
value
|
value | True | string |
Abfragewert |
|
rrtype
|
rrtype | True | string |
Abfrage-Rrtype |
|
time_first_before (Unix/Epoche)
|
time_first_before | number |
Geben Sie Ergebnisse vor dem definierten Zeitstempel für den zeitpunkt der ersten Beobachtung des DNS-Eintrags an. Der URL-Parameter "time_first_before=1420070400" stellt beispielsweise nur übereinstimmende DNS-Einträge bereit, die zuerst vor dem 1. Januar 2015 (oder älter als) beobachtet wurden. |
|
|
time_first_after (Unix/Epoche)
|
time_first_after | number |
Geben Sie Ergebnisse nach dem definierten Zeitstempel für den Zeitpunkt der ersten Beobachtung des DNS-Eintrags an. Der URL-Parameter "time_first_after=-31536000" liefert beispielsweise nur Ergebnisse, die im letzten Jahr zuerst beobachtet wurden. |
|
|
time_last_before (Unix/Epoche)
|
time_last_before | number |
Geben Sie Ergebnisse vor dem definierten Zeitstempel für den zeitpunkt der letzten Beobachtung des DNS-Eintrags an. Der URL-Parameter "time_last_before=1356998400" stellt beispielsweise nur Ergebnisse für DNS-Einträge bereit, die vor 2013 zuletzt beobachtet wurden. |
|
|
time_last_after (Unix/Epoche)
|
time_last_after | number |
Geben Sie Ergebnisse nach dem definierten Zeitstempel für den zeitpunkt der letzten Beobachtung des DNS-Eintrags an. Beispielsweise stellt der URL-Parameter "time_last_after=-2678400" nur Ergebnisse bereit, die vor 31 Tagen zuletzt beobachtet wurden. |
|
|
Begrenzung
|
limit | number |
Grenzwert für die Anzahl der Ergebnisse, die über diese Nachschlagemethoden zurückgegeben werden. Es gibt ein integriertes Limit für die Anzahl der Ergebnisse, die über diese Nachschlagemethoden zurückgegeben werden. Der Standardgrenzwert wird auf 10.000 festgelegt. Dieser Grenzwert kann durch Festlegen des Abfrageparameters "limit" ausgelöst oder herabgesetzt werden. Es gibt auch eine maximale Anzahl zulässiger Ergebnisse; Das Anfordern eines Grenzwerts, der größer als der Höchstwert ist, gibt nur das Maximum zurück. Weitere Informationen zu diesem Maximum finden Sie unter results_max weiter unten. Wenn "?limit=0" verwendet wird, gibt DNSDB die maximale Anzahl zulässiger Ergebnisse zurück. Wenn für die Abfrage weniger Ergebnisse als der angeforderte Grenzwert vorhanden sind, kann nur der tatsächliche Betrag zurückgegeben werden. |
|
|
aggr
|
aggr | boolean |
Aggregierte Ergebnisse gruppieren identische rrsets über alle Zeiträume hinweg und ist das klassische Verhalten beim Abfragen der DNSDB. Dies bedeutet, dass Sie die Gesamtanzahl der Beobachteten eines Rrsets abrufen können, aber nicht, wenn es beobachtet wurde. Nicht aggregierte Ergebnisse heben die Gruppierung identischer Rrsets auf, sodass Sie sehen können, wie der Domänenname im DNS im vollständigen Bereich aufgelöst wurde, der in DNSDB behandelt wird (vorbehaltlich des Zeitfencings). Dies kann einen genaueren Eindruck des Datensatzanforderungsvolumens im Lauf der Zeit geben, da dadurch die unterschiedlichen Zeitstempel von Datensätzen angezeigt werden, deren Werte wiederholt werden. Sie können Fragen beantworten, z. B. "Wurde eine Domäne lange geparkt, meist nicht verwendet, bis sie für die Bereitstellung von Schadsoftware oder das Weiterleiten von Spam verwendet wurde, aber dann erneut abgebrochen wurde?". Es ermöglicht Ihnen zu sehen, ob ein Datensatz in der letzten Woche stark beobachtet wurde, vs. seit Jahren konstant beobachtet wurde. Dies ist ein boolescher Wert. Verwenden Sie "True", die Standardeinstellung für die aggregierten Ergebnisse oder "False" für nicht aggregierte Ergebnisse. |
|
|
Menschliche Zeit
|
humantime | boolean |
Ein boolescher Wert, der True ist, wenn Zeitwerte (in time_first, time_last, zone_time_first, zone_time_last) im lesbaren (RFC3339 konformen) Format oder False zurückgegeben werden sollen, wenn Unix-Zeitwerte in Sekunden seit der Rückgabe der Epoche zurückgegeben werden sollen. False ist das klassische Verhalten beim Abfragen der DNSDB und ist der Standardwert für diese Option. |
|
|
offset
|
offset | number |
Wie viele Zeilen in den Ergebnissen versetzt werden sollen (z. B. überspringen). Dadurch wird ein inkrementelles Ergebnisübertragungsfeature implementiert, mit dem Sie mehr der verfügbaren Ergebnisse für eine einzelne Abfrage anzeigen können. Die Zeilen werden vor dem angewendeten Limitparameter versetzt, sodass offset zusätzliche Ergebnisse über einen Grenzwert hinaus sehen kann, der der maximalen Anzahl von Ergebnissen entspricht. Beachten Sie, dass DNSDB die Ergebnisse für jede Abfrage neu berechnet und die Reihenfolge der Ergebnisse möglicherweise nicht beibehalten wird. Daher ist diese Funktion kein gültiger Weg, um alle Ergebnisse über mehrere Abfragen zu durchlaufen – einige Ergebnisse fehlen möglicherweise, und einige werden möglicherweise dupliziert. Der tatsächliche Offset, der verwendet werden kann, ist begrenzt oder für bestimmte API-Schlüssel, Offset ist nicht zulässig . Siehe den offset_max rate_limit Schlüssel unten. Der Offsetwert muss eine positive ganze Zahl sein. Der Standardwert ist 0, was bedeutet, dass die Zeilen nicht versetzt werden. |
Gibt zurück
- response
- array of RData_Results
RRSet Lookup mit RRType und Bailiwick
Die RRSet-Suche fragt den RRset-Index von DNSDB ab, der Forward-Lookups basierend auf dem Besitzernamen eines RRsets unterstützt.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
type
|
type | True | string |
Abfragetyp(Name, unformatierter) Name: Der WERT ist ein DNS-Besitzername im Präsentationsformat oder in Wildcards, wie unten beschrieben. Dies wird manchmal nur eine Rrset-Suche, unformatiert, aufgerufen: Der WERT ist eine gerade Anzahl hexadezimaler Ziffern, die eine unformatierte Oktettzeichenfolge angeben. |
|
value
|
value | True | string |
Abfragewert |
|
rrtype
|
rrtype | True | string |
Abfrage-Rrtype |
|
Vogtei
|
bailiwick | True | string |
Abfrage-Bailiwick |
|
time_first_before (Unix/Epoche)
|
time_first_before | number |
Geben Sie Ergebnisse vor dem definierten Zeitstempel für den zeitpunkt der ersten Beobachtung des DNS-Eintrags an. Der URL-Parameter "time_first_before=1420070400" stellt beispielsweise nur übereinstimmende DNS-Einträge bereit, die zuerst vor dem 1. Januar 2015 (oder älter als) beobachtet wurden. |
|
|
time_first_after (Unix/Epoche)
|
time_first_after | number |
Geben Sie Ergebnisse nach dem definierten Zeitstempel für den Zeitpunkt der ersten Beobachtung des DNS-Eintrags an. Der URL-Parameter "time_first_after=-31536000" liefert beispielsweise nur Ergebnisse, die im letzten Jahr zuerst beobachtet wurden. |
|
|
time_last_before (Unix/Epoche)
|
time_last_before | number |
Geben Sie Ergebnisse vor dem definierten Zeitstempel für den zeitpunkt der letzten Beobachtung des DNS-Eintrags an. Der URL-Parameter "time_last_before=1356998400" stellt beispielsweise nur Ergebnisse für DNS-Einträge bereit, die vor 2013 zuletzt beobachtet wurden. |
|
|
time_last_after (Unix/Epoche)
|
time_last_after | number |
Geben Sie Ergebnisse nach dem definierten Zeitstempel für den zeitpunkt der letzten Beobachtung des DNS-Eintrags an. Beispielsweise stellt der URL-Parameter "time_last_after=-2678400" nur Ergebnisse bereit, die vor 31 Tagen zuletzt beobachtet wurden. |
|
|
Begrenzung
|
limit | number |
Grenzwert für die Anzahl der Ergebnisse, die über diese Nachschlagemethoden zurückgegeben werden. Es gibt ein integriertes Limit für die Anzahl der Ergebnisse, die über diese Nachschlagemethoden zurückgegeben werden. Der Standardgrenzwert wird auf 10.000 festgelegt. Dieser Grenzwert kann durch Festlegen des Abfrageparameters "limit" ausgelöst oder herabgesetzt werden. Es gibt auch eine maximale Anzahl zulässiger Ergebnisse; Das Anfordern eines Grenzwerts, der größer als der Höchstwert ist, gibt nur das Maximum zurück. Weitere Informationen zu diesem Maximum finden Sie unter results_max weiter unten. Wenn "?limit=0" verwendet wird, gibt DNSDB die maximale Anzahl zulässiger Ergebnisse zurück. Wenn für die Abfrage weniger Ergebnisse als der angeforderte Grenzwert vorhanden sind, kann nur der tatsächliche Betrag zurückgegeben werden. |
|
|
aggr
|
aggr | boolean |
Aggregierte Ergebnisse gruppieren identische rrsets über alle Zeiträume hinweg und ist das klassische Verhalten beim Abfragen der DNSDB. Dies bedeutet, dass Sie die Gesamtanzahl der Beobachteten eines Rrsets abrufen können, aber nicht, wenn es beobachtet wurde. Nicht aggregierte Ergebnisse heben die Gruppierung identischer Rrsets auf, sodass Sie sehen können, wie der Domänenname im DNS im vollständigen Bereich aufgelöst wurde, der in DNSDB behandelt wird (vorbehaltlich des Zeitfencings). Dies kann einen genaueren Eindruck des Datensatzanforderungsvolumens im Lauf der Zeit geben, da dadurch die unterschiedlichen Zeitstempel von Datensätzen angezeigt werden, deren Werte wiederholt werden. Sie können Fragen beantworten, z. B. "Wurde eine Domäne lange geparkt, meist nicht verwendet, bis sie für die Bereitstellung von Schadsoftware oder das Weiterleiten von Spam verwendet wurde, aber dann erneut abgebrochen wurde?". Es ermöglicht Ihnen zu sehen, ob ein Datensatz in der letzten Woche stark beobachtet wurde, vs. seit Jahren konstant beobachtet wurde. Dies ist ein boolescher Wert. Verwenden Sie "True", die Standardeinstellung für die aggregierten Ergebnisse oder "False" für nicht aggregierte Ergebnisse. |
|
|
Menschliche Zeit
|
humantime | boolean |
Ein boolescher Wert, der True ist, wenn Zeitwerte (in time_first, time_last, zone_time_first, zone_time_last) im lesbaren (RFC3339 konformen) Format oder False zurückgegeben werden sollen, wenn Unix-Zeitwerte in Sekunden seit der Rückgabe der Epoche zurückgegeben werden sollen. False ist das klassische Verhalten beim Abfragen der DNSDB und ist der Standardwert für diese Option. |
|
|
offset
|
offset | number |
Wie viele Zeilen in den Ergebnissen versetzt werden sollen (z. B. überspringen). Dadurch wird ein inkrementelles Ergebnisübertragungsfeature implementiert, mit dem Sie mehr der verfügbaren Ergebnisse für eine einzelne Abfrage anzeigen können. Die Zeilen werden vor dem angewendeten Limitparameter versetzt, sodass offset zusätzliche Ergebnisse über einen Grenzwert hinaus sehen kann, der der maximalen Anzahl von Ergebnissen entspricht. Beachten Sie, dass DNSDB die Ergebnisse für jede Abfrage neu berechnet und die Reihenfolge der Ergebnisse möglicherweise nicht beibehalten wird. Daher ist diese Funktion kein gültiger Weg, um alle Ergebnisse über mehrere Abfragen zu durchlaufen – einige Ergebnisse fehlen möglicherweise, und einige werden möglicherweise dupliziert. Der tatsächliche Offset, der verwendet werden kann, ist begrenzt oder für bestimmte API-Schlüssel, Offset ist nicht zulässig . Siehe den offset_max rate_limit Schlüssel unten. Der Offsetwert muss eine positive ganze Zahl sein. Der Standardwert ist 0, was bedeutet, dass die Zeilen nicht versetzt werden. |
Gibt zurück
- response
- array of RRSet_Results
RRSet-Nachschlagevorgang
Die RRSet-Suche fragt den RRset-Index von DNSDB ab, der Forward-Lookups basierend auf dem Besitzernamen eines RRsets unterstützt.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
type
|
type | True | string |
Abfragetyp(Name, unformatierter) Name: Der WERT ist ein DNS-Besitzername im Präsentationsformat oder in Wildcards, wie unten beschrieben. Dies wird manchmal nur eine Rrset-Suche, unformatiert, aufgerufen: Der WERT ist eine gerade Anzahl hexadezimaler Ziffern, die eine unformatierte Oktettzeichenfolge angeben. |
|
value
|
value | True | string |
Abfragewert |
|
time_first_before (Unix/Epoche)
|
time_first_before | number |
Geben Sie Ergebnisse vor dem definierten Zeitstempel für den zeitpunkt der ersten Beobachtung des DNS-Eintrags an. Der URL-Parameter "time_first_before=1420070400" stellt beispielsweise nur übereinstimmende DNS-Einträge bereit, die zuerst vor dem 1. Januar 2015 (oder älter als) beobachtet wurden. |
|
|
time_first_after (Unix/Epoche)
|
time_first_after | number |
Geben Sie Ergebnisse nach dem definierten Zeitstempel für den Zeitpunkt der ersten Beobachtung des DNS-Eintrags an. Der URL-Parameter "time_first_after=-31536000" liefert beispielsweise nur Ergebnisse, die im letzten Jahr zuerst beobachtet wurden. |
|
|
time_last_before (Unix/Epoche)
|
time_last_before | number |
Geben Sie Ergebnisse vor dem definierten Zeitstempel für den zeitpunkt der letzten Beobachtung des DNS-Eintrags an. Der URL-Parameter "time_last_before=1356998400" stellt beispielsweise nur Ergebnisse für DNS-Einträge bereit, die vor 2013 zuletzt beobachtet wurden. |
|
|
time_last_after (Unix/Epoche)
|
time_last_after | number |
Geben Sie Ergebnisse nach dem definierten Zeitstempel für den zeitpunkt der letzten Beobachtung des DNS-Eintrags an. Beispielsweise stellt der URL-Parameter "time_last_after=-2678400" nur Ergebnisse bereit, die vor 31 Tagen zuletzt beobachtet wurden. |
|
|
Begrenzung
|
limit | number |
Grenzwert für die Anzahl der Ergebnisse, die über diese Nachschlagemethoden zurückgegeben werden. Es gibt ein integriertes Limit für die Anzahl der Ergebnisse, die über diese Nachschlagemethoden zurückgegeben werden. Der Standardgrenzwert wird auf 10.000 festgelegt. Dieser Grenzwert kann durch Festlegen des Abfrageparameters "limit" ausgelöst oder herabgesetzt werden. Es gibt auch eine maximale Anzahl zulässiger Ergebnisse; Das Anfordern eines Grenzwerts, der größer als der Höchstwert ist, gibt nur das Maximum zurück. Weitere Informationen zu diesem Maximum finden Sie unter results_max weiter unten. Wenn "?limit=0" verwendet wird, gibt DNSDB die maximale Anzahl zulässiger Ergebnisse zurück. Wenn für die Abfrage weniger Ergebnisse als der angeforderte Grenzwert vorhanden sind, kann nur der tatsächliche Betrag zurückgegeben werden. |
|
|
aggr
|
aggr | boolean |
Aggregierte Ergebnisse gruppieren identische rrsets über alle Zeiträume hinweg und ist das klassische Verhalten beim Abfragen der DNSDB. Dies bedeutet, dass Sie die Gesamtanzahl der Beobachteten eines Rrsets abrufen können, aber nicht, wenn es beobachtet wurde. Nicht aggregierte Ergebnisse heben die Gruppierung identischer Rrsets auf, sodass Sie sehen können, wie der Domänenname im DNS im vollständigen Bereich aufgelöst wurde, der in DNSDB behandelt wird (vorbehaltlich des Zeitfencings). Dies kann einen genaueren Eindruck des Datensatzanforderungsvolumens im Lauf der Zeit geben, da dadurch die unterschiedlichen Zeitstempel von Datensätzen angezeigt werden, deren Werte wiederholt werden. Sie können Fragen beantworten, z. B. "Wurde eine Domäne lange geparkt, meist nicht verwendet, bis sie für die Bereitstellung von Schadsoftware oder das Weiterleiten von Spam verwendet wurde, aber dann erneut abgebrochen wurde?". Es ermöglicht Ihnen zu sehen, ob ein Datensatz in der letzten Woche stark beobachtet wurde, vs. seit Jahren konstant beobachtet wurde. Dies ist ein boolescher Wert. Verwenden Sie "True", die Standardeinstellung für die aggregierten Ergebnisse oder "False" für nicht aggregierte Ergebnisse. |
|
|
Menschliche Zeit
|
humantime | boolean |
Ein boolescher Wert, der True ist, wenn Zeitwerte (in time_first, time_last, zone_time_first, zone_time_last) im lesbaren (RFC3339 konformen) Format oder False zurückgegeben werden sollen, wenn Unix-Zeitwerte in Sekunden seit der Rückgabe der Epoche zurückgegeben werden sollen. False ist das klassische Verhalten beim Abfragen der DNSDB und ist der Standardwert für diese Option. |
|
|
offset
|
offset | number |
Wie viele Zeilen in den Ergebnissen versetzt werden sollen (z. B. überspringen). Dadurch wird ein inkrementelles Ergebnisübertragungsfeature implementiert, mit dem Sie mehr der verfügbaren Ergebnisse für eine einzelne Abfrage anzeigen können. Die Zeilen werden vor dem angewendeten Limitparameter versetzt, sodass offset zusätzliche Ergebnisse über einen Grenzwert hinaus sehen kann, der der maximalen Anzahl von Ergebnissen entspricht. Beachten Sie, dass DNSDB die Ergebnisse für jede Abfrage neu berechnet und die Reihenfolge der Ergebnisse möglicherweise nicht beibehalten wird. Daher ist diese Funktion kein gültiger Weg, um alle Ergebnisse über mehrere Abfragen zu durchlaufen – einige Ergebnisse fehlen möglicherweise, und einige werden möglicherweise dupliziert. Der tatsächliche Offset, der verwendet werden kann, ist begrenzt oder für bestimmte API-Schlüssel, Offset ist nicht zulässig . Siehe den offset_max rate_limit Schlüssel unten. Der Offsetwert muss eine positive ganze Zahl sein. Der Standardwert ist 0, was bedeutet, dass die Zeilen nicht versetzt werden. |
Gibt zurück
- response
- array of RRSet_Results
RRSet-Nachschlagevorgang mit RRType
Die RRSet-Suche fragt den RRset-Index von DNSDB ab, der Forward-Lookups basierend auf dem Besitzernamen eines RRsets unterstützt.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
type
|
type | True | string |
Abfragetyp(Name, unformatierter) Name: Der WERT ist ein DNS-Besitzername im Präsentationsformat oder in Wildcards, wie unten beschrieben. Dies wird manchmal nur eine Rrset-Suche, unformatiert, aufgerufen: Der WERT ist eine gerade Anzahl hexadezimaler Ziffern, die eine unformatierte Oktettzeichenfolge angeben. |
|
value
|
value | True | string |
Abfragewert |
|
rrtype
|
rrtype | True | string |
Abfrage-Rrtype |
|
time_first_before (Unix/Epoche)
|
time_first_before | number |
Geben Sie Ergebnisse vor dem definierten Zeitstempel für den zeitpunkt der ersten Beobachtung des DNS-Eintrags an. Der URL-Parameter "time_first_before=1420070400" stellt beispielsweise nur übereinstimmende DNS-Einträge bereit, die zuerst vor dem 1. Januar 2015 (oder älter als) beobachtet wurden. |
|
|
time_first_after (Unix/Epoche)
|
time_first_after | number |
Geben Sie Ergebnisse nach dem definierten Zeitstempel für den Zeitpunkt der ersten Beobachtung des DNS-Eintrags an. Der URL-Parameter "time_first_after=-31536000" liefert beispielsweise nur Ergebnisse, die im letzten Jahr zuerst beobachtet wurden. |
|
|
time_last_before (Unix/Epoche)
|
time_last_before | number |
Geben Sie Ergebnisse vor dem definierten Zeitstempel für den zeitpunkt der letzten Beobachtung des DNS-Eintrags an. Der URL-Parameter "time_last_before=1356998400" stellt beispielsweise nur Ergebnisse für DNS-Einträge bereit, die vor 2013 zuletzt beobachtet wurden. |
|
|
time_last_after (Unix/Epoche)
|
time_last_after | number |
Geben Sie Ergebnisse nach dem definierten Zeitstempel für den zeitpunkt der letzten Beobachtung des DNS-Eintrags an. Beispielsweise stellt der URL-Parameter "time_last_after=-2678400" nur Ergebnisse bereit, die vor 31 Tagen zuletzt beobachtet wurden. |
|
|
Begrenzung
|
limit | number |
Grenzwert für die Anzahl der Ergebnisse, die über diese Nachschlagemethoden zurückgegeben werden. Es gibt ein integriertes Limit für die Anzahl der Ergebnisse, die über diese Nachschlagemethoden zurückgegeben werden. Der Standardgrenzwert wird auf 10.000 festgelegt. Dieser Grenzwert kann durch Festlegen des Abfrageparameters "limit" ausgelöst oder herabgesetzt werden. Es gibt auch eine maximale Anzahl zulässiger Ergebnisse; Das Anfordern eines Grenzwerts, der größer als der Höchstwert ist, gibt nur das Maximum zurück. Weitere Informationen zu diesem Maximum finden Sie unter results_max weiter unten. Wenn "?limit=0" verwendet wird, gibt DNSDB die maximale Anzahl zulässiger Ergebnisse zurück. Wenn für die Abfrage weniger Ergebnisse als der angeforderte Grenzwert vorhanden sind, kann nur der tatsächliche Betrag zurückgegeben werden. |
|
|
aggr
|
aggr | boolean |
Aggregierte Ergebnisse gruppieren identische rrsets über alle Zeiträume hinweg und ist das klassische Verhalten beim Abfragen der DNSDB. Dies bedeutet, dass Sie die Gesamtanzahl der Beobachteten eines Rrsets abrufen können, aber nicht, wenn es beobachtet wurde. Nicht aggregierte Ergebnisse heben die Gruppierung identischer Rrsets auf, sodass Sie sehen können, wie der Domänenname im DNS im vollständigen Bereich aufgelöst wurde, der in DNSDB behandelt wird (vorbehaltlich des Zeitfencings). Dies kann einen genaueren Eindruck des Datensatzanforderungsvolumens im Lauf der Zeit geben, da dadurch die unterschiedlichen Zeitstempel von Datensätzen angezeigt werden, deren Werte wiederholt werden. Sie können Fragen beantworten, z. B. "Wurde eine Domäne lange geparkt, meist nicht verwendet, bis sie für die Bereitstellung von Schadsoftware oder das Weiterleiten von Spam verwendet wurde, aber dann erneut abgebrochen wurde?". Es ermöglicht Ihnen zu sehen, ob ein Datensatz in der letzten Woche stark beobachtet wurde, vs. seit Jahren konstant beobachtet wurde. Dies ist ein boolescher Wert. Verwenden Sie "True", die Standardeinstellung für die aggregierten Ergebnisse oder "False" für nicht aggregierte Ergebnisse. |
|
|
Menschliche Zeit
|
humantime | boolean |
Ein boolescher Wert, der True ist, wenn Zeitwerte (in time_first, time_last, zone_time_first, zone_time_last) im lesbaren (RFC3339 konformen) Format oder False zurückgegeben werden sollen, wenn Unix-Zeitwerte in Sekunden seit der Rückgabe der Epoche zurückgegeben werden sollen. False ist das klassische Verhalten beim Abfragen der DNSDB und ist der Standardwert für diese Option. |
|
|
offset
|
offset | number |
Wie viele Zeilen in den Ergebnissen versetzt werden sollen (z. B. überspringen). Dadurch wird ein inkrementelles Ergebnisübertragungsfeature implementiert, mit dem Sie mehr der verfügbaren Ergebnisse für eine einzelne Abfrage anzeigen können. Die Zeilen werden vor dem angewendeten Limitparameter versetzt, sodass offset zusätzliche Ergebnisse über einen Grenzwert hinaus sehen kann, der der maximalen Anzahl von Ergebnissen entspricht. Beachten Sie, dass DNSDB die Ergebnisse für jede Abfrage neu berechnet und die Reihenfolge der Ergebnisse möglicherweise nicht beibehalten wird. Daher ist diese Funktion kein gültiger Weg, um alle Ergebnisse über mehrere Abfragen zu durchlaufen – einige Ergebnisse fehlen möglicherweise, und einige werden möglicherweise dupliziert. Der tatsächliche Offset, der verwendet werden kann, ist begrenzt oder für bestimmte API-Schlüssel, Offset ist nicht zulässig . Siehe den offset_max rate_limit Schlüssel unten. Der Offsetwert muss eine positive ganze Zahl sein. Der Standardwert ist 0, was bedeutet, dass die Zeilen nicht versetzt werden. |
Gibt zurück
- response
- array of RRSet_Results
Definitionen
RRSet_Results
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Anzahl
|
count | number |
Die Häufigkeit, mit der das RRset über die passive DNS-Replikation beobachtet wurde. |
|
Erstmaliges Mal
|
time_first | number |
Das erste Mal, dass das RRset beobachtet wurde. |
|
Uhrzeit zuletzt
|
time_last | number |
Die jüngste Zeit, zu der das RRset beobachtet wurde. |
|
Zone Time First
|
zone_time_first | number |
Das erste Mal, dass das RRset über den Zonendateiimport beobachtet wurde. |
|
Zone Time Last
|
zone_time_last | number |
Das letzte Mal, dass das RRset über den Zonendateiimport beobachtet wurde. |
|
RRName
|
rrname | string |
Der Besitzername des RRset im DNS-Präsentationsformat. |
|
RRType
|
rrtype | string |
Der Ressourceneintragstyp des RRsets, entweder unter Verwendung des standardmäßigen DNS-Typs Mnemonic oder eines generischen RFC 3597-Typs, d. h. der ZeichenfolgeNTYP unmittelbar gefolgt von der Dezimal-RRtype-Zahl. |
|
Vogtei
|
bailiwick | string |
Die nächstgelegene umschließende Zone, die an einen Namenserver delegiert wird, der das RRset bedient hat, oder der Name der Zone, die das RRset enthält, wenn FromZoneFile "True" ist. |
|
RData
|
rdata | array of string |
Ein Array mit mindestens einem Rdata-Wert. Die Rdata-Werte werden basierend auf dem Rrtype-Wert in das Standardpräsentationsformat konvertiert. Wenn der Encoder kein typspezifisches Präsentationsformat für den RRset-Rrtype aufweist, wird die generische Rdata-Codierung RFC 3597 verwendet. |
RData_Results
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Anzahl
|
count | number |
Die Häufigkeit, mit der der Ressourceneintrag über die passive DNS-Replikation beobachtet wurde. |
|
Erstmaliges Mal
|
time_first | number |
Das erste Mal, dass der Ressourcendatensatz beobachtet wurde. |
|
Uhrzeit zuletzt
|
time_last | number |
Die letzte Zeit, zu der der Ressourcendatensatz beobachtet wurde. |
|
Zone Time First
|
zone_time_first | number |
Das erste Mal, dass der Ressourcendatensatz über den Zonendateiimport beobachtet wurde. |
|
Zone Time Last
|
zone_time_last | number |
Das letzte Mal, dass der Ressourcendatensatz über den Zonendateiimport beobachtet wurde. |
|
RRName
|
rrname | string |
Der Besitzername des Ressourceneintrags im DNS-Präsentationsformat. |
|
RRType
|
rrtype | string |
Der Ressourceneintragstyp des Ressourceneintrags, entweder mit dem standardmäßigen DNS-Typ Mnemonic oder einem generischen RFC 3597-Typ, d. h. dem ZeichenfolgenTYP unmittelbar gefolgt von der dezimalen RRtype-Nummer. |
|
RData
|
rdata | array of string |
Der Datensatzdatenwert. Der Rdata-Wert wird basierend auf dem Rrtype-Wert in das Standardpräsentationsformat konvertiert. Wenn der Encoder kein typspezifisches Präsentationsformat für den Ressourcendatensatztyp aufweist, wird die generische Rdata-Codierung RFC 3597 verwendet. |
Flex_Results
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
RData
|
rdata | string |
Der Datensatzdatenwert. |
|
RRName
|
rrname | string |
Der Besitzername des RRset im DNS-Präsentationsformat. |
|
RRType
|
rrtype | string |
Der Ressourceneintragstyp des RRset/Resource-Eintrags, entweder unter Verwendung des standardmäßigen DNS-Typs Mnemonic oder eines generischen RFC 3597-Typs, d. h. der ZeichenfolgeNTYP unmittelbar gefolgt von der dezimalen RRtype-Zahl. |
|
RAW_RDATA
|
raw_rdata | string |
Der Datensatzdatenwert als Paare von Hexadezimierungen, die eine unformatierte Oktettzeichenfolge angeben. Dieser Wert wird für das Pivoting von flexibler Suche in die Standardsuche verwendet, um weitere Details zu rdata zu erhalten. |
RateLimit_Results
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Limit
|
limit | number |
Die maximale Anzahl von API-Nachschlagevorgängen, die ausgeführt werden können. Dies ist das anfängliche Kontingent. |
|
Verbleibend
|
remaining | number |
Für zeitbasierte Kontingente: die verbleibende Anzahl von API-Nachschlagevorgängen, die bis zur Zurücksetzungszeit ausgeführt werden können. Für blockbasierte Kontingente: die verbleibende Anzahl von API-Nachschlagevorgängen im Blockkontingent. |
|
Zurücksetzen
|
reset | number |
Für zeitbasierte Kontingente: UNIX-Zeitstempel mit zweiter Granularität, der den nächsten Zeitpunkt angibt, an dem das Kontingentlimit zurückgesetzt wird. In der Regel ist dies um 00:00 (Mitternacht) UTC. Für blockbasierte Kontingente: Der Wert lautet "n/a" |
|
Läuft ab
|
expires | number |
Nur für blockbasiertes Kontingent vorhanden: UNIX-Zeitstempel mit zweiter Granularität, der angibt, wann das Kontingent abläuft. |
|
ResultsMax
|
results_max | number |
Gibt die maximale Anzahl von Ergebnissen zurück, die von diesen Nachschlagemethoden zurückgegeben werden können. Dadurch wird ein Abfrageparameter "limit" außer Kraft gesetzt, falls angegeben. Wenn beispielsweise "?limit=20000" an den URL-Pfad angefügt wird, aber results_max=1000 dann nur bis zu 1000 Ergebnisse zurückgegeben werden. |
|
OffsetMax
|
offset_max | number |
Der Maximalwert, den der Offsetabfrageparameter sein kann. Wenn sie höher ist, wird der Antwortcode "Angeforderter Bereich nicht satisfiable" mit der Meldung "Fehler: Offsetwert größer als maximal zulässig" zurückgegeben. Wenn der Wert "n/a" lautet, ist der Offsetparameter für diesen API-Schlüssel nicht zulässig, und ein ähnlicher 416-Fehler wird generiert. |
|
BurstSize
|
burst_size | number |
Die maximale Anzahl von API-Nachschlagevorgängen, die innerhalb dieses burst_window Anzahl von Sekunden ausgeführt werden können. |
|
BurstWindow
|
burst_window | number |
Die Anzahl der Sekunden, über die ein Ausplatzen von Abfragen gemessen wird. |