Requesting the available databases on a server (Web Interface REST service)

Web Interface and Publisher > Web Interface > Web Interface REST service > Requesting resources through the REST service > Requesting the available databases on a server (Web Interface REST service)

The Repositories operation returns resource URIs for the repositories that can be accessed from a server.

Request

The syntax of the URI for a Repositories request is as follows.

<Web Interface website>/ModelerService/Servers/<server name>/Repositories

Where:

• <Web Interface website> - is the URI for the Web Interface website.

• <server name> - is the name of the server, against which the Repositories operation is being run.

If the server name contains reserved characters, those characters must be percent encoded in the URI. Use the Servers operation request to return the URI safe version of the server name.

Returned XML

A Repositories request returns a resource URI for each database that can be accessed from the server.

The syntax of a returned URI is as follows.

<Web Interface website>/ModelerService/Servers/<server name>/Repositories/<repository name>

When you use the preceding resource URI for a database, the REST service returns operation URIs that can be used against the database.

Example

In this example, the following Repositories request returns a resource URI for each database that can be accessed from the Server101 server.

https://localhost:57850/ModelerService/Servers/Server101/Repositories.

The returned XML is as follows. You can see that there is a resource URI for the Examples database, and a resource URI for the Models database.

<?xml version="1.0"?>
<ArrayOfRepository xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/StudioRESTService.ModelerRESTService">
<Repository>
<RequestResult>Complete</RequestResult>
<RequestResultType>Resource</RequestResultType>
<ID>Server101/Examples</ID>
<Name>Examples</Name>
<ResourceType>Repository</ResourceType>
<URIs>
<URI>
<href>https://localhost:57850/ModelerService/Servers/Server101/Repositories/Examples</href>
</URI>
<WebInterfaceLink>https://localhost:57850/showitem?srvNm=Server101+repNm=Examples</WebInterfaceLink>
</URIs>
</Repository>
<Repository>
<RequestResult>Complete</RequestResult>
<RequestResultType>Resource</RequestResultType>
<ID>Server101/Models</ID>
<Name>Models</Name>
<ResourceType>Repository</ResourceType>
<URIs>
<URI>
<href>https://localhost:57850/ModelerService/Servers/Server101/Repositories/Models</href>
</URI>
<WebInterfaceLink>https://localhost:57850/showitem?srvNm=Server101+repNm=Models</WebInterfaceLink>
</URIs>
</Repository>
</ArrayOfRepository>