创建自定义域名。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
下表是API对应的授权信息,可以在RAM权限策略语句的Action
元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:
- 操作:是指具体的权限点。
- 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
- 资源类型:是指操作中支持授权的资源类型。具体说明如下:
- 对于必选的资源类型,用背景高亮的方式表示。
- 对于不支持资源级授权的操作,用
全部资源
表示。
- 条件关键字:是指云产品自身定义的条件关键字。
- 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作 | 访问级别 | 资源类型 | 条件关键字 | 关联操作 |
---|---|---|---|---|
fc:CreateCustomDomain | create |
|
| 无 |
请求语法
POST /2021-04-06/custom-domains
请求参数
名称 | 类型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
body | object | 否 | 域名定义。 | |
domainName | string | 是 | 域名。填写已在阿里云备案或接入备案的自定义域名名称。 | example.com |
protocol | string | 否 | 域名支持的协议类型:
| HTTP |
routeConfig | RouteConfig | 否 | 路由表:自定义域名访问时的 PATH 到 Function 的映射。 | |
certConfig | CertConfig | 否 | HTTPS 证书的信息。 | |
tlsConfig | TLSConfig | 否 | TLS 配置信息。 | |
wafConfig | WAFConfig | 否 | Web 应用防火墙配置信息。 | |
X-Fc-Account-Id | string | 否 | 您的阿里云账号(主账号)ID。 | 188077086902**** |
X-Fc-Date | string | 否 | API 调用时间,格式为EEE,d MMM yyyy HH:mm:ss GMT。 | Wed, 11 May 2022 09:00:00 GMT |
X-Fc-Trace-Id | string | 否 | 自定义请求 ID。 | rid281s****** |
返回参数
示例
正常返回示例
JSON
格式
{
"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
}
}
错误码
访问错误中心查看更多错误码。
变更历史
变更时间 | 变更内容概要 | 操作 |
---|---|---|
2024-02-19 | API 内部配置变更,不影响调用 | 查看变更详情 |
2021-06-30 | OpenAPI 入参发生变更 | 查看变更详情 |
2021-06-30 | OpenAPI 入参发生变更 | 查看变更详情 |
2021-06-30 | OpenAPI 入参发生变更 | 查看变更详情 |