虚拟私有云 VPC-创建端口:请求参数

时间:2024-06-17 19:16:34

请求参数

表2 请求参数

名称

是否必选

参数类型

说明

port

port object

端口对象,请参见表3

表3 port字段说明

名称

是否必选

参数类型

说明

name

String

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

network_id

String

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

网络ID的获取方式:

  • 方法1:登录虚拟私有云服务的控制台界面,单击VPC下的子网,进入子网详情页面,查找网络ID。
  • 方法2:通过虚拟私有云服务的API接口查询,具体操作可参考查询子网列表

admin_state_up

Boolean

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

device_owner

String

  • 功能说明:端口设备所属。
  • 取值范围:目前只支持指定""和"neutron:VIP_PORT",neutron:VIP_PORT表示创建的是VIP。

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,且不支持更新。

tenant_id

String

项目ID。

security_groups

Array of strings

安全组的UUID,例如:"security_groups": ["a0608cbf-d047-4f54-8b28-cd7b59853fff"](扩展属性)。

allowed_address_pairs

Array of allowed_address_pairs objects

  • 功能说明:IP/Mac对列表,allowed_address_pair参见表5(扩展属性)。
  • 约束:IP地址不允许为 “0.0.0.0/0”。
  • 如果allowed_address_pairs配置地址池较大的CIDR(掩码小于24位),建议为该port配置一个单独的安全组。
  • 如果allowed_address_pairs的IP地址为“1.1.1.1/0”,表示关闭源目地址检查开关。
  • 如果虚拟IP绑定云服务器资源,
    • 则mac_address可为空或者填写被绑定云服务器网卡的Mac地址。
    • 被绑定的云服务器网卡allowed_address_pairs的IP地址填“1.1.1.1/0”。

extra_dhcp_opts

Array of extra_dhcp_opt objects

DHCP的扩展Option(扩展属性),请参见表6

表4 fixed_ip对象

名称

是否必选

参数类型

说明

subnet_id

String

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

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

  • 约束:不支持更新。

ip_address

String

  • 功能说明:端口IP地址。
  • 约束:不支持更新。
表5 allowed_address_pairs对象

名称

是否必选

参数类型

说明

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

表6 extra_dhcp_opt对象

名称

是否必选

参数类型

说明

opt_name

String

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

opt_value

String

  • 功能说明:DHCP选项的值。
  • 当“opt_name”为“51”时,参数格式为“Xh”,表示DHCP租约时间为X小时。
  • “X”的取值范围为1~30000或“-1”,“-1”表示DHCP租约时间无限长。
support.huaweicloud.com/api-vpc/vpc_port01_0006.html