すべてのプロダクト
Search

このプロダクト

    Intelligent Media Services:ListMediaLiveChannels

    ドキュメントセンター

    Intelligent Media Services:ListMediaLiveChannels

    最終更新日:Mar 21, 2026

    MediaLive チャンネルを照会します。

    操作説明

    QPS 制限

    この操作は、Alibaba Cloud アカウントごとに 1 秒間に最大 50 回まで呼び出すことができます。この制限を超えるリクエストは破棄され、サービス中断が発生する可能性があります。本操作の呼び出しに際しては、この制限を十分にご確認ください。

    今すぐお試しください

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

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    ice:ListMediaLiveChannels

    list

    *All Resource

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    MaxResults

    integer

    任意

    1 ページあたりの表示件数です。有効な値：1～100。デフォルト値：

    • このパラメーターを指定しない場合、または 10 より小さい値を指定した場合は、デフォルト値は 10 です。

    • 100 より大きい値を指定した場合は、デフォルト値は 100 です。

    10
    Skip

    integer

    任意

    照会からスキップする件数です。スキップしようとする件数が条件に合致する件数を超える場合、空のリストが返されます。

    20
    NextToken

    string

    任意

    次のページの結果を取得するためのページネーショントークンです。最初のリクエストではこのパラメーターを指定する必要はありません。前回の照会で取得したトークンを NextToken の値として指定してください。

    caeba0bbb2be03f84eb48b699f0a4883
    SortOrder

    string

    任意

    作成時刻によるチャンネルの並べ替え順序です。デフォルト値：asc。有効な値：desc、asc。asc は昇順、desc は降順を意味します。

    desc
    Keyword

    string

    任意

    検索キーワードです。チャンネル ID またはチャンネル名に対してあいまい検索を実行できます。

    123
    States

    string

    任意

    照会対象のチャンネルの状態です。JSON 配列内でカンマ (,) を使用して複数の状態を区切ります。

    ["IDLE","RUNNING"]

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    応答のスキーマ

    RequestId

    string

    リクエストの ID です。

    ******11-DB8D-4A9A-875B-275798******
    Channels

    array<object>

    チャンネル情報です。

    array<object>

    ChannelId

    string

    チャンネル ID です。

    SEGK5KA6KYKAWQQH
    Name

    string

    チャンネル名です。

    mych
    State

    string

    チャンネルの状態です。有効な値：IDLE、STARTING、RUNNING、RECOVERING、STOPPING。

    IDLE
    InputAttachments

    array<object>

    チャンネルに関連付けられた入力情報です。

    array<object>

    InputId

    string

    入力 ID です。

    SEGK5KA6KYKAWQQH
    InputName

    string

    入力名です。

    myinput
    LanguageName

    string

    言語名です。

    eng
    AudioSelectors

    array<object>

    オーディオセレクターです。

    array<object>

    Name

    string

    オーディオセレクター名です。

    myselector
    AudioLanguageSelection

    object

    オーディオ言語選択設定です。

    LanguageCode

    string

    オーディオソース内の 3 文字の ISO 639-2 言語コードです。

    eng
    AudioPidSelection

    object

    オーディオ PID 選択設定です。

    Pid

    integer

    ソース内の PID です。

    123
    AudioTrackSelection

    array<object>

    オーディオトラック選択設定です。

    object

    TrackId

    integer

    ソース内のトラック ID です。

    1
    OutputGroups

    array<object>

    出力グループです。

    array<object>

    Name

    string

    出力グループ名です。

    group1
    Type

    string

    出力グループの種別です。

    MediaPackage
    Outputs

    array<object>

    出力グループ内の出力です。

    array<object>

    Name

    string

    出力名です。

    output1
    MediaType

    integer

    出力のメディアタイプです。

    0
    MediaPackageOutputSetting

    object

    MediaPackage へ配信される出力の設定です。

    NameModifier

    string

    マニフェスト名修飾子です。子マニフェストの M3U8 ファイル名にはこの修飾子が含まれます。

    480p
    AudioGroupId

    string

    マニフェストのオーディオグループ ID です。

    audiogroup
    VideoSettingName

    string

    参照される VideoSettings の名前です。

    myVideo1
    AudioSettingNames

    array

    参照される AudioSettings です。

    string

    参照される AudioSettings の名前です。

    myAudio1
    MediaPackageGroupSetting

    object

    MediaPackage の送信先です。

    GroupName

    string

    MediaPackage 内の GroupName です。

    myPackageGroup
    ChannelName

    string

    MediaPackage 内の ChannelName です。

    myPackageChannel
    MonitorUrl

    string

    出力グループのモニタリング用 URL です。出力グループの種別が MediaPackage の場合のみ、このパラメーターが返されます。

    rtmp://xxx
    AudioSettings

    array<object>

    音声設定です。

    array<object>

    Name

    string

    音声設定の名前です。

    zhuanfengzhuang
    AudioSelectorName

    string

    オーディオセレクター名です。

    myselector
    LanguageCode

    string

    3 文字の ISO 639-2 言語コードです。

    eng
    LanguageName

    string

    言語名です。

    English
    AudioCodec

    string

    音声コーデックです。

    aac
    AudioCodecSetting

    object

    音声エンコーディング設定です。

    Profile

    string

    音声コーデックプロファイルです。

    AAC-LOW
    Bitrate

    integer

    音声ビットレートです。単位：bit/s。

    200000
    SampleRate

    integer

    音声サンプルレートです。単位：Hz。

    44100
    VideoSettings

    array<object>

    ビデオ設定です。

    array<object>

    Name

    string

    ビデオ設定の名前です。

    video1
    Width

    integer

    ビデオの幅（ピクセル単位）です。

    1280
    Height

    integer

    ビデオの高さ（ピクセル単位）です。

    720
    VideoCodec

    string

    ビデオコーデックです。

    H264
    VideoCodecSetting

    object

    ビデオエンコーディング設定です。

    Rate

    object

    ビデオエンコーディングレートです。

    Bitrate

    integer

    ビデオビットレートです。単位：bit/s。

    2500000
    RateControlMode

    string

    ビットレート制御モードです。

    ABR
    MaxBitrate

    integer

    最大ビットレートです。単位：bit/s。

    6000000
    BufferSize

    integer

    ビデオバッファーのサイズです。単位：bit/s。

    6000000
    Framerate

    object

    フレームレートです。

    FramerateControl

    string

    フレームレートモードです。

    SPECIFIED
    FramerateNumerator

    integer

    固定フレームレートの分子です。

    25
    FramerateDenominator

    integer

    固定フレームレートの分母です。

    1
    Gop

    object

    GOP 設定です。

    GopSizeUnits

    string

    GOP サイズの単位です。

    FRAMES
    GopSize

    integer

    GOP サイズです。

    90
    BframesNum

    integer

    B フレームの数です。

    3
    CodecDetail

    object

    ビデオエンコーディング設定です。

    Profile

    string

    H.264 プロファイルです。

    MAIN
    Level

    string

    ビデオエンコーディングレベルです。現時点では未対応です。

    H264_LEVEL_AUTO
    VideoCodecType

    string

    動画トランスコーディング方法です。有効な値：NORMAL（通常のトランスコーディング）、NBHD（狭帯域 HD™ トランスコーディング）。

    NORMAL
    CreateTime

    string

    チャンネルの作成時刻です。ISO 8601 標準（yyyy-MM-ddTHH:mm:ssZ 形式）に従っており、協定世界時 (UTC) で表示されます。

    2024-12-03T06:56:42Z
    LastStartTime

    string

    チャンネルの最終起動時刻です。ISO 8601 標準（yyyy-MM-ddTHH:mm:ssZ 形式）に従っており、協定世界時 (UTC) で表示されます。チャンネルが作成されて以降一度も起動されていない場合は、空文字列が返されます。

    2024-12-03T06:56:42Z
    LastStopTime

    string

    チャンネルの最終停止時刻です。ISO 8601 標準（yyyy-MM-ddTHH:mm:ssZ 形式）に従っており、協定世界時 (UTC) で表示されます。チャンネルが作成されて以降一度も停止されていない場合は、空文字列が返されます。

    2024-12-03T06:56:42Z
    MaxResults

    integer

    1 ページあたりに返される件数です。

    10
    NextToken

    string

    ページネーショントークンです。次のリクエストで新しいページの結果を取得するために使用できます。

    caeba0bbb2be03f84eb48b699f0a4883
    TotalCount

    integer

    返された総件数です。

    100

    例

    成功レスポンス

    JSONJSON

    {
  "RequestId": "******11-DB8D-4A9A-875B-275798******",
  "Channels": [
    {
      "ChannelId": "SEGK5KA6KYKAWQQH",
      "Name": "mych",
      "State": "IDLE",
      "InputAttachments": [
        {
          "InputId": "SEGK5KA6KYKAWQQH",
          "InputName": "myinput",
          "LanguageName": "eng",
          "AudioSelectors": [
            {
              "Name": "myselector",
              "AudioLanguageSelection": {
                "LanguageCode": "eng"
              },
              "AudioPidSelection": {
                "Pid": 123
              },
              "AudioTrackSelection": [
                {
                  "TrackId": 1
                }
              ]
            }
          ]
        }
      ],
      "OutputGroups": [
        {
          "Name": "group1",
          "Type": "MediaPackage",
          "Outputs": [
            {
              "Name": "output1",
              "MediaType": 0,
              "MediaPackageOutputSetting": {
                "NameModifier": "480p",
                "AudioGroupId": "audiogroup"
              },
              "VideoSettingName": "myVideo1",
              "AudioSettingNames": [
                "myAudio1"
              ]
            }
          ],
          "MediaPackageGroupSetting": {
            "GroupName": "myPackageGroup",
            "ChannelName": "myPackageChannel"
          },
          "MonitorUrl": "rtmp://xxx"
        }
      ],
      "AudioSettings": [
        {
          "Name": "zhuanfengzhuang",
          "AudioSelectorName": "myselector",
          "LanguageCode": "eng",
          "LanguageName": "English",
          "AudioCodec": "aac",
          "AudioCodecSetting": {
            "Profile": "AAC-LOW",
            "Bitrate": 200000,
            "SampleRate": 44100
          }
        }
      ],
      "VideoSettings": [
        {
          "Name": "video1",
          "Width": 1280,
          "Height": 720,
          "VideoCodec": "H264",
          "VideoCodecSetting": {
            "Rate": {
              "Bitrate": 2500000,
              "RateControlMode": "ABR",
              "MaxBitrate": 6000000,
              "BufferSize": 6000000
            },
            "Framerate": {
              "FramerateControl": "SPECIFIED",
              "FramerateNumerator": 25,
              "FramerateDenominator": 1
            },
            "Gop": {
              "GopSizeUnits": "FRAMES",
              "GopSize": 90,
              "BframesNum": 3
            },
            "CodecDetail": {
              "Profile": "MAIN",
              "Level": "H264_LEVEL_AUTO"
            }
          },
          "VideoCodecType": "NORMAL"
        }
      ],
      "CreateTime": "2024-12-03T06:56:42Z",
      "LastStartTime": "2024-12-03T06:56:42Z",
      "LastStopTime": "2024-12-03T06:56:42Z"
    }
  ],
  "MaxResults": 10,
  "NextToken": "caeba0bbb2be03f84eb48b699f0a4883",
  "TotalCount": 100
}

    エラーコード

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

    変更履歴

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