获取客户端异常事件

最近更新时间: 2026-09-17 00:02:44

1. 接口描述

接口请求域名： cwp.api3.fincloud.tencent.cn。

获取客户端异常事件

默认接口请求频率限制：20次/秒。

接口更新时间：2022-11-16 10:43:36。

接口既验签名又鉴权。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见公共请求参数。

参数名称	必选	允许NULL	类型	描述
Action	是	否	String	公共参数，本接口取值：DescribeClientException
Version	是	否	String	公共参数，本接口取值：2018-02-28
Region	是	否	String	公共参数，地域信息本接口不需要传递此参数。
EndTime	否	否	String	结束时间 `2006-01-02 15:04:05` 格式示例值： 2006-01-02 15:04:05
ExceptionType	是	否	Int64	客户端异常类型 1:客户端离线，2:客户端卸载示例值： 1
Limit	是	否	Uint64	分页单页限制数目，不为0，最大值100 示例值： 10
Offset	是	否	Uint64	分页的偏移量示例值： 0
StartTime	否	否	String	起始时间 `2006-01-02 15:04:05` 格式示例值： 2006-01-02 15:04:05

3. 输出参数

参数名称	类型	描述
Records	Array of RecordInfo	事件详情示例值：查看
TotalCount	Uint64	事件总数量示例值： 944
RequestId	String	唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

4. 错误码

该接口暂无业务逻辑相关的错误码，其他错误码详见公共错误码。

5. 示例

示例1 示例1

输入示例

POST / HTTP/1.1
Host: cwp.api3.fincloud.tencent.cn
Content-Type: application/json
X-TC-Action: DescribeClientException
<Public request parameters>

{
    "EndTime": "2020-11-21 15:16:00",
    "Limit": "10",
    "ExceptionType": "1",
    "StartTime": "2020-11-21 15:16:00",
    "Offset": "0"
}

输出示例

{
    "Response": {
        "Records": [
            {
                "HostIP": "172.23.16.2",
                "InstanceID": "ins-kz85kljw",
                "Uuid": "2e6353e4-0498-450a-9be5-77e2537247f6",
                "OfflineTime": "2022-04-24T17:52:37+08:00",
                "UninstallTime": "2020-11-21 15:16:00",
                "UninstallCmd": "sh ******"
            }
        ],
        "RequestId": "1248a7df-c3fe-4930-b3ff-2af956cf8d66",
        "TotalCount": 944
    }
}