The configurationStoreDirectives Web API Method

Validate and store a list of directives and their corresponding values in the server’s configuration. Directives are validated according to their type and a predefined validation scheme.

Version: 1.3

Required Permissions: Full

HTTP method: POST

Supported by Editions: All

Request Parameters:

Directives and their values are passed as HTTP parameters in the “directives” namespace, directly into the query part of the Request

Parameter	Type	Required	Description
directives	Array	Yes	The directives to store.

Expected Response Code: 200 OK. For more information see Response Format.

Response Type: A list of directives and their current values, not the values that were validated

Possible Action Specific Error Codes:

HTTP Code	Error Code	Description
400	InvalidParameter	A directive’s value failed validation. A list of messages describing the failure will be part of the error message.
500	internalServerError	The system could not retrieve the requested extensions’ information, possibly due to a database error.
404	noSuchDirective	A directive sent for validation was not found and cannot be validated.

Example

Usage Example

Request

POST /ZendServer/Api/configurationStoreDirectives

directives[directive_name]=directive value&directives[directive_name2]=directive value

Response

<?xml version="1.0" encoding="UTF-8"?>
<zendServerAPIResponse xmlns="http://www.zend.com/server/api/1.3">
	<requestData>
		<apiKeyName>angel.eyes</apiKeyName>
		<method>configurationStoreDirectives</method>
	</requestData>
	<responseData>
		<directives>
			<directive>
				<name>directive_name</name>
				<extension>extension_name</extension>
				<section>server</section>
				<type>string</type>
				<fileValue><![CDATA[directive value]]></fileValue>
				<defaultValue><![CDATA[directive default value]]><</defaultValue>
				<previousValue></previousValue>
				<description>...</description>
				<type>int</type>
				<units>digits</units>
				<listValues></listValues>
			</directive>
			<directive>
				<name>directive_name2</name>
				<extension>extension_name</extension>
				<section>server</section>
				<type>string</type>
				<fileValue><![CDATA[directive value]]></fileValue>
				<defaultValue><![CDATA[directive default value]]><</defaultValue>
				<previousValue></previousValue>
				<description>...</description>
				<type>int</type>
				<units>digits</units>
				<listValues></listValues>
			</directive>
		</directives>
	</responseData>
</zendServerAPIResponse>