port¶

一个端口是连接单个设备（例如服务器的网卡）到网络的连接点。端口还描述了相关的网络配置，例如在该端口上要使用的 MAC 和 IP 地址。

Network v2

port create¶

创建一个新的端口

openstack port create
    [--extra-property type=<property_type>,name=<property_name>,value=<property_value>]
    --network <network>
    [--description <description>]
    [--device <device-id>]
    [--mac-address <mac-address>]
    [--device-owner <device-owner>]
    [--vnic-type <vnic-type>]
    [--host <host-id>]
    [--dns-domain dns-domain]
    [--dns-name <dns-name>]
    [--numa-policy-required | --numa-policy-preferred | --numa-policy-socket | --numa-policy-legacy]
    [--hint <alias=value>]
    [--trusted | --not-trusted]
    [--fixed-ip subnet=<subnet>,ip-address=<ip-address> | --no-fixed-ip]
    [--binding-profile <binding-profile>]
    [--enable | --disable]
    [--enable-uplink-status-propagation | --disable-uplink-status-propagation]
    [--project <project>]
    [--project-domain <project-domain>]
    [--extra-dhcp-option name=<name>[,value=<value>,ip-version={4,6}]]
    [--security-group <security-group> | --no-security-group]
    [--qos-policy <qos-policy>]
    [--enable-port-security | --disable-port-security]
    [--allowed-address ip-address=<ip-address>[,mac-address=<mac-address>]]
    [--device-profile <device-profile>]
    [--hardware-offload-type <hardware-offload-type>]
    [--tag <tag> | --no-tag]
    <name>

--extra-property type=<property_type>,name=<property_name>,value=<property_value>¶: 可以使用此属性传递额外的参数。额外属性的默认类型是字符串（‘str’），但也可以使用其他类型。可用类型包括：‘dict’、‘list’、‘str’、‘bool’、‘int’。对于 ‘list’ 类型，‘value’ 可以是分号分隔的值列表。对于 ‘dict’ 类型，value 是分号分隔的键值对列表。

--network <network>¶: 此端口所属的网络（名称或 ID）

--description <description>¶: 此端口的描述

--device <device-id>¶: 端口设备 ID

--mac-address <mac-address>¶: 此端口的 MAC 地址

--device-owner <device-owner>¶: 此端口的设备所有者。这是使用该端口的实体（例如，network:dhcp）。

--vnic-type <vnic-type>¶: 此端口的 VNIC 类型 (direct | direct-physical | macvtap | normal | baremetal | virtio-forwarder | vdpa | remote-managed) (默认: normal)

--host <host-id>¶: 在主机 <host-id> 上分配端口（仅限 ID）

--dns-domain dns-domain¶: 将 DNS 域设置为此端口（需要端口的 dns_domain 扩展）

--dns-name <dns-name>¶: 为此端口设置 DNS 名称（需要 DNS 集成扩展）

--numa-policy-required¶: 需要 NUMA 亲和策略来调度此端口

--numa-policy-preferred¶: 首选 NUMA 亲和策略来调度此端口

--numa-policy-socket¶: 要调度此端口的 NUMA 亲和策略套接字

--numa-policy-legacy¶: 使用传统模式来调度此端口的 NUMA 亲和策略

--hint <alias=value>¶: 端口提示，格式为 ALIAS=VALUE 或 JSON。有效的提示别名/值：ovs-tx-steering=thread, ovs-tx-steering=hash。有效的 JSON 值如 Neutron API 中所述。(需要 port-hints 扩展)(对于别名：ovs-tx-steering，需要 port-hint-ovs-tx-steering 扩展)(重复选项以设置多个提示)。

--trusted¶: 将端口设置为受信任。这将填充到 ‘binding:profile’ 字典中，并传递给期望在此字典中找到它的服务（例如，Nova）。

--not-trusted¶: 将端口设置为不受信任。这将填充到 ‘binding:profile’ 字典中，并传递给期望在此字典中找到它的服务（例如，Nova）。

--fixed-ip subnet=<subnet>,ip-address=<ip-address>¶: 此端口所需的 IP 和/或子网（名称或 ID）：subnet=<subnet>,ip-address=<ip-address>（重复选项以设置多个固定 IP 地址）

--no-fixed-ip¶: 端口未设置 IP 或子网

--binding-profile <binding-profile>¶: 作为 binding:profile 传递的自定义数据。数据可以作为 <key>=<value> 或 JSON 传递（重复选项以设置多个 binding:profile 数据）。

--enable¶: 启用端口（默认）

--disable¶: 禁用端口

--enable-uplink-status-propagation¶: 启用上行链路状态传播（默认）

--disable-uplink-status-propagation¶: 禁用上行链路状态传播

--project <project>¶: 所有者的项目（名称或 ID）

--project-domain <project-domain>¶: 项目所属的域（名称或 ID）。如果项目名称之间存在冲突，可以使用此选项。

--extra-dhcp-option name=<name>[,value=<value>,ip-version={4,6}]¶: 要分配给此端口的额外 DHCP 选项：name=<name>[,value=<value>,ip-version={4,6}]（重复选项以设置多个额外 DHCP 选项）

--security-group <security-group>¶: 与此端口关联的安全组（名称或 ID）（重复选项以设置多个安全组）

--no-security-group¶: 将不将任何安全组与此端口关联

--qos-policy <qos-policy>¶: 将 QoS 策略附加到此端口（名称或 ID）

--enable-port-security¶: 为此端口启用端口安全（默认）

--disable-port-security¶: 为此端口禁用端口安全

--allowed-address ip-address=<ip-address>[,mac-address=<mac-address>]¶: 添加与此端口关联的允许地址对：ip-address=<ip-address>[,mac-address=<mac-address>]（重复选项以设置多个允许地址对）

--device-profile <device-profile>¶: 端口设备配置文件

--hardware-offload-type <hardware-offload-type>¶: 此端口在附加到网络后端时将请求的硬件卸载类型

--tag <tag>¶: 要添加到端口的标签（重复选项以设置多个标签）

--no-tag¶: 端口没有关联的标签

name¶: 此端口的名称

port delete¶

删除端口

openstack port delete <port> [<port> ...]

port¶: 要删除的端口（名称或 ID）

port list¶

列出端口

openstack port list
    [--sort-column SORT_COLUMN]
    [--sort-ascending | --sort-descending]
    [--device-owner <device-owner>]
    [--host <host-id>]
    [--network <network>]
    [--router <router> | --server <server> | --device-id <device-id>]
    [--mac-address <mac-address>]
    [--long]
    [--project <project>]
    [--name <name>]
    [--security-group <security-group>]
    [--status <status>]
    [--project-domain <project-domain>]
    [--fixed-ip subnet=<subnet>,ip-address=<ip-address>,ip-substring=<ip-substring>]
    [--tags <tag>[,<tag>,...]]
    [--any-tags <tag>[,<tag>,...]]
    [--not-tags <tag>[,<tag>,...]]
    [--not-any-tags <tag>[,<tag>,...]]

--sort-column SORT_COLUMN¶: 指定要对数据进行排序的列（首先指定的列具有优先级，不存在的列将被忽略），可以重复

--sort-ascending¶: 按升序对列进行排序

--sort-descending¶: 按降序对列进行排序

--device-owner <device-owner>¶: 仅列出具有指定设备所有者的端口。这是使用该端口的实体（例如，network:dhcp）。

--host <host-id>¶: 仅列出绑定到此主机 ID 的端口

--network <network>¶: 仅列出连接到此网络的端口（名称或 ID）

--router <router>¶: 仅列出连接到此路由器的端口（名称或 ID）

--server <server>¶: 仅列出连接到此服务器的端口（名称或 ID）

--device-id <device-id>¶: 仅列出具有指定设备 ID 的端口

--mac-address <mac-address>¶: 仅列出具有此 MAC 地址的端口

--long¶: 在输出中列出附加字段

--project <project>¶: 根据其项目列出端口（名称或 ID）

--name <name>¶: 根据其名称列出端口

--security-group <security-group>¶: 仅列出与此安全组关联的端口

--status <status>¶: 根据其状态列出端口（‘ACTIVE’、‘BUILD’、‘DOWN’、‘ERROR’）

--project-domain <project-domain>¶: 项目所属的域（名称或 ID）。如果项目名称之间存在冲突，可以使用此选项。

--fixed-ip subnet=<subnet>,ip-address=<ip-address>,ip-substring=<ip-substring>¶: 用于筛选端口的所需 IP 和/或子网（名称或 ID）：subnet=<subnet>,ip-address=<ip-address>,ip-substring=<ip-substring>（重复选项以设置多个固定 IP 地址）

--tags <tag>[,<tag>,...]¶: 列出具有所有给定标签的端口（逗号分隔的标签列表）

--any-tags <tag>[,<tag>,...]¶: 列出具有任何给定标签的端口（逗号分隔的标签列表）

--not-tags <tag>[,<tag>,...]¶: 排除具有所有给定标签的端口（逗号分隔的标签列表）

--not-any-tags <tag>[,<tag>,...]¶: 排除带有任何给定标签(标签用逗号分隔)的端口

端口设置¶

设置端口属性

openstack port set
    [--extra-property type=<property_type>,name=<property_name>,value=<property_value>]
    [--description <description>]
    [--device <device-id>]
    [--mac-address <mac-address>]
    [--device-owner <device-owner>]
    [--vnic-type <vnic-type>]
    [--host <host-id>]
    [--dns-domain dns-domain]
    [--dns-name <dns-name>]
    [--numa-policy-required | --numa-policy-preferred | --numa-policy-socket | --numa-policy-legacy]
    [--hint <alias=value>]
    [--trusted | --not-trusted]
    [--enable | --disable]
    [--name <name>]
    [--fixed-ip subnet=<subnet>,ip-address=<ip-address>]
    [--no-fixed-ip]
    [--binding-profile <binding-profile>]
    [--no-binding-profile]
    [--qos-policy <qos-policy>]
    [--security-group <security-group>]
    [--no-security-group]
    [--enable-port-security | --disable-port-security]
    [--allowed-address ip-address=<ip-address>[,mac-address=<mac-address>]]
    [--no-allowed-address]
    [--extra-dhcp-option name=<name>[,value=<value>,ip-version={4,6}]]
    [--data-plane-status <status>]
    [--enable-uplink-status-propagation | --disable-uplink-status-propagation]
    [--tag <tag>]
    [--no-tag]
    <port>

--extra-property 类型=<property_type>,名称=<property_name>,值=<property_value>¶: 可以使用此属性传递额外的参数。额外属性的默认类型是字符串（‘str’），但也可以使用其他类型。可用类型包括：‘dict’、‘list’、‘str’、‘bool’、‘int’。对于 ‘list’ 类型，‘value’ 可以是分号分隔的值列表。对于 ‘dict’ 类型，value 是分号分隔的键值对列表。

--description <描述>¶: 此端口的描述

--device <设备ID>¶: 端口设备 ID

--mac-address <MAC地址>¶: 此端口的MAC地址（仅限管理员）

--device-owner <设备所有者>¶: 此端口的设备所有者。这是使用该端口的实体（例如，network:dhcp）。

--vnic-type <vnic类型>¶: 此端口的 VNIC 类型 (direct | direct-physical | macvtap | normal | baremetal | virtio-forwarder | vdpa | remote-managed) (默认: normal)

--host <主机ID>¶: 在主机 <host-id> 上分配端口（仅限 ID）

--dns-domain dns域名¶: 将 DNS 域设置为此端口（需要端口的 dns_domain 扩展）

--dns-name <DNS名称>¶: 为此端口设置 DNS 名称（需要 DNS 集成扩展）

--numa-policy-required¶: 需要 NUMA 亲和策略来调度此端口

--numa-policy-preferred¶: 首选 NUMA 亲和策略来调度此端口

--numa-policy-socket¶: 要调度此端口的 NUMA 亲和策略套接字

--numa-policy-legacy¶: 使用传统模式来调度此端口的 NUMA 亲和策略

--hint <别名=值>¶: 端口提示，格式为 ALIAS=VALUE 或 JSON。有效的提示别名/值：ovs-tx-steering=thread, ovs-tx-steering=hash。有效的 JSON 值如 Neutron API 中所述。(需要 port-hints 扩展)(对于别名：ovs-tx-steering，需要 port-hint-ovs-tx-steering 扩展)(重复选项以设置多个提示)。

--trusted¶: 将端口设置为受信任。这将填充到 ‘binding:profile’ 字典中，并传递给期望在此字典中找到它的服务（例如，Nova）。

--not-trusted¶: 将端口设置为不受信任。这将填充到 ‘binding:profile’ 字典中，并传递给期望在此字典中找到它的服务（例如，Nova）。

--enable¶: 启用端口

--disable¶: 禁用端口

--name <名称>¶: 设置端口名称

--fixed-ip 子网=<子网>,IP地址=<IP地址>¶: 此端口所需的 IP 和/或子网（名称或 ID）：subnet=<subnet>,ip-address=<ip-address>（重复选项以设置多个固定 IP 地址）

--no-fixed-ip¶: 清除现有固定IP地址信息。同时指定 –fixed-ip 和 –no-fixed-ip 以覆盖当前固定IP地址。

--binding-profile <绑定配置文件>¶: 作为 binding:profile 传递的自定义数据。数据可以作为 <key>=<value> 或 JSON 传递（重复选项以设置多个 binding:profile 数据）。

--no-binding-profile¶: 清除现有绑定:profile信息。同时指定 –binding-profile 和 –no-binding-profile 以覆盖当前绑定:profile信息。

--qos-policy <QoS策略>¶: 将 QoS 策略附加到此端口（名称或 ID）

--security-group <安全组>¶: 与此端口关联的安全组（名称或 ID）（重复选项以设置多个安全组）

--no-security-group¶: 清除与此端口关联的现有安全组

--enable-port-security¶: 为该端口启用端口安全

--disable-port-security¶: 为此端口禁用端口安全

--allowed-address IP地址=<IP地址>[,MAC地址=<MAC地址>]¶: 添加与此端口关联的允许地址对：ip-address=<ip-address>[,mac-address=<mac-address>]（重复选项以设置多个允许地址对）

--no-allowed-address¶: 清除与此端口关联的现有允许地址对。同时指定 –allowed-address 和 –no-allowed-address 以覆盖当前允许地址对。

--extra-dhcp-option 名称=<名称>[,值=<值>,IP版本={4,6}]¶: 要分配给此端口的额外 DHCP 选项：name=<name>[,value=<value>,ip-version={4,6}]（重复选项以设置多个额外 DHCP 选项）

--data-plane-status <状态>¶: 设置此端口的数据平面状态（ACTIVE | DOWN）。使用“port unset”命令将其设置为 None（需要数据平面状态扩展）。

--enable-uplink-status-propagation¶: 启用上行链路状态传播

--disable-uplink-status-propagation¶: 禁用上行链路状态传播

--tag <标签>¶: 要添加到端口的标签（重复选项以设置多个标签）

--no-tag¶: 清除与端口关联的标签。同时指定 –tag 和 –no-tag 以覆盖当前标签

port¶: 要修改的端口（名称或ID）

端口显示¶

显示端口详细信息

openstack port show <port>

port¶: 要显示的端口（名称或ID）

端口取消设置¶

取消设置端口属性

openstack port unset
    [--extra-property type=<property_type>,name=<property_name>,value=<property_value>]
    [--fixed-ip subnet=<subnet>,ip-address=<ip-address>]
    [--binding-profile <binding-profile-key>]
    [--security-group <security-group>]
    [--allowed-address ip-address=<ip-address>[,mac-address=<mac-address>]]
    [--qos-policy]
    [--data-plane-status]
    [--numa-policy]
    [--host]
    [--hints]
    [--device]
    [--device-owner]
    [--tag <tag> | --all-tag]
    <port>

--extra-property 类型=<property_type>,名称=<property_name>,值=<property_value>¶: 可以使用此属性传递额外的参数。额外属性的默认类型是字符串（‘str’），但也可以使用其他类型。可用类型包括：‘dict’、‘list’、‘str’、‘bool’、‘int’。对于 ‘list’ 类型，‘value’ 可以是分号分隔的值列表。对于 ‘dict’ 类型，value 是分号分隔的键值对列表。

--fixed-ip 子网=<子网>,IP地址=<IP地址>¶: 要从此端口删除的所需IP地址和/或子网：子网=<子网>,IP地址=<IP地址>（重复选项以取消设置多个固定IP地址）

--binding-profile <绑定配置文件键>¶: 要从绑定:profile中删除的所需键（重复选项以取消设置多个绑定:profile键）

--security-group <安全组>¶: 要从此端口删除的安全组（名称或ID）（重复选项以取消设置多个安全组）

--allowed-address IP地址=<IP地址>[,MAC地址=<MAC地址>]¶: 要从此端口删除的所需允许地址对：IP地址=<IP地址>[,MAC地址=<MAC地址>]（重复选项以取消设置多个允许地址对）

--qos-policy¶: 删除附加到端口的QoS策略

--data-plane-status¶: 清除现有的数据平面状态信息

--numa-policy¶: 清除现有的NUMA亲和策略

--host¶: 清除端口的主机绑定

--hints¶: 清除端口的提示

--device¶: 清除端口的设备ID。

--device-owner¶: 清除端口的设备所有者。

--tag <标签>¶: 要从端口删除的标签（重复选项以删除多个标签）

--all-tag¶: 清除与端口关联的所有标签

port¶: 要修改的端口（名称或ID）

port

port¶

port create¶

port delete¶

port list¶

端口设置¶

端口显示¶

端口取消设置¶

OpenStack 命令行客户端 8.2.1.dev8

页面内容