kbendick commented on a change in pull request #4367:
URL: https://github.com/apache/iceberg/pull/4367#discussion_r830731721
##########
File path: open-api/rest-catalog-open-api.yaml
##########
@@ -1537,9 +1622,39 @@ components:
EmptyResponse:
$ref: '#/components/examples/ListNamespacesEmptyExample'
+ AuthenticationTimeoutResponse:
+ description:
+ Credentials have timed out. If possible, the client should refresh
credentials and retry.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/ErrorModel'
+ example: {
+ "error": {
+ "message": "Credentials have timed out",
+ "type": "AuthenticationTimeoutException",
+ "code": 419
+ }
+ }
+
+ ServiceUnavailableResponse:
+ description:
+ The service is not ready to handle the request. The client should wait
and retry.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/ErrorModel'
+ example: {
+ "error": {
+ "message": "Slow down",
+ "type": "SlowDownException",
+ "code": 503
+ }
+ }
+
ServerErrorResponse:
description:
- A server-side problem that might not be addressable from the client
side. Used for server 5xx errors.
+ A server-side problem that might not be addressable from the client
side. Used for server 5xx errors without more specific documentation in
individual routes.
Review comment:
Nit: Can we wrap this description so that it's not all on one line?
Seems a little long to me. It is 167 characters (including leading white space).
Maybe placing the second sentence on its own line would help.
--
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]
