AI 助理
备案控制台
文档
输入文档关键字查找
首页 视频直播 开发参考 API参考（新） API目录 用量查询 DescribeLiveProducerUsageData - 查询导播台用量数据

DescribeLiveProducerUsageData - 查询导播台用量数据

更新时间：
产品详情
相关技术圈
我的收藏

调用DescribeLiveProducerUsageData查询导播台用量数据。

接口说明

最小数据查询粒度为 1 小时；最大查询时间跨度为 31 天；支持历史最大查询时间范围为最近 90 天。

QPS 限制

本接口的单用户 QPS 限制为 5 次/秒。超过限制，API 调用会被限流，这可能会影响您的业务，请合理调用。

调试

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

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

  • 操作：是指具体的权限点。
  • 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
  • 资源类型：是指操作中支持授权的资源类型。具体说明如下：
    • 对于必选的资源类型，用背景高亮的方式表示。
    • 对于不支持资源级授权的操作，用全部资源表示。
  • 条件关键字：是指云产品自身定义的条件关键字。
  • 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。
操作访问级别资源类型条件关键字关联操作
live:DescribeLiveProducerUsageDataget
*Domain
acs:cdn:*:{#accountId}:domain/{#DomainName}
    无
无

请求参数

名称类型必填描述示例值
Regionstring否

域名所属地域。若参数为空，默认返回所有 Region 合并后数据，支持批量查询，多个 Region 用半角逗号（,）分隔。

cn-shanghai
DomainNamestring否

云导播播流域名。

  • 支持单个或批量域名查询。批量查询时多个域名用英文逗号（,）分隔。
  • 若参数为空，默认返回所有直播域名合并后的数据。
example.com
Instancestring否

查询实例。支持批量实例查询，多个实例用英文逗号（,）分隔。

说明 若参数为空，默认返回所有实例合并后数据。
a17d0184-462d-4630-b2a6-8c26dde2****
Typestring否

导播类型。支持批量查询，多个类型用英文逗号（,）分隔。取值：

  • slidelive：播单型。

  • universal：通用型。

说明 若参数为空，默认返回所有导播类型合并后数据。
slidelive
SplitBystring否

分组键。可以指定 domain、region、 instance,、type 其中之一或多个, 多个使用英文逗号（,）分隔.。指定了 split 的字段将会被分组输出。

说明 若参数为空, 则只输出按照聚合后数据.
type
StartTimestring否

开始时间。日期格式按照 ISO8601 表示法，并使用 UTC+0 时间，格式为 yyyy-MM-ddTHH:mm:ssZ。

2018-09-30T16:00:00Z
EndTimestring否

结束时间。日期格式按照 ISO8601 表示法，并使用 UTC+0 时间，格式为 yyyy-MM-ddTHH:mm:ssZ。

说明 结束时间需大于起始时间。
2018-10-31T15:59:59Z
Intervalstring否

指定查询数据的时间粒度，支持 3600（1 小时）和 86400（1 天）的取值。单位：秒。

3600
appstring否

播流所属应用名称。

liveApp****

返回参数

名称类型描述示例值
object
BillProducerDataarray<object>

用户导播台用量数据。

BillProducerDataItemobject
DomainNamestring

用量域名。SplitBy 指定为 domain 时，分组输出。

example.com
Instancestring

用量实例。SplitBy 指定为 instance 时，分组输出。

a17d0184-462d-4630-b2a6-8c26dde2****
OutputHdDurationlong

高清分辨率时长，单位为分钟。

6000
OutputLdDurationlong

流畅分辨率时长，单位为分钟。

1001
OutputSdDurationlong

标准分辨率时长，单位为分钟。

500
Regionstring

用量地区。SplitBy 指定为 region 时，分组输出。

cn-shanghai
TimeStampstring

时间片起始时刻。

2018-09-30T00:00:00Z
TranHdDurationlong

转码高清分辨率时长，单位为分钟。

6777
TranLdDurationlong

转码流畅分辨率时长，单位为分钟。

111
TranSdDurationlong

转码标准分辨率时长，单位为分钟。

666
Typestring

导播类型。SplitBy 指定为 type 时，分组输出。

slidelive
EndTimestring

结束时间。

2018-09-30T16:00:00Z
RequestIdstring

请求 ID。

C370DAF1-C838-4288-A1A0-9A87633D248E
StartTimestring

开始时间。

2018-10-31T15:59:59Z

示例

正常返回示例

JSON格式

{
  "BillProducerData": {
    "BillProducerDataItem": [
      {
        "DomainName": "example.com",
        "Instance": "a17d0184-462d-4630-b2a6-8c26dde2****",
        "OutputHdDuration": 6000,
        "OutputLdDuration": 1001,
        "OutputSdDuration": 500,
        "Region": "cn-shanghai",
        "TimeStamp": "2018-09-30T00:00:00Z",
        "TranHdDuration": 6777,
        "TranLdDuration": 111,
        "TranSdDuration": 666,
        "Type": "slidelive"
      }
    ]
  },
  "EndTime": "2018-09-30T16:00:00Z",
  "RequestId": "C370DAF1-C838-4288-A1A0-9A87633D248E",
  "StartTime": "2018-10-31T15:59:59Z"
}

错误码

HTTP status code错误码错误信息描述
400InvalidStartTime.MalformedSpecified StartTime is malformed.StartTime参数错误，请您确认该StartTime参数是否正确。
400InvalidEndTime.MalformedSpecified EndTime is malformed.结束时间错误，请您确认结束时间是否正确。
400InvalidTime.MalformedSpecified StartTime or EndTime is malformed.-
400InvalidEndTime.MismatchSpecified end time does not math the specified start time.结束时间与开始时间不匹配，请您确认时间的匹配度。
400InvalidTimeSpanThe time span exceeds the limit.时间跨度超过限制，请参照接口文档，配置合理查询跨度。
400InvalidTime.ValueNotSupportedSpecified Time is malformed.指定的时间无效。

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

变更历史

变更时间变更内容概要操作
暂无变更历史

示例 2： splitBy=type

请求示例

http://live.aliyuncs.com?Action=DescribeLiveProducerUsageData  
&StartTime=2018-09-30T16:00:00Z  
&EndTime=2018-10-31T15:59:59Z  
&SplitBy=type  
&<公共请求参数>

正常返回示例

XML格式

<DescribeLiveProducerUsageDataResponse>
    <RequestId>C370DAF1-C838-4288-A1A0-9A87633D248E</RequestId>
    <EndTime>2018-09-30T16:00:00Z</EndTime>
    <StartTime>2018-10-31T15:59:59Z</StartTime>
    <BillProducerData>
        <BillProducerDataItem>
            <Type>universal</Type>
            <OutputLdDuration>1001</OutputLdDuration>
            <OutputSdDuration>500</OutputSdDuration>
            <OutputHdDuration>6000</OutputHdDuration>
            <TranLdDuration>111</TranLdDuration>
            <TranSdDuration>666</TranSdDuration>
            <TranHdDuration>6777</TranHdDuration>
            <TimeStamp>2018-09-30T00:00:00Z</TimeStamp>
        </BillProducerDataItem>
        <BillProducerDataItem>
            <Type>slidelive</Type>
            <OutputLdDuration>1001</OutputLdDuration>
            <OutputSdDuration>500</OutputSdDuration>
            <OutputHdDuration>6000</OutputHdDuration>
            <TranLdDuration>111</TranLdDuration>
            <TranSdDuration>666</TranSdDuration>
            <TranHdDuration>6777</TranHdDuration>
            <TimeStamp>2018-09-30T00:00:00Z</TimeStamp>
        </BillProducerDataItem>
        <BillProducerDataItem>
            <Type>universal</Type>
            <OutputLdDuration>1001</OutputLdDuration>
            <OutputSdDuration>500</OutputSdDuration>
            <OutputHdDuration>6000</OutputHdDuration>
            <TranLdDuration>111</TranLdDuration>
            <TranSdDuration>666</TranSdDuration>
            <TranHdDuration>6777</TranHdDuration>
            <TimeStamp>2018-10-01T00:00:00Z</TimeStamp>
        </BillProducerDataItem>
        <BillProducerDataItem>
            <Type>slidelive</Type>
            <OutputLdDuration>1001</OutputLdDuration>
            <OutputSdDuration>500</OutputSdDuration>
            <OutputHdDuration>6000</OutputHdDuration>
            <TranLdDuration>111</TranLdDuration>
            <TranSdDuration>666</TranSdDuration>
            <TranHdDuration>6777</TranHdDuration>
            <TimeStamp>2018-10-01T00:00:00Z</TimeStamp>
        </BillProducerDataItem>
        <BillProducerDataItem>
            <Type>universal</Type>
            <OutputLdDuration>1001</OutputLdDuration>
            <OutputSdDuration>500</OutputSdDuration>
            <OutputHdDuration>6000</OutputHdDuration>
            <TranLdDuration>111</TranLdDuration>
            <TranSdDuration>666</TranSdDuration>
            <TranHdDuration>6777</TranHdDuration>
            <TimeStamp>2018-10-02T00:00:00Z</TimeStamp>
        </BillProducerDataItem>
        <BillProducerDataItem>
            <Type>slidelive</Type>
            <OutputLdDuration>1001</OutputLdDuration>
            <OutputSdDuration>500</OutputSdDuration>
            <OutputHdDuration>6000</OutputHdDuration>
            <TranLdDuration>111</TranLdDuration>
            <TranSdDuration>666</TranSdDuration>
            <TranHdDuration>6777</TranHdDuration>
            <TimeStamp>2018-10-02T00:00:00Z</TimeStamp>
        </BillProducerDataItem>
    </BillProducerData>
</DescribeLiveProducerUsageDataResponse>

JSON格式

{
  "RequestId": "C370DAF1-C838-4288-A1A0-9A87633D248E",
  "EndTime": "2018-09-30T16:00:00Z",
  "StartTime": "2018-10-31T15:59:59Z",
  "BillProducerData": {
    "BillProducerDataItem": [
    {
      "Type": "universal",
      "OutputLdDuration": 1001,
      "OutputSdDuration": 500,
      "OutputHdDuration": 6000,
      "TranLdDuration": 111,
      "TranSdDuration": 666,
      "TranHdDuration": 6777,
      "TimeStamp": "2018-09-30T00:00:00Z"
    }, {
      "Type": "slidelive",
      "OutputLdDuration": 1001,
      "OutputSdDuration": 500,
      "OutputHdDuration": 6000,
      "TranLdDuration": 111,
      "TranSdDuration": 666,
      "TranHdDuration": 6777,
      "TimeStamp": "2018-09-30T00:00:00Z"
    },{
      "Type": "universal",
      "OutputLdDuration": 1001,
      "OutputSdDuration": 500,
      "OutputHdDuration": 6000,
      "TranLdDuration": 111,
      "TranSdDuration": 666,
      "TranHdDuration": 6777,
      "TimeStamp": "2018-10-01T00:00:00Z"
    },{
      "Type": "slidelive",
      "OutputLdDuration": 1001,
      "OutputSdDuration": 500,
      "OutputHdDuration": 6000,
      "TranLdDuration": 111,
      "TranSdDuration": 666,
      "TranHdDuration": 6777,
      "TimeStamp": "2018-10-01T00:00:00Z"
    },{
      "Type": "universal",
      "OutputLdDuration": 1001,
      "OutputSdDuration": 500,
      "OutputHdDuration": 6000,
      "TranLdDuration": 111,
      "TranSdDuration": 666,
      "TranHdDuration": 6777,
      "TimeStamp": "2018-10-02T00:00:00Z"
    },{
      "Type": "slidelive",
      "OutputLdDuration": 1001,
      "OutputSdDuration": 500,
      "OutputHdDuration": 6000,
      "TranLdDuration": 111,
      "TranSdDuration": 666,
      "TranHdDuration": 6777,
      "TimeStamp": "2018-10-02T00:00:00Z"
    }]
  }
}
上一篇：DescribeLiveDomainStreamTranscodeData - 查询域名转码用量数据下一篇：DescribeLiveDomainMonitoringUsageData - 获取域名广目监播用量