AI 助理
文档备案控制台
官方文档
首页

ListNetworkInterfaces - 查询灵骏网卡列表

更新时间：
复制 MD 格式
产品详情
我的收藏

查询灵骏网卡列表信息。

调试

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

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

  • 操作：是指具体的权限点。

  • 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。

  • 资源类型：是指操作中支持授权的资源类型。具体说明如下：

    • 对于必选的资源类型，用前面加 * 表示。

    • 对于不支持资源级授权的操作，用全部资源表示。

  • 条件关键字：是指云产品自身定义的条件关键字。

  • 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

eflo:ListNetworkInterfaces

list

*NetworkInterface

acs:eflo:{#regionId}:{#accountId}:NetworkInterface/*

 无 无

请求参数

名称

类型

必填

描述

示例值
RegionId

string

是

地域 ID。

cn-wulanchabu
NetworkInterfaceId

string

否

灵骏网卡 ID。

lni-bp18exxqa2rvfn45e5pz
VpdId

string

否

所属灵骏网段（VPD）实例 ID。

vpd-iv2zm1qf
NodeId

string

否

所属机器 ID。

r-2ze121o4uhr4np3r5t-db-5
SubnetId

string

否

所属灵骏子网（Subnet）实例 ID。

subnet-anhtskts
Ip

string

否

网卡 IP 地址。

203.107.46.227
PageNumber

integer

否

当前页。

1
PageSize

integer

否

当前页数量。

10
EnablePage

boolean

否

是否需要分页。

false
ResourceGroupId

string

否

资源组实例 ID

rg-aek2ojvzk4avjby
Tag

array<object>

否

标签列表。

object

否

标签信息。

Key

string

否

标签键。

k-test
Value

string

否

标签值。

v-test

返回参数

名称

类型

描述

示例值

object

响应实体对象。

Code

integer

响应状态码。

0
Message

string

错误信息。（当实例状态为异常时，提示异常原因）

success
RequestId

string

当次请求的 Request ID。

039C3C3A-3C37-5672-80D5-D8CD48C676D1
Content

object

响应内容。

Total

integer

总记录数。

0
Data

array<object>

返回的数据。

array<object>

灵骏网卡信息。

TenantId

string

租户 ID。

1620939556166279

RegionId

string

地域 ID。

cn-wulanchabu
NetworkInterfaceId

string

灵骏网卡 ID。

lni-2ze50voovmtswn328ogm
NodeId

string

所属机器 ID。

2d53f5c204e7476dae69177e7fa6f19c
VpdBaseInfo

object

灵骏网段（VPD）基本信息。

VpdId

string

灵骏网段（VPD）实例 ID。

vpd-d3isyds4
VpdName

string

灵骏网段（VPD）实例名称。

vpd-1

Cidr

string

灵骏网段（VPD）的网段。

  • 建议您使用 RFC 私网地址作为灵骏网段的网段如 10.0.0.0/8，172.16.0.0/12，192.168.0.0/16，多灵骏网段互通场景或灵骏网段和 VPC 互通场景需确保地址规划不能冲突。

  • 您也可以使用除 100.64.0.0/10、224.0.0.0/4、127.0.0.0/8 或 169.254.0.0/16 及其子网外的自定义地址段作为 VPD 的主 IPv4 网段。 默认值：空。

10.0.0.0/16
CreateTime

string

创建时间。

1668158213000
ZoneId

string

可用区 ID。

cn-wulanchabu-b
SubnetBaseInfo

object

灵骏子网（Subnet）基本信息。

SubnetId

string

灵骏子网（Subnet）实例 ID。

subnet-yjnqn5ef
SubnetName

string

灵骏子网（Subnet）实例名称。

subnet-1
Cidr

string

灵骏子网（Subnet）的网段。

  • 子网的网段必须是其所属灵骏网段的真子集且掩码需在 16 位到 29 位之间，可提供 8 ~ 65536 个地址。 例如，灵骏网段的网段为 192.168.0.0/16，该灵骏网段下的子网的网段为 192.168.0.0/17 ~ 192.168.0.0/29。

  • 每个子网网段的第一个和最后三个 IP 地址为系统保留地址。 例如，子网的网段为 192.168.1.0/24，192.168.1.0、192.168.1.253、192.168.1.254 和 192.168.1.255 这四个 IP 地址为系统保留地址。

关于 CIDR 地址块的详细信息，请参见什么是 CIDR。

默认值：空。

10.0.0.0/24
CreateTime

string

创建时间。

1623656472000
Ip

string

IP 地址。

10.0.0.13
ServiceMac

string

服务网卡地址。

00-ff-84-15-ba-67
PrivateIpAddressMacGroup

array<object>

辅助私网 IP&MAC 地址集合

object

描述信息

IpName

string

IP 唯一标识。

sip-1asjd3xg
PrivateIpAddress

string

辅助私网 IP 地址。

10.0.0.14
IpAddressMac

string

辅助私网 MAC 地址。

00:25:9d:00:20:20
Status

string

实例状态。

Available
Description

string

描述信息

test测试
Message

string

错误信息。（当实例状态为异常时，提示异常原因）

success
Ethernet

array

端口。

string

网卡端口信息。

eth1 eth2
Status

string

状态。

Available
Gateway

string

网关。

10.0.0.253
CreateTime

string

创建时间。

1669734207000
Quota

integer

网卡私有辅助 IP 额度。

6
NcType

string

NC 类型。

枚举值：

  • CUSTOM_LNI_INTEGRATION :

    两网合一架构灵骏托管网卡

  • CPU :

    CPU 机器

  • ELASTIC_6.2 :

    两网合一架构机器

  • GPU :

    GPU 机器

  • DEFAULT :

    旧 CPU 机器

  • CUSTOM_LNI :

    两网分离架构灵骏托管网卡

GPU
NetworkInterfaceName

string

端口名称。

bond0
ResourceGroupId

string

资源组实例 ID

rg-acfm4c7urez5byi
Tags

array<object>

标签列表

object

标签信息。

TagKey

string

标签键

k-test
TagValue

string

标签值

v-test
AccessDeniedDetail

string

权限校验失败详情

None

示例

正常返回示例

JSON格式

{
  "Code": 0,
  "Message": "success",
  "RequestId": "039C3C3A-3C37-5672-80D5-D8CD48C676D1",
  "Content": {
    "Total": 0,
    "Data": [
      {
        "TenantId": "1620939556166279\n",
        "RegionId": "cn-wulanchabu",
        "NetworkInterfaceId": "lni-2ze50voovmtswn328ogm",
        "NodeId": "2d53f5c204e7476dae69177e7fa6f19c",
        "VpdBaseInfo": {
          "VpdId": "vpd-d3isyds4",
          "VpdName": "vpd-1\n",
          "Cidr": "10.0.0.0/16",
          "CreateTime": "1668158213000"
        },
        "ZoneId": "cn-wulanchabu-b",
        "SubnetBaseInfo": {
          "SubnetId": "subnet-yjnqn5ef",
          "SubnetName": "subnet-1",
          "Cidr": "10.0.0.0/24",
          "CreateTime": "1623656472000"
        },
        "Ip": "10.0.0.13",
        "ServiceMac": "00-ff-84-15-ba-67",
        "PrivateIpAddressMacGroup": [
          {
            "IpName": "sip-1asjd3xg",
            "PrivateIpAddress": "10.0.0.14",
            "IpAddressMac": "00:25:9d:00:20:20",
            "Status": "Available",
            "Description": "test测试",
            "Message": "success"
          }
        ],
        "Ethernet": [
          "eth1 eth2"
        ],
        "Status": "Available",
        "Gateway": "10.0.0.253",
        "CreateTime": "1669734207000",
        "Quota": 6,
        "NcType": "GPU",
        "NetworkInterfaceName": "bond0",
        "ResourceGroupId": "rg-acfm4c7urez5byi",
        "Tags": [
          {
            "TagKey": "k-test",
            "TagValue": "v-test"
          }
        ]
      }
    ]
  },
  "AccessDeniedDetail": "None"
}

错误码

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

变更历史

更多信息，参考变更详情。

上一篇：GetNetworkInterface - 查询网卡实例信息下一篇：ListLniPrivateIpAddress - 查询灵骏网卡私网IP列表