All Products
Search
Document Center

Security Center:QueryIncidentTracingDetail

Last Updated:Nov 14, 2024

Queries the provenance graph of an event by using the event ID.

Debugging

You can run this interface directly in OpenAPI Explorer, saving you the trouble of calculating signatures. After running successfully, OpenAPI Explorer can automatically generate SDK code samples.

Authorization information

The following table shows the authorization information corresponding to the API. The authorization information can be used in the Action policy element to grant a RAM user or RAM role the permissions to call this API operation. Description:

  • Operation: the value that you can use in the Action element to specify the operation on a resource.
  • Access level: the access level of each operation. The levels are read, write, and list.
  • Resource type: the type of the resource on which you can authorize the RAM user or the RAM role to perform the operation. Take note of the following items:
    • The required resource types are displayed in bold characters.
    • If the permissions cannot be granted at the resource level, All Resources is used in the Resource type column of the operation.
  • Condition Key: the condition key that is defined by the cloud service.
  • Associated operation: other operations that the RAM user or the RAM role must have permissions to perform to complete the operation. To complete the operation, the RAM user or the RAM role must have the permissions to perform the associated operations.
OperationAccess levelResource typeCondition keyAssociated operation
yundun-sas:QueryIncidentTracingDetailget
  • All Resources
    *
    none
none

Request parameters

ParameterTypeRequiredDescriptionExample
IncidentIdstringYes

The ID of the event.

Note You can call the DescribeCloudSiemEvents operation to query the IDs of events.
184892fc5245b3ce8c3316434c94261f

Response parameters

ParameterTypeDescriptionExample
object

The provenance graph.

TracingDetailobject

The information about the provenance graph.

VertexListarray<object>

The nodes.

VertexListobject
Idstring

The ID of the current node.

383044
Namestring

The name of the current node.

auto-test-attestor
Typestring

The type of the current node. Valid values include the following values:

  • process
  • file
  • alert
  • ip
  • domain
alidetect
Timestring

The time when the current node was created.

2021-11-26
Timestamplong

The UNIX timestamp when the current node was created. Unit: milliseconds.

1663048980
Uuidstring

The UUID of the current node. The security information and event management (SIEM) system generates UUIDs for nodes and edges in the provenance graph to help you locate the nodes or edges.

32e36d8a-2b5d-4f71-98a8-12775685a3b4
RuleIdstring

The ID of the rule based on which the current node is generated.

301425
Propertiesstring

The text that contains the properties of the current node.

[{'PropertyValues': [{'PropertyValueId': 239, 'PropertyValue': '121'}, {'PropertyValueId': 240, 'PropertyValue': '6666'}], 'PropertyKey': '22222222', 'PropertyId': 203}]
Propertyobject

The property of the current node.

{\"coverage\":\"global\"}
UpdateTimestring

The time when the current node was updated.

2022-01-13 12:49:33
Aliuidstring

The ID of the Alibaba Cloud account to which the current node belongs.

1487146717137516
NeighborListarray<object>

The nodes that are adjacent to the current node.

NeighborListobject
Typestring

The type of the node. Valid values include the following values:

  • process
  • file
  • alert
  • ip
  • domain
2
Countinteger

The number of nodes.

0
HasMoreboolean

Indicates whether more nodes are adjacent to the current node. Valid values:

  • true
  • false
True
DisplayInfoarray<object>

The display information of the current node.

DisplayInfoobject
Namestring

The name of the property that needs to be displayed for the current node.

scan:ACSV-2020-111301
Valuestring

The value of the property that needs to be displayed for the current node.

10.16.1
Langstring

The rendering language of the current node.

zh
EdgeListarray<object>

The edges.

EdgeListobject
StartIdstring

The ID of the start node for the current edge.

23003
StartTypestring

The type of the start node for the current edge. Valid values include the following values:

  • process
  • file
  • alert:
  • ip
  • domain
process
EndIdstring

The ID of the end node for the current edge.

223a185f05e5fc3c637
EndTypestring

The type of the end node for the current edge. Valid values include the following values:

  • process
  • file
  • alert
  • ip
  • domain
process_test_process
Namestring

The name of the current edge.

mongod
Typestring

The type of the current edge. Valid values include the following values:

  • process_exec_file: The relationship indicates an executable file that is run by a process.
  • process_connect_ip: The relationship indicates an IP address that is connected by a process.
  • domain_trgger_alert: The relationship indicates an alert that is triggered for a domain name.
elf
Timestring

The time when the current edge was created.

1652941117
Timestamplong

The UNIX timestamp when the current edge was created. Unit: milliseconds.

1636092632
Aliuidstring

The ID of the Alibaba Cloud account to which the current edge belongs.

1277498600854739
Uuidstring

The UUID of the current edge. The SIEM system generates UUIDs for nodes and edges in the provenance graph to help you locate the nodes or edges.

678e29f4-d78f-4a7c-a2bc-38434a138538
Originstring

The origin vertex ID of the current edge.

distribution
Propertiesstring

The text that contains the properties of the current edge.

{\"bandWidth\":\"8192\",\"internetIp\":\"8.211.13.50\",\"changeReason\":\"EIP_BIND\",\"bindInstanceId\":\"i-gw887xhzjvyjfv7vdfs3\",\"bindType\":\"EIP_ECS\"}
Propertyobject

The property of the current edge.

{\"coverage\":\"global\"}
ShowTypestring

The display type of the current edge.

0
RuleIdstring

The ID of the rule based on which the current edge is generated.

136
UpdateTimestring

The time when the current edge was updated.

2022-01-13 12:49:33
TypeNamestring

The type of the current edge.

cis
EntityTypeListarray<object>

The entities.

EntityTypeListobject
Idstring

The ID of the current entity.

1425
Namestring

The type of the current entity. Valid values include the following values:

  • process
  • file
  • alert
  • ip
  • domain
auto-test-policy-name
GmtCreatestring

The time when the current entity was created.

2022-10-09T10:53Z
GmtModifiedstring

The time when the current entity was updated.

1585816811000
Namespacestring

The namespace of the current entity.

78
DisplayTemplatestring

The display template of the current entity.

[]
DisplayColorstring

The display color of the current entity.

#FFF
SyncIdinteger

The synchronization ID of the current entity.

e2fdf402-b4ed-4e1a-9e95-44d6069600b0
CurrentVersionIdstring

The version ID of the current entity.

1768
DisplayIconstring

The display icon of the current entity.

-
DisplayOrderinteger

The display sequence of the current entity.

2
TraceSuccessFlaginteger

The tag that indicates whether tracing was successful. Valid values:

  • 1: successful
  • 0: failed
1
IsVirtualNodeinteger

Indicates whether the entity is a virtual node. Valid values:

  • 1: yes
  • 0: no
1
RelationTypeListarray<object>

The relationships.

RelationTypeListobject
Idstring

The ID of the current relationship.

1514
Namestring

The type of the current relationship. Valid values include the following values:

  • process_exec_file: The relationship indicates an executable file that is run by a process.
  • process_connect_ip: The relationship indicates an IP address that is connected by a process.
  • domain_trgger_alert: The relationship indicates an alert that is triggered for a domain name.
wusa
Directedinteger

The direction of the current relationship. Valid values:

  • 1: forward
  • 0: reverse
1
GmtCreatestring

The time when the current relationship was created.

2022-09-23T10:50Z
GmtModifiedstring

The time when the current relationship was updated.

2022-07-12T07:58:49Z
Namespacestring

The namespace of the current relationship.

default
DisplayTemplatestring

The display template of the current relationship.

[]
DisplayColorstring

The display color of the current relationship.

#FFF
SyncIdinteger

The synchronization ID of the current relationship.

sync-0000aws50gyy2ocisbmx
CurrentVersionIdstring

The version ID of the current relationship.

1487
ShowTypestring

The display type of the current relationship.

0
DisplayIconstring

The display icon of the current relationship.

https://img.alicdn.com/imgextra/i2/O1CN01jpZwD31G56XYPEJv2_!!600000000****-55-tps-25-28.svg
Langstring

The rendering language of the returned result. Valid values:

  • zh: Chinese
  • en: English
zh
Successboolean

Indicates whether the request was successful. Valid values:

  • true
  • false
True
RequestIdstring

The request ID.

D2956025-4E5C-529D-92B4-B2591DDED067

Examples

Sample success responses

JSONformat

{
  "TracingDetail": {
    "VertexList": [
      {
        "Id": "383044",
        "Name": "auto-test-attestor",
        "Type": "alidetect",
        "Time": "2021-11-26",
        "Timestamp": 1663048980,
        "Uuid": "32e36d8a-2b5d-4f71-98a8-12775685a3b4",
        "RuleId": "301425",
        "Properties": "[{'PropertyValues': [{'PropertyValueId': 239, 'PropertyValue': '121'}, {'PropertyValueId': 240, 'PropertyValue': '6666'}], 'PropertyKey': '22222222', 'PropertyId': 203}]",
        "Property": {
          "test": "test",
          "test2": 1
        },
        "UpdateTime": "2022-01-13 12:49:33",
        "Aliuid": "1487146717137516",
        "NeighborList": [
          {
            "Type": "2",
            "Count": 0,
            "HasMore": true
          }
        ],
        "DisplayInfo": [
          {
            "Name": "scan:ACSV-2020-111301",
            "Value": "10.16.1"
          }
        ],
        "Lang": "zh"
      }
    ],
    "EdgeList": [
      {
        "StartId": "23003",
        "StartType": "process",
        "EndId": "223a185f05e5fc3c637",
        "EndType": "process_test_process",
        "Name": "mongod",
        "Type": "elf",
        "Time": "1652941117",
        "Timestamp": 1636092632,
        "Aliuid": "1277498600854739",
        "Uuid": "678e29f4-d78f-4a7c-a2bc-38434a138538",
        "Origin": "distribution",
        "Properties": "{\\\"bandWidth\\\":\\\"8192\\\",\\\"internetIp\\\":\\\"8.211.13.50\\\",\\\"changeReason\\\":\\\"EIP_BIND\\\",\\\"bindInstanceId\\\":\\\"i-gw887xhzjvyjfv7vdfs3\\\",\\\"bindType\\\":\\\"EIP_ECS\\\"}",
        "Property": {
          "test": "test",
          "test2": 1
        },
        "ShowType": "0",
        "RuleId": "136",
        "UpdateTime": "2022-01-13 12:49:33",
        "TypeName": "cis"
      }
    ],
    "EntityTypeList": [
      {
        "Id": "1425",
        "Name": "auto-test-policy-name",
        "GmtCreate": "2022-10-09T10:53Z",
        "GmtModified": "1585816811000",
        "Namespace": "78",
        "DisplayTemplate": "[]",
        "DisplayColor": "#FFF",
        "SyncId": 0,
        "CurrentVersionId": "1768",
        "DisplayIcon": "-",
        "DisplayOrder": 2,
        "TraceSuccessFlag": 1,
        "IsVirtualNode": 1
      }
    ],
    "RelationTypeList": [
      {
        "Id": "1514",
        "Name": "wusa",
        "Directed": 1,
        "GmtCreate": "2022-09-23T10:50Z",
        "GmtModified": "2022-07-12T07:58:49Z",
        "Namespace": "default",
        "DisplayTemplate": "[]",
        "DisplayColor": "#FFF",
        "SyncId": 0,
        "CurrentVersionId": "1487",
        "ShowType": "0",
        "DisplayIcon": "https://img.alicdn.com/imgextra/i2/O1CN01jpZwD31G56XYPEJv2_!!600000000****-55-tps-25-28.svg"
      }
    ],
    "Lang": "zh"
  },
  "Success": true,
  "RequestId": "D2956025-4E5C-529D-92B4-B2591DDED067"
}

Error codes

HTTP status codeError codeError messageDescription
400TracingDetailErrorThe Incident tracing detail error, please try again.-
403NoPermissioncaller has no permissionYou are not authorized to do this operation.
500ServerErrorServerError-

For a list of error codes, visit the Service error codes.

Change history

Change timeSummary of changesOperation
No change history