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