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）
• 约束：不支持设置和更新，由系统自动维护

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

• 功能说明：提供用户设置自定义信息(扩展属性)

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

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地址

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