update_stap_config
修改向指定 Guardium® 系统报告的 S-TAPs 的配置。
此 API 在 Guardium V9.5 及更高版本中可用。
REST API 语法
此 API 可通过
PUT 方法，以 REST 服务的形式使用。 请按如下方式调用此 API：PUT https://[Guardium hostname or IP address]:8443/restAPI/stap_configGuardAPI 语法
使用 updateValue 参数可修改 guard_tap.ini 文件中列出的参数。 列示的每个参数都会指出它是否与 Windows 或 Unix 相关。 您可以在此命令中指定任意参数组合。
update_stap_config parameter=value updateValue=<guard_tap.ini section name>.<parameter>:value要修改多个参数：
update_stap_config parameter=value updateValue=<guard_tap.ini section name>.<parameter>:value&<guard_tap.ini section name>.<parameter>:value...参数
注意： 这些参数中有许多是高级参数，通常只有 IBM 技术支持部门才能修改。
| 参数 | 值类型 | 描述 |
|---|---|---|
| stapHost | 字符串 | 必需。 Guardium 系统所在数据库服务器的主机名或 IP 地址，或者是主机名或 IP 地址的列表（以逗号分隔），或者是下列其中一项：
要获取有效值，请从命令行使用 |
| tap_identifier | NULL | 用于区分各个检查引擎。 如果未指定，那么 Guardium 会使用数据库类型和序列号，在此字段中自动填写唯一名称。 |
| updateValue | 字符串 | 必需。 guard_tap.ini
配置文件中的可修改参数。 有关每个参数的有效值，请参阅 Windows 和 UNIX-Linux S-TAP® 配置中的参数描述。 TAP 节：
DB 节：
SQLGUARD 节：
SQLC_n 部分 (仅限UNIX Oracle Unified Auditing):
|
| waitForResponse | 字符串 | 指定 API 是否等待来自 S-TAP的响应。 有效值：
|
| api_target_host | 字符串 | 指定执行 API 所在的目标主机。有效值：
IP 地址必须符合网络的 IP 方式。 在双重 IP 方式下，请使用向中央管理器注册受管单元时使用的 IP 协议。 例如，如果该注册使用的是 IPv6，请指定 IPv6 地址。 主机名与 IP 方式无关，可以在任何方式下使用。 |
示例
对于所有活动的 UNIX S-TAPs: 在 [TAP] 部分中，将 set all_can_control 设置为 1; 将 qrw_default_state 设置为 0; 在 [SQLGUARD] 部分中，将 num_main_thread 设置为 4:
> grdapi update_stap_config stapHost=all_unix_active updateValue=tap.all_can_control:1&tap.qrw_default_state:0&sqlguard.num_main_thread:4>grdapi update_stap_config stapHost=all_unix_active updateValue=tap.all_can_control:1
update_stap_config stapHost=all_unix_active updateValue=tap.qrw_default_state:0
update_stap_config stapHost=all_unix_active updateValue=sqlguard.num_main_thread:4
对于 Windows ，请使用此 GRDAPI 来打开防火墙。 例如：
> grdapi update_stap_config stapHost=MyHost updateValue=TAP.FIREWALL_INSTALLED:1 waitForResponse=1
ID=77039
ok
why is a specific IP address here as a valid value?