7.1.37 Version information acquisition API
This API acquires product version information.
Use this API to determine the product version of JP1/AJS3 - Web Console when you specify the APIs or parameters in the list below. For details, see the description of the relevant API or parameter.
|
API or parameter |
Relevant section |
|---|---|
|
The following parameter of the unit list acquisition API:
|
|
|
Unit information acquisition API |
|
|
The following parameter of the unit information acquisition API:
|
|
|
Wait condition status list acquisition API |
|
|
The following parameter of the planned execution registration API:
|
|
|
The following parameters of the fixed execution registration API:
|
|
|
The following parameters of the registration cancellation API:
|
|
|
Change delay monitor API |
|
|
Change job status API |
|
|
Change plan (change time) API |
|
|
The following parameters of the change plan (change time) API:
|
|
|
Change plan (execute immediately) API |
|
|
Change plan (execution prohibited) API |
|
|
Change plan (release change) API |
|
|
Interrupt API |
|
|
Kill API |
|
|
Rerun API |
|
|
Wait status change API |
|
|
Execution order control method change API |
|
|
Execution agent status list acquisition API |
|
|
Execution agent status acquisition API |
|
|
Execution agent definition acquisition API |
|
|
Execution agent addition API |
|
|
Execution agent deletion API |
|
|
Execution agent reconfiguration API |
|
|
API to change the job transfer restriction status of an execution agent |
7.1.27 API to change the job transfer restriction status of an execution agent |
|
Execution agent status change API |
|
|
API to check the communication status of the job distribution delay reduction function |
7.1.29 API to check the communication status of the job distribution delay reduction function |
|
Execution agent group status list acquisition API |
|
|
Execution agent group definition acquisition API |
|
|
Execution agent group addition API |
|
|
Execution agent group deletion API |
|
|
Execution agent group reconfiguration API |
|
|
API to change the job transfer restriction status of an execution agent group |
7.1.35 API to change the job transfer restriction status of an execution agent group |
|
API to exclude or add execution agents, or to change their priority levels |
7.1.36 API to exclude or add execution agents, or to change their priority levels |
|
JP1/AJS3 - Manager protocol version acquisition API |
- Execution privileges
-
None
- Request format
-
- Request line
GET /application/component/apiVersion/version?query httpVersion
- API version
-
v1
- Information that uniquely identifies a resource
-
None
- Parameter
-
The following table lists and describes the parameters that can be specified for query.
Table 7‒37: List of parameters for the version information acquisition API Parameter
Description of the value
Required?
manager
Specify the manager host name or IP address by using a character string in the range from 1 to 255 bytes.
Y
- Legend:
-
Y: Required
- Status code
-
The following table lists and describes the status codes returned as a response:
Status code
Text description
Description
200
OK
Version information was successfully acquired.
400
Bad Request
The query character string is invalid.
401
Unauthorized
Authentication is required.
404
Not found
The operator does not have access permission for the resource, or the resource does not exist.
412
Precondition failed
The Web Console server is not available.
500
Server-side error
A processing error occurred in the Web Console server.
- Response format
-
- Response message body
{ "productName":"product-name", "productVersion":"product-version", "displayProductVersion":"product-version (for-display)", "productVersionNumber":product-version (number) }
- Return values
-
If the status code is 200, the following information is returned:
Member
Data type
Description
productName
string
Returns the product name.
productVersion
string
Returns the product version in the format of VV-RR-SS.
VV, RR, and SS each indicate a two-digit number.
displayProductVersion
string
Returns the product version (for display) in the format of VV-RR or VV-RR-SS.
VV, RR, and SS each indicate a two-digit number.
For example, if the value of productVersion is 11-00-00, 11-00 is returned with a value for SS omitted.
productVersionNumber
int
Returns the product version as a number. The returned number is in the format of VVRRSS for the product version VV-RR-SS.
For example, if the product version is 11-00-06, 110006 is returned. If the product version is 11-10-00, 111000 is returned.
This member is returned if the version of JP1/AJS3 - Web Console is 11-10 or later. If this member is not returned, assume that the version of JP1/AJS3 - Web Console is earlier than 11-10.
- Example
-
The following shows an example of using the API that acquires version information of the product.
- Example request:
GET /ajs/api/v1/version?manager=HOSTM HTTP/1.1 Host: HOSTW:22252 Accept-Language: ja X-AJS-Authorization: dXNlcjpwYXNzd29yZA==
- Example response (message body):
{ "productName": "Automatic Job Management System 3 - Web Console", "productVersion": "11-10-00", "displayProductVersion": "11-10", "productVersionNumber": 111000 }