自定义错误页面

最近更新时间:2022-03-17 17:10:28

查看PDF

SetErrorPageConfig

描述

本接口用于设置自定义错误页面,支持的错误码见使用须知

注意:

加速域名创建后,默认自定义错误页面为空。

请求语法

本接口请求需要包含指定目录/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"
    }]
}

返回示例

  • 说明:本接口调用成功只会返回200的状态码,无返回值,若调用失败,则会返回错误码。

错误码

为了帮您快速定位问题,WCDN将错误码集中归类,请到【使用须知】查看详情。

文档内容是否对您有帮助?

根本没帮助
文档较差
文档一般
文档不错
文档很好

在文档使用中是否遇到以下问题

内容不全,不深入
内容更新不及时
描述不清晰,比较混乱
系统或功能太复杂,缺乏足够的引导
内容冗长

更多建议

0/200

评价建议不能为空

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

问题反馈