ListNetworkInterfaces - 查询灵骏网卡列表

查询灵骏网卡列表信息。

调试

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

授权信息

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

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
eflo:ListNetworkInterfacesget
  • 全部资源
    *

请求参数

名称类型必填描述示例值
RegionIdstring

地域 ID。

cn-wulanchabu
NetworkInterfaceIdstring

灵骏网卡 ID。

lni-bp18exxqa2rvfn45e5pz
VpdIdstring

所属灵骏网段(VPD)实例 ID。

vpd-iv2zm1qf
NodeIdstring

所属机器 ID。

r-2ze121o4uhr4np3r5t-db-5
SubnetIdstring

所属灵骏子网(Subnet)实例 ID。

subnet-anhtskts
Ipstring

网卡 IP 地址。

203.107.46.227
PageNumberinteger

当前页。

1
PageSizeinteger

当前页数量。

10
EnablePageboolean

是否需要分页。

false

返回参数

名称类型描述示例值
object

响应实体对象。

Codeinteger

响应状态码。

0
Messagestring

错误信息。(当实例状态为异常时,提示异常原因)

success
RequestIdstring

当次请求的 Request ID。

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

响应内容。

Totallong

总记录数。

0
Dataarray<object>

返回的数据。

Dataobject

灵骏网卡信息。

TenantIdstring

租户 ID。

1620939556166279
RegionIdstring

地域 ID。

cn-wulanchabu
NetworkInterfaceIdstring

灵骏网卡 ID。

lni-2ze50voovmtswn328ogm
NodeIdstring

所属机器 ID。

2d53f5c204e7476dae69177e7fa6f19c
VpdBaseInfoobject

灵骏网段(VPD)基本信息。

VpdIdstring

灵骏网段(VPD)实例 ID。

vpd-d3isyds4
VpdNamestring

灵骏网段(VPD)实例名称。

vpd-1
Cidrstring

灵骏网段(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
CreateTimestring

创建时间。

1668158213000
ZoneIdstring

可用区 ID。

cn-wulanchabu-b
SubnetBaseInfoobject

灵骏子网(Subnet)基本信息。

SubnetIdstring

灵骏子网(Subnet)实例 ID。

subnet-yjnqn5ef
SubnetNamestring

灵骏子网(Subnet)实例名称。

subnet-1
Cidrstring

灵骏子网(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
CreateTimestring

创建时间。

1623656472000
Ipstring

IP 地址。

10.0.0.13
ServiceMacstring

服务网卡地址。

00-ff-84-15-ba-67
PrivateIpAddressMacGrouparray<object>

辅助私网 IP&MAC 地址集合

PrivateIpAddressMacGroupobject

描述信息

IpNamestring

IP 唯一标识。

sip-1asjd3xg
PrivateIpAddressstring

辅助私网 IP 地址。

10.0.0.14
IpAddressMacstring

辅助私网 MAC 地址。

00:25:9d:00:20:20
Statusstring

实例状态。

Available
Descriptionstring

描述信息

test测试
Messagestring

错误信息。(当实例状态为异常时,提示异常原因)

success
Ethernetarray

端口。

Ethernetstring

网卡端口信息。

eth1 eth2
Statusstring

状态。

Available
Gatewaystring

网关。

10.0.0.253
CreateTimestring

创建时间。

1669734207000
Quotainteger

网卡私有辅助 IP 额度。

6
NcTypestring

NC 类型。

枚举值:
  • CUSTOM_LNI_INTEGRATION两网合一架构灵骏托管网卡
  • CPUCPU机器
  • ELASTIC_6.2两网合一架构机器
  • GPUGPU机器
  • DEFAULTCPU机器
  • CUSTOM_LNI两网分离架构灵骏托管网卡
GPU
NetworkInterfaceNamestring

端口名称。

bond0

示例

正常返回示例

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"
      }
    ]
  }
}

错误码

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