創建擴展域名。
接口說明
說明
性能共享型實例的監聽不支持擴展域名。
調試
您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
下表是API對應的授權信息，可以在RAM權限策略語句的Action元素中使用，用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下：
- 操作：是指具體的權限點。
- 訪問級別：是指每個操作的訪問級別，取值為寫入（Write）、讀取（Read）或列出（List）。
- 資源類型：是指操作中支持授權的資源類型。具體說明如下：
- 對于必選的資源類型，用背景高亮的方式表示。
- 對于不支持資源級授權的操作，用
全部資源表示。
- 條件關鍵字：是指云產品自身定義的條件關鍵字。
- 關聯操作：是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限，操作才能成功。
| 操作 | 訪問級別 | 資源類型 | 條件關鍵字 | 關聯操作 |
|---|---|---|---|---|
| slb:CreateDomainExtension | create |
|
| 無 |
請求參數
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| RegionId | string | 是 | 負載均衡實例的地域 ID。 | cn-hangzhou |
| LoadBalancerId | string | 是 | 負載均衡實例的 ID。 | lb-bp1o94dp5i6earrxxxxxx |
| ListenerPort | integer | 是 | 負載均衡實例 HTTPS 監聽的前端端口。 取值：1-65535。 | 443 |
| Domain | string | 是 | 域名。 | *.example1.com |
| ServerCertificateId | string | 是 | 與域名對應的證書 ID。 | 123157xxxxxxx_166f820xxxxxx_1714763408_709981xxxx |
返回參數
示例
正常返回示例
JSON格式
{
"ListenerPort": 80,
"RequestId": "A6E7EFC9-0938-40CA-877D-9BE******",
"DomainExtensionId": "de-bp1rp7ta19******"
}錯誤碼
| HTTP status code | 錯誤碼 | 錯誤信息 | 描述 |
|---|---|---|---|
| 400 | InvalidAction.RegionNotSupport | The region does not support this action. | 當前地域不支持指定功能。 |
| 400 | InvalidParameter.ServerCertificateId | The specified ServerCertificateId does not exist. | 指定的服務證書不存在。 |
| 400 | InvalidParameter.Domain | The specified Domain exists. | 指定的Domain已存在。 |
| 400 | DomainExtensionProcessing | A previous configuration of the DomainExtension is pending, please try again later. | 指定的擴展域名正在變配中, 請稍后重試。 |
| 400 | DomainExtensionNumberOverLimit | The number of domainExtension has reached to the quota limit of this listener. | 監聽可保有的擴展域名數量已達到配額上限。 |
| 400 | DomainExtensionNotSupport | The instance with shared loadBalancerSpec does not support domainExtension. | 共享型負載均衡實例不支持創建擴展域名。 |
| 400 | InvalidParameter.CertificateId | The specified CertificateId contains duplicate certificate EncryptionAlgorithm. | 指定的證書包含重復的證書加密算法。 |
| 400 | InvalidParamSize.CertificateId | The size of parameter CertificateId is invalid. | 指定的CertificateId無效。請檢查參數約束，并在修改后重試。 |
| 400 | MissingParameter.CertificateId | The parameter CertificateId is required. | 參數CertificateId缺失。 |
| 400 | InvalidParameter.CertificateId | The specified CertificateId is invalid. | 指定的證書不存在。 |
| 400 | InvalidParameter.RegionNotSupport | The region does not support the parameter: %s. | 當前區域不支持指定參數。 |
| 400 | CertificateTypeMismatched | The certificate type does not match. | 指定證書的類型不匹配。 |
| 400 | SPEC_NOT_SUPPORT_PARAMETER | The loadbalancer with share spec does not support the parameter. | - |
| 400 | CnCertificateNotSupport | The cn certificate is not support. | 不支持國密證書。 |
| 400 | InvalidParam.CertificateBindingType | The param is invalid. | 指定的CertificateBindingType無效。請檢查參數約束，并在修改后重試。 |
| 400 | MissingParam.ServerCertificates | The param ServerCertificates is missing. | 參數ServerCertificates缺失。 |
| 400 | InvalidParamSize.ServerCertificates | The size of param ServerCertificates is invalid. | 指定的ServerCertificates長度無效。請檢查參數約束，并在修改后重試。 |
| 400 | SPEC_NOT_SUPPORT_PARAMETER | Share spec does not support the feature. | - |
| 400 | TooManyListeners | More than 1 listener is found, please be more specified. | 檢索到的監聽數量大于1，請提供更具體的查詢條件。 |
訪問錯誤中心查看更多錯誤碼。