すべてのプロダクト
Search

このプロダクト

    Server Load Balancer:CreateLoadBalancer

    ドキュメントセンター

    Server Load Balancer:CreateLoadBalancer

    最終更新日:Sep 08, 2026

    SLB インスタンスを作成します。

    操作説明

    説明

    • インスタンスを作成する前に、 DescribeAvailableResource の呼び出しを行い、各ゾーンで購入可能なリソースをクエリしてください。

    • インスタンスの作成後、料金が発生します。

    • 従量課金制の課金方法では、使用量課金インスタンスのみがサポートされています。スペック課金インスタンスは、2025 年 6 月 1 日 00:00:00 (協定世界時 (UTC)+8) 以降、新規購入できなくなりました。詳細については、「スペック課金 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

    必須

    Classic Load Balancer (CLB) インスタンスのリージョン ID。

    DescribeRegions の呼び出しを行い、リージョン ID をクエリできます。

    cn-hangzhou
    AddressType

    string

    任意

    Classic Load Balancer (CLB) インスタンスのネットワークタイプ。有効な値:

    • internet: インターネット向け SLB インスタンスの作成後、システムはパブリック IP アドレスをインスタンスに割り当てるため、インスタンスはインターネットからのリクエストを転送できます。

    • intranet: VPC タイプの内部向け Server Load Balancer インスタンスの作成後、システムは内部ネットワーク IP アドレスをインスタンスに割り当てるため、インスタンスは内部ネットワークリクエストのみを転送できます。

    internet
    InternetChargeType

    string

    任意

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

    • paybytraffic (デフォルト): データ転送課金。

    • paybybandwidth: 帯域幅課金。

    説明

    • PayType が PayOnDemand にセットされ、InstanceChargeType が PayByCLCU にセットされている場合、このパラメーターは paybytraffic のみをサポートします。

    • このパラメーターを paybytraffic にセットした場合、Bandwidth パラメーターをセットする必要はありません。Bandwidth パラメーターをセットしても、その値に効果はありません。

    paybytraffic
    Bandwidth

    integer

    任意

    インスタンスの帯域幅の最大値。単位: Mbit/s。

    有効な値: 1 ~ 5000。

    説明

    このパラメーターは、AddressType が インターネット にセットされ、InternetChargeType が paybybandwidth にセットされている場合にのみ効果があります。

    10
    ClientToken

    string

    任意

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

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

    説明

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

    593B0448-D13E-4C56-AC0D-FDF0FDE0E9A3
    LoadBalancerName

    string

    任意

    Server Load Balancer インスタンスの名前。

    名前は 1 ~ 80 文字で、英字、数字、ピリオド (.)、アンダースコア (_)、ハイフン (-) を使用できます。先頭は英字または漢字にする必要があります。

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

    lb-bp1o94dp5i6ea****
    VpcId

    string

    任意

    Server Load Balancer インスタンスが属する VPC の ID。

    vpc-bp1aevy8sofi8mh1****
    VSwitchId

    string

    任意

    SLB インスタンスが属する vSwitch の ID。

    VPC タイプの Server Load Balancer インスタンスを作成するには、このパラメーターを指定する必要があります。このパラメーターを指定すると、AddressType の値は自動的に intranet にセットされます。

    説明

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

    vsw-bp12mw1f8k3jgy****
    MasterZoneId

    string

    任意

    Server Load Balancer インスタンスのプライマリゾーン ID。

    DescribeZone の呼び出しを行い、リージョン内のプライマリゾーンとセカンダリゾーンをクエリできます。

    説明

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

    cn-hangzhou-b
    SlaveZoneId

    string

    任意

    Server Load Balancer インスタンスのセカンダリゾーン ID。

    DescribeZone の呼び出しを行い、リージョン内のプライマリゾーンとセカンダリゾーンをクエリできます。

    cn-hangzhou-d
    LoadBalancerSpec

    string

    任意

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

    • slb.s1.small

    • slb.s2.small

    • slb.s2.中間

    • slb.s3.small

    • slb.s3.中間

    • slb.s3.large

    説明

    • InstanceChargeType が PayByCLCU にセットされている場合、このパラメーターに効果はなく、指定する必要はありません。

    • スペック課金 Classic Load Balancer (CLB) インスタンスは、2025 年 6 月 1 日 00:00:00 (協定世界時 (UTC)+8) 以降、新規購入できなくなりました。詳細については、「スペック課金 CLB インスタンスの販売終了に関するお知らせ」をご参照ください。

    slb.s1.small
    ResourceGroupId

    string

    任意

    エンタープライズリソースグループの ID。

    rg-atstuj3rtopt****
    PayType deprecated

    string

    任意

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

    • PayOnDemand: 従量課金。

    PayOnDemand
    PricingCycle deprecated

    string

    任意

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

    • month

    • year

    説明

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

    month
    Duration deprecated

    integer

    任意

    インターネット向けインスタンスの料金。有効な値:

    • PricingCycle が month にセットされている場合、有効な値は 1 ~ 9 です。

    • PricingCycle が year にセットされている場合、有効な値は 1 ~ 5 です。

    説明

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

    1
    AutoPay deprecated

    boolean

    任意

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

    • true: 自動支払いが自動的に完了します。この操作の呼び出し後、SLB インスタンスがすぐに作成されます。

    • false (デフォルト): この操作の呼び出し後、注文は作成されますが自動支払いは完了しません。コンソールで未払いの注文をビューできます。注文が支払われていないため、SLB インスタンスは作成されません。

    説明

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

    true
    AddressIPVersion

    string

    任意

    Server Load Balancer インスタンスの IP バージョン。有効な値: ipv4 および ipv6。

    ipv4
    Address

    string

    任意

    インスタンスの非公開 IP アドレス。IP アドレスは vSwitch の CIDR ブロック内である必要があります。

    192.168.XX.XX
    Tag

    array<object>

    任意

    タグ。

    object

    任意

    タグ。

    Key

    string

    任意

    インスタンスのタグキー。N の有効な値: 1 ~ 20。タグキーは空文字列にできません。

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

    test
    Value

    string

    任意

    インスタンスのタグ値。N の有効な値: 1 ~ 20。タグ値は空文字列にできます。 タグ値は最大 128 文字で、先頭を aliyun または acs: にすることはできません。http:// または https:// を含めることはできません。

    値
    DeleteProtection

    string

    任意

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

    • on: 有効。

    • off: 無効。

    on
    ModificationProtectionStatus

    string

    任意

    Classic Load Balancer (CLB) インスタンスの構成読み取り専用モード。有効な値:

    • NonProtection: 構成読み取り専用モードは無効です。この値を設定すると、ModificationProtectionReason の値がクリアされます。

    • ConsoleProtection: コンソールの構成読み取り専用モードが有効です。

    説明

    構成読み取り専用モードを有効にするためにこのパラメーターを ConsoleProtection に設定した場合、Server Load Balancer コンソールでインスタンスの構成を変更することはできません。ただし、API 操作を呼び出してインスタンスの構成を変更することはできます。

    ConsoleProtection
    ModificationProtectionReason

    string

    任意

    構成読み取り専用モードを有効にする理由。理由は 1 ~ 80 文字で、先頭は英字または漢字にする必要があります。数字、ピリオド (.)、アンダースコア (_)、ハイフン (-) を使用できます。

    説明

    このパラメーターは、ModificationProtectionStatus が ConsoleProtection にセットされている場合にのみ効果があります。

    マネージドインスタンス
    InstanceChargeType

    string

    任意

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

    有効な値: PayByCLCU: 使用量課金。

    説明

    • このパラメーターは、PayType が PayOnDemand (従量課金) にセットされている場合にのみ効果があります。

    • スペック課金 Classic Load Balancer (CLB) インスタンスは、2025 年 6 月 1 日 00:00:00 (協定世界時 (UTC)+8) 以降、新規購入できなくなりました。詳細については、「スペック課金 CLB インスタンスの販売終了に関するお知らせ」をご参照ください。

    PayBySpec

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    VpcId

    string

    Server Load Balancer インスタンスが属する VPC の ID。

    vpc-25dvzy9****
    AddressIPVersion

    string

    Server Load Balancer インスタンスの IP アドレスタイプ。

    ipv4
    VSwitchId

    string

    Server Load Balancer インスタンスが属する vSwitch の ID。

    vsw-255ecr****
    RequestId

    string

    リクエスト ID。

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

    string

    Server Load Balancer インスタンスの名前。

    lb-bp1o94dp5i6ea****
    LoadBalancerId

    string

    Server Load Balancer インスタンスの ID。

    lb-hddhfjg****
    ResourceGroupId

    string

    リソースグループ ID。

    rg-atstuj3rto****
    Address

    string

    SLB インスタンスに割り当てる IP アドレス。

    42.XX.XX.6
    NetworkType

    string

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

    • 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. CloudBox インスタンスでは IPv6 がサポートされていません。
    400 CloudBoxNotSupportInternet The cloudBox instance does not support internet. CloudBox インスタンスではインターネットアクセスがサポートされていません。
    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. 指定されたリージョン、またはプライマリ/セカンダリゾーンは IPv6 をサポートしていません。
    400 InvalidParameter.Mismatch AddressType and IpVersion is conflict, IPv6 does not support intranet instance. ネットワークタイプが IP バージョンと競合しています。内部 SLB インスタンスは IPv6 をサポートしていません。
    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. 指定された vSwitch に使用可能な IP アドレスがありません。
    400 VSwitchNotExist The specified VSwitch does not exist. 指定された vSwitch が存在しません。
    400 InvalidParameter Illegal parameter. The IP address is not in subnet. Vgw ip が空です。Vgw ip パラメーターを指定してください。
    400 Instance.ShareSlbNotSupportPay95 Illegal parameter. The share instance not support PayBy95 or PayByOld95. 共有リソースインスタンスでは、PayBy95 または PayByOld95 はサポートされていません。
    400 Instance.Pay95RateInvalid Illegal parameter. The rate is illegal. 指定された Rate は無効です。パラメーターの制約を確認してリトライしてください。
    400 Instance.Pay95BandwidthIllegal Illegal parameter. The bandwidth is illegal. 指定された Bandwidth は無効です。パラメーターの制約を確認してリトライしてください。
    400 Instance.InternetChargeTypeNotAllowed Illegal parameter. The specified InternetChargeType not allowed. パラメーターは無効です。指定された InternetChargeType (インターネット) はサポートされていません。
    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. VSwitchId パラメーターがありません。
    400 InvalidVpcId.NotExist The specified VPC not exist. 指定された VPC は存在しません。
    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. 指定された CloudType が無効です。パラメーターの制約を確認し、修正後に再試行してください。
    400 OperationFailed.InvalidAccount The account information is incomplete. アカウント情報のフォーマットが不完全なため、操作に失敗しました。
    400 RegionOrZonesNotSupportCEN The specified region or master/slave zones does not support cloudType of hybrid_cen. 指定されたリージョン、またはプライマリ/セカンダリゾーンは CEN をサポートしていません。
    400 MissingParam.LoadBalancerSpec The param LoadBalancerSpec is required. LoadBalancerSpec パラメーターがありません。
    400 InvalidParameter.Bandwidth The param Bandwidth is invalid. 指定された Bandwidth が無効です。パラメーターの制約を確認して、再試行してください。
    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. 指定された ModificationProtectionStatus は無効です。パラメーターの制約を確認し、修正してから再試行してください。
    400 InvalidParam.ModificationProtectionReason The param ModificationProtectionReason is invalid. 指定された ModificationProtectionReason は無効です。パラメーターの制約を確認し、修正してから再試行してください。
    400 ShareSlbHaltSales The share instance has been discontinued. 共有リソース SLB インスタンスの在庫がありません。
    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. Lingxiao サービスの呼び出しに失敗したため、操作に失敗しました。
    400 AllocateVpcInstanceFailed Failed to allocate vpc instance. VPC 接続インスタンスの割り当てに失敗しました。
    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. vSwitch インスタンスが無効です。
    400 IllegalParam.SpecType The param of SpecType is illegal. 指定された SpecType は無効です。パラメーターの制約を確認してリトライしてください。
    400 MissingParam.SpecType The param of SpecType is missing. SpecType パラメーターがありません。
    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 指定されたインスタンスのゾーン ID はサポートされていません。
    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. サブネットに使用可能な IP アドレスがありません。
    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. アカウント残高が 0 未満です。アカウントに入金してリトライしてください。
    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. 支払方法でリスクが検出されました。Eメールまたはサイト内メッセージのリンクを使用して認証を完了してください。認証の完了後に新しい注文を行ってください。

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

    変更履歴

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