调用DescribeNetworks查询network列表。

调试

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

请求参数

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

系统规定参数。取值:DescribeNetworks。

NetworkId String n-****

网络ID。

EnsRegionId String cn-beijing-telecom

ENS节点ID。

NetworkName String example

网络名称。

PageNumber Integer 1

列表的页码,默认值为1。

PageSize Integer 10

分页查询时每页的行数,最大值为50,默认值为10。

返回数据

名称 类型 示例值 描述
Networks Array of Network

返回结果。

Network
CidrBlock String 10.0.XX.XX/24

网络的IPv4网段。

CreatedTime String 2020-06-16T06:33:15Z

创建时间,使用UTC时间格式,格式为yyyy-MM-ddTHH:mm:ssZ。

Description String exampleDescription

网络的描述信息。

EnsRegionId String cn-beijing

ENS节点ID。

NetworkId String n-****

网络ID。

NetworkName String example

网络名称。

Status String Available

网络的状态,取值:Pending:配置中。Available:可用。

VSwitchIds List vsw-bp1nhbnpv2blyz8dl****

网络中交换机的列表。

PageNumber Integer 1

当前查询页码。

PageSize Integer 2

当前查询每页的行数。

RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

请求ID。

TotalCount Integer 3

列表数据总数。

示例

请求示例

https://ens.aliyuncs.com/?Action=DescribeNetworks
&<公共请求参数>

正常返回示例

XML格式

<Networks>
    <Network>
        <Status>Available</Status>
        <NetworkName>example</NetworkName>
        <Description>exampleDescription</Description>
        <CreatedTime>2020-06-16T06:33:15Z</CreatedTime>
        <CidrBlock>10.0.XX.XX/24</CidrBlock>
        <EnsRegionId>cn-beijing</EnsRegionId>
        <NetworkId>n-****</NetworkId>
        <VSwitchIds>
            <VSwitchId>vsw-bp1nhbnpv2blyz8dl****</VSwitchId>
        </VSwitchIds>
    </Network>
</Networks>
<TotalCount>3</TotalCount>
<RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
<PageSize>2</PageSize>
<PageNumber>1</PageNumber>

JSON格式

{
    "Networks": {
        "Network": {
            "Status": "Available",
            "NetworkName": "example",
            "Description": "exampleDescription",
            "CreatedTime": "2020-06-16T06:33:15Z",
            "CidrBlock": "10.0.XX.XX/24",
            "EnsRegionId": "cn-beijing",
            "NetworkId": "n-****",
            "VSwitchIds": {
                "VSwitchId": "vsw-bp1nhbnpv2blyz8dl****"
            }
        }
    },
    "TotalCount": 3,
    "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
    "PageSize": 2,
    "PageNumber": 1
}

错误码

HttpCode 错误码 错误信息 描述
400 NoPermission Permission denied. 没有足够的权限,请联系云账号管理员授予您相应权限。

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