全部產品
Search
文件中心

Server Load Balancer:CreateLoadBalancer

更新時間:Oct 18, 2026

建立網路型負載平衡執行個體。

介面說明

  • 建立網路型負載平衡執行個體時會自動為使用者建立 AliyunServiceRoleForNlb SLR 角色。

  • CreateLoadBalancer 介面屬於非同步介面,即系統返回一個執行個體 ID,但該網路型負載平衡執行個體尚未建立成功,系統後台的建立任務仍在進行。您可以呼叫 GetLoadBalancerAttribute 查詢網路型負載平衡執行個體的建立狀態:
    • 當網路型負載平衡執行個體處於 Provisioning 狀態時,表示網路型負載平衡執行個體正在建立中。

    • 當網路型負載平衡執行個體處於 Active 狀態時,表示網路型負載平衡執行個體建立成功。

調試

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

調試

授權資訊

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

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

  • 存取層級:是指每個操作的存取層級,取值為寫入(Write)、讀取(Read)或列出(List)。

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

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

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

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

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

操作

存取層級

資源類型

條件關鍵字

關聯操作

nlb:CreateLoadBalancer

create

*LoadBalancer

acs:nlb:{#regionId}:{#accountId}:loadbalancer/*

*VSwitch

acs:vpc:{#regionId}:{#accountId}:vswitch/{#VSwitchId}

EipAddress

acs:vpc:{#regionId}:{#accountId}:eip/{#AllocationId}

*VPC

acs:vpc:{#regionId}:{#accountId}:vpc/{#VpcId}

  • nlb:AddressType
無

請求參數

名稱

類型

必填

描述

樣本值

LoadBalancerType

string

否

負載平衡的類型,僅取值:network,表示網路型負載平衡。

network

LoadBalancerName

string

否

網路型負載平衡執行個體名稱。

長度為 2~128 個英文或中文字元,必須以大小寫英文字母或中文開頭,可包含數字、半角句號(.)、底線(_)和短橫線(-)。

NLB1

AddressType

string

是

網路型負載平衡執行個體的 IPv4 位址類型。取值:

  • Internet:負載平衡具有公網 IP 位址,DNS 網域名稱被解析到公網 IP,因此可以在公網環境存取。

  • Intranet:負載平衡只有私網 IP 位址,DNS 網域名稱被解析到私網 IP,因此只能被負載平衡所在 VPC 的內部網路環境存取。

說明

網路型負載平衡雙堆疊執行個體的 IPv6 公網需透過 EnableLoadBalancerIpv6Internet 介面開啟。

Internet

AddressIpVersion

string

否

協定版本。取值:

  • ipv4(預設值):IPv4 類型。

  • DualStack:雙堆疊類型。

ipv4

VpcId

string

是

網路型負載平衡執行個體的專有網路 ID。

vpc-bp1b49rqrybk45nio****

ZoneMappings

array<object>

是

可用區及交換器對應清單。最多支援新增 10 個可用區。若目前地域支援 2 個及以上的可用區,至少需要新增 2 個可用區。

object

否

可用區及交換器對應清單。最多支援新增 10 個可用區。若目前地域支援 2 個及以上的可用區,至少需要新增 2 個可用區。

VSwitchId

string

是

可用區對應的交換器,每個可用區只能使用一台交換器和一個子網路。最多支援新增 10 個可用區。 若目前地域支援 2 個及以上的可用區,至少需要新增 2 個可用區。

vsw-sersdf****

ZoneId

string

是

網路型負載平衡執行個體的可用區 ID。最多支援新增 10 個可用區。若目前地域支援 2 個及以上可用區,至少需要新增 2 個可用區。

您可以透過呼叫 DescribeZones 介面取得可用區 ID。

cn-hangzhou-a

PrivateIPv4Address

string

否

IPv4 私網 VIP 位址。NLB 對外提供服務的私網 IPv4 位址。

192.168.10.1

AllocationId

string

否

公網執行個體繫結的 EIP 執行個體 ID,每個可用區對應 1 個 EIP 執行個體 ID。最多支援新增 10 個可用區。若目前地域支援 2 個及以上可用區,至少需要新增 2 個可用區。

eip-bp1aedxso6u80u0qf****

Ipv6Address

string

否

IPv6 VIP 位址。NLB 對外提供服務的 IPv6 位址。

2408:400a:d5:3080:b409:840a:ca:e8e5

Ipv4LocalAddresses

array

否

IPv4 Local 位址清單。NLB 與後端服務互動的位址清單。 位址個數必須是偶數,且最少 2 個,最多 8 個。

string

否

IPv4 Local 位址。

192.168.10.2

Ipv6LocalAddresses

array

否

IPv6 Local 位址清單。NLB 與後端服務互動的位址清單。 位址個數必須是偶數,且最少 2 個,最多 8 個。

string

否

IPv6 Local 位址。

2408:400a:d5:3080:b409:840a:ca:e8e6

BandwidthPackageId

string

否

公網類型執行個體關聯的共享頻寬套件 ID。

cbwp-bp1vevu8h3ieh****

LoadBalancerBillingConfig

object

否

網路型負載平衡執行個體計費設定。

PayType

string

否

網路型負載平衡執行個體的計費類型。

僅取值 PostPay:表示按量計費。

PostPay

ResourceGroupId

string

否

資源群組 ID。

rg-atstuj3rtop****

DryRun

boolean

否

是否僅預檢此次請求。取值:

  • true:傳送檢查請求,不會建立執行個體。檢查項目包括是否填寫了必要參數、請求格式、業務限制。如果檢查不通過,則返回對應錯誤。如果檢查通過,則返回錯誤碼DryRunOperation。

  • false(預設值):傳送正常請求,通過檢查後返回 HTTP 2xx 狀態碼並直接進行操作。

false

ClientToken

string

否

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

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

說明

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

123e4567-e89b-12d3-a456-426655440000

RegionId

string

否

網路型負載平衡執行個體所在的地域 ID。

您可以透過呼叫 DescribeRegions 介面取得地域 ID。

cn-hangzhou

DeletionProtectionConfig

object

否

刪除保護設定。

Enabled

boolean

否

刪除保護狀態,取值:

  • true:開啟狀態。

  • false(預設值):關閉狀態。

false

Reason

string

否

變更刪除保護狀態的原因。長度為 2~128 個英文或中文字元,必須以大小寫英文字母或中文開頭,可包含數字、半角句號(.)、底線(_)和短橫線(-)。

Instance is running

ModificationProtectionConfig

object

否

修改保護設定。

Status

string

否

網路型負載平衡修改保護狀態。取值:

  • NonProtection:不保護,表示不允許傳入保護設定的 Reason。如果設定了保護設定的 Reason,則清空其設定資訊。

  • ConsoleProtection:主控台修改保護,此時允許傳入保護設定的 Reason。

說明

當取值為 ConsoleProtection,即開啟修改保護後,使用者不能透過負載平衡主控台修改執行個體設定,但可以透過呼叫 API 修改執行個體設定。

ConsoleProtection

Reason

string

否

輸入開啟修改保護的原因。長度為 2~128 個英文或中文字元,必須以大小寫英文字母或中文開頭,可包含數字、半形句號(.)、底線(_)和短橫線(-)。

說明

僅在 Status 為 ConsoleProtection 時有效且合法。

Business protection period

Tag

array<object>

否

標籤清單。

object

否

標籤。

Key

string

否

標籤鍵。最多支援 64 個字元,不能以aliyun或acs:開頭,不能包含http://或https://。支援字元包括字母、數字、底線 (_)、點 (.)、冒號 (:)、斜線 (/)、等號 (=)、加號 (+)、減號 (-)、@符號 (@) 。

一次呼叫最多支援新增 20 個標籤。

env

Value

string

否

標籤值。最多支援 128 個字元,不能以aliyun或acs:開頭,不能包含http://或https://。支援字元包括字母、數字、底線 (_)、點 (.)、冒號 (:)、斜線 (/)、等號 (=)、加號 (+)、減號 (-)、@符號 (@) 。

一次呼叫最多支援新增 20 個標籤。

product

返回參數

名稱

類型

描述

樣本值

object

response

RequestId

string

請求 ID。

CEF72CEB-54B6-4AE8-B225-F876FF7BA984

LoadbalancerId

string

執行個體 ID。

nlb-83ckzc8d4xlp8o****

OrderId

integer

網路型負載平衡執行個體的訂單 ID。

20230000

樣本

正常返回樣本

JSON格式

{
  "RequestId": "CEF72CEB-54B6-4AE8-B225-F876FF7BA984",
  "LoadbalancerId": "nlb-83ckzc8d4xlp8o****",
  "OrderId": 20230000
}

錯誤碼

HTTP status code

錯誤碼

錯誤資訊

描述

400 OperationDenied.OnlyPayByTrafficSupported The operation is not allowed because of OnlyPayByTrafficSupported. 由於僅支援按流量計費,因此不允許進行此操作。
400 OperationFailed.%s The operation failed because of %s. 因為 % 操作目前 API 失敗。
400 Mismatch.ZoneIdAndVswitchId The ZoneIdAndVswitchId is mismatched for %s and %s. ZoneId和VswitchId缺失,請檢查輸入參數。
400 QuotaExceeded.%s The quota of %s is exceeded, usage %s/%s. %s 的配額超過限制,已使用 %s/%s。
400 DryRunOperation Request validation has been passed with DryRun flag set. dryRun 請求驗證已通過。
400 OperationDenied.OnlyPostPaidSupported The operation is not allowed because of OnlyPostPaidSupported. 由於僅支援後付費,因此不允許進行此操作。
400 OperationFailed.DuplicateZones. The operation failed because of Can not Specify duplicate zones. 由於指定了重複的可用區,操作失敗。請修改參數。
400 ResourceNotEnough.VSwitchIp The specified resource of VSwitchIp is not enough. 所指定的虛擬交換器 (vSwitch) IP 資源不足。
400 DuplicatedParam.AllocationId The param of AllocationId is duplicated. AllocationId 參數重複,請檢查參數。
400 ResourceInConfiguring.VswitchId The specified resource of VswitchId is being configured, please try again later. 正在設定指定的虛擬交換器資源,請稍後重試。
400 IllegalParam The param of %s is illegal. 輸入的參數有值非法,請檢查輸入。
400 OperationFailed.UnpaidBill The operation failed because of UnpaidBill. 您有欠費帳單,不符合購買條件。請先儲值結清帳單後再購買。
400 OperationDenied.ServiceLinkedRoleNotExist The operation is not allowed because of ServiceLinkedRoleNotExist. 由於服務連結角色不存在(ServiceLinkedRoleNotExist),不允許進行此操作。請檢查 RAM 中是否為 NLB 進行了授權。
400 ResourceAlreadyAssociated.AllocationId The specified resource of %s is already associated. 指定的資源 AllocationId 已經被關聯。
400 OperationFailed.vSwitchNotSupportIpv6 The operation failed because of vSwitchNotSupportIpv6. 所使用的虛擬交換器 (vSwitch) 不支援 IPv6 協定,請確認輸入參數。
400 InvalidZones The current zone list is illegal. Zone maping中使用的可用區非法。
400 QuotaExceeded.QuotaInsufficient The quota of %s is exceeded, usage %s/%s. 配額不足,已使用 %s/%s。請在配額中心中修改配額大小。
400 ResourceInUse.IP The specified resource of IP is in use. 傳入的 IP 不能是 NLB 的 ENI 位址,請檢查參數。
400 OperationFailed.CreateOrderError Operation failed because CreateOrderError. 因為建立訂單失敗,所以操作失敗。
400 OperationFailed.NotExist.ResourceGroup Operation failed because ResourceGroup not exist. 指定的資源群組不存在。
400 IllegalParam.loadBalancerName Param loadBalancerName is illegal. 執行個體名稱非法,請檢查參數。
400 SystemBusy System is busy, please try again later. 系統繁忙,請稍後重試。
400 MissingParam.%s The parameter of %s is missing. 參數%s缺失,請檢查輸入參數。
400 IllegalParam.DeletionProtectionConfig DeletionProtectionConfig reason is illegal. 變更刪除保護狀態原因參數非法。
400 IllegalParam.ModificationProtectionConfig ModificationProtectionConfig reason is illegal. 修改保護原因參數非法。
400 Throttling.User Request was denied due to api flow control. 由於觸發流量控制,請求被拒絕。
403 UnauthorizedZone The specified zone of %s is not authorized. 指定的可用區 %s 未被授權使用。
403 Forbidden.NoPermission Authentication is failed for NoPermission. 因為帳號沒有權限,所以授權失敗。
403 UnauthorizedRegion The specified region of %s is not authorized. 目前區域還沒有獲得授權。
404 ResourceNotFound.VSwitch The specified resource of vSwitch is not found. 找不到指定的虛擬交換器資源,請檢查輸入參數。
404 ResourceNotFound.Vpc The specified resource of Vpc is not found. 找不到指定的 VPC 資源,請檢查輸入參數。

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

變更歷史

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