-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
nshttpprofile
-
-
-
-
-
-
-
-
videooptimizationdetectionpolicylabel_videooptimizationdetectionpolicy_binding
-
videooptimizationdetectionpolicy_videooptimizationglobaldetection_binding
-
videooptimizationglobaldetection_videooptimizationdetectionpolicy_binding
-
videooptimizationglobalpacing_videooptimizationpacingpolicy_binding
-
videooptimizationpacingpolicylabel_videooptimizationpacingpolicy_binding
-
videooptimizationpacingpolicy_videooptimizationglobalpacing_binding
-
This content has been machine translated dynamically.
Dieser Inhalt ist eine maschinelle Übersetzung, die dynamisch erstellt wurde. (Haftungsausschluss)
Cet article a été traduit automatiquement de manière dynamique. (Clause de non responsabilité)
Este artículo lo ha traducido una máquina de forma dinámica. (Aviso legal)
此内容已经过机器动态翻译。 放弃
このコンテンツは動的に機械翻訳されています。免責事項
이 콘텐츠는 동적으로 기계 번역되었습니다. 책임 부인
Este texto foi traduzido automaticamente. (Aviso legal)
Questo contenuto è stato tradotto dinamicamente con traduzione automatica.(Esclusione di responsabilità))
This article has been machine translated.
Dieser Artikel wurde maschinell übersetzt. (Haftungsausschluss)
Ce article a été traduit automatiquement. (Clause de non responsabilité)
Este artículo ha sido traducido automáticamente. (Aviso legal)
この記事は機械翻訳されています.免責事項
이 기사는 기계 번역되었습니다.책임 부인
Este artigo foi traduzido automaticamente.(Aviso legal)
这篇文章已经过机器翻译.放弃
Questo articolo è stato tradotto automaticamente.(Esclusione di responsabilità))
Translation failed!
nshttpprofile
Configuration for HTTP profile resource.
Properties
(click to see Operations )
Name | Data Type | Permissions | Description |
---|---|---|---|
name |
|
Read-write | Name for an HTTP profile. Must begin with a letter, number, or the underscore (_) character. Other characters allowed, after the first character, are the hyphen (-), period (.), hash (#), space ( ), at (@), colon (:), and equal (=) characters. The name of a HTTP profile cannot be changed after it is created.
CLI Users: If the name includes one or more spaces, enclose the name in double or single quotation marks (for example, “my http profile” or ‘my http profile’). Minimum length = 1 Maximum length = 127 |
dropinvalreqs |
|
Read-write | Drop invalid HTTP requests or responses.
Default value: DISABLED Possible values = ENABLED, DISABLED |
markhttp09inval |
|
Read-write | Mark HTTP/0.9 requests as invalid.
Default value: DISABLED Possible values = ENABLED, DISABLED |
markconnreqinval |
|
Read-write | Mark CONNECT requests as invalid.
Default value: DISABLED Possible values = ENABLED, DISABLED |
marktracereqinval |
|
Read-write | Mark TRACE requests as invalid.
Default value: DISABLED Possible values = ENABLED, DISABLED |
markrfc7230noncompliantinval |
|
Read-write | Mark RFC7230 non-compliant transaction as invalid.
Default value: DISABLED Possible values = ENABLED, DISABLED |
markhttpheaderextrawserror |
|
Read-write | Mark Http header with extra white space as invalid.
Default value: DISABLED Possible values = ENABLED, DISABLED |
cmponpush |
|
Read-write | Start data compression on receiving a TCP packet with PUSH flag set.
Default value: DISABLED Possible values = ENABLED, DISABLED |
conmultiplex |
|
Read-write | Reuse server connections for requests from more than one client connections.
Default value: ENABLED Possible values = ENABLED, DISABLED |
maxreusepool |
|
Read-write | Maximum limit on the number of connections, from the Citrix ADC to a particular server that are kept in the reuse pool. This setting is helpful for optimal memory utilization and for reducing the idle connections to the server just after the peak time. Zero implies no limit on reuse pool size. If non-zero value is given, it has to be greater than or equal to the number of running Packet Engines.
Default value: 0 Minimum value = 0 Maximum value = 360000 |
dropextracrlf |
|
Read-write | Drop any extra ‘CR’ and ‘LF’ characters present after the header.
Default value: ENABLED Possible values = ENABLED, DISABLED |
incomphdrdelay |
|
Read-write | Maximum time to wait, in milliseconds, between incomplete header packets. If the header packets take longer to arrive at Citrix ADC, the connection is silently dropped.
Default value: 7000 Minimum value = 1 Maximum value = 360000 |
websocket |
|
Read-write | HTTP connection to be upgraded to a web socket connection. Once upgraded, Citrix ADC does not process Layer 7 traffic on this connection.
Default value: DISABLED Possible values = ENABLED, DISABLED |
rtsptunnel |
|
Read-write | Allow RTSP tunnel in HTTP. Once application/x-rtsp-tunnelled is seen in Accept or Content-Type header, Citrix ADC does not process Layer 7 traffic on this connection.
Default value: DISABLED Possible values = ENABLED, DISABLED |
reqtimeout |
|
Read-write | Time, in seconds, within which the HTTP request must complete. If the request does not complete within this time, the specified request timeout action is executed. Zero disables the timeout.
Default value: 0 Minimum value = 0 Maximum value = 86400 |
adpttimeout |
|
Read-write | Adapts the configured request timeout based on flow conditions. The timeout is increased or decreased internally and applied on the flow.
Default value: DISABLED Possible values = ENABLED, DISABLED |
reqtimeoutaction |
|
Read-write | Action to take when the HTTP request does not complete within the specified request timeout duration. You can configure the following actions
|
dropextradata |
|
Read-write | Drop any extra data when server sends more data than the specified content-length.
Default value: DISABLED Possible values = ENABLED, DISABLED |
weblog |
|
Read-write | Enable or disable web logging.
Default value: ENABLED Possible values = ENABLED, DISABLED |
clientiphdrexpr |
|
Read-write | Name of the header that contains the real client IP address. |
maxreq |
|
Read-write | Maximum number of requests allowed on a single connection. Zero implies no limit on the number of requests.
Default value: 0 Minimum value = 0 Maximum value = 65534 |
persistentetag |
|
Read-write | Generate the persistent Citrix ADC specific ETag for the HTTP response with ETag header.
Default value: DISABLED Possible values = ENABLED, DISABLED |
http2 |
|
Read-write | Choose whether to enable support for HTTP/2.
Default value: DISABLED Possible values = ENABLED, DISABLED |
http2direct |
|
Read-write | Choose whether to enable support for Direct HTTP/2.
Default value: DISABLED Possible values = ENABLED, DISABLED |
http2strictcipher |
|
Read-write | Choose whether to enable strict HTTP/2 cipher selection.
Default value: ENABLED Possible values = ENABLED, DISABLED |
http2altsvcframe |
|
Read-write | Choose whether to enable support for sending HTTP/2 ALTSVC frames. When enabled, the ADC sends HTTP/2 ALTSVC frames to HTTP/2 clients, instead of the Alt-Svc response header field. Not applicable to servers.
Default value: DISABLED Possible values = ENABLED, DISABLED |
altsvc |
|
Read-write | Choose whether to enable support for Alternative Services.
Default value: DISABLED Possible values = ENABLED, DISABLED |
altsvcvalue |
|
Read-write | Configure a custom Alternative Services header value that should be inserted in the response to advertise a HTTP/SSL/HTTP_QUIC vserver. |
reusepooltimeout |
|
Read-write | Idle timeout (in seconds) for server connections in re-use pool. Connections in the re-use pool are flushed, if they remain idle for the configured timeout.
Default value: 0 Minimum value = 0 Maximum value = 31536000 |
maxheaderlen |
|
Read-write | Number of bytes to be queued to look for complete header before returning error. If complete header is not obtained after queuing these many bytes, request will be marked as invalid and no L7 processing will be done for that TCP connection.
Default value: 24820 Minimum value = 2048 Maximum value = 122880 |
maxheaderfieldlen |
|
Read-write | Number of bytes allowed for header field for HTTP header. If number of bytes exceeds beyond configured value, then request will be marked invalid.
Default value: 24820 Minimum value = 2048 Maximum value = 122880 |
minreusepool |
|
Read-write | Minimum limit on the number of connections, from the Citrix ADC to a particular server that are kept in the reuse pool. This setting is helpful for optimal memory utilization and for reducing the idle connections to the server just after the peak time. Zero implies no limit on reuse pool size.
Default value: 0 Minimum value = 0 Maximum value = 360000 |
http2maxheaderlistsize |
|
Read-write | Maximum size of header list that the Citrix ADC is prepared to accept, in bytes. NOTE: The actual plain text header size that the Citrix ADC accepts is limited by maxHeaderLen. Please change maxHeaderLen parameter as well when modifying http2MaxHeaderListSize.
Default value: 24576 Minimum value = 8192 Maximum value = 131071 |
http2maxframesize |
|
Read-write | Maximum size of the frame payload that the Citrix ADC is willing to receive, in bytes.
Default value: 16384 Minimum value = 16384 Maximum value = 32768 |
http2maxconcurrentstreams |
|
Read-write | Maximum number of concurrent streams that is allowed per connection.
Default value: 100 Minimum value = 0 Maximum value = 1000 |
http2initialconnwindowsize |
|
Read-write | Initial window size for connection level flow control, in bytes.
Default value: 65535 Minimum value = 65535 Maximum value = 67108864 |
http2initialwindowsize |
|
Read-write | Initial window size for stream level flow control, in bytes.
Default value: 65535 Minimum value = 8192 Maximum value = 20971520 |
http2headertablesize |
|
Read-write | Maximum size of the header compression table used to decode header blocks, in bytes.
Default value: 4096 Minimum value = 0 Maximum value = 131072 |
http2minseverconn |
|
Read-write | Minimum number of HTTP2 connections established to backend server, on receiving HTTP requests from client before multiplexing the streams into the available HTTP/2 connections.
Default value: 20 Minimum value = 1 Maximum value = 360000 |
http2maxpingframespermin |
|
Read-write | Maximum number of PING frames allowed in HTTP2 connection per minute.
Default value: 60 Minimum value = 1 Maximum value = 360000 |
http2maxsettingsframespermin |
|
Read-write | Maximum number of SETTINGS frames allowed in HTTP2 connection per minute.
Default value: 15 Minimum value = 1 Maximum value = 360000 |
http2maxresetframespermin |
|
Read-write | Maximum number of outgoing RST_STREAM frames allowed in HTTP/2 connection per minute.
Default value: 90 Minimum value = 1 Maximum value = 360000 |
http2maxemptyframespermin |
|
Read-write | Maximum number of empty frames allowed in HTTP2 connection per minute.
Default value: 60 Minimum value = 1 Maximum value = 360000 |
http2maxrxresetframespermin |
|
Read-write | Maximum number of incoming RST_STREAM frames allowed in HTTP/2 connection per minute.
Default value: 0 Minimum value = 0 Maximum value = 360000 |
grpcholdlimit |
|
Read-write | Maximum size in bytes allowed to buffer gRPC packets till trailer is received.
Default value: 131072 Minimum value = 0 Maximum value = 33554432 |
grpcholdtimeout |
|
Read-write | Maximum time in milliseconds allowed to buffer gRPC packets till trailer is received. The value should be in multiples of 100.
Default value: 1000 Minimum value = 0 Maximum value = 180000 |
grpclengthdelimitation |
|
Read-write | Set to DISABLED for gRPC without a length delimitation.
Default value: ENABLED Possible values = ENABLED, DISABLED |
apdexcltresptimethreshold |
|
Read-write | This option sets the satisfactory threshold (T) for client response time in milliseconds to be used for APDEX calculations. This means a transaction responding in less than this threshold is considered satisfactory. Transaction responding between T and 4T is considered tolerable. Any transaction responding in more than 4T time is considered frustrating. Citrix ADC maintains stats for such tolerable and frustrating transcations. And client response time related apdex counters are only updated on a vserver which receives clients traffic.
Default value: 500 Minimum value = 1 Maximum value = 3600000 |
http3 |
|
Read-write | Choose whether to enable support for HTTP/3.
Default value: DISABLED Possible values = ENABLED, DISABLED |
http3maxheaderfieldsectionsize |
|
Read-write | Maximum size of the HTTP/3 header field section, in bytes.
Default value: 24576 Minimum value = 8192 Maximum value = 131072 |
http3maxheadertablesize |
|
Read-write | Maximum size of the HTTP/3 QPACK dynamic header table, in bytes.
Default value: 4096 Minimum value = 0 Maximum value = 131072 |
http3maxheaderblockedstreams |
|
Read-write | Maximum number of HTTP/3 streams that can be blocked while HTTP/3 headers are being decoded.
Default value: 100 Minimum value = 1 Maximum value = 500 |
http3webtransport |
|
Read-write | Choose whether to enable support for WebTransport over HTTP/3.
Default value: DISABLED Possible values = ENABLED, DISABLED |
httppipelinebuffsize |
|
Read-write | Application pipeline request buffering size, in bytes.
Default value: 131072 Minimum value = 131072 Maximum value = 20971520 |
allowonlywordcharactersandhyphen |
|
Read-write | When enabled allows only the word characters [A-Za-z0-9_] and hyphen [-] in the request/response header names and the connection will be reset for the other characters. When disabled allows any visible (printing) characters (%21-%7E) except delimiters (double quotes and “(),/:;<=>?@[]{}”).
Default value: DISABLED Possible values = ENABLED, DISABLED |
hostheadervalidation |
|
Read-write | Validates the length of the Host header and its syntax. Also includes validation of the port number if specified.
Default value: DISABLED Possible values = ENABLED, DISABLED |
passprotocolupgrade |
|
Read-write | Pass protocol upgrade request to the server.
Default value: ENABLED Possible values = ENABLED, DISABLED |
refcnt |
|
Read-only | Number of entities using this profile. |
builtin | <String[]> | Read-only | Flag to determine if http profile is built-in or not.
Possible values = MODIFIABLE, DELETABLE, IMMUTABLE, PARTITION_ALL |
apdexsvrresptimethreshold |
|
Read-only | This option sets the satisfactory threshold (T) for server response time in milliseconds to be used for APDEX calculations. This means a transaction responding in less than this threshold is considered satisfactory. Transaction responding between T and 4T is considered tolerable. Any transaction responding in more than 4T time is considered frustrating. Citrix ADC maintains stats for such tolerable and frustrating transcations. Server Response time related apdex counters are only updated on backend services or a backend vserver which is not accepting client traffic.
Default value: 400 Minimum value = 1 Maximum value = 3600000 |
dropinvalreqswarning |
|
Read-only | Display warning if Drop invalid reqs is disabled in the profile.
Default value: 0 Possible values = Secure deployment guide : This http profile is insecure. To keep it secure enable - Drop invalid HTTP requests |
feature |
|
Read-only | The feature to be checked while applying this config. |
__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 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
red
and placeholder content is marked in
green
add
URL: http:// <netscaler-ip-address> /nitro/v1/config/nshttpprofile HTTP Method: POST
Request Headers:
Cookie:NITRO_AUTH_TOKEN= <tokenvalue>
Content-Type:application/json
Request Payload:
{"nshttpprofile":{
<b>"name":<String_value>,
</b>"dropinvalreqs":<String_value>,
"markhttp09inval":<String_value>,
"markconnreqinval":<String_value>,
"marktracereqinval":<String_value>,
"markrfc7230noncompliantinval":<String_value>,
"markhttpheaderextrawserror":<String_value>,
"cmponpush":<String_value>,
"conmultiplex":<String_value>,
"maxreusepool":<Double_value>,
"dropextracrlf":<String_value>,
"incomphdrdelay":<Double_value>,
"websocket":<String_value>,
"rtsptunnel":<String_value>,
"reqtimeout":<Double_value>,
"adpttimeout":<String_value>,
"reqtimeoutaction":<String_value>,
"dropextradata":<String_value>,
"weblog":<String_value>,
"clientiphdrexpr":<String_value>,
"maxreq":<Double_value>,
"persistentetag":<String_value>,
"http2":<String_value>,
"http2direct":<String_value>,
"http2strictcipher":<String_value>,
"http2altsvcframe":<String_value>,
"altsvc":<String_value>,
"altsvcvalue":<String_value>,
"reusepooltimeout":<Double_value>,
"maxheaderlen":<Double_value>,
"maxheaderfieldlen":<Double_value>,
"minreusepool":<Double_value>,
"http2maxheaderlistsize":<Double_value>,
"http2maxframesize":<Double_value>,
"http2maxconcurrentstreams":<Double_value>,
"http2initialconnwindowsize":<Double_value>,
"http2initialwindowsize":<Double_value>,
"http2headertablesize":<Double_value>,
"http2minseverconn":<Double_value>,
"http2maxpingframespermin":<Double_value>,
"http2maxsettingsframespermin":<Double_value>,
"http2maxresetframespermin":<Double_value>,
"http2maxemptyframespermin":<Double_value>,
"http2maxrxresetframespermin":<Double_value>,
"grpcholdlimit":<Double_value>,
"grpcholdtimeout":<Double_value>,
"grpclengthdelimitation":<String_value>,
"apdexcltresptimethreshold":<Double_value>,
"http3":<String_value>,
"http3maxheaderfieldsectionsize":<Double_value>,
"http3maxheadertablesize":<Double_value>,
"http3maxheaderblockedstreams":<Double_value>,
"http3webtransport":<String_value>,
"httppipelinebuffsize":<Double_value>,
"allowonlywordcharactersandhyphen":<String_value>,
"hostheadervalidation":<String_value>,
"passprotocolupgrade":<String_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/nshttpprofile/ name_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/nshttpprofile HTTP Method: PUT
Request Headers:
Cookie:NITRO_AUTH_TOKEN= <tokenvalue>
Content-Type:application/json
Request Payload:
{"nshttpprofile":{
<b>"name":<String_value>,
</b>"dropinvalreqs":<String_value>,
"markhttp09inval":<String_value>,
"markconnreqinval":<String_value>,
"marktracereqinval":<String_value>,
"markrfc7230noncompliantinval":<String_value>,
"markhttpheaderextrawserror":<String_value>,
"cmponpush":<String_value>,
"conmultiplex":<String_value>,
"maxreusepool":<Double_value>,
"dropextracrlf":<String_value>,
"incomphdrdelay":<Double_value>,
"websocket":<String_value>,
"rtsptunnel":<String_value>,
"reqtimeout":<Double_value>,
"adpttimeout":<String_value>,
"reqtimeoutaction":<String_value>,
"dropextradata":<String_value>,
"weblog":<String_value>,
"clientiphdrexpr":<String_value>,
"maxreq":<Double_value>,
"persistentetag":<String_value>,
"http2":<String_value>,
"http2direct":<String_value>,
"http2strictcipher":<String_value>,
"http2altsvcframe":<String_value>,
"altsvc":<String_value>,
"altsvcvalue":<String_value>,
"http2maxheaderlistsize":<Double_value>,
"http2maxframesize":<Double_value>,
"http2maxconcurrentstreams":<Double_value>,
"http2initialconnwindowsize":<Double_value>,
"http2initialwindowsize":<Double_value>,
"http2headertablesize":<Double_value>,
"http2minseverconn":<Double_value>,
"http2maxpingframespermin":<Double_value>,
"http2maxsettingsframespermin":<Double_value>,
"http2maxresetframespermin":<Double_value>,
"http2maxemptyframespermin":<Double_value>,
"http2maxrxresetframespermin":<Double_value>,
"grpcholdlimit":<Double_value>,
"grpcholdtimeout":<Double_value>,
"grpclengthdelimitation":<String_value>,
"reusepooltimeout":<Double_value>,
"maxheaderlen":<Double_value>,
"maxheaderfieldlen":<Double_value>,
"minreusepool":<Double_value>,
"apdexcltresptimethreshold":<Double_value>,
"http3":<String_value>,
"http3maxheaderfieldsectionsize":<Double_value>,
"http3maxheadertablesize":<Double_value>,
"http3maxheaderblockedstreams":<Double_value>,
"http3webtransport":<String_value>,
"httppipelinebuffsize":<Double_value>,
"allowonlywordcharactersandhyphen":<String_value>,
"hostheadervalidation":<String_value>,
"passprotocolupgrade":<String_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/nshttpprofile? action=unset HTTP Method: POST
Request Headers:
Cookie:NITRO_AUTH_TOKEN= <tokenvalue>
Content-Type:application/json
Request Payload:
{"nshttpprofile":{
<b>"name":<String_value>,
</b>"dropinvalreqs":true,
"markhttp09inval":true,
"markconnreqinval":true,
"marktracereqinval":true,
"markrfc7230noncompliantinval":true,
"markhttpheaderextrawserror":true,
"cmponpush":true,
"conmultiplex":true,
"maxreusepool":true,
"dropextracrlf":true,
"incomphdrdelay":true,
"websocket":true,
"dropextradata":true,
"clientiphdrexpr":true,
"reqtimeout":true,
"adpttimeout":true,
"reqtimeoutaction":true,
"weblog":true,
"maxreq":true,
"persistentetag":true,
"http2":true,
"http2maxheaderlistsize":true,
"http2maxframesize":true,
"http2maxconcurrentstreams":true,
"http2initialwindowsize":true,
"http2headertablesize":true,
"http2minseverconn":true,
"http2maxpingframespermin":true,
"http2maxsettingsframespermin":true,
"http2maxresetframespermin":true,
"http2maxemptyframespermin":true,
"http2maxrxresetframespermin":true,
"http2altsvcframe":true,
"altsvcvalue":true,
"reusepooltimeout":true,
"maxheaderlen":true,
"rtsptunnel":true,
"minreusepool":true,
"apdexcltresptimethreshold":true,
"http3":true,
"http3maxheaderfieldsectionsize":true,
"http3maxheadertablesize":true,
"http3maxheaderblockedstreams":true,
"http3webtransport":true,
"httppipelinebuffsize":true,
"allowonlywordcharactersandhyphen":true,
"hostheadervalidation":true,
"passprotocolupgrade":true,
"http2direct":true,
"http2strictcipher":true,
"altsvc":true,
"http2initialconnwindowsize":true,
"grpcholdlimit":true,
"grpcholdtimeout":true,
"grpclengthdelimitation":true,
"maxheaderfieldlen":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/nshttpprofile Query-parameters: attrs http:// <netscaler-ip-address> /nitro/v1/config/nshttpprofile? 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/nshttpprofile? filter=property-name1:property-val1,property-name2:property-val2
Use this query-parameter to get the filtered set of nshttpprofile resources configured on NetScaler.Filtering can be done on any of the properties of the resource.
view http:// <netscaler-ip-address> /nitro/v1/config/nshttpprofile? view=summary
Use this query-parameter to get the summary output of nshttpprofile resources configured on NetScaler.
Note: By default, the retrieved results are displayed in detail view (?view=detail).
pagination http:// <netscaler-ip-address> /nitro/v1/config/nshttpprofile? pagesize=#no;pageno=#no
Use this query-parameter to get the nshttpprofile 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 Header:
Content-Type:application/json
Response Payload:
{ "nshttpprofile": [ {
"name":<String_value>,
"dropinvalreqs":<String_value>,
"markhttp09inval":<String_value>,
"markconnreqinval":<String_value>,
"marktracereqinval":<String_value>,
"markrfc7230noncompliantinval":<String_value>,
"markhttpheaderextrawserror":<String_value>,
"cmponpush":<String_value>,
"conmultiplex":<String_value>,
"maxreusepool":<Double_value>,
"websocket":<String_value>,
"refcnt":<Double_value>,
"dropextracrlf":<String_value>,
"incomphdrdelay":<Double_value>,
"reqtimeout":<Double_value>,
"adpttimeout":<String_value>,
"reqtimeoutaction":<String_value>,
"dropextradata":<String_value>,
"weblog":<String_value>,
"clientiphdrexpr":<String_value>,
"maxreq":<Double_value>,
"persistentetag":<String_value>,
"http2":<String_value>,
"http2direct":<String_value>,
"http2strictcipher":<String_value>,
"http2altsvcframe":<String_value>,
"altsvc":<String_value>,
"altsvcvalue":<String_value>,
"http2maxheaderlistsize":<Double_value>,
"http2maxframesize":<Double_value>,
"http2maxconcurrentstreams":<Double_value>,
"http2initialconnwindowsize":<Double_value>,
"http2initialwindowsize":<Double_value>,
"http2headertablesize":<Double_value>,
"http2minseverconn":<Double_value>,
"http2maxpingframespermin":<Double_value>,
"http2maxsettingsframespermin":<Double_value>,
"http2maxresetframespermin":<Double_value>,
"http2maxemptyframespermin":<Double_value>,
"http2maxrxresetframespermin":<Double_value>,
"grpcholdlimit":<Double_value>,
"grpcholdtimeout":<Double_value>,
"grpclengthdelimitation":<String_value>,
"reusepooltimeout":<Double_value>,
"maxheaderlen":<Double_value>,
"maxheaderfieldlen":<Double_value>,
"rtsptunnel":<String_value>,
"minreusepool":<Double_value>,
"builtin":<String[]_value>,
"apdexsvrresptimethreshold":<Double_value>,
"apdexcltresptimethreshold":<Double_value>,
"http3":<String_value>,
"http3maxheaderfieldsectionsize":<Double_value>,
"http3maxheadertablesize":<Double_value>,
"http3maxheaderblockedstreams":<Double_value>,
"http3webtransport":<String_value>,
"httppipelinebuffsize":<Double_value>,
"allowonlywordcharactersandhyphen":<String_value>,
"hostheadervalidation":<String_value>,
"dropinvalreqswarning":<String_value>,
"passprotocolupgrade":<String_value>,
"feature":<String_value>
}]}
get
URL: http:// <netscaler-ip-address> /nitro/v1/config/nshttpprofile/ name_value<String> Query-parameters: attrs http:// <netscaler-ip-address> /nitro/v1/config/nshttpprofile/ name_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/nshttpprofile/ name_value<String> ? view=summary
Use this query-parameter to get the summary output of nshttpprofile resources configured on NetScaler.
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 Header:
Content-Type:application/json
Response Payload:
{ "nshttpprofile": [ {
"name":<String_value>,
"dropinvalreqs":<String_value>,
"markhttp09inval":<String_value>,
"markconnreqinval":<String_value>,
"marktracereqinval":<String_value>,
"markrfc7230noncompliantinval":<String_value>,
"markhttpheaderextrawserror":<String_value>,
"cmponpush":<String_value>,
"conmultiplex":<String_value>,
"maxreusepool":<Double_value>,
"websocket":<String_value>,
"refcnt":<Double_value>,
"dropextracrlf":<String_value>,
"incomphdrdelay":<Double_value>,
"reqtimeout":<Double_value>,
"adpttimeout":<String_value>,
"reqtimeoutaction":<String_value>,
"dropextradata":<String_value>,
"weblog":<String_value>,
"clientiphdrexpr":<String_value>,
"maxreq":<Double_value>,
"persistentetag":<String_value>,
"http2":<String_value>,
"http2direct":<String_value>,
"http2strictcipher":<String_value>,
"http2altsvcframe":<String_value>,
"altsvc":<String_value>,
"altsvcvalue":<String_value>,
"http2maxheaderlistsize":<Double_value>,
"http2maxframesize":<Double_value>,
"http2maxconcurrentstreams":<Double_value>,
"http2initialconnwindowsize":<Double_value>,
"http2initialwindowsize":<Double_value>,
"http2headertablesize":<Double_value>,
"http2minseverconn":<Double_value>,
"http2maxpingframespermin":<Double_value>,
"http2maxsettingsframespermin":<Double_value>,
"http2maxresetframespermin":<Double_value>,
"http2maxemptyframespermin":<Double_value>,
"http2maxrxresetframespermin":<Double_value>,
"grpcholdlimit":<Double_value>,
"grpcholdtimeout":<Double_value>,
"grpclengthdelimitation":<String_value>,
"reusepooltimeout":<Double_value>,
"maxheaderlen":<Double_value>,
"maxheaderfieldlen":<Double_value>,
"rtsptunnel":<String_value>,
"minreusepool":<Double_value>,
"builtin":<String[]_value>,
"apdexsvrresptimethreshold":<Double_value>,
"apdexcltresptimethreshold":<Double_value>,
"http3":<String_value>,
"http3maxheaderfieldsectionsize":<Double_value>,
"http3maxheadertablesize":<Double_value>,
"http3maxheaderblockedstreams":<Double_value>,
"http3webtransport":<String_value>,
"httppipelinebuffsize":<Double_value>,
"allowonlywordcharactersandhyphen":<String_value>,
"hostheadervalidation":<String_value>,
"dropinvalreqswarning":<String_value>,
"passprotocolupgrade":<String_value>,
"feature":<String_value>
}]}
count
URL: http:// <netscaler-ip-address> /nitro/v1/config/nshttpprofile? 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 Header:
Content-Type:application/json
Response Payload:
{ "nshttpprofile": [ { "__count": "#no"} ] }
In this article
This Preview product documentation is Citrix Confidential.
You agree to hold this documentation confidential pursuant to the terms of your Citrix Beta/Tech Preview Agreement.
The development, release and timing of any features or functionality described in the Preview documentation remains at our sole discretion and are subject to change without notice or consultation.
The documentation is for informational purposes only and is not a commitment, promise or legal obligation to deliver any material, code or functionality and should not be relied upon in making Citrix product purchase decisions.
If you do not agree, select I DO NOT AGREE to exit.