Sample Exchange

These are the vRealize Orchestrator sample workflows that are used to illustrate the vRealize Automation 8.2 Extensibility Migration Guide

This content was developped by different VMware contributors from engineering, PSO, PVE.

It leverages the vRO REST plug-in with the vRA REST APIs

The goal is to provide code samples for educational purposes. Use at your own risk. VMware should not be held liable in case the use of this code result in data loss.

Requirements

• vRA >= 8.2.0
• Account with credentials for vRA & vRO

Installation

• Download and import the package
• Run the setup workflow "Set vRA REST Host" from Orchestrator designer
• Copy / paste the host name from your browser URL bar
• Provide a username and a password for a user assigned with roles in Orchestrator, Assembly, Service Broker. Some workflows like the onboarding one expect admin roles and org owner

The workflow should fail in case you do not provide proper host name or credentials.

To test the functionality you can run the "Invoke VRA 8 REST Operation from swagger and display result" workflow. It should auto populate the vRA host and credentials and by submitting the default values the workflow should complete successful and display the project objects in the logs tab.

Content

• "Set vRA REST Host" : Setup workflow to create vRA REST host & default credentials
• REST Operations
  • "Invoke VRA 8 REST Operation from swagger" : Allows to run REST operations on vRA host with listing the URL / operations for each vRA service
  • "Invoke VRA 8 REST Operation from URL" : Free form of the previous workflow
• Event Broker
  • "Event Broker Template" : Event Broker demonstrator workflow including:
  • • Display the content of the payload
    • Display the content of metadatas
    • Call back vRA to get the properties of the objects provided as IDs in the payload (endpoint, organization, project, zone, ,event topic, events, deployment, resources, blueprint, catalog Items, resource actions, network parameters, host placement...)
    • Provide example on converting payload IDs to vRO object to bind Operation workflow on the object (Convert to VC:VirtualMachine and output it)
    • Display the parameters that supports being changed via workflow outputs
    • Update custom properties
    • Update tags
    • Update VM names
    • Update Host Selection
    • Update Zone placement
    • Place holders to update network parameters
  • "Create an event broker subscription" : To reuse in other workflows to create subscriptions programattically. Used by next workflow
  • "Create sample  "Event Broker Template" subscriptions" : Create a subscription for each event type starting the event broker workflow
• Tag & Custom properties
  • "Edit project tags"
  • "Edit machine custom properties"
  • "Get Network by tags"
• Deployment day 2 operations
  • "Change deployment lease"
  • "Change Machine boot disk size"
  • "Change Machine CPU & Memory"
  • "Edit deployment tags"
• Organization onboarding
  • "Create Cloud Account"
  • "Create Zone"
  • "Create Project"
  • "Onboarding project"
  • "Onboarding Organization including all the previous workflows"
• Request
  • "Request Catalog Item (Service Broker Only)" : Request programmatically a acatalog item. This version is designed to be run from Service Broker and is incompatible with vRO ATM
• Dynamic Types
  • Website sample : Example of a simple Dynamic Types scenario

History:

• Dec 8 2020 - Minor update for Dynamic Types
• March 26 2021 - Updated authentication as method used in previous version relied on login API to return the access token which it will not do anymore in vRA 8.4