org.apache.pulsar.client.admin

Interface Tenants

All Known Implementing Classes:

TenantsImpl

public interface Tenants

Admin interface for tenants management

Method Summary

Modifier and Type	Method and Description
void	createTenant(String tenant, TenantInfo config) Create a new tenant.
void	deleteTenant(String tenant) Delete an existing tenant.
TenantInfo	getTenantInfo(String tenant) Get the config of the tenant.
List<String>	getTenants() Get the list of tenants.
void	updateTenant(String tenant, TenantInfo config) Update the admins for a tenant.

Method Detail

getTenants

List<String> getTenants()
                 throws PulsarAdminException

Get the list of tenants.

Response Example:

 ["my-tenant", "other-tenant", "third-tenant"]
 

Returns:

the list of Pulsar tenants

Throws:

PulsarAdminException.NotAuthorizedException - Don't have admin permission

PulsarAdminException - Unexpected error

getTenantInfo

TenantInfo getTenantInfo(String tenant)
                  throws PulsarAdminException

Get the config of the tenant.

Get the admin configuration for a given tenant.

Parameters:

tenant - Tenant name

Returns:

the tenant configuration

Throws:

PulsarAdminException.NotAuthorizedException - Don't have admin permission

PulsarAdminException.NotFoundException - Tenant does not exist

PulsarAdminException - Unexpected error

createTenant

void createTenant(String tenant,
                  TenantInfo config)
           throws PulsarAdminException

Create a new tenant.

Provisions a new tenant. This operation requires Pulsar super-user privileges.

Parameters:

tenant - Tenant name

config - Config data

Throws:

PulsarAdminException.NotAuthorizedException - Don't have admin permission

PulsarAdminException.ConflictException - Tenant already exists

PulsarAdminException.PreconditionFailedException - Tenant name is not valid

PulsarAdminException - Unexpected error

updateTenant

void updateTenant(String tenant,
                  TenantInfo config)
           throws PulsarAdminException

Update the admins for a tenant.

This operation requires Pulsar super-user privileges.

Parameters:

tenant - Tenant name

config - Config data

Throws:

PulsarAdminException.NotAuthorizedException - Don't have admin permission

PulsarAdminException.NotFoundException - Tenant does not exist

PulsarAdminException - Unexpected error

deleteTenant

void deleteTenant(String tenant)
           throws PulsarAdminException

Delete an existing tenant.

Delete a tenant and all namespaces and topics under it.

Parameters:

tenant - Tenant name

Throws:

PulsarAdminException.NotAuthorizedException - Don't have admin permission

PulsarAdminException.NotFoundException - The tenant does not exist

PulsarAdminException.ConflictException - The tenant still has active namespaces

PulsarAdminException - Unexpected error