VMware vRealize CloudClient 4.5 Release Notes


vRealize CloudClient 4.5 | 12 April 2018 | Build 8227624

Check for additions and updates to these release notes.

What's in the Release Notes

The release notes cover the following topics:

What's New

Enabling Multi-Factor Authentication in CloudClient for vRealize Automation Users — To provide a higher level of security than basic username and password authentication, you can enable CloudClient to use multi-factor authentication with vRealize Automation.

  • vra oauth2client create allows the administrator to create a new OAuth2 client that supports multi-factor authentication
  • vra login authzcode allows the user to login to vRealize Automation with clientId and clientSecret created by the administrator
  • vra login refreshtoken allows the user to login to vRealize Automation with the refreshtoken that can be retrieved using vra login authzcode

Documentation about enabling multi-factor authentication is included in the Related Tools and Documentation chapter of the vRealize Automation API Programming Guide available from code.vmware.com. To learn more about accessing the documentation, see vRealize Automation API.

Cancel In-Progress Requestsvra request cancel allows an administrator to cancel an in-progress request and roll back any resources that have been provisioned as part of the cancelled request.

TLS Update — CloudClient uses TLS 1.2 by default.


To run CloudClient, run the cloudclient.sh (Unix) or cloudclient.bat (Windows) command.

On both Windows and Linux operating systems, CloudClient requires Java version 1.8 or later. VMware recommends Java version 1.8U102 or later.

When running CloudClient in script mode, use single quotes (') instead of double quotes (") in command arguments.

When providing multiple comma separated values for any parameter, enclose them in single quotes ('). For example: --properties values='1, 2, 3, 4'

Use the following guidelines for the best Windows experience when running CloudClient:

  • Ensure that your Command Prompt or PowerShell uses the same value for Window Buffer Width and Window Width. If your prompt's Window Buffer Width is larger than your Window Width, commands do not wrap properly.
  • Only the [Home] and [End] keyboard shortcut keys are supported when running CloudClient.

For full product documentation, open docs/index.html in your browser.

Resolved Issues

  • Cloud Client does not verify uniqueness of a Virtual Machine before attempting to unregister it

    If you have duplicated names for vCloud Director Component Machines and vCloud Director vApps, CloudClient may randomly unregister either one of the these when the command vra machines forceunregister is run.

    This issue has been resolved in this release.

  • CloudClient returns a correct JSON response and an ERROR logging message

    CloudClient intermittently returns correct JSON with an error message in the logs. This could affect an automation script.

    This issue has been resolved in this release.

  • User unable to submit catalog request with property definition required=true on deployment level

    Catalog request with the property set to required for a blueprint fails even though the property is provided in the command

    This issue has been resolved in this release.

Known Issues

  • Deployment actions for Scale In and Scale Out do not support template generation

    The vra deployment action execute command for Scale In and Scale Out requires the user to specify the component names and desired number of instances as a request parameter but does not provide a template with the component names populated.

    Workaround: Use the vra blueprint detail command to retrieve the component names

  • Deployment action for Change Security is not supported

    When you attempt to use deployment action for Change Security, the operation fails with an error message.

    Workaround: None