本文导读

功能介绍
调试
URI
请求参数
响应参数
请求示例
响应示例
状态码
错误码

展开导读

文档首页/ 虚拟私有云 VPC/ API参考/ API V3/ 辅助弹性网卡/ 查询租户下辅助弹性网卡详情

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

更新时间：2025-07-22 GMT+08:00

查看PDF

功能介绍

查询辅助弹性网卡详情。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。

URI

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

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	项目ID。获取方式请参见获取项目ID。
sub_network_interface_id	是	String	辅助弹性网卡的唯一标识。

请求参数

无

响应参数

状态码：200

表2 响应Body参数
参数	参数类型	描述
request_id	String	请求ID。
sub_network_interface	SubNetworkInterface object	辅助弹性网卡响应体。

表3 SubNetworkInterface
参数	参数类型	描述
id	String	功能说明：辅助弹性网卡的唯一标识。取值范围：带(-)的标准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 ResourceTag objects	功能说明：辅助弹性网卡的标签列表。
project_id	String	功能说明：辅助弹性网卡所属项目ID。
created_at	String	功能说明：辅助弹性网卡的创建时间。取值范围：UTC时间格式，yyyy-MM-ddTHH:mm:ssZ。
allowed_address_pairs	Array of AllowAddressPair objects	扩展属性：IP/Mac对列表，allow_address_pair参见“allow_address_pair对象”表。使用说明：如果allowed_address_pairs配置地址池较大的CIDR（掩码小于24位），建议为该port配置一个单独的安全组。硬件SDN环境不支持ip_address属性配置为CIDR格式。
state	String	功能说明：辅助弹性网卡当前状态。取值范围：NORMAL, UNBOUND。
instance_id	String	功能说明：辅助弹性网卡所属实例ID，例如RDS实例ID。
instance_type	String	功能说明：辅助弹性网卡所属实例类型，例如“RDS”。
scope	String	功能说明：辅助弹性网卡所在站点的公网出口信息。取值范围：center-表示作用域为中心；{azId}表示作用域为具体的AZ。
security_enabled	Boolean	功能说明：辅助弹性网卡安全使能标记，如果不使能则安全组不生效。

表4 ResourceTag
参数	参数类型	描述
key	String	功能说明：标签键。约束：同一资源的key值不能重复。取值范围：1-128个字符。最小长度：1 最大长度：128
value	String	功能说明：标签值。取值范围：0-255个字符。最大长度：255

表5 AllowAddressPair
参数	参数类型	描述
ip_address	String	功能说明：如果allowed_address_pairs配置地址池较大的CIDR（掩码小于24位），建议为该port配置一个单独的安全组。
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" : "4c2b455a-4c75-4c4d-bada-727be4d0f7b5",
    "project_id" : "6b32266bded64091a138e9ec19cff361",
    "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操作正常返回，更多状态码请参见状态码。

错误码

请参见错误码。

父主题：辅助弹性网卡

上一篇：查询租户下辅助弹性网卡列表

下一篇：查询租户下辅助弹性网卡数目

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！您可在我的云声建议查看反馈及问题处理状态。

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消

如您有其它疑问，您也可以通过华为云社区问答频道来与我们联系探讨

盘古Doer提问云社区提问