Hi Michael, Thank you very much for bringing this to our attention. You've made a very good point here. Currently, we keep Admin API and pulsar-admin reference as two parts: The Admin API tells users that they can interact with admin interface via pulsar-admin, REST API and client. It lists some generic operations and part of examples. It’s not complete, and some features supported by pulsar-admin are not supported by clients. So on the Admin API overview page <https://pulsar.apache.org/docs/en/next/admin-api-overview/>, we add a reference link and tell users to check the pulsar-admin reference page for detailed usage. The pulsar-admin reference page <https://pulsar.apache.org/docs/en/pulsar-admin/> can be used as wikipedia, which tries to collect all different command usage. (We're trying to abstract command usage from the code automatically, if someone is interested in it, looking forward to your contribution~)
In the long run, if the Pulsar community has a plan to support all features equally by pulsar-admin, REST API and client, we can consider listing all different usage supported by the pulsar-admin, REST API and java client in the Admin API section, and remove the pulsar-admin reference. Best Regards, Jennifer On Fri, Feb 26, 2021 at 11:44 PM Michael Marshall <mikemars...@gmail.com> wrote: > Just want to clarify that I was confused because there are two sections on > the pulsar website that document the Admin API for namespaces, and one has > more information than the other. > > Admin API Namespaces: > https://pulsar.apache.org/docs/en/admin-api-namespaces/ > > Pulsar Admin CLI tool: > https://pulsar.apache.org/docs/en/pulsar-admin/#namespaces-1 > > The first appears to be client agnostic, as it documents REST, the > pulsar-admin cli tool, and the Java api, and the second is just documenting > the pulsar-admin cli tool. While the first seems to be more generic, the > second is the one that documents more features, including the one for which > I was looking. > > I know there is already an effort to improve the documentation on the > website, and I just want to make sure to call this out as a bit confusing. > I definitely didn't realize these pages would have different information. > > Thanks, > Michael > > On Fri, Feb 26, 2021 at 12:11 AM Michael Marshall <mikemars...@gmail.com> > wrote: > >> I just double checked the documentation, and I had missed the admin >> command that solves my question. No need for any help or replies at this >> point. >> >> It’s defined at the following link, in case anyone needs the reference. >> >> http://pulsar.apache.org/docs/en/pulsar-admin/#set-auto-topic-creation >> >> Thanks, >> Michael >> >> On Feb 25, 2021, at 11:31 PM, Michael Marshall <mikemars...@gmail.com> >> wrote: >> >> >> Hello, >> >> I'm looking to set namespace level overrides for auto topic creation, but >> I can't seem to find any documentation on how to do so. I see the >> "AutoTopicCreationOverride" class in the project, so it looks like it >> should be possible to override the default settings. Can anyone point me to >> documentation or share a way to update these overrides? >> >> Thanks! >> Michael Marshall >> >>
