调用DescribeVsTopDomainsByFlow获取顶级域名_视图计算(VECS)-阿里云帮助中心

获取用户按流量排名的域名不指定StartTime和EndTime时，默认读取当月的数据，同时支持按指定的起止时间查询，两者需要同时指定。 * 最多可获取90天的数据。

调试

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

授权信息

当前API暂无授权信息透出。

请求参数

名称	类型	必填	描述	示例值
StartTime	string	否	获取数据起始时间点，日期格式按照 ISO8601 表示法，并使用 UTC 时间。格式为：YYYY-MM-DDThh:mm:ssZ 最小数据粒度为 5 分钟不写默认读取当月数据	2021-12-12T10:00:00Z
EndTime	string	否	结束时间需大于起始时间；获日期格式按照 ISO8601 表示法，并使用 UTC 时间。格式为：YYYY-MM-DDThh:mm:ssZ	2018-12-10T18:00:00Z
Limit	long	否	域名获取数量限制，默认为 20，取值支持 1~100	3

返回参数

名称	类型	描述	示例值
	object
DomainOnlineCount	long	账户下正在运行的域名总数。	12
EndTime	string	按结束时间查询。	2018-12-10T18:00:00Z
StartTime	string	按开始时间查询。	2021-12-10T10:00:00Z
RequestId	string	本次操作请求 ID	BEA5625F-8FCF-48F4-851B-CA63946DA664
DomainCount	long	账号下的域名总数。	20
TopDomains	object []	域名列表。
MaxBps	long	带宽峰值。	100
Rank	long	排名。	1
TotalAccess	long	访问次数。	100
TrafficPercent	string	流量占比。	30.64191989360235
DomainName	string	域名。	example.aliyundoc.com
TotalTraffic	string	总流量。	100
MaxBpsTime	string	带宽峰值时刻。	1457111400

示例

正常返回示例

JSON格式

{
  "DomainOnlineCount": 12,
  "EndTime": "2018-12-10T18:00:00Z",
  "StartTime": "2021-12-10T10:00:00Z",
  "RequestId": "BEA5625F-8FCF-48F4-851B-CA63946DA664",
  "DomainCount": 20,
  "TopDomains": {
    "TopDomain": [
      {
        "MaxBps": 100,
        "Rank": 1,
        "TotalAccess": 100,
        "TrafficPercent": "30.64191989360235",
        "DomainName": "example.aliyundoc.com",
        "TotalTraffic": "100",
        "MaxBpsTime": "1457111400"
      }
    ]
  }
}

错误码

HTTP status code	错误码	错误信息	描述
400	InvalidStartTime.Malformed	The format of the specified StartTime is invalid.	开始时间格式不对
400	InvalidEndTime.Malformed	The format of the specified EndTime is invalid.	截止时间格式不对
400	InvalidEndTime.Mismatch	The specified EndTime is earlier than the StartTime.	结束时间早于开始时间，请检查
400	InvalidStartTime.ValueNotSupported	The specified StartTime is invalid.	不支持该开始时间

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