DescribeUserBandWidthData - 边缘节点服务ENS

调试

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

请求参数


名称	类型	是否必选	示例值	描述
Action	String	是	DescribeUserBandWidthData	系统规定参数，取值：DescribeUserBandWidthData。
Period	String	是	300	获取监控数据的精度，取值：300（默认值）、1200、3600、14400，单位：秒。
Version	String	是	2017-11-10	版本号。
StartTime	String	是	2019-05-21T10:22:00Z	获取数据的起始时间点。按照ISO8601标准表示，并需要使用UTC时间，格式为yyyy-MM-ddTHH:mm:ssZ。如果秒不是00，则自动取为下一分钟开始时。
EndTime	String	是	2019-05-21T12:22:00Z	获取数据的结束时间点。按照ISO8601标准表示，并需要使用UTC时间，格式为yyyy-MM-ddTHH:mm:ssZ。如果秒不是00，则自动取为下一分钟开始时。
EnsRegionId	String	否	cn-taiyuan-telecom	节点ID，仅支持传单个ID，默认查询所有节点。
InstanceId	String	否	i-5inkeimcipxk26yqtzm4q****	获取指定数据的实例ID，仅支持传单个ID，默认查询所有实例。

返回数据


名称	类型	示例值	描述
Code	Integer	0	业务返回码，成功返回0。
MonitorData	Struct		监控数据信息。
BandWidthMonitorData	Array		带宽监控数据。
DownBandWidth	Integer	0	下行带宽，单位：bit/s。
InternetRX	Integer	0	实例接收的公网数据流量，单位：bits。
InternetTX	Integer	0	实例发送的公网数据流量，单位：bits。
TimeStamp	String	2019-10-12T05:45:00Z	查询监控信息的时间戳，UTC时间，格式为yyyy-MM-DDThh:mm:ssZ。
UpBandWidth	Integer	0	上行带宽，单位：bit/s。
MaxDownBandWidth	String	16817468	查询时间范围内最大下行带宽，单位：bit/s。
MaxUpBandWidth	String	231008	查询时间范围内最大上行带宽，单位：bit/s。
RequestId	String	50373E71-7710-4620-8AAB-133CCE49451C	请求ID。

示例

请求示例

https://ens.aliyuncs.com/?Action=DescribeUserBandWidthData
&StartTime=2014-10-29T23:00:00Z
&EndTime=2014-10-30T08:00:00Z
&Version=2017-11-10
&Period=300
&<公共请求参数>

正常返回示例

XML 格式

<DescribeUserBandWidthDataResponse>
  <code>200</code>
      <RequestId>50373E71-7710-4620-8AAB-133CCE49451C</RequestId>
      <MonitorData>
            <MaxDownBandWidth>16817468</MaxDownBandWidth>
            <MaxUpBandWidth>231008</MaxUpBandWidth>
            <BandWidthMonitorData>
                  <UpBandWidth>0</UpBandWidth>
                  <DownBandWidth>0</DownBandWidth>
                  <InternetTX>0</InternetTX>
                  <InternetRX>0</InternetRX>
                  <TimeStamp>2019-10-12T05:45:00Z</TimeStamp>
            </BandWidthMonitorData>
      </MonitorData>
      <Code>0</Code>
  <requestId>50373E71-7710-4620-8AAB-133CCE49451C</requestId>
  <successResponse>true</successResponse>
</DescribeUserBandWidthDataResponse>

JSON 格式

{
    "code":"200",
        "RequestId":"50373E71-7710-4620-8AAB-133CCE49451C",
        "MonitorData":{
            "MaxDownBandWidth":16817468,
            "MaxUpBandWidth":231008,
            "BandWidthMonitorData":[
                {
                    "UpBandWidth":0,
                    "DownBandWidth":0,
                    "InternetTX":0,
                    "InternetRX":0,
                    "TimeStamp":"2019-10-12T05:45:00Z"
                }
            ]
        },
        "Code":0,
    "requestId":"50373E71-7710-4620-8AAB-133CCE49451C",
    "successResponse":true
}

错误码

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