687acd7c5e
This patch setup the basic structure for api-ref and adds api-ref for types(instance_types). Partially-Implements: blueprint adopt-api-ref Change-Id: I228891a2aff4b77d2acadc20627c67a55be6a706
28 lines
1.1 KiB
ReStructuredText
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/nimble/v1`` then the full API call for
|
|
``/instances`` is ``http://mycompute.pvt/nimble/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``.
|