すべてのプロダクト
Search

このプロダクト

    :CreateLiveStreamMonitor

    ドキュメントセンター

    :CreateLiveStreamMonitor

    最終更新日:Aug 14, 2025

    モニタリングセッションを作成します。

    操作説明

    この操作を呼び出して、モニタリングセッションを作成します。 必須パラメータが構成されていることを確認してください。

    QPS 制限

    1 ユーザーあたりのクエリ/秒 (QPS) 制限は、1 秒あたり 10 回の呼び出しです。 制限を超えると、API 呼び出しがスロットルされます。 これはビジネスに影響を与える可能性があります。 API 呼び出しはそれに応じて計画してください。

    今すぐお試しください

    この 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:CreateLiveStreamMonitor

    create

    *All Resource

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    タイプ

    必須 / 任意

    説明

    例
    RegionId

    string

    任意

    リージョン ID。

    cn-shanghai
    MonitorName

    string

    必須

    モニタリングセッションの名前。

    liveMonitor****
    OutputTemplate

    string

    必須

    モニタリングセッションの出力テンプレート。有効な値：

    • lp_ld: 低解像度。

    • lp_sd: 標準解像度。

    • lp_hd: 高解像度。

    • lp_ud: 超高解像度。

    lp_ud
    Domain

    string

    必須

    監視対象のドメイン名。

    demo.aliyundoc.com
    App

    string

    任意

    モニタリングセッションの出力ストリームのアプリケーション名。カスタム名を指定できます。 このパラメータを指定しない場合、monitor がアプリケーション名として使用されます。

    monitor****
    Stream

    string

    任意

    モニタリングセッションの出力ストリームの名前。 このパラメータを指定しない場合、システムはランダムな名前を生成します。

    monitorStream****
    InputList

    string

    必須

    監視対象の入力ストリームのリスト。 詳細については、以下のInputConfig テーブルを参照してください。

    InputConfig
    MonitorConfig

    string

    任意

    監視のアラートしきい値設定。 値は JSON 文字列である必要があります。 詳細については、以下の MonitorConfig テーブルを参照してください。

    "{\"fpsLowThres\": 0.6,\"brLowThres\": 1.1,\"eofDurationThresSec\": 10}"
    CallbackUrl

    string

    任意

    Webhook アドレス。 HTTP および HTTPS がサポートされています。

    http://guide.aliyundoc.com/notify
    DingTalkWebHookUrl

    string

    任意

    DingTalk チャットボットの Webhook URL。 アラート通知を受信するには、DingTalk チャットボットを構成し、その Webhook URL を入力します。これは、HTTP または HTTPS 形式にすることができます。 詳細については、「カスタムロボットアクセス」を参照してください。

    説明

    DingTalk チャットボットのカスタムキーワードを「Alerting」に設定します。 そうしないと、メッセージを受信できません。

    https://oapi.dingtalk.com/robot/send?access_token=7a7d404056eee1f2fd944ace9bcfc361dc6448583e1d3d3baa****

    InputConfig

    名前

    タイプ

    説明

    値の例

    Index

    整数

    インデックス。 このパラメータはフロントエンドで使用されます。

    1

    LayoutId

    整数

    レイアウト ID。 値は 1 から始まる必要があります。

    1

    StreamName

    文字列

    監視対象ストリームの表示名。

    monitorStream****

    InputUrl

    文字列

    入力ストリームの URL。

    demo.aliyundoc.com

    LayoutConfig

    LayoutConfig

    レイアウト設定。

    以下のLayoutConfig テーブルを参照してください。

    PlayConfig

    PlayConfig

    再生構成。

    以下のPlayConfig テーブルを参照してください。

    LayoutConfig

    名前

    タイプ

    説明

    値の例

    FillMode

    文字列

    塗りつぶしモード。 フロントエンドの場合は、このパラメータを `none` に設定します。

    none

    PositionRefer

    文字列

    要素の位置の基準点。 有効な値: `topLeft` (左上)、`topRight` (右上)、`bottomLeft` (左下)、`bottomRight` (右下)。

    topLeft

    PositionNormalized

    浮動小数点数

    レイヤーのパディングエリアの正規化された位置。 `[x,y]` 形式。
    x と y の値の範囲は 0 から 1 です。
    たとえば、`[0.1,0.1]` は、左上隅からの水平オフセット 10% と垂直オフセット 10% を示します。




    [0.1, 0.1]

    SizeNormalized

    浮動小数点数

    レイヤーの正規化されたサイズ。 `[w,h]` 形式。
    w と h の値の範囲は 0 から 1 です。 幅と高さはどちらも正規化されています。
    たとえば、`[0.2,0.3]` は、幅 20% と高さ 30% を示します。




    [0.2, 0.3]

    PlayConfig

    名前

    タイプ

    説明

    値の例

    VolumeRate

    浮動小数点数

    ボリューム。 値は 0 から 1 の範囲で、小数点以下 2 桁まで正確です。

    0.50

    MonitorConfig

    名前

    タイプ

    説明

    値の例

    fpsLowThres

    浮動小数点数

    ビデオフレームレートのアラートしきい値。 このしきい値は係数です。 値の範囲は (0.0, 1.0] です。 デフォルト値は 0.7 です。 監視対象ストリームのビデオフレームレートが (アラートしきい値 × ライブストリームの元のフレームレート) より小さい場合、アラートがトリガーされます。

    0.7

    brHighThres

    浮動小数点数

    オーディオおよびビデオビットレートのアラートしきい値。 このしきい値は係数です。 値の範囲は (0.0, 100] です。 デフォルト値は 1.0 です。 監視対象ストリームのオーディオおよびビデオビットレートが (アラートしきい値 × ライブストリームの元のビットレート) より大きい場合、アラートがトリガーされます。

    1.0

    eofDurationThresSec

    浮動小数点数

    アラートがトリガーされるまでのストリーム中断時間のしきい値。 単位: 秒。 値の範囲は (0, 65535] です。 デフォルト値は 0 です。 - ストリームが中断された後、接続はアクティブなままです。 システムは、5 秒の内部パケット受信タイムアウトを使用して中断を検出します。 このパラメータを 5 秒以下の値に設定すると、実際の検出時間は 5 秒になります。 このパラメータを 5 秒より大きい値に設定すると、実際の検出時間は設定した値になります。 この期間の最初の 5 秒は内部タイムアウト用で、残りはシステムがストリームの回復を待つ時間です。 - タイムアウト期間が終了する前にストリームが回復した場合、アラートはトリガーされません。 ストリームがタイムアウトする前に監視アドレスを変更すると、システムはタイムアウトの検出と以前のストリームのアラートのトリガーを停止します。

    10

    レスポンスパラメーター

    パラメーター

    タイプ

    説明

    例

    object

    MonitorId

    string

    モニタリングセッションの ID。

    445409ec-7eaa-461d-8f29-4bec2eb9****
    RequestId

    string

    リクエスト ID。

    5c6a2a0d-f228-4a64-af62-20e91b96****

    例

    成功レスポンス

    JSONJSON

    {
  "MonitorId": "445409ec-7eaa-461d-8f29-4bec2eb9****",
  "RequestId": "5c6a2a0d-f228-4a64-af62-20e91b96****"
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    400 InvalidParameter.Malformed %s
    400 InvalidUserId.Malformed %s
    400 MissingParameter %s
    400 StreamMonitorExist %s
    401 IllegalOperation %s
    500 InternalError %s
    404 InvalidDomainName.NotFound %s

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

    変更履歴

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