ストリーミングドメインの記録コールバック設定を作成します。
使用状況ノート
このインターフェイスを呼び出してドメインレベルの録画コールバック設定を追加する前に、ライブ録画コールバック設定を確認します。 ライブ録音コールバック設定を照会するには、DescribeLiveRecordNotifyConfig
QPS制限
1人のユーザーが1秒あたり最大30件のクエリ (QPS) を実行できます。 1秒あたりの呼び出し数がQPS制限を超えると、スロットリングがトリガーされます。 スロットルはビジネスに影響を与える可能性があります。 したがって、この操作のQPS制限を遵守することをお勧めします。 シングルユーザーの意味とQPSの詳細については、「ApsaraVideo LiveのAPI操作のQPS制限」をご参照ください。
デバッグ
リクエストパラメーター
| パラメーター | データ型 | 必須／任意 | 例 | 説明 |
|---|---|---|---|---|
| 操作 | String | 必須 | AddLiveRecordNotifyConfig |
実行したい操作。 値をAddLiveRecordNotifyConfigに設定します。 |
| DomainName | String | 必須 | example.com |
メインのストリーミングドメイン。 |
| NotifyUrl | String | 必須 | http://demo.aliyundoc.com/examplecallback.action |
イベントとステータスの記録に関する通知を受け取るために使用されるコールバックURL。 URLは、 |
| OnDemandUrl | String | 任意 | http://learn.aliyundoc.com/ondemandcallback.action |
オンデマンド録音のコールバックURL。 URLは、 |
| NeedStatusNotify | Boolean | 任意 | false |
ステータスを記録するコールバックを有効にするかどうかを指定します。 設定可能な値は以下のとおりです。
|
レスポンスパラメーター
| パラメーター | データ型 | 例 | 説明 |
|---|---|---|---|
| RequestId | String | 16A96B9A-F203-4EC5-8E43-CB92E68F4CD8 |
リクエストの ID です。 |
例
リクエストの例
https://live.aliyuncs.com/?Action=AddLiveRecordNotifyConfig
&DomainNam e=example.com
&NotifyUrl=http://demo.aliyundoc.com/examplecallback.action
&<共通リクエストパラメーター>正常に処理された場合のレスポンス例
XML 形式
<AddLiveRecordNotifyConfigResponse>
<RequestId>394966CA-5940-44D7-A1C5-24211C7B07A9</RequestId>
</AddLiveRecordNotifyConfigResponse>JSON 形式
{
"RequestId": "394966CA-5940-44D7-A1C5-24211C7B07A9"
}エラーコード
| HTTP ステータスコード | エラーコード | エラーメッセージ | 説明 |
|---|---|---|---|
| 400 | InvalidNotifyUrl.Malformed | 指定されたNotifyUrlは無効です。 | コールバックURLの形式が無効な場合に返されるエラーメッセージ。 NotifyUrlパラメーターの値が正しいかどうかを確認します。 |
| 400 | InvalidNotifyUrl.Unsafe | 指定されたNotifyUrlは安全ではありません。 | コールバックURLが安全でない場合に返されるエラーメッセージ。 NotifyUrlパラメーターの値が正しいかどうかを確認します。 |
| 400 | ConfigAlreadyExists | Configはすでに存在しています。 | コールバック通知の受信に使用されるURLが追加された場合に返されるエラーメッセージ。 |
エラーコードリストについては、「API エラーセンター」をご参照ください。