The jobqueueUpdateQueue Web API Method

Update a queue in queues list.

Version: 1.10

Required Permissions: Full

HTTP method: POST

Supported by Editions: Zend Server

Request Parameters:  

Parameter

 Type

Required

Description

id

Integer

Yes

The ID of the queue.

name

String

No

The name of the new queue (unique). 2 - 32 characters.

status

Integer

No

Default 1 (JobQueueInterface::QUEUE_ACTIVE). Can be 1 (active) or 2 (suspended).

priority

Integer

No

Default 2. Value between 0 and 4. (4 is highest priority).

max_http_jobs

Integer

No

Default 5. Max concurrent jobs in this queue.

max_wait_time

Integer

No

Default 5. Max waiting time for a job inside a queue. Used to avoid starvation.

connection_timeout

Integer

No

Default 30. Number of seconds the daemon tries to establish a connection with a back-end server

http_job_timeout

Integer

No

Default 120. Number of seconds a URL-based job must be completed in

http_job_retry_count

Integer

No

Default 10. Number of retries for failed HTTP jobs

http_job_retry_timeout

Integer

No

Default 1. The number of seconds between retries for failed HTTP jobs

Expected Response Code: 200 OK - Returned for a successful request.

Possible Action Specific Error Codes: None.

Example

Usage Example

Request

POST /ZendServer/Api/jobqueueUpdateQueue
id=213, name=qwerty123

Response

<zendServerAPIResponse xmlns="http://www.zend.com/server/api/1.10">
	<requestData>
		<apiKeyName>
			<![CDATA[admin]]>
		</apiKeyName>
		<method>jobqueueUpdateQueue</method>
	</requestData>
	<responseData>
		<result>success</result>
	</responseData>
</zendServerAPIResponse>