文档首页/ 智能边缘云 IEC/ API参考/ API/ 端口/ 创建端口
更新时间：2024-01-02 GMT+08:00
查看PDF
分享

创建端口

功能介绍

创建端口。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

URI

POST /v1/ports

请求参数

表1 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户Token。

通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。
表2 请求Body参数

参数

是否必选

参数类型

描述

port

是

CreatePortOption object

创建端口参数。
表3 CreatePortOption

参数

是否必选

参数类型

描述

device_owner

是

String

端口设备所属。

取值范围：目前只支持指定"neutron:VIP_PORT"，neutron:VIP_PORT表示创建的是VIP

network_id

是

String

端口所属网络的ID。

约束：必须是存在的网络ID。

最小长度：1

最大长度：36

fixed_ips

否

Array of FixedIp objects

端口IP

约束：一个端口只支持一个fixed_ip，且不支持更新。
表4 FixedIp

参数

是否必选

参数类型

描述

subnet_id

否

String

所属子网ID

ip_address

否

String

端口IP地址

响应参数

状态码： 200

表5 响应Body参数

参数

参数类型

描述

port

Port object

端口对象。
表6 Port

参数

参数类型

描述

id

String

端口唯一标识

name

String

端口名称

取值：默认为空，最大长度不超过255

status

String

端口状态，Hana硬直通虚拟机端口状态总为DOWN

取值范围：ACTIVE、BUILD、DOWN

admin_state_up

Boolean

管理状态

约束：只支持true，默认为true

fixed_ips

Array of FixedIp objects

端口IP。

约束：一个端口只支持一个fixed_ip，且不支持更新。

mac_address

String

端口MAC地址

约束：由系统分配，不支持指定

network_id

String

端口所属网络的ID

约束：必须是存在的网络ID

device_id

String

端口所属设备ID

约束：不支持设置和更新，由系统自动维护

device_owner

String

设备所属（DHCP/Router/ lb/Nova）

约束：不支持设置和更新，由系统自动维护

security_groups

Array of strings

安全组的UUID(扩展属性)

extra_dhcp_opts

Array of ExtraDhcpOption objects

DHCP的扩展属性。

allowed_address_pairs

Array of AllowedAddressPair objects

  • 功能说明：IP/Mac对列表。

  • 约束： IP地址不允许为 “0.0.0.0/0” 如果allowed_address_pairs配置地址池较大的CIDR（掩码小于24位），建议为该port配置一个单独的安全组。 如果allowed_address_pairs的IP地址为“1.1.1.1/0”，表示关闭源目地址检查开关。

site_id

String

站点ID

dns_assignment

Array of DnsAssignment objects

主网卡默认内网域名信息

约束：不支持设置和更新，由系统自动维护

dns_name

String

主网卡默认内网DNS名称

约束：不支持设置和更新，由系统自动维护

ipv6_bandwidth_id

String

IPv6带宽ID

binding:profile

Object

功能说明：提供用户设置自定义信息(扩展属性)
表7 FixedIp

参数

参数类型

描述

subnet_id

String

所属子网ID

ip_address

String

端口IP地址
表8 ExtraDhcpOption

参数

参数类型

描述

opt_name

String

Option名称

opt_value

String

Option值
表9 AllowedAddressPair

参数

参数类型

描述

ip_address

String

  • 功能说明：IP地址

  • 约束： 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地址
表10 DnsAssignment

参数

参数类型

描述

fqdn

String

端口内网fqdn

hostname

String

端口hostname

ip_address

String

端口IP地址

请求示例

创建一个端口，所在network id为56071e5f-3e97-44d1-822d-bcb76906e9a7，指定子网id为3e361542-55aa-470c-a8a7-a438fa154f7d，指定IP地址为172.16.0.188。

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

{
  "port" : {
    "fixed_ips" : [ {
      "ip_address" : "172.16.0.188",
      "subnet_id" : "3e361542-55aa-470c-a8a7-a438fa154f7d"
    } ],
    "network_id" : "56071e5f-3e97-44d1-822d-bcb76906e9a7",
    "device_owner" : "neutron:VIP_PORT"
  }
}

响应示例

状态码： 200

OK

{
  "port" : {
    "id" : "dcbd71e9-c325-4e10-b1c2-57136daf413f",
    "name" : "",
    "status" : "DOWN",
    "admin_state_up" : true,
    "fixed_ips" : [ {
      "subnet_id" : "3e361542-55aa-470c-a8a7-a438fa154f7d",
      "ip_address" : "172.16.0.188"
    } ],
    "mac_address" : "fa:16:3e:2d:3f:61",
    "network_id" : "56071e5f-3e97-44d1-822d-bcb76906e9a7",
    "device_id" : "",
    "device_owner" : "neutron:VIP_PORT",
    "security_groups" : [ ],
    "extra_dhcp_opts" : [ ],
    "allowed_address_pairs" : [ ],
    "site_id" : "",
    "dns_assignment" : [ ],
    "dns_name" : ""
  }
}

状态码

状态码

描述

200

OK

错误码

请参见错误码。

父主题： 端口

相关文档