You can call this operation to create tasks that query alerts triggered by the same rule or rules of the same type.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes CreateSimilarSecurityEventsQueryTask

The operation that you want to perform.

Set the value to CreateSimilarSecurityEventsQueryTask.
SourceIp String No 1.2.3.4

The source IP address of the request.
SecurityEventId Long No 14323

The ID of the alert.
SimilarEventScenarioCode String No default

The codes of alerts that are triggered by the same rule or rules of the same type.

Response parameters

Parameter Type Example Description
RequestId String 5861EE3E-F0B3-48B8-A5DC-A5080BFBE052

The ID of the request.
CreateSimilarSecurityEventsQueryTaskResponse Struct

The response of the task that queries alerts of the same type.
TaskId Long 2915

The ID of the task.
Status String DataRetrieved

The status of the task. Valid values:

  • New: The task is new.
  • RetrievingData: The task is retrieving data.
  • DataRetrieved: The task is retrieving data.
  • Processing: The task is running
  • Success: The task is successful.
  • Failed: The task failed.
  • PartialFailed: Part of the task failed.

Examples

Sample requests

http(s)://[Endpoint]/? Action=CreateSimilarSecurityEventsQueryTask
&<Common request parameters>

Sample success responses

XML format 

<CreateSimilarSecurityEventsQueryTask>
    <CreateSimilarSecurityEventsQueryTaskResponse>
        <Status>DataRetrieved</Status>
        <TaskId>2915</TaskId>
    </CreateSimilarSecurityEventsQueryTaskResponse>
    <requestId>5861EE3E-F0B3-48B8-A5DC-A5080BFBE052</requestId>
</CreateSimilarSecurityEventsQueryTaskResponse>

JSON format 

{
    "CreateSimilarSecurityEventsQueryTaskResponse": {
      "Status": "DataRetrieved",
      "TaskId": 2915
    },
  "requestId": "5861EE3E-F0B3-48B8-A5DC-A5080BFBE052"
}

Error codes

For a list of error codes, visit the API Error Center.