最近更新时间:2021-09-13 10:08:02
本接口用于设置自定义错误页面,支持的错误码见使用须知。
注意:
加速域名创建后,默认自定义错误页面为空。
本接口请求需要包含指定目录/2016-09-01/domain/SetErrorPageConfig、公共请求header和该接口所特有的请求参数,具体请求语句参照下文请求示例。
参数名 | 必选 | 类型及范围 | 说明 |
---|---|---|---|
DomainId | 是 | String | 域名ID |
ErrorPages | 是 | ErrorPage[] | 由ErrorPage组成的数组,表示自定义错误页面列表。注意:该数组是有序的,如果一个相同状态码在数组里有配置子集,则以最后面的子集为准。 |
ErrorPage(配置子集)
参数名 | 必选 | 类型及范围 | 说明 |
---|---|---|---|
ErrorHttpCode | 是 | String | 错误的状态码。支持状态码400,403,404,405,406,414,416,500,501,502,503,504,不支持多条输入 |
CustomPageUrl | 是 | String | 自定义发生错误后跳转的页面URL。注:需要检验URL的合法性,如果URL不是以https://或者http://开头,则报错,提示输入url有误。 |
请求示例
POST方式:
POST /2016-09-01/domain/SetErrorPageConfig
Host: cdn.api.ksyun.com
X-Amz-Date: date
Authorization:authorization string
x-action: SetErrorPageConfig
x-version: 2016-09-01
Content-Type: application/json
{
"DomainId": "2D08M8V",
"ErrorPages":
[{
"ErrorHttpCode":"404",
"CustomPageUrl":"https://www.test.com/error404.html"
},
{
"ErrorHttpCode":"403",
"CustomPageUrl":"https://www.test.com/error403.html"
}]
}
返回示例
纯净模式