You need to enable JavaScript to run this app.
文档中心
API 网关

API 网关

复制全文
下载 pdf
路由管理
UpdateCustomDomain - 更新自定义域名
复制全文
下载 pdf
UpdateCustomDomain - 更新自定义域名
更新自定义域名。​
请求说明​
API 网关已在全球多个地域部署服务,旨在为您提供更稳定、低延迟的访问体验。您可以通过查阅 服务地址 文档,根据业务所在地域,选择最合适的接入点。​
  • 请求方式:POST​
  • 请求地址:https://apig.cn-beijing.volcengineapi.com?Action=UpdateCustomDomain&Version=2021-03-03​
调试​
API Explorer
您可以通过 API Explorer 在线发起调用,无需关注签名生成过程,快速获取调用结果。
​
请求参数​
​
参数​
类型​
是否必选​
示例值​
描述​
Action​
String​
是​
UpdateCustomDomain​
接口名称。当前 API 的名称为 UpdateCustomDomain。​
Version​
String​
是​
2021-03-03​
接口版本。当前 API 的版本为 2021-03-03。​
Id​
String​
是​
d****​
自定义域名 ID。您可以通过 ListCustomDomains 查询自定义域名 ID。​
Protocol​
Array of String​
是​
["HTTP","HTTPS"]​
协议类型,取值:​
  • HTTP。​
  • HTTPS。​
CertificateId​
String​
否​
cert-c88****​
证书 ID。您可以通过 QuickApplyCertificate 创建证书。​
Comments​
String​
否​
example​
自定义域名备注信息。​
SSLRedirect​
Boolean​
否​
true​
是否重定向到 HTTPS。取值:​
  • true:是。​
  • false:否。​
​
请求示例​
​
POST https://apig.cn-beijing.volcengineapi.com?Action=UpdateCustomDomain&Version=2021-03-03​
Content-Type: application/json​
{​
"Id": "d****",​
"Protocol": [​
"HTTP",​
"HTTPS"​
],​
"CertificateId": "cert-c88****",​
"Comments": "example",​
"SSLRedirect": true​
}​
​
返回参数​
​
参数​
类型​
示例值​
描述​
Id​
String​
d****​
自定义域名 ID。​
​
返回示例​
​
Content-Type: application/json​
{​
"ResponseMetadata": {​
"RequestId": "20230604110420****100232280022D31",​
"Action": "UpdateCustomDomain",​
"Version": "2021-03-03",​
"Service": "apig",​
"Region": "cn-beijing"​
},​
"Result": {​
"Id": "d****"​
}​
}​
​
错误码​
本接口错误码如下表所示,公共错误码请参见 公共错误码。​
​
HTTP 状态码​
错误码​
错误信息​
说明​
400​
DomainPending​
A custom domain is creating or deleting.​
自定义域名正在创建或删除。请稍后重试。​
400​
DomainCertificateInvalid​
The certificate is invalid.​
自定义域名证书不合法。请确认参数后重试。​
​
最近更新时间:2026.07.29 10:20:01
这个页面对您有帮助吗?
有用
有用
无用
无用