调用QueryApiStatusCodeGroupTrend按指定分组方式（域名或操作系统）查询网络HTTP状态码统计趋势。

应用需提前接入性能分析SDK，并启用网络性能监控。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 QueryApiStatusCodeGroupTrend

系统规定参数。取值：QueryApiStatusCodeGroupTrend。
EndTime Long 是 1609862400000

用于设置查询时间区间的结束时间。
Group String 是 Domain

用于设置按指定方式将查询结果进行分组。

取值范围：

  • Domain：按域名。
  • OsVersion：按操作系统。
StartTime Long 是 1609430400000

用于设置查询时间区间的开始时间。
UniqueAppId String 是 24781204@android

用于唯一标识App。

格式：appkey@{platfrom}

其中{platfrom}为应用所属平台：

  • Android应用的{platfrom}为android；
  • iOS应用的{platfrom}为iphoneos。
AppVersion.N RepeatList 否 1.0

用于设置应用的版本号。

格式为：{N}.x. ... .x，其中，{N}的取值范围为1~10。

说明：

  • 参数AppVersion.N与参数AppVersionStrategy，二者必选其一进行配置。
  • 当本参数已设置时，则参数AppVersionStrategy无需设置，或设置无效。
  • 当本参数未设置时，则参数AppVersionStrategy必须设置。
AppVersionStrategy String 否 LATEST_3

用于设置应用的版本策略。

格式：LATEST_{N}，代表取最近的N个版本。其中，{N}的最大取值为10。

说明：

  • 参数AppVersion.N与参数AppVersionStrategy，二者必选其一进行配置。
  • 当参数AppVersion.N已设置时，则本参数无需设置，或设置无效。
  • 当参数AppVersion.N未设置时，则本参数必须设置。
IntervalMinutes Integer 否 60

用于设置查询结果的时间精度，以分钟为单位。

  • 当时间范围小于等于3天时：最高精度为60分钟（1小时）；默认精度为60分钟；参数取值需为60的倍数；
  • 当时间范围小于等于31天时：最高精度为1440分钟（1天）；默认精度为1440分钟；参数取值需为1440的倍数。

返回数据

名称 类型 示例值 描述
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的状态不合法。

访问错误中心查看更多错误码。