ライブストリーム間でオンラインのオリジナルストリームとトランスコードされたストリームの数を照会します。

使用状況ノート

この操作は、メインのストリーミングドメインに適用できます。

QPS制限

1人のユーザーが1秒あたり最大1回のクエリを実行できます。 1秒あたりの呼び出し数がQPS制限を超えると、スロットリングがトリガーされます。 スロットルはビジネスに影響を与える可能性があります。 したがって、この操作のQPS制限を遵守することをお勧めします。 シングルユーザーの意味とQPSの詳細については、「ApsaraVideo LiveのAPI操作のQPS制限」をご参照ください。

デバッグ

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

リクエストパラメーター

パラメーター データ型 必須／任意 例 説明
操作 String 必須 DescribeLiveStreamCount

実行したい操作。 値をDescribeLiveStreamCountに設定します。

DomainName String 必須 example.com

The main streaming domain.

レスポンスパラメーター

パラメーター データ型 例 説明
RequestId String FCFFE4A4-F34F-4EEF-B401-36A01689AFBC

リクエストの ID です。
StreamCountInfos StreamCountInfoの配列

ライブストリームの統計。
StreamCountInfo
Count Long 3

オンラインストリームの数。
制限事項 Long 10

同時取り込みストリームの最大数。 このパラメーターは、ホワイトリストのユーザーのみが使用できます。
StreamCountDetails StreamCountDetailの配列

The information about the live streams.
StreamCountDetail
Count Long 2

オンラインストリームの数。
形式 String h264

ビデオのエンコード形式。 設定可能な値は以下のとおりです。

  • h264
  • h265
VideoDataRate Long 390

ビデオのビットレート This parameter is available only for transcoded streams.
データ型 String raw

The type of the live stream. 設定可能な値は以下のとおりです。

  • raw: 元のストリーム。
  • trans: a transcoded stream.

例

リクエストの例

http(s)://live.aliyuncs.com/?Action=DescribeLiveStreamCount
&DomainName=example.com
&<Common request parameters>

正常に処理された場合のレスポンス例

XML 形式 

<DescribeLiveStreamCountResponse>
  <RequestId>FCFFE4A4-F34F-4EEF-B401-36A01689AFBC</RequestId>
  <StreamCountInfos>
        <StreamCountInfo>
              <Count>3</Count>
              <タイプ> 生 </タイプ>
              <StreamCountDetails>
                    <StreamCountDetail>
                          <フォーマット> h264</フォーマット>
                          <Count>2</Count>
                    </StreamCountDetail>
                    <StreamCountDetail>
                          <フォーマット> h265</フォーマット>
                          <Count>1</Count>
                    </StreamCountDetail>
              </StreamCountDetails>
        </StreamCountInfo>
        <StreamCountInfo>
              <Count>3</Count>
              <タイプ> トランス </タイプ>
              <StreamCountDetails>
                    <StreamCountDetail>
                          <フォーマット> h264</フォーマット>
                          <Count>2</Count>
                          <VideoDataRate>390</VideoDataRate>
                    </StreamCountDetail>
                    <StreamCountDetail>
                          <フォーマット> h265</フォーマット>
                          <Count>1</Count>
                          <VideoDataRate>700</VideoDataRate>
                    </StreamCountDetail>
              </StreamCountDetails>
        </StreamCountInfo>
  </StreamCountInfos>
</DescribeLiveStreamCountResponse>

JSON 形式 

{
        "RequestId": "FCFFE4A4-F34F-4EEF-B401-36A01689AFBC" 、
        "StreamCountInfos": {
                "StreamCountInfo": [{
                        "Count": 3,
                        "タイプ": "raw" 、
                        "StreamCountDetails": {
                                "StreamCountDetail": [{
                                        "フォーマット": "h264" 、
                                        "Count": 2
                                }, {
                                        "フォーマット": "h265" 、
                                        "カウント": 1
                                }]
                        }
                }, {
                        "Count": 3,
                        "タイプ": "トランス" 、
                        "StreamCountDetails": {
                                "StreamCountDetail": [{
                                        "フォーマット": "h264" 、
                                        "カウント": 2、
                                        "VideoDataRate": 390
                                }, {
                                        "フォーマット": "h265" 、
                                        "カウント": 1、
                                        "VideoDataRate": 700
                                }]
                        }
                }]
        }
}

エラーコード

エラーコードリストについては、「API エラーセンター」をご参照ください。