Product Documentation

NITRO Changes Across Releases

Jun 14, 2016

Some NITRO API have changed across releases. This topic details information which can help you avoid compatibility issues in your application. The changes are categorized as:

注意

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

All NITRO Flavors - Changes from 9.3 to 10.1/10.5

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

Type of Change

Resource

Method

Attribute

Resource removed

lbmonitor_lbmetrictable_binding

----------

Replaced with the resource 'lbmonitor_metric_binding'.

-

-

Method removed

vserver

GET

----------

Perform the GET operation on specific virtual server types such as lb/cr/cs.

-

filterpolicy

POST with 'action=unset'

----------

This method is removed as unsetting the attributes('action') of a policy makes it invalid.

-

auditsyslogpolicy

POST with 'action=unset'

----------

This method is removed as unsetting the attributes('action') of a policy makes it invalid.

-

auditnslogpolicy

POST with 'action=unset'

----------

This method is removed as unsetting the attributes('action') of a policy makes it invalid.

-

authorizationpolicy

POST with 'action=unset'

----------

This method is removed as unsetting the attributes('action') of a policy makes it invalid.

-

Return-type changed

snmpengineid

GET

----------

Return type changed to an array.

-

nshostname

GET

----------

Return type changed to an array.

-

Attribute-type changed

appfwpolicy_lbvserver_binding

-

activepolicy

----------

Data type changed from Boolean to Integer.

appfwpolicy_appfwglobal_binding

-

activepolicy

----------

Data type changed from Boolean to Integer.

vlan

-

portbitmap

----------

Data type changed from uint to ulong.

vlan

-

tagbitmap

----------

Data type changed from uint to ulong.

Attribute removed

policypatset_pattern_binding

-

indextype

----------

This attribute is moved to 'policypatset' resource as this attribute is applicable at patset level.

system_stats

-

powersupply1failure

----------

Replaced with 'powersupply1status'.

Note: Change is applicable from NetScaler 9.3 Build 65.8.

system_stats

-

powersupply2failure

----------

Replaced with 'powersupply2status'.

Note: Change is applicable from NetScaler 9.3 Build 65.8.

server_servicegroup_binding

-

servicetype

----------

Replaced with 'svctype'.

server_service_binding

-

servicetype

----------

Replaced with 'svctype'.

crvserver

-

hits

----------

Hits are calculated per policy binding hence moved this parameter to binding resources.

crvserver

-

dstvsvr

----------

Replaced with 'destinationvserver'.

crvserver

-

destvserver

----------

Replaced with 'domain'.

crvserver

-

dnsvserver

----------

Replaced with 'dnsvservername'.

appflowpolicylabel

-

type

----------

Replaced with 'policylabeltype'.

sslcipher

-

ciphgrpals

----------

Replaced with 'ciphergroupname'.

csvserver_cspolicy_binding

-

targetvserver

----------

Replaced with 'targetlbvserver'.

Note: This change is applicable for the 'sslcipher_*_binding' resources also.

csvserver_cspolicy_binding

-

targetvserver

----------

Replaced with 'targetlbvserver'.

rewriteaction

-

allow_unsafe_pi1, allow_unsafe_pi

----------

Replaced with 'bypassSafetyCheck'.

nsconfig -

nwfwmode

----------

Marked as a hidden attribute.

NITRO SDKs - Changes from 9.3 to 10.1/10.5

The SDK-specific changes that were made in NetScaler 10.1/10.5 when compared with NetScaler 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)

dnsaddrec

get(dnsaddrec obj, nitro_service session)

get(nitro_service session, String hostname)

dnsnsrec

get(dnsnsrec obj, nitro_service session)

get(nitro_service session, String domain)

snmpengineid

unset(nitro_service session, String[] args)

unset(nitro_service session, snmpengineid resource, String[] args)

arp

arp.get(nitro_service session, String ipaddress)

arp.get(nitro_service session, arp resource)

nsip

get(nitro_service session, String ipaddress)

get(nitro_service client, nsip resource)

nsip6

get(nitro_service session, String ipv6address)

get(nitro_service session, nsip6 resource)

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  -
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.

-

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

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

Type of Change

Resource

Attribute

Attribute removed nstrace doruntimemerge
nstrace tcpdump
cacheobject force

NITRO SDKs - Changes from 10.5 57.x to 11.0

The SDK-specific changes that were made in NetScaler 11.0 when compared with NetScaler 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)
shutdown (base_response) Shutdown(shutdown obj, nitro_service session) (base_response) Shutdown(nitro_service session)
systemfile (systemfile) get(systemfile obj, nitro_service session) -
sslfips (base_response) reset(sslfips obj, nitro_service session) (base_response) reset(nitro_service session)