SoftLayer Hardware Server::getWindowsUpdateStatus

From SoftLayer Development Network Wiki

getWindowsUpdateStatus 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

This method returns an update status record for this server. That record will specify if the server is missing updates, or has updates that must be reinstalled or require a reboot to go into affect.

User Access

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

• View Hardware Details

Return Type

getWindowsUpdateStatus returns the SoftLayer_Container_Utility_Microsoft_Windows_UpdateServices_Status data type.

Headers

Required Headers

getWindowsUpdateStatus requires the following headers set:

• authenticate
• SoftLayer_Hardware_ServerInitParameter

Optional Headers

getWindowsUpdateStatus takes the following optional headers:

• SoftLayer_Hardware_ServerObjectMask

Error Handling

getWindowsUpdateStatus 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