调用UpdateHttpTriggerConfig更新云函数的HTTP触发配置。
开启Http触发功能,系统会为开启Http触发功能的Space分配一个默认域名,然后再结合UpdateFunction接口给云函数设置一个触发路径,之后就可以通过HTTP请求来触发云函数调用。您可以绑定自己的域名来使用Http触发的功能,要求您的域名必须接入阿里云备案。您还可以给您的自定义域名绑定Https证书,之后可以使用Https协议加自定义域名来访问。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | UpdateHttpTriggerConfig |
系统规定参数。取值:UpdateHttpTriggerConfig。 |
EnableService | Boolean | 是 | true |
设置是否开启HTTP触发功能。取值:
|
SpaceId | String | 是 | 34C45988-2B24-****-A4DC-4D6C952890D8 |
服务空间ID。 |
CustomDomain | String | 否 | abc.xxx.com |
自定义域名。不传该字段表示不更新自定义域名,设置为空字符串表示删除自定义域名。 在绑定自定义域名前,要求您的域名已经接入阿里云备案,并且已配置解析CNAME到CustomDomainCname。 |
CustomDomainCertificate | String | 否 | -----BEGIN CERTIFICATE----- MIIFK****GCSqGSIb3DQEBCwUA= -----END CERTIFICATE----- |
自定义域名的Https证书。必须和CustomDomainPrivateKey一起使用,不传这两个字段表示不更新证书,都传空字符串表示删除证书。 |
CustomDomainPrivateKey | String | 否 | -----BEGIN PRIVATE KEY----- MIIEwA******DmUwVD0M74ECwZw= -----END PRIVATE KEY----- |
自定义域名的Https证书的私钥。必须和CustomDomainCertificate一起使用,不传这两个字段表示不更新证书,都传空字符串表示删除证书。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
CustomDomain | String | abc.example.com |
Http触发绑定的自定义域名。 |
CustomDomainCertificateInfo | String | {"notAfter":"2021-09-28T08:21:42Z","notBefore":"2021-06-30T08:21:43Z","subject":"CN=*.example.com"} |
Http触发绑定的自定义域名的证书信息。 |
CustomDomainCname | String | 724d************795a2.custom.bspapp.com |
Http触发绑定的自定义域名的CNAME地址。 |
DefaultEndpoint | String | 724dade5-492f-426b-a5df-ff****0795a2.bspapp.com |
Http触发的默认域名。 |
EnableService | Boolean | true |
是否开启了HTTP触发功能。 |
RequestId | String | 34C45988-2B24-****-A4DC-4D6C952890D8 |
请求ID。 |
示例
请求示例
http(s)://[Endpoint]/?Action=UpdateHttpTriggerConfig
&EnableService=true
&SpaceId=34C45988-2B24-****-A4DC-4D6C952890D8
&<公共请求参数>
正常返回示例
XML
格式
<UpdateHttpTriggerConfigResponse>
<DefaultEndpoint>226e5213-****-4a52-b4ff-35a09f8a52de.bspapp.com</DefaultEndpoint>
<RequestId>34C45988-2B24-495D-A4DC-4D6C952890D8</RequestId>
<EnableService>true</EnableService>
<Success>true</Success>
<CustomDomainCname>226e5213-****-4a52-b4ff-35a09f8a52de.custom.bspapp.com</CustomDomainCname>
</UpdateHttpTriggerConfigResponse>
JSON
格式
{
"DefaultEndpoint": "226e5213-****-4a52-b4ff-35a09f8a52de.bspapp.com",
"RequestId": "34C45988-2B24-495D-A4DC-4D6C952890D8",
"EnableService": true,
"Success": true,
"CustomDomainCname": "226e5213-****-4a52-b4ff-35a09f8a52de.custom.bspapp.com"
}