Submitting a Task Sequence / OSD Request
App Broker 2020 R1
This section describes the App Broker REST API endpoint to submit a task sequence/OSD request to App Portal..
|
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:
|
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:
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 2020 R1 Administration GuideAugust 2020 |