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>] [--collect-timing] [--tls-ciphers <ciphers>]
[--tls-min-version {None,1.2,1.3}] [--os-auth-type <name>]
[--os-auth-url OS_AUTH_URL] [--os-system-scope OS_SYSTEM_SCOPE]
[--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> ...
Command-line interface to the OpenStack Images API.
Positional arguments:
<subcommand>
add-location Add location to an image which is in `queued` state only.
cache-clean Clean invalid and stalled cached images.
cache-clear Clear all images from cache, queue or both
cache-delete Delete image from cache/caching queue.
cache-list Get cache state.
cache-nodes-list List node reference URLs where an image is cached.
cache-prune Prune cached images to reduce cache size.
cache-queue Queue image(s) for caching.
explain Describe a specific model.
image-create Create a new image.
image-create-via-import
EXPERIMENTAL: Create a new image via image import.
image-deactivate Deactivate specified image.
image-delete Delete specified image.
image-download Download a specific image.
image-import Initiate the image import taskflow.
image-list List images you can access.
image-reactivate Reactivate specified image.
image-show Describe a specific image.
image-stage Upload data for a specific image to staging.
image-tag-delete Delete the tag associated with the given image.
image-tag-update Update an image with the given tag.
image-tasks Get tasks associated with image
image-update Update an existing image.
image-upload Upload data for a specific image.
import-info Print import methods available from Glance.
location-add Add a location (and related metadata) to an image.
location-delete Remove locations (and related metadata) from an image.
location-update Update metadata of an image's location.
md-namespace-create
Create a new metadata definitions namespace.
md-namespace-delete
Delete specified metadata definitions namespace with its contents.
md-namespace-import
Import a metadata definitions namespace from file or standard input.
md-namespace-list List metadata definitions namespaces.
md-namespace-objects-delete
Delete all metadata definitions objects inside a specific namespace.
md-namespace-properties-delete
Delete all metadata definitions property inside a specific namespace.
md-namespace-resource-type-list
List resource types associated to specific namespace.
md-namespace-show Describe a specific metadata definitions namespace.
md-namespace-tags-delete
Delete all metadata definitions tags inside a specific namespace.
md-namespace-update
Update an existing metadata definitions namespace.
md-object-create Create a new metadata definitions object inside a namespace.
md-object-delete Delete a specific metadata definitions object inside a namespace.
md-object-list List metadata definitions objects inside a specific namespace.
md-object-property-show
Describe a specific metadata definitions property inside an object.
md-object-show Describe a specific metadata definitions object inside a namespace.
md-object-update Update metadata definitions object inside a namespace.
md-property-create Create a new metadata definitions property inside a namespace.
md-property-delete Delete a specific metadata definitions property inside a namespace.
md-property-list List metadata definitions properties inside a specific namespace.
md-property-show Describe a specific metadata definitions property inside a namespace.
md-property-update Update metadata definitions property inside a namespace.
md-resource-type-associate
Associate resource type with a metadata definitions namespace.
md-resource-type-deassociate
Deassociate resource type with a metadata definitions namespace.
md-resource-type-list
List available resource type names.
md-tag-create Add a new metadata definitions tag inside a namespace.
md-tag-create-multiple
Create new metadata definitions tags inside a namespace.
md-tag-delete Delete a specific metadata definitions tag inside a namespace.
md-tag-list List metadata definitions tags inside a specific namespace.
md-tag-show Describe a specific metadata definitions tag inside a namespace.
md-tag-update Rename a metadata definitions tag inside a namespace.
member-create Create member for a given image.
member-delete Delete image member.
member-get Show details of an image member
member-list Describe sharing permissions by image.
member-update Update the status of a member for a given image.
stores-delete Delete image from specific store.
stores-info Print available backends from Glance.
task-create Create a new task.
task-list List tasks you can access.
task-show Describe a specific task.
usage Get quota usage information.
bash-completion Prints arguments for bash_completion.
help Display help about this program or one of its subcommands.
Options:
--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.
-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 glance configuration
file at /etc/glance/glance-api.conf and /etc/glance/glance-registry.conf.
Without key the profiling will not be triggered even if osprofiler is
enabled on server side. Defaults to env[OS_PROFILE].
--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, --os-auth-plugin <name>
Authentication type to use
API Connection Options:
Options controlling the HTTP API Connections
--insecure Explicitly allow client to perform "insecure" TLS (https) requests. The
server's certificate will not be verified against any certificate
authorities. This option should be used with caution.
--os-cacert <ca-certificate>
Specify a CA bundle file to use in verifying a TLS (https) server
certificate. Defaults to env[OS_CACERT].
--os-cert <certificate>
The location for the keystore (PEM formatted) containing the public key of
this client. Defaults to env[OS_CERT].
--os-key <key> The location for the keystore (PEM formatted) containing the private key
of this client. Defaults to env[OS_KEY].
--timeout <seconds> Set request timeout (in seconds).
--collect-timing Collect per-API call timing information.
--tls-ciphers <ciphers>
An OpenSSL cipher string to set the allowed ciphers for TLS connections.
If not specified, the default ciphers from the underlying OpenSSL library
are used. Defaults to env[OS_TLS_CIPHERS].
--tls-min-version {None,1.2,1.3}
The minimum TLS version to require for TLS connections. When not
specified, the behavior is undefined and defers to the system
cryptographic policy. Defaults to env[OS_TLS_MIN_VERSION].
Authentication Options:
Options specific to the password plugin.
--os-auth-url OS_AUTH_URL
Authentication URL
--os-system-scope OS_SYSTEM_SCOPE
Scope for system operations
--os-domain-id OS_DOMAIN_ID
Domain ID to scope to
--os-domain-name OS_DOMAIN_NAME
Domain name to scope to
--os-project-id, --os-tenant-id OS_PROJECT_ID
Project ID to scope to
--os-project-name, --os-tenant-name OS_PROJECT_NAME
Project name to scope to
--os-project-domain-id OS_PROJECT_DOMAIN_ID
Domain ID containing project
--os-project-domain-name OS_PROJECT_DOMAIN_NAME
Domain name containing project
--os-trust-id OS_TRUST_ID
ID of the trust to use as a trustee use
--os-default-domain-id OS_DEFAULT_DOMAIN_ID
Optional domain ID to use with v3 and v2 parameters. It will be used for
both the user and project domain in v3 and ignored in v2 authentication.
--os-default-domain-name OS_DEFAULT_DOMAIN_NAME
Optional domain name to use with v3 API and v2 parameters. It will be used
for both the user and project domain in v3 and ignored in v2
authentication.
--os-user-id OS_USER_ID
User id
--os-username, --os-user-name OS_USERNAME
Username
--os-user-domain-id OS_USER_DOMAIN_ID
User's domain id
--os-user-domain-name OS_USER_DOMAIN_NAME
User's domain name
--os-password OS_PASSWORD
User's password
See "glance help COMMAND" for help on a specific command.
Options (37)
| Option | Description | Source |
|---|---|---|
--version | show program's version number and exit | help |
-d, --debug | Defaults to env[GLANCECLIENT_DEBUG]. | help |
-v, --verbose | Print more verbose output. | help |
--get-schema | Ignores cached copy and forces retrieval of schema that generates portions of the help text. | help |
-f, --force | Prevent select actions from requesting user confirmation. | help |
--os-image-url OS_IMAGE_URL | Defaults to env[OS_IMAGE_URL]. | help |
--os-image-api-version OS_IMAGE_API_VERSION | Defaults to env[OS_IMAGE_API_VERSION] or 2. | help |
--profile HMAC_KEY | HMAC key to use for encrypting context data for performance profiling of operation. | help |
--os-region-name OS_REGION_NAME | Defaults to env[OS_REGION_NAME]. | help |
--os-auth-token OS_AUTH_TOKEN | Defaults to env[OS_AUTH_TOKEN]. | help |
--os-service-type OS_SERVICE_TYPE | Defaults to env[OS_SERVICE_TYPE]. | help |
--os-endpoint-type OS_ENDPOINT_TYPE | Defaults to env[OS_ENDPOINT_TYPE]. | help |
--os-auth-type, --os-auth-plugin name | Authentication type to use | help |
--insecure | Explicitly allow client to perform "insecure" TLS (https) requests. | help |
--os-cacert ca-certificate | Specify a CA bundle file to use in verifying a TLS (https) server certificate. | help |
--os-cert certificate | The location for the keystore (PEM formatted) containing the public key of this client. | help |
--os-key key | The location for the keystore (PEM formatted) containing the private key of this client. | help |
--timeout seconds | Set request timeout (in seconds). | help |
--collect-timing | Collect per-API call timing information. | help |
--tls-ciphers ciphers | An OpenSSL cipher string to set the allowed ciphers for TLS connections. | help |
--tls-min-version None | The minimum TLS version to require for TLS connections. | help |
--os-auth-url OS_AUTH_URL | Authentication URL | help |
--os-system-scope OS_SYSTEM_SCOPE | Scope for system operations | help |
--os-domain-id OS_DOMAIN_ID | Domain ID to scope to | help |
--os-domain-name OS_DOMAIN_NAME | Domain name to scope to | help |
--os-project-id, --os-tenant-id OS_PROJECT_ID | Project ID to scope to | help |
--os-project-name, --os-tenant-name OS_PROJECT_NAME | Project name to scope to | help |
--os-project-domain-id OS_PROJECT_DOMAIN_ID | Domain ID containing project | help |
--os-project-domain-name OS_PROJECT_DOMAIN_NAME | Domain name containing project | help |
--os-trust-id OS_TRUST_ID | ID of the trust to use as a trustee use | help |
--os-default-domain-id OS_DEFAULT_DOMAIN_ID | Optional domain ID to use with v3 and v2 parameters. | help |
--os-default-domain-name OS_DEFAULT_DOMAIN_NAME | Optional domain name to use with v3 API and v2 parameters. | help |
--os-user-id OS_USER_ID | User id | help |
--os-username, --os-user-name OS_USERNAME | Username | help |
--os-user-domain-id OS_USER_DOMAIN_ID | User's domain id | help |
--os-user-domain-name OS_USER_DOMAIN_NAME | User's domain name | help |
--os-password OS_PASSWORD | User's password | help |