All Products
Search
Document Center

Cloud Enterprise Network:DescribeCenAttachedChildInstanceAttribute

Last Updated:Mar 25, 2024

Queries the information about a network instance, such as a virtual private cloud (VPC), a virtual border router, or a Cloud Connect Network (CCN) instance, that is attached to a Cloud Enterprise Network (CEN) instance.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

Authorization information

The following table shows the authorization information corresponding to the API. The authorization information can be used in the Action policy element to grant a RAM user or RAM role the permissions to call this API operation. Description:

  • Operation: the value that you can use in the Action element to specify the operation on a resource.
  • Access level: the access level of each operation. The levels are read, write, and list.
  • Resource type: the type of the resource on which you can authorize the RAM user or the RAM role to perform the operation. Take note of the following items:
    • The required resource types are displayed in bold characters.
    • If the permissions cannot be granted at the resource level, All Resources is used in the Resource type column of the operation.
  • Condition Key: the condition key that is defined by the cloud service.
  • Associated operation: other operations that the RAM user or the RAM role must have permissions to perform to complete the operation. To complete the operation, the RAM user or the RAM role must have the permissions to perform the associated operations.
OperationAccess levelResource typeCondition keyAssociated operation
cen:DescribeCenAttachedChildInstanceAttributeREAD
  • CenInstance
    acs:cen:*:{#accountId}:ceninstance/{#ceninstanceId}
    none
none

Request parameters

ParameterTypeRequiredDescriptionExample
CenIdstringYes

The ID of the CEN instance.

cen-5mv960yjhja0dh****
ChildInstanceIdstringYes

The ID of the network instance that is attached to the CEN instance.

vpc-2zebdboka7d7t37vo****
ChildInstanceTypestringYes

The type of the network instance. Valid values:

  • VPC: virtual private cloud (VPC)
  • VBR: virtual border router (VBR)
  • CCN: Cloud Connect Network (CCN) instance
VPC
ChildInstanceRegionIdstringYes

The region ID of the network instance.

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

cn-beijing

Response parameters

ParameterTypeDescriptionExample
object
Statusstring

Indicates whether the network instance is attached to the CEN instance.

  • 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.
Attached
ChildInstanceTypestring

The type of the network instance. Valid values:

  • VPC: VPC
  • VBR: VBR
  • CCN: CCN instance
VPC
ChildInstanceRegionIdstring

The region ID of the network instance.

cn-beijing
RequestIdstring

The ID of the request.

ADD98358-D265-4060-87CB-A2427F5A8944
ChildInstanceOwnerIdlong

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

1688000000000000
ChildInstanceIdstring

The ID of the network instance.

vpc-2zebdboka7d7t37vo****
CenIdstring

The ID of the CEN instance.

cen-5mv960yjhja0dh****
ChildInstanceNamestring

The name of the network instance.

defaultvpc
ChildInstanceAttachTimestring

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.

2018-07-30T07:53Z
ChildInstanceAttributesobject

The details about the network instance.

CidrBlockstring

The IPv4 CIDR block of the VPC.

192.168.0.0/16
SecondaryCidrBlocksarray

The information about the VPC secondary CIDR block.

string

The secondary IPv4 CIDR block of the VPC.

192.168.20.0/24
Ipv6CidrBlockstring

The IPv6 CIDR block of the VPC.

2408:XXXX:0:a600::/56
Ipv6CidrBlocksobject []

The IPv6 CIDR blocks of the VPC.

Ipv6Ispstring

The type of the IPv6 CIDR block of the VPC. Valid values:

  • BGP (default): Alibaba Cloud Border Gateway Protocol (BGP) IPv6
  • ChinaMobile: China Mobile (single line)
  • ChinaUnicom: China Unicom (single line)
  • ChinaTelecom: China Telecom (single line)
Note If you are on the whitelist of single-line bandwidth, you can set this parameter to ChinaTelecom, ChinaUnicom, or ChinaMobile.
BGP
Ipv6CidrBlockstring

The IPv6 CIDR block of the VPC.

2408:XXXX:0:6a::/56

Examples

Sample success responses

JSONformat

{
  "Status": "Attached",
  "ChildInstanceType": "VPC",
  "ChildInstanceRegionId": "cn-beijing",
  "RequestId": "ADD98358-D265-4060-87CB-A2427F5A8944",
  "ChildInstanceOwnerId": 1688000000000000,
  "ChildInstanceId": "vpc-2zebdboka7d7t37vo****",
  "CenId": "cen-5mv960yjhja0dh****",
  "ChildInstanceName": "defaultvpc",
  "ChildInstanceAttachTime": "2018-07-30T07:53Z",
  "ChildInstanceAttributes": {
    "CidrBlock": "192.168.0.0/16",
    "SecondaryCidrBlocks": {
      "secondaryCidrBlock": [
        "192.168.20.0/24"
      ]
    },
    "Ipv6CidrBlock": "2408:XXXX:0:a600::/56",
    "Ipv6CidrBlocks": {
      "ipv6CidrBlock": [
        {
          "Ipv6Isp": "BGP",
          "Ipv6CidrBlock": "2408:XXXX:0:6a::/56"
        }
      ]
    }
  }
}

Error codes

HTTP status codeError codeError messageDescription
400SystemBusyThe system is busy. Please try again later.The error message returned because the system is unavailable. Try again later.
400InvalidParameterInvalid parameter.The error message returned because the parameter is set to an invalid value.
400UnauthorizedThe AccessKeyId is unauthorized.The error message returned because you do not have the permissions to perform this operation.
404ParameterErrorThe parameter is error.The error message returned because a parameter is invalid.

For a list of error codes, visit the Service error codes.

Change history

Change timeSummary of changesOperation
2023-04-27The Error code has changed. The response structure of the API has changedsee changesets
Change itemChange content
Error CodesThe Error code has changed.
    delete Error Codes: 400
    delete Error Codes: 404
Output ParametersThe response structure of the API has changed.