7.2
Table Of Contents
- Programming Guide
- Contents
- vRealize Automation Programming Guide
- Overview of the vRealize Automation REST API
- REST API Authentication
- REST API Use Cases
- Create a Tenant
- Syntax for Displaying Your Current Tenants
- Syntax for Requesting a New Tenant
- Syntax for Listing All Tenant Identity Stores
- Syntax for Linking an Identity Store to the Tenant
- Syntax for Searching LDAP or Active Directory for a User
- Syntax for Assigning a User to a Role
- Syntax for Displaying all Roles Assigned to a User
- Request a Machine
- Approve a Machine Request
- List Provisioned Resources
- Manage Provisioned Deployments
- Working with Reservations
- Create a Reservation
- Display a List of Supported Reservation Types
- Displaying a Schema Definition for a Reservation
- Get the Business Group ID for a Reservation
- Get a Compute Resource for the Reservation
- Getting a Resources Schema by Reservation Type
- Creating a Reservation By Type
- Verify a Reservation and Get Reservation Details
- Display a List of Reservations
- Update a Reservation
- Delete a Reservation
- Create a Reservation
- Working with Reservation Policies
- Working with Key Pairs
- Working with Network Profiles
- Get a List of Available IP Ranges for an IPAM Provider
- Import and Export Content
- Syntax for Listing Supported Content Types
- Syntax for Listing Available Content
- Syntax for Filtering Content by Content Type
- Syntax for Creating a Package for Export
- Syntax for Listing Packages in the Content Service
- Syntax for Exporting a Package
- Syntax for Validating a Content Bundle Before Importing
- Syntax for Importing a Package
- Understanding Blueprint Schema
- Manage XaaS Content with Import and Export
- Create a Tenant
- Related Tools and Documentation
- Filtering and Formatting REST API Information
- Index
REST API Use Cases 3
Available use cases provide the prerequisite, command line options and format, and sample results to help
you perform a variety of vRealize Automation functions, such as requesting a machine or creating a
reservation.
You can nd information about all of the available vRealize Automation REST API calls in the vRealize
Automation API Reference zip le located in the vRealize Automation Documentation Center. The use cases
provide samples of calls that you might commonly use and descriptions of example inputs and outputs
relative to those calls.
n
Create a Tenant on page 16
You can use the REST API identity service to create a vRealize Automation tenant and perform related
functions. Perform the tasks required to create a tenant with the REST API in sequence. For
information about creating and working with tenants and roles by using thevRealize Automation
application user interface, see the Tenant Administration and IaaS Conguration documentation.
n
Request a Machine on page 33
You can use REST API catalog service commands to complete a variety of tasks related to requesting a
machine. This procedure provides sample command line syntax for machine request tasks. Supporting
information regarding available input and output parameters, command-line entry samples, and
sample JSON output samples is available in the subsequent topics that explain syntax for the various
tasks.
n
Approve a Machine Request on page 50
You can use a sequence of REST API workitem service commands to approve a machine request.
n
List Provisioned Resources on page 69
You can use the REST API catalog service to log in to vRealize Automation and display a full or
ltered list of your provisioned resources .
n
Manage Provisioned Deployments on page 87
You can use the REST API catalog service to log in to vRealize Automation and view information
about provisioned resources .
n
Working with Reservations on page 101
You can work with the REST API reservation service to perform a variety of functions, such as creating
and updating reservations.
n
Working with Reservation Policies on page 265
You can use the vRealize Automation REST API to work with the reservation service to perform a
variety of functions, such as creating and updating reservation policies.
VMware, Inc.
15