### GetAuthorizationCookie Request and Response Example Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/2dedbd00-fbb7-46ee-8ee0-aec9bd1ecd2a This example shows the request and response for GetAuthorizationCookie. The request includes account details, and the response contains the PlugInId and a trimmed CookieData BLOB. ```xml HemantTest.redmond.microsoft.com ADB2FE48-0B2E-451e-8FC8-44B29845B0C6 DssTargeting 4VEGgCdh/cuG4BSwhzLDomn2BAcYKl45Po5CmuBbOlRXfwhmBopYbLUHLWP EHsBFG ``` -------------------------------- ### GetConfigData Response Example Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/2dedbd00-fbb7-46ee-8ee0-aec9bd1ecd2a This XML snippet represents a GetConfigData response. It contains configuration details such as sync settings, server information, and language data. ```xml true true false 100 14030,2006-06-08 15:38:16.022 0 all all true 1033 en English false ``` -------------------------------- ### GetAuthConfig Request Example Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/2dedbd00-fbb7-46ee-8ee0-aec9bd1ecd2a This snippet shows the GetAuthConfig request message, used in the authorization phase between a DSS and a USS. It is part of the initial setup for establishing communication. ```xml ``` -------------------------------- ### GetAuthConfig Response Example Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/2dedbd00-fbb7-46ee-8ee0-aec9bd1ecd2a This snippet illustrates a successful GetAuthConfig response. It contains information about the last change and authentication plugin details, including the service URL. ```xml 2006-06-07T20:41:50.883Z DssTargeting DssAuthWebService/DssAuthWebService.asmx ``` -------------------------------- ### GetDeploymentsResponse Example Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/2dedbd00-fbb7-46ee-8ee0-aec9bd1ecd2a This XML snippet represents a GetDeploymentsResponse from the WSUS protocol, detailing server deployments and hidden updates. It is part of the reporting data synchronization phase. ```xml                                  52bdd083-4169-4094-8eea-6230c7c1520d              102              0              WUS Server              9999-12-31T23:59:59.9999999              true              2006-05-24T15:59:33.063              10a2030d-0ac1-434a-9c37-732fc36f9838              b73ca6ed-5727-47f3-84de-015e03f6a88a              1                                                  9a9bafe2-fbfc-4b0b-8479-49a2bb08cd5a            6c9d9217-0e1d-434a-a938-d9918703c361                          ``` -------------------------------- ### GetRevisionIdList Response Example Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/2dedbd00-fbb7-46ee-8ee0-aec9bd1ecd2a This XML snippet is a GetRevisionIdList response, containing an anchor and a list of new update revisions, each with an UpdateID and RevisionNumber. ```xml 4742,2006-05-26 18:59:26.192 0287014e-6772-4b4d-81f7-42063ac26e8a 100 ff2a96fb-cc89-4e5e-83b2-7d48aa179840 101 ``` -------------------------------- ### GetCookie Request and Response Example Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/2dedbd00-fbb7-46ee-8ee0-aec9bd1ecd2a This snippet demonstrates the GetCookie request and its corresponding response. The request includes authorization cookies and a protocol version, while the response contains expiration information and encrypted data. ```xml DssTargeting 4VEGgCdh/cuG4BSwhzLDomn2BAcYKl45Po5CmuBbOlRXfwhmBopYbLUHLW EHsBFG 1.2 2006-06-08T19:32:23.7190987Z edzLnPhI/Rjr6CBMlcP+fuCRNBKREOtAw9yEMe6EF3oXXvU/N67oNV/An L5eN3ZAA+jOoJzdcdJmc9za5M3B0jqBSnZsWch8waYEVNqd+eLx1EMBCK2v9lb+oXtMGw05PgQJAHtZP Rk5h4bCN4hxaCaI7JJaN7VWiWBQLh9HAKoBEm7WpOyJgnr7acYoEf64KOrB+aRc0QFuNnLsNYPNQKmxl 7R+cGkS ``` -------------------------------- ### GetUpdateData Request Example Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/2dedbd00-fbb7-46ee-8ee0-aec9bd1ecd2a This XML shows a GetUpdateData request, used to retrieve update data. It includes a cookie and a list of update IDs for which data is requested. ```xml 2006-05-27T22:42:23.0632331Z XXRQXVUzH9NX5Qvos3IL4F31UmlUgdVSVFm450d+O9A32AyPyTo66g4Vl MA48PRBtRsvajGUYA+CDNeF/ylHxuy48MUWiTJK68AJHO1V+Z6sfBDDnCTVlFc8z7UUQHguLLTXx0B4h kHhm5FSRMH03ei7mDJnhGstnEhu2hjASXU8uvespc7yt5BtoPCamiNEJQR2WgCImaw3S96AubSSKxDv9 yEAChjO 0287014e-6772-4b4d-81f7-42063ac26e8a 100 36b1c48e-c741-4047-9b09-d38698ed34b3 101 ``` -------------------------------- ### RollupComputerStatus Response Example Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/2dedbd00-fbb7-46ee-8ee0-aec9bd1ecd2a This XML snippet shows a successful response from the USS to the DSS for the RollupComputerStatus operation, indicating that the data synchronization phase is complete. ```xml true ``` -------------------------------- ### GetUpdateData Response Example Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/2dedbd00-fbb7-46ee-8ee0-aec9bd1ecd2a This XML snippet represents a GetUpdateData response, which would typically contain the actual update data within an 'updates' element. ```xml ``` -------------------------------- ### GetConfigData Request Example Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/2dedbd00-fbb7-46ee-8ee0-aec9bd1ecd2a This XML snippet shows a GetConfigData request, used in the metadata synchronization phase. It includes a cookie with an expiration date and encrypted data. ```xml 2006-06-08T19:32:23.7190987Z edzLnPhI/Rjr6CBMlcP+fuCRNBKREOtAw9yEMe6EF3oXXvU/N67oNV/AnL5eN3ZAA +jOoJzdcdJmc9za5M3B0jqBSnZsWch8waYEVNqd+eLx1EMBCK2v9lb+oXtMGw05PgQJAHtZPRk5h4bCN 4hxaCaI7JJaN7VWiWBQLh9HAKoBEm7WpOyJgnr7acYoEf64KOrB+aRc0QFuNnLsNYPNQKmxl7R+cGkS< /EncryptedData> ``` -------------------------------- ### GetRevisionIdList Request Example Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/2dedbd00-fbb7-46ee-8ee0-aec9bd1ecd2a This XML shows a GetRevisionIdList request, used to retrieve update revision IDs. It includes a cookie and filter criteria for the request. ```xml 2006-05-26T22:59:25.1296674Z c7jG7GX4Czeq+uO8twkF3uNyVfDX6G2bXwIUKk114C+BOl80eXz9YToko +KAMpO50h16kmztwMUn4i7bJ7AQw64t05Xtgfmf9F42JG1mADwLmRUSAIxnWEpKJe4fmdUzHPKjUWbKB Pi2UijibE2jZ4y177B3vafHo3RtM7NM2lMi/VWXxHwlNKvMYvzOrOvXPNuDJtTM3AOHGzW2MlZ4daT7T Usd5m6g true false ``` -------------------------------- ### DownloadFiles Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/8a3b2470-928a-4bd1-bdcc-8c2bf6b8e863 Initiates the download of files via the Server Sync Web Service. This operation is part of the ServerSyncProxySoap binding. ```APIDOC ## DownloadFiles ### Description Initiates the download of files via the Server Sync Web Service. ### Method POST ### Endpoint /ServerSyncProxySoap ### Parameters #### Request Body This operation does not define specific request parameters in the WSDL, but a SOAP request body is expected. ### Response #### Success Response (200) Details of the success response are not explicitly defined in the provided WSDL snippet, but it corresponds to the PingSoapOut message. #### Response Example (SOAP response structure would be defined here) ``` -------------------------------- ### GUID Schema Definition Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/567b00a9-cfec-400e-975e-6b447e54a4b7 This XML schema defines a simple type 'guid' for representing Globally Unique Identifiers. It enforces the standard GUID format using a regular expression pattern. ```xml                       ``` -------------------------------- ### DownloadFiles Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/8a3b2470-928a-4bd1-bdcc-8c2bf6b8e863 Initiates the download of files managed by the server sync service. ```APIDOC ## DownloadFiles ### Description Initiates the download of files managed by the server sync service. ### Method SOAP ### Endpoint /DownloadFiles ### Parameters #### Request Body - **parameters** (tns:DownloadFiles) - Required - The request parameters for DownloadFiles. ### Response #### Success Response - **parameters** (tns:DownloadFilesResponse) - The response from DownloadFiles. ``` -------------------------------- ### GetUpdateDecryptionData Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/aed4f960-521f-43ec-8b1c-1ec35f7e27c5 A DSS SHOULD call the GetUpdateDecryptionData method to get the decryption data for the list of update IDs requested. ```APIDOC ## GetUpdateDecryptionData ### Description Retrieves decryption data for a list of specified update IDs. ### Method SOAP ### Endpoint (Not specified, but implies a SOAP service endpoint) ### Parameters #### Request Body (Implied by SOAP message) - **cookie** (string) - Required - Must be present and non-empty. Contains EncryptedData that the USS can read. - **protocolVersion** (string) - Required (within cookie) - Format x.y, major version must be 1. - **updateIds** (array of strings) - Required - Must not be NULL. The number of elements must not exceed MaxUpdatesPerRequestInGetUpdateDecryptionData. ### Request Example (SOAP message structure not fully detailed, but implies a request containing cookie and updateIds) ### Response #### Success Response Returns an ArrayOfServerSyncUpdateFileDecryption element containing decryption data for each requested UpdateIdentity. #### Response Example (Structure not fully detailed, but implies a success response or a SOAP fault) #### Error Handling - **InvalidCookie**: If the cookie is invalid or malformed. - **InvalidParameters**: If protocolVersion is not x.y format, or if updateIds is NULL or exceeds the maximum limit. - **IncompatibleProtocolVersion**: If the major version of protocolVersion is not 1. - **InternalServerError**: For other server-side errors. ``` -------------------------------- ### GetAuthorizationCookie Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/141c290d-4ea1-4e0c-9dc8-0430eca197d7 Retrieves an authorization cookie. This method requires the account name and account GUID of the DSS, and the programKeys field is reserved for future use. ```APIDOC ## GetAuthorizationCookie ### Description Retrieves an authorization cookie. This method requires the account name and account GUID of the DSS, and the programKeys field is reserved for future use. ### Method Not specified (SOAP-based, likely POST) ### Endpoint Not specified ### Parameters #### Request Body - **accountName** (string) - Required - The FQDN of the DSS. - **accountGuid** (string) - Required - A GUID that identifies the DSS. - **programKeys** (ArrayOfGuid) - Optional - Reserved for future use and MUST be set to empty. ``` -------------------------------- ### GetDeployments Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/8a3b2470-928a-4bd1-bdcc-8c2bf6b8e863 Retrieves deployment information from the Server Sync Web Service. This operation is part of the ServerSyncProxySoap binding. ```APIDOC ## GetDeployments ### Description Retrieves deployment information from the Server Sync Web Service. ### Method POST ### Endpoint /ServerSyncProxySoap ### Parameters #### Request Body This operation does not define specific request parameters in the WSDL, but a SOAP request body is expected. ### Response #### Success Response (200) Details of the success response are not explicitly defined in the provided WSDL snippet, but it corresponds to the PingSoapOut message. #### Response Example (SOAP response structure would be defined here) ``` -------------------------------- ### DownloadFiles Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/8a3b2470-928a-4bd1-bdcc-8c2bf6b8e863 Initiates the download of files associated with updates from the Server Sync Web Service. This operation is available for SOAP 1.2 binding. ```APIDOC ## POST /serversyncwebservice/ServerSyncProxy.asmx ### Description Initiates the download of files associated with updates from the Server Sync Web Service. ### Method POST ### Endpoint /serversyncwebservice/ServerSyncProxy.asmx ### Parameters #### Request Body - **(literal)** - Required - The request body is expected in a literal SOAP format. ### Response #### Success Response (200) - **(literal)** - The response body is in a literal SOAP format. ``` -------------------------------- ### GetDeployments Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/8a3b2470-928a-4bd1-bdcc-8c2bf6b8e863 Retrieves deployment information from the Server Sync Web Service. This operation is available for SOAP 1.2 binding. ```APIDOC ## POST /serversyncwebservice/ServerSyncProxy.asmx ### Description Retrieves deployment information from the Server Sync Web Service. ### Method POST ### Endpoint /serversyncwebservice/ServerSyncProxy.asmx ### Parameters #### Request Body - **(literal)** - Required - The request body is expected in a literal SOAP format. ### Response #### Success Response (200) - **(literal)** - The response body is in a literal SOAP format. ``` -------------------------------- ### DownloadFiles Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/8a3b2470-928a-4bd1-bdcc-8c2bf6b8e863 Initiates the download of files based on a provided list of file digests. It requires a cookie for authentication and optionally accepts a list of file digests to download. ```APIDOC ## POST /DownloadFiles ### Description Initiates the download of files based on a provided list of file digests. This operation is used to retrieve update files from the server. ### Method POST ### Endpoint /DownloadFiles ### Parameters #### Request Body - **cookie** (Cookie) - Optional - Authentication cookie. - **fileDigestList** (ArrayOfBase64Binary) - Optional - A list of base64 encoded file digests to download. ``` -------------------------------- ### ArrayOfGuid Complex Type Definition Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/7eb31e85-f34e-4235-b47f-7510435a87da This XML schema defines the ArrayOfGuid complex type, which is an array of GUIDs. It is used in messages within the http://www.microsoft.com/SoftwareDistribution namespace. ```xml             ``` -------------------------------- ### DownloadFiles Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/65492f6c-ad61-4c02-a0d3-eeda2a4303f9 Initiates the Content Download process on a USS for a set of files from the parent of the USS. This method is typically called by a DSS after a Content Download attempt from the USS fails with a "File Not Found" condition. ```APIDOC ## DownloadFiles ### Description A DSS calls the DownloadFiles method to initiate the Content Download process on a USS for a set of files from the parent of the USS. This method is typically called by a DSS after a Content Download attempt from the USS fails with a "File Not Found" condition. ### Method SOAP ### Endpoint N/A (SOAP operation) ### Parameters #### Request Body (Implicit in SOAP message) - **cookie** (string) - Required - The cookie used for authentication and session management. Must be present, not empty, and in the correct format for the USS to read values. - **protocolVersion** (string) - Required (within cookie) - Specifies the protocol version in 'x.y' format. Major Version must be 1. - **fileDigestList** (array of strings) - Required - A list of file digests to download. The number of elements must not exceed 100. ### Request Example ```xml EncryptedCookieData FileDigest1 FileDigest2 ``` ### Response #### Success Response If no errors occur during processing, the USS returns a success response. #### Response Example ```xml ``` #### Error Handling If an error occurs, the USS MUST return a SOAP fault with an element. Possible ErrorCodes include: - **InvalidParameters**: Parameters are not valid. DSS MUST stop the protocol. - **InternalServerError**: An internal error occurred on the server. DSS MUST stop the protocol. - **InvalidCookie**: The cookie has an error. DSS MUST restart the protocol. - **IncompatibleProtocolVersion**: Protocol versions are incompatible. DSS MUST stop the protocol. - **FileDigestsMissing**: Some or all requested FileDigest values are not known. DSS MUST restart the protocol. ``` -------------------------------- ### GetDeployments Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/af3c24e0-df97-4fc2-9580-fcb46092f538 Retrieves deployment information. This operation requires a valid cookie and specific anchors for synchronization. ```APIDOC ## GetDeployments ### Description Retrieves deployment information. This operation requires a valid cookie and specific anchors for synchronization. ### Method Not specified (SOAP operation) ### Endpoint Not specified (SOAP operation) ### Parameters #### Request Body Parameters - **cookie** (Cookie) - Required - This field MUST be present and set to the Cookie returned by the GetCookie operation. The Cookie MUST NOT be expired. - **deploymentAnchor** (string) - Optional - This identifies the point in time that the last GetDeployments operation was completed successfully. If this is the first time the GetDeployments operation is called, this field MUST NOT be present. For subsequent calls to GetDeployments, it MUST be set to the anchor returned in the last GetDeployments call. - **syncAnchor** (string) - Required - This field MUST be present. It MUST be set to the anchor returned in the last successful GetRevisionIdList operation response. It identifies the point in time that the last GetRevisionIdList operation was completed successfully. ### Request Example ```xml ``` ### Response (Response details not provided in the source text) ``` -------------------------------- ### GetAuthConfig Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/8a3b2470-928a-4bd1-bdcc-8c2bf6b8e863 Retrieves authentication configuration for the Server Sync Web Service. This operation is part of the ServerSyncProxySoap binding. ```APIDOC ## GetAuthConfig ### Description Retrieves authentication configuration for the Server Sync Web Service. ### Method POST ### Endpoint /ServerSyncProxySoap ### Parameters #### Request Body This operation does not define specific request parameters in the WSDL, but a SOAP request body is expected. ### Response #### Success Response (200) Details of the success response are not explicitly defined in the provided WSDL snippet, but it corresponds to the PingSoapOut message. #### Response Example (SOAP response structure would be defined here) ``` -------------------------------- ### GetRollupConfiguration Response Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/2dedbd00-fbb7-46ee-8ee0-aec9bd1ecd2a This XML snippet represents a GetRollupConfiguration response in the WSUS protocol. It includes details like batch sizes for various rollup operations and a reset GUID. ```xml                         true          3277f62c-fa08-468f-873f-2f9867bcf9e5          059ab167-8a19-4bab-befc-daaab5b1d82b          5000          1500          20000          500                  ``` -------------------------------- ### GetConfigData Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/8a3b2470-928a-4bd1-bdcc-8c2bf6b8e863 Retrieves configuration data from the server sync service. ```APIDOC ## GetConfigData ### Description Retrieves configuration data from the server sync service. ### Method SOAP ### Endpoint /GetConfigData ### Parameters #### Request Body - **parameters** (tns:GetConfigData) - Required - The request parameters for GetConfigData. ### Response #### Success Response - **parameters** (tns:GetConfigDataResponse) - The response from GetConfigData. ``` -------------------------------- ### UpdateIdentity Complex Type Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/3a6e3cf0-cc0f-43e3-bf49-aa7d1ce77011 This XML schema defines the UpdateIdentity complex type, which includes an UpdateID (GUID) and a RevisionNumber (integer) to uniquely identify a specific revision of an update. ```xml                     ``` -------------------------------- ### DownstreamServerRollupClientActivitySummary Complex Type Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/ba5a1c8c-59c2-45af-b74b-6dfc7e5e109d Defines the structure for reporting client activity summary for a specific update. It includes the update identifier, revision number, and counts of successful and failed installations. ```xml                               ``` -------------------------------- ### RollupDownstreamServers Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/f1978fa7-59a4-44b5-980a-8efa7b8ab443 Initiates the rollup process for downstream servers. Requires client time and an array of downstream server information. ```APIDOC ## POST /RollupDownstreamServers ### Description Initiates the rollup process for downstream servers, sending their status and information. ### Method POST ### Endpoint /RollupDownstreamServers ### Parameters #### Request Body - **cookie** (Cookie) - Optional - A cookie object for authentication or session tracking. - **clientTime** (dateTime) - Required - The current date and time on the client. - **downstreamServers** (ArrayOfDownstreamServerRollupInfo) - Optional - An array of downstream server information to be rolled up. ``` -------------------------------- ### ReportInventory Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/f1978fa7-59a4-44b5-980a-8efa7b8ab443 Reports inventory data to the WSUS server. ```APIDOC ## POST /ReportInventory ### Description Reports inventory data to the WSUS server. ### Method POST ### Endpoint /ReportInventory ### Parameters #### Request Body - **parameters** (ReportInventory) - Required - The inventory data to report. ``` -------------------------------- ### GetUpdateData Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/c28ad30c-fa3f-4bc6-a747-788391d2d964 A DSS calls the GetUpdateData method to get the full update metadata for the list of revision IDs requested. The USS validates inputs and processes the request to return update data or a SOAP fault. ```APIDOC ## GetUpdateData ### Description Retrieves the full update metadata for a list of revision IDs. ### Method SOAP ### Endpoint (Not specified, inferred as SOAP endpoint) ### Parameters #### Request Body (SOAP) - **cookie** (string) - Required - Must be present and nonempty. The EncryptedData must be in the correct format for the USS to read values. - **protocolVersion** (string) - Required - Must be in the format x.y, where x is the Major Version (must be 1) and y is the Minor Version number. - **updateIds** (array) - Required - Must not be NULL. The number of elements must not exceed MaxNumberOfUpdatesPerRequest. ### Request Example (SOAP request structure not provided in source) ### Response #### Success Response Returns an ArrayOfServerSyncUpdateData and ArrayOfServerSyncUrlData containing the requested update metadata. #### Response Example (SOAP response structure not provided in source) #### Error Response - **InvalidParameters**: Returned if cookie is invalid, protocolVersion is invalid, or updateIds are invalid. - **InvalidCookie**: Returned if the cookie is invalid or not in the correct format. - **IncompatibleProtocolVersion**: Returned if the Major Version of the protocolVersion is not 1. - **InternalServerError**: Returned for other internal server errors. - **SOAP Fault**: If an error occurs, a SOAP fault message is returned, potentially containing an ErrorCode. ``` -------------------------------- ### GetRollupConfiguration Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/f1978fa7-59a4-44b5-980a-8efa7b8ab443 Retrieves the rollup configuration from the WSUS server. ```APIDOC ## GET /GetRollupConfiguration ### Description Retrieves the rollup configuration from the WSUS server. ### Method GET ### Endpoint /GetRollupConfiguration ### Parameters #### Query Parameters None ### Response #### Success Response (200) - **parameters** (GetRollupConfigurationResponse) - The response containing the rollup configuration. ``` -------------------------------- ### RollupComputers Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/f1978fa7-59a4-44b5-980a-8efa7b8ab443 Initiates a rollup process for computers. ```APIDOC ## POST /RollupComputers ### Description Initiates a rollup process for computers. ### Method POST ### Endpoint /RollupComputers ### Parameters #### Request Body - **parameters** (RollupComputers) - Required - The request to initiate computer rollup. ``` -------------------------------- ### DownstreamServerRollupInfo Complex Type Definition Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/73b1ac70-2bb9-41f3-844c-188f26297c82 This XML schema definition outlines the structure of the DownstreamServerRollupInfo complex type. It specifies the elements and their data types, including GUIDs, strings, dateTimes, and booleans, to represent information about a downstream update server. ```xml                                                        ``` -------------------------------- ### RollupDownstreamServers Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/f1978fa7-59a4-44b5-980a-8efa7b8ab443 Initiates a rollup process for downstream servers. ```APIDOC ## POST /RollupDownstreamServers ### Description Initiates a rollup process for downstream servers. ### Method POST ### Endpoint /RollupDownstreamServers ### Parameters #### Request Body - **parameters** (RollupDownstreamServers) - Required - The request to initiate downstream server rollup. ``` -------------------------------- ### GetConfigData Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/8a3b2470-928a-4bd1-bdcc-8c2bf6b8e863 Retrieves configuration data from the Server Sync Web Service. This operation is part of the ServerSyncProxySoap binding. ```APIDOC ## GetConfigData ### Description Retrieves configuration data from the Server Sync Web Service. ### Method POST ### Endpoint /ServerSyncProxySoap ### Parameters #### Request Body This operation does not define specific request parameters in the WSDL, but a SOAP request body is expected. ### Response #### Success Response (200) Details of the success response are not explicitly defined in the provided WSDL snippet, but it corresponds to the PingSoapOut message. #### Response Example (SOAP response structure would be defined here) ``` -------------------------------- ### RollupComputers Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/f1978fa7-59a4-44b5-980a-8efa7b8ab443 This operation is used to report the status of computers. It accepts a cookie and client time, and returns a list of computers that have changed. ```APIDOC ## POST /api/RollupComputers ### Description Reports the status of computers to the WSUS server. This operation is part of the Reporting Web Service. ### Method POST ### Endpoint /api/RollupComputers ### Parameters #### Request Body - **cookie** (tns:Cookie) - Optional - Represents the session cookie. - **clientTime** (s:dateTime) - Required - The current date and time on the client. - **computers** (tns:ArrayOfComputerRollupInfo) - Optional - An array of ComputerRollupInfo objects detailing the status of computers. ### Response #### Success Response (200) - **RollupComputersResult** (tns:ArrayOfChangedComputer) - An array of ChangedComputer objects indicating which computers have been deleted or had their parent server changed. ### Response Example ```json { "RollupComputersResult": [ { "ComputerId": "string", "Change": "Deleted | NewParent" } ] } ``` ``` -------------------------------- ### GetAuthConfig Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/8a3b2470-928a-4bd1-bdcc-8c2bf6b8e863 Retrieves authentication configuration for the Server Sync Web Service. This operation is available for SOAP 1.2 binding. ```APIDOC ## POST /serversyncwebservice/ServerSyncProxy.asmx ### Description Retrieves authentication configuration for the Server Sync Web Service. ### Method POST ### Endpoint /serversyncwebservice/ServerSyncProxy.asmx ### Parameters #### Request Body - **(literal)** - Required - The request body is expected in a literal SOAP format. ### Response #### Success Response (200) - **(literal)** - The response body is in a literal SOAP format. ``` -------------------------------- ### GetRollupConfigurationResponse Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/f1978fa7-59a4-44b5-980a-8efa7b8ab443 The response containing the rollup configuration details. ```APIDOC ## Response for GetRollupConfiguration ### Description Contains the rollup configuration details. ### Success Response (200) - **GetRollupConfigurationResult** (RollupConfiguration) - An object containing the rollup configuration. ``` -------------------------------- ### ReportInventory Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/f1978fa7-59a4-44b5-980a-8efa7b8ab443 Reports the inventory of a client to the WSUS server. This operation sends the collected inventory data for a client. ```APIDOC ## POST /ReportInventory ### Description Reports the inventory of a client to the WSUS server. This operation sends the collected inventory data for a client. ### Method POST ### Endpoint /ReportInventory ### Parameters #### Request Body - **cookie** (Cookie) - Optional - A cookie object for session management. - **clientTime** (dateTime) - Required - The date and time when the inventory was collected on the client. - **inventory** (ReportingInventory) - Optional - The inventory data to be reported. ``` -------------------------------- ### DownloadFiles SOAP Operation Binding Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/65492f6c-ad61-4c02-a0d3-eeda2a4303f9 Specifies the SOAP binding for the DownloadFiles operation, including the SOAP action and style. ```xml ``` -------------------------------- ### GetAuthConfig Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/8a3b2470-928a-4bd1-bdcc-8c2bf6b8e863 Retrieves the authentication configuration for the server. This includes information about authentication plugins, allowed event IDs, and the last change timestamp. ```APIDOC ## POST /GetAuthConfig ### Description Retrieves the authentication configuration for the server. This includes information about authentication plugins, allowed event IDs, and the last change timestamp. ### Method POST ### Endpoint /GetAuthConfig ### Parameters #### Request Body This operation does not take a request body. ### Response #### Success Response (200) - **GetAuthConfigResult** (ServerAuthConfig) - The authentication configuration details. - **LastChange** (dateTime) - The timestamp of the last configuration change. - **AuthInfo** (ArrayOfAuthPlugInInfo) - An array of authentication plugin information. - **AuthPlugInInfo** (AuthPlugInInfo) - Information about an authentication plugin. - **PlugInID** (string) - The unique identifier for the authentication plugin. - **ServiceUrl** (string) - The URL of the authentication service. - **Parameter** (string) - Additional parameters for the authentication plugin. - **AllowedEventIds** (ArrayOfInt) - An array of integers representing allowed event IDs. #### Response Example ```json { "GetAuthConfigResult": { "LastChange": "2023-10-27T10:00:00Z", "AuthInfo": { "AuthPlugInInfo": [ { "PlugInID": "plugin1", "ServiceUrl": "http://example.com/auth", "Parameter": "param1" } ] }, "AllowedEventIds": { "int": [1, 2, 3] } } } ``` ``` -------------------------------- ### GetConfigData Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/8a3b2470-928a-4bd1-bdcc-8c2bf6b8e863 Retrieves configuration data from the Server Sync Web Service. This operation is available for SOAP 1.2 binding. ```APIDOC ## POST /serversyncwebservice/ServerSyncProxy.asmx ### Description Retrieves configuration data from the Server Sync Web Service. ### Method POST ### Endpoint /serversyncwebservice/ServerSyncProxy.asmx ### Parameters #### Request Body - **(literal)** - Required - The request body is expected in a literal SOAP format. ### Response #### Success Response (200) - **(literal)** - The response body is in a literal SOAP format. ``` -------------------------------- ### RollupDownstreamServers Request Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/2dedbd00-fbb7-46ee-8ee0-aec9bd1ecd2a This XML snippet demonstrates a RollupDownstreamServers request in the WSUS protocol, used for synchronizing reporting data. It includes client time and server information. ```xml                         9999-12-31T23:59:59.9999999                        2007-03-06T03:28:02.5507362Z                            050cee4a-aaff-470c-8fc3-7a94cb3a4293                         ``` -------------------------------- ### ReportInventory Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/f1978fa7-59a4-44b5-980a-8efa7b8ab443 This operation is used to report inventory data. It accepts optional RawXml and CompressedXml parameters for reporting data in different formats. ```APIDOC ## POST /ReportInventory ### Description Reports inventory data to the service. Allows for reporting in raw XML or compressed XML formats. ### Method POST ### Endpoint /ReportInventory ### Parameters #### Request Body - **RawXml** (string) - Optional - Raw XML data for inventory reporting. - **CompressedXml** (base64Binary) - Optional - Compressed XML data for inventory reporting. ```