すべてのプロダクト
Search

このプロダクト

    Intelligent Media Services:GetMediaLiveChannel

    ドキュメントセンター

    Intelligent Media Services:GetMediaLiveChannel

    最終更新日: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:GetMediaLiveChannel

    get

    *All Resource

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    ChannelId

    string

    必須

    チャンネルの ID です。

    SEGK5KA6KYKAWQQH

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    応答のスキーマです。

    RequestId

    string

    リクエストの ID です。

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

    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

    例

    成功レスポンス

    JSONJSON

    {
  "RequestId": "******11-DB8D-4A9A-875B-275798******",
  "Channel": {
    "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"
  }
}

    エラーコード

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

    変更履歴

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