feat: endpoint execute schedule permission [BACKLOG-40051] (#144)

core/src/main/java/org/pentaho/platform/web/http/api/resources/SchedulerResource.java

@@ -606,13 +606,39 @@ public String isScheduleAllowed( @QueryParam( "id" ) String id ) {
   @Path( "/canSchedule" )
   @Produces( APPLICATION_JSON )
   @StatusCodes( {
-    @ResponseCode( code = 200, condition = "Successful retrieved the scheduling permission." ),
+    @ResponseCode( code = 200, condition = "Successfully retrieved the scheduling permission." ),
     @ResponseCode( code = 500, condition = "Unable to retrieve the scheduling permission." )
   } )
   public String doGetCanSchedule() {
     return schedulerService.doGetCanSchedule();
   }
 
+  /**
+   * Checks whether the current user has authority to execute schedules in the platform.
+   *
+   * <p><b>Example Request:</b><br />
+   * GET pentaho/api/scheduler/canExecuteSchedules
+   * </p>
+   *
+   * <p><b>Example Response:</b></p>
+   * <pre function="syntax.xml">
+   *   true
+   * </pre>
+   *
+   * @return true or false. true indicates schedule execution is allowed and false indicates schedule execution is
+   * not allowed for the user.
+   */
+  @GET
+  @Path( "/canExecuteSchedules" )
+  @Produces( APPLICATION_JSON )
+  @StatusCodes( {
+    @ResponseCode( code = 200, condition = "Successfully retrieved the scheduling permission." ),
+    @ResponseCode( code = 500, condition = "Unable to retrieve the scheduling permission." )
+  } )
+  public String doGetCanExecuteSchedules() {
+    return schedulerService.doGetCanExecuteSchedule();
+  }
+
   /**
    * Returns the state of the scheduler with the value of RUNNING or PAUSED.
    *

core/src/main/java/org/pentaho/platform/web/http/api/resources/services/ISchedulerServicePlugin.java

@@ -51,7 +51,8 @@
  */
 public interface ISchedulerServicePlugin {
   /*
-   * TODO I don't think createJob actually throws IOException. look into changing IOException, SchedulerException, IllegalAccessException, ->  SchedulerException,
+   * TODO I don't think createJob actually throws IOException. look into changing IOException, SchedulerException,
+   *  IllegalAccessException, ->  SchedulerException,
    */
   Job createJob( JobScheduleRequest jobScheduleRequest ) throws IOException, SchedulerException, IllegalAccessException;
 
@@ -67,6 +68,8 @@ public interface ISchedulerServicePlugin {
 
   String doGetCanSchedule();
 
+  String doGetCanExecuteSchedule();
+
   String getState() throws SchedulerException;
 
   String start() throws SchedulerException;