nastra commented on code in PR #15280:
URL: https://github.com/apache/iceberg/pull/15280#discussion_r3086581455
##########
open-api/rest-catalog-open-api.yaml:
##########
@@ -1227,7 +1234,17 @@ paths:
type: string
description: The plan ID that has been used for server-side scan
planning
- $ref: '#/components/parameters/referenced-by'
- description: Load vended credentials for a table from the catalog.
+ - $ref: '#/components/parameters/storage-refresh-token'
+ description:
+ Load vended credentials for a table from the catalog.
+
+
+ An optional `storageRefreshToken` query parameter can be provided to
refresh credentials
+ for a staged table. See the `storageRefreshToken` parameter definition
for detailed behavior.
+
+
+ The `planId` and `storageRefreshToken` parameters are mutually
exclusive. If both are
Review Comment:
why are they mutually exclusive? A client will most likely send both to
maintain backwards compatibility depending on whether it's talking to an older
server that only supports the `planId` or to a newer server. Newer servers
would then still most likely support `planId` if they supported it previously.
--
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: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]