全部產品
Search

搜尋本產品

    Server Load Balancer：CreateServerGroup - 建立伺服器組

    文件中心

    Server Load Balancer：CreateServerGroup - 建立伺服器組

    更新時間：Dec 19, 2025

    在指定地區建立伺服器組。

    介面說明

    CreateServerGroup 介面屬於非同步介面，即系統返回一個請求 ID，但該伺服器組尚未建立成功，系統背景建立任務仍在進行。您可以調用 ListServerGroups 查詢服務器組的建立狀態：

    • 當伺服器組處於 Creating 狀態時，表示伺服器組正在建立中。

    • 當伺服器組處於 Available 狀態時，表示伺服器組建立成功。

    調試

    您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

    調試

    授權資訊

    下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

    • 操作：是指具體的許可權點。

    • 存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。

    • 資源類型：是指操作中支援授權的資源類型。具體說明如下：

      • 對於必選的資源類型，用前面加 * 表示。

      • 對於不支援資源級授權的操作，用全部資源表示。

    • 條件關鍵字：是指雲產品自身定義的條件關鍵字。

    • 關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    alb:CreateServerGroup

    create

    *ServerGroup

    acs:alb:{#regionId}:{#accountId}:servergroup/*
    • alb:ServerGroupProtocol
    		 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    ServerGroupName

    string

    是

    伺服器組名稱。長度為 2~128 個字元，必須以大小寫字母或中文開頭，可包含數字、半形句號（.）、底線（_）和短劃線（-）。

    test
    ServerGroupType

    string

    否

    伺服器群組類型。取值：

    • Instance（預設值）：伺服器類型，該類型伺服器組支援添加 Ecs、Eni、Eci 執行個體。

    • Ip：IP 位址類型，該類型伺服器組支援添加 IP 位址類型的後端伺服器。

    • Fc：Function Compute類型，該類型支援添加Function Compute類型的後端伺服器。

    Instance
    VpcId

    string

    否

    VPC 執行個體 ID。只有該 VPC 下的伺服器可以加入到該伺服器組。

    說明

    ServerGroupType 取值為 Instance 或 Ip 時，該參數生效。

    vpc-bp15zdkdt37pq72zv****
    Scheduler

    string

    否

    調度演算法。取值：

    • Wrr（預設值）：加權輪詢，權重值越高的後端伺服器，被輪詢到的機率也越高。

    • Wlc：加權最小串連數，除了根據每台後端伺服器設定的權重值來進行輪詢，同時還考慮後端伺服器的實際負載（即串連數）。當權重值相同時，當前串連數越小的後端伺服器被輪詢到的機率也越高。

    • Sch：一致性雜湊，相同雜湊因子計算結果的請求將會調度到相同的後端伺服器。不配置 UchConfig 參數時，預設雜湊因子為源 IP，相同源 IP 位址的請求會分發到同一台後端伺服器；配置了 UchConfig 參數時，雜湊因子為 URL 參數，相同 URL 參數的請求會分發到同一台後端伺服器。

    說明

    ServerGroupType 取值為 Instance 或 Ip 時，該參數生效。

    Wrr
    Protocol

    string

    否

    後端協議。取值：

    • HTTP（預設值）：支援關聯 HTTPS、HTTP 和 QUIC 監聽。

    • HTTPS：支援關聯 HTTPS 監聽。

    • gRPC：關聯 HTTPS 和 QUIC 監聽。

    說明

    ServerGroupType 取值為 Fc 時，無需配置後端協議。

    HTTP
    ResourceGroupId

    string

    否

    資源群組 ID。

    rg-atstuj3rsop****
    HealthCheckConfig

    object

    是

    健全狀態檢查相關配置。

    HealthCheckConnectPort

    integer

    否

    健全狀態檢查的後端伺服器的連接埠。

    取值範圍： 0~65535。

    預設值：0，表示使用後端伺服器的連接埠進行健全狀態檢查。

    80
    HealthCheckEnabled

    boolean

    是

    是否開啟健全狀態檢查，取值：

    • true：開啟

    • false：不開啟

    說明

    ServerGroupType 取值為 Instance 或 Ip 時，預設開啟健全狀態檢查。ServerGroupType 取值為 Fc 時，預設不開啟健全狀態檢查。

    true
    HealthCheckHost

    string

    否

    健全狀態檢查網域名稱。

    • 使用後端伺服器的內網 IP（預設）：使用後端伺服器的內網 IP 位址作為健全狀態檢查的網域名稱。

    • 指定特定網域名稱：輸入一個網域名稱。

      • 長度限制為 1~80 個字元。

      • 可包含小寫字母、數字、短劃線（-）和半形句號（.）。

      • 至少包含一個半形句號（.），半形句號（.）不能出現在開頭或結尾。

      • 最右側的域標籤，只能包含字母，不能包含數字或短劃線（-）。

      • 短劃線（-）不能出現在開頭或結尾。

    說明

    只有 HealthCheckProtocol 設定為 HTTP、HTTPS 或 gRPC 時，該參數生效。

    www.example.com
    HealthCheckCodes

    array

    否

    健全狀態檢查正常的狀態代碼列表。

    string

    否

    健全狀態檢查正常的狀態代碼。

    • 當 HealthCheckProtocol 取值為 HTTP 或 HTTPS 時，HealthCheckCodes 可以選擇http_2xx（預設值）、 http_3xx、http_4xx和http_5xx。多個狀態代碼用半形逗號（,）分隔。

    • 當 HealthCheckProtocol 取值為 gRPC 時，HealthCheckCodes 狀態代碼範圍：0~99，預設值：0。支援範圍輸入，最多支援 20 個範圍值。多個範圍值使用半形逗號（,）隔開。

    說明

    HealthCheckProtocol 為 HTTP 或 HTTPS 或 gRPC，該參數生效。

    http_2xx
    HealthCheckHttpVersion

    string

    否

    健全狀態檢查 HTTP 協議版本，取值：HTTP1.0或HTTP1.1（預設值）。

    說明

    只有 HealthCheckProtocol 設定為 HTTP 或 HTTPS 時，該參數生效。

    HTTP1.1
    HealthCheckInterval

    integer

    否

    健全狀態檢查的時間間隔。單位：秒。

    取值範圍：1~50。

    預設值：2。

    2
    HealthCheckMethod

    string

    否

    健全狀態檢查方法，取值：

    • GET：如果響應報文長度超過 8K，會被截斷，但不會影響健全狀態檢查結果的判定。

    • POST：gRPC 監聽健全狀態檢查預設採用 POST 方法。

    • HEAD（預設值）：HTTP 和 HTTPS 監聽健全狀態檢查預設採用 HEAD 方法。

    說明

    只有 HealthCheckProtocol 設定為 HTTP 或 HTTPS 或 gRPC 時，該參數生效。

    HEAD
    HealthCheckPath

    string

    否

    健全狀態檢查的轉寄規則路徑。

    長度為 1~80 個字元，只能使用字母、數字、字元-/.%?#&=以及擴充字元_;~!（)*[]@$^:',+。 URL 必須以正斜線（/）開頭。

    說明

    只有 HealthCheckProtocol 設定為 HTTP 或 HTTPS 時，該參數生效。

    /test/index.html
    HealthCheckProtocol

    string

    否

    健全狀態檢查協議，取值：

    • HTTP：通過發送 HEAD 或 GET 請求類比瀏覽器的訪問行為來檢查伺服器應用是否健康。

    • HTTPS：通過發送 HEAD 或 GET 請求類比瀏覽器的訪問行為來檢查伺服器應用是否健康。（資料加密，相比 HTTP 更安全。）

    • TCP：通過發送 SYN 握手報文來檢測伺服器連接埠是否存活。

    • gRPC：通過發送 POST 或 GET 請求來檢查伺服器應用是否健康。

    HTTP
    HealthCheckTimeout

    integer

    否

    接收來自健全狀態檢查的響應需要等待的時間。如果後端伺服器在指定的時間內沒有正確響應，則判定為健全狀態檢查失敗。單位：秒。

    取值範圍：1~300。

    預設值：5。

    5
    HealthyThreshold

    integer

    否

    健全狀態檢查連續成功多少次後，將後端伺服器的健全狀態檢查狀態由失敗判定為成功。

    取值範圍：2~10。

    預設值：3。

    3
    UnhealthyThreshold

    integer

    否

    健全狀態檢查連續失敗多少次後，將後端伺服器的健全狀態檢查狀態由成功判定為失敗。

    取值範圍：2~10。

    預設值：3。

    3
    StickySessionConfig

    object

    否

    會話保持配置結構體。

    說明

    ServerGroupType 取值為 Instance 或 Ip 時，該參數生效。

    Cookie

    string

    否

    伺服器上配置的 Cookie。

    長度為 1~200 個字元，只能包含 ASCII 英文字母和數字字元，不能包含半形逗號（,）、半形分號（;）或空格，也不能以貨幣符號（$）開頭。

    說明

    當 StickySessionEnabled 為 true 且 StickySessionType 為 server 時，該參數生效。

    B490B6EBF6F3CD402E515D22BCDA****
    CookieTimeout

    integer

    否

    Cookie 逾時時間。單位：秒。

    取值範圍：1~86400。

    預設值：1000。

    說明

    當 StickySessionEnabled 為 true 且 StickySessionType 為 Insert 時，該參數生效。

    1000
    StickySessionEnabled

    boolean

    否

    是否啟用會話保持，取值：

    • true：開啟

    • false：不開啟。

    說明

    ServerGroupType 取值為 Instance 或 Ip 時，該參數生效。

    false
    StickySessionType

    string

    否

    Cookie 的處理方式。取值：

    • Insert（預設值）：植入 Cookie。 用戶端第一次訪問時，負載平衡會在返回請求中植入 Cookie（即在 HTTP 或 HTTPS 響應報文中插入 SERVERID），下次用戶端攜帶此 Cookie 訪問，負載平衡服務會將請求定向轉寄給之前記錄到的後端伺服器上。

    • Server：重寫 Cookie。 負載平衡發現使用者自訂了 Cookie，將會對原來的 Cookie 進行重寫，下次用戶端攜帶新的 Cookie 訪問，負載平衡服務會將請求定向轉寄給之前記錄到的後端伺服器。

    說明

    當 StickySessionEnabled 的值為 true 時，該參數生效。

    Insert
    ClientToken

    string

    否

    用戶端 Token，用於保證請求的等冪性。

    從您的用戶端產生一個參數值，確保不同請求間該參數值唯一。ClientToken 只支援 ASCII 字元。

    說明

    若您未指定，則系統自動使用 API 請求的 RequestId 作為 ClientToken 標識。每次 API 請求的 RequestId 可能不一樣。

    5A2CAF0E-5718-45B5-9D4D-70B******
    DryRun

    boolean

    否

    是否只預檢此次請求，取值：

    • true：發送檢查請求，不會建立伺服器組。檢查項包括是否填寫了必需參數、請求格式、業務限制。如果檢查不通過，則返回對應錯誤。如果檢查通過，則返回錯誤碼DryRunOperation。

    • false（預設值）：發送正常請求，通過檢查後返回 HTTP 2xx 狀態代碼並直接進行操作。

    false
    Ipv6Enabled

    boolean

    否

    是否開啟 Ipv6

    UpstreamKeepaliveEnabled

    boolean

    否

    是否開啟後端長連結。

    • true：開啟

    • false（預設值）：不開啟。

    false
    ServiceName

    string

    否

    僅適用於 ALB Ingress 情境，表示伺服器組對應的K8s Service名稱。

    test
    UchConfig

    object

    否

    url 一致性 hash 參數配置。

    Type

    string

    是

    參數類型。只能填 QueryString。

    QueryString
    Value

    string

    是

    一致性 hash 參數值。

    abc
    ConnectionDrainConfig

    object

    否

    串連優雅中斷相關配置。

    開啟串連優雅中斷，在移除後端伺服器或者健全狀態檢查失敗後，負載平衡使現有串連在一定時間內正常傳輸。

    說明

    • 基礎版執行個體不支援開啟串連優雅中斷，僅標準版、WAF 增強版執行個體支援。

    • 伺服器類型、IP 類型伺服器組支援串連優雅中斷，Function Compute類型不支援。

    ConnectionDrainEnabled

    boolean

    否

    是否開啟串連優雅中斷。

    • true：開啟

    • false：關閉（預設值）

    false
    ConnectionDrainTimeout

    integer

    否

    串連優雅中斷逾時時間。

    取值範圍：0~900。

    預設值：300。

    300
    SlowStartConfig

    object

    否

    慢啟動相關配置。

    開啟慢啟動後，將會在設定的時間段內對新添加到後端伺服器組的後端伺服器進行預熱，轉寄到該伺服器的請求數量線性增加。

    說明

    • 基礎版執行個體不支援開啟慢啟動，僅標準版、WAF 增強版執行個體支援。

    • 伺服器類型、IP 類型伺服器組支援配置慢啟動，Function Compute類型不支援。

    • 慢啟動僅在後端調度演算法是加權輪詢演算法時可開啟。

    SlowStartEnabled

    boolean

    否

    是否開啟慢啟動。

    • true：開啟

    • false：關閉（預設值）

    false
    SlowStartDuration

    integer

    否

    慢啟動期間。

    取值範圍：30~900。

    預設值：30。

    30
    Tag

    array<object>

    否

    標籤。

    object

    否

    標籤結構。

    Key

    string

    否

    標籤鍵。最多支援 128 個字元，不能以aliyun或acs:開頭，不能包含http://或https://。

    env
    Value

    string

    否

    標籤值。最多支援 128 個字元，不能以aliyun或acs:開頭，不能包含http://或https://。

    product
    CrossZoneEnabled

    boolean

    否

    伺服器組是否開啟跨 AZ 負載平衡。取值：

    • true：開啟（預設值）

    • false：關閉

    說明

    • 基礎版執行個體不支援綁定關閉跨 AZ 負載平衡的伺服器組，僅標準版、WAF 增強版執行個體支援。

    • 伺服器類型、IP 類型伺服器組支援關閉跨 AZ 負載平衡，Function Compute類型不支援。

    • 關閉跨 AZ 負載平衡時，不支援開啟會話保持。

    true

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    返回資料結構體

    JobId

    string

    非同步任務 ID。

    72dcd26b-f12d-4c27-b3af-18f6aed5****
    RequestId

    string

    請求 ID。

    365F4154-92F6-4AE4-92F8-7FF******
    ServerGroupId

    string

    伺服器組 ID。

    sgp-8ilqs4axp6******

    樣本

    正常返回樣本

    JSON格式

    {
  "JobId": "72dcd26b-f12d-4c27-b3af-18f6aed5****",
  "RequestId": "365F4154-92F6-4AE4-92F8-7FF******",
  "ServerGroupId": "sgp-8ilqs4axp6******"
}

    錯誤碼

    HTTP status code

    錯誤碼

    錯誤資訊

    描述
    400 QuotaExceeded.ServerGroupsNum The quota of %s is exceeded, usage %s/%s. 配額%s已超額度限制，目前已使用%s，配額為%s。
    400 Mismatch.LoadBalancerEditionAndSlowStartEnable The %s and %s are mismatched. 參數%s和%s不匹配。
    400 Mismatch.ServerGroupSchedulerAndSlowStartEnable The %s and %s are mismatched. 參數%s和%s不匹配。
    400 QuotaExceeded.SlowStartDuration The quota of %s is exceeded, usage %s/%s. 參數%s超過配額限制，當前值%s，配額值%s。
    400 UnsupportedFeature.SlowStart The feature of %s is not supported. 不支援%s特性。
    400 Mismatch.LoadBalancerEditionAndConnectionDrain The %s and %s are mismatched. 參數%s和%s不匹配。
    400 QuotaExceeded.ConnectionDrainTimeout The quota of %s is exceeded, usage %s/%s. 參數%s超過配額限制，當前值%s，配額值%s。
    400 UnsupportedFeature.ConnectionDrain The feature of %s is not supported. 不支援%s特性。
    400 NotExist.ResourceGroup ResourceGroup does not exist. 資源群組不存在
    400 OperationDenied.VpcNotSupportIpv6 The operation is not allowed because of VpcNotSupportIpv6. 不允許該操作，原因：當前VPC未開啟IPv6功能
    400 UnsupportedFeature.FcServerGroup Server groups of type FC are not supported. 不支援FC類型的伺服器組
    404 ResourceNotFound.Vpc The specified resource %s is not found. VPC不存在。

    訪問錯誤中心查看更多錯誤碼。

    變更歷史

    更多資訊，參考變更詳情。