調用CreateCustomDomain介面建立自訂網域名。
調試
您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。
要求標頭
該介面使用公用要求標頭,無特殊要求標頭。請參見公用請求參數文檔。
請求文法
POST /custom-domains HTTP/1.1
請求參數
| 名稱 | 類型 | 位置 | 是否必選 | 樣本值 | 描述 |
| Object | Body | 是 | 網域名稱定義。 |
||
| certConfig | CertConfig | Body | 否 | HTTPS認證的配置資訊。 |
|
| domainName | String | Body | 是 | example.com | 已在阿里雲備案或接入備案的自訂網域名名稱。 |
| protocol | String | Body | 否 | HTTP | 網域名稱支援的協議類型。
|
| routeConfig | RouteConfig | Body | 否 | 路由表:自訂網域名訪問時的PATH到Function的映射。 |
返回資料
| 名稱 | 類型 | 樣本值 | 描述 |
| accountId | String | 1986114****4305 | 帳號ID。 |
| apiVersion | String | 2016-08-15 | API的版本。 |
| certConfig | CertConfig | HTTPS認證的資訊。 |
|
| createdTime | String | 2020-07-27T08:02:19Z | 網域名稱綁定的時間。 |
| domainName | String | example.com | 已在阿里雲備案或接入備案的自訂網域名名稱。 |
| lastModifiedTime | String | 2020-07-27T08:02:19Z | 網域名稱上一次被更新的時間。 |
| protocol | String | HTTP | 網域名稱支援的協議類型。
|
| routeConfig | RouteConfig | 路由表:自訂網域名訪問時的PATH到Function的映射。 |
樣本
請求樣本
POST /custom-domains HTTP/1.1
Host:fc-ram.aliyuncs.com
Content-Type:application/json
{
"certConfig" : {
"certificate" : "-----BEGIN CERTIFICATE----- xxxxx -----END CERTIFICATE-----",
"privateKey" : "-----BEGIN RSA PRIVATE KEY----- xxxxx -----END RSA PRIVATE KEY-----"
},
"domainName" : "example.com",
"protocol" : "HTTP",
"routeConfig" : {
"routes" : [ {
"functionName" : "f1",
"methods" : [ "GET" ],
"path" : "/login",
"qualifier" : "prod",
"serviceName" : "s1"
} ]
}
}
正常返回樣本
JSON格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"accountId" : "1986114****4305",
"apiVersion" : "2016-08-15",
"certConfig" : {
"certificate" : "-----BEGIN CERTIFICATE----- xxxxx -----END CERTIFICATE-----",
"privateKey" : "-----BEGIN RSA PRIVATE KEY----- xxxxx -----END RSA PRIVATE KEY-----"
},
"createdTime" : "2020-07-27T08:02:19Z",
"domainName" : "example.com",
"lastModifiedTime" : "2020-07-27T08:02:19Z",
"protocol" : "HTTP",
"routeConfig" : {
"routes" : [ {
"functionName" : "f1",
"methods" : [ "GET" ],
"path" : "/login",
"qualifier" : "prod",
"serviceName" : "s1"
} ]
}
}
錯誤碼
訪問錯誤中心查看更多錯誤碼。