すべてのプロダクト
Search

このプロダクト

    ApsaraVideo Live:DescribeLivePullToPushList

    ドキュメントセンター

    ApsaraVideo Live:DescribeLivePullToPushList

    最終更新日:Jun 23, 2026

    プルトゥプッシュタスクをファジークエリします。

    操作説明

    • このオペレーションを呼び出して、プルトゥプッシュタスクのリストをクエリします。

    • タスクリストのページネーションクエリをサポートし、タスクID、タスク名、および宛先プッシュURLによるファジー検索をサポートしています。

    QPS 制限

    このオペレーションのシングルユーザーQPS 制限は1 秒あたり10 回の呼び出しです。制限を超えるとスロットリングが発生し、ビジネスに影響を与える可能性があります。このオペレーションを適切に呼び出してください。

    今すぐお試しください

    この 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 ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    live:DescribeLivePullToPushList

    get

    *All Resource

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    RegionId

    string

    任意

    リージョンID。

    cn-shanghai
    Region

    string

    必須

    クエリするライブセンター。有効な値：

    • ap-southeast-1（シンガポール）

    • ap-southeast-5（インドネシア）

    • cn-beijing（北京）

    • cn-shanghai（上海）。

    列挙値:

    • cn-shenzhen :

      深セン

    • cn-qingdao :

      青島

    • preregion :

      プレリリース

    • cn-beijing :

      北京

    • cn-shanghai :

      上海

    • ap-southeast-1 :

      シンガポール

    • eu-central-1 :

      ドイツ-フランクフルト

    • ap-northeast-1 :

      日本-東京

    • ap-southeast-5 :

      インドネシア

    • me-central-1 :

      サウジアラビア-リヤド

    cn-shanghai
    TaskId

    string

    任意

    タスクID。タスクIDに基づいてファジー検索が実行されます。

    説明

    タスクIDは大文字と小文字の英字、数字、アンダースコア、およびハイフン（-）で構成され、最大 55 文字です。

    861009
    TaskName

    string

    任意

    タスク名。タスク名に基づいてファジー検索が実行されます。

    task
    DstUrl

    string

    任意

    宛先プッシュURL。宛先プッシュURLに基づいてファジー検索が実行されます。

    rtmp://qd
    PageNumber

    integer

    任意

    ページ番号。

    説明

    値は0より大きく、Integerデータ型の最大値を超えることはできません。デフォルト値：1。

    1
    PageSize

    integer

    任意

    1ページあたりのレコード数。

    説明

    デフォルト値：10。有効な値：1～100。

    10

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    レスポンスのスキーマ

    RequestId

    string

    リクエストID。

    a05e6b15-15af-405b-a4a2-0152245*****
    Total

    integer

    クエリ結果の総数。

    3
    PageNumber

    integer

    ページ番号。

    1
    PageSize

    integer

    1ページあたりのクエリレコード数。

    10
    TaskList

    array<object>

    タスク情報リスト。

    array<object>

    タスク情報リスト。

    TaskId

    string

    タスクID。

    fb0d4ac7-c7e3-4978-9743-0bf2f6e8****
    TaskStatus

    integer

    現在のタスクステータス：

    • 0：未開始（開始時間に達していません）。

    • 1：正常実行中（ストリームのプルとプッシュが正常です）。

    • 2：異常実行中。

    • 3：停止済み（ストリームのプルまたはプッシュが異常、またはAPIを呼び出してタスクが能動的に停止されました）。

    • -1：終了済み。

    0
    TaskInvalidReason

    string

    タスク停止の理由：

    • PullStreamFailed：ソースストリームのプル例外、再試行中。

    • PushStreamFailed：宛先ストリームのプッシュ例外、再試行中。

    • UnknownError：不明な例外。

    説明

    タスクが停止状態の場合のみ返されます。

    PullStreamFailed
    TaskExitTime

    integer

    タスク終了時間、Unixタイムスタンプ（秒単位）。

    説明

    タスクが終了状態の場合のみ返されます。

    1726354625
    TaskExitReason

    string

    タスク終了の理由：

    • TriggerByUser：ユーザーによって能動的に終了。

    • OverEndTime：プリセットの終了時間を超過。

    説明

    タスクが終了状態の場合のみ返されます。

    TriggerByUser
    CurrentOffset

    integer

    現在有効なビデオ再生オフセット。

    0
    CurrentFileIndex

    integer

    現在有効なプレイリストシーケンスオフセット。

    0
    TaskInfo

    object

    タスク情報。

    TaskId

    string

    タスク ID。

    fb0d4ac7-c7e3-4978-9743-0bf2f6e8****
    TaskName

    string

    タスク名。

    taskname
    StartTime

    string

    タスクの開始時刻。時刻は UTC で yyyy-MM-ddTHH:mm:ssZ 形式です。

    2024-12-04T09:16:00Z
    EndTime

    string

    タスクの終了時刻。時刻は UTC で yyyy-MM-ddTHH:mm:ssZ 形式です。

    2024-12-30T14:30:00Z
    SourceType

    string

    ソースストリームの種類。有効な値：

    • live：ライブストリーム。

    • vod：ApsaraVideo VOD リソース。

    • url：サードパーティの動画ファイルリソース。

    vod
    SourceProtocol

    string

    ソースストリームのプロトコル。

    flv
    SourceUrls

    array

    ソースストリームの URL。

    string

    ソースストリームの URL。

    rtmp://118.178.***.*5:****/wwtestlive1/pulltest.jiugong.aliyunlive.com_livelight2?vhost=pulltest.jiugong.aliyun*******
    DstUrl

    string

    送信先のアップストリーミング URL。

    rtmp://qd.push.lgg.alivecdn.com/testhsc/streamhsc?live_rtmp_*******
    CallbackURL

    string

    HTTP Webhook アドレス。

    hahaha.com
    Offset

    integer

    動画ファイルの開始オフセット（秒単位）。値は 0 より大きい必要があります。

    説明

    • これは、最初のフレームから読み取りを開始するまでの相対的な時間オフセットを示します。

    • このパラメーターは、ApsaraVideo VOD リソースまたは動画ファイルに対してのみ有効です。

    0
    FileIndex

    integer

    再生を開始するファイルのインデックス。

    0
    RetryCount

    integer

    再試行回数。

    3
    RetryInterval

    integer

    再試行間隔（秒単位）。

    60
    RepeatNumber

    integer

    再生完了後の繰り返し再生回数。有効な値：

    • 0（デフォルト）：繰り返し再生しません。

    • -1：無限ループで再生します。

    • 正の整数：再生を繰り返す回数。

    説明

    このパラメーターは、ApsaraVideo VOD またはサードパーティのビデオストリームに対してのみ有効です。

    0

    例

    成功レスポンス

    JSONJSON

    {
  "RequestId": "a05e6b15-15af-405b-a4a2-0152245*****",
  "Total": 3,
  "PageNumber": 1,
  "PageSize": 10,
  "TaskList": [
    {
      "TaskId": "fb0d4ac7-c7e3-4978-9743-0bf2f6e8****",
      "TaskStatus": 0,
      "TaskInvalidReason": "PullStreamFailed",
      "TaskExitTime": 1726354625,
      "TaskExitReason": "TriggerByUser",
      "CurrentOffset": 0,
      "CurrentFileIndex": 0,
      "TaskInfo": {
        "TaskId": "fb0d4ac7-c7e3-4978-9743-0bf2f6e8****",
        "TaskName": "taskname",
        "StartTime": "2024-12-04T09:16:00Z",
        "EndTime": "2024-12-30T14:30:00Z",
        "SourceType": "vod",
        "SourceProtocol": "flv",
        "SourceUrls": [
          "rtmp://118.178.***.*5:****/wwtestlive1/pulltest.jiugong.aliyunlive.com_livelight2?vhost=pulltest.jiugong.aliyun*******"
        ],
        "DstUrl": "rtmp://qd.push.lgg.alivecdn.com/testhsc/streamhsc?live_rtmp_*******",
        "CallbackURL": "hahaha.com",
        "Offset": 0,
        "FileIndex": 0,
        "RetryCount": 3,
        "RetryInterval": 60,
        "RepeatNumber": 0
      }
    }
  ]
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    400 InvalidParameter %s.
    400 LiveServiceNotFound Your account does not open Live service yet
    400 CodeInvalidAliUid This aliuid does not have a live domain name.
    400 CodeTaskNotExist Task does not exist.
    500 InternalError %s.

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

    変更履歴

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