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 エラーセンター」をご参照ください。