すべてのプロダクト
Search

このプロダクト

    :DescribeExpressConnectRouterAssociation

    ドキュメントセンター

    :DescribeExpressConnectRouterAssociation

    最終更新日:Aug 14, 2025

    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:DescribeExpressConnectRouterAssociation

    list

    *ExpressConnectRouter

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

    		 なし なし

    リクエストパラメーター

    パラメーター

    タイプ

    必須 / 任意

    説明

    例
    EcrId

    string

    必須

    ECR インスタンス ID。

    ecr-mezk2idmsd0vx2****
    AssociationId

    string

    任意

    ECR と VPC または TR 間の関連付け ID。

    ecr-assoc-9p2qxx5phpca2m****
    AssociationRegionId

    string

    任意

    関連付けられた VPC または TR がデプロイされているリージョンの ID。

    cn-hangzhou
    AssociationNodeType

    string

    任意

    関連付けられたリソースのタイプ。

    • VPC: VPC。

    • TR: TR。

    VPC
    VpcId

    string

    任意

    VPC インスタンスの ID。

    vpc-bp1h37fchc6jmfyln****
    TransitRouterId

    string

    任意

    TR インスタンスの ID。

    tr-2ze4i71c6be454e2l****
    CenId

    string

    任意

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

    cen-of3o1the3i4gwb****
    NextToken

    string

    任意

    次のクエリに使用されるトークン。有効な値:

    • 最初のクエリ、または後続のクエリが不要な場合は、このパラメーターを空のままにします。

    • 後続のクエリが必要な場合は、前の API 呼び出しから返された NextToken 値に設定します。

    AAAAAYws9fJ0Ur4MGm/5OkDoW/Zn0J0/sCjivzwX9oBcwFnWaaas/kSG+J/WzLOxJHS4****
    MaxResults

    integer

    任意

    各ページに返す最大エントリ数。有効な値: 1 ～ 2147483647 。デフォルト値: 20 。

    10
    DryRun

    boolean

    任意

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

    • true: サービスリソースを変更せずにチェックリクエストを送信します。

    • false ( デフォルト ): 通常のリクエストを送信します。

    false
    ClientToken

    string

    任意

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

    異なるリクエスト間でトークンが一意になるように、クライアントでトークンを生成します。ClientToken パラメーターには ASCII 文字のみを含めることができます。

    説明

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

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

    レスポンスパラメーター

    パラメーター

    タイプ

    説明

    例

    object

    RpcResponse

    RequestId

    string

    リクエスト ID 。

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

    boolean

    呼び出しが成功したかどうかを示します。有効な値:

    • True: 呼び出しは成功しました。

    • False: 呼び出しは失敗しました。

    True
    Code

    string

    呼び出しが成功したかどうかを示します。値 200 は、呼び出しが成功したことを示します。その他の値は、呼び出しが失敗したことを示します。詳細については、「エラーコード」をご参照ください。

    200
    Message

    string

    操作に対して返されたメッセージ。

    OK
    HttpStatusCode

    integer

    HTTP ステータスコード。

    200
    DynamicCode

    string

    動的エラーコード。

    IllegalParamFormat.EcrId
    DynamicMessage

    string

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

    説明

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

    The param format of EcrId **** is illegal.
    AccessDeniedDetail

    string

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

    Authentication is failed for ****
    TotalCount

    integer

    関連付けられているリソースの総数。

    1
    MaxResults

    integer

    各ページに返される最大エントリ数。有効な値: 1 ～ 2147483647 。デフォルト値: 20 。

    20
    NextToken

    string

    次のクエリに使用されるトークン。有効な値:

    • NextToken が空の場合、次のクエリは送信されません。

    • NextToken に値が返された場合、その値は次のクエリに使用されるトークンです。

    AAAAAYws9fJ0Ur4MGm/5OkDoW/Zn0J0/sCjivzwX9oBcwFnWaaas/kSG+J/WzLOxJHS4****

    AssociationList

    array<object>

    関連付けられているリソースのリスト。

    object

    AssociationId

    string

    ECR と VPC または TR 間の関連付けの ID 。

    ecr-assoc-9p2qxx5phpca2m****

    RegionId

    string

    リソースがデプロイされているリージョン。

    cn-hangzhou
    OwnerId

    integer

    リソースが属する Alibaba Cloud アカウントの ID 。

    167509154715****
    GmtCreate

    string

    関連付けが作成された時刻。時刻は ISO 8601 標準の YYYY-MM-DDThh:mm:ssZ 形式で表示されます。時刻は UTC で表示されます。

    2024-01-09T12:18:23Z
    GmtModified

    string

    関連付けが変更された時刻。時刻は ISO 8601 標準の YYYY-MM-DDThh:mm:ssZ 形式で表示されます。時刻は UTC で表示されます。

    2024-01-09T12:18:23Z
    Status

    string

    関連付けられたリソースのデプロイステータス。有効な値:

    • CREATING: リソースは作成中です。

    • ACTIVE: リソースが作成されました。

    • INACTIVE: ECR は TR に関連付けられていますが、TR は ECR に関連付けられていません。

    • ASSOCIATING: リソースは関連付けられています。

    • DISSOCIATING: リソースは関連付け解除中です。

    • UPDATING: リソースは変更中です。

    • DELETING: リソースは削除中です。

    ACTIVE
    AssociationNodeType

    string

    関連付けられたリソースのタイプ。

    • VPC: VPC。

    • TR: TR。

    VPC
    TransitRouterOwnerId

    integer

    TR が属する Alibaba Cloud アカウントの ID 。

    189159362009****

    TransitRouterId

    string

    TR インスタンスの ID 。

    tr-2ze4i71c6be454e2l****

    CenId

    string

    CEN インスタンス ID。

    cen-5510frtx8zi54q****
    VpcOwnerId

    integer

    VPC が属する Alibaba Cloud アカウントの ID 。

    146757288406****
    VpcId

    string

    VPC インスタンスの ID 。

    vpc-2zeeaxet4i2j1a7n7****
    AllowedPrefixes

    array

    許可されたルートプレフィックスのリスト。

    string

    許可されたルートプレフィックス。

    192.0.20.0/28
    EcrId

    string

    ECR インスタンス ID。

    ecr-fu8rszhgv7623c****
    AllowedPrefixesMode

    string

    プレフィックスルーティングモード。有効な値:

    • MatchMode: 一致モード

    • IncrementalMode: 増分モード

    MatchMode
    Description

    string

    関連付けられたリソースの説明。

    test

    例

    成功レスポンス

    JSONJSON

    {
  "RequestId": "05130E79-588D-5C40-A718-C4863A59****",
  "Success": true,
  "Code": "200",
  "Message": "OK",
  "HttpStatusCode": 200,
  "DynamicCode": "IllegalParamFormat.EcrId",
  "DynamicMessage": "The param format of EcrId **** is illegal.",
  "AccessDeniedDetail": "Authentication is failed for ****",
  "TotalCount": 1,
  "MaxResults": 20,
  "NextToken": "AAAAAYws9fJ0Ur4MGm/5OkDoW/Zn0J0/sCjivzwX9oBcwFnWaaas/kSG+J/WzLOxJHS4****\n",
  "AssociationList": [
    {
      "AssociationId": "ecr-assoc-9p2qxx5phpca2m****\n",
      "RegionId": "cn-hangzhou",
      "OwnerId": 0,
      "GmtCreate": "2024-01-09T12:18:23Z",
      "GmtModified": "2024-01-09T12:18:23Z",
      "Status": "ACTIVE",
      "AssociationNodeType": "VPC",
      "TransitRouterOwnerId": 0,
      "TransitRouterId": "tr-2ze4i71c6be454e2l****\n",
      "CenId": "cen-5510frtx8zi54q****",
      "VpcOwnerId": 0,
      "VpcId": "vpc-2zeeaxet4i2j1a7n7****",
      "AllowedPrefixes": [
        "192.0.20.0/28"
      ],
      "EcrId": "ecr-fu8rszhgv7623c****",
      "AllowedPrefixesMode": "MatchMode",
      "Description": "test "
    }
  ]
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    400 MissingParam.%s The param of %s is missing.
    400 IllegalParamFormat.%s The param format of %s is illegal.
    400 IllegalParam.%s The param of %s is illegal.
    404 ResourceNotFound.EcrId EcrId not found.

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

    変更履歴

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