Download full document:

subscribergxinterface

Configuration for Gx interface Parameters resource.

Properties

(click to see Operations)

NameData TypePermissionsDescription
vserver<String>Read-writeName of the load balancing, or content switching vserver to which the Gx connections are established. The service type of the virtual server must be DIAMETER/SSL_DIAMETER. Mutually exclusive with the service parameter. Therefore, you cannot set both service and the Virtual Server in the Gx Interface.
Minimum length = 1
service<String>Read-writeName of DIAMETER/SSL_DIAMETER service corresponding to PCRF to which the Gx connection is established. The service type of the service must be DIAMETER/SSL_DIAMETER. Mutually exclusive with vserver parameter. Therefore, you cannot set both Service and the Virtual Server in the Gx Interface.
Minimum length = 1
pcrfrealm<String>Read-writePCRF realm is of type DiameterIdentity and contains the realm of PCRF to which the message is to be routed. This is the realm used in Destination-Realm AVP by Citrix ADC Gx client (as a Diameter node).

Minimum length = 1
holdonsubscriberabsence<String>Read-writeSet this setting to yes if Citrix ADC needs to Hold pakcets till subscriber session is fetched from PCRF. Else set to NO. By default set to yes. If this setting is set to NO, then till Citrix ADC fetches subscriber from PCRF, default subscriber profile will be applied to this subscriber if configured. If default subscriber profile is also not configured an undef would be raised to expressions which use Subscriber attributes. .
Default value: YES
Possible values = YES, NO
requesttimeout<Double>Read-writeq!Time, in seconds, within which the Gx CCR request must complete. If the request does not complete within this time, the request is retransmitted for requestRetryAttempts time. If still reuqest is not complete then default subscriber profile will be applied to this subscriber if configured. If default subscriber profile is also not configured an undef would be raised to expressions which use Subscriber attributes.
Zero disables the timeout. !.
Default value: 10
Minimum value = 0
Maximum value = 86400
requestretryattempts<Double>Read-writeIf the request does not complete within requestTimeout time, the request is retransmitted for requestRetryAttempts time.
Default value: 3
idlettl<Double>Read-writeq!Idle Time, in seconds, after which the Gx CCR-U request will be sent after any PCRF activity on a session. Any RAR or CCA message resets the timer.
Zero value disables the idle timeout. !.
Default value: 900
Minimum value = 0
Maximum value = 86400
revalidationtimeout<Double>Read-writeq!Revalidation Timeout, in seconds, after which the Gx CCR-U request will be sent after any PCRF activity on a session. Any RAR or CCA message resets the timer.
Zero value disables the idle timeout. !.
Default value: 0
Minimum value = 0
Maximum value = 86400
negativettl<Double>Read-writeq!Negative TTL, in seconds, after which the Gx CCR-I request will be resent for sessions that have not been resolved by PCRF due to server being down or no response or failed response. Instead of polling the PCRF server constantly, negative-TTL makes Citrix ADC stick to un-resolved session. Meanwhile Citrix ADC installs a negative session to avoid going to PCRF.
For Negative Sessions, Netcaler inherits the attributes from default subscriber profile if default subscriber is configured. A default subscriber could be configured as 'add subscriber profile *'. Or these attributes can be inherited from Radius as well if Radius is configued.
Zero value disables the Negative Sessions. And Citrix ADC does not install Negative sessions even if subscriber session could not be fetched. !.
Default value: 600
Minimum value = 0
Maximum value = 86400
negativettllimitedsuccess<String>Read-writeSet this to YES if Citrix ADC should create negative session for Result-Code DIAMETER_LIMITED_SUCCESS (2002) received in CCA-I. If set to NO, regular session is created.
Default value: NO
Possible values = YES, NO
servicepathavp<Double[]>Read-writeThe AVP code in which PCRF sends service path applicable for subscriber.
Minimum value = 1
servicepathvendorid<Double>Read-writeThe vendorid of the AVP in which PCRF sends service path for subscriber.
nodeid<Double>Read-writeUnique number that identifies the cluster node.
Minimum value = 0
Maximum value = 31
svrstate<String>Read-onlyThe state of the gx service.
Possible values = UP, DOWN, UNKNOWN, BUSY, OUT OF SERVICE, GOING OUT OF SERVICE, DOWN WHEN GOING OUT OF SERVICE, NS_EMPTY_STR, Unknown, DISABLED
identity<String>Read-onlyDiameterIdentity to be used by NS. DiameterIdentity is used to identify a Diameter node uniquely. Before setting up diameter configuration, Citrix ADC (as a Diameter node) MUST be assigned a unique DiameterIdentity.
example =>
set ns diameter -identity Citrix ADC.com
Now whenever Citrix ADC system needs to use identity in diameter messages. It will use 'netscaler.com' as Origin-Host AVP as defined in RFC3588
.
Minimum length = 1
realm<String>Read-onlyDiameter Realm to be used by NS.
example =>
set ns diameter -realm com
Now whenever Citrix ADC system needs to use realm in diameter messages. It will use 'com' as Origin-Realm AVP as defined in RFC3588
.
Minimum length = 1
status<String>Read-onlyCitrix ADC PCRF connection Status. (Gx Protocol State).
servicepathinfomode<String>Read-onlyThe type of info in which service path is passed from PCRF,
SERVICE_FUNCTION: Denotes the service chain is passed as servicefunction names in-order in AVPS with code servicepathAVP
SERVICE_PATH: Denotes the service path name is passed in AVPS with code servicepathAVP.q.
Default value: SERVICEPATH
Possible values = SERVICEFUNCTIONS, SERVICEPATH
gxreportingavp1<Double[]>Read-onlyThe AVP code to report as 1st custom AVP.
Minimum value = 1
gxreportingavp1vendorid<Double>Read-onlyThe vendorid of the AVP which will be reported as 1st custom AVP.
gxreportingavp1type<String>Read-onlyThe type of the AVP which will be reported as 1st custom AVP.
Default value: OctetString
Possible values = OctetString, Integer32, Integer64, Unsigned32, Unsigned64, Float32, Float64
gxreportingavp2<Double[]>Read-onlyThe AVP code to report as 2nd custom AVP.
Minimum value = 1
gxreportingavp2vendorid<Double>Read-onlyThe vendorid of the AVP which will be reported as 2nd custom AVP.
gxreportingavp2type<String>Read-onlyThe type of the AVP which will be reported as 2nd custom AVP.
Default value: OctetString
Possible values = OctetString, Integer32, Integer64, Unsigned32, Unsigned64, Float32, Float64
gxreportingavp3<Double[]>Read-onlyThe AVP code to report as 3rd custom AVP.
Minimum value = 1
gxreportingavp3vendorid<Double>Read-onlyThe vendorid of the AVP which will be reported as 3rd custom AVP.
gxreportingavp3type<String>Read-onlyThe type of the AVP which will be reported as 3rd custom AVP.
Default value: OctetString
Possible values = OctetString, Integer32, Integer64, Unsigned32, Unsigned64, Float32, Float64
gxreportingavp4<Double[]>Read-onlyThe AVP code to report as 4th custom AVP.
Minimum value = 1
gxreportingavp4vendorid<Double>Read-onlyThe vendorid of the AVP which will be reported as 4th custom AVP.
gxreportingavp4type<String>Read-onlyThe type of the AVP which will be reported as 4th custom AVP.
Default value: OctetString
Possible values = OctetString, Integer32, Integer64, Unsigned32, Unsigned64, Float32, Float64
gxreportingavp5<Double[]>Read-onlyThe AVP code to report as 5th custom AVP.
Minimum value = 1
gxreportingavp5vendorid<Double>Read-onlyThe vendorid of the AVP which will be reported as 5th custom AVP.
gxreportingavp5type<String>Read-onlyThe type of the AVP which will be reported as 5th custom AVP.
Default value: OctetString
Possible values = OctetString, Integer32, Integer64, Unsigned32, Unsigned64, Float32, Float64

Operations

(click to see Properties)

UPDATE| UNSET| GET (ALL)

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>

Note:

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

update

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

HTTP Method:PUT

Request Headers:

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

Request Payload:

{"subscribergxinterface":{
"vserver":<String_value>,
"service":<String_value>,
"pcrfrealm":<String_value>,
"holdonsubscriberabsence":<String_value>,
"requesttimeout":<Double_value>,
"requestretryattempts":<Double_value>,
"idlettl":<Double_value>,
"revalidationtimeout":<Double_value>,
"negativettl":<Double_value>,
"negativettllimitedsuccess":<String_value>,
"servicepathavp":<Double[]_value>,
"servicepathvendorid":<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/subscribergxinterface?action=unset

HTTP Method:POST

Request Headers:

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

Request Payload:

{"subscribergxinterface":{
"vserver":true,
"service":true,
"holdonsubscriberabsence":true,
"requesttimeout":true,
"requestretryattempts":true,
"idlettl":true,
"revalidationtimeout":true,
"negativettl":true,
"negativettllimitedsuccess":true,
"servicepathavp":true,
"servicepathvendorid":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/subscribergxinterface

Query-parameters:

args

http://<netscaler-ip-address>/nitro/v1/config/subscribergxinterface?args=nodeid:<Double_value>

Use this query-parameter to get subscribergxinterface resources based on additional properties.

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 errorResponse Headers:

Content-Type:application/json

Response Payload:

{ "subscribergxinterface": [ {
nodeid:<Double_value>"vserver":<String_value>,
"service":<String_value>,
"svrstate":<String_value>,
"pcrfrealm":<String_value>,
"holdonsubscriberabsence":<String_value>,
"requesttimeout":<Double_value>,
"requestretryattempts":<Double_value>,
"idlettl":<Double_value>,
"revalidationtimeout":<Double_value>,
"negativettl":<Double_value>,
"negativettllimitedsuccess":<String_value>,
"identity":<String_value>,
"realm":<String_value>,
"status":<String_value>,
"servicepathavp":<Double[]_value>,
"servicepathvendorid":<Double_value>,
"servicepathinfomode":<String_value>,
"gxreportingavp1":<Double[]_value>,
"gxreportingavp1vendorid":<Double_value>,
"gxreportingavp1type":<String_value>,
"gxreportingavp2":<Double[]_value>,
"gxreportingavp2vendorid":<Double_value>,
"gxreportingavp2type":<String_value>,
"gxreportingavp3":<Double[]_value>,
"gxreportingavp3vendorid":<Double_value>,
"gxreportingavp3type":<String_value>,
"gxreportingavp4":<Double[]_value>,
"gxreportingavp4vendorid":<Double_value>,
"gxreportingavp4type":<String_value>,
"gxreportingavp5":<Double[]_value>,
"gxreportingavp5vendorid":<Double_value>,
"gxreportingavp5type":<String_value>
}]}