All Documents
Current Document

Content is empty

If you don't find the content you expect, please try another search term

Documentation

SetIgnoreQueryStringConfig

Last updated:2021-03-17 10:55:32

SetIgnoreQueryStringConfig

Description

You can call this operation to configure the parameter filter for a domain name. This feature allows Kingsoft Cloud CDN to ignore the parameters that follow the question mark (?) in a request URL to increase the cache hit rate.

Note:

The parameter filter is enabled by default after a domain name is added.

Request syntax

The API request contains the specified directory /2016-09-01/domain/SetIgnoreQueryStringConfig, common request headers, and operation-specific request parameters. For more information, see the sample request.

Request headers

Header Required Type Description
X-Version Yes String The version number. Set the value to 2016-09-01.
X-Action Yes String The operation that you want to perform. Set the value to SetIgnoreQueryStringConfig.

Request parameters

Parameter Required Type Description
DomainId Yes String The ID of the domain name.
Enable Yes String Specifies whether to enable the parameter filter. Valid values: on and off. Default value: on.
HashKeyArgs No String The parameters to be retained. Separate multiple parameters with commas (,).

Examples

Sample request

GET method:

GET /2016-09-01/domain/SetIgnoreQueryStringConfig?DomainId=2D08M8V&Enable=on&HashKeyArgs=tklink
Host: cdn.api.ksyun.com
X-Amz-Date: date
Authorization:authorization string
x-action: SetIgnoreQueryStringConfig
x-version: 2016-09-01

POST method:

POST /2016-09-01/domain/SetIgnoreQueryStringConfig
Host: cdn.api.ksyun.com
X-Amz-Date: date
Authorization:authorization string
x-action: SetIgnoreQueryStringConfig
x-version: 2016-09-01
Content-Type: application/x-www-form-urlencoded

{
    "DomainId": "2D08M8V",
    "Enable": "on",
    "HashKeyArgs":"tklink"
}

Sample response

  • Note: If this operation is successfully called, the HTTP status code 200 is returned, without a return value. If this operation fails to be called, the HTTP status code 403 or 400 is returned. For more information about the error codes for the HTTP status code 400, see Usage notes.
On this page
Pure ModeNormal Mode

Pure Mode

Click to preview the document content in full screen
Feedback