List Redirection
This API is used to list redirection for website acceleration service.
Request
Request-Line
GET /cdn/v1.0/services/{serviceId}/redirections HTTP/1.1
Request Parameters
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| serviceId | Integer | Mandatory | service id. |
Response
Response Body
| Parameter | Type | Description |
|---|---|---|
| Array | Array of Redirection Control. |
Object: Redirection Control
| Parameter | Type | Description |
|---|---|---|
| policyName | String | Mandatory |
| matchUrlPath | Object | URL path matching configuration that determines which requests the rule applies to. See Match Url Path for details. |
| matchQueryString | Object | Query-string matching configuration used to refine which requests the rule applies to. See Match Query String for details. |
| redirectDestination | String | Mandatory |
| httpCode | Integer | Mandatory |
| priority | Integer | Mandatory |
| enabled | Boolean | Optional |
Object: Match Url Path
| Parameter | Type | Description |
|---|---|---|
| operator | String | Defines how to match the field. Supported values:prefix,regex,equals,suffix. |
| patterns | String[] | List of patterns matching the URL path string. |
Object: Match Query String
| Parameter | Type | Description |
|---|---|---|
| operator | String | Defines how to match the field. Supported values:prefix,regex,equals,suffix. |
| patterns | String[] | List of patterns matching the URL query string. |
Status Codes, Error Codes and Error Messages
| Status Code | Error Code | Error Message |
|---|---|---|
| 400 | Request.BadRequest | Bad request. |
| 400 | InvalidCustomer.IdEmpty | Customer id can be empty or invalid. |
| 400 | InvalidService.IdIncorrect | Service id is empty or invalid. |
| 400 | ServiceId.IdPermission | ServiceId can not be found or unknown. |
| 400 | InvalidRedirection.PolicyName | Policy name is required. |
| 400 | InvalidRedirection.MatchURLIncorrect | The matchUrlPath can not be empty. |
| 400 | InvalidRedirection.Operator | Operator must be one of the following: prefix,regex,equals or suffix. |
| 400 | InvalidRedirection.MatchUrlPathPatternsIncorrect | The MatchUrlPath patterns could not be empty. |
| 400 | InvalidRedirection.URLEmpty | Policy redirection URL is empty. |
| 400 | InvalidRedirection.HttpCodeEmpty | Policy redirection http code is empty. |
| 400 | InvalidRedirection.HttpCode | Policy redirection http code type is 301 or 302. |
| 400 | InvalidRedirection.Priority | Patterns cannot be empty or invalid. |
Examples
List Redirection
Request
GET /cdn/v1.0/services/226401/redirections HTTP/1.1
#### Successful Response Body
```json
{
"policyName":"redo",
"matchUrlPath": {
"operator": "suffix",
"patterns": [
"/wp-content/web/"
]
},
"priority":1,
"redirectDestination":"www.domain333.com",
"httpCode":302,
"enabled":true
}