2.21.1 Obtaining FC Switch List
The API acquires a list of FC switches.
Execution permission
Admin, Modify
API version
v1
Request format
GET http[s]://host:port/Analytics/version/objects/FCSwitches
Request body
Not applicable.
Response body
The structure of the response body and the object attributes are as follows:{ "data":[{ "instanceID":"...", "name":"...", "ipAddress":"...", "status":"...", "monitorStatus":"...", "description":"...", "usedCredentialID":"...", "usedCredentials":"...", "wwn":"...", "thresholdProfileID":"...", "thresholdProfileName":"...", "originalThresholdProfileID":"...", "accessPointType":"...", "accessPointIpAddress":"...", "accessPointUser":"..." }, : ], "pagination":{ "page":"...", "pageSize":"...", "numPages":"...", "totalCount":"..." }, "count":"..." }
Collections (Type: Collections)
Attribute |
Type |
Description |
---|---|---|
data |
FCSwitch[] |
A list of FCSwitch objects. For details about FCSwitch, 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: FCSwitch)
Attribute |
Type |
Description |
---|---|---|
instanceID |
long |
ID of the FC switch |
name |
string |
Name of the FC switch |
ipAddress |
string |
IP address of the FC switch |
status |
enum |
Status of the FC switch (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 FC switch. (For details about the specifiable values, see the table ManagementLevelType in List of enumerators.) The specifiable values are as follows:
|
description |
string |
Detailed information about the FC Switch |
usedCredentialID |
long |
ID for identifying authentication information used for detection |
usedCredentials |
string |
Name of authentication information used for detection |
wwn |
string |
WWN of the FC switch |
thresholdProfileID |
long |
ID of the threshold profile assigned to the FC switch |
thresholdProfileName |
string |
Name of the threshold profile assigned to the FC switch |
originalThresholdProfileID |
string |
Original threshold profile ID of the threshold profile assigned to the FC switch |
accessPointType |
enum |
Type of 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 used for connections to monitoring targets |
accessPointUser |
string |
User ID used for connections to monitoring targets |
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/FCSwitches 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 07:11:36 GMT Server: Cosminexus HTTP Server Cache-Control: no-cache WWW-Authenticate: HSSO 87d94e387ca516a82287ff4254ddac7f44e18bd4_WVlGcHsLfg5ffg0I_V0810 X-Frame-Options: SAMEORIGIN Transfer-Encoding: chunked Content-Type: application/json [Response Body] { "data" : [ { "instanceID" : 5, "name" : "SANbox", "ipAddress" : "10.197.87.222", "status" : "Unknown", "monitorStatus" : "Manage", "description" : "FC Switch", "usedCredentialID" : 6, "usedCredentials" : "10.197.87.222", "wwn" : "10:00:00:C0:DD:0D:62:E4", "thresholdProfileID" : 8, "thresholdProfileName" : "Default Profile for FC Switch", "accessPointType" : "WBEM", "accessPointIpAddress" : "10.197.87.222", "accessPointUser" : "admin" }, { "instanceID" : 19, "name" : "SW4016", "ipAddress" : "10.197.64.97, 127.0.0.1", "status" : "Normal", "monitorStatus" : "Manage", "description" : "FC Switch", "usedCredentialID" : 9, "usedCredentials" : "FCSwitchSNMP", "wwn" : "10:00:00:05:33:16:84:CB", "thresholdProfileID" : 8, "thresholdProfileName" : "Default Profile for FC Switch", "accessPointType" : "SNMP", "accessPointIpAddress" : "10.197.64.97", "accessPointUser" : "" } ], "count" : 2 }