虚拟私有云 VPC-创建端口:请求参数
请求参数
表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 |
|
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 |
|
ip_address |
否 |
String |
|
表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