ストリームのプルをトリガーする構成を作成します。
使用状況ノート
このインターフェイスは、トリガーされたストリームプルに適用できます。つまり、プルする必要があるソースURLがライブストリームの再生を開始すると、ApsaraVideo liveサービスが自動的にトリガーされてライブストリームがプルされます。
QPS制限
1人のユーザーが1分あたり最大1000クエリ (QPS) を実行できます。 1秒あたりの呼び出し数がQPS制限を超えると、スロットリングがトリガーされます。 スロットルはビジネスに影響を与える可能性があります。 したがって、この操作のQPS制限を遵守することをお勧めします。 シングルユーザーの意味とQPSの詳細については、「ApsaraVideo LiveのAPI操作のQPS制限」をご参照ください。
デバッグ
リクエストパラメーター
パラメーター | データ型 | 必須/任意 | 例 | 説明 |
操作 | String | 必須 | SetLiveLazyPullStreamInfoConfig | 実行したい操作。 値をSetLiveLazyPullStreamInfoConfigに設定します。 |
AppName | String | 必須 | ali_all_app | ライブストリームが属するアプリケーションの名前。 説明 すべてのアプリケーションがback-To-originストリームプルをトリガーできるようにするには、値をali_all_appに設定します。 |
DomainName | String | 必須 | example.com | メインのストリーミングドメイン。 |
PullDomainName | String | 必須 | guide.aliyundoc.com | ライブストリームの配信元サーバー。 複数のオリジンサーバーをセミコロン (;) で区切ります。 |
PullProtocol | String | 必須 | rtmp | back-to-originストリームをプルするためのプロトコル。 設定可能な値は以下のとおりです。
|
PullAppName | String | 任意 | livePullApp **** | back-to-originストリームのプルのためのアプリケーション。 説明 ストリーミングURLで指定されたアプリケーションを使用するには、このパラメーターを空のままにします。 |
レスポンスパラメーター
パラメーター | データ型 | 例 | 説明 |
RequestId | String | 16A96B9A-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 | 不明なエラーが発生した場合に返されるエラーメッセージ。 |