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值不合法。

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