AI 助理
备案控制台
文档
输入文档关键字查找
首页 全球加速 开发参考 API参考 API目录 监听 DissociateAdditionalCertificatesFromListener - 将扩展证书与HTTPS监听解绑

DissociateAdditionalCertificatesFromListener - 将扩展证书与HTTPS监听解绑

更新时间：
产品详情
相关技术圈
我的收藏

调用DissociateAdditionalCertificatesFromListener接口将扩展证书与HTTPS监听解绑。

接口说明

  • DissociateAdditionalCertificatesFromListener 接口属于异步接口，即系统会先返回一个请求 ID，但 HTTPS 监听和扩展证书并未解绑完成，系统后台的解绑任务仍在进行。您可以调用 DescribeListener 查询监听的状态：
    • 当监听处于 updating 状态时，表示 HTTPS 监听和扩展证书正在解绑中，在该状态下，您只能执行查询操作，不能执行其他操作。
    • 当监听处于 active 状态时，表示 HTTPS 监听和扩展证书解绑完成。
  • DissociateAdditionalCertificatesFromListener 接口不支持在同一个全球加速实例内并发为 HTTPS 监听解绑扩展证书。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

  • 操作：是指具体的权限点。
  • 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
  • 资源类型：是指操作中支持授权的资源类型。具体说明如下：
    • 对于必选的资源类型，用背景高亮的方式表示。
    • 对于不支持资源级授权的操作，用全部资源表示。
  • 条件关键字：是指云产品自身定义的条件关键字。
  • 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。
操作访问级别资源类型条件关键字关联操作
ga:DissociateAdditionalCertificatesFromListenerupdate
  • Listener
    acs:ga:{#regionId}:{#accountId}:listener/{#listenerId}
    无
无

请求参数

名称类型必填描述示例值
RegionIdstring是

全球加速实例所在的地域 ID，仅取值cn-hangzhou。

cn-hangzhou
ClientTokenstring否

客户端 Token，用于保证请求的幂等性。

从您的客户端生成一个参数值，确保不同请求间该参数值唯一。ClientToken 只支持 ASCII 字符。

说明 若您未指定，则系统自动使用 API 请求的 RequestId 作为 ClientToken 标识。每次 API 请求的 RequestId 不一样。
123e4567-e89b-12d3-a456-426655440000
AcceleratorIdstring是

全球加速实例 ID。

ga-bp1odcab8tmno0hdq****
ListenerIdstring是

监听实例 ID。

lsr-bp1bpn0kn908w4nbw****
Domainsarray是

扩展证书绑定的域名。

string是

扩展证书绑定的域名。

您一次最多可输入 10 个域名。

example.com

返回参数

名称类型描述示例值
object

返回信息列表。

RequestIdstring

请求 ID。

6FEA0CF3-D3B9-43E5-A304-D217037876A8

示例

正常返回示例

JSON格式

{
  "RequestId": "6FEA0CF3-D3B9-43E5-A304-D217037876A8"
}

错误码

HTTP status code错误码错误信息描述
400AlreadyInBandwidthPackage.AcceleratorThe accelerated instance is already in the bandwidth package.加速实例已经在带宽包中
400BandwidthIllegal.BandwidthPackageThe bandwidth of the basic bandwidth package must be lower than or equal to the bandwidth of the cross-domain bandwidth package.基础带宽包的带宽必需小于等于跨境带宽包的带宽
400BindExist.AcceleratorThe accelerated instance is already bound to a bandwidth package.加速实例已经绑定带宽包
400BindExist.BandwidthPackageThe bandwidth package is already bound.带宽包已经绑定
400BindExist.EndPointGroupThe endpoint group %s contains binding.终端节点组 %s 存在绑定关系
400EndPointGroupTypeIllegal.EndpointGroupThe endpoint group type is illegal.终端节点组类型不合法
400EndPointRequestProtocolIllegal.EndpointGroupThe endpoint group request protocol is illegal.终端节点请求协议不合法
400Exist.EndpointGroupThe endpoint group already exists.终端节点组已存在
400Exist.ForwardingRuleThe forwarding rule already exists.转发规则已存在
400Exist.IpSetThe IpSet already exists.存在IpSet
400Exist.ListenerThe listener already exists.监听器存在
400Exist.VirtualEndpointGroupA virtual endpoint group already exists.已存在虚拟终端节点组
400GaSpecExceeded.IpSetThe number of IpSet exceeds the specification of the GA instance.IpSet数目超过加速实例的规格
400GreaterThanGa.IpSetBandwidthThe total bandwidth for IpSet exceeds the total bandwidth of the GA instance.IpSet配置的总带宽超过GA实例的总带宽
400IllegalBandwidth.IpSetThe bandwidth of IpSet is invalid.IpSet带宽非法
400IllegalParameter.BandwidthTypeThe parameter BandwidthType is illegal.基础带宽包绑定的全球加速实例设置了非EIP类型的终端节点，不允许将基础带宽包带宽类型修改为标准加速带宽。
400IllegalParameter.SpecThe specified Spec is invalid.入参Spec非法格式
400IllegalParameter.TypeThe specified Type is invalid.入参Type非法格式
400MissingParameter.BandwidthTypeYou must specify BandwidthType.入参缺少参数BandwidthType
400NoPermission.EnableHealthCheckYou do not have permission to enable health check.该账号没有启用健康检查的权限。
400NoPermission.GaDdosRoleSessionYou are not authorized to perform the operation.用户没有创建服务关联角色的权限，请联系阿里云账号（主账号）或权限管理员授予权限AliyunGlobalAccelerationFullAccess，或者创建服务关联角色的自定义权限。 自定义权限策略的相关信息为ServiceName：ddos.ga.aliyuncs.com。 服务关联角色名称为AliyunServiceRoleForGaAntiDDos。 执行该操作所需的用户权限为ram:CreateServiceLinkedRole。
400NoPermission.VpcEndpointYou are not authorized to perform the operation.用户没有创建服务关联角色的权限，请联系主账号或权限管理员授权当前用户AliyunGlobalAccelerationFullAccess或者创建服务关联角色的自定义权限。自定义权限策略的相关信息包含以下内容：ServiceName为vpcendpoint.ga.aliyuncs.com，服务关联角色名称为AliyunServiceRoleForGaVpcEndpoint，执行该操作所需的用户权限为ram:CreateServiceLinkedRole。
400NotActive.IpSetThe state of IpSet is not active.IpSet状态非稳态
400NotActive.ListenerThe state of the listener is not active.监听器状态非稳态
400NotExist.AcceleratorThe accelerated instance does not exist.加速实例不存在。
400NotExist.BandwidthPackageThe bandwidth package does not exist.带宽包不存在
400NotExist.BasicBandwidthPackageYou must specify the basic bandwidth package.缺少基础带宽包
400NotExist.BusinessRegionThe business region does not exist.业务region并不存在
400NotExist.EndPointGroupThe endpoint group does not exist.终端节点组不存在
400NotExist.IpSetThe IpSet does not exist.IpSet不存在。
400NotExist.IpSetsThe IpSet does not exist.IpSet不存在。
400NotExist.ListenerThe listener does not exist.监听器不存在
400NotExist.ListenerPortThe listening port %s does not exist.监听端口 %s 不存在
400NotInBandwidthPackage.AcceleratorThe accelerated instance is not in the bandwidth package.加速实例并不在带宽包当中
400PortConflict.ListenerThe listener port configuration is in conflict.监听端口配置冲突
400PortRangeIllegal.CountThe hugePort listener only supports one port range.海量端口监听（端口数>300）仅支持配置一个端口范围
400PortRangeIllegal.ListenerThe specified listener port range is invalid.监听端口范围配置非法
400PortRanges.MustOneThe portRanges must be one for HTTPS and HTTP type listener.HTTPS/HTTP类型监听只支持一个端口
400ProtocalIllegal.ListenerThe specified listener protocol is invalid.监听协议配置非法
400QuotaExceeded.EndPointThe maximum number of endpoints is exceeded.终端节点达到Quota限制
400QuotaExceeded.ForwardingRuleThe number of forwarding rule exceeds the limit.转发规则数量超过限制
400QuotaExceeded.ListenerThe maximum number of listeners is exceeded.监听器达到Quota限制
400QuotaExceeded.ListenerPortThe maximum number of listener ports is exceeded.监听端口达到Quota限制
400QuotaExceeded.PortOverrideThe number of port override exceeds the limit.端口转发数量超过限制
400QuotaExceeded.RuleConditionConfigThe number of path and host exceeds the limit.-
400RegionRepeat.IpSetOnly one IpSet can be created in an accelerated region.一个加速region只能创建一个IpSet
400Repeat.IpSetsThe configuration of IpSet is duplicated.IpSet配置重复
400RepeatPathAndHost.ForwardingRuleThe path and host %s are duplicated.路径和域名重复
400StateError.AcceleratorThe state of the accelerated instance is invalid.加速实例状态非法。
400StateError.BandwidthPackageThe state of bandwidth package is invalid.带宽包状态非法
400StateError.BandwidthPackageBindThe state of binding for the bandwidth package is invalid.带宽包绑定状态非法
400StateError.EndPointGroupThe specified state of endpoint group is invalid.终端节点组状态非法
400StateError.ForwardingRuleThe forwarding rule state %s is illegal.转发规则状态不合法
400StateError.IpSetThe state of IpSet is invalid.IpSet状态非法。
400TooManySpareIp.AcceleratorToo many SpareIp accepted under the same Accelerator配置过多备用IP在当前全球加速实例下
400UpgradeError.BandwidthPackageThe bandwidth package configurations should be either all upgrades or all downgrades.带宽包变配项目应当全是升配或降配

访问错误中心查看更多错误码。

变更历史

变更时间变更内容概要操作
暂无变更历史
上一篇：AssociateAdditionalCertificatesWithListener - 为HTTPS监听绑定扩展证书下一篇：UpdateAdditionalCertificateWithListener - 为HTTPS监听替换扩展证书
文档推荐