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]

Reply via email to