Queries detailed information about Cloud Enterprise Network (CEN) instances within the current Alibaba Cloud account.

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 DescribeCens

The operation that you want to perform.

Set the value to DescribeCens.

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.

Filter.N.Key String No CenId

The filter condition. Valid values:

  • CenId: a CEN instance ID.
  • Name: a CEN instance name.

Maximum value of N: 5. By default, the logical relation among multiple filter conditions is AND. Information about a CEN instance is returned only if the CEN instance matches all filter conditions.

Filter.N.Value.N RepeatList No cen-0xyeagctz5sfg9****

The value of the filter condition. Maximum value of N: 5.

This parameter sets the value of a filter key. You can specify multiple values for a filter key. The logical relation among multiple filter values is OR. If a CEN instance matches one or more of the values that you specify, the CEN instance matches the filter condition.

Tag.N.Key String No tagtest

The tag key of the CEN instance. Valid values of N: 1 to 20.

The tag key cannot be an empty string. The tag key must be up to 64 characters in length, and cannot start with http:// or https:// .

Tag.N.Value String No tagtest

The tag value of the CEN instance. Valid values of N: 1 to 20.

The tag value must be up to 128 characters in length, and cannot start with http:// or https:// .

Response parameters

Parameter Type Example Description
Cens Array of Cen

Detailed information about the CEN instance.

Cen
CenBandwidthPackageIds List cenbwp-4c2zaavbvh5f42****

The IDs of the bandwidth plans that are associated with the CEN instance.

CenId String cen-0xyeagctz5sfg9****

The ID of the CEN instance.

CreationTime String 2019-10-22T07:44Z

The time when the CEN instance was created.

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

Description String desctest

The description of the CEN instance.

Name String nametest

The name of the CEN instance.

ProtectionLevel String REDUCED

The level of CIDR block overlapping.

REDUCED: Overlapped CIDR blocks are allowed. This value specifies that CIDR blocks can overlap but CIDR blocks cannot match.

Status String Active

The status of the CEN instance.

  • Creating: The CEN instance is being created.
  • Active: The CEN instance is running.
  • Deleting: The CEN instance is being deleted.
Tags Array of Tag

The IDs of the tags that are added to the CEN instance.

Tag
Key String tagtest

The key of the tag.

Value String tagtest

The value of the tag.

PageNumber Integer 1

The number of the returned page.

PageSize Integer 10

The number of entries returned per page.

RequestId String 2BFA6822-240E-4E27-B4C8-AA400EF7474D

The ID of the request.

TotalCount Integer 1

The total number of entries returned.

Examples

Sample requests

http(s)://[Endpoint]/?Action=DescribeCens
&<Common request parameters>

Sample success responses

XML format

<DescribeCensResponse>
  <TotalCount>1</TotalCount>
  <RequestId>2BFA6822-240E-4E27-B4C8-AA400EF7474D</RequestId>
  <PageSize>10</PageSize>
  <PageNumber>1</PageNumber>
  <Cens>
        <Cen>
              <Status>Active</Status>
              <ProtectionLevel>REDUCED</ProtectionLevel>
              <CenId>cen-0xyeagctz5sfg9****</CenId>
              <CreationTime>2019-10-22T07:44Z</CreationTime>
              <CenBandwidthPackageIds>
        </CenBandwidthPackageIds>
              <Name>v190702</Name>
        </Cen>
  </Cens>
</DescribeCensResponse>

JSON format

{
    "TotalCount": 1,
    "RequestId": "2BFA6822-240E-4E27-B4C8-AA400EF7474D",
    "PageSize": 10,
    "PageNumber": 1,
    "Cens": {
        "Cen": [
            {
                "Status": "Active",
                "ProtectionLevel": "REDUCED",
                "CenId": "cen-0xyeagctz5sfg9****",
                "CreationTime": "2019-10-22T07:44Z",
                "CenBandwidthPackageIds": {
                    "CenBandwidthPackageId": []
                },
                "Name": "v190702"
            }
        ]
    }
}

Error codes

HttpCode Error code Error message Description
400 InvalidTagKey The tag keys are not valid. The error message returned because the tag key is invalid.

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