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
Overview of the vRealize Automation
REST API 1
The vRealize Automation REST API provides consumer, administrator, and provider-level access to the
service catalog with the same services that support the vRealize Automation console user interface. You can
perform vRealize Automation functions programmatically by using REST API service calls.
The vRealize Automation REST API oers the following services and functions.
Table 1‑1. vRealize Automation REST API Services
Service Description
Approval Service Retrieve, create, update, and delete approval policies, policy types,
policy instances, and policy requests.
Branding Service Change the background and text colors, company logo, company
name, product name, tenant name, and other resources in the
console.
Catalog Service Retrieve global and entitled catalog items, and entitlements for a
catalog item and its service that the current user can review. A
consumer can retrieve, edit, and submit a request form for a catalog
item. A provider can retrieve, register, update, and delete catalog
items. Provision and manage systems.
Component Registry Service Access and manage all services and serves as the central view for
all service lookups.
Composition Service Allows vRealize Automation services to register application
components, which the composition service manages so that they
can be used in composite blueprints.
Content Management Service Access and manage the content controller and package controller
for export and import processes. This includes export and import
for blueprints and software.
Endpoint Conguration Service Create, read, update and delete endpoint types, endpoint
categories, and endpoints.
Event Broker Service Provide a central location and a consistent way of recording events
and querying for events.
Forms Service Used internally by the vRealize Automation system to create, read,
update and delete (perform CRUD operations on) request forms for
XaaS components.
IaaS Proxy Provider Service Run a proxy service that acts as a bridge between the service
catalog and the IaaS provider to call other services, such as the
catalog service, composition service, reservation service, and event
broker service.
Identity Service Manage tenants, business groups, SSO and custom groups, users,
and identity stores.
VMware, Inc. 7