|
APIs in Category: portset |
7-Mode API version 1.15 |
portset-add |
Port sets are associated with igroups. If an igroup is not associated with a port set then an initiator that belongs to that igroup can see its target luns on all ports. If a port set is bound to an igroup then the initiator that belongs to that igroup can only see its target luns on the ports that belong to the port set. |
| portset-add | [top] |
Add a port to an existing port set
Input Name Range Type Description portset-name string
Name of port set. portset-port-name string
This is the name of the port that is to be added to the portset. In Data ONTAP 7-Mode, it can be input in two styles. The filername:slotletter format will add the port from a specific filer. For example: "buxton:4a" The slotletter format will add the port from both the local and partner filers. For example: "4a" In Data ONTAP Cluster-Mode, the port name is the name of either an FCP data lif or an iSCSI target portal group.
Errno Description EVDISK_ERROR_PORTSET_NO_SUCH_SET EVDISK_ERROR_PORTSET_HAS_PORT EVDISK_ERROR_PORTSET_TOO_MANY_PORTS EVDISK_ERROR_PORTSET_INVALID_PORT_NAME EVDISK_ERROR_PORTSET_THROTTLE_EXCEEDED EVDISK_ERROR_PORTSET_INVALID_PARTNER_PORT_NAME EVDISK_ERROR_PORTSET_BOTH_INVALID_PORT_NAMES EVDISK_ERROR_PORTSET_TOO_FEW_PORTS EVDISK_ERROR_PORTSET_WRONG_TYPE
| portset-create | [top] |
Create a port set
Input Name Range Type Description portset-name string
Name of the port set to create. portset-type string
Protocols accepted for this portset. Possible values: "fcp", "iscsi", "mixed". "iscsi" and "mixed" are available in Data ONTAP Cluster-Mode only.
Errno Description EVDISK_ERROR_PORTSET_ALREADY_EXIST EVDISK_ERROR_PORTSET_INVALID_TYPE EVDISK_ERROR_PORTSET_IC_DOWN EVDISK_ERROR_PORTSET_NO_SUCH_PORT EVDISK_ERROR_PORTSET_WRONG_TYPE EVDISK_ERROR_PORTSET_INVALID_PARTNER_PORT_NAME EVDISK_ERROR_PORTSET_BOTH_INVALID_PORT_NAMES EVDISK_ERROR_PORTSET_TOO_FEW_PORTS
| portset-destroy | [top] |
Destroys an existing port set. By default a set cannot be destroyed if there are existing igroup associated with that portset.
Input Name Range Type Description force boolean
optional
If 'false' or not specified, the request will fail if there are any igroups bound to this portset. If 'true', forcibly destroy the portset, even if there are existing igroup bindings. Best practice is to unbind all the associated igroups before destroying the igroup. portset-name string
Name of the port set to destroy.
Errno Description EVDISK_ERROR_PORTSET_NO_SUCH_GROUP EVDISK_ERROR_PORTSET_CANT_DESTROY_BOUND_PORTSET EVDISK_ERROR_PORTSET_THROTTLE_EXCEEDED EVDISK_ERROR_PORTSET_TOO_FEW_PORTS
| portset-list-info | [top] |
Get information for port set(s).
Input Name Range Type Description portset-name string
optional
Name of port set. If specified, only information for that set is returned. If not specified, information for all port sets are returned. Output Name Range Type Description portset-sets portset-info[]
List of port sets.
Errno Description EVDISK_ERROR_PORTSET_NO_SUCH_GROUP EVDISK_ERROR_PORTSET_TOO_FEW_PORTS
| portset-remove | [top] |
Removes a port from a port set.
Input Name Range Type Description portset-name string
Name of the port set. portset-port-name string
This is the name of the port that is to be removed from the portset. In Data ONTAP 7-Mode, it can be input in two styles. The filername:slotletter format will remove the port from a specific filer. For example: "buxton:4a" The slotletter format will remove the port from both the local and partner filers. For example: "4a" In Data ONTAP Cluster-Mode, the port name is the name of either an FCP data lif or an iSCSI target portal group.
Errno Description EVDISK_ERROR_PORTSET_INVALID_PORT_NAME EVDISK_ERROR_PORTSET_NO_SUCH_GROUP EVDISK_ERROR_PORTSET_NO_SUCH_PORT EVDISK_ERROR_PORTSET_TOO_FEW_PORTS EVDISK_ERROR_INITGROUP_ALREADY_BOUND
| Element definition: portset-info | [top] |
Information about a port set.
Name Range Type Description initiator-group-info initiator-group-name[]
Information about the initiator group(s) that are bound to the portset. portset-name string
Name of this port set. portset-port-info portset-port-name[]
Information about the ports belonging to the set. portset-port-total [0..1024] integer
Total number of ports in the port set. portset-type string
Possible values: "fcp", "iscsi", "mixed".
| Element definition: initiator-group-name | [top] |
The name of an initiator group
[none]
| Element definition: portset-port-name | [top] |
String representing a member of a portset. In Data ONTAP 7-Mode, the port name is of the format "filer:slotletter" or "slotletter". In Data ONTAP Cluster-Mode, the port name is the name of an FCP data lif or iSCSI target portal group.
[none]