Module org.yamcs.api

Package org.yamcs.protobuf.activities

Class ActivitiesApiClient

java.lang.Object

org.yamcs.protobuf.activities.AbstractActivitiesApi<Void>

org.yamcs.protobuf.activities.ActivitiesApiClient

All Implemented Interfaces:

Api<Void>

@Generated(value="org.yamcs.maven.ServiceGenerator",
           date="2026-08-31T06:45:28.035361Z")
public class ActivitiesApiClient
extends AbstractActivitiesApi<Void>

Constructor Summary

Constructors

Constructor	Description
ActivitiesApiClient(MethodHandler handler)

Method Summary

Modifier and Type	Method	Description
final void	addLogMessage(Void ctx, AddLogMessageRequest request, Observer<com.google.protobuf.Empty> observer)	Add a message to the activity log
final void	cancelActivity(Void ctx, CancelActivityRequest request, Observer<ActivityInfo> observer)	Cancel an ongoing activity
final void	completeManualActivity(Void ctx, CompleteManualActivityRequest request, Observer<ActivityInfo> observer)	Mark an ongoing activity as completed.
final void	getActivity(Void ctx, GetActivityRequest request, Observer<ActivityInfo> observer)	Get an activity
final void	getActivityLog(Void ctx, GetActivityLogRequest request, Observer<GetActivityLogResponse> observer)	Get the activity log
final void	listActivities(Void ctx, ListActivitiesRequest request, Observer<ListActivitiesResponse> observer)	List activities
final void	listExecutors(Void ctx, ListExecutorsRequest request, Observer<ListExecutorsResponse> observer)	List available executors
final void	listScriptRunners(Void ctx, ListScriptRunnersRequest request, Observer<ListScriptRunnersResponse> observer)	List script runners available for activities of type SCRIPT
final void	listScripts(Void ctx, ListScriptsRequest request, Observer<ListScriptsResponse> observer)	List scripts available for activities of type SCRIPT
final void	startActivity(Void ctx, StartActivityRequest request, Observer<ActivityInfo> observer)	Start an activity The request body allows for the execution of arbitrary activities
final void	subscribeActivities(Void ctx, SubscribeActivitiesRequest request, Observer<ActivityInfo> observer)	Receive activity updates
final void	subscribeActivityLog(Void ctx, SubscribeActivityLogRequest request, Observer<ActivityLogInfo> observer)	Receive activity log updates
final void	subscribeGlobalStatus(Void ctx, SubscribeGlobalStatusRequest request, Observer<GlobalActivityStatus> observer)	Receive activity status updates

Methods inherited from class org.yamcs.protobuf.activities.AbstractActivitiesApi

callMethod, callMethod, getDescriptorForType, getRequestPrototype, getResponsePrototype

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

ActivitiesApiClient

public ActivitiesApiClient(MethodHandler handler)

Method Details

listActivities

public final void listActivities(Void ctx,
 ListActivitiesRequest request,
 Observer<ListActivitiesResponse> observer)

  List activities
 

Specified by:

listActivities in class AbstractActivitiesApi<Void>

getActivity

public final void getActivity(Void ctx,
 GetActivityRequest request,
 Observer<ActivityInfo> observer)

  Get an activity
 

Specified by:

getActivity in class AbstractActivitiesApi<Void>

getActivityLog

public final void getActivityLog(Void ctx,
 GetActivityLogRequest request,
 Observer<GetActivityLogResponse> observer)

  Get the activity log
 

Specified by:

getActivityLog in class AbstractActivitiesApi<Void>

startActivity

public final void startActivity(Void ctx,
 StartActivityRequest request,
 Observer<ActivityInfo> observer)

  Start an activity
 
  The request body allows for the execution of arbitrary activities.
 
  | Key             | Value                               |
  | --------------- | ----------------------------------- |
  | `type` (string) | Activity type                       |
  | `args` (map)    | Map accepting type-specific options |
 
  The following activity types are included in the core Yamcs module:
 
  * `COMMAND`: Execute a single command
 
    Args:
    * `command` (string): **Required.** Qualified name of a command
    * `args` (map):  Named arguments, if the command requires any
    * `extra` (map): Extra command options
    * `processor` (string): Processor name. If not provided, Yamcs
      defaults to any processor it can find with commanding enabled.
 
    Example:
    ```json
    {
      "type": "COMMAND",
      "args": {
        "command": "/YSS/SIMULATOR/SWITCH_VOLTAGE_ON",
        "args": {
          "voltage_num": 3
        },
        "processor": "realtime"
      }
    }
    ```
 
  * `STACK`: Execute a stack
 
    Args:
    * `bucket` (string): **Required.** The name of the bucket containg the stack
    * `stack` (string): **Required.** The name of the stack object inside the bucket
    * `processor` (string): Processor name. If not provided, Yamcs defaults
      to any processor it can find with commanding enabled.
 
    Example:
    ```json
    {
      "type": "STACK",
      "args": {
        "bucket": "mybucket",
        "stack": "mystack.ycs",
        "processor": "realtime"
      }
    }
    ```
 
  * `SCRIPT`: Run a script
 
    Args:
    * `script` (string): **Required.** Script identifier.
      This should be the relative path to an executable file in one of the
      search locations. When unconfigured, the default search location is
      `etc/scripts/` relative to the Yamcs working directory.
    * `args` (string or string[]): Script arguments
    * `processor` (string): If provided, this information is passed to the
      script in an environment variable `YAMCS_PROCESSOR`.
    * `runner` (string): In case of multiple script runners, you can provide
      this field, to indicate which runner this script execution applies to.
 
    Example:
    ```json
    {
      "type": "SCRIPT",
      "args": {
        "script": "simulate_los.py",
        "args": "--duration 60",
        "processor": "realtime"
      }
    }
    ```
 

Specified by:

startActivity in class AbstractActivitiesApi<Void>

cancelActivity

public final void cancelActivity(Void ctx,
 CancelActivityRequest request,
 Observer<ActivityInfo> observer)

  Cancel an ongoing activity
 

Specified by:

cancelActivity in class AbstractActivitiesApi<Void>

completeManualActivity

public final void completeManualActivity(Void ctx,
 CompleteManualActivityRequest request,
 Observer<ActivityInfo> observer)

  Mark an ongoing activity as completed.
 
  This method may only be used with manual activities.
 

Specified by:

completeManualActivity in class AbstractActivitiesApi<Void>

addLogMessage

public final void addLogMessage(Void ctx,
 AddLogMessageRequest request,
 Observer<com.google.protobuf.Empty> observer)

  Add a message to the activity log
 

Specified by:

addLogMessage in class AbstractActivitiesApi<Void>

subscribeGlobalStatus

public final void subscribeGlobalStatus(Void ctx,
 SubscribeGlobalStatusRequest request,
 Observer<GlobalActivityStatus> observer)

  Receive activity status updates
 

Specified by:

subscribeGlobalStatus in class AbstractActivitiesApi<Void>

subscribeActivities

public final void subscribeActivities(Void ctx,
 SubscribeActivitiesRequest request,
 Observer<ActivityInfo> observer)

  Receive activity updates
 

Specified by:

subscribeActivities in class AbstractActivitiesApi<Void>

subscribeActivityLog

public final void subscribeActivityLog(Void ctx,
 SubscribeActivityLogRequest request,
 Observer<ActivityLogInfo> observer)

  Receive activity log updates
 

Specified by:

subscribeActivityLog in class AbstractActivitiesApi<Void>

listExecutors

public final void listExecutors(Void ctx,
 ListExecutorsRequest request,
 Observer<ListExecutorsResponse> observer)

  List available executors
 

Specified by:

listExecutors in class AbstractActivitiesApi<Void>

listScriptRunners

public final void listScriptRunners(Void ctx,
 ListScriptRunnersRequest request,
 Observer<ListScriptRunnersResponse> observer)

  List script runners available for activities of type SCRIPT
 

Specified by:

listScriptRunners in class AbstractActivitiesApi<Void>

listScripts

public final void listScripts(Void ctx,
 ListScriptsRequest request,
 Observer<ListScriptsResponse> observer)

  List scripts available for activities of type SCRIPT
 

Specified by:

listScripts in class AbstractActivitiesApi<Void>