OS Manuals

/opt/chainguard/openstack-client-2026.1/bin/glance

OpenStack Command-line Client (python-openstackclient) — 2026.1 Gazpacho

From openstack-client-2026.1 9.0.0_git20261013-r5 (enterprise-packages), captured 2026-11-08 by running glance --help (exit 0). permalink

usage: glance [--version] [-d] [-v] [--get-schema] [-f] [--os-image-url OS_IMAGE_URL]
              [--os-image-api-version OS_IMAGE_API_VERSION] [--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]
              [--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-clear         Clear all images from cache, queue or both
    cache-delete        Delete image from cache/caching queue.
    cache-list          Get cache state.
    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.
  --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.

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 (34)
OptionDescriptionSource
--versionshow program's version number and exithelp
-d, --debugDefaults to env[GLANCECLIENT_DEBUG].help
-v, --verbosePrint more verbose output.help
--get-schemaIgnores cached copy and forces retrieval of schema that generates portions of the help text.help
-f, --forcePrevent select actions from requesting user confirmation.help
--os-image-url OS_IMAGE_URLDefaults to env[OS_IMAGE_URL].help
--os-image-api-version OS_IMAGE_API_VERSIONDefaults to env[OS_IMAGE_API_VERSION] or 2.help
--os-region-name OS_REGION_NAMEDefaults to env[OS_REGION_NAME].help
--os-auth-token OS_AUTH_TOKENDefaults to env[OS_AUTH_TOKEN].help
--os-service-type OS_SERVICE_TYPEDefaults to env[OS_SERVICE_TYPE].help
--os-endpoint-type OS_ENDPOINT_TYPEDefaults to env[OS_ENDPOINT_TYPE].help
--os-auth-type, --os-auth-plugin nameAuthentication type to usehelp
--insecureExplicitly allow client to perform "insecure" TLS (https) requests.help
--os-cacert ca-certificateSpecify a CA bundle file to use in verifying a TLS (https) server certificate.help
--os-cert certificateThe location for the keystore (PEM formatted) containing the public key of this client.help
--os-key keyThe location for the keystore (PEM formatted) containing the private key of this client.help
--timeout secondsSet request timeout (in seconds).help
--collect-timingCollect per-API call timing information.help
--os-auth-url OS_AUTH_URLAuthentication URLhelp
--os-system-scope OS_SYSTEM_SCOPEScope for system operationshelp
--os-domain-id OS_DOMAIN_IDDomain ID to scope tohelp
--os-domain-name OS_DOMAIN_NAMEDomain name to scope tohelp
--os-project-id, --os-tenant-id OS_PROJECT_IDProject ID to scope tohelp
--os-project-name, --os-tenant-name OS_PROJECT_NAMEProject name to scope tohelp
--os-project-domain-id OS_PROJECT_DOMAIN_IDDomain ID containing projecthelp
--os-project-domain-name OS_PROJECT_DOMAIN_NAMEDomain name containing projecthelp
--os-trust-id OS_TRUST_IDID of the trust to use as a trustee usehelp
--os-default-domain-id OS_DEFAULT_DOMAIN_IDOptional domain ID to use with v3 and v2 parameters.help
--os-default-domain-name OS_DEFAULT_DOMAIN_NAMEOptional domain name to use with v3 API and v2 parameters.help
--os-user-id OS_USER_IDUser idhelp
--os-username, --os-user-name OS_USERNAMEUsernamehelp
--os-user-domain-id OS_USER_DOMAIN_IDUser's domain idhelp
--os-user-domain-name OS_USER_DOMAIN_NAMEUser's domain namehelp
--os-password OS_PASSWORDUser's passwordhelp

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.