openstack/python-keystoneclient
Code Issues Proposed changes

more work on standardizing project_id

Browse Source
This commit is contained in:
Jesse Andrews
2011-12-17 23:02:27 -08:00
parent 70f83389a9
commit caad71d1b7
2 changed files with 25 additions and 17 deletions
Download Patch File Download Diff File Expand all files Collapse all files

36
docs/shell.rst
View File

@@ -12,27 +12,33 @@ The :program:`keystone` shell utility
The :program:`keystone` shell utility interacts with OpenStack Keystone API
from the command line. It supports the entirety of the OpenStack Keystone API.
First, you'll need an OpenStack Keystone account and an API key. You get this
by using the `keystone-manage` command in OpenStack Keystone.
First, you'll need an OpenStack Keystone account. You get this by using the
`keystone-manage` command in OpenStack Keystone.
You'll need to provide :program:`keystone` with your OpenStack username and
API key. You can do this with the :option:`--username`, :option:`--apikey`
and :option:`--projectid` options, but it's easier to just set them as
environment variables by setting two environment variables:
password. You can do this with the :option:`--username`, :option:`--password`.
You can optionally specify a :option:`--tenant_id` or :option:`--tenant_name`,
to scope your token to a specific tenant. If you don't specify a tenant, you
will be scoped to your default tenant if you have one. Instead of using
options, it is easier to just set them as environment variables:
.. envvar:: KEYSTONE_USERNAME
.. envvar:: OS_USERNAME
Your Keystone username.
.. envvar:: KEYSTONE_API_KEY
.. envvar:: OS_PASSWORD
Your API key.
Your Keystone password.
.. envvar:: KEYSTONE_PROJECT_ID
.. envvar:: OS_TENANT_NAME
Project for work.
Name of Keystone Tenant.
.. envvar:: KEYSTONE_URL
.. envvar:: OS_TENANT_ID
ID of Keystone Tenant.
.. envvar:: OS_AUTH_URL
The OpenStack API server URL.
@@ -42,10 +48,10 @@ environment variables by setting two environment variables:
For example, in Bash you'd use::
export KEYSTONE_USERNAME=yourname
export KEYSTONE_API_KEY=yadayadayada
export KEYSTONE_PROJECT_ID=myproject
export KEYSTONE_URL=http://...
export OS_USERNAME=yourname
export OS_PASSWORD=yadayadayada
export OS_TENANT_NAME=myproject
export OS_AUTH_URL=http://example.com:5000/v2.0/
export KEYSTONE_VERSION=2.0
From there, all shell commands take the form::

6
keystoneclient/v2_0/client.py
View File

@@ -33,7 +33,9 @@ class Client(client.HTTPClient):
:param string username: Username for authentication. (optional)
:param string password: Password for authentication. (optional)
:param string token: Token for authentication. (optional)
:param string project_id: Tenant/Project id. (optional)
:param string tenant_name: Tenant id. (optional)
:param string tenant_id: Tenant name. (optional)
:param string project_id: Converted to tenant name. (deprecated - to be removed in essex)
:param string auth_url: Keystone service endpoint for authorization.
:param string region_name: Name of a region to select when choosing an
endpoint from the service catalog.
@@ -49,7 +51,7 @@ class Client(client.HTTPClient):
>>> from keystoneclient.v2_0 import client
>>> keystone = client.Client(username=USER,
password=PASS,
project_id=TENANT,
tenant_name=TENANT,
auth_url=KEYSTONE_URL)
>>> keystone.tenants.list()
...