org.apache.pulsar.client.admin

Interface ResourceGroups

public interface ResourceGroups

Admin interface for ResourceGroups management.

Method Summary

Modifier and Type	Method and Description
void	createResourceGroup(String name, ResourceGroup resourcegroup) Create a new resourcegroup.
CompletableFuture<Void>	createResourceGroupAsync(String name, ResourceGroup resourcegroup) Create a new resourcegroup.
void	deleteResourceGroup(String resourcegroup) Delete an existing resourcegroup.
CompletableFuture<Void>	deleteResourceGroupAsync(String resourcegroup) Delete an existing resourcegroup.
ResourceGroup	getResourceGroup(String resourcegroup) Get configuration for a resourcegroup.
CompletableFuture<ResourceGroup>	getResourceGroupAsync(String resourcegroup) Get policies for a namespace asynchronously.
List<String>	getResourceGroups() Get the list of resourcegroups.
CompletableFuture<List<String>>	getResourceGroupsAsync() Get the list of resourcegroups asynchronously.
void	updateResourceGroup(String name, ResourceGroup resourcegroup) Update the configuration for a ResourceGroup.
CompletableFuture<Void>	updateResourceGroupAsync(String name, ResourceGroup resourcegroup) Update the configuration for a ResourceGroup.

Method Detail

getResourceGroups

List<String> getResourceGroups()
                        throws PulsarAdminException

Get the list of resourcegroups.

Get the list of all the resourcegroup.

Response Example:

 ["resourcegroup1",
  "resourcegroup2",
  "resourcegroup3"]
 

Throws:

PulsarAdminException.NotAuthorizedException - Don't have admin permission

PulsarAdminException - Unexpected error

getResourceGroupsAsync

CompletableFuture<List<String>> getResourceGroupsAsync()

Get the list of resourcegroups asynchronously.

Get the list of all the resourcegrops.

Response Example:

 ["resourcegroup1",
  "resourcegroup2",
  "resourcegroup3"]
 

getResourceGroup

ResourceGroup getResourceGroup(String resourcegroup)
                        throws PulsarAdminException

Get configuration for a resourcegroup.

Get configuration specified for a resourcegroup.

Response Example:

 
     "publishRateInMsgs" : "value",
     "PublishRateInBytes" : "value",
     "DispatchRateInMsgs" : "value",
     "DispatchRateInBytes" : "value"
 
 

Parameters:

resourcegroup - String resourcegroup

Throws:

PulsarAdminException.NotAuthorizedException - You don't have admin permission

PulsarAdminException.NotFoundException - Resourcegroup does not exist

PulsarAdminException - Unexpected error

See Also:

*

getResourceGroupAsync

CompletableFuture<ResourceGroup> getResourceGroupAsync(String resourcegroup)

Get policies for a namespace asynchronously.

Get cnfiguration specified for a resourcegroup.

Response example:

 
     "publishRateInMsgs" : "value",
     "PublishRateInBytes" : "value",
     "DispatchRateInMsgs" : "value",
     "DspatchRateInBytes" : "value"
 
 

Parameters:

resourcegroup - Namespace name

See Also:

ResourceGroup

createResourceGroup

void createResourceGroup(String name,
                         ResourceGroup resourcegroup)
                  throws PulsarAdminException

Create a new resourcegroup.

Creates a new reourcegroup with the configuration specified.

Parameters:

name - resourcegroup name

resourcegroup - ResourceGroup configuration

Throws:

PulsarAdminException.NotAuthorizedException - You don't have admin permission

PulsarAdminException.ConflictException - Resourcegroup already exists

PulsarAdminException - Unexpected error

createResourceGroupAsync

CompletableFuture<Void> createResourceGroupAsync(String name,
                                                 ResourceGroup resourcegroup)

Create a new resourcegroup.

Creates a new resourcegroup with the configuration specified.

Parameters:

name - resourcegroup name

resourcegroup - ResourceGroup configuration.

updateResourceGroup

void updateResourceGroup(String name,
                         ResourceGroup resourcegroup)
                  throws PulsarAdminException

Update the configuration for a ResourceGroup.

This operation requires Pulsar super-user privileges.

Parameters:

name - resourcegroup name

resourcegroup - resourcegroup configuration

Throws:

PulsarAdminException.NotAuthorizedException - Don't have admin permission

PulsarAdminException.NotFoundException - ResourceGroup does not exist

PulsarAdminException - Unexpected error

updateResourceGroupAsync

CompletableFuture<Void> updateResourceGroupAsync(String name,
                                                 ResourceGroup resourcegroup)

Update the configuration for a ResourceGroup.

This operation requires Pulsar super-user privileges.

Parameters:

name - resourcegroup name

resourcegroup - resourcegroup configuration

deleteResourceGroup

void deleteResourceGroup(String resourcegroup)
                  throws PulsarAdminException

Delete an existing resourcegroup.

The resourcegroup needs to unused and not attached to any entity.

Parameters:

resourcegroup - Resourcegroup name

Throws:

PulsarAdminException.NotAuthorizedException - You don't have admin permission

PulsarAdminException.NotFoundException - Resourcegroup does not exist

PulsarAdminException.ConflictException - Resourcegroup is in use

PulsarAdminException - Unexpected error

deleteResourceGroupAsync

CompletableFuture<Void> deleteResourceGroupAsync(String resourcegroup)

Delete an existing resourcegroup.

The resourcegroup needs to unused and not attached to any entity.

Parameters:

resourcegroup - Resourcegroup name