-
Notifications
You must be signed in to change notification settings - Fork 332
[OpenAPI Modification] Return created objects #2603
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
[OpenAPI Modification] Return created objects #2603
Conversation
…CatalogRole to return 204 (No Content) on success
adutra
left a comment
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The changes LGTM but you will need to adapt some of the regtests.
spec/polaris-management-service.yml
Outdated
| $ref: "#/components/schemas/RevokeGrantRequest" | ||
| responses: | ||
| 201: | ||
| 204: |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This is technically a breaking change per our current "evolution" approach: https://polaris.apache.org/releases/1.0.1/evolution/#semantic-versioning
The change itself is meaningful, but if we make it, I suppose we'd have to do a major version bump (which is ok from my POV)..
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Removed as per ML - and will introduce it separately.
adutra
left a comment
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
LGTM. I wasn't too worried about the 201 -> 204 change, but I agree that it's better to leave this change out.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Code changes LGTM 👍 , but I believe this change is worth mentioning in CHANGELOG.md, probably in the Changes section.
flyrain
left a comment
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
LGTM
HonahX
left a comment
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
LGTM! +1 on adding a line in the CHANGELOG to reveal this. We should also update our python cli to print the entity, we can do that in a follow-up : )
5f27979
* Always propagate non-credential properties from AccessConfig to clients (apache#2615) * Always propagate non-credential properties from AccessConfig to clients This change builds on top of apache#2589 and further prepares Polaris code to support non-STS S3 implementations for apache#2589. For S3 implementations that do have STS, this change enables clients to run with local credentials (no credential vending) and still receive endpoint configuration from the catalog. * Call `SupportsCredentialDelegation.getAccessConfig()` on all relevant create/load requests (previously it was called only when `vended-credentials` was requested * Always sent `AccessConfig.extraProperties()` to clients * Expose credentials to clients only when the `vended-credentials` access delegation mode is requested. * There is not client-visible behaviour change for implementations of `PolarisStorageIntegration` that do not produce "extra" `AccessConfig` properties. * [OpenAPI Modification] Return created objects (apache#2603) As per the ML thread [here](https://lists.apache.org/thread/q7q0rrsmw5gcqv30g4hr9ffq3gtr72yk), this PR introduces the change to return all objects that are created within their respective API calls. * chore(docs): reorganize getting-started section (apache#2611) * fix(deps): update dependency org.assertj:assertj-core to v3.27.6 (apache#2651) * fix: fix broken markdown-link-check CI job after apache#2611 got merged (apache#2655) * Release artifacts should use dlcdn.apache.org (signature and checksum must refer downloads.apache.org) (apache#2647) * docs: Update S3 getting started guides (apache#2652) * fix(deps): update dependency com.google.cloud:google-cloud-storage-bom to v2.58.0 (apache#2660) * fix(deps): update dependency org.apache.spark:spark-sql_2.12 to v3.5.7 (apache#2659) * fix(deps): update dependency org.apache.spark:spark-sql_2.12 to v3.5.7 (apache#2658) * Fix Issue 2024 for Rendering Blockquotes (apache#2656) * Fix Issue 2024 for Rendering Blockquotes * Small fix for URLs * Update license * Last merged commit fcb6b33 --------- Co-authored-by: Dmitri Bourlatchkov <dmitri.bourlatchkov@gmail.com> Co-authored-by: Adnan Hemani <adnan.h@berkeley.edu> Co-authored-by: Artur Rakhmatulin <artur.rakhmatulin@gmail.com> Co-authored-by: Mend Renovate <bot@renovateapp.com> Co-authored-by: JB Onofré <jbonofre@apache.org> Co-authored-by: Adam Christian <105929021+adam-christian-software@users.noreply.github.com>
As per the ML thread here, this PR introduces the change to return all objects that are created within their respective API calls.
Additionally, therevokeGrantFromCatalogRoleAPI will now return 204 (No Content) on a successful call rather than 201 (Created).