全部文档
当前文档

暂无内容

如果没有找到您期望的内容,请尝试其他搜索词

文档中心

查询独立IP数

最近更新时间:2022-07-28 10:32:40

GetUvData

描述

本接口用于获取域名独立请求的IP个数,单位:个

  • 支持按指定的起止时间查询,两者需要同时指定
  • 支持批量域名查询,多个域名ID用逗号(半角)分隔
  • 最多可获取最近一年内31天跨度的数据
  • 统计粒度:5分钟粒度、1天粒度
  • 时效性:30分钟延迟

请求语法

本接口请求需要包含指定目录/2020-06-30/statistics/GetUvData和公共请求header和该接口所特有的请求参数,具体请求语句参照下文请求示例。

请求参数

参数名 必选 类型及范围 说明
StartTime String 获取数据起始时间点,日期格式按ISO8601表示法,北京时间,格式为:YYYY-MM-DDThh:mm+0800,例如: 2016-08-01T21:14+0800
EndTime String 结束时间需大于起始时间;获取日期格式按照ISO8601表示法,北京时间,格式为:YYYY-MM-DDThh:mm+0800,例如: 2016-08-01T21:14+0800
CdnType String 产品类型,只允许输入一种类型,取值为file:大文件下载,video:音视频点播,page:图片小文件
Domains String 域名,缺省为当前产品类型下的全部域名,可输入需要查询的域名,支持批量域名查询,多个域名用逗号(半角)分隔
Interval String 统计粒度,取值为 5(默认):5分钟粒度;1440:1天粒度。
注:当选择粒度是 1440:1天粒度 时, ResultType 必须是 expand , StartTime 和 EndTime 都必须是 T00:00+0800 结尾,比如:StartTime 是2022-08-01T00:00+0800、EndTime 是2022-08-06T00:00+0800,表示查询2022-08-01 到 2022-08-05 的天粒度数据;可以是多天查询,最大支持31天的跨度查询。天粒度上线较晚,是在2022-07-05迭代上线,故最早可查询 2022-07-05的天粒度数据。
ResultType String 统计结果数据展示方式,支持不展开(unexpand)和按照域名维度展开(expand),缺省为 不展开

返回参数

参数名 类型及范围 说明
StartTime String 开始时间
EndTime String 结束时间
CdnType String 产品类型
Domains String 域名列表,逗号(半角)间隔
Interval String 统计粒度
ResultType Long 统计结果数据展示方式
RequestId String 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
Datas UvDataByTime[] 每个时间粒度的独立请求的IP数据

UvDataByTime

参数 类型 描述
Time String 时间点
Uv Long 独立请求的IP个数,(所选域名合并值)
Domains UvDataByDomain[] 每个域名的详细独立请求的IP个数数据ResultType取值为expand时返回此项数据))

UvDataByDomain

参数 类型 描述
Domain String 域名
Uv Long 该域名的独立请求的IP个数

示例

请求示例

GET方式:

GET /2020-06-30/statistics/GetUvData?StartTime=2020-09-01T08%3a00%2b0800&EndTime=2020-09-01T08%3a05%2b0800&CdnType=video
Host: cdn.api.ksyun.com
X-Amz-Date: date
Authorization:authorization string
x-action: GetUvData
x-version: 2020-06-30

POST方式:

POST /2020-06-30/statistics/GetUvData
Host: cdn.api.ksyun.com
X-Amz-Date: date
Authorization:authorization string
x-action: GetUvData
x-version: 2020-06-30
Content-Type: application/json
{
    "StartTime": "2022-07-05T00:00+0800",
    "EndTime": "2022-07-07T00:00+0800",
    "CdnType":"wcdn",
    "Domains":"dynamic-test-6.ksc-test.com",
    "ResultType":"expand",
    "Interval":1440
}

返回示例

{
    "StartTime": "2022-07-05T00:00+0800",
    "EndTime": "2022-07-07T00:00+0800",
    "CdnType": "wcdn",
    "Domains": "dynamic-test-6.ksc-test.com",
    "Interval": 1440,
    "ResultType": "expand",
    "RequestId": "ca261bee-91e2-42f6-a2d0-d68a02eacb98",
    "Datas": [
        {
            "Time": "2022-07-05T00:00+0800",
            "Uv": 580,
            "Domains": [
                {
                    "Domain": "dynamic-test-6.ksc-test.com",
                    "Uv": 580
                }
            ]
        },
        {
            "Time": "2022-07-06T00:00+0800",
            "Uv": 581,
            "Domains": [
                {
                    "Domain": "dynamic-test-6.ksc-test.com",
                    "Uv": 581
                }
            ]
        }
    ]
}
文档导读
纯净模式常规模式

纯净模式

点击可全屏预览文档内容
文档反馈