dimas-b commented on code in PR #2012:
URL: https://github.com/apache/polaris/pull/2012#discussion_r2207846885


##########
spec/polaris-management-service.yml:
##########
@@ -1056,6 +1056,12 @@ components:
               type: string
               description: endpoint for STS requests (optional). If not set, 
defaults to 'endpoint'.
               example: "https://sts.example.com:1234";
+            pathStyleAccess:
+              type: boolean
+              description: >- 
+                Whether S3 requests to files in this catalog should use 
'path-style addressing for buckets'.
+                Default: false.

Review Comment:
   If we add a `default` declaration in the Open API YAML, then the Open API 
generators will produce API-level classes in a way that will _always_ put the 
`pathStyleAccess` attribute into JSON responses.
   
   My changes in this PR specifically avoid that situation to ensure "no 
behaviour" change in existing servers.
   
   I personally think that this kind of backward-compatibility guarantee is 
preferable to adding a `default` declaration to the Open API YAML.
   
   @eric-maynard : what benefit do you see in having `default` in Open API YAML?



-- 
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...@polaris.apache.org

For queries about this service, please contact Infrastructure at:
us...@infra.apache.org

Reply via email to