すべてのプロダクト
Search

このプロダクト

    :CreateLiveStreamMonitor

    ドキュメントセンター

    :CreateLiveStreamMonitor

    最終更新日:Jan 21, 2026

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

    操作説明

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

    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 を入力します。Webhook URL は HTTP または HTTPS 形式を使用できます。 詳細については、「カスタムロボットアクセス」をご参照ください。

    説明

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

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

    InputConfig

    名前タイプ説明値の例
    IndexIntegerインデックス。 このパラメーターはフロントエンドで使用されます。1
    LayoutIdIntegerレイアウト ID。 値は 1 から始まる必要があります。1
    StreamNameString監視対象ストリームの表示名。monitorStream****
    InputUrlString入力ストリームの URL。demo.aliyundoc.com
    LayoutConfigLayoutConfigレイアウト設定。後述の LayoutConfig テーブルをご参照ください。
    PlayConfigPlayConfig再生設定。後述の PlayConfig テーブルをご参照ください。

    LayoutConfig

    名前タイプ説明値の例
    FillModeStringフィルモード。 フロントエンドでは、このパラメーターを `none` に設定します。none
    PositionReferString要素の位置の基準点。 有効な値：`topLeft` (左上)、`topRight` (右上)、`bottomLeft` (左下)、`bottomRight` (右下)。topLeft
    PositionNormalizedFloatレイヤーのパディングエリアの正規化された位置。`[x,y]` 形式で指定します。 x と y の値の範囲は 0 から 1 です。 たとえば、`[0.1,0.1]` は、左上隅から水平方向に 10%、垂直方向に 10% のオフセットを示します。[0.1, 0.1]
    SizeNormalizedFloatレイヤーの正規化されたサイズ。`[w,h]` 形式で指定します。 w と h の値の範囲は 0 から 1 です。 幅と高さの両方が正規化されます。 たとえば、`[0.2,0.3]` は、幅 20%、高さ 30% を示します。[0.2, 0.3]

    PlayConfig

    名前タイプ説明値の例
    VolumeRateFloatボリューム。 値の範囲は 0 から 1 で、小数点以下 2 桁まで指定できます。0.50

    MonitorConfig

    名前タイプ説明値の例
    fpsLowThresFloatビデオフレームレートのアラートしきい値。 このしきい値は係数です。 値の範囲は (0.0, 1.0] です。 デフォルト値は 0.7 です。 監視対象ストリームのビデオフレームレートが (アラートしきい値 × ライブストリームの元のフレームレート) 未満の場合にアラートがトリガーされます。0.7
    brHighThresFloat音声とビデオのビットレートのアラートしきい値。 このしきい値は係数です。 値の範囲は (0.0, 100] です。 デフォルト値は 1.0 です。 監視対象ストリームの音声とビデオのビットレートが (アラートしきい値 × ライブストリームの元のビットレート) を超える場合にアラートがトリガーされます。1.0
    eofDurationThresSecFloatアラートがトリガーされるまでのストリーム中断期間のしきい値。 単位：秒。 値の範囲は (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 There are invalid parameters: %s.
    400 InvalidUserId.Malformed %s, please check userId.
    400 MissingParameter %s.
    400 StreamMonitorExist %s, please check and try again later.
    401 IllegalOperation %s, please check and try again later.
    500 InternalError %s, please try again later.
    404 InvalidDomainName.NotFound %s, please check and try again later.

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

    変更履歴

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