调用DescribeLiveDomainTranscodeData查询直播域名转码时长。

说明 每日转码时长数据包括:当日转码总时长和区分转码规格的时长数据列表。

调试

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

请求参数

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

系统规定参数。取值:DescribeLiveDomainTranscodeData

StartTime String 2018-01-01T00:00:00Z

起始时间。格式为:yyyy-MM-ddTHH:mm:ssZ(UTC时间)。

说明 支持查询最近90天的数据。
EndTime String 2018-01-02T01:00:00Z

结束时间。需晚于起始时间。格式为:yyyy-MM-ddTHH:mm:ssZ(UTC时间)。

DomainName String www.example.com

直播域名。

多个域名之间用英文逗号(,)分隔。

返回数据

名称 类型 示例值 描述
TranscodeDataInfos Array of TranscodeDataInfo

直播转码时长的每日数据统计。

TranscodeDataInfo
Date String 20180202

日期,具体到天。

Total Integer 4710

单日转码总时长。单位:秒。

Detail String { "LD_CASTER": 86315, "SD_CASTER": 86315 }, "Date": "20180212", "Total": 172630}

区分转码规格的转码时长信息。

转码类型字段含义请参见下文转码类型说明

RequestId String B955107D-E658-4E77-B913-E0AC3D31693F

请求ID。

示例

请求示例

http(s)://live.aliyuncs.com/?Action=DescribeLiveDomainTranscodeData
&StartTime=2018-01-01T00:00:00Z
&EndTime=2018-01-02T01:00:00Z
&<公共请求参数>

正常返回示例

XML格式

<DescribeLiveDomainTranscodeDataResponse>
  <RequestId>793D2C8D-E6F6-4528-B9BC-1EFBD11087D7</RequestId>
  <TranscodeDataInfos>
        <TranscodeDataInfo>
              <Total>370</Total>
              <Date>20180101</Date>
              <Detail>SD_MIX:370</Detail>
        </TranscodeDataInfo>
        <TranscodeDataInfo>
              <Total>40700</Total>
              <Date>20180102</Date>
              <Detail>SD_MIX:39785,HD_MIX:915</Detail>
        </TranscodeDataInfo>
        <TranscodeDataInfo>
              <Total>55710</Total>
              <Date>20180103</Date>
              <Detail>SD_MIX:54440,HD_MIX:1270</Detail>
        </TranscodeDataInfo>
        <TranscodeDataInfo>
              <Total>78355</Total>
              <Date>20180104</Date>
              <Detail>SD_MIX:77170,HD_MIX:1185</Detail>
        </TranscodeDataInfo>
        <TranscodeDataInfo>
              <Total>79265</Total>
              <Date>20180105</Date>
              <Detail>SD_MIX:75975,HD_MIX:3290</Detail>
        </TranscodeDataInfo>
        <TranscodeDataInfo>
              <Total>755</Total>
              <Date>20180106</Date>
              <Detail>SD_MIX:755</Detail>
        </TranscodeDataInfo>
        <TranscodeDataInfo>
              <Total>2955</Total>
              <Date>20180107</Date>
              <Detail>HD_MIX:145,SD_MIX:2810</Detail>
        </TranscodeDataInfo>
        <TranscodeDataInfo>
              <Total>38915</Total>
              <Date>20180108</Date>
              <Detail>HD_MIX:4885,SD_MIX:34030</Detail>
        </TranscodeDataInfo>
        <TranscodeDataInfo>
              <Total>39245</Total>
              <Date>20180109</Date>
              <Detail>HD_MIX:55,SD_MIX:39190</Detail>
        </TranscodeDataInfo>
        <TranscodeDataInfo>
              <Total>48135</Total>
              <Date>20180110</Date>
              <Detail>HD_MIX:2630,SD_MIX:45505</Detail>
        </TranscodeDataInfo>
        <TranscodeDataInfo>
              <Total>44525</Total>
              <Date>20180111</Date>
              <Detail>HD_MIX:1070,SD_MIX:43455</Detail>
        </TranscodeDataInfo>
        <TranscodeDataInfo>
              <Total>62485</Total>
              <Date>20180112</Date>
              <Detail>SD_MIX:62485</Detail>
        </TranscodeDataInfo>
  </TranscodeDataInfos>
</DescribeLiveDomainTranscodeDataResponse>

JSON格式

{
	"RequestId": "793D2C8D-E6F6-4528-B9BC-1EFBD11087D7",
	"TranscodeDataInfos": {
		"TranscodeDataInfo": [
			{
				"Total": 370,
				"Date": "20180101",
				"Detail": "SD_MIX:370"
			},
			{
				"Total": 40700,
				"Date": "20180102",
				"Detail": "SD_MIX:39785,HD_MIX:915"
			},
			{
				"Total": 55710,
				"Date": "20180103",
				"Detail": "SD_MIX:54440,HD_MIX:1270"
			},
			{
				"Total": 78355,
				"Date": "20180104",
				"Detail": "SD_MIX:77170,HD_MIX:1185"
			},
			{
				"Total": 79265,
				"Date": "20180105",
				"Detail": "SD_MIX:75975,HD_MIX:3290"
			},
			{
				"Total": 755,
				"Date": "20180106",
				"Detail": "SD_MIX:755"
			},
			{
				"Total": 2955,
				"Date": "20180107",
				"Detail": "HD_MIX:145,SD_MIX:2810"
			},
			{
				"Total": 38915,
				"Date": "20180108",
				"Detail": "HD_MIX:4885,SD_MIX:34030"
			},
			{
				"Total": 39245,
				"Date": "20180109",
				"Detail": "HD_MIX:55,SD_MIX:39190"
			},
			{
				"Total": 48135,
				"Date": "20180110",
				"Detail": "HD_MIX:2630,SD_MIX:45505"
			},
			{
				"Total": 44525,
				"Date": "20180111",
				"Detail": "HD_MIX:1070,SD_MIX:43455"
			},
			{
				"Total": 62485,
				"Date": "20180112",
				"Detail": "SD_MIX:62485"
			}
		]
	}
}

错误码

HttpCode 错误码 错误信息 描述
400 InvalidStartTime.Malformed Specified StartTime is malformed. StartTime参数错误,请您确认该StartTime参数是否正确。
400 InvalidEndTime.Malformed Specified EndTime is malformed. 结束时间错误,请您确认结束时间是否正确。

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

转码类型说明

转码类型是一个字符串,由分辨率字段、前缀字段和后缀字段组成,字段之间由下划线分隔。分辨率字段为必备字段,前缀和后缀字段为可选字段。

  • 分辨率字段
    • LD:低清
    • SD:标清
    • HD:高清
    • 2K:2K
    • 4K:4K
    • EX:大于4K
  • codec前缀
    • 没有:H.264
    • 265:H.265
  • profile后缀
    • 没有:窄带高清1.0转码
    • S:标准质量转码
    • NBHD15:窄带高清1.5转码
    • NBHD2:窄带高清2.0转码
    • WM:水印转码
    • CASTER:导播转码
  • 输出帧率后缀
    • 没有:标准输出帧率(≤30fps)
    • OFH:高输出帧率(>30fps)

举例:

  • HD:H.264、高清、窄带高清1.0转码、标准输出帧率。
  • 265_SD_NBHD2:H.265、标清、窄带高清2.0转码、标准输出帧率。
  • LD_S_OFH:H.264、低清、标准质量转码、高输出帧率。