NITRO Changes Across Releases

Some NITRO API have changed across releases. This topic details information which can help you avoid compatibility issues in your application.

Changes made from 13.0-52.24 -> 13.0-7631

  • Changes across NITRO flavors

    The NITRO API changes that were made in release build 13.0-76.31 when compared with release build 13.0-52.24.

Note: Resources and attributes related to Cisco RISE feature have been removed.

Type of change Resource Method/Attribute Remarks
Attribute removed vpnvserver analyticsprofile In 13.0-76.31 and later builds, multiple analytics profiles can be associated. vpnvserver_analyticsprofile_binding resource has been added for this purpose.
Attribute removed appfwprofile autodeployrule -
Attribute removed appflowparam aaainsight If API Gateway license and feature are enabled, transactions with content-type as application/json are included in the appflow records by default.
Attribute type changed policyevaluation pitoffsetlengtharray Attribute type has changed from integer to double.

Changes made from 12.1-48.13 -> 13.0-5224

  • Changes across NITRO flavors

    The NITRO changes that were made in release 13.0-52.24 when compared with release 12.1-48.13.

Type of change Resource Method/Attribute Remarks
Attribute removed rnat rnatip2 In 12.1 and earlier releases, for creating or updating ACL based RNAT resources, natip2 attribute was used. This has been changed to natip attribute for making it consistent with network based RNAT resources, get and update.
Attribute type changed rnat redirectport Data type for redirectport attribute is changed from boolean to integer.
Attribute missing in method rnat clear(), redirectport, natip redirectport and natip attributes are removed from clear() operation. Also, the clear() operation is deprecated, Use delete() operation instead.
Attribute missing in method rnat unset(), ownergroup, redirectport -
Attribute missing in method Authenticationpushservice POST/PUT, namespace The namespace attribute is set to a constant value of https://mfa.cloud.com. This attribute cannot be modified.
Attribute removed vpnvserver policy, priority, gotopriorityexpression These attributes are removed from vpnvserver resource because these attributes are related to policy binding.
  • Changes specific to NITRO SDKs

    The SDK-specific changes that were made in release 13.0-52.24 when compared with release 12.1-48.13.

Type of change Class Method/Attribute Remarks
Method removed systemfile (systemfile[]) get(nitro_service session), (systemfile[]) get(options option, nitro_service session), (systemfile) get(String filename, nitro_service session) These methods were not useful because filelocation was always a required attribute in fetching system files.
Attribute type changed nsconnectiontable irs, iss Data type changed from Integer to Double.
Method removed nsvpxparam (nsvpxparam) get(nitro_service session) With cluster support for nsvpxparam, the get() method returns an array instead of single entity.
Method removed nsconfig (base_response) save(nitro_service session) Alternate method - ‘base_response save(nitro_service client, nsconfig resource)’
Attribute type changed appfwprofile postbodylimit datatype changed from uint? to long?

Changes made from 12.0-57.24 -> 12.1-4813

  • Changes across NITRO flavors

    The NITRO changes that were made in release 12.1-48.13 when compared with release 12.0-57.24.

Type of change Resource Method/Attribute Remarks
Attribute removed nsicapprofile insertxserverip, insertxclientip, sendreqinresmod, insertxauthuseruri, onservererrorresponse -
Attribute removed lsnclient td “td” is applicable to lsnclientonly in conjunction with network/network6. This attribute is now a part of lsnclient_network_binding and lsclient_netwrok6_binding resources.
Attribute removed nspartition_stats minbandwidth minbandwidth setting on the partition is deprecated.
Attribute removed cloudparameter verifyurl This attribute is renamed to activationcode.
Attribute removed appfwprofile_safeobject_binding expression This attribute is renamed to as_expression.
  • Changes specific to NITRO SDKs

    The SDK-specific changes that were made in release 12.1-48.13 when compared with release 12.0-57.24.

Type of change Class Method/Attribute Remarks
Method removed nsacls (base_response) renumber(nitro_service session) Alternate method - (base_response)renumber(nitro_service client, nsacls resource)
Method removed nsacls (base_response) clear(nitro_service session) Alternate method - (base_response)clear(nitro_service client, nsacls resource)
Method removed nsacls (base_response) apply(nitro_service session) Alternate method - (base_response)apply(nitro_service client, nsacls resource)
Method removed nsacls6 (base_response) renumber(nitro_service session) Alternate method - (base_response)renumber(nitro_service client, nsacls6 resource)
Method removed nsacls6 (base_response) clear(nitro_service session) Alternate method - (base_response)clear(nitro_service client, nsacls6 resource)
Method removed nsacls6 (base_response) apply(nitro_service session) Alternate method - (base_response)apply(nitro_service client, nsacls6 resource)

Changes made from 11.1-53.3 -> 12.0-48x

  • Changes across NITRO flavors

    The NITRO changes that were made in release 12.0-48.x when compared with release 11.1-53.3.

Type of change Resource Method Attribute
Resource removed vpath, vpathparam ALL All resources and parameters related to vpath feature.
Attribute removed l3param - IcmperrgenerateThis attribute is related to vpath for which the support is removed in 12.0. 
Attribute removed qos_stats - ipcpe2qosfailedrateNote: Some of the counters under this resource are removed. For new definitions, see http://docs.citrix.com/en-us/netscaler/12/nitro-api/nitro-rest/api-reference/statistics/qos/qos.html 
Attribute removed vrid_interface_binding - trackifnumNew resources (vrid_trackifnum_binding and vrid6_trackifnum_binding) are introduced to deal with track interfaces.
Attribute removed vrid_interface_binding - ifaces is replaced with ifnum.Previously, ifaces parameter was used in the response and ifnum was used in the input. Now both POST and GET are consistent and use the same attribute name.
Attribute removed sslprofile_sslciphersuite_binding - cipheraliasnamecipheraliasname is a redundant parameter. The required information is provided by ciphername parameter.
Attribute removed nslicense - IspooledlicensingIspooledlicensing Is replaced with a new parameter licensingmode which returns if the license of "Local".html"Pooled".html"CICO" type.
Attribute removed lbmonitor_sslcertkey_binding DELETE crlcheck
  • Changes specific to NITRO SDKs

    The SDK-specific changes that were made in release 12.0-48.x when compared with release 11.1-53.3.

Type of change Class Method/Attribute Remarks
Attribute type changed  pcpmap pcpprotocol Datatype changed from double to string.
Class removed mediaclassification_stats - -
Method removed vxlan_iptunnel_binding add(vxlan_iptunnel_binding obj, nitro_service session)delete(vxlan_iptunnel_binding obj, nitro_service session) Feature is deprecated, use bridgetable with broadcast mac option.
Method removed inatsession_stats get(inatsession obj, nitro_service session) -

Changes Made from 10.5 57.x -> 110

Note:

XML APIs are deprecated from NetScaler release 10.5 onwards.

All NITRO Flavors - Changes from 10.5 57.x to 11.0

The NITRO changes that were made in release 11.0 when compared with release 10.5 Build 57.x.

Type of Change Resource Attribute
Attribute removed nstrace doruntimemerge
Attribute removed nstrace tcpdump
Attribute removed cacheobject force

NITRO SDKs - Changes from 10.5-57.x to 11.0

The SDK-specific changes that were made in release 11.0 when compared with release 10.5 Build 57.x.

Type of Change Class Method Replace with
Attribute missing in method cacheobject (base_response) flush(cacheobject obj, nitro_service session)'force' attribute missing in this method. -
Method missing clustersync (base_response) Force(clustersync obj, nitro_service session) (base_response) Force(nitro_service session)
Method missing shutdown (base_response) Shutdown(shutdown obj, nitro_service session) (base_response) Shutdown(nitro_service session)
Method missing systemfile (systemfile) get(systemfile obj, nitro_service session) -
Method missing sslfips (base_response) reset(sslfips obj, nitro_service session) (base_response) reset(nitro_service session)

Changes made from 9.3 -> 10.1 or 105

Note. No changes are introduced from release 10.1 to release 10.5. Therefore, you should not face any compatibility issues when migrating from release 10.1 to 10.5.

All NITRO Flavors - Changes from 9.3 to 10.1/10.5

The NITRO changes that were made in release 10.1/10.5 when compared with release 9.3.

Type of Change Resource Method Attribute
Resource removed lbmonitor_lbmetrictable_bindingReplaced with the resource 'lbmonitor_metric_binding'. - -
Method removed vserver GETPerform the GET operation on specific virtual server types such as lb/cr/cs. -
Method removed filterpolicy POST with 'action=unset'This method is removed as unsetting the attributes('action') of a policy makes it invalid. -
Method removed auditsyslogpolicy POST with 'action=unset'This method is removed as unsetting the attributes('action') of a policy makes it invalid. -
Method removed auditnslogpolicy POST with 'action=unset'This method is removed as unsetting the attributes('action') of a policy makes it invalid. -
Method removed authorizationpolicy POST with 'action=unset'This method is removed as unsetting the attributes('action') of a policy makes it invalid. -
Return-type changed snmpengineid GETReturn type changed to an array. -
Return-type changed nshostname GETReturn type changed to an array. -
Attribute-type changed appfwpolicy_lbvserver_binding - activepolicyData type changed from Boolean to Integer.
Attribute-type changed appfwpolicy_appfwglobal_binding - activepolicyData type changed from Boolean to Integer.
Attribute-type changed vlan - portbitmapData type changed from uint to ulong.
Attribute-type changed vlan - tagbitmapData type changed from uint to ulong.
Attribute removed policypatset_pattern_binding - indextypeThis attribute is moved to 'policypatset' resource as this attribute is applicable at patset level.
Attribute removed system_stats - powersupply1failureReplaced with 'powersupply1status'.Note: Change is applicable from release 9.3 Build 65.8.
Attribute removed system_stats - powersupply2failureReplaced with 'powersupply2status'.Note: Change is applicable from release 9.3 Build 65.8.
Attribute removed server_servicegroup_binding - servicetypeReplaced with 'svctype'.
Attribute removed server_service_binding - servicetypeReplaced with 'svctype'.
Attribute removed crvserver - hitsHits are calculated per policy binding hence moved this parameter to binding resources.
Attribute removed crvserver - dstvsvrReplaced with 'destinationvserver'.
Attribute removed crvserver - destvserverReplaced with 'domain'.
Attribute removed crvserver - dnsvserverReplaced with 'dnsvservername'.
Attribute removed appflowpolicylabel - typeReplaced with 'policylabeltype'.
Attribute removed sslcipher - ciphgrpalsReplaced with 'ciphergroupname'.
Attribute removed csvserver_cspolicy_binding - targetvserverReplaced with 'targetlbvserver'.Note: This change is applicable for the 'sslcipher_*_binding' resources also.
Attribute removed csvserver_cspolicy_binding - targetvserverReplaced with 'targetlbvserver'.
Attribute removed rewriteaction - allow_unsafe_pi1, allow_unsafe_piReplaced with 'bypassSafetyCheck'.
Attribute removed nsconfig - nwfwmodeMarked as a hidden attribute.

NITRO SDKs - Changes from 9.3 to 10.1/10.5

The SDK-specific changes that were made in release 10.1/10.5 when compared with release 9.3.

Type of Change Class Method Replace with
Class removed Routerbgp - This class is removed as all router configurations are deprecated in 9.2.
Method signature changed dnsptrrec get(dnsptrrec obj, nitro_service session) get(nitro_service session, String reversedomain)
Method signature changed dnsaddrec get(dnsaddrec obj, nitro_service session) get(nitro_service session, String hostname)
Method signature changed dnsnsrec get(dnsnsrec obj, nitro_service session) get(nitro_service session, String domain)
Method signature changed snmpengineid unset(nitro_service session, String[] args) unset(nitro_service session, snmpengineid resource, String[] args)
Method signature changed arp arp.get(nitro_service session, String ipaddress) arp.get(nitro_service session, arp resource)
Method signature changed nsip get(nitro_service session, String ipaddress) get(nitro_service client, nsip resource)
Method signature changed nsip6 get(nitro_service session, String ipv6address) get(nitro_service session, nsip6 resource)
Method signature changed dnsmxrec dnsmxrec.get(dnsmxrec obj, nitro_service session) dnsmxrec[] get(nitro_service service, dnsmxrec_args args)
Method Missing authenticationnegotiatepolicy (base_response) unset(nitro_service session, String[] args, String name)' is missing in  -
Method missing authenticationnegotiatepolicy (base_response) unset(authenticationnegotiatepolicy obj, nitro_service session, String[] args) -
Attribute missing in method nsconfig (base_response) update(nsconfig obj, nitro_service session)'nwfwmode' attribute is missing in this method. -