CDN

自定义错误页面

最近更新时间:2020-10-30 19:31:11

SetErrorPageConfig

描述

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

注意:

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

请求语法

本接口请求需要包含指定目录/2016-09-01/domain/SetErrorPageConfig、公共请求header和该接口所特有的请求参数,具体请求语句参照下文请求示例。

请求头

参数名 必选 类型及范围 说明
X-Version String 版本号,取值:2016-09-01
X-Action String 操作接口名,取值:SetErrorPageConfig

请求参数

参数名 必选 类型及范围 说明
DomainId String 域名ID
ErrorPages ErrorPage[] 由ErrorPage组成的数组,表示自定义错误页面列表。注意:该数组是有序的,如果一个相同状态码在数组里有配置子集,则以最后面的子集为准。

ErrorPage(配置子集)

参数名 必选 类型及范围 说明
ErrorHttpCode String 错误的状态码。
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的具体错误原因详见【使用须知】中错误代码表说明

金山云,开启您的云计算之旅

免费注册