Reference Guide

Zend Server Reference Manual
clusterDisableServer
This method disables a cluster member. This process may be asynchronous if Session Clustering is
used. If this is the case, the initial operation returns an HTTP 202 response. As long as the server is not
fully disabled, further calls to this method are idempotent. On a Zend Server Cluster Manager with no
valid license, this operation fails.
Required Permissions: full
HTTP method: POST
Supported by Editions: Zend Server Cluster Manager
Request Parameters:
Parameter Type Required Description
serverId String Yes The server ID
Expected Response Code:
364
200 OK - The process was completed successfully. This status is expected if there is no need to
perform a graceful shutdown process.
202 Accepted - The disabling process has started but was not completed yet. You can check the
server status within a few seconds using the clusterGetServerStatus method to verify that the
operation is complete.
Response Type: serverInfo with the status of the server being disabled. The status is either
shuttingDown or disabled. On a Zend Server Cluster Manager with no valid license, this operation fails.
Possible Action Specific Error Codes:
HTTP
Code
Error Code Description
404 noSuchServer There is no server with the provided server ID.
500 cantConnectToServer Zend Server Cluster Manager is unable to connect to the
specified server.
500 invalidServerResponse An invalid or unexpected response from the server.
503 temporarilyLocked The server cannot be disabled because another server in the
cluster is performing a graceful startup/shutdown.
405 notImplementedByEdition The method is not implemented by this edition of Zend Server.
500 serverNotLicensed Zend Server Cluster Manager is not licensed.