DescribeCenAttachedChildInstances - Cloud Enterprise Network - Alibaba Cloud ドキュメントセンター

CEN インスタンスに接続されているネットワークインスタンスを照会します。

操作説明

次のいずれかの方法を使用して、CEN インスタンスに接続されているネットワークインスタンスに関する情報を照会できます。

CenId パラメーターを設定することにより、CEN インスタンスに接続されているすべてのネットワークインスタンスを照会できます。
CenId パラメーターと ChildInstanceRegionId パラメーターを設定することにより、指定したリージョンにある CEN インスタンスに接続されているネットワークインスタンスを照会できます。
CenId パラメーターと ChildInstanceType パラメーターを設定することにより、指定したタイプのネットワークインスタンスのうち、CEN インスタンスに接続されているものを照会できます。

今すぐお試しください

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

get

*CenInstance

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

なし

リクエストパラメーター

パラメーター	タイプ	必須 / 任意	説明	例
PageNumber	integer	任意	返されるページ番号。デフォルト値：1。	1
PageSize	integer	任意	各ページに返されるエントリの数。デフォルト値：10。有効な値：1 ～ 50。	10
CenId	string	必須	CEN インスタンスの ID。	cen-j3jzhw1zpau2km****
ChildInstanceType	string	任意	ネットワークインスタンスのタイプ。有効な値： VPC: VPC (Virtual Private Cloud) VBR: 仮想ボーダールータ (VBR) CCN: クラウド相互接続ネットワーク (CCN) インスタンス	VPC
ChildInstanceRegionId	string	任意	ネットワークインスタンスがデプロイされているリージョンの ID。 DescribeRegions 操作を呼び出して、最新のリージョンリストを照会できます。	cn-zhangjiakou

レスポンスパラメーター

パラメーター	タイプ	説明	例
	object
PageSize	integer	1 ページあたりに返されるエントリの数。	10
RequestId	string	リクエスト ID。	B2063B16-852B-5B66-B73D-4ED4D1A5E5C2
PageNumber	integer	返されたページのページ番号。	1
TotalCount	integer	返されたエントリの総数。	1
ChildInstances	object
ChildInstance	array<object>	ネットワークインスタンスの情報。
	object
ChildInstanceType	string	ネットワークインスタンスのタイプ。有効な値： VPC: VPC VBR: VBR CCN: CCN インスタンス	VPC
Status	string	ネットワークインスタンスのステータス。有効な値： Attaching: ネットワークインスタンスはトランジットルーターで作成されています。 Attached: ネットワークインスタンスはトランジットルーターで作成されました。 Detaching: ネットワークインスタンスはトランジットルーターから削除されています。	Attached
ChildInstanceRegionId	string	ネットワークインスタンスがデプロイされているリージョンの ID。	cn-zhangjiakou
ChildInstanceOwnerId	integer	ネットワークインスタンスが属する Alibaba Cloud アカウントの ID。	1688000000000000
ChildInstanceId	string	ネットワークインスタンスの ID。	vpc-8vb1lu55yt9rlwgxl****
ManagedService	string	ネットワークインスタンスが属するクラウドサービス。その標準コードは、VPC がトランジットルーターに接続されている場合にのみ返されます。セルフマネージド VPC の場合、コードは返されません。	swas
ChildInstanceAttachTime	string	ネットワークインスタンスが CEN インスタンスに接続された時刻。時刻は YYYY-MM-DDThh:mmZ 形式の ISO8601 標準に準拠しています。時刻は UTC で表示されます。	2021-08-10T06:27Z
CenId	string	CEN インスタンスの ID。	cen-j3jzhw1zpau2km****

例

成功レスポンス

JSONJSON

{
  "PageSize": 10,
  "RequestId": "B2063B16-852B-5B66-B73D-4ED4D1A5E5C2",
  "PageNumber": 1,
  "TotalCount": 1,
  "ChildInstances": {
    "ChildInstance": [
      {
        "ChildInstanceType": "VPC",
        "Status": "Attached",
        "ChildInstanceRegionId": "cn-zhangjiakou",
        "ChildInstanceOwnerId": 1688000000000000,
        "ChildInstanceId": "vpc-8vb1lu55yt9rlwgxl****",
        "ManagedService": "swas",
        "ChildInstanceAttachTime": "2021-08-10T06:27Z",
        "CenId": "cen-j3jzhw1zpau2km****"
      }
    ]
  }
}

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ	説明
400	InvalidParameter	Invalid parameter.
400	Unauthorized	The AccessKeyId is unauthorized.

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

変更履歴

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