Gesamtzahl der Anfragen einer Domain oder Subdomain abrufen¶

Note

Sie müssen im ausgewählten Zeitraum mindestens READ-Berechtigungen besitzen.

Note

Domains und Subdomains, für die keine Berechtigungen bestehen, werden übersprungen.

Note

Im Body muss mindestens eines der Attribute domains oder subDomains definiert sein.

Senden einer POST-Anfrage an den Endpunkt /statistics/total-domain-requests/{startTime}/{finishTime}.

Beschreibung¶

Mit der Get-Total-Requests-For-A-Domain-Anfrage rufen Sie eine Statistik der Gesamtanfragen einer oder mehrerer Domains oder Subdomains für den ausgewählten Zeitraum ab.

Voraussetzungen¶

Werte der Anfrage: Startdate {startTime}; Enddate {finishTime}

Objekte: StatisticsVO

Anfrage¶

Um eine Statistik der Gesamtanfragen einer oder mehrerer Domains oder Subdomains abzurufen, fügen Sie die Start- und Endzeit als Unix-Zeitstempel dem Pfad der Anfrage hinzu.

Für eine detaillierte Spezifikation, welche Informationen zum Abrufen einer Statistik erforderlich sind, müssen im Body die folgenden Attribute definiert werden:

Attribut	Beschreibung	Werte
`domains`	Ein Array mit den Namen der Domains.HinweisUm eine Domain mit allen ihren Subdomains aufzunehmen, muss das Attribut `subDomains` leer sein.	`string`
`subDomains`	Ein Array mit den Namen der Subdomains.HinweisUm nur bestimmte Subdomains aufzunehmen, kann das Attribut `Domains` leer sein.	`string`

Als Ergebnis erhalten Sie das Objekt graph mit Daten für jede Analysekategorie für die ausgewählten Domains oder Subdomains zur grafischen Visualisierung.

Außerdem das Objekt data mit den zugehörigen Gesamtdaten.

Das Objekt data liefert die folgenden Informationen:

Attribut	Beschreibung	Werte
`total_requests`	Die Gesamtzahl der Anfragen.	`integer`
`total_https_requests`	Die Gesamtzahl der HTTPS-Anfragen.	`integer`
`total_non_https_requests`	Die Gesamtzahl der Nicht-HTTPS-Anfragen.	`integer`
`total_blocked_requests`	Die Gesamtzahl der blockierten Anfragen.	`integer`
`total_cached_requests`	Die Gesamtzahl der zwischengespeicherten Anfragen.	`integer`
`total_uncached_requests`	Die Gesamtzahl der nicht zwischengespeicherten Anfragen.	`integer`
`total_redirect_requests`	Die Gesamtzahl der weitergeleiteten Anfragen.	`integer`
`total_verified_requests`	Die Gesamtzahl der verifizierten Anfragen.	`integer`
`total_traffic`	Die Gesamtmenge des Traffics.	`integer`
`total_ingress_traffic`	Die Gesamtmenge des eingehenden Traffics.	`integer`
`total_egress_traffic`	Die Gesamtmenge des ausgehenden Traffics.	`integer`
`total_cached_traffic`	Die Gesamtmenge des zwischengespeicherten Traffics.	`integer`
`total_uncached_traffic`	Die Gesamtmenge des nicht zwischengespeicherten Traffics.	`integer`
`mean_requests_ps`	Die durchschnittliche Anzahl der Anfragen pro Sekunde.	`integer`
`mean_blocked_requests_ps`	Die durchschnittliche Anzahl der blockierten Anfragen pro Sekunde.	`integer`
`mean_cached_requests_ps`	Die durchschnittliche Anzahl der zwischengespeicherten Anfragen pro Sekunde.	`integer`
`mean_uncached_requests_ps`	Die durchschnittliche Anzahl der nicht zwischengespeicherten Anfragen pro Sekunde.	`integer`
`mean_redirect_requests_ps`	Die durchschnittliche Anzahl der weitergeleiteten Anfragen pro Sekunde.	`integer`
`mean_verified_requests_ps`	Die durchschnittliche Anzahl der verifizierten Anfragen pro Sekunde.	`integer`
`mean_traffic_ps`	Die durchschnittliche Traffic-Menge pro Sekunde.	`integer`
`mean_cached_traffic_ps`	Die durchschnittliche Menge des zwischengespeicherten Traffics pro Sekunde.	`integer`
`mean_uncached_traffic_ps`	Die durchschnittliche Menge des nicht zwischengespeicherten Traffics pro Sekunde.	`integer`
`upstream_time_avg`	Die durchschnittliche Upstream-Zeit.	`integer`

Für eine grafische Visualisierung der Daten je Datenpunkt im ausgewählten Zeitraum finden Sie unter Data für jedes Attribut das Objekt graph mit den relevanten Daten für die Analyse.

Attribut	Beschreibung	Werte
`x`	Datum und Uhrzeit des Datenpunkts.	`integer` als Unix-Zeitstempel
`y`	Der Wert für den zugehörigen Datenpunkt.	`integer`

Beispiel¶

Beispiel-Request-Body:

{
  "domains": "string",
  "subDomains": "string",
  "total_requests": 0,
  "total_https_requests": 0,
  "total_non_https_requests": 0,
  "total_blocked_requests": 0,
  "total_cached_requests": 0,
  "total_uncached_requests": 0,
  "total_redirect_requests": 0,
  "total_verified_requests": 0,
  "total_traffic": 0,
  "total_ingress_traffic": 0,
  "total_egress_traffic": 0,
  "total_cached_traffic": 0,
  "total_uncached_traffic": 0,
  "mean_requests_ps": 0,
  "mean_blocked_requests_ps": 0,
  "mean_cached_requests_ps": 0,
  "mean_uncached_requests_ps": 0,
  "mean_redirect_requests_ps": 0,
  "mean_verified_requests_ps": 0,
  "mean_traffic_ps": 0,
  "mean_cached_traffic_ps": 0,
  "mean_uncached_traffic_ps": 0,
  "upstream_time_avg": 0,
  "x": 0,
  "y": 0
}

Antworten¶

Die folgenden Antworten sind möglich:

STATUSCODE	BESCHREIBUNG
201	Die Anfrage war erfolgreich und ein neues Objekt wurde erstellt.
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.