Qbrick
データの種類
CDN使用量
概要
Qbrick CDNの月間使用量(GB単位)
データフィード形式
月間使用量のデータフィードの例は次のとおりです。
{
"usage": {
"unit": "GB",
"value": "444706.06"
}
}
<!--NeedCopy-->
実装に関する注意事項
- 使用状況メトリックが取得されます。
- 月初から現在までの月間使用状況メトリックを表示します(常に現在の月に基づきます)。
-
月間使用量は、Qbrick APIへの次のリクエストをホストすることで受信されます。
{"metric":"size","tStart":1517443200000,"tEnd":2517443200000,"resolution":0} - Qbrickは指定された期間の集計を行います。返されるデータは、tStartとtEnd(ミリ秒単位)の間のすべての使用量です。この計算はQbrickの内部で行われます。
調整手順
OAuth2.0ではいくつかの認証方法が提供されています。Qbrickでは、最初のステップとしてインプリシットグラントフローを使用して認証することをお勧めします。
1. 認証トークンの取得
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リクエスト:
curl "https://video.qbrick.com/account/authentications" -H 'Content-Type: application/json' -d '{"email": "[customer_email_here]", "password": "[password_here]", "persistent": false}'
<!--NeedCopy-->
レスポンスには、アカウントID、顧客ID、および生成された「トークン」を含むその他の情報が含まれます。
レスポンス:
レスポンスには、アカウントID、顧客ID、および生成されたトークンを含むその他の情報が含まれます。
{
"id": 123456,
"uid": 123456,
"token": "0e5f64267aff1cc48963b1f8995c76a1",
"expiration": 1519226015000,
"impersonate": -1,
"customerId": 123456,
"account": 123456
}
<!--NeedCopy-->
注: 認証トークンの有効期限は1週間です。
2. アクセストークンの取得
アクセストークンを取得するには、次のリクエストを使用します。
GET https://video.qbrick.com/authorization/oauth2/token?client_id=&authentication_token=&redirect_uri=http://video.qbrick.com/oauth.html&response_type=token
<!--NeedCopy-->
サーバーは、リクエストで使用されたURIとアクセストークンを含むLocationレスポンスヘッダーとともに、302リダイレクトで応答する必要があります。
レスポンス:
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. 使用量の取得
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リクエスト:
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-->
ここで、
-
unit=gbは、値をGB単位で取得するためのオプションです。これはオプションです。指定しない場合、結果はバイト単位になります。「Metric」:「size」は使用量です。 -
tStartはエポックからのミリ秒単位の時間です。これは月の初日の深夜に設定されます。 -
tEndは遠い将来のミリ秒単位の時間です。 -
"Resolution": 0は、指定された期間の単一の値を取得するためのものです。
結果は次のようになります。
[
{
"tValue": 1517443200000,
"value": 267594.852717525
}
]
<!--NeedCopy-->
ここで、
-
tValueは、提供されたタイムスロットの開始時刻、つまり月の初日の深夜です。 -
valueは、tValue以降に配信されたGB数です。
Fusionでの設定
Fusionデータフィードには、左側のナビゲーションペインのOpenmixからアクセスできます。初期設定の手順については、Fusion統合ドキュメントを参照してください。
サービス固有の設定ダイアログボックスが表示されたら、最初に設定するサービスを選択します。
次のステップでは、以下の設定フィールドに入力します。
- 名前: データフィードに付けられた名前です。指定しない場合、「サービス - プラットフォーム名」がデフォルトになります。
- 実行頻度: サービスからデータフィードが更新される頻度です。
- プラットフォーム: データフィードに関連付けられているプラットフォームです。
- APIユーザーメール: Qbrickにログインするために使用されるQbrickユーザーID(メールアドレス)です。
- APIクライアントID: ロードバランシング統計、認証統計、DNS統計など、取得しようとしているデータの種類です。
- APIパスワード: ユーザーのCDNアカウントのAPIパスワードです。
- アカウント番号: ユーザーのQbrickアカウント番号です。ユーザーのCDNアカウントを指定します。
Qbrick Fusionの設定が完了すると、Fusionデータフィードのホームページに緑色のステータスとログ履歴の監視メトリックとともに表示されます。
データフィード履歴
データフィードのステータス、データに関する情報、およびサービスから返されたペイロードを表示できます。リストから特定のデータフィードを選択した後、ログ履歴をクリックしてデータフィードの履歴を表示します。
編集
Fusionデータフィードを編集するには、リスト内のデータフィードをクリックし、次に編集ボタンをクリックします。
編集が完了したら、保存をクリックします。これにより、変更が保存され、データフィードに適用された状態でデータフィードリストに戻ります。