查询端口

port

port object

端口对象，请参见表3。

id

String

端口唯一标识。

name

String

• 功能说明：端口名称。
• 取值：默认为空，最大长度不超过255。

network_id

String

• 功能说明：端口所属网络的ID。
• 约束：必须是存在的网络ID。

admin_state_up

Boolean

• 功能说明：管理状态。
• 约束：默认为true。

mac_address

String

• 功能说明：端口MAC地址。
• 约束：由系统分配，不支持指定。

fixed_ips

Array of fixed_ip objects

• 功能说明：端口IP。例如："fixed_ips": [{"subnet_id": "4dc70db6-cb7f-4200-9790-a6a910776bba", "ip_address": "192.169.25.79"}]，请参见表4 fixed_ip对象。
• 约束：ipv4场景下，一个端口只支持一个fixed_ip，且不支持更新。ipv6场景下，一个端口最多可以支持两个fixed_ip，且不支持更新。

device_id

String

• 功能说明：端口所属设备ID。
• 约束：不支持设置和更新，由系统自动维护。

device_owner

String

• 功能说明：设备所属（DHCP/Router/ lb/Nova）。
• 取值范围：network:dhcp，network:router_interface_distributed，compute:xxx(xxx对应具体的可用区名称，例如compute:aa-bb-cc表示是被可用区aa-bb-cc上的ECS使用)，neutron:VIP_PORT，neutron:LOADBALANCERV2，neutron:LOADBALANCERV3，network:endpoint_interface，network:nat_gateway，network:ucmp。
• 使用说明：不支持更新，只允许用户在创建虚拟IP端口时，为虚拟IP端口设置device_owner为neutron:VIP_PORT，当端口的该字段不为空时，仅支持该字段为neutron:VIP_PORT时的端口删除。

tenant_id

String

项目ID。

status

String

• 功能说明：端口状态，Hana硬直通虚拟机端口状态总为DOWN。
• 取值范围：ACTIVE、BUILD、DOWN。

如果allowed_address_pairs回显值为云服务器网卡IP地址，表示虚拟IP的端口处于绑定状态。

security_groups

Array of strings

安全组的UUID(扩展属性)。

allowed_address_pairs

Array of allowed_address_pairs objects

• 功能说明：IP/Mac对列表。请参见表5 allow_address_pair对象。
• 约束：IP地址不允许为 “0.0.0.0/0”。
• 如果allowed_address_pairs配置地址池较大的CIDR（掩码小于24位），建议为该port配置一个单独的安全组。
• 如果allowed_address_pairs的IP地址为“1.1.1.1/0”，表示关闭源目的地址检查开关。
• 被绑定的云服务器网卡allowed_address_pairs的IP地址填“1.1.1.1/0”。

extra_dhcp_opts

Array of extra_dhcp_opt objects

DHCP的扩展Option(扩展属性)，请参见表6 extra_dhcp_opt对象。

binding:vif_details

binding:vif_details object

vif的详细信息，参见表7。

binding:profile

Object

扩展属性：提供用户设置自定义信息。

【使用说明】

• internal_elb字段，布尔类型，普通租户可见。只有在创建内网ELB的虚拟IP的网卡时设置为true。普通租户没有权限更改该字段，由系统维护。

  举例：

  {"internal_elb": true}

• disable_security_groups字段，布尔类型，普通租户可见。默认为false高性能通信场景下，允许指定为true普通租户可见。仅支持创建port和读取时指定。当前仅支持指定为true，不支持指定为false。

  举例：

  {"disable_security_groups"：true }，

  当前仅支持指定为true，不支持指定为false，指定为true时，FWaaS功能不生效。

binding:vnic_type

String

• 功能说明：绑定的vNIC类型。
• 取值范围：normal或者direct。
• normal: 软交换direct: SRIOV硬直通（不支持）。

dns_assignment

Array of dns_assignment objects

• 功能说明：主网卡默认内网域名信息。
• 约束：不支持设置和更新，由系统自动维护。

dns_name

String

• 功能说明：主网卡默认内网DNS名称。
• 约束：不支持设置和更新，由系统自动维护。

instance_id

String

• 功能说明：端口所属实例ID，例如RDS实例ID。
• 约束：不支持设置和更新，由系统自动维护。

instance_type

String

• 功能说明：端口所属实例类型，例如“RDS”。
• 约束：不支持设置和更新，由系统自动维护。

port_security_enabled

Boolean

• 功能说明：端口安全使能标记，如果不使能则安全组和dhcp防欺骗不生效。

zone_id

String

端口所属的可用分区。

enable_efi

Boolean

• 功能说明：是否使能efi，使能则表示端口支持vRoCE能力，默认为false。

ipv6_bandwidth_id

String

• 功能说明：IPv6网卡绑定的共享带宽ID。
• 约束：只有IPv6网卡绑定了共享带宽，才会显示此参数。

subnet_id

String

• 功能说明：所属子网ID。

  如果您使用管理控制台，此值即为子网详情中的“IPv4子网ID”或“IPv6子网ID”参数值。

• 约束：不支持更新。

ip_address

String

端口IP地址。

ip_address

String

• 功能说明：IP地址。
• 约束：不支持0.0.0.0/0。
• 如果allowed_address_pairs配置地址池较大的CIDR（掩码小于24位），建议为该port配置一个单独的安全组。
• 如果allowed_address_pairs的IP地址为“1.1.1.1/0”，表示关闭源目的地址检查开关。
• 被绑定的云服务器网卡allowed_address_pairs的IP地址填“1.1.1.1/0”。

mac_address

String

MAC地址。默认使用本端口的MAC地址。

opt_name

String

DHCP选项名称，目前仅支持填写“51”，表示DHCP租约时间。

opt_value

String

• 功能说明：DHCP选项的值。
• 当“opt_name”为“51”时，参数格式为“Xh”，表示DHCP租约时间为X小时。
• “X”的取值范围为1~30000或“-1”，“-1”表示DHCP租约时间无限长。

primary_interface

Boolean

取值为true，表示是虚拟机的主网卡。

port_filter

Boolean

表示该网络服务提供端口过滤特性，如安全组和反MAC/IP欺骗。

ovs_hybrid_plug

Boolean

用于通知像nova这样的API消费者，应该使用OVS的混合插入策略。

hostname

String

端口hostname。

ip_address

String

端口IP地址。

fqdn

String

端口内网fqdn。