PublishVpnRouteEntry - VPN Gateway - Alibaba Cloud ドキュメントセンター

PublishVpnRouteEntry 操作を呼び出して、送信先ルートまたはポリシールートを VPC のシステムルートテーブルに公開するか、公開済みの送信先ルートまたはポリシールートを VPC のシステムルートテーブルから取り消します。

今すぐお試しください

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

update

*VpnGateway

acs:vpc:{#regionId}:{#accountId}:vpngateway/{#VpnGatewayId}

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
RegionId	string	必須	VPN ゲートウェイインスタンスのリージョン ID。 DescribeRegions 操作を呼び出して、リージョン ID をクエリできます。	cn-hangzhou
ClientToken	string	任意	リクエストのべき等性を確保するために使用されるクライアントトークン。このパラメーターの値はクライアントによって生成されます。異なるリクエスト間で値が一意であることを確認してください。最大値は 64 ASCII 文字です。説明このパラメーターを指定しない場合、システムは API リクエストの RequestId を ClientToken として使用します。各 API リクエストの RequestId は異なります。	d7d24a21-f4ba-4454-9173-b382****
VpnGatewayId	string	必須	VPN ゲートウェイインスタンスの ID。	vpn-bp1a3kqjiiq9legfx****
RouteDest	string	必須	VPN ゲートウェイルートエントリの送信先 CIDR ブロック。	10.0.0.0/24
NextHop	string	必須	VPN ゲートウェイルートエントリのネクストホップ。	vco-bp15oes1py4i66rmd****
RouteType	string	必須	VPN ゲートウェイルートエントリのタイプ。有効な値: pbr: ポリシーベースルート。 dbr: 送信先ベースルート。	pbr
PublishVpc	boolean	必須	ルートを公開するか取り消すかを指定します。有効な値: true: ルートを公開します。このパラメーターが true に設定されている場合、送信先ルートまたはポリシールートが VPC のシステムルートテーブルに公開されます。 false: ルートを取り消します。このパラメーターが false に設定されている場合、公開済みの送信先ルートまたはポリシールートが VPC のシステムルートテーブルから取り消されます。説明ポリシールートテーブルと送信先ルートテーブルに同じ送信先 CIDR ブロックを持つルートエントリが含まれており、両方のルートエントリが同じ VPC に公開されている場合、ポリシールートテーブルからルートエントリを取り消すと、送信先ルートテーブルのルートエントリも取り消されます。送信先ルートテーブルからルートエントリを取り消すと、ポリシールートテーブルのルートエントリも取り消されます。	true

レスポンスフィールド

フィールド	型	説明	例
	object	応答パラメーター。
RequestId	string	リクエスト ID。	5BE01CD7-5A50-472D-AC14-CA181C5C03BE

例

成功レスポンス

JSONJSON

{
  "RequestId": "5BE01CD7-5A50-472D-AC14-CA181C5C03BE\t"
}

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ	説明
400	Resource.QuotaFull	The quota of resource is full
400	VpnGateway.Configuring	The specified service is configuring.
400	VpnGateway.FinancialLocked	The specified service is financial locked.
400	VpnRouteEntry.AlreadyExists	The specified route entry is already exist.
400	VpnRouteEntry.Conflict	The specified route entry has conflict.
400	InvalidVpnRouteEntry.NotFound	The specified route entry does not exist.
400	OperationFailed.InvalidStatus	Route entry is not allowed to operate in current status.
400	OperationFailed.RouteConflict	Operation failed because there is already a route in VPC route table to another VPN on the same network block.
400	OperationFailed.InvalidCidrBlock	Operation failed because the specified network block is invalid.
400	QuotaExceeded.VpnRouteEntry	The number of route entries to the VPN gateway in the VPC routing table has reached the quota limit.
400	TaskConflict	The operation is too frequent, please wait a moment and try again.
400	IllegalParam.CidrBlock	The specified CidrBlock is illegal.
400	QuotaExceeded	Route entry quota exceeded in this route table.
400	MissingParameter	Miss mandatory parameter.
400	InvalidCidrBlock.Malformed	Specified CIDR block is not valid.
400	InvalidCIDRBlock.Duplicate	Specified CIDR block is already exists.
400	IncorrectVpcStatus	Current VPC status does not support this operation.
400	IncorrectInstanceStatus	Current instance status does not support this operation.
400	IncorrectRouteEntryStatus	Some route entry status blocked this operation.
400	IncorrectVSwitchStatus	The current virtual switch status does not support this operation.	指定された VSwitch はステータスが Pending になっているため、削除できませんでした。
400	InvalidCidrBlock	Specified CIDR block is not valid.	考えられるエラー原因:1.10.0.0.0/8のルーティングネットワークセグメントのホワイトリストにないので、このネットワークセグメントを使用できません。2.追加したカスタムルーティング先ネットワークセグメントは、同じVPCの下のすべてのスイッチに属するネットワークセグメントからはできません。3.100.64.0.0/10はクラウドサービスアドレスなので、このネットワークセグメントをクラウドIDCに追加することはできません。4.100.64.0.0/10を除いて、100.64.0.0/11、100.960.0/11などの明細ルーティングネットワークセグメントはクラウドIDCでは使用できない。
400	InvalidNextHopType	Specified parameter "NextHopType" is not valid
400	InvalidNextHop.NotFound	Specified next hop does not exist.
400	InvalidVRouter.NotFound	vRouter not exists.
400	InvalidVPC.NotFound	vpc not exists.
400	InvalidNexthopTypeAndList.BothNull	both nexthopType and nextHopList are null.
400	InvalidNexthopTypeAndList.BothNotNull	both nexthopType and nextHopList are not null.
400	InvalidRouterInterface	invalid router interface.
400	InvalidOppositeRouterType	nexthop list cannot only contain router interface whose opposite router interface is on vbr.
400	InvalidNexthopListSize	nexthop size is illegal. Must be between 2 and 4.
400	InvalidEntryRuleQuota.NotFound	Route entry quota rule not exists.
400	Forbidden.CheckEntryRuleQuota	Route entry quota rule check error.
400	InvalidVBRStatus	invalid virtual border router status.
400	InvalidPhysicalConnectionBusinessStatus	invalid physical connection business status.
400	IncorrectHaVipStatus	This operation is denied because satus of the specified HaVip is neither Available nor InUse.
400	CountLimitExceed.HaVipRouteEntry	There can be 5 route entry to HaVip at most in one route table.
400	InvalidRouteEntry.Duplicate	The route entry already exist.
400	INVALID_WEIGHT_PARAM	Specified value of weight invalid
400	FORBIDDEN_USE_VPC_AS_INTERNET_GATEWAY	The Specified CIDR must be in vpc CIDR.
400	INVALID_VPC_ID	The Specified VpcId not match.
400	InvalidRouteEntrySize	The Specified routerEntry size not legal.
400	RouteConflict.AlreadyExist	Route conflict exists in routing table.
400	InvalidRouteEntryName.Malformed	Specified RouteEntry name is not valid.
400	Duplicated.VpcNextHop	Route entry nexthop duplicate.
400	InvalidNexthop.DirectEni	The direct Eni cannot be nexthop.
400	InvalidAttachment.NotFound	The attachment is not found.
400	OperationFailed.ActiveNetworkInterfaceNotFound	No active network interface is found on the attachment.
400	InvalidNetworkInterface.NotFound	The network interface is not found on the attachment.
400	OperationFailed.QueryAttachmentInfo	Failed to query attachment information.
400	IllegalParam.AttachmentId	The attachment is invalid.
400	OperationFailed.NotSupportIPV6	The specified next hop does not support IPv6.
400	IncorrectStatus.Ipv6Address	The IPv6 address of the specified next hop is being assigned or deleted.
400	OperationUnsupported.Ipv6EntryOnPrimaryNetworkInterface	You cannot create IPv6 route entries on a primary network interface.
400	OperationUnsupported.SpecifyIpOnIpv6Entry	You cannot specify the private IP address when you create IPv6 route entries.
400	OperationUnsupported.MutipleIpv6Address	You cannot specify a next hop that has bound multiple IPv6 addresses.
400	OperationDenied.Ipv6EntryOnCustomTable	You cannot create any IPv6 route entry on a custom route table.
403	Forbbiden.SubUser	User not authorized to operate on the specified resource as your account is created by another user.
403	Forbidden	User not authorized to operate on the specified resource.
404	InvalidVpnGatewayInstanceId.NotFound	The specified vpn gateway instance id does not exist.

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

変更履歴

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