接口说明
本接口用于查看云主机绑定的虚拟网卡列表。
URL
GET https://ecloud.10086.cn/api/openapi-ecs/acl/v3/server/{serverId}/ports
请求参数
Path
|
参数名称
|
类型
|
必填
|
描述
|
|
serverId
|
string
|
是
|
云主机ID，可通过主机列表详情接口获取。 |
Query
|
参数名称
|
类型
|
必填
|
描述
|
|
page
|
integer(int32)
|
否
|
分页页数，起始页为1。 |
|
pageSize
|
integer(int32)
|
否
|
每页显示个数。 |
请求示例
GET https://ecloud.10086.cn/api/openapi-ecs/acl/v3/server/{serverId}/ports返回参数
返回码：200
OK
|
参数名称
|
类型
|
描述
|
|
body
|
PageListResp«api查询网卡列表返回结构体»
|
请求成功时返回的数据。 |
|
content
|
<api查询网卡列表返回结构体> array
|
分页查询返回的具体结构体。 |
|
id
|
string
|
网卡ID。 |
|
name
|
string
|
网卡名称。 |
|
subnetName
|
string
|
子网名称。 |
|
macAddress
|
string
|
mac地址。 |
|
publicIp
|
string
|
公网IP。 |
|
bandwidthSize
|
integer(int32)
|
公网IP的带宽,单位:Mb。 |
|
createdTime
|
string(date-time)
|
创建时间。 |
|
securityGroupResps
|
<安全组信息实体类> array
|
安全组列表。 |
|
id
|
string
|
安全组ID。 |
|
name
|
string
|
安全组名称。 |
|
createdTime
|
string(date-time)
|
安全组创建时间。 |
|
description
|
string
|
安全组描述。 |
|
fixedIpResps
|
<内网IP实体类> array
|
内网IP信息列表。 |
|
ipAddress
|
string
|
内网IP地址。 |
|
ipVersion
|
enum(4,6)
|
IP版本：v4/v6。 |
|
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-***",
"state":"OK",
"body":{
"total":1,
"content":[
{
"id":"7aaa4f07-50b6-422c-a034-***",
"name":"port340",
"subnetName":"slt-c6hn",
"macAddress":"fa:16:3e:84:***",
"publicIp":null,
"bandwidthSize":null,
"createdTime":"2025-04-26 01:07:57",
"securityGroupResps":[
{
"id":"14d2cfbe-ba64-4d6e-b539-***",
"name":"default",
"createdTime":"2024-01-09 17:21:37",
"description":"Default security group"
}
],
"fixedIpResps":[
{
"ipAddress":"192.168.0.1",
"ipVersion":4,
"vpcId":"02d5c4fb-45f0-d135-815f-***",
"vpcName":"vpc_default",
"subnetId":"dee44701-60d7-4b76-bba7-***",
"subnetName":"slt-c6hn",
"subnetCidr":"192.168.***"
},
{
"ipAddress":"2409:8c85:2021:5833:52da:1f33:ac96:***",
"ipVersion":6,
"vpcId":"02d5cdfb-45f0-4135-815f-***",
"vpcName":"vpc_default",
"subnetId":"2d0807c1-6bdd-47a7-b1bd-***",
"subnetName":"slt-c6hn",
"subnetCidr":"2409:8c85:2021:5833***"
}
]
}
]
}
}