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

ApsaraVideo Live:DescribeLiveStreamRecordIndexFiles

最終更新日:Aug 01, 2024

特定の期間内のすべてのM3U8インデックスファイルに関する情報を照会します。

使用状況ノート

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

QPS制限

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

デバッグ

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

リクエストパラメーター

パラメーターデータ型必須/任意説明
操作String必須DescribeLiveStreamRecordIndexFiles

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

AppNameString必須liveApp ****

ライブストリームが属するアプリケーションの名前。

DomainNameString必須www.example.com

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

EndTimeString必須2017-12-22T08:00:00Z

照会する時間範囲の終わり。 StartTimeおよびEndTimeパラメーターで指定された時間範囲は、4日を超えることはできません。 ISO 8601標準のyyyy-MM-dd T HH:mm:ss Z形式で時刻を指定します。 時刻はUTCである必要があります。

StartTimeString必須2017-12-21T08:00:00Z

クエリする時間範囲の先頭。 ISO 8601標準のyyyy-MM-dd T HH:mm:ss Z形式で時刻を指定します。 時刻はUTCである必要があります。

StreamNameString必須liveStream ****

ライブストリームの名前。

PageNumInteger任意1

返すページの番号。 デフォルト値: 1

PageSizeInteger任意10

返される各ページのエントリ数。 有効な値: 5〜30。 デフォルト値:10

OrderString任意asc

ソート順。 設定可能な値は以下のとおりです。

  • asc: エントリを昇順で並べ替えます。 これはデフォルト値です。
  • desc: エントリを降順に並べ替えます。

レスポンスパラメーター

パラメーターデータ型説明
RecordIndexInfoListRecordIndexInfoの配列

照会されたM3U8インデックスファイルの記録設定。

RecordIndexInfo
RecordUrlStringhttp:// ****/atestObject.m3u8

M3U8インデックスファイルのURL。

DomainNameStringexample.com

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

AppNameStringliveApp****

ライブストリームが属するアプリケーションの名前。

StreamNameStringliveStream ****

ライブストリームの名前。

StartTimeString2015-12-01T07:36:00Z

データが照会された時間範囲の開始。 時間は、 Z形式のISO 8601標準に従います。 時刻はUTCで表示されます。

EndTimeString2015-12-01T07:46:00Z

データが照会された時間範囲の終わり。 時間は、 Z形式のISO 8601標準に従います。 時刻はUTCで表示されます。

有効期間Float588.849

記録の長さ。 (単位:秒)

HeightInteger480

ビデオの高さ。

Integer640

ビデオの幅。

CreateTimeString2016-05-27T09:40:56Z

M3U8インデックスファイルが作成された時刻。

OssBucketStringliveBucket ****

M3U8インデックスファイルが保存されているOSSバケットの名前。

OssEndpointStringoss-cn-shanghai.aliyuncs.com

OSSのエンドポイント。

OssObjectStringliveObject ****

OSSに保存されているレコードの名前。

レコードIDStringc4d7f0a4-b506-43f9-8de3-07732c3f ****

M3U8インデックスファイルのID。

PageNumInteger10

返されたページの数です。

PageSizeInteger5

1 ページあたりで返されるエントリ数。

OrderStringasc

ソート順。

TotalPageInteger20

合計ページ数。

TotalNumInteger12

指定された条件を満たすエントリの総数。

RequestIdStringDE24625C-7C0F-4020-8448-9C31A50C1556

リクエストの ID です。

リクエストの例

http(s):// live.aliyuncs.com/?Action=DescribeLiveStreamRecordIndexFiles
&AppName=liveApp ****
&DomainNam e=example.com
&EndTime=2017-12-22T08:00:00Z
&StartTime=2017-12-21T08:00:00Z
&StreamName=liveStream ****
&<共通リクエストパラメーター>

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

XML 形式

<DescribeLiveStreamRecordIndexFilesResponse>
  <注文> asc</注文>
  <TotalNum>12</TotalNum>
  <TotalPage>20</TotalPage>
  <PageSize>5</PageSize>
  <PageNum>10</PageNum>
  <RequestId>DE24625C-7C0F-4020-8448-9C31A50C1556</RequestId>
  <RecordIndexInfoList>
        <RecordIndexInfo>
              <EndTime>2015-12-01T17:36:00Z</EndTime>
              <DomainNam e>example.com</DomainName>
              <CreateTime>2016-05-27T09:40:56Z</CreateTime>
              <StartTime>2015-12-01T17:36:00Z</StartTime>
              <OssBucket>liveBucket ****</OssBucket>
              <期間> 588.849</期間>
              <AppName>liveApp ****</AppName>
              <StreamName>liveStream ****</StreamName>
              <OssEndpoin t>oss-cn-shanghai.aliyuncs.com</OssEndpoint>
              <RecordUrl>http:// ****/atestObject.m3u8</RecordUrl>
              <OssObject>liveObject ****</OssObject>
              <高さ> 480</高さ>
              <RecordId>c4d7f0a4-b506-43f9-8de3-07732c3f ****</RecordId>
              <Width>640</Width>
        </RecordIndexInfo>
  </RecordIndexInfoList>
</DescribeLiveStreamRecordIndexFilesResponse>

JSON 形式

{
    "Order": "asc" 、
    "TotalNum": "12" 、
    "TotalPage": "20" 、
    "PageSize": "5" 、
    "PageNum": "10" 、
    "RequestId": "DE24625C-7C0F-4020-8448-9C31A50C1556" 、
    "RecordIndexInfoList": {
        "RecordIndexInfo": [{
            "EndTime": "2015-12-01T17:36:00Z" 、
            "DomainName": "www.example.com" 、
            "CreateTime": "2016-05-27T09:40:56Z" 、
            "StartTime": "2015-12-01T17:36:00Z" 、
            "OssBucket": "test123" 、
            "期間": "588.849" 、
            "AppName": "testApp" 、
            "StreamName": "test123" 、
            "OssEndpoint": "oss-cn-shanghai.aliyuncs.com" 、
            "RecordUrl": "http:// ****/atestObject.m3u8" 、
            "OssObject": "test123" 、
            "高さ": "480" 、
            "RecordId": "c4d7f0a4-b506-43f9-8de3-07732c3f ****" 、
            "幅": "640"
        }]
    }
}

エラーコード

HTTP ステータスコードエラーコードエラーメッセージ説明
400InvalidStartTime.Malformed指定された StartTime は不正です。開始時刻の形式が無効な場合に返されるエラーメッセージ。 StartTimeパラメーターの値が有効かどうかを確認します。
400InvalidEndTime.Malformed指定された EndTime は不正です。終了時刻の形式が無効な場合に返されるエラーメッセージ。 EndTimeパラメーターの値が有効かどうかを確認します。
400InvalidEndTime. ミスマッチ指定された終了時間は、指定された開始時間を計算しません。StartTimeパラメーターとEndTimeパラメーターで指定された時間範囲が無効な場合に返されるエラーメッセージ。 StartTimeパラメーターとEndTimeパラメーターが正しく指定されているかどうかを確認します。

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