Product Documentation

channel

Sep 07, 2016

Configuration for channel resource.

Properties (click to see Operations)

Name Data Type Permissions Description
id
<String>
Read-write
ID for the LA channel or cluster LA channel or LR channel to be created. Specify an LA channel in LA/x notation, where x can range from 1 to 8 or cluster LA channel in CLA/x notation or Link redundant channel in LR/x notation, where x can range from 1 to 4. Cannot be changed after the LA channel is created.
ifnum
<String[]>
Read-write
Interfaces to be bound to the LA channel of a NetScaler appliance or to the LA channel of a cluster configuration.
For an LA channel of a NetScaler appliance, specify an interface in C/U notation (for example, 1/3).
For an LA channel of a cluster configuration, specify an interface in N/C/U notation (for example, 2/1/3).
where C can take one of the following values:
* 0 - Indicates a management interface.
* 1 - Indicates a 1 Gbps port.
* 10 - Indicates a 10 Gbps port.
U is a unique integer for representing an interface in a particular port group.
N is the ID of the node to which an interface belongs in a cluster configuration.
Use spaces to separate multiple entries.
state
<String>
Read-write
Enable or disable the LA channel.
Default value: ENABLED
Possible values = ENABLED, DISABLED
mode
<String>
Read-write
The initital mode for the LA channel.
Possible values = MANUAL, AUTO
conndistr
<String>
Read-write
The 'connection' distribution mode for the LA channel.
Possible values = DISABLED, ENABLED
macdistr
<String>
Read-write
The 'MAC' distribution mode for the LA channel.
Possible values = SOURCE, DESTINATION, BOTH
lamac
<String>
Read-write
Specifies a MAC address for the LA channels configured in NetScaler virtual appliances (VPX). This MAC address is persistent after each reboot.
If you don't specify this parameter, a MAC address is generated randomly for each LA channel. These MAC addresses change after each reboot.
speed
<String>
Read-write
Ethernet speed of the channel, in Mbps. If the speed of any bound interface is greater than or equal to the value set for this parameter, the state of the interface is UP. Otherwise, the state is INACTIVE. Bound Interfaces whose state is INACTIVE do not process any traffic.
Default value: AUTO
Possible values = AUTO, 10, 100, 1000, 10000, 40000
flowctl
<String>
Read-write
Specifies the flow control type for this LA channel to manage the flow of frames. Flow control is a function as mentioned in clause 31 of the IEEE 802.3 standard. Flow control allows congested ports to pause traffic from the peer device. Flow control is achieved by sending PAUSE frames.
Default value: OFF
Possible values = OFF, RX, TX, RXTX
hamonitor
<String>
Read-write
In a High Availability (HA) configuration, monitor the LA channel for failure events. Failure of any LA channel that has HA MON enabled triggers HA failover.
Default value: ON
Possible values = ON, OFF
haheartbeat
<String>
Read-write
In a High Availability (HA) configuration, configure the LA channel for sending heartbeats. LA channel that has HA Heartbeat disabled should not send the heartbeats.
Default value: ON
Possible values = OFF, ON
tagall
<String>
Read-write
Adds a four-byte 802.1q tag to every packet sent on this channel. The ON setting applies tags for all VLANs that are bound to this channel. OFF applies the tag for all VLANs other than the native VLAN.
Default value: OFF
Possible values = ON, OFF
trunk
<String>
Read-write
This is deprecated by tagall.
Default value: OFF
Possible values = ON, OFF
ifalias
<String>
Read-write
Alias name for the LA channel. Used only to enhance readability. To perform any operations, you have to specify the LA channel ID.
Default value: " "
Maximum length = 31
throughput
<Double>
Read-write
Low threshold value for the throughput of the LA channel, in Mbps. In an high availability (HA) configuration, failover is triggered when the LA channel has HA MON enabled and the throughput is below the specified threshold.
Minimum value = 0
Maximum value = 160000
bandwidthhigh
<Double>
Read-write
High threshold value for the bandwidth usage of the LA channel, in Mbps. The NetScaler appliance generates an SNMP trap message when the bandwidth usage of the LA channel is greater than or equal to the specified high threshold value.
Minimum value = 0
Maximum value = 160000
bandwidthnormal
<Double>
Read-write
Normal threshold value for the bandwidth usage of the LA channel, in Mbps. When the bandwidth usage of the LA channel returns to less than or equal to the specified normal threshold after exceeding the high threshold, the NetScaler appliance generates an SNMP trap message to indicate that the bandwidth usage has returned to normal.
Minimum value = 0
Maximum value = 160000
mtu
<Double>
Read-write
The maximum transmission unit (MTU) is the largest packet size, measured in bytes excluding 14 bytes ethernet header and 4 bytes crc, that can be transmitted and received by this interface. Default value of MTU is 1500 on all the interface of Netscaler appliance any value configured more than 1500 on the interface will make the interface as jumbo enabled. In case of cluster backplane interface MTU value will be changed to 1514 by default, user has to change the backplane interface value to maximum mtu configured on any of the interface in cluster system plus 14 bytes more for backplane interface if Jumbo is enabled on any of the interface in a cluster system. Changing the backplane will bring back the MTU of backplane interface to default value of 1500. If a channel is configured as backplane then the same holds true for channel as well as member interfaces.
Default value: 1500
Minimum value = 1500
Maximum value = 9216
lrminthroughput
<Double>
Read-write
Specifies the minimum throughput threshold (in Mbps) to be met by the active subchannel. Setting this parameter automatically divides an LACP channel into logical subchannels, with one subchannel active and the others in standby mode. When the maximum supported throughput of the active channel falls below the lrMinThroughput value, link failover occurs and a standby subchannel becomes active.
Minimum value = 0
Maximum value = 80000
linkredundancy
<String>
Read-write
Link Redundancy for Cluster LAG.
Default value: OFF
Possible values = ON, OFF
devicename
<String>
Read-only
LA channel name in form LA/x, where x is channel ID, which ranges from 1 to 8 or LR channel name in form LR/x, where x is channel ID, which ranges from 1 to 4.
unit
<Double>
Read-only
Unit number of the channel. This is an internal reference number that the NetScaler uses to identify the channel.
description
<String>
Read-only
The IEEE standard that the channel is based on.
flags
<Double>
Read-only
Flags of this channel.
actualmtu
<Double>
Read-only
MTU of the channel. This is the maximum frame size that the channel can process.
vlan
<Double>
Read-only
Native VLAN of the channel.
mac
<String>
Read-only
MAC address of the channel.
uptime
<Double>
Read-only
Duration for which the channel is UP. (Example: 3 hours 1 minute 1 second). This value is reset when the channel state changes to DOWN.
downtime
<Double>
Read-only
Duration for which the channel is DOWN. (Example: 3 hours 1 minute 1 second). This value is reset when the channel state changes to UP.
reqmedia
<String>
Read-only
Requested media setting for this channel. Since there is no media associated with LA, the displayed values carry no significance.
Possible values = AUTO, UTP, FIBER
reqspeed
<String>
Read-only
Requested speed setting for this channel. Since no media are associated with LA, this speed is used to determine the threshold for the slave interfaces. If the speed of the member interface is less than the requested speed, that interface is considered inactive.
Possible values = AUTO, 10, 100, 1000, 10000, 40000
reqduplex
<String>
Read-only
Requested duplex setting for this channel. Since no media are associated with LA, the displayed values carry no significance.
Possible values = AUTO, HALF, FULL
reqflowcontrol
<String>
Read-only
Requested flow control setting for this channel. Since no media are associated with LA, the displayed values carry no significance.
Possible values = OFF, RX, TX, RXTX
media
<String>
Read-only
Requested media setting for this interface.
Possible values = AUTO, UTP, FIBER
actspeed
<String>
Read-only
Actual speed setting for this channel.
Possible values = AUTO, 10, 100, 1000, 10000, 40000
duplex
<String>
Read-only
Actualduplex setting for this interface.
Possible values = AUTO, HALF, FULL
actflowctl
<String>
Read-only
Actual flow control setting for this channel.
Possible values = OFF, RX, TX, RXTX
lamode
<String>
Read-only
The mode(AUTO/MANNUAL) for the LA channel.
Possible values = MANUAL, AUTO
autoneg
<Double>
Read-only
Requested auto negotiation setting for this channel. Since no media are associated with LA, this setting has no effect.
autonegresult
<Double>
Read-only
Actual auto negotiation setting for this channel.
tagged
<Double>
Read-only
VLAN tags setting on this channel.
taggedany
<Double>
Read-only
Channel setting to accept/drop all tagged packets.
taggedautolearn
<Double>
Read-only
Dynaminc vlan membership on this channel.
hangdetect
<Double>
Read-only
Hang detect for this channel.
hangreset
<Double>
Read-only
Hang reset for this channel.
linkstate
<Double>
Read-only
The current state of the link associated with the interface. For logical interfaces (LA), the state of the link is dependent on the state of the slave interfaces. For the link to be UP at least one of the slave interfaces needs to be UP.
intfstate
<Double>
Read-only
Current state of the specified interface. The interface state set to UP only if the link state is UP and administrative state is ENABLED.
rxpackets
<Double>
Read-only
Number of bytes received by all the slave interfaces of the channel since the NetScaler appliance was started or the interface statistics were cleared.
rxbytes
<Double>
Read-only
Number of packets received by all member interfaces since the NetScaler appliance was started or the interface statistics were cleared.
rxerrors
<Double>
Read-only
Number of inbound packets dropped by the hardware of the slave interfaces since the NetScaler appliance was started or the interface statistics were cleared. Possible causes of dropped packets are CRC, length (undersize or oversize), and alignment errors.
rxdrops
<Double>
Read-only
Number of inbound packets dropped by the channel's slave interfaces. Commonly dropped packets are multicast frames, spanning tree BPDUs, packets destined to a MAC not owned by the NetScaler when L2 mode is disabled, or packets tagged for a VLAN that is not bound to the interface. In most healthy networks, this statistic increments at a steady rate regardless of traffic load. A sharp spike in dropped packets generally indicates an issue with connected L2 switches, such as a forwarding database overflow resulting in packets being broadcast on all ports.
txpackets
<Double>
Read-only
Number of packets transmitted by slave interfaces of a channel since the NetScaler appliance was started or the interface statistics were cleared.
txbytes
<Double>
Read-only
Number of bytes transmitted by slave interfaces of a channel since the NetScaler appliance was started or the interface statistics were cleared.
txerrors
<Double>
Read-only
Number of outbound packets dropped by the hardware of a channel's slave interfaces since the NetScaler appliance was started or the interface statistics were cleared. Possible causes of dropped packets are length (undersize or oversize) errors and lack of resources.
txdrops
<Double>
Read-only
Number of packets dropped in transmission by a channel's slave interfaces for one of the following reasons:
(1) VLAN mismatch.
(2) Oversized packets.
(3) Interface congestion.
(4) Loopback packets sent on non-loopback interface.
indisc
<Double>
Read-only
Number of error-free inbound packets discarded by a channel's slave interfaces because of a lack of resources (for example, insufficient receive buffers).
outdisc
<Double>
Read-only
Number of error-free outbound packets discarded by a channel's slave interfaces because of a lack of resources. This statistic is not available on:
(1) 10G ports of NetScaler MPX 12500/12500/15500-10G platforms.
(2) 10G data ports on NetScaler MPX 17500/19500/21500 platforms.
fctls
<Double>
Read-only
Number of times flow control is performed on a channel's slave interfaces because of pause frames.
hangs
<Double>
Read-only
Number of hangs that occurred on the channel's slave interfaces.
stsstalls
<Double>
Read-only
Number of status stalls that occurred on the channel's slave interfaces.
txstalls
<Double>
Read-only
Number of Tx stalls happened that occurred on the channel's slave interfaces.
rxstalls
<Double>
Read-only
Number of Rx stalls that occurred on the channel's slave interfaces.
bdgmuted
<Double>
Read-only
Number of times a channel's slave interfaces stopped transmitting and receiving packets because of MAC moves between ports.
vmac
<String>
Read-only
Virtual MAC of this channel.
vmac6
<String>
Read-only
Virtual MAC for IPv6 on this interface.
reqthroughput
<Double>
Read-only
Minimum required throughput for an interface. Failover is triggered if the operating throughput of a Link Aggregation (LA) channel for which HAMON is ON falls below this value.
Minimum value = 0
Maximum value = 160000
actthroughput
<Double>
Read-only
Actual throughput for the interface.
backplane
<String>
Read-only
The cluster backplane status of the LA. If the status is enabled, the LA is part of the cluster backplane. By default, the backplane status is disabled.
Possible values = ENABLED, DISABLED
cleartime
<Double>
Read-only
Time since the interface stats are cleared last time.
lacpmode
<String>
Read-only
The LACP mode of the specified interface. The possible values are:
1. Active: A port in active mode generates LACP protocol messages on a regular basis, regardless of any need expressed by its partner to receive them.
2. Passive: A port in passive mode generally does not transmit LACP messages unless its partner is in the active mode; that is, it does not speak unless spoken to.
3. Disabled: Removes the interface from the LA channel. If this is only interface in the LA channel, the LA channel is also deleted.
.
Possible values = DISABLED, ACTIVE, PASSIVE
lacptimeout
<String>
Read-only
Time to wait for the LACPDU. If a LACPDU is not received within this interval, the NetScaler markes the link partner port as DOWN. Possible values: Long and Short. Long lacptimeout is 90 sec and Short LACP timeout is 3 sec.
Possible values = LONG, SHORT
lacpactorpriority
<Double>
Read-only
LACP Actor Priority. A LACP port priority is configured on each port using LACP. LACP uses the port priority with the port number to form the port identifier. The port priority determines which ports should be put in standby mode when there is a hardware limitation that prevents all compatible ports from aggregating.
lacpactorportno
<Double>
Read-only
LACP Actor port number. LACP uses the port priority with the port number to form the port identifier.
lacppartnerstate
<String>
Read-only
LACP Partner State. Whether the port is in Active or Passive negotiating state.
Possible values = MANUAL, AUTO
lacppartnertimeout
<String>
Read-only
The timeout value for the information revieved in LACPDUs. It can have values as SHORT or LONG. The SHORT timeout is 3s and the LONG timeout is 90s.
Possible values = LONG, SHORT
lacppartneraggregation
<String>
Read-only
The Aggregation flag indicates that the participant will allow the link to be used as part of an aggregate. Otherwise the link is to be used as an individual link, i.e. not aggregated with any other.
Possible values = NS_EMPTY_STR, AGG
lacppartnerinsync
<String>
Read-only
The Synchronization flag indicates that the transmitting participant.s mux component is in sync with the system id and key information transmitted.
Possible values = NS_EMPTY_STR, SYNC
lacppartnercollecting
<String>
Read-only
The Collecting flag indicates that the participant.s collector, i.e. the reception component of the mux, is definitely on. If set the flag communicates collecting.
Possible values = NS_EMPTY_STR, COLLECTING
lacppartnerdistributing
<String>
Read-only
The Distributing flag indicates that the participant.s distributor is not definitely off. If reset the flag indicates not distributing.
Possible values = NS_EMPTY_STR, DISTRIBUTING
lacppartnerdefaulted
<String>
Read-only
If the timer expires in the Expired state, the Receive Machine enters the Defaulted state.
Possible values = NS_EMPTY_STR, DEFAULTED
lacppartnerexpired
<String>
Read-only
If the LACPDUs are received for timeout period, the Receive Machine enters the Expired state and the timer is restarted with the timeout value of SHORT timeout.
Possible values = NS_EMPTY_STR, EXPIRED
lacppartnerpriority
<Double>
Read-only
LACP Partner Priority. A LACP port priority is configured on each port using LACP. LACP uses the port priority with the port number to form the port identifier.
The port priority determines which ports should be put in standby mode when there is a hardware limitation that prevents all compatible ports from aggregating.
lacppartnersystemmac
<String>
Read-only
LACP Partner System MAC.
lacppartnersystempriority
<Double>
Read-only
LACP Partner System Priority. The LACP partner's system priority. The values for the priority range from 0 to 65535. The lower the value, the higher the system priority. The switch with the lower system priority value determines which links between LACP partner are active and which are in the standby for each LACP Channel.
lacppartnerportno
<Double>
Read-only
LACP Partner Port number. LACP uses the port priority with the port number to form the port identifier.
lacppartnerkey
<Double>
Read-only
LACP Partner Key. The LACP key used by the partner port.
lacpactoraggregation
<String>
Read-only
The Aggregation flag indicates that the participant will allow the link to be used as part of an aggregate. Otherwise the link is to be used as an individual link, i.e. not aggregated with any other.
Possible values = NS_EMPTY_STR, AGG
lacpactorinsync
<String>
Read-only
The Synchronization flag indicates that the transmitting participant.s mux component is in sync with the system id and key information transmitted.
Possible values = NS_EMPTY_STR, SYNC
lacpactorcollecting
<String>
Read-only
The Collecting flag indicates that the participant.s collector, i.e. the reception component of the mux, is definitely on. If set the flag communicates collecting.
Possible values = NS_EMPTY_STR, COLLECTING
lacpactordistributing
<String>
Read-only
The Distributing flag indicates that the participant.s distributor is not definitely off. If reset the flag indicates not distributing.
Possible values = NS_EMPTY_STR, DISTRIBUTING
lacpportmuxstate
<String>
Read-only
LACP Port MUX state. The state of the MUX control machine. The Mux Control Machine attaches the physical port to an aggregate port, using the Selection Logic to choose an appropriate port, and turns the distributor and collector for the physical port on or off as required by protocol information.
Possible values = DETACHED, WAITING, ATTACHED, COLLECTING, DISTRIBUTING
lacpportrxstat
<String>
Read-only
LACP Port RX state. The state of the Receive machine. The Receive Machine maintains partner information, recording protocol information from LACPDUs sent by remote partner(s). Received information is subject to a timeout, and if sufficient time elapses the receive machine will revert to using default partner information.
Possible values = INIT, PORT_DISABLED, LACP_DISABLED, EXPIRED, DEFAULTED, CURRENT
lacpportselectstate
<String>
Read-only
LACP Port SELECT state. The state of the SELECT state machine, It could be SELECTED or UNSELECTED.
Possible values = UNSELECTED, SELECTED, STANDBY
lldpmode
<String>
Read-only
Link Layer Discovery Protocol (LLDP) mode for an interface. The resultant LLDP mode of an interface depends on the LLDP mode configured at the global and the interface levels.
Possible values = NONE, TRANSMITTER, RECEIVER, TRANSCEIVER
__count
<Double>
Read-only
count parameter

Operations (click to see Properties)

Some options that you can use for each operations:

  • Getting warnings in response: NITRO allows you to get warnings in an operation by specifying the "warning" query parameter as "yes". For example, to get warnings while connecting to the NetScaler appliance, the URL is as follows:

    http://<netscaler-ip-address>/nitro/v1/config/login?warning=yes

    If any, the warnings are displayed in the response payload with the HTTP code "209 X-NITRO-WARNING".

  • Authenticated access for individual NITRO operations: NITRO allows you to logon to the NetScaler appliance to perform individual operations. You can use this option instead of creating a NITRO session (using the login object) and then using that session to perform all operations,

    To do this, you must specify the username and password in the request header of the NITRO request as follows:

    X-NITRO-USER:<username>

    X-NITRO-PASS:<password>

    Note: In such cases, make sure that the request header DOES not include the following:

    Cookie:NITRO_AUTH_TOKEN=<tokenvalue>

메모

Mandatory parameters are marked in red and placeholder content is marked in <green>.

add

URL: http://<netscaler-ip-address>/nitro/v1/config/channel

HTTP Method: POST

Request Headers:

Cookie:NITRO_AUTH_TOKEN=<tokenvalue>
Content-Type:application/json

Request Payload:

{"channel":{
      "id":<String_value>,
      "ifnum":<String[]_value>,
      "state":<String_value>,
      "mode":<String_value>,
      "conndistr":<String_value>,
      "macdistr":<String_value>,
      "lamac":<String_value>,
      "speed":<String_value>,
      "flowctl":<String_value>,
      "hamonitor":<String_value>,
      "haheartbeat":<String_value>,
      "tagall":<String_value>,
      "trunk":<String_value>,
      "ifalias":<String_value>,
      "throughput":<Double_value>,
      "bandwidthhigh":<Double_value>,
      "bandwidthnormal":<Double_value>
}}

Response:

HTTP Status Code on Success: 201 Created
HTTP Status Code on Failure: 4xx <string> (for general HTTP errors) or 5xx <string> (for NetScaler-specific errors). The response payload provides details of the error

delete

URL: http://<netscaler-ip-address>/nitro/v1/config/channel/id_value<String>

HTTP Method: DELETE

Request Headers:

Cookie:NITRO_AUTH_TOKEN=<tokenvalue>

Response:

HTTP Status Code on Success: 200 OK
HTTP Status Code on Failure: 4xx <string> (for general HTTP errors) or 5xx <string> (for NetScaler-specific errors). The response payload provides details of the error

update

URL: http://<netscaler-ip-address>/nitro/v1/config/channel

HTTP Method: PUT

Request Headers:

Cookie:NITRO_AUTH_TOKEN=<tokenvalue>
Content-Type:application/json

Request Payload:

{"channel":{
      "id":<String_value>,
      "state":<String_value>,
      "mode":<String_value>,
      "conndistr":<String_value>,
      "macdistr":<String_value>,
      "lamac":<String_value>,
      "speed":<String_value>,
      "mtu":<Double_value>,
      "flowctl":<String_value>,
      "hamonitor":<String_value>,
      "haheartbeat":<String_value>,
      "tagall":<String_value>,
      "trunk":<String_value>,
      "ifalias":<String_value>,
      "throughput":<Double_value>,
      "lrminthroughput":<Double_value>,
      "linkredundancy":<String_value>,
      "bandwidthhigh":<Double_value>,
      "bandwidthnormal":<Double_value>
}}

Response:

HTTP Status Code on Success: 200 OK
HTTP Status Code on Failure: 4xx <string> (for general HTTP errors) or 5xx <string> (for NetScaler-specific errors). The response payload provides details of the error

unset

URL: http://<netscaler-ip-address>/nitro/v1/config/channel?action=unset

HTTP Method: POST

Request Headers:

Cookie:NITRO_AUTH_TOKEN=<tokenvalue>
Content-Type:application/json

Request Payload:

{"channel":{
      "id":<String_value>,
      "state":true,
      "mode":true,
      "conndistr":true,
      "macdistr":true,
      "speed":true,
      "mtu":true,
      "flowctl":true,
      "hamonitor":true,
      "haheartbeat":true,
      "tagall":true,
      "trunk":true,
      "ifalias":true,
      "throughput":true,
      "lrminthroughput":true,
      "linkredundancy":true,
      "bandwidthhigh":true,
      "bandwidthnormal":true
}}

Response:

HTTP Status Code on Success: 200 OK
HTTP Status Code on Failure: 4xx <string> (for general HTTP errors) or 5xx <string> (for NetScaler-specific errors). The response payload provides details of the error

get (all)

URL: http://<netscaler-ip-address>/nitro/v1/config/channel

Query-parameters:

attrs

http://<netscaler-ip-address>/nitro/v1/config/channel?attrs=property-name1,property-name2

Use this query parameter to specify the resource details that you want to retrieve.

filter

http://<netscaler-ip-address>/nitro/v1/config/channel?filter=property-name1:property-val1,property-name2:property-val2

Use this query-parameter to get the filtered set of channel resources configured on NetScaler.Filtering can be done on any of the properties of the resource.

view

http://<netscaler-ip-address>/nitro/v1/config/channel?view=summary

Note: By default, the retrieved results are displayed in detail view (?view=detail).

pagination

http://<netscaler-ip-address>/nitro/v1/config/channel?pagesize=#no&pageno=#no

Use this query-parameter to get the channel resources in chunks.

HTTP Method: GET

Request Headers:

Cookie:NITRO_AUTH_TOKEN=<tokenvalue>
Accept:application/json

Response:

HTTP Status Code on Success: 200 OK
HTTP Status Code on Failure: 4xx <string> (for general HTTP errors) or 5xx <string> (for NetScaler-specific errors). The response payload provides details of the error

Response Headers:

Content-Type:application/json

Response Payload:

{ "channel": [ {
      "id":<String_value>,
      "devicename":<String_value>,
      "unit":<Double_value>,
      "description":<String_value>,
      "flags":<Double_value>,
      "mtu":<Double_value>,
      "actualmtu":<Double_value>,
      "vlan":<Double_value>,
      "mac":<String_value>,
      "lamac":<String_value>,
      "uptime":<Double_value>,
      "downtime":<Double_value>,
      "reqmedia":<String_value>,
      "reqspeed":<String_value>,
      "reqduplex":<String_value>,
      "reqflowcontrol":<String_value>,
      "media":<String_value>,
      "actspeed":<String_value>,
      "duplex":<String_value>,
      "actflowctl":<String_value>,
      "mode":<String_value>,
      "lamode":<String_value>,
      "hamonitor":<String_value>,
      "haheartbeat":<String_value>,
      "state":<String_value>,
      "autoneg":<Double_value>,
      "autonegresult":<Double_value>,
      "tagged":<Double_value>,
      "tagall":<String_value>,
      "trunk":<String_value>,
      "taggedany":<Double_value>,
      "taggedautolearn":<Double_value>,
      "hangdetect":<Double_value>,
      "hangreset":<Double_value>,
      "linkstate":<Double_value>,
      "intfstate":<Double_value>,
      "rxpackets":<Double_value>,
      "rxbytes":<Double_value>,
      "rxerrors":<Double_value>,
      "rxdrops":<Double_value>,
      "txpackets":<Double_value>,
      "txbytes":<Double_value>,
      "txerrors":<Double_value>,
      "txdrops":<Double_value>,
      "indisc":<Double_value>,
      "outdisc":<Double_value>,
      "fctls":<Double_value>,
      "hangs":<Double_value>,
      "stsstalls":<Double_value>,
      "txstalls":<Double_value>,
      "rxstalls":<Double_value>,
      "bdgmuted":<Double_value>,
      "vmac":<String_value>,
      "vmac6":<String_value>,
      "ifalias":<String_value>,
      "reqthroughput":<Double_value>,
      "lrminthroughput":<Double_value>,
      "linkredundancy":<String_value>,
      "actthroughput":<Double_value>,
      "bandwidthhigh":<Double_value>,
      "bandwidthnormal":<Double_value>,
      "ifnum":<String[]_value>,
      "backplane":<String_value>,
      "cleartime":<Double_value>,
      "lacpmode":<String_value>,
      "lacptimeout":<String_value>,
      "lacpactorpriority":<Double_value>,
      "lacpactorportno":<Double_value>,
      "lacppartnerstate":<String_value>,
      "lacppartnertimeout":<String_value>,
      "lacppartneraggregation":<String_value>,
      "lacppartnerinsync":<String_value>,
      "lacppartnercollecting":<String_value>,
      "lacppartnerdistributing":<String_value>,
      "lacppartnerdefaulted":<String_value>,
      "lacppartnerexpired":<String_value>,
      "lacppartnerpriority":<Double_value>,
      "lacppartnersystemmac":<String_value>,
      "lacppartnersystempriority":<Double_value>,
      "lacppartnerportno":<Double_value>,
      "lacppartnerkey":<Double_value>,
      "lacpactoraggregation":<String_value>,
      "lacpactorinsync":<String_value>,
      "lacpactorcollecting":<String_value>,
      "lacpactordistributing":<String_value>,
      "lacpportmuxstate":<String_value>,
      "lacpportrxstat":<String_value>,
      "lacpportselectstate":<String_value>,
      "lldpmode":<String_value>
}]}

get

URL: http://<netscaler-ip-address>/nitro/v1/config/channel/id_value<String>

Query-parameters:

attrs

http://<netscaler-ip-address>/nitro/v1/config/channel/id_value<String>?attrs=property-name1,property-name2

Use this query parameter to specify the resource details that you want to retrieve.

view

http://<netscaler-ip-address>/nitro/v1/config/channel/id_value<String>?view=summary

Note: By default, the retrieved results are displayed in detail view (?view=detail).

HTTP Method: GET

Request Headers:

Cookie:NITRO_AUTH_TOKEN=<tokenvalue>
Accept:application/json

Response:

HTTP Status Code on Success: 200 OK
HTTP Status Code on Failure: 4xx <string> (for general HTTP errors) or 5xx <string> (for NetScaler-specific errors). The response payload provides details of the error

Response Headers:

Content-Type:application/json

Response Payload:

{ "channel": [ {
      "id":<String_value>,
      "devicename":<String_value>,
      "unit":<Double_value>,
      "description":<String_value>,
      "flags":<Double_value>,
      "mtu":<Double_value>,
      "actualmtu":<Double_value>,
      "vlan":<Double_value>,
      "mac":<String_value>,
      "lamac":<String_value>,
      "uptime":<Double_value>,
      "downtime":<Double_value>,
      "reqmedia":<String_value>,
      "reqspeed":<String_value>,
      "reqduplex":<String_value>,
      "reqflowcontrol":<String_value>,
      "media":<String_value>,
      "actspeed":<String_value>,
      "duplex":<String_value>,
      "actflowctl":<String_value>,
      "mode":<String_value>,
      "lamode":<String_value>,
      "hamonitor":<String_value>,
      "haheartbeat":<String_value>,
      "state":<String_value>,
      "autoneg":<Double_value>,
      "autonegresult":<Double_value>,
      "tagged":<Double_value>,
      "tagall":<String_value>,
      "trunk":<String_value>,
      "taggedany":<Double_value>,
      "taggedautolearn":<Double_value>,
      "hangdetect":<Double_value>,
      "hangreset":<Double_value>,
      "linkstate":<Double_value>,
      "intfstate":<Double_value>,
      "rxpackets":<Double_value>,
      "rxbytes":<Double_value>,
      "rxerrors":<Double_value>,
      "rxdrops":<Double_value>,
      "txpackets":<Double_value>,
      "txbytes":<Double_value>,
      "txerrors":<Double_value>,
      "txdrops":<Double_value>,
      "indisc":<Double_value>,
      "outdisc":<Double_value>,
      "fctls":<Double_value>,
      "hangs":<Double_value>,
      "stsstalls":<Double_value>,
      "txstalls":<Double_value>,
      "rxstalls":<Double_value>,
      "bdgmuted":<Double_value>,
      "vmac":<String_value>,
      "vmac6":<String_value>,
      "ifalias":<String_value>,
      "reqthroughput":<Double_value>,
      "lrminthroughput":<Double_value>,
      "linkredundancy":<String_value>,
      "actthroughput":<Double_value>,
      "bandwidthhigh":<Double_value>,
      "bandwidthnormal":<Double_value>,
      "ifnum":<String[]_value>,
      "backplane":<String_value>,
      "cleartime":<Double_value>,
      "lacpmode":<String_value>,
      "lacptimeout":<String_value>,
      "lacpactorpriority":<Double_value>,
      "lacpactorportno":<Double_value>,
      "lacppartnerstate":<String_value>,
      "lacppartnertimeout":<String_value>,
      "lacppartneraggregation":<String_value>,
      "lacppartnerinsync":<String_value>,
      "lacppartnercollecting":<String_value>,
      "lacppartnerdistributing":<String_value>,
      "lacppartnerdefaulted":<String_value>,
      "lacppartnerexpired":<String_value>,
      "lacppartnerpriority":<Double_value>,
      "lacppartnersystemmac":<String_value>,
      "lacppartnersystempriority":<Double_value>,
      "lacppartnerportno":<Double_value>,
      "lacppartnerkey":<Double_value>,
      "lacpactoraggregation":<String_value>,
      "lacpactorinsync":<String_value>,
      "lacpactorcollecting":<String_value>,
      "lacpactordistributing":<String_value>,
      "lacpportmuxstate":<String_value>,
      "lacpportrxstat":<String_value>,
      "lacpportselectstate":<String_value>,
      "lldpmode":<String_value>
}]}

count

URL: http://<netscaler-ip-address>/nitro/v1/config/channel?count=yes

HTTP Method: GET

Request Headers:

Cookie:NITRO_AUTH_TOKEN=<tokenvalue>
Accept:application/json

Response:

HTTP Status Code on Success: 200 OK
HTTP Status Code on Failure: 4xx <string> (for general HTTP errors) or 5xx <string> (for NetScaler-specific errors). The response payload provides details of the error

Response Headers:

Content-Type:application/json

Response Payload:

{ "channel": [ { "__count": "#no"} ] }