产品动态
安全公告
产品公告
DimensionName参数用于指定返回数据中的分组维度，以实现一次查询获取多个分组数据的效果，可以极大程度上减少 API 调用频次，简化您获取统计数据的操作。例如：在某次调用中入参 DimensionName = domain，则返回数据将按照每个域名单独返回一组数据。DimensionName 与 Filters 参数，实现高效、灵活的数据获取。在涉及大量域名或精细状态码的查询时，建议优先使用 Filters进行预筛选，并选择合适的查询粒度（Interval）。{"ZoneIds": ["*"],"MetricNames": ["l7Flow_inFlux_hy"],"StartTime": "2025-12-01T00:00:00Z","EndTime": "2025-12-02T00:00:00Z","Interval": "hour","Filters": [{"Key": "domain","Operator": "equals","Value": ["example.com", "api.example.com"]}],"DimensionName": "domain"}
{"ZoneIds": ["*"],"MetricNames": ["l7Flow_request_hy"],"StartTime": "2025-12-01T00:00:00Z","EndTime": "2025-12-01T12:00:00Z","Interval": "hour","Filters": [{"Key": "originStatusCode","Operator": "equals","Value": ["2xx", "4xx", "5xx"]}],"DimensionName": "origin-status-code-category"}
TimingDataItem。数据项总数的计算规则如下：指标个数 * 时间点个数 * 维度值个数 = 数据项总数
MetricNames的列表长度。(EndTime - StartTime) / Interval。DimensionName 时，默认按账号维度汇总数据，维度值个数为 1。DimensionName = domain 时，维度值个数为 Filters 中 domain 过滤条件指定的域名列表长度。DimensionName = origin-status-code-category 时，维度值个数默认为 6。DimensionName = origin-status-code 时，维度值个数默认为 600。DimensionName 可以与 Filters 组合使用，通过在 Filters 中指定 DimensionName 对应的过滤条件以限制维度值个数。MetricNames = ["l7Flow_request_hy"]（指标个数 = 1）StartTime = 2025-10-01T06:00:00+08:00，EndTime = 2025-10-01T06:59:59+08:00，Interval = "min"（时间点个数 = 60）DimensionName = origin-status-code，Filters = [{"originStatusCode": ["0", "4xx", "5xx"]}]（维度值个数 = 201）1 × 60 × 201 = 12060
LimitExceeded.TimingDataItemLimitExceeded。StartTime 到 EndTime 之间的时间跨度）。Interval）。Filters，指定更少的 domain 或 originStatusCode 列表。MetricNames，指定更少的查询指标。文档反馈