取り込みドメインのストリーム取り込みコールバックを設定します。
使用状況ノート
このインターフェイスは、取り込みドメイン名のコールバックアドレスと認証情報の設定をサポートします。
QPS limit
1人のユーザーが1秒あたり最大15クエリ (QPS) を実行できます。 1秒あたりの呼び出し数がQPS制限を超えると、スロットリングがトリガーされます。 スロットルはビジネスに影響を与える可能性があります。 したがって、この操作のQPS制限を遵守することをお勧めします。 シングルユーザーの意味とQPSの詳細については、「ApsaraVideo LiveのAPI操作のQPS制限」をご参照ください。
デバッグ
リクエストパラメーター
パラメーター | データ型 | 必須/任意 | 例 | 説明 |
---|---|---|---|---|
操作 | String | 必須 | SetLiveStreamsNotifyUrlConfig |
実行する操作です。 Set the value to SetLiveStreamsNotifyUrlConfig. |
DomainName | String | 必須 | demo.aliyundoc.com |
取り込みドメイン。 |
NotifyUrl | String | 必須 | http://guide.aliyundoc.com/notify |
ストリーム取り込みに関するコールバック通知の送信先のURL。 |
NotifyReqAuth | String | 任意 | はい |
認証を有効にするかどうかを指定します。 設定可能な値は以下のとおりです。
デフォルト値: no。 |
NotifyAuthKey | String | 任意 | 123 *** |
暗号化キー。 このパラメーターは、NotifyReqAuthパラメーターがyesに設定されている場合に必要です。 |
レスポンスパラメーター
パラメーター | データ型 | 例 | 説明 |
---|---|---|---|
RequestId | String | 40A4F36D-A7CC-473A-88E7-154F92242566 |
リクエストの ID です。 |
例
リクエストの例
http(s):// live.aliyuncs.com/?Action=SetLiveStreamsNotifyUrlConfig
&DomainNam e=demo.aliyundoc.com
&NotifyUrl=http://guide.aliyundoc.com/notify
&<共通リクエストパラメーター>
正常に処理された場合のレスポンス例
XML
形式
<SetLiveStreamsNotifyUrlConfigResponse>
<RequestId>4C747C97-7ECD-4C61-8A92-67AD806331FF</RequestId>
</SetLiveStreamsNotifyUrlConfigResponse>
JSON
形式
{
"RequestId":"4C747C97-7ECD-4C61-8A92-67AD806331FF"
}
エラーコード
エラーコードリストについては、「API エラーセンター」をご参照ください。
コールバックロジック
ライブストリーム取り込みステータスのコールバックロジック:
Real-Time Messaging Protocol (RTMP) によるストリーム取り込み中、ApsaraVideo Liveは、ApsaraVideo LiveがOnPublishメッセージを受信してから2秒以内にストリーム取り込みクライアントが接続を閉じるかどうかを確認します。 ストリーム取り込みクライアントが接続を閉じない場合、ApsaraVideo Liveはストリーム取り込みの成功に関するコールバック通知を送信します。 接続確立後にApsaraVideo Liveがライブストリーミングデータを受信した場合にのみ、このコールバック通知の送信をApsaraVideo Liveに要求することができます。 In this case, submit a ticket.
For example, you have Ingest Domain A and Streaming Domain B, and you use the stream pulling feature for live streaming under Streaming Domain B. You can configure ApsaraVideo Live to pull a stream at the specified point in time, or allow ApsaraVideo Live to automatically pull a stream when the origin server starts live streaming. ストリームプルステータスに関するコールバック通知を受信する場合は、取り込みドメインaのストリームインジェストコールバックを設定します。設定後、ApsaraVideo Liveはストリームインジェストステータスと同じコールバックロジックを使用して、ストリーミングドメインBでストリームプルステータスに関するコールバック通知を送信します。デフォルトでは、apsaraVideo Liveは、接続が確立されてから2秒以内にストリームプルクライアントが接続を閉じない場合、ストリームプルの成功に関するコールバック通知を送信します。
Callback authentication logic
- ApsaraVideo Liveには、コールバック情報をコールバックURLに送信する際に、HTTP(S) リクエストヘッダーに
ALI-LIVE-TIMESTAMP
フィールドとALI-LIVE-SIGNATURE
フィールドが含まれます。ALI-LIVE-SIGNATURE
の値は、次の式を使用して計算されます。ALI-LIVE-SIGNATURE=MD5SUM (MD5CONTENT)
MD5CONTENT= ストリームプッシュドメイン名 | ALI-LIVEの値-TIMESTAMP | 暗号鍵
注 Stream pushingドメイン名は、コールバックURLが設定されているドメインを参照します。 暗号鍵は、コールバックURLの認証鍵を参照します。 - コールバックURLをホストするサーバーは、ストリームプッシュドメイン名、
ALI-LIVE-TIMESTAMP
の値、および暗号キーの連結文字列からMD5ハッシュを生成します。 It then compares the MD5 hash with the value ofALI-LIVE-SIGNATURE
in the HTTP(S) request header. If the MD5 hash is not consistent with the value ofALI-LIVE-SIGNATURE
, the request is considered invalid.
特殊エラーコード
エラーコード |
エラーメッセージ |
HTTP ステータスコード |
説明 |
---|---|---|---|
InternalError |
不明なエラーにより、リクエスト処理が失敗しました。 |
500 |
不明なエラーが発生した場合に返されるエラーメッセージ。 |
InvalidDomain.NotFound |
The domain provided does not exist in our records. |
404 |
ドメイン名がAlibaba Cloudアカウントに属していない場合に返されるエラーメッセージ。 |
IllegalOperation |
Illegal domain operate is not permitted. |
403 |
The error message returned because the current operation is not supported. たとえば、指定されたドメイン名はライブドメインではありません。 |
InvalidNotifyUrl.Malformed |
Specified parameter NotifyUrl is not valid. |
400 |
The error message returned because the callback URL is not a valid HTTP URL. |
InvalidNotifyUrl.Unsafe |
指定されたNotifyUrlは安全ではありません。 |
400 |
The error message returned because the URL used to receive notifications is unsafe. |