Get Cache Control Rules

Get cache control rules for website accleration domain.

Request

Request-Line

GET /waap/v1.0/services/{serviceId}/cacheControls HTTP/1.1

Request Parameters

Path Parameters

Parameter	Type	Required	Description
serviceId	Integer	Mandatory	Service ID.

Response

Response Body

Parameter	Type	Required	Description
	Array	Mandatory	Array of Url Cache Controls Rule.

Object: Url Cache Controls Rule

Parameter	Type	Required	Description
ruleId	Integer	Mandatory	Rule ID number for access control.
name	String	Mandatory	Rule name for access control.
matchUrlPath	Object	Mandatory	URL path matching configuration that determines which requests the rule applies to. See Match Url Path for details.
matchQueryString	Object	Optional	Query-string matching configuration used to refine which requests the rule applies to. See Match Query String for details.
priority	Integer	Mandatory	Priority weight for the rule. Rules with a higher weight take precedence. The weight must be non-zero.
ttl	Long	Optional	Time-to-live (TTL) in seconds for content cached at the edge. If omitted, the origin cache TTL is used.
ignoreClientNoCache	Boolean	Mandatory	True or false to ignore no-cache header(s) sent by the client.
ignoreOriginNoCache	Boolean	Mandatory	True or false to ignore no-cache header(s) sent by the origin server.
ignoreQueryString	Boolean	Mandatory	True or false to ignore any URL query string when caching contents.
enableXCache	Boolean	Mandatory	When enabled all responses from the edge have X-Cache header with values like "HIT from da01.xy01.swiftserve.com", showing whether the response was served from the cache (at least partially) or not.
neverCache	Boolean	Mandatory	Do not cache the content even if the origin presents it as cacheable.
varyMIMEs	String[]	Optional	Configures so-called "vary for images" feature.Contains a list of mime types, preferred for objects matched by the rule. Supported values: image/webp, image/avif, image/jpeg, image/jpg, image/png
enabled	Boolean	Mandatory	Flag indicating whether the rule is active.

Object: Match Url Path

Parameter	Type	Required	Description
operator	String	Mandatory	Defines how to match the field. Supported values:prefix,regex,equals,suffix.
patterns	String[]	Mandatory	List of patterns to match what against. If any of the patterns matches then the match succeeds.

Object: Match Query String

Parameter	Type	Required	Description
operator	String	Mandatory	Defines how to match the field. Supported values:prefix,regex,equals,suffix.
patterns	String[]	Mandatory	List of patterns to match what against. If any of the patterns matches then the match succeeds.

Status Codes, Error Codes and Error Messages

Status Code	Error Code	Error Message
400	ServiceId.Invalid	ServiceId is empty or invalid.
400	CacheControl.OperationFailed	The cache control operation failed.
404	ServiceId.NotFound	ServiceId is not found.

Examples

Get Cache Control Rules

Request

GET /waap/v1.0/services/12345/cacheControls HTTP/1.1

Successful Response Body

[
    {
        "ruleId": 261699,
        "name": "test1",
        "matchUrlPath": {
            "operator": "prefix",
            "patterns": [
                "/"
            ]
        },
        "priority": 1023,
        "ignoreClientNoCache": false,
        "ignoreOriginNoCache": false,
        "ignoreQueryString": false,
        "enableXCache": false,
        "neverCache": false,
        "enabled": true
    },
    {
        "ruleId": 261700,
        "name": "test",
        "matchUrlPath": {
            "operator": "prefix",
            "patterns": [
                "/"
            ]
        },
        "matchQueryString": {
            "operator": "prefix",
            "patterns": [
                "name1=1",
                "name2=2"
            ]
        },
        "priority": 1,
        "ttl": 100,
        "ignoreClientNoCache": true,
        "ignoreOriginNoCache": false,
        "ignoreQueryString": false,
        "enableXCache": false,
        "neverCache": false,
        "varyMIMEs": [
            "image/jpg"
        ],
        "enabled": true
    }
]