查询端口-九游平台

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功能不生效。

• 仅对于“华北-北京二”区域：udp_srvports和tcp_srvports，字段，字符串类型，默认不设置udp_srvports和tcp_srvports字段。允许指定udp_srvports和tcp_srvports字段为端口号，表示这些端口的tcp报文和udp报文可支持高并发连接，但是此类报文不受acl和安全组规则的限制。udp_srvports和tcp_srvports字段同时支持更新操作。
  • 格式：

    {"tcp_srvports": "port1 port2 port3", "udp_srvports": "port1 port2 port3"}

    端口号之间以空格间隔，最多允许指定的端口号总共为15个，端口号范围是1到65535。

  • 示例：

    {"tcp_srvports": "80 443", "udp_srvports": "53"}

    示例表示入方向目的端口为80或者443的tcp报文可支持高并发连接。入方向目的端口为53的udp报文可支持高并发连接。但是此类报文不受acl和安全组规则的限制。

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。