调用 ModifyNLBListenerAdditionalCertificates 接口，为指定的TLS监听器关联、解除关联扩展证书。

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

Action String 必选示例值：ModifyNLBListenerAdditionalCertificates

要执行的操作，取值为 ModifyNLBListenerAdditionalCertificates。

Version String 必选示例值：2020-04-01

API版本信息，当前版本为 2020-04-01。

ListenerId String 必选示例值：sn-2fek3rgsxhrsw5oxruwec****

监听器的ID。

AssociateCertificateSource String 可选示例值：SSL

待关联的扩展证书的类型。取值如下：

SSL：SSL 证书。

PCALeaf：PCA 私有证书。

当指定AssociateCertificateSource参数时，AssociateCertificateIds.N参数为必填，否则报错。

AssociateCertificateIds.N String 可选示例值：cert-bp1o94dp5i6eb****

待关联的扩展证书。

参数 - N：表示扩展证书ID的序号，取值范围为1 ～ 15。

多个扩展证书ID之间用&分隔。

DisassociateCertificateIds.N String 可选示例值：cert-bp2o05dp6i7eb****

待解除关联的扩展证书。

参数 - N：表示扩展证书ID的序号，取值范围为1 ～ 15。

多个扩展证书ID之间用&分隔。

返回参数

RequestId String 示例值：2024092952539010225146063030****

请求ID。

请求示例

返回示例

错误码

此处仅展示当前API的错误码，更多错误码请参见公共错误码。

状态码	错误码	错误信息	说明
400	DryRunOperation	Exception raised to indicate a successfully authorized action when the DryRun flag is set to true.	该请求设置为DryRun操作，操作授权已获得许可，但未被实际执行。
400	IdempotentParameterMismatch	Arguments on this idempotent request are inconsistent with arguments used in previous request(s).	此幂等请求的参数与前一个请求中使用的参数不一致。
400	InvalidAssociateCertificateIds.AssociateCertificateSourceMismatch	The specified AssociateCertificateIds is not matched with AssociateCertificateSource.	指定的 AssociateCertificateIds 与 AssociateCertificateSource 不匹配。
400	InvalidAssociateCertificateIds.Malformed	The specified AssociateCertificateIds is malformed.	指定的 AssociateCertificateIds 参数格式不合法。
400	InvalidAssociateCertificateSource.Malformed	The specified AssociateCertificateSource is malformed.	指定的 AssociateCertificateSource 参数格式不合法。
400	InvalidCertificate.DomainTotalCount	The specified Certificate does not support this action, due to the total number of the certificate domain is illegal.	指定的证书由于域名总数量不合法，不支持当前操作。
400	InvalidCertificate.DomainTotalLength	The specified Certificate does not support this action, due to the total length of the certificate domain is illegal.	指定的证书由于域名总长度不合法，不支持当前操作。
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	InvalidClientToken.Malformed	The specified ClientToken is malformed.	指定的 ClientToken 参数格式不合法。
400	InvalidDisassociateCertificateIds.Malformed	The specified DisassociateCertificateIds is malformed.	指定的 DisassociateCertificateIds 参数格式不合法。
400	InvalidListener.InvalidStatus	The specified Listener is not in the correct status for the request.	指定监听器所处状态无法响应该请求。
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	InvalidLoadBalancerBillingStatus.InvalidStatus	The specified LoadBalancer is not in the correct billing status for the request.	指定的负载均衡计费状态所处状态无法响应该请求。
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.AdditionalCertificateNumber	You've reached the limit on the number of additional certificates 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 '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 ''.	该请求缺少必要参数。请确保发起请求已提供全部必要参数，比如。
400	OperationFailed.QueryPcaService	The request for the specified resource operation failed due to an abnormal access issue with the pca service.	由于证书中心 PCA 服务的访问异常，对指定资源的操作请求失败。
400	QuotaExceed.AdditionalCertificateNumber	You've reached the limit on the number of additional certificates that you can create.	已达到单监听器可创建扩展证书数量的配额上限。
403	Forbidden	You are not authorized to perform operations on the specified service.	无权限对指定服务进行操作。
403	InvalidResourceType.ServiceManaged	The specified ResourceType is managed by a service.	指定的资源是服务托管资源。
404	InvalidAction.NotFound	The specified Action does not exist.	指定的 Action 不存在。
404	InvalidCACertificate.NotFound	The specified CACertificate does not exist.	指定的 CA 证书不存在。
404	InvalidCertificate.NotFound	The specified Certificate does not exist.	指定的证书不存在。
404	InvalidListener.NotFound	The specified Listener does not exist.	指定的监听器不存在。
404	InvalidLoadBalancer.NotFound	The specified LoadBalancer does not exist.	指定的负载均衡不存在。
404	ServiceRoleForLoadBalancer.NotFound	ServiceRoleForLoadBalancer does not exist.	负载均衡服务关联角色不存在。
409	InvalidCertificate.Conflict	The specified certificate already exists.	指定的证书已存在。
409	InvalidOperation.Conflict	The specified resource operation conflicts.	指定的资源操作冲突。
412	IdempotentProcessing	The request uses the same client token as a previous one that is still in process.	幂等请求处理中。
500	InternalError	An internal error has occurred.	发生内部错误。

负载均衡