SoftLayer Hardware Server::getWindowsUpdateAvailableUpdates

From SoftLayer Development Network Wiki

getWindowsUpdateAvailableUpdates is a member of the SoftLayer_Hardware_Server service.

Contents 1 Overview 2 User Access 3 Return Type 4 Headers 4.1 Required Headers 4.2 Optional Headers 5 Error Handling 6 External Links

Overview

Retrieve a list of Windows updates available for a server from the local SoftLayer Windows Server Update Services (WSUS) server. Windows servers provisioned by SoftLayer are configured to use the local WSUS server via the private network by default.

User Access

Users wishing to execute getWindowsUpdateAvailableUpdates must have the following permissions assigned to their account:

• View Hardware Details

Return Type

getWindowsUpdateAvailableUpdates returns the SoftLayer_Container_Utility_Microsoft_Windows_UpdateServices_UpdateItemArray data type.

Headers

Required Headers

getWindowsUpdateAvailableUpdates requires the following headers set:

• authenticate
• SoftLayer_Hardware_ServerInitParameter

Optional Headers

getWindowsUpdateAvailableUpdates takes the following optional headers:

• resultLimit
• SoftLayer_Hardware_ServerObjectMask

Error Handling

getWindowsUpdateAvailableUpdates throws the following exceptions:

• SoftLayer_Exception

Throw the exception "This server does not run the Microsoft Windows operating system" when trying to run this method on a server that doesn't run Microsoft Windows.

External Links

• Windows Server Update Services (WSUS) Home