Queries the network instances that are attached to a Cloud Enterprise Network (CEN) instance.

Description

You can use one of the following methods to query the information about the network instances that are attached to a CEN instance:

  • You can query all the network instances that are attached to a CEN instance by setting the CenId parameter.
  • You can query the network instances that are attached to a CEN instance in a specified region by setting the CenId and ChildInstanceRegionId parameters.
  • You can query a specified type of network instances that are attached to a CEN instance by setting the CenId and ChildInstanceType parameters.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String No DescribeCenAttachedChildInstances

The operation that you want to perform. Set the value to DescribeCenAttachedChildInstances.

CenId String Yes cen-j3jzhw1zpau2km****

The ID of the CEN instance.

PageNumber Integer No 1

The number of the page to return. Default value: 1.

PageSize Integer No 10

The number of entries to return per page. Default value: 10. Valid values: 1 to 50.

ChildInstanceType String No VPC

The type of the network instance. Valid values:

  • VPC: virtual private cloud (VPC)
  • VBR: virtual border router (VBR)
  • CCN: Cloud Connect Network (CCN) instance
ChildInstanceRegionId String No cn-zhangjiakou

The region ID of the network instance.

You can call the DescribeRegions operation to query the most recent region list.

Response parameters

Parameter Type Example Description
ChildInstances Array of ChildInstance

The information about the network instances.

ChildInstance
CenId String cen-j3jzhw1zpau2km****

The ID of the CEN instance.

ChildInstanceAttachTime String 2021-08-10T06:27Z

The time when the network instance was attached to the CEN instance.

The time follows the ISO 8601 standard in the yyyy-MM-ddThh:mmZ format. The time is displayed in UTC.

ChildInstanceId String vpc-8vb1lu55yt9rlwgxl****

The ID of the network instance.

ChildInstanceOwnerId Long 1688000000000000

The ID of the Alibaba Cloud account to which the network instance belongs.

ChildInstanceRegionId String cn-zhangjiakou

The region ID of the network instance.

ChildInstanceType String VPC

The type of the network instance. Valid values:

  • VPC: VPC
  • VBR: VBR
  • CCN: CCN instance
Status String Attached

The status of the network instance. Valid values:

  • Attaching: The network instance is being attached to the CEN instance.
  • Attached: The network instance is attached to the CEN instance.
  • Detaching: The network instance is being detached from the CEN instance.
PageNumber Integer 1

The number of the returned page.

PageSize Integer 10

The number of entries returned per page.

RequestId String B2063B16-852B-5B66-B73D-4ED4D1A5E5C2

The ID of the request.

TotalCount Integer 1

The total number of entries returned.

Examples

Sample requests

http(s)://[Endpoint]/?Action=DescribeCenAttachedChildInstances
&CenId=cen-j3jzhw1zpau2km****
&<Common request parameters>

Sample success responses

XML format

<DescribeCenAttachedChildInstancesResponse>
  <TotalCount>1</TotalCount>
  <PageSize>10</PageSize>
  <RequestId>B2063B16-852B-5B66-B73D-4ED4D1A5E5C2</RequestId>
  <PageNumber>1</PageNumber>
  <ChildInstances>
        <ChildInstance>
              <Status>Attached</Status>
              <ChildInstanceType>VPC</ChildInstanceType>
              <CenId>cen-j3jzhw1zpau2kmscxd</CenId>
              <ChildInstanceAttachTime>2021-08-10T06:27Z</ChildInstanceAttachTime>
              <ChildInstanceOwnerId>1688401595963306</ChildInstanceOwnerId>
              <ChildInstanceId>vpc-8vb1lu55yt9rlwgxlu83b</ChildInstanceId>
              <ChildInstanceRegionId>cn-zhangjiakou</ChildInstanceRegionId>
        </ChildInstance>
  </ChildInstances>
</DescribeCenAttachedChildInstancesResponse>

JSON format

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

Error codes

For a list of error codes, visit the API Error Center.