Commands for managing service task definitions in SHAR workflows.

Subcommands

list

Lists all registered service tasks.

Usage:

shar servicetask list [flags]

Flags:

  • -r, --raw - Show entire, unfiltered JSON output (includes full task specifications)

Example:

# List service task names
shar servicetask list

# List full service task specifications
shar servicetask list --raw

Output: Returns a list of service task names, or full task specifications if –raw flag is used.

add

Adds a new service task definition from a YAML file.

Usage:

shar servicetask add <yaml_file>

Arguments:

  • yaml_file - Path to the service task YAML definition file

Example:

shar servicetask add ./my-service-task.yaml

Output: Returns the ServiceTaskID of the newly registered task.

get

Retrieves a specific version of a service task by its UID.

Usage:

shar servicetask get <task_uid>

Arguments:

  • task_uid - The unique ID of the service task

Example:

shar servicetask get task_abc123

Output: Returns the complete task specification.

getusage

Gets usage information for a specific service task.

Usage:

shar servicetask getusage <task_name>

Arguments:

  • task_name - The name of the service task

Example:

shar servicetask getusage "EmailNotification"

Output: Returns information about which workflows are using this service task.

getversions

Gets all versions of a specific service task.

Usage:

shar servicetask getversions <task_name>

Arguments:

  • task_name - The name of the service task

Example:

shar servicetask getversions "EmailNotification"

Output: Returns all versions of the specified service task.