Red Hat Summit Red Hat SummitSuporteConsoleDesenvolvedoresComeçar um testeContato

Este conteúdo não está disponível no idioma selecionado.

Chapter 5. Image service (glance) command-line client

The glance client is the command-line interface (CLI) for the Image service (glance) API and its extensions.

This chapter documents glance version 2.6.0.

Note

The Image service property keys are documented in the Instances and Images Guide

For help on a specific glance command, enter: 

$ glance help COMMAND
Copy to Clipboard Toggle word wrap

5.1. glance usage
Copiar o link

usage: glance [--version] [-d] [-v] [--get-schema] [--no-ssl-compression] [-f]
              [--os-image-url OS_IMAGE_URL]
              [--os-image-api-version OS_IMAGE_API_VERSION]
              [--profile HMAC_KEY] [--key-file OS_KEY] [--ca-file OS_CACERT]
              [--cert-file OS_CERT] [--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> ...
Copy to Clipboard Toggle word wrap

5.2. glance optional arguments
Copiar o link

--version
show program’s version number and exit
-d, --debug
Defaults to env[GLANCECLIENT_DEBUG].
-v, --verbose
Print more verbose output.
--get-schema
Ignores cached copy and forces retrieval of schema that generates portions of the help text. Ignored with API version 1.
--no-ssl-compression
DEPRECATED! This option is deprecated and not used anymore. SSL compression should be disabled by default by the system SSL library.
-f, --force
Prevent select actions from requesting user confirmation.
--os-image-url OS_IMAGE_URL
Defaults to env[OS_IMAGE_URL]. If the provided image url contains a version number and --os-image-api-version is omitted the version of the URL will be picked as the image api version to use.
--os-image-api-version OS_IMAGE_API_VERSION
Defaults to env[OS_IMAGE_API_VERSION] or 2.
--profile HMAC_KEY
HMAC key to use for encrypting context data for performance profiling of operation. This key should be the value of HMAC key configured in osprofiler middleware in glance, it is specified in paste configuration file at /etc/glance/api-paste.ini and /etc/glance/registry-paste.ini. Without key the profiling will not be triggered even if osprofiler is enabled on server side.
--key-file OS_KEY
DEPRECATED! Use --os-key.
--ca-file OS_CACERT
DEPRECATED! Use --os-cacert.
--cert-file OS_CERT
DEPRECATED! Use --os-cert.
--os-region-name OS_REGION_NAME
Defaults to env[OS_REGION_NAME].
--os-auth-token OS_AUTH_TOKEN
Defaults to env[OS_AUTH_TOKEN].
--os-service-type OS_SERVICE_TYPE
Defaults to env[OS_SERVICE_TYPE].
--os-endpoint-type OS_ENDPOINT_TYPE
Defaults to env[OS_ENDPOINT_TYPE].
--os-auth-type <name>, --os-auth-plugin <name>
Authentication type to use

5.2.1. glance explain
Copiar o link

usage: glance explain <MODEL>
Copy to Clipboard Toggle word wrap

Describe a specific model.

Positional arguments:

<MODEL>
Name of model to describe.

5.2.2. glance image-create
Copiar o link

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]
Copy to Clipboard Toggle word wrap

Create a new image.

Optional arguments:

--architecture <ARCHITECTURE>
Operating system architecture.
--protected [True|False]
If true, image will not be deletable.
--name <NAME>
Descriptive name for the image
--instance-uuid <INSTANCE_UUID>
Metadata which can be used to record which instance this image is associated with. (Informational only, does not create an instance snapshot.)
--min-disk <MIN_DISK>
Amount of disk space (in GB) required to boot image.
--visibility <VISIBILITY>
Scope of image accessibility Valid values: public, private, community, shared
--kernel-id <KERNEL_ID>
ID of image stored in Glance that should be used as the kernel when booting an AMI-style image.
--tags <TAGS> [<TAGS> …​]
List of strings related to the image
--os-version <OS_VERSION>
Operating system version as specified by the distributor
--disk-format <DISK_FORMAT>
Format of the disk Valid values: None, ami, ari, aki, vhd, vhdx, vmdk, raw, qcow2, vdi, iso, ploop
--os-distro <OS_DISTRO>
Common name of operating system distribution.
--id <ID>
An identifier for the image
--owner <OWNER>
Owner of the image
--ramdisk-id <RAMDISK_ID>
ID of image stored in Glance that should be used as the ramdisk when booting an AMI-style image.
--min-ram <MIN_RAM>
Amount of ram (in MB) required to boot image.
--container-format <CONTAINER_FORMAT>
Format of the container Valid values: None, ami, ari, aki, bare, ovf, ova, docker
--property <key=value>
Arbitrary property to associate with image. May be used multiple times.
--file <FILE>
Local file that contains disk image to be uploaded during creation. Alternatively, the image data can be passed to the client via stdin.
--progress
Show upload progress bar.

5.2.3. glance image-deactivate
Copiar o link

usage: glance image-deactivate <IMAGE_ID>
Copy to Clipboard Toggle word wrap

Deactivate specified image.

Positional arguments:

<IMAGE_ID>
ID of image to deactivate.

5.2.4. glance image-delete
Copiar o link

usage: glance image-delete <IMAGE_ID> [<IMAGE_ID> ...]
Copy to Clipboard Toggle word wrap

Delete specified image.

Positional arguments:

<IMAGE_ID>
ID of image(s) to delete.

5.2.5. glance image-download
Copiar o link

usage: glance image-download [--file <FILE>] [--progress] <IMAGE_ID>
Copy to Clipboard Toggle word wrap

Download a specific image.

Positional arguments:

<IMAGE_ID>
ID of image to download.

Optional arguments:

--file <FILE>
Local file to save downloaded image data to. If this is not specified and there is no redirection the image data will not be saved.
--progress
Show download progress bar.

5.2.6. glance image-list
Copiar o link

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>]]
Copy to Clipboard Toggle word wrap

List images you can access.

Optional arguments:

--limit <LIMIT>
Maximum number of images to get.
--page-size <SIZE>
Number of images to request in each paginated request.
--visibility <VISIBILITY>
The visibility of the images to display.
--member-status <MEMBER_STATUS>
The status of images to display.
--owner <OWNER>
Display images owned by <OWNER>.
--property-filter <KEY=VALUE>
Filter images by a user-defined image property.
--checksum <CHECKSUM>
Displays images that match the checksum.
--tag <TAG>
Filter images by a user-defined tag.
--sort-key {name,status,container_format,disk_format,size,id,created_at,updated_at}
Sort image list by specified fields. May be used multiple times.
--sort-dir {asc,desc}
Sort image list in specified directions.
--sort <key>[:<direction>]
Comma-separated list of sort keys and directions in the form of <key>[:<asc|desc>]. Valid keys: name, status, container_format, disk_format, size, id, created_at, updated_at. OPTIONAL.

5.2.7. glance image-reactivate
Copiar o link

usage: glance image-reactivate <IMAGE_ID>
Copy to Clipboard Toggle word wrap

Reactivate specified image.

Positional arguments:

<IMAGE_ID>
ID of image to reactivate.

5.2.8. glance image-show
Copiar o link

usage: glance image-show [--human-readable] [--max-column-width <integer>]
                         <IMAGE_ID>
Copy to Clipboard Toggle word wrap

Describe a specific image.

Positional arguments:

<IMAGE_ID>
ID of image to describe.

Optional arguments:

--human-readable
Print image size in a human-friendly format.
--max-column-width <integer>
The max column width of the printed table.

5.2.9. glance image-tag-delete
Copiar o link

usage: glance image-tag-delete <IMAGE_ID> <TAG_VALUE>
Copy to Clipboard Toggle word wrap

Delete the tag associated with the given image.

Positional arguments:

<IMAGE_ID>
ID of the image from which to delete tag.
<TAG_VALUE>
Value of the tag.

5.2.10. glance image-tag-update
Copiar o link

usage: glance image-tag-update <IMAGE_ID> <TAG_VALUE>
Copy to Clipboard Toggle word wrap

Update an image with the given tag.

Positional arguments:

<IMAGE_ID>
Image to be updated with the given tag.
<TAG_VALUE>
Value of the tag.

5.2.11. glance image-update
Copiar o link

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>
Copy to Clipboard Toggle word wrap

Update an existing image.

Positional arguments:

<IMAGE_ID>
ID of image to update.

Optional arguments:

--architecture <ARCHITECTURE>
Operating system architecture.
--protected [True|False]
If true, image will not be deletable.
--name <NAME>
Descriptive name for the image
--instance-uuid <INSTANCE_UUID>
Metadata which can be used to record which instance this image is associated with. (Informational only, does not create an instance snapshot.)
--min-disk <MIN_DISK>
Amount of disk space (in GB) required to boot image.
--visibility <VISIBILITY>
Scope of image accessibility Valid values: public, private, community, shared
--kernel-id <KERNEL_ID>
ID of image stored in Glance that should be used as the kernel when booting an AMI-style image.
--os-version <OS_VERSION>
Operating system version as specified by the distributor
--disk-format <DISK_FORMAT>
Format of the disk Valid values: None, ami, ari, aki, vhd, vhdx, vmdk, raw, qcow2, vdi, iso, ploop
--os-distro <OS_DISTRO>
Common name of operating system distribution.
--owner <OWNER>
Owner of the image
--ramdisk-id <RAMDISK_ID>
ID of image stored in Glance that should be used as the ramdisk when booting an AMI-style image.
--min-ram <MIN_RAM>
Amount of ram (in MB) required to boot image.
--container-format <CONTAINER_FORMAT>
Format of the container Valid values: None, ami, ari, aki, bare, ovf, ova, docker
--property <key=value>
Arbitrary property to associate with image. May be used multiple times.
--remove-property
key Name of arbitrary property to remove from the image.

5.2.12. glance image-upload
Copiar o link

usage: glance image-upload [--file <FILE>] [--size <IMAGE_SIZE>] [--progress]
                           <IMAGE_ID>
Copy to Clipboard Toggle word wrap

Upload data for a specific image.

Positional arguments:

<IMAGE_ID>
ID of image to upload data to.

Optional arguments:

--file <FILE>
Local file that contains disk image to be uploaded. Alternatively, images can be passed to the client via stdin.
--size <IMAGE_SIZE>
Size in bytes of image to be uploaded. Default is to get size from provided data object but this is supported in case where size cannot be inferred.
--progress
Show upload progress bar.

5.2.13. glance location-add
Copiar o link

usage: glance location-add --url <URL> [--metadata <STRING>] <IMAGE_ID>
Copy to Clipboard Toggle word wrap

Add a location (and related metadata) to an image.

Positional arguments:

<IMAGE_ID>
ID of image to which the location is to be added.

Optional arguments:

--url <URL>
URL of location to add.
--metadata <STRING>
Metadata associated with the location. Must be a valid JSON object (default: {})

5.2.14. glance location-delete
Copiar o link

usage: glance location-delete --url <URL> <IMAGE_ID>
Copy to Clipboard Toggle word wrap

Remove locations (and related metadata) from an image.

Positional arguments:

<IMAGE_ID>
ID of image whose locations are to be removed.

Optional arguments:

--url <URL>
URL of location to remove. May be used multiple times.

5.2.15. glance location-update
Copiar o link

usage: glance location-update --url <URL> [--metadata <STRING>] <IMAGE_ID>
Copy to Clipboard Toggle word wrap

Update metadata of an image’s location.

Positional arguments:

<IMAGE_ID>
ID of image whose location is to be updated.

Optional arguments:

--url <URL>
URL of location to update.
--metadata <STRING>
Metadata associated with the location. Must be a valid JSON object (default: {})

5.2.16. glance md-namespace-create
Copiar o link

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>
Copy to Clipboard Toggle word wrap

Create a new metadata definitions namespace.

Positional arguments:

<NAMESPACE>
Name of the namespace.

Optional arguments:

--schema <SCHEMA>

--created-at <CREATED_AT>
Date and time of namespace creation.

--resource-type-associations <RESOURCE_TYPE_ASSOCIATIONS> […​]

--protected [True|False]
If true, namespace will not be deletable.

--self <SELF>

--display-name <DISPLAY_NAME>
The user friendly name for the namespace. Used by UI if available.
--owner <OWNER>
Owner of the namespace.
--visibility <VISIBILITY>
Scope of namespace accessibility. Valid values: public, private
--updated-at <UPDATED_AT>
Date and time of the last namespace modification.
--description <DESCRIPTION>
Provides a user friendly description of the namespace.

5.2.17. glance md-namespace-delete
Copiar o link

usage: glance md-namespace-delete <NAMESPACE>
Copy to Clipboard Toggle word wrap

Delete specified metadata definitions namespace with its contents.

Positional arguments:

<NAMESPACE>
Name of namespace to delete.

5.2.18. glance md-namespace-import
Copiar o link

usage: glance md-namespace-import [--file <FILEPATH>]
Copy to Clipboard Toggle word wrap

Import a metadata definitions namespace from file or standard input.

Optional arguments:

--file <FILEPATH>
Path to file with namespace schema to import. Alternatively, namespaces schema can be passed to the client via stdin.

5.2.19. glance md-namespace-list
Copiar o link

usage: glance md-namespace-list [--resource-types <RESOURCE_TYPES>]
                                [--visibility <VISIBILITY>]
                                [--page-size <SIZE>]
Copy to Clipboard Toggle word wrap

List metadata definitions namespaces.

Optional arguments:

--resource-types <RESOURCE_TYPES>
Resource type to filter namespaces.
--visibility <VISIBILITY>
Visibility parameter to filter namespaces.
--page-size <SIZE>
Number of namespaces to request in each paginated request.

5.2.20. glance md-namespace-objects-delete
Copiar o link

usage: glance md-namespace-objects-delete <NAMESPACE>
Copy to Clipboard Toggle word wrap

Delete all metadata definitions objects inside a specific namespace.

Positional arguments:

<NAMESPACE>
Name of namespace.

5.2.21. glance md-namespace-properties-delete
Copiar o link

usage: glance md-namespace-properties-delete <NAMESPACE>
Copy to Clipboard Toggle word wrap

Delete all metadata definitions property inside a specific namespace.

Positional arguments:

<NAMESPACE>
Name of namespace.

5.2.22. glance md-namespace-resource-type-list
Copiar o link

usage: glance md-namespace-resource-type-list <NAMESPACE>
Copy to Clipboard Toggle word wrap

List resource types associated to specific namespace.

Positional arguments:

<NAMESPACE>
Name of namespace.

5.2.23. glance md-namespace-show
Copiar o link

usage: glance md-namespace-show [--resource-type <RESOURCE_TYPE>]
                                [--max-column-width <integer>]
                                <NAMESPACE>
Copy to Clipboard Toggle word wrap

Describe a specific metadata definitions namespace. Lists also the namespace properties, objects and resource type associations.

Positional arguments:

<NAMESPACE>
Name of namespace to describe.

Optional arguments:

--resource-type <RESOURCE_TYPE>
Applies prefix of given resource type associated to a namespace to all properties of a namespace.
--max-column-width <integer>
The max column width of the printed table.

5.2.24. glance md-namespace-tags-delete
Copiar o link

usage: glance md-namespace-tags-delete <NAMESPACE>
Copy to Clipboard Toggle word wrap

Delete all metadata definitions tags inside a specific namespace.

Positional arguments:

<NAMESPACE>
Name of namespace.

5.2.25. glance md-namespace-update
Copiar o link

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>
Copy to Clipboard Toggle word wrap

Update an existing metadata definitions namespace.

Positional arguments:

<NAMESPACE>
Name of namespace to update.

Optional arguments:

--created-at <CREATED_AT>
Date and time of namespace creation.
--protected [True|False]
If true, namespace will not be deletable.
--namespace <NAMESPACE>
The unique namespace text.

--self <SELF>

--display-name <DISPLAY_NAME>
The user friendly name for the namespace. Used by UI if available.
--owner <OWNER>
Owner of the namespace.
--visibility <VISIBILITY>
Scope of namespace accessibility. Valid values: public, private
--updated-at <UPDATED_AT>
Date and time of the last namespace modification.
--description <DESCRIPTION>
Provides a user friendly description of the namespace.

5.2.26. glance md-object-create
Copiar o link

usage: glance md-object-create --name <NAME> --schema <SCHEMA> <NAMESPACE>
Copy to Clipboard Toggle word wrap

Create a new metadata definitions object inside a namespace.

Positional arguments:

<NAMESPACE>
Name of namespace the object will belong.

Optional arguments:

--name <NAME>
Internal name of an object.
--schema <SCHEMA>
Valid JSON schema of an object.

5.2.27. glance md-object-delete
Copiar o link

usage: glance md-object-delete <NAMESPACE> <OBJECT>
Copy to Clipboard Toggle word wrap

Delete a specific metadata definitions object inside a namespace.

Positional arguments:

<NAMESPACE>
Name of namespace the object belongs.
<OBJECT>
Name of an object.

5.2.28. glance md-object-list
Copiar o link

usage: glance md-object-list <NAMESPACE>
Copy to Clipboard Toggle word wrap

List metadata definitions objects inside a specific namespace.

Positional arguments:

<NAMESPACE>
Name of namespace.

5.2.29. glance md-object-property-show
Copiar o link

usage: glance md-object-property-show [--max-column-width <integer>]
                                      <NAMESPACE> <OBJECT> <PROPERTY>
Copy to Clipboard Toggle word wrap

Describe a specific metadata definitions property inside an object.

Positional arguments:

<NAMESPACE>
Name of namespace the object belongs.
<OBJECT>
Name of an object.
<PROPERTY>
Name of a property.

Optional arguments:

--max-column-width <integer>
The max column width of the printed table.

5.2.30. glance md-object-show
Copiar o link

usage: glance md-object-show [--max-column-width <integer>]
                             <NAMESPACE> <OBJECT>
Copy to Clipboard Toggle word wrap

Describe a specific metadata definitions object inside a namespace.

Positional arguments:

<NAMESPACE>
Name of namespace the object belongs.
<OBJECT>
Name of an object.

Optional arguments:

--max-column-width <integer>
The max column width of the printed table.

5.2.31. glance md-object-update
Copiar o link

usage: glance md-object-update [--name <NAME>] [--schema <SCHEMA>]
                               <NAMESPACE> <OBJECT>
Copy to Clipboard Toggle word wrap

Update metadata definitions object inside a namespace.

Positional arguments:

<NAMESPACE>
Name of namespace the object belongs.
<OBJECT>
Name of an object.

Optional arguments:

--name <NAME>
New name of an object.
--schema <SCHEMA>
Valid JSON schema of an object.

5.2.32. glance md-property-create
Copiar o link

usage: glance md-property-create --name <NAME> --title <TITLE> --schema
                                 <SCHEMA>
                                 <NAMESPACE>
Copy to Clipboard Toggle word wrap

Create a new metadata definitions property inside a namespace.

Positional arguments:

<NAMESPACE>
Name of namespace the property will belong.

Optional arguments:

--name <NAME>
Internal name of a property.
--title <TITLE>
Property name displayed to the user.
--schema <SCHEMA>
Valid JSON schema of a property.

5.2.33. glance md-property-delete
Copiar o link

usage: glance md-property-delete <NAMESPACE> <PROPERTY>
Copy to Clipboard Toggle word wrap

Delete a specific metadata definitions property inside a namespace.

Positional arguments:

<NAMESPACE>
Name of namespace the property belongs.
<PROPERTY>
Name of a property.

5.2.34. glance md-property-list
Copiar o link

usage: glance md-property-list <NAMESPACE>
Copy to Clipboard Toggle word wrap

List metadata definitions properties inside a specific namespace.

Positional arguments:

<NAMESPACE>
Name of namespace.

5.2.35. glance md-property-show
Copiar o link

usage: glance md-property-show [--max-column-width <integer>]
                               <NAMESPACE> <PROPERTY>
Copy to Clipboard Toggle word wrap

Describe a specific metadata definitions property inside a namespace.

Positional arguments:

<NAMESPACE>
Name of namespace the property belongs.
<PROPERTY>
Name of a property.

Optional arguments:

--max-column-width <integer>
The max column width of the printed table.

5.2.36. glance md-property-update
Copiar o link

usage: glance md-property-update [--name <NAME>] [--title <TITLE>]
                                 [--schema <SCHEMA>]
                                 <NAMESPACE> <PROPERTY>
Copy to Clipboard Toggle word wrap

Update metadata definitions property inside a namespace.

Positional arguments:

<NAMESPACE>
Name of namespace the property belongs.
<PROPERTY>
Name of a property.

Optional arguments:

--name <NAME>
New name of a property.
--title <TITLE>
Property name displayed to the user.
--schema <SCHEMA>
Valid JSON schema of a property.

5.2.37. glance md-resource-type-associate
Copiar o link

usage: glance md-resource-type-associate [--updated-at <UPDATED_AT>]
                                         [--name <NAME>]
                                         [--properties-target <PROPERTIES_TARGET>]
                                         [--prefix <PREFIX>]
                                         [--created-at <CREATED_AT>]
                                         <NAMESPACE>
Copy to Clipboard Toggle word wrap

Associate resource type with a metadata definitions namespace.

Positional arguments:

<NAMESPACE>
Name of namespace.

Optional arguments:

--updated-at <UPDATED_AT>
Date and time of the last resource type association modification.
--name <NAME>
Resource type names should be aligned with Heat resource types whenever possible.
--properties-target <PROPERTIES_TARGET>
Some resource types allow more than one key / value pair per instance. For example, Cinder allows user and image metadata on volumes. Only the image properties metadata is evaluated by Nova (scheduling or drivers). This property allows a namespace target to remove the ambiguity.
--prefix <PREFIX>
Specifies the prefix to use for the given resource type. Any properties in the namespace should be prefixed with this prefix when being applied to the specified resource type. Must include prefix separator (e.g. a colon :).
--created-at <CREATED_AT>
Date and time of resource type association.

5.2.38. glance md-resource-type-deassociate
Copiar o link

usage: glance md-resource-type-deassociate <NAMESPACE> <RESOURCE_TYPE>
Copy to Clipboard Toggle word wrap

Deassociate resource type with a metadata definitions namespace.

Positional arguments:

<NAMESPACE>
Name of namespace.
<RESOURCE_TYPE>
Name of resource type.

5.2.39. glance md-resource-type-list
Copiar o link

usage: glance md-resource-type-list
Copy to Clipboard Toggle word wrap

List available resource type names.

5.2.40. glance md-tag-create
Copiar o link

usage: glance md-tag-create --name <NAME> <NAMESPACE>
Copy to Clipboard Toggle word wrap

Add a new metadata definitions tag inside a namespace.

Positional arguments:

<NAMESPACE>
Name of the namespace the tag will belong to.

Optional arguments:

--name <NAME>
The name of the new tag to add.

5.2.41. glance md-tag-create-multiple
Copiar o link

usage: glance md-tag-create-multiple --names <NAMES> [--delim <DELIM>]
                                     <NAMESPACE>
Copy to Clipboard Toggle word wrap

Create new metadata definitions tags inside a namespace.

Positional arguments:

<NAMESPACE>
Name of the namespace the tags will belong to.

Optional arguments:

--names <NAMES>
A comma separated list of tag names.
--delim <DELIM>
The delimiter used to separate the names (if none is provided then the default is a comma).

5.2.42. glance md-tag-delete
Copiar o link

usage: glance md-tag-delete <NAMESPACE> <TAG>
Copy to Clipboard Toggle word wrap

Delete a specific metadata definitions tag inside a namespace.

Positional arguments:

<NAMESPACE>
Name of the namespace to which the tag belongs.
<TAG>
Name of the tag.

5.2.43. glance md-tag-list
Copiar o link

usage: glance md-tag-list <NAMESPACE>
Copy to Clipboard Toggle word wrap

List metadata definitions tags inside a specific namespace.

Positional arguments:

<NAMESPACE>
Name of namespace.

5.2.44. glance md-tag-show
Copiar o link

usage: glance md-tag-show <NAMESPACE> <TAG>
Copy to Clipboard Toggle word wrap

Describe a specific metadata definitions tag inside a namespace.

Positional arguments:

<NAMESPACE>
Name of the namespace to which the tag belongs.
<TAG>
Name of the tag.

5.2.45. glance md-tag-update
Copiar o link

usage: glance md-tag-update --name <NAME> <NAMESPACE> <TAG>
Copy to Clipboard Toggle word wrap

Rename a metadata definitions tag inside a namespace.

Positional arguments:

<NAMESPACE>
Name of the namespace to which the tag belongs.
<TAG>
Name of the old tag.

Optional arguments:

--name <NAME>
New name of the new tag.

5.2.46. glance member-create
Copiar o link

usage: glance member-create <IMAGE_ID> <MEMBER_ID>
Copy to Clipboard Toggle word wrap

Create member for a given image.

Positional arguments:

<IMAGE_ID>
Image with which to create member.
<MEMBER_ID>
Tenant to add as member.

5.2.47. glance member-delete
Copiar o link

usage: glance member-delete <IMAGE_ID> <MEMBER_ID>
Copy to Clipboard Toggle word wrap

Delete image member.

Positional arguments:

<IMAGE_ID>
Image from which to remove member.
<MEMBER_ID>
Tenant to remove as member.

5.2.48. glance member-list
Copiar o link

usage: glance member-list --image-id <IMAGE_ID>
Copy to Clipboard Toggle word wrap

Describe sharing permissions by image.

Optional arguments:

--image-id <IMAGE_ID>
Image to display members of.

5.2.49. glance member-update
Copiar o link

usage: glance member-update <IMAGE_ID> <MEMBER_ID> <MEMBER_STATUS>
Copy to Clipboard Toggle word wrap

Update the status of a member for a given image.

Positional arguments:

<IMAGE_ID>
Image from which to update member.
<MEMBER_ID>
Tenant to update.
<MEMBER_STATUS>
Updated status of member. Valid Values: accepted, rejected, pending

5.2.50. glance task-create
Copiar o link

usage: glance task-create [--type <TYPE>] [--input <STRING>]
Copy to Clipboard Toggle word wrap

Create a new task.

Optional arguments:

--type <TYPE>
Type of Task. Please refer to Glance schema or documentation to see which tasks are supported.
--input <STRING>
Parameters of the task to be launched

5.2.51. glance task-list
Copiar o link

usage: glance task-list [--sort-key {id,type,status}] [--sort-dir {asc,desc}]
                        [--page-size <SIZE>] [--type <TYPE>]
                        [--status <STATUS>]
Copy to Clipboard Toggle word wrap

List tasks you can access.

Optional arguments:

--sort-key {id,type,status}
Sort task list by specified field.
--sort-dir {asc,desc}
Sort task list in specified direction.
--page-size <SIZE>
Number of tasks to request in each paginated request.
--type <TYPE>
Filter tasks to those that have this type.
--status <STATUS>
Filter tasks to those that have this status.

5.2.52. glance task-show
Copiar o link

usage: glance task-show <TASK_ID>
Copy to Clipboard Toggle word wrap

Describe a specific task.

Positional arguments:

<TASK_ID>
ID of task to describe.
Voltar ao topo
Red Hat logoGithubredditYoutubeTwitter

Aprender

Experimente, compre e venda

Comunidades

Sobre a documentação da Red Hat

Ajudamos os usuários da Red Hat a inovar e atingir seus objetivos com nossos produtos e serviços com conteúdo em que podem confiar. Explore nossas atualizações recentes.

Tornando o open source mais inclusivo

A Red Hat está comprometida em substituir a linguagem problemática em nosso código, documentação e propriedades da web. Para mais detalhes veja o Blog da Red Hat.

Sobre a Red Hat

Fornecemos soluções robustas que facilitam o trabalho das empresas em plataformas e ambientes, desde o data center principal até a borda da rede.

Theme

© 2025 Red Hat