开发者社区 问答 正文

如何获取加速域名95带宽峰值监控数据?



DescribeDomainMax95BpsData



描述


获取加速域名95带宽峰值监控数据,单位bit/second
不指定StartTime和EndTime时,默认读取过去24小时的数据,同时支持按指定的起止时间查询,两者需要同时指定。

  • 支持批量域名查询,多个域名用逗号(半角)分隔
  • 最多可获取最近90天的数据


请求参数

参数类型必要描述
ActionString操作接口名,系统规定参数取值:DescribeDomainMax95BpsData
DomainNameString若参数为空,默认返回所有加速域名合并后数据可输入需要查询的加速域名支持批量域名查询,多个域名用逗号(半角)分隔
StartTimeString获取数据起始时间点,日期格式按照ISO8601表示法,并使用UTC时间。格式为:YYYY-MM-DDThh:mmZ最小数据粒度为5分钟不写默认读取过去24小时数据
EndTimeString结束时间需大于起始时间;获日期格式按照ISO8601表示法,并使用UTC时间。格式为:YYYY-MM-DDThh:mmZ


返回参数

名称类型描述
DomainNameString加速域名信息
StartTimeDateTime开始时间
EndTimeDateTime结束时间
Max95BpsString95带宽峰值
DomesticMax95BpsString国内95带宽峰值
OverseasMax95BpsString海外95带宽峰值


特殊错误码

错误代码描述Http 状态码语义
InvalidDomain.NotFoundThe domain provided does not belong to you.404域名不存在或不属于当前用户
MissingParameterStartTime and EndTime can not be single.400StartTime和EndTime不能单独设置
InvalidStartTime.MalformedSpecified start time is malformed.400StartTime格式错误
InvalidEndTime.MalformedSpecified end time is malformed.400EndTime格式错误
InvalidEndTime.MismatchSpecified end time does not math the specified start time.400EndTime小于StartTime
InvalidStartTime.ValueNotSupportedSpecified end time does not math the specified start time.400EndTime和StartTime差值超过90天


示例


请求示例: http://cdn.aliyuncs.com?Action=DescribeDomainMax95BpsData&DomainName=test.com
&StartTime=2015-12-10T20:00Z
&EndTime=2015-12-10T21:00Z
&<公共请求参数>


返回示例:
JSON格式 {
    "DomainName": "test.com",
    "RequestId": "3C6CCEC4-6B88-4D4A-93E4-D47B3D92CF8F",
    "StartTime": "2015-12-10T20:00Z",
    "EndTime": "2015-12-10T21:00Z",
    "Max95Bps": "16777590.28",
    "DomesticMax95Bps": "16777590.28",
    "OverseasMax95Bps": "0"
}

展开
收起
青衫无名 2017-10-24 11:26:10 3022 分享 版权
阿里云 AI 助理回答

DescribeDomainMax95BpsData 是阿里云CDN(Content Delivery Network)服务中的一个API操作,用于获取指定加速域名在特定时间范围内的95带宽峰值监控数据。这个指标反映的是网络流量的稳定性,即在统计周期内,有95%的时间带宽使用量都不超过这个峰值。这对于评估网站或应用的带宽需求、优化成本以及确保用户体验非常有用。下面是关于此API的详细说明:

请求参数

  • Action: 必填参数,固定值为DescribeDomainMax95BpsData,表示请求的操作类型。
  • DomainName: 可选参数,用来指定需要查询的加速域名。如果不提供,则默认返回所有加速域名合并后的数据。支持批量查询,多个域名间用半角逗号分隔。
  • StartTime: 可选参数,用于设定获取数据的起始时间点,遵循ISO8601格式(YYYY-MM-DDThh:mmZ),并采用UTC时间。不指定时,默认为过去24小时的数据。最小时间粒度为5分钟。
  • EndTime: 可选参数,与StartTime配合使用,设定数据获取的结束时间点,格式同StartTime。要求EndTime必须大于StartTime,并且两者需同时指定,否则会报错。

返回参数

  • DomainName: 加速域名信息。
  • StartTime: 查询数据的开始时间。
  • EndTime: 查询数据的结束时间。
  • Max95Bps: 95带宽峰值,单位为bit/second。
  • DomesticMax95Bps: 国内95带宽峰值。
  • OverseasMax95Bps: 海外95带宽峰值。

特殊错误码

列举了一些常见的错误代码及其描述,帮助用户理解可能遇到的错误情况及原因。

示例

请求示例展示了如何构造URL来调用此API,例如:

http://cdn.aliyuncs.com?Action=DescribeDomainMax95BpsData

实际使用中,根据需要,你可能还需要添加其他参数如DomainName, StartTime, 和 EndTime 来细化请求。

请注意,调用阿里云API通常需要进行身份验证,包括设置AccessKeyId、Signature等头部信息,这些在实际HTTP请求中是必不可少的,但未在上述示例中展示。具体签名和认证流程可以参考阿里云官方文档中关于CDN API调用的指南。

有帮助
无帮助
AI 助理回答生成答案可能存在不准确,仅供参考
0 条回答
写回答
取消 提交回答