接口说明
本接口用于查看实例绑定的虚拟网卡列表。
URL
GET https://ecloud.10086.cn/api/openapi-instance/v4/virtual-networks
请求参数
Query
|
参数名称
|
类型
|
必填
|
描述
|
|
instanceId
|
string
|
是
|
实例ID，可通过查询实例状态列表接口获取。 |
|
page
|
integer(int32)
|
否
|
分页页数，起始页为1。 |
|
pageSize
|
integer(int32)
|
否
|
每页显示个数。 |
请求示例
GET https://ecloud.10086.cn/api/openapi-instance/v4/virtual-networks返回参数
返回码：200
OK
|
参数名称
|
类型
|
描述
|
|
body
|
PageListResp«PortListApiResponse»
|
请求成功时返回的数据。 |
|
content
|
<PortListApiResponse> array
|
分页查询返回的具体结构体。 |
|
id
|
string
|
网卡ID。 |
|
name
|
string
|
网卡名称。 |
|
subnetName
|
string
|
子网名称。 |
|
macAddress
|
string
|
mac地址。 |
|
publicIp
|
string
|
公网IP。 |
|
bandwidthSize
|
integer(int32)
|
公网IP的带宽，单位：Mb。 |
|
createdTime
|
string(date-time)
|
创建时间。 |
|
securityGroupResps
|
<SecurityGroupResp> array
|
安全组列表。 |
|
id
|
string
|
安全组ID。 |
|
name
|
string
|
安全组名称。 |
|
createdTime
|
string(date-time)
|
安全组创建时间。 |
|
description
|
string
|
安全组描述。 |
|
fixedIpResps
|
<PortFixedIpResp> array
|
内网IP信息列表。 |
|
ipAddress
|
string
|
内网IP地址。 |
|
ipVersion
|
enum(4,6)
|
IP版本。 |
|
vpcId
|
string
|
VPC的ID。 |
|
vpcName
|
string
|
VPC名称。 |
|
subnetId
|
string
|
子网ID。 |
|
subnetName
|
string
|
子网名称。 |
|
subnetCidr
|
string
|
子网CIDR网段。 |
|
total
|
integer
|
满足查询条件的总个数。 |
|
errorCode
|
string
|
统一错误码。 |
|
errorMessage
|
string
|
页面国际化错误提示。 |
|
errorParams
|
<string> array
|
统一错误码的自定义参数。 |
|
requestId
|
string
|
每个请求的序列号。 |
|
state
|
enum(OK,ERROR,EXCEPTION,ALARM,FORBIDDEN)
|
返回状态码。返回正常：OK，返回错误：ERROR，返回异常：EXCEPTION，需要告警实现的：ALARM，禁止访问：FORBIDDEN。 |
返回示例
返回码：200
OK
{
"requestId":"reqId-b8bc4f1bc41c485a94812861e007dc8e",
"state":"OK",
"body":{
"total":1,
"content":[
{
"id":"0d8157c3-28d8-492d-bcf1-fa7961b2676c",
"name":"port734155",
"subnetName":"VPC_test215",
"macAddress":"fa:16:3e:a1:65:fc",
"publicIp":null,
"bandwidthSize":null,
"createdTime":"2025-09-03 05:19:35",
"securityGroupResps":[
{
"id":"c129faac-4457-4248-b236-f4e813764378",
"name":"default",
"createdTime":"2024-07-08 18:59:22",
"description":"Default security group"
}
],
"fixedIpResps":[
{
"ipAddress":"192.168.12.135",
"ipVersion":4,
"vpcId":"d7e5d522-88fe-44bd-9cb7-fc01cff24751",
"vpcName":"VPC_EAS-test215",
"subnetId":"da917a00-2afb-46fa-a97d-ceb6132f51ba",
"subnetName":"VPC_test215",
"subnetCidr":"192.168.12.0/24"
}
]
}
]
}
}