1つ以上のドメイン名のタイムシフトのリソース使用量データを照会します。
使用状況ノート
- 複数のドメイン名を指定し、コンマ (,) で区切ることができます。
- 最大で過去90日間のデータをクエリできます。
- 返されるエントリ間の時間間隔は1時間です。
- The maximum time range in which the data can be queried in a call is 31 days.
QPS制限
1人のユーザーが1分あたり最大10件のクエリを実行できます。 1秒あたりの呼び出し数がQPS制限を超えると、スロットリングがトリガーされます。 スロットルはビジネスに影響を与える可能性があります。 したがって、この操作のQPS制限を遵守することをお勧めします。 シングルユーザーの意味とQPSの詳細については、「ApsaraVideo LiveのAPI操作のQPS制限」をご参照ください。
デバッグ
リクエストパラメーター
パラメーター | データ型 | 必須/任意 | 例 | 説明 |
---|---|---|---|---|
操作 | String | 必須 | DescribeLiveDomainTimeShiftData |
実行する操作です。 値をDescribeLiveDomainTimeShiftDataに設定します。 |
DomainName | String | 任意 | example.com |
メインのストリーミングドメイン。 注
|
StartTime | String | 任意 | 2021-03-03T00:00:00Z |
クエリする時間範囲の先頭。 ISO 8601標準のyyyy-MM-dd T HH:mm:ss Z形式で時刻を指定します。 時刻はUTCである必要があります。 注
|
EndTime | String | 任意 | 2021-03-03T02:00:00Z |
照会する時間範囲の終わり。 ISO 8601標準のyyyy-MM-dd T HH:mm:ss Z形式で時刻を指定します。 時間は UTC にする必要があります。 終了時間は開始時間より遅くする必要があります。 |
間隔 | String | 任意 | 300 |
データが照会される時間間隔。 (単位:秒) 設定可能な値は以下のとおりです。
このパラメーターを設定しない場合、または指定された値が無効な場合は、デフォルト値300が使用されます。 |
レスポンスパラメーター
パラメーター | データ型 | 例 | 説明 |
---|---|---|---|
RequestId | String | 8AE1CB3A-6510-442E-A6B9-EF03D05B3E09 |
リクエストの ID です。 |
TimeShiftData | DataModuleの配列 |
時間間隔ごとに収集されたタイムシフトのリソース使用量データ。 |
|
DataModule | |||
Size | String | 1664165660 |
タイムシフトのストレージ使用量。 単位: バイト。 |
タイムスタンプ | String | 2021-03-03T00:00:00Z |
返されたデータのタイムスタンプ。 |
データ型 | String | HLS_D7 |
タイムシフトのタイプ。 例: HLS_D1およびHLS_D7。 |
例
リクエストの例
http(s):// live.aliyuncs.com/?Action=DescribeLiveDomainTimeShiftData
&StartTime=2021-03-03T00:00:00Z
&EndTime=2021-03-03T02:00:00Z
&<共通リクエストパラメーター>
正常に処理された場合のレスポンス例
XML
形式
<DescribeLiveDomainTimeShiftDataResponse>
<TimeShiftData>
<DataModule>
<タイプ> HLS_D7</タイプ>
<サイズ> 1664165660</サイズ>
<タイムスタンプ> 2021-03-03T00:00:00Z</タイムスタンプ>
</DataModule>
<DataModule>
<タイプ> HLS_D7</タイプ>
<サイズ> 1308431308</サイズ>
<タイムスタンプ> 2021-03-03T01:00:00Z</タイムスタンプ>
</DataModule>
</TimeShiftData>
<RequestId>E8942890-A783-4456-BEF8-81FDDD8F8F3C</RequestId>
</DescribeLiveDomainTimeShiftDataResponse>
JSON
形式
{
"TimeShiftData": {
"DataModule": [
{
"タイプ": "HLS_D7" 、
「サイズ」: 1664165660、
"タイムスタンプ": "2021-03-03T00:00:00Z"
},
{
"タイプ": "HLS_D7" 、
「サイズ」: 1308431308、
"TimeStamp": "2021-03-03T01:00:00Z"
}
]
},
"RequestId": "E8942890-A783-4456-BEF8-81FDDD8F8F3C"
}
エラーコード
HTTP ステータスコード | エラーコード | エラーメッセージ | 説明 |
---|---|---|---|
400 | InvalidStartTime.Malformed | 指定された StartTime は不正です。 | 開始時刻の形式が無効な場合に返されるエラーメッセージ。 StartTimeパラメーターの値が有効かどうかを確認します。 |
400 | InvalidEndTime.Malformed | 指定された EndTime は不正です。 | 終了時刻の形式が無効な場合に返されるエラーメッセージ。 EndTimeパラメーターの値が有効かどうかを確認します。 |
400 | InvalidEndTime. ミスマッチ | 指定された終了時間は、指定された開始時間を計算しません。 | 終了時刻が開始時刻より前の場合に返されるエラーメッセージ。 StartTimeパラメーターとEndTimeパラメーターの値が有効かどうかを確認します。 |
エラーコードリストについては、「API エラーセンター」をご参照ください。
特殊エラーコード
エラーコード |
エラーメッセージ |
HTTP ステータスコード |
説明 |
---|---|---|---|
Throttling |
Request was denied due to request throttling. |
503 |
帯域幅調整が行われ、リクエストが拒否された場合に返されるエラーメッセージです。 |
InvalidDomain.NotFound |
The domain provided does not belong to you. |
404 |
ドメイン名が存在しないか、現在のユーザーに属していない場合に返されるエラーメッセージ。 |