调用DescribeLiveRecordNotifyConfig查询域名级别录制回调配置。

使用说明

先获取主播流域名,再调用本接口查询域名级别录制回调配置。

QPS限制

本接口的单用户QPS限制为50次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。更多信息,请参见QPS限制

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action 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

录制回调地址。

NeedStatusNotify Boolean false

是否需要录制任务状态回调。取值:

  • true:是。
  • false(默认值):否。
OnDemandUrl String http://guide.aliyundoc.com/ondemandcallback.action

按需录制回调URL地址。

示例

请求示例

http(s)://live.aliyuncs.com/?Action=DescribeLiveRecordNotifyConfig
&DomainName=example.com
&<公共请求参数>

正常返回示例

XML格式

<DescribeLiveRecordNotifyConfigResponse>
  <RequestId>5056369B-D337-499E-B8B7-B761BD37B08A</RequestId>
  <LiveRecordNotifyConfig>
        <NeedStatusNotify>false</NeedStatusNotify>
        <OnDemandUrl>http://guide.aliyundoc.com/ondemandcallback.action</OnDemandUrl>
        <DomainName>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"
        }
    }
}

错误码

HttpCode 错误码 错误信息 描述
404 InvalidConfig.NotFound Config does not exist. 配置错误,请您确认该配置是否正确。

访问错误中心查看更多错误码。