すべてのプロダクト
Search
ドキュメントセンター

ApsaraVideo Live:SetLiveLazyPullStreamInfoConfig

最終更新日:Jul 08, 2024

ストリームのプルをトリガーする構成を作成します。

使用状況ノート

このインターフェイスは、トリガーされたストリームプルに適用できます。つまり、プルする必要があるソースURLがライブストリームの再生を開始すると、ApsaraVideo liveサービスが自動的にトリガーされてライブストリームがプルされます。

説明 このインターフェイスは現在IPv6プロトコルをサポートしていません。

QPS制限

1人のユーザーが1分あたり最大1000クエリ (QPS) を実行できます。 1秒あたりの呼び出し数がQPS制限を超えると、スロットリングがトリガーされます。 スロットルはビジネスに影響を与える可能性があります。 したがって、この操作のQPS制限を遵守することをお勧めします。 シングルユーザーの意味とQPSの詳細については、「ApsaraVideo LiveのAPI操作のQPS制限」をご参照ください。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。 この操作は、OpenAPI Explorer で呼び出すことを推奨します。 OpenAPI Explorer は、さまざまな SDK に対して操作のサンプルコードを動的に生成します。

リクエストパラメーター

パラメーターデータ型必須/任意説明
操作String必須SetLiveLazyPullStreamInfoConfig

実行したい操作。 値をSetLiveLazyPullStreamInfoConfigに設定します。

AppNameString必須ali_all_app

ライブストリームが属するアプリケーションの名前。

説明 すべてのアプリケーションがback-To-originストリームプルをトリガーできるようにするには、値をali_all_appに設定します。
DomainNameString必須example.com

メインのストリーミングドメイン。

PullDomainNameString必須guide.aliyundoc.com

ライブストリームの配信元サーバー。 複数のオリジンサーバーをセミコロン (;) で区切ります。

PullProtocolString必須rtmp

back-to-originストリームをプルするためのプロトコル。 設定可能な値は以下のとおりです。

  • rtmp
  • httpflv
PullAppNameString任意livePullApp ****

back-to-originストリームのプルのためのアプリケーション。

説明 ストリーミングURLで指定されたアプリケーションを使用するには、このパラメーターを空のままにします。

レスポンスパラメーター

パラメーターデータ型説明
RequestIdString16A96B9A-F203-4EC5-8E43-CB92E68F4CF8

リクエストの ID です。

リクエストの例

http(s):// live.aliyuncs.com/?Action=SetLiveLazyPullStreamInfoConfig
&AppName=ali_all_app
&DomainNam e=example.com
&PullDomainNam e=guide.aliyundoc.com
&PullProtocol=rtmp
&<共通リクエストパラメーター>

正常に処理された場合のレスポンス例

XML 形式

<SetLiveLazyPullStreamInfoResponse>
      <RequestId>16A96B9A-F203-4EC5-8E43-CB92E68F4CF8</RequestId>
  </SetLiveLazyPullStreamInfoResponse>

JSON 形式

{
    "RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68F4CF8"
}

エラーコード

エラーコードリストについては、「API エラーセンター」をご参照ください。

エラーコード

エラーメッセージ

HTTP ステータスコード

説明

InvalidDomain.NotFound

The domain provided does not exist in our records.

404

ドメイン名がAlibaba Cloudアカウントに属していない場合に返されるエラーメッセージ。

IllegalOperation

Illegal domain operate is not permitted.

403

現在の操作がサポートされていない場合に返されるエラーメッセージ。 たとえば、指定されたドメイン名はライブドメインではありません。

不足しているドメイン名

このアクションにはDomainNameが必須です。

400

必要なパラメーターが指定されていない場合に返されるエラーメッセージ。

InternalError

不明なエラーにより、リクエスト処理が失敗しました。

500

不明なエラーが発生した場合に返されるエラーメッセージ。