kbendick commented on a change in pull request #4367:
URL: https://github.com/apache/iceberg/pull/4367#discussion_r830732653



##########
File path: open-api/rest-catalog-open-api.yaml
##########
@@ -469,23 +507,52 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/ErrorModel'
-        5XX:
+        419:
+          $ref: '#/components/responses/AuthenticationTimeoutResponse'
+        500:
           description:
-            A server-side problem that might not be addressable from the 
client side.
-
-            Error codes 500 and 504 indicate that the commit state is unknown 
and the client should
-            check the table state before considering the commit successful or 
failed.
+            An unknown server-side problem occurred; the commit state is 
unknown.
           content:
             application/json:
               schema:
                 $ref: '#/components/schemas/ErrorModel'
               example: {
                 "error": {
                   "message": "Internal Server Error",
-                  "type": "InternalServerError",
+                  "type": "CommitStateUnknownException",
                   "code": 500
                 }
               }
+        503:
+          $ref: '#/components/responses/ServiceUnavailableResponse'
+        504:
+          description:
+            An server-side gateway timeout occurred; the commit state is 
unknown.

Review comment:
       Nit: `A server-side` not `An server-side`. Unnecessary `n`.




-- 
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