CreateRouteTargetGroup - Virtual Private Cloud - Alibaba Cloud ドキュメントセンター

ルートターゲットグループインスタンスを作成します。

操作説明

CreateRouteTargetGroup は非同期操作です。この操作を呼び出すと、システムはインスタンス ID を返しますが、ルートターゲットグループインスタンスはまだ作成されていません。作成タスクはバックグラウンドで続行されます。ListRouteTargetGroup を呼び出して、ルートターゲットグループの作成ステータスをクエリできます。
- ルートターゲットグループが Pending 状態の場合、ルートターゲットグループは作成中です。
- ルートターゲットグループが Available、Unavailable、Switched、または Abnormal 状態の場合、ルートターゲットグループは作成されています。
アクティブな/スタンバイモード: ルートターゲットグループを作成するときは、異なるゾーンにあり、同じタイプのプライマリインスタンスとセカンダリインスタンスを構成します。
プライマリインスタンス: 重みは 100 です。プライマリインスタンスは通常時にすべてのトラフィックを処理し、ヘルスチェックが成功した場合に効果を発揮します。
セカンダリインスタンス: 重みは 0 です。セカンダリインスタンスは、プライマリインスタンスに障害が発生したときにトラフィックを引き継ぎ、ディザスタリカバリおよびバックアップとして機能します。

今すぐお試しください

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

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

vpc:CreateRouteTargetGroup

create

*RouteTargetGroup。

acs:vpc:{#regionId}:{#accountId}:routetargetgroup/*

なし

リクエスト構文

POST  HTTP/1.1

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
VpcId	string	必須	ルートターゲットグループが属する VPC の ID。	vpc-xxxx
RouteTargetGroupName	string	任意	ルートターゲットグループの名前。名前は 1～128 文字で、http:// または https:// で始まることはできません。	myRouteTargetGroupName
RouteTargetGroupDescription	string	任意	ルートターゲットグループの説明。説明は 1～256 文字で、http:// または https:// で始まることはできません。	myRouteTargetGroupDescription
RouteTargetMemberList	array<object>	必須	ルートターゲットグループのメンバーのリスト。アクティブな/スタンバイモードでは、ルートターゲットグループのメンバーに以下の使用制限が適用されます。ルートターゲットグループのメンバー数は 2 である必要があります。ルートターゲットグループのメンバーは異なるゾーンにある必要があります。
	object	必須
MemberId	string	必須	ルートターゲットグループメンバーのインスタンス ID。	ep-xxxx
MemberType	string	必須	ルートターゲットグループメンバーのタイプ。サポートされているタイプ: GatewayLoadBalancerEndpoint アクティブな/スタンバイモードでは、ルートターゲットグループ内のすべてのメンバーが同じタイプである必要があります。	GatewayLoadBalancerEndpoint
Weight	integer	必須	ルートターゲットグループメンバーの重み。有効な値: 100: メンバーはプライマリインスタンスです。 0: メンバーはセカンダリインスタンスです。重みは作成時にのみ設定でき、変更できません。	100
ConfigMode	string	必須	ルートターゲットグループの構成モード。有効な値: Active-Standby: アクティブな/スタンバイモード。	Active-Standby
RegionId	string	必須	ルートターゲットグループのリージョン ID。DescribeRegions 操作を呼び出して、最新のリージョンリストをクエリできます。	cn-hangzhou
ResourceGroupId	string	任意	リソースグループ ID。リソースグループの詳細については、「リソースグループとは」を参照してください。	rg-acfmxazffggds****
ClientToken	string	任意	リクエストのべき等性を確保するために使用されるクライアントトークン。クライアントを使用してトークンを生成できますが、異なるリクエスト間でトークンが一意であることを確認する必要があります。トークンには ASCII 文字のみを含めることができます。このパラメーターを指定しない場合、システムは自動的に RequestId 値を ClientToken 値として使用します。RequestId 値は各 API 呼び出しで異なります。	0c593ea1-3bea-11e9-b96b-88e9fe6****
Tag	array<object>	任意	リソースのタグ。
	object	任意	リソースのタグ。
Key	string	任意	リソースのタグキー。タグキーは最大 20 個まで指定できます。タグキーを空文字列にすることはできません。タグキーは最大 128 文字で、`aliyun` または `acs:` で始まることはできません。`http://` または `https://` を含めることはできません。	FinanceDept
Value	string	任意	リソースのタグ値。タグ値は最大 20 個まで指定できます。タグ値は空文字列にすることができます。タグ値は最大 128 文字で、`aliyun` または `acs:` で始まることはできません。`http://` または `https://` を含めることはできません。	FinanceJoshua

レスポンスフィールド

フィールド	型	説明	例
	object	応答スキーマ。
RequestId	string	リクエスト ID。	8AA5CE21-2E6A-4530-BDF5-F055849476E6
RouteTargetGroupId	string	ルートターゲットグループのインスタンス ID。	rtg-xxxx

例

成功レスポンス

JSONJSON

{
  "RequestId": "8AA5CE21-2E6A-4530-BDF5-F055849476E6",
  "RouteTargetGroupId": "rtg-xxxx"
}

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ	説明
400	UnsupportedFeature.RouteTargetGroup	The feature of RouteTargetGroup is not supported.	ルートターゲットグループ機能は、現在のリージョンではサポートされていません。
400	Mismatch.GroupVpcIdAndInstanceVpcId	The RouteTargetGroup VPC %s and the RouteTargetConfig VPC %s are mismatched.	ルートターゲットグループの VPC が、設定されたインスタンスの VPC と一致しません。
400	OperationDenied.MemberWithSameAz	The operation is not allowed because of all members being in the same availability zone.	ルートターゲットグループ内のメンバーインスタンスを同じゾーンに属させることはできません。
400	InvalidVpcId.NotFound	Specified value of VpcId is not found in our record.
400	ResourceNotFound.GatewayLoadBalancerEndpoint	GatewayLoadBalancerEndpoint instance %s not found.
400	QuotaExceeded.RouteTargetGroup	The quota of %s is exceeded, usage %s/%s.	VPC で作成できるルートターゲットグループの最大値に達しました。クォータを増やして再試行してください。
400	OperationDenied.NatGatewayNotSingleAZ	NAT gateway must be in SingleAZ mode.	ルートターゲットグループはシングルゾーン NAT ゲートウェイのみをサポートします。
400	OperationDenied.NatGatewayIcmpReplyDisabled	NAT gateway ICMP reply is disabled.	ルートターゲットグループ内の NAT ゲートウェイは、ICMP プローブパケットに正常に応答できるよう、ICMP エコーリプライ機能を有効にする必要があります。
400	UnsupportedFeature.RouteTargetGroupForNat	This region currently does not support NAT gateways as route target group members.	現在のリージョンでは、NAT ゲートウェイをルートターゲットグループのメンバーとして使用できません。
400	ResourceNotFound.NatGatewayVSwitch	The VSwitch information associated with the selected NAT gateway was not found.	選択した NAT ゲートウェイに関連付けられた vSwitch 情報が見つかりませんでした。
400	ResourceNotFound.NatGateway	The selected NAT gateway was not found when creating or modifying the route target group.	ルートターゲットグループの作成または変更時に、選択した NAT ゲートウェイリソースが見つかりませんでした。
400	IncorrectStatus.NatGateway	%The status of %s [%s] is incorrect.	指定された NAT ゲートウェイが安定した状態ではありません。

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

変更履歴

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