You need to enable JavaScript to run this app.
文档中心
云安全中心

云安全中心

复制全文
下载 pdf
HIDS_RASP
EditRaspConfig - 编辑RASP配置
复制全文
下载 pdf
EditRaspConfig - 编辑RASP配置

根据配置 ID 更新 RASP 防护配置的匹配条件、规则、防护模式和启用状态。

调试

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

参数
类型
是否必填
示例值
描述
Action
String
是

EditRaspConfig

要执行的操作,取值:EditRaspConfig。

Version
String
是

2024-05-08

API的版本,取值:2024-05-08。

Filters
Array of Object
否

--

过滤规则列表;编辑时整组覆盖,不传或空数组将清空原有规则;非内部租户不可配置阻断或过滤规则

IfProtect
Boolean
否

true

配置是否生效

BlockUuid
String
否

block-uuid-id-001

阻断规则uuid

Blocks
Array of Object
否

--

阻断规则列表;编辑时整组覆盖,不传或空数组将清空原有规则;非内部租户不可配置阻断或过滤规则

Name
String
是

example-name

配置名称

Runtime
String
是

JVM

运行时类型,必填,取值:JVM(Java 应用)、CPython(Python 应用)、Golang(Go 应用)、NodeJS(Node.js 应用)、PHP(PHP 应用)

TopGroupID
String
否

group-id-001

根分组ID

AllProcessInject
Boolean
否

true

是否注入全部进程;不传时按 false 处理;编辑时整组覆盖原配置

ID
String
是

resource-id-001

配置ID,可从 ListRaspConfigs 获取

LocalProjectInject
Boolean
否

true

是否注入本地进程

ProtectMethod
String
是

manual

防护开启方式 auto:自动开启 manual:手动开启

Range
Object
是

--

范围

Switch
Object
否

--

开关配置(文件、内存马、进程、网络、反射类、加载类、类文件上传开关);编辑时整组覆盖,不传时原有开关配置将被清空

FilterUuid
String
否

filter-uuid-id-001

过滤规则uuid

InjectConfigList
Array of Object
否

--

注入进程变量过滤条件列表;编辑时整组覆盖,不传或空数组将清空原有注入条件

返回参数

下表仅列出本接口特有的返回参数。更多信息请参见返回结构。

参数
类型
示例值
描述
Success
Boolean

true

操作是否成功;true 表示成功,false 表示失败

请求示例

POST /?Action=EditRaspConfig&Version=2024-05-08 HTTP/1.1
Host: seccenter.volcengineapi.com
Content-Type: application/json; charset=UTF-8
X-Date: 20241120T080538Z
X-Content-Sha256: 287e874e******d653b44d21e
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20241120/cn-beijing/seccenter/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f

{
  "AllProcessInject": true,
  "BlockUuid": "block-uuid-id-001",
  "Blocks": [
    {
      "HookFunc": [
        "java.lang.Runtime.exec"
      ],
      "HookParam": 1,
      "Rules": [
        {
          "Rule": "rule-sample",
          "Type": "include"
        }
      ],
      "Runtime": "Java"
    }
  ],
  "FilterUuid": "filter-uuid-id-001",
  "Filters": [
    {
      "HookFunc": [
        "java.lang.Runtime.exec"
      ],
      "HookParam": 1,
      "Rules": [
        {
          "Rule": "rule-sample",
          "Type": "include"
        }
      ],
      "Runtime": "Java"
    }
  ],
  "ID": "resource-id-001",
  "IfProtect": true,
  "InjectConfigList": [
    {
      "MatchContent": [
        "java.lang.Runtime.exec"
      ],
      "MatchKey": "exe_name",
      "MatchType": 1
    }
  ],
  "LocalProjectInject": true,
  "Name": "example-name",
  "ProtectMethod": "manual",
  "Range": {
    "AgentIDList": [
      "agent-id-001"
    ],
    "AllHost": true,
    "LeafGroupIDs": [
      "group-id-001"
    ],
    "SingleGroupPath": "/production/web",
    "SingleHostname": "host-001"
  },
  "Runtime": "JVM",
  "Switch": {
    "classupload": true,
    "file": true,
    "load": true,
    "memshell": true,
    "net": true,
    "process": true,
    "reflect": true
  },
  "TopGroupID": "group-id-001"
}

返回示例

{
  "ResponseMetadata": {
    "RequestId": "20241120165538010234567890",
    "Action": "EditRaspConfig",
    "Version": "2024-05-08",
    "Service": "seccenter",
    "Region": "cn-beijing"
  },
  "Result": {
    "Success": true
  }
}

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码
错误码
错误信息
说明
400
MissingParameter

The required parameter %s is missing.

请求参数缺失,请检查参数是否已正确传入。

400
InvalidParameter

The specified parameter %s is invalid.

请求参数错误,请检查参数传递内容是否正确。

400
OperationDenied

Operation is denied because the specified resource is in use.

不允许的操作,请检查当前资源是否被占用。

500
InternalError

The request has failed due to an unknown error.

服务器内部错误,请稍后重试或联系技术支持。

500
DBOperateError

The request has failed because database return error: %s

数据库操作异常,请稍后重试或联系技术支持。

最近更新时间:2026.10.30 14:11:15
这个页面对您有帮助吗?
有用
有用
无用
无用