すべてのプロダクト
Search

このプロダクト

    Cloud Enterprise Network:CreateTransitRouterEcrAttachment

    ドキュメントセンター

    Cloud Enterprise Network:CreateTransitRouterEcrAttachment

    最終更新日:Aug 07, 2025

    CreateTransitRouterEcrAttachment 操作を呼び出して、同じリージョンにあるトランジットルーターに Express Connect Router (ECR) インスタンスを接続します。

    操作説明

    • Enterprise Edition トランジットルーターのみが ECR 接続をサポートしています。

    • 次の 2 つの方法のいずれかで、Enterprise Edition トランジットルーターに ECR 接続を作成できます。

      • ターゲットリージョンに Enterprise Edition トランジットルーターインスタンスがある場合は、[EcrId]、[RegionId]、および [TransitRouterId] を指定して ECR 接続を作成できます。

      • ターゲットリージョンに Enterprise Edition トランジットルーターインスタンスがない場合は、[EcrId]、[CenId]、および [RegionId] を指定して ECR 接続を作成できます。 ECR 接続を作成すると、システムは Enterprise Edition トランジットルーターインスタンスを自動的に作成します。

    • CreateTransitRouterEcrAttachment は非同期操作です。 リクエストを送信すると、システムは ECR 接続 ID を返しますが、接続はバックグラウンドで作成されます。 ListTransitRouterEcrAttachments 操作を呼び出して、ECR 接続のステータスをクエリできます。

      • ECR 接続が [接続中] ステータスの場合、接続は作成中です。 このステータスでは、接続のクエリのみが可能で、他の操作は実行できません。

      • ECR 接続が [接続済み] ステータスの場合、接続は作成されています。

    • デフォルトでは、ECR 接続が作成された後、ルート学習または転送のために Enterprise Edition トランジットルーターのルートテーブルには関連付けられません。

      ECR 接続が ルート学習 用の Enterprise Edition トランジットルーターのルートテーブルに関連付けられると、システムは ECR インスタンスからのルートを Enterprise Edition トランジットルーターのルートテーブルに自動的に伝播します。

    • ECR 接続が作成されると、システムは ECR 接続に関連付けられた Enterprise Edition トランジットルーターのルートテーブルから ECR インスタンスのルートテーブルにルートを自動的に伝播します。

    前提条件

    • Enterprise Edition トランジットルーターと ECR インスタンスを所有する Alibaba Cloud アカウントは、同じ企業に属している必要があります。

    • Enterprise Edition トランジットルーターは、同じアカウントまたは異なるアカウントに属する ECR インスタンスに接続できます。 アカウントをまたがる ECR 接続を作成する前に、ECR インスタンスを所有するアカウントから承認を取得する必要があります。 詳細については、「アカウントをまたがるネットワークインスタンスを承認する」をご参照ください。

    • [この操作を呼び出して ECR 接続を作成する前に、CreateExpressConnectRouterAssociation 操作を呼び出して、ECR インスタンスと Enterprise Edition トランジットルーターインスタンス間の関連付けを作成する必要があります。]

      [DeleteTransitRouterEcrAttachment 操作を呼び出して ECR 接続を強制削除すると、システムは ECR インスタンスと Enterprise Edition トランジットルーターインスタンス間の関連付けも削除します。 関連付けを個別に削除する必要はありません。]

    今すぐお試しください

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

    create

    *CenInstance

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

    TransitRouter

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

    		 なし なし

    リクエストパラメーター

    パラメーター

    タイプ

    必須 / 任意

    説明

    例
    ClientToken

    string

    任意

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

    クライアントトークンがリクエストごとに一意であることを確認してください。 トークンには ASCII 文字のみを含めることができます。

    説明

    このパラメーターを指定しない場合、システムはリクエスト ID をクライアントトークンとして自動的に使用します。 リクエスト ID はリクエストごとに異なります。

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

    string

    任意

    クラウドエンタープライズネットワーク (CEN) インスタンスの ID。

    cen-7qthudw0ll6jmc****
    TransitRouterId

    string

    任意

    トランジットルーターの ID。

    tr-bp1su1ytdxtataupl****
    RegionId

    string

    任意

    トランジットルーターがデプロイされているリージョンの ID。

    DescribeChildInstanceRegions 操作を呼び出して、最新のリージョンリストをクエリできます。 詳細については、「DescribeChildInstanceRegions」をご参照ください。

    eu-central-1
    TransitRouterAttachmentName

    string

    任意

    ECR 接続の名前。

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

    nametest
    TransitRouterAttachmentDescription

    string

    任意

    ECR 接続の説明。

    説明は空にするか、1 ～ 256 文字の長さにできます。 また、http:// または https:// で始めることはできません。

    testdesc
    EcrId

    string

    必須

    ECR インスタンスの ID。

    ecr-upyc0viial107r****
    EcrOwnerId

    integer

    任意

    ECR インスタンスが属する Alibaba Cloud アカウントの ID。 デフォルト値は現在の Alibaba Cloud アカウントの ID です。

    説明

    別の Alibaba Cloud アカウントに属するネットワークインスタンスに接続する場合、このパラメーターは必須です。

    1250123456123456
    DryRun

    boolean

    任意

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

    • [true]：ドライランを実行します。 システムは必須パラメーター、リクエスト形式、およびサービス制限を確認します。 リクエストがドライランに失敗した場合、エラーメッセージが返されます。 リクエストがドライランに合格した場合、DryRunOperation エラーコードが返されます。 システムは ECR 接続の構成を変更しません。

    • [false] (デフォルト): 通常のリクエストを送信します。 リクエストがチェックに合格すると、システムは ECR 接続の構成を変更します。

    false
    Tag

    array<object>

    任意

    タグ。

    呼び出しごとに最大 20 個のタグを指定できます。

    object

    任意

    Key

    string

    任意

    タグキー。

    タグキーは空の文字列にすることはできません。 タグキーは最大 64 文字の長さにでき、aliyun または acs: で始めることはできません。 http:// または https:// を含めることはできません。

    最大 20 個のタグキーを指定できます。

    tagtest
    Value

    string

    任意

    タグ値。

    タグ値は空にするか、最大 128 文字の長さにできます。 aliyun または acs: で始めることはできず、http:// または https:// を含めることはできません。

    各タグキーには一意のタグ値が必要です。 最大 20 個のタグ値を指定できます。

    tagtest

    レスポンスパラメーター

    パラメーター

    タイプ

    説明

    例

    object

    TransitRouterAttachmentId

    string

    ECR 接続の ID。

    tr-attach-qieks13jnt1cchy***
    RequestId

    string

    リクエスト ID。

    C0245BEF-52AC-44A8-A776-EF96FD26A5CA

    例

    成功レスポンス

    JSONJSON

    {
  "TransitRouterAttachmentId": "tr-attach-qieks13jnt1cchy***",
  "RequestId": "C0245BEF-52AC-44A8-A776-EF96FD26A5CA"
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    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 OperationUnsupported.TransitRouterRegionId The specified TransitRouterRegion does not support the operation.
    400 InvalidCenId.NotFound CenId is not found.
    400 InvalidStatus.ResourceStatus The resource is not in a valid state for the attachment operation.
    400 InvalidTransitRouterId.NotFound TransitRouterId is not found.
    400 Forbbiden.TransitRouterServiceNotOpen The user has not open transit router service.
    400 OperationUnsupported.TransitRouterType The specified TransitRouterType does not support the operation.
    400 MissingParam.CenIdOrRegionId Either CenId or RegionId must be specified.
    400 IllegalParam.AssociateRouteTableId The specified AssociateRouteTableId is illegal.
    400 Forbbiden.AttachChildInstanceAcrossBid Operation is invalid, please apply for cross-bid attaching.
    400 IllegalParam.RegionId RegionId is illegal.
    400 OperationUnsupported.CenFullLevel CEN full level does not support TransitRouter
    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 QuotaFull.ChildInstanceRelatedCen The childinstance has exceed the quota of the times that a childinstance can be attached as an attachment.
    400 Forbidden.ResourceOwnerTransitRouterServiceNotOpen The resource owner user has not opened transit router service.
    400 OperationUnsupported.BandwidthType The specified BandwidthType does not support the operation.
    400 IllegalParam.BandwidthType BandwidthType is illegal.
    400 IncorrectStatus.EcrResource The ECR resource is not in a valid state for the attachment operation.
    400 QuotaExceeded.CenQuotaEcrAttachPerTransitRouter The maximum number of ECR attachment per Transit Router is exceeded.
    400 OperationUnsupported.ECRAttachment ECR Attachment is not supported.
    400 InvalidTransitRouterMode.NeedUpgrade TransitRouter need to upgrade.
    400 ResourceNotFound The resource does not found.
    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 Forbbiden.AttachAcrossBidEcr Attach cross bid ECR is unsupported. Please submit a ticket.
    400 InvalidParameter Invalid parameter.
    400 Unauthorized The AccessKeyId is unauthorized.
    400 InvalidParameter.ResourceType The specified parameter ResourceType is invalid.
    400 SystemBusy The system is busy. Please try again later.
    400 OperationDenied.AttachmentInCurrentRegionExisted The current operation is rejected. The Express Connect Router instance can only associate one Transit Router in the same region.

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

    変更履歴

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