Skip to main content
Version: 3.3.x

Managing Tenants

tip

This page only shows some frequently used operations.

  • For the latest and complete information about Pulsar admin, including commands, flags, descriptions, and more, see Pulsar admin docs.

  • For the latest and complete information about REST API, including parameters, responses, samples, and more, see REST API doc.

  • For the latest and complete information about Java admin API, including classes, methods, descriptions, and more, see Java admin API doc.

Tenants, like namespaces, can be managed using the admin API. There are currently two configurable aspects of tenants:

  • Admin roles
  • Allowed clusters

Tenant resources​

List​

You can list all of the tenants associated with an instance.

Use the list subcommand.

pulsar-admin tenants list

Output:

my-tenant-1
my-tenant-2

Create​

You can create a new tenant.

Use the create subcommand:

pulsar-admin tenants create my-tenant

When creating a tenant, you can optionally assign admin roles using the -r/--admin-roles flag, and clusters using the -c/--allowed-clusters flag. You can specify multiple values as a comma-separated list. Here are some examples:

pulsar-admin tenants create my-tenant \
--admin-roles role1,role2,role3 \
--allowed-clusters cluster1
pulsar-admin tenants create my-tenant \
-r role1 \
-c cluster1

Get configuration​

You can fetch the configuration for an existing tenant at any time.

Use the get subcommand and specify the name of the tenant. Here's an example:

pulsar-admin tenants get my-tenant
{
"adminRoles": [
"admin1",
"admin2"
],
"allowedClusters": [
"cl1",
"cl2"
]
}

Delete​

Tenants can be deleted from a Pulsar instance.

Use the delete subcommand and specify the name of the tenant.

pulsar-admin tenants delete my-tenant

Update​

You can update a tenant's configuration.

Use the update subcommand.

pulsar-admin tenants update my-tenant \
--admin-roles role1,role2 \
--allowed-clusters cluster1,cluster2