1つ以上のドメイン名のトランスコード使用量データを照会します。
使用上の注意
この操作では、各時間間隔でトランスコード使用量データを収集します。
複数のドメイン名をコンマ (,) で区切って指定できます。
過去90日間のデータをクエリできます。
データの時間粒度は1時間または1日です。
さまざまなトランスコードタイプとトランスコード解像度の課金については、ApsaraVideo live料金ページのライブストリームトランスコードの課金セクションのトランスコード料金のさまざまなトランスコード仕様の課金に関する説明を参照してください。
QPS制限
この操作の呼び出し回数は、アカウントごとに、1 秒間で 20 回までとなっています。 この制限を超えるリクエストは削除され、サービスが中断されます。 この操作を呼び出す際は、この制限にご注意ください。 詳細については、「QPS制限」をご参照ください。
デバッグ
リクエストパラメーター
パラメーター | タイプ | 必須 | 例 | 説明 |
Action | String | 必須 | DescribeLiveDomainStreamTranscodeData | 実行する操作です。 値をDescribeLiveDomainStreamTranscodeDataに設定します。 |
DomainName | String | 任意 | example.com | データをクエリするメインのストリーミングドメイン。
|
StartTime | String | 必須 | 2017-12-10T20:00:00Z | 照会する期間の開始時刻です。 yyyy-MM-dd T HH:mm:ss Z形式のISO 8601標準で時刻を指定します。 時刻は UTC である必要があります。
|
EndTime | String | 必須 | 2017-12-10T22:00:00Z | 照会する期間の終了時刻を設定します。 yyyy-MM-dd T HH:mm:ss Z形式のISO 8601標準で時刻を指定します。 時刻は UTC である必要があります。 |
精度 | String | 任意 | min | クエリの時間精度。 有効な値:
|
間隔 | String | 任意 | 3600 | クエリの時間粒度。 単位は秒です。 有効な値:
説明 このパラメーターを指定しない場合、デフォルトで1時間の時間粒度が使用されます。 |
分割 | String | 任意 | domain | データをグループ化するために使用されるキー。 有効な値:
1つ以上のキーを指定できます。 複数のキーを指定する場合は、コンマ (,) で区切ります。 デフォルト値: |
レスポンスパラメーター
パラメーター | タイプ | 例 | 説明 |
RequestId | String | 3C6CCEC4-6B88-4D4A-93E4-D47B3D92CF8F | リクエスト ID。 |
TranscodeDataList | TranscodeDataの配列 | 各間隔で返されるトランスコード使用量データ。 | |
TranscodeData | |||
TanscodeType | String | H264STD | トランスコードの種類。 有効な値: 説明 このパラメーターは、リクエストパラメーターSplitがtranscode_typeに設定されている場合にのみ有効です。
|
ドメイン | String | example.com | メインのストリーミングドメイン。 説明 このパラメーターは、リクエストパラメーターSplitがdomainに設定されている場合にのみ有効です。 |
リージョン | String | cn-beijing | ドメイン名が存在するリージョンのID。 有効な値: 説明 このパラメータは、リクエストパラメータSplitがregionに設定されている場合にのみ有効です。
|
有効期間 | Integer | 2000 | 期間です。 単位は分です。 |
タイムスタンプ | String | 2017-12-10T20:00:00Z | 返されたデータのタイムスタンプ。 |
FPS | String | normal | フレームレート。 説明 このパラメータは、リクエストパラメータSplitがfpsに設定されている場合にのみ有効です。 |
解像度 | String | HD | 解像度。 有効な値: 説明 このパラメーターは、リクエストパラメーターSplitがresolutionに設定されている場合にのみ有効です。
|
例
リクエストの例
http(s):// live.aliyuncs.com/?Action=DescribeLiveDomainStreamTranscodeData
&StartTime=2017-12-10T20:00:00Z
&EndTime=2017-12-10T22:00:00Z
&<共通リクエストパラメーター>
成功レスポンスの例
XML
形式
HTTP/1.1 200 OK
Content-Type:application/xml
<?xml version="1.0" encoding="UTF-8" ?>
<DescribeLiveDomainStreamTranscodeDataResponse>
<RequestId>3C6CCEC4-6B88-4D4A-93E4-D47B3D92CF8F</RequestId>
<TranscodeDataList>
<TranscodeData>
<Fps> ノーマル </Fps>
<リージョン> cn-beijing</Region>
<期間> 2000</期間>
<TanscodeType>H264STD</TanscodeType>
<Domain>example.com</Domain>
<タイムスタンプ> 2017-12-10T20:00:00Z</タイムスタンプ>
<解像度> HD</解像度>
</TranscodeData>
</TranscodeDataList>
</DescribeLiveDomainStreamTranscodeDataResponse>
JSON
形式
HTTP/1.1 200 OK
Content-Type:application/json
{
"DescribeLiveDomainStreamTranscodeDataResponse" : {
"RequestId" : "3C6CCEC4-6B88-4D4A-93E4-D47B3D92CF8F" 、
"TranscodeDataList" : {
"TranscodeData" : {
"Fps" : "ノーマル" 、
"地域" : "cn-beijing" 、
"期間" : 2000、
"TanscodeType" : "H264STD" 、
"ドメイン" : "example.com" 、
"タイムスタンプ" : "2017-12-10T20:00:00Z" 、
"解像度" : "HD"
}
}
}
}
エラーコード
HTTPステータスコード | エラーコード | エラーメッセージ | 説明 |
400 | InvalidStartTime.Malformed | 指定された StartTime は不正です。 | 開始時刻の形式が無効です。 StartTimeパラメーターの値が有効かどうかを確認します。 |
400 | InvalidEndTime.Malformed | 指定された EndTime は不正です。 | 終了時刻の形式が無効です。 EndTimeパラメーターの値が有効かどうかを確認します。 |
400 | InvalidParamPrecision | パラメータPrecisionが無効です。StartTimeとEndTimeまたはPrecisionをチェックしてください。 | Precisionパラメーターが無効です。 StartTime、EndTime、またはPrecisionパラメーターの値を確認します。 |
400 | InvalidEndTime. ミスマッチ | 指定された終了時間は、指定された開始時間を計算しません。 | 終了時刻が開始時刻と一致しません。 EndTimeパラメーターの値が一致するかどうかを確認します。 |
400 | InvalidTimeSpan | タイムスパンが制限を超えています。 | 時間範囲が制限を超えています。 クエリする有効な時間範囲を設定します。 |
400 | InvalidStartTime.ValueNotSupported | パラメータ StartTime に指定された値はサポートされていません。 | StartTimeパラメーターに指定された値が無効です。 |
エラーコードの一覧については、「サービスエラーコード」をご参照ください。
特殊エラーコード
エラーコード | エラーメッセージ | HTTP ステータスコード | 説明 |
Throttling | Request was denied due to request throttling. | 503 | トラフィックの抑制によりリクエストが拒否されました。 |
InvalidDomain.NotFound | The domain provided does not belong to you. | 404 | ドメイン名が存在しないか、アカウントに属していません。 |