...

Panel

Table of Contents

maxlevel	1

...

XML Request

JSON Request

Expand

title	XML Request

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

Expand

title	JSON Request

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

...

XML Request

JSON Request

Expand

title	XML Request

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

Expand

title	JSON Request

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

...

XML Response

JSON Response

Expand

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

Expand

title	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",
  }

Anchor
Modify a Bundle
Modify a Bundle
Modify a Bundle

...

XML Response

JSON Response

Expand

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

Expand

title	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",
  
 ]   }

Anchor
Promotion
Promotion
Promotion

...

Property

UI Field Name

Description

Specifications

Required

Mutually Exclusive With

Anchor

	itemType - promo
	itemType - promo

itemType

n/a

Item 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

Anchor

	itemIds - promo
	itemIds - promo

itemIds

n/a

IDs for promotion items.

Comma-separated list of promotion item IDs.

Y
(unless itemNames
is specified)

itemNames

Anchor

	itemNames - promo
	itemNames - promo

itemNames

n/a

Names for promotion items.

Comma-separated list of promotion item names.

Y
(unless itemIds
is specified)

itemIds

Anchor

	promotionTargetId - promo
	promotionTargetId - promo

promotionTargetId

n/a

ID of the Promotion Target.

Y
(unless promotionTargetName
is specified)

promotionTargetName

Anchor

	promotionTargetName - promo
	promotionTargetName - promo

promotionTargetName

Promotion Target

Name of the Promotion Target.

Y
(unless promotionTargetId
is specified)

promotionTargetId

Anchor

	overrideUser - promo
	overrideUser - promo

overrideUser

User

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

Y
(if overridePassword
is specified)

Anchor

	overridePassword - promo
	overridePassword - promo

overridePassword

Password

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

Y
(if overrideUser
is specified)

Anchor

	excluseOnExistence - promo
	excluseOnExistence - promo

excludeOnExistence

Exclude On Existence

Item 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

Anchor

	followReferences - promo
	followReferences - promo

followReferences

Follow References

Dynamically include items in the promotion that are referenced by promotion items.

Valid values:

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

N

Anchor

	allUnvTmpltChanges - promo
	allUnvTmpltChanges - promo

allUnvTmpltChanges

Allow Universal Template Changes

Allow the promotion to contain new or changed Universal Templates.

Valid values:

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

Note

title	Note

In order to promote Universal Template changes, the user must have theops_universal_template_admin role or the ops_adminrole.

N

Anchor
Cancel a Scheduled Bundle Promotion
Cancel a Scheduled Bundle Promotion
Cancel a Scheduled Bundle Promotion

...

Property

UI Field Name

Description

Specifications

Required

Mutually Exclusive With

Anchor

	allowUnvTmpltChanges - SBC
	allowUnvTmpltChanges - SBC

allowUnvTmpltChanges

Allow Universal Template Changes

Allow the promotion to contain new or changed Universal Templates.

Valid values:

Yes,Y,true
No,N,false

Note

title	Note

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

N

Anchor

	createSnapshot - SBC
	createSnapshot - SBC

createSnapshot

Create Snapshot

Schedule the Bundle promotion using the current Bundle records.

Valid values:

Yes,Y,true
No,N,false

N

Anchor

	date - SBC
	date - SBC

date

Date

Date on which to promote the Bundle.

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

Anchor

	id - SBC
	id - SBC

id

n/a

32-character sysid of the Bundle to be promoted.

Y
(unless name
is specified)

name

Anchor

	name - SBC
	name - SBC

name

Bundle Name

Name of the Bundle to be promoted.

Y
(unless id
is specified)

id

Anchor

	notificationOption - SBC
	notificationOption - SBC

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

Anchor

	overridePassword - SBC
	overridePassword - SBC

overridePassword

Password

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

Y
(if overrideUser
is specified)

Anchor

	overrideUser - SBC
	overrideUser - SBC

overrideUser

User

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

Y
(if overridePassword
is specified)

Anchor

	promotionTargetId - SBC
	promotionTargetId - SBC

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

Anchor

	promotionTargetName - SBC
	promotionTargetName - SBC

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

Anchor

	schedule - SBC
	schedule - SBC

schedule

Schedule

Indication of whether or not to schedule a Bundle promotion.

Valid values

Yes,Y,true
No,N,false.

Y

Anchor

	time - SBC
	time - SBC

time

Time

Time on which to promote the Bundle.

Default is 00:00.

N

...

Examples

XML

JSON

Example Request

Expand

title	XML

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

Expand

title	JSON

 {
    "agentMappings": [],
    "description": null,
    "name": "test",
    "opswiseGroups": [
        "bus-1",
        "bus-2"
    ],
    "password": "********",
    "retainSysIds": true,
    "sysId": "ed76d6c78f06402d882e155bfd42b98f",
    "uri": "http://localhost:7070/uc",
    "user": "ops.admin"
}

...

Property

UI Field Name

Description

Specifications

Required

Anchor

	agentMappings - PT
	agentMappings - PT

agentMappings

n/a

List of agentMapping details associated with the Controller

agentMapping details

N

Anchor

	description - PT
	description - PT

description

Description

Promotion Target description

String value of description

N

Anchor

	exportReleaseLevel - PT
	exportReleaseLevel - PT

exportReleaseLevel

n/a

Universal Controller release that the record was exported from.

read only

N

Anchor

	exportTable - PT
	exportTable - PT

exportTable

n/a

Record table information.

read only

N

Anchor

	name - PT
	name - PT

name

Name

Name for this Promotion Target.

String value of the promotion target name

Y

Anchor

	opswiseGroups - PT
	opswiseGroups - PT

opswiseGroups

Member Of Business Services

List of Business Services that this task belongs to

String value

N

Anchor

	password - PT
	password - PT

password

Password

Login password on the target cluster node of Universal Controller.

String value of password

N

Anchor

	retainSysIds - PT
	retainSysIds - PT

retainSysIds

n/a

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

Note

title	Note

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

Valid values: true/false (

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

title	Note

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

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

N

Anchor

	sourceAgents - PT
	sourceAgents - PT

sourceAgents

Source Agent

List of source agent names.

N

Anchor

	sysId - PT
	sysId - PT

sysId

n/a

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

Persisted only if retainSysIds is set to true.

N

Anchor

	targetAgent - PT
	targetAgent - PT

targetAgent

Target Agent

Target agent name.

String value of the target agent name.

Y

Anchor

	type - PT
	type - PT

type

Type

Agent type.

String value of agent type.

(For example, Windows)

Y

Anchor

	uri - PT
	uri - PT

uri

URI

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

String value uri.

Y

Anchor

	user - PT
	user - PT

user

User

Login ID on the target cluster node of Universal Controller.

String value of user.

N

...

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

Anchor
List Promotion Targets Example Response
List Promotion Targets Example Response
List Promotion Targets: Example Response

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

Examples

XML

JSON

Example Response

Expand

title	XML

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<promotionTargets>
  <promotionTarget exportReleaseLevel="7.2.0.0" exportTable="ops_bundlepromotion_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> 
    <password>********</password> 
    <sysId>ed76d6c78f06402d882e155bfd42b98f</sysId> 
    <uri>http://localhost:7070/uc</uri> 
    <user>ops.admin</user> 
  </promotionTarget>
  <promotionTarget exportReleaseLevel="7.2.0.0" exportTable="ops_bundlepromotion_target" 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>
</promotionTargets>

Expand

title	JSON

 {
    "agentMappings": [

        {
            "sourceAgents": [
                "SBUS30 - AGNT0005"
            ],
            "targetAgent": "SBUS30 - AGNT0005",
            "type": "Windows"
        }
    ],
    "description": null, 
    "nameexportReleaseLevel": "test7.2.0.0", 
    "opswiseGroupsexportTable": [ "ops_promotion_target"
       "bus-1", "name": "test", 
    "opswiseGroups": [ 
       "bus-21", 
     ],  "bus-2" 
    "password": "********"], 
    "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" 
    ], 
    "password": "********", 
    "retainSysIds": true, 
    "sysId": "ed76d6c78f06402d882e155bfd42b98f", 
    "uri": "http://localhost:7070/uc", 
    "user": "ops.admin"

...

Anchor
Read a Promotion Target Example Response
Read a Promotion Target Example Response
Read a Promotion Target: Example Response

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

Examples

XML

JSON

Example Request

Expand

title	XML

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<promotionTarget exportReleaseLevel="7.2.0.0" exportTable="ops_bundlepromotion_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> 
    <password>********</password> 
    <sysId>ed76d6c78f06402d882e155bfd42b98f</sysId> 
    <uri>http://localhost:7070/uc</uri> 
    <user>ops.admin</user> 
</promotionTarget>

Expand

title	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" 
    ], 
    "password": "********", 
    "retainSysIds": true, 
    "sysId": "ed76d6c78f06402d882e155bfd42b98f", 
    "uri": "http://localhost:7070/uc", 
    "user": "ops.admin" 
}

...

Versions Compared

Old Version 10

New Version Current

Key

Anchor
Modify a Bundle
Modify a Bundle
Modify a Bundle

Anchor
Promotion
Promotion
Promotion

Anchor
Cancel a Scheduled Bundle Promotion
Cancel a Scheduled Bundle Promotion
Cancel a Scheduled Bundle Promotion

Anchor
List Promotion Targets Example Response
List Promotion Targets Example Response
List Promotion Targets: Example Response

Anchor
Read a Promotion Target Example Response
Read a Promotion Target Example Response
Read a Promotion Target: Example Response

Page Comparison

Versions Compared

Old Version 10

New Version Current

Key

AnchorModify a BundleModify a BundleModify a Bundle

AnchorPromotionPromotionPromotion

AnchorCancel a Scheduled Bundle PromotionCancel a Scheduled Bundle PromotionCancel a Scheduled Bundle Promotion

AnchorList Promotion Targets Example ResponseList Promotion Targets Example ResponseList Promotion Targets: Example Response

AnchorRead a Promotion Target Example ResponseRead a Promotion Target Example ResponseRead a Promotion Target: Example Response

Anchor
Modify a Bundle
Modify a Bundle
Modify a Bundle

Anchor
Promotion
Promotion
Promotion

Anchor
Cancel a Scheduled Bundle Promotion
Cancel a Scheduled Bundle Promotion
Cancel a Scheduled Bundle Promotion

Anchor
List Promotion Targets Example Response
List Promotion Targets Example Response
List Promotion Targets: Example Response

Anchor
Read a Promotion Target Example Response
Read a Promotion Target Example Response
Read a Promotion Target: Example Response