You need to enable JavaScript to run this app.
文档中心
负载均衡

负载均衡

复制全文
下载 pdf
CLB-监听器
ModifyListenerDomainExtensions - 管理HTTPS 监听器的扩展域名
复制全文
下载 pdf
ModifyListenerDomainExtensions - 管理HTTPS 监听器的扩展域名
调用ModifyListenerDomainExtensions 接口,管理HTTPS 监听器的扩展域名。​
注意事项​
新增、修改或移除扩展域名,每种操作的单次上限为 20 个。​
调试​
API Explorer
您可以通过 API Explorer 在线发起调用,无需关注签名生成过程,快速获取调用结果。
​
请求参数​
Action String 必选 示例值:ModifyListenerDomainExtensions​
要执行的操作,取值:ModifyListenerDomainExtensions。​
​
Version String 必选 示例值:2020-04-01​
API的版本信息,当前版本为 2020-04-01。​
​
ListenerId String 必选 示例值:lsn-2fek3rgsxhrsw5oxruwec****​
监听器ID。​
您可以调用DescribeListeners接口,查询监听器ID。​
​
AddDomainExtensions.N.Domain String 可选 示例值:www.test.com​
待添加的扩展域名的域名,支持泛域名和精确域名。规范如下:​
  • 需至少包含一个.,且不允许以.开头或结尾。​
  • 仅允许包含字母、数字、.、-、*。​
  • 长度限制为1 ~ 128个字符。​
  • 泛域名:使用“*”代替1个或多个字符。​
  • *必须在域名开头或结尾。​
  • 同一条域名中*不能出现两次。​
  • *前后不能有除了.以外的字符。​
  • 合法示例:*.com、www.test.*。​
  • 非法示例:*aaa.com、www.*.com。​
  • 精确域名:符合域名规范的精确域名,例如:www.test.com。​
​
AddDomainExtensions.N.CertificateSource String 可选 示例值:cert_center​
待添加的扩展域名的证书来源,取值:​
  • cert_center:火山引擎证书中心的SSL 证书。​
​
AddDomainExtensions.N.CertCenterCertificateId String 可选 示例值:cert-ahfhds****​
待添加的扩展域名的证书ID。​
​
ModifyDomainExtensions.N.DomainExtensionId String 可选 示例值:de-fskghsj****​
待修改的扩展域名ID。​
​
ModifyDomainExtensions.N.CertificateSource String 可选 示例值:cert_center​
待修改的扩展域名的证书来源,取值:​
  • cert_center:火山引擎证书中心的SSL 证书。​
​
ModifyDomainExtensions.N.CertCenterCertificateId String 可选 示例值:cert-dar48thejr****​
待修改的扩展域名的证书ID。​
​
RemoveDomainExtensions.N.DomainExtensionId String 可选 示例值:de-wtrg1fdjgh53df***​
待移除的扩展域名ID。​
​
​
​
返回参数​
RequestId String 示例值:20210811152539010225146063030****​
请求ID。​
​
​
​
请求示例​
​
GET /?Action=ModifyListenerDomainExtensions&Version=2020-04-01&ListenerId=lsn-2fek3rgsxhrsw5oxruwec****&AddDomainExtensions.1.Domain=www.test.com&AddDomainExtensions.1.CertificateSource=cert_center&AddDomainExtensions.1.CertCenterCertificateId=cert-ahfhds****&ModifyDomainExtensions.1.DomainExtensionId=de-fskghsj****&ModifyDomainExtensions.1.CertificateSource=cert_center&ModifyDomainExtensions.1.CertCenterCertificateId=cert-dar48thejr****&RemoveDomainExtensions.1.DomainExtensionId=de-wtrg1fdjgh53df***​
Host: clb.cn-beijing.volcengineapi.com​
X-Date: 20251121T094038Z​
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20251121/cn-beijing/clb/request, SignedHeaders=host;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f​
​
返回示例​
​
{​
"ResponseMetadata": {​
"RequestId": "20230604110420****100232280022D31",​
"Action": "ModifyListenerDomainExtensions",​
"Version": "2020-04-01",​
"Service": "clb",​
"Region": "cn-beijing"​
},​
"Result": {​
"RequestId": "20210811152539010225146063030****"​
}​
}​
​
错误码​
此处仅展示当前API的错误码,更多错误码请参见公共错误码。​
​
状态码​
错误码​
错误信息​
说明​
400​
InvalidAddDomainExtensions.CertificateSource.Malformed​
The specified AddDomainExtensions.CertificateSource is malformed.​
指定的 AddDomainExtensions.CertificateSource 参数格式不合法。​
400​
InvalidAddDomainExtensions.Domain.Malformed​
The specified AddDomainExtensions.Domain is malformed.​
指定的 AddDomainExtensions.Domain 参数格式不合法。​
400​
InvalidCertificate.UnSupportAction​
The specified Certificate does not support this action, due to the content of the certificate is illegal.​
指定的证书由于内容不合法,不支持当前操作。​
400​
InvalidCertificateLength.Malformed​
The specified CertificateLength is malformed.​
指定的 CertificateLength 参数格式不合法。​
400​
InvalidIncorrectOrder.Malformed​
The specified index order is malformed.​
指定的索引顺序参数格式不合法。​
400​
InvalidListenerProtocol.UnSupportAction​
The specified Protocol of Listener does not support this action.​
指定的监听器因协议类型不支持当前操作。​
400​
InvalidLoadBalancer.InvalidStatus​
The specified LoadBalancer is not in the correct status for the request.​
指定的负载均衡所处状态无法响应该请求。​
400​
InvalidModifyDomainExtensions.CertificateSource.Malformed​
The specified ModifyDomainExtensions.CertificateSource is malformed.​
指定的 ModifyDomainExtensions.CertificateSource 参数格式不合法。​
400​
InvalidPrivateKey.Malformed​
The specified PrivateKey is malformed.​
指定的 PrivateKey 参数格式不合法。​
400​
InvalidPublicKey.Malformed​
The specified PublicKey is malformed.​
指定的 PublicKey 参数格式不合法。​
400​
InvalidPublicKey.PrivateKeyMisMatch​
The PublicKey and PrivateKey are not matched.​
指定的公钥与私钥不匹配。​
400​
InvalidQuotaCode.Malformed​
The specified QuotaCode is malformed.​
指定的 QuotaCode 参数格式不合法。​
400​
LimitExceeded.AddDomainExtensionNumber​
You've reached the limit on the number of adding domain extensions that you can operate.​
已达到单次可添加的扩展域名的数量上限。​
400​
LimitExceeded.ModifyDomainExtensionNumber​
You've reached the limit on the number of modifying domain extensions that you can operate.​
已达到单次可修改的扩展域名的数量上限。​
400​
LimitExceeded.RemoveDomainExtensionNumber​
You've reached the limit on the number of removing domain extensions that you can operate.​
已达到单次可移除的扩展域名的数量上限。​
400​
MissingParameter​
The request is missing a required parameter. Ensure that you have supplied all the required parameters for the request; for example, the 'AddDomainExtensions.CertificateSource'.​
该请求缺少必要参数。请确保发起请求已提供全部必要参数,比如 AddDomainExtensions.CertificateSource。​
400​
MissingParameter​
The request is missing a required parameter. Ensure that you have supplied all the required parameters for the request; for example, the 'ModifyDomainExtensions.DomainExtensionId'.​
该请求缺少必要参数。请确保发起请求已提供全部必要参数,比如 ModifyDomainExtensions.DomainExtensionId。​
400​
MissingParameter​
The request is missing a required parameter. Ensure that you have supplied all the required parameters for the request; for example, the 'ListenerId'.​
该请求缺少必要参数。请确保发起请求已提供全部必要参数,比如 ListenerId。​
400​
MissingParameter​
The request is missing a required parameter. Ensure that you have supplied all the required parameters for the request; for example, the 'ModifyDomainExtensions.CertCenterCertificateId'.​
该请求缺少必要参数。请确保发起请求已提供全部必要参数,比如 ModifyDomainExtensions.CertCenterCertificateId。​
400​
MissingParameter​
The request is missing a required parameter. Ensure that you have supplied all the required parameters for the request; for example, the 'AddDomainExtensions.Domain'.​
该请求缺少必要参数。请确保发起请求已提供全部必要参数,比如 AddDomainExtensions.Domain。​
400​
MissingParameter​
The request is missing a required parameter. Ensure that you have supplied all the required parameters for the request; for example, the 'RemoveDomainExtensions.DomainExtensionId'.​
该请求缺少必要参数。请确保发起请求已提供全部必要参数,比如 RemoveDomainExtensions.DomainExtensionId。​
400​
MissingParameter​
The request is missing a required parameter. Ensure that you have supplied all the required parameters for the request; for example, the 'AddDomainExtensions.CertCenterCertificateId'.​
该请求缺少必要参数。请确保发起请求已提供全部必要参数,比如 AddDomainExtensions.CertCenterCertificateId。​
400​
MissingParameter​
The request is missing a required parameter. Ensure that you have supplied all the required parameters for the request; for example, the ''.​
该请求缺少必要参数。请确保发起请求已提供全部必要参数,比如 。​
400​
MissingParameter​
The request is missing a required parameter. Ensure that you have supplied all the required parameters for the request; for example, the 'ModifyDomainExtensions.CertificateSource'.​
该请求缺少必要参数。请确保发起请求已提供全部必要参数,比如 ModifyDomainExtensions.CertificateSource。​
400​
OperationFailed.QueryCertificateService​
The request for the specified resource operation failed due to an abnormal access issue with the certificate center service.​
由于证书中心服务的访问异常,对指定资源的操作请求失败。​
400​
QuotaExceed.DomainExtNumberEachListener​
You've reached the limit on the number of DomainExtension that you can operate.​
已达到监听器可关联的扩展域名的数量上限。​
400​
UnsupportedOperation.AccountArrears​
The request on the specified instance is denied due to the account in arrears status.​
因账户处于欠费状态,对于该实例的操作请求被拒绝。​
403​
Forbidden​
You are not authorized to perform operations on the certificate of certificate center.​
无权限对指定的证书中心侧证书进行操作。​
403​
Forbidden​
You are not authorized to perform operations on the specified service.​
无权限对指定服务进行操作。​
403​
InvalidResourceType.ServcieManaged​
The specified ResourceType is managed by a service.​
指定的资源是服务托管资源。​
404​
InvalidCertificate.NotFound​
The specified Certificate does not exist.​
指定的证书不存在。​
404​
InvalidDomainExtensions.NotFound​
The specified DomainExtensions does not exist.​
指定的扩展域名不存在。​
404​
InvalidListener.NotFound​
The specified Listener does not exist.​
指定的监听器不存在。​
404​
InvalidLoadBalancer.NotFound​
The specified LoadBalancer does not exist.​
指定的负载均衡不存在。​
409​
InvalidAddDomainExtensions.DomainConflict​
The specified AddDomainExtensions.Domain already exists.​
指定的 AddDomainExtensions.Domain 已存在。​
409​
InvalidDomainExtensionId.Conflict​
The specified DomainExtensionId already exists in request.​
指定的 DomainExtensionId 在请求中已存在。​
409​
InvalidOperation.Conflict​
The specified resource operation conflicts.​
指定的资源操作冲突。​
412​
InvalidLoadBalancer.Expired​
The specified LoadBalancer has expired.​
指定的负载均衡已过期。​
500​
InternalError​
An internal error has occurred.​
发生内部错误。​
​
​
最近更新时间:2026.03.25 11:49:24
这个页面对您有帮助吗?
有用
有用
无用
无用