最近更新时间:2023.05.26 12:00:17
首次发布时间:2023.03.23 10:31:55
本接口支持通过指定查询时间段和时间粒度获取 2.0 模式下的上传分片速度。
说明
单次查询的时间跨度不能超过 90 天。
说明
veImageX 在全球多个区域部署,每个区域有自己对应的 OpenAPI 域名,不支持跨区域调用。具体详情请查看服务地址。
以下请求参数列表仅列出了该接口的部分公共参数,完整公共参数列表见公共参数。
参数 | 类型 | 是否必选 | 描述 |
---|---|---|---|
Action | String | 是 | 接口名称。 |
Version | String | 是 | 接口版本。veImageX 当前 API 的版本为 2018-08-01 。 |
参数 | 类型 | 是否必选 | 描述 |
---|---|---|---|
Appid | String | 否 | 应用 ID,默认为空,不传匹配账号下所有的 AppID。 说明 您可以通过调用获取应用列表的方式获取所需的 AppID。 |
AppVer | Array of String | 否 | 需要匹配的 App 版本,不传则匹配 App 的所有版本。 |
OS | String | 否 | 需要匹配的系统类型,不传则匹配非 WEB 端的所有系统。取值如下所示:
|
SdkVer | Array of String | 否 | 需要匹配的 SDK 版本,不传则匹配所有版本。 |
Country | String | 否 | 需要匹配的国家名称,不传则匹配所有国家,传海外 匹配海外所有国家 |
Province | String | 否 | 需要匹配的省份名称,不传则匹配所有省份 |
Isp | Array of String | 否 | 需要匹配的运营商名称,不传则匹配所有运营商。支持取值如下:
|
ExtraDims | Array of ExtraDims | 否 | 需要匹配的自定义维度项 |
GroupBy | String | 否 | 拆分维度。默认为空,表示拆分分位数据。 支持取值:
|
UploadType | Integer | 是 | 上传类型,固定值传入2 ,表示上传 2.0 数据。 |
StartTime | String | 是 | 获取数据起始时间点。日期格式按照 ISO8601 表示法,格式为:YYYY-MM-DDThh:mm:ss±hh:mm,比如 2019-06-02T00:00:00+08:00。 |
EndTime | String | 是 | 获取数据结束时间点,需在起始时间点之后。日期格式按照 ISO8601 表示法,格式为:YYYY-MM-DDThh:mm:ss±hh:mm,比如 2019-06-02T00:00:00+08:00。 |
Granularity | String | 是 | 返回数据的时间粒度,取值如下所示:
|
参数 | 类型 | 是否必选 | 描述 |
---|---|---|---|
Dim | String | 是 | 自定义维度名称。 说明 您可以通过调用获取自定义维度列表来获取。 |
Vals | Array of String | 是 | 需要匹配的对应维度值。 说明 您可以通过调用获取自定义维度值来获取。 |
参数 | 类型 | 描述 |
---|---|---|
SpeedData | Array of SpeedData | 上传速度数据。 |
参数 | 类型 | 描述 |
---|---|---|
Type | String | 数据类型。
|
Count | Integer | 总上传次数 |
Data | Array of Data | 具体数据 |
参数 | 类型 | 描述 |
---|---|---|
Count | Integer | 上传次数 |
Timestamp | String | 数据对应时间点,按照ISO8601表示法,格式为:YYYY-MM-DDThh:mm:ss±hh:mm。 |
Value | Float | 上传分片速度,单位为 KB/s。 |
POST https://imagex.volcengineapi.com/?Action=DescribeImageXUploadSegmentSpeedByTime&Version=2018-08-01 { "StartTime": "2019-06-02T00:00:00+08:00", "EndTime": "2019-06-02T00:01:00+08:00", "Granularity": "1h", "Province": "xx", "ExtraDims": [ { "Dim": "xx", "Vals": [ "xx" ] } ], "GroupBy": "xx", "SdkVer": [ "1.2.3" ], "AppVer": [ "2.3.1" ], "Isp": [ "电信" ], "Appid": "12**9u", "Country": "海外", "OS": "iOS" }
{ "ResponseMetadata": { "RequestId": "201806041104200100100232280022D30", "Action": "DescribeImageXUploadSegmentSpeedByTime", "Version": "2018-08-01", "Service": "imagex", "Region": "cn-north-1" } "Result": { "SpeedData": [ { "Data": [ { "Timestamp": "2020-01-01T08:00:00+08:00", "Value": 0.992, "Count": 5661 } ], "Type": "Total", "Count": 1739 } ] } }
{ "ResponseMetadata": { "RequestId": "201806041104200100100232280022D30", "Action": "DescribeImageXUploadSegmentSpeedByTime", "Version": "2018-08-01", "Service": "imagex", "Region": "cn-north-1", "Error": { "Code": "200000", "Message": "参数异常" } } }