diff options
Diffstat (limited to 'docs/api-usage.rst')
| -rw-r--r-- | docs/api-usage.rst | 13 |
1 files changed, 11 insertions, 2 deletions
diff --git a/docs/api-usage.rst b/docs/api-usage.rst index f30ed03..66e5887 100644 --- a/docs/api-usage.rst +++ b/docs/api-usage.rst @@ -265,8 +265,17 @@ The generator exposes extra listing information as received from the server: * ``prev_page``: if ``None`` the current page is the first one * ``next_page``: if ``None`` the current page is the last one * ``per_page``: number of items per page -* ``total_pages``: total number of pages available -* ``total``: total number of items in the list +* ``total_pages``: total number of pages available. This may be a ``None`` value. +* ``total``: total number of items in the list. This may be a ``None`` value. + +.. note:: + + For performance reasons, if a query returns more than 10,000 records, GitLab + does not return the ``total_pages`` or ``total`` headers. In this case, + ``total_pages`` and ``total`` will have a value of ``None``. + + For more information see: + https://docs.gitlab.com/ee/user/gitlab_com/index.html#pagination-response-headers Sudo ==== |