Help Center
Choose product document...
Veeam Backup & Replication 9.5
RESTful API Reference

pageSize and page

The pageSize and page query parameters let you control pagination.

pageSize

Using the pageSize parameter, you can define the number of items to be displayed on one page. As a result, the server will return a set of pages with the defined number of items per page.

By default, all query results are displayed on one page. To set the pageSize parameter, you should pass a value greater than 0 as a query argument.

For example, using the query below, you can paginate a list of backup serves, 1 backup server per page:

Request:

GET http://localhost:9399/api/query?type=backupServer&pageSize=1

 

Response:

200 Success

 

Response Body:

<QueryResult xmlns="http://www.veeam.com/ent/v1.0">
 <Refs>
   <Ref Type="BackupServerReference" Href="http://localhost:9399/api/backupServers/e42211aa-321d-4f91-9c13-2342cf9557eb" Name="172.17.53.47" UID="urn:veeam:BackupServer:e42211aa-321d-4f91-9c13-2342cf9557eb">
     <Links>
       <Link Rel="Down" Type="JobReferenceList" Href="http://localhost:9399/api/backupServers/e42211aa-321d-4f91-9c13-2342cf9557eb/jobs" />
       <Link Rel="Down" Type="RepositoryReferenceList" Href="http://localhost:9399/api/backupServers/e42211aa-321d-4f91-9c13-2342cf9557eb/repositories" />
       <Link Rel="Down" Type="CredentialsList" Href="http://localhost:9399/api/backupServers/e42211aa-321d-4f91-9c13-2342cf9557eb/credentials" />
       <Link Rel="Down" Type="PasswordKeyList" Href="http://localhost:9399/api/backupServers/e42211aa-321d-4f91-9c13-2342cf9557eb/passwords" />
       <Link Rel="Alternate" Type="BackupServer" Href="http://localhost:9399/api/backupServers/e42211aa-321d-4f91-9c13-2342cf9557eb?format=Entity" Name="172.17.53.47" />
       <Link Rel="Down" Type="ManagedServerReferenceList" Href="http://localhost:9399/api/backupServers/e42211aa-321d-4f91-9c13-2342cf9557eb/managedServers" />
     </Links>
   </Ref>
 </Refs>
 <PagingInfo PageNum="1" PageSize="1" PagesCount="2">
   <Links>
     <Link Rel="First" Href="http://localhost:9399/api/query?type=backupServer&pageSize=1&page=1" />
     <Link Rel="Next" Href="http://localhost:9399/api/query?type=backupServer&pageSize=1&page=2" />
     <Link Rel="Last" Href="http://localhost:9399/api/query?type=backupServer&pageSize=1&page=2" />
   </Links>
 </PagingInfo>
</QueryResult>

page

In the PagingInfo section of the returned resource representation, Veeam Backup Enterprise Manager returns URLs to pages with results. The page parameter in the URL defines the number of displayed page.

For example, the page=2 string in the URL below defines that the displayed page is the 2nd page with query results:

http://localhost:9399/api/query?type=BackupServer&pageSize=1&page=2

 

pageSize and page Tip:

You can move forward or backward the pages with query results by following the links in PagingInfo section in the query results. Alternatively, you can manually increase or decrease the page number in the query string.

 

Veeam Large Logo

User Guide for VMware vSphere

User Guide for Microsoft Hyper-V

Enterprise Manager User Guide

Veeam Cloud Connect Guide

Veeam Backup Explorers User Guide

PowerShell Reference

RESTful API Reference

Veeam Backup FREE Edition User Guide

Veeam Backup for Microsoft Office 365

Veeam ONE Documentation

Veeam Endpoint Backup Documentation

Veeam Management Pack Documentation