すべてのプロダクト
Search
ドキュメントセンター

Cloud Enterprise Network:UpdateTransitRouterPeerAttachmentAttribute

最終更新日:Oct 29, 2025

エンタープライズ版トランジットルーターのリージョン間接続を変更します。

操作説明

UpdateTransitRouterPeerAttachmentAttribute は非同期操作です。リクエストを送信すると、システムは リクエスト ID を返し、バックグラウンドでタスクを実行します。ListTransitRouterPeerAttachments 操作を呼び出して、リージョン間接続のステータスをクエリできます。

  • ヒント: インストールプロセスを簡素化するために、Softaculous または Fantastico などの自動インストールスクリプトを使用できます。

  • リージョン間接続が [接続済み] 状態の場合、リージョン間接続が変更されます。

今すぐお試しください

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

update

*TransitRouterPeerAttachment

acs:cen:*:{#accountId}:centransitrouterattachment/{#centransitrouterattachmentId}

なし なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

ClientToken

string

任意

リクエストのべき等性を保証するために使用されるクライアントトークン。

クライアントを使用してトークンを生成できますが、トークンが異なるリクエスト間で一意であることを確認する必要があります。トークンには ASCII 文字のみを含めることができます。

説明

このパラメーターを設定しない場合、ClientTokenRequestId の値に設定されます。各 API リクエストの RequestId の値は異なる場合があります。

02fb3da4-130e-11e9-8e44-001****

TransitRouterAttachmentId

string

必須

リージョン間接続の ID。

tr-attach-ft94dcrbc3e5taun3x

TransitRouterAttachmentName

string

任意

リージョン間接続の新しい名前。

名前は空、または 1~128 文字の長さで、http:// または https:// で始めることはできません。

testname

TransitRouterAttachmentDescription

string

任意

リージョン間接続の新しい説明。

このパラメーターはオプションです。説明を入力する場合、長さは 1~256 文字で、http:// または https:// で始めることはできません。

testdesc

AutoPublishRouteEnabled

boolean

任意

ローカルの Enterprise Edition トランジットルーターが、リージョン間接続のルートをピアトランジットルーターに自動的にアドバタイズできるようにするかどうかを指定します。有効な値:

  • false (デフォルト): いいえ

  • true: はい

false

DryRun

boolean

任意

権限やインスタンスのステータスなどの情報を確認するためのドライランを実行するかどうかを指定します。デフォルト値:

  • false (デフォルト): ドライランを実行し、リクエストを送信します。

  • true: ドライランを実行します。システムは、必須パラメーターとリクエスト構文をチェックします。リクエストがドライランに失敗すると、エラーメッセージが返されます。リクエストがドライランに成功すると、システムはリクエストの ID を返します。

false

Bandwidth

integer

任意

リージョン間接続の帯域幅の値。単位: Mbit/s。

  • BandwidthTypeBandwidthPackage に設定した場合、このパラメーターはリージョン間接続の最大帯域幅値を指定します。

  • BandwidthTypeDataTransfer に設定した場合、このパラメーターはリージョン間接続の帯域幅の速度制限のしきい値を指定します。

2

CenBandwidthPackageId

string

任意

リージョン間接続に帯域幅を割り当てるために使用される帯域幅プランの ID。

説明

BandwidthTypeDataTransfer に設定した場合、このパラメーターを設定する必要はありません。

cenbwp-3xrxupouolw5ou****

BandwidthType

string

任意

帯域幅割り当てメソッド。有効な値:

  • BandwidthPackage: 帯域幅プランから帯域幅を割り当てます。

  • DataTransfer: 帯域幅は、トラフィック課金の課金方法に基づいて課金されます。

BandwidthPackage

DefaultLinkType

string

任意

デフォルトの回線タイプ。

有効な値: Platinum および Gold。

Platinum は、BandwidthType が DataTransfer に設定されている場合にのみサポートされます。

Gold

レスポンスフィールド

フィールド

説明

object

レスポンス。

RequestId

string

リクエストの ID。

A01FEDD7-7D69-4EB3-996D-CF79F6F885CA

成功レスポンス

JSONJSON

{
  "RequestId": "A01FEDD7-7D69-4EB3-996D-CF79F6F885CA"
}

エラーコード

HTTP ステータスコード

エラーコード

エラーメッセージ

説明

400 InvalidTransitRouterAttachmentId.NotFound TransitRouterAttachmentId is not found.
400 OperationUnsupported.BandwidthType The specified BandwidthType does not support the operation.
400 MissingParam.Bandwidth The parameter Bandwidth is mandatory.
400 IncorrectStatus.Attachment The resource is not in a valid state for the attachment operation.
400 IllegalParam.BandwidthType BandwidthType is illegal.
400 IllegalParam.Bandwidth Bandwidth is illegal.
400 ParameterIllegal.BandwidthPackageDefaultLinkTypeOnlySupportGold Cen bandwidthPackage only support Gold.
400 ParameterIllegal.CdtDefaultLinkTypeOnlySupportPlatinumOrGold DataTransfer only support Platinum and 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 OperationUnsupported.TransitRouterAttachment The specified TransitRouterAttachment has configured TransitRegion. Please remove the configuration first.
400 IllegalParam.BandwidthLessThanQosPolicyBandwidth The input bandwidth value is less than the sum of the Qos policy bandwidth.
400 IllegalParam.BandwidthPackageStatus The status of the bandwidth package is incorrect.
400 QuotaExceeded.Bandwidth Bandwidth quota exceeded.
400 ParamExclusive.BandwidthTypeAndCenBandwidthPackageId DataTransfer and CenBandwidthPackageId is mutually exclusive.
400 OperationUnsupported.CloudDataTransferService CCN region not support cloud data transfer service.
400 InvalidParameter Invalid parameter.
400 Unauthorized The AccessKeyId is unauthorized.
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.

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

変更履歴

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