All Products
Search
Document Center

Security Center:ListObjectScanEvent

Last Updated:Feb 20, 2024

Queries alerts that are generated for malicious files.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
CurrentPageintegerYes

The page number.

1
PageSizeintegerYes

The number of entries per page.

20
RiskLevelstringNo

The risk level of the alert. Valid values:

  • high
  • medium
  • low
low
EventNamestringNo

The name of the alert.

WebShell
SourcestringNo

The method that is used to detect the malicious file. Valid values:

  • API: uses API operations.
  • OSS: uses Object Storage Service (OSS) file check.
OSS
OssKeystringNo

The key of the file that is stored in an OSS bucket.

1/2022/06/23/15/41/16559701077444693a0c6-33b2-4cc2-a99f-9f38b8b8****
BucketNamestringNo

The name of the OSS bucket.

ltrbuck****
LangstringNo

The language of the content within the request and response. Default value: zh. Valid values:

  • zh: Chinese
  • en: English
zh
Md5stringNo

The MD5 hash value of the file.

0552c44e243abdea1729d4507bce****
TimeStartlongNo

The beginning of the time range during which the exception is detected.

1683603086000
TimeEndlongNo

The end of the time range during which the exception is detected.

1683862286000

Response parameters

ParameterTypeDescriptionExample
object

The response parameters.

RequestIdstring

The request ID.

7BC55C8F-226E-5AF5-9A2C-2EC43864****
PageInfoobject

The pagination information.

CurrentPageinteger

The page number.

1
PageSizeinteger

The number of entries per page.

20
TotalCountinteger

The total number of entries returned.

253
Dataobject []

The data returned.

OssKeystring

The key of the file that is stored in the OSS bucket.

1/2023/07/21/10/18/16899059356518bcf6c64-a04e-492d-a421-4ae8b888****
Md5string

The MD5 hash value of the file.

5b394b54ca632fe51c4ab4a6dbaf****
BucketNamestring

The name of the OSS bucket.

hz-new01****
RiskLevelstring

The risk level of the alert. Valid values:

  • high
  • medium
  • low
medium
Sourcestring

The method that is used to detect the malicious file. Valid values:

  • API: uses API operations.
  • OSS: uses OSS file check.
OSS
FilePathstring

The path to the file.

/usr/local****
EventNamestring

The name of the alert.

WebShell
EventIdlong

The ID of the alert.

911273
FirstTimelong

The timestamp at which the alert was first detected.

1694576692000
LastTimelong

The timestamp at which the alert was last detected.

1694576692000
Sha256string

The SHA-256 hash value of the file.

3a6fed5fc11392b3ee9f81caf017b48640d7458766a8eb0382899a605b41****
Sha1string

The SHA-1 hash value of the file.

3c01bdbb26f358bab27f267924aa2c9a03fc****
DisplaySandboxResultstring

Indicates whether the file can be detected by cloud sandbox. Valid values:

  • true
  • false
true
Detailsobject []

The details of the file.

Namestring

The name of the parameter in the file details.

DownloadUrl
NameDisplaystring

The display name of the alert.

DownloadUrl
Typestring

The value type of the parameter in the file details.

html
Valuestring

The value of the parameter.

http://gcx.cn-hangzhou.aliyuncs.com/****
ValueDisplaystring

The value of the parameter.

http://gcx.cn-hangzhou.aliyuncs.com/****

Examples

Sample success responses

JSONformat

{
  "RequestId": "7BC55C8F-226E-5AF5-9A2C-2EC43864****",
  "PageInfo": {
    "CurrentPage": 1,
    "PageSize": 20,
    "TotalCount": 253
  },
  "Data": [
    {
      "OssKey": "1/2023/07/21/10/18/16899059356518bcf6c64-a04e-492d-a421-4ae8b888****",
      "Md5": "5b394b54ca632fe51c4ab4a6dbaf****",
      "BucketName": "hz-new01****",
      "RiskLevel": "medium",
      "Source": "OSS",
      "FilePath": "/usr/local****",
      "EventName": "WebShell",
      "EventId": 911273,
      "FirstTime": 1694576692000,
      "LastTime": 1694576692000,
      "Sha256": "3a6fed5fc11392b3ee9f81caf017b48640d7458766a8eb0382899a605b41****",
      "Sha1": "3c01bdbb26f358bab27f267924aa2c9a03fc****",
      "DisplaySandboxResult": "true",
      "Details": [
        {
          "Name": "DownloadUrl",
          "NameDisplay": "DownloadUrl",
          "Type": "html",
          "Value": "http://gcx.cn-hangzhou.aliyuncs.com/****",
          "ValueDisplay": "http://gcx.cn-hangzhou.aliyuncs.com/****"
        }
      ]
    }
  ]
}

Error codes

HTTP status codeError codeError messageDescription
403NoPermissioncaller has no permissionYou are not authorized to do this operation.
500ServerErrorServerError-

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