接口功能介绍

设置Windows更新模式；CUSTOM_WSUS模式下可配置更新服务、安装计划和高级选项。

接口约束

无

URI

POST /v3/strategy/windowsUpdate

路径参数 无

Query参数

参数	是否必填	参数类型	说明	示例	下级对象
regionId	是	String	资源池ID。	xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

请求参数

请求头header参数 无

请求体body参数

参数	是否必填	参数类型	说明	示例	下级对象
strategyOid	是	String	策略Oid。
windowsUpdatePolicy	是	Object	Windows更新策略配置。		windowsUpdatePolicy

表 windowsUpdatePolicy

参数	是否必填	参数类型	说明	示例	下级对象
mode	是	String	Windows更新模式。取值： - DISABLED：禁止更新。 - AUTOMATIC：自动更新。 - CUSTOM_WSUS：自定义WSUS。
customWsus	否	Object	CUSTOM_WSUS模式必填。其他模式不得提交。		customWsus

表 customWsus

参数	是否必填	参数类型	说明	下级对象
name	是	String	WSUS服务器名称。长度1~50个字符。
description	否	String	WSUS服务器描述。最长255个字符。
updateService	是	Object	Intranet Microsoft更新服务配置。	updateService
automaticUpdates	是	String	自动更新状态。取值： - INHERIT：继承（未配置）。 - ENABLED：启用。 - DISABLED：禁用。
updateMode	是	String	自动更新方式。取值： - NOTIFY_DOWNLOAD_AND_AUTO_INSTALL：通知下载并自动安装。 - AUTO_DOWNLOAD_NOTIFY_INSTALL：自动下载并通知安装。 - AUTO_DOWNLOAD_SCHEDULE_INSTALL：自动下载并计划安装。 - LOCAL_ADMIN_SELECT_SETTING：由本地管理员选择设置。 - AUTO_DOWNLOAD_NOTIFY_INSTALL_AND_RESTART：自动下载、通知安装和重启。
installDay	是	String	计划安装日。取值： - EVERY_DAY：每天。 - SUNDAY：星期日。 - MONDAY：星期一。 - TUESDAY：星期二。 - WEDNESDAY：星期三。 - THURSDAY：星期四。 - FRIDAY：星期五。 - SATURDAY：星期六。
installTime	是	Object	计划安装时间。	installTime
automaticMaintenanceEnable	是	Boolean	是否在自动维护期间执行计划安装。
detectionFrequency	是	Object	自动更新检测频率配置。	detectionFrequency
targetGroup	是	Object	客户端目标组配置。	targetGroup
autoInstallMinorUpdates	是	String	是否立即安装次要更新。取值： - INHERIT：继承（未配置）。 - ENABLED：启用。 - DISABLED：禁用。
elevateNonAdmins	是	String	是否允许非管理员接受更新通知。取值： - INHERIT：继承（未配置）。 - ENABLED：启用。 - DISABLED：禁用。
noAutoRebootWithLoggedOnUsers	是	String	有用户登录时，更新安装后是否不自动重启。取值： - INHERIT：继承（未配置）。 - ENABLED：启用。 - DISABLED：禁用。

表 updateService

参数	是否必填	参数类型	说明
useWuServer	是	String	Intranet Microsoft更新服务位置状态。取值： - INHERIT：继承（未配置）。 - ENABLED：启用。 - DISABLED：禁用。
updateServerUrl	否	String	Intranet Microsoft更新服务地址。最长2048个字符。仅支持HTTP或HTTPS URI。不得包含用户信息和片段。 useWuServer为ENABLED时必填。其他状态禁止提交。
statisticsServerUrl	否	String	Intranet Microsoft统计服务地址。最长2048个字符。仅支持HTTP或HTTPS URI。不得包含用户信息和片段。 useWuServer为ENABLED时必填。其他状态禁止提交。
alternateDownloadServerUrl	否	String	备用内容下载服务器地址。最长2048个字符。格式为URI。仅useWuServer为ENABLED时可提交。
fillEmptyContentUrlsEnable	是	Boolean	下载URL为空时是否允许从备用下载服务器下载内容。

表 installTime

参数	是否必填	参数类型	说明	示例	下级对象
mode	是	String	安装时间模式。取值： - AUTO：自动安排。 - FIXED_HOUR：固定小时。
hour	否	Integer	固定安装小时。取值0~23。 FIXED_HOUR模式必填。 AUTO模式不得提交。

表 detectionFrequency

参数	是否必填	参数类型	说明	示例	下级对象
state	是	String	自定义更新检测频率状态。取值： - INHERIT：继承（未配置）。 - ENABLED：启用。 - DISABLED：禁用。
hours	否	Integer	检测间隔，单位小时。取值1~22。 ENABLED状态必填。其他状态不得提交。

表 targetGroup

参数	是否必填	参数类型	说明	示例	下级对象
state	是	String	客户端目标组状态。取值： - INHERIT：继承（未配置）。 - ENABLED：启用。 - DISABLED：禁用。
name	否	String	客户端目标组名称。最少1个字符。 ENABLED状态必填。其他状态禁止提交。

响应参数

参数	参数类型	说明	示例
statusCode	Integer	状态码，800表示请求成功，900表示请求失败。	800
error	String	错误码。	ECPC_1000
message	String	提示信息。	OK.
returnObj	Boolean	是否设置成功。

枚举参数

无

请求示例

请求url

https://{host}?regionId=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

请求头header

无

请求体body

{
  "strategyOid":"dsy-xxxxxx",
  "windowsUpdatePolicy":{
    "mode":"CUSTOM_WSUS",
    "customWsus":{
      "name":"企业WSUS策略",
      "description":"办公网终端更新策略",
      "updateService":{
        "useWuServer":"ENABLED",
        "updateServerUrl":"https://wsus.example.com/update",
        "statisticsServerUrl":"https://wsus.example.com/statistics",
        "alternateDownloadServerUrl":"https://download.example.com/windows",
        "fillEmptyContentUrlsEnable":true
      },
      "automaticUpdates":"ENABLED",
      "updateMode":"AUTO_DOWNLOAD_SCHEDULE_INSTALL",
      "installDay":"MONDAY",
      "installTime":{
        "mode":"FIXED_HOUR",
        "hour":2
      },
      "automaticMaintenanceEnable":true,
      "detectionFrequency":{
        "state":"ENABLED",
        "hours":6
      },
      "targetGroup":{
        "state":"ENABLED",
        "name":"OFFICE-DESKTOPS"
      },
      "autoInstallMinorUpdates":"ENABLED",
      "elevateNonAdmins":"DISABLED",
      "noAutoRebootWithLoggedOnUsers":"ENABLED"
    }
  }
}

响应示例

{
  "statusCode":800,
  "message":"OK.",
  "returnObj":true
}

状态码

请参考状态码

错误码

请参考错误码

息壤智算

应用商城

定价

合作伙伴

开发者

支持与服务

了解天翼云

天翼云电脑（政企版）

天翼云电脑（政企版）

接口功能介绍

接口约束

URI

请求参数

响应参数

枚举参数

请求示例

响应示例

状态码

错误码

活动

息壤智算

应用商城

定价

合作伙伴

开发者

支持与服务

了解天翼云

天翼云电脑（政企版）

天翼云电脑（政企版）

接口功能介绍

接口约束

URI

请求参数

响应参数

枚举参数

请求示例

响应示例

状态码

错误码