虚拟私有云 VPC-创建端口(废弃):请求消息

时间:2023-11-01 16:25:20

请求消息

  • 请求参数
    表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"        ]    }}
support.huaweicloud.com/api-vpc/vpc_port03_0001.html