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.

pulsar-admin

Use the list subcommand.

pulsar-admin tenants list

Output:

my-tenant-1
my-tenant-2

REST API

GET /admin/v2/tenants

Java

admin.tenants().getTenants();

Create

You can create a new tenant.

pulsar-admin

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

REST API

PUT /admin/v2/tenants/{tenant}

Java

admin.tenants().createTenant(tenantName, tenantInfo);

Get configuration

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

pulsar-admin

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"
  ]
}

REST API

GET /admin/v2/tenants/{tenant}

Java

admin.tenants().getTenantInfo(tenantName);

Delete

Tenants can be deleted from a Pulsar instance.

pulsar-admin

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

pulsar-admin tenants delete my-tenant

REST API

DELETE /admin/v2/tenants/{tenant}

Java

admin.Tenants().deleteTenant(tenantName);

Update

You can update a tenant's configuration.

pulsar-admin

Use the update subcommand.

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

REST API

POST /admin/v2/tenants/{tenant}

Java

admin.tenants().updateTenant(tenantName, tenantInfo);