创建端口（废弃）

功能介绍

创建端口。

URI

POST /v1/ports

请求消息

请求参数

表1 请求参数
名称	是否必选	参数类型	说明
port	是	port object	端口对象，请参见表2。

表2 port字段说明
名称	是否必选	参数类型	说明
name	否	String	功能说明：端口名称取值：默认为空，最大长度不超过255
network_id	是	String	功能说明：端口所属网络的ID 约束：必须是存在的网络ID
admin_state_up	否	Boolean	功能说明：管理状态约束：只支持true，默认为true
fixed_ips	否	Array of fixed_ip objects	功能说明：端口IP。请参见表3。例如："fixed_ips": [{"subnet_id": "4dc70db6-cb7f-4200-9790-a6a910776bba", "ip_address": "192.169.25.79"}] 约束：一个端口只支持一个fixed_ip，且不支持更新。
tenant_id	否	String	项目ID。
security_groups	否	Array of strings	安全组的UUID，例如："security_groups": ["a0608cbf-d047-4f54-8b28-cd7b59853fff"](扩展属性)
allowed_address_pairs	否	Array of allow_address_pair objects	功能说明：IP/Mac对列表，allow_address_pair参见表4(扩展属性) 约束：IP地址不允许为 “0.0.0.0” 如果allowed_address_pairs配置地址池较大的CIDR（掩码小于24位），建议为该port配置一个单独的安全组如果allowed_address_pairs为“1.1.1.1/0”，表示关闭源目的地址检查开关
extra_dhcp_opts	否	Array of extra_dhcp_opt objects	DHCP的扩展Option(扩展属性)
port_security_enabled	否	Boolean	端口安全使能标记，如果不使能则安全组和dhcp防欺骗不生效，默认为true

表3 fixed_ip对象
名称	是否必选	参数类型	说明
subnet_id	否	String	功能说明：所属子网ID 约束：不支持更新
ip_address	否	String	功能说明：端口IP地址约束：不支持更新

表4 allow_address_pair对象
名称	是否必选	参数类型	说明
ip_address	否	String	功能说明：IP地址约束：不支持0.0.0.0 如果allowed_address_pairs配置地址池较大的CIDR（掩码小于24位），建议为该port配置一个单独的安全组如果allowed_address_pairs为“1.1.1.1/0”，表示关闭源目的地址检查开关
mac_address	否	String	MAC地址

表5 extra_dhcp_opt对象
名称	是否必选	参数类型	说明
opt_name	否	String	Option名称
opt_value	否	String	Option值

请求样例

POST https://{Endpoint}/v1/ports

{
    "port": {
        "fixed_ips": [
            {
                "ip_address": "192.168.0.38",
                "subnet_id": "06bc2359-d75e-4f96-82f4-313e39c7148c"
            }
        ],
        "network_id": "28a1c93c-9a5e-4a9f-813b-e495bdef7d34",
        "security_groups": [
            "f2c5b3fc-b971-4a86-87b9-032586260e3e"
        ]
    }
}

响应消息

响应参数

表6 响应参数
名称	参数类型	说明
port	port object	端口对象，请参见表7。

表7 port字段说明
名称	参数类型	说明
id	String	端口唯一标识
name	String	功能说明：端口名称取值：默认为空，最大长度不超过255
network_id	String	功能说明：端口所属网络的ID 约束：必须是存在的网络ID
admin_state_up	Boolean	功能说明：管理状态约束：只支持true，默认为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"}] 约束：一个端口只支持一个fixed_ip，且不支持更新。
device_id	String	功能说明：端口所属设备ID 约束：不支持设置和更新，由系统自动维护
device_owner	String	功能说明：设备所属（DHCP/Router/ lb/Nova）约束：不支持设置和更新，由系统自动维护
tenant_id	String	项目ID。
status	String	功能说明：端口状态，Hana硬直通虚拟机端口状态总为DOWN 取值范围：ACTIVE、BUILD、DOWN
security_groups	Array of strings	安全组的UUID(扩展属性)
allowed_address_pairs	Array of allow_address_pairobjects	功能说明：IP/Mac对列表，allow_address_pair参见表9（扩展属性）。约束：IP地址不允许为 “0.0.0.0” 如果allowed_address_pairs配置地址池较大的CIDR（掩码小于24位），建议为该port配置一个单独的安全组如果allowed_address_pairs为“1.1.1.1/0”，表示关闭源目的地址检查开关
extra_dhcp_opts	Array of extra_dhcp_opt objects	DHCP的扩展Option(扩展属性)，请参见表10
binding:vif_details	Object	vif的详细信息， "ovs_hybrid_plug": 是否为ovs/bridge混合模式
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功能不生效。
binding:vnic_type	String	功能说明：绑定的vNIC类型取值范围：normal或者direct。normal: 软交换，direct: SRIOV硬直通（不支持）
port_security_enabled	Boolean	端口安全使能标记，如果不使能则安全组和dhcp防欺骗不生效，默认为true

表8 fixed_ip对象
名称	参数类型	说明
subnet_id	String	功能说明：所属子网ID 约束：不支持更新
ip_address	String	端口IP地址

表9 allow_address_pair对象
名称	参数类型	说明
ip_address	String	功能说明：IP地址约束：不支持0.0.0.0 如果allowed_address_pairs配置地址池较大的CIDR（掩码小于24位），建议为该port配置一个单独的安全组。
mac_address	String	MAC地址

**表10** extra_dhcp_opt对象
名称	参数类型	说明
opt_name	String	Option名称
opt_value	String	Option值

响应样例

{
    "port": {
        "id": "d00f9c13-412f-4855-8af3-de5d8c24cd60",
        "name": "test",
        "status": "DOWN",
        "admin_state_up": "true",
        "fixed_ips": [
            {
                "subnet_id": "70f2e74b-e660-410a-b754-0ca46744348a",
                "ip_address": "10.128.1.10"
            }
        ],
        "mac_address": "fa:16:3e:d7:f2:6c",
        "network_id": "5b808927-13c9-4e60-a4f4-ed6ffe225167",
        "tenant_id": "43f2d1cca56a40729dcb17212482f34d",
        "device_id": "",
        "device_owner": "",
        "security_groups": [
            "02b4e8ee-74fa-4a31-802e-5490df11245e"
        ],
        "extra_dhcp_opts": [],
        "allowed_address_pairs": [],
        "binding:vnic_type": "normal",
        "binding:vif_details": {},
        "binding:profile": {},
        "port_security_enabled":true
    }
}

状态码

请参见状态码。

错误码

请参考错误码。

父主题： 端口（废弃）

上一篇：端口（废弃）

下一篇：查询端口（废弃）

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消