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

云安全中心

复制全文
下载 pdf
HIDS_ALARM
EditMonitorPolicy - 编辑监控策略
复制全文
下载 pdf
EditMonitorPolicy - 编辑监控策略

修改指定文件监控策略;默认策略仅允许修改生效范围,名称等元数据不可修改;策略类型与策略状态不可通过本接口修改,状态请调用 ControlMonitorPolicy。

调试

请求参数

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

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

EditMonitorPolicy

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

Version
String
是

2024-05-08

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

AllLinux
Boolean
否

true

是否监控所有linux agent

FSuffixList
Array of String
否

[".log",".conf"]

监控的文件后缀列表,最多 100 个、不可重复;仅当 AllFSuffix=false 时生效

PolicyName
String
否

example-name

监控策略名称;默认策略名称不可修改;自定义策略的 PolicyNameEN 由服务端按 PolicyName 生成;编辑策略时不传则保留原策略名称

PolicyNameEN
String
否

example-name

监控策略名称EN

PolicyPlatform
String
是

linux

操作系统平台,必填:linux Linux 主机、windows Windows 主机

HarmLevel
String
是

critical

告警等级:critical 严重、high 高危、medium 中危、low 低危

ID
String
否

resource-id-001

监控策略唯一 ID,必填,可从 ListMonitorPolicies 获取;未传入或格式非法时返回参数错误

PolicyType
String
否

default

自定义策略custom 默认策略 default

Status
String
否

close

策略状态;新增时由服务端强制置为关闭,本字段由服务端覆盖,调用方无需传入;策略开关请通过 ControlMonitorPolicy 修改

AgentIDList
Array of String
否

["agent-id-001"]

指定主机 ID 列表,可选;最多 5000 个、不可重复;非空时逐一校验主机均属于当前账户;生效范围由本字段、GroupIDList、AllLinux、AllWindows 组合确定

AllFSuffix
Boolean
否

true

是否监控全部文件类型;true 忽略 FSuffixList;false 按 FSuffixList 指定后缀过滤;不传时按 false 处理

AllWindows
Boolean
否

true

是否监控所有windows agent

DirectoryList
Array of Object
否

--

监控目录列表,可选;最多 20 个、目录项不可重复;不传时为空列表;目录项(WatchMode、SpChild、FollowLink 等)与 FSuffixList、OperatorList 共同定义策略匹配条件

GroupIDList
Array of String
否

["group-id-001"]

指定叶子分组 ID 列表,可选;最多 5000 个、不可重复;非空时逐一校验分组存在

OperatorList
Array of String
是

["write","remove"]

监控操作:修改write 删除remove 新增create 重命名rename 读取read

返回参数

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

参数
类型
示例值
描述
Data
String

success

返回结果

请求示例

POST /?Action=EditMonitorPolicy&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

{
  "AgentIDList": [
    "agent-id-001"
  ],
  "AllFSuffix": true,
  "AllLinux": true,
  "AllWindows": true,
  "DirectoryList": [
    {
      "FollowLink": true,
      "Fpath": "/var/log/example.log",
      "OnContainer": true,
      "SpChild": "sp-child-sample",
      "WatchMode": 1
    }
  ],
  "FSuffixList": [
    ".log",
    ".conf"
  ],
  "GroupIDList": [
    "group-id-001"
  ],
  "HarmLevel": "critical",
  "ID": "resource-id-001",
  "OperatorList": [
    "write",
    "remove"
  ],
  "PolicyName": "example-name",
  "PolicyNameEN": "example-name",
  "PolicyPlatform": "linux",
  "PolicyType": "default",
  "Status": "close"
}

返回示例

{
  "ResponseMetadata": {
    "RequestId": "20241120165538010234567890",
    "Action": "EditMonitorPolicy",
    "Version": "2024-05-08",
    "Service": "seccenter",
    "Region": "cn-beijing"
  },
  "Result": {
    "Data": "success"
  }
}

错误码

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

状态码
错误码
错误信息
说明
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:06:22
这个页面对您有帮助吗?
有用
有用
无用
无用