api list

A mash-up of service, region and endpoint listings. api list coughs up the basic information in the service catalog returned by the Identity authentication request. It shows the available services by type, name and region. With a little help from the --long option it adds the actual endpoint URL and a list of the supported versions at that endpoint.

The version support output needs a bit of explaining. Nearly every OpenStack service catalog is configured to include a service API version in the URL. This means that to use a different version requires 'knowledge'. But here we know that these versions are nearly always in the form of vNNN in the URI path.

api list starts at the base URI and looks for returned version information in a couple of the usual JSON formats. If not found it loops adding the URI path components one at a time, stopping when it finds a recognized version response.

The returned service catalog entries can be filtered by service type --type or service name --name.

osc api list
    [--type <service-type>]
    [--name <service-name>]
    [--long]

auth show

auth show displays the authentication information that OSC will use to perform authentication. This command stops just before authentication would otherwise occur so you can see exactly what has been collected from the command line options, environment variables and os-client-config file.

Note that this is one of the rare 'show' commands that does not take a positional argument to determine what to show. This is due to there being ony one thing (authentication options) to choose from, but wanting to present the output in the traditional show command format. This makes grabbing any of these values in a shell script trivial using the --format shell option.

Also, os_password is not displayed, because, duh.

osc auth show

auth type list

auth type list simply lists the authentication plugin types installed and their entry point targets. Handy to see why things are not working as expected.

osc auth type list

auth type show

auth type show shows details of the specified auth plugin type. This includes the options that the plugin type defines. Note that the option names are the internal names, OSC will add --os- prefix to command lise options and OS_ prefix, plus forcing uppercase and replacing - with _ for environment variables.

osc auth type show
    <auth-type>

flavor find

This is the functional basis for the enhanced server create command, directly searching for matching flavors that meet or exceed the specified values for RAM, disk and virtual CPUs.

What is the difference between a find and list command? I don't know yet. List + filtering == find maybe, but remember, this is experimental for a reason.

osc flavor find
    [--ram <size-mb>]
    [--disk <size-gb>]
    [--vcpus <vcpus>]

server create

Extends the stock server create by adding the options to select a flavor directly based on RAM, disk and/or virtual CPUs.

osc server create
    [--ram <size-mb>]
    [--disk <size-gb>]
    [--vcpus <vcpus>]
    ...
    <server-name>

server show

Another command that extends the stock version by changing the output displayed, in this case swapping project_id for tenant_id. This is something that needs to be done in OSC itself as part of our "never show the user a 'tenant'" campaign.

show flavor

Yes! I can restore my long-lost <action> <object> command format just by putting the right things into setup.cfg. Unfortunately, the command class does not know (yet) which command form was given to call it so changing behaviour is not yet possible. This requires a patch to cliff that is in progress and should be released soon.