Bundles and Promotion Web Services

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://host_name/uc/resources/bundle/report

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

bundleid

UUID

ID used within the Controller to identify this Bundle.

String value of the bundle sysId.

Y
(unless bundlename
is specified)

bundlename

bundlename

Bundle Name

Name used within the Controller to identify this Bundle.

String value of the bundle name.

Y
(unless bundleid
is specified)

bundleid


Bundle Report: Example Response

XML Response

JSON Response

 XML 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>

 JSON Response
  {
    "retainSysIds": true,
    "name": "bundle-1",
    "sysId": "b52335345df646e5b597dc26df599344",
    "description": "bundle test 1",
    "opswiseGroups": [
      "bus-1",
      "bus-2"
    ],
    "defaultPromotionTarget": "local",
    "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, Applications",
    "followReferences": true,
    "promoteBundleDefinition": true,
    "promoteByBusinessServices": [
      "bus-1",
      "bus-2"
    ],
    "visibleTo": "ops.admin",
    "bundleAgentClusters": [
      {
        "name": "Opswise - Default Linux/Unix Cluster",
        "sysId": "0d7f03026a96451fbc3d7a8eecd641d5"
      },
      {
        "name": "Opswise - Default Windows Cluster",
        "sysId": "d3f8282f702544d69500928afbcc00f0"
      }
    ],
    "bundleApplications": [
      {
        "name": "app-1",
        "sysId": "e12830a711c849388819230203e601d3"
      }
    ],
    "bundleBusinessServices": [
      {
        "name": "bus-1",
        "sysId": "b939eedb63544517accd905cfdd13b22"
      }
    ],
    "bundleCalendars": [
      {
        "name": "cal-1",
        "sysId": "655b9c498e574ace886b114f79d5933a"
      }
    ],
    "bundleCredentials": [
      {
        "name": "cred-1",
        "sysId": "d04886ac74be43a0aa3faa8042f82cca"
      }
    ],
    "bundleCustomDays": [
      {
        "name": "cust-1",
        "sysId": "1b0e9acedb98439a8319ac3cd51c21ba"
      }
    ],
    "bundleDatabaseConnections": [
      {
        "name": "db-con-1",
        "sysId": "fc8223ece09f407bb9b5bb865574cb49"
      }
    ],
    "bundleEmailConnections": [
      {
        "name": "email-conn",
        "sysId": "bd54eae4221a4f909454f7fa04c75efb"
      }
    ],
    "bundleEmailTemplates": [
      {
        "name": "email-temp-1",
        "sysId": "5dce586a419448ee83fa121589d60a75"
      }
    ],
    "bundlePeoplesoftConnections": [
      {
        "name": "ps-con-1",
        "sysId": "aac40dfd5c3242ae9bcaaf169a5468b9"
      }
    ],
    "bundleSapConnections": [
      {
        "name": "sap-1",
        "sysId": "a4b0544fb668404ba10b2826b2e6db81"
      }
    ],
    "bundleScripts": [
      {
        "name": "script-1",
        "sysId": "01e90371bed4473d87dad00148512f35"
      }
    ],
    "bundleSnmpManagers": [
      {
        "name": "snmp-1",
        "sysId": "4bfa01f747ca4ad5b4ee9e073d643604"
      }
    ],
    "bundleTasks": [
      {
        "name": "win-1",
        "sysId": "3b50f8c015d6494288328cfdb35d9ea7"
      }
    ],
    "bundleTriggers": [
      {
        "name": "cron-trig-1",
        "sysId": "d2869f93a68547beb8e5b156d4fac99e"
      }
    ],
    "bundleUniversalTemplates": [
      {
        "name": "uni-1",
        "sysId": "0ff4abb1d80c4f95b517dc073c9abd0c"
      }
    ],
    "bundleVariables": [
      {
        "name": "var1",
        "sysId": "9988d78bf82e44dbae66cf0e8ec4b820"
      }
    ],
    "bundleVirtualResources": [
      {
        "name": "VR-1",
        "sysId": "deeaf3e516ce485fac5fc2283022d904"
      }
    ]
  }

Create a Bundle


Description

URI

http://host_name/uc/resources/bundle

HTTP Method

POST

Description

Creates a Bundle.

Example URI

http://localhost:8080/uc/resources/bundle
AuthenticationHTTP Basic

Consumes Content-Type

application/xml, application/json

Produces Content-Type

n/a

Example Request

See Create a Bundle: Example Request, below.

Properties

See Bundle Properties.

Example Response

  • Status 200 /OK
    Successfully created the Bundle with sysId 0b6e87e4aa4a410eb1b5875d8fe40985.

Create a Bundle: Example Request

XML Request

JSON Request

 XML Request

<?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>

 JSON Request
  {
    "retainSysIds": true,
    "name": "bundle-1",
    "sysId": "b52335345df646e5b597dc26df599344",
    "description": "bundle test 1",
    "opswiseGroups": [
      "bus-1",
      "bus-2"
    ],
    "defaultPromotionTarget": "local",
    "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, Applications",
    "followReferences": true,
    "promoteBundleDefinition": true,
    "promoteByBusinessServices": [
      "bus-1",
      "bus-2"
    ],
    "visibleTo": "ops.admin",
    "bundleAgentClusters": [
      {
        "name": "Opswise - Default Linux/Unix Cluster",
        "sysId": "0d7f03026a96451fbc3d7a8eecd641d5"
      },
      {
        "name": "Opswise - Default Windows Cluster",
        "sysId": "d3f8282f702544d69500928afbcc00f0"
      }
    ],
    "bundleApplications": [
      {
        "name": "app-1",
        "sysId": "e12830a711c849388819230203e601d3"
      }
    ],
    "bundleBusinessServices": [
      {
        "name": "bus-1",
        "sysId": "b939eedb63544517accd905cfdd13b22"
      }
    ],
    "bundleCalendars": [
      {
        "name": "cal-1",
        "sysId": "655b9c498e574ace886b114f79d5933a"
      }
    ],
    "bundleCredentials": [
      {
        "name": "cred-1",
        "sysId": "d04886ac74be43a0aa3faa8042f82cca"
      }
    ],
    "bundleCustomDays": [
      {
        "name": "cust-1",
        "sysId": "1b0e9acedb98439a8319ac3cd51c21ba"
      }
    ],
    "bundleDatabaseConnections": [
      {
        "name": "db-con-1",
        "sysId": "fc8223ece09f407bb9b5bb865574cb49"
      }
    ],
    "bundleEmailConnections": [
      {
        "name": "email-conn",
        "sysId": "bd54eae4221a4f909454f7fa04c75efb"
      }
    ],
    "bundleEmailTemplates": [
      {
        "name": "email-temp-1",
        "sysId": "5dce586a419448ee83fa121589d60a75"
      }
    ],
    "bundlePeoplesoftConnections": [
      {
        "name": "ps-con-1",
        "sysId": "aac40dfd5c3242ae9bcaaf169a5468b9"
      }
    ],
    "bundleSapConnections": [
      {
        "name": "sap-1",
        "sysId": "a4b0544fb668404ba10b2826b2e6db81"
      }
    ],
    "bundleScripts": [
      {
        "name": "script-1",
        "sysId": "01e90371bed4473d87dad00148512f35"
      }
    ],
    "bundleSnmpManagers": [
      {
        "name": "snmp-1",
        "sysId": "4bfa01f747ca4ad5b4ee9e073d643604"
      }
    ],
    "bundleTasks": [
      {
        "name": "win-1",
        "sysId": "3b50f8c015d6494288328cfdb35d9ea7"
      }
    ],
    "bundleTriggers": [
      {
        "name": "cron-trig-1",
        "sysId": "d2869f93a68547beb8e5b156d4fac99e"
      }
    ],
    "bundleUniversalTemplates": [
      {
        "name": "uni-1",
        "sysId": "0ff4abb1d80c4f95b517dc073c9abd0c"
      }
    ],
    "bundleVariables": [
      {
        "name": "var1",
        "sysId": "9988d78bf82e44dbae66cf0e8ec4b820"
      }
    ],
    "bundleVirtualResources": [
      {
        "name": "VR-1",
        "sysId": "deeaf3e516ce485fac5fc2283022d904"
      }
    ]
  }

Bundle Properties

Property

UI Field Name

Description

Specifications

Required

bundleAgentClusters

Agent Clusters

Task Items to include

String value of task

N

bundleApplications

Applications

Applications to include

String value of Applications

N

bundleBusinessServices

Business Services

Business Services Items to include

String value of Business Services

N

bundleCalendars

Calendars

Calendars Items to include

String value of Calendars

N

bundleCredentials

Credentials

Agent Clusters Items to include

String value of Agent Clusters

N

bundleCustomDays

Custom Days

Custom Days Items to include

String value of Custom Days

N

bundleDatabaseConnections

Database Connections

Database Connections Items to include

String value of Database Connections

N

bundleEmailConnections

Email Connections

Email Connections Items to include

String value of Email Connections

N

bundleEmailTemplates

Email Templates

Email Templates Items to include

String value of Email Templates

N

bundlePeoplesoftConnections

PeopleSoft Connections

PeopleSoft Connections Items to include

String value of PeopleSoft Connections

N

bundleSapConnections

Sap Connections

Sap Connections Items to include

String value of Sap Connections

N

bundleScripts

Scripts

Scripts Items to include

String value of Scripts

N

bundleSnmpManagers

SNMP Managers

SNMP Managers Items to include

String value of SNMP Managers

N

bundleTasks

Tasks

Task Items to include

String value of task

N

bundleTriggers

Triggers

Triggers Items to include

String value of Triggers

N

bundleUniversalTemplates

Universal Templates

Universal Templates Items to include

String value of Universal Templates

N

bundleVariables

Variables

Variables Items to include

String value of Variables

N

bundleVirtualResources

Virtual Resources

Virtual Resources Items to include

String value of Virtual Resources

N

defaultPromotionTarget

Default Promotion Target

Promotion Target server name

String value of target

N

description

Description

Bundle description

String value of description

N

excludeOnExistence

Exclude On Existence

Exclude Items on existence

String value

N

exportReleaseLevel

n/a

Universal Controller release that the record was exported from.

read onlyN

exportTable

n/aRecord table information.read onlyN

followReferences

Follow References

Follow references items

Boolean value

N

name

Bundle Name

Bundle name

String value of the bundle name

Y

opswiseGroups

Member Of Business Services

List of Business Services that this task belongs to

String value

N

promoteBundleDefinition

Promote Bundle Definition

Promote Bundle Definition

Boolean value

N

promoteByBusinessServices

Promote Member of Business Service

Promote List of Business Services that this task belongs to

String value

N

sysId

n/aSystem ID field in the database for this Bundles record.

Persisted only if retainSysIds is set to true.

N

visibleTo

Visible To

Visible to user

String value of user name

N
(Required if promoteByBusinessServices
is specified)


Create a Bundle By Business Services


Description

URI

HTTP Method

POST

Description

Creates a Bundle.

Example URI

AuthenticationHTTP Basic

Consumes Content-Type

application/xml, application/json

Produces Content-Type

n/a

Example Request

See Create a Bundle By Business Services: Example Request, below.

Properties

See Create a Bundle By Business Services Properties.

Example Response

  • Status 200
    Successfully created bundle "bundle-by-service2" with 1 item(s).



Create a Bundle By Business Services: Example Request

XML Request

JSON Request

 XML Request

<bundle>
    <name>bundle-by-service2</name>
    <businessServices>
        <businessService>bus-1</businessService>
        <businessService>bus-2</businessService>
   
</businessServices>
   
<typesToInclude>Triggers, Tasks, Calendars, Variables, Credentials</typesToInclude>
    <businessServicesToInclude>
        <businessService>bus-1</businessService>
        <businessService>bus-2</businessService>
    </businessServicesToInclude>
</bundle>

 JSON Request

{
    "name": "bundle-service4",
    
"typesToInclude": "Triggers, Tasks, Calendars, Variables, Credentials",
    "businessServices": [
      
"bus-1",
      
"bus-2"
    
],
    
"businessServicesToInclude": [
      
"bus-1",
      
"bus-2"
    
]
}


Create a Bundle By Business Services Properties

Property

UI Field Name

Description

Specifications

Required

name

Bundle Name

Bundle name

String value of the bundle name.

Y

typesToInclude

Types To Include

Include item types

String value.

Y

businessServices

Member Of Business Services

List of Business Services that this bundle belongs to

String value of the list.

N

businessServicesToInclude

Business Services To Include

Include List of Business Services for this bundle creation

String value of the list.

Y



Create a Bundle By Date


Description

URI

HTTP Method

POST

Description

Creates a Bundle.

Example URI

AuthenticationHTTP Basic

Consumes Content-Type

application/xml, application/json

Produces Content-Type

n/a

Example Request

See Create a Bundle By Date: Example Request, below.

Properties

See Create a Bundle By Date Properties.

Example Response

  • Status 200
    Successfully created bundle "bundle-by-service2" with 1 item(s).



Create a Bundle By Date: Example Request

XML Request

JSON Request

 XML Request

<bundle>
    <name>bundle-by-service2</name>
    <businessServices>
        <businessService>bus-1</businessService>
        <businessService>bus-2</businessService>
    </businessServices>
   
<typesToInclude>Triggers, Tasks, Calendars, Variables, Credentials</typesToInclude>
    <updatedOnOrAfter>2020-07-01 00:00:00 -0400</updatedOnOrAfter>
</bundle>

 JSON Request

{
    "name": "bundle-service4",
    
"typesToInclude": "Triggers, Tasks, Calendars, Variables, Credentials",
    "businessServices": [
      
"bus-1",
            "bus-2"
    ],
 
   "updatedOnOrAfter": "2020-07-01 00:00:00 -0400"
}


Create a Bundle By Date Properties

Property

UI Field Name

Description

Specifications

Required

name

Bundle Name

Bundle name

String value of the bundle name.

Y

typesToInclude

Types To Include

Include item types

String value.

Y

businessServices

Member Of Business Services

List of Business Services that this bundle belongs to

String value of the list.

N

updatedOnOrAfter

Business Services To Include

Include List of items created On/After the dae

String value of the date.

Y


Delete a Bundle


Description

URI

http://host_name/uc/resources/bundle

HTTP Method

DELETE

Description

Deletes a Bundle.

URI Parameters

See Delete a Bundle: URI Parameters, below.

Example URI

Example Response

  • Status 200 /OK
    Bundle deleted successfully.

Delete a Bundle: URI Parameters

Parameter

Description

Specifications

Required

Mutually Exclusive With

bundleid

ID used within the Controller to identify this Bundle.

String value of the bundle sysId.

Y
(unless bundlename
is specified)

bundlename

bundlename

Name used within the Controller to identify this Bundle.

String value of the bundle name.

Y
(unless bundleid
is specified)

bundleid

List Bundles


Description

URI

http://host_name/uc/resources/bundle/list

HTTP Method

GET

Description

Retrieves information on all Bundles.

Example URI

Authentication

HTTP Basic

Consumes Content-Type

n/a

Produces Content-Type

application/xml, application/json

Example Response

See List Bundles: Example Response, below.

Properties

See Bundle Properties.


List Bundles Request Parameters

Property

UI Field Name

Description

Specifications

Required

bundlename

n/a

Request parameter bundlename.

String value of the bundle name. Wildcards are supported.

N

businessServices

n/a

Request parameter businessServices.

String value of the bundle business service.

N

defaultPromotionTarget

n/a

Request parameter defaultPromotionTarget.

String value of the promotion target. Wildcards are supported.

N


List Bundles: Example Response

XML Response

JSON Response

 XML Response

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<bundles>
    <bundle exportReleaseLevel="7.2.0.0" exportTable="ops_bundle" retainSysIds=true>

        <name>bundle-test</name>
        <sysId>b52335345df646e5b597dc26df599344</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 addedBy="ops.admin" type="Workflow">
                <name>win-1</name>
                <sysId>0d7f03026a96451fbc3d7a8eecd641d5</sysId>

            </bundleTask>
        </bundleTasks>
        <bundleApplications>
            <bundleApplication addedBy="ops.admin" type="Windows Service">
                <name>App-test-1</name>
                <sysId>0d7f03026a96451fbc3d7a8eecd641d5</sysId>
            </bundleApplication>
        </bundleApplications>
        <bundleTriggers>
            <bundleTrigger addedBy="ops.admin" type="Cron">
                <name>manual-trigger-1</name>
                <sysId>0d7f03026a96451fbc3d7a8eecd641d5</sysId>
            </bundleTrigger>
        </bundleTriggers>
        <bundleCalendars>
            <bundleCalendar addedBy="ops.admin" type="calendar 1">
                <name>cal-test-1</name>
                <sysId>0d7f03026a96451fbc3d7a8eecd641d5</sysId>
            </bundleCalendar>
        </bundleCalendars>
        <bundleCustomDays>
            <bundleCustomDay addedBy="ops.admin" description="custom day test"
                             type="Single Date"
>

                <name>custome-test-1</name>
                <sysId>0d7f03026a96451fbc3d7a8eecd641d5</sysId>
            </bundleCustomDay>
        </bundleCustomDays>
        <bundleVariables>
            <bundleVariable addedBy="ops.admin" description="variable 1" >
                <name>var1</name>
                <sysId>0d7f03026a96451fbc3d7a8eecd641d5</sysId>
            </bundleVariable>
        </bundleVariables>
        <bundleBusinessServices>
            <bundleBusinessService addedBy="ops.admin">
                <name>bus-1</name>
                <sysId>0d7f03026a96451fbc3d7a8eecd641d5</sysId>
            </bundleBusinessService>
       
</bundleBusinessServices>
        <bundleCredentials>
            <bundleCredential addedBy="ops.admin">
                <name>sap-cred</name>
                <sysId>0d7f03026a96451fbc3d7a8eecd641d5</sysId>
            </bundleCredential>
        </bundleCredentials>
        <bundleAgentClusters>
            <bundleAgentCluster addedBy="ops.admin" type="Linux/Unix">
                <name>Opswise - Default Windows Cluster</name>
                <sysId>0d7f03026a96451fbc3d7a8eecd641d5</sysId>
            </bundleAgentCluster>
        </bundleAgentClusters>
        <bundleVirtualResources>
            <bundleVirtualResource addedBy="ops.admin" type="Renewable">
                <name>VR-1</name>
                <sysId>0d7f03026a96451fbc3d7a8eecd641d5</sysId>
            </bundleVirtualResource>
        </bundleVirtualResources>
        <bundleScripts>
            <bundleScript addedBy="ops.admin" description="script 1"
                          type="Script"
>

                <name>script-1</name>
                <sysId>0d7f03026a96451fbc3d7a8eecd641d5</sysId>
            </bundleScript>
        </bundleScripts>
        <bundleEmailTemplates>
            <bundleEmailTemplate addedBy="ops.admin">
                <name>email-temp-1</name>
                <sysId>0d7f03026a96451fbc3d7a8eecd641d5</sysId>
            </bundleEmailTemplate>
        </bundleEmailTemplates>
        <bundleEmailConnections>
            <bundleEmailConnection addedBy="ops.admin" type="Outgoing">
                <name>Email-con-1</name>
                <sysId>0d7f03026a96451fbc3d7a8eecd641d5</sysId>
            </bundleEmailConnection>
        </bundleEmailConnections>
        <bundleDatabaseConnections>
            <bundleDatabaseConnection addedBy="ops.admin">
                <name>DB-conn-1</name>
                <sysId>0d7f03026a96451fbc3d7a8eecd641d5</sysId>
            </bundleDatabaseConnection>
        </bundleDatabaseConnections>
        <bundleSapConnections>
            <bundleSapConnection addedBy="ops.admin">
                <name>SAP-conn-1</name>
                <sysId>0d7f03026a96451fbc3d7a8eecd641d5</sysId>
            </bundleSapConnection>
        </bundleSapConnections>
        <bundlePeoplesoftConnections>
            <bundlePeoplesoftConnection addedBy="ops.admin">
                <name>People-test-1</name>
                <sysId>0d7f03026a96451fbc3d7a8eecd641d5</sysId>
            </bundlePeoplesoftConnection>
        </bundlePeoplesoftConnections>
        <bundleSnmpManagers>
            <bundleSnmpManager addedBy="ops.admin">
                <name>snmp-test-1</name>
                <sysId>0d7f03026a96451fbc3d7a8eecd641d5</sysId>
            </bundleSnmpManager>
        </bundleSnmpManagers>
        <bundleUniversalTemplates>
            <bundleUniversalTemplate addedBy="ops.admin">
                <name>univ-test-1</name>
                <sysId>0d7f03026a96451fbc3d7a8eecd641d5</sysId>
            </bundleUniversalTemplate>
        </bundleUniversalTemplates>
    </bundle>
<bundles>

 JSON Response
[  
  {
    "retainSysIds": true,
    "name": "bundle-1",
    "sysId": "b52335345df646e5b597dc26df599344",
    "description": "bundle test 1",
    "opswiseGroups": [
      "bus-1",
      "bus-2"
    ],
    "defaultPromotionTarget": "local",
    "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, Applications",
    "followReferences": true,
    "promoteBundleDefinition": true,
    "promoteByBusinessServices": [
      "bus-1",
      "bus-2"
    ],
    "visibleTo": "ops.admin",
    "bundleAgentClusters": [
      {
        "addedBy": "ops.admin",
        "name": "Opswise - Default Linux/Unix Cluster",
        "sysId": "0d7f03026a96451fbc3d7a8eecd641d5",
        "type": "Windows"
      }
    ],
    "bundleApplications": [
      {
        "addedBy": "ops.admin",
        "name": "app-1",
        "sysId": "e12830a711c849388819230203e601d3",
        "type": "Windows Service"

      }
    ],
    "bundleBusinessServices": [
      {
        "addedBy": "ops.admin",
        "name": "bus-1",
        "sysId": "b939eedb63544517accd905cfdd13b22"
      }
    ],
    "bundleCalendars": [
      {
        "addedBy": "ops.admin",
        "description": "calendar 1",
        "name": "cal-1",
        "sysId": "655b9c498e574ace886b114f79d5933a"
      }
    ],
    "bundleCredentials": [
      {
        "addedBy": "ops.admin",
        "name": "cred-1",
        "sysId": "d04886ac74be43a0aa3faa8042f82cca"
      }
    ],
    "bundleCustomDays": [
      {
        "addedBy": "ops.admin",
        "description": "custom day test",
        "name": "cust-1",
        "sysId": "1b0e9acedb98439a8319ac3cd51c21ba",
        "type": "Single Date"
      }
    ],
    "bundleDatabaseConnections": [
      {
        "addedBy": "ops.admin",
        "name": "db-con-1",
        "sysId": "fc8223ece09f407bb9b5bb865574cb49"
      }
    ],
    "bundleEmailConnections": [
      {
        "addedBy": "ops.admin",
        "name": "email-conn",
        "sysId": "bd54eae4221a4f909454f7fa04c75efb",
        "type": "Outgoing"
      }
    ],
    "bundleEmailTemplates": [
      {
        "addedBy": "ops.admin",
        "name": "email-temp-1",
        "sysId": "5dce586a419448ee83fa121589d60a75"
      }
    ],
    "bundlePeoplesoftConnections": [
      {
        "addedBy": "ops.admin",
        "name": "ps-con-1",
        "sysId": "aac40dfd5c3242ae9bcaaf169a5468b9"
      }
    ],
    "bundleSapConnections": [
      {
        "addedBy": "ops.admin",
        "name": "sap-1",
        "sysId": "a4b0544fb668404ba10b2826b2e6db81"
      }
    ],
    "bundleScripts": [
      {
        "addedBy": "ops.admin",
        "description": "script 1",
        "name": "script-1",
        "sysId": "01e90371bed4473d87dad00148512f35",
        "type": "Script"
      }
    ],
    "bundleSnmpManagers": [
      {
        "addedBy": "ops.admin",
        "name": "snmp-1",
        "sysId": "4bfa01f747ca4ad5b4ee9e073d643604"
      }
    ],
    "bundleTasks": [
      {
        "addedBy": "ops.admin",
        "name": "win-1",
        "sysId": "3b50f8c015d6494288328cfdb35d9ea7",
        "type": "Workflow"
      }
    ],
    "bundleTriggers": [
      {
        "addedBy": "ops.admin",
        "name": "cron-trig-1",
        "sysId": "d2869f93a68547beb8e5b156d4fac99e",
        "type": "Cron"
      }
    ],
    "bundleUniversalTemplates": [
      {
        "addedBy": "ops.admin",
        "name": "uni-1",
        "sysId": "0ff4abb1d80c4f95b517dc073c9abd0c"
      }
    ],
    "bundleVariables": [
      {
        "addedBy": "ops.admin",
        "description": "variable 1",
        "name": "var1",
        "sysId": "9988d78bf82e44dbae66cf0e8ec4b820"
      }
    ],
    "bundleVirtualResources": [
      {
        "addedBy": "ops.admin",
        "name": "VR-1",
        "sysId": "deeaf3e516ce485fac5fc2283022d904",
        "type": "Renewable"
      }
    ]
"exportReleaseLevel": "7.2.0.0",
"exportTable": "ops_bundle", }
]

Modify a Bundle


Description

URI

http://host_name/uc/resources/bundle

HTTP Method

PUT

Description

Modifies the Credential specified by the sysId.

Example URI

http://localhost:8080/uc/resources/bundle

Consumes Content-Type

application/xml, application/json

Produces Content-Type

n/a

Example Request

See Modify a Bundle: Example Request, below.

Properties

See Bundle Properties.

Example Response

  • Status 200 /OK
    Successfully updated the Bundle with sysId <sysId> to version <version>.


Modify a Bundle: Example Request

XML Request

JSON Request

 XML Request

<?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>

 JSON Request
  {
    "retainSysIds": true,
    "name": "bundle-1",
    "sysId": "b52335345df646e5b597dc26df599344",
    "description": "bundle test 1",
    "opswiseGroups": [
      "bus-1",
      "bus-2"
    ],
    "defaultPromotionTarget": "local",
    "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, Applications",
    "followReferences": true,
    "promoteBundleDefinition": true,
    "promoteByBusinessServices": [
      "bus-1",
      "bus-2"
    ],
    "visibleTo": "ops.admin",
    "bundleAgentClusters": [
      {
        "name": "Opswise - Default Linux/Unix Cluster",
        "sysId": "0d7f03026a96451fbc3d7a8eecd641d5",
      },
      {
        "name": "Opswise - Default Windows Cluster",
        "sysId": "d3f8282f702544d69500928afbcc00f0",
      }
    ],
    "bundleApplications": [
      {
        "name": "app-1",
        "sysId": "e12830a711c849388819230203e601d3",
      }
    ],
    "bundleBusinessServices": [
      {
        "name": "bus-1",
        "sysId": "b939eedb63544517accd905cfdd13b22"
      }
    ],
    "bundleCalendars": [
      {
        "name": "cal-1",
        "sysId": "655b9c498e574ace886b114f79d5933a"
      }
    ],
    "bundleCredentials": [
      {
        "name": "cred-1",
        "sysId": "d04886ac74be43a0aa3faa8042f82cca"
      }
    ],
    "bundleCustomDays": [
      {
        "name": "cust-1",
        "sysId": "1b0e9acedb98439a8319ac3cd51c21ba",
      }
    ],
    "bundleDatabaseConnections": [
      {
        "name": "db-con-1",
        "sysId": "fc8223ece09f407bb9b5bb865574cb49"
      }
    ],
    "bundleEmailConnections": [
      {
        "name": "email-conn",
        "sysId": "bd54eae4221a4f909454f7fa04c75efb",
      }
    ],
    "bundleEmailTemplates": [
      {
        "name": "email-temp-1",
        "sysId": "5dce586a419448ee83fa121589d60a75"
      }
    ],
    "bundlePeoplesoftConnections": [
      {
        "name": "ps-con-1",
        "sysId": "aac40dfd5c3242ae9bcaaf169a5468b9"
      }
    ],
    "bundleSapConnections": [
      {
        "name": "sap-1",
        "sysId": "a4b0544fb668404ba10b2826b2e6db81"
      }
    ],
    "bundleScripts": [
      {
        "name": "script-1",
        "sysId": "01e90371bed4473d87dad00148512f35",
      }
    ],
    "bundleSnmpManagers": [
      {
        "name": "snmp-1",
        "sysId": "4bfa01f747ca4ad5b4ee9e073d643604"
      }
    ],
    "bundleTasks": [
      {
        "name": "win-1",
        "sysId": "3b50f8c015d6494288328cfdb35d9ea7",
      }
    ],
    "bundleTriggers": [
      {
        "name": "cron-trig-1",
        "sysId": "d2869f93a68547beb8e5b156d4fac99e",
      }
    ],
    "bundleUniversalTemplates": [
      {
        "name": "uni-1",
        "sysId": "0ff4abb1d80c4f95b517dc073c9abd0c"
      }
    ],
    "bundleVariables": [
      {
        "name": "var1",
        "sysId": "9988d78bf82e44dbae66cf0e8ec4b820"
      }
    ],
    "bundleVirtualResources": [
      {
        "name": "VR-1",
        "sysId": "deeaf3e516ce485fac5fc2283022d904",
      }
    ]
  }

Read a Bundle

URI

http://host_name/uc/resources/bundle

HTTP Method

GET

Description

Retrieve Bundle details using a specific query parameters.

URI Parameters

See Read a Bundle: URI Parameters, below.

Example URI

Consumes Content-Type

n/a

Produces Content-Type

application/xml, application/json

Example Response

See Read a Bundle: Example Response, below.

Properties

See Bundle Properties.

Read a Bundle: URI Parameters

Parameter

Description

Specifications

Required

Mutually Exclusive With

bundleid

ID used within the Controller to identify this Bundle.

String value of the bundle sysId.

Y
(unless bundlename
is specified)

bundlename

bundlename

Name used within the Controller to identify this Bundle.

String value of the bundle name.

Y
(unless bundleid
is specified)

bundleid

Read a Bundle: Example Response

The exportReleaseLevel and exportTable properties are specified as attributes in XML.

XML Response

JSON Response

 XML Response

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <bundle exportReleaseLevel="7.2.0.0" exportTable="ops_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>
        </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>

 JSON Response
  {
    "retainSysIds": true,
    "name": "bundle-1",
    "sysId": "b52335345df646e5b597dc26df599344",
    "description": "bundle test 1",
    "opswiseGroups": [
      "bus-1",
      "bus-2"
    ],
    "defaultPromotionTarget": "local",
    "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, Applications",
    "followReferences": true,
    "promoteBundleDefinition": true,
    "promoteByBusinessServices": [
      "bus-1",
      "bus-2"
    ],
    "visibleTo": "ops.admin",
    "bundleAgentClusters": [
      {
        "name": "Opswise - Default Linux/Unix Cluster",
        "sysId": "0d7f03026a96451fbc3d7a8eecd641d5",
      },
      {
        "name": "Opswise - Default Windows Cluster",
        "sysId": "d3f8282f702544d69500928afbcc00f0",
      }
    ],
    "bundleApplications": [
      {
        "name": "app-1",
        "sysId": "e12830a711c849388819230203e601d3",
      }
    ],
    "bundleBusinessServices": [
      {
        "name": "bus-1",
        "sysId": "b939eedb63544517accd905cfdd13b22"
      }
    ],
    "bundleCalendars": [
      {
        "name": "cal-1",
        "sysId": "655b9c498e574ace886b114f79d5933a"
      }
    ],
    "bundleCredentials": [
      {
        "name": "cred-1",
        "sysId": "d04886ac74be43a0aa3faa8042f82cca"
      }
    ],
    "bundleCustomDays": [
      {
        "name": "cust-1",
        "sysId": "1b0e9acedb98439a8319ac3cd51c21ba",
      }
    ],
    "bundleDatabaseConnections": [
      {
        "name": "db-con-1",
        "sysId": "fc8223ece09f407bb9b5bb865574cb49"
      }
    ],
    "bundleEmailConnections": [
      {
        "name": "email-conn",
        "sysId": "bd54eae4221a4f909454f7fa04c75efb",
      }
    ],
    "bundleEmailTemplates": [
      {
        "name": "email-temp-1",
        "sysId": "5dce586a419448ee83fa121589d60a75"
      }
    ],
    "bundlePeoplesoftConnections": [
      {
        "name": "ps-con-1",
        "sysId": "aac40dfd5c3242ae9bcaaf169a5468b9"
      }
    ],
    "bundleSapConnections": [
      {
        "name": "sap-1",
        "sysId": "a4b0544fb668404ba10b2826b2e6db81"
      }
    ],
    "bundleScripts": [
      {
        "name": "script-1",
        "sysId": "01e90371bed4473d87dad00148512f35",
      }
    ],
    "bundleSnmpManagers": [
      {
        "name": "snmp-1",
        "sysId": "4bfa01f747ca4ad5b4ee9e073d643604"
      }
    ],
    "bundleTasks": [
      {
        "name": "win-1",
        "sysId": "3b50f8c015d6494288328cfdb35d9ea7",
      }
    ],
    "bundleTriggers": [
      {
        "name": "cron-trig-1",
        "sysId": "d2869f93a68547beb8e5b156d4fac99e",
      }
    ],
    "bundleUniversalTemplates": [
      {
        "name": "uni-1",
        "sysId": "0ff4abb1d80c4f95b517dc073c9abd0c"
      }
    ],
    "bundleVariables": [
      {
        "name": "var1",
        "sysId": "9988d78bf82e44dbae66cf0e8ec4b820"
      }
    ],
    "bundleVirtualResources": [
      {
        "name": "VR-1",
        "sysId": "deeaf3e516ce485fac5fc2283022d904",
      }
],
"exportReleaseLevel": "7.2.0.0",
"exportTable": "ops_bundle" }


Promotion

Bundleless Promotion


Description

URI

http://host_name/uc/resources/promote

HTTP Method

POST

Description

Promotes, without a bundle, one or more items of a specific type.

Example URI

http://localhost:8080/uc/resources/promote

Authentication

HTTP Basic

Consumes Content-Type

application/xml, application/json

Produces Content-Type

application/xml, application/json

Example Request

See Promote: XML and JSON Examples.

Request Properties

See Promote: Properties.

Example Response

See Promote: XML and JSON Examples.

Bundleless Promotion: XML and JSON Examples

Examples

XML

JSON

Example Request

 XML
<promote>
    <itemType>Calendar</itemType>
    <itemNames>CAL_US,CAL_CAN</itemNames>
    <promotionTargetName>PT1</promotionTargetName>
    <excludeOnExistence>Custom Days</excludeOnExistence>
    <followReferences>false</followReferences>
    <allowUnvTmpltChanges>false</allowUnvTmpltChanges>
</promote>


 JSON

{
  "itemType" : "Universal Template",
  "itemIds" : "4e656d398d5f4ebd8d7df3210147c488",
  "promotionTargetId" : "6330f82afab54273b9167a2b434a2424",
  "overrideUser" : "testUser",
  "overridePassword" : "testPassword1",
  "followReferences" : true,
  "allowUnvTmpltChanges" : true
}

Example Response

 XML

<command-response>
    <type>promote</type>
    <success>true</success>
    <info>Successfully promoted 2 calendars and 1 referenced item to promotion target "PT1".</info>
    <errors></errors>
</command-response>

 JSON

{
  "type": "promote",
  "success": true,
  "info": "Successfully promoted 1 universal template to promotion target \"PT1\".",
  "errors": ""
}

Bundleless Promotion: Properties

Property

UI Field Name

Description

Specifications

Required

Mutually Exclusive With

itemType

n/aItem type for promotion item(s).

Valid Values:

One of the following (not case sensitive):

  • Trigger
  • Task
  • Calendar
  • Custom Day
  • Variable
  • Business Service
  • Credential
  • Agent Cluster
  • Virtual Resource
  • Script
  • Email Template
  • Email Connection
  • Database Connection
  • SAP Connection
  • PeopleSoft Connection
  • SNMP Manager
  • Application
  • Universal Template
Y

itemIds

n/aIDs for promotion items.Comma-separated list of promotion item IDs.Y
(unless itemNames
is specified)
itemNames

itemNames

n/aNames for promotion items.

Comma-separated list of promotion item names.

Y
(unless itemIds
is specified)
itemIds

promotionTargetId

n/aID of the Promotion Target.
Y
(unless promotionTargetName
is specified)
promotionTargetName

promotionTargetName

Promotion Target

Name of the Promotion Target.


Y
(unless promotionTargetId
is specified)
promotionTargetId

overrideUser

User

User name to use instead of the default User name for the Promotion Target.


Y
(if overridePassword
is specified)

overridePassword

PasswordUser password to use instead of the default User password for the Promotion Target.
Y
(if overrideUser
is specified)

excludeOnExistence

Exclude On ExistenceItem types that will not be updated if they exist on the target server.

Comma-separated list of excluded types.

Valid Values:

  • As String = Triggers, As Value = 1
  • As String = Tasks, As Value = 2
  • As String = Calendars, As Value = 4
  • As String = Custom Days, As Value = 8
  • As String = Variables As Value = 16
  • As String = Credentials, As Value = 64
  • As String = Agent Clusters, As Value = 128
  • As String = Virtual Resources, As Value = 256
  • As String = Scripts, As Value = 512
  • As String = Email Templates, As Value = 1024
  • As String = Email Connections As Value = 2048
  • As String = Database Connections, As Value = 4096
  • As String = SAP Connections, As Value = 8192
  • As String = SNMP Managers, As Value = 16384
  • As String = Applications, As Value = 32768
  • As String = PeopleSoft Connections, As Value = 65536
N

followReferences

Follow ReferencesDynamically include items in the promotion that are referenced by promotion items.

Valid values:

  • Yes,Y,true
  • No,N,false (default)
N

allUnvTmpltChanges

Allow Universal Template ChangesAllow the promotion to contain new or changed Universal Templates.

Valid values:

  • Yes,Y,true
  • No,N,false (default)

Note

In order to promote Universal Template changes, the user must have the ops_universal_template_admin role or the ops_admin role.

N

Cancel a Scheduled Bundle Promotion

Cancel a Scheduled Bundle Promotion: URI Parameters

Parameter

Description

Specifications

Required

Mutually Exclusive With

scheduleid

UUID of the promotion schedule.


N

bundlename and bundleid

bundlename

Name of the bundle.


N

scheduleid and bundleid

bundleid

UUID of the bundle.


N

scheduleid and bundlename

date

Date when the promotion was scheduled.
 
Corresponds to the year, month, and day of the Scheduled Time field in a promotion schedule.

Format: yyyy-MM-dd (For example: 2018-11-14).

Y
(If bundlename or
bundleid is specified)


time

Time when the promotion was scheduled.
 
Corresponds to the hour and minutes of the Scheduled Time field in a promotion schedule.

Format: HH:mm (For example: 22:00).

Y
(If bundlename or
bundleid is specified)


Cancel a Scheduled Bundle Promotion: XML and JSON Examples

Examples

XML

JSON

Example Response

 XML
<command-response>
    <type>schedule_promotion</type>
    <success>true</success>
    <info></info>
    <errors></errors>
</command-response>

OR

<command-response>
    <type>schedule_promotion</type>
    <success>false</success>
    <info></info>
    <errors>The promotion schedule can only be cancelled while in a Scheduled status.</errors>
</command-response>
 JSON
{
    "type": "schedule_promotion",
    "success": true,
    "info": "",
    "errors": ""
}

OR

{
    "type": "schedule_promotion",
    "success": false,
    "info": "",
    "errors": "The promotion schedule can only be cancelled while in a Scheduled status."
}

Delete a Scheduled Bundle Promotion


Description

URI

http://host_name/uc/resources/promotion/schedule

HTTP Method

DELETE

Description

Deleted the scheduled promotion of a Bundle.

URI Parameters

See Delete a Scheduled Bundle Promotion: URI Parameters, below.

Example URI

Example Response

  • Status 200
    Promotion schedule deleted successfully.
  • Status 400
    One of parameters scheduleid, bundleid, or bundlename required.
  • Status 400
    Both date, and time parameters required when bundleid, or bundlename specified.
  • Status 400
    Unable to parse at least one of the date (yyyy-MM-dd) and time (HH:mm) parameters.
  • Status 403
    Operation prohibited due to security constraints.
  • Status 403
    Promotion Schedule cannot be deleted while Running.
  • Status 404
    Unable to find bundle by the bundlename specified.
  • Status 404
    More than one qualifying promotion schedule found.
  • Status 404
    Unable to find qualifying promotion schedule.

Delete a Scheduled Bundle Promotion: URI Parameters

Parameter

Description

Specifications

Required

Mutually Exclusive With

scheduleid

UUID of the promotion schedule.


N

bundlename and bundleid

bundlename

Name of the bundle.


N

scheduleid and bundleid

bundleid

UUID of the bundle.


N

scheduleid and bundlename

date

Date when the promotion was scheduled.
 
Corresponds to the year, month, and day of the Scheduled Time field in a promotion schedule.

Format: yyyy-MM-dd (For example: 2018-11-14).

Y
(If bundlename or
bundleid is specified)


time

Time when the promotion was scheduled.
 
Corresponds to the hour and minutes of the Scheduled Time field in a promotion schedule.

Format: HH:mm (For example: 22:00).

Y
(If bundlename or
bundleid is specified)



Promote a Bundle or Schedule a Bundle Promotion


Description

URI

http://host_name/uc/resources/bundle/promote

HTTP Method

POST

Description

Promote a Bundle or schedule the promotion of a Bundle.

Example URI

http://localhost:8080/uc/resources/bundle/promote

Authentication

HTTP Basic

Consumes Content-Type

application/xml, application/json

Produces Content-Type

application/xml, application/json

Example Request

See Schedule Bundle Promotion: XML and JSON Examples.

Request Properties

See Schedule Bundle Promotion: Properties.

Example Response

See Schedule Bundle Promotion: XML and JSON Examples.

Promote a Bundle or Schedule a Bundle Promotion: XML and JSON Examples

Examples

XML

JSON

Example Request

 XML
<bundle-promote>
   <id>a17c53a4975d4df59ddf4e6f1fb0b111</id>
   <promotionTargetName>testTarget</promotionTargetName>
   <overrideUser>testUser</overrideUser>
   <overridePassword>testPassword</overridePassword>
   <allowUnvTmpltChanges>true</allowUnvTmpltChanges>
   <schedule>true</schedule>
   <createSnapshot>true</createSnapshot>
   <date>2015-10-31</date>
   <time>22:00</time>
   <notificationOption>operation success</notificationOption>
</bundle-promote>


 JSON
{
   "id": "1bd5a9ae80714523a858633df3c515bf",
   "promotionTargetName": "testTarget",
   "overrideUser": "testUser",   
   "overridePassword": "testPassword1",
   "allowUnvTmpltChanges": true,
   "schedule": true,
   "createSnapshot": true,
   "date": "2018-01-04",
   "time": "23:00",
   "notificationOption": "operation success"
}

Example Response

 XML
<command-response>
   <type>schedule_promotion</type>
   <success>true</success>
   <info>Successfully scheduled the promotion of bundle "test" to promotion target "testTarget" for 2015-10-31 22:00:00 -0600.</info>
   <errors />
</command-response>
 JSON
{
"type": "schedule_promotion",
"success": true,
"info": "Successfully scheduled the promotion of bundle "abc" to promotion target "testTarget" for 2018-01-04 23:00:00 -0600.",
"errors": ""
}

Promote a Bundle or Schedule a Bundle Promotion: Properties

Property

UI Field Name

Description

Specifications

Required

Mutually Exclusive With

allowUnvTmpltChanges

Allow Universal Template Changes

Allow the promotion to contain new or changed Universal Templates.

Valid values:


  • Yes,Y,true
  • No,N,false


Note

In order to promote Universal Template changes, the user must have the ops_universal_template_admin role or the ops_admin role.

N


createSnapshot

Create Snapshot

Schedule the Bundle promotion using the current Bundle records.

Valid values:

  • Yes,Y,true
  • No,N,false

N


date

Date

Date on which to promote the Bundle.


Y
(if schedule
is Yes,Y,true);
format is
yyyy-MM-dd.


id

n/a

32-character sysid of the Bundle to be promoted.


Y
(unless name
is specified)

name

name

Bundle Name

Name of the Bundle to be promoted.


Y
(unless id
is specified)

id

notificationOption

System Notification

System Notification to send on success and/or failure of the promotion.

Valid values (not case sensitive):

  • operation Failure (default)
  • operation success/failure
  • operation success

N


overridePassword

Password

User password to use instead of the default User password for the promotion target.


Y
(if overrideUser
is specified)


overrideUser

User

User name to use instead of the default User name for the promotion target.


Y
(if overridePassword
is specified)


promotionTargetId

n/a

ID of the Controller cluster node on which to promote the Bundle.

Default is the Default Promotion Target of the specified Bundle.

N

promotionTargetName

promotionTargetName

Promotion Target

Name of the Controller cluster node on which to promote the Bundle.

Default is the Default Promotion Target of the specified Bundle.

N

promotionTargetId

schedule

Schedule

Indication of whether or not to schedule a Bundle promotion.

Valid values

  • Yes,Y,true
  • No,N,false.

Y


time

Time

Time on which to promote the Bundle.

Default is 00:00.

N


 
 

Create a Promotion Target


Description

URI

HTTP Method

POST

Description

Creates a Promotion Target.

Example URI

http://localhost:8080/uc/resources/promotiontarget
AuthenticationHTTP Basic

Consumes Content-Type

application/xml, application/json

Produces Content-Type

n/a

Example Request

See Create a Promotion Target: Example Request, below.

Properties

See Promotion Target Properties.

Example Response

  • Status 200 /OK
    Successfully created the promotion target with sysId 0b6e87e4aa4a410eb1b5875d8fe40985.

Create a Promotion Target: Example Request

Note

All of the mapping agents will be automatically mapped when you execute the Refresh Target Agent command, so the mapping agents included in the request will be ignored.

Examples

XML

JSON

Example Request

 XML
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<promotionTarget retainSysIds="true">
    <agentMappings/>        
    <name>test</name>
    <description/>
    <opswiseGroups>
        <opswiseGroup>bus-1</opswiseGroup>
        <opswiseGroup>bus-2</opswiseGroup>
    </opswiseGroups>
    <password>********</password>
    <sysId>ed76d6c78f06402d882e155bfd42b98f</sysId>
    <uri>http://localhost:7070/uc</uri>
    <user>ops.admin</user>
</promotionTarget>
 JSON
 {
    "agentMappings": [],
    "description": null,
    "name": "test",
    "opswiseGroups": [
        "bus-1",
        "bus-2"
    ],
    "password": "********",
    "retainSysIds": true,
    "sysId": "ed76d6c78f06402d882e155bfd42b98f",
    "uri": "http://localhost:7070/uc",
    "user": "ops.admin"
}

Promotion Target Properties

Property

UI Field Name

Description

Specifications

Required

agentMappings

n/a

List of agentMapping details associated with the Controller

agentMapping details

N

description

Description

Promotion Target description

String value of description

N

exportReleaseLevel

n/a

Universal Controller release that the record was exported from.

read onlyN

exportTable

n/aRecord table information.read onlyN

name

Name

Name for this Promotion Target.

String value of the promotion target name

Y

opswiseGroups

Member Of Business Services

List of Business Services that this task belongs to

String value

N

password

Password

Login password on the target cluster node of Universal Controller.

String value of password

N

retainSysIds

n/a

Specification for whether or not the Create a Promotion Target web service will persist the sysId property.

  • If retainSysIds="true" and sysId is included in the request/response, sysId will be persisted to the database.
  • If retainSysIds="false" and sysId is included in the request/response, sysId will be ignored; it will be autogenerated by the Controller.

Note

In XML web services, retainSysIds is specified as an attribute in the <script> element.

Valid values: true/false (default is true).

N

sourceAgents

Source Agent

List of source agent names.

List of source agent names.

N

sysId

n/a

System ID field in the database for this Prommotion Target record.

Persisted only if retainSysIds is set to true.

N

targetAgent

Target Agent

Target agent name.

String value of the target agent name.

Y

type

Type

Agent type.

String value of agent type.

(For example, Windows)

Y

uri

URI

Uniform Resource Identifier (URI) used to locate the Promotion Target cluster node.

String value uri.

Y

user

User

Login ID on the target cluster node of Universal Controller.

String value of user.

N

Modify a Promotion Target

Modify a Promotion Target is used for updating the promotion target details and source agent details of the mapping agent details.

You can map multiple source agents to a specific target agent, but you cannot add the same source agents for more than one target agent.


Description

URI

HTTP Method

PUT

Description

Updates a Promotion Target.

Example URI

http://localhost:8080/uc/resources/promotiontarget
AuthenticationHTTP Basic

Consumes Content-Type

application/xml, application/json

Produces Content-Type

n/a

Example Request

See Modify a Promoition Target: Example Request, below.

Properties

See Promotion Target Properties.

Example Response

  • Status 200 /OK
    Successfully updated the promotion target with sysId 0b6e87e4aa4a410eb1b5875d8fe40985.

Modify a Promotion Target: Example Request

Examples

XML

JSON

Example Request

 XML
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<promotionTarget retainSysIds="true">
    <agentMappings>
       
<agentMapping> <sourceAgents> <sourceAgent>SBUS30 - AGNT0005</sourceAgent> </sourceAgents> <targetAgent>SBUS30 - AGNT0005</targetAgent> <type>Windows</type> </agentMapping>
   <agentMappings>
  <name>test</name>
<description/>
<opswiseGroups>
<opswiseGroup>bus-1</opswiseGroup>
<opswiseGroup>bus-2</opswiseGroup>
</opswiseGroups>
<password>********</password>
<sysId>ed76d6c78f06402d882e155bfd42b98f</sysId>
<uri>http://localhost:7070/uc</uri>
<user>ops.admin</user>
</promotionTarget>
 JSON
 {
    "agentMappings": [
        {
            "sourceAgents": [
                "SBUS30 - AGNT0005"
            ],
            "targetAgent": "SBUS30 - AGNT0005",
            "type": "Windows"
        }
    ],
   
"description": null,
"name": "test",
"opswiseGroups": [
"bus-1",
"bus-2"
],
"password": "********",
"retainSysIds": true,
"sysId": "ed76d6c78f06402d882e155bfd42b98f",
"uri": "http://localhost:7070/uc",
"user": "ops.admin"
}

List Promotion Targets

List Promotion Targets allows the retrieval of promotion target details based on provided search criteria.

List Promotion Targets: URI Parameters

Property

UI Field Name

Description

Specifications

Required

targetname

N/A

Request parameter targetname

String value of the target name.

Wildcards are supported.

N

businessServices

N/A

Request parameter businessServices.

String value of the business service

N

List Promotion Targets: Example Response

The exportReleaseLevel and exportTable properties are specified as attributes in XML.

Examples

XML

JSON

Example Response

 XML
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<promotionTargets> <promotionTarget exportReleaseLevel="7.2.0.0" exportTable="ops_promotion_target" retainSysIds="true"> <agentMappings>
       
<agentMapping> <sourceAgents> <sourceAgent>SBUS30 - AGNT0005</sourceAgent> </sourceAgents> <targetAgent>SBUS30 - AGNT0005</targetAgent> <type>Windows</type> </agentMapping>
<agentMappings>
   
<name>test</name>
<description/>
<opswiseGroups>
<opswiseGroup>bus-1</opswiseGroup>
<opswiseGroup>bus-2</opswiseGroup>
</opswiseGroups>
<sysId>ed76d6c78f06402d882e155bfd42b98f</sysId>
<uri>http://localhost:7070/uc</uri>
<user>ops.admin</user>
</promotionTarget>
<promotionTarget exportReleaseLevel="7.2.0.0" exportTable="ops_promotion_target" retainSysIds="true"> <agentMappings />
   <name>test</name>
<description/>
<opswiseGroups>
<opswiseGroup>bus-1</opswiseGroup>
<opswiseGroup>bus-2</opswiseGroup>
</opswiseGroups>
<sysId>ed76d6c78f06402d882e155bfd42b98f</sysId>
<uri>http://localhost:7070/uc</uri>
<user>ops.admin</user>
</promotionTarget>
</promotionTargets>
 JSON
 {
    "agentMappings": [
        {
            "sourceAgents": [
                "SBUS30 - AGNT0005"
            ],
            "targetAgent": "SBUS30 - AGNT0005",
            "type": "Windows"
        }
    ],
   
"description": null,
"exportReleaseLevel": "7.2.0.0",
"exportTable": "ops_promotion_target"
"name": "test",
"opswiseGroups": [
"bus-1",
"bus-2"
],
"retainSysIds": true,
"sysId": "ed76d6c78f06402d882e155bfd42b98f",
"uri": "http://localhost:7070/uc",
"user": "ops.admin"
},
{
    "agentMappings": [],
    "description": null, 
"exportReleaseLevel": "7.2.0.0",
"exportTable": "ops_promotion_target"
"name": "test",
"opswiseGroups": [
"bus-2"
],
"retainSysIds": true,
"sysId": "ed76d6c78f06402d882e155bfd42b98f",
"uri": "http://localhost:7070/uc",
"user": "ops.admin"

Delete a Promotion Target

Delete a Promotion Target allows the deletion of a specified promotion target.


Description

URI

http://host_name/uc/resources/promotiontarget/

HTTP Method

DELETE

Description

Delete a specified Promotion Target.

URI Parameters

See Delete a Promotion Target: URI Parameters, below.

Example URI

http://localhost:8080/uc/resources/promotiontarget?targetname=test

http://localhost:8080/uc/resources/promotiontarget?targetid=ed76d6c78f06402d882e155bfd42b98f

AuthenticationHTTP Basic

Consumes Content-Type

n/a

Produces Content-Type

text/plain

Properties

See Promotion Target Properties.

Example Response

  • Status 200 /OK
    Promotion target deleted successfully.

Delete Promotion Target: URI Parameters

Property

UI Field Name

Description

Specifications

Required

Mutually Exclusive

targetname

n/a

Request parameter targetname.

String value of the promotion target name

Y
(unless targetid
is specified)

targetid

targetid

n/a

Request parameter targetid.

String value of the promotion target sysId

Y
(unless targetname
is specified)

targetname

Read a Promotion Target

Read a Promotion Target allows the reading of promotion target details based on a specified targetid or targetname.


Description

URI

http://host_name/uc/resources/promotiontarget/

HTTP Method

GET

Description

Retrieve a specified Promotion Target details.

URI Parameters

See Read a Promotion Target: URI Parameters, below.

Example URI

http://localhost:8080/uc/resources/promotiontarget?targetname=test

http://localhost:8080/uc/resources/promotiontarget?targetid=ed76d6c78f06402d882e155bfd42b98f

AuthenticationHTTP Basic

Consumes Content-Type

n/a

Produces Content-Type

application/xml, application/json

Example Response

See Read a Promoition Target: Example Response, below.

Response Properties

See Promotion Target Properties.

Read a Promotion Target: URI Parameters

Property

UI Field Name

Description

Specifications

Required

Mutually Exclusive

targetname

n/a

Request parameter targetname.

String value of the promotion target name

Y
(unless targetid
is specified)

targetid

targetid

n/a

Request parameter targetid.

String value of the promotion target sysId

Y
(unless targetname
is specified)

targetname

Read a Promotion Target: Example Response

The exportReleaseLevel and exportTable properties are specified as attributes in XML.

Examples

XML

JSON

Example Request

 XML
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<promotionTarget exportReleaseLevel="7.2.0.0" exportTable="ops_promotion_target" retainSysIds="true">
    <agentMappings>
       
<agentMapping> <sourceAgents> <sourceAgent>SBUS30 - AGNT0005</sourceAgent> </sourceAgents> <targetAgent>SBUS30 - AGNT0005</targetAgent> <type>Windows</type> </agentMapping>
   <agentMappings>
  <name>test</name>
<description/>
<opswiseGroups>
<opswiseGroup>bus-1</opswiseGroup>
<opswiseGroup>bus-2</opswiseGroup>
</opswiseGroups>
<sysId>ed76d6c78f06402d882e155bfd42b98f</sysId>
<uri>http://localhost:7070/uc</uri>
<user>ops.admin</user>
</promotionTarget>
 JSON
 {
    "agentMappings": [
        {
            "sourceAgents": [
                "SBUS30 - AGNT0005"
            ],
            "targetAgent": "SBUS30 - AGNT0005",
            "type": "Windows"
        }
    ],
   
"description": null,
"exportReleaseLevel": "7.2.0.0",
"exportTable": "ops_promotion_target"
"name": "test",
"opswiseGroups": [
"bus-1",
"bus-2"
],
"retainSysIds": true,
"sysId": "ed76d6c78f06402d882e155bfd42b98f",
"uri": "http://localhost:7070/uc",
"user": "ops.admin"
}

Refresh Target Agents

Refresh Promotion Target Agents allows the refreshing of the target Controller agents mapped to the promotion target.


Description

URI

HTTP Method

POST

Description

Refresh the target agents for a specified Promotion Target.

URI Parameters

See Refresh Target Agents: URI Parameters, below.

Example URI

AuthenticationHTTP Basic

Consumes Content-Type

n/a

Produces Content-Type

application/xml, application/json

Example Response

Successfully refreshed target agents for test-1

Refresh Target Agents: URI Parameters

Property

Description

Specifications

Required

Mutually Exclusive

targetname

Name for this Promotion Target.

String value of the promotion target name passed as query parameter.

Y
(unless targetid
is specified)

targetid

targetid

Promotion Target sysId.

String value of the promotion target sysId passed as query parameter.

Y
(unless targetname
is specified)

targetname

username

Override Login ID on the target cluster node of Universal Controller.

String value of user, passed as request body.

N


password

Override Login password on the target cluster node of Universal Controller.

String value of password, passed as request body.

N


Refresh Target Agents: Example Request

Examples

XML

JSON

Example Request

 XML

<overrideUser>
    <username>test-1</username>
    <password>test</password>
</overrideUser>
 JSON

{    
    "password": "1234",
    "username": "ops.admin"
}