Bundles and Promotion Web Services
- 1 Overview
- 2 Bundles
- 3 Bundle Report
- 4 Create a Bundle
- 5 Create a Bundle By Business Services
- 6 Create a Bundle By Date
- 7 Delete a Bundle
- 8 List Bundles
- 9 Modify a Bundle
- 10 Read a Bundle
- 11 Promotion
- 12 Bundleless Promotion
- 13 Cancel a Scheduled Bundle Promotion
- 14 Delete a Scheduled Bundle Promotion
- 15 Promote a Bundle or Schedule a Bundle Promotion
- 16 Create a Promotion Target
- 17 Modify a Promotion Target
- 18 List Promotion Targets
- 19 Delete a Promotion Target
- 20 Delete Promotion Target: URI Parameters
- 21 Read a Promotion Target
- 22 Refresh Target Agents
Overview
Universal Controller supports the following RESTful-based web services for Bundles and Promotion operations, which are listed alphabetically on this page under two categories:
Bundles
Promotion
Formatting specifications for each web service, including details about parameter requirements, are provided.
Bundles
Bundle Report
| Description |
|---|---|
URI | |
HTTP Method | GET |
Description | Retrieve Bundle Report details using specific query parameters. |
Example URI | |
URI Parameters | See Bundle Report: URI Parameters, below. |
Consumes Content-Type | n/a |
Produces Content-Type | application/xml, application/json |
Example Response | See Bundle Report: Example Response, below. |
Properties | See Bundle Properties. |
Bundle Report: URI Parameters
Parameter | UI Field Name | Description | Specifications | Required | Mutually Exclusive With |
|---|---|---|---|---|---|
| UUID | ID used within the Controller to identify this Bundle. | String value of the bundle sysId. | Y |
|
| Bundle Name | Name used within the Controller to identify this Bundle. | String value of the bundle name. | Y |
|
Bundle Report: Example Response
XML Response | JSON Response |
|---|---|
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<bundle retainSysIds="true">
<name>bundle-test</name>
<sysId>0d7f03026a96451fbc3d7a8eecd641d5</sysId>
<description>bundle test</description>
<defaultPromotionTarget>local</defaultPromotionTarget>
<followReferences>true</followReferences>
<excludeOnExistence>Triggers, Tasks, Calendars, Custom Days, Variables, Credentials, Agent Clusters, Virtual Resources, Scripts, Email Templates, Email Connections, Database Connections, SAP Connections, PeopleSoft Connections, SNMP Managers</excludeOnExistence>
<opswiseGroups>
<opswiseGroup>bus-1</opswiseGroup>
<opswiseGroup>bus-2</opswiseGroup>
</opswiseGroups>
<promoteBundleDefinition>true</promoteBundleDefinition>
<promoteByBusinessServices>
<businessService>bus-1</businessService>
<businessService>bus-2</businessService>
</promoteByBusinessServices>
<visibleTo>ops.admin</visibleTo>
<bundleTasks>
<bundleTask>
<name>win-1</name>
<sysId>0d7f03026a96451fbc3d7a8eecd641d5</sysId>
</bundleTask>
<bundleTask>
<name>abc</name>
<sysId>0d7f03026a96451fbc3d7a8eecd641d5</sysId>
</bundleTask>
</bundleTasks>
<bundleApplications>
<bundleApplication>
<name>App-test-1</name>
<sysId>0d7f03026a96451fbc3d7a8eecd641d5</sysId>
</bundleApplication>
</bundleApplications>
<bundleTriggers>
<bundleTrigger>
<name>manual-trigger-1</name>
<sysId>0d7f03026a96451fbc3d7a8eecd641d5</sysId>
</bundleTrigger>
<bundleTrigger>
<name>time-trigger-1</name>
<sysId>0d7f03026a96451fbc3d7a8eecd641d5</sysId>
</bundleTrigger>
</bundleTriggers>
<bundleCalendars>
<bundleCalendar>
<name>cal-test-1</name>
<sysId>0d7f03026a96451fbc3d7a8eecd641d5</sysId>
</bundleCalendar>
</bundleCalendars>
<bundleCustomDays>
<bundleCustomDay>
<name>custome-test-1</name>
<sysId>0d7f03026a96451fbc3d7a8eecd641d5</sysId>
</bundleCustomDay>
</bundleCustomDays>
<bundleVariables>
<bundleVariable>
<name>var1</name>
<sysId>0d7f03026a96451fbc3d7a8eecd641d5</sysId>
</bundleVariable>
</bundleVariables>
<bundleBusinessServices>
<bundleBusinessService>
<name>bus-1</name>
<sysId>0d7f03026a96451fbc3d7a8eecd641d5</sysId>
</bundleBusinessService>
</bundleBusinessServices>
<bundleCredentials>
<bundleCredential>
<name>sap-cred</name>
<sysId>0d7f03026a96451fbc3d7a8eecd641d5</sysId>
</bundleCredential>
</bundleCredentials>
<bundleAgentClusters>
<bundleAgentCluster>
<name>Opswise - Default Windows Cluster</name>
<sysId>0d7f03026a96451fbc3d7a8eecd641d5</sysId>
</bundleAgentCluster>
</bundleAgentClusters>
<bundleVirtualResources>
<bundleVirtualResource>
<name>VR-1</name>
<sysId>0d7f03026a96451fbc3d7a8eecd641d5</sysId>
</bundleVirtualResource>
</bundleVirtualResources>
<bundleScripts>
<bundleScript>
<name>script-1</name>
<sysId>0d7f03026a96451fbc3d7a8eecd641d5</sysId>
</bundleScript>
</bundleScripts>
<bundleEmailTemplates>
<bundleEmailTemplate>
<name>email-temp-1</name>
<sysId>0d7f03026a96451fbc3d7a8eecd641d5</sysId>
</bundleEmailTemplate>
</bundleEmailTemplates>
<bundleEmailConnections>
<bundleEmailConnection>
<name>Email-con-1</name>
<sysId>0d7f03026a96451fbc3d7a8eecd641d5</sysId>
</bundleEmailConnection>
</bundleEmailConnections>
<bundleDatabaseConnections>
<bundleDatabaseConnection>
<name>DB-conn-1</name>
<sysId>0d7f03026a96451fbc3d7a8eecd641d5</sysId>
</bundleDatabaseConnection>
</bundleDatabaseConnections>
<bundleSapConnections>
<bundleSapConnection>
<name>SAP-conn-1</name>
<sysId>0d7f03026a96451fbc3d7a8eecd641d5</sysId>
</bundleSapConnection>
</bundleSapConnections>
<bundlePeoplesoftConnections>
<bundlePeoplesoftConnection>
<name>People-test-1</name>
<sysId>0d7f03026a96451fbc3d7a8eecd641d5</sysId>
</bundlePeoplesoftConnection>
</bundlePeoplesoftConnections>
<bundleSnmpManagers>
<bundleSnmpManager>
<name>snmp-test-1</name>
<sysId>0d7f03026a96451fbc3d7a8eecd641d5</sysId>
</bundleSnmpManager>
</bundleSnmpManagers>
<bundleUniversalTemplates>
<bundleUniversalTemplate>
<name>univ-test-1</name>
<sysId>0d7f03026a96451fbc3d7a8eecd641d5</sysId>
</bundleUniversalTemplate>
</bundleUniversalTemplates>
</bundle> |