Package: ocsw
ocsw-cli - Octave Cloud IoT command-line toolThis is not an official implementation of the command line interface (CLI) for
theOctave Cloud REST API.The ocsw makes calls to Octave Cloud Infrastructure APIs to provide
the functionality implemented for the various services. These are REST APIs that
use HTTPS requests and responses.API ReferenceThis package includes a client implementing the api described inhttps://rest.octave.dev/RequirementsTo install and use the CLI, you must have:An Octave Cloud Infrastructure account. A user created in that account, in a group with a policy that grants the desired permissions. This account user can be that calls the API.System use token-based authentication. You can get the API token for your user by logging intoOctave Cloud, On the lower left side of the main page, you will see Master Token option. Click here and a pop up will display your token along with the user you will use with the Octave Cloud APIs.InstallationAs per usual:pipinstallocswEnvironment variablesVARIABLEDescriptionOCTAVE_CLOUD_API_URLdefault:https://octave-api.sierrawireless.io/v5.0End point octave cloudOCTAVE_CLOUD_TOKENMaster TokenOCTAVE_CLOUD_USERYour user idOCTAVE_CLOUD_COMPANYIdentifier of one of the companyUsageusage: ocsw-cli [-h] [-H] [-C PATH] [-D] [-v] [--show-secrets]  ...

Manage and monitor your devices

optional arguments:
  -h, --help      show this help message and exit
  -H              show help from all command
  -C PATH         location of configuration path (default ".")
  -D, --debug     enable debug output
  -v, --version   show program's version number and exit
  --show-secrets  decrypt secrets and displays plain text

commands:

    blueprint     Manage blueprints
    cloud         Manage cloud
    cloud_action  Manage cloud actions
    company       Manage companies
    device        Manage devices
    edge_action   Manage edge actions
    firmware      Manage firmware's
    group         Manage user groups
    stream        Manage streams
    user          Manage users
    identity      Display detailed information about current user
    login         Log in to a Octave Cloud
    logout        Log out from a Octave Cloud
    release       Display Octave API Version InformationCommand: blueprintusage: ocsw-cli blueprint [-h] COMMAND ...

Manage blueprints

positional arguments:
  COMMAND
    ls        display blueprint list
    inspect   display detailed information on one or more blueprints
    diff      differences between blueprint versions

optional arguments:
  -h, --help  show this help message and exitCommand: cloudusage: ocsw-cli cloud [-h] COMMAND ...

Manage Cloud

positional arguments:
  COMMAND
    fetch     download objects and refs from cloud
    export    download objects and refs from cloud

optional arguments:
  -h, --help  show this help message and exitCommand: cloud_actionusage: ocsw-cli cloud_action [-h] COMMAND ...

Manage cloud actions

positional arguments:
  COMMAND
    inspect   display detailed information on one or more cloud actions
    ls        list cloud action
    diff      differences in javascript between cloud action versions

optional arguments:
  -h, --help  show this help message and exitCommand: cloud_connectorusage: ocsw-cli cloud_connector [-h] COMMAND ...

Manage cloud connectors

positional arguments:
  COMMAND
    inspect   display detailed information on one or more cloud connectors
    ls        list cloud connector
    diff      differences in javascript between cloud connector versions

optional arguments:
  -h, --help  show this help message and exitCommand: companyusage: ocsw-cli company [-h] COMMAND ...

Manage companies

positional arguments:
  COMMAND
    ls        display company list
    inspect   display detailed information on one or more companies
    switch    set company active

optional arguments:
  -h, --help  show this help message and exitCommand: deviceusage: ocsw-cli device [-h] COMMAND ...

Manage devices

positional arguments:
  COMMAND
    actions   list device edge actions
    create    creating device
    inspect   display detailed information on one or more devices
    lc        list devices configuration
    li        list devices identity
    ls        list devices connectivity
    rm        remove one or more devices
    tags      set device tags
    events    display recent events
    changes   display recent changes

optional arguments:
  -h, --help  show this help message and exitCommand: edge_actionusage: ocsw-cli edge_action [-h] COMMAND ...

Manage edge actions

positional arguments:
  COMMAND
    inspect   display detailed information on one or more edge actions
    ls        list edge action
    diff      differences in javascript between edge action versions

optional arguments:
  -h, --help  show this help message and exitCommand: firmwareusage: ocsw-cli firmware [-h] COMMAND ...

Manage firmware

positional arguments:
  COMMAND
    ls        list of available firmware
    note      display notes on one or more firmware

optional arguments:
  -h, --help  show this help message and exitCommand: groupusage: ocsw-cli group [-h] COMMAND ...

Manage user groups

positional arguments:
  COMMAND
    ls        display user group list
    inspect   display detailed information on one or more user groups

optional arguments:
  -h, --help  show this help message and exitCommand: streamusage: ocsw-cli stream [-h] COMMAND ...

Manage streams

positional arguments:
  COMMAND
    ls        display streams list
    inspect   display detailed information on one or more streams
    events    display stream events list

optional arguments:
  -h, --help  show this help message and exitCommand: userusage: ocsw-cli user [-h] COMMAND ...

Manage users

positional arguments:
  COMMAND
    ls        display user list
    inspect   display detailed information on one or more users

optional arguments:
  -h, --help  show this help message and exitCommand: identityusage: ocsw-cli identity [-h]

Display detailed information about current user

optional arguments:
  -h, --help  show this help message and exitCommand: loginusage: ocsw-cli login [-h] [-t] [-u] [COMPANY]

Log in to a Octave Cloud

positional arguments:
  COMPANY           company name

optional arguments:
  -h, --help        show this help message and exit
  -t , --token      token
  -u , --username   usernameCommand: logoutusage: ocsw-cli logout [-h]

Log out from a Octave Cloud

optional arguments:
  -h, --help  show this help message and exitCommand: releaseusage: ocsw-cli release [-h]

Display Octave API Version Information

optional arguments:
  -h, --help  show this help message and exit