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

使用状況ノート

この操作は、メインのストリーミングドメインに適用できます。

QPS制限

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

デバッグ

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

リクエストパラメーター

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

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

DomainName String 必須 example.com

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

レスポンスパラメーター

パラメーター データ型 例 説明
RequestId String 5056369B-D337-499E-B8B7-B761BD37B08A

リクエストの ID です。
LiveRecordNotifyConfig Struct

ストリーミングドメインの記録コールバック設定。
DomainName String example.com

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

録音コールバックURL。
NeedStatusNotify Boolean false

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

  • true: 記録ステータスのコールバックが有効になっています。
  • false: 記録ステータスのコールバックが無効になりました。 これはデフォルト値です。
OnDemandUrl String http://guide.aliyundoc.com/ondemandcallback.action

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

例

リクエストの例

http(s):// live.aliyuncs.com/?Action=DescribeLiveRecordNotifyConfig
&DomainNam e=example.com
&<共通リクエストパラメーター>

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

XML 形式 

<DescribeLiveRecordNotifyConfigResponse>
  <RequestId>5056369B-D337-499E-B8B7-B761BD37B08A</RequestId>
  <LiveRecordNotifyConfig>
        <NeedStatusNotify>false</NeedStatusNotify>
        <OnDemandUrl>http://guide.aliyundoc.com/ondemandcallback.action</OnDemandUrl>
        <DomainNam e>example.com</DomainName>
        <NotifyUrl>http://learn.aliyundoc.com/examplecallback.action</NotifyUrl>
  </LiveRecordNotifyConfig>
</DescribeLiveRecordNotifyConfigResponse>

JSON 形式 

{
    "DescribeLiveRecordNotifyConfigResponse": {
        "RequestId": "5056369B-D337-499E-B8B7-B761BD37B08A" 、
        "LiveRecordNotifyConfig": {
            "NeedStatusNotify": false、
            "OnDemandUrl": "http://guide.aliyundoc.com/ondemandcallback.action" 、
            "DomainName": "example.com",
            "NotifyUrl": "http://learn.aliyundoc.com/examplecallback.action"
        }
    }
}

エラーコード

HTTP ステータスコード エラーコード エラーメッセージ 説明
404 InvalidConfig.NotFound 設定は存在しません。 リクエストパラメーターに基づいて設定が見つからない場合に返されるエラーメッセージ。 リクエストパラメーターが正しいかどうかを確認します。

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