Acquire Agent instance details

This is an API function to acquire details of the specified Agent instance. This API function corresponds to the operation of the [Details] button that is displayed by selecting the [Agent] on the operation screen of Manager.

= Remarks =

It is the difference between the acquire a list of Agent instances API function and this API function that the following parameters are not included in the response of this API function.

  • content layer (Parameters under the content layer of the acquire a list API function are the same as the parameters of the acquire details API function.)
  • first

  • last

  • number

  • numberOfElements

  • size

  • sort

  • totalElements

  • totalPages

Format

curl -X GET --header 'Accept: application/json'

--header 'X-API-KEY:APIKEY'

'http://HOSTNAME:PORTNUMBER/api/v1/agents/agentId'

Request parameter (Path format)
Item name Request parameter Type Value Default value
Agent ID agentId String   Impossible to omit
Response

{

"agentId": "string",

"agentVersion": 0,

"agentVersionSyncronized": true,

"basicSettings": {

"autoResendingRetryCount": 0,

"autoResendingRetryInterval": 0,

"connectionRetryCount": 0,

"connectionRetryInterval": 0,

"historyMode": 0,

"jobTimeout": 0,

"jobTimeoutEnabled": true,

"pollingInterval": "string",

"receivingQueuePollingInterval": "string",

"receivingTaskQueueSize": 0,

"requestTimeout": 0,

"sendLogPoolSize": "string",

"sendProcessMultiplexLevel": 0,

"socketBufferSize": 0,

"socketBufferSizeMode": "string",

"socketTimeout": 0,

"traceLogPoolSize": "string",

"communicationTimeLimitEnabled": true,

"startCommunicationTimeHour": 0,

"endCommunicationTimeHour": 0

},

"bit": "string",

"cpu": "string",

"deviceAccessLog": {

"accessedDate": 0,

"agentId": "string",

"agentVersion": 0,

"attachedModuleVersion": "string",

"deviceAccessLogId": "string",

"moduleVersion": "string",

"pollingInterval": 0,

"profileId": "string",

"profileVersion": 0,

"type": "string",

"unitId": "string",

"unitVersion": 0

},

"host": "string",

"lockDown": {

"autoResendingRetryCount": true,

"autoResendingRetryInterval": true,

"connectionRetryCount": true,

"connectionRetryInterval": true,

"historyMode": true,

"jobTimeout": true,

"jobTimeoutEnabled": true,

"pollingInterval": true,

"receivingQueuePollingInterval": true,

"requestTimeout": true,

"sendLogPoolSize": true,

"sendProcessMultiplexLevel": true,

"socketBufferSize": true,

"socketTimeout": true,

"traceLogPoolSize": true,

"communicationTimeLimitEnabled": true,

"startCommunicationTimeHour": true,

"endCommunicationTimeHour": true

},

"macAddress": "string",

"moduleVersion": "string",

"moduleVersionSyncronized": true,

"moduleVersionUpdated": true,

"name": "string",

"nextSyncronizationScheduledTime": 0,

"os": "string",

"otherInfo": {

"region": 0,

"floating": "string"

},

"profileId": "string",

"profileName": "string",

"profileVersionSyncronized": true,

"profileVersionUpdated": true,

"registrationDate": 0,

"remarks": "string",

"sendLog": {

"agentId": "string",

"agentName": "string",

"cipherType": "string",

"compressedRate": 0,

"dTelegramLen": 0,

"dataSize": 0,

"detailCode": 0,

"errorJobExitCode": 0,

"errorJobName": "string",

"exitCode": 0,

"fileId": "string",

"hostName": "string",

"latestProcessId": "string",

"latestTransferId": "string",

"preJobExitCode": 0,

"preJobName": "string",

"profileId": "string",

"profileName": "string",

"recordCount": 0,

"sendLogId": "string",

"sndEndTimeStr": "string",

"sndEndTimeUtc": 0,

"sndFileName": "string",

"sndStartTimeStr": "string",

"sndStartTimeUtc": 0,

"startProcessId": "string",

"startTransferId": "string",

"successJobExitCode": 0,

"successJobName": "string",

"transferRate": 0,

"transferType": "string",

"triggerEvent": 0,

"triggerStatus": 0,

"unitId": "string",

"unitName": "string"

},

"session": "string",

"status": "string",

"unitId": "string",

"unitName": "string",

"unitVersionSyncronized": true,

"unitVersionUpdated": true

}

Response parameter
Item name Response parameter Type Value
Agent ID agentId String  

Agent Version

(Settings history)

agentVersion Integer

This value is returned for managing the settings history of Agent.

Just after an activation, the value is 1. If you modify the settings of Agent, the value will increase one by one.

Synchronization of the module agentVersionSyncronized Boolean

• true: It has been synchronized

• false: To be synchronized

 

Item name Response parameter Type Value
Auto Resend Retry Count basicSettings autoResendingRetryCount Integer 0 to 9999 (times)
Auto Resend Retry Interval autoResendingRetryInterval Integer 0 to 9999 (seconds)
Connection Retry Count connectionRetryCount Integer 0 to 9999 (times)
Connection Retry Interval connectionRetryInterval Integer 0 to 9999 (seconds)
Log Output Mode historyMode Integer

0 | 1

• 0: Only when an error occurs

• 1: Always

Job Timeout (Time) jobTimeout Integer

10 to 86400 (seconds)

If the "Job Timeout" is invalid, the value that was set when the "Job Timeout" was valid is returned.

Job Timeout (Valid or Invalid) jobTimeoutEnabled Boolean

• true: valid

• false: invalid

Polling Interval pollingInterval String

Numeral (1 to 59) with a unit (second: s, minute: m, hour: h, or day: d) is returned.

Receive Queue Polling Interval receivingQueuePollingInterval String

Numeral (1 to 59) with a unit (second: s, minute: m, hour: h, or day: d) is returned.

Size of Receive Task Queue receivingTaskQueueSize Integer 1 to 9999 (times)
Request Timeout requestTimeout Integer 10 to 259200 (seconds)
Send Log Pool Size sendLogPoolSize String

Numeral (1 to 1024) with a unit (megabyte: m) is returned.

Send Process Multiplex Level sendProcessMultiplexLevel Integer 1 to 99 (items)

Socket Buffer Size

(Byte count)

socketBufferSize Integer

• If the "socketBufferSizeMode" is "DEFAULT": The value that was set when the "socketBufferSizeMode" was "SPECIFIED" is returned. The initial value is NULL.

• If the "socketBufferSizeMode" is "SPECIFIED": 4096 to 2147483647 (byte)

Socket Buffer Size

(Type)

socketBufferSizeMode String

"DEFAULT" | "SPECIFIED"

• DEFAULT: Default

• SPECIFIED: Specified by user

Socket Read Timeout socketTimeout Integer 10 to 259200 (seconds)
Trace Log Pool Size traceLogPoolSize String

Numeral (1 to 1024) with a unit (megabyte: m) is returned.

Communication Time Limit communicationTimeLimitEnabled Boolean

• true: Communication hour is restricted

• false: Communication hour is not restricted

Start Time (Communication Time Limit) startCommunicationTimeHour Integer 0 to 23 (o'clock)
End Time (Communication Time Limit) endCommunicationTimeHour Integer 0 to 23 (o'clock)

 

Item name Response parameter Type Value
Agent Bit Count bit String

"32" | "64"

The value that indicates the bit count of Agent module is returned.

Agent Architecture cpu String

The CPU architecture on which the Agent module runs is returned.

Example: x86_84

Access Date and Time deviceAccessLog accessedDate Integer

The value is returned by using a "yyyyMMddHHmmssSSS" format.

Example: 20171114142949096

Agent ID agentId String  

Agent Version (Settings history)

agentVersion Integer

This value is returned for managing the settings history of Agent.

Just after an activation, the value is 1. If you modify the settings of Agent, the value will increase one by one.

Module Version (Current) attachedModuleVersion String

The version of a module that is currently allocated to the Agent is returned.

Example: "V01L04R00P00"

Access Log ID deviceAccessLogId String  

Module Version (To be allocated)

moduleVersion String

The version of a module that is currently allocated to the Agent or the version of a prepared module that will be allocated to the Agent is returned.

Example: "V01L04R00P00"

Polling Interval pollingInterval Integer

Numeral is returned. (seconds)

Example: 60

Profile ID profileId String  
Profile Version profileVersion Integer  
Access Log Type type String

"FULLSET" | "VERSION" | "UPDATE_STATUSES"

• "FULLSET": Settings Acquisition

• "VERSION": Version Confirmation

• "UPDATE_STATUSES": Update Statuses

Unit ID unitId String  
Unit Version unitVersion Integer  
Host Name host String  
Item name Response parameter Type Value
Make Auto Resend Retry Count static lockDown autoResendingRetryCount Boolean

• true: it is a fixed-value

• false: it is not a fixed-value

Make Auto Resend Retry Interval static autoResendingRetryInterval Boolean

• true: it is a fixed-value

• false: it is not a fixed-value

Make Connection Retry Count static connectionRetryCount Boolean

• true: it is a fixed-value

• false: it is not a fixed-value

Make Connection Retry Interval static connectionRetryInterval Boolean

• true: it is a fixed-value

• false: it is not a fixed-value

Make Log Output Mode static historyMode Boolean

• true: it is a fixed-value

• false: it is not a fixed-value

Make Job Timeout (Time) static jobTimeout Boolean

• true: it is a fixed-value

• false: it is not a fixed-value

Make Job Timeout (Valid or Invalid) static jobTimeoutEnabled Boolean

• true: it is a fixed-value

• false: it is not a fixed-value

Make Polling Interval static pollingInterval Boolean

• true: it is a fixed-value

• false: it is not a fixed-value

Make Receive Queue Polling Interval static receivingQueuePollingInterval Boolean

• true: it is a fixed-value

• false: it is not a fixed-value

Make Request Timeout static requestTimeout Boolean

• true: it is a fixed-value

• false: it is not a fixed-value

Make Send Log Pool Size static sendLogPoolSize Boolean

• true: it is a fixed-value

• false: it is not a fixed-value

Make Send Process Multiplex Level static sendProcessMultiplexLevel Boolean

• true: it is a fixed-value

• false: it is not a fixed-value

Make Socket Buffer Size static socketBufferSize Boolean

• true: it is a fixed-value

• false: it is not a fixed-value

Make Socket Read Timeout static socketTimeout Boolean

• true: it is a fixed-value

• false: it is not a fixed-value

Make Trace Log Pool Size static traceLogPoolSize Boolean

• true: it is a fixed-value

• false: it is not a fixed-value

Make Communication Time Limit static communicationTimeLimitEnabled Boolean

• true: it is a fixed-value

• false: it is not a fixed-value

Make Start Time static (Communication Time Limit) startCommunicationTimeHour Boolean

• true: it is a fixed-value

• false: it is not a fixed-value

Make End Time static (Communication Time Limit) endCommunicationTimeHour Boolean

• true: it is a fixed-value

• false: it is not a fixed-value

Item name Response parameter Type Value
MAC address macAddress String  
Module Version moduleVersion String  
Synchronization of the module moduleVersionSyncronized Boolean

• true: It has been synchronized

• false: To be synchronized

Update of the module

moduleVersionUpdated Boolean

• true: Update succeeded

• false: Update failed

If this value and the value of the "moduleVersionSyncronized" are both "true", the synchronization is complete.

Agent Name name String  
Next Scheduled Sync Time nextSyncronizationScheduledTime Integer

The value is returned by using a "yyyyMMddHHmmssSSS" format.

Example: 20171124164131676

OS os String  
Region otherInfo region Integer

0 | 1

• 0: Not a region edition

• 1: A region edition

Floating Point Operation of Agent floating String

"soft-float" | "hard-float"

• "soft-float": by using software

• "hard-float": by using hardware

This value is valid only when Agent is ARM version.

Profile ID profileId String  
Profile Name profileName String  
Synchronization of Profile profileVersionSyncronized Boolean

• true: It has been synchronized

• false: To be synchronized

Update of Profile

profileVersionUpdated Boolean

• true: Update succeeded

• false: Update failed

If this value and the value of the "profileVersionSyncronized" are both "true", the synchronization is complete.

Registration Date and Time registrationDate Integer

The value is returned by using a "yyyyMMddHHmmssSSS" format.

Example: 20171124164131676

Remarks remarks String Maximum 512 ASCII characters
Item name Response parameter Type Value
Agent ID sendLog agentId String  
Agent Name agentName String  
Encryption Type cipherType String

"0" | "1"

• 0: Encryption function is not used.*

• 1: HULFT encryption is used.

* If the product is a region edition, always 0 is specified.

Compression Ratio compressedRate Integer  
Transfer Block Length dTelegramLen Integer

 

Data Size (Send) dataSize Integer The size of the send data is returned.
Detail Code (Send) detailCode Integer  
End Code of Unsuccessful Job errorJobExitCode Integer  
Unsuccessful Job errorJobName String Job itself is returned.
End Code (Send) exitCode Integer  
File ID (Send file) fileId String The ID of the send file is returned.
Host Name (Send destination) hostName String  
Latest Processing Identifier latestProcessId String  
Latest Transfer Identifier latestTransferId String  
End code of Pre-send Job preJobExitCode Integer  
Pre-send Job preJobName String Job itself is returned.
Profile ID profileId String The ID of Profile that is used for the send processing is returned.
Profile Name profileName String The name of Profile that is used for the send processing is returned.
Record Count recordCount Integer The record count of the file that Agent has sent is returned.
Send Log ID sendLogId String  
Send End Date and Time (String) sndEndTimeStr String

"day-of-week month day hour:minute:second year"

Example: "Fri Sep 08 17:15:52 2017"

Send End Date and Time (UTC) sndEndTimeUtc Integer The number of seconds that has accumulated since midnight of 1970/1/1 (UTC)
Send File name sndFileName String Character code is UTF-8.
Send Start Date and Time (String) sndStartTimeStr String

"day-of-week month day hour:minute:second year"

Example: "Fri Sep 08 17:15:52 2017"

Send Start Date and Time (UTC) sndStartTimeUtc Integer The number of seconds that has accumulated since midnight of 1970/1/1 (UTC)
Item name Response parameter Type Value
Starting Identifier sendLog startProcessId String  
Start Transfer Identifier startTransferId String  
End code of Successful Job successJobExitCode Integer  
Successful Job successJobName String Job itself is returned.
Transmission Rate transferRate Integer

The transmission rate that is calculated by the following formula is returned:

Send data size (bytes) ÷ Send time (seconds)

Transfer Type transferType String

"B" | "T"

• B: Binary

• T: Text

Trigger Fire Event triggerEvent Integer

0 | 1

• 0: The event is fired by a result of a size monitoring

• 1: The event is fired by a result of a time stamp monitoring

File Status When Firing Trigger triggerStatus Integer

File Size | Date and Time

• If the event is fired by a result of a size monitoring: File Size (byte)

• If the event is fired by a time stamp monitoring: Date and Time

Unit ID unitId String The ID of Unit in which the send processing is executed is returned.
Unit Name unitName String The name of Unit in which the send processing is executed is returned.
Session session String

"ONLINE" | "OFFLINE" | "OUT_OF_HOURS"

• ONLINE: online

• OFFLINE: offline

• OUT_OF_HOURS: other than the communication hours according to Communication Time Limit

Agent status status String

"ON" | "OFF"

• ON: Agent is in use.

• OFF: Agent is on standby.

Unit ID unitId String  
Unit Name unitName String  
Synchronization of Unit unitVersionSyncronized Boolean

• true: It has been synchronized

• false: To be synchronized

Update of Unit unitVersionUpdated Boolean

• true: Update succeeded

• false: Update failed

If this value and the value of the "unitVersionSyncronized" are both "true", the synchronization is complete.