Web API Reference Guide > Available API Methods > Library Methods > The libraryGetStatus Method

The libraryGetStatus Method

Get the list of libraries currently deployed on the server or the cluster, and information about each library’s available versions. If library IDs are specified, will return information about the specified applications; If no IDs are specified, will return information about all libraries.

Version: 1.5

Required Permissions: Read-only

HTTP method: GET

Supported by Editions: Zend Server

Request Parameters:

Parameter	Type	Required	Description
libraries	Array	No	List of library IDs. If specified, information will be returned about these applications only. If not specified, information about all applications will be returned. Note that if a non-existing application ID is provided, this action will not fail but instead will return no information about the specific app.
direction	String	No	One of ASC\|DESC. Sets the ordering direction. Ordering is always by User application name

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

Response Type: libraryList

Possible Action Specific Error Codes: This action has no specific error codes

Example

Usage Example

Request

GET /ZendServer/Api/libraryGetStatus?libraries[]=1&libraries[]=2

Response

<?xml version="1.0" encoding="UTF-8"?>
<zendServerAPIResponse xmlns="http://www.zend.com/server/api/1.5">
	<requestData>
		<apiKeyName>angel.eyes</apiKeyName>
		<method>libraryGetStatus</method>
	</requestData>
	<responseData>
		<libraryList>
			<libraryInfo>
				<libraryId>1</libraryId>
				<libraryName>Zend Framework</libraryName>
				<status>Ok</status>
				<libraryVersions>
					<libraryVersion>
					<libraryVersionId>1</libraryVersionId>
					<version>1.12.1</version>
					<default>true</default>
					<status>Ok</status>
				<installedLocation><![CDATA[/path/to/lib]]></installedLocation>
				<isDefinedLibrary>false</isDefinedLibrary>
				<creationTime>1970-01-01T02:00:00+02:00</creationTime>
				<lastUsed>1970-01-01T02:00:00+02:00</lastUsed>
				<servers>
					<libraryServer>
						<serverId>1</serverId>
						<status>OK</status>
					</libraryServer>
					<libraryServer>
						<serverId>4</serverId>
						<status>OK</status>
					</libraryServer>
					<libraryServer>
						<serverId>8</serverId>
						<status>OK</status>
					</libraryServer>
				</servers>	
			</libraryVersion>
		</libraryVersions>
	</libraryInfo>
	<libraryInfo>
		<libraryId>2</libraryId>
		<libraryName>Zend Framework 2</libraryName>
		<status>Ok</status>
		<isDefinedLibrary>false</isDefinedLibrary>
		<libraryVersions>
			<libraryVersion>
				<libraryVersionId>2</libraryVersionId>
				<version>2.0.1</version>
				<default>false</default>
				<status>Ok</status>
				<installedLocation><![CDATA[/path/to/lib]]></installedLocation>
				<creationTime>1970-01-01T02:00:00+02:00</creationTime>
				<lastUsed>1970-01-01T02:00:00+02:00</lastUsed>
				<servers>
					<libraryServer>
						<serverId>1</serverId>
						<status>OK</status>
					</libraryServer>
					<libraryServer>
						<serverId>4</serverId>
						<status>OK</status>
					</libraryServer>
					<libraryServer>
						<serverId>8</serverId>
						<status>OK</status>
					</libraryServer>
				</servers>
				<libraryVersion>
				</libraryVersions>
			</libraryInfo>
		</libraryList>
	</responseData>
</zendServerAPIResponse>

	Read Also
	Available API Methods
	Library Methods