VSS Command Line Interface v0.2.8

VSSCLI v0.2.8 is available for download via PyPI or GitLab. Latest version includes the following new features and bug fixes:

• New Feature

  • List API messages with vss message ls
    

    vss message ls
      id  kind    subject                          status
    ----  ------  -------------------------------  --------
       4  Notice  VM Disks Consolidation Required  Created
       8  Notice  VM Disks Consolidation Required  Created
      12  Notice  VM Disks Consolidation Required  Created

• • Read any message based on ID with vss message get <id>

     vss message get 4
    msg.status          : Read
    msg.kind            : Notice
    msg.user_id         : 10
    msg.text            : 5012da9a-2563-82dc-f8d0-d5583fbcfde3 1711P-modest_davinci
    msg.created_on      : Sat, 24 Feb 2018 14:00:04 GMT
    user.username       : vsswebservices
    user.id             : 10
    user_to.username    : josem
    user_to.id          : 2
    msg.updated_on      : Fri, 02 Mar 2018 12:48:38 GMT
    msg.id              : 4
    msg.subject         : VM Disks Consolidation Required

• • Acknowledge messages based on ids with vss message set ack <id1> <id2> <idn>:

    vss message set ack 4 8
      [####################################]  100%
    
    
    vss message ls
      id  kind    subject                          status
    ----  ------  -------------------------------  ------------
      12  Notice  VM Disks Consolidation Required  Created
       4  Notice  VM Disks Consolidation Required  Acknowledged
       8  Notice  VM Disks Consolidation Required  Acknowledged

    Acknowledged messages will not be included in weekly digests generated by the API to users.

• Improvements
  

  • Check for Created messages when obtaining a token

    You have 3 unread messages. Please, run: vss message ls
    Successfully updated configuration file /Users/<user>/.vss/config.json

Upgrade or install PyVSS as follows:

# from version 0.2.5 you can run
vss upgrade
# upgrade
pip install vsscli --upgrade

# install
pip install vsscli

Docker images available: uofteis/vsscli:py27:

docker run -it -v /tmp:/data \
-e VSS_API_USER=user_here -e VSS_API_USER_PASS=user_pass_here \
-e VSS_DEFAULT_OUTPUT=json \
uofteis/vsscli bash

For more information, please refer to the official documentation site.