image¶

Image v2

image create¶

创建/上传镜像

openstack image create
    [--id <id>]
    [--container-format <container-format>]
    [--disk-format <disk-format>]
    [--min-disk <disk-gb>]
    [--min-ram <ram-mb>]
    [--file <file> | --volume <volume>]
    [--force]
    [--progress]
    [--sign-key-path <sign-key-path>]
    [--sign-cert-id <sign-cert-id>]
    [--protected | --unprotected]
    [--public | --private | --community | --shared]
    [--property <key=value>]
    [--tag <tag>]
    [--project <project>]
    [--import]
    [--project-domain <project-domain>]
    <image-name>

--id <id>¶: 要保留的镜像 ID

--container-format <container-format>¶: 镜像容器格式。支持的选项有：ami, ari, aki, bare, docker, ova, ovf。默认格式为：bare

--disk-format <disk-format>¶: 镜像磁盘格式。支持的选项有：ami, ari, aki, vhd, vmdk, raw, qcow2, vhdx, vdi, iso, ploop。默认格式为：raw

--min-disk <disk-gb>¶: 启动镜像所需的最小磁盘大小，以千兆字节为单位

--min-ram <ram-mb>¶: 启动镜像所需的最小 RAM 大小，以兆字节为单位

--file <file>¶: 从本地文件上传镜像

--volume <volume>¶: 从卷创建镜像

--force¶: 如果卷正在使用，则强制创建镜像（仅在与 –volume 一起使用时才有意义）

--progress¶: 显示上传进度条（如果通过 stdin 传递数据，则忽略）

--sign-key-path <sign-key-path>¶: 使用指定的私钥对镜像进行签名。仅与 –sign-cert-id 结合使用

--sign-cert-id <sign-cert-id>¶: 指定的证书 UUID 是密钥管理器中与公钥对应的证书的引用，用于签名验证。仅与 –sign-key-path 结合使用

--protected¶: 防止删除镜像

--unprotected¶: 允许删除镜像（默认）

--public¶: 镜像可供所有用户访问和查看

--private¶: 镜像仅可供所有者访问（默认，直到 –os-image-api-version 2.5）

--community¶: 镜像可供所有用户访问，但不出现在任何用户（所有者除外）的默认镜像列表中（需要 –os-image-api-version 2.5 或更高版本）

--shared¶: 镜像仅可供所有者和镜像成员访问（需要 –os-image-api-version 2.5 或更高版本）（默认，自从 –os-image-api-version 2.5 以来）

--property <key=value>¶: 为该镜像设置属性（重复选项以设置多个属性）

--tag <tag>¶: 为该镜像设置标签（重复选项以设置多个标签）

--project <project>¶: 为该镜像设置备用项目（名称或 ID）

--import¶: 强制使用 glance 镜像导入而不是直接上传

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

image-name¶: 新的镜像名称

image delete¶

删除镜像

openstack image delete [--store <STORE>] <image> [<image> ...]

--store <STORE>¶: 要从中删除镜像的存储

image¶: 要删除的镜像（名称或 ID）

image list¶

列出可用的镜像

openstack image list
    [--sort-column SORT_COLUMN]
    [--sort-ascending | --sort-descending]
    [--public | --private | --community | --shared | --all]
    [--property <key=value>]
    [--name <name>]
    [--status <status>]
    [--member-status <member-status>]
    [--project <project>]
    [--project-domain <project-domain>]
    [--tag <tag>]
    [--hidden]
    [--long]
    [--sort <key>[:<direction>]]
    [--limit <limit>]
    [--marker <marker>]

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

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

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

--public¶: 仅列出公共镜像

--private¶: 仅列出私有镜像

--community¶: 仅列出社区镜像（需要 –os-image-api-version 2.5 或更高版本）

--shared¶: 仅列出共享镜像（需要 –os-image-api-version 2.5 或更高版本）

--all¶: 列出所有镜像

--property <key=value>¶: 基于属性过滤输出（重复选项以过滤多个属性）

--name <name>¶: 基于名称过滤镜像。

--status <status>¶: 基于状态过滤镜像。

--member-status <member-status>¶: 基于成员状态过滤镜像。支持的选项有：accepted, pending, rejected, all。

--project <project>¶: 按项目搜索（仅限管理员）（名称或 ID）

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

--tag <tag>¶: 基于标签过滤镜像。（重复选项以过滤多个标签）

--hidden¶: 列出隐藏的镜像

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

--sort <key>[:<direction>]¶: 按选定的键和方向（asc 或 desc）对输出进行排序（默认：name:asc），可以以逗号分隔指定多个键和方向

--limit <limit>¶: 返回的最大条目数。如果该值超过服务器定义的限制，则将使用最大值。

--marker <marker>¶: 从集合中返回结果的第一个位置。这应该是在先前请求中返回的值。

image save¶

将镜像保存到本地

openstack image save
    [--chunk-size <chunk-size>]
    [--file <filename>]
    <image>

--chunk-size <chunk-size>¶: 一次从线读取和缓冲的字节大小（默认：1024）

--file <filename>¶: 下载的镜像保存文件名（默认：stdout）

image¶: 要保存的镜像（名称或 ID）

image set¶

设置镜像属性

openstack image set
    [--name <name>]
    [--min-disk <disk-gb>]
    [--min-ram <ram-mb>]
    [--container-format <container-format>]
    [--disk-format <disk-format>]
    [--protected | --unprotected]
    [--public | --private | --community | --shared]
    [--property <key=value>]
    [--tag <tag>]
    [--architecture <architecture>]
    [--instance-id <instance-id>]
    [--kernel-id <kernel-id>]
    [--os-distro <os-distro>]
    [--os-version <os-version>]
    [--ramdisk-id <ramdisk-id>]
    [--deactivate | --activate]
    [--project <project>]
    [--project-domain <project-domain>]
    [--accept | --reject | --pending]
    [--hidden | --unhidden]
    <image>

--name <name>¶: 新的镜像名称

--min-disk <disk-gb>¶: 启动镜像所需的最小磁盘大小，以千兆字节为单位

--min-ram <ram-mb>¶: 启动镜像所需的最小 RAM 大小，以兆字节为单位

--container-format <container-format>¶: 镜像容器格式。支持的选项有：ami, ari, aki, bare, docker, ova, ovf

--disk-format <disk-format>¶: 镜像磁盘格式。支持的选项有：ami, ari, aki, vhd, vmdk, raw, qcow2, vhdx, vdi, iso, ploop

--protected¶: 防止删除镜像

--unprotected¶: 允许删除镜像（默认）

--public¶: 镜像可供所有用户访问和查看

--private¶: 镜像仅可供所有者访问（默认，直到 –os-image-api-version 2.5）

--community¶: 镜像可供所有用户访问，但不出现在任何用户（所有者除外）的默认镜像列表中（需要 –os-image-api-version 2.5 或更高版本）

--shared¶: 镜像仅可供所有者和镜像成员访问（需要 –os-image-api-version 2.5 或更高版本）（默认，自从 –os-image-api-version 2.5 以来）

--property <key=value>¶: 为该镜像设置属性（重复选项以设置多个属性）

--tag <tag>¶: 为该镜像设置标签（重复选项以设置多个标签）

--architecture <architecture>¶: 操作系统架构

--instance-id <instance-id>¶: 用于创建此镜像的服务器实例的 ID

--kernel-id <kernel-id>¶: 用于启动此磁盘镜像的内核镜像的 ID

--os-distro <os-distro>¶: 操作系统发行版名称

--os-version <os-version>¶: 操作系统发行版版本

--ramdisk-id <ramdisk-id>¶: 用于启动此磁盘镜像的 ramdisk 镜像的 ID

--deactivate¶: 停用镜像

--activate¶: 启用镜像

--project <project>¶: 为该镜像设置备用项目（名称或 ID）

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

--accept¶: 接受镜像成员资格，针对由‘–project’指示的项目（如果提供），或当前用户的项目

--reject¶: 拒绝镜像成员资格，针对由‘–project’指示的项目（如果提供），或当前用户的项目

--pending¶: 将镜像成员资格重置为‘pending’

--hidden¶: 隐藏镜像

--unhidden¶: 取消隐藏镜像

image¶: 要修改的镜像（名称或 ID）

image unset¶

取消设置镜像标签和属性

openstack image unset [--tag <tag>] [--property <property-key>] <image>

--tag <tag>¶: 取消设置此镜像上的标签（重复选项以取消设置多个标签）

--property <property-key>¶: 取消设置此镜像上的属性（重复选项以取消设置多个属性）

image¶: 要修改的镜像（名称或 ID）

image show¶

显示镜像详细信息

openstack image show [--human-readable] <image>

--human-readable¶: 以人类可读的格式打印镜像大小。

image¶: 要显示的镜像（名称或 ID）

image stage¶

将特定镜像的数据上传到暂存区。这需要对可互操作的镜像导入过程的支持，该过程首次在 Image API 版本 2.6 (Glance 16.0.0 (Queens)) 中引入

openstack image stage [--file <file>] [--progress] <image>

--file <file>¶: 包含要上传的磁盘镜像的本地文件。或者，可以通过 stdin 传递镜像。

--progress¶: 显示上传进度条（如果通过 stdin 传递数据，则忽略）

image¶: 要上传数据的镜像（名称或 ID）

image import¶

启动镜像导入过程。这需要对可互操作的镜像导入过程的支持，该过程首次在 Image API 版本 2.6 (Glance 16.0.0 (Queens)) 中引入

openstack image import
    [--method <method>]
    [--uri <uri>]
    [--remote-image <REMOTE_IMAGE>]
    [--remote-region <REMOTE_GLANCE_REGION>]
    [--remote-service-interface <REMOTE_SERVICE_INTERFACE>]
    [--store [<STORE> ...]
    |
    --all-stores ALL_STORES
    ]
    [--allow-failure | --disallow-failure]
    [--wait]
    <image>

--method <method>¶: 用于镜像导入过程的导入方法。并非所有部署都将支持所有方法。默认方法‘glance-direct’要求首先使用‘image-stage’命令暂存镜像。

--uri <uri>¶: 下载外部镜像的 URI（仅在使用‘web-download’导入方法时有效）

--remote-image <REMOTE_IMAGE>¶: 要导入的远程 glance 镜像（仅 ID）（仅在使用‘glance-download’导入方法时有效）

--remote-region <REMOTE_GLANCE_REGION>¶: 从哪个远程 Glance 区域下载镜像（仅在使用‘glance-download’导入方法时有效）

--remote-service-interface <REMOTE_SERVICE_INTERFACE>¶: 导入镜像时要使用的远程 Glance 服务接口（仅在使用‘glance-download’导入方法时有效）

--store <STORE>¶: 上传镜像到的后端存储（多次指定以上传到多个存储）（使用‘copy-image’导入方法时，需要‘–store’或‘–all-stores’）

--all-stores <ALL_STORES>¶: 使镜像对所有存储可用（使用‘copy-image’导入方法时，需要‘–store’或‘–all-stores’）

--allow-failure¶: 在上传到多个存储时，指示如果任何上传失败，导入应继续。仅适用于 –stores 或 –all-stores

--disallow-failure¶: 在上传到多个存储时，指示如果任何上传失败，导入应回滚。仅适用于 –stores 或 –all-stores

--wait¶: 等待操作完成

image¶: 要启动导入过程的镜像（名称或 ID）

image