Interface RolesApi

All Superinterfaces:
ApiService

@Path("/api/v1/roles") @Consumes("application/json") @Produces("application/json") public interface RolesApi extends ApiService
Operations related to roles.
  • Method Details

    • serviceName

      default String serviceName()
      Specified by:
      serviceName in interface ApiService
    • searchRoles

      @GET List<RoleView> searchRoles(@BeanParam RolePrincipalsFilters filters, @DefaultValue("0") @QueryParam("page") Integer page, @DefaultValue("100") @QueryParam("resultsPerPage") Integer resultsPerPage)
      Returns the paginated list of roles ordered by role name.
      Parameters:
      filters - filter by role name, or principal name
      page - the page of results to return. Default value is 0.
      resultsPerPage - the number of results per page. Default value is 100. Maximum value is 100.
      Returns:
      a list of roles.
    • searchRoles

      default List<RoleView> searchRoles(String roleName, String principalName, Integer page, Integer resultsPerPage)
      Returns the paginated list of roles ordered by role name where role name and principal name match filter substring.
      Parameters:
      roleName - role name filter
      principalName - principal name filter
      page - the page of results to return
      resultsPerPage - the number of results per page. Maximum value is 100.
      Returns:
      a list of matching roles
    • getRoles

      default List<RoleView> getRoles(@DefaultValue("0") @QueryParam("page") Integer page, @DefaultValue("100") @QueryParam("resultsPerPage") Integer resultsPerPage)
      Returns the paginated list of roles ordered by role name.
      Parameters:
      page - the page of results to return. Default value is 0.
      resultsPerPage - the number of results per page. Default value is 100. Maximum value is 100.
      Returns:
      a list of roles.
    • getRole

      @GET @Path("/{roleName:.*[^/]*}") RoleView getRole(@PathParam("roleName") String roleName)
    • create

      @POST @Path("/{roleName:.*[^/]*}") void create(@PathParam("roleName") String roleName, RoleView roleView)
    • create

      @POST void create(List<RoleView> roleViews)
    • update

      @PUT @Path("/{roleName:.*[^/]*}") void update(@PathParam("roleName") String roleName, RoleView roleView)
    • update

      @PUT void update(List<RoleView> roleViews)
    • delete

      @DELETE @Path("/{roleName:.*[^/]*}") void delete(@PathParam("roleName") String roleName)
    • rename

      @POST @Path("/{roleName:.*[^/]*}/rename") void rename(@PathParam("roleName") String roleName, @QueryParam("newName") String newName)