Skip to main content
Version: 3.7.x.x LTS

Reading configuration

The configuration of an existing resource can be obtained by browsing the tree (GET request) starting from the top-level resource such as a zone or an environment. For example, to retrieve the configuration of a nevisProxy service, you have to find out the zone, server, and the nevisProxy instance that the service belongs to.

To obtain a list of zones, start with a request as follows: https://<hostname>:8037/nevisadmin/rest/infrastructure/zone

The response contains all the zones that are currently available. For example:

List of available zones
<?xml version="1.0" encoding="UTF-8"?>
<references>
<reference type="zone" id="id-9c5d51d1-5aa7-480f-abb9-7b4f0cc1d0c7" name="APP-ZH">
<link href="https://server.adnovum.ch:8037/nevisadmin/rest/infrastructure/zone/id-9c5d51d1-5aa7-480f-abb9-7b4f0cc1d0c7"/>
</reference>
<reference type="zone" id="id-b130f733-1e20-4edd-a1a0-01bd373f92bc" name="DMZ-ZH">
<link href="https://server.adnovum.ch:8037/nevisadmin/rest/infrastructure/zone/id-b130f733-1e20-4edd-a1a0-01bd373f92bc"/>
</reference>
</references>

Once you know the ID of the zone resource, you can proceed with listing the servers within the given zone. Provide the path to the given zone and add the resource type you are interested in. Supported types on the infrastructure level are: zone, server, instance, service, and file. The request will look as follows:

https://<hostname>:8037/nevisadmin/rest/infrastructure/zone/<zoneId>/server

Follow this approach until you have obtained the ID of the nevisProxy service that you want to look at. Then, read the configuration as follows:

https://<hostname>:8037/nevisadmin/rest/infrastructure/zone/<zoneId>/server/<serverId>/instance/<instanceId>/service/<serviceId>

The response contains the configuration of the resource with the given ID. For example:

nevisProxy service resource
<?xml version="1.0" encoding="UTF-8"?>
<nevisProxyService xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:type="nevisProxyService" id="id-e0bbc78a-105c-4087-8ef1-37b10729844f"
name="nevapl08-ext0.zh.adnovum.ch">
<description></description>
<customInitParams/>
<deploymentDir>work</deploymentDir>
...
<trustStoreId>nevis:[email protected]</trustStoreId>
<sslAttributes/>
...
<proxyConnector type="proxyConnector">
<hostname>nevapl08-ext0.zh.adnovum.ch</hostname>
<port>5080</port>
<ssl>false</ssl>
<listeningHost>nevapl08-ext0.zh.adnovum.ch</listeningHost>
<listeningPort>5080</listeningPort>
<nameVirtualHost>false</nameVirtualHost>
<serverAlias></serverAlias>
<clientCATruststoreLabelId></clientCATruststoreLabelId>
<caTruststoreLabelId></caTruststoreLabelId>
<keystoreLabelId></keystoreLabelId>
</proxyConnector>
</nevisProxyService>