Home > Configuration > Integrated Caching > addcachecontentgroup

addcachecontentgroup

Use this method to creates a new content group for grouping cached objects on the basis of some unique property.

Syntax



Parameters

name

Name for the content group. Must begin with an ASCII alphabetic or underscore (_) character, and must contain only ASCII alphanumeric, underscore, hash (#), period (.), space, colon (:), at (@), equals (=), and hyphen (-) characters. Cannot be changed after the content group is created.
This is mandatory parameter.

weakposrelexpiry

Relative expiry time, in seconds, for expiring positive responses with response codes between 200 and 399. Cannot be used in combination with other Expiry attributes. Similar to -relExpiry but has lower precedence.
Default value = VAL_NOT_SET.
Maximum value = 31536000.

heurexpiryparam

Heuristic expiry time, in percent of the duration, since the object was last modified.
Default value = VAL_NOT_SET.
Maximum value = 100.

relexpiry

Relative expiry time, in seconds, after which to expire an object cached in this content group.
Default value = VAL_NOT_SET.
Maximum value = 31536000.

relexpirymillisec

Relative expiry time, in milliseconds, after which to expire an object cached in this content group.
Default value = VAL_NOT_SET.
Maximum value = 86400000.

absexpiry

Local time, up to 4 times a day, at which all objects in the content group must expire. CLI Users: For example, to specify that the objects in the content group should expire by 11:00 PM, type the following method: add cache contentgroup -absexpiry 23:00 To specify that the objects in the content group should expire at 10:00 AM, 3 PM, 6 PM, and 11:00 PM, type: add cache contentgroup -absexpiry 10:00 15:00 18:00 23:00

absexpirygmt

Coordinated Universal Time (GMT), up to 4 times a day, when all objects in the content group must expire.

weaknegrelexpiry

Relative expiry time, in seconds, for expiring negative responses. This value is used only if the expiry time cannot be determined from any other source. It is applicable only to the following status codes: 307, 403, 404, and 410.
Default value = VAL_NOT_SET.
Maximum value = 31536000.

hitparams

Parameters to use for parameterized hit evaluation of an object. Up to 128 parameters can be specified. Mutually exclusive with the Hit Selector parameter.

invalparams

Parameters for parameterized invalidation of an object. You can specify up to 8 parameters. Mutually exclusive with invalSelector.

ignoreparamvaluecase

Ignore case when comparing parameter values during parameterized hit evaluation. (Parameter value case is ignored by default during parameterized invalidation.)
Default value = VAL_NOT_SET.

matchcookies

Evaluate for parameters in the cookie header also.
Default value = VAL_NOT_SET.

invalrestrictedtohost

Take the host header into account during parameterized invalidation.
Default value = VAL_NOT_SET.

polleverytime

Always poll for the objects in this content group. That is, retrieve the objects from the origin server whenever they are requested.
Default value = NO.

ignorereloadreq

Ignore any request to reload a cached object from the origin server. To guard against Denial of Service attacks, set this parameter to YES. For RFC-compliant behavior, set it to NO.
Default value = YES.

removecookies

Remove cookies from responses.
Default value = YES.

prefetch

Attempt to refresh objects that are about to go stale.
Default value = YES.

prefetchperiod

Time period, in seconds before an object's calculated expiry time, during which to attempt prefetch.
Default value = VAL_NOT_SET.
Maximum value = MAX_PREFETCH_SECS.

prefetchperiodmillisec

Time period, in milliseconds before an object's calculated expiry time, during which to attempt prefetch.
Default value = VAL_NOT_SET.
Maximum value = MAX_PREFETCH_MSECS.

prefetchmaxpending

Maximum number of outstanding prefetches that can be queued for the content group.
Default value = VAL_NOT_SET.
Maximum value = 0xFFFFFFFE.

flashcache

Perform flash cache. Mutually exclusive with Poll Every Time (PET) on the same content group.
Default value = NO.

expireatlastbyte

Force expiration of the content immediately after the response is downloaded (upon receipt of the last byte of the response body). Applicable only to positive responses.
Default value = NO.

insertvia

Insert a Via header into the response.
Default value = YES.

insertage

Insert an Age header into the response. An Age header contains information about the age of the object, in seconds, as calculated by the integrated cache.
Default value = YES.

insertetag

Insert an ETag header in the response. With ETag header insertion, the integrated cache does not serve full responses on repeat requests.
Default value = YES.

cachecontrol

Insert a Cache-Control header into the response.

quickabortsize

If the size of an object that is being downloaded is less than or equal to the quick abort value, and a client aborts during the download, the cache stops downloading the response. If the object is larger than the quick abort size, the cache continues to download the response.
Default value = 4194303.
Maximum value = 4194303.

minressize

Minimum size of a response that can be cached in this content group. Default minimum response size is 0.
Maximum value = 2097151.

maxressize

Maximum size of a response that can be cached in this content group.
Default value = 80.
Maximum value = 2097151.

memlimit

Maximum amount of memory that the cache can use. The effective limit is based on the available memory of the Citrix ADC.
Default value = 65536.

ignorereqcachinghdrs

Ignore Cache-Control and Pragma headers in the incoming request.
Default value = YES.

minhits

Number of hits that qualifies a response for storage in this content group.
Default value = 0.

alwaysevalpolicies

Force policy evaluation for each response arriving from the origin server. Cannot be set to YES if the Prefetch parameter is also set to YES.
Default value = NO.

persistha

Setting persistHA to YES causes IC to save objects in contentgroup to Secondary node in HA deployment.
Default value = NO.

pinned

Do not flush objects from this content group under memory pressure.
Default value = NO.

lazydnsresolve

Perform DNS resolution for responses only if the destination IP address in the request does not match the destination IP address of the cached response.
Default value = YES.

hitselector

Selector for evaluating whether an object gets stored in a particular content group. A selector is an abstraction for a collection of PIXL expressions.

invalselector

Selector for invalidating objects in the content group. A selector is an abstraction for a collection of PIXL expressions.

type

The type of the content group.
Default value = NSSVC_HTTP.

Return Value

Returns simpleResult

See Also