调用DescribeLiveRealtimeDeliveryAcc查询实时日志投递次数。

使用说明

  • 可以统计实时日志投递次数信息。统计实时日志投递失败次数和实时日志投递成功次数。
  • 支持UID维度查询。
  • 收费次数包含投递成功和失败的全部次数。

QPS限制

本接口的单用户QPS限制为100次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。更多信息,请参见QPS限制

调试

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

请求参数

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

系统规定参数。取值:

DescribeLiveRealtimeDeliveryAcc

RegionId String cn-shanghai

地域ID。

StartTime String 2015-12-10T20:00:00Z

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

EndTime String 2015-12-10T21:05:00Z

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

结束时间需大于起始时间。起止时间和结束时间,间隔不超过一年。

Interval String 3600

查询数据的时间粒度。单位:秒(s)。取值:

  • 300
  • 3600
  • 86400

不传或传的值不支持,且时间跨度不超过3天时,默认值300秒。超过3天默认值3600秒。超过30天默认值86400秒。

Project String project_example

实时日志投递的Project。

LogStore String logstore_example

实时日志投递的Logstore。

DomainName String example.com

播流域名。

返回数据

名称 类型 示例值 描述
RealTimeDeliveryAccData Array of AccData

实时日志投递次数信息。

AccData
FailedNum Integer 0

实时日志投递失败次数。

SuccessNum Integer 321321

实时日志投递成功次数。

TimeStamp String 2015-12-10T20:00:00Z

时间片起始时刻。

RequestId String 684306D2-2511-4977-991D-CE97E91FD7C0

请求ID。

示例

请求示例

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

正常返回示例

XML格式

<DescribeLiveRealtimeDeliveryAccResponse>
  <RealTimeDeliveryAccData>
        <AccData>
              <SuccessNum>321321</SuccessNum>
              <FailedNum>0</FailedNum>
              <TimeStamp>2015-12-10T20:00:00Z</TimeStamp>
        </AccData>
  </RealTimeDeliveryAccData>
  <RequestId>684306D2-2511-4977-991D-CE97E91FD7C0</RequestId>
</DescribeLiveRealtimeDeliveryAccResponse>

JSON格式

{
    "DescribeLiveRealtimeDeliveryAccResponse": {
        "RealTimeDeliveryAccData": {
            "AccData": {
                "SuccessNum": 321321,
                "FailedNum": 0,
                "TimeStamp": "2015-12-10T20:00:00Z"
            }
        },
        "RequestId": "684306D2-2511-4977-991D-CE97E91FD7C0"
    }
}

错误码

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

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

特殊错误码

错误代码

描述

HTTP 状态码

语义

InvalidStartTime.ValueNotSupported

The specified value of parameter StartTime is not supported.

400

EndTime和StartTime差值超过90天。

InvalidEndTime.Mismatch

Specified EndTime does not math the specified StartTime.

400

EndTime小于StartTime