Developer Documentation
Citrix ADC 12.1 NITRO API Reference
Current Release 13.1 13

channel

August 17, 2023
Contributed by: 
C

Configuration for channel resource.

Properties

(click to see Operations)

Name Data Type Permissions Description
id 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 Citrix ADC or to the LA channel of a cluster configuration.
For an LA channel of a Citrix ADC, 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 Read-write Enable or disable the LA channel.
Default value: ENABLED
Possible values = ENABLED, DISABLED
mode Read-write The initital mode for the LA channel.
Possible values = MANUAL, AUTO
conndistr Read-write The ‘connection’ distribution mode for the LA channel.
Possible values = DISABLED, ENABLED
macdistr Read-write The ‘MAC’ distribution mode for the LA channel.
Possible values = SOURCE, DESTINATION, BOTH
lamac Read-write Specifies a MAC address for the LA channels configured in Citrix ADC 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 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, 25000, 40000, 50000, 100000
flowctl 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, ON
hamonitor 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 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 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 Read-write This is deprecated by tagall.
Default value: OFF
Possible values = ON, OFF
ifalias 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 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 Read-write High threshold value for the bandwidth usage of the LA channel, in Mbps. The Citrix ADC 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 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 Citrix ADC generates an SNMP trap message to indicate that the bandwidth usage has returned to normal.
Minimum value = 0
Maximum value = 160000
mtu 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 Citrix ADC 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 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 Read-write Link Redundancy for Cluster LAG.
Default value: OFF
Possible values = ON, OFF
devicename 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 Read-only Unit number of the channel. This is an internal reference number that the Citrix ADC uses to identify the channel.
description Read-only The IEEE standard that the channel is based on.
flags Read-only Flags of this channel.
actualmtu Read-only MTU of the channel. This is the maximum frame size that the channel can process.
vlan Read-only Native VLAN of the channel.
mac Read-only MAC address of the channel.
uptime 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 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 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 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, 25000, 40000, 50000, 100000
reqduplex 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 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, ON
media Read-only Requested media setting for this interface.
Possible values = AUTO, UTP, FIBER
actspeed Read-only Actual speed setting for this channel.
Possible values = AUTO, 10, 100, 1000, 10000, 25000, 40000, 50000, 100000
duplex Read-only Actualduplex setting for this interface.
Possible values = AUTO, HALF, FULL
actflowctl Read-only Actual flow control setting for this channel.
Possible values = OFF, RX, TX, RXTX, ON
lamode Read-only The mode(AUTO/MANNUAL) for the LA channel.
Possible values = MANUAL, AUTO
autoneg Read-only Requested auto negotiation setting for this channel. Since no media are associated with LA, this setting has no effect.
autonegresult Read-only Actual auto negotiation setting for this channel.
tagged Read-only VLAN tags setting on this channel.
taggedany Read-only Channel setting to accept/drop all tagged packets.
taggedautolearn Read-only Dynaminc vlan membership on this channel.
hangdetect Read-only Hang detect for this channel.
hangreset Read-only Hang reset for this channel.
linkstate 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 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 Read-only Number of bytes received by all the slave interfaces of the channel since the Citrix ADC was started or the interface statistics were cleared.
rxbytes Read-only Number of packets received by all member interfaces since the Citrix ADC was started or the interface statistics were cleared.
rxerrors Read-only Number of inbound packets dropped by the hardware of the slave interfaces since the Citrix ADC was started or the interface statistics were cleared. Possible causes of dropped packets are CRC, length (undersize or oversize), and alignment errors.
rxdrops 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 Citrix ADC 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 Read-only Number of packets transmitted by slave interfaces of a channel since the Citrix ADC was started or the interface statistics were cleared.
txbytes Read-only Number of bytes transmitted by slave interfaces of a channel since the Citrix ADC was started or the interface statistics were cleared.
txerrors Read-only Number of outbound packets dropped by the hardware of a channel’s slave interfaces since the Citrix ADC was started or the interface statistics were cleared. Possible causes of dropped packets are length (undersize or oversize) errors and lack of resources.
txdrops 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 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 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 Citrix ADC MPX 12500/12500/15500-10G platforms.
(2) 10G data ports on Citrix ADC MPX 17500/19500/21500 platforms.
fctls Read-only Number of times flow control is performed on a channel’s slave interfaces because of pause frames.
hangs Read-only Number of hangs that occurred on the channel’s slave interfaces.
stsstalls Read-only Number of status stalls that occurred on the channel’s slave interfaces.
txstalls Read-only Number of Tx stalls happened that occurred on the channel’s slave interfaces.
rxstalls Read-only Number of Rx stalls that occurred on the channel’s slave interfaces.
bdgmuted Read-only Number of times a channel’s slave interfaces stopped transmitting and receiving packets because of MAC moves between ports.
vmac Read-only Virtual MAC of this channel.
vmac6 Read-only Virtual MAC for IPv6 on this interface.
reqthroughput 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 Read-only Actual throughput for the interface.
backplane 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 Read-only Time since the interface stats are cleared last time.
lacpmode 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 Read-only Time to wait for the LACPDU. If a LACPDU is not received within this interval, the Citrix ADC 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 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 Read-only LACP Actor port number. LACP uses the port priority with the port number to form the port identifier.
lacppartnerstate Read-only LACP Partner State. Whether the port is in Active or Passive negotiating state.
Possible values = MANUAL, AUTO
lacppartnertimeout 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 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 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 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 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 Read-only If the timer expires in the Expired state, the Receive Machine enters the Defaulted state.
Possible values = NS_EMPTY_STR, DEFAULTED
lacppartnerexpired 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 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 Read-only LACP Partner System MAC.
lacppartnersystempriority 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 Read-only LACP Partner Port number. LACP uses the port priority with the port number to form the port identifier.
lacppartnerkey Read-only LACP Partner Key. The LACP key used by the partner port.
lacpactoraggregation 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 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 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 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 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 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 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 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 Read-only count parameter

Operations

(click to see Properties)

ADD DELETE UPDATE UNSET GET (ALL) GET COUNT

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 Citrix ADC appliance, the URL is as follows:

    http://<Citrix-ADC-IP-address(NSIP)>/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 Citrix ADC 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>

*Note:*

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

add

URL:http://<Citrix-ADC-IP-address(NSIP)>/nitro/v1/config/channel

HTTP Method:POST

Request Headers:

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

Request Payload: 


{"channel":{
<b>"id":<String_value>,
</b>"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>
}}

<!--NeedCopy-->

Response:

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

delete

URL:http://<Citrix-ADC-IP-address(NSIP)>/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 Citrix ADC specific errors). The response payload provides details of the error

update

URL:http://<Citrix-ADC-IP-address(NSIP)>/nitro/v1/config/channel

HTTP Method:PUT

Request Headers:

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

Request Payload: 


{"channel":{
<b>"id":<String_value>,
</b>"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>
}}

<!--NeedCopy-->

Response:

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

unset

URL:http://<Citrix-ADC-IP-address(NSIP)>/nitro/v1/config/channel?action=unset

HTTP Method:POST

Request Headers:

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

Request Payload: 


{"channel":{
<b>"id":<String_value>,
</b>"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
}}

<!--NeedCopy-->

Response:

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

get (all)

URL:http://<Citrix-ADC-IP-address(NSIP)>/nitro/v1/config/channel

Query-parameters:

attrs

http://<Citrix-ADC-IP-address(NSIP)>/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://<Citrix-ADC-IP-address(NSIP)>/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 Citrix ADC. Filtering can be done on any of the properties of the resource.

view

http://<Citrix-ADC-IP-address(NSIP)>/nitro/v1/config/channel?view=summary

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

pagination

http://<Citrix-ADC-IP-address(NSIP)>/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 Citrix ADC specific errors). The response payload provides details of the errorResponse 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>
}]}

<!--NeedCopy-->

get

URL:http://<Citrix-ADC-IP-address(NSIP)>/nitro/v1/config/channel/id_value<String>

Query-parameters:

attrs

http://<Citrix-ADC-IP-address(NSIP)>/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://<Citrix-ADC-IP-address(NSIP)>/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 Citrix ADC specific errors). The response payload provides details of the errorResponse 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>
}]}

<!--NeedCopy-->

count

URL:http://<Citrix-ADC-IP-address(NSIP)>/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 Citrix ADC specific errors). The response payload provides details of the errorResponse Headers:

Content-Type:application/json

Response Payload: 


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

<!--NeedCopy-->
channel
August 17, 2023
Contributed by: 
C
August 17, 2023
Contributed by: 
C

In this article

Site feedback | Your privacy choices footer linkYour Privacy Choices | Privacy and legal terms | Cookie preferences | Consent settings | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.