IBM DataPower Operations Dashboard v1.0.8.5
Note: A more recent version of DPOD is available. See IBM DPOD Documentation for the latest documentation.
Appliance Firmware Upgrade REST API
Prerequisites
Requires admin or operator access.
Unauthorized requests will receive a "401 Unauthorized" response.
Send a firmware upgrade plan to the execution queue:
POST /op/api/v1/firmwareupgradeplan/<API-Reference>/execute
The API-Reference of the plan is set in the add/edit plan page, and can be viewed in the plan details page
Successful Response
{
"resultCode": "SUCCESS",
"resultErrorCode": "SUCCESS",
"resultMessage": "Firmware upgrade plan added to execution queue"
}
Error Response
{
"resultCode": "ERROR",
"resultErrorCode": "PLAN_NOT_FOUND",
"resultMessage": "Firmware upgrade plan with API Ref 199da450-7add-42fd-b644-986cfc018f32 was not found"
}
This API call does NOT execute the plan, it just adds it to the execution queue.
The plan may not be executed at all. (For example - when the current time is not within the plan's maintenance window timeframe, or if the plan is not enabled)
Get All Available Plans
GET /op/api/v1/firmwareupgradeplan/
The lastUpdateTime field returns the last time the plan was updated in epoch time format.
{
"plans": [
{
"name": "My Plan 1",
"description": "Just a test plan",
"URI": "/op/api/v1/firmwareupgradeplan/075D3780-4D79-4AFE-A749-817A3640C9E7",
"lastUpdateTime": 1513583334112
},
{
"name": "My Plan 2",
"description": "",
"URI": "/op/api/v1/firmwareupgradeplan/F44E875F-C7B5-4CC5-830B-0A9E39A005E5",
"lastUpdateTime": 1512052896724
}
]
}