This is an archive version of the document. To get the most up-to-date information, see the current version.

Step 3. Get a List of Veeam Backup Servers

In this article

To get a list of all Veeam backup servers, you need to retrieve a resource representation of the /backupServers resource. This resource contains a collection of Veeam backup servers connected to Veeam Backup Enterprise Manager.

In the resource representation of the logon session created at the previous step, find a link to the /backupServers resource. The Rel attribute within the link component has the Down value and the Type attribute is set to BackupServerReferenceList or BackupServerList:

<Link Rel="Down" Type="BackupServerReferenceList" Href="http://localhost:9399/api/backupServers>

Get the URL for the Veeam backup servers collection. The URL is provided in the Href attribute of the link component:

http://localhost:9399/api/backupServers

Send the GET HTTP request to the retrieved URL. Veeam Backup Enterprise Manager will return a representation of all connected Veeam backup servers:

Request:

GET http://localhost:9399/api/backupServers

Response:

200 Success

Response Body:

<EntityReferences xmlns="http://www.veeam.com/ent/v1.0">
<Ref Type="BackupServerReference" Href="http://localhost:9399/api/backupServers/f62624c1-8462-4747-8bd4-d686f99b0540" Name="backupserver" UID="urn:veeam:BackupServer:f62624c1-8462-4747-8bd4-d686f99b0540">
<Links>
<Link Rel="Down" Type="JobReferenceList" Href="http://localhost:9399/api/backupServers/f62624c1-8462-4747-8bd4-d686f99b0540/jobs" />
<Link Rel="Down" Type="RepositoryReferenceList" Href="http://localhost:9399/api/backupServers/f62624c1-8462-4747-8bd4-d686f99b0540/repositories" />
<Link Rel="Down" Type="CredentialsList" Href="http://localhost:9399/api/backupServers/f62624c1-8462-4747-8bd4-d686f99b0540/credentials" />
<Link Rel="Down" Type="PasswordKeyList" Href="http://localhost:9399/api/backupServers/f62624c1-8462-4747-8bd4-d686f99b0540/passwords" />
<Link Rel="Alternate" Type="BackupServer" Href="http://localhost:9399/api/backupServers/f62624c1-8462-4747-8bd4-d686f99b0540?format=Entity" Name="backupserver" />
<Link Rel="Down" Type="ManagedServerReferenceList" Href="http://localhost:9399/api/backupServers/f62624c1-8462-4747-8bd4-d686f99b0540/managedServers" />
</Links>
</Ref>
<Ref Type="BackupServerReference" Href="http://localhost:9399/api/backupServers/50a1b2fb-b90a-4e05-816f-e298eb2f995c" Name="localhost" UID="urn:veeam:BackupServer:50a1b2fb-b90a-4e05-816f-e298eb2f995c">
<Links>
<Link Rel="Down" Type="JobReferenceList" Href="http://localhost:9399/api/backupServers/50a1b2fb-b90a-4e05-816f-e298eb2f995c/jobs" />
<Link Rel="Down" Type="RepositoryReferenceList" Href="http://localhost:9399/api/backupServers/50a1b2fb-b90a-4e05-816f-e298eb2f995c/repositories" />
<Link Rel="Down" Type="CredentialsList" Href="http://localhost:9399/api/backupServers/50a1b2fb-b90a-4e05-816f-e298eb2f995c/credentials" />
<Link Rel="Down" Type="PasswordKeyList" Href="http://localhost:9399/api/backupServers/50a1b2fb-b90a-4e05-816f-e298eb2f995c/passwords" />
<Link Rel="Alternate" Type="BackupServer" Href="http://localhost:9399/api/backupServers/50a1b2fb-b90a-4e05-816f-e298eb2f995c?format=Entity" Name="localhost" />
<Link Rel="Down" Type="ManagedServerReferenceList" Href="http://localhost:9399/api/backupServers/50a1b2fb-b90a-4e05-816f-e298eb2f995c/managedServers" />
</Links>
</Ref>
</EntityReferences>