DescribeExpressConnectRouterAssociation を使用した Express Connect Router リソース関連付けのクエリ - Express Connect - Alibaba Cloud - Express Connect

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 (ECR) インスタンスの ID。	ecr-mezk2idmsd0vx2****
AssociationId	string	任意	Express Connect Router (ECR) と VPC または TR の間の関連付け ID。	ecr-assoc-9p2qxx5phpca2m****
AssociationRegionId	string	任意	VPC または TR が属するリージョン。	cn-hangzhou
AssociationNodeType	string	任意	関連付けられたリソースのタイプ。有効な値:	VPC
VpcId	string	任意	VPC 接続インスタンスの ID。	vpc-bp1h37fchc6jmfyln****
TransitRouterId	string	任意	トランジットルーターインスタンスの ID。	tr-2ze4i71c6be454e2l****
CenId	string	任意	Cloud Enterprise Network (CEN) インスタンスの ID。	cen-of3o1the3i4gwb****
NextToken	string	任意	ページネーショントークン。有効な値:	AAAAAYws9fJ0Ur4MGm/5OkDoW/Zn0J0/sCjivzwX9oBcwFnWaaas/kSG+J/WzLOxJHS4****
MaxResults	integer	任意	返されるエントリの最大値。有効な値: 1～2147483647。デフォルト値: 20。	20
DryRun	boolean	任意	ドライランのみを実行するかどうかを指定します。有効な値:	false
ClientToken	string	任意	リクエストのべき等性を確保するために使用されるクライアントトークン。	02fb3da4-130e-11e9-8e44-00****
Tag	array<object>	任意	タグのリスト。
	object	任意
Key	string	任意	リソースのタグキー。一度指定すると、値を空文字列にすることはできません。タグキーの長さは最大 128 文字で、`aliyun` または `acs:` で始めることはできません。`http://` または `https://` を含めることはできません。	TestKey
Value	string	任意	リソースのタグ値。タグ値は空文字列でもよく、長さは最大 128 文字です。`http://` または `https://` を含めることはできません。	TestValue

レスポンスフィールド

フィールド	型	説明	例
	object	RpcResponse
RequestId	string	リクエスト ID。	05130E79-588D-5C40-A718-C4863A59****
Success	boolean	呼び出しが成功したかどうかを示します。有効な値:	True
Code	string	応答コード。値 200 は成功を示します。その他の値は失敗を示します。エラーコードの詳細については、「エラーコード」を参照してください。	200
Message	string	返されたメッセージ。	OK
HttpStatusCode	integer	HTTP 状態コード。	200
DynamicCode	string	動的エラーコード。	IllegalParamFormat.EcrId
DynamicMessage	string	動的エラーメッセージ。ErrMessage 戻りパラメーター内の `%s` を置き換えるために使用されます。	EcrId **** のパラメーターフォーマットが無効です。
AccessDeniedDetail	string	アクセス拒否の詳細。	**** の認証は失敗しました。
TotalCount	integer	関連付けられたリソースの総数。	1
MaxResults	integer	返されるエントリの最大値。有効な値: 1～2147483647。デフォルト値: 20。	20
NextToken	string	ページネーショントークン。有効な値:	AAAAAYws9fJ0Ur4MGm/5OkDoW/Zn0J0/sCjivzwX9oBcwFnWaaas/kSG+J/WzLOxJHS4****
AssociationList	array<object>	関連付けられたリソースのリスト。
	array<object>
AssociationId	string	Express Connect Router (ECR) と VPC または TR の間の関連付け ID。	ecr-assoc-9p2qxx5phpca2m****
RegionId	string	リソースが属するリージョン。	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	関連付けられたリソースの Deployment ステータス。有効な値:	ACTIVE
AssociationNodeType	string	関連付けられたリソースのタイプ。有効な値:	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 Router (ECR) インスタンスの ID。	ecr-fu8rszhgv7623c****
AllowedPrefixesMode	string	プレフィックスルートモード。有効な値:	MatchMode
Description	string	関連付けられたリソースの説明。	test
Tags	array<object>	関連付けられたリソースにバインドされたタグのリスト。
	object
Key	string	タグキー。	TestKey
Value	string	タグ値。	TestValue
TransitRouterName	string	トランジットルーターインスタンスの名前。	test
VpcName	string	VPC 接続インスタンスの名前。	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.**.**/28"
      ],
      "EcrId": "ecr-fu8rszhgv7623c****",
      "AllowedPrefixesMode": "MatchMode",
      "Description": "test ",
      "Tags": [
        {
          "Key": "TestKey",
          "Value": "TestValue"
        }
      ],
      "TransitRouterName": "test",
      "VpcName": "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.

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

変更履歴

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