Red Hat Summit 红帽全球峰会支持控制台（Console）开发人员开始试用联系人

第 8 章 镜像服务命令行客户端

glance 客户端是镜像服务 API 及其扩展的命令行界面(CLI)。本章记录了 glance 版本 1.1.0。
有关特定 glance 命令的帮助信息，请输入： 
$ glance help COMMAND
Copy to Clipboard

8.1. Glance 用法

usage: glance [--version] [-d] [-v] [--get-schema] [--timeout TIMEOUT] [--no-ssl-compression] [-f] [--os-image-url OS_IMAGE_URL] [--os-image-api-version OS_IMAGE_API_VERSION] [--profile HMAC_KEY] [-k] [--os-cert OS_CERT] [--cert-file OS_CERT] [--os-key OS_KEY] [--key-file OS_KEY] [--os-cacert <ca-certificate-file>] [--ca-file OS_CACERT] [--os-username OS_USERNAME] [--os-user-id OS_USER_ID] [--os-user-domain-id OS_USER_DOMAIN_ID] [--os-user-domain-name OS_USER_DOMAIN_NAME] [--os-project-id OS_PROJECT_ID] [--os-project-name OS_PROJECT_NAME] [--os-project-domain-id OS_PROJECT_DOMAIN_ID] [--os-project-domain-name OS_PROJECT_DOMAIN_NAME] [--os-password OS_PASSWORD] [--os-tenant-id OS_TENANT_ID] [--os-tenant-name OS_TENANT_NAME] [--os-auth-url OS_AUTH_URL] [--os-region-name OS_REGION_NAME] [--os-auth-token OS_AUTH_TOKEN] [--os-service-type OS_SERVICE_TYPE] [--os-endpoint-type OS_ENDPOINT_TYPE] <subcommand> ...
Copy to Clipboard

8.2. Glance 可选参数

--version
显示程序的版本号并退出
-d, --debug
默认为 env[GLANCECLIENT_DEBUG]。
-v, --verbose
打印更详细的输出
--get-schema
忽略缓存的复制，并强制检索生成帮助文本的部分模式。API 版本 1 忽略。
--timeout TIMEOUT
等待响应的秒数
--no-ssl-compression
弃用！这个选项已弃用，不再使用。系统 SSL 库应默认禁用 SSL 压缩。
-f, --force
防止选择操作请求用户确认。
--os-image-url OS_IMAGE_URL
默认为 env[OS_IMAGE_URL]。如果提供的镜像 url 包含版本号，并且忽略了 '--os-image-api- version'，则将选择 URL 版本作为要使用的镜像 api 版本。
--os-image-api-version OS_IMAGE_API_VERSION
默认为 env[OS_IMAGE_API_VERSION] 或 2。
--profile HMAC_KEY
HMAC 密钥用于加密上下文数据以进行操作性能分析。这个键应该是在 glance 中在 osprofiler 中间件中配置的 HMAC 键的值，它在 /etc/glance/api-paste.ini 和 /etc/glance/registry-paste.ini 中指定。如果没有键，即使服务器端启用了 osprofiler，也不会触发性能分析。
-k, --insecure
明确允许 glanceclient 执行"不安全 SSL" (https)请求。服务器的证书不会针对任何证书颁发机构进行验证。这个选项应谨慎使用。
--os-cert OS_CERT
SSL 连接中使用的证书文件的路径。此文件可以选择使用私钥前添加。
--cert-file OS_CERT
弃用！使用 --os-cert。
--os-key OS_KEY
SSL 连接中使用的客户端密钥的路径。如果您的密钥在您的证书文件前面添加，则不需要这个选项。
--key-file OS_KEY
弃用！使用 --os-key。
--os-cacert <ca-certificate-file>
用于验证远程服务器证书的 CA TLS 证书的路径。如果没有此选项，则 glance 会查找默认的系统 CA 证书。
--ca-file OS_CACERT
弃用！使用 --os-cacert。
--os-username OS_USERNAME
默认为 env[OS_USERNAME]。
--os-user-id OS_USER_ID
默认为 env[OS_USER_ID]。
--os-user-domain-id OS_USER_DOMAIN_ID
默认为 env[OS_USER_DOMAIN_ID]。
--os-user-domain-name OS_USER_DOMAIN_NAME
默认为 env[OS_USER_DOMAIN_NAME]。
--os-project-id OS_PROJECT_ID
指定租户 ID 的另一种方式。这个选项与 --os-tenant-id 相互排斥。默认为 env[OS_PROJECT_ID]。
--os-project-name OS_PROJECT_NAME
指定租户名称的另一种方法。这个选项与 --os-tenant-name 相互排斥。默认为 env[OS_PROJECT_NAME]。
--os-project-domain-id OS_PROJECT_DOMAIN_ID
默认为 env[OS_PROJECT_DOMAIN_ID]。
--os-project-domain-name OS_PROJECT_DOMAIN_NAME
默认为 env[OS_PROJECT_DOMAIN_NAME]。
--os-password OS_PASSWORD
默认为 env[OS_PASSWORD]。
--os-tenant-id OS_TENANT_ID
默认为 env[OS_TENANT_ID]。
--os-tenant-name OS_TENANT_NAME
默认为 env[OS_TENANT_NAME]。
--os-auth-url OS_AUTH_URL
默认为 env[OS_AUTH_URL]。
--os-region-name OS_REGION_NAME
默认为 env[OS_REGION_NAME]。
--os-auth-token OS_AUTH_TOKEN
默认为 env[OS_AUTH_TOKEN]。
--os-service-type OS_SERVICE_TYPE
默认为 env[OS_SERVICE_TYPE]。
--os-endpoint-type OS_ENDPOINT_TYPE
默认为 env[OS_ENDPOINT_TYPE]。

8.3. 镜像服务 API v1 命令

8.3.1. glance image-create (v1)

usage: glance --os-image-api-version 1 image-create [--id <IMAGE_ID>] [--name <NAME>] [--store <STORE>] [--disk-format <DISK_FORMAT>] [--container-format <CONTAINER_FORMAT>] [--owner <TENANT_ID>] [--size <SIZE>] [--min-disk <DISK_GB>] [--min-ram <DISK_RAM>] [--location <IMAGE_URL>] [--file <FILE>] [--checksum <CHECKSUM>] [--copy-from <IMAGE_URL>] [--is-public {True,False}] [--is-protected {True,False}] [--property <key=value>] [--human-readable] [--progress]
Copy to Clipboard

可选参数

--id <IMAGE_ID>
要保留的镜像 ID。
--name <NAME>
镜像名称。
--store <STORE>
存储以上传映像到.
--disk-format <DISK_FORMAT>
镜像的磁盘格式。可接受的格式： ami, ari, aki, vhd, vmdk, raw, qcow2, vdi, 和 iso。
--Container-format <CONTAINER_FORMAT>
容器镜像格式。可接受的格式： ami、ari、aki、bare 和 ovf。
--owner <TENANT_ID>
应该拥有镜像的租户。
--size <SIZE>
镜像数据的大小（以字节为单位）。仅用于 '-- location' 和 '--copy_from'。
--min-disk <DISK_GB>
引导镜像所需的最小磁盘大小（以 GB 为单位）。
--min-ram <DISK_RAM>
引导镜像所需的最小 RAM 量（以 MB 为单位）。
--location <IMAGE_URL>
此镜像的数据已驻留的 URL。例如，如果镜像数据存储在 swift 中，您可以指定 'swift+http://tenant%3Aaccount:key@auth_ url/v2.0/container/obj'。（注：'%3A' is ':' URL encoded.）
--file <FILE>
包含要在创建过程中上传的磁盘镜像的本地文件。或者，可以通过 stdin 传递给客户端。
--checksum <CHECKSUM>
使用 Glance 的镜像数据的哈希可用于验证。此处提供 md5 checksum。
--copy-from <IMAGE_URL>
与使用中的"-location"类似，但这表明 Glance 服务器应立即复制数据并将其存储在其配置的映像存储中。
注意
Red Hat OpenStack Platform 8 版本的 glance v2 弃用了 -copy-from 选项，并将在以后的 Red Hat OpenStack Platform 版本中弃用 v1。
--is-public {True,False}
使镜像可以被公共访问。
--is-protected {True,False}
防止镜像被删除。
--property <key=value>
与镜像关联的任意属性。可以多次使用。
--human-readable
以人类可读格式打印镜像大小。
--progress
显示上传进度条。

8.3.2. Glance image-delete (v1)

usage: glance --os-image-api-version 1 image-delete <IMAGE> [<IMAGE> ...]
Copy to Clipboard
删除指定的镜像。

positional 参数

<IMAGE>
要删除的镜像的名称或 ID。

8.3.3. Glance image-download (v1)

usage: glance --os-image-api-version 1 image-download [--file <FILE>] [--progress] <IMAGE>
Copy to Clipboard
下载特定镜像。

positional 参数

<IMAGE>
要下载的镜像的名称或 ID。

可选参数

--file <FILE>
将下载的镜像数据保存到的本地文件。如果没有指定，且没有保存镜像数据。
--progress
显示下载进度条。

8.3.4. glance image-list (v1)

usage: glance --os-image-api-version 1 image-list [--name <NAME>] [--status <STATUS>] [--changes-since <CHANGES_SINCE>] [--container-format <CONTAINER_FORMAT>] [--disk-format <DISK_FORMAT>] [--size-min <SIZE>] [--size-max <SIZE>] [--property-filter <KEY=VALUE>] [--page-size <SIZE>] [--human-readable] [--sort-key {name,status,container_format,disk_format,size,id,created_at,updated_at}] [--sort-dir {asc,desc}] [--is-public {True,False}] [--owner <TENANT_ID>] [--all-tenants]
Copy to Clipboard
列出您可以访问的镜像。

可选参数

--name <NAME>
将镜像过滤为具有此名称的镜像。
--status <STATUS>
将镜像过滤为具有此状态的镜像。
--changes-since <CHANGES_SINCE>
将镜像过滤到自给定时间起更改的镜像，其中包括已删除的镜像。
--Container-format <CONTAINER_FORMAT>
将镜像过滤为具有此容器格式的镜像。可接受的格式： ami、ari、aki、bare 和 ovf。
--disk-format <DISK_FORMAT>
将镜像过滤为具有此磁盘格式的镜像。可接受的格式： ami, ari, aki, vhd, vmdk, raw, qcow2, vdi, 和 iso。
--size-min <SIZE>
将镜像过滤为大于这个大小的镜像。
--size-max <SIZE>
将镜像过滤为小于这个大小的镜像。
--property-filter <KEY=VALUE>
根据用户定义的镜像属性过滤镜像。
--page-size <SIZE>
每个分页请求中请求的镜像数。
--human-readable
以人类可读格式打印镜像大小。
--sort-key {name,status,container_format,disk_format,size,id,created_at,updated_at}
根据指定字段对镜像列表进行排序。
--sort-dir {asc,desc}
在指定方向排序镜像列表。
--is-public {True,False}
允许用户选择公共或非公共镜像的列表。
--owner <TENANT_ID>
仅显示此租户 id 拥有的镜像。过滤在客户端中进行，因此可能效率低下。此选项主要用于管理员使用。使用空字符串('')列出没有所有者的镜像。注意：此选项会覆盖 --is-public 参数（如果存在）。注： v2 API 支持更有效地基于服务器端所有者的过滤。
--all-tenants
允许 admin 用户列出与镜像的所有者或 is_public 值无关的所有镜像。

8.3.5. glance image-show (v1)

usage: glance --os-image-api-version 1 image-show [--human-readable] [--max-column-width <integer>] <IMAGE>
Copy to Clipboard
描述特定镜像。

positional 参数

<IMAGE>
要描述的镜像的名称或 ID。

可选参数

--human-readable
以人类可读格式打印镜像大小。
--max-column-width <integer>
打印表的最大列宽度。

8.3.6. glance image-update (v1)

usage: glance --os-image-api-version 1 image-update [--name <NAME>] [--disk-format <DISK_FORMAT>] [--container-format <CONTAINER_FORMAT>] [--owner <TENANT_ID>] [--size <SIZE>] [--min-disk <DISK_GB>] [--min-ram <DISK_RAM>] [--location <IMAGE_URL>] [--file <FILE>] [--checksum <CHECKSUM>] [--copy-from <IMAGE_URL>] [--is-public {True,False}] [--is-protected {True,False}] [--property <key=value>] [--purge-props] [--human-readable] [--progress] <IMAGE>
Copy to Clipboard
更新特定镜像。

positional 参数

<IMAGE>
要修改的镜像的名称或 ID。

可选参数

--name <NAME>
镜像名称。
--disk-format <DISK_FORMAT>
镜像的磁盘格式。可接受的格式： ami, ari, aki, vhd, vmdk, raw, qcow2, vdi, 和 iso。
--Container-format <CONTAINER_FORMAT>
容器镜像格式。可接受的格式： ami、ari、aki、bare 和 ovf。
--owner <TENANT_ID>
应该拥有镜像的租户。
--size <SIZE>
镜像数据的大小（以字节为单位）。
--min-disk <DISK_GB>
引导镜像所需的最小磁盘大小（以 GB 为单位）。
--min-ram <DISK_RAM>
引导镜像所需的最小 RAM 量（以 MB 为单位）。
--location <IMAGE_URL>
此镜像的数据已驻留的 URL。例如，如果镜像数据存储在 swift 中，您可以指定 'swift+http://tenant%3Aaccount:key@auth_ url/v2.0/container/obj'。（注：'%3A' is ':' URL encoded.）这个选项只适用于 'queued' 状态中的镜像。
--file <FILE>
包含要在更新期间上传的磁盘镜像的本地文件。或者，可以通过 stdin 传递给客户端。
--checksum <CHECKSUM>
使用 Glance 的镜像数据的哈希可用于验证。
--copy-from <IMAGE_URL>
与使用中的"-location"类似，但这表明 Glance 服务器应立即复制数据并将其存储在其配置的映像存储中。这个选项只适用于 'queued' 状态中的镜像。
注意
Red Hat OpenStack Platform 8 版本的 glance v2 弃用了 -copy-from 选项，并将在以后的 Red Hat OpenStack Platform 版本中弃用 v1。
--is-public {True,False}
使镜像可以被公共访问。
--is-protected {True,False}
防止镜像被删除。
--property <key=value>
与镜像关联的任意属性。可以多次使用。
--purge-props
如果存在此标志，请删除更新请求中未明确设置的所有镜像属性。否则，未引用的属性会被保留。
--human-readable
以人类可读格式打印镜像大小。
--progress
显示上传进度条。

8.3.7. glance member-create (v1)

usage: glance --os-image-api-version 1 member-create [--can-share] <IMAGE> <TENANT_ID>
Copy to Clipboard
与租户共享特定镜像。

positional 参数

<IMAGE>
要添加成员的镜像。
<TENANT_ID>
添加为成员的租户

可选参数

--can-share
允许指定的租户共享此镜像。

8.3.8. Glance member-delete (v1)

usage: glance --os-image-api-version 1 member-delete <IMAGE> <TENANT_ID>
Copy to Clipboard
从租户移除共享镜像。

positional 参数

<IMAGE>
从中删除成员的镜像。
<TENANT_ID>
要作为成员删除的租户。

8.3.9. glance member-list (v1)

usage: glance --os-image-api-version 1 member-list [--image-id <IMAGE_ID>] [--tenant-id <TENANT_ID>]
Copy to Clipboard
描述镜像或租户的共享权限。

可选参数

--image-id <IMAGE_ID>
根据镜像 ID 过滤结果。
--tenant-id <TENANT_ID>
根据租户 ID 过滤结果。

8.4. 镜像服务 API v2 命令

您可以通过添加 -os-image-api-version 参数或设置对应的 环境变量来选择要使用的 API 版本： 
$ export OS_IMAGE_API_VERSION=2
Copy to Clipboard

8.4.1. Glance explain (v2)

usage: glance --os-image-api-version 2 explain <MODEL>
Copy to Clipboard
描述特定模型。

positional 参数

<MODEL>
要描述的型号名称。

8.4.2. glance image-create (v2)

usage: glance --os-image-api-version 2 image-create [--architecture <ARCHITECTURE>] [--protected [True|False]] [--name <NAME>] [--instance-uuid <INSTANCE_UUID>] [--min-disk <MIN_DISK>] [--visibility <VISIBILITY>] [--kernel-id <KERNEL_ID>] [--tags <TAGS> [<TAGS> ...]] [--os-version <OS_VERSION>] [--disk-format <DISK_FORMAT>] [--self <SELF>] [--os-distro <OS_DISTRO>] [--id <ID>] [--owner <OWNER>] [--ramdisk-id <RAMDISK_ID>] [--min-ram <MIN_RAM>] [--container-format <CONTAINER_FORMAT>] [--property <key=value>] [--file <FILE>] [--progress]
Copy to Clipboard

可选参数

--architecture <ARCHITECTURE>
如 http://docs.openstack.org/trunk/openstack- compute/admin/content/adding-images.html 中指定的操作系统架构
--protected [True|False]
如果为 true，则镜像将无法被删除。
--name <NAME>
镜像的描述性名称
--instance-uuid <INSTANCE_UUID>
用于创建此镜像的实例 ID。
--min-disk <MIN_DISK>
引导镜像所需的磁盘空间（以 GB 为单位）。
--visibility <VISIBILITY>
镜像可访问性有效值范围：public, private
--kernel-id <KERNEL_ID>
存储在 Glance 中的映像 ID，在引导 AMI 式镜像时应用作内核。
--tags <TAGS> [<TAGS> ...]
与镜像相关的字符串列表
--os-version <OS_VERSION>
根据经销商指定的操作系统版本
--disk-format <DISK_FORMAT>
磁盘 Valid 值的格式： ami, ari, aki, vhd, vmdk, raw, qcow2, vdi, iso
--self <SELF>
（只读）
--os-distro <OS_DISTRO>
在 http://docs.openstack.org/trunk /openstack-compute/admin/content/adding-images.html 中指定的常用操作系统分发名称
--id <ID>
镜像的标识符
--owner <OWNER>
镜像的所有者
--ramdisk-id <RAMDISK_ID>
存储在 Glance 中的映像 ID，在引导 AMI 式镜像时应用作 ramdisk。
--min-ram <MIN_RAM>
引导镜像所需的 RAM 量（以 MB 为单位）。
--Container-format <CONTAINER_FORMAT>
容器 Valid 值的格式： ami, ari, aki, bare, ovf, ova
--property <key=value>
与镜像关联的任意属性。可以多次使用。
--file <FILE>
包含要在创建过程中上传的磁盘镜像的本地文件。如果镜像没有通过 stdin 传递给客户端，则必须存在。
--progress
显示上传进度条。

8.4.3. glance image-delete (v2)

usage: glance --os-image-api-version 2 image-delete <IMAGE_ID>
Copy to Clipboard
删除指定的镜像。

positional 参数

<IMAGE_ID>
要删除的镜像的 ID。

8.4.4. Glance image-download (v2)

usage: glance --os-image-api-version 2 image-download [--file <FILE>] [--progress] <IMAGE_ID>
Copy to Clipboard
下载特定镜像。

positional 参数

<IMAGE_ID>
要下载的镜像的 ID。

可选参数

--file <FILE>
将下载的镜像数据保存到的本地文件。如果没有指定，且没有保存镜像数据。
--progress
显示下载进度条。

8.4.5. glance image-list (v2)

usage: glance --os-image-api-version 2 image-list [--limit <LIMIT>] [--page-size <SIZE>] [--visibility <VISIBILITY>] [--member-status <MEMBER_STATUS>] [--owner <OWNER>] [--property-filter <KEY=VALUE>] [--checksum <CHECKSUM>] [--tag <TAG>] [--sort-key {name,status,container_format,disk_format,size,id,created_at,updated_at}] [--sort-dir {asc,desc}] [--sort <key>[:<direction>]]
Copy to Clipboard
列出您可以访问的镜像。

可选参数

--limit <LIMIT>
要获取的最大镜像数。
--page-size <SIZE>
每个分页请求中请求的镜像数。
--visibility <VISIBILITY>
要显示的镜像的可见性。
--member-status <MEMBER_STATUS>
要显示的镜像状态。
--owner <OWNER>
显示由 <OWNER> 所有的镜像。
--property-filter <KEY=VALUE>
根据用户定义的镜像属性过滤镜像。
--checksum <CHECKSUM>
显示与校验和匹配的镜像。
--tag <TAG>
根据用户定义的标签过滤镜像。
--sort-key {name,status,container_format,disk_format,size,id,created_at,updated_at}
根据指定字段对镜像列表进行排序。
--sort-dir {asc,desc}
在指定方向排序镜像列表。
--sort <key>[:<direction>]
以逗号分隔的排序键和方向列表，格式为 <key>[:<asc|desc>]。有效键： name, status, container_format, disk_format, size, id, created_at, updated_at.可选。

8.4.6. glance image-show (v2)

usage: glance --os-image-api-version 2 image-show [--human-readable] [--max-column-width <integer>] <IMAGE_ID>
Copy to Clipboard
描述特定镜像。

positional 参数

<IMAGE_ID>
要描述的镜像 ID。

可选参数

--human-readable
以人类可读格式打印镜像大小。
--max-column-width <integer>
打印表的最大列宽度。

8.4.7. Glance image-tag-delete (v2)

usage: glance --os-image-api-version 2 image-tag-delete <IMAGE_ID> <TAG_VALUE>
Copy to Clipboard
删除与给定镜像关联的标签。

positional 参数

<IMAGE_ID>
要从中删除标签的镜像 ID。
<TAG_VALUE>
标签的值。

8.4.8. glance image-tag-update (v2)

usage: glance --os-image-api-version 2 image-tag-update <IMAGE_ID> <TAG_VALUE>
Copy to Clipboard
使用给定标签更新镜像。

positional 参数

<IMAGE_ID>
要使用给定标签更新的镜像。
<TAG_VALUE>
标签的值。

8.4.9. glance image-update (v2)

usage: glance --os-image-api-version 2 image-update [--architecture <ARCHITECTURE>] [--protected [True|False]] [--name <NAME>] [--instance-uuid <INSTANCE_UUID>] [--min-disk <MIN_DISK>] [--visibility <VISIBILITY>] [--kernel-id <KERNEL_ID>] [--os-version <OS_VERSION>] [--disk-format <DISK_FORMAT>] [--self <SELF>] [--os-distro <OS_DISTRO>] [--owner <OWNER>] [--ramdisk-id <RAMDISK_ID>] [--min-ram <MIN_RAM>] [--container-format <CONTAINER_FORMAT>] [--property <key=value>] [--remove-property key] <IMAGE_ID>
Copy to Clipboard
更新现有镜像。

positional 参数

<IMAGE_ID>
要更新的镜像的 ID。

可选参数

--architecture <ARCHITECTURE>
如 http://docs.openstack.org/trunk/openstack- compute/admin/content/adding-images.html 中指定的操作系统架构
--protected [True|False]
如果为 true，则镜像将无法被删除。
--name <NAME>
镜像的描述性名称
--instance-uuid <INSTANCE_UUID>
用于创建此镜像的实例 ID。
--min-disk <MIN_DISK>
引导镜像所需的磁盘空间（以 GB 为单位）。
--visibility <VISIBILITY>
镜像可访问性有效值范围：public, private
--kernel-id <KERNEL_ID>
存储在 Glance 中的映像 ID，在引导 AMI 式镜像时应用作内核。
--os-version <OS_VERSION>
根据经销商指定的操作系统版本
--disk-format <DISK_FORMAT>
磁盘 Valid 值的格式： ami, ari, aki, vhd, vmdk, raw, qcow2, vdi, iso
--self <SELF>
（只读）
--os-distro <OS_DISTRO>
在 http://docs.openstack.org/trunk /openstack-compute/admin/content/adding-images.html 中指定的常用操作系统分发名称
--owner <OWNER>
镜像的所有者
--ramdisk-id <RAMDISK_ID>
存储在 Glance 中的映像 ID，在引导 AMI 式镜像时应用作 ramdisk。
--min-ram <MIN_RAM>
引导镜像所需的 RAM 量（以 MB 为单位）。
--Container-format <CONTAINER_FORMAT>
容器 Valid 值的格式： ami, ari, aki, bare, ovf, ova
--property <key=value>
与镜像关联的任意属性。可以多次使用。
--remove-property
从镜像中删除的任意属性的关键名称。

8.4.10. Glance image-upload (v2)

usage: glance --os-image-api-version 2 image-upload [--file <FILE>] [--size <IMAGE_SIZE>] [--progress] <IMAGE_ID>
Copy to Clipboard
上传特定镜像的数据。

positional 参数

<IMAGE_ID>
要上传数据的镜像的 ID。

可选参数

--file <FILE>
包含要上传的磁盘镜像的本地文件。或者，可以通过 stdin 传递给客户端。
--size <IMAGE_SIZE>
要上传的镜像的大小（以字节为单位）。默认为从提供的数据对象获取大小，但在无法推断大小时被支持。
--progress
显示上传进度条。

8.4.11. glance location-add (v2)

usage: glance --os-image-api-version 2 location-add --url <URL> [--metadata <STRING>] <ID>
Copy to Clipboard
向镜像添加位置（和相关元数据）。

positional 参数

<ID>
要添加位置的镜像 ID。

可选参数

--url <URL>
要添加的位置的 URL。
--metadata <STRING>
与位置关联的元数据。必须是有效的 JSON 对象（默认：{}）

8.4.12. glance location-delete (v2)

usage: glance --os-image-api-version 2 location-delete --url <URL> <ID>
Copy to Clipboard
从镜像中删除位置（和相关元数据）。

positional 参数

<ID>
要删除其位置的镜像 ID。

可选参数

--url <URL>
要删除的位置的 URL。可以多次使用。

8.4.13. glance location-update (v2)

usage: glance --os-image-api-version 2 location-update --url <URL> [--metadata <STRING>] <ID>
Copy to Clipboard
更新镜像位置的元数据。

positional 参数

<ID>
要更新位置的镜像 ID。

可选参数

--url <URL>
要更新的位置 URL。
--metadata <STRING>
与位置关联的元数据。必须是有效的 JSON 对象（默认：{}）

8.4.14. glance md-namespace-create (v2)

usage: glance --os-image-api-version 2 md-namespace-create <NAMESPACE> <unavailable>
Copy to Clipboard
创建新的元数据定义命名空间。

positional 参数

<NAMESPACE>
命名空间的名称。
<unavailable>
请使用设置连接参数运行，以检索用于为此命令生成帮助的模式

8.4.15. glance md-namespace-delete (v2)

usage: glance --os-image-api-version 2 md-namespace-delete <NAMESPACE>
Copy to Clipboard
使用其内容删除指定的元数据定义命名空间。

positional 参数

<NAMESPACE>
要删除的命名空间的名称。

8.4.16. glance md-namespace-import (v2)

usage: glance --os-image-api-version 2 md-namespace-import [--file <FILEPATH>]
Copy to Clipboard
从文件或标准输入中导入元数据定义命名空间。

可选参数

--file <FILEPATH>
带有要导入的命名空间模式的文件路径。另外，命名空间架构可以通过 stdin 传递给客户端。

8.4.17. glance md-namespace-list (v2)

usage: glance --os-image-api-version 2 md-namespace-list [--resource-types <RESOURCE_TYPES>] [--visibility <VISIBILITY>] [--page-size <SIZE>]
Copy to Clipboard
列出元数据定义命名空间。

可选参数

--resource-types <RESOURCE_TYPES>
用于过滤命名空间的资源类型。
--visibility <VISIBILITY>
过滤命名空间的可见性参数。
--page-size <SIZE>
在每个分页请求中请求的命名空间数量。

8.4.18. glance md-namespace-objects-delete (v2)

usage: glance --os-image-api-version 2 md-namespace-objects-delete <NAMESPACE>
Copy to Clipboard
删除特定命名空间中的所有元数据定义对象。

positional 参数

<NAMESPACE>
命名空间的名称。

8.4.19. glance md-namespace-properties-delete (v2)

usage: glance --os-image-api-version 2 md-namespace-properties-delete <NAMESPACE>
Copy to Clipboard
删除特定命名空间中的所有元数据定义属性。

positional 参数

<NAMESPACE>
命名空间的名称。

8.4.20. glance md-namespace-resource-type-list (v2)

usage: glance --os-image-api-version 2 md-namespace-resource-type-list <NAMESPACE>
Copy to Clipboard
列出与特定命名空间关联的资源类型。

positional 参数

<NAMESPACE>
命名空间的名称。

8.4.21. glance md-namespace-show (v2)

usage: glance --os-image-api-version 2 md-namespace-show [--resource-type <RESOURCE_TYPE>] [--max-column-width <integer>] <NAMESPACE>
Copy to Clipboard
描述特定的元数据定义命名空间。也列出命名空间属性、对象和资源类型关联。

positional 参数

<NAMESPACE>
要描述的命名空间的名称。

可选参数

--resource-type <RESOURCE_TYPE>
将与命名空间关联的资源类型的前缀应用到命名空间的所有属性。
--max-column-width <integer>
打印表的最大列宽度。

8.4.22. glance md-namespace-tags-delete (v2)

usage: glance --os-image-api-version 2 md-namespace-tags-delete <NAMESPACE>
Copy to Clipboard
删除特定命名空间中的所有元数据定义标签。

positional 参数

<NAMESPACE>
命名空间的名称。

8.4.23. glance md-namespace-update (v2)

usage: glance --os-image-api-version 2 md-namespace-update <NAMESPACE> <unavailable>
Copy to Clipboard
更新现有元数据定义命名空间。

positional 参数

<NAMESPACE>
要更新的命名空间名称。
<unavailable>
请使用设置连接参数运行，以检索用于为此命令生成帮助的模式

8.4.24. glance md-object-create (v2)

usage: glance --os-image-api-version 2 md-object-create --name <NAME> --schema <SCHEMA> <NAMESPACE>
Copy to Clipboard
在命名空间内创建新的元数据定义对象。

positional 参数

<NAMESPACE>
对象将属于的命名空间的名称。

可选参数

--name <NAME>
对象的内部名称。
--schema <SCHEMA>
对象的有效 JSON 模式。

8.4.25. Glance md-object-delete (v2)

usage: glance --os-image-api-version 2 md-object-delete <NAMESPACE> <OBJECT>
Copy to Clipboard
删除命名空间中的特定元数据定义对象。

positional 参数

<NAMESPACE>
对象所属命名空间的名称。
<OBJECT>
对象的名称。

8.4.26. glance md-object-list (v2)

usage: glance --os-image-api-version 2 md-object-list <NAMESPACE>
Copy to Clipboard
列出特定命名空间中的元数据定义对象。

positional 参数

<NAMESPACE>
命名空间的名称。

8.4.27. glance md-object-property-show (v2)

usage: glance --os-image-api-version 2 md-object-property-show [--max-column-width <integer>] <NAMESPACE> <OBJECT> <PROPERTY>
Copy to Clipboard
描述对象中的特定元数据定义属性。

positional 参数

<NAMESPACE>
对象所属命名空间的名称。
<OBJECT>
对象的名称。
<PROPERTY>
属性的名称。

可选参数

--max-column-width <integer>
打印表的最大列宽度。

8.4.28. glance md-object-show (v2)

usage: glance --os-image-api-version 2 md-object-show [--max-column-width <integer>] <NAMESPACE> <OBJECT>
Copy to Clipboard
描述命名空间中的特定元数据定义对象。

positional 参数

<NAMESPACE>
对象所属命名空间的名称。
<OBJECT>
对象的名称。

可选参数

--max-column-width <integer>
打印表的最大列宽度。

8.4.29. glance md-object-update (v2)

usage: glance --os-image-api-version 2 md-object-update [--name <NAME>] [--schema <SCHEMA>] <NAMESPACE> <OBJECT>
Copy to Clipboard
更新命名空间内的元数据定义对象。

positional 参数

<NAMESPACE>
对象所属命名空间的名称。
<OBJECT>
对象的名称。

可选参数

--name <NAME>
对象的新名称。
--schema <SCHEMA>
对象的有效 JSON 模式。

8.4.30. glance md-property-create (v2)

usage: glance --os-image-api-version 2 md-property-create --name <NAME> --title <TITLE> --schema <SCHEMA> <NAMESPACE>
Copy to Clipboard
在命名空间内创建新的元数据定义属性。

positional 参数

<NAMESPACE>
属性将属于的命名空间的名称。

可选参数

--name <NAME>
属性的内部名称。
--title <TITLE>
显示给用户的属性名称。
--schema <SCHEMA>
属性的有效 JSON 模式。

8.4.31. glance md-property-delete (v2)

usage: glance --os-image-api-version 2 md-property-delete <NAMESPACE> <PROPERTY>
Copy to Clipboard
删除命名空间中的特定元数据定义属性。

positional 参数

<NAMESPACE>
属性所属命名空间的名称。
<PROPERTY>
属性的名称。

8.4.32. glance md-property-list (v2)

usage: glance --os-image-api-version 2 md-property-list <NAMESPACE>
Copy to Clipboard
列出特定命名空间中的元数据定义属性。

positional 参数

<NAMESPACE>
命名空间的名称。

8.4.33. glance md-property-show (v2)

usage: glance --os-image-api-version 2 md-property-show [--max-column-width <integer>] <NAMESPACE> <PROPERTY>
Copy to Clipboard
描述命名空间中的特定元数据定义属性。

positional 参数

<NAMESPACE>
属性所属命名空间的名称。
<PROPERTY>
属性的名称。

可选参数

--max-column-width <integer>
打印表的最大列宽度。

8.4.34. glance md-property-update (v2)

usage: glance --os-image-api-version 2 md-property-update [--name <NAME>] [--title <TITLE>] [--schema <SCHEMA>] <NAMESPACE> <PROPERTY>
Copy to Clipboard
更新命名空间中的元数据定义属性。

positional 参数

<NAMESPACE>
属性所属命名空间的名称。
<PROPERTY>
属性的名称。

可选参数

--name <NAME>
属性的新名称。
--title <TITLE>
显示给用户的属性名称。
--schema <SCHEMA>
属性的有效 JSON 模式。

8.4.35. Glance md-resource-type-associate (v2)

usage: glance --os-image-api-version 2 md-resource-type-associate <NAMESPACE> <unavailable>
Copy to Clipboard
将资源类型与元数据定义命名空间关联。

positional 参数

<NAMESPACE>
命名空间的名称。
<unavailable>
请使用设置连接参数运行，以检索用于为此命令生成帮助的模式

8.4.36. glance md-resource-type-deassociate (v2)

usage: glance --os-image-api-version 2 md-resource-type-deassociate <NAMESPACE> <RESOURCE_TYPE>
Copy to Clipboard
将资源类型与元数据定义命名空间关联。

positional 参数

<NAMESPACE>
命名空间的名称。
<RESOURCE_TYPE>
资源类型的名称。

8.4.37. glance md-resource-type-list (v2)

usage: glance --os-image-api-version 2 md-resource-type-list
Copy to Clipboard
列出可用的资源类型名称。为 v1 help 运行 'glance --os-image-api-version 1 help md-resource-type-list'

8.4.38. Glance md-tag-create (v2)

usage: glance --os-image-api-version 2 md-tag-create --name <NAME> <NAMESPACE>
Copy to Clipboard
在命名空间中添加新的元数据定义标签。

positional 参数

<NAMESPACE>
标签所属命名空间的名称。

可选参数

--name <NAME>
要添加的新标签的名称。

8.4.39. glance md-tag-create-multiple (v2)

usage: glance --os-image-api-version 2 md-tag-create-multiple --names <NAMES> [--delim <DELIM>] <NAMESPACE>
Copy to Clipboard
在命名空间内创建新的元数据定义标签。

positional 参数

<NAMESPACE>
标签要属于的命名空间的名称。

可选参数

--names <NAMES>
以逗号分隔的标签名称列表。
--delim <DELIM>
用于分隔名称的分隔符（如果没有提供，则默认为逗号）。

8.4.40. Glance md-tag-delete (v2)

usage: glance --os-image-api-version 2 md-tag-delete <NAMESPACE> <TAG>
Copy to Clipboard
删除命名空间中的特定元数据定义标签。

positional 参数

<NAMESPACE>
标签所属命名空间的名称。
<TAG>
标签的名称。

8.4.41. glance md-tag-list (v2)

usage: glance --os-image-api-version 2 md-tag-list <NAMESPACE>
Copy to Clipboard
列出特定命名空间中的元数据定义标签。

positional 参数

<NAMESPACE>
命名空间的名称。

8.4.42. Glance md-tag-show (v2)

usage: glance --os-image-api-version 2 md-tag-show <NAMESPACE> <TAG>
Copy to Clipboard
描述命名空间中的特定元数据定义标签。

positional 参数

<NAMESPACE>
标签所属命名空间的名称。
<TAG>
标签的名称。

8.4.43. Glance md-tag-update (v2)

usage: glance --os-image-api-version 2 md-tag-update --name <NAME> <NAMESPACE> <TAG>
Copy to Clipboard
重命名命名空间中的元数据定义标签。

positional 参数

<NAMESPACE>
标签所属命名空间的名称。
<TAG>
旧标签的名称。

可选参数

--name <NAME>
新标签的新名称。

8.4.44. glance member-create (v2)

usage: glance --os-image-api-version 2 member-create <IMAGE_ID> <MEMBER_ID>
Copy to Clipboard
为给定镜像创建成员。

positional 参数

<IMAGE_ID>
要创建成员的镜像。
<MEMBER_ID>
要添加为成员的租户。

8.4.45. Glance member-delete (v2)

usage: glance --os-image-api-version 2 member-delete <IMAGE_ID> <MEMBER_ID>
Copy to Clipboard
删除镜像成员。

positional 参数

<IMAGE_ID>
从中删除成员的镜像。
<MEMBER_ID>
要作为成员删除的租户。

8.4.46. glance member-list (v2)

usage: glance --os-image-api-version 2 member-list --image-id <IMAGE_ID>
Copy to Clipboard
描述镜像共享权限。

可选参数

--image-id <IMAGE_ID>
镜像以显示.

8.4.47. Glance member-update (v2)

usage: glance --os-image-api-version 2 member-update <IMAGE_ID> <MEMBER_ID> <MEMBER_STATUS>
Copy to Clipboard
更新给定镜像的成员的状态。

positional 参数

<IMAGE_ID>
从中更新成员的镜像。
<MEMBER_ID>
要更新的租户。
<MEMBER_STATUS>
更新了成员状态。有效值： accepted, rejected, pending

8.4.48. glance task-create (v2)

usage: glance --os-image-api-version 2 task-create [--type <TYPE>] [--input <STRING>]
Copy to Clipboard
创建新任务。

可选参数

--type <TYPE>
任务类型。请参阅 Glance 架构或文档，以了解支持哪些任务。
--input <STRING>
要启动的任务的参数

8.4.49. glance task-list (v2)

usage: glance --os-image-api-version 2 task-list [--sort-key {id,type,status}] [--sort-dir {asc,desc}] [--page-size <SIZE>] [--type <TYPE>] [--status <STATUS>]
Copy to Clipboard
列出您可以访问的任务。

可选参数

--sort-key {id,type,status}
根据指定字段对任务列表进行排序。
--sort-dir {asc,desc}
在指定方向排序任务列表。
--page-size <SIZE>
每个分页请求中请求的任务数量。
--type <TYPE>
将任务过滤为具有此类型的那些任务。
--status <STATUS>
将任务过滤到具有此状态的用户。

8.4.50. glance task-show (v2)

usage: glance --os-image-api-version 2 task-show <TASK_ID>
Copy to Clipboard
描述特定任务。

positional 参数

<TASK_ID>
要描述的任务 ID。

8.5. 镜像服务属性键

以下键与特定于它们的组件一起可用于 glance image-update 和 glance image-create 命令的 property 选项。例如： 
$ glance image-update IMG-UUID --property architecture=x86_64
Copy to Clipboard
注意
使用镜像属性设置的行为会覆盖使用类别设置的行为。如需更多信息，请参阅 Red Hat OpenStack Platform Cloud Admin Guide。
表 8.1. 属性键
特定于 键 描述 支持的值
All 架构 管理程序必须支持的 CPU 架构。例如，x86_64,arm, 或 ppc64。运行 uname -m 以获取机器的架构。我们强烈建议您使用 libosinfo 项目 定义的架构数据词汇。
All hypervisor_type 管理程序类型。 Xen,qemu,kvm,lxc,uml,vmware, 或 hyperv
All instance_uuid 对于快照镜像，这是用于创建此镜像的服务器的 UUID。 有效服务器 UUID
All kernel_id 存储在镜像服务中的镜像的 ID，在引导 AMI 风格镜像时应用作内核。 有效镜像 ID
All os_distro 小写的操作系统分布的通用名称（使用与 libosinfo 项目相同的数据词汇）。仅为此字段指定可识别的值。列出已弃用的值，以帮助您搜索可识别的值。
  • 存档Linux.不要使用 archlinux 或 org.archlinux
  • CentOS-Community 企业操作系统.不要使用 org.centos 或 CentOS
  • Debian-Debian.不要使用 Debian 或 org.debian
  • Fedora-Fedora.不要使用 Fedora、org.fedora 或 org.fedoraproject
  • FreeBSD-FreeBSD。不要使用 org.freebsd、freeBSD 或 FreeBSD
  • gentoo-Gentoo Linux。不要使用 Gentoo 或 org.gentoo
  • mandrake-Mandrakelinux (MandrakeSoft)发行版.不要使用 mandrakelinux 或 MandrakeLinux
  • mandriva-Mandriva Linux.不要使用 mandrivalinux
  • mes-Mandriva Enterprise Server.不要使用 mandrivaent 或 mandrivaES
  • msdos-Microsoft Disc Operating System.不要使用 ms-dos
  • netbsd—NetBSD.不要使用 NetBSD 或 org.netbsd
  • Netware-Novell NetWare.不要使用 novell 或 NetWare
  • openbsd- 打开BSD。不要使用 OpenBSD 或 org.openbsd
  • Open optimize-OpenSolaris.不要使用 Open swig 或 org.open swig
  • OpenSuse-openSUSE.不要使用 suse、SuSE 或 org.opensuse
  • rhel-Red Hat Enterprise Linux.不要使用 redhat、RedHat 或 com.redhat
  • SLED-SUSE Linux Enterprise Desktop.不要使用 com.suse
  • Ubuntu-Ubuntu.不要使用 Ubuntu、com.ubuntu、org.ubuntu 或 规范
  • Windows-Microsoft Windows.不要使用 com.microsoft.server
All os_version 根据经销商指定的操作系统版本。 版本号（例如："11.10"）
All ramdisk_id 存储在镜像服务中的镜像的 ID，在引导 AMI 风格镜像时应用作 ramdisk。 有效镜像 ID
All vm_mode 虚拟机模式。这代表了用于虚拟机的主机/guest ABI （应用程序二进制接口）。
  • Hvm-完全虚拟化.这是 QEMU 和 KVM 使用的模式。
  • Xen-Xen 3.0 半虚拟化.
  • UML-User 模式 Linux 半虚拟化.
  • 容器中的 exe-Executables。这是 LXC 使用的模式。
libvirt API 驱动程序 hw_disk_bus 指定要附加磁盘设备的磁盘控制器类型。 scsi 之一：virtio、uml、xen、ide 或 usb。
libvirt API 驱动程序
hw_rng_model
在镜像的实例中添加随机数生成器设备。云管理员可通过配置实例的类别来启用和控制设备行为。默认情况下：
  • 生成器设备被禁用。
  • /dev/random 用作默认熵源。要指定物理 HW RNG 设备，在 nova.conf 文件中使用以下选项： 
    rng_dev_path=/dev/hwrng
    Copy to Clipboard
VirtIO，或其他支持的设备。
libvirt API 驱动程序 hw_machine_type 启用使用指定的机器类型引导 ARM 系统。默认情况下，如果使用 ARM 镜像并且未指定类型，Compute 将使用 vexpress-a15 (ARMv7)或 virt （用于 AArch64）机器类型。 libvirt 机器类型。可以使用 virsh capabilities 命令查看有效类型（机器标签中会显示 机器类型 ）。
libvirt API 驱动程序 hw_scsi_model 启用 VirtIO SCSI (virtio-scsi)来为计算实例提供块设备访问；默认情况下，实例使用 VirtIO 块(virtio-blk)。VirtIO SCSI 是一个半虚拟化 SCSI 控制器设备，它提高了可扩展性和性能，并支持高级 SCSI 硬件。 virtio-scsi
libvirt API 驱动程序 hw_video_model 使用的视频图像驱动程序。 VGA,cirrus,vmvga,xen, 或 qxl
libvirt API 驱动程序 hw_video_ram 视频镜像的最大 RAM。仅在类别的 extra_specs 中设置 hw_video:ram_max_mb 值并且该值高于 hw_video_ram 中设置的值时使用。 以 MB 为单位的整数（例如 '64'）
libvirt API 驱动程序 hw_watchdog_action 启用虚拟硬件 watchdog 设备，在服务器挂起时执行指定操作。watchdog 使用 i6300esb 设备（模拟 PCI Intel 6300ESB）。如果没有指定 hw_watchdog_action，则禁用 watchdog。
  • disabled-(default)该设备没有附加。允许用户禁用镜像的 watchdog，即使已使用镜像的类别启用了它。
  • 重置客户机。
  • poweroff-Forcefully 关闭客户机。
  • 暂停 guest。
  • none-Only 启用 watchdog；如果服务器挂起，什么都不做。
libvirt API 驱动程序 os_command_line libvirt 驱动程序使用的内核命令行，而不是默认。对于 Linux 容器(LXC)，其值用作初始化的参数。这个密钥只适用于 Amazon 内核、ramdisk 或机器镜像(aki、ari 或 ami)。
libvirt API 驱动程序和 VMware API 驱动程序 hw_vif_model 指定要使用的虚拟网络接口设备的型号。
有效选项取决于配置的虚拟机监控程序。
  • KVM 和 QEMU： e1000、ne2k_pci、pcnet、rtl8139 和 virtio.
  • VMware： e1000、e1000e、VirtualE1000 e、VirtualE1000e、VirtualPCNet32、VirtualSriovEthernetCard、和 VirtualVmxnet.
  • Xen: e1000,netfront,ne2k_pci,pcnet, 和 rtl8139.
VMware API 驱动程序 vmware_adaptertype 管理程序使用的虚拟 SCSI 或 IDE 控制器。 lsiLogic,busLogic, 或 ide
VMware API 驱动程序 vmware_ostype VMware GuestID，用于描述在镜像中安装的操作系统。这个值在创建虚拟机时传递给虚拟机监控程序。如果没有指定，则密钥默认为 otherGuest。 请参见 thinkvirt.com。
VMware API 驱动程序 vmware_image_version 当前未使用。 1
xenapi 驱动程序 auto_disk_config 如果为 true，则在实例引导前，磁盘上的根分区会自动调整大小。只有使用带有 XenAPI 驱动程序的基于 Xen 的 hypervisor 时，计算服务才会考虑该值。只有映像上只有一个分区，并且仅当分区采用 ext3 或 ext4 格式时，计算服务才会尝试调整大小。 true | false
xenapi 驱动程序 os_type 在镜像上安装的操作系统。XenAPI 驱动程序包含根据镜像的 os_type 参数的值来采取不同操作的逻辑。例如，对于 os_type=windows 镜像，它会创建一个基于 FAT32 的交换分区而不是 Linux swap 分区，并将注入的主机名限制为小于 16 个字符。 linux 或 windows
返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务，以及可以信赖的内容，帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情，请参阅红帽博客.

關於紅帽

我们提供强化的解决方案，使企业能够更轻松地跨平台和环境（从核心数据中心到网络边缘）工作。

Theme

© 2025 Red Hat