Checking Updater Status

The check operation is used to show current status of Plesk Updater. If it is installing a component or updating Plesk, the other operations are unavailable.

In this chapter:

Request Packet Structure

Response Packet Structure

Samples

 

Request Packet Structure

A request XML packet retrieving status of Plesk Updater includes the check operation node:

<packet version="1.5.0.0">
<updater>
   <check/>
</updater>
</packet>

 

The check node is required. Data type: none.

 

Response Packet Structure

The check node of the output XML packet is presented by type UpdaterCheckOutputType (updater.xsd) and structured as follows:

  • The result node is required. It wraps the response retrieved from the server. Data type:resultType (common.xsd).
  • The status node is required. It specifies if the Plesk Updater is not busy. Data type: string. Allowed values: ok | error.
  • The errcode node is optional. Is returns the error code if the check operation fails. Data type: integer.
  • The errtext node is optional. It returns the error message if the check operation fails. Data type: string.

 

 

Samples

This request retrievs status of Plesk Updater:

<packet version="1.5.0.0">
<updater>
   <check/>
</updater>
</packet>

Response:

<packet version="1.5.0.0">
<updater>
   <check>
      <result>
         <status>ok</status>
      </result>
   </check>
</updater>
</packet>

 

If Plesk Updater is busy, the response packet from the server will look as follows:

<packet version="1.5.0.0">
<updater>
   <check>
      <result>
         <status>error</status>
         <errcode>1035</errcode>
         <errtext>Service is busy</errtext>
      </result>
   </check>
</updater>
</packet>

 

 

Leave your comments on this page

Leave your feedback or question on this documentation topic below. For technical assistance, contact your hosting service provider or submit a request to Plesk support. Suggest new features for Plesk here. Discuss general questions on the Plesk forum. All offtopic comments will be removed.