summaryrefslogtreecommitdiffstats
path: root/docs/api.rst
diff options
context:
space:
mode:
authorfsandoval <frank.sandoval@oamtechnologies.com>2018-04-30 19:23:36 -0600
committerShankaranarayanan Puzhavakath Narayanan <snarayanan@research.att.com>2018-05-01 16:55:11 +0000
commit2c0f127d19981cbf69868265f5b4ac98cd687210 (patch)
tree4f240e117a5f545b78d6b94fc29f826f4ce9f979 /docs/api.rst
parentdcf83b8e6798552e614ff6fc117498d737980f9a (diff)
Beijing RC2 documentation
Change-Id: Ic8b75e4cb33d6c4562cef2f2b9342974bfae03a3 Signed-off-by: fsandoval <frank.sandoval@oamtechnologies.com> Issue-ID: OPTFRA-41
Diffstat (limited to 'docs/api.rst')
-rw-r--r--docs/api.rst134
1 files changed, 0 insertions, 134 deletions
diff --git a/docs/api.rst b/docs/api.rst
deleted file mode 100644
index 33e0a68..0000000
--- a/docs/api.rst
+++ /dev/null
@@ -1,134 +0,0 @@
-.. This work is licensed under a Creative Commons Attribution 4.0 International License.
-.. Copyright (C) 2017-2018 AT&T Intellectual Property. All rights reserved.
-
-Homing API v1
-=============
-
-*Updated: 28 Feb 2018*
-
-This document describes the Homing API, provided by the Homing and Allocation service (Conductor).
-It is a work in progress and subject to frequent revision.
-
-General API Information
-=======================
-
-Authenticated calls that target a known URI but that use an HTTP method
-the implementation does not support return a 405 Method Not Allowed
-status. In addition, the HTTP OPTIONS method is supported for each known
-URI. In both cases, the Allow response header indicates the supported
-HTTP methods. See the API Errors section for more information about the
-error response structure.
-
-API versions
-============
-
-List all Homing API versions
-----------------------------
-
-**GET** ``/``\ F
-
-**Normal response codes:** 200
-
-.. code:: json
-
- {
- "versions": [
- {
- "status": "EXPERIMENTAL",
- "id": "v1",
- "updated": "2016-11-01T00:00:00Z",
- "media-types": [
- {
- "base": "application/json",
- "type": "application/vnd.onap.homing-v1+json"
- }
- ],
- "links": [
- {
- "href": "http://has.ip/v1",
- "rel": "self"
- },
- {
- "href": "http://has.url/",
- "type": "text/html",
- "rel": "describedby"
- }
- ]
- }
- ]
- }
-
-This operation does not accept a request body.
-
-Plans
-=====
-
-Create a plan
--------------
-
-**POST** ``/v1/plans``
-
-- **Normal response codes:** 201
-- **Error response codes:** badRequest (400), unauthorized (401),
- internalServerError (500)
-
-Request an inventory plan for one or more related service demands.
-
-The request includes or references a declarative **template**,
-consisting of:
-
-- **Parameters** that can be referenced like macros
-- **Demands** for service made against inventory
-- **Locations** that are common to the overall plan
-- **Constraints** made against demands, resulting in a set of inventory
- candidates
-- **Optimizations** to further narrow down the remaining candidates
-
-The response contains an inventory **plan**, consisting of one or more
-sets of recommended pairings of demands with an inventory candidate’s
-attributes and region.
-
-Request Parameters
-~~~~~~~~~~~~~~~~~~
-
-+--------------------+------------+----------+------------------------+
-| Parameter | Style | Type | Description |
-+====================+============+==========+========================+
-| ``name`` | plain | xsd:stri | A name for the new |
-| (Optional) | | ng | plan. If a name is not |
-| | | | provided, it will be |
-| | | | auto-generated based |
-| | | | on the homing |
-| | | | template. This name |
-| | | | must be unique within |
-| | | | a given Conductor |
-| | | | environment. When |
-| | | | deleting a plan, its |
-| | | | name will not become |
-| | | | available for reuse |
-| | | | until the deletion |
-| | | | completes |
-| | | | successfully. Must |
-| | | | only contain letters, |
-| | | | numbers, hypens, full |
-| | | | stops, underscores, |
-| | | | and tildes (RFC 3986, |
-| | | | Section 2.3). This |
-| | | | parameter is |
-| | | | immutable. |
-+--------------------+------------+----------+------------------------+
-| ``id`` (Optional) | plain | csapi:UU | The UUID of the plan. |
-| | | ID | UUID is assigned by |
-| | | | Conductor if no id is |
-| | | | provided in the |
-| | | | request. |
-+--------------------+------------+----------+------------------------+
-| ``transaction_id`` | plain | csapi:UU | The transaction id |
-| | | ID | assigned by SO. The |
-| | | | logs should have this |
-| | | | transaction id for |
-| | | | tracking purposes. |
-+--------------------+------------+----------+------------------------+
-| ``files`` | plain | xsd:dict | Supplies the contents |
-| (Optional) | | | of files referenced. |
-+--------------------+------------+----------+------------------------+ \ No newline at end of file