调用DescribeLiveUserDomains查询用户名下所有的直播域名。

调试

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

请求参数

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

系统规定参数。取值：DescribeLiveUserDomains。

LiveDomainType String 否 liveVideo

直播域名业务类型。取值：

  • liveVideo：播流域名。
  • liveEdge：边缘推流域名。
PageSize Integer 否 20

分页大小。默认值为20，最大值为50。

PageNumber Integer 否 1

当前页码。取值范围：1~100000。

DomainName String 否 *.testdomain.com

域名模糊匹配过滤。不传值时，默认查询用户所有直播推流和播流域名。
RegionName String 否 cn-beijing

域名所属地域。
DomainSearchType String 否 fuzzy_match

域名查询类型。取值：

  • fuzzy_match（默认值）：模糊匹配。
  • pre_match：前匹配。
  • suf_match：后匹配。
  • full_match：完全匹配。
DomainStatus String 否 online

域名状态。取值：

  • online：运行中（表示域名服务状态正常）。
  • offline：已停止。
  • configuring：配置中。
Tag.N.Key String 否 TestKey

标签健。
Tag.N.Value String 否 TestValue

标签值。

返回数据

名称 类型 示例值 描述
Domains Array of PageData

返回直播域名的状态信息。
PageData
Cname String xingzu-bj.alivecdn.com.w.alikunlun.net

直播域名对应的CNAME域名。
Description String test

备注说明。
DomainName String live.yourdomain.com

直播推流和播流域名。
GmtCreated String 2017-08-29T12:15:36Z

直播域名创建时间。格式为：yyyy-MM-ddTHH:mm:ssZ（UTC时间）。

GmtModified String 2017-12-29T12:15:36Z

直播域名修改时间。格式为：yyyy-MM-ddTHH:mm:ssZ（UTC时间）。

LiveDomainStatus String online

域名状态。取值：

  • online：运行中（表示域名服务状态正常）。
  • offline：已停止。
  • configuring：配置中。
LiveDomainType String liveVideo

直播域名业务类型。取值：

  • liveVideo：播流域名。
  • liveEdge：边缘推流域名。
RegionName String cn-beijing

域名所属地域。
PageNumber Long 1

返回数据的当前页码。
PageSize Long 100

分页大小。
RequestId String E4EBD2BF-5EB0-4476-8829-9D94E1B15267

请求ID。
TotalCount Long 2

总条数。

示例

请求示例

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

正常返回示例

XML格式 

<DescribeLiveUserDomainsResponse>
  <Domains>
        <PageData>
              <LiveDomainStatus>online</LiveDomainStatus>
              <Description>test</Description>
              <RegionName>cn-beijing</RegionName>
              <LiveDomainType>liveVideo</LiveDomainType>
              <DomainName>live.yourdomain.com</DomainName>
              <GmtModified>2017-12-29T12:15:36Z</GmtModified>
              <GmtCreated>2017-08-29T12:15:36Z</GmtCreated>
              <Cname>xingzu-bj.alivecdn.com.w.alikunlun.net</Cname>
        </PageData>
  </Domains>
  <TotalCount>2</TotalCount>
  <PageSize>100</PageSize>
  <RequestId>E4EBD2BF-5EB0-4476-8829-9D94E1B15267</RequestId>
  <PageNumber>1</PageNumber>
</DescribeLiveUserDomainsResponse>

JSON格式 

{
	"Domains": {
		"PageData": [{
			"LiveDomainStatus": "online",
			"Description": "test",
			"RegionName": "cn-beijing",
			"LiveDomainType": "liveVideo",
			"DomainName": "live.yourdomain.com",
			"GmtModified": "2017-12-29T12:15:36Z",
			"GmtCreated": "2017-08-29T12:15:36Z",
			"Cname": "xingzu-bj.alivecdn.com.w.alikunlun.net"
		}]
	},
	"TotalCount": "2",
	"PageSize": "100",
	"RequestId": "E4EBD2BF-5EB0-4476-8829-9D94E1B15267",
	"PageNumber": "1"
}

错误码

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