DescribeSecurityEventMarkMissList

Updated at:

Queries the automatic whitelist rules for alerts.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request syntax

GET  HTTP/1.1

Request parameters

Parameter

Type

Required

Description

Example

EventName

string

No

The name of the alert event (subtype).

Untrusted process startup

Remark

string

No

[Deprecated] This field is deprecated.

192.168.XX.XX

DisposalWay

string

No

The disposal method of the rule. The current query does not filter results by this field, so you do not need to specify it. Valid values:

  • auto_add_white: Automatic whitelisting.

  • defense_not_notification: Defense only without notification.

auto_add_white

CurrentPage

integer

Yes

Specifies the page number of the returned page. Default value: 1.

1

PageSize

integer

Yes

The number of whitelist rules to return on each page in a paging query. Default value: 20.

20

MaxResults

integer

No

The maximum number of records to return in a single query. This field is reserved for compatibility. The backend currently uses CurrentPage and PageSize for pagination.

20

NextToken

string

No

The pagination token.

****==

Response elements

Element

Type

Description

Example

object

RequestId

string

The ID of the request.

24A20733-10A0-4AF6-BE6B-E3322413BB68

PageInfo

object

The pagination information.

CurrentPage

integer

The page number of the current page in a paging query.

1

PageSize

integer

The number of whitelist rules to return on each page in a paging query. Default value: 20.

20

TotalCount

integer

The total number of whitelist rules returned.

200

Count

integer

The number of whitelist rules on the current page.

9

List

array<object>

The list of whitelist rules.

object

Id

integer

The ID of the alert whitelist rule.

104037

GmtCreate

integer

[Deprecated] This field is deprecated.

1775095792000

GmtModified

integer

[Deprecated] This field is deprecated.

1780539705000

EventType

string

The display name of the alerting type.

Precise defense

EventTypeOriginal

string

The original identifier of the alerting type.

Precise defense

EventName

string

The display text of the alert name.

Untrusted process startup

EventNameOriginal

string

The original identifier of the alert name.

SASE non-whitelist startup interception_PC

Uuid

string

The UUID of the asset instance. For rules associated with an asset scope, the effective scope is identified by AssetScopeId, and the UUID of the target asset is not returned.

inet-pc-c6641e3e-2646-4688-ac38-************

Uuids

string

The list of UUIDs of the associated assets. Multiple values are separated by commas (,). The current API operation does not assign a value to this field.

inet-pc-c6641e3e-2646-4688-ac38-************

Field

string

The name of the rule matching field. The field used when creating a rule is subject to the corresponding FiledName returned by DescribeSecurityEventOperations.

cmd

FiledAliasName

string

The alias of the whitelisting field.

Command line

FieldValue

string

The matching value of the rule, which defines the matching condition together with Field and Operate.

C:\Windows\System32\RuntimeBroker.exe -Embedding

Operate

string

The matching operator of the rule. The available operators for a specific field are subject to the SupportedMisTypes field returned by DescribeSecurityEventOperations. The following shared operators are available, but not all fields support all values:

  • contains: Contains.

  • notContains: Does not contain.

  • strEqual: Equal to.

  • strNotEqual: Not equal to.

  • regex: Regular expression match.

strEqual

HitCount

integer

The number of times the alert whitelist rule is hit.

10

InternetIp

string

The public IP address of the terminal or asset.

8.210.XX.XX

IntranetIp

string

The private IP address of the terminal or asset.

172.25.XX.XX

InstanceName

string

The instance name of the asset.

iZ0rqjt4wqw****

InstanceId

string

The instance identity of the terminal or asset.

c208107c-3b39-4fc1-bbdb-************

DisposalWay

string

The disposal method of the rule. The current API operation does not assign a value to this field. Valid values:

  • auto_add_white: Automatic whitelisting.

  • defense_not_notification: Defense only without notification.

auto_add_white

AssetScopeId

integer

The ID of the Endpoint Detection and Response (EDR) asset scope associated with the alert rule. You can call the DescribeAssetScope operation to query the corresponding scope.

1932

AliUid

integer

The user ID.

176618589410****

MaxResults

integer

The maximum number of records to return in a single query. This field is reserved for compatibility. The backend currently uses CurrentPage and PageSize for pagination.

20

NextToken

string

The pagination token.

N6hiD08qrLdwJ9Fh0qdsJD61D5V7sa12H194Q1******

This API operation uses CurrentPage and PageSize for pagination, and does not use NextToken or MaxResults.

The response model retains the GmtCreate, GmtModified, HitCount, AliUid, Uuids, and DisposalWay fields, but the current query does not assign values to these list item fields. For rules associated with an asset scope, the effective scope is identified by AssetScopeId, and the target asset information is not returned through Uuid, InternetIp, IntranetIp, InstanceName, or InstanceId.

Examples

Success response

JSON format

{
  "RequestId": "24A20733-10A0-4AF6-BE6B-E3322413BB68",
  "PageInfo": {
    "CurrentPage": 1,
    "PageSize": 20,
    "TotalCount": 200,
    "Count": 9
  },
  "List": [
    {
      "Id": 104037,
      "GmtCreate": 1775095792000,
      "GmtModified": 1780539705000,
      "EventType": "Precise defense",
      "EventTypeOriginal": "Precise defense",
      "EventName": "Untrusted process startup",
      "EventNameOriginal": "SASE non-whitelist startup interception_PC",
      "Uuid": "inet-pc-c6641e3e-2646-4688-ac38-************",
      "Uuids": "inet-pc-c6641e3e-2646-4688-ac38-************",
      "Field": "cmd",
      "FiledAliasName": "Command line",
      "FieldValue": "C:\\Windows\\System32\\RuntimeBroker.exe -Embedding",
      "Operate": "strEqual",
      "HitCount": 10,
      "InternetIp": "8.210.XX.XX",
      "IntranetIp": "172.25.XX.XX",
      "InstanceName": "iZ0rqjt4wqw****",
      "InstanceId": "c208107c-3b39-4fc1-bbdb-************",
      "DisposalWay": "auto_add_white",
      "AssetScopeId": 1932,
      "AliUid": 0
    }
  ],
  "MaxResults": 20,
  "NextToken": "N6hiD08qrLdwJ9Fh0qdsJD61D5V7sa12H194Q1******"
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.