CreateTransitRouterPeerAttachment API を呼び出してリージョン間接続を作成 - CEN - Alibaba Cloud - Cloud Enterprise Network

Enterprise Edition のトランジットルーターインスタンスのリージョン間接続を作成します。

操作説明

Enterprise Edition のトランジットルーターでは、以下の 2 つの帯域幅割り当てメソッドがサポートされています。
- 帯域幅パッケージからの割り当て:
  
  このメソッドを使用するには、まず帯域幅パッケージを購入し、その帯域幅パッケージからリージョン間接続に帯域幅を割り当てます。帯域幅パッケージの購入方法の詳細については、「 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 文字のみを含めることができます。説明このパラメーターを指定しない場合、システムは自動的に API リクエストの 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 を呼び出して、最新のリージョンリストをクエリできます。	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	任意	リージョン間接続の帯域幅値。単位: Mbit/s。 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	任意	デフォルトのリンクタイプ。有効な値: プラチナ、ゴールド。デフォルト値: ゴールド。プラチナリンクタイプは、帯域幅割り当てメソッドがデータ転送量課金の場合にのみ設定できます。	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.	cen.aliyuncs.com サービスのサービスリンクロール AliyunServiceRolePolicyForCEN を作成する権限がありません。現在のユーザーに ram:CreateServiceLinkedRole 権限が付与されていることを確認してください。
400	InvalidTransitRouterId.NotFound	TransitRouterId is not found.	リクエストに指定された TransitRouterId が存在しません。
400	IllegalParam.PeerTransitRouterId	PeerTransitRouterId is illegal.	リージョン間接続のピア側のトランジットルーター ID が無効です。
400	OperationUnsupported.TransitRouterId	TransitRouterId is unsupported.	トランジットルーターが Basic Edition エディションの場合、この操作はサポートされていません。
400	MissingParam.Bandwidth	The parameter Bandwidth is mandatory.	帯域幅値のパラメーターは必須です。
400	IllegalParam.Bandwidth	Bandwidth is illegal.	帯域幅プラン ID が無効です。
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.	現在の BandwidthType はこの操作をサポートしていません。
400	InvalidCenId.NotFound	CenId is not found.	リクエストで指定された CenId が存在しません。
400	IllegalParam.BandwidthType	BandwidthType is illegal.	帯域幅プランタイプが無効です。
400	MissingParam.CenIdOrRegionId	Either CenId or RegionId must be specified.	CenId または RegionId パラメーターは必須です。
400	OperationUnsupported.BandwidthHS	This bandwidth limit can only be set in China-AsiaPacific-HS
400	OperationUnsupported.CenFullLevel	CEN full level does not support TransitRouter	Full モードの CEN は、VPN BGP をサポートしていません。
400	OperationUnsupported.CloudDataTransferService	CCN region not support cloud data transfer service.	CCN リージョンでは Cloud Data Transfer サービスはサポートされていません。
400	InvalidPeerTransitRouterId.NotFound	The specified PeerTransitRouterId is not found.	リクエストに指定された PeerTransitRouterId が存在しません。
400	IllegalParam.RegionId	RegionId is illegal.	リクエストで指定されたリージョンが無効です。
400	IllegalParam.PeerRegionId	PeerRegionId is illegal.	リクエストで指定された PeerRegionId が無効です。
400	IllegalParam.TransitRouterRegionId	TransitRouterRegionId is illegal.	TransitRouterRegionId が無効です。
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.	リクエストで指定された CenBandwidthPackageId が無効です。
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.	クロスリージョン接続の両端のトランジットルーターがすべて Enterprise Edition エディションではなく、かつ帯域幅割り当てメソッドがデータ転送量課金の場合、デフォルトのリンクタイプはゴールドのみをサポートします。
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.	クロスリージョン接続は、両方のリージョンが IPv6 をサポートしているか、または両方のリージョンが IPv6 をサポートしていない場合にのみ作成できます。
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.	リージョン間接続の両端のトランジットルーターがすべて Enterprise Edition ではなく、かつ帯域幅割り当てメソッドがトラフィック転送課金の場合、デフォルトのリンクタイプは Silver (UnderlaySilver) のみをサポートします。
400	ParameterIllegal.DefaultLinkTypeOnlySupportUnderlaySilver	Cen bandwidthPackage only support UnderlaySilver.	帯域幅割り当てメソッドが帯域幅プランの場合、デフォルトのリンクタイプは Silver (UnderlaySilver) のみをサポートします。
400	OperationNotAllowed.DefaultLinkTypeOnlySupportUnderlaySilver	This user can only set the default link type to UnderlaySilver.	このユーザーは、デフォルトのリンクタイプを Silver (UnderlaySilver) にのみ設定できます。
400	OperationFailed.ValidateVbrInstanceFailedForLowLatencyCircuit	Operation failed when validate VBR instance for Low Latency Circuit.	低遅延リンクの作成時に、読み込まれた VBR インスタンスの検証に失敗しました。
400	InvalidParameter.TagValue	The specified parameter TagValue is invalid.	タグ値パラメーターが無効です。

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

変更履歴

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