すべてのプロダクト
Search

このプロダクト

    Express Connect:DescribeExpressConnectRouterAssociation

    ドキュメントセンター

    Express Connect:DescribeExpressConnectRouterAssociation

    最終更新日:Jun 04, 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:DescribeExpressConnectRouterAssociation

    list

    *ExpressConnectRouter

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

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    EcrId

    string

    必須

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

    ecr-mezk2idmsd0vx2****
    AssociationId

    string

    任意

    Express Connect Router と VPC または TR との間の関連付けの ID です。

    ecr-assoc-9p2qxx5phpca2m****
    AssociationRegionId

    string

    任意

    関連付けられている VPC または TR のリージョン ID です。

    cn-hangzhou
    AssociationNodeType

    string

    任意

    関連リソースのタイプです。有効な値は次のとおりです：

    • VPC：VPC

    • TR：トランジットルーター

    VPC
    VpcId

    string

    任意

    VPC インスタンスの ID です。

    vpc-bp1h37fchc6jmfyln****
    TransitRouterId

    string

    任意

    トランジットルーターインスタンスの ID です。

    tr-2ze4i71c6be454e2l****
    CenId

    string

    任意

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

    cen-of3o1the3i4gwb****
    NextToken

    string

    任意

    結果の次ページを取得するためのトークンです。有効な値は次のとおりです：

    • 最初のリクエストでは、このパラメーターを空のままにします。

    • 後続のリクエストでは、このパラメーターを前の応答で返された NextToken の値に設定します。

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

    integer

    任意

    ページあたりに返すエントリの最大数です。有効な値：1～2147483647。デフォルト値：20。

    20
    DryRun

    boolean

    任意

    ドライランを実行するかどうかを指定します。有効な値は次のとおりです：

    • true：リクエストをチェックするためのドライランを実行します。リソースは変更されません。

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

    false
    ClientToken

    string

    任意

    リクエストのべき等性を保証するためのクライアントトークンです。

    トークンはリクエスト間で一意とし、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 が EcrId を返す場合、EcrId リクエストパラメーターの値は無効です。

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

    string

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

    Authentication is failed for ****
    TotalCount

    integer

    返されたエントリの総数。

    1
    MaxResults

    integer

    ページごとに返されるエントリ数。

    20
    NextToken

    string

    ページネーショントークン。次のリクエストで使用すると、結果の新しいページを取得できます。有効な値：

    • NextToken が空の場合、次のページはありません。

    • NextToken が空でない場合、結果の次のページが利用可能であることを示します。

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

    AssociationList

    array<object>

    関連付けのリスト。

    array<object>

    AssociationId

    string

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

    ecr-assoc-9p2qxx5phpca2m****

    RegionId

    string

    リソースのリージョン ID。

    cn-hangzhou
    OwnerId

    integer

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

    167509154715****
    GmtCreate

    string

    関連付けが作成された時刻。時刻は YYYY-MM-DDThh:mm:ssZ 形式で表示されます。協定世界時 (UTC) です。

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

    string

    関連付けが変更された時刻。時刻は YYYY-MM-DDThh:mm:ssZ 形式で表示されます。協定世界時 (UTC) です。

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

    string

    関連付けのステータス。有効な値：

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

    • ACTIVE ：リソースは利用可能です。

    • INACTIVE ：Express Connect ルーターはトランジットルーターに関連付けられていますが、トランジットルーターからの関連付けは保留中です。

    • ASSOCIATING ：リソースは関連付け中です。

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

    • UPDATING ：リソースは更新中です。

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

    ACTIVE
    AssociationNodeType

    string

    関連付けられているリソースのタイプ。有効な値：

    • VPC ：VPC

    • TR ：トランジットルーター

    VPC
    TransitRouterOwnerId

    integer

    トランジットルーターを所有する Alibaba Cloud アカウントの ID。

    189159362009****

    TransitRouterId

    string

    トランジットルーターインスタンスの 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.**.**/28
    EcrId

    string

    Express Connect ルーターインスタンスの ID。

    ecr-fu8rszhgv7623c****
    AllowedPrefixesMode

    string

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

    • MatchMode ：マッチモード

    • IncrementalMode ：インクリメンタルモード

    MatchMode
    Description

    string

    関連付けの説明。

    test

    Tags

    array<object>

    関連付けのタグ。

    object

    Key

    string

    タグキー。

    Value

    string

    タグ値。

    TransitRouterName

    string

    トランジットルーターインスタンスの名前。

    VpcName

    string

    VPC インスタンスの名前。

    例

    成功レスポンス

    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.**.**/28"
      ],
      "EcrId": "ecr-fu8rszhgv7623c****",
      "AllowedPrefixesMode": "MatchMode",
      "Description": "test ",
      "Tags": [
        {
          "Key": "",
          "Value": ""
        }
      ],
      "TransitRouterName": "",
      "VpcName": ""
    }
  ]
}

    エラーコード

    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.

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

    変更履歴

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