指定されたリージョンに Application Load Balancer (ALB) インスタンスを作成します。
操作説明
CreateLoadBalancer は非同期操作です。リクエストの送信後、システムはリクエスト ID を返し、バックグラウンドでタスクを実行します。GetLoadBalancerAttribute 操作を呼び出して、ALB インスタンスのステータスをクエリできます。
ALB インスタンスが Provisioning ステータスの場合、ALB インスタンスが作成中であることを示します。
ALB インスタンスが Active ステータスの場合、ALB インスタンスが作成されたことを示します。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
alb:CreateLoadBalancer |
create |
*LoadBalancer
|
|
なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| ClientToken |
string |
任意 |
リクエストのべき等性を保証するために使用されるクライアントトークンです。 クライアントを使用して値を生成できますが、異なるリクエスト間で一意である必要があります。トークンには ASCII 文字のみを含めることができます。 説明
このパラメーターを指定しない場合、システムは RequestId の値を ClientToken の値として使用します。RequestId パラメーターの値は、API リクエストごとに異なる場合があります。 |
5A2CFF0E-5718-45B5-9D4D-70B3FF3898 |
| DryRun |
boolean |
任意 |
ドライランを実行するかどうかを指定します。デフォルト値:false。有効な値:
|
false |
| VpcId |
string |
必須 |
ALB インスタンスを作成する VPC (Virtual Private Cloud) の ID。 |
vpc-bp1b49rqrybk45nio**** |
| AddressType |
string |
必須 |
ALB インスタンスのアドレスタイプ。有効な値:
|
Internet |
| LoadBalancerName |
string |
任意 |
ALB インスタンスの名前。 名前は 2~128 文字で、文字、数字、ピリオド (.)、アンダースコア (_)、ハイフン (-) を使用できます。名前は文字で始まる必要があります。 |
alb1 |
| DeletionProtectionEnabled |
boolean |
任意 |
削除保護を有効にするかどうかを指定します。デフォルト値:false。有効な値:
|
false |
| ModificationProtectionConfig |
object |
任意 |
設定変更保護の設定。 |
|
| Reason |
string |
任意 |
設定変更保護を有効にする理由。 理由は 2~128 文字で、文字、数字、ピリオド (.)、アンダースコア (_)、ハイフン (-) を使用でき、文字で始まる必要があります。 説明
このパラメーターは、Status が ConsoleProtection に設定されている場合にのみ有効です。 |
test |
| Status |
string |
任意 |
設定変更保護を有効にするかどうかを指定します。有効な値:
説明
パラメーターが 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 のタイプ。有効な値:
説明
ALB が Anycast EIP をサポートするリージョンの詳細については、「制限事項」をご参照ください。 |
Common |
| IntranetAddress |
string |
任意 |
プライベート IPv4 アドレス。 |
192.168.10.1 |
| AddressAllocatedMode |
string |
任意 |
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 インスタンスのエディションによって、特徴と課金ルールが異なります。有効な値:
|
Standard |
| LoadBalancerBillingConfig |
object |
必須 |
ALB インスタンスの課金方法。 |
|
| PayType |
string |
必須 |
インスタンスの課金方法。 値を PostPay に設定します。これは従量課金方法を指定します。 |
PostPay |
| BandwidthPackageId |
string |
任意 |
インターネット向けの ALB インスタンスに関連付けられている共有帯域幅インスタンスの ID。 |
cbwp-bp1vevu8h3ieh**** |
| AddressIpVersion |
string |
任意 |
プロトコルバージョン。有効な値:
|
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. |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。