7.1

Table Of Contents
Contents
vRealize Automation Programming Guide 6
1
Overview of the vRealize Automation REST API 7
2
REST API Authentication 10
Using HTTP Bearer Tokens 10
Configure the Duration of an HTTP Bearer Token 10
Request an HTTP Bearer Token 11
Validate an HTTP Bearer Token 14
Delete an HTTP Bearer Token 14
3
REST API Use Cases 16
Create a Tenant 17
Syntax for Displaying Your Current Tenants 20
Syntax for Requesting a New Tenant 23
Syntax for Listing All Tenant Identity Stores 26
Syntax for Linking an Identity Store to the Tenant 29
Syntax for Searching LDAP or Active Directory for a User 33
Syntax for Assigning a User to a Role 35
Syntax for Displaying all Roles Assigned to a User 36
Request a Machine 38
Syntax for Listing Shared and Private Catalog Items 40
Syntax for Getting Information for a Catalog Item 43
Syntax for Getting a Template Request for a Catalog Item 47
Syntax for Requesting a Machine 51
Syntax for Viewing Details of a Machine Request 54
Approve a Machine Request 57
Syntax for Listing Work Items 58
Syntax for Getting Work Item Details 65
Syntax for Constructing a JSON File to Approve a Machine Request 69
Syntax for Approving a Submitted Machine Request 73
Syntax for Updating Cost Information 75
List Provisioned Resources 78
Syntax for Displaying Your Provisioned Resources 79
Syntax for Displaying Provisioned Resources by Resource Type 81
Syntax for Displaying All Available Resource Types 84
Syntax for Displaying Provisioned Resources by Business Groups You Manage 86
Syntax for Viewing Machine Details 93
VMware, Inc.
3