2.24.1 Obtaining Service Resource List
The API acquires a list of service resources.
Execution permission
Admin, Modify
API version
v1
Request format
GET http[s]://host:port/Analytics/version/objects/ServiceResources
Request body
Not applicable.
Response body
The structure of the response body and the object attributes are as follows:{ "data":[{ "name":"...", "status":"...", "monitorStatus":"...", "serviceType":"...", "region":"...", "zone":"...", "serviceDetailType":"...", "description":"...", "collectorID":"...", "collectorName":"...", "autoCollectionType":"...", "usedCredentialID":"...", "usedCredentials":"...", "accessPointType":"...", "accessPointIpAddress":"...", "accessPointUser":"...", "accessTargetIdentification":"...", "pluginId":"...", "pluginName":"..." }, : ], "pagination":{ "page":"...", "pageSize":"...", "numPages":"...", "totalCount":"..." }, "count":"..." }
Collections (Type: Collections)
Attribute |
Type |
Description |
---|---|---|
data |
ServiceResource[] |
A list of ServiceResource objects. For details about ServiceResource, 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. |
data (Type: ServiceResource)
Attribute |
Type |
Description |
---|---|---|
name |
string |
Name of the service resource |
status |
enum |
Status of the service resource (For details about the specifiable values, see the table NodeStatusType in List of enumerators.) The specifiable values are as follows:
|
monitorStatus |
enum |
Monitoring status of the service resource (For details about the specifiable values, see the table ManagementLevelType in List of enumerators.) The specifiable values are as follows:
|
serviceType |
enum |
Type of the service resource (For details about the specifiable values, see the table PluginServiceType in List of enumerators.) The specifiable values are as follows:
|
region |
string |
Region of the service resource |
zone |
string |
Zone of the service resource |
serviceDetailType |
string |
Detailed type of the service resource |
description |
string |
Description of the service resource |
collectorID |
long |
ID for identifying a collector used for detection |
collectorName |
string |
Name of a collector used for detection |
autoCollectionType |
enum |
Type of a collector used for detection (For details about the specifiable values, see the table ConnectType in List of enumerators.) The specifiable values are as follows:
|
usedCredentialID |
long |
Name of authentication information used for detection |
usedCredentials |
string |
ID for authentication information used for detection |
accessPointType |
enum |
Type of the protocol or collector for authentication information used for detection (For details about the specifiable values, see the table ProtocolType in List of enumerators.) The specifiable values are as follows:
|
accessPointIpAddress |
string |
IP address or host name used for connections to monitoring targets or management software |
accessPointUser |
string |
User ID used for connections to monitoring targets or management software |
accessTargetIdentification |
string |
Access-target identification key used for connections to monitoring targets or management software |
pluginId |
string |
ID for the plug-in applied to the service resource |
pluginName |
string |
Name for the plug-in applied to the service resource |
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 |
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/ServiceResources/ HTTP/1.1 Authorization: HSSO e1ae4524b8ff0eb6560dda6af26e6a258ac92f6_Vlo8Y30KeAYCfyNKC3cJZCEEbAQ=_V0810 User-Agent: Mozilla/5.0 (Windows NT 10.0; WOW64; Trident/7.0; rv:11.0) like Gecko Host: localhost:22015 Accept: application/json Accept-Language: ja [Response Header] HTTP/1.1 200 OK Date: Fri, 04 Sep 2020 09:27:26 GMT Server: Cosminexus HTTP Server Cache-Control: no-cache WWW-Authenticate: HSSO e1ae4524b8ff0eb6560dda6af26e6a258ac92f6_Vlo8Y30KeAYCfyNKC3cJZCEEbAQ=_V0810 X-Frame-Options: SAMEORIGIN Connection: Keep-Alive Content-Type: application/json Content-Length: 633 [Response Body] { "data" : [ { "instanceID" : 1000001, "name" : "EC Service", "status" : "Warning", "monitorStatus" : "Manage", "serviceType" : "computing", "region" : "Tokyo", "zone" : "1a", "description" : "", "collectorID" : 2, "collectorName" : "AWS Collector", "autoCollectionType" : "AutoConnect", "accessPointType" : "HTTP", "accessPointIpAddress" : "", "accessPointUser" : "system", "accessTargetIdentification" : "accessId", "pluginId" : "com.hitachi.software.ias.awsPlugin", "pluginName" : "AWS Plugin" } ], "count" : 1 }