调用DescribeCens接口查询当前阿里云账号下的云企业网实例信息。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 否 DescribeCens

要执行的操作。

取值：DescribeCens。

PageNumber Integer 否 1

查询页码。默认值为1。

PageSize Integer 否 10

分页查询时每页显示的条目数。默认值为10，取值范围：1~50。

Filter.N.Key String 否 CenId

过滤条件。取值：

  • CenId：云企业网实例ID。
  • Name：云企业网实例名称。

N的最大值为5。多个过滤条件之间默认是与的关系，即必须符合所有过滤条件，才视为匹配过滤条件。

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

过滤条件的值。N的最大值为5。

根据Key指定过滤值。一个Key支持指定多个过滤值，多个过滤值之间是或的关系，即只要符合其中一个过滤值，则视为匹配该过滤条件。

Tag.N.Key String 否 tagtest

资源的标签键。N的取值范围：1~20。

一旦传入该值，则不允许为空字符串。最多支持64个字符，不能以http://或者https:// 开头。

Tag.N.Value String 否 tagtest

资源的标签值。N的取值范围：1~20。

标签值可以为空或输入不超过128个字符的字符串，不能以http:// 或者https:// 开头。

返回数据

名称 类型 示例值 描述
Cens Array of Cen

云企业网实例的详细信息。
Cen
CenBandwidthPackageIds List cenbwp-4c2zaavbvh5f42****

云企业网实例绑定的带宽包的列表。
CenId String cen-0xyeagctz5sfg9****

云企业网实例的ID。
CreationTime String 2019-10-22T07:44Z

云企业网实例的创建时间。

时间按照ISO8601标准表示，并使用UTC时间。格式为：YYYY-MM-DDThh:mmZ。
Description String desctest

云企业网实例的描述信息。
Name String nametest

云企业网实例的名称。
ProtectionLevel String REDUCED

网段重叠的级别。

REDUCED：表示网段可以有重叠，但是不能完全相同。

Status String Active

云企业网实例的状态。

  • Creating：创建中。
  • Active：运行中。
  • Deleting：删除中。
Tags Array of Tag

云企业网实例绑定的标签列表。
Tag
Key String tagtest

标签键。
Value String tagtest

标签值。
PageNumber Integer 1

查询页码。
PageSize Integer 10

分页查询时每页显示的条目数。
RequestId String 2BFA6822-240E-4E27-B4C8-AA400EF7474D

请求ID。
TotalCount Integer 1

总条目数。

示例

请求示例

http(s)://[Endpoint]/?Action=DescribeCens
&<公共请求参数>

正常返回示例

XML格式 

<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格式 

{
	"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"
			}
		]
	}
}

错误码

HttpCode 错误码 错误信息 描述
400 InvalidTagKey The tag keys are not valid. 标签的Key值不合法。

访问错误中心查看更多错误码。