調用DissociateAdditionalCertificatesFromListener接口將擴展證書與HTTPS監聽解綁。
接口說明
- DissociateAdditionalCertificatesFromListener 接口屬于異步接口，即系統會先返回一個請求 ID，但 HTTPS 監聽和擴展證書并未解綁完成，系統后臺的解綁任務仍在進行。您可以調用 DescribeListener 查詢監聽的狀態：
- 當監聽處于 updating 狀態時，表示 HTTPS 監聽和擴展證書正在解綁中，在該狀態下，您只能執行查詢操作，不能執行其他操作。
- 當監聽處于 active 狀態時，表示 HTTPS 監聽和擴展證書解綁完成。
- DissociateAdditionalCertificatesFromListener 接口不支持在同一個全球加速實例內并發為 HTTPS 監聽解綁擴展證書。
調試
您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
下表是API對應的授權信息，可以在RAM權限策略語句的Action元素中使用，用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下：
- 操作：是指具體的權限點。
- 訪問級別：是指每個操作的訪問級別，取值為寫入（Write）、讀?。≧ead）或列出（List）。
- 資源類型：是指操作中支持授權的資源類型。具體說明如下：
- 對于必選的資源類型，用背景高亮的方式表示。
- 對于不支持資源級授權的操作，用
全部資源表示。
- 條件關鍵字：是指云產品自身定義的條件關鍵字。
- 關聯操作：是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限，操作才能成功。
| 操作 | 訪問級別 | 資源類型 | 條件關鍵字 | 關聯操作 |
|---|---|---|---|---|
| ga:DissociateAdditionalCertificatesFromListener | update |
|
| 無 |
請求參數
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| RegionId | string | 是 | 全球加速實例所在的地域 ID，僅取值cn-hangzhou。 | cn-hangzhou |
| ClientToken | string | 否 | 客戶端 Token，用于保證請求的冪等性。 從您的客戶端生成一個參數值，確保不同請求間該參數值唯一。ClientToken 只支持 ASCII 字符。 說明
若您未指定，則系統自動使用 API 請求的 RequestId 作為 ClientToken 標識。每次 API 請求的 RequestId 不一樣。
| 123e4567-e89b-12d3-a456-426655440000 |
| AcceleratorId | string | 是 | 全球加速實例 ID。 | ga-bp1odcab8tmno0hdq**** |
| ListenerId | string | 是 | 監聽實例 ID。 | lsr-bp1bpn0kn908w4nbw**** |
| Domains | array | 是 | 擴展證書綁定的域名。 | |
| string | 是 | 擴展證書綁定的域名。 您一次最多可輸入 10 個域名。 | example.com |
返回參數
示例
正常返回示例
JSON格式
{
"RequestId": "6FEA0CF3-D3B9-43E5-A304-D217037876A8"
}錯誤碼
| HTTP status code | 錯誤碼 | 錯誤信息 | 描述 |
|---|---|---|---|
| 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.EnableHealthCheck | You do not have permission to enable health check. | 該賬號沒有啟用健康檢查的權限。 |
| 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 | QuotaExceeded.RuleConditionConfig | The number of path and host 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.Accelerator | The state of the accelerated instance is invalid. | 加速實例狀態非法。 |
| 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. | 帶寬包變配項目應當全是升配或降配 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
| 變更時間 | 變更內容概要 | 操作 |
|---|
暫無變更歷史