rahil-c commented on code in PR #9660:
URL: https://github.com/apache/iceberg/pull/9660#discussion_r1498050092
##########
open-api/rest-catalog-open-api.yaml:
##########
@@ -1581,6 +1607,17 @@ components:
type: string
example: [ "accounting", "tax" ]
+ PageToken:
+ description:
+ An opaque token which allows clients to make use of pagination for a
list API (e.g. ListTables) by signaling to the service
+ that they would prefer the response to be paginated.
+
+ Clients will initiate the request by sending an empty pageToken e.g.
GET /tables?pageToken or /tables?pageToken=
+ For servers that support pagination, they will recognize pageToken and
return a next pageToken in response if there are more results available.
+ After initial request, it is expected that the next pageToken from the
last response be used in the subsequent request.
+ For servers that do not support pagination, they will ignore the
pageToken and return all results.
Review Comment:
Actually I think the current sentence reads fine and is for the initial case
of sending the pageToken.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: issues-unsubscr...@iceberg.apache.org
For queries about this service, please contact Infrastructure at:
us...@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscr...@iceberg.apache.org
For additional commands, e-mail: issues-h...@iceberg.apache.org
