CreateLoadBalancer を使用して Application Load Balancer インスタンスを作成 - SLB - Alibaba Cloud - Server Load Balancer

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

操作説明

CreateLoadBalancer 操作は非同期です。システムはインスタンス ID を返しますが、Application Load Balancer (ALB) インスタンスはまだ作成されておらず、作成タスクはバックグラウンドで実行中です。 GetLoadBalancerAttribute 操作を呼び出して、Application Load Balancer (ALB) インスタンスの作成ステータスを照会できます。

Application Load Balancer (ALB) インスタンスが Provisioning 状態の場合、インスタンスは作成中です。
Application Load Balancer (ALB) インスタンスが 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

create

*LoadBalancer。

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

alb:AddressType

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
ClientToken	string	任意	リクエストのべき等性を確保するために使用されるクライアントトークン。クライアントでパラメーター値を生成し、異なるリクエスト間で値が一意になるようにできます。ClientToken パラメーターは ASCII 文字のみをサポートします。説明このパラメーターを指定しない場合、システムは API リクエストの RequestId を ClientToken として自動的に使用します。各 API リクエストの RequestId は異なります。	5A2CFF0E-5718-45B5-9D4D-70B3FF3898
DryRun	boolean	任意	リクエストに対してドライランのみを実行するかどうかを指定します。有効な値: true: Application Load Balancer (ALB) インスタンスを作成せずにドライランを実行します。システムは、必須パラメーターが指定されているか、リクエストフォーマット、およびサービスの制限をチェックします。ドライランに失敗した場合、エラーメッセージが返されます。ドライランに成功した場合、DryRunOperation エラーコードが返されます。 false (デフォルト): ドライランを実行し、通常のリクエストを送信します。ドライランに成功した場合、HTTP 2xx 状態コードが返され、操作が実行されます。	false
VpcId	string	必須	Application Load Balancer (ALB) インスタンスがデプロイされている仮想非公開クラウド (VPC) の ID。	vpc-bp1b49rqrybk45nio****
AddressType	string	必須	Application Load Balancer (ALB) インスタンスのネットワークタイプ。有効な値: Internet: Application Load Balancer (ALB) インスタンスはパブリック IP アドレスを使用します。DNS ドメイン名はパブリック IP アドレスに解決されます。したがって、インスタンスはインターネット環境からアクセスできます。 Intranet: Application Load Balancer (ALB) インスタンスは非公開 IP アドレスのみを使用します。DNS ドメイン名は非公開 IP アドレスに解決されます。したがって、インスタンスは、Application Load Balancer (ALB) インスタンスがデプロイされている VPC の内部ネットワーク環境からのみアクセスできます。	Internet
LoadBalancerName	string	任意	Application Load Balancer (ALB) インスタンスの名前。名前は 2～128 文字で、英字、数字、ピリオド (.)、アンダースコア (_)、ハイフン (-)、およびスペースを使用できます。先頭は英字または数字である必要があります。	alb1
DeletionProtectionEnabled	boolean	任意	削除保護を有効にするかどうかを指定します。有効な値: true: 削除保護を有効にします。 false (デフォルト): 削除保護を無効にします。	false
ModificationProtectionConfig	object	任意	変更保護構成。
Reason	string	任意	変更保護を有効にする理由。値は 2～128 文字で、英字、数字、ピリオド (.)、アンダースコア (_)、およびハイフン (-) を使用できます。先頭は英字または漢字である必要があります。説明このパラメーターは、Status が ConsoleProtection に設定されている場合にのみ有効です。	Managed Instance
Status	string	任意	Application Load Balancer (ALB) インスタンスの変更保護ステータス。有効な値: NonProtection: 変更保護を無効にします。Reason が指定されている場合、強制的にクリアされます。 ConsoleProtection: コンソールでの変更保護を有効にします。Reason が指定されている場合、それが効果を発揮します。説明このパラメーターが ConsoleProtection に設定されている場合、ユーザーはロードバランサーコンソールでインスタンス構成を変更できませんが、API 操作を呼び出してインスタンス構成を変更できます。	ConsoleProtection
ZoneMappings	array<object>	必須	ゾーンと vSwitch のマッピングのリスト。最大 10 個のゾーンを指定できます。現在のリージョンが 2 つ以上のゾーンをサポートしている場合、少なくとも 2 つのゾーンを指定する必要があります。
	object	任意	ゾーンと vSwitch のマッピングのリスト。最大 10 個のゾーンを追加できます。現在のリージョンが 2 つ以上のゾーンをサポートしている場合、少なくとも 2 つのゾーンを追加する必要があります。
VSwitchId	string	必須	ゾーン内の vSwitch の ID。各ゾーンでは、1 つの vSwitch と 1 つのサブネットのみを使用できます。最大 10 個のゾーンを追加できます。現在のリージョンが 2 つ以上のゾーンをサポートしている場合、少なくとも 2 つのゾーンを追加する必要があります。	vsw-sersdf****
ZoneId	string	必須	ゾーン ID。最大 10 個のゾーンを追加できます。現在のリージョンが 2 つ以上のゾーンをサポートしている場合、少なくとも 2 つのゾーンを追加する必要があります。 DescribeZones 操作を呼び出して、ゾーンの情報を照会できます。	cn-hangzhou-a
AllocationId	string	任意	インターネットに接続するインスタンスにアタッチされている EIP のインスタンス ID。	eip-bp1aedxso6u80u0qf****
EipType	string	任意	EIP のタイプ。有効な値: Common (デフォルト): EIP。 Anycast: エニーキャスト EIP。説明 ALB がエニーキャスト EIP をサポートするリージョンの詳細については、「使用制限」を参照してください。	Common
IntranetAddress	string	任意	IPv4 非公開 IP アドレス。	192.168.10.1
AddressAllocatedMode	string	任意	IP アドレス割り当てモード。有効な値: Fixed (デフォルト): 固定 IP モード。各ゾーンに固定 IP アドレスが割り当てられます。 Dynamic: 動的 IP モード。各ゾーンに IP アドレスが動的に割り当てられます。説明 2025 年 2 月 25 日 00:00:00 (協定世界時 (UTC)+8) 以降、この操作を呼び出してインスタンスを作成すると、指定したモードに関係なく、スペックアップされた ALB インスタンスが作成されます。IP アドレス割り当てモードは区別されなくなり、割り当てられた IP アドレスは自動的にスケーラブルになります。スペックアップ前に作成された既存の ALB インスタンスは影響を受けません。	Fixed
ResourceGroupId	string	任意	リソースグループの ID。	rg-atstuj3rtop****
LoadBalancerEdition	string	必須	Application Load Balancer (ALB) インスタンスのエディション。エディションによって、特徴の制限と課金ポリシーが異なります。有効な値: Basic: Basic Edition。 Standard: Standard Edition。 StandardWithWaf: WAF 強化エディション。	Standard
LoadBalancerBillingConfig	object	必須	Application Load Balancer (ALB) インスタンスの課金構成。
PayType	string	必須	インスタンスの課金方法。値を PostPay に設定します。これは従量課金方法を指定します。	PostPay
BandwidthPackageId	string	任意	インターネットに接続する ALB インスタンスに関連付けられているインターネット共有帯域幅インスタンスの ID。	cbwp-bp1vevu8h3ieh****
AddressIpVersion	string	任意	IP バージョン。有効な値: IPv4: IPv4。 DualStack: デュアルスタック。	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

レスポンスフィールド

フィールド	型	説明	例
	object	ロードバランサーインスタンス作成の応答。
LoadBalancerId	string	Application Load Balancer (ALB) インスタンスのインスタンス ID。	alb-o9ulmq5hqn68jk****
RequestId	string	リクエスト 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.	ユーザーアカウントが Alibaba Cloud サービスリンクロール AliyunServiceRoleForAlb に関連付けられていません。
404	ResourceNotFound.VSwitch	The specified resource %s is not found.	リソース %s が存在しません。

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

変更履歴

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