
Add or remove end-point(s) to network.
For fiber channel, some Networks may be automatically created by discovering Network Systems. These Networks will have endpoints that were discovered by a Network System, including endpoints that represent host initiator port WWNs as well as end points that represent storage array port WWNs.
Discovered endpoints may not be deleted by the user. They will be updated periodically as the Network System refreshes its information on the topology of the VSANs or Fabrics.
The user may still manually add endpoints to a discovered Network. The user is able to delete endpoints that were manually added. If a manually entered endpoint is subsequently discovered by a a Network System, it becomes managed as if it were discovered originally, and then may no longer be deleted.
This API is maintained for backward compatibility. Since the method is deprecated use /vdc/networks/{id} instead.
id | the URN of a ViPR Network |
Requires one of the following roles:
All parameters are required unless otherwise stated.
Field | Description | Type | Notes |
<network_endpoints> | |||
<endpoints> | List of endpoints (WWN, iqn, IP address of port and host interfaces) to be added to the network or removed from it. | ||
<endpoint> | String |
0-* Elements |
|
</endpoints> | |||
<op> | Operation to add or remove endpoints from the network. | String | |
</network_endpoints> |
Network details
Field | Description | Type | Notes |
<network> | |||
<discovered> | Indicates whether the network was discovered by a network system or manually created. Valid values: true = network was discovered by a network system false = network was manually created | Boolean | |
<endpoints> | List of endpoints associated with the network. | ||
<endpoint> | String |
0-* Elements |
|
</endpoints> | |||
<endpoints_discovered> | List of endpoints associated with the network. Each endpoint is indexed to "true" indicating it was discovered or "false" indicating it was manually added into the network. | ||
<endpoint_discovered> |
0-* Elements |
||
<alias> | String | ||
<name> | String | ||
<value> | String | ||
</endpoint_discovered> | |||
</endpoints_discovered> | |||
<fabric_id> | Fabric name or VSAN (Virtual Storage Area Network) ID for the network if discovered by a network system. | String | |
<varray> | |||
<id> | ViPR ID of the related object | URI | |
<link> | A hyperlink to the related object | ||
</varray> | |||
<network_systems> | List of network systems that manage the network. These are the network systems where the network was discovered. Empty list for manually created network. | ||
<network_system> | String |
0-* Elements |
|
</network_systems> | |||
<assigned_varrays> | List of virtual arrays to which the network is assigned. | ||
<assigned_varray> | String |
0-* Elements |
|
</assigned_varrays> | |||
<connected_varrays> | List of virtual arrays to which the network is implicitly connected because a storage port in the network has been assigned to the virtual array. | ||
<connected_varray> | String |
0-* Elements |
|
</connected_varrays> | |||
<registration_status> | Indicates whether the network and its endpoints can be used for provisioning operation. Only registered networks can be used for provisioning operations. Valid values: UNREGISTERED REGISTERED UNKNOWN | String | |
<transport_type> | Transport type for the network. Valid values: IP FC Ethernet. | String | |
<routed_networks> | A list of networks that are routed to this network Valid value: FC | ||
<routed_network> | String |
0-* Elements |
|
</routed_networks> | |||
<native_guid> | The native unique identifier for this resource
Network Transport Types:
Network System Types:
Storage System Types:
|
String | |
<name> | The name assigned to this resource in ViPR. The resource name is set by a user and can be changed at any time. It is not a unique identifier. | String | |
<id> | An identifier that is generated by ViPR when the resource is created. The resource ID is guaranteed to be unique and immutable across all virtual data centers for all time. | URI | |
<link> | A hyperlink to the details for this resource | ||
<creation_time> | A timestamp that shows when this resource was created in ViPR | DateTime | |
<tags> | Keywords and labels that can be added by a user to a resource to make it easy to find when doing a search. | ||
<tag> | String |
0-* Elements |
|
</tags> | |||
<inactive> | Whether or not the resource is inactive. When a user removes a resource, the resource is put in this state before it is removed from the ViPR database. | Boolean | |
<global> | Boolean | ||
<remote> | Boolean | ||
<vdc> | |||
<id> | ViPR ID of the related object | URI | |
<link> | A hyperlink to the related object | ||
</vdc> | |||
<internal> | Whether or not the resource is an internal resource. | Boolean | |
</network> |
PUT: https://192.168.0.0:4443/vdc/networks/urn:storageos:Network:0e116bce-f137-4b89-a5d5-c171c6c67b4f:/endpoints.json HTTP/1.1 Content-Type: application/json X-SDS-AUTH-TOKEN: <AUTH_TOKEN> { "endpoints": [ "50:6F:00:50:56:91:3B:BF" ], "op": "add" }
HTTP/1.1 200 OK Content-Type: application/json { "creation_time": 1380721826906, "discovered": false, "endpoints": [ "50:06:01:61:3E:A0:59:B0", "50:06:01:66:3E:A0:59:B0", "50:01:24:82:01:B1:B5:B6", "50:06:01:63:3E:A0:59:B0", "50:01:24:82:03:F1:B5:B7", "50:01:24:82:01:B1:B5:B7", "50:06:01:62:3E:A0:59:B0", "50:01:24:82:03:F1:B5:B6", "50:06:01:6D:3E:A0:59:B0", "50:01:24:82:01:B1:D5:B5", "50:01:24:82:01:BC:4A:AD", "50:01:24:82:01:BC:4A:AC", "50:06:01:6A:3E:A0:59:B0", "50:01:24:82:02:D1:B5:B7", "50:01:24:82:00:91:D5:B4", "50:01:24:82:02:D1:B5:B6", "50:01:24:82:00:91:D5:B5", "50:01:24:82:02:DC:4A:AD", "50:01:24:82:02:DC:4A:AC", "50:01:24:82:01:B1:D5:B4", "50:06:01:6C:3E:A0:59:B0", "50:06:01:6E:3E:A0:59:B0", "50:01:24:82:03:FC:4A:AD", "50:06:01:68:3E:A0:59:B0", "50:6F:00:50:56:91:3B:BF", "50:06:01:65:3E:A0:59:B0", "50:06:01:60:3E:A0:59:B0", "50:06:01:6F:3E:A0:59:B0", "50:06:01:64:3E:A0:59:B0", "50:01:24:82:03:FC:4A:AC", "50:06:01:69:3E:A0:59:B0", "50:01:24:82:02:D1:D5:B5", "50:01:24:82:02:D1:D5:B4", "50:01:24:82:00:91:B5:B7", "50:06:01:6B:3E:A0:59:B0", "50:01:24:82:00:9C:4A:AC", "50:01:24:82:00:91:B5:B6", "50:01:24:82:03:F1:D5:B5", "50:01:24:82:03:F1:D5:B4", "50:06:01:67:3E:A0:59:B0", "50:01:24:82:00:9C:4A:AD" ], "endpoints_discovered": [ { "name": "50:06:01:61:3E:A0:59:B0", "value": "false" }, { "name": "50:06:01:66:3E:A0:59:B0", "value": "false" }, { "name": "50:06:01:63:3E:A0:59:B0", "value": "false" }, { "name": "50:01:24:82:01:B1:B5:B6", "value": "false" }, { "name": "50:01:24:82:03:F1:B5:B7", "value": "false" }, { "name": "50:06:01:62:3E:A0:59:B0", "value": "false" }, { "name": "50:01:24:82:01:B1:B5:B7", "value": "false" }, { "name": "50:01:24:82:03:F1:B5:B6", "value": "false" }, { "name": "50:06:01:6D:3E:A0:59:B0", "value": "false" }, { "name": "50:01:24:82:01:B1:D5:B5", "value": "false" }, { "name": "50:01:24:82:01:BC:4A:AD", "value": "false" }, { "name": "50:06:01:6A:3E:A0:59:B0", "value": "false" }, { "name": "50:01:24:82:01:BC:4A:AC", "value": "false" }, { "name": "50:01:24:82:00:91:D5:B4", "value": "false" }, { "name": "50:01:24:82:02:D1:B5:B7", "value": "false" }, { "name": "50:01:24:82:02:D1:B5:B6", "value": "false" }, { "name": "50:01:24:82:00:91:D5:B5", "value": "false" }, { "name": "50:01:24:82:02:DC:4A:AD", "value": "false" }, { "name": "50:01:24:82:02:DC:4A:AC", "value": "false" }, { "name": "50:06:01:6C:3E:A0:59:B0", "value": "false" }, { "name": "50:01:24:82:01:B1:D5:B4", "value": "false" }, { "name": "50:06:01:6E:3E:A0:59:B0", "value": "false" }, { "name": "50:06:01:68:3E:A0:59:B0", "value": "false" }, { "name": "50:01:24:82:03:FC:4A:AD", "value": "false" }, { "name": "50:6F:00:50:56:91:3B:BF", "value": "false" }, { "name": "50:06:01:65:3E:A0:59:B0", "value": "false" }, { "name": "50:06:01:60:3E:A0:59:B0", "value": "false" }, { "name": "50:06:01:6F:3E:A0:59:B0", "value": "false" }, { "name": "50:06:01:64:3E:A0:59:B0", "value": "false" }, { "name": "50:01:24:82:03:FC:4A:AC", "value": "false" }, { "name": "50:06:01:69:3E:A0:59:B0", "value": "false" }, { "name": "50:01:24:82:02:D1:D5:B5", "value": "false" }, { "name": "50:01:24:82:02:D1:D5:B4", "value": "false" }, { "name": "50:06:01:6B:3E:A0:59:B0", "value": "false" }, { "name": "50:01:24:82:00:91:B5:B7", "value": "false" }, { "name": "50:01:24:82:00:9C:4A:AC", "value": "false" }, { "name": "50:01:24:82:00:91:B5:B6", "value": "false" }, { "name": "50:01:24:82:03:F1:D5:B5", "value": "false" }, { "name": "50:01:24:82:03:F1:D5:B4", "value": "false" }, { "name": "50:06:01:67:3E:A0:59:B0", "value": "false" }, { "name": "50:01:24:82:00:9C:4A:AD", "value": "false" } ], "id": "urn:storageos:Network:0e116bce-f137-4b89-a5d5-c171c6c67b4f:", "inactive": false, "link": { "href": "/vdc/networks/urn:storageos:Network:0e116bce-f137-4b89-a5d5-c171c6c67b4f:", "rel": "self" }, "name": "fctz_a", "native_guid": "", "registration_status": "REGISTERED", "tags": [], "transport_type": "FC", "varray": { "id": "urn:storageos:VirtualArray:3746b1cc-1980-4fe0-b897-a018ac08f224:", "link": { "href": "/vdc/varrays/urn:storageos:VirtualArray:3746b1cc-1980-4fe0-b897-a018ac08f224:", "rel": "self" } } }