全部文档
当前文档

暂无内容

如果没有找到您期望的内容,请尝试其他搜索词

文档中心

自定义错误页面

最近更新时间:2021-09-13 10:08:02

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的状态码,无返回值,若调用失败,则会返回403/400状态码,400的具体错误原因详见【使用须知】中错误代码表说明
文档导读
纯净模式常规模式

纯净模式

点击可全屏预览文档内容
文档反馈