更新补丁管理维护窗口
此方法用于修改补丁管理的维护窗口。
参数
|
参数 |
描述 |
请求包含项 |
类型 |
取值 |
|---|---|---|---|---|
|
|
您想为补丁管理窗口指定的名称。 |
必填 |
字符串 |
可选值：
|
|
|
需创建维护窗口的目标公司ID。 |
可选 |
字符串 |
默认值：生成API密钥的用户所属关联公司的ID。 要求：
|
|
|
指示目标是否为客户公司。 |
必填 |
布尔值 |
无附加要求。 |
|
|
通过此数组配置待创建维护窗口的补丁管理设置。 |
必填 |
对象数组 |
参见??? |
对象
downloadSettings
|
参数 |
描述 |
类型 |
值 |
|---|---|---|---|
|
|
用于指定要使用的补丁缓存服务器。数组中的位置应解释为优先级。 |
对象数组 |
包含以下信息：
|
|
|
确定是否启用直接下载设置。 |
布尔值 |
无额外要求。 |
installPatchesSettings
|
参数 |
描述 |
类型 |
值 |
|---|---|---|---|
|
|
指示启用时补丁是否自动应用。对应 应用补丁 开关在 GravityZone 控制台中。 |
布尔值 |
无额外要求。 |
|
|
指示如果任务未执行，将尽快重试。 |
布尔值 |
无额外要求。 |
|
|
指定您希望包含或排除在补丁更新范围内的供应商及产品。 |
对象 |
包含以下信息：
|
|
|
指定是否希望在应用补丁后延迟系统重启。 |
对象 |
包含以下信息：
|
|
|
用于启用并将特定设置应用于安全或非安全更新。 |
对象 |
包含以下信息：
|
|
|
唯一补丁ID列表。 |
字符串数组 |
补丁ID必须有效且属于创建维护窗口的公司。 提示
您可以使用
|
警告
-
如果
enabled参数位于installPatchesSettings对象中并分配了true值，则需要将true值分配给以下参数之一：-
位于
enabled参数下的securityPatchesSettings选项。它们位于updateType对象下，该对象又位于installPatchesSettings对象下。 -
位于
enabled参数下的nonSecurityPatchesSettings选项。它们位于updateType对象下，该对象又位于installPatchesSettings对象下。
-
-
如果
enabled参数在installPatchesSettings对象中被赋值为false，则需要确保以下参数均未赋值为true：-
位于
enabled参数下的securityPatchesSettings选项。它们位于updateType对象，位于installPatchesSettings对象下。 -
在
enabled参数位于nonSecurityPatchesSettings选项下。它们可以在updateType对象下找到，该对象位于installPatchesSettings对象下。
-
-
如果
enabled参数在installPatchesSettings对象中被赋值为true，则enabled参数在scanPatchesSettings对象中也必须被赋值为true。
vendorProductsPairs
|
参数 |
描述 |
类型 |
值 |
|---|---|---|---|
|
|
供应商-产品组合兼容的操作系统。 当特定供应商-产品组合兼容多个操作系统时，可使用此属性。 |
整数 |
可选值：
默认值：
重要提示提供给此属性的值必须与请求中指定的供应商-产品组合兼容。使用无效组合将导致错误。 |
|
|
包含一个或多个供应商。 |
对象 |
该对象包含以下属性：
|
|
|
包含一个或多个产品 |
对象数组 |
该对象包含以下属性：
|
between
|
参数 |
描述 |
类型 |
取值范围 |
|---|---|---|---|
|
|
事件设定的开始小时。 |
整数 |
取值范围为
|
|
|
事件设定的开始分钟。 |
整数 |
取值范围为
|
|
|
事件设定的结束小时。 |
整数 |
取值范围在
|
|
|
事件设定的结束分钟。 |
整数 |
取值范围在
|
注意
startHour:startMinute
必须小于
endHour:endMinute
scheduler
|
参数 |
描述 |
类型 |
取值 |
|---|---|---|---|
|
|
设置特定任务的执行频率 |
整数 |
可选值：
|
|
|
若选择当日，则指示当前纪元时间（10位字符，秒级精度）。 |
整数 |
必须为大于
|
|
|
设置任务运行的时间间隔 |
对象 |
更多信息请参阅???。 |
|
|
决定每周任务的执行频率。
该参数仅在
|
对象 |
包含以下信息：
|
|
|
确定每月任务的频率。
此参数仅在
|
对象 |
包含以下信息：
|
oldScheduler
|
参数 |
描述 |
类型 |
取值 |
|---|---|---|---|
|
|
设置任务运行的频率 |
整数 |
可能取值：
|
|
|
事件设定的开始小时。 |
整数 |
可能取值：
|
|
|
事件设定的开始分钟。 |
整数 |
可能取值：
|
|
|
设置任务在每周的特定日期重复执行。 |
整数数组 |
可能取值：
|
scanPatchesSettings
|
参数 |
描述 |
类型 |
取值 |
|---|---|---|---|
|
|
指示是否自动执行扫描以搜索新补丁。对应 扫描补丁 开关位于 GravityZone 控制台中。 |
布尔值 |
无额外要求。 |
|
|
指示安装新支持的应用程序时是否扫描可用补丁。对应 安装新应用程序时智能扫描补丁 开关位于 GravityZone 控制台中。 |
布尔值 |
无额外要求。 |
|
|
在当前计划系统（
|
字符串 |
可选值：
|
|
|
将此计划设置为所有任务的默认计划。对应 对所有目标操作使用相同计划 GravityZone 控制台中的 开关。 |
布尔值 |
无额外要求。 |
|
|
设置特定计划。 |
对象 |
包含以下信息
注意
若
|
|
|
使用后备系统设置特定计划。 |
对象 |
包含以下信息：
|
返回值
此方法返回布尔值true或false，表示维护窗口是否成功更新。
示例
请求 :
{
"method": "updatePatchManagementMaintenanceWindow",
"id": "a7f1d11d-3c94-47f0-a599-b48d2fc44241",
"jsonrpc": "2.0",
"params": {
"id": "61974ab63bdfe97a6c34fe4d",
"settings": {
"downloadSettings": {
"cachingServers": [
],
"fallbackOnDirectDownload": true
},
"installPatchesSettings": {
"enabled": true,
"ifMissedRunAsSoonAsPossible": true,
"specificVendorAndProduct": {
"type": 1,
"enabled": false,
"vendorProductsPairs": [
{
"os": 3,
"vendor": {
"id": "Oracle"
},
"products": [
{
"id": "java-11-openjdk 11"
},
{
"id": "java-1.8.0-openjdk"
}
]
},
{
"vendor": {
"id": "Inkscape"
},
"products": [
{
"id": "0"
}
]
},
{
"vendor": {
"id": "65"
},
"products": [
{
"id": "15694"
}
]
}
]
},
"postponeReboot": {
"option": 0
},
"updateType": {
"nonSecurityPatchesSettings": {
"enabled": true,
"scheduler": {
"recurrence": 3,
"startDate": 1637258826,
"between": {
"startHour": 21,
"startMinute": 0,
"endHour": 23,
"endMinute": 59
},
"weeklyRecurrence": {
"every": 1,
"days": [
1,
2,
3,
4,
5,
6,
0
]
}
},
},
"securityPatchesSettings": {
"enabled": true,
"scheduler": {
"recurrence": 1
},
"manuallyApprovedPatchesSettings": {
"enabled": True,
"scheduler": {
"recurrence": 1
}
}
}
"manuallyApprovedPatchIds": [
"{00016C6E-0000-0000-0000-000000000000}",
"{0001354A-0000-0000-0000-000000000000}"
]
},
"scanPatchesSettings": {
"enabled": true,
"useSameSchedule": false,
"useFallbackSchedule": true,
"runOnSystemChanges": true,
"scheduler": {
"recurrence": 3,
"startDate": 1637258826,
"between": {
"startHour": 21,
"startMinute": 0,
"endHour": 23,
"endMinute": 59
},
"weeklyRecurrence": {
"every": 1,
"days": [
1,
2,
3,
4,
5,
6,
0
]
}
},
}
}
}
}
响应 :
{
"id" : "a7f1d11d-3c94-47f0-a599-b48d2fc44241",
"jsonrpc" : "2.0",
"result" : {
"success" : true
}
}