调用QueryApiDurationDistribution查询接口响应时间的分布。
应用需提前接入性能分析SDK,并启用网络性能监控。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | QueryApiDurationDistribution |
系统规定参数。取值:QueryApiDurationDistribution。 |
Domain | String | 是 | www.aliyun.com |
用于设置查询的域名。 |
EndTime | Long | 是 | 1609862400000 |
用于设置查询时间区间的结束时间。 |
StartTime | Long | 是 | 1609430400000 |
用于设置查询时间区间的开始时间。 |
UniqueAppId | String | 是 | 24781204@android |
用于唯一标识App。 格式:appkey@{platfrom} 其中{platfrom}为应用所属平台:
|
AppVersion.N | RepeatList | 否 | 1.0 |
用于设置应用的版本号。 格式为:{N}.x. ... .x,其中,{N}的取值范围为1~10。 说明:
|
AppVersionStrategy | String | 否 | LATEST_3 |
用于设置应用的版本策略。 格式:LATEST_{N},代表取最近的N个版本。其中,{N}的最大取值为10。 说明:
|
IntervalMinutes | Integer | 否 | 1440 |
用于设置查询结果的时间精度,以分钟为单位。 最高精度为1440分钟(1天);默认精度为1440分钟;参数取值需为1440的倍数。 |
Ip.N | RepeatList | 否 | 192.0.0.1 |
用于设置API服务器的公网IP地址,由网络规划获取。 |
UrlPath.N | RepeatList | 否 | /test/emas |
用于设置API服务器的请求路径。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
MetricResultList | Array of MetricResultItem |
用于显示结果列表。 |
|
Data | Array of Point |
用于显示某个标签组合的数据。 |
|
CentroidItemList | Array of CentroidItem |
用于显示数据区间分布列表。 |
|
Range | String | 100-200 |
响应时间区间,毫秒 |
Rate | Float | 13 |
样本数百分比 |
Value | Float | 1300 |
样本数 |
Time | Long | 1609862400000 |
用于显示时间戳。 |
Tags | Map | {"appVersion":"1.0","domain":"www.aliyun.com"} |
用于显示标签的组合。 |
RequestId | String | A8313212-EB4E-4E15-A7F9-D9C8F3FE8E94 |
用于显示查询请求的ID。 |
示例
请求示例
http(s)://[Endpoint]/?Action=QueryApiDurationDistribution
&Domain=www.aliyun.com
&EndTime=1609862400000
&StartTime=1609430400000
&UniqueAppId=24781204@android
&AppVersion.1=1.0
&<公共请求参数>
正常返回示例
XML
格式
<RequestId>A23AE171-3B22-45E7-8767-EA7C0A1A9991</RequestId>
<MetricResultList>
<Tags>
<appVersion>1.0</appVersion>
<domain>www.aliyun.com</domain>
</Tags>
<Data>
<Time>1609862400000</Time>
<CentroidItemList>
<Value>1100</Value>
<Range>300以下</Range>
<Rate>25</Rate>
</CentroidItemList>
<CentroidItemList>
<Value>1000</Value>
<Range>300-500</Range>
<Rate>23</Rate>
</CentroidItemList>
</Data>
</MetricResultList>
JSON
格式
{
"RequestId": "A23AE171-3B22-45E7-8767-EA7C0A1A9991",
"MetricResultList": [{
"Tags": {
"appVersion": "1.0",
"domain": "www.aliyun.com"
},
"Data": [{
"Time": "1609862400000",
"CentroidItemList": [{
"Value": 1100,
"Range": "300以下",
"Rate": 25.0
}, {
"Value": 1000,
"Range": "300-500",
"Rate": 23.0
}]
}]
}]
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
403 | Forbidden.NoPermission | You are not authorized to access data related to the specified AppId. | 您无权访问与该AppId有关的数据。 |
403 | Forbidden.NoRAMPermission | Your RAM account is not authorized to access the data of the specified AppId. | 您使用的RAM子账号没有被授权访问该AppId的数据。 |
500 | InternalError | An error occurred while processing your request. | 服务出错。 |
400 | InvalidAppId | The AppId you provided is invalid. | 您提供的AppId不合法。 |
400 | InvalidParameters | The specified parameter is invalid. | 参数不合法。 |
400 | InvalidRequest | The request is invalid. | 请求不合法。 |
406 | UnexpectedAppStatus | The status of App is invalid. | App的状态不合法。 |
访问错误中心查看更多错误码。