ストリーミングドメインの記録コールバック設定を変更します。

使用状況ノート

この操作では、次の設定を変更できます。

  • イベントとステータスの記録に関する通知を受け取るために使用されるコールバックURL。 詳細については、「イベントコールバックの記録」をご参照ください。
  • オンデマンド録音のコールバックURL。 詳細については、「オンデマンド記録コールバック」をご参照ください。
  • ステータスを記録するコールバックを有効にするかどうかを指定します。

QPS制限

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

デバッグ

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

リクエストパラメーター

パラメーター データ型 必須／任意 例 説明
操作 String 必須 UpdateLiveRecordNotifyConfig

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

DomainName String 必須 example.com

メインのストリーミングドメイン。
NotifyUrl String 任意 http://learn.aliyundoc.com/examplecallback.action

イベントとステータスの記録に関する通知を受け取るために使用されるコールバックURL。

重要 このパラメーターは、NeedStatusNotifyパラメーターがtrueに設定されている場合に指定する必要があります。
  • URLはhttp:// またはhttps:// で始まる必要があります。
  • システムが漢字、スペース、および特殊文字を識別できるように、エンコードにURLEncoderを使用する必要があります。
OnDemandUrl String 任意 http://guide.aliyundoc.com/ondemandcallback.action

オンデマンド録音のコールバックURL。

  • URLはhttp:// またはhttps:// で始まる必要があります。
  • システムが漢字、スペース、および特殊文字を識別できるように、エンコードにURLEncoderを使用する必要があります。
NeedStatusNotify Boolean 任意 false

ステータスを記録するコールバックを有効にするかどうかを指定します。 設定可能な値は以下のとおりです。

注 このpapameterがtrueに設定されている場合、リクエストでNotifyUrlパラメーターを指定する必要があります。
  • true: 記録ステータスのコールバックを有効にします。
  • false: 記録ステータスのコールバックを無効にします。 これはデフォルト値です。

レスポンスパラメーター

パラメーター データ型 例 説明
RequestId String 16A96B9A-F203-4EC5-8E43-CB92E68F4CD

リクエストの ID です。

例

リクエストの例

https://live.aliyuncs.com/?Action=UpdateLiveRecordNotifyConfig
&DomainNam e=example.com
&<共通リクエストパラメーター>

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

XML 形式 

<UpdateLiveRecordNotifyConfigResponse>
      <RequestId>16A96B9A-F203-4EC5-8E43-CB92E68F4CD8</RequestId>
</UpdateLiveRecordNotifyConfigResponse>

JSON 形式 

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

エラーコード

HTTP ステータスコード エラーコード エラーメッセージ 説明
400 InvalidNotifyUrl.Malformed 指定されたNotifyUrlは無効です。 コールバックURLの形式が無効な場合に返されるエラーメッセージ。 NotifyUrlパラメーターの値が正しいかどうかを確認します。
400 InvalidNotifyUrl.Unsafe 指定されたNotifyUrlは安全ではありません。 コールバックURLが安全でない場合に返されるエラーメッセージ。 NotifyUrlパラメーターの値が正しいかどうかを確認します。
404 InvalidConfig.NotFound 設定は存在しません。 リクエストパラメーターに基づいて設定が見つからない場合に返されるエラーメッセージ。 リクエストパラメーターが正しいかどうかを確認します。

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