すべてのプロダクト
Search
ドキュメントセンター

:CreateLoadBalancer

最終更新日:Aug 11, 2025

クラシックロードバランサー (CLB) インスタンスを作成します。

操作説明

説明
  • インスタンスを作成する前に、DescribeAvailableResource 操作を呼び出して、ゾーンで購入可能なリソースをクエリできます。

  • 課金はインスタンスの作成後に開始されます。

  • 従量課金方式は、LCU 課金インスタンスのみをサポートしています。スペック課金インスタンスは、2025年6月1日 00:00:00 (UTC + 08:00) から購入できなくなります。詳細については、「スペック課金 Classic Load Balancer (CLB) インスタンスの提供終了」をご参照ください。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

  • アクション:特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

  • API:アクションを具体的に実行するための API。

  • アクセスレベル:各 API に対して事前定義されているアクセスの種類。有効な値:create、list、get、update、delete。

  • リソースタイプ:アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

    • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

    • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

  • 条件キー:サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

  • 依存アクション:ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

slb:CreateLoadBalancer

create

*LoadBalancer

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

slb:AddressType
なし

リクエストパラメーター

パラメーター

タイプ

必須 / 任意

説明

RegionId

string

必須

CLB インスタンスのリージョン ID。

DescribeRegions 操作を呼び出して、利用可能なリージョンをクエリできます。

cn-hangzhou

AddressType

string

任意

CLB インスタンスのネットワークタイプ。有効な値:

  • internet: システムが CLB インスタンスにパブリック IP アドレスを割り当てます。CLB インスタンスはインターネット経由でリクエストを転送できます。

  • intranet: システムが CLB インスタンスにプライベート IP アドレスを割り当てます。CLB インスタンスは VPC 内でのみリクエストを転送できます。

internet

InternetChargeType

string

任意

インターネット向け CLB インスタンスの課金方式。有効な値:

  • paybytraffic (デフォルト): トラフィック課金。

  • paybybandwidth: 帯域幅課金。

説明
  • PayTypePayOnDemand に設定され、InstanceChargeTypePayByCLCU に設定されている場合、このパラメーターを paybytraffic に設定する必要があります。

  • このパラメーターを paybytraffic に設定した場合、Bandwidth パラメーターを指定する必要はありません。Bandwidth の値は、指定しても有効になりません。

paybytraffic

Bandwidth

integer

任意

CLB インスタンスのピーク帯域幅。単位:Mbit/s。

有効な値:1 から 5000

説明

このパラメーターは、AddressTypeinternet に設定され、InternetChargeTypepaybybandwidth に設定されている場合にのみ必須です。

10

ClientToken

string

任意

クライアントトークン。リクエストのべき等性を確保するために使用されます。

クライアントを使用してトークンを生成できますが、異なるリクエスト間でトークンが一意であることを確認する必要があります。

説明

このパラメーターを指定しない場合、システムは RequestIdClientToken として使用します。RequestId はリクエストごとに異なる場合があります。

593B0448-D13E-4C56-AC0D-FDF0FDE0E9A3

LoadBalancerName

string

任意

CLB インスタンスの名前。

名前は 1 ~ 80 文字でなければなりません。文字または漢字で始まり、数字、ピリオド(.)、アンダースコア(_)、ハイフン(-) を含めることができます。

このパラメーターを指定しない場合、システムはインスタンスに自動的に名前を割り当てます。

lb-bp1o94dp5i6ea****

VpcId

string

任意

CLB インスタンスがデプロイされている VPC の ID。

vpc-bp1aevy8sofi8mh1****

VSwitchId

string

任意

CLB インスタンスの vSwitch の ID。

VPC に CLB インスタンスを作成する場合、このパラメーターは必須です。このパラメーターを指定すると、AddressType パラメーターはデフォルトで intranet に設定されます。

説明

vSwitch がプライマリゾーンと同じゾーンにあることを確認してください。

vsw-bp12mw1f8k3jgy****

MasterZoneId

string

任意

CLB インスタンスのプライマリゾーンの ID。

DescribeZone 操作を呼び出して、指定したリージョンのプライマリゾーンとセカンダリゾーンをクエリできます。

説明

プライマリゾーンが vSwitch と同じゾーンであることを確認してください。

cn-hangzhou-b

SlaveZoneId

string

任意

CLB インスタンスのセカンダリゾーンの ID。

DescribeZone 操作を呼び出して、指定したリージョンのプライマリゾーンとセカンダリゾーンをクエリできます。

cn-hangzhou-d

LoadBalancerSpec

string

任意

CLB インスタンスのスペック。有効な値:

  • slb.s1.small

  • slb.s2.small

  • slb.s2.medium

  • slb.s3.small

  • slb.s3.medium

  • slb.s3.large

説明
  • InstanceChargeTypePayByCLCU に設定されている場合、このパラメーターは有効にならず、構成する必要はありません。

  • スペック課金 Classic Load Balancer (CLB) インスタンスは、2025年6月1日 00:00:00 (UTC + 08:00) から購入できなくなります。詳細については、「スペック課金 Classic Load Balancer (CLB) インスタンスの提供終了」をご参照ください。

slb.s1.small

ResourceGroupId

string

任意

リソースグループの ID。

rg-atstuj3rtopt****

PayType deprecated

string

任意

インスタンスの課金方式。有効な値:

  • PayOnDemand: 従量課金。

PayOnDemand

PricingCycle deprecated

string

任意

サブスクリプションインターネット向けインスタンスの課金サイクル。有効な値:

  • month

  • year

説明

このパラメーターは、Alibaba Cloud 中国サイト (aliyun.com) で作成されたサブスクリプションインスタンスに対してのみ有効です。

month

Duration deprecated

integer

任意

サブスクリプションインターネット向けインスタンスのサブスクリプション期間。有効な値:

  • PricingCycle が month に設定されている場合、有効な値は 1 から 9 です。

  • PricingCycle が year に設定されている場合、有効な値は 1 から 5 です。

説明

このパラメーターは、Alibaba Cloud 中国サイト (aliyun.com) で作成されたサブスクリプションインスタンスに対してのみ有効です。

1

AutoPay deprecated

boolean

任意

サブスクリプションインターネット向けインスタンスの自動支払いを有効にするかどうかを指定します。有効な値:

  • true: 自動支払いを有効にします。操作を呼び出した後、SLB インスタンスはすぐに作成されます。

  • false (デフォルト): 操作を呼び出した後、注文は作成されますが、支払われません。未払いの注文はコンソールで確認できます。SLB インスタンスは、注文が支払われるまで作成されません。

説明

このパラメーターは、Alibaba Cloud 中国サイト (aliyun.com) で作成されたサブスクリプションインスタンスに対してのみ有効です。

true

AddressIPVersion

string

任意

CLB インスタンスの IP バージョン。有効な値:ipv4ipv6

ipv4

Address

string

任意

内部向け CLB インスタンスのプライベート IP アドレス。IP アドレスは、vSwitch の CIDR ブロック内である必要があります。

192.168.XX.XX

Tag

array<object>

任意

インスタンスのタグ。

object

任意

タグ。

Key

string

任意

タグキー。最大 20 個のタグキーを指定できます。タグキーは空の文字列にすることはできません。

タグキーは最大 64 文字までで、aliyun または acs: で始めることはできません。http:// または https:// を含めることはできません。

test

Value

string

任意

タグ値。最大 20 個のタグ値を指定できます。タグ値は空の文字列にすることができます。 タグ値は最大 128 文字までで、aliyun または acs: で始めることはできません。http:// または https:// を含めることはできません。

value

DeleteProtection

string

任意

削除保護を有効にするかどうかを指定します。有効な値:

  • on: はい。

  • off: いいえ。

on

ModificationProtectionStatus

string

任意

CLB インスタンスの設定変更保護モード。有効な値:

  • NonProtection: 設定変更保護モードを無効にします。この場合、ModificationProtectionReason の値はクリアされます。

  • ConsoleProtection: コンソールで設定変更保護モードを有効にします。

説明

このパラメーターを ConsoleProtection に設定すると、CLB コンソールでインスタンスの設定を変更できなくなります。ただし、API 操作を呼び出すことによってインスタンスの設定を変更できます。

ConsoleProtection

ModificationProtectionReason

string

任意

設定変更保護モードを有効にする理由。理由は 1 ~ 80 文字でなければなりません。文字または漢字で始まり、数字、ピリオド(.)、アンダースコア(_)、ハイフン(-) を含めることができます。

説明

このパラメーターは、ModificationProtectionStatusConsoleProtection に設定されている場合にのみ必須です。

Managed instance

InstanceChargeType

string

任意

インスタンスの課金方式。

有効な値:PayByCLCU (LCU 課金)。

説明
  • このパラメーターは、PayType パラメーターが PayOnDemand (従量課金) に設定されている場合にのみ有効です。

  • スペック課金 Classic Load Balancer (CLB) インスタンスは、2025年6月1日 00:00:00 (UTC + 08:00) から購入できなくなります。詳細については、「スペック課金 Classic Load Balancer (CLB) インスタンスの提供終了」をご参照ください。

PayBySpec

レスポンスパラメーター

パラメーター

タイプ

説明

object

VpcId

string

CLB インスタンスがデプロイされている VPC の ID。

vpc-25dvzy9****

AddressIPVersion

string

CLB インスタンスの IP バージョン。

ipv4

VSwitchId

string

CLB インスタンスの vSwitch の ID。

vsw-255ecr****

RequestId

string

リクエストの ID。

365F4154-92F6-4AE4-92F8-7FF34B540710

LoadBalancerName

string

CLB インスタンスの名前。

lb-bp1o94dp5i6ea****

LoadBalancerId

string

CLB インスタンスの ID。

lb-hddhfjg****

ResourceGroupId

string

リソースグループの ID。

rg-atstuj3rto****

Address

string

CLB インスタンスのサービス IP アドレス。

42.XX.XX.6

NetworkType

string

CLB インスタンスのネットワークタイプ。有効な値:

  • vpc: VPC。

  • classic: クラシックネットワーク。

classic

OrderId

integer

サブスクリプションインスタンスの注文 ID。

20212961978****

成功レスポンス

JSONJSON

{
  "VpcId": "vpc-25dvzy9****",
  "AddressIPVersion": "ipv4",
  "VSwitchId": "vsw-255ecr****",
  "RequestId": "365F4154-92F6-4AE4-92F8-7FF34B540710",
  "LoadBalancerName": "lb-bp1o94dp5i6ea****",
  "LoadBalancerId": "lb-hddhfjg****",
  "ResourceGroupId": "rg-atstuj3rto****",
  "Address": "42.XX.XX.6",
  "NetworkType": "classic",
  "OrderId": 0
}

エラーコード

HTTP ステータスコード

エラーコード

エラーメッセージ

説明

400 OperationFailed.ZoneResourceLimit The operation failed because of resource limit of the specified zone.
400 CloudBoxNotSupportIpv6 The cloudBox instance does not support ipv6.
400 CloudBoxNotSupportInternet The cloudBox instance does not support internet.
400 OperationFailed.RegionResourceLimit The operation failed because of resource limit of the specified region.
400 Operation.NotAllowed Operation Denied. The charge type of internet prepay instance can only be paybybandwidth.
400 OperationFailed.UnpaidBillsExist The account has unpaid bills. Please pay your overdue bill first.
400 RegionOrZonesNotSupportIpv6 The specified region or master/slave zones does not support ipv6.
400 InvalidParameter.Mismatch AddressType and IpVersion is conflict, IPv6 does not support intranet instance.
400 PAYFOR.CREDIT_PAY_INSUFFICIENT_BALANCE Your account does not have enough balance.
400 HighRiskOperationDenied The operation is denied because of high risk.
400 VSwitchAvailableIpNotExist The specified VSwitch has no availabe ip.
400 VSwitchNotExist The specified VSwitch does not exist.
400 InvalidParameter Illegal parameter. The IP address is not in subnet.
400 Instance.ShareSlbNotSupportPay95 Illegal parameter. The share instance not support PayBy95 or PayByOld95.
400 Instance.Pay95RateInvalid Illegal parameter. The rate is illegal.
400 Instance.Pay95BandwidthIllegal Illegal parameter. The bandwidth is illegal.
400 Instance.InternetChargeTypeNotAllowed Illegal parameter. The specified InternetChargeType not allowed.
400 OperationFailed.TokenIsProcessing The operation is failed, because the Client Token is processing.
400 InsufficientBalance Your account does not have enough balance.
400 MissingParam.VSwitchId The parameter VSwitchId is required.
400 InvalidVpcId.NotExist The specified VPC not exist.
400 PAY.MAYI_WITHHOLDING_AGREEMENT_ILLEGAL Your account did not sign a withholding agreement or no coupons in Alipay.
400 InvalidParameter.CloudType The specified CloudType is invalid.
400 OperationFailed.InvalidAccount The account information is incomplete.
400 RegionOrZonesNotSupportCEN The specified region or master/slave zones does not support cloudType of hybrid_cen.
400 MissingParam.LoadBalancerSpec The param LoadBalancerSpec is required.
400 InvalidParameter.Bandwidth The param Bandwidth is invalid.
400 OperationForbidden.AccountRiskReject The operation failed because of account risk reject.
400 OperationForbidden.QuotaLimit The operation failed because of quota limit of shared loadbalancers.
400 InvalidParam.ModificationProtectionStatus The param ModificationProtectionStatus is invalid.
400 InvalidParam.ModificationProtectionReason The param ModificationProtectionReason is invalid.
400 ShareSlbHaltSales The share instance has been discontinued.
400 OperationFailed.CashBookInsufficient No payment method is specified for your account, We recommend that you add a payment method or maintain a prepayment balance.
400 OperationFailed.OnlyInnerCommoditySupportToPurchase AliCroup2Cloud user only can buy inner commodity.
400 OperationFailed.InvokeLingXiaoFailed Failed to invoke lingxiao service.
400 AllocateVpcInstanceFailed Failed to allocate vpc instance.
400 QueryCreditCtrlInfoFailed Failed to query credit ctrl info.
400 QueryCommodityCenterFailed Failed to query commodity center.
400 RegionNotSupportParameter Current region does not support the param of %s.
400 QueryAccountBookInfoFailed Failed to invoke account book info.
400 RateAccountFailed Failed to rate account for pricing.
400 TradeWaitDistributorAudit The trade needs distributor to audit.
400 OperationFailed.InvokeProxyFailed Failed to invoke proxy.
400 QueryAccountCompleteProgressFailed Failed to query account progress.
400 QueryVoucherInfoFailed Failed to query voucher info.
400 InvalidVSwitchId.NotFound The specified vSwitch instance is invalid.
400 IllegalParam.SpecType The param of SpecType is illegal.
400 MissingParam.SpecType The param of SpecType is missing.
400 UnsupportedRegion The feature is not supported in current region.
400 PayInsufficientBalance Your account balance is insufficient.
400 IllegalParam.InstanceChargeType The parameter InstanceChargeType is illegal.
400 SystemBusy The system is busy.
400 PRODUCT.NOT_AVAILABLE_IZ The Instance zone id doesn t support
400 PRICE.INQUIRY_FAILED The instance pricing inquiry is failed.
400 AssociateIpFail The instance associating ip is failed.
400 SDK.ServerUnreachable Service is unreachable.
400 OverQuota The Total is over the quota 合計数が限度額を超えています。数を減らしてから再試行してください。
400 InvalidParam.TagValue %s.
400 InvalidParam.TagKey %s.
400 SizeLimitExceeded.Tag %s.
400 MissingParam.TagKey The param MissingParam.TagKey is missing.
400 SubnetIpExhaust No subnet IP addresses are available.
400 BeforePayRuleBatchValidateError The pre-payment rule center instance rule validation failed. Please check if the instance limit has been reached.
400 TradeSyncCreateSubError Subscription transfer failed.
400 QueryOrderError Failed to query the order. Please try again later.
400 CreateOrderTimeout Order creation timed out. Please try again later.
400 MultiGrayKeyResourceInconsist The identifier for the gray resource is set incorrectly.
400 InsufficientAvailableQuota Your account available balance is less than 0. Please recharge before attempting to make a purchase.
400 Forbidden.AliGroupForbiddenRegion Thre region is forbidden for aligroup user.
403 SecurityRisk.AuthVerification We have detected a security risk with your payment method. Please proceed with verification via the link in your email or console message and re-submit your order after verification.

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。