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

:CreateLoadBalancer

最終更新日:Dec 19, 2025

指定されたリージョンに Application Load Balancer (ALB) インスタンスを作成します。

操作説明

CreateLoadBalancer は非同期操作です。リクエストの送信後、システムはリクエスト ID を返し、バックグラウンドでタスクを実行します。GetLoadBalancerAttribute 操作を呼び出して、ALB インスタンスのステータスをクエリできます。

  • ALB インスタンスが Provisioning ステータスの場合、ALB インスタンスが作成中であることを示します。

  • ALB インスタンスが Active ステータスの場合、ALB インスタンスが作成されたことを示します。

今すぐお試しください

この 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

create

*LoadBalancer

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

  • alb:AddressType
なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

ClientToken

string

任意

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

クライアントを使用して値を生成できますが、異なるリクエスト間で一意である必要があります。トークンには ASCII 文字のみを含めることができます。

説明

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

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

DryRun

boolean

任意

ドライランを実行するかどうかを指定します。デフォルト値:false。有効な値:

  • true:ドライランを実行します。システムは必須パラメーター、リクエストフォーマット、およびサービス制限を確認します。リクエストがドライランに失敗した場合、エラーメッセージが返されます。リクエストがドライランに成功した場合、DryRunOperation エラーコードが返されます。

  • false:ドライランを実行し、リクエストを送信します。リクエストがドライランに成功した場合、2xx HTTP ステータスコードが返され、操作が実行されます。

false

VpcId

string

必須

ALB インスタンスを作成する VPC (Virtual Private Cloud) の ID。

vpc-bp1b49rqrybk45nio****

AddressType

string

必須

ALB インスタンスのアドレスタイプ。有効な値:

  • Internet:ALB インスタンスはパブリック IP アドレスを使用します。ALB インスタンスのドメイン名はパブリック IP アドレスに解決されます。この場合、ALB インスタンスはインターネット経由でアクセスできます。

  • Intranet:ALB インスタンスはプライベート IP アドレスを使用します。ALB インスタンスのドメイン名はプライベート IP アドレスに解決されます。この場合、ALB インスタンスは、ALB インスタンスがデプロイされている VPC 経由でアクセスできます。

Internet

LoadBalancerName

string

任意

ALB インスタンスの名前。

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

alb1

DeletionProtectionEnabled

boolean

任意

削除保護を有効にするかどうかを指定します。デフォルト値:false。有効な値:

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

  • false:削除保護を無効にします。

false

ModificationProtectionConfig

object

任意

設定変更保護の設定。

Reason

string

任意

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

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

説明

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

test

Status

string

任意

設定変更保護を有効にするかどうかを指定します。有効な値:

  • NonProtection:設定変更保護を無効にします。この場合、指定した Reason パラメーターの値は有効になりません。Reason を指定した場合、パラメーターの値はクリアされます。

  • ConsoleProtection:設定変更保護を有効にします。この場合、指定した Reason パラメーターの値が有効になります。****

説明

パラメーターが ConsoleProtection に設定されている場合、設定変更保護が有効になります。ALB コンソールで ALB インスタンスの構成を変更することはできません。ただし、API 操作を呼び出して ALB インスタンスの構成を変更することはできます。

ConsoleProtection

ZoneMappings

array<object>

必須

ゾーンと vSwitch 間のマッピング。最大 10 個のゾーンを指定できます。選択したリージョンが 2 つ以上のゾーンをサポートしている場合は、サービスの高可用性を確保するために、少なくとも 2 つのゾーンを選択してください。

object

任意

ゾーンと vSwitch 間のマッピング。最大 10 個のゾーンを指定できます。選択したリージョンが 2 つ以上のゾーンをサポートしている場合は、サービスの高可用性を確保するために、少なくとも 2 つのゾーンを選択してください。

VSwitchId

string

必須

ゾーン内の vSwitch。各ゾーンで指定できる vSwitch (サブネット) は 1 つだけです。最大 10 個のゾーンを指定できます。リージョンが 2 つ以上のゾーンをサポートしている場合は、少なくとも 2 つのゾーンを指定してください。

vsw-sersdf****

ZoneId

string

必須

クラスターのゾーン ID。最大 10 個のゾーンを指定できます。リージョンが 2 つ以上のゾーンをサポートしている場合は、少なくとも 2 つのゾーンを指定してください。DescribeZones 操作を呼び出して、最新のゾーンリストをクエリできます。

cn-hangzhou-a

AllocationId

string

任意

インターネット向けの ALB インスタンスに関連付ける EIP の ID。

eip-bp1aedxso6u80u0qf****

EipType

string

任意

EIP のタイプ。有効な値:

  • Common:EIP。

  • Anycast:Anycast EIP。

説明

ALB が Anycast EIP をサポートするリージョンの詳細については、「制限事項」をご参照ください。

Common

IntranetAddress

string

任意

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

192.168.10.1

AddressAllocatedMode

string

任意

ALB インスタンスに IP アドレスを割り当てるモード。有効な値:

  • Fixed (デフォルト):各ゾーンの ALB インスタンスに固定 IP アドレスが割り当てられます。

  • Dynamic:各ゾーンの ALB インスタンスに IP アドレスが動的に割り当てられます。

説明

2025 年 2 月 25 日 00:00:00 (UTC+08:00) 以降、この操作を呼び出して ALB インスタンスを作成すると、指定したモードに関係なく、インスタンスは自動的にアップグレード版になります。アップグレード版の ALB インスタンスは、IP モードを区別しなくなります。代わりに、ロードバランシングサービスを提供するために IP アドレスをグローバルに自動スケーリングします。この日時より前に作成した ALB インスタンスは影響を受けません。

Dynamic

ResourceGroupId

string

任意

リソースグループの ID。

rg-atstuj3rtop****

LoadBalancerEdition

string

必須

ALB インスタンスのエディション。ALB インスタンスのエディションによって、特徴と課金ルールが異なります。有効な値:

  • Basic:ベーシック。

  • Standard:標準。

  • StandardWithWaf:WAF 有効。

Standard

LoadBalancerBillingConfig

object

必須

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

PayType

string

必須

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

値を PostPay に設定します。これは従量課金方法を指定します。

PostPay

BandwidthPackageId

string

任意

インターネット向けの ALB インスタンスに関連付けられている共有帯域幅インスタンスの ID。

cbwp-bp1vevu8h3ieh****

AddressIpVersion

string

任意

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

  • IPv4:IPv4。

  • DualStack:デュアルスタック。

IPv4

Tag

array<object>

任意

タグ。

object

任意

Key

string

任意

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

env

Value

string

任意

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

product

レスポンスフィールド

フィールド

説明

object

ALB インスタンスを作成する操作。

LoadBalancerId

string

ALB インスタンス ID。

alb-o9ulmq5hgn68jk****

RequestId

string

リクエストの ID。

CEF72CEB-54B6-4AE8-B225-F876FF7BA984

成功レスポンス

JSONJSON

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

エラーコード

HTTP ステータスコード

エラーコード

エラーメッセージ

説明

400 ResourceNotEnough.VSwitchIp The specified resource %s is not enough.
400 QuotaExceeded.LoadBalancersNum The quota of %s is exceeded, usage %s/%s.
400 Mismatch.ZoneIdAndVSwitchId The %s and %s are mismatched.
400 DuplicatedParam.ZoneId The param of ZoneId is duplicated.
400 OperationDenyed.ServiceLinkedRoleNotExist The service linked role AliyunServiceRoleForAlb does not exist.
404 ResourceNotFound.VSwitch The specified resource %s is not found.

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

変更履歴

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