glance/doc/source/man/glance.rst

3.3 KiB

glance

Glance command line interface

Author

glance@lists.launchpad.net

Date

2012-01-03

Copyright

OpenStack LLC

Version

2012.1-dev

Manual section

1

Manual group

cloud computing

SYNOPSIS

glance <command> [options] [args]

COMMANDS

help <command>

Output help for one of the commands below

add

Adds a new image to Glance

update

Updates an image's metadata in Glance

delete

Deletes an image from Glance

index

Return brief information about images in Glance

details

Return detailed information about images in Glance

show

Show detailed information about an image in Glance

clear

Removes all images and metadata from Glance

MEMBER COMMANDS

image-members

List members an image is shared with

member-images

List images shared with a member

member-add

Grants a member access to an image

member-delete

Revokes a member's access to an image

members-replace

Replaces all membership for an image

OPTIONS

--version

show program's version number and exit

-h, --help

show this help message and exit

-v, --verbose

Print more verbose output

-d, --debug

Print more verbose output

-H ADDRESS, --host=ADDRESS

Address of Glance API host. Default: 0.0.0.0

-p PORT, --port=PORT

Port the Glance API host listens on. Default: 9292

-U URL, --url=URL

URL of Glance service. This option can be used to specify the hostname, port and protocol (http/https) of the glance server, for example -U https://localhost:9292/v1 Default: None

-k, --insecure

Explicitly allow glance to perform insecure SSL (https) requests. The server certificate will not be verified against any certificate authorities. This option should be used with caution.

-R REGION, --region=REGION

When using keystone authentication version 2.0 or later this identifies the region name to use when selecting the service endpoint. If no region is specified and only one region is available that region will be used by default. Where more than one region endpoint is available a region must be provided.

-A TOKEN, --auth_token=TOKEN

Authentication token to use to identify the client to the glance server

--limit=LIMIT

Page size to use while requesting image metadata

--marker=MARKER

Image index after which to begin pagination

--sort_key=KEY

Sort results by this image attribute.

--sort_dir=[desc|asc]

Sort results in this direction.

-f, --force

Prevent select actions from requesting user confirmation

--dry-run

Don't actually execute the command, just print output showing what WOULD happen.

--can-share

Allow member to further share image.

SEE ALSO

BUGS

  • Glance is sourced in Launchpad so you can view current bugs at OpenStack Glance