The changeServerNameById Web API Method

Replace the current server name with a new one. This change is purely cosmetic - the server’s name does not influence any aspect of its accessibility or functionality.

Version: 1.3

Required Permissions: full

HTTP method: POST

Request Parameters:

Parameter

 Type

Required

Description

serverName

String

Yes

Server name

serverId

Integer

Yes

Server ID

Expected Response Code: 202 Accepted

Response Type: serverInfo with information about theadded server

Possible Action Specific Error Codes:

HTTP Code

 Error Code

Description

400

alreadyConnected

The server is already a member of a cluster (not necessarily the current cluster)

400

wrongPassword

Provided GUI password is incorrect

405

notImplementedByEdition

This method is only available on Zend Server Professional or Enterprise edition

500

invalidServerResponse

Invalid or unexpected response from new server

500

serverNotLicensed

Zend Server is not licensed

500

noActiveServers

The server cannot be added because all servers in the cluster are disabled or unreachable

500

cantConnectToServer

Zend Server is unable to connect to the specified Server URL

503

temporarilyLocked

The server cannot be added because a cluster member is in graceful startup / shutdown mode

Example

Usage Example

Request (URI broken for readability)

POST /ZendServer/Api/changeServerNameById
serverName=www-05&serverId=0

Response

<?xml version="1.0" encoding="UTF-8"?>
<zendServerAPIResponse xmlns="http://www.zend.com/server/api/1.0">
	<requestData>
		<apiKeyName>angel.eyes</apiKeyName>
		<method>changeServerNameById</method>
	</requestData>
	<responseData>
		<serverInfo>
			<id>25</id>
			<name>www-05</name>
			<address>www-05.local</address>
			<status>OK</status>
			<messageList />
			<debugModeEnabled>true</debugModeEnabled>
		</serverInfo>
	</responseData>
</zendServerAPIResponse>