Pagination
IAM supports cursor-based pagination by design. APIs (where this is applicable) do not accept parameters for specific pages.The initial call always returns the first page of results, subsequent pages can be accessed through the links provided in the response.
Clarity on Links
| Cursor | Clarity |
|---|---|
| first | an URL with reference to the first page of the request. |
| prev | an URL with reference to the previous page of the request, if applicable. |
| next | an URL with reference to the subsequent page of the request, if there are items yet to be traversed with respect to the pageSize requested. The listing is deemed complete, if there is no next link present. |
| self | an URL with cursor reference to the current page of the request |
Contract
- The URLs in the links block should not be parsed by client-side developers as their content and/or format may change without notice. These URLs are intended to be used in GET calls as-is without interpretation or modification.
- A cursor link reference is valid for only 5 minutes. If a page is requested and a next link is returned, that link is valid for 5 minutes, after which it will be deemed invalid.