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

云安全中心

复制全文
下载 pdf
HIDS_TENANT
ModifyTLSConfig - 修改现有日志设置
复制全文
下载 pdf
ModifyTLSConfig - 修改现有日志设置

修改当前账户的日志分析告警阈值及各日志主题开关、存储时长。Result.Data 为 success 表示操作成功,无额外业务数据。

调试

请求参数

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

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

ModifyTLSConfig

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

Version
String
是

2024-05-08

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

LoginTopicConfig
Object
否

--

登录流水日志配置;不传时保留原配置

PortChangeTopicConfig
Object
否

--

端口变更日志配置;不传时保留原配置

ProcessStartTopicConfig
Object
否

--

进程启动日志配置;不传时保留原配置

StorageDays
Long
否

30

1.2.0废弃
已废弃的兼容字段,单位天;仍会覆盖顶层及安全告警、漏洞扫描主题的存储时长,未传时按 0 处理,新接入应改传各 TopicConfig.StorageDays

Threshold
Long
否

80

告警阈值,必填且始终参与校验;不传时按 0 参与校验并覆盖原阈值,不保留原值。预付费单位为百分比、范围 50-100,不传(0)小于 50 校验失败;后付费单位为 GB、范围 0-1000000,取 0 表示不告警,不传(0)合法但会将原阈值覆盖为 0

VulnTopicConfig
Object
否

--

漏洞扫描日志配置;不传时保留原开关,但存储时长会使用已废弃的顶层 StorageDays(顶层未传时为 0)

AlarmTopicConfig
Object
否

--

安全告警日志配置;不传时保留原开关,但存储时长会使用已废弃的顶层 StorageDays(顶层未传时为 0)

BashAuditTopicConfig
Object
否

--

bash 内置命令审计日志配置;不传时保留原配置,传入时仅对白名单账户生效

返回参数

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

参数
类型
示例值
描述
Data
String

success

操作结果,success 表示配置修改成功且无额外业务数据

请求示例

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

{
  "AlarmTopicConfig": {
    "StorageDays": 30,
    "Switch": true
  },
  "BashAuditTopicConfig": {
    "StorageDays": 30,
    "Switch": true
  },
  "LoginTopicConfig": {
    "StorageDays": 30,
    "Switch": true
  },
  "PortChangeTopicConfig": {
    "StorageDays": 30,
    "Switch": true
  },
  "ProcessStartTopicConfig": {
    "StorageDays": 30,
    "Switch": true
  },
  "StorageDays": 30,
  "Threshold": 80,
  "VulnTopicConfig": {
    "StorageDays": 30,
    "Switch": true
  }
}

返回示例

{
  "ResponseMetadata": {
    "RequestId": "20241120165538010234567890",
    "Action": "ModifyTLSConfig",
    "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:11:14
这个页面对您有帮助吗?
有用
有用
无用
无用