VSS Command Line Interface (vss-cli) v0.9.0🎃

VSS-CLI v0.9.0 is available for download via PyPI or GitLab. Latest version includes the following improvements and bug fixes:

Improvements

core: pyvss v0.15.1 -> v0.16.0 (#358)

️compute vm set controller scsi up --sharing: update SCSI sharing mode (#359)

Commands:

  • compute vm set controller scsi up

For example

vss-cli compute vm set vm-2177 controller scsi up --sharing nosharing 0

️compute vm set disk up --sharing: update Disk sharing mode (#360)

Commands:

  • compute vm set disk up

For example

vss-cli compute vm set vm-2177 disk up --sharing sharingnone 1

compute vm set controller scsi mk: create SCSI controller with new spec <type>=<sharing>. (#361)

Commands:

  • compute vm set controller scsi mk

For example

# backwards compatibility
# defaults:
# 		type to persistent
# 		sharing to nosharing
vss-cli compute vm set vm-2177 controller scsi mk --scsi paravirtual

# new scsi spec
vss-cli compute vm set vm-2177 controller scsi mk --scsi paravirtual=virtualsharing

compute vm set disk mk: create Disk with new spec <capacity>=<backing_mode>=<backing_sharing>. (#362)

Commands:

  • compute vm set disk mk

For example

# backwards compatibility 
# defaults: 
#           backing_mode to persistent
#           backing_sharing to sharingnone
vss-cli compute vm set vm-2177 disk mk --disk 100

# new disk spec
vss-cli compute vm set vm-2177 disk mk --disk 100=independent_persistent=sharingnone

compute vm mk: create vm with Disks new spec <capacity>=<backing_mode>=<backing_sharing>. (#363)

Commands:

  • compute vm mk shell
    compute vm mk from-clone
    compute vm mk from-file
    compute vm mk from-image
    compute vm mk from-template

For example

# backwards compatibility 
# defaults: 
#           backing_mode to persistent
#           backing_sharing to sharingnone
vss-cli compute vm set vm-2177 disk mk --disk 100

# new disk spec
vss-cli compute vm set vm-2177 disk mk --disk 100=independent_persistent=sharingnone

--wait/--no-wait: add option to the main cli instead of per sub-command that submits requests. (#364)

Description:

This change provides the ability to better handle the --wait/--no-wait option for the global cli context instead of per sub-command. The --wait/--no-wait option is also settable via VSS_WAIT_FOR_REQUESTS environment variable.

Commands:

  • vss-cli

For example

vss-cli --wait compute vm set vm-2177 state on

# or
VSS_WAIT_FOR_REQUESTS=1
vss-cli compute vm set vm-21777 state on

config set: add wait_for_requests option in general settings in configuration file (config.yaml). (#364)

Description:

After running for the first time v0.9.0 of the VSS-CLI the wait_for_requests option in the configuration file will show up and can be set by either executing either one of the following commands:

Commands:

  • configure set wait_for_requests 1
    configure edit

For example

vss-cli configure set wait_for_requests 1
Updating wait_for_requests from True -> True.
~/.vss-cli/config.yaml updated 💾

# or
vss-cli configure edit
general:
	check_for_updates: true
	check_for_messages: true
	default_endpoint_name: vss-api-dev
	debug: false
	output: auto
	table_format: simple
	timeout: 60
	verbose: false
	columns_width: -1
	wait_for_requests: true
...

compute: remove --wait/--no-wait option from the following commands (#364)

Description:

Since now the --wait/--no-wait option lives at the main cli level, it has been removed from the following subcommand contexts:

Commands:

  • compute vm set
    compute vm mk
    compute vm rm
    compute template rm
    compute folder set
    compute folder mk
    compute folder rm
    compute inventory mk

For example

vss-cli --wait compute inventory mk

id : 25
status : SUBMITTED
task_id : 4b877caa-c64c-487d-b797-9e65459f23cc
message : Request has been accepted for processing

⏳ Waiting for request 25 to complete...
🎉 Request 25 completed successfully:

warnings : Inventory Report has been created 9d8a8f86-9f69-4428-b39a-1acf3870cd99.csv
errors :
Would you like to download? [y/N]: y

FILE : ./9d8a8f86-9f69-4428-b39a-1acf3870cd99.csv

University of Toronto - Since 1827