CreateTransitRouterPeerAttachment - Cloud Enterprise Network - Alibaba Cloud ドキュメントセンター

ネットワークインスタンス (VPC、VBR、IPsec 接続) がトランジットルーターに接続された後、異なるリージョン内のネットワークインスタンス間の通信を可能にするために、リージョン間接続を作成する必要があります。CreateTransitRouterPeerAttachment 操作を呼び出して、Enterprise Edition トランジットルーターインスタンスのリージョン間接続を作成できます。

操作説明

Enterprise Edition トランジットルーターでは、次の方法を使用して、帯域幅リソースをリージョン間接続に割り当てることができます。
- 帯域幅プランから:
  
  帯域幅プランを購入し、そのプランからリージョン間接続に帯域幅リソースを割り当てる必要があります。帯域幅プランの購入方法の詳細については、「CreateCenBandwidthPackage」をご参照ください。
- トラフィック課金:
  
  リージョン間接続の最大帯域幅値を設定できます。接続を介して転送されるデータ量に基づいて課金されます。課金の詳細については、「リージョン間トラフィック」をご参照ください。
CreateTransitRouterPeerAttachment 操作は非同期です。この操作を呼び出すと、システムはリージョン間接続 ID を返します。ただし、リージョン間接続はすぐには作成されません。作成タスクはバックグラウンドで実行されます。ListTransitRouterPeerAttachments 操作を呼び出して、リージョン間接続のステータスをクエリできます。
- リージョン間接続が Attaching ステータスの場合、接続は作成中です。このステータスでは、リージョン間接続のクエリのみが可能です。他の操作は実行できません。
- リージョン間接続が Attached ステータスの場合、接続の作成は完了です。

今すぐお試しください

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

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

cen:CreateTransitRouterPeerAttachment

create

CenInstance

acs:cen:*:{#accountId}:ceninstance/{#ceninstanceId}

TransitRouter

acs:cen:*:{#accountId}:centransitrouter/{#TransitRouterId}

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
ClientToken	string	任意	リクエストのべき等性を保証するために使用されるクライアントトークンです。クライアントを使用してトークンを生成できますが、トークンが異なるリクエスト間で一意であることを確認する必要があります。トークンには ASCII 文字のみを含めることができます。説明このパラメーターを指定しない場合、システムは自動的に RequestId を ClientToken として使用します。RequestId は API リクエストごとに異なります。	02fb3da4-130e-11e9-8e44-001****
CenId	string	任意	Cloud Enterprise Network (CEN) インスタンスの ID。	cen-j3jzhw1zpau2km****
TransitRouterId	string	任意	ローカルの Enterprise Edition トランジットルーターインスタンスの ID。	tr-bp1su1ytdxtataupl****
RegionId	string	任意	ローカルの Enterprise Edition トランジットルーターインスタンスがデプロイされているリージョンの ID。 DescribeRegions 操作を呼び出して、リージョン ID をクエリできます。	cn-hangzhou
TransitRouterAttachmentName	string	任意	リージョン間接続の名前。名前は空または 1～128 文字の長さで、http:// または https:// で始めることはできません。	testname
TransitRouterAttachmentDescription	string	任意	リージョン間接続の説明。説明はオプションです。説明を入力する場合、1～256 文字の長さで、http:// または https:// で始めることはできません。	testdesc
PeerTransitRouterId	string	必須	ピアトランジットルーターインスタンスの ID。	tr-m5eq27g6bndum7e88****
PeerTransitRouterRegionId	string	任意	ピアトランジットルーターインスタンスがデプロイされているリージョンの ID。	cn-qingdao
AutoPublishRouteEnabled	boolean	任意	ローカルの Enterprise Edition トランジットルーターがリージョン間接続のルートをピアトランジットルーターに自動的にアドバタイズできるようにするかどうかを指定します。有効な値: false (デフォルト): いいえ。 true: はい。	false
Bandwidth	integer	任意	リージョン間接続の帯域幅値。単位: Mbps。 BandwidthType が BandwidthPackage に設定されている場合、このパラメーターはリージョン間接続が使用できる帯域幅値を指定します。 BandwidthType が DataTransfer に設定されている場合、このパラメーターはリージョン間接続の最大帯域幅値を指定します。	2
CenBandwidthPackageId	string	任意	リージョン間接続に関連付ける帯域幅プランの ID。説明 BandwidthType が DataTransfer に設定されている場合、このパラメーターを設定する必要はありません。	cenbwp-3xrxupouolw5ou****
DryRun	boolean	任意	権限やインスタンスのステータスなどの情報を確認するためにドライランを実行するかどうかを指定します。有効な値: false (デフォルト): 通常のリクエストを送信します。リクエストがチェックに合格すると、システムはリージョン間接続を作成します。 true: チェックリクエストを送信します。システムは必須パラメーターとリクエスト構文をチェックします。リクエストがドライランに失敗した場合、エラーメッセージが返されます。リクエストがドライランに合格した場合、リクエスト ID が返されます。	false
BandwidthType	string	任意	リージョン間接続に帯域幅を割り当てるために使用されるメソッド。有効な値: BandwidthPackage: 帯域幅プランから帯域幅を割り当てます。 DataTransfer: リージョン間接続に帯域幅を割り当てず、トラフィック課金に基づいて課金します。	BandwidthPackage
Tag	array<object>	任意	タグ情報。各呼び出しで最大 20 個のタグを指定できます。
	object	任意	タグ。
Key	string	任意	アタッチするタグのキー。タグキーとして空の文字列を指定することはできません。タグキーは最大 64 文字の長さで、`aliyun` または `acs:` で始めることはできません。`http://` または `https://` を含めることはできません。各呼び出しで最大 20 個のタグキーを指定できます。	tag_A1
Value	string	任意	指定されたリソースにアタッチするタグの値。タグ値は空の文字列または最大 128 文字の長さの文字列にすることができます。`aliyun` または `acs:` で始めることはできません。`http://` または `https://` を含めることはできません。各キーと値のペアは一意である必要があります。各呼び出しで最大 20 個のタグ値を指定できます。	value_A1
DefaultLinkType	string	任意	デフォルトの回線タイプ。有効な値: Platinum および Gold。デフォルト値: Gold。帯域幅割り当て方法がトラフィック課金の場合にのみ、このパラメーターを Platinum に設定できます。	Gold

レスポンスフィールド

フィールド	型	説明	例
	object	レスポンスパラメーター。
TransitRouterAttachmentId	string	リージョン間接続の ID。	tr-attach-nwkiqfvw22qesz****
RequestId	string	リクエスト ID。	59422BF5-BAAD-4CFD-9019-9557BD3ACFA3

例

成功レスポンス

JSONJSON

{
  "TransitRouterAttachmentId": "tr-attach-nwkiqfvw22qesz****",
  "RequestId": "59422BF5-BAAD-4CFD-9019-9557BD3ACFA3"
}

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ
400	OperationUnsupported.TransitRouterRegionId	The specified TransitRouterRegion does not support the operation.
400	NoPermission.AliyunServiceRolePolicyForCEN	You are not authorized to create the service linked role. Role Name: AliyunServiceRolePolicyForCEN. Service Name: cen.aliyuncs.com. Make sure that the user has been granted the ram:CreateServiceLinkedRole permission.
400	InvalidTransitRouterId.NotFound	TransitRouterId is not found.
400	IllegalParam.PeerTransitRouterId	PeerTransitRouterId is illegal.
400	OperationUnsupported.TransitRouterId	TransitRouterId is unsupported.
400	MissingParam.Bandwidth	The parameter Bandwidth is mandatory.
400	IllegalParam.Bandwidth	Bandwidth is illegal.
400	Forbbiden.TransitRouterServiceNotOpen	The user has not open transit router service.
400	OperationUnsupported.TransitRouterType	The specified TransitRouterType does not support the operation.
400	OperationUnsupported.BandwidthType	The specified BandwidthType does not support the operation.
400	InvalidCenId.NotFound	CenId is not found.
400	IllegalParam.BandwidthType	BandwidthType is illegal.
400	MissingParam.CenIdOrRegionId	Either CenId or RegionId must be specified.
400	OperationUnsupported.BandwidthHS	This bandwidth limit can only be set in China-AsiaPacific-HS
400	OperationUnsupported.CenFullLevel	CEN full level does not support TransitRouter
400	OperationUnsupported.CloudDataTransferService	CCN region not support cloud data transfer service.
400	InvalidPeerTransitRouterId.NotFound	The specified PeerTransitRouterId is not found.
400	IllegalParam.RegionId	RegionId is illegal.
400	IllegalParam.PeerRegionId	PeerRegionId is illegal.
400	IllegalParam.TransitRouterRegionId	TransitRouterRegionId is illegal.
400	InvalidOperation.CenInstanceStatus	The CEN instance is not in a valid state for the operation.
400	IncorrectStatus.TransitRouter	The status of TransitRouter is incorrect.
400	InvalidOperation.BwpNotAssociated	Operation is invalid because a bandwidth package corresponding to the geographic span is not associated.
400	InvalidOperation.BwpBusinessStatus	The CBN bandwidth package is not in a valid business state for the operation.
400	IllegalParam.CenBandwidthPackageId	Parameter CenBandwidthPackageId is illegal.
400	InvalidOperation.BwpBandwidthExceeded	Operation is invalid because the total bandwidth limit has exceeded that of the bandwidth package.
400	ParameterIllegal.CdtDefaultLinkTypeOnlySupportPlatinumOrGold	DataTransfer only support Platinum and Gold.
400	ParameterIllegal.BandwidthPackageDefaultLinkTypeOnlySupportGold	Cen bandwidthPackage only support Gold.
400	ParameterIllegal.CdtDefaultLinkTypeOnlySupportGold	CDT only support Gold when both transitrouters for cross regional connections are not all enterprise version.
400	OperationNotAllowed.DefaultLinkTypeOnlySupportGold	Operation is not allowed because this user can only set default link type to Gold.
400	OperationInvalid.UserCanNotBuyCrossBorderBwp	According to the laws and regulations of the operator and mainland China, you are currently not eligible to purchase or renew a cross-border bandwidth package. Please contact online customer service or your business manager for consultation.
400	OperationInvalid.IdentityRegistrationStatusNotSupport	Real name registration of enterprises required.
400	InvalidOperation.OnlyOneRegionSupportIpv6	Peer Attachment is only allowed when both regions support IPv6 or do not support IPv6 at all.
400	InvalidOperation	Operation is invalid.
400	Forbidden.ResourceOwnerTransitRouterServiceExpired	The transit router service of the account to which the resource belongs has been suspended due to arrears. Please notify the other party to renew the service and try again.
400	Forbidden.TransitRouterServiceExpired	The transit router service is out of service.
400	OperationUnsupported.RegionId	The specified RegionId does not support the operation.
400	QuotaExceeded.Bandwidth	Bandwidth quota exceeded.
400	InvalidParameter	Invalid parameter.
400	Unauthorized	The AccessKeyId is unauthorized.
400	InvalidParameter.PeerTransitRouterId	The specified parameter PeerTransitRouterId is invalid.
400	InvalidParameter.ResourceType	The specified parameter ResourceType is invalid.
400	ParameterIllegal.CdtDefaultLinkTypeOnlySupportUnderlaySilver	CDT only support UnderlaySilver when both transitrouters for cross regional connections are not all enterprise version.
400	ParameterIllegal.DefaultLinkTypeOnlySupportUnderlaySilver	Cen bandwidthPackage only support UnderlaySilver.
400	OperationNotAllowed.DefaultLinkTypeOnlySupportUnderlaySilver	This user can only set the default link type to UnderlaySilver.
400	OperationFailed.ValidateVbrInstanceFailedForLowLatencyCircuit	Operation failed when validate VBR instance for Low Latency Circuit.

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

変更履歴

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