Qbrick
Art der Daten
CDN-Nutzung
Beschreibung
Monatliche Nutzung in GB für Qbrick CDN
Daten-Feed-Format
Ein Beispiel für einen monatlichen Nutzungs-Daten-Feed sieht wie folgt aus:
{
"usage": {
"unit": "GB",
"value": "444706.06"
}
}
<!--NeedCopy-->
Implementierungshinweise
- Nutzungsmetriken werden erfasst.
- Zeigt monatliche Nutzungsmetriken vom Monatsanfang bis zum aktuellen Tag an (immer basierend auf dem aktuellen Monat).
-
Die monatliche Nutzung wird durch das Senden dieser Anfrage an die Qbrick API empfangen:
{"metric":"size","tStart":1517443200000,"tEnd":2517443200000,"resolution":0} - Qbrick führt die Aggregation für den Zeitbereich durch. Die zurückgegebenen Daten umfassen die gesamte Nutzung zwischen tStart und tEnd (in Millisekunden). Diese Berechnung ist intern bei Qbrick.
Abgleichschritte
OAuth2.0 bietet verschiedene Authentifizierungsmethoden. Qbrick empfiehlt Ihnen, als ersten Schritt den Implicit Grant Flow zur Authentifizierung zu verwenden.
1. Authentifizierungstoken abrufen
POST https://video.qbrick.com/account/authentications
headers: "Content-Type": "application/json"
body : {"email": "[customer_email_here]", "password": "c[password_here]", "persistent": false}
<!--NeedCopy-->
cURL-Anfrage:
curl "https://video.qbrick.com/account/authentications" -H 'Content-Type: application/json' -d '{"email": "[customer_email_here]", "password": "[password_here]", "persistent": false}'
<!--NeedCopy-->
Die Antwort besteht aus Ihrer Konto-ID, Kunden-ID und weiteren Informationen, einschließlich des generierten “Tokens”.
Antwort:
Die Antwort besteht aus Ihrer Konto-ID, Kunden-ID und weiteren Informationen, einschließlich des generierten Tokens.
{
"id": 123456,
"uid": 123456,
"token": "0e5f64267aff1cc48963b1f8995c76a1",
"expiration": 1519226015000,
"impersonate": -1,
"customerId": 123456,
"account": 123456
}
<!--NeedCopy-->
Hinweis: Das Authentifizierungstoken ist eine Woche lang gültig.
2. Zugriffstoken abrufen
Verwenden Sie die folgende Anfrage, um das Zugriffstoken abzurufen:
GET https://video.qbrick.com/authorization/oauth2/token?client_id=&authentication_token=&redirect_uri=http://video.qbrick.com/oauth.html&response_type=token
<!--NeedCopy-->
Der Server muss mit einer 302-Weiterleitung antworten, die den Location-Antwortheader mit der im Request verwendeten URI und dem Zugriffstoken enthält.
Antwort:
HTTP/1.1 302 Found
Server: Apache-Coyote/1.1
Location: http://video.qbrick.com/oauth.html#access_token=MjQ0ODEwN2MtNTQ3MS00MDJiLTgzNTctZmI2NTU5ZGIzZDJk&token_type=bearer&expires_in=3600
Pragma: no-cache
Cache-Control: no-cache, no-store, no-transform
Content-Length: 0
Date: Tue, 29 May 2018 22:00:42 GMT
Set-Cookie: qvp-Tomcat-Farm=as260; path=/
<!--NeedCopy-->
3. Nutzung abrufen
POST /api/v1/analytics/cdn/accounts/946645/stats?unit=gb HTTP/1.1
Host: video.qbrick.com
Authorization: Bearer NWM0NTU3NTUtZGZhMi00Y2UyLWJmNWQtYj43654635467354765
Content-Type: application/json
{"metric":"size","tStart":1517443200000,"tEnd":2517443200000,"resolution":0}
<!--NeedCopy-->
cURL-Anfrage:
curl 'https://video.qbrick.com/api/v1/analytics/cdn/accounts/123456/stats?unit=gb' -H 'Authorization: Bearer NWM0NTU3NTUtZGZhMi00Y2UyLWJmNWQtYj43654635467354765' -H 'Content-Type: application/json' -d '{"metric":"size","tStart":1517443200000,"tEnd":2517443200000,"resolution":0}'
<!--NeedCopy-->
Dabei gilt:
-
unit=gbist eine Option, um den Wert in GB zu erhalten. Dies ist optional. Falls nicht angegeben, ist das Ergebnis in Bytes. “Metric”:”size” ist die Nutzung. -
tStartist die Zeit in Millisekunden seit der Epoche. Wir setzen dies auf den ersten Tag des Monats um Mitternacht. -
tEndist eine Zeit in Millisekunden weit in der Zukunft. -
"Resolution": 0dient dazu, einen einzelnen Wert für den angegebenen Zeitbereich zu erhalten.
Das Ergebnis sieht wie folgt aus:
[
{
"tValue": 1517443200000,
"value": 267594.852717525
}
]
<!--NeedCopy-->
Dabei gilt:
-
tValueist der Beginn eines von uns bereitgestellten Zeitfensters, d.h. es ist der erste Tag des Monats um Mitternacht. -
valueist die Anzahl der seittValuegelieferten GB.
Einrichtung in Fusion
Sie können über den linken Navigationsbereich unter Openmix auf Fusion Data Feeds zugreifen. Für die ersten Schritte lesen Sie die Dokumentation zur Fusion-Integration.
Wenn Sie zum Dialogfeld für die dienstspezifische Konfiguration gelangen, besteht der erste Schritt darin, den Dienst auszuwählen, den Sie konfigurieren möchten.
Der nächste Schritt ist das Ausfüllen der folgenden Konfigurationsfelder:
- Name: Der Name, der dem Daten-Feed gegeben wird. Dieser wird standardmäßig auf “Dienst - Plattformname” gesetzt, falls nicht anders angegeben.
- Ausführungshäufigkeit: Wie oft der Daten-Feed vom Dienst aktualisiert wird.
- Plattform: Die Plattform, die mit dem Daten-Feed verknüpft ist.
- API-Benutzer-E-Mail: Dies ist die Qbrick-Benutzer-ID (E-Mail), die für die Anmeldung bei Qbrick verwendet wird.
- API-Client-ID: Die Art der Daten, die Sie abrufen möchten, z. B. Statistiken zur Lastverteilung, Authentifizierungsstatistiken, DNS-Statistiken.
- API-Passwort: Das API-Passwort für das CDN-Konto des Benutzers.
- Kontonummer: Die Qbrick-Kontonummer des Benutzers. Sie gibt das CDN-Konto des Benutzers an.
Sobald die Qbrick Fusion-Konfiguration abgeschlossen ist, wird sie auf der Startseite der Fusion-Daten-Feeds mit einem grünen Status und Überwachungsmetriken im Protokollverlauf angezeigt.
Daten-Feed-Verlauf
Sie können den Status des Daten-Feeds, Informationen zu den Daten und die vom Dienst zurückgegebene Nutzlast anzeigen. Nachdem Sie den spezifischen Daten-Feed in der Liste ausgewählt haben, klicken Sie auf Protokollverlauf, um den Verlauf für den Daten-Feed anzuzeigen.
Bearbeiten
Um einen Fusion-Daten-Feed zu bearbeiten, klicken Sie in der Liste auf den Daten-Feed und dann auf die Schaltfläche Bearbeiten.
Wenn Sie mit der Bearbeitung fertig sind, klicken Sie auf Speichern. Dies bringt Sie zurück zur Daten-Feed-Liste, wobei Ihre Änderungen gespeichert und auf den Daten-Feed angewendet wurden.