查询租户下辅助弹性网卡列表

project_id

是

String

项目ID。

获取方式请参见获取项目ID。

limit

否

Integer

• 功能说明：每页返回的个数。

• 取值范围：0-2000。

marker

否

String

分页查询起始的资源ID，为空时查询第一页。

id

否

Array of strings

• 功能说明：辅助弹性网卡ID，支持多ID过滤。

• 使用场景：查询需要的多个辅助弹性网卡信息。

description

否

Array of strings

• 功能说明：辅助弹性网卡的描述信息，支持多个同时过滤。

• 使用场景：通过描述信息过滤辅助弹性网卡。

vpc_id

否

Array of strings

• 功能说明：辅助弹性网卡所属的VPC_ID，支持多ID过滤。

• 使用场景：过滤单个或多个VPC下的辅助弹性网卡信息。

virsubnet_id

否

Array of strings

• 功能说明：辅助弹性网卡所属虚拟子网的ID，支持多个ID过滤。

• 使用场景：过滤需要的单个或者多个虚拟子网下的辅助弹性网卡。

parent_id

否

Array of strings

• 功能说明：辅助弹性网卡的宿主网卡的ID，支持多ID过滤。

• 使用场景：过滤单个或多个宿主网卡下存在的辅助弹性网卡。

private_ip_address

否

Array of strings

• 功能说明：辅助弹性网卡的私有IPv4地址，支持多个地址同时过滤。

• 使用场景：通过单个或者多个ip地址过滤查询辅助弹性网卡。

mac_address

否

Array of strings

• 功能说明：辅助弹性网卡的mac地址，支持多个同时过滤。

• 使用场景：使用mac地址精确过滤辅助弹性网卡。

enable_eip

否

Boolean

• 功能说明：按照“是否关联EIP”过滤查询。

scope

否

String

• 功能说明：按照publicBorderGroup过滤查询。

security_groups

否

String

• 功能说明：辅助弹性网卡绑定的安全组id，支持多个id同时过滤。

parent_device_id

否

String

• 功能说明：辅助弹性网卡绑定的设备id，支持多个id同时过滤。

vlan_id

否

Integer

• 功能说明：辅助弹性网卡的VLAN ID，支持多个id同时过滤。

• 取值范围：1-4094。

state

否

String

• 功能说明：辅助弹性网卡当前状态, 支持多个同时过滤。

• 取值范围：NORMAL, UNBOUND。

ipv6_ip_address

否

String

• 功能说明：功能说明：辅助弹性网卡的IPv6地址，支持多个同时过滤。

project_id

否

String

• 功能说明：辅助弹性网卡所属项目ID，支持多个id同时过滤。

instance_id

否

String

• 功能说明: 辅助弹性网卡所属实例ID，例如RDS实例ID, 支持多个id同时过滤。

instacne_type

否

String

• 功能说明：辅助弹性网卡所属实例类型，例如“RDS”, 支持多个同时过滤。

request_id

String

• 功能说明：请求ID。

• 取值范围：标准UUID。

sub_network_interfaces

Array of SubNetworkInterface objects

辅助弹性网卡查询对象。

page_info

PageInfo object

分页信息。

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

• 功能说明：辅助弹性网卡安全使能标记，如果不使能则安全组不生效。

key

String

• 功能说明：标签键。

• 约束：同一资源的key值不能重复。

• 取值范围：1-128个字符。

最小长度：1

最大长度：128

value

String

• 功能说明：标签值。

• 取值范围：0-255个字符。

最大长度：255

ip_address

String

• 功能说明：

  • 如果allowed_address_pairs配置地址池较大的CIDR（掩码小于24位），建议为该port配置一个单独的安全组。

mac_address

String

• 功能说明：MAC地址。

previous_marker

String

当前页第一条记录。

current_count

Integer

当前页总数。

next_marker

String

当前页最后一条记录，最后一页时无next_marker字段。

200

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