调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

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

参数	类型	是否必填	示例值	描述
Action	String	是	AddMonitorPolicy	要执行的操作，取值：AddMonitorPolicy。
Version	String	是	2024-05-08	API的版本，取值：2024-05-08。
AllFSuffix	Boolean	否	true	是否监控全部文件类型；true 忽略 FSuffixList；false 按 FSuffixList 指定后缀过滤；不传时按 false 处理
AllWindows	Boolean	否	true	是否监控所有windows agent
DirectoryList	Array of Object	否	--	监控目录列表，可选；最多 20 个、目录项不可重复；不传时为空列表；目录项（WatchMode、SpChild、FollowLink 等）与 FSuffixList、OperatorList 共同定义策略匹配条件
PolicyType	String	否	default	自定义策略custom 默认策略 default
AgentIDList	Array of String	否	["agent-id-001"]	指定主机 ID 列表，可选；最多 5000 个、不可重复；非空时逐一校验主机均属于当前账户；生效范围由本字段、GroupIDList、AllLinux、AllWindows 组合确定
GroupIDList	Array of String	否	["group-id-001"]	指定叶子分组 ID 列表，可选；最多 5000 个、不可重复；非空时逐一校验分组存在
PolicyName	String	否	example-name	监控策略名称；默认策略名称不可修改；自定义策略的 PolicyNameEN 由服务端按 PolicyName 生成；编辑策略时不传则保留原策略名称
FSuffixList	Array of String	否	[".log",".conf"]	监控的文件后缀列表，最多 100 个、不可重复；仅当 AllFSuffix=false 时生效
OperatorList	Array of String	是	["write","remove"]	监控操作：修改write 删除remove 新增create 重命名rename 读取read
HarmLevel	String	是	critical	告警等级：critical 严重、high 高危、medium 中危、low 低危
PolicyNameEN	String	否	example-name	监控策略名称EN
PolicyPlatform	String	是	linux	操作系统平台，必填：linux Linux 主机、windows Windows 主机
Status	String	否	close	策略状态；新增时由服务端强制置为关闭，本字段由服务端覆盖，调用方无需传入；策略开关请通过 ControlMonitorPolicy 修改
AllLinux	Boolean	否	true	是否监控所有linux agent

返回参数

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

参数	类型	示例值	描述
Data	String	success	返回结果

请求示例

POST /?Action=AddMonitorPolicy&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",
  "OperatorList": [
    "write",
    "remove"
  ],
  "PolicyName": "example-name",
  "PolicyNameEN": "example-name",
  "PolicyPlatform": "linux",
  "PolicyType": "default",
  "Status": "close"
}

返回示例

{
  "ResponseMetadata": {
    "RequestId": "20241120165538010234567890",
    "Action": "AddMonitorPolicy",
    "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:21

这个页面对您有帮助吗？

有用

无用

云安全中心

调试 #

请求参数 #

返回参数 #

请求示例 #

返回示例 #

错误码 #

调试

请求参数

返回参数

请求示例

返回示例

错误码