Domain name for API request: csip.intl.tencentcloudapi.com.
This API is used to query the CSC abnormal login custom allowlist. In multi-account scenarios, parse out all member AppIds by MemberId and perform an aggregate query only once. Return in pages by ModifyTime DESC. The output slice field is always [] and never null.
A maximum of 20 requests can be initiated per second for this API.
The following request parameter list only provides API request parameters and some common parameters. For the complete common parameter list, see Common Request Parameters.
| Parameter Name | Required | Type | Description |
|---|---|---|---|
| Action | Yes | String | Common Params. The value used for this API: DescribeLoginWhiteCustomListEDR. |
| Version | Yes | String | Common Params. The value used for this API: 2022-11-21. |
| Region | No | String | Common Params. This parameter is not required. |
| MemberId.N | No | Array of String | Group account member id |
| Filters.N | No | Array of EDRFilter | Filter condition array (multiple Filters have an AND relationship). Supports Name: Keyword (SrcIp/UserName/Locations/Remark blurry), SrcIp, UserName, Location, Remark, ModifyBeginTime, ModifyEndTime (time format 2006-01-02 15:04:05); unknown Name is ignored with no error reported |
| Limit | No | Integer | Page size. Default: 10. Upper limit: 100. If 0 or more than 100 is passed, the default or upper limit is used. |
| Offset | No | Integer | Pagination offset. Default value: 0. |
| Order | No | String | Sorting order: ASC - ascending, DESC - descending (not case-sensitive). Default: DESC |
| By | No | String | Sorting field: CreateTime-creation time, ModifyTime-last modified. Default: ModifyTime. If an illegal value is passed, InvalidParameter is returned. |
| Parameter Name | Type | Description |
|---|---|---|
| TotalCount | Integer | Total number of rules that meet the criteria |
| List | Array of LoginWhiteItem | Custom allowlist rule list (Type is always Custom). If empty, [] is returned. |
| RequestId | String | The unique request ID, generated by the server, will be returned for every request (if the request fails to reach the server for other reasons, the request will not obtain a RequestId). RequestId is required for locating a problem. |
Query the custom allowlist list for logon exceptions
POST / HTTP/1.1
Host: csip.intl.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: DescribeLoginWhiteCustomListEDR
<Common request parameters>
{}{
"Response": {
"List": [
{
"AppId": 260199983,
"CreateTime": "2026-10-23 15:38:40",
"EndTime": "",
"ExcludeInstanceIDs": [],
"ExcludeQUUIDS": [],
"HostCount": 0,
"Id": 3,
"InstanceIDs": [],
"Locations": "",
"ModifyTime": "2026-10-23 15:38:40",
"Places": [],
"QUUIDS": [],
"Remark": "",
"Scope": 1,
"SrcIp": "1.1.1.2",
"StartTime": "",
"TagItems": [],
"Type": "Custom",
"UserName": "place"
}
],
"TotalCount": 2,
"RequestId": "51c542e6-5cde-4adf-8f01-4e21e027cf20"
}
}TencentCloud API 3.0 integrates SDKs that support various programming languages to make it easier for you to call APIs.
The following only lists the error codes related to the API business logic. For other error codes, see Common Error Codes.
| Error Code | Description |
|---|---|
| InternalError | Internal error. |
| InvalidParameter | Parameter error. |
文档反馈