Service Manager
This is the latest version of the help for Ivanti Service Manager 2018. If you cannot find some of the features described in the help, you may be using an older version of the application. To upgrade the application, click here.To view the help for the latest version of Service Manager, click here
Update a Business Object
Here is an example to update a change, problem, incident, or any other business object.
URL |
|
Method |
PUT/PATCH |
Header Name | Authorization : Sessionkey |
Status Code |
200 |
Response |
{
} |
Empty Request Body (Update)
Scenario: When updating a business object instance with a proper key, an empty request body is passed.
Example:
https://tatnet.ivanti.com/api/odata/businessobject/alerts(‘05B5CD2DFAE54D86A04C74DBF616C1DE ‘)
Header Name:
Authorization: Authentication token
HTTP PUT/PATCH |
Request payload is : |
Code |
ISM_4000 |
Description | Invalid Request Payload |
Message |
[ "Message body cannot be empty" ], |
HTTP STATUS CODE |
400 |
Empty Object ID
Scenario: To update an incident, the object ID provided is empty or a white space.
Example:
https://tatnet.ivanti.com/api/odata/businessobject/alerts(‘ ‘)
Header Name:
Authorization: Authentication token
HTTP PUT/PATCH |
|
Code |
ISM_4000 |
Description | Invalid Request Payload |
Message |
[ "Invalid Business Object Key" ], |
HTTP STATUS CODE |
400 |
Invalid Object ID
Scenario: When updating an incident, the object ID provided is invalid.
Examples:
https://tatnet.ivanti.com/api/odata/businessobject/alerts(‘1234‘)
https://tatnet.ivanti.com/api/odata/businessobject/alerts(‘random‘)
Header Name:
Authorization: Authentication token
Code |
ISM_4000 |
Description | Invalid Request Payload |
Message |
[ "Record '1234' cannot be found in the business object 'alert'" ], |
HTTP STATUS CODE |
400 |
Key Value Pair Does Not Exist
Scenario: When updating a valid business object instance with a proper key, an invalid request body or key value pair is provided, which are not part of business object field definition.
Example:
https://tatnet.ivanti.com/api/odata/businessobject/alerts(‘05B5CD2DFAE54D86A04C74DBF616C1DE ‘)
Header Name:
Authorization: Authentication token
HTTP PUT/PATCH |
Request payload is : {"name": "test"} |
Code |
ISM_4000 |
Description | Invalid Request Payload |
Message |
[ "Field 'name' does not exist in the business object 'Incident#'" ], |
HTTP STATUS CODE |
400 |
Unhandled Exception
Scenario: When updating a valid business object instance with a proper key and valid request body, but for some reason unhandled code is provided and if it fails to update.
Header Name:
Authorization: Authentication token
HTTP PUT/PATCH |
|
Code |
ISM_5000 |
Description | Internal server error |
Message |
[ "The server encountered an internal error. Please retry the request." ], |
HTTP STATUS CODE |
500 |
Was this article useful?
The topic was:
Inaccurate
Incomplete
Not what I expected
Other
Copyright © 2018, Ivanti. All rights reserved.