Queries detailed information about Cloud Enterprise Network (CEN) instances under the current 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 1

The number of entries to return on each page. Maximum value: 50. Default value: 10.

Filter.N.Key String No Name

The filter condition.

Filter.N.Value.N RepeatList No test

The value of the filter condition.

Tag.N.Key String No name

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

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

Tag.N.Value String No abc

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

This parameter can be an empty string. The tag value can be up to 128 characters in length, and cannot start with http:// or https://.

Response parameters

Parameter Type Example Description
Cens Array

Detailed information about the CEN instance.

Cen
CenBandwidthPackageIds List cenbwp-4c2zaavbvh5f42****

The bandwidth plan that is associated with the CEN instance.

CenId String cen-7qthudw0ll6jmc****

The ID of the CEN instance.

CreationTime String 2018-10-16T08:46Z

The time when the CEN instance was created.

Description String cen

The description of the CEN instance.

Name String test

The name of the CEN instance.

ProtectionLevel String REDUCED

The level of CIDR block overlapping. Valid values:

REDUCED: Overlapped CIDR blocks are allowed. However, the overlapped CIDR blocks cannot be the same.

Status String Creating

The state of the CEN instance. Valid values:

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

The tags of the CEN instance.

Tag
Key String name

The tag key of the CEN instance.

Value String aaa

The tag value of the CEN instance.

PageNumber Integer 1

The number of the returned page.

PageSize Integer 12

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

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