The applicationUpdate Method

Parameter

 Type

Required

Description

appId

Integer

Yes

The application ID you would like to update.

appPackage

File

Yes

The application package file. The content type for the file must be ‘application/vnd.zend.applicationpackage’.

ignoreFailures

Boolean

No

Ignore failures during staging if only some servers report failures. If all servers report failures the operation will fail in any case.
The default value is FALSE, meaning any failure will return an error.

userParams

Hashmap

No

Set values for user parameters that are defined in the package.
Any required parameters that were not defined in a previous deployment of the same application will be required. Any parameters with already defined values are not required, but may be specified again if you would like to set a new value.

HTTP Code

 Error Code

Description

404

noSuchApplication

The provided application ID does not exist.

409

applicationConflict

The provided application package includes a different application, instead of a different version of the existing application.

400

missingParamater

A required parameter is missing.

400

invalidParameter

A value provided for a parameter is invalid.

Request

POST /ZendServerManager/Api/applicationUpdate
Content-type: multipart/form-data, boundary=--bla-bla-bla--

----bla-bla-bla--
Content-disposition: form-data; name=appId 

2
----bla-bla-bla--
Content-disposition: form-data; name=”appPackage”; 
filename=”myApplication-v1.1.zpk”
Content-type: application/vnd.zend.applicationpackage

[...binary data follows...]
----bla-bla-bla--
Content-disposition: form-data; name=userParams%5Bnewparam%5D

someValueForNewParam
----bla-bla-bla--
Content-disposition: form-data; name=userParams%5BOldParamRedone%5D

some new value for a parameter that was previously defined
----bla-bla-bla----

Response

<?xml version="1.0" encoding="UTF-8"?>
<zendServerAPIResponse xmlns="http://www.zend.com/server/api/1.3">
	<requestData>
		<apiKeyName>angel.eyes</apiKeyName>
		<method>applicationUpdate</method>
	</requestData>
	<responseData>
		<applicationInfo>
			<id>2</id>
			<baseUrl>http://oapp.example.com:8080/</baseUrl>
			<appName>Blog 2.0</appName>
			<userAppName>Wolfgang's Blog</userAppName>
			<installedLocation>/usr/local/somewhere</installedLocation>
			<status>staging</status>
			<servers>
				<applicationServer>
					<id>1</id>
					<deployedVersion>1.6</deployedVersion>
					<status>staging</status>
				</applicationServer>
				<applicationServer>
					<id>4</id>
					<deployedVersion>1.6</deployedVersion>
					<status>staging</status>
				</applicationServer>
				<applicationServer>
					<id>8</id>
					<deployedVersion>1.6</deployedVersion>
					<status>staging</status>
				</applicationServer>
			</servers>
			<deployedVersions>
				<deployedVersion>1.6</deployedVersion>
				<deployedVersion>1.5</deployedVersion>
			</deployedVersions>
		<messageList />
			<creationTime>1970-01-01T02:00:00+02:00</creationTime>
			<lastUsed>1970-01-01T02:00:00+02:00</lastUsed>
		</applicationInfo>
	</responseData>
</zendServerAPIResponse>