You need to enable JavaScript to run this app.
导航
查询访问回源资源用量细节
最近更新时间:2023.10.26 11:48:59首次发布时间:2022.09.08 13:59:53

API说明

API名称:DescribeOriginStatisticsDetail。
API域名:open.volcengineapi.com。
API描述:查询访问回源资源用量细节 。

URI参数

公共参数

Action和Version需要放在请求 URL 后方参数中。

参数名称
是否必选
参数类型
参数说明
Action
String
API 名称,该参数的取值是 DescribeOriginStatisticsDetail 。
Version
String
API 版本,该参数的取值是 2021-04-01 。

请求正文

参数名称

是否必选

参数类型

参数说明

示例

StartTimeString查询起始时间。2021-01-01 00:00:00
EndTimeString查询结束时间,结束时间大于起始时间。2021-01-01 23:59:59
Domains[ ]String指定查询域名列表,为空代表查询当前用户所有域名。[www.bytedance.com]

Metrics

[ ]String

指定查询指标,支持取值:

  • all:全部指标。

  • traffic:流量,单位为 byte 。

  • bandwidth:峰值带宽,单位为 bps 。

  • request: 请求数,单位为次 。

  • QPS: 峰值QPS,单位为次/s 。

[bandwidth]

Interval

Integer

时间粒度,单位为秒 ,支持参数:

  • 3 天以内(不含3):支持 300、3600、 86400,不传该参数时,默认值为300。

  • 3 - 31 天(不含31): 支持 3600 和 86400,不传该参数时,默认值为3600。

  • 31 天及以上: 支持 86400,不传该参数,默认值为 86400。

300

Protocol

[ ]String

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

  • ALL

  • HTTP

  • HTTPS

[HTTP,HTTPS]

Type

String

指定访问类型,不填时表示查询所有类型,返回总和(相当于all),支持参数:

  • all:所有类型。

  • dynamic:指定查询动态内容对应指标。

  • static:指定查询静态内容对应指标。

all

IPVersion

String

指定ip类型查询,不填时表示查询所有类型,支持参数:

  • all:所有类型。

  • ipv4

  • ipv6

all

注意

资源用量和实时监控接口的查询时间区别如下表。

具体指标资源用量实时监控
查询时支持查到的最早历史数据90天前7天前
查询时支持最大的查询时间跨度31天24小时
查询后数据展示的最小时间粒度5分钟(可修改其他更大数值)1分钟(不可修改)

响应正文

参数名称
参数类型
参数说明
示例
RequestId
String
请求ID。
2022******452201017424420806842536
DomainCount
Integer
查询域名中有效域名的数量。
20
StartTime
String
查询起始时间。
2021-01-01 00:00:00
EndTime
String
查询结束时间。
2021-01-01 23:59:59
Metrics
[ ]String
查询时选择展示的字段。
["bandwidth"]
Results
Result
查询数据明细。
-

示例

请求示例

POST https://open.volcengineapi.com/?Action=DescribeOriginStatisticsDetail&Version=2021-04-01&<其他公共请求参数>
{
    "StartTime": "2022-08-09 00:00:00",
    "EndTime": "2022-08-09 00:20:11",
    "Domains":[
        "www.qq.com",
        "www.bytedance.com"
    ],
    "Metrics": [
        "all"
    ],
    "Interval": 300
}

响应示例

{
    "ResponseMetadata": {
        "RequestId": "202208100137510102251460630120605A",
        "Action": "DescribeOriginStatisticsDetail",
        "Version": "2021-04-01",
        "Service": "dcdn",
        "Region": "cn-north-1"
    },
    "Result": {
        "DomainCount": 2,
        "StartTime": "2022-08-09 00:00:00",
        "EndTime": "2022-08-09 00:20:11",
        "Metrics": [
            "all"
        ],
        "Results": [
            {
                "TimeStamp": "2022-08-09 00:00:00",
                "RealTimeResults": [
                    {
                        "DomainName": "www.bytedance.com",
                        "DetailInfo": [
                            {
                                "Name": "Traffic",
                                "Value": 340791
                            },
                            {
                                "Name": "Request",
                                "Value": 168
                            },
                            {
                                "Name": "QPS",
                                "Value": 0.5599998
                            },
                            {
                                "Name": "Bandwidth",
                                "Value": 9087.320000000002
                            }
                        ]
                    },
                    {
                        "DomainName": "www.qq.com",
                        "DetailInfo": [
                            {
                                "Name": "Traffic",
                                "Value": 0
                            },
                            {
                                "Name": "Request",
                                "Value": 0
                            },
                            {
                                "Name": "QPS",
                                "Value": 0
                            },
                            {
                                "Name": "Bandwidth",
                                "Value": 0
                            }
                        ]
                    }
                ]
            },
            {
                "TimeStamp": "2022-08-09 00:05:00",
                "RealTimeResults": [
                    {
                        "DomainName": "www.bytedance.com",
                        "DetailInfo": [
                            {
                                "Name": "Traffic",
                                "Value": 332618
                            },
                            {
                                "Name": "Request",
                                "Value": 164
                            },
                            {
                                "Name": "QPS",
                                "Value": 0.5466666
                            },
                            {
                                "Name": "Bandwidth",
                                "Value": 8869.300000000001
                            }
                        ]
                    },
                    {
                        "DomainName": "www.qq.com",
                        "DetailInfo": [
                            {
                                "Name": "Traffic",
                                "Value": 0
                            },
                            {
                                "Name": "Request",
                                "Value": 0
                            },
                            {
                                "Name": "QPS",
                                "Value": 0
                            },
                            {
                                "Name": "Bandwidth",
                                "Value": 0
                            }
                        ]
                    }
                ]
            },
            {
                "TimeStamp": "2022-08-09 00:10:00",
                "RealTimeResults": [
                    {
                        "DomainName": "www.bytedance.com",
                        "DetailInfo": [
                            {
                                "Name": "Traffic",
                                "Value": 320546.60000000003
                            },
                            {
                                "Name": "Request",
                                "Value": 158
                            },
                            {
                                "Name": "QPS",
                                "Value": 0.526667
                            },
                            {
                                "Name": "Bandwidth",
                                "Value": 8547.220000000001
                            }
                        ]
                    },
                    {
                        "DomainName": "www.qq.com",
                        "DetailInfo": [
                            {
                                "Name": "Traffic",
                                "Value": 0
                            },
                            {
                                "Name": "Request",
                                "Value": 0
                            },
                            {
                                "Name": "QPS",
                                "Value": 0
                            },
                            {
                                "Name": "Bandwidth",
                                "Value": 0
                            }
                        ]
                    }
                ]
            },
            {
                "TimeStamp": "2022-08-09 00:15:00",
                "RealTimeResults": [
                    {
                        "DomainName": "www.qq.com",
                        "DetailInfo": [
                            {
                                "Name": "Traffic",
                                "Value": 0
                            },
                            {
                                "Name": "Request",
                                "Value": 2
                            },
                            {
                                "Name": "QPS",
                                "Value": 0.0066666
                            },
                            {
                                "Name": "Bandwidth",
                                "Value": 0
                            }
                        ]
                    },
                    {
                        "DomainName": "www.bytedance.com",
                        "DetailInfo": [
                            {
                                "Name": "Traffic",
                                "Value": 348997
                            },
                            {
                                "Name": "Request",
                                "Value": 172
                            },
                            {
                                "Name": "QPS",
                                "Value": 0.5733332
                            },
                            {
                                "Name": "Bandwidth",
                                "Value": 9306.220000000001
                            }
                        ]
                    }
                ]
            },
            {
                "TimeStamp": "2022-08-09 00:20:00",
                "RealTimeResults": [
                    {
                        "DomainName": "www.bytedance.com",
                        "DetailInfo": [
                            {
                                "Name": "Traffic",
                                "Value": 58793.9
                            },
                            {
                                "Name": "Request",
                                "Value": 29
                            },
                            {
                                "Name": "QPS",
                                "Value": 0.0966666
                            },
                            {
                                "Name": "Bandwidth",
                                "Value": 1567.7200000000003
                            }
                        ]
                    },
                    {
                        "DomainName": "www.qq.com",
                        "DetailInfo": [
                            {
                                "Name": "Traffic",
                                "Value": 0
                            },
                            {
                                "Name": "Request",
                                "Value": 0
                            },
                            {
                                "Name": "QPS",
                                "Value": 0
                            },
                            {
                                "Name": "Bandwidth",
                                "Value": 0
                            }
                        ]
                    }
                ]
            }
        ]
    }
}