调用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"
}

错误码

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