调用CreateCustomDomain接口创建自定义域名。

请求头

该接口使用公共请求头，无特殊请求头。请参见公共请求参数文档。

请求语法

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