すべてのプロダクト
Search
ドキュメントセンター

ApsaraVideo Live:DescribeLiveDomainStreamTranscodeData

最終更新日:Oct 21, 2024

1つ以上のドメイン名のトランスコード使用量データを照会します。

使用上の注意

  • この操作では、各時間間隔でトランスコード使用量データを収集します。

  • 複数のドメイン名をコンマ (,) で区切って指定できます。

  • 過去90日間のデータをクエリできます。

  • データの時間粒度は1時間または1日です。

  • さまざまなトランスコードタイプとトランスコード解像度の課金については、ApsaraVideo live料金ページのライブストリームトランスコードの課金セクションのトランスコード料金のさまざまなトランスコード仕様の課金に関する説明を参照してください。

QPS制限

この操作の呼び出し回数は、アカウントごとに、1 秒間で 20 回までとなっています。 この制限を超えるリクエストは削除され、サービスが中断されます。 この操作を呼び出す際は、この制限にご注意ください。 詳細については、「QPS制限」をご参照ください。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。 利便性を考慮して、この操作は OpenAPI Explorer で呼び出すことが推奨されます。 OpenAPI Explorer は、さまざまな SDK に対して操作のサンプルコードを動的に生成します。

リクエストパラメーター

パラメーター

タイプ

必須

説明

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 である必要があります。

  • 最小時間粒度は1時間です。

  • このパラメーターを指定しない場合、過去24時間のデータが返されます。

EndTime

String

必須

2017-12-10T22:00:00Z

照会する期間の終了時刻を設定します。 yyyy-MM-dd T HH:mm:ss Z形式のISO 8601標準で時刻を指定します。 時刻は UTC である必要があります。

精度

String

任意

min

クエリの時間精度。 有効な値:

  • min (デフォルト): 分単位。

  • 秒: 秒単位。

間隔

String

任意

3600

クエリの時間粒度。 単位は秒です。 有効な値:

  • 3600: 1時間

  • 86400: 1日

説明

このパラメーターを指定しない場合、デフォルトで1時間の時間粒度が使用されます。

分割

String

任意

domain

データをグループ化するために使用されるキー。 有効な値:

  • domain: 応答のDomainパラメーターは、Splitがdomainに設定されている場合にのみ有効です。

  • region: 応答のRegionパラメーターは、Splitがregionに設定されている場合にのみ有効です。

  • transcode_type: レスポンスのTanscodeTypeパラメーターは、Splitがtranscode_typeに設定されている場合にのみ有効です。

  • resolution: レスポンスのResolutionパラメーターは、Splitがresolutionに設定されている場合にのみ有効です。

  • fps: 応答のFpsパラメーターは、Splitがfpsに設定されている場合にのみ有効です。

1つ以上のキーを指定できます。 複数のキーを指定する場合は、コンマ (,) で区切ります。

デフォルト値: domain、region、transcode_type、resolution、fps

レスポンスパラメーター

パラメーター

タイプ

説明

RequestId

String

3C6CCEC4-6B88-4D4A-93E4-D47B3D92CF8F

リクエスト ID。

TranscodeDataList

TranscodeDataの配列

各間隔で返されるトランスコード使用量データ。

TranscodeData

TanscodeType

String

H264STD

トランスコードの種類。 有効な値:

説明

このパラメーターは、リクエストパラメーターSplitがtranscode_typeに設定されている場合にのみ有効です。

  • H264STD: H.264に基づく標準トランスコーディング

  • H264NBHD: 狭帯域HD™H.264に基づくトランスコーディング

  • H265STD: H.265に基づく標準トランスコーディング

  • AUDIO: オーディオトランスコーディング

ドメイン

String

example.com

メインのストリーミングドメイン。

説明

このパラメーターは、リクエストパラメーターSplitがdomainに設定されている場合にのみ有効です。

リージョン

String

cn-beijing

ドメイン名が存在するリージョンのID。 有効な値:

説明

このパラメータは、リクエストパラメータSplitがregionに設定されている場合にのみ有効です。

  • cn-北京: 中国 (北京)

  • cn-shanghai: 中国 (上海)

  • cn-qingdao: 中国 (チンタオ)

  • cn-shenzhen: 中国 (深セン)

  • ap-northeast-1: 日本 (東京)

  • ap-southeast-1: シンガポール

  • ap-southeast-5: インドネシア (ジャカルタ)

  • eu-central-1: ドイツ (フランクフルト)

有効期間

Integer

2000

期間です。 単位は分です。

タイムスタンプ

String

2017-12-10T20:00:00Z

返されたデータのタイムスタンプ。

FPS

String

normal

フレームレート。

説明

このパラメータは、リクエストパラメータSplitがfpsに設定されている場合にのみ有効です。

解像度

String

HD

解像度。 有効な値:

説明

このパラメーターは、リクエストパラメーターSplitがresolutionに設定されている場合にのみ有効です。

  • 2K

  • 4K

  • LD: 低い定義

  • SD: 標準定義

  • HD: 高い定义

  • def: オーディオ

リクエストの例

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

ドメイン名が存在しないか、アカウントに属していません。