指定のリージョンにアプリケーションロードバランサーを作成します。
操作説明
CreateLoadBalancer 操作は非同期です。呼び出しが成功するとインスタンス ID が返りますが、Application Load Balancer インスタンスはバックグラウンドで作成されます。GetLoadBalancerAttribute を呼び出して、Application Load Balancer インスタンスの作成ステータスを確認してください。
インスタンスが provisioning 状態の場合、作成中です。
インスタンスが active 状態の場合、作成済みです。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
alb:CreateLoadBalancer |
作成 |
* ロードバランサー
|
|
なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| ClientToken |
string |
任意 |
リクエストのべき等性を確保するためのクライアントトークン。 リクエストごとに、クライアント側で一意の値を生成できます。 説明
このパラメータを省略した場合、システムはリクエストの RequestId を ClientToken として使用します。 |
5A2CFF0E-5718-45B5-9D4D-70B3FF3898 |
| DryRun |
boolean |
任意 |
ドライランを実行するかどうかを指定します。有効な値:
|
false |
| VpcId |
string |
必須 |
Application Load Balancer インスタンスがデプロイされる VPC の ID。 |
vpc-bp1b49rqrybk45nio**** |
| AddressType |
string |
必須 |
Application Load Balancer のアドレスタイプ。有効な値:
|
Internet |
| LoadBalancerName |
string |
任意 |
Application Load Balancer インスタンスの名前。 名前は 2~128 文字で、先頭は英字、漢字、または数字である必要があります。数字、ピリオド (.)、アンダースコア (_)、ハイフン (-)、およびスペースを使用できます。 |
alb1 |
| DeletionProtectionEnabled |
boolean |
任意 |
削除保護を有効にするかどうかを指定します。有効な値:
|
false |
| ModificationProtectionConfig |
object |
任意 |
変更保護の設定。 |
|
| Reason |
string |
任意 |
変更保護を有効にする理由。 理由は 2~128 文字である必要があります。先頭は英字または漢字である必要があり、数字、ピリオド (.)、アンダースコア (_)、およびハイフン (-) を使用できます。 説明
Status が ConsoleProtection に設定されている場合にのみ、このパラメータは有効です。 |
Managed Instance |
| Status |
string |
任意 |
Application Load Balancer インスタンスの変更保護ステータス。有効な値:
説明
値を 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 アドレスのタイプ。有効な値:
説明
Application Load Balancer インスタンスへのエニキャスト EIP のバインドがサポートされているリージョンについては、Limitations をご参照ください。 |
Common |
| IntranetAddress |
string |
任意 |
プライベート IPv4 アドレス。 |
192.168.10.1 |
| AddressAllocatedMode |
string |
任意 |
アドレス割り当てモード。有効な値:
説明
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 のエディション。エディションによって、機能と課金ポリシーが異なります。有効な値:
|
Standard |
| LoadBalancerBillingConfig |
object |
必須 |
Application Load Balancer インスタンスの課金設定。 |
|
| PayType |
string |
必須 |
インスタンスの課金方法。 従量課金の場合は、値を PostPay に設定します。 |
PostPay |
| BandwidthPackageId |
string |
任意 |
インターネット向けインスタンスに関連付ける共有帯域幅パッケージの ID。 |
cbwp-bp1vevu8h3ieh**** |
| AddressIpVersion |
string |
任意 |
プロトコルバージョン。有効な値:
|
IPv4 |
| Tag |
array<object> |
任意 |
インスタンスに追加するタグ。 |
|
|
object |
任意 |
タグ構造。 |
||
| Key |
string |
任意 |
タグキー。キーは最大 128 文字で、 |
env |
| Value |
string |
任意 |
タグ値。値は最大 128 文字で、 |
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 が見つかりません。 |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。