全部产品
Search
文档中心

视频点播:DescribeVodDomainMax95BpsData - 查询95带宽峰值

更新时间:Dec 16, 2024

调用本接口查询加速域名95带宽峰值监控数据。

接口说明

分三种方式查询:

  • 当同时指定 StartTime 和 EndTime 时,若 EndTime 与 StartTime 差值在 24 小时内,则查询 StartTime 所在当天的 95 峰值,否则查询 StartTime 所在月份的 95 峰值。

  • 当同时指定 TimePoint 和 Cycle 时,返回 TimePoint 所在周期的 95 峰值。

  • 当指定 StartTime 和 EndTime 时,若额外指定了 Cycle,可以返回查询范围内所有指定 cycle 对应的 95 峰值。

当这三种方式都不指定时,默认返回过去 24 小时的 95 峰值。

  • 数据最大查询跨度:90 天

  • 数据最小查询粒度:1 天

  • 数据最大查询范围:90 天

  • 单用户调用频率:100 次/秒。

  • 获取数据单位:bit/s。

调试

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

授权信息

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

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

请求参数

名称类型必填描述示例值
DomainNamestring

需要查询的加速域名。若参数为空,默认返回所有加速域名合并后的数据。

说明 不支持批量域名查询
example.com
StartTimestring

获取起始时间点。

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

2017-01-11T12:00:00Z
EndTimestring

获取结束时间点。

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

说明 结束时间需大于起始时间。
2017-01-12T13:00:00Z
TimePointstring

获取数据起始时间点。

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

2017-12-21T10:00:00Z
Cyclestring

95 带宽峰值周期,默认值为 day。取值:

  • day:按日查询 95 峰值。

  • month:按月查询 95 峰值。

month

返回参数

名称类型描述示例值
object
RequestIdstring

请求 ID。

25818875-5F78-4A*****F6-D7393642CA58
DomainNamestring

加速域名信息

example.com
EndTimestring

数据的结束时间点。

2017-01-11T13:00:00Z
StartTimestring

数据的起始时间点。

2017-01-11T12:00:00Z
DomesticMax95Bpsstring

中国内地 95 带宽峰值。

16777590.28
OverseasMax95Bpsstring

全球(不含中国内地)95 带宽峰值。

0
Max95Bpsstring

95 带宽峰值。

16777590.28
DetailDataarray<object>

95 带宽明细数据。

Max95Detailobject
TimeStampstring

时间片起始时刻。

2024-01-18 10:11:32
Areastring

95 带宽对应的区域。

CN
Max95BpsPeakTimestring

95 带宽峰值时间。

2015-12-11T21:05:00Z
Max95Bpsfloat

95 带宽峰值。

16777590.28

示例

正常返回示例

JSON格式

{
  "RequestId": "25818875-5F78-4A*****F6-D7393642CA58",
  "DomainName": "example.com",
  "EndTime": "2017-01-11T13:00:00Z",
  "StartTime": "2017-01-11T12:00:00Z",
  "DomesticMax95Bps": "16777590.28\n",
  "OverseasMax95Bps": "0",
  "Max95Bps": "16777590.28\n",
  "DetailData": {
    "Max95Detail": [
      {
        "TimeStamp": "2024-01-18 10:11:32",
        "Area": "CN",
        "Max95BpsPeakTime": "2015-12-11T21:05:00Z\n",
        "Max95Bps": 16777590.28
      }
    ]
  }
}

错误码

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