すべてのプロダクト
Search

このプロダクト

    ApsaraVideo Live:UpdateLiveStreamMonitor

    ドキュメントセンター

    ApsaraVideo Live:UpdateLiveStreamMonitor

    最終更新日:Jan 21, 2026

    モニタリングセッションの構成を更新します。

    操作説明

    この操作は、モニタリングセッションの設定を更新します。モニタリングセッションが実行中の場合、入力ソースの設定への更新はリアルタイムで有効になります。

    QPS 制限

    1 人のユーザーあたりの 1 秒あたりのクエリ数 (QPS) 制限は 10 です。この制限を超える 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:UpdateLiveStreamMonitor

    update

    *All Resource

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    RegionId

    string

    任意

    リージョン ID。

    cn-shanghai
    MonitorId

    string

    必須

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

    説明

    MonitorId の値は、CreateLiveStreamMonitor 操作のレスポンスパラメーターから取得します。

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

    string

    任意

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

    liveMonitor****
    Domain

    string

    任意

    モニタリングセッションの出力ドメイン名。

    demo.aliyundoc.com
    App

    string

    任意

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

    monitor****
    Stream

    string

    任意

    モニタリングセッションの出力ストリームの名前。

    monitorStream****
    OutputTemplate

    string

    任意

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

    • lp_ld：低解像度。

    • lp_sd：標準解像度。

    • lp_hd：高解像度。

    • lp_ud：超高解像度。

    lp_ud
    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 チャットボットのカスタムキーワードを「アラート」に設定してください。そうしないと、メッセージを受信できません。

    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

    RequestId

    string

    リクエスト ID。

    5c6a2a0d-f228-4a64-af62-20e91b9676b3

    例

    成功レスポンス

    JSONJSON

    {
  "RequestId": "5c6a2a0d-f228-4a64-af62-20e91b9676b3"
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    400 InvalidUserId.Malformed %s, please check userId.
    400 InvalidParameter.Malformed There are invalid parameters: %s.
    400 MissingParameter %s.
    400 InvalidMonitorId.Malformed %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.
    404 StreamMonitorNotExist %s, please check and try again later.

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

    変更履歴

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