jackye1995 commented on code in PR #9695:
URL: https://github.com/apache/iceberg/pull/9695#discussion_r1623316510


##########
open-api/rest-catalog-open-api.yaml:
##########
@@ -3804,6 +4110,41 @@ components:
             }
           }
 
+    #  Note that this is a representative example response for use as a 
shorthand in the spec.
+    #  The fields `message` and `type` as indicated here are not presently 
prescriptive.
+    MisdirectedRequestResponse:
+      description:
+        Misdirected Request. The request was directed to a server that is not 
able to produce a response.
+      content:
+        application/json:
+          schema:
+            $ref: '#/components/schemas/IcebergErrorResponse'
+          example: {
+            "error": {
+              "message": "Fail to plan table scan: must perform preplan before 
planning a table scan",
+              "type": "PreplanTableRequiredException",
+              "code": 421
+            }
+          }
+
+    #  Note that this is a representative example response for use as a 
shorthand in the spec.
+    #  The fields `message` and `type` as indicated here are not presently 
prescriptive.
+    UnprocessableContentResponse:

Review Comment:
   I think @rdblue you suggested using 413 for payload too big, but based on 
the HTTP code, it looks like 413 is for Request payload too big, but what we 
want here is response payload too big. I think it can be covered by 422, so I 
changed to that with an example



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

Reply via email to