すべてのプロダクト
Search

このプロダクト

    Express Connect:ExpressConnect ルーター関連付けの作成

    ドキュメントセンター

    Express Connect:ExpressConnect ルーター関連付けの作成

    最終更新日:Jun 05, 2026

    Express Connect Router (ECR) を仮想プライベートクラウド (VPC) またはトランジットルーター (TR) に関連付けます。

    今すぐお試しください

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

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    expressconnectrouter:CreateExpressConnectRouterAssociation

    作成

    *ExpressConnectRouter

    acs:expressconnectrouter::{#accountId}:expressconnectrouter/{#EcrId}

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    EcrId

    文字列

    はい必須

    Express Connect Router インスタンスの ID。

    ecr-mezk2idmsd0vx2****
    AssociationRegionId

    文字列

    はい必須

    関連付けるネットワークインスタンスのリージョン。

    cn-hangzhou
    TransitRouterOwnerId

    文字列

    いいえ任意

    Transit Router インスタンスを所有する Alibaba Cloud アカウント (メインアカウント) の ID。指定しない場合、現在の Alibaba Cloud アカウントの ID が使用されます。

    説明

    このパラメーターは、関連付けるネットワークインスタンスが別の Alibaba Cloud アカウントに属する場合に必要です。

    189159362009****
    TransitRouterId

    文字列

    いいえ任意

    Transit Router インスタンスの ID。

    tr-2ze4i71c6be454e2l****
    CenId

    文字列

    いいえ任意

    Cloud Enterprise Network (CEN) インスタンスの ID。

    cen-of3o1the3i4gwb****
    VpcOwnerId

    文字列

    いいえ任意

    VPC インスタンスを所有する Alibaba Cloud アカウント (メインアカウント) の ID。指定しない場合、現在の Alibaba Cloud アカウントの ID が使用されます。

    説明

    このパラメーターは、関連付けるネットワークインスタンスが別の Alibaba Cloud アカウントに属する場合に必要です。

    132193271328****
    VpcId

    文字列

    いいえ任意

    VPC インスタンスの ID。

    vpc-bp1h37fchc6jmfyln****
    AllowedPrefixes

    配列

    いいえ任意

    Express Connect Router からオンプレミスデータセンターへの広報を許可するプレフィックスルート。

    文字列

    いいえ任意

    許可する CIDR 形式のプレフィックスルート。

    192.0.20.0/24
    CreateAttachment

    ブール値

    いいえ任意

    アソシエーションの作成時に、Transit Router に対応するアタッチメントを自動的に作成するかどうかを指定します。有効な値：

    • true：Transit Router にアタッチメントが自動的に作成されます。

    • false：アタッチメントは作成されません。Transit Router 上で手動でアタッチメントを作成する必要があります。

    true
    DryRun

    ブール値

    いいえ任意

    ドライランを実行するかどうかを指定します。有効な値：

    • true：ドライランを実行して、パラメーターの不足や無効な値などの潜在的な問題をチェックします。リクエストがチェックに合格すると、DryRunOperation エラーコードが返されます。リソースは作成も変更もされません。

    • false (デフォルト)：通常のリクエストを送信します。リクエストがチェックに合格すると、システムはアソシエーションを作成します。

    false
    ClientToken

    文字列

    いいえ任意

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

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

    説明

    このパラメーターを指定しない場合、システムはリクエストの RequestId を ClientToken として使用します。各 API リクエストの RequestId は一意です。

    02fb3da4-130e-11e9-8e44-00****
    AllowedPrefixesMode

    文字列

    いいえ任意

    AllowedPrefixes パラメーターで指定するプレフィックスルートの広報モード。有効な値：

    • MatchMode：マッチモード。AllowedPrefixes で指定されたプレフィックスルートのみがオンプレミスデータセンターに広報されます。以前に広報されていた、より具体的なルートは取り消されます。

    • IncrementalMode：インクリメンタルモード。AllowedPrefixes で指定されたプレフィックスルートがオンプレミスデータセンターに広報されます。指定されたプレフィックスに含まれる既存の、より具体的なルートは取り消されます。指定されたプレフィックスの範囲外にある他の、より具体的なルートは広報され続けます。

    MatchMode
    Description

    文字列

    いいえ任意

    アソシエーションの説明。説明の長さは 0～128 文字である必要があります。

    test

    レスポンスフィールド

    フィールド

    型

    説明

    例

    オブジェクト

    RpcResponse

    RequestId

    文字列

    リクエスト ID。

    05130E79-588D-5C40-A718-C4863A59****
    Success

    ブール値

    リクエストが成功したかどうかを示します。有効な値：

    • True ：リクエストは成功しました。

    • False ：リクエストは失敗しました。

    True
    Code

    文字列

    レスポンスコード。値が 200 の場合は、リクエストが成功したことを示します。詳細については、「エラーコード」をご参照ください。

    200
    Message

    文字列

    レスポンスメッセージ。

    OK
    HttpStatusCode

    整数

    HTTP ステータスコード。

    200
    DynamicCode

    文字列

    動的エラーコード。

    IllegalParamFormat.EcrId

    DynamicMessage

    文字列

    ErrMessage パラメーターの %s プレースホルダーを置き換える動的エラーメッセージ。

    説明

    ErrMessage パラメーターが The Value of Input Parameter %s is not valid を返し、DynamicMessage パラメーターが DtsJobId を返す場合、指定された DtsJobId リクエストパラメーターは無効です。

    EcrId
    AccessDeniedDetail

    文字列

    アクセス拒否に関する詳細。

    Authentication is failed for ****

    AssociationId

    文字列

    Express Connect ルーターとトランジットルーターまたは VPC との間の関連付けの ID。

    ecr-assoc-9p2qxx5phpca2m****

    例

    成功レスポンス

    JSONJSON

    {
  "RequestId": "05130E79-588D-5C40-A718-C4863A59****",
  "Success": false,
  "Code": "IllegalParamFormat.EcrId",
  "Message": "The param format of EcrId **** is illegal.",
  "HttpStatusCode": 400,
  "DynamicCode": "IllegalParamFormat.EcrId",
  "DynamicMessage": "The param format of EcrId **** is illegal."
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    400 IncorrectStatus.Ecr Ecr Status does not allow current operation. Express Connect Router インスタンスの現在のステータスでは、この操作は許可されていません。インスタンスに対して他の操作が実行中、またはインスタンスが削除処理中の可能性があります。しばらくしてからもう一度お試しください。
    400 OperationDenied.ForceDeleting The current instance is being deleted. インスタンスが強制的に削除されているため、現在の操作は拒否されました。しばらくしてからもう一度お試しください。
    400 UnsupportedRegion Feature not supported in specified region. 指定されたリージョンでは、この機能はサポートされていません。
    400 QuotaExceeded.VpcCountPerEcr The number of VPC bound to the ECR exceeds the quota. ECR インスタンスに関連付けられる VPC の数がクォータ制限に達しました。クォータの引き上げについては、営業担当者にお問い合わせください。
    400 QuotaExceeded.TrCountPerEcr The number of TR bound to the ECR exceeds the quota. ECR インスタンスに関連付けられる TR の数がクォータ制限に達しました。クォータの引き上げについては、営業担当者にお問い合わせください。
    400 IllegalParamFormat.AllowedPrefixes The prefix parameter format is invalid. Procedure. 指定されたプレフィックスルートのフォーマットが正しくありません。
    400 OperationDenied.NotGrantedByNodeOwner The node owner is not authorized. この操作を実行するための権限がありません。
    400 OperationFailed.CdtNotOpened The Cdt function is disabled. Alibaba Cloud のデータ転送機能が有効になっていないため、操作に失敗しました。
    400 OperationFailed.CdtCrossBoarderNotOpened The Cdt cross-border transmission function is disabled. Alibaba Cloud のクロスボーダーデータ転送機能が有効になっていないため、操作に失敗しました。
    400 OperationFailed.CrossBorderNotAllowed There is no qualification for creating cross-border links. お客様のアカウントにはクロスボーダーリンクを作成する権限がないため、操作に失敗しました。権限の追加については、営業担当者にお問い合わせください。
    400 ResourceNotFound.CenId CenId not found. CEN インスタンスが存在しません。
    400 ResourceNotFound.TrId TRId not found. TR インスタンスが存在しません。
    400 Conflict.ASNOfVBR ASN already used by other VBR. VBR の BgpGroup に設定された localAsn が、ECR の ASN と一致していません。ASN を一致させてから、再度関連付けを行ってください。
    400 MissingParam.%s The param of %s is missing. 必須パラメーターがありません。パラメーターを確認して、もう一度お試しください。
    400 IllegalParamFormat.%s The param format of %s is illegal. パラメーターのフォーマットが不正です。
    400 IllegalParamFormat.CenId The format of the entered Cen instance ID is incorrect. 入力された CEN インスタンス ID のフォーマットが正しくありません。
    400 OperationDenied.CrossBidAssociating Cross-border binding of resources is subject to compliance constraints. この関連付け操作には、中国サイトのリソースと海外サイトのリソースが含まれています。コンプライアンス上の制約があるため、詳細については営業担当者にお問い合わせください。
    400 ExclusiveParam.TransitRouterIdAndVpcId A private network instance cannot be bound to a forwarding router instance at the same time. VPC インスタンスと転送ルーターインスタンスを同時に指定することはできません。どちらか一方のインスタンスのみを指定して、再度操作を行ってください。
    400 IllegalParamSize.AllowedPrefixes The number of prefix routes exceeded the quota. 入力したプレフィックスルートの数がクォータ上限を超えています。クォータの拡張が必要な場合は、営業担当者にお問い合わせください。
    400 OperationDenied.CrossAccountAttaching If the forwarding router is bound to another account, perform this operation on the same account. 転送ルーターが別のアカウントに属しているため、現在の操作は拒否されました。転送ルーターが属するアカウントで操作を実行してください。
    400 OperationDenied.AttachmentInCurrentRegionExisted Only one forwarding router can be bound to an area. ECR インスタンスは、同一リージョン内で 1 つの転送ルーターにしか関連付けできないため、現在の操作は拒否されました。
    400 Conflict.Lock There are other unfinished operations. 現在、未完了の他の操作があります。しばらくしてからもう一度お試しください。
    400 OperationFailed.CallingVpcYaochi The system is abnormal. Please try again later. システムエラーにより操作に失敗しました。しばらくしてからもう一度お試しください。問題が解決しない場合は、営業担当者にお問い合わせください。
    400 ResourceAlreadyExist.TransitRouterId The specified resource of transit router already exists. 指定された TR インスタンスは、すでにこの Express Connect Router に関連付けられています。
    400 ResourceAlreadyExist.VpcId The specified resource of VpcId already exists. 指定された VPC は、すでにこの Express Connect Router に関連付けられています。
    400 Conflict.AllowedPrefixes The allowed route prefixes [%s] is conflict. 指定された AllowedPrefixes が、既存のプレフィックスと競合しています。内容を確認して、再度実行してください。
    400 UnsupportedFeature.JumboFrame The region where the sub-instance is located does not support the jumbo frame feature and cannot be attached to the express connect router. サブインスタンスが配置されているリージョンではジャンボフレーム機能がサポートされていないため、Express Connect Router にアタッチできません。
    400 InternalErrorTemp The request processing has failed due to some unknown error. 不明なエラーにより、リクエストの処理に失敗しました。
    404 ResourceNotFound.EcrId EcrId not found. ECR インスタンスが存在しません。

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

    変更履歴

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