调用DescribeLiveDomainMapping查询推流域名、主播流域名和子播流域名映射。

使用说明

先获取需要查询的直播域名,再调用本接口查询直播域名映射。

QPS限制

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

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String DescribeLiveDomainMapping

系统规定参数。取值:DescribeLiveDomainMapping

DomainName String example.com

您要查询的域名。域名可以是以下类型:

  • 推流域名。
  • 主播流域名。
  • 子播流域名。
RegionId String cn-beijing

域名所属地域。

返回数据

名称 类型 示例值 描述
LiveDomainModels Array of LiveDomainModel

直播域名映射列表。

LiveDomainModel
DomainName String example.aliyundoc.com

查询域名的映射域名。

Type String play

查询域名的属性。取值:

  • vhost:主播流域名。
  • publish:推流域名。
  • play:子播流域名。
RequestId String 16A96B9A-F203-4EC5-8E43-CB92E68F6CD8

请求ID。

示例

请求示例

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

正常返回示例

XML格式

<RequestId>16A96B9A-F203-4EC5-8E43-CB92E68F6CD8</RequestId>
<LiveDomainModels>
    <LiveDomainModel>
        <Type>play</Type>
        <DomainName>example.aliyundoc.com</DomainName>
    </LiveDomainModel>
</LiveDomainModels>

JSON格式

{
    "RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68F6CD8",
    "LiveDomainModels": {
        "LiveDomainModel": {
            "Type": "play",
            "DomainName": "example.aliyundoc.com"
        }
    }
}

错误码

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