DescribeVodDomainTrafficData でアクセラレーションドメインの過去トラフィックデータをクエリ - VOD

この操作を呼び出して、高速化ドメイン名のトラフィックデータをクエリできます。 DescribeVodDomainRealTimeTrafficData 操作と比較して、この操作はより長い期間にわたる既存データのクエリをサポートしています。過去 366 日間のデータをクエリできます。ただし、この操作は時間粒度が大きく、最小 5 分で、データ遅延が大きくなります。

操作説明

この操作のエンドポイントは、[中国 (上海)] リージョンでのみ使用できます。
この操作はバッチクエリをサポートしています。 1 回のリクエストで最大 500 ドメインのデータをクエリできます。
StartTime パラメーターと EndTime パラメーターを指定しない場合、デフォルトで過去 24 時間のデータが返されます。 StartTime と EndTime を指定すると、指定した時間範囲内のデータが返されます。

データの時間粒度

Interval パラメーターを設定しない場合、返されるデータのデフォルトの時間粒度は、StartTime と EndTime の間で指定した時間範囲によって決まります。次の表は、時間粒度、既存データクエリのサポートされている時間範囲、およびデータ遅延を示しています。

時間粒度	単一クエリの時間範囲	既存データのクエリ可能な時間範囲	データ遅延
5 分	単一クエリの時間範囲は 3 日未満です	93 日	15 分
1 時間	単一クエリの時間範囲は 3 日以上 31 日未満です	186 日	通常 3 ～ 4 時間
1 日	単一クエリの時間範囲は 31 日以上 366 日以下です	366 日	通常 4 時間ですが、24 時間以内です

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。
API：アクションを具体的に実行するための API。
アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。
リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。
- リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。
- リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。
条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。
依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

vod:DescribeVodDomainTrafficData

get

*All Resource

*

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
DomainName	string	任意	クエリする高速化ドメイン名。このパラメーターを指定しない場合、デフォルトですべての高速化ドメイン名のプールされたデータが返されます。バッチクエリがサポートされています。複数のドメイン名をコンマ (,) で区切ります。一度に最大 500 ドメインをクエリできます。 ApsaraVideo VOD コンソールにログインし、左側のナビゲーションウィンドウで [構成管理] > [CDN 構成] > [ドメイン] を選択して、ApsaraVideo VOD に追加されている高速化ドメイン名を表示します。 DescribeVodUserDomains 操作を呼び出して、高速化ドメイン名のリストをクエリすることもできます。	example.com
StartTime	string	任意	クエリする時間範囲の開始時刻。時間は ISO 8601 標準 (yyyy-MM-ddTHH:mm:ssZ 形式) に従います。時間は UTC で表示されます。	2019-01-20T13:59:58Z
EndTime	string	任意	クエリする時間範囲の終了時刻。時間は ISO 8601 標準 (yyyy-MM-ddTHH:mm:ssZ 形式) に従います。時間は UTC で表示されます。説明終了時刻は開始時刻よりも後である必要があります。	2019-01-20T14:59:58Z
Interval	string	任意	クエリするデータの時間粒度。単位: 秒。有効値: 300、3600、86400。このパラメーターを設定しない場合、またはサポートされていない値に設定した場合、デフォルト値が使用されます。サポートされている時間粒度は、`StartTime` と `EndTime` で指定された時間範囲によって異なります。時間範囲が 3 日未満の場合、有効値は 300 (デフォルト)、3600、86400 です。時間範囲が 3 ～ 31 日の場合、有効値は 3600 (デフォルト) と 86400 です。時間範囲が 31 日を超える場合、有効値は 86400 (デフォルト) です。	300
IspNameEn	string	任意	キャリアの名前。このパラメーターを設定しない場合、すべてのキャリアのデータがクエリされます。	unicom
LocationNameEn	string	任意	リージョンの名前。このパラメーターを設定しない場合、すべてのリージョンのデータがクエリされます。現在、上海リージョンのみがサポートされています。	shanghai

レスポンスフィールド

フィールド	型	説明	例
	object	レスポンス。
EndTime	string	時間範囲の終了時刻。	2019-01-20T14:59:58Z
StartTime	string	時間範囲の開始時刻。	2019-01-20T13:59:58Z
RequestId	string	リクエスト ID。	D94E471F-1A27-442E-552D-D4D2000C****
DomainName	string	高速化ドメイン名。	example.com
TotalTraffic	string	総トラフィック。	5906662826
DataInterval	string	2 つの連続したデータエントリ間の時間間隔。これはデータの時間粒度です。単位: 秒。	300
TrafficDataPerInterval	object
DataModule	array<object>	時間間隔ごとのトラフィックデータのリスト。
	object
HttpsDomesticValue	string	中国本土の L1 ノードの HTTPS トラフィック。単位: バイト。	0
Value	string	総トラフィック。単位: バイト。	0
OverseasValue	string	中国本土以外のトラフィック。単位: バイト。	0
HttpsValue	string	L1 ノードの HTTPS 総トラフィック。単位: バイト。	0
HttpsOverseasValue	string	中国本土以外の L1 ノードの HTTPS トラフィック。単位: バイト。	0
TimeStamp	string	データタイムスタンプ。時間は ISO 8601 標準に従い、UTC で表示されます。	2019-01-20T13:59:58Z
DomesticValue	string	中国本土のトラフィック。単位: バイト。	0

例

成功レスポンス

JSONJSON

{
  "EndTime": "2019-01-20T14:59:58Z",
  "StartTime": "2019-01-20T13:59:58Z",
  "RequestId": "D94E471F-1A27-442E-552D-D4D2000C****",
  "DomainName": "example.com",
  "TotalTraffic": "5906662826",
  "DataInterval": "300\n",
  "TrafficDataPerInterval": {
    "DataModule": [
      {
        "HttpsDomesticValue": "0",
        "Value": "0",
        "OverseasValue": "0",
        "HttpsValue": "0",
        "HttpsOverseasValue": "0",
        "TimeStamp": "2019-01-20T13:59:58Z",
        "DomesticValue": "0"
      }
    ]
  }
}

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ
400	MissingTimeParameter	The StartTime and EndTime must be both specified.
400	InvalidStartTime.Malformed	The specified StartTime is invalid.
400	InvalidEndTime.Malformed	The specified EndTime is invalid.
400	InvalidEndTime.Mismatch	The specified EndTime is earlier than the StartTime.
400	InvalidStartTime.ValueNotSupported	The specified StartTime is invalid.

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。