You can use the vRealize Automation REST API catalog service to request a vCloud Air machine.

Prerequisites

Procedure

  1. Find the catalog item that corresponds to the vCloud Air blueprint to use for the machine request by retrieving a page of published blueprint catalog items.
    curl --insecure -H "Content-Type: application/json" 
    -H "Authorization: Bearer $token” 
    https://$host/catalog-service/api/consumer/catalogItems?limit=10&page=1
  2. Construct a JSON file that contains the work item ID information to approve a machine request.
    1. Copy the appropriate JSON input file template to a new file in an XML editor that maintains formatting.
    2. Substitute the input variables in the template with the values obtained for specific ID.
    3. Save the file with a new name, for example, request.json.
  3. Request a machine as defined in the chosen blueprint or override the default values of the blueprint by adding properties to the JSON input file to override default values.
    curl --insecure -H "Content-Type: application/json" 
    -H "Authorization: Bearer $token” 
    https://$host/catalog-service/api/consumer/requests --verbose --data @C:/Temp/requestMachine.json
  4. View the details of the machine request by using the catalog service.
    curl --insecure -H "Content-Type: application/json" 
    -H "Authorization: Bearer $token" 
    https://$host/catalog-service/api/consumer/requests/510051b5-52ce-45db-8889-d4eeabf68da1