Page Comparison

Panel

Table of Contents

maxlevel	1

...

	Description
URI	http://host_name/uc/resources/bundle
HTTP Method	POST
Description	Creates a Bundle.
Example URI	http://localhost:8080/uc/resources/bundle
Authentication	HTTP 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.

...

	Description
URI	http://host_name/uc/resources/bundle/bybusinessservices
HTTP Method	POST
Description	Creates a Bundle.
Example URI	http://localhost:8080/uc/resources/bundle/bybusinessservices
Authentication	HTTP 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).

...

	Description
URI	http://host_name/uc/resources/bundle/bydate
HTTP Method	POST
Description	Creates a Bundle.
Example URI	http://localhost:8080/uc/resources/bundle/bydate
Authentication	HTTP 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).

...

	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	http://localhost:8080/uc/resources/bundle?bundleid=f87848b00a0001037f43e7c81c8ec969 http://localhost:8080/uc/resources/bundle?bundlename=testbundle
Example Response	Status 200 /OK Bundle deleted successfully.

...

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
Report
Widget
Dashboard

Y

Anchor

	itemIds - promo
	itemIds - promo

itemIds

n/a

IDs for promotion items.

Comma-separated list of promotion item IDs.

Y
(unless itemNames or items is specified)

itemNames

items

Anchor

	itemNames - promo
	itemNames - promo

itemNames

n/a

Names for promotion items.

Comma-separated list of promotion item names.

Y
(unless itemIds or items is specified)

itemIds

items

n/a

List of promotion items.

XML:

Code Block

language	text

    <items>
        <item>
            <name>reportTitle1</name>
        </item>  
         <item>
            <name>reportTitle2</name>
            <user>userName</user>
        </item>
        <item>
            <name>reportTitle3</name>
            <group>groupName</group>
        </item>                  
    </items>

JSON:

Code Block

language	text

  "items": [
        {
            "name": "reportTitle1"
        },  
        {
            "name": "reportTitle1",
            "user": "username",
            "group": ""
        },
        {
            "name": "reportTitle2",
            "user": null,
            "group": "group2"
        }
    ]

Y

(unless itemIds
or itemNames is specified)

itemIds

itemNames

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)

overrideToken

Personal Access Token

Personal Access Token to use instead of the default personal access token for the Promotion Target.

If both overrideToken and overrideUser+overridePassword are specified, overrideToken takes precedence and overrideUser+overidePassword will be ignored.

N

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
As String = Reports, As Value = 262144
As String = Widgets, As Value = 524288

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 the ops_universal_template_admin role or the ops_adminrole.

N

Anchor

	Items Properties
	Items Properties

...

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)

...

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)

...

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)

overrideToken

Personal Access Token

Personal Access Token to use instead of the default personal access token for the Promotion Target.

If both overrideToken and overrideUser+overridePassword are specified, overrideToken takes precedence and overrideUser+overidePassword will be ignored.

N

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

...

	Description
URI	http://host_name/uc/resources/promotiontarget
HTTP Method	POST
Description	Creates a Promotion Target.
Example URI	http://localhost:8080/uc/resources/promotiontarget
Authentication	HTTP 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.

...

	Description
URI	http://host_name/uc/resources/promotiontarget
HTTP Method	PUT
Description	Updates a Promotion Target.
Example URI	http://localhost:8080/uc/resources/promotiontarget
Authentication	HTTP 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.

...

	Description
URI	http://host_name/uc/resources/promotiontarget/list
HTTP Method	GET
Description	Retrieve Promotion Target details.
URI Parameters	See List Promotion Targets: URI Parameters, below.
Example URI	http://localhost:8080/uc/resources/promotiontarget/list?targetname=test http://localhost:8080/uc/resources/promotiontarget/list?targetname=* http://localhost:8080/uc/resources/promotiontarget/list?targetname=local&businessServies=bus-1,bus-2
Authentication	HTTP Basic
Consumes Content-Type	n/a
Produces Content-Type	application/xml, application/json
Example Respone	See List Promoition Targets: Example Response, below.
Response Properties	See Promotion Target Properties.

...

	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
Authentication	HTTP 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.

...

	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
Authentication	HTTP 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.

...

	Description
URI	http://host_name/uc/resources/promotiontarget/refreshtargetagents
HTTP Method	POST
Description	Refresh the target agents for a specified Promotion Target.
URI Parameters	See Refresh Target Agents: URI Parameters, below.
Example URI	http://localhost:8080/uc/resources/promotionTarget/refreshtargetagents?targetname=test http://localhost:8080/uc/resources/promotionTarget/refreshtargetagents?targetid=ed76d6c78f06402d882e155bfd42b98f
Authentication	HTTP Basic
Consumes Content-Type	n/a
Produces Content-Type	application/xml, application/json
Example Response	Successfully refreshed target agents for test-1

...

Versions Compared

Old Version 1

New Version 2

Key