Submitting a Task Sequence / OSD Request

App Broker 2017

This section describes the App Broker REST API endpoint to submit a task sequence/OSD request to App Portal..

Submitting a Task Sequence / OSD Request
Endpoint Example	Response Body Example
[POST] http://<SERVERNAME>/esd/api/servicenow/requests/SN1001?dn=appportal&un=spatel&dev= itaapccnet01	{ "requestId":"0", "appPortalOrder": { "targets": [ { "uniqueUserName":"APPPORTAL\\spatel", "machineName":"NuMacSat01", "catalogs": [ { "id":14, "reservationId":0 } ] } ], "RolesAndApps": [ { "RoleId":"1", "MigrationType":"1", "CatalogIdsSelectedForMigrateAndInstall": "1,2,3", "ProcessBothInserts":"true", "CreateAssociation":"false", "OldMachineName":"chedev01", "OsdBuildId":"xyztxt", "MacAddr":"12:34:56:78:98:76" } ] } }

Input Parameter Details

The following are the details for the parameters listed in the Request Body Example:

Input Parameter Details of Request Body Example

Parameter

Description

RequestId

Can be any string.

UniqueUserName

Unique name for the target user.

Machine

Target machine where the task sequence / OSD should be deployed.

Catalogs

The catalog item for which the request is being made.

RoleId

The role that is applicable to the target user.

MigrationType

Possible values are:

•

1—In-place migration

•

2—Side by side migration

•

3—No data migration

Note • Option 3, no data migration, is already handled in different scenarios from Employee App Provisioning in ServiceNow.

CatalogIdsSelectedForMigrateAndInstall

IDs of catalog items that are part of role, selected as part of migratable apps and additional apps.

ProcessBothInserts

Insert both source machine and target machine into collection.

CreateAssociation

Create association between source and target computers.

OldMachineName

Name of the old or source computer.

OsdBuildId

Build ID with 6-character-long string

MacAddr

MAC address of the target computer.

Output Details

The output gives HTTP status 200.

App Portal / App Broker 2017 Administration Guide