DescribeVodQUICRequestData - 查询 QUIC 用量--视频点播-火山引擎

文档中心

立即注册

导航

DescribeVodQUICRequestData - 查询 QUIC 用量

最近更新时间：2025.04.08 20:53:51首次发布时间：2025.04.08 20:53:51

调用 DescribeVodQUICRequestData 接口查看指定空间下一定时间范围内的 QUIC 用量（请求数）。

注意事项

计费说明：具体价格请参见 QUIC 计费。
数据延迟：1 天。
时间范围：查询的时间跨度不超过 93 天。
权限说明：当使用子账号请求接口时，接口会按照子账号进行权限校验，只返回该子账号有权限的数据。详见给子账号添加项目权限。

请求说明

请求地址：https://vod.volcengineapi.com?Action=DescribeVodQUICRequestData&Version=2023-07-01

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共请求参数。

参数	类型	是否必选	示例值	描述
Action	String	是	`DescribeVodQUICRequestData`	接口名称。当前 API 的名称为 `DescribeVodQUICRequestData`。
Version	String	是	`2023-07-01`	接口版本。当前 API 的版本为 `2023-07-01`。
DomainList	String[]	否	`www.test.com`	域名列表。可通过 ListDomain 接口获取指定空间下的域名列表。说明 `DomainList` 和 `DomainInSpaceList` 两个参数二选一，不能同时设置。
DomainInSpaceList	String[]	否	`vod-player-test:vod-player-test.volcvod.com`	点播空间名和域名列表。格式为`空间名:域名`。说明 `DomainList` 和 `DomainInSpaceList` 两个参数二选一，不能同时设置。
StartTime	String	是	`2025-02-17T16:00:00.000Z`	查询的起始时间。遵循 RFC3339 格式的 UTC 时间，精度为秒，格式为：yyyy-MM-ddTHH:mm:ssZ。
EndTime	String	是	`2025-02-19T15:59:59.999Z`	查询的结束时间。遵循 RFC3339 格式的 UTC 时间，精度为秒，格式为：yyyy-MM-ddTHH:mm:ssZ。
Aggregation	Integer	否	`86400`	聚合的时间粒度。单位为秒。该 API 基于 `Interval` 将 `StartTime` 和 `EndTime` 所表示的统计时间段拆分成一系列的时间区间，然后对每个时间区间统计 `Metric` 数据。取值如下： `300`：（默认）5 分钟 `1800`：30 分钟 `3600`：1 小时 `86400`：1 天
AreaList	String[]	否	`CHN`	计费区域。默认返回所有区域的数据。取值如下： `CHN`：中国内地 `EU`：欧洲 `NA`：北美 `SA`：南美 `ME`：中东 `AP1`：亚太一区 `AP2`：亚太二区 `AP3`：亚太三区 `All`：全部区域 `OverSeas`：除中国内地外的区域说明各计费区的覆盖范围详见计费区说明。
RegionList	String[]	否	`cn-north-1`	服务地域列表。默认全选，多个用英文逗号 `,` 连接。取值如下： `cn-north-1`：华北 `ap-southeast-1`：亚太东南（柔佛）说明如果是 POST 请求类型为 Array of String 。视频点播亚太东南（柔佛）地域邀测中，仅针对企业用户开放。如您有相关需求，请联系您的商务经理申请，申请通过后即可正常使用。

返回参数

下表仅列出本接口特有的返回参数。更多信息请见公共返回参数。

参数	类型	示例值	描述
DomainList	String[]	`["www.test.com"]`	域名列表。
DomainInSpaceList	String[]	`["vod-player-test:vod-player-test.volcvod.com"]`	域名空间列表。
StartTime	String	`2025-02-17T16:00:00.000Z`	查询的起始时间。遵循 RFC3339 格式的 UTC 时间，精度为秒，格式为：yyyy-MM-ddTHH:mm:ssZ。
EndTime	String	`2025-02-19T15:59:59.999Z`	查询结束时间。遵循 RFC3339 格式的 UTC 时间，精度为秒，格式为：yyyy-MM-ddTHH:mm:ssZ。
Aggregation	Integer	`86400`	聚合的时间粒度。单位为秒。取值如下： `300`：5 分钟 `1800`：30 分钟 `3600`：1 小时 `86400`：1 天
AreaList	String[]	`["CHN"]`	计费区域。取值如下： `CHN`：中国内地 `EU`：欧洲 `NA`：北美 `SA`：南美 `ME`：中东 `AP1`：亚太一区 `AP2`：亚太二区 `AP3`：亚太三区 `All`：全部区域 `OverSeas`：除中国内地外的区域
RegionList	String[]	`["cn-north-1"]`	服务地域列表。
TotalRequestData	Integer	`133`	总请求数。
QUICDetailDataList	Object[]	`-`	QUIC 用量详细数据。
Time	String	`2025-02-18T00:00:00+08:00`	数据所在时间区间的开始时间。遵循 RFC3339 格式的 UTC 时间，精度为秒，格式为：yyyy-MM-ddTHH:mm:ssZ。
Cnt	Integer	`76`	该时间区间内的请求数。

请求示例

https://vod.volcengineapi.com?Action=DescribeVodQUICRequestData&Version=2023-07-01&DomainList=www.test.com&DomainInSpaceList=vod-player-test:vod-player-test.volcvod.com&StartTime=2025-02-17T16:00:00.000Z&EndTime=2025-02-19T15:59:59.999Z&Aggregation=86400&AreaList=CHN&RegionList=cn-north-1

返回示例

{
  "ResponseMetadata": {
    "RequestId": "20230604110420****100232280022D31",
    "Action": "DescribeVodQUICRequestData",
    "Version": "2023-07-01",
    "Service": "vod",
    "Region": "cn-north-1"
  },
  "Result": {
    "DomainList": [
      "www.test.com"
    ],
    "DomainInSpaceList": [
      "vod-player-test:vod-player-test.volcvod.com"
    ],
    "StartTime": "2025-02-17T16:00:00.000Z",
    "EndTime": "2025-02-19T15:59:59.999Z",
    "Aggregation": 86400,
    "AreaList": [
      "CHN"
    ],
    "RegionList": [
      "cn-north-1"
    ],
    "TotalRequestData": 133,
    "QUICDetailDataList": [
      {
        "Time": "2025-02-18T00:00:00+08:00",
        "Cnt": 76
      }
    ]
  }
}

错误码

本接口无特有的错误码。更多信息请见公共错误码。