Tenants, like namespaces, can be managed using the admin API. There are currently two configurable aspects of tenants:
You can list all of the tenants associated with an instance using the list
subcommand:
$ pulsar-admin tenants list
That will return a simple list, like this:
my-tenant-1 my-tenant-2
You can create a new tenant using the create
subcommand:
$ pulsar-admin tenants create my-tenant
When creating a tenant, you can assign admin roles using the -r
/--admin-roles
flag. You can specify multiple roles as a comma-separated list. Here are some examples:
$ pulsar-admin tenants create my-tenant \ --admin-roles role1,role2,role3 $ pulsar-admin tenants create my-tenant \ -r role1
You can see a tenant's configuration as a JSON object using the get
subcommand and specifying the name of the tenant:
$ pulsar-admin tenants get my-tenant { "adminRoles": [ "admin1", "admin2" ], "allowedClusters": [ "cl1", "cl2" ] }
You can delete a tenant using the delete
subcommand and specifying the tenant name:
$ pulsar-admin tenants delete my-tenant
You can update a tenant's configuration using the update
subcommand