/mgmt/status/default/FirmwareVersion3 GET

Use the HTTP GET method with the /mgmt/status/default/FirmwareVersion3 resource to list the version of the firmware and its components as well as the machine and model type for the appliance.

Resource URL

https://host:port/mgmt/status/default/FirmwareVersion3
Where port is 5554 by default.

Request headers

The following header must be sent with the request:
Authorization
This header must be sent to perform authentication.

Request body format

None.

Security requirements

The caller must be authenticated as an appliance user with sufficient authority. For more information about security, see Types of user and how they are authenticated and User authorization, credential mapping, and access profiles.

Response status codes

200
Status information retrieved successfully.
400
Invalid data provided.
401
Not authenticated.
The caller must be authenticated as an appliance user. See Types of user and how they are authenticated for more information.
403
Not authorized.
The caller is authenticated but does not the authority to perform this action. See User authorization, credential mapping, and access profiles for more information.

Response headers

Content-Type
This header is returned with a value of application/json.

Response body format

The response is in JSON format. The response includes information about the current firmware version. Each object contains the following fields:
Serial
String.
The serial number of the appliance. This number is unique to each appliance.
Version
String.
The version of this firmware image
Level
String.
The level of the firmware.
Build
String.
The specific build of this firmware image.
BuildDate
String.
Date of the firmware build.
DeliveryType
String.
Indicates the delivery type.
  • LTS Long-term support (LTS) releases are intended for customers who demand the highest level of stability. Updates during the support period contain fixes to identified problems and vulnerabilities.
  • CD Continuous delivery (CD) releases add new function on a regular cadence and are intended for customers who want to exploit the latest features and capabilities without waiting for the next LTS release. Each CD release contains fixes to identified problems and vulnerabilities.
WatchdogBuild
String.
The build number of the system health monitor.
InstalledDPOS
String.
The version number of the appliance manager.
RunningDPOS
String.
The version number of the appliance manager.
XMLAccelerator
String.
MachineType
String.
The IBM machine type of the appliance.
ModelType
String.
The IBM model type of the appliance.
Tenant
String.
not used

Examples

The following example requests information about the appliance firmware.

The following URL is used with the HTTP GET method:
https://localhost:5554/mgmt/status/default/FirmwareVersion3
The following listing shows sections from the received response:
{
  "_links": {
    "self": {
      "href": "/mgmt/status/default/FirmwareVersion3"
    },
    "doc": {
      "href": "/mgmt/docs/status/FirmwareVersion3"
    }
  },
  "FirmwareVersion3": {
    "Serial": "1300014",
    "Version": "MQ00.9.1.2.0",
    "Level": "p912-L190305",
    "Build": "306735mq",
    "BuildDate": "2019/02/27 12:09:32",
    "DeliveryType": "CD",
    "WatchdogBuild": "MQ00.9.1.2.0",
    "InstalledDPOS": "MQ00.9.1.2.0",
    "RunningDPOS": "MQ00.9.1.2.0",
    "XMLAccelerator": "embedded",
    "MachineType": "8441",
    "ModelType": "54X",
    "Tenant": ""
  }
}