edit-icon download-icon

DescribeCens

Last Updated: Mar 28, 2018

Description

Query the created CEN instances.

Request parameters

Name Type Required Description
Action String Yes

The action to perform. Valid value:

DescribeCens

Filter.n.Key String No

Filter keys. Up to 5 filters can be specified. Valid value for n is [1,5].

The supported filter keys are:

  • CenId: Query the CEN instance with the specified ID.
  • Name: Query the CEN instance with the specified name.
  • CenBandwidthPackageId: Query the CEN instance with the specified bandwidth package.
Filter.n.Value.m String No The value of the corresponding filter key.
PageNumberIntegerNoThe number of pages to return. Default value is 1.
PageSizeIntegerNoThe number of rows per page. The maximum value is 50 and the default value is 10.

Response parameters

Name Type Description
RequestId String The ID of the request.
PageNumber Integer The current page number.
TotalCountIntegerThe number of queried entries.
PageSizeIntegerThe number of entries on the current page.
CensJSON StringA list of the CEN instances.
The Cens parameter contains the following elements:
CenIdStringThe ID of the CEN instance.
NameStringThe name of the CEN instance.
StatusStringThe status of the CEN instance.
CenBandwidthPackageIdsJSON StringThe bandwidth packages associated with the CEN instances.
DescriptionStringThe description of the CEN instance.

Error Codes

See Common error codes.

Examples

Request example

  1. http://cbn.aliyuncs.com/?Action=DescribeCens
  2. &<Common parameters>

Response example

XML format

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <DescribeCensResponse>
  3. <Cens>
  4. <Cen>
  5. <CenBandwidthPackageIds>
  6. <CenBandwidthPackageId>
  7. <CenBandwidthPackageId>cenbwp-oq2ehpxq4zhwp790l7</CenBandwidthPackageId>
  8. <CenBandwidthPackageId>cenbwp-18qmj0bahl3yskktho</CenBandwidthPackageId>
  9. </CenBandwidthPackageId>
  10. </CenBandwidthPackageIds>
  11. <CenId>cen-kojok19x3j0q6kx5qf</CenId>
  12. <Description>jzwne 0207</Description>
  13. <Name>jzwen_0207_01</Name>
  14. <Status>Active</Status>
  15. </Cen>
  16. <Cen>
  17. <CenBandwidthPackageIds>
  18. <CenBandwidthPackageId>
  19. <CenBandwidthPackageId>cenbwp-3o2zy4s6jig88pn325</CenBandwidthPackageId>
  20. <CenBandwidthPackageId>cenbwp-hq2ad760htrr7r5vlp</CenBandwidthPackageId>
  21. </CenBandwidthPackageId>
  22. </CenBandwidthPackageIds>
  23. <CenId>cen-mkljagz6auhbzo7ayx</CenId>
  24. <Name>jzwen_crossaccount_01</Name>
  25. <Status>Active</Status>
  26. </Cen>
  27. </Cens>
  28. <PageNumber>1</PageNumber>
  29. <PageSize>10</PageSize>
  30. <RequestId>145F96AB-3EE9-4DCA-991C-726F96CC5703</RequestId>
  31. <TotalCount>4</TotalCount>
  32. </DescribeCensResponse>

JSON format

  1. {
  2. "PageNumber":1,
  3. "TotalCount":1,
  4. "PageSize":10,
  5. "RequestId":"04BD121E-4F82-4E92-BAFA-87FC8082DDD7",
  6. "Cens":{
  7. "Cen":[
  8. {
  9. "Name":"test",
  10. "Status":"Active",
  11. "CenId":"Cen-646nkqmhnixx2j1l5k",
  12. "CenBandwidthPackageIds":{
  13. "CenBandwidthPackageId":[
  14. ]
  15. }
  16. }
  17. ]
  18. }
  19. }
Thank you! We've received your feedback.