mogan/api-ref/source/v1/urls.inc
sxmatch ec9b48ad61 Rename nimble to mogan(part one)
Today we decided to rename Nimble project
since it's same as a Cinder driver name.

The new name of this project is called Mogan.

For convenience of reviewing, this is a part one
which includes api-ref folder.

Change-Id: Ie1f5bc9d29efcdf77c2b981d6102c56490e70022
Partially-Implements: bp rename-nimble-to-mogan
2017-01-04 16:11:13 +08:00

28 lines
1.1 KiB
ReStructuredText

.. -*- rst -*-
==============
Service URLs
==============
All API calls through the rest of this document require authentication
with the OpenStack Identity service. They also required a base
``service url`` that is extracted from the Identity token of type
``baremetal-compute``. This will be the root url that every call below
will be added to build a full path.
For instance, if the ``service url`` is
``http://mycompute.pvt/mogan/v1`` then the full API call for
``/instances`` is ``http://mycompute.pvt/mogan/v1/instances``.
Depending on the deployment the baremetal compute service url might
be http or https, a custom port, a custom path, and include your
tenant id. The only way to know the urls for your deployment is by
using the service catalog. The baremetal compute servic URL should
never be hard coded in applications, even if they are only expected
to work at a single site. It should always be discovered from the
Identity token.
As such, for the rest of this document we will be using short hand
where ``GET /instances`` really means ``GET
{your_service_url}/instances``.