すべてのプロダクト
Search

このプロダクト

    ApsaraVideo VOD:ListLiveRecordVideo

    ドキュメントセンター

    ApsaraVideo VOD:ListLiveRecordVideo

    最終更新日:Jul 21, 2026

    ライブから VOD への動画リストを取得します。

    操作説明

    指定されたフィルター条件に一致するレコードを最大値 5,000 件取得できます。

    今すぐお試しください

    この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

    テスト

    RAM 認証

    下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

    • アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

    • API：アクションを具体的に実行するための API。

    • アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。

    • リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

      • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

      • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

    • 条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

    • 依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    vod:ListLiveRecordVideo

    get

    *All Resource

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    StreamName

    string

    任意

    録画中に使用されたライブストリームの名前。

    live-test。
    DomainName

    string

    任意

    録画中に使用されたドメイン名。

    example.com。
    AppName

    string

    任意

    録画中に使用されたアプリケーションの名前。

    testApp。
    PageNo

    integer

    任意

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

    1
    PageSize

    integer

    任意

    1 ページあたりのエントリ数。最大値: 100。デフォルト値: 10。

    10
    SortBy

    string

    任意

    結果のソート順序。有効な値:

    • CreationTime:Desc (デフォルト): 作成時刻の降順でソートされます。

    • CreationTime:Asc: 作成時刻の昇順でソートされます。

    CreationTime:Desc。
    StartTime

    string

    任意

    録画操作の開始時刻 (ライブストリームの録画が開始される時刻)。フォーマット: yyyy-MM-ddTHH:mm:ssZ (協定世界時 (UTC))。

    2017-01-11T12:00:00Z
    EndTime

    string

    任意

    録画操作の終了時刻 (ライブストリームの録画が終了する時刻)。終了時刻は開始時刻より後である必要があります。フォーマット: yyyy-MM-ddTHH:mm:ssZ (協定世界時 (UTC))。

    2017-01-11T13:00:00Z

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    Total

    integer

    動画の総数。

    123
    RequestId

    string

    リクエスト ID。

    25818875-5F78-4A13-****-D7393642CA58
    LiveRecordVideoList

    object

    LiveRecordVideo

    array<object>

    動画リスト。

    array<object>

    AppName

    string

    アプリケーション名。

    testApp
    PlaylistId

    string

    再生リストの ID。

    ****
    StreamName

    string

    ライブ録画ファイルの名前。

    live-test
    RecordEndTime

    string

    録画終了時刻。時刻は yyyy-MM-ddTHH:mm:ssZ 形式です。時刻は UTC で表示されます。

    2017-12-08T08:44:56Z
    RecordStartTime

    string

    録画開始時刻。時刻は yyyy-MM-ddTHH:mm:ssZ 形式です。時刻は UTC で表示されます。

    2017-12-08T07:40:56Z
    DomainName

    string

    ドメイン名。

    example.com
    Video

    object

    ライブ録画ファイルに関する情報。

    CreationTime

    string

    オーディオまたはビデオファイルが作成された時刻。時刻は yyyy-MM-ddTHH:mm:ssZ 形式です。時刻は UTC で表示されます。

    2017-12-08T07:40:56Z
    Status

    string

    ビデオのステータス。有効な値：

    • Uploading

    • UploadFail

    • UploadSuccess

    • Transcoding

    • TranscodeFail

    • Blocked

    • Normal：ビデオは正常です。

    Normal
    CateId

    integer

    ビデオカテゴリの ID。

    78
    VideoId

    string

    ビデオの ID。

    93ab850b4f6f*****54b6e91d24d81d4
    Tags

    string

    ビデオのタグ。複数のタグはコンマ (,) で区切られます。

    标签1, 标签2
    CateName

    string

    ビデオのカテゴリ。

    分类名
    Description

    string

    ビデオファイルの説明。

    阿里云VOD视频描述
    Size

    integer

    ソースビデオファイルのサイズ。単位：バイト。

    10897890
    CoverURL

    string

    ビデオサムネイルの URL。

    https://image.example.com/coversample.jpg
    TemplateGroupId

    string

    トランスコーディングテンプレートグループの ID。

    1
    Duration

    number

    ビデオファイルの長さ。単位：秒。

    135.6
    Title

    string

    ビデオのタイトル。

    阿里云VOD视频标题
    ModifyTime

    string

    ビデオが更新された時刻。時刻は yyyy-MM-ddTHH:mm:ssZ 形式です。時刻は UTC で表示されます。

    2017-12-08T09:40:56Z
    Snapshots

    object

    Snapshot

    array

    ビデオスナップショット URL の配列。

    string

    ビデオスナップショットの URL。

    {"Snapshot":["http://image.example.com/snapshot/sample000001.jpg?auth_key=1498476426-0-0-f00b9455c49a423ce69cf4e273334f52","http://image.example.com/snapshot/sample00002.jpg?auth_key=1498476426-0-0-f00b9455c49a423ce69cf4e272434f52"]}

    例

    成功レスポンス

    JSONJSON

    {
  "Total": 123,
  "RequestId": "25818875-5F78-4A13-****-D7393642CA58",
  "LiveRecordVideoList": {
    "LiveRecordVideo": [
      {
        "AppName": "testApp",
        "PlaylistId": "****",
        "StreamName": "live-test",
        "RecordEndTime": "2017-12-08T08:44:56Z",
        "RecordStartTime": "2017-12-08T07:40:56Z",
        "DomainName": "example.com",
        "Video": {
          "CreationTime": "2017-12-08T07:40:56Z",
          "Status": "Normal",
          "CateId": 78,
          "VideoId": "93ab850b4f6f*****54b6e91d24d81d4",
          "Tags": "标签1, 标签2",
          "CateName": "分类名",
          "Description": "阿里云VOD视频描述",
          "Size": 10897890,
          "CoverURL": "https://image.example.com/coversample.jpg",
          "TemplateGroupId": "1",
          "Duration": 135.6,
          "Title": "阿里云VOD视频标题",
          "ModifyTime": "2017-12-08T09:40:56Z",
          "Snapshots": {
            "Snapshot": [
              "{\"Snapshot\":[\"http://image.example.com/snapshot/sample000001.jpg?auth_key=1498476426-0-0-f00b9455c49a423ce69cf4e273334f52\",\"http://image.example.com/snapshot/sample00002.jpg?auth_key=1498476426-0-0-f00b9455c49a423ce69cf4e272434f52\"]}"
            ]
          }
        }
      }
    ]
  }
}

    エラーコード

    完全なリストについては、「エラーコード」をご参照ください。

    変更履歴

    完全なリストについては、「変更履歴」をご参照ください。