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

使用说明

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

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String DissociateAdditionalCertificatesFromListener

系统规定参数。取值:DissociateAdditionalCertificatesFromListener

RegionId String cn-hangzhou

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

ClientToken String 123e4567-e89b-12d3-a456-426655440000

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

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

说明 若您未指定,则系统自动使用API请求的RequestId作为ClientToken标识。每次API请求的RequestId可能不一样。
AcceleratorId String ga-bp1odcab8tmno0hdq****

全球加速实例ID。

ListenerId String lsr-bp1bpn0kn908w4nbw****

监听实例ID。

Domains.N String example.com

扩展证书绑定的域名。

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

返回数据

名称 类型 示例值 描述
RequestId String 6FEA0CF3-D3B9-43E5-A304-D217037876A8

请求ID。

示例

请求示例

http(s)://[Endpoint]/?Action=DissociateAdditionalCertificatesFromListener
&RegionId=cn-hangzhou
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&AcceleratorId=ga-bp1odcab8tmno0hdq****
&ListenerId=lsr-bp1bpn0kn908w4nbw****
&Domains=["example.com"]
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<DissociateAdditionalCertificatesFromListenerResponse>
    <RequestId>6FEA0CF3-D3B9-43E5-A304-D217037876A8</RequestId>
</DissociateAdditionalCertificatesFromListenerResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

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

错误码

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

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