调用QueryApiStatusCodeGroupTrend按指定分组方式(域名或操作系统)查询网络HTTP状态码统计趋势。
应用需提前接入性能分析SDK,并启用网络性能监控。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | QueryApiStatusCodeGroupTrend |
系统规定参数。取值:QueryApiStatusCodeGroupTrend。 |
EndTime | Long | 是 | 1609862400000 |
用于设置查询时间区间的结束时间。 |
Group | String | 是 | Domain |
用于设置按指定方式将查询结果进行分组。 取值范围:
|
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 | 否 | 60 |
用于设置查询结果的时间精度,以分钟为单位。
|
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
MetricResultList | Array of MetricResultItem |
用于显示结果列表。 |
|
Data | Array of Point |
用于显示该标签组合的数据列表。 |
|
PointData | Struct |
用于显示HTTP状态码统计信息。 |
|
Status4xxCount | Long | 10 |
用于显示4xx状态码的样本数。 |
Status4xxRatio | Float | 1.0 |
用于显示4xx状态码样本的百分比。 |
Status5xxCount | Long | 20 |
用于显示5xx状态码的样本数。 |
Status5xxRatio | Float | 2.0 |
用于显示5xx状态码样本的百分比。 |
StatusNormalCount | Long | 970 |
用于显示正常状态码的样本数。 |
StatusNormalRatio | Float | 97.0 |
用于显示正常状态码样本的百分比。 |
Time | Long | 1609862400000 |
用于显示时间戳。 |
Tags | Map | {"appVersion":"1.0","domain":"www.aliyun.com"} |
用于显示标签组合。 |
RequestId | String | A8313212-EB4E-4E15-A7F9-D9C8F3FE8E94 |
用于显示查询请求的ID。 |
示例
请求示例
http(s)://[Endpoint]/?Action=QueryApiStatusCodeGroupTrend
&EndTime=1609862400000
&Group=Domain
&StartTime=1609430400000
&UniqueAppId=24781204@android
&AppVersion.1=1.0
&<公共请求参数>
正常返回示例
XML
格式
<RequestId>A8313212-EB4E-4E15-A7F9-D9C8F3FE8E94</RequestId>
<MetricResultList>
<Tags>
<appVersion>1</appVersion>
<domain>www.aliyun.com</domain>
</Tags>
<Data>
<Time>1609862400000</Time>
<PointData>
<Status4xxCount>10</Status4xxCount>
<Status4xxRatio>1</Status4xxRatio>
<Status5xxCount>20</Status5xxCount>
<Status5xxRatio>2</Status5xxRatio>
<StatusNormalCount>97</StatusNormalCount>
<StatusNormalRatio>97</StatusNormalRatio>
</PointData>
</Data>
</MetricResultList>
JSON
格式
{
"RequestId": "A8313212-EB4E-4E15-A7F9-D9C8F3FE8E94",
"MetricResultList": {
"Tags": {
"appVersion": 1,
"domain": "www.aliyun.com"
},
"Data": [{
"Time": 1609862400000,
"PointData": {
"Status4xxCount": 10,
"Status4xxRatio": 1.0,
"Status5xxCount": 20,
"Status5xxRatio": 2.0,
"StatusNormalCount": 97,
"StatusNormalRatio": 97.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的状态不合法。 |
访问错误中心查看更多错误码。