Scripts to aid using API tokens with VMware Cloud Director (VCD) version 10.3.1 (or later)
These scripts accompany my blog posts here and here on using the new API Token feature in VMware Cloud Director (VCD) versions 10.3.1 and later. They will not function against earlier releases of VCD. See the VCD 10.3.1 release notes here for details.
Update version for PowerCLI version 13.1 (or later)
Example script in PowerShell which shows connecting to the VCD API using an API Token to generate a SessionId which can then be used to login (Connect-CIServer) to the PowerCLI cmdlets provided by VMware. This allows use of existing PowerCLI scripts with an API Token instead of stored credentials.
Usage: Adjust variables at the top fo the file as appropriate and commands at end. Will create a persistent PowerCLI session if the Disconnect-CIServer part is removed.
This should only be used for PowerCLI version 13.0 or prior, PowerCLI 13.1 or later won't work with the mechanism used in this script
Example script in PowerShell which shows connecting to the VCD API using an API Token to generate a SessionId which can then be used to login (Connect-CIServer) to the PowerCLI cmdlets provided by VMware. This allows use of existing PowerCLI scripts with an API Token instead of stored credentials.
Usage: Adjust variables at the top fo the file as appropriate and commands at end. Will create a persistent PowerCLI session if the Disconnect-CIServer part is removed.
Example script in Bash which connects to the VCD API using an API Token and then sets the VCD_TOKEN environment variable to the value of a valid VCD SessionId which can then be consumed in the Terraform VCD Provider rather than storing user credentials in Terraform variables.
Note: Requires jq utility to be installed and accessible to parse returned JSON.
Note: Script should be saved and made executable (
chmod u+x vcd-token.sh)
Usage: Adjust variables at the top of the file as appropriate and then dot source (. ./vcd-token.sh) to set environment variable with the session Id.
| Date | Comments |
|---|---|
| 2023-08-08 | Added option for using provider tokens (set 'Org' to 'system') |
| 2023-08-06 | Update for PowerCLI v13.1 and change to new cloudapi token method, older PowerCLI versions should use vcd-token-legacy.ps1 |
| 2021-10-22 | Initial release |