/
VSS Command Line Interface (vss-cli) v0.3.0🎉

VSS Command Line Interface (vss-cli) v0.3.0🎉

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

Improvements

Rename --bill-dept to --client (#210)

Commands:

  • compute vm mk from-clone
  • compute vm mk from-file
  • compute vm mk from-spec
  • compute vm mk shell

Description

Option --bill-dept has been renamed to --client to match the new VSS API specification.

Usage: vss-cli compute vm mk from-clone [OPTIONS] [NAME]

  Clone virtual machine from running or powered off vm. If name argument is
  not specified, -clone suffix will be added to resulting virtual machine

Options:
  -s, --source TEXT               Source virtual machine or template UUID.
                                  [required]
  -d, --description TEXT          A brief description.  [required]
  -b, --client TEXT               Client department.
  -a, --admin TEXT                Admin name, phone number and email separated
                                  by `:` i.e. "John
                                  Doe:416-123-1234:john.doe@utoronto.ca"
  -r, --inform TEXT               Informational contact emails in comma
                                  separated
  -u, --usage [Test|Prod|Dev|QA]  Vm usage.
  -o, --os TEXT                   Guest operating system id.
  -m, --memory INTEGER            Memory in GB.
  -c, --cpu INTEGER               Cpu count.
  -f, --folder TEXT               Logical folder moref name or path.
  -i, --disk INTEGER              Virtual disks in GB.
  -n, --net TEXT                  Network adapter <moref-or-name>=<nic-type>.
  -t, --domain TEXT               Target fault domain name or moref.
  --notes TEXT                    Custom notes.
  -p, --custom-spec TEXT          Guest OS custom specification in JSON
                                  format.
  -e, --extra-config TEXT         VMWare Guest Info Interface in JSON format.
  --vss-service TEXT              VSS Service related to VM
  --instances INTEGER             Number of instances to deploy  [default: 1]
  --help                          Show this message and exit.

Support multiple values and --wait flag (#208 #207)

Commands:

  • compute folder mk
  • compute folder rm

Description

Both folder creation and deletion support multiple values and the --wait flag to follow up request status until completion:

Usage: vss-cli compute folder mk [OPTIONS] NAME...

  Create a logical folder under a given name, path or moref of parent.



Options:
  -p, --parent TEXT  Parent folder name, path or moref  [required]
  --wait             wait for request(s) to complete
  --help             Show this message and exit.

For example, the following command creates 4 folders under the parent group-v1637 :

vss-cli compute folder mk --wait QA DEV PROD UAT --parent group-v1637

More examples can be found here.

For folder deletion, the CLI allows to submit multiple folder deletions at once and follow up the state of request:

Usage: vss-cli compute folder rm [OPTIONS] MOREF...

  Delete a logical folder. Folder must be empty.



Options:
  -m, --max-del INTEGER RANGE  Maximum items to delete  [default: 3]
  --wait                       wait for request(s) to complete
  --help                       Show this message and exit.


For instance, to delete folders created in the previous example:

vas-cli compute folder rm --wait --max-del=4 $(vss-cli --columns moref --no-headers --table-format plain compute folder get group-v1637 children)


pyvss upgrade from 0.9.43 -> 0.11.0 (#211)

Bug fixes

Fixes compute folder rm Attribute error (#206)

Missing v0.2.7 change log in documentation (#205)

Fixes RST syntax warnings in docs source (#209)


Upgrade

Remember, VSS-CLI documentation is now available in VSS-CLI and the full Change Log is available here. Upgrade or install VSS-CLI as follows:

# using vss-cli
vss-cli upgrade stable

# upgrade with pip
pip install vss-cli --upgrade

# install
pip install vss-cli 


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

Related content

VSS Command Line Interface (vss-cli) v0.2.4 🎉
VSS Command Line Interface (vss-cli) v0.2.4 🎉
More like this
VSS Command Line Interface (vss-cli) v0.12.0🎉
VSS Command Line Interface (vss-cli) v0.12.0🎉
More like this
VSS Command Line Interface (vss-cli) v2023.2.1
VSS Command Line Interface (vss-cli) v2023.2.1
More like this
VSS Command Line Interface (vss-cli) v0.2.3 🎉
VSS Command Line Interface (vss-cli) v0.2.3 🎉
More like this
VSS Command Line Interface (vss-cli) v2021.8.0 🎉
VSS Command Line Interface (vss-cli) v2021.8.0 🎉
More like this
VSS Command Line Interface (vss-cli) v2023.3.1
VSS Command Line Interface (vss-cli) v2023.3.1
More like this

University of Toronto - Since 1827