Skip to main content

Get Redirection Rules

Get redirection rules for website accleration domain.

Request

Request-Line

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

Request Parameters

Path Parameters

ParameterTypeRequiredDescription
serviceIdIntegerMandatoryService ID.

Response

Response Body

ParameterTypeRequiredDescription
ArrayMandatoryArray of Redirection Rule.

Object: Redirection Rule

ParameterTypeRequiredDescription
ruleIdIntegerMandatoryRule ID number for redirection.
nameStringMandatoryRule name for access control.
matchUrlPathObjectMandatoryURL path matching configuration that determines which requests the rule applies to. See Match Url Path for details.
matchQueryStringObjectOptionalQuery-string matching configuration used to refine which requests the rule applies to. See Match Query String for details.
priorityIntegerMandatoryPriority weight for the rule. Rules with a higher weight take precedence. The weight must be non-zero.
redirectionURLStringMandatorySend an HTTP redirect if this policy matches.
statusCodeIntegerMandatoryHTTP response code to use if sending an HTTP redirect. Could be "301/302".
enabledBooleanMandatoryFlag indicating whether the rule is active.
Object: Match Url Path
ParameterTypeRequiredDescription
operatorStringMandatoryDefines how to match the field. Supported values:prefix,regex,equals,suffix.
patternsString[]MandatoryList of patterns to match what against. If any of the patterns matches then the match succeeds.
Object: Match Query String
ParameterTypeRequiredDescription
operatorStringMandatoryDefines how to match the field. Supported values:prefix,regex,equals,suffix.
patternsString[]MandatoryList of patterns to match what against. If any of the patterns matches then the match succeeds.

Status Codes, Error Codes and Error Messages

Status CodeError CodeError Message
400ServiceId.InvalidServiceId is empty or invalid.
400Redirection.OperationFailedThe redirection operation failed.
404ServiceId.NotFoundServiceId is not found.

Examples

Get Redirection Rules

Request

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

Successful Response Body

[
{
"name": "test",
"priority": 12,
"enabled": true,
"ruleId": 261704,
"matchUrlPath": {
"operator": "prefix",
"patterns": [
"/"
]
},
"redirectionURL": "http://www.example.com/404.html",
"statusCode": 302
},
{
"name": "test",
"priority": 11,
"enabled": true,
"ruleId": 261703,
"matchUrlPath": {
"operator": "prefix",
"patterns": [
"/"
]
},
"matchQueryString": {
"operator": "prefix",
"patterns": [
"name1=1",
"name2=2"
]
},
"redirectionURL": "http://www.example.com/404.html",
"statusCode": 302
}
]