Image service (glance) 命令行客户端¶
glance 客户端是 Image service (glance) API 及其扩展的命令行界面 (CLI)。
本章记录 glance 版本 2.8.0。
要获取特定 glance 命令的帮助，请输入
$ glance help COMMAND
glance usage¶
usage: glance [--version] [-d] [-v] [--get-schema] [-f]
[--os-image-url OS_IMAGE_URL]
[--os-image-api-version OS_IMAGE_API_VERSION]
[--profile HMAC_KEY] [--os-region-name OS_REGION_NAME]
[--os-auth-token OS_AUTH_TOKEN]
[--os-service-type OS_SERVICE_TYPE]
[--os-endpoint-type OS_ENDPOINT_TYPE] [--insecure]
[--os-cacert <ca-certificate>] [--os-cert <certificate>]
[--os-key <key>] [--timeout <seconds>] [--os-auth-type <name>]
[--os-auth-url OS_AUTH_URL] [--os-domain-id OS_DOMAIN_ID]
[--os-domain-name OS_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-trust-id OS_TRUST_ID]
[--os-default-domain-id OS_DEFAULT_DOMAIN_ID]
[--os-default-domain-name OS_DEFAULT_DOMAIN_NAME]
[--os-user-id OS_USER_ID] [--os-username OS_USERNAME]
[--os-user-domain-id OS_USER_DOMAIN_ID]
[--os-user-domain-name OS_USER_DOMAIN_NAME]
[--os-password OS_PASSWORD]
<subcommand> ...
glance 可选参数¶
--version显示程序版本号并退出
-d, --debug默认值为
env[GLANCECLIENT_DEBUG]。-v, --verbose打印更详细的输出。
--get-schema忽略缓存副本并强制检索生成帮助文本一部分的模式。API 版本 1 时忽略。
-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 密钥的值，它在 glance 配置文件 /etc/glance/glance-api.conf 和 /etc/glance/glance-registry.conf 中指定。如果没有密钥，即使服务器端启用了 osprofiler，分析也不会被触发。默认值为
env[OS_PROFILE]。--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]。--os-auth-type <name>, --os-auth-plugin <name>要使用的身份验证类型
glance explain¶
usage: glance explain <MODEL>
描述特定的模型。
位置参数
<MODEL>要描述的模型名称。
glance image-create¶
usage: glance 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>]
[--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]
创建一个新的镜像。
可选参数
--architecture <ARCHITECTURE>操作系统架构，如 https://docs.openstack.org/glance/2025.2/user/common-image-properties.html#architecture 中所述。
--protected [True|False]如果为 true，则镜像将无法删除。
--name <NAME>镜像的描述性名称
--instance-uuid <INSTANCE_UUID>元数据，可用于记录此镜像与哪个实例关联。 （仅供参考，不会创建实例快照。）
--min-disk <MIN_DISK>启动镜像所需的磁盘空间量（以 GB 为单位）。
--visibility <VISIBILITY>镜像可访问范围。有效值：public、private、community、shared
--kernel-id <KERNEL_ID>存储在 Glance 中的镜像的 ID，该镜像应在启动 AMI 风格的镜像时用作内核。
--tags <TAGS> [<TAGS> ...]与镜像相关的字符串列表
--os-version <OS_VERSION>发行版指定的操作系统版本
--disk-format <DISK_FORMAT>磁盘格式。有效值：None、ami、ari、aki、vhd、vhdx、vmdk、raw、qcow2、vdi、iso、ploop
--os-distro <OS_DISTRO>操作系统分发版的常用名称，如 https://docs.openstack.org/glance/2025.2/user/common-image-properties.html#os-distro 中所述。
--id <ID>镜像的标识符
--owner <OWNER>镜像的所有者
--ramdisk-id <RAMDISK_ID>存储在 Glance 中的镜像的 ID，该镜像应在启动 AMI 风格的镜像时用作 ramdisk。
--min-ram <MIN_RAM>启动镜像所需的 RAM 量（以 MB 为单位）。
--container-format <CONTAINER_FORMAT>容器格式。有效值：None、ami、ari、aki、bare、ovf、ova、docker
--property <key=value>与镜像关联的任意属性。可多次使用。
--file <FILE>在创建期间要上传的磁盘镜像的本地文件。或者，可以通过 stdin 将镜像数据传递给客户端。
--progress显示上传进度条。
glance image-deactivate¶
usage: glance image-deactivate <IMAGE_ID>
停用指定的镜像。
位置参数
<IMAGE_ID>要停用的镜像的 ID。
glance image-delete¶
usage: glance image-delete <IMAGE_ID> [<IMAGE_ID> ...]
删除指定的镜像。
位置参数
<IMAGE_ID>要删除的镜像的 ID。
glance image-download¶
usage: glance image-download [--file <FILE>] [--progress] <IMAGE_ID>
下载特定的镜像。
位置参数
<IMAGE_ID>要下载的镜像的 ID。
可选参数
--file <FILE>将下载的镜像数据保存到的本地文件。如果未指定此项且没有重定向，则不会保存镜像数据。
--progress显示下载进度条。
glance image-list¶
usage: glance 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>]]
列出您可以访问的镜像。
可选参数
--limit <LIMIT>要获取的最大镜像数量。
--page-size <SIZE>在每个分页请求中请求的镜像数量。
--visibility <VISIBILITY>要显示的镜像的可见性。
--member-status <MEMBER_STATUS>要显示的镜像的状态。
--owner <OWNER>显示由 <OWNER> 拥有的镜像。
--property-filter <KEY=VALUE>按用户定义的镜像属性过滤镜像。
--checksum <CHECKSUM>显示与 MD5 校验和匹配的镜像。
--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。可选。
glance image-reactivate¶
usage: glance image-reactivate <IMAGE_ID>
重新激活指定的镜像。
位置参数
<IMAGE_ID>要重新激活的镜像的 ID。
glance image-show¶
usage: glance image-show [--human-readable] [--max-column-width <integer>]
<IMAGE_ID>
描述特定的镜像。
位置参数
<IMAGE_ID>要描述的镜像的 ID。
可选参数
--human-readable以人类可读的格式打印镜像大小。
--max-column-width <integer>打印表格的最大列宽。
glance image-tag-delete¶
usage: glance image-tag-delete <IMAGE_ID> <TAG_VALUE>
删除与给定镜像关联的标签。
位置参数
<IMAGE_ID>要从中删除标签的镜像的 ID。
<TAG_VALUE>标签的值。
glance image-tag-update¶
usage: glance image-tag-update <IMAGE_ID> <TAG_VALUE>
使用给定的标签更新镜像。
位置参数
<IMAGE_ID>要使用给定的标签更新的镜像。
<TAG_VALUE>标签的值。
glance image-update¶
usage: glance 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>]
[--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>
更新现有的镜像。
位置参数
<IMAGE_ID>要更新的镜像的 ID。
可选参数
--architecture <ARCHITECTURE>操作系统架构，如 https://docs.openstack.org/glance/2025.2/user/common-image-properties.html#architecture 中所述。
--protected [True|False]如果为 true，则镜像将无法删除。
--name <NAME>镜像的描述性名称
--instance-uuid <INSTANCE_UUID>元数据，可用于记录此镜像与哪个实例关联。 （仅供参考，不会创建实例快照。）
--min-disk <MIN_DISK>启动镜像所需的磁盘空间量（以 GB 为单位）。
--visibility <VISIBILITY>镜像可访问范围。有效值：public、private、community、shared
--kernel-id <KERNEL_ID>存储在 Glance 中的镜像的 ID，该镜像应在启动 AMI 风格的镜像时用作内核。
--os-version <OS_VERSION>发行版指定的操作系统版本
--disk-format <DISK_FORMAT>磁盘格式。有效值：None、ami、ari、aki、vhd、vhdx、vmdk、raw、qcow2、vdi、iso、ploop
--os-distro <OS_DISTRO>操作系统分发版的常用名称，如 https://docs.openstack.org/glance/2025.2/user/common-image-properties.html#os-distro 中所述。
--owner <OWNER>镜像的所有者
--ramdisk-id <RAMDISK_ID>存储在 Glance 中的镜像的 ID，该镜像应在启动 AMI 风格的镜像时用作 ramdisk。
--min-ram <MIN_RAM>启动镜像所需的 RAM 量（以 MB 为单位）。
--container-format <CONTAINER_FORMAT>容器格式。有效值：None、ami、ari、aki、bare、ovf、ova、docker
--property <key=value>与镜像关联的任意属性。可多次使用。
--remove-property要从镜像中删除的任意属性的键。
glance image-upload¶
usage: glance image-upload [--file <FILE>] [--size <IMAGE_SIZE>] [--progress]
<IMAGE_ID>
上传特定镜像的数据。
位置参数
<IMAGE_ID>要上传数据的镜像的 ID。
可选参数
--file <FILE>要上传的磁盘镜像的本地文件。或者，可以通过 stdin 将镜像传递给客户端。
--size <IMAGE_SIZE>要上传的镜像的大小（以字节为单位）。默认是从提供的数据对象获取大小，但在无法推断大小的情况下支持此项。
--progress显示上传进度条。
glance import-info¶
usage: glance import-info
打印 Glance 可用的导入方法，或者如果目标 Glance 不支持镜像导入，则打印一条消息。
glance image-stage¶
usage: glance image-stage [--file <FILE>] [--size <IMAGE_SIZE>]
[--progress]
<IMAGE_ID>
将数据上传到暂存以进行特定镜像的操作。
位置参数
<IMAGE_ID>要上传数据的镜像的 ID。
可选参数
--file <FILE>要上传的磁盘镜像的本地文件。或者，可以通过 stdin 将镜像传递给客户端。
--size <IMAGE_SIZE>要上传的镜像的大小（以字节为单位）。默认是从提供的数据对象获取大小，但在无法推断大小的情况下支持此项。
--progress显示上传进度条。
glance image-import¶
usage: glance image-import [--import-method <METHOD>]
[--uri <IMAGE_URL>]
[--store <STORE>] [--stores <STORES>]
[--all-stores [True|False]]
[--allow-failure [True|False]]
<IMAGE_ID>
启动镜像导入任务流。
位置参数
<IMAGE_ID>要导入的镜像的 ID。
可选参数
--import-method <METHOD>用于镜像导入工作流的导入方法。可以使用 import-info 命令检索有效值，默认值为“glance-direct”，与“image-stage”一起使用。
--uri <IMAGE_URL>下载外部镜像的 URI
--store <STORE>要上传镜像的后端存储。
--stores <STORES>如果环境中启用了多存储，则要上传镜像的逗号分隔的存储列表。
--all-stores [True|False]可以使用“all-stores”代替“–stores <STORES>”来指示应将镜像导入到所有可用的存储。
--allow-failure [True|False]指示是否所有列出的存储（或可用存储）都必须成功。默认值为“True”，这意味着允许某些存储失败，并且可以从镜像元数据中监视状态。如果设置为“False”，则如果任何上传失败，导入将被回滚。仅与“stores”或“all-stores”一起使用。
glance image-create-via-import¶
这是一个实验性命令。将来可能会重命名或删除它。
usage: glance image-create-via import [--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>]
[--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]
使用镜像导入过程创建一个新的镜像。
注意这是一个实验性命令。将来可能会重命名或删除它。
可选参数
--architecture <ARCHITECTURE>操作系统架构，如 https://docs.openstack.org/glance/2025.2/user/common-image-properties.html#architecture 中所述。
--protected [True|False]如果为 true，则镜像将无法删除。
--name <NAME>镜像的描述性名称
--instance-uuid <INSTANCE_UUID>元数据，可用于记录此镜像与哪个实例关联。 （仅供参考，不会创建实例快照。）
--min-disk <MIN_DISK>启动镜像所需的磁盘空间量（以 GB 为单位）。
--visibility <VISIBILITY>镜像可访问范围。有效值：public、private、community、shared
--kernel-id <KERNEL_ID>存储在 Glance 中的镜像的 ID，该镜像应在启动 AMI 风格的镜像时用作内核。
--tags <TAGS> [<TAGS> ...]与镜像相关的字符串列表
--os-version <OS_VERSION>发行版指定的操作系统版本
--disk-format <DISK_FORMAT>磁盘格式。有效值：None、ami、ari、aki、vhd、vhdx、vmdk、raw、qcow2、vdi、iso、ploop
--os-distro <OS_DISTRO>操作系统分发版的常用名称，如 https://docs.openstack.org/glance/2025.2/user/common-image-properties.html#os-distro 中所述。
--id <ID>镜像的标识符
--owner <OWNER>镜像的所有者
--ramdisk-id <RAMDISK_ID>存储在 Glance 中的镜像的 ID，该镜像应在启动 AMI 风格的镜像时用作 ramdisk。
--min-ram <MIN_RAM>启动镜像所需的 RAM 量（以 MB 为单位）。
--container-format <CONTAINER_FORMAT>容器格式。有效值：None、ami、ari、aki、bare、ovf、ova、docker
--property <key=value>与镜像关联的任意属性。可多次使用。
--file <FILE>在创建期间要上传的磁盘镜像的本地文件。或者，可以通过 stdin 将镜像数据传递给客户端。
--progress显示上传进度条。
glance location-add¶
usage: glance location-add --url <URL> [--metadata <STRING>] <IMAGE_ID>
将位置（以及相关元数据）添加到镜像。
位置参数
<IMAGE_ID>要添加位置的镜像的 ID。
可选参数
--url <URL>要添加的位置的 URL。
--metadata <STRING>与位置关联的元数据。必须是有效的 JSON 对象（默认：{}）
glance location-delete¶
usage: glance location-delete --url <URL> <IMAGE_ID>
从镜像中删除位置（以及相关元数据）。
位置参数
<IMAGE_ID>要删除位置的镜像的 ID。
可选参数
--url <URL>要删除的位置的 URL。可以多次使用。
glance location-update¶
usage: glance location-update --url <URL> [--metadata <STRING>] <IMAGE_ID>
更新镜像位置的元数据。
位置参数
<IMAGE_ID>要更新位置的镜像的 ID。
可选参数
--url <URL>要更新的位置的 URL。
--metadata <STRING>与位置关联的元数据。必须是有效的 JSON 对象（默认：{}）
glance md-namespace-create¶
usage: glance md-namespace-create [--schema <SCHEMA>]
[--created-at <CREATED_AT>]
[--resource-type-associations <RESOURCE_TYPE_ASSOCIATIONS> [<RESOURCE_TYPE_ASSOCIATIONS> ...]]
[--protected [True|False]] [--self <SELF>]
[--display-name <DISPLAY_NAME>]
[--owner <OWNER>]
[--visibility <VISIBILITY>]
[--updated-at <UPDATED_AT>]
[--description <DESCRIPTION>]
<NAMESPACE>
创建一个新的元数据定义命名空间。
位置参数
<NAMESPACE>命名空间的名称。
可选参数
--schema <SCHEMA>
--created-at <CREATED_AT>命名空间创建的日期和时间。
--resource-type-associations <RESOURCE_TYPE_ASSOCIATIONS> [...]
--protected [True|False]如果为 true，则命名空间将无法删除。
--self <SELF>
--display-name <DISPLAY_NAME>命名空间的友好名称。如果可用，则由 UI 使用。
--owner <OWNER>命名空间的所有者。
--visibility <VISIBILITY>命名空间可访问范围。有效值：public、private
--updated-at <UPDATED_AT>上次修改命名空间的日期和时间。
--description <DESCRIPTION>提供命名空间的友好描述。
glance md-namespace-delete¶
usage: glance md-namespace-delete <NAMESPACE>
删除指定的元数据定义命名空间及其内容。
位置参数
<NAMESPACE>要删除的命名空间的名称。
glance md-namespace-import¶
usage: glance md-namespace-import [--file <FILEPATH>]
从文件或标准输入导入元数据定义命名空间。
可选参数
--file <FILEPATH>包含要导入的命名空间模式的文件的路径。或者，可以通过 stdin 将命名空间模式传递给客户端。
glance md-namespace-list¶
usage: glance md-namespace-list [--resource-types <RESOURCE_TYPES>]
[--visibility <VISIBILITY>]
[--page-size <SIZE>]
列出元数据定义命名空间。
可选参数
--resource-types <RESOURCE_TYPES>用于过滤命名空间的资源类型。
--visibility <VISIBILITY>用于过滤命名空间的可见性参数。
--page-size <SIZE>在每个分页请求中请求的命名空间数量。
glance md-namespace-objects-delete¶
usage: glance md-namespace-objects-delete <NAMESPACE>
删除特定命名空间内的所有元数据定义对象。
位置参数
<NAMESPACE>命名空间名称。
glance md-namespace-properties-delete¶
usage: glance md-namespace-properties-delete <NAMESPACE>
删除特定命名空间内的所有元数据定义属性。
位置参数
<NAMESPACE>命名空间名称。
glance md-namespace-resource-type-list¶
usage: glance md-namespace-resource-type-list <NAMESPACE>
列出与特定命名空间关联的资源类型。
位置参数
<NAMESPACE>命名空间名称。
glance md-namespace-show¶
usage: glance md-namespace-show [--resource-type <RESOURCE_TYPE>]
[--max-column-width <integer>]
<NAMESPACE>
描述特定的元数据定义命名空间。同时列出命名空间属性、对象和资源类型关联。
位置参数
<NAMESPACE>要描述的命名空间名称。
可选参数
--resource-type <RESOURCE_TYPE>将给定资源类型的前缀应用于命名空间的所有属性。
--max-column-width <integer>打印表格的最大列宽。
glance md-namespace-update¶
usage: glance md-namespace-update [--created-at <CREATED_AT>]
[--protected [True|False]]
[--namespace <NAMESPACE>] [--self <SELF>]
[--display-name <DISPLAY_NAME>]
[--owner <OWNER>]
[--visibility <VISIBILITY>]
[--updated-at <UPDATED_AT>]
[--description <DESCRIPTION>]
<NAMESPACE>
更新现有的元数据定义命名空间。
位置参数
<NAMESPACE>要更新的命名空间名称。
可选参数
--created-at <CREATED_AT>命名空间创建的日期和时间。
--protected [True|False]如果为 true，则命名空间将无法删除。
--namespace <NAMESPACE>唯一的命名空间文本。
--self <SELF>
--display-name <DISPLAY_NAME>命名空间的友好名称。如果可用，则由 UI 使用。
--owner <OWNER>命名空间的所有者。
--visibility <VISIBILITY>命名空间可访问范围。有效值：public、private
--updated-at <UPDATED_AT>上次修改命名空间的日期和时间。
--description <DESCRIPTION>提供命名空间的友好描述。
glance md-object-create¶
usage: glance md-object-create --name <NAME> --schema <SCHEMA> <NAMESPACE>
在命名空间内创建一个新的元数据定义对象。
位置参数
<NAMESPACE>对象将所属的命名空间名称。
可选参数
--name <NAME>对象的内部名称。
--schema <SCHEMA>对象的有效 JSON 模式。
glance md-object-delete¶
usage: glance md-object-delete <NAMESPACE> <OBJECT>
删除命名空间内的特定元数据定义对象。
位置参数
<NAMESPACE>对象所属的命名空间名称。
<OBJECT>对象的名称。
glance md-object-list¶
usage: glance md-object-list <NAMESPACE>
列出特定命名空间内的元数据定义对象。
位置参数
<NAMESPACE>命名空间名称。
glance md-object-property-show¶
usage: glance md-object-property-show [--max-column-width <integer>]
<NAMESPACE> <OBJECT> <PROPERTY>
描述对象内的特定元数据定义属性。
位置参数
<NAMESPACE>对象所属的命名空间名称。
<OBJECT>对象的名称。
<PROPERTY>属性的名称。
可选参数
--max-column-width <integer>打印表格的最大列宽。
glance md-object-show¶
usage: glance md-object-show [--max-column-width <integer>]
<NAMESPACE> <OBJECT>
描述命名空间内的特定元数据定义对象。
位置参数
<NAMESPACE>对象所属的命名空间名称。
<OBJECT>对象的名称。
可选参数
--max-column-width <integer>打印表格的最大列宽。
glance md-object-update¶
usage: glance md-object-update [--name <NAME>] [--schema <SCHEMA>]
<NAMESPACE> <OBJECT>
更新命名空间内的元数据定义对象。
位置参数
<NAMESPACE>对象所属的命名空间名称。
<OBJECT>对象的名称。
可选参数
--name <NAME>对象的新的名称。
--schema <SCHEMA>对象的有效 JSON 模式。
glance md-property-create¶
usage: glance md-property-create --name <NAME> --title <TITLE> --schema
<SCHEMA>
<NAMESPACE>
在命名空间内创建一个新的元数据定义属性。
位置参数
<NAMESPACE>属性将所属的命名空间名称。
可选参数
--name <NAME>属性的内部名称。
--title <TITLE>向用户显示的属性名称。
--schema <SCHEMA>属性的有效 JSON 模式。
glance md-property-delete¶
usage: glance md-property-delete <NAMESPACE> <PROPERTY>
删除命名空间内的特定元数据定义属性。
位置参数
<NAMESPACE>属性所属的命名空间名称。
<PROPERTY>属性的名称。
glance md-property-list¶
usage: glance md-property-list <NAMESPACE>
列出特定命名空间内的元数据定义属性。
位置参数
<NAMESPACE>命名空间名称。
glance md-property-show¶
usage: glance md-property-show [--max-column-width <integer>]
<NAMESPACE> <PROPERTY>
描述命名空间内的特定元数据定义属性。
位置参数
<NAMESPACE>属性所属的命名空间名称。
<PROPERTY>属性的名称。
可选参数
--max-column-width <integer>打印表格的最大列宽。
glance md-property-update¶
usage: glance md-property-update [--name <NAME>] [--title <TITLE>]
[--schema <SCHEMA>]
<NAMESPACE> <PROPERTY>
更新命名空间内的元数据定义属性。
位置参数
<NAMESPACE>属性所属的命名空间名称。
<PROPERTY>属性的名称。
可选参数
--name <NAME>属性的新名称。
--title <TITLE>向用户显示的属性名称。
--schema <SCHEMA>属性的有效 JSON 模式。
glance md-resource-type-associate¶
usage: glance md-resource-type-associate [--updated-at <UPDATED_AT>]
[--name <NAME>]
[--properties-target <PROPERTIES_TARGET>]
[--prefix <PREFIX>]
[--created-at <CREATED_AT>]
<NAMESPACE>
将资源类型与元数据定义命名空间关联。
位置参数
<NAMESPACE>命名空间名称。
可选参数
--updated-at <UPDATED_AT>上次资源类型关联修改的时间。
--name <NAME>资源类型名称应尽可能与 Heat 资源类型对齐：https://docs.openstack.org/heat/2025.2/template_guide/openstack.html
--properties-target <PROPERTIES_TARGET>某些资源类型允许每个实例使用多个键/值对。例如，Cinder 允许卷上的用户和镜像元数据。Nova（调度或驱动程序）仅评估镜像属性元数据。此属性允许命名空间目标消除歧义。
--prefix <PREFIX>指定应用于给定资源类型的前缀。当应用于指定资源类型时，命名空间中的所有属性都应使用此前缀作为前缀。必须包含前缀分隔符（例如冒号：）。
--created-at <CREATED_AT>资源类型关联的时间。
glance md-resource-type-deassociate¶
usage: glance md-resource-type-deassociate <NAMESPACE> <RESOURCE_TYPE>
将资源类型与元数据定义命名空间取消关联。
位置参数
<NAMESPACE>命名空间名称。
<RESOURCE_TYPE>资源类型的名称。
glance md-resource-type-list¶
usage: glance md-resource-type-list
列出可用的资源类型名称。
glance md-tag-create¶
usage: glance md-tag-create --name <NAME> <NAMESPACE>
在命名空间内添加一个新的元数据定义标签。
位置参数
<NAMESPACE>标签将所属的命名空间名称。
可选参数
--name <NAME>要添加的新标签的名称。
glance md-tag-create-multiple¶
usage: glance md-tag-create-multiple --names <NAMES> [--delim <DELIM>]
<NAMESPACE>
在命名空间内创建新的元数据定义标签。
位置参数
<NAMESPACE>标签将所属的命名空间名称。
可选参数
--names <NAMES>逗号分隔的标签名称列表。
--delim <DELIM>用于分隔名称的分隔符（如果未提供，则默认值为逗号）。
glance md-tag-delete¶
usage: glance md-tag-delete <NAMESPACE> <TAG>
删除命名空间内的特定元数据定义标签。
位置参数
<NAMESPACE>标签所属的命名空间名称。
<TAG>标签的名称。
glance md-tag-list¶
usage: glance md-tag-list <NAMESPACE>
列出特定命名空间内的元数据定义标签。
位置参数
<NAMESPACE>命名空间名称。
glance md-tag-show¶
usage: glance md-tag-show <NAMESPACE> <TAG>
描述命名空间内的特定元数据定义标签。
位置参数
<NAMESPACE>标签所属的命名空间名称。
<TAG>标签的名称。
glance md-tag-update¶
usage: glance md-tag-update --name <NAME> <NAMESPACE> <TAG>
在命名空间内重命名元数据定义标签。
位置参数
<NAMESPACE>标签所属的命名空间名称。
<TAG>旧标签的名称。
可选参数
--name <NAME>新标签的新名称。
glance member-create¶
usage: glance member-create <IMAGE_ID> <MEMBER_ID>
为给定的镜像创建成员。
位置参数
<IMAGE_ID>要创建成员的镜像。
<MEMBER_ID>要添加为成员的租户。
glance member-delete¶
usage: glance member-delete <IMAGE_ID> <MEMBER_ID>
删除镜像成员。
位置参数
<IMAGE_ID>要从中删除成员的镜像。
<MEMBER_ID>要删除为成员的租户。
glance member-list¶
usage: glance member-list --image-id <IMAGE_ID>
按镜像描述共享权限。
可选参数
--image-id <IMAGE_ID>要显示成员的镜像。
glance member-update¶
usage: glance member-update <IMAGE_ID> <MEMBER_ID> <MEMBER_STATUS>
更新给定镜像的成员状态。
位置参数
<IMAGE_ID>要从中更新成员的镜像。
<MEMBER_ID>要更新的租户。
<MEMBER_STATUS>成员的更新状态。有效值：accepted, rejected, pending
glance task-create¶
usage: glance task-create [--type <TYPE>] [--input <STRING>]
创建一个新的任务。
可选参数
--type <TYPE>任务类型。请参考 Glance 模式或文档，以查看支持哪些任务。
--input <STRING>要启动的任务的参数
glance task-list¶
usage: glance task-list [--sort-key {id,type,status}] [--sort-dir {asc,desc}]
[--page-size <SIZE>] [--type <TYPE>]
[--status <STATUS>]
列出您可以访问的任务。
可选参数
--sort-key {id,type,status}按指定的字段对任务列表进行排序。
--sort-dir {asc,desc}按指定的方向对任务列表进行排序。
--page-size <SIZE>每个分页请求中请求的任务数量。
--type <TYPE>将任务过滤为具有此类型的任务。
--status <STATUS>将任务过滤为具有此状态的任务。
glance task-show¶
usage: glance task-show <TASK_ID>
描述特定的任务。
位置参数
<TASK_ID>要描述的任务的 ID。
