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

Server Load Balancer:CreateLoadBalancer

最終更新日:Jun 05, 2026

指定のリージョンにアプリケーションロードバランサーを作成します。

操作説明

CreateLoadBalancer 操作は非同期です。呼び出しが成功するとインスタンス ID が返りますが、Application Load Balancer インスタンスはバックグラウンドで作成されます。GetLoadBalancerAttribute を呼び出して、Application Load Balancer インスタンスの作成ステータスを確認してください。

  • インスタンスが provisioning 状態の場合、作成中です。

  • インスタンスが active 状態の場合、作成済みです。

今すぐお試しください

この 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 ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

alb:CreateLoadBalancer

作成

* ロードバランサー

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

  • alb:AddressType
なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

ClientToken

string

任意

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

リクエストごとに、クライアント側で一意の値を生成できます。ClientToken パラメータは ASCII 文字のみをサポートします。

説明

このパラメータを省略した場合、システムはリクエストの RequestIdClientToken として使用します。

5A2CFF0E-5718-45B5-9D4D-70B3FF3898

DryRun

boolean

任意

ドライランを実行するかどうかを指定します。有効な値:

  • true:Application Load Balancer インスタンスを作成せずにドライランを実行します。システムは、必須パラメータ、リクエスト形式、およびサービス制限を確認します。リクエストがチェックに失敗した場合、エラーが返されます。リクエストがチェックに合格した場合、システムは DryRunOperation エラーコードを返します。

  • false (デフォルト):通常のリクエストを送信します。リクエストがチェックに合格した場合、システムは HTTP 2xx ステータスコードを返し、操作を実行します。

false

VpcId

string

必須

Application Load Balancer インスタンスがデプロイされる VPC の ID。

vpc-bp1b49rqrybk45nio****

AddressType

string

必須

Application Load Balancer のアドレスタイプ。有効な値:

  • Internet:ロードバランサーにパブリック IP アドレスが割り当てられます。ドメイン名はパブリック IP アドレスに解決され、インターネット経由でアクセスできます。

  • Intranet:ロードバランサーにプライベート IP アドレスが割り当てられます。ドメイン名はプライベート IP アドレスに解決され、ロードバランサーがデプロイされている VPC 内からのみアクセスできます。

Internet

LoadBalancerName

string

任意

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

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

alb1

DeletionProtectionEnabled

boolean

任意

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

  • true:削除保護を有効にします。

  • false (デフォルト):削除保護を無効にします。

false

ModificationProtectionConfig

object

任意

変更保護の設定。

Reason

string

任意

変更保護を有効にする理由。

理由は 2~128 文字である必要があります。先頭は英字または漢字である必要があり、数字、ピリオド (.)、アンダースコア (_)、およびハイフン (-) を使用できます。

説明

StatusConsoleProtection に設定されている場合にのみ、このパラメータは有効です。

Managed Instance

Status

string

任意

Application Load Balancer インスタンスの変更保護ステータス。有効な値:

  • NonProtection:変更保護は無効です。Reason に値を指定した場合、その値はクリアされます。

  • ConsoleProtection:コンソールでの変更保護が有効です。Reason に値を指定した場合、その値が有効になります。

説明

値を ConsoleProtection に設定した場合、Application Load Balancer コンソールでインスタンスを変更できません。ただし、API を呼び出して変更することは可能です。

ConsoleProtection

ZoneMappings

array<object>

必須

アベイラビリティーゾーンとサブネット間のマッピング。最大 10 個のアベイラビリティーゾーンを指定できます。リージョンに 2 つ以上のアベイラビリティーゾーンがある場合は、少なくとも 2 つ指定する必要があります。

object

任意

アベイラビリティーゾーンとサブネット間のマッピング。最大 10 個のアベイラビリティーゾーンを指定できます。リージョンに 2 つ以上のアベイラビリティーゾーンがある場合は、少なくとも 2 つ指定する必要があります。

VSwitchId

string

必須

指定したアベイラビリティーゾーン内のサブネットの ID。各アベイラビリティーゾーンでマッピングできるサブネットは 1 つだけです。

vsw-sersdf****

ZoneId

string

必須

アベイラビリティーゾーンの ID。 利用可能なゾーンをクエリするには、DescribeZones API を呼び出します。

cn-hangzhou-a

AllocationId

string

任意

インターネット向けインスタンスに関連付ける Elastic IP アドレス (EIP) の ID。

eip-bp1aedxso6u80u0qf****

EipType

string

任意

Elastic IP アドレスのタイプ。有効な値:

  • Common (デフォルト):Elastic IP アドレス。

  • Anycast:エニキャスト EIP。

説明

Application Load Balancer インスタンスへのエニキャスト EIP のバインドがサポートされているリージョンについては、Limitations をご参照ください。

Common

IntranetAddress

string

任意

プライベート IPv4 アドレス。

192.168.10.1

AddressAllocatedMode

string

任意

アドレス割り当てモード。有効な値:

  • Fixed (デフォルト):各アベイラビリティーゾーンに静的 IP アドレスが割り当てられます。

  • Dynamic:各アベイラビリティーゾーンに IP アドレスが動的に割り当てられます。

説明

2025 年 2 月 25 日 00:00:00 (UTC+8) 以降、この API を呼び出して作成されたすべてのインスタンスは、指定したモードにかかわらず upgraded ALB instances となります。IP モードの区別はなくなり、割り当てられた IP アドレスは自動的にスケールします。アップグレード前に作成された既存の ALB インスタンスには影響しません。

Fixed

ResourceGroupId

string

任意

リソースグループの ID。

rg-atstuj3rtop****

LoadBalancerEdition

string

必須

Application Load Balancer のエディション。エディションによって、機能と課金ポリシーが異なります。有効な値:

  • Basic:Basic エディション。

  • Standard:Standard エディション。

  • StandardWithWaf:WAF 対応エディション。

Standard

LoadBalancerBillingConfig

object

必須

Application Load Balancer インスタンスの課金設定。

PayType

string

必須

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

従量課金の場合は、値を PostPay に設定します。

PostPay

BandwidthPackageId

string

任意

インターネット向けインスタンスに関連付ける共有帯域幅パッケージの ID。

cbwp-bp1vevu8h3ieh****

AddressIpVersion

string

任意

プロトコルバージョン。有効な値:

  • IPv4:IPv4。

  • DualStack:デュアルスタック。インスタンスは IPv4 と IPv6 の両方をサポートします。

IPv4

Tag

array<object>

任意

インスタンスに追加するタグ。

object

任意

タグ構造。

Key

string

任意

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

env

Value

string

任意

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

product

SecurityGroupIds

array<object>

任意

インスタンスに関連付けるセキュリティグループの ID。

object

任意

インスタンスに関連付けるセキュリティグループの ID。

SecurityGroupId

string

任意

セキュリティグループの ID。

sg-gw82chzr7ru23iwbn9mu

レスポンスフィールド

フィールド

説明

オブジェクト

Application Load Balancer インスタンス作成のレスポンス。

LoadBalancerId

文字列

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

alb-o9ulmq5hqn68jk****

RequestId

文字列

リクエスト ID。

CEF72CEB-54B6-4AE8-B225-F876FF7BA984

成功レスポンス

JSONJSON

{
  "LoadBalancerId": "alb-o9ulmq5hqn68jk****",
  "RequestId": "CEF72CEB-54B6-4AE8-B225-F876FF7BA984"
}

エラーコード

HTTP ステータスコード

エラーコード

エラーメッセージ

説明

400 ResourceNotEnough.VSwitchIp The specified resource %s is not enough. 指定されたリソース %s が不足しています。
400 QuotaExceeded.LoadBalancersNum The quota of %s is exceeded, usage %s/%s. %s のクォータを超えました (使用量: %s/%s)。
400 Mismatch.ZoneIdAndVSwitchId The %s and %s are mismatched. %s と %s が不一致です。
400 DuplicatedParam.ZoneId The param of ZoneId is duplicated. ZoneId パラメーターが重複しています。
400 OperationDenyed.ServiceLinkedRoleNotExist The service linked role AliyunServiceRoleForAlb does not exist. サービスにリンクされたロール AliyunServiceRoleForAlb が存在しません。
404 ResourceNotFound.VSwitch The specified resource %s is not found. 指定されたリソース %s が見つかりません。

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

変更履歴

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