VCF Installer API interacting with ESX Hosts and VCF SDDC Manager for host validation, networking, datastore setup, installation, and registration.

Before you can begin deploying VMware Cloud Foundation, you first configure the VCF Installer to connect to the Broadcom Depot. In order to do this you must first obtain your unique download token from the VCF Business Services Console, once you have your download token you can proceed with setting up the VCF Installer.

VCF Installer APIs Used

  • POST /v1/tokens
  • PUT /v1/system/settings/depot
  • GET /v1/system/settings/depot
  • GET /v1/system/settings/depot/depot-sync-info
  • PATCH /v1/system/settings/depot/depot-sync-info

VCF Installer API Reference Guide

Procedure

  1. Connect to a system that has access to the infrastructure and is capable of running CURL.

  2. Replace the values in the sample code with values for your VCF Installer instance and paste the commands in the console.

vcfInstallerFqdn=$'sfo-ins01.sfo.rainpole.io'
vcfInstallerUser=$'admin@local'
vcfInstallerPass=$'VMw@re1!VMw@re1!'
broadcomDepotToken=$'<your-unique-token'
  1. Authenticate to VCF Installer and obtain a token by running the following command:
vcfInstallerToken=$(curl -k -X POST https://$vcfInstallerFqdn/v1/tokens -H 'Content-Type:application/json' -d '{"username": "'$vcfInstallerUser'","password": "'$vcfInstallerPass'"}' | jq -r '.accessToken')
  1. Configure the VCF Installer depot settings by running the following command:
curl -k -X PUT https://$vcfInstallerFqdn/v1/system/settings/depot -H "Authorization: Bearer $vcfInstallerToken" -H -H 'Content-Type:application/json' -d '{"vmwareAccount": {"downloadToken": "'$broadcomDepotToken'"}}'
  1. Verify the status of the VCF Installer depot configuration by running the following command:
curl -k -X GET https://$vcfInstallerFqdn/v1/system/settings/depot -H "Authorization: Bearer $vcfInstallerToken" -H 'Accept: application/json' -H "Content-Type:application/json" | json_pp
  1. Verify the synchronization status with the Broadcom Depot by running the following command:
curl -k -X GET https://$vcfInstallerFqdn/v1/system/settings/depot/depot-sync-info -H "Authorization: Bearer $vcfInstallerToken" -H "Accept: application/json" -H "Content-Type:application/json" | json_pp
  1. (Optional) Force a syncronization of the metadat from the Broadcom Depot by running the following command:
curl -k -X PATCH https://$vcfInstallerFqdn/v1/system/settings/depot/depot-sync-info -H "Authorization: Bearer $vcfInstallerToken" -H "Accept: application/json" -H "Content-Type:application/json" | json_pp

Leave a comment