SetErrorPageConfig

Last updated:2021-03-17 11:08:31

SetErrorPageConfig

Description

You can call this operation to configure custom error pages. For more information about the supported error codes, see Usage notes.

Note:

No custom error pages are configured by default after a domain name is added.

Request syntax

The API request contains the specified directory /2016-09-01/domain/SetErrorPageConfig, common request headers, and operation-specific request parameters. For more information, see the sample request.

Request headers

Header Required Type Description
X-Version Yes String The version number. Set the value to 2016-09-01.
X-Action Yes String The operation that you want to perform. Set the value to SetErrorPageConfig.

Request parameters

Parameter Required Type Description
DomainId Yes String The ID of the domain name.
ErrorPages Yes ErrorPage[] The array of custom error pages. The array is ordered. If multiple pages are configured for a status code in the array, the last page takes effect.

ErrorPage

Parameter Required Type Description
ErrorHttpCode Yes String The HTTP status code of the error.
CustomPageUrl Yes String The URL of the custom page that is displayed when the error occurs. Note: The URL must start with https:// or http://. Otherwise, an error message is returned, indicating that the input URL is invalid.

Examples

Sample request

POST method:

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"
    }]
}

Sample response

  • Note: If this operation is successfully called, the HTTP status code 200 is returned, without a return value. If this operation fails to be called, the HTTP status code 403 or 400 is returned. For more information about the error codes for the HTTP status code 400, see Usage notes.

Did you find the above information helpful?

Unhelpful
Mostly Unhelpful
A little helpful
Helpful
Very helpful

What might be the problems?

Insufficient
Outdated
Unclear or awkward
Redundant or clumsy
Lack of context for the complex system or functionality

More suggestions

0/200

Please give us your feedback.

Submitted

Thank you for your feedback.

问题反馈