全部產品
Search

搜尋本產品

    Server Load Balancer：CreateServerGroup

    文件中心

    Server Load Balancer：CreateServerGroup

    更新時間：Sep 02, 2026

    在指定地域建立伺服器群組。

    介面說明

    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：函數運算類型，該類型支援新增函數運算類型的後端伺服器。

    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

    是

    健康檢查相關設定。

    rg-123
    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。

    true
    UpstreamKeepaliveEnabled

    boolean

    否

    是否開啟後端長連結。

    • true：開啟

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

    false
    ServiceName

    string

    否

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

    test
    UchConfig

    object

    否

    URL 一致性雜湊參數設定。

    Type

    string

    是

    參數類型。只能填 QueryString。

    QueryString
    Value

    string

    是

    一致性雜湊參數值。

    abc
    ConnectionDrainConfig

    object

    否

    連線優雅中斷相關設定。

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

    說明

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

    • 伺服器類型、IP 類型伺服器群組支援連線優雅中斷，函數運算類型不支援。

    ConnectionDrainEnabled

    boolean

    否

    是否開啟連線優雅中斷。

    • true：開啟

    • false：關閉（預設值）

    false
    ConnectionDrainTimeout

    integer

    否

    連線優雅中斷逾時時間。

    取值範圍：0~900。

    預設值：300。

    300
    SlowStartConfig

    object

    否

    慢啟動相關設定。

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

    說明

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

    • 伺服器類型、IP 類型伺服器群組支援設定慢啟動，函數運算類型不支援。

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

    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 負載平衡，函數運算類型不支援。

    • 關閉跨 AZ 負載平衡時，不支援開啟工作階段保持。

    true
    IpVersionAffinityMode

    string

    否

    IP 版本親和模式。

    Affinity

    返回參數

    名稱

    類型

    描述

    樣本值

    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 不存在。

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

    變更歷史

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