You need to enable JavaScript to run this app.
文档中心
全站加速

全站加速

复制全文
下载 pdf
数据监控接口
查询回源资源概况 DescribeOriginStatistics
复制全文
下载 pdf
查询回源资源概况 DescribeOriginStatistics

查询回源资源概况。

请求说明

  • 请求方式:POST
  • 请求地址:https://open.volcengineapi.com?Action=DescribeOriginStatistics&Version=2021-04-01

请求参数

Query

参数名称
数据类型
是否必选
参数说明
Action
String
接口名称。当前 API 的名称为 DescribeOriginStatistics
Version
String
接口版本。当前 API 的版本为 2021-04-01

Body

参数名称
数据类型
是否必选
参数说明
示例
StartTime
String
查询起始时间。您可以查询过去90天内的数据。查询时间跨度(StartTime和EndTime之间时长)不能超过31天。基于您指定的时间跨度,您可以选择数据样本的时间粒度(Interval 参数)会相应不同。
2021-01-01 00:00:00
EndTime
String
查询结束时间,结束时间大于起始时间。
2021-01-01 23:59:59
Metrics
String[]

指定返回的监控指标,支持取值:

  • all:全部指标。
  • traffic:流量,单位为 byte。
  • bandwidth:峰值带宽,单位为 bps。
  • request:请求数。
  • QPS:峰值QPS。
  • 2xx:返回 2xx 状态码的请求数。返回结果会提供 2xx 状态码总请求数以及单个 2xx 状态码的总请求数。
  • 3xx:返回 3xx 状态码的请求数。返回结果会提供 3xx 状态码总请求数以及单个 3xx 状态码的总请求数。
  • 4xx:返回 4xx 状态码的请求数。返回结果会提供 4xx 状态码总请求数以及单个 4xx 状态码的总请求数。
  • 5xx:返回 5xx 状态码的请求数。返回结果会提供 5xx 状态码总请求数以及单个 5xx 状态码的总请求数。
["bandwidth","traffic","5xx"]
Domains
String[]
指定查询域名列表。为空时代表查询当前用户所有域名。
["example.com"]
Interval
Integer

时间粒度,单位为秒 。支持取值:

  • 查询时间段跨度 3 天以内(不含3):支持 300360086400。不传该参数时,默认值为300
  • 查询时间段跨度 3 - 31 天(不含31): 支持 360086400。不传该参数时,默认值为 3600
  • 查询时间段跨度 31 天: 支持 86400。不传该参数,默认值为 86400
300
Protocol
String[]

指定客户端请求应用层和传输层协议查询,为空时表示查询所有协议,支持取值:

  • ALL:全部协议
  • HTTP:HTTP协议
  • HTTPS:HTTPS协议
  • QUIC:QUIC协议
  • WS:WebSocket协议
["HTTP","HTTPS"]
Type
String

指定访问请求类型,为空时表示查询所有类型(相当于all)。支持取值:

  • all:所有类型。
  • dynamic:仅查询动态请求对应指标。
  • static:仅查询静态请求对应指标。
all
IPVersion
String

指定IP协议类型查询。为空时表示查询所有类型,支持取值:

  • all:所有类型。
  • ipv4:通过 IPv4 访问DCDN的请求
  • ipv6:通过 IPv6 访问DCDN的请求
ipv4
ProjectName
String[]
指定域名所属的项目,为空时表示查询当前用户所有项目。
["test"]

返回参数

参数名称
数据类型
参数说明
示例
DomainCount
Integer
查询域名中有效域名的数量。
20
StartTime
String
查询起始时间。
2021-01-01 00:00:00
EndTime
String
查询结束时间。
2021-01-01 23:59:59
Metrics
String[]
回显查询时选择展示的统计指标。
["bandwidth"]
Results
Object[]
查询数据明细。

请求示例

POST https://open.volcengineapi.com?Action=DescribeOriginStatistics&Version=2021-04-01
{
    "StartTime": "2021-12-02 16:39:49",
    "EndTime": "2021-12-02 16:49:49",
    "Domains": [
        "www.bytedance.com"
    ],
    "Metrics": [
        "all"
    ],
    "Interval": 300,
    "Type": "dynamic"
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "202506041157509435888DA1CA3F9D3E02",
        "Action": "DescribeOriginStatistics",
        "Version": "2021-04-01",
        "Service": "DCDN",
        "Region": "cn-north-01"
    },
    "Result": {
        "DomainCount": 78,
        "StartTime": "2025-03-15 00:00:00",
        "EndTime": "2025-03-15 00:20:00",
        "Metrics": [
            "all"
        ],
        "Results": [
            {
                "TimeStamp": "2025-03-15 00:00:00",
                "DetailInfo": [
                    {
                        "Name": "1xx",
                        "Value": 0
                    },
                    {
                        "Name": "101",
                        "Value": 0
                    },
                    {
                        "Name": "102",
                        "Value": 0
                    },
                    {
                        "Name": "100",
                        "Value": 0
                    },
                    {
                        "Name": "2xx",
                        "Value": 0
                    },
                    {
                        "Name": "200",
                        "Value": 0
                    },
                    {
                        "Name": "201",
                        "Value": 0
                    },
                    {
                        "Name": "206",
                        "Value": 0
                    },
                    {
                        "Name": "3xx",
                        "Value": 0
                    },
                    {
                        "Name": "301",
                        "Value": 0
                    },
                    {
                        "Name": "302",
                        "Value": 0
                    },
                    {
                        "Name": "4xx",
                        "Value": 0
                    },
                    {
                        "Name": "400",
                        "Value": 0
                    },
                    {
                        "Name": "403",
                        "Value": 0
                    },
                    {
                        "Name": "404",
                        "Value": 0
                    },
                    {
                        "Name": "499",
                        "Value": 0
                    },
                    {
                        "Name": "401",
                        "Value": 0
                    },
                    {
                        "Name": "5xx",
                        "Value": 0
                    },
                    {
                        "Name": "500",
                        "Value": 0
                    },
                    {
                        "Name": "502",
                        "Value": 0
                    },
                    {
                        "Name": "533",
                        "Value": 0
                    },
                    {
                        "Name": "504",
                        "Value": 0
                    },
                    {
                        "Name": "505",
                        "Value": 0
                    },
                    {
                        "Name": "530",
                        "Value": 0
                    },
                    {
                        "Name": "531",
                        "Value": 0
                    },
                    {
                        "Name": "532",
                        "Value": 0
                    },
                    {
                        "Name": "Traffic",
                        "Value": 0
                    },
                    {
                        "Name": "Request",
                        "Value": 0
                    },
                    {
                        "Name": "QPS",
                        "Value": 0
                    },
                    {
                        "Name": "Bandwidth",
                        "Value": 0
                    }
                ]
            },
            {
                "TimeStamp": "2025-03-15 00:05:00",
                "DetailInfo": [
                    {
                        "Name": "Traffic",
                        "Value": 861
                    },
                    {
                        "Name": "Request",
                        "Value": 1
                    },
                    {
                        "Name": "QPS",
                        "Value": 0.0033333333333333335
                    },
                    {
                        "Name": "Bandwidth",
                        "Value": 22.96
                    },
                    {
                        "Name": "1xx",
                        "Value": 0
                    },
                    {
                        "Name": "101",
                        "Value": 0
                    },
                    {
                        "Name": "102",
                        "Value": 0
                    },
                    {
                        "Name": "100",
                        "Value": 0
                    },
                    {
                        "Name": "2xx",
                        "Value": 0
                    },
                    {
                        "Name": "200",
                        "Value": 0
                    },
                    {
                        "Name": "201",
                        "Value": 0
                    },
                    {
                        "Name": "206",
                        "Value": 0
                    },
                    {
                        "Name": "3xx",
                        "Value": 0
                    },
                    {
                        "Name": "301",
                        "Value": 0
                    },
                    {
                        "Name": "302",
                        "Value": 0
                    },
                    {
                        "Name": "4xx",
                        "Value": 1
                    },
                    {
                        "Name": "400",
                        "Value": 0
                    },
                    {
                        "Name": "403",
                        "Value": 0
                    },
                    {
                        "Name": "404",
                        "Value": 1
                    },
                    {
                        "Name": "499",
                        "Value": 0
                    },
                    {
                        "Name": "401",
                        "Value": 0
                    },
                    {
                        "Name": "5xx",
                        "Value": 0
                    },
                    {
                        "Name": "500",
                        "Value": 0
                    },
                    {
                        "Name": "502",
                        "Value": 0
                    },
                    {
                        "Name": "533",
                        "Value": 0
                    },
                    {
                        "Name": "504",
                        "Value": 0
                    },
                    {
                        "Name": "505",
                        "Value": 0
                    },
                    {
                        "Name": "530",
                        "Value": 0
                    },
                    {
                        "Name": "531",
                        "Value": 0
                    },
                    {
                        "Name": "532",
                        "Value": 0
                    }
                ]
            },
            {
                "TimeStamp": "2025-03-15 00:10:00",
                "DetailInfo": [
                    {
                        "Name": "1xx",
                        "Value": 0
                    },
                    {
                        "Name": "101",
                        "Value": 0
                    },
                    {
                        "Name": "102",
                        "Value": 0
                    },
                    {
                        "Name": "100",
                        "Value": 0
                    },
                    {
                        "Name": "2xx",
                        "Value": 0
                    },
                    {
                        "Name": "200",
                        "Value": 0
                    },
                    {
                        "Name": "201",
                        "Value": 0
                    },
                    {
                        "Name": "206",
                        "Value": 0
                    },
                    {
                        "Name": "3xx",
                        "Value": 0
                    },
                    {
                        "Name": "301",
                        "Value": 0
                    },
                    {
                        "Name": "302",
                        "Value": 0
                    },
                    {
                        "Name": "4xx",
                        "Value": 0
                    },
                    {
                        "Name": "400",
                        "Value": 0
                    },
                    {
                        "Name": "403",
                        "Value": 0
                    },
                    {
                        "Name": "404",
                        "Value": 0
                    },
                    {
                        "Name": "499",
                        "Value": 0
                    },
                    {
                        "Name": "401",
                        "Value": 0
                    },
                    {
                        "Name": "5xx",
                        "Value": 0
                    },
                    {
                        "Name": "500",
                        "Value": 0
                    },
                    {
                        "Name": "502",
                        "Value": 0
                    },
                    {
                        "Name": "533",
                        "Value": 0
                    },
                    {
                        "Name": "504",
                        "Value": 0
                    },
                    {
                        "Name": "505",
                        "Value": 0
                    },
                    {
                        "Name": "530",
                        "Value": 0
                    },
                    {
                        "Name": "531",
                        "Value": 0
                    },
                    {
                        "Name": "532",
                        "Value": 0
                    },
                    {
                        "Name": "Traffic",
                        "Value": 0
                    },
                    {
                        "Name": "Request",
                        "Value": 0
                    },
                    {
                        "Name": "QPS",
                        "Value": 0
                    },
                    {
                        "Name": "Bandwidth",
                        "Value": 0
                    }
                ]
            },
            {
                "TimeStamp": "2025-03-15 00:15:00",
                "DetailInfo": [
                    {
                        "Name": "1xx",
                        "Value": 0
                    },
                    {
                        "Name": "101",
                        "Value": 0
                    },
                    {
                        "Name": "102",
                        "Value": 0
                    },
                    {
                        "Name": "100",
                        "Value": 0
                    },
                    {
                        "Name": "2xx",
                        "Value": 0
                    },
                    {
                        "Name": "200",
                        "Value": 0
                    },
                    {
                        "Name": "201",
                        "Value": 0
                    },
                    {
                        "Name": "206",
                        "Value": 0
                    },
                    {
                        "Name": "3xx",
                        "Value": 0
                    },
                    {
                        "Name": "301",
                        "Value": 0
                    },
                    {
                        "Name": "302",
                        "Value": 0
                    },
                    {
                        "Name": "4xx",
                        "Value": 0
                    },
                    {
                        "Name": "400",
                        "Value": 0
                    },
                    {
                        "Name": "403",
                        "Value": 0
                    },
                    {
                        "Name": "404",
                        "Value": 0
                    },
                    {
                        "Name": "499",
                        "Value": 0
                    },
                    {
                        "Name": "401",
                        "Value": 0
                    },
                    {
                        "Name": "5xx",
                        "Value": 0
                    },
                    {
                        "Name": "500",
                        "Value": 0
                    },
                    {
                        "Name": "502",
                        "Value": 0
                    },
                    {
                        "Name": "533",
                        "Value": 0
                    },
                    {
                        "Name": "504",
                        "Value": 0
                    },
                    {
                        "Name": "505",
                        "Value": 0
                    },
                    {
                        "Name": "530",
                        "Value": 0
                    },
                    {
                        "Name": "531",
                        "Value": 0
                    },
                    {
                        "Name": "532",
                        "Value": 0
                    },
                    {
                        "Name": "Traffic",
                        "Value": 0
                    },
                    {
                        "Name": "Request",
                        "Value": 0
                    },
                    {
                        "Name": "QPS",
                        "Value": 0
                    },
                    {
                        "Name": "Bandwidth",
                        "Value": 0
                    }
                ]
            }
        ],
        "TotalStatistics": {
            "1xx": 0,
            "1xxRatio": 0,
            "2xx": 0,
            "2xxRatio": 0,
            "3xx": 0,
            "3xxRatio": 0,
            "4xx": 1,
            "4xxRatio": 1,
            "5xx": 0,
            "5xxRatio": 0,
            "Bandwidth": 22.96,
            "QPS": 0.0033333333333333335,
            "Request": 1,
            "Traffic": 861
        }
    }
}
最近更新时间:2026.05.25 16:53:18
这个页面对您有帮助吗?
有用
有用
无用
无用