ITS Private Cloud CLI (vss-cli) Cheat Sheet

Username

--username

VSS_USER

 User to interact with the VSS API.

Password

--password

VSS_USER_PASS

 User password.

MFA TOTP Token

--totp

VSS_USER_OTP

If MFA enabled, will be prompted.

Config­uration Path

--config

VSS_CONFIG

Altern­ative config­uration path.

Request Timeout

--timeout

VSS_TIMEOUT

Request timeout in seconds.

API endpoint

--endpoint

VSS_ENDPOINT

ITS Private Cloud endpoint instance.

Table format to use

--tabl­e-f­ormat

VSS_TABLE

csv, fancy_­grid, github, grid, html, jira...

Custom columns

--columns

-

Any VM attribute: 

moref,­nam­e,c­pu_­cou­nt,­ip_­address,folder.path,power_state,networks[*].name

Truncates column values

--colu­mns­-width

VSS_COL_WIDTH

0: auto, -1: disable

Don't use headers

--no-h­eaders

-

When printing tables

Sort output

--sort-by

-

Sort table by the jsonpath expres­sion.

Output

--output

VSS_OUTPUT

json|y­aml­|ta­ble­|au­to|­ndjson

CPU

Update VM CPU count.

CPU hot-add

Update VM cpu hot-add settings.

Memory

Update VM memory size.

Memory hot-add

Update VM memory hot-add settings.

Disk New (basic)

Create single or multiple disks.

Power State:

Turn off, on, reset. Shutdown and reboot (VMware Tools required)

Disk New (adv.)

Create single or multiple disks using specific SCSI controller

Disk Copy (adv.)

Copy and attach disks to VM from vskey-stor user space.

Disk Update

Update VM disk N capacity in GB.

Disk Update (adv.)

Update VM disk N capacity in GB, SCSI bus N and add metadata notes to the disk.

Disk Delete

Delete VM disk(s). Confirmation will be prompted.

NIC New

Create new network interface specifying Network name.

NIC new (adv.)

Create new network interface specifying Network name and Type.

NIC Update Network:

Update network interface network.

NIC Update State

Update network interface state to either connect or disconnect

NIC Update Type

Update network interface adapter type. defaults to vmxnet3.

NIC Delete

Delete network interface adapter(s)

CD/ISO Create

Create CD drive with attached ISO image from Content Library or client.

CD/ISO Update

Update CD drive to connect to a different ISO or disconnect.

Floppy Create

Create virtual floppy drive with given image or client.

Floppy Update

Update virtual floppy backing with a different image or client.

Storage Type

Update VM storage type to either ssd or hdd. This action will perform storage vMotion within the Compute Domain.

Domain

Update VM compute domain. This action will perform vMotion and storage vMotion.

Operating System

Update VM operating system settings. This setting is responsible to present the right virtual hardware to the guest OS.

Add vTPM

Add virtual Trusted Platform Module to VM. Virtualization Based Security, EFI and secure boot will be also en

Add vGPU

Add GPU to VM based on given profile.

Enable|Disable VBS

Enable or disable Virtualization Based Security.

Enable|Disable Secure Boot

Enable or Disable secure boot.

FIrmware

Update VM firmware to bios or EFI.

Convert to|from template

Mark VM as template or template as VM.

Administrator

Update VM admin metadata.

Informational Contacts

Add Informational Contacts in VM metadata.

Get Restore Points

List available restore points filtered by timestamp.

Submit Restore

Submit a restore request.

Content Library

Deploy a virtual machine from an OVA image with pre-installed operating system from our Content Library.

Note. --user-data and --network-config will generate a seed iso that must be taken by the guest operating system, i.e. Ubuntu.

Shell VM

Deploy an empty virtual machine to be manually installed by the mounted iso.

Clone VM or Template

Clone virtual machine from another VM, template.

Clone VM (from snapshot)

Clone virtual machine from another VM snapshot id.

CLI Spec (existing)

Deploy a virtual machine from existing vss-cli specification.

CLI Spec (new)

Deploy a virtual machine from new vss-cli specification.

From Image

Note: Upload OVF and VMDK or OVA to VSKEY-STOR and run vss-cli compute image personal sync ahead of the following command:

Create virtual machine snapshot now

Create virtual machine snapshot later

List existing virtual machine snapshots

Revert to existing virtual machine snapshots

Remove existing virtual machine snapshot

Extend virtual machine snapshot lifetime

Create Folder

Rename Folder

Move Folder with its contents

Create Inventory File

Download Inventory File

List

List all virtual machines

Search

Search for vm by attribute

Attributes

Get additional info for specific attribute

Look for a VM by IP address

List including storage type and prefer­ences

Show VM info before decommissioning

Initialize

List

Set

Enable MFA

Disable MFA

Verify

Format

Filter

Method

Get Group membership

Get group details

Get group members

Get Deployment Option parameters

Generate additi­ona­l-p­arams spec

Get Property parameters