调用DescribeCenAttachedChildInstances查询云企业网实例下已加载的网络实例信息

调用DescribeCenAttachedChildInstances接口查询云企业网实例下已加载的网络实例信息。

接口说明

通过本接口您可以使用以下三种方式查询云企业网实例已加载的网络实例的信息：

通过指定查询CenId，查询云企业网实例下已加载的所有网络实例的信息。
通过指定CenId和ChildInstanceRegionId，查询云企业网实例在某一个地域下已加载的网络实例的信息。
通过指定CenId和ChildInstanceType，查询云企业网实例已加载的某一类型的网络实例的信息。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

cen:DescribeCenAttachedChildInstances

get

*CenInstance

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

无

请求参数

名称	类型	必填	描述	示例值
PageNumber	integer	否	查询页码。默认值为 1。	1
PageSize	integer	否	分页查询时每页显示的条目数。默认值为 10，取值范围：1~50。	10
CenId	string	是	云企业网实例 ID。	cen-j3jzhw1zpau2km****
ChildInstanceType	string	否	网络实例的类型，取值： VPC：专有网络实例。 VBR：边界路由器实例。 CCN：云连接网实例。	VPC
ChildInstanceRegionId	string	否	网络实例所属地域 ID。您可以通过调用 DescribeRegions 接口获取地域 ID。	cn-zhangjiakou

返回参数

名称	类型	描述	示例值
	object
PageSize	integer	分页查询时每页显示的条目数。	10
RequestId	string	请求 ID。	B2063B16-852B-5B66-B73D-4ED4D1A5E5C2
PageNumber	integer	查询页码。	1
TotalCount	integer	总条目数。	1
ChildInstances	object
ChildInstance	array<object>	云企业网实例加载的网络实例信息列表。
	object
ChildInstanceType	string	网络实例的类型，取值： VPC：专有网络实例。 VBR：边界路由器实例。 CCN：云连接网实例。	VPC
Status	string	网络实例的状态，取值： Attaching：加载中。 Attached：已加载。 Detaching：卸载中。	Attached
ChildInstanceRegionId	string	网络实例所属地域 ID。	cn-zhangjiakou
ChildInstanceOwnerId	integer	网络实例所属阿里云账号（主账号）ID。	1688000000000000
ChildInstanceId	string	网络实例 ID。	vpc-8vb1lu55yt9rlwgxl****
ManagedService	string	网络实例所归属的云服务，只有云服务占用的 VPC 连接到 TR 时才会返回对应云服务的标准 Code。如果是您自行管理的 VPC，则不返回。	swas
ChildInstanceAttachTime	string	网络实例的加载时间。时间按照 ISO8601 标准表示，并使用 UTC 时间。格式为：YYYY-MM-DDThh:mmZ。	2021-08-10T06:27Z
CenId	string	云企业网实例 ID。	cen-j3jzhw1zpau2km****

示例

正常返回示例

JSON格式

{
  "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****"
      }
    ]
  }
}

异常返回示例

JSON格式

{
   "PageNumber":1,
   "ChildInstances":{
      "ChildInstance":[
         {
            "Status":"Attached",
            "ChildInstanceOwnerId":"1894573272823690",
            "ChildInstanceId":"vpc-hp3kz27b1uv9hsmm9vqiv",
            "ChildInstanceRegionId":"cn-huhehaote",
            "CenId":"cen-kojok19x3j0q6kx5qf",
            "ChildInstanceType":"VPC"
         },
         {
            "Status":"Attached",
            "ChildInstanceOwnerId":"1894573272823690",
            "ChildInstanceId":"vpc-gw85r5kr8urw957szm455",
            "ChildInstanceRegionId":"eu-central-1",
            "CenId":"cen-kojok19x3j0q6kx5qf",
            "ChildInstanceType":"VPC"
         }
      ]
   },
   "TotalCount":3,
   "PageSize":10,
   "RequestId":"50F8E0AB-A225-41C0-AC88-FFB51A4F5C72"
}

错误码

HTTP status code	错误码	错误信息	描述
400	InvalidParameter	Invalid parameter.	参数不合法。
400	Unauthorized	The AccessKeyId is unauthorized.	账号无权限操作。

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。