更新时间:2026-01-09 GMT+08:00

查询租户下辅助弹性网卡详情

功能介绍

当您的辅助弹性网卡创建成功后,您可以通过该接口查询单个辅助弹性网卡的详细信息,包括辅助弹性网卡的IP地址、VLAN ID等。

调用方法

请参见如何调用API

URI

GET /v3/{project_id}/vpc/sub-network-interfaces/{sub_network_interface_id}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释

辅助弹性网卡所属的项目ID。

取值范围

不涉及。

sub_network_interface_id

String

参数解释

辅助弹性网卡的资源ID。

取值范围

不涉及。

请求参数

响应参数

状态码:200

表2 响应Body参数

参数

参数类型

描述

request_id

String

参数解释

请求ID。

取值范围

不涉及。

sub_network_interface

SubNetworkInterface object

参数解释

查询辅助弹性网卡详情的响应体。

取值范围

不涉及。

表3 SubNetworkInterface

参数

参数类型

描述

id

String

参数解释

辅助弹性网卡的资源ID。辅助弹性网卡创建成功后,会生成一个辅助弹性网卡 ID,是辅助弹性网卡对应的唯一标识。

取值范围

带“-”的标准UUID格式。

virsubnet_id

String

参数解释

辅助弹性网卡所在的虚拟子网ID。

取值范围

带“-”的标准UUID格式。

private_ip_address

String

参数解释

辅助弹性网卡的私有IPv4地址。

取值范围

不涉及。

ipv6_ip_address

String

参数解释

辅助弹性网卡的私有IPv6地址。

取值范围

不涉及。

mac_address

String

参数解释

辅助弹性网卡的MAC地址。

取值范围

合法的MAC地址,系统随机分配。

parent_device_id

String

参数解释

辅助弹性网卡的宿主网卡所属的设备ID。

取值范围

带“-”的标准UUID格式。

parent_id

String

参数解释

辅助弹性网卡所挂载的弹性网卡的ID。

取值范围

带“-”的标准UUID格式。

description

String

参数解释

辅助弹性网卡的描述信息。

取值范围

0-255个字符,不能包含“<”和“>”。

vpc_id

String

参数解释

辅助弹性网卡所属VPC的ID。

取值范围

带“-”的标准UUID格式。

vlan_id

Integer

参数解释

辅助弹性网卡的VLAN ID。

取值范围

1-4094

security_groups

Array of strings

参数解释

辅助弹性网卡关联的安全组的ID列表。例如:"security_groups": ["a0608cbf-d047-4f54-8b28-cd7b59853fff"]。

取值范围

如果请求时不指定此参数,辅助弹性网卡创建后会自动关联默认安全组。

tags

Array of ResponseTag objects

参数解释

辅助弹性网卡的标签信息,包括标签键和标签值,可用来分类和标识资源。详情请参见Tag对象。

取值范围

不涉及。

project_id

String

参数解释

辅助弹性网卡所属的项目ID。

取值范围

不涉及。

created_at

String

参数解释

辅助弹性网卡的创建时间。

取值范围

UTC时间格式,yyyy-MM-ddTHH:mm:ssZ。

allowed_address_pairs

Array of AllowedAddressPair objects

参数解释

辅助弹性网卡的IP/Mac对列表,详情请参见“AllowedAddressPair”对象表。

取值范围

不涉及。

state

String

参数解释

辅助弹性网卡的状态。

取值范围

  • NORMAL:表示辅助弹性网卡已挂载在弹性网卡上。

  • UNBOUND:表示辅助弹性网卡未挂载在弹性网卡上。

instance_id

String

参数解释

辅助弹性网卡所属的云服务实例ID,例如RDS实例ID。

取值范围

不涉及。

instance_type

String

参数解释

辅助弹性网卡所属的云服务实例类型,例如“RDS”。

取值范围

不涉及。

scope

String

参数解释

辅助弹性网卡所在站点的公网出口信息。

取值范围

  • center:默认值,表示作用域为中心。

  • 某个AZ ID:表示作用域为具体的AZ。

security_enabled

Boolean

参数解释

辅助弹性网卡安全使能标记,如果不使能则安全组不生效。

取值范围

不涉及。

表4 ResponseTag

参数

参数类型

描述

key

String

参数解释

标签键。

取值范围

  • 最大长度128个unicode字符, key不能为空。

  • 同一资源的key不能重复。

  • 可以包含的字符范围:

    • 英文字母

    • 数字

    • 特殊字符:下划线(_)、点(.)、冒号(:)、加号(+)、中划线(-)、等号(=)

value

String

参数解释

标签值。

取值范围

  • 每个值最大长度255个unicode字符,value可以为空。

  • 可以包含的字符范围:

    • 英文字母

    • 数字

    • 特殊字符:下划线(_)、冒号(:)、加号(+)、中划线(-)、等号(=)

表5 AllowedAddressPair

参数

参数类型

描述

ip_address

String

参数解释

IP地址。

约束限制

如果allowed_address_pairs配置地址池较大的IP网段(掩码小于24位),建议为该网卡配置一个单独的安全组。

取值范围

单个IP地址:例如192.168.21.25。

IP网段:例如192.168.21.0/24。

默认取值

不涉及。

mac_address

String

参数解释

MAC地址。

约束限制

不涉及。

取值范围

不涉及。

默认取值

不涉及。

请求示例

查询id为2be868f2-f7c9-48db-abc0-eea0b9105b0的辅助弹性网卡详情。

GET https://{Endpoint}/v3/8c6fb137a48a428aaf9a0229dca4edb3/vpc/sub-network-interfaces/2be868f2-f7c9-48db-abc0-eea0b9105b0d

响应示例

状态码:200

GET操作正常返回,更多状态码请参见状态码

{
  "sub_network_interface" : {
    "id" : "2be868f2-f7c9-48db-abc0-eea0b9105b0d",
    "project_id" : "8c6fb137a48a428aaf9a0229dca4edb3",
    "virsubnet_id" : "3c15c3b0-0df4-4115-9c18-e67a8a0d7702",
    "private_ip_address" : "192.168.0.160",
    "ipv6_ip_address" : null,
    "mac_address" : "fa:16:3e:26:7e:1e",
    "parent_device_id" : "285b2e45-2968-4f4c-8992-54e0d4c8da1d",
    "security_enabled" : false,
    "security_groups" : [ ],
    "allowed_address_pairs" : [ ],
    "vpc_id" : "c10e1e02-9db2-4bd0-89ef-52536952627e",
    "instance_id" : "",
    "instance_type" : "",
    "description" : "",
    "parent_id" : "00336617-4552-48c5-9856-f539f4e9aca2",
    "vlan_id" : 3413,
    "state" : null,
    "tags" : [ ],
    "scope" : "center",
    "created_at" : "2025-02-10T08:21:16Z"
  },
  "request_id" : "16fe2bcb91bd7ad03a895adbc63bf44e"
}

状态码

状态码

描述

200

GET操作正常返回,更多状态码请参见状态码

错误码

请参见错误码