全部產品
Search
文件中心

Function Compute:CreateCustomDomain

更新時間:Aug 20, 2025

調用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

網域名稱支援的協議類型。

  • HTTP:僅支援HTTP協議。
  • HTTP,HTTPS:支援HTTP及HTTPS協議。
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

網域名稱支援的協議類型。

  • HTTP:僅支援HTTP協議。
  • HTTP,HTTPS:支援HTTP及HTTPS協議。
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"
    } ]
  }
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。