2.3.1 Obtaining Collector List
This API acquires a list of collectors to be used by JP1/OA for connections to management software.
Execution permission
Admin, Modify
API version
v1
Request format
GET http[s]://host:port/Analytics/version/objects/Collectors
Request body
Not applicable.
Response body
The structure of the response body and the object attributes are as follows:Collections
{ "data":["...", ...], "pagination":{ "page":"...", "pageSize":"...", "numPages":"...", "totalCount":"..." }, "count":"..." }
Collections (Type: Collections)
Attribute |
Type |
Description |
---|---|---|
data |
anyType[] |
A list of Collector objects. For details about Collector, see the table below. |
pagination |
Pagination |
Page information. This parameter is displayed only when the relevant resource exists. |
count |
int |
Number of data items that meet the conditions. |
pagination (Type: Pagination)
Attribute |
Type |
Description |
---|---|---|
page |
integer |
page |
pageSize |
integer |
Size of the pages |
numPages |
integer |
Number of the pages |
totalCount |
integer |
Number of the objects |
Collector
{ "instanceID":"...", "name":"...", "collectorType":"...", "osType":"...", "autoCollectionType":"...", "connectResult":"...", "refreshStatus":"...", "message":"...", "lastRefreshed":"...", "refreshDateForInventory":"...", "refreshDateForPerformance":"...", "numOfHypervisors":"...", "numOfVms":"...", "numOfApplications":"...", "collectorCredentials":[{ "ipAddress":"...", "userId":"...", "portNumber":"...", "hypertextTransferProtocolType":"...", "domainName":"...", "useAdministrativeShares":"...", "shareName":"...", "sharedFolder":"...", "logicalHostName":"...", "useLogicalHostName":"..." }, : ], "productName":"...", "providerName":"...", "refreshDateForApp":"..." }
Collector (Type: Collector)
Attribute |
Type |
Description |
---|---|---|
instanceID |
long |
ID for identifying instances. |
name |
string |
Collector name |
collectorType |
enum |
Collector type. (For details about the specifiable values, see the table ProtocolType in List of enumerators.) The specifiable values are as follows:
|
osType |
enum |
Type of OS. This member is only set when the collectorType is AJS, PFM, or IM. (For details about the specifiable values, see the table CollectorOsType in List of enumerators.) |
autoCollectionType |
enum |
Settings for periodic executions of the collector. (For details about the specifiable values, see the table ConnectType in List of enumerators.) The specifiable values are as follows:
|
connectResult |
enum |
Last execution result of the collector. (For details about the specifiable values, see the table ConnectStatusType in List of enumerators.) The specifiable values are as follows:
|
refreshStatus |
enum |
Execution status of the collector. (For details about the specifiable values, see the table ConnectStatusType in List of enumerators.) The specifiable values are as follows:
|
message |
string |
Message of the execution result of the collector |
lastRefreshed |
dateTime |
Last refresh date and time |
refreshDateForInventory |
dateTime |
Refresh date and time for the configuration information |
refreshDateForPerformance |
dateTime |
Refresh date and time for the performance information |
numOfHypervisors |
int |
Number of hypervisors found by the collector |
numOfVms |
int |
Number of virtual machines found by the collector |
numOfApplications |
int |
Number of applications found by the collector. |
collectorCredentials |
CollectorCredential[] |
Authentication information used for connections to monitoring targets. |
productName |
string |
Collected-product name |
providerName |
string |
Provider name |
refreshDateForApp |
dateTime |
Date definition was applied |
collectorCredentials (Type: CollectorCredential)
Attribute |
Type |
Description |
---|---|---|
ipAddress |
string |
IP address or host name used for connections to management software. |
userId |
string |
User ID used for connections to management software. Specify a string of 255 or fewer bytes. |
portNumber |
int |
Port number used for connections to management software. |
hypertextTransferProtocolType |
enum |
Whether to use SSL (HTTPS) for connections to management software. (For details about the specifiable values, see the table HypertextTransferProtocolType in List of enumerators.) The specifiable values are as follows:
|
domainName |
string |
Domain name: Used for application linkage when Windows is selected. |
useAdministrativeShares |
boolean |
To share management, set true. |
shareName |
string |
share Name |
sharedFolder |
string |
shared Folder |
logicalHostName |
string |
Logical Host Name |
useLogicalHostName |
boolean |
To use logical host name, set true. |
Status codes
Status code |
Reason phrase |
Description |
---|---|---|
200 |
OK |
Success. |
401 |
Unauthorized |
No login privilege. |
403 |
Forbidden |
No reference privilege. |
412 |
Precondition Failed |
The server is not available. |
500 |
Internal Server Error |
Server processing error. |
Example code
[Request Header] GET /Analytics/v1/objects/Collectors HTTP/1.1 Authorization: Basic c3lzdGVtOm1hbmFnZXI= User-Agent: curl/7.33.0 Host: localhost:22015 Accept: application/json Accept-Language: ja [Response Header] HTTP/1.1 200 OK Date: Fri, 27 Nov 2015 05:21:49 GMT Server: Cosminexus HTTP Server Cache-Control: no-cache WWW-Authenticate: HSSO b9719717b548c1da1798ed5a2b2c22dbda7f40cd_WVlGcHsLfg5ffg0I_V0810 X-Frame-Options: SAMEORIGIN Transfer-Encoding: chunked Content-Type: application/json [Response Body] { "data" : [ { "instanceID" : 0, "name" : "192.168.0.115", "collectorType" : "VCENTER", "autoCollectionType" : "AutoConnect", "connectResult" : "Succeeded", "refreshStatus" : "NoConnect", "lastRefreshed" : "2015-11-27T14:17:09.160+09:00", "refreshDateForInventory" : "2015-11-27T13:25:03.943+09:00", "refreshDateForPerformance" : "2015-11-27T14:17:09.160+09:00", "numOfHypervisors" : 2, "numOfVms" : 27, "numOfStorages" : 0, "collectorCredentials" : [ { "ipAddress" : "192.168.0.115", "userId" : "Administrator", "portNumber" : 443, "hypertextTransferProtocolType" : "HTTPS" } ] }, { "instanceID": 1, "name": "jp1ajs_v11", "collectorType": "AJS", "osType": "Windows", "autoCollectionType": "AutoConnect", "connectResult": "Succeeded", "refreshStatus": "NoConnect", "lastRefreshed": "2017-09-26T00:46:59.296+09:00", "refreshDateForInventory": "2017-09-26T00:46:59.296+09:00", "numOfHypervisors": 0, "numOfVms": 0, "numOfStorages": 0, "numOfApplications": 12, "collectorCredentials": [ { "ipAddress": "192.168.1.118", "userId": "administrator", "domainName": "", "useAdministrativeShares": true, "useLogicalHostName": false } ] }, { "instanceID": 3, "name": "customCollector", "collectorType": "CUSTOM_APP", "autoCollectionType": "AutoConnect", "connectResult": "Succeeded", "refreshStatus": "NoConnect", "lastRefreshed": "2017-09-26T10:15:26.991+09:00", "refreshDateForInventory": "2017-09-26T10:15:26.991+09:00", "numOfHypervisors": 0, "numOfVms": 0, "numOfStorages": 0, "numOfApplications": 10, "productName": "User Product", "providerName": "XXYY System", "refreshDateForApp": "2017-08-04T12:10:00.775+09:00" } ], "count" : 3 }