72.8. 服务器创建

<server-name>

新服务器名称

-h, --help

显示帮助信息并退出

--flavor <flavor>

创建使用此类别的服务器（名称或 id）

--image <image>

从此镜像创建服务器引导磁盘（名称或 id）

--image-property <key=value>

使用与指定属性匹配的镜像创建服务器。属性必须完全匹配一个属性。

--volume <volume>

使用此卷创建服务器（名称或 ID）此选项自动创建块设备映射，其引导索引为 0。在许多 hypervisor （例如，libvirt/kvm）上，这将是设备 vda。不要为这个卷的 --block-device- mapping 创建重复的映射。

--snapshot <snapshot>

使用此快照创建服务器，作为引导磁盘（名称或 ID）此选项自动创建块设备映射，其引导索引为 0。在许多 hypervisor （例如，libvirt/kvm）上，这将是设备 vda。不要为这个卷的 --block-device- mapping 创建重复的映射。

--boot-from-volume <volume-size>

与 ''--image' 或 ''--image-property' 选项一同使用时，此选项会自动创建一个块设备映射，并带有引导索引 0，并告知计算服务从指定镜像创建给定大小（以 GB 为单位）的卷，并将其用作服务器的根磁盘。当服务器被删除时，将不会删除根卷。这个选项与 ''-volume' 和 ''-snapshot' 选项相互排斥。

--block-device-mapping <dev-name=mapping>

弃用了 在服务器上创建块设备。块设备映射，格式为 <dev-name>=<id>:<type>:<size (GB)>:<delete-on- terminate> <dev-name>: block device name，如 vdb, xvdc (required)<id>: 卷的名称或 ID, 卷快照或镜像（必需） <type>: volume, snapshot or image; default: volume (optional)<size (GB)>: 如果从镜像或快照创建（可选） <delete-on-terminate>: true 或 false; default: false （可选） 替换为 --block-device

--block-device

在服务器上创建块设备。JSON 文件的路径或 CSV 序列化字符串来描述块设备映射。对于两者都接受以下键： uuid=<uuid>： 卷、快照或 ID （如果使用源镜像、快照或卷）、source_type=<source_type>: source type 之一（镜像、快照、卷、空白）、destination_typ=<destination_type>: destination 类型之一（卷、本地）（可选）、disk_bus=<disk_bus>: 设备总线之一（以下为 uml）： lxc, virtio, …​）（可选）、device_type=<device_type>: 设备类型（用于：disk、cdrom 等等）。（可选）、device_name=<device_name>: 名称（可选）、device_size=<volume_size>: 的大小（用于 swap）或 GiB （用于所有其它内容）（可选） guest _format= : 格式：设备格式（可选）、boot_index=<boot_index>: 用于订购引导磁盘的磁盘索引（对于卷支持的实例是必需的）、delete_on_termination=<true|false>: 是否在删除服务器时删除卷（可选），标签=<tag>: 设备元数据标签（可选）、volume_type=<volume_type>: 类型要创建的卷（如果源或 ID），如果为空，image 或 snapshot 和 dest 是 volume （可选）

--swap <swap>

创建并附加一个 <swap_size> MiB 的本地交换块设备。

--ephemeral <size=size[,format=format]>

创建并附加一个 <size> GiB 的本地临时块设备，并将其格式化为 <format>。

--network <network>

在服务器上创建一个 nic，并将它连接到网络。多次指定选项来创建多个 NIC。这是一个适用于 nic net-id=<network& gt; 参数的打包程序，它为将新服务器连接到给定网络的标准用例提供了简单的语法。如需更高级的用例，请参阅- nic 参数。

--port <port>

在服务器上创建一个 nic，并将它连接到 port。多次指定选项来创建多个 NIC。这是一个适用于 nic port-id=<port& gt; 参数的打包程序，它为将新服务器连接到给定端口的标准用例提供了简单的语法。对于更高级的用例，请参阅- nic 参数。

--nic <net-id=net-uuid,port-id=port-uuid,v4-fixed-ip=ip-addr,v6-fixed-ip=ip-addr,tag=tag,auto,none>

在服务器上创建一个 nic。格式为：net-id=<net-uuid>: 将 NIC 附加到带有此 UUID 的网络，port-id=<port-uuid>: 将 NIC 附加到带有此 UUID 的端口，v4-fixed-ip=<ip-addr>: NIC 的 IPv4 固定地址（可选），v6-fixed-ip=<ip-addr>: NIC 的 IPv6 固定地址（可选）、标签：接口元数据标签（可选）（由 --os-compute-api-version 2.43 或更高版本支持），none: (v2.37+)没有附加网络，自动：(v2.37+)计算服务将自动分配网络。多次指定选项来创建多个 NIC。指定 auto 或 none 的 --nic 值不能与任何其他 --nic 值一起使用。必须提供 net-id 或 port-id，但不能同时提供。

--password <password>

设置密码到这个服务器。此选项需要云支持。

--security-group <security-group>

要分配给此服务器的安全组（名称或 id）（重复选项可设置多个组）

--key-name <key-name>

要注入这个服务器的密钥对

--property <key=value>

在此服务器上设置属性（重复选项可设置多个值）

--file <dest-filename=source-filename>

要在引导过程中注入镜像的文件（重复选项来设置多个文件）（由 --os- compute-api-version 2.57 或以下支持）

--user-data <user-data>

从元数据服务器提供服务的用户数据文件

--description <description>

设置服务器的描述（由 --os- compute-api-version 2.19 或更高版本支持）

--availability-zone <zone-name>

为 server. host 和 node 选择一个可用区。主机和节点是可选参数。可用区格式为 <zone-name>:<host-name>:<node-name>, <zone- name>::<node-name>, <zone-name>:<host-name> 或 <zone-name>

--host <host>

请求的主机来创建服务器。（仅限管理员）（由 --os-compute-api-version 2.74 或更高版本支持）

--hypervisor-hostname <hypervisor-hostname>

请求的 hypervisor 主机名来创建服务器。（仅限管理员）（由 --os-compute-api-version 2.74 或更高版本支持）

--hint <key=value>

调度程序的提示

--use-config-drive

启用配置驱动器。

--no-config-drive

禁用配置驱动器。

--config-drive <config-drive-volume>|True

弃用 使用指定的卷作为配置驱动器，或使用 True 来使用临时驱动器。用 --use-config-drive 替换。

--min <count>

要启动的最小服务器数量(default=1)

--max <count>

要启动的最大服务器数量(default=1)

--tag <tag>

服务器的标签。指定多个标签来添加多个标签。（由 --os-compute-api-version 2.52 或更高版本支持）

--wait

等待构建完成

-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}

输出格式，默认为 table

-c COLUMN, --column COLUMN

指定要包含的列，可以重复显示多个列

--noindent

是否禁用对 json 的缩进

--prefix PREFIX

在所有变量名称中添加前缀

--max-width <integer>

最大显示宽度，即 <1 来禁用。您还可以使用 CLIFF_MAX_TERM_WIDTH 环境变量，但参数具有优先权。

--fit-width

将表与显示宽度匹配。如果 --max 宽度大于 0，则表示表示。将环境变量 CLIFF_FIT_WIDTH=1 设置为 always 启用

--print-empty

如果没有要显示数据，则打印空表。