DescribeLiveStreamRecordIndexFile - ApsaraVideo Live - Alibaba Cloud ドキュメントセンター

M3U8インデックスファイルに関する情報を照会します。

使用状況ノート

ApsaraVideo Liveは、M3U8インデックスファイルに関する情報を6か月間のみ保存します。クエリできるのは、過去6か月間に作成されたM3U8インデックスファイルに関する情報だけです。
Object Storage Service (OSS) は、ストレージ構成で指定された期間、M3U8インデックスファイルを保存します。

QPS制限

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

デバッグ

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

リクエストパラメーター

パラメーター	データ型	必須／任意	例	説明
操作	String	必須	DescribeLiveStreamRecordIndexFile	実行したい操作。値をDescribeLiveStreamRecordIndexFileに設定します。
AppName	String	必須	liveApp ****	ライブストリームが属するアプリケーションの名前。
DomainName	String	必須	example.com	メインのストリーミングドメイン。
レコードID	String	必須	c4d7f0a4-b506-43f9-8de3-07732c3f ****	M3U8インデックスファイルのID。
StreamName	String	必須	liveStream ****	ライブストリームの名前。

レスポンスパラメーター

パラメーター	データ型	例	説明
RecordIndexInfo	Struct		レコーディングの設定。
RecordUrl	String	http:// ****/atestObject.m3u8	M3U8インデックスファイルのURL。
DomainName	String	example.com	メインのストリーミングドメイン。
AppName	String	liveApp ****	ライブストリームが属するアプリケーションの名前。
StreamName	String	liveStream ****	ライブストリームの名前。
OssBucket	String	tes123	M3U8インデックスファイルが保存されているOSSバケットの名前。
OssEndpoint	String	oss-cn-hangzhou.aliyuncs.com	OSSのエンドポイント。
OssObject	String	liveBucket ****	OSSに保存されているレコードの名前。
StartTime	String	2015-12-01T05:36:00Z	M3U8インデックスファイルが作成される録音の先頭。時間は、 Z形式のISO 8601標準に従います。時刻はUTCで表示されます。
EndTime	String	2016-05-25T05:47:11Z	M3U8インデックスファイルが作成される記録の終わり。時間は、 ISO 8601標準に従います。時刻はUTCで表示されます。
有効期間	Float	588.849	記録の長さ。 (単位：秒)
Height	Integer	480	ビデオの高さ。
幅	Integer	640	ビデオの幅。
CreateTime	String	2016-05-27T09:40:56Z	M3U8インデックスファイルが作成された時刻。時間は、 Z形式のISO 8601標準に従います。時刻は UTC 表示です。
レコードID	String	c4d7f0a4-b506-43f9-8de3-07732c3f ****	M3U8インデックスファイルのID。
RequestId	String	5EBF2AC3-4B73-40A5-8B32-83F49D5F035E	リクエストの ID です。

例

リクエストの例

http(s):// live.aliyuncs.com/?Action=DescribeLiveStreamRecordIndexFile
&AppName=liveApp ****
&DomainNam e=example.com
&RecordId=c4d7f0a4-b506-43f9-8de3-07732c3f ****
&StreamName=testStream
&<共通リクエストパラメーター>

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

XML 形式

<DescribeLiveStreamRecordIndexFileResponse>
      <RecordIndexInfo>
            <AppName>liveApp ****</AppName>
            <CreateTime>2016-05-27T09:40:56Z</CreateTime>
            <DomainNam e>example.com</DomainName>
            <期間> 588.849</期間>
            <EndTime>2016-05-25T05:47:11Z</EndTime>
            <高さ> 480</高さ>
            <OssBucket>liveBucket ****</OssBucket>
            <OssEndpoin t>oss-cn-hangzhou.aliyuncs.com</OssEndpoint>
            <OssObject>atestObject.m3u8</OssObject>
            <RecordId>c4d7f0a4-b506-43f9-8de3-07732c3f ****</RecordId>
            <RecordUrl>http:// ****/atestObject.m3u8</RecordUrl>
            <StartTime>2016-05-25T05:37:11Z</StartTime>
            <StreamName>liveStream ****</StreamName>
            <Width>640</Width>
      </RecordIndexInfo>
      <RequestId>5EBF2AC3-4B73-40A5-8B32-83F49D5F035E</RequestId>
</DescribeLiveStreamRecordIndexFileResponse>

JSON 形式

{
    "RecordIndexInfo":{
        "AppName":"liveApp ****" 、
        "CreateTime":"2016-05-27T09:40:56Z" 、
        "DomainName":"example.com" 、
        "期間":588.849、
        "EndTime":"2016-05-25T05:47:11Z" 、
        "高さ":480、
        "OssBucket":"liveBucket ****" 、
        "OssEndpoint":"oss-cn-hangzhou.aliyuncs.com" 、
        "OssObject":"atestObject.m3u8" 、
        "RecordId":"c4d7f0a4-b506-43f9-8de3-07732c3f ****" 、
        "RecordUrl":"http:// ****/atestObject.m3u8" 、
        "StartTime":"2016-05-25T05:37:11Z" 、
        "StreamName":"liveStream ****" 、
        "幅":640
    },
    "RequestId":"5EBF2AC3-4B73-40A5-8B32-83F49D5F035E"
}

エラーコード

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