Statistikabfrage für Domains und Subdomains ausführen¶

Note

Ist type auf fqdn gesetzt, muss sich jeder Eintrag von fqdn auf eine Domain auflösen lassen, auf die der authentifizierte Nutzende Lesezugriff hat, und ihre Anzahl darf das konfigurierte Domain-Limit nicht überschreiten, andernfalls schlägt die Anfrage mit einem Validierungsfehler fehl.

Senden einer POST-Anfrage an den Endpunkt /statistic/query.

Beschreibung¶

Mit der Statistic-Query-Anfrage führen Sie eine Statistikabfrage für einen bestimmten Zeitraum aus und erhalten die angefragten Datenquellen aggregiert nach den passenden Domains, Subdomains oder FQDNs.

Voraussetzungen¶

Werte der Anfrage: keine Objekte: StatisticVO

Anfrage¶

Um eine Statistikabfrage auszuführen, muss das Objekt query StatisticVO dem Body der Anfrage hinzugefügt werden. Das Attribut query ist ein verschachteltes StatisticQueryVO-Objekt mit den folgenden Attributen:

Attribut	Beschreibung	Werte
`startDate`	Der Anfang des Aggregationsintervalls.	`string($date-time)`
`endDate`	Das Ende des Aggregationsintervalls. Die Differenz zwischen `startDate` und `endDate` darf 7952399 Sekunden (etwa 92 Tage) nicht überschreiten.	`string($date-time)`
`dataSources`	Eine Map aus beliebigen Datensatznamen zur angefragten Datenquelle und zum Ausgabetyp, in der Form `{\"<name>\": {\"source\": \"<sourceName>\", \"type\": \"<outputType>\"}}`. Mindestens ein Eintrag ist erforderlich. `sourceName` ist einer der Werte `requests`, `requests_total`, `requests_ssl`, `requests_nonssl`, `requests_blocked`, `requests_blocked_reason`, `requests_cached`, `requests_cached_ssl`, `requests_cached_nonssl`, `requests_uncached`, `requests_uncached_ssl`, `requests_uncached_nonssl`, `bytes`, `bytes_ssl`, `bytes_nonssl`, `bytes_cached`, `bytes_cached_ssl`, `bytes_cached_nonssl`, `bytes_uncached`, `bytes_uncached_ssl`, `bytes_uncached_nonssl`, `response_codes`, `country_codes`, `requests_cache_hits`, `requests_blocked_hits`, `requests_cache_hits_ssl`, `requests_cache_hits_nonssl`, `bytes_cache_hits`, `bytes_cache_hits_ssl`, `bytes_cache_hits_nonssl` oder `upstream_performance`. `outputType` ist `stats` oder `histogram`.	`object`

Die folgenden Attribute sind optional:

Attribut	Beschreibung	Werte
`fqdn`	Eine Liste von Domainnamen, die aggregiert werden. Wird nur verwendet, wenn `type` auf `fqdn` gesetzt ist.	`array` von `string`
`aggregationInterval`	Das für Histogram-Datenquellen verwendete Aggregationsintervall.	`2m` `hour` `day` `week` `month` `year`
`type`	Legt fest, für welche Domains die Statistik erstellt wird.	`all` `own` `foreign` `fqdn`

Das System gibt das Objekt StatisticVO zurück, dessen Attribut result die aggregierten Daten für jeden angefragten Eintrag von dataSources enthält.

Beispiel¶

Beispiel-Request-Body:

{
  "query": {
    "startDate": "2026-01-01T00:00:00+00:00",
    "endDate": "2026-01-01T00:00:00+00:00",
    "dataSources": {},
    "fqdn": [
      "string"
    ],
    "aggregationInterval": "day",
    "type": "fqdn"
  }
}

Antworten¶

Die folgenden Antworten sind möglich:

STATUSCODE	BESCHREIBUNG
200	Die Anfrage war erfolgreich.
400	Die Anfrage war nicht erfolgreich. Die Anfrage war fehlerhaft oder es fehlen Informationen.
401	Die Anfrage war nicht erfolgreich, da die Authentifizierung fehlerhaft war.
403	Die Anfrage war nicht erfolgreich, da die erforderlichen Berechtigungen fehlen.