调用DescribeCasters查询导播台列表。

调试

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

请求参数

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

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

CasterId String 否 LIVEPRODUCER_POST-cn-0pp1czt****

导播台ID。
CasterName String 否 caster001

导播台名称。
StartTime String 否 2016-06-29T09:00:00Z

起始时间。格式为：yyyy-MM-ddTHH:mm:ssZ（UTC时间）。

EndTime String 否 2016-06-29T11:00:00Z

结束时间。格式为：yyyy-MM-ddTHH:mm:ssZ（UTC时间）。

PageNum Integer 否 1

页码。
PageSize Integer 否 5

每页条数。
Status Integer 否 0

状态。 取值：

  • 0：空闲 。
  • 1：导播中 。
RegionId String 否 cn-shanghai

地域ID。

返回数据

名称 类型 示例值 描述
CasterList Array of Caster

导播台信息列表。
Caster
CasterId String LIVEPRODUCER_POST-cn-0pp1czt****

导播台ID。
CasterName String coco-caster2

导播台名称。
CasterTemplate String lp_ld

导播台分辨率配置，付费类型为预付费时必选。

  • lp_ld：流畅 。
  • lp_sd：标清 。
  • lp_hd：高清。
  • lp_ud：超清。
  • lp_ld_v：竖屏流畅。
  • lp_sd_v：竖屏标清。
  • lp_hd_v：竖屏高清。
  • lp_ud_v：竖屏超清。
ChannelEnable Integer 1

是否启用Channel。

  • 0：不启用。
  • 1：启用。
ChargeType String PrePaid

付费方式。 目前只支持PostPaid。

  • PrePaid：预付费 。
  • PostPaid：后付费。
CreateTime String 2017-08-30 12:02:57.0

创建时间。
ExpireTime String 2018-08-30 12:02:57.0

导播台过期时间。
NormType Integer 1

导播台规格类型 。

  • 0：播单型。
  • 1：通用型。
PurchaseTime String 2017-08-30 12:02:57.0

导播台购买时间。
StartTime String 2017-08-30 18:02:57.0

导播台启动时间，当导播台处于导播中时输出。
Status Integer 1

状态。

  • 0：空闲。
  • 1：导播中。
RequestId String 6159ba01-6687-4fb2-a831-f0cd8d188648

请求ID。
Total Integer 1

导播台数量。

示例

请求示例

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

正常返回示例

XML 格式 

<DescribeCastersResponse>
  <RequestId>D81E449E-6420-42A3-8525-BCCB6E87323F</RequestId>
  <Total>1</Total>
  <CasterList>
        <Caster>
              <Status>0</Status>
              <CasterName>LIVEPRODUCER_POST-cn-v0h1557****</CasterName>
              <ChannelEnable>1</ChannelEnable>
              <ChargeType>PostPaid</ChargeType>
              <CreateTime>2019-05-23T12:31:48Z</CreateTime>
              <NormType>0</NormType>
              <CasterId>LIVEPRODUCER_POST-cn-v0h1557****</CasterId>
        </Caster>
  </CasterList>
</DescribeCastersResponse>

JSON 格式 

{
	"RequestId": "D81E449E-6420-42A3-8525-BCCB6E87323F",
	"Total": 1,
	"CasterList": {
		"Caster": [
			{
				"Status": 0,
				"CasterName": "LIVEPRODUCER_POST-cn-v0h1557****",
				"ChannelEnable": 1,
				"ChargeType": "PostPaid",
				"CreateTime": "2019-05-23T12:31:48Z",
				"NormType": 0,
				"CasterId": "LIVEPRODUCER_POST-cn-v0h1557****"
			}
		]
	}
}

错误码

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