更新端口 - UpdatePort

port

是

port object

端口对象，请参见表2。

更新操作时至少指定一项属性。

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”。
• 如果填写allowed_address_pairs参数，则ip_address是必选参数。

mac_address

否

String

MAC地址。默认使用当前端口的MAC地址。

opt_name

否

String

DHCP选项名称，目前仅支持填写“51”，表示IPv4网卡DHCP租约时间；填写“651”，表示IPv6网卡DHCP租约时间。

opt_value

否

String

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

port

port object

端口对象，请参见表6。

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，请参见表7。例如："fixed_ips": [{"subnet_id": "4dc70db6-cb7f-4200-9790-a6a910776bba", "ip_address": "192.169.25.79"}]。
• 约束：ipv4场景下，一个端口只支持一个fixed_ip，且不支持更新。ipv6场景下，一个端口最多可以支持两个fixed_ip，且不支持更新。

device_id

String

• 功能说明：端口所属设备ID，表示使用子网内私有IP地址的云服务资源ID，比如云服务器的ID、ELB的ID。

device_owner

String

• 功能说明：端口所属的设备，表示使用子网内私有IP地址的云服务资源。
• 取值范围：
  • network:dhcp表示DHCP服务
  • network:router_interface_distributed表示子网网关地址
  • compute:xxx表示云服务器网卡私有IP地址，其中XXX对应具体的可用区名称，例如compute:aa-bb-cc表示私有IP地址被可用区aa-bb-cc内的云服务器使用
  • neutron:VIP_PORT表示虚拟IP地址
  • neutron:LOADBALANCERV2表示共享型ELB
  • neutron:LOADBALANCERV3表示独享型ELB
  • network:endpoint_interface表示VPC终端节点
  • network:nat_gateway表示NAT网关
  • network:ucmp表示UCMP端口，为企业路由器服务所用

tenant_id

String

项目ID。

status

String

• 功能说明：端口状态，Hana硬直通虚拟机端口状态总为DOWN。
• 取值范围：
  • ACTIVE：端口处于活动状态，可以正常进行网络通信。
  • BUILD：端口正在创建或配置中。
  • DOWN：端口处于非活动状态，不能进行网络通信。Hana 硬直通虚拟机端口状态总为DOWN。

security_groups

Array of strings

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

allowed_address_pairs

Array of allowed_address_pairs objects

• 功能说明：IP/Mac对列表，请参见表8。
• 约束：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地址，表示虚拟IP的端口处于绑定状态。
• 被绑定的云服务器网卡allowed_address_pairs的IP地址填“1.1.1.1/0”。

extra_dhcp_opts

Array of extra_dhcp_opt objects

DHCP的扩展Option(扩展属性)，请参见表9。

binding:vif_details

binding:vif_details object

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

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，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”，表示IPv4网卡DHCP租约时间；填写“651”，表示IPv6网卡DHCP租约时间。

opt_value

String

• 功能说明：DHCP选项的值。
• 当“opt_name”为“51”或“651”时，参数格式为“Xh”，表示DHCP租约时间为X小时。
• “X”的取值范围为1~175200或“-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。