You are viewing a plain text version of this content. The canonical link for it is here.
Posted to reviews@kudu.apache.org by "Gabriella Lotz (Code Review)" <ge...@cloudera.org> on 2025/11/10 13:55:00 UTC

[kudu-CR](gh-pages) Add Introducing REST API blog post

Gabriella Lotz has uploaded this change for review. ( http://gerrit.cloudera.org:8080/23655


Change subject: Add Introducing REST API blog post
......................................................................

Add Introducing REST API blog post

Change-Id: I1435431857a9f493e6492fae002c70f7af4cdd6c
---
A _posts/2025-11-10-introducing-the-rest-api.md
A img/swagger.png
2 files changed, 113 insertions(+), 0 deletions(-)



  git pull ssh://gerrit.cloudera.org:29418/kudu refs/changes/55/23655/1
-- 
To view, visit http://gerrit.cloudera.org:8080/23655
To unsubscribe, visit http://gerrit.cloudera.org:8080/settings

Gerrit-Project: kudu
Gerrit-Branch: gh-pages
Gerrit-MessageType: newchange
Gerrit-Change-Id: I1435431857a9f493e6492fae002c70f7af4cdd6c
Gerrit-Change-Number: 23655
Gerrit-PatchSet: 1
Gerrit-Owner: Gabriella Lotz <lo...@gmail.com>

[kudu-CR](gh-pages) Add Introducing REST API blog post

Posted by "Zoltan Chovan (Code Review)" <ge...@cloudera.org>.
Zoltan Chovan has posted comments on this change. ( http://gerrit.cloudera.org:8080/23655 )

Change subject: Add Introducing REST API blog post
......................................................................


Patch Set 3: Code-Review+2


-- 
To view, visit http://gerrit.cloudera.org:8080/23655
To unsubscribe, visit http://gerrit.cloudera.org:8080/settings

Gerrit-Project: kudu
Gerrit-Branch: gh-pages
Gerrit-MessageType: comment
Gerrit-Change-Id: I1435431857a9f493e6492fae002c70f7af4cdd6c
Gerrit-Change-Number: 23655
Gerrit-PatchSet: 3
Gerrit-Owner: Gabriella Lotz <lo...@gmail.com>
Gerrit-Reviewer: Abhishek Chennaka <ac...@cloudera.com>
Gerrit-Reviewer: Alexey Serbin <al...@apache.org>
Gerrit-Reviewer: Gabriella Lotz <lo...@gmail.com>
Gerrit-Reviewer: Marton Greber <gr...@gmail.com>
Gerrit-Reviewer: Zoltan Chovan <zc...@cloudera.com>
Gerrit-Comment-Date: Mon, 08 Dec 2025 13:16:25 +0000
Gerrit-HasComments: No

[kudu-CR](gh-pages) Add Introducing REST API blog post

Posted by "Alexey Serbin (Code Review)" <ge...@cloudera.org>.
Alexey Serbin has posted comments on this change. ( http://gerrit.cloudera.org:8080/23655 )

Change subject: Add Introducing REST API blog post
......................................................................


Patch Set 2:

(12 comments)

http://gerrit.cloudera.org:8080/#/c/23655/2/_posts/2025-11-10-introducing-the-rest-api.md
File _posts/2025-11-10-introducing-the-rest-api.md:

PS2: 
For regular text content, could you break long lines so a single line would be of at most 80 characters long?  Many prior posts were adhering to such a layout (sometimes using 100 characters instead of 80, though).

At least, it's easier to review posts that are formatted as described above.

Thank you!


http://gerrit.cloudera.org:8080/#/c/23655/2/_posts/2025-11-10-introducing-the-rest-api.md@13
PS2, Line 13: full client application
client application that depends on the Kudu client library and uses KRPC to interact with Kudu clusters


http://gerrit.cloudera.org:8080/#/c/23655/2/_posts/2025-11-10-introducing-the-rest-api.md@13
PS2, Line 13: catalog
system catalog


http://gerrit.cloudera.org:8080/#/c/23655/2/_posts/2025-11-10-introducing-the-rest-api.md@13
PS2, Line 13: table-metadata
table metadata ?


http://gerrit.cloudera.org:8080/#/c/23655/2/_posts/2025-11-10-introducing-the-rest-api.md@24
PS2, Line 24: table metadata management
Here and elsewhere in appropriate context: being 'table metadata' from the Kudu's system catalog view, in the outside world of applications and SQL it's usually referred to as 'altering a table', 'DDL operations', etc.  Consider rephrasing 'table metadata management' to be more descriptive of what this means to the outside world.


http://gerrit.cloudera.org:8080/#/c/23655/2/_posts/2025-11-10-introducing-the-rest-api.md@89
PS2, Line 89: master's web UI
Does it make sense to provide path the the API doc page from the root of the embedded webserver?


http://gerrit.cloudera.org:8080/#/c/23655/2/_posts/2025-11-10-introducing-the-rest-api.md@89
PS2, Line 89: OpenAPI
Consider adding an extra Reference section to provide hyperlinks to OpenAPI and other external resources for the readers' convenience.  In addition to OpenAPI link, maybe add references/links to the Kudu C++ and Java client API as well (they are referenced in the beginning of this post).


http://gerrit.cloudera.org:8080/#/c/23655/2/_posts/2025-11-10-introducing-the-rest-api.md@96
PS2, Line 96: will return errors
Maybe, be more specific as for what particular HTTP status code non-leader masters respond with?


http://gerrit.cloudera.org:8080/#/c/23655/2/_posts/2025-11-10-introducing-the-rest-api.md@96
PS2, Line 96: only the leader master will respond to REST API requests
Non-leader masters respond as well, but they respond with errors, IIUC.  Please rephrase this part of the sentence to be technically correct.


http://gerrit.cloudera.org:8080/#/c/23655/2/_posts/2025-11-10-introducing-the-rest-api.md@96
PS2, Line 96: connect to the correct master
Since it's not quite evident for people without Kudu or other distributed systems background, consider mentioning that leader master might change at any time, and it's necessary to find a new leader and change the destination URL once receiving particular HTTP status code from the Kudu master that the application received the error.


http://gerrit.cloudera.org:8080/#/c/23655/2/_posts/2025-11-10-introducing-the-rest-api.md@96
PS2, Line 96: configurations
Kudu clusters


http://gerrit.cloudera.org:8080/#/c/23655/2/_posts/2025-11-10-introducing-the-rest-api.md@99
PS2, Line 99:  for optimal performance
nit: drop this part?



-- 
To view, visit http://gerrit.cloudera.org:8080/23655
To unsubscribe, visit http://gerrit.cloudera.org:8080/settings

Gerrit-Project: kudu
Gerrit-Branch: gh-pages
Gerrit-MessageType: comment
Gerrit-Change-Id: I1435431857a9f493e6492fae002c70f7af4cdd6c
Gerrit-Change-Number: 23655
Gerrit-PatchSet: 2
Gerrit-Owner: Gabriella Lotz <lo...@gmail.com>
Gerrit-Reviewer: Abhishek Chennaka <ac...@cloudera.com>
Gerrit-Reviewer: Alexey Serbin <al...@apache.org>
Gerrit-Reviewer: Gabriella Lotz <lo...@gmail.com>
Gerrit-Reviewer: Marton Greber <gr...@gmail.com>
Gerrit-Comment-Date: Tue, 18 Nov 2025 00:12:25 +0000
Gerrit-HasComments: Yes

[kudu-CR](gh-pages) Add Introducing REST API blog post

Posted by "Marton Greber (Code Review)" <ge...@cloudera.org>.
Marton Greber has posted comments on this change. ( http://gerrit.cloudera.org:8080/23655 )

Change subject: Add Introducing REST API blog post
......................................................................


Patch Set 1:

(12 comments)

Thank you Gabi for putting this article together!
I've posted a couple observations, suggestions. Let me know what you think.

http://gerrit.cloudera.org:8080/#/c/23655/1/_posts/2025-11-10-introducing-the-rest-api.md
File _posts/2025-11-10-introducing-the-rest-api.md:

http://gerrit.cloudera.org:8080/#/c/23655/1/_posts/2025-11-10-introducing-the-rest-api.md@3
PS1, Line 3: REST API to Apache Kudu
Not sure what was the final naming that we agreed on, but I think it would be important to outline that this API is for metadata management.
eg.: REST catalog; REST API for metadata management.


http://gerrit.cloudera.org:8080/#/c/23655/1/_posts/2025-11-10-introducing-the-rest-api.md@7
PS1, Line 7: high-performance
not sure if this is needed or just saying client applications is enough.


http://gerrit.cloudera.org:8080/#/c/23655/1/_posts/2025-11-10-introducing-the-rest-api.md@7
PS1, Line 7: REST API
REST API for metadata management


http://gerrit.cloudera.org:8080/#/c/23655/1/_posts/2025-11-10-introducing-the-rest-api.md@13
PS1, Line 13: The REST API in Apache Kudu provides a comprehensive HTTP interface for table metadata management operations. Built on top of Kudu's existing catalog management system, the API follows RESTful principles and returns JSON responses. This makes it easy to integrate Kudu with a wide range of applications and tools that can communicate over HTTP.
I think its not necessary to mention explicitly the json response part. I would outline that the main win is that for metadata operations one can omit a full client app and rather use rest. I would say:

The Apache Kudu REST API exposes table-metadata and administrative operations over HTTP on top of Kudu’s catalog. It lets users handle these tasks with lightweight REST calls instead of building a full client application.

What do you think?


http://gerrit.cloudera.org:8080/#/c/23655/1/_posts/2025-11-10-introducing-the-rest-api.md@21
PS1, Line 21: * **Leader-only Operations**: In multi-master setups, only the leader responds to requests
            : * **Leader Discovery**: Built-in endpoint to discover the current cluster leader
I would maybe say that remove these two bullet points from here. (In my opinion these fit more into the 'limitations' part)

Then maybe later rename the "Important Notes" section to "Limitations" and outline things there.


http://gerrit.cloudera.org:8080/#/c/23655/1/_posts/2025-11-10-introducing-the-rest-api.md@26
PS1, Line 26: `/api/v1/`
maybe mention that this is available on masters webserver on this path.


http://gerrit.cloudera.org:8080/#/c/23655/1/_posts/2025-11-10-introducing-the-rest-api.md@37
PS1, Line 37: ### Example Responses
IIUC these are now two responses. Without the request path/method it lacks context.

What do you think about adding a basic GET /api/v1/tables/<table_id> request
with the corresponding response here. Would that be more illustrative?


http://gerrit.cloudera.org:8080/#/c/23655/1/_posts/2025-11-10-introducing-the-rest-api.md@97
PS1, Line 97: For complete API documentation and examples, check out our Swagger UI:
            : ![png]({{ site.github.url }}/img/swagger.png){: .img-responsive}
While thinking about this I've figured that it would be nice to have the Swagger docs also on the Apache Kudu web site, for that I've filed: KUDU-3715

In the meantime in the article I think you can add a link to the raw api json:
https://github.com/apache/kudu/blob/master/www/swagger/kudu-api.json

And mention that on a Kudu cluster running this new feature the api docs are accessible on the webui. (If fancy you could add a screenshot)


http://gerrit.cloudera.org:8080/#/c/23655/1/_posts/2025-11-10-introducing-the-rest-api.md@100
PS1, Line 100: ## Important Notes
As mentioned above, I think a "Limitations" section would maybe be better here.


http://gerrit.cloudera.org:8080/#/c/23655/1/_posts/2025-11-10-introducing-the-rest-api.md@102
PS1, Line 102: ### Authentication
             : The REST API supports Kerberos/SPNEGO authentication, integrating seamlessly with Kudu's existing security mechanisms.
In case you go with the "Limitations" approach this could be removed from this section.


http://gerrit.cloudera.org:8080/#/c/23655/1/_posts/2025-11-10-introducing-the-rest-api.md@106
PS1, Line 106: In multi-master configurations, only the leader master will respond to REST API requests. Follower masters will return errors, so applications should use the leader discovery endpoint to find the correct master to connect to.
Maybe mention here that users can get the leader address by using the leader the /api/v1/leader endpoint.


http://gerrit.cloudera.org:8080/#/c/23655/1/_posts/2025-11-10-introducing-the-rest-api.md@111
PS1, Line 111: ## Configuration
Does it make sense to mention the webserver_enabled flag as well?



-- 
To view, visit http://gerrit.cloudera.org:8080/23655
To unsubscribe, visit http://gerrit.cloudera.org:8080/settings

Gerrit-Project: kudu
Gerrit-Branch: gh-pages
Gerrit-MessageType: comment
Gerrit-Change-Id: I1435431857a9f493e6492fae002c70f7af4cdd6c
Gerrit-Change-Number: 23655
Gerrit-PatchSet: 1
Gerrit-Owner: Gabriella Lotz <lo...@gmail.com>
Gerrit-Reviewer: Marton Greber <gr...@gmail.com>
Gerrit-Comment-Date: Tue, 11 Nov 2025 13:53:01 +0000
Gerrit-HasComments: Yes

[kudu-CR](gh-pages) Add Introducing REST API blog post

Posted by "Alexey Serbin (Code Review)" <ge...@cloudera.org>.
Alexey Serbin has posted comments on this change. ( http://gerrit.cloudera.org:8080/23655 )

Change subject: Add Introducing REST API blog post
......................................................................


Patch Set 3: Verified+1


-- 
To view, visit http://gerrit.cloudera.org:8080/23655
To unsubscribe, visit http://gerrit.cloudera.org:8080/settings

Gerrit-Project: kudu
Gerrit-Branch: gh-pages
Gerrit-MessageType: comment
Gerrit-Change-Id: I1435431857a9f493e6492fae002c70f7af4cdd6c
Gerrit-Change-Number: 23655
Gerrit-PatchSet: 3
Gerrit-Owner: Gabriella Lotz <lo...@gmail.com>
Gerrit-Reviewer: Abhishek Chennaka <ac...@cloudera.com>
Gerrit-Reviewer: Alexey Serbin <al...@apache.org>
Gerrit-Reviewer: Gabriella Lotz <lo...@gmail.com>
Gerrit-Reviewer: Marton Greber <gr...@gmail.com>
Gerrit-Comment-Date: Tue, 02 Dec 2025 02:12:56 +0000
Gerrit-HasComments: No

[kudu-CR](gh-pages) Add Introducing REST API blog post

Posted by "Abhishek Chennaka (Code Review)" <ge...@cloudera.org>.
Abhishek Chennaka has posted comments on this change. ( http://gerrit.cloudera.org:8080/23655 )

Change subject: Add Introducing REST API blog post
......................................................................


Patch Set 3: Code-Review+2


-- 
To view, visit http://gerrit.cloudera.org:8080/23655
To unsubscribe, visit http://gerrit.cloudera.org:8080/settings

Gerrit-Project: kudu
Gerrit-Branch: gh-pages
Gerrit-MessageType: comment
Gerrit-Change-Id: I1435431857a9f493e6492fae002c70f7af4cdd6c
Gerrit-Change-Number: 23655
Gerrit-PatchSet: 3
Gerrit-Owner: Gabriella Lotz <lo...@gmail.com>
Gerrit-Reviewer: Abhishek Chennaka <ac...@cloudera.com>
Gerrit-Reviewer: Alexey Serbin <al...@apache.org>
Gerrit-Reviewer: Gabriella Lotz <lo...@gmail.com>
Gerrit-Reviewer: Marton Greber <gr...@gmail.com>
Gerrit-Comment-Date: Fri, 05 Dec 2025 04:25:01 +0000
Gerrit-HasComments: No

[kudu-CR](gh-pages) Add Introducing REST API blog post

Posted by "Marton Greber (Code Review)" <ge...@cloudera.org>.
Marton Greber has submitted this change and it was merged. ( http://gerrit.cloudera.org:8080/23655 )

Change subject: Add Introducing REST API blog post
......................................................................

Add Introducing REST API blog post

Preview can be found at
https://gabriellalotz.github.io/2025/11/10/introducing-the-rest-api.html

Change-Id: I1435431857a9f493e6492fae002c70f7af4cdd6c
Reviewed-on: http://gerrit.cloudera.org:8080/23655
Reviewed-by: Alexey Serbin <al...@apache.org>
Tested-by: Alexey Serbin <al...@apache.org>
Reviewed-by: Abhishek Chennaka <ac...@cloudera.com>
Reviewed-by: Marton Greber <gr...@gmail.com>
Reviewed-by: Zoltan Chovan <zc...@cloudera.com>
Reviewed-by: Attila Bukor <ab...@apache.org>
---
A _posts/2025-11-10-introducing-the-rest-api.md
A img/swagger.png
2 files changed, 142 insertions(+), 0 deletions(-)

Approvals:
  Alexey Serbin: Looks good to me, approved; Verified
  Abhishek Chennaka: Looks good to me, approved
  Marton Greber: Looks good to me, approved
  Zoltan Chovan: Looks good to me, approved
  Attila Bukor: Looks good to me, approved

-- 
To view, visit http://gerrit.cloudera.org:8080/23655
To unsubscribe, visit http://gerrit.cloudera.org:8080/settings

Gerrit-Project: kudu
Gerrit-Branch: gh-pages
Gerrit-MessageType: merged
Gerrit-Change-Id: I1435431857a9f493e6492fae002c70f7af4cdd6c
Gerrit-Change-Number: 23655
Gerrit-PatchSet: 4
Gerrit-Owner: Gabriella Lotz <lo...@gmail.com>
Gerrit-Reviewer: Abhishek Chennaka <ac...@cloudera.com>
Gerrit-Reviewer: Alexey Serbin <al...@apache.org>
Gerrit-Reviewer: Attila Bukor <ab...@apache.org>
Gerrit-Reviewer: Gabriella Lotz <lo...@gmail.com>
Gerrit-Reviewer: Marton Greber <gr...@gmail.com>
Gerrit-Reviewer: Zoltan Chovan <zc...@cloudera.com>

[kudu-CR](gh-pages) Add Introducing REST API blog post

Posted by "Abhishek Chennaka (Code Review)" <ge...@cloudera.org>.
Abhishek Chennaka has posted comments on this change. ( http://gerrit.cloudera.org:8080/23655 )

Change subject: Add Introducing REST API blog post
......................................................................


Patch Set 2:

(2 comments)

http://gerrit.cloudera.org:8080/#/c/23655/2/_posts/2025-11-10-introducing-the-rest-api.md
File _posts/2025-11-10-introducing-the-rest-api.md:

http://gerrit.cloudera.org:8080/#/c/23655/2/_posts/2025-11-10-introducing-the-rest-api.md@7
PS2, Line 7:  tools
Consider adding which version of Kudu this feature is supported from.


http://gerrit.cloudera.org:8080/#/c/23655/2/_posts/2025-11-10-introducing-the-rest-api.md@20
PS2, Line 20: Integrates with Kudu's existing authentication mechanisms
nit: Since most of the clusters use security, consider adding extending the example to talk to a secure cluster



-- 
To view, visit http://gerrit.cloudera.org:8080/23655
To unsubscribe, visit http://gerrit.cloudera.org:8080/settings

Gerrit-Project: kudu
Gerrit-Branch: gh-pages
Gerrit-MessageType: comment
Gerrit-Change-Id: I1435431857a9f493e6492fae002c70f7af4cdd6c
Gerrit-Change-Number: 23655
Gerrit-PatchSet: 2
Gerrit-Owner: Gabriella Lotz <lo...@gmail.com>
Gerrit-Reviewer: Abhishek Chennaka <ac...@cloudera.com>
Gerrit-Reviewer: Gabriella Lotz <lo...@gmail.com>
Gerrit-Reviewer: Marton Greber <gr...@gmail.com>
Gerrit-Comment-Date: Mon, 17 Nov 2025 21:59:36 +0000
Gerrit-HasComments: Yes

[kudu-CR](gh-pages) Add Introducing REST API blog post

Posted by "Alexey Serbin (Code Review)" <ge...@cloudera.org>.
Alexey Serbin has posted comments on this change. ( http://gerrit.cloudera.org:8080/23655 )

Change subject: Add Introducing REST API blog post
......................................................................


Patch Set 3: Code-Review+2


-- 
To view, visit http://gerrit.cloudera.org:8080/23655
To unsubscribe, visit http://gerrit.cloudera.org:8080/settings

Gerrit-Project: kudu
Gerrit-Branch: gh-pages
Gerrit-MessageType: comment
Gerrit-Change-Id: I1435431857a9f493e6492fae002c70f7af4cdd6c
Gerrit-Change-Number: 23655
Gerrit-PatchSet: 3
Gerrit-Owner: Gabriella Lotz <lo...@gmail.com>
Gerrit-Reviewer: Abhishek Chennaka <ac...@cloudera.com>
Gerrit-Reviewer: Alexey Serbin <al...@apache.org>
Gerrit-Reviewer: Gabriella Lotz <lo...@gmail.com>
Gerrit-Reviewer: Marton Greber <gr...@gmail.com>
Gerrit-Comment-Date: Tue, 02 Dec 2025 02:12:14 +0000
Gerrit-HasComments: No

[kudu-CR](gh-pages) Add Introducing REST API blog post

Posted by "Attila Bukor (Code Review)" <ge...@cloudera.org>.
Attila Bukor has posted comments on this change. ( http://gerrit.cloudera.org:8080/23655 )

Change subject: Add Introducing REST API blog post
......................................................................


Patch Set 3: Code-Review+2


-- 
To view, visit http://gerrit.cloudera.org:8080/23655
To unsubscribe, visit http://gerrit.cloudera.org:8080/settings

Gerrit-Project: kudu
Gerrit-Branch: gh-pages
Gerrit-MessageType: comment
Gerrit-Change-Id: I1435431857a9f493e6492fae002c70f7af4cdd6c
Gerrit-Change-Number: 23655
Gerrit-PatchSet: 3
Gerrit-Owner: Gabriella Lotz <lo...@gmail.com>
Gerrit-Reviewer: Abhishek Chennaka <ac...@cloudera.com>
Gerrit-Reviewer: Alexey Serbin <al...@apache.org>
Gerrit-Reviewer: Attila Bukor <ab...@apache.org>
Gerrit-Reviewer: Gabriella Lotz <lo...@gmail.com>
Gerrit-Reviewer: Marton Greber <gr...@gmail.com>
Gerrit-Reviewer: Zoltan Chovan <zc...@cloudera.com>
Gerrit-Comment-Date: Mon, 08 Dec 2025 13:17:44 +0000
Gerrit-HasComments: No

[kudu-CR](gh-pages) Add Introducing REST API blog post

Posted by "Gabriella Lotz (Code Review)" <ge...@cloudera.org>.
Gabriella Lotz has posted comments on this change. ( http://gerrit.cloudera.org:8080/23655 )

Change subject: Add Introducing REST API blog post
......................................................................


Patch Set 2:

(15 comments)

http://gerrit.cloudera.org:8080/#/c/23655/2/_posts/2025-11-10-introducing-the-rest-api.md
File _posts/2025-11-10-introducing-the-rest-api.md:

PS2: 
> For regular text content, could you break long lines so a single line would
Done


http://gerrit.cloudera.org:8080/#/c/23655/2/_posts/2025-11-10-introducing-the-rest-api.md@7
PS2, Line 7:  tools
> Consider adding which version of Kudu this feature is supported from.
Done


http://gerrit.cloudera.org:8080/#/c/23655/2/_posts/2025-11-10-introducing-the-rest-api.md@13
PS2, Line 13: full client application
> client application that depends on the Kudu client library and uses KRPC to
Done


http://gerrit.cloudera.org:8080/#/c/23655/2/_posts/2025-11-10-introducing-the-rest-api.md@13
PS2, Line 13: catalog
> system catalog
Done


http://gerrit.cloudera.org:8080/#/c/23655/2/_posts/2025-11-10-introducing-the-rest-api.md@13
PS2, Line 13: table-metadata
> table metadata ?
Done


http://gerrit.cloudera.org:8080/#/c/23655/2/_posts/2025-11-10-introducing-the-rest-api.md@20
PS2, Line 20: Integrates with Kudu's existing authentication mechanisms
> nit: Since most of the clusters use security, consider adding extending the
Thanks for the suggestion. I've added a brief note about authentication for secure clusters after the example. Since this is an introductory article rather than complete documentation, I kept it concise.


http://gerrit.cloudera.org:8080/#/c/23655/2/_posts/2025-11-10-introducing-the-rest-api.md@24
PS2, Line 24: table metadata management
> Here and elsewhere in appropriate context: being 'table metadata' from the 
Done


http://gerrit.cloudera.org:8080/#/c/23655/2/_posts/2025-11-10-introducing-the-rest-api.md@89
PS2, Line 89: OpenAPI
> Consider adding an extra Reference section to provide hyperlinks to OpenAPI
Done


http://gerrit.cloudera.org:8080/#/c/23655/2/_posts/2025-11-10-introducing-the-rest-api.md@89
PS2, Line 89: master's web UI
> Does it make sense to provide path the the API doc page from the root of th
Done


http://gerrit.cloudera.org:8080/#/c/23655/2/_posts/2025-11-10-introducing-the-rest-api.md@89
PS2, Line 89: interactive
> nit: iirc it is not interactive as that was pulled out because of Knox righ
Done


http://gerrit.cloudera.org:8080/#/c/23655/2/_posts/2025-11-10-introducing-the-rest-api.md@96
PS2, Line 96: will return errors
> Maybe, be more specific as for what particular HTTP status code non-leader 
Done


http://gerrit.cloudera.org:8080/#/c/23655/2/_posts/2025-11-10-introducing-the-rest-api.md@96
PS2, Line 96: only the leader master will respond to REST API requests
> Non-leader masters respond as well, but they respond with errors, IIUC.  Pl
Done


http://gerrit.cloudera.org:8080/#/c/23655/2/_posts/2025-11-10-introducing-the-rest-api.md@96
PS2, Line 96: configurations
> Kudu clusters
Done


http://gerrit.cloudera.org:8080/#/c/23655/2/_posts/2025-11-10-introducing-the-rest-api.md@96
PS2, Line 96: connect to the correct master
> Since it's not quite evident for people without Kudu or other distributed s
Done


http://gerrit.cloudera.org:8080/#/c/23655/2/_posts/2025-11-10-introducing-the-rest-api.md@99
PS2, Line 99:  for optimal performance
> nit: drop this part?
Done



-- 
To view, visit http://gerrit.cloudera.org:8080/23655
To unsubscribe, visit http://gerrit.cloudera.org:8080/settings

Gerrit-Project: kudu
Gerrit-Branch: gh-pages
Gerrit-MessageType: comment
Gerrit-Change-Id: I1435431857a9f493e6492fae002c70f7af4cdd6c
Gerrit-Change-Number: 23655
Gerrit-PatchSet: 2
Gerrit-Owner: Gabriella Lotz <lo...@gmail.com>
Gerrit-Reviewer: Abhishek Chennaka <ac...@cloudera.com>
Gerrit-Reviewer: Alexey Serbin <al...@apache.org>
Gerrit-Reviewer: Gabriella Lotz <lo...@gmail.com>
Gerrit-Reviewer: Marton Greber <gr...@gmail.com>
Gerrit-Comment-Date: Thu, 27 Nov 2025 10:14:25 +0000
Gerrit-HasComments: Yes

[kudu-CR](gh-pages) Add Introducing REST API blog post

Posted by "Gabriella Lotz (Code Review)" <ge...@cloudera.org>.
Hello Marton Greber, Alexey Serbin, Abhishek Chennaka, 

I'd like you to reexamine a change. Please visit

    http://gerrit.cloudera.org:8080/23655

to look at the new patch set (#3).

Change subject: Add Introducing REST API blog post
......................................................................

Add Introducing REST API blog post

Preview can be found at
https://gabriellalotz.github.io/2025/11/10/introducing-the-rest-api.html

Change-Id: I1435431857a9f493e6492fae002c70f7af4cdd6c
---
A _posts/2025-11-10-introducing-the-rest-api.md
A img/swagger.png
2 files changed, 142 insertions(+), 0 deletions(-)


  git pull ssh://gerrit.cloudera.org:29418/kudu refs/changes/55/23655/3
-- 
To view, visit http://gerrit.cloudera.org:8080/23655
To unsubscribe, visit http://gerrit.cloudera.org:8080/settings

Gerrit-Project: kudu
Gerrit-Branch: gh-pages
Gerrit-MessageType: newpatchset
Gerrit-Change-Id: I1435431857a9f493e6492fae002c70f7af4cdd6c
Gerrit-Change-Number: 23655
Gerrit-PatchSet: 3
Gerrit-Owner: Gabriella Lotz <lo...@gmail.com>
Gerrit-Reviewer: Abhishek Chennaka <ac...@cloudera.com>
Gerrit-Reviewer: Alexey Serbin <al...@apache.org>
Gerrit-Reviewer: Gabriella Lotz <lo...@gmail.com>
Gerrit-Reviewer: Marton Greber <gr...@gmail.com>

[kudu-CR](gh-pages) Add Introducing REST API blog post

Posted by "Marton Greber (Code Review)" <ge...@cloudera.org>.
Marton Greber has posted comments on this change. ( http://gerrit.cloudera.org:8080/23655 )

Change subject: Add Introducing REST API blog post
......................................................................


Patch Set 2: Code-Review+1

(1 comment)

http://gerrit.cloudera.org:8080/#/c/23655/2/_posts/2025-11-10-introducing-the-rest-api.md
File _posts/2025-11-10-introducing-the-rest-api.md:

http://gerrit.cloudera.org:8080/#/c/23655/2/_posts/2025-11-10-introducing-the-rest-api.md@89
PS2, Line 89: interactive
nit: iirc it is not interactive as that was pulled out because of Knox right? In that case just leave the interactive word.



-- 
To view, visit http://gerrit.cloudera.org:8080/23655
To unsubscribe, visit http://gerrit.cloudera.org:8080/settings

Gerrit-Project: kudu
Gerrit-Branch: gh-pages
Gerrit-MessageType: comment
Gerrit-Change-Id: I1435431857a9f493e6492fae002c70f7af4cdd6c
Gerrit-Change-Number: 23655
Gerrit-PatchSet: 2
Gerrit-Owner: Gabriella Lotz <lo...@gmail.com>
Gerrit-Reviewer: Gabriella Lotz <lo...@gmail.com>
Gerrit-Reviewer: Marton Greber <gr...@gmail.com>
Gerrit-Comment-Date: Mon, 17 Nov 2025 18:25:28 +0000
Gerrit-HasComments: Yes

[kudu-CR](gh-pages) Add Introducing REST API blog post

Posted by "Marton Greber (Code Review)" <ge...@cloudera.org>.
Marton Greber has posted comments on this change. ( http://gerrit.cloudera.org:8080/23655 )

Change subject: Add Introducing REST API blog post
......................................................................


Patch Set 3: Code-Review+2


-- 
To view, visit http://gerrit.cloudera.org:8080/23655
To unsubscribe, visit http://gerrit.cloudera.org:8080/settings

Gerrit-Project: kudu
Gerrit-Branch: gh-pages
Gerrit-MessageType: comment
Gerrit-Change-Id: I1435431857a9f493e6492fae002c70f7af4cdd6c
Gerrit-Change-Number: 23655
Gerrit-PatchSet: 3
Gerrit-Owner: Gabriella Lotz <lo...@gmail.com>
Gerrit-Reviewer: Abhishek Chennaka <ac...@cloudera.com>
Gerrit-Reviewer: Alexey Serbin <al...@apache.org>
Gerrit-Reviewer: Gabriella Lotz <lo...@gmail.com>
Gerrit-Reviewer: Marton Greber <gr...@gmail.com>
Gerrit-Comment-Date: Mon, 08 Dec 2025 13:16:12 +0000
Gerrit-HasComments: No

[kudu-CR](gh-pages) Add Introducing REST API blog post

Posted by "Gabriella Lotz (Code Review)" <ge...@cloudera.org>.
Gabriella Lotz has posted comments on this change. ( http://gerrit.cloudera.org:8080/23655 )

Change subject: Add Introducing REST API blog post
......................................................................


Patch Set 2:

(12 comments)

http://gerrit.cloudera.org:8080/#/c/23655/1/_posts/2025-11-10-introducing-the-rest-api.md
File _posts/2025-11-10-introducing-the-rest-api.md:

http://gerrit.cloudera.org:8080/#/c/23655/1/_posts/2025-11-10-introducing-the-rest-api.md@3
PS1, Line 3: REST API for metadata m
> Not sure what was the final naming that we agreed on, but I think it would 
Done


http://gerrit.cloudera.org:8080/#/c/23655/1/_posts/2025-11-10-introducing-the-rest-api.md@7
PS1, Line 7: or metad
> REST API for metadata management
Done


http://gerrit.cloudera.org:8080/#/c/23655/1/_posts/2025-11-10-introducing-the-rest-api.md@7
PS1, Line 7: client applicati
> not sure if this is needed or just saying client applications is enough.
Done


http://gerrit.cloudera.org:8080/#/c/23655/1/_posts/2025-11-10-introducing-the-rest-api.md@13
PS1, Line 13: The Apache Kudu REST API exposes table-metadata and administrative operations over HTTP on top of Kudu's catalog. It lets users handle these tasks with lightweight REST calls instead of building a full client application.
> I think its not necessary to mention explicitly the json response part. I w
Done


http://gerrit.cloudera.org:8080/#/c/23655/1/_posts/2025-11-10-introducing-the-rest-api.md@21
PS1, Line 21: 
            : ## API Overview
> I would maybe say that remove these two bullet points from here. (In my opi
Done


http://gerrit.cloudera.org:8080/#/c/23655/1/_posts/2025-11-10-introducing-the-rest-api.md@26
PS1, Line 26: 
> maybe mention that this is available on masters webserver on this path.
Done


http://gerrit.cloudera.org:8080/#/c/23655/1/_posts/2025-11-10-introducing-the-rest-api.md@37
PS1, Line 37: **GET** `/api/v1/tabl
> IIUC these are now two responses. Without the request path/method it lacks 
Done


http://gerrit.cloudera.org:8080/#/c/23655/1/_posts/2025-11-10-introducing-the-rest-api.md@97
PS1, Line 97: 
            : ### Metadata Only
> While thinking about this I've figured that it would be nice to have the Sw
Done


http://gerrit.cloudera.org:8080/#/c/23655/1/_posts/2025-11-10-introducing-the-rest-api.md@100
PS1, Line 100: 
> As mentioned above, I think a "Limitations" section would maybe be better h
Done


http://gerrit.cloudera.org:8080/#/c/23655/1/_posts/2025-11-10-introducing-the-rest-api.md@102
PS1, Line 102: 
             : The REST API must be explicitly enabled using the `--enable_rest_api` flag on Kudu masters. The master's webserver mus
> In case you go with the "Limitations" approach this could be removed from t
Done


http://gerrit.cloudera.org:8080/#/c/23655/1/_posts/2025-11-10-introducing-the-rest-api.md@106
PS1, Line 106: 
> Maybe mention here that users can get the leader address by using the leade
Done


http://gerrit.cloudera.org:8080/#/c/23655/1/_posts/2025-11-10-introducing-the-rest-api.md@111
PS1, Line 111: 
> Does it make sense to mention the webserver_enabled flag as well?
Done



-- 
To view, visit http://gerrit.cloudera.org:8080/23655
To unsubscribe, visit http://gerrit.cloudera.org:8080/settings

Gerrit-Project: kudu
Gerrit-Branch: gh-pages
Gerrit-MessageType: comment
Gerrit-Change-Id: I1435431857a9f493e6492fae002c70f7af4cdd6c
Gerrit-Change-Number: 23655
Gerrit-PatchSet: 2
Gerrit-Owner: Gabriella Lotz <lo...@gmail.com>
Gerrit-Reviewer: Gabriella Lotz <lo...@gmail.com>
Gerrit-Reviewer: Marton Greber <gr...@gmail.com>
Gerrit-Comment-Date: Fri, 14 Nov 2025 14:15:16 +0000
Gerrit-HasComments: Yes

[kudu-CR](gh-pages) Add Introducing REST API blog post

Posted by "Gabriella Lotz (Code Review)" <ge...@cloudera.org>.
Hello Marton Greber, 

I'd like you to reexamine a change. Please visit

    http://gerrit.cloudera.org:8080/23655

to look at the new patch set (#2).

Change subject: Add Introducing REST API blog post
......................................................................

Add Introducing REST API blog post

Preview can be found at
https://gabriellalotz.github.io/2025/11/10/introducing-the-rest-api.html

Change-Id: I1435431857a9f493e6492fae002c70f7af4cdd6c
---
A _posts/2025-11-10-introducing-the-rest-api.md
A img/swagger.png
2 files changed, 103 insertions(+), 0 deletions(-)


  git pull ssh://gerrit.cloudera.org:29418/kudu refs/changes/55/23655/2
-- 
To view, visit http://gerrit.cloudera.org:8080/23655
To unsubscribe, visit http://gerrit.cloudera.org:8080/settings

Gerrit-Project: kudu
Gerrit-Branch: gh-pages
Gerrit-MessageType: newpatchset
Gerrit-Change-Id: I1435431857a9f493e6492fae002c70f7af4cdd6c
Gerrit-Change-Number: 23655
Gerrit-PatchSet: 2
Gerrit-Owner: Gabriella Lotz <lo...@gmail.com>
Gerrit-Reviewer: Marton Greber <gr...@gmail.com>