Web API Reference Guide > Available API Methods > Configuration Management Methods > The configurationDirectivesList Method

The configurationDirectivesList Method

Retrieve a filtered list of directives and associated information. This list can be filtered by extension name, however if an invalid or non-existing extension is passed, an valid empty result will be returned.

Version: 1.3

Required Permissions: Read-only

HTTP method: GET

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
extension	String	No	Retrieve only directives of a specific extension. Default: Retrieve all known directives regardless of extensions. If no extension name is provided, the output will be modified so that the extension element is empty
daemon	String	No	Retrieve only directives of a specific zend daemon. Note that both extension and daemon parameters cannot be passed.
filter	String	No	Filter out the directives returned according to a certain text.

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

Response Type: A list of directives, current meta data, state and description.

Possible Action Specific Error Codes:

HTTP Code	Error Code	Description
500	internalServerError	The system could not retrieve the requested extensions’ information, possibly due to a database error

Example

Usage Example

Request

GET /ZendServer/Api/configurationDirectivesList?extension=mysql

Response

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

	Read Also
	Available API Methods
	Configuration Management Methods