Adds a custom domain name.
Debugging
Authorization information
Request syntax
POST /2021-04-06/custom-domains
Request parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
| body | object | No | The definition of the domain name. | |
| domainName | string | Yes | The domain name. Enter a custom domain name that has obtained an ICP filing in the Alibaba Cloud ICP Filing system, or a custom domain name whose ICP filing information includes Alibaba Cloud as a service provider. | example.com |
| protocol | string | No | The protocol types supported by the domain name. Valid values:
| HTTP |
| routeConfig | RouteConfig | No | The route table that maps the paths to functions when the functions are invoked by using the custom domain name. | |
| certConfig | CertConfig | No | The configurations of the HTTPS certificate. | |
| tlsConfig | TLSConfig | No | The Transport Layer Security (TLS) configuration. | |
| wafConfig | WAFConfig | No | The Web Application Firewall (WAF) configuration. | |
| X-Fc-Account-Id | string | No | The ID of your Alibaba Cloud account. | 188077086902**** |
| X-Fc-Date | string | No | The time when the operation is called. The format is: EEE,d MMM yyyy HH:mm:ss GMT. | Wed, 11 May 2022 09:00:00 GMT |
| X-Fc-Trace-Id | string | No | The custom request ID. | rid281s****** |
Response parameters
Examples
Sample success responses
JSONformat
{
"domainName": "example.com\t",
"accountId": "1986114****4305\t",
"protocol": "HTTP",
"certConfig": {
"certName": "my-cert",
"certificate": "-----BEGIN CERTIFICATE----- xxxxx -----END CERTIFICATE-----",
"privateKey": "-----BEGIN RSA PRIVATE KEY----- xxxxx -----END RSA PRIVATE KEY-----"
},
"tlsConfig": {
"minVersion": "TLSv1.0",
"cipherSuites": [
"TLS_RSA_WITH_RC4_128_SHA"
],
"maxVersion": "TLSv1.3"
},
"apiVersion": "2016-08-15\t",
"routeConfig": {
"routes": [
{
"functionName": "f1",
"methods": [
"GET"
],
"path": "/login",
"qualifier": "prod",
"serviceName": "s1",
"rewriteConfig": {
"equalRules": [
{
"match": "/old",
"replacement": "/new"
}
],
"wildcardRules": [
{
"match": "/api/*",
"replacement": "/$1"
}
],
"regexRules": [
{
"match": "^/js/(.*?)$",
"replacement": "/public/javascripts/$1"
}
]
}
}
]
},
"createdTime": "2020-07-27T08:02:19Z\t",
"lastModifiedTime": "2020-07-27T08:02:19Z",
"wafConfig": {
"enableWAF": true
}
}Error codes
For a list of error codes, visit the Service error codes.
Change history
| Change time | Summary of changes | Operation | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 2024-02-19 | The internal configuration of the API is changed, but the call is not affected | see changesets | ||||||||||||||
| ||||||||||||||||
| 2021-06-30 | The request parameters of the API has changed | see changesets | ||||||||||||||
| ||||||||||||||||
| 2021-06-30 | The request parameters of the API has changed | see changesets | ||||||||||||||
| ||||||||||||||||
| 2021-06-30 | The request parameters of the API has changed | see changesets | ||||||||||||||
|