最近更新时间:2022-07-28 10:32:40
本接口用于获取域名独立请求的IP个数,单位:个
本接口请求需要包含指定目录/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数据 |
参数 | 类型 | 描述 |
---|---|---|
Time | String | 时间点 |
Uv | Long | 独立请求的IP个数,(所选域名合并值) |
Domains | UvDataByDomain[] | 每个域名的详细独立请求的IP个数数据ResultType取值为expand时返回此项数据)) |
参数 | 类型 | 描述 |
---|---|---|
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
}
]
}
]
}
纯净模式