DescribeLiveDomainTranscodeData - - Alibaba Cloud Documentation Center

Note The daily statistics on the transcoding length include the total transcoding length and the transcoding length of each transcoding specification on the current day.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

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.