Queries the statistics on the transcoding length for one or more domain names.
Debugging
Request parameters
Parameter | Type | Required | Example | Description |
---|---|---|---|---|
Action | String | Yes | DescribeLiveDomainTranscodeData |
The operation that you want to perform. Set the value to DescribeLiveDomainTranscodeData. |
StartTime | String | Yes | 2018-01-01T00:00:00Z |
The beginning of the time range to query. Specify the time in the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC. Note You can query the data of the last 90 days at most.
|
EndTime | String | Yes | 2018-01-02T01:00:00Z |
The end of the time range to query. The end time must be later than the start time. Specify the time in the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC. |
DomainName | String | No | www.example.com |
The domain name. Separate multiple domain names with commas (,). |
Response parameters
Parameter | Type | Example | Description |
---|---|---|---|
TranscodeDataInfos | Array of TranscodeDataInfo |
The daily statistics on the transcoding length. |
|
TranscodeDataInfo | |||
Date | String | 20180202 |
The date when the statistics were generated. |
Total | Integer | 4710 |
The total transcoding length of the specified date. Unit: seconds. |
Detail | String | { "LD_CASTER": 86315, "SD_CASTER": 86315 }, "Date": "20180212", "Total": 172630} |
The information about the transcoding length of each transcoding specification. For more information about fields in each transcoding specification, see Fields in transcoding specifications. |
RequestId | String | B955107D-E658-4E77-B913-E0AC3D31693F |
The ID of the request. |
Examples
Sample requests
http(s)://live.aliyuncs.com/?Action=DescribeLiveDomainTranscodeData
&StartTime=2018-01-01T00:00:00Z
&EndTime=2018-01-02T01:00:00Z
&<Common request parameters>
Sample success responses
XML
format
<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
format
{
"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"
}
]
}
}
Error codes
HttpCode | Error code | Error message | Description |
---|---|---|---|
400 | InvalidStartTime.Malformed | Specified StartTime is malformed. | The error message returned because the format of the start time is invalid. Check whether the value of the StartTime parameter is valid. |
400 | InvalidEndTime.Malformed | Specified EndTime is malformed. | The error message returned because the format of the end time is invalid. Check whether the value of the EndTime parameter is valid. |
For a list of error codes, visit the API Error Center.
Fields in transcoding specifications
The transcoding specification is a string that consists of the resolution, prefix, and suffix fields, separated by underscores (_). The resolution field is required, and the prefix and suffix fields are optional.
- Resolution
- LD: low definition.
- SD: standard definition.
- HD: high definition.
- 2K: 2K resolution.
- 4K: 4K resolution.
- EX: resolution greater than 4K.
- Codec prefix
- Null: H.264.
- 265: H.265.
- Profile suffix
- Null: Narrowband HD™ 1.0 transcoding.
- S: standard quality transcoding.
- NBHD15: Narrowband HD™ 1.5 transcoding.
- NBHD2: Narrowband HD™ 2.0 transcoding.
- WM: watermark-based transcoding.
- CASTER: production studio-based transcoding.
- Output frame rate suffix
- Null: standard output frame rate, which does not exceed 30 FPS.
- OFH: high output frame rate, which exceeds 30 FPS.
Examples:
- HD: H.264, high definition, Narrowband HD™ 1.0 transcoding, and standard output frame rate.
- 365_SD_NBHD2: H.265, standard definition, Narrowband HD™ 2.0 transcoding, and standard output frame rate.
- LD_S_OFH: H.264, low definition, standard quality transcoding, and high output frame rate.