查询Vlan详情
1. 接口描述
调用 DescribeVlans 接口查询指定地域下已创建的VLAN列表信息。
2. 请求参数
| 名称 | 类型 | 是否必选 | 描述 |
|---|---|---|---|
| Action | String | 是 | 固定取值：DescribeVlans |
| RegionCode | String | 是 | VLAN所在的地域编码 |
| VlanUUID | String | 非必传 | 指定VLAN标识 |
| PageNumber | Integer | 非必传 | 列表页码 |
| PageSize | Integer | 非必传 | 分页查询时返回的每页记录数 |
3. 返回数据
| 名称 | 类型 | 说明 |
|---|---|---|
| VlanList | List< VlanInfo > | VLAN 列表 |
| TotalCount | Long | 总条数 |
| PageSize | Integer | 每页条数 |
| PageNumber | Integer | 页码 |
| RequestId | String | 请求ID |
4. 示例
请求示例
http://ecs.kpy.cloud/?AccessKeyId=5OyWnDx2M4VJ
&Action=DescribeVlans
&Format=JSON
&RegionCode=cn-dev-1
&SignatureMethod=HMAC-SHA1
&SignatureNonce=05621549-56ad-40a9-8b7b-fde70fd14050
&SignatureVersion=1.0
&Timestamp=2025-12-02T09%3A52%3A05Z
&Version=2014-05-26
&Signature=ACitMCFidnc4DW5LoEZa%2BlIqBmQ%3D
正常返回示例
{
"TotalCount": 1,
"RequestId": "cab4e8a0-d183-11f0-a984-22a80d94d6a4",
"PageSize": 10,
"PageNumber": 1,
"VlanList": [
{
"VlanName": "1223",
"Description": "3213",
"RegionCode": "cn-dev-1",
"VpcUUID": "vpc-4h00001bbhx8",
"CreationTime": "2025-12-04 18:43:20",
"VlanPendingStatus": "NONE",
"VlanStatus": "AVAIABLE",
"ZoneCode": "cn-dev-1-a",
"CidrBlock": "10.5.72.0/24",
"VlanUUID": "vnet-4h00001bbhx7"
}
]
}
5. 错误码
| 错误码 | 错误信息 |
|---|---|
| DescribeVlanList_RequiredParamMissing | VLAN列表查询必要参数缺失:RegionCode必须填写 |
| DescribeVlanListFail | 查询Vlan列表详情失败: 可用的地域实体未找到 |