# 获取服务错误码时间分布统计信息 #### 功能介绍 获取服务错误码时间分布统计信息接口用于展现服务的错误码统计时间分布信息。仅保存30天内的统计数据。 #### 接口约束 - 区域限制：仅支持西南-贵阳一区域。 - API流量限制：所有用户对该API的总请求次数上限，20秒内不超过80次。 - 用户流量限制：单个用户对该API的请求次数上限，20秒内不超过1次。 - 限流响应：超出限流阈值时，API将返回HTTP 429状态码（Too Many Requests）。 - 重试建议：遇到限流时，建议等待20秒后重试。 #### URI POST /v1/{project_id}/maas/monitoring/{service_id}/error-code-chart 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | **参数解释** ：项目ID。关于如何获取项目ID，请参见[获取项目ID和名称](https://support.huaweicloud.com/api-maas/ErrorCode.html)。 **约束限制**：不涉及。 **取值范围**：只能由小写英文字母和数字组成，长度32字符。 **默认取值**：不涉及。 | | service_id | 是 | String | **参数解释** ：服务ID。服务ID在创建服务时即可在返回体中获取，也可通过[获取服务列表接口](https://support.huaweicloud.com/api-maas/ListServices.html)获取当前用户拥有的服务，其中service_id字段即为服务ID。 **约束限制**：不涉及。 **取值范围**：长度 1-128 字符，仅支持大小写字母、数字、下划线 (_)、短横线 (-)。 **默认取值**：不涉及。 | #### 请求参数 表2请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | X-Auth-Token | 是 | String | **参数解释** ：用户Token。通过调用IAM服务的获取用户Token接口获取（响应消息头中X-Subject-Token的值）。获取方式请参见[认证鉴权](https://support.huaweicloud.com/api-maas/api-maas-0005.html)。 **约束限制**：不涉及。 **取值范围**：不涉及。 **默认取值**：不涉及。 | 表3请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | service_type | 是 | Integer | **参数解释**：服务类型。 **约束限制**：不涉及。 **取值范围**：枚举类型，取值如下： - 2：预置服务，在"预置服务"页签开通的模型服务。具体操作，请参见[开通预置服务](https://support.huaweicloud.com/model-call-maas/model-call-052.html)。 - 4：自定义接入点，在"自定义接入点"页签创建的接入点服务。更多信息，请参见[创建自定义接入点](https://support.huaweicloud.com/model-call-maas/model-call-048.html)。 **默认取值**：不涉及。 | | api_keys | 否 | Array of strings | **参数解释**：API Key标签列表，根据传入的API Key标签列表筛选。 MaaS的服务支持**API Key调用** 和**在线体验**两种方式。 **API Key标签** 获取方式：进入[API Key 管理](https://console.huaweicloud.com/modelarts/?#/model-studio/authmanage)页面，API Key列表中"标签"字段的值即为API Key的标签。如下图所示： ![](https://support.huaweicloud.com/api-maas/figure/zh-cn_image_0000002659094077.png "点击放大") **约束限制**：不涉及。 **取值范围**： - 查询**在线体验**调用数据时示例：api_keys: \[""\]。 - 查询**部分** **API Key**下的调用数据时，传入对应API Key的标签；示例：api_keys: \["test01"，"test02"\]。 - 查询**在线体验** 和**部分** **API Key**下的调用数据时，示例：api_keys: \["test01", "test02", ""\] - 查询**全部**调用数据时，不传该参数。 | | ips | 否 | Array of strings | **参数解释** ：IP地址列表，指已产生调用量的客户端源IP地址，不传则查询用户全部IP地址下的数据。可使用[查询IP列表接口](https://support.huaweicloud.com/api-maas/ListSourceIps.html)查询IP地址。 **约束限制**：需符合IP地址格式。 **取值范围**：不涉及。 **默认取值**：不涉及。 | | start_time | 是 | Long | **参数解释**：开始时间，毫秒时间戳。 **约束限制**：结束时间与开始时间相差不超过30天。 **取值范围**：数值大于0，小于等于end_time的取值。 **默认取值**：不涉及。 | | end_time | 是 | Long | **参数解释**：结束时间，毫秒时间戳。 **约束限制**：结束时间与开始时间相差不超过30天。 **取值范围**：数值大于0。 **默认取值**：不涉及。 | | timezone | 否 | String | **参数解释**：时区。 **约束限制**：不涉及。 **取值范围**：遵循IANA时区规范（如Asia/Shanghai、UTC）。 **默认取值**：Asia/Shanghai（东八区）。 | | infer_type | 是 | String | **参数解释**：服务的推理类型。 **取值范围**：枚举类型，取值如下： - real_time：在线推理。 - batch：批量推理（批量推理当前处于受限使用阶段，如需使用请提交工单）。 **约束限制**：不涉及。 **默认取值**：不涉及。 | | error_code_type | 否 | String | **参数解释**：错误码类型。 **约束限制**：不涉及。 **取值范围**：取值如下： - 4xx：以4开头错误码。 - 5xx：以5开头错误码。 ·为空字符串或者不传：以4开头错误码和以5开头错误码都展示。 **默认取值**：不涉及。 | | time_granularity | 是 | Integer | **参数解释**：时间粒度。 **约束限制**：时间范围（开始时间和结束时间间隔）与时间精度需满足如下规则： - 时间范围0-2天，支持精度：按分钟、按小时。 - 时间范围3-7天，支持精度：按小时、按天。 - 时间范围8-30天，支持精度：按天。 **取值范围**：枚举类型，取值为1\~3的整数： - 1：分钟粒度。 - 2：小时粒度。 - 3：天粒度。 **默认取值**：不涉及。 | | version_id | 否 | String | **参数解释** ：服务版本ID，根据传入的版本ID筛选；不传则查找所有版本的数据。可以使用[查询服务版本调用数据接口](https://support.huaweicloud.com/api-maas/ListVersionStatistics.html)查询服务的版本ID。 **约束限制**：不涉及。 **取值范围**：长度 1-128 字符，仅支持大小写字母、数字、下划线 (_)、短横线 (-)。 **默认取值**：不涉及。 | #### 响应参数 **状态码：200** 表4响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | total | Integer | **参数解释**：总错误数。 **取值范围**：不涉及。 | | count | Integer | **参数解释**：总错误数。 **取值范围**：不涉及。 | | list_4xx | Array of [ErrorCodeCount] objects | **参数解释**：4xx错误详情列表。 **取值范围**：不涉及。 | | list_5xx | Array of [ErrorCodeCount] objects | **参数解释**：5xx错误详情列表。 **取值范围**：不涉及。 | 表5ErrorCodeCount | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释**：4xx或5xx类错误码下具体的错误码。 **取值范围**：具体错误码取值范围如下： - 400：通常因为请求体参数有问题，请检查您的请求体参数。 - 401：通常是因为请求无权限，请检查您的鉴权信息。 - 403：通常是因为请求或生成的内容包含不合规内容。 - 404：找不到资源，可能您的请求路径出现问题。 - 413：通常是因为请求体内过大导致被服务端拒绝。 - 429：通常是因为发生请求限流。 - 499：通常是客户端主动关闭连接或取消了请求。 - 500：服务端发生未知错误。 - 503：当前底层无可用的推理服务。 - 504：请求超时。 | | list | Array of [TimestampErrorCnt] objects | **参数解释**：具体错误码在各时间段的次数列表，包含毫秒时间戳和对应时间的错误次数。 **取值范围**：不涉及。 | 表6TimestampErrorCnt | 参数 | 参数类型 | 描述 | |:---|:---|:---| | time | Long | **参数解释**：毫秒时间戳。 **取值范围**：不涉及。 | | count | Long | **参数解释**：该时间段错误码数量。 **取值范围**：不涉及。 | **状态码：400** 表7响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释** ：错误码，标识错误类型，详情请参考[MaaS错误码](https://support.huaweicloud.com/api-maas/ErrorCode.html)。 **取值范围**：不涉及。 | | error_msg | String | **参数解释** ：错误描述信息。详情请参考[MaaS错误码](https://support.huaweicloud.com/api-maas/ErrorCode.html)。 **取值范围**：不涉及。 | #### 请求示例 查询服务ID为4f6d50ec-0e80-4ea0-983b-d0ad1ede7596，版本ID为ac73463d-4453-4d62-a3d9-31b627a116b1的预置服务14天内在线推理文本生成的指标数据信息。 ``` POST https://{endpoint}/v1/{project_id}/maas/monitoring/4f6d50ec-0e80-4ea0-983b-d0ad1ede7596/error-code-chart { "service_type" : 2, "start_time" : 1768406400000, "end_time" : 1769532163224, "timezone" : "Asia/Shanghai", "time_granularity" : 3, "infer_type" : "real_time" } ``` #### 响应示例 **状态码：200** 成功响应。 ``` { "total" : 2, "count" : 2, "list_4xx" : [ { "error_code" : "400", "list" : [ { "time" : 1768406400000, "count" : 2 }, { "time" : 1768492800000, "count" : 0 }, { "time" : 1768579200000, "count" : 0 }, { "time" : 1768665600000, "count" : 0 }, { "time" : 1768752000000, "count" : 0 }, { "time" : 1768838400000, "count" : 0 }, { "time" : 1768924800000, "count" : 0 }, { "time" : 1769011200000, "count" : 0 }, { "time" : 1769097600000, "count" : 0 }, { "time" : 1769184000000, "count" : 0 }, { "time" : 1769270400000, "count" : 0 }, { "time" : 1769356800000, "count" : 0 }, { "time" : 1769443200000, "count" : 0 }, { "time" : 1769529600000, "count" : 0 } ] } ], "list_5xx" : [ { "error_code" : "500", "list" : [ ] } ] } ``` **状态码：400** 失败响应。 ``` { "error_msg" : "The project ID in the request does not match that in the token.", "error_code" : "ModelArts.0210" } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | 成功响应。 | | 400 | 失败响应。 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-maas/ErrorCode.html)。