列表

本文档介绍了一组有助于您管理自定义列表的操作。

搜索自定义列表

说明

在自定义列表的记录中搜索指定字符串。如果未提供任何值，则搜索会返回所有自定义列表记录。

参数

示例

在此示例中，系统会检查自定义列表中是否有任何记录包含 .com，且该记录的类别为“已屏蔽的网域”。

操作配置

操作执行结果

• 脚本结果

  脚本结果名称	值选项	示例
  Match_records	true 或 false	true

• JSON 结果

  [{
  "entityIdentifier": "sample.com", "category": "Blocked Domains", "forDBMigration": false, "environments": ["*"], "id": 1, "creationTimeUnixTimeInMs": 1674846992575, "modificationTimeUnixTimeInMs": 1674846992575
  }]

在环境自定义列表中搜索指定字符串

说明

在当前支持请求环境的自定义列表记录中搜索指定字符串。如果未提供任何值，搜索将返回所有自定义列表记录。

参数

示例

在此示例中，系统会检查 1.1.1.1 是否包含在类别为“vuln_scanner”的自定义列表中的任何记录中。

操作配置

操作执行结果

• 脚本结果

  脚本结果名称	值选项	示例
  Match_Records	true 或 false	true

• JSON 结果

  [
    {
      "entityIdentifier": "1.1.1.1",
      "category": "vuln_scanner",
      "environments": [
        "Default Environment"
      ],
      "id": 5,
      "name": "test",
      "creationTimeUnixTimeInMs": 1673953571935,
      "modificationTimeUnixTimeInMs": 1673953571935
    }
  ]
  

字符串是否在自定义列表中

说明

检查字符串是否位于自定义列表中。

参数

示例

在此示例中，系统会检查 IP 地址 0.0.0.0 是否存在于名为 bad_ips_list 的列表类别中。

操作配置

操作结果

• 脚本结果

• JSON 结果

  {
  "Entity" : "0.0.0.0",
  "EntityResult" : "true"
  }

向自定义列表添加字符串

说明

向自定义列表添加字符串。

参数

示例

在此示例中，IP 地址 0.0.0.1 已添加到名为 bad_ips_list 的自定义列表类别中。

操作配置

操作执行结果

• 脚本结果

  脚本结果名称	值选项	示例
  NumOf FoundResults	true 或 false	true

• JSON 结果

  {
  "Entity" : "0.0.0.0",
  "EntityResult" : "true"
  }

从自定义列表中移除字符串

说明

从自定义列表中移除字符串。

参数

示例

在此示例中，IP 地址 0.0.0.1 从名为 bad_ips_list 的自定义列表类别中移除。

操作配置

操作执行结果

• 脚本结果

  脚本结果名称	值选项	示例
  NumOfFoundResults	true 或 false	true

• JSON 结果

  {
  "Entity" : "0.0.0.0",
  "EntityResult" : "true"
  }