文档中心

API 网关

路由管理

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

这个页面对您有帮助吗？

有用

无用