diff options
author | Vijay Venkatesh Kumar <vv770d@att.com> | 2022-05-11 11:16:05 -0400 |
---|---|---|
committer | Vijay Venkatesh Kumar <vv770d@att.com> | 2022-05-11 11:16:12 -0400 |
commit | 9b2a9b261f77b43ecd17810e5fa5706df01d41d5 (patch) | |
tree | 254c36d1c5680937351b3fdb86df5612b8d1fde3 /docs/sections/apis/inventory.rst | |
parent | acd42cd6397eb0461a9d26d5e2c291c69dc3f2d1 (diff) |
Remove deprecated component docs
Change-Id: Ided1be8a124c19c42dd4e6c3c8c720d8b69678e7
Signed-off-by: Vijay Venkatesh Kumar <vv770d@att.com>
Issue-ID: DCAEGEN2-2973
Issue-ID: DCAEGEN2-3140
Issue-ID: DCAEGEN2-2968
Diffstat (limited to 'docs/sections/apis/inventory.rst')
-rw-r--r-- | docs/sections/apis/inventory.rst | 1538 |
1 files changed, 0 insertions, 1538 deletions
diff --git a/docs/sections/apis/inventory.rst b/docs/sections/apis/inventory.rst deleted file mode 100644 index 7420102d..00000000 --- a/docs/sections/apis/inventory.rst +++ /dev/null @@ -1,1538 +0,0 @@ -.. This work is licensed under a - Creative Commons Attribution 4.0 International License. - -Inventory API -============= - -.. toctree:: - :maxdepth: 3 - -Description -~~~~~~~~~~~ - -DCAE Inventory is a web service that provides the following: - -1. Real-time data on all DCAE services and their components -2. Comprehensive details on available DCAE service types - -.. csv-table:: - :header: "API name", "Swagger YAML" - :widths: 10,5 - - "Inventory", ":download:`link <swagger_inventory.yaml>`" - -Contact Information -~~~~~~~~~~~~~~~~~~~ - -dcae@lists.openecomp.org - - -DEFAULT -~~~~~~~ - -GET ``/dcae-service-types`` ---------------------------- - -Description -+++++++++++ - -.. raw:: html - - Get a list of `DCAEServiceType` objects. - -Parameters -++++++++++ - -.. csv-table:: - :delim: | - :header: "Name", "Located in", "Required", "Type", "Format", "Properties", "Description" - :widths: 20, 15, 10, 10, 10, 20, 30 - - typeName | query | No | string | | | Filter by service type name - onlyLatest | query | No | boolean | | {"default": true} | If set to true, query returns just the latest versions of DCAE service types. If set to false, then all versions are returned. Default is true - onlyActive | query | No | boolean | | {"default": true} | If set to true, query returns only *active* DCAE service types. If set to false, then all DCAE service types are returned. Default is true - vnfType | query | No | string | | | Filter by associated vnf type. No wildcards, matches are explicit. This field is treated case insensitive. - serviceId | query | No | string | | | Filter by assocaited service id. Instances with service id null or empty is always returned. - serviceLocation | query | No | string | | | Filter by associated service location. Instances with service location null or empty is always returned. - asdcServiceId | query | No | string | | | Filter by associated asdc design service id. Setting this to `NONE` will return instances that have asdc service id set to null - asdcResourceId | query | No | string | | | Filter by associated asdc design resource id. Setting this to `NONE` will return instances that have asdc resource id set to null - offset | query | No | integer | int32 | | Query resultset offset used for pagination (zero-based) - -Request -+++++++ - -Responses -+++++++++ - -**200** -^^^^^^^ - -List of `DCAEServiceType` objects - -Type: :ref:`InlineResponse200 <d_b1ccd4187d31690b8e704c0aa01b2c59>` - -**Example:** - -.. code-block:: javascript - - { - "items": [ - { - "asdcResourceId": "somestring", - "asdcServiceId": "somestring", - "asdcServiceURL": "somestring", - "blueprintTemplate": "somestring", - "created": "2015-01-01T15:00:00.000Z", - "deactivated": "2015-01-01T15:00:00.000Z", - "owner": "somestring", - "selfLink": { - "params": {}, - "rel": "somestring", - "rels": [ - "somestring", - "somestring" - ], - "title": "somestring", - "type": "somestring", - "uri": "somestring", - "uriBuilder": {} - }, - "serviceIds": [ - "somestring", - "somestring" - ], - "serviceLocations": [ - "somestring", - "somestring" - ], - "typeId": "somestring", - "typeName": "somestring", - "typeVersion": 1, - "vnfTypes": [ - "somestring", - "somestring" - ] - }, - { - "asdcResourceId": "somestring", - "asdcServiceId": "somestring", - "asdcServiceURL": "somestring", - "blueprintTemplate": "somestring", - "created": "2015-01-01T15:00:00.000Z", - "deactivated": "2015-01-01T15:00:00.000Z", - "owner": "somestring", - "selfLink": { - "params": {}, - "rel": "somestring", - "rels": [ - "somestring", - "somestring" - ], - "title": "somestring", - "type": "somestring", - "uri": "somestring", - "uriBuilder": {} - }, - "serviceIds": [ - "somestring", - "somestring" - ], - "serviceLocations": [ - "somestring", - "somestring" - ], - "typeId": "somestring", - "typeName": "somestring", - "typeVersion": 1, - "vnfTypes": [ - "somestring", - "somestring" - ] - } - ], - "links": { - "nextLink": { - "params": {}, - "rel": "somestring", - "rels": [ - "somestring", - "somestring" - ], - "title": "somestring", - "type": "somestring", - "uri": "somestring", - "uriBuilder": {} - }, - "previousLink": { - "params": {}, - "rel": "somestring", - "rels": [ - "somestring", - "somestring" - ], - "title": "somestring", - "type": "somestring", - "uri": "somestring", - "uriBuilder": {} - } - }, - "totalCount": 1 - } - -DELETE ``/dcae-service-types/{typeId}`` ---------------------------------------- - -Description -+++++++++++ - -.. raw:: html - - Deactivates existing `DCAEServiceType` instances - -Parameters -++++++++++ - -.. csv-table:: - :delim: | - :header: "Name", "Located in", "Required", "Type", "Format", "Properties", "Description" - :widths: 20, 15, 10, 10, 10, 20, 30 - - typeId | path | Yes | string | | | - -Request -+++++++ - -Responses -+++++++++ - -**200** -^^^^^^^ - -`DCAEServiceType` has been deactivated - -Type: :ref:`ApiResponseMessage <d_8a94f348f7df00259702f8d9b7d2ea84>` - -**Example:** - -.. code-block:: javascript - - { - "code": 1, - "message": "somestring", - "type": "somestring" - } - -**404** -^^^^^^^ - -`DCAEServiceType` not found - -Type: :ref:`ApiResponseMessage <d_8a94f348f7df00259702f8d9b7d2ea84>` - -**Example:** - -.. code-block:: javascript - - { - "code": 1, - "message": "somestring", - "type": "somestring" - } - -**410** -^^^^^^^ - -`DCAEServiceType` already gone - -Type: :ref:`ApiResponseMessage <d_8a94f348f7df00259702f8d9b7d2ea84>` - -**Example:** - -.. code-block:: javascript - - { - "code": 1, - "message": "somestring", - "type": "somestring" - } - -GET ``/dcae-service-types/{typeId}`` ------------------------------------- - -Description -+++++++++++ - -.. raw:: html - - Get a `DCAEServiceType` object. - -Parameters -++++++++++ - -.. csv-table:: - :delim: | - :header: "Name", "Located in", "Required", "Type", "Format", "Properties", "Description" - :widths: 20, 15, 10, 10, 10, 20, 30 - - typeId | path | Yes | string | | | - -Request -+++++++ - -Responses -+++++++++ - -**200** -^^^^^^^ - -Single `DCAEServiceType` object - -Type: :ref:`DCAEServiceType <d_b0cb5f12dbde8c0c42487c089983687e>` - -**Example:** - -.. code-block:: javascript - - { - "asdcResourceId": "somestring", - "asdcServiceId": "somestring", - "asdcServiceURL": "somestring", - "blueprintTemplate": "somestring", - "created": "2015-01-01T15:00:00.000Z", - "deactivated": "2015-01-01T15:00:00.000Z", - "owner": "somestring", - "selfLink": { - "params": {}, - "rel": "somestring", - "rels": [ - "somestring", - "somestring" - ], - "title": "somestring", - "type": "somestring", - "uri": "somestring", - "uriBuilder": {} - }, - "serviceIds": [ - "somestring", - "somestring" - ], - "serviceLocations": [ - "somestring", - "somestring" - ], - "typeId": "somestring", - "typeName": "somestring", - "typeVersion": 1, - "vnfTypes": [ - "somestring", - "somestring" - ] - } - -**404** -^^^^^^^ - -Resource not found - -Type: :ref:`DCAEServiceType <d_b0cb5f12dbde8c0c42487c089983687e>` - -**Example:** - -.. code-block:: javascript - - { - "asdcResourceId": "somestring", - "asdcServiceId": "somestring", - "asdcServiceURL": "somestring", - "blueprintTemplate": "somestring", - "created": "2015-01-01T15:00:00.000Z", - "deactivated": "2015-01-01T15:00:00.000Z", - "owner": "somestring", - "selfLink": { - "params": {}, - "rel": "somestring", - "rels": [ - "somestring", - "somestring" - ], - "title": "somestring", - "type": "somestring", - "uri": "somestring", - "uriBuilder": {} - }, - "serviceIds": [ - "somestring", - "somestring" - ], - "serviceLocations": [ - "somestring", - "somestring" - ], - "typeId": "somestring", - "typeName": "somestring", - "typeVersion": 1, - "vnfTypes": [ - "somestring", - "somestring" - ] - } - -POST ``/dcae-service-types`` ----------------------------- - -Description -+++++++++++ - -.. raw:: html - - Inserts a new `DCAEServiceType` or updates an existing instance. Updates are only allowed iff there are no running DCAE services of the requested type, - -Request -+++++++ - -.. _d_57dc24aa38507ded2f27eec90206336e: - -Body -^^^^ - -.. csv-table:: - :delim: | - :header: "Name", "Required", "Type", "Format", "Properties", "Description" - :widths: 20, 10, 15, 15, 30, 25 - - asdcResourceId | No | string | | | Id of vf/vnf instance this DCAE service type is associated with. Value source is from ASDC's notification event's field `resourceInvariantUUID`. - asdcServiceId | No | string | | | Id of service this DCAE service type is associated with. Value source is from ASDC's notification event's field `serviceInvariantUUID`. - asdcServiceURL | No | string | | | URL to the ASDC service model - blueprintTemplate | Yes | string | | | String representation of a Cloudify blueprint with unbound variables - owner | Yes | string | | | - serviceIds | No | array of string | | | List of service ids that are used to associate with DCAE service type. DCAE service types with this propery as null or empty means them apply for every service id. - serviceLocations | No | array of string | | | List of service locations that are used to associate with DCAE service type. DCAE service types with this propery as null or empty means them apply for every service location. - typeName | Yes | string | | | Descriptive name for this DCAE service type - typeVersion | Yes | integer | int32 | | Version number for this DCAE service type - vnfTypes | No | array of string | | | - -.. code-block:: javascript - - { - "asdcResourceId": "somestring", - "asdcServiceId": "somestring", - "asdcServiceURL": "somestring", - "blueprintTemplate": "somestring", - "owner": "somestring", - "serviceIds": [ - "somestring", - "somestring" - ], - "serviceLocations": [ - "somestring", - "somestring" - ], - "typeName": "somestring", - "typeVersion": 1, - "vnfTypes": [ - "somestring", - "somestring" - ] - } - -Responses -+++++++++ - -**200** -^^^^^^^ - -Single `DCAEServiceType` object. - -Type: :ref:`DCAEServiceType <d_b0cb5f12dbde8c0c42487c089983687e>` - -**Example:** - -.. code-block:: javascript - - { - "asdcResourceId": "somestring", - "asdcServiceId": "somestring", - "asdcServiceURL": "somestring", - "blueprintTemplate": "somestring", - "created": "2015-01-01T15:00:00.000Z", - "deactivated": "2015-01-01T15:00:00.000Z", - "owner": "somestring", - "selfLink": { - "params": {}, - "rel": "somestring", - "rels": [ - "somestring", - "somestring" - ], - "title": "somestring", - "type": "somestring", - "uri": "somestring", - "uriBuilder": {} - }, - "serviceIds": [ - "somestring", - "somestring" - ], - "serviceLocations": [ - "somestring", - "somestring" - ], - "typeId": "somestring", - "typeName": "somestring", - "typeVersion": 1, - "vnfTypes": [ - "somestring", - "somestring" - ] - } - -**400** -^^^^^^^ - -Bad request provided. - -Type: :ref:`ApiResponseMessage <d_8a94f348f7df00259702f8d9b7d2ea84>` - -**Example:** - -.. code-block:: javascript - - { - "code": 1, - "message": "somestring", - "type": "somestring" - } - -**409** -^^^^^^^ - -Failed to update because there are still DCAE services of the requested type -running. - -Type: :ref:`ApiResponseMessage <d_8a94f348f7df00259702f8d9b7d2ea84>` - -**Example:** - -.. code-block:: javascript - - { - "code": 1, - "message": "somestring", - "type": "somestring" - } - -GET ``/dcae-services`` ----------------------- - -Description -+++++++++++ - -.. raw:: html - - Get a list of `DCAEService` objects. - -Parameters -++++++++++ - -.. csv-table:: - :delim: | - :header: "Name", "Located in", "Required", "Type", "Format", "Properties", "Description" - :widths: 20, 15, 10, 10, 10, 20, 30 - - typeId | query | No | string | | | DCAE service type name - vnfId | query | No | string | | | - vnfType | query | No | string | | | Filter by associated vnf type. This field is treated case insensitive. - vnfLocation | query | No | string | | | - componentType | query | No | string | | | Use to filter by a specific DCAE service component type - shareable | query | No | boolean | | | Use to filter by DCAE services that have shareable components or not - created | query | No | string | | | Use to filter by created time - offset | query | No | integer | int32 | | Query resultset offset used for pagination (zero-based) - -Request -+++++++ - -Responses -+++++++++ - -**200** -^^^^^^^ - -List of `DCAEService` objects - -Type: :ref:`InlineResponse2001 <d_31bb361a8900a0bed20df49b94f1e33b>` - -**Example:** - -.. code-block:: javascript - - { - "items": [ - { - "components": [ - { - "componentId": "somestring", - "componentLink": { - "params": {}, - "rel": "somestring", - "rels": [ - "somestring", - "somestring" - ], - "title": "somestring", - "type": "somestring", - "uri": "somestring", - "uriBuilder": {} - }, - "componentSource": "DCAEController", - "componentType": "somestring", - "created": "2015-01-01T15:00:00.000Z", - "location": "somestring", - "modified": "2015-01-01T15:00:00.000Z", - "shareable": 1, - "status": "somestring" - }, - { - "componentId": "somestring", - "componentLink": { - "params": {}, - "rel": "somestring", - "rels": [ - "somestring", - "somestring" - ], - "title": "somestring", - "type": "somestring", - "uri": "somestring", - "uriBuilder": {} - }, - "componentSource": "DCAEController", - "componentType": "somestring", - "created": "2015-01-01T15:00:00.000Z", - "location": "somestring", - "modified": "2015-01-01T15:00:00.000Z", - "shareable": 1, - "status": "somestring" - } - ], - "created": "2015-01-01T15:00:00.000Z", - "deploymentRef": "somestring", - "modified": "2015-01-01T15:00:00.000Z", - "selfLink": { - "params": {}, - "rel": "somestring", - "rels": [ - "somestring", - "somestring" - ], - "title": "somestring", - "type": "somestring", - "uri": "somestring", - "uriBuilder": {} - }, - "serviceId": "somestring", - "typeLink": { - "params": {}, - "rel": "somestring", - "rels": [ - "somestring", - "somestring" - ], - "title": "somestring", - "type": "somestring", - "uri": "somestring", - "uriBuilder": {} - }, - "vnfId": "somestring", - "vnfLink": { - "params": {}, - "rel": "somestring", - "rels": [ - "somestring", - "somestring" - ], - "title": "somestring", - "type": "somestring", - "uri": "somestring", - "uriBuilder": {} - }, - "vnfLocation": "somestring", - "vnfType": "somestring" - }, - { - "components": [ - { - "componentId": "somestring", - "componentLink": { - "params": {}, - "rel": "somestring", - "rels": [ - "somestring", - "somestring" - ], - "title": "somestring", - "type": "somestring", - "uri": "somestring", - "uriBuilder": {} - }, - "componentSource": "DCAEController", - "componentType": "somestring", - "created": "2015-01-01T15:00:00.000Z", - "location": "somestring", - "modified": "2015-01-01T15:00:00.000Z", - "shareable": 1, - "status": "somestring" - }, - { - "componentId": "somestring", - "componentLink": { - "params": {}, - "rel": "somestring", - "rels": [ - "somestring", - "somestring" - ], - "title": "somestring", - "type": "somestring", - "uri": "somestring", - "uriBuilder": {} - }, - "componentSource": "DCAEController", - "componentType": "somestring", - "created": "2015-01-01T15:00:00.000Z", - "location": "somestring", - "modified": "2015-01-01T15:00:00.000Z", - "shareable": 1, - "status": "somestring" - } - ], - "created": "2015-01-01T15:00:00.000Z", - "deploymentRef": "somestring", - "modified": "2015-01-01T15:00:00.000Z", - "selfLink": { - "params": {}, - "rel": "somestring", - "rels": [ - "somestring", - "somestring" - ], - "title": "somestring", - "type": "somestring", - "uri": "somestring", - "uriBuilder": {} - }, - "serviceId": "somestring", - "typeLink": { - "params": {}, - "rel": "somestring", - "rels": [ - "somestring", - "somestring" - ], - "title": "somestring", - "type": "somestring", - "uri": "somestring", - "uriBuilder": {} - }, - "vnfId": "somestring", - "vnfLink": { - "params": {}, - "rel": "somestring", - "rels": [ - "somestring", - "somestring" - ], - "title": "somestring", - "type": "somestring", - "uri": "somestring", - "uriBuilder": {} - }, - "vnfLocation": "somestring", - "vnfType": "somestring" - } - ], - "links": { - "nextLink": { - "params": {}, - "rel": "somestring", - "rels": [ - "somestring", - "somestring" - ], - "title": "somestring", - "type": "somestring", - "uri": "somestring", - "uriBuilder": {} - }, - "previousLink": { - "params": {}, - "rel": "somestring", - "rels": [ - "somestring", - "somestring" - ], - "title": "somestring", - "type": "somestring", - "uri": "somestring", - "uriBuilder": {} - } - }, - "totalCount": 1 - } - -**502** -^^^^^^^ - -Bad response from DCAE controller - -Type: :ref:`ApiResponseMessage <d_8a94f348f7df00259702f8d9b7d2ea84>` - -**Example:** - -.. code-block:: javascript - - { - "code": 1, - "message": "somestring", - "type": "somestring" - } - -**504** -^^^^^^^ - -Failed to connect with DCAE controller - -Type: :ref:`ApiResponseMessage <d_8a94f348f7df00259702f8d9b7d2ea84>` - -**Example:** - -.. code-block:: javascript - - { - "code": 1, - "message": "somestring", - "type": "somestring" - } - -GET ``/dcae-services-groupby/{propertyName}`` ---------------------------------------------- - -Description -+++++++++++ - -.. raw:: html - - Get a list of unique values for the given `propertyName` - -Parameters -++++++++++ - -.. csv-table:: - :delim: | - :header: "Name", "Located in", "Required", "Type", "Format", "Properties", "Description" - :widths: 20, 15, 10, 10, 10, 20, 30 - - propertyName | path | Yes | string | | | Property to find unique values. Restricted to `type`, `vnfType`, `vnfLocation` - -Request -+++++++ - -Responses -+++++++++ - -**200** -^^^^^^^ - -List of unique property values - -Type: :ref:`DCAEServiceGroupByResults <d_a6dc4f986873bc126fc916189ffa5e91>` - -**Example:** - -.. code-block:: javascript - - { - "propertyName": "somestring", - "propertyValues": [ - { - "count": 1, - "dcaeServiceQueryLink": { - "params": {}, - "rel": "somestring", - "rels": [ - "somestring", - "somestring" - ], - "title": "somestring", - "type": "somestring", - "uri": "somestring", - "uriBuilder": {} - }, - "propertyValue": "somestring" - }, - { - "count": 1, - "dcaeServiceQueryLink": { - "params": {}, - "rel": "somestring", - "rels": [ - "somestring", - "somestring" - ], - "title": "somestring", - "type": "somestring", - "uri": "somestring", - "uriBuilder": {} - }, - "propertyValue": "somestring" - } - ] - } - -DELETE ``/dcae-services/{serviceId}`` -------------------------------------- - -Description -+++++++++++ - -.. raw:: html - - Remove an existing `DCAEService` object. - -Parameters -++++++++++ - -.. csv-table:: - :delim: | - :header: "Name", "Located in", "Required", "Type", "Format", "Properties", "Description" - :widths: 20, 15, 10, 10, 10, 20, 30 - - serviceId | path | Yes | string | | | - -Request -+++++++ - -Responses -+++++++++ - -**200** -^^^^^^^ - -DCAE service has been removed - -**404** -^^^^^^^ - -Unknown DCAE service - -Type: :ref:`ApiResponseMessage <d_8a94f348f7df00259702f8d9b7d2ea84>` - -**Example:** - -.. code-block:: javascript - - { - "code": 1, - "message": "somestring", - "type": "somestring" - } - -GET ``/dcae-services/{serviceId}`` ----------------------------------- - -Description -+++++++++++ - -.. raw:: html - - Get a `DCAEService` object. - -Parameters -++++++++++ - -.. csv-table:: - :delim: | - :header: "Name", "Located in", "Required", "Type", "Format", "Properties", "Description" - :widths: 20, 15, 10, 10, 10, 20, 30 - - serviceId | path | Yes | string | | | - -Request -+++++++ - -Responses -+++++++++ - -**200** -^^^^^^^ - -Single `DCAEService` object - -Type: :ref:`DCAEService <d_ae85cd292c2b4046e1ea1bbb02c7ea63>` - -**Example:** - -.. code-block:: javascript - - { - "components": [ - { - "componentId": "somestring", - "componentLink": { - "params": {}, - "rel": "somestring", - "rels": [ - "somestring", - "somestring" - ], - "title": "somestring", - "type": "somestring", - "uri": "somestring", - "uriBuilder": {} - }, - "componentSource": "DCAEController", - "componentType": "somestring", - "created": "2015-01-01T15:00:00.000Z", - "location": "somestring", - "modified": "2015-01-01T15:00:00.000Z", - "shareable": 1, - "status": "somestring" - }, - { - "componentId": "somestring", - "componentLink": { - "params": {}, - "rel": "somestring", - "rels": [ - "somestring", - "somestring" - ], - "title": "somestring", - "type": "somestring", - "uri": "somestring", - "uriBuilder": {} - }, - "componentSource": "DCAEController", - "componentType": "somestring", - "created": "2015-01-01T15:00:00.000Z", - "location": "somestring", - "modified": "2015-01-01T15:00:00.000Z", - "shareable": 1, - "status": "somestring" - } - ], - "created": "2015-01-01T15:00:00.000Z", - "deploymentRef": "somestring", - "modified": "2015-01-01T15:00:00.000Z", - "selfLink": { - "params": {}, - "rel": "somestring", - "rels": [ - "somestring", - "somestring" - ], - "title": "somestring", - "type": "somestring", - "uri": "somestring", - "uriBuilder": {} - }, - "serviceId": "somestring", - "typeLink": { - "params": {}, - "rel": "somestring", - "rels": [ - "somestring", - "somestring" - ], - "title": "somestring", - "type": "somestring", - "uri": "somestring", - "uriBuilder": {} - }, - "vnfId": "somestring", - "vnfLink": { - "params": {}, - "rel": "somestring", - "rels": [ - "somestring", - "somestring" - ], - "title": "somestring", - "type": "somestring", - "uri": "somestring", - "uriBuilder": {} - }, - "vnfLocation": "somestring", - "vnfType": "somestring" - } - -**404** -^^^^^^^ - -DCAE service not found - -Type: :ref:`ApiResponseMessage <d_8a94f348f7df00259702f8d9b7d2ea84>` - -**Example:** - -.. code-block:: javascript - - { - "code": 1, - "message": "somestring", - "type": "somestring" - } - -**502** -^^^^^^^ - -Bad response from DCAE controller - -Type: :ref:`ApiResponseMessage <d_8a94f348f7df00259702f8d9b7d2ea84>` - -**Example:** - -.. code-block:: javascript - - { - "code": 1, - "message": "somestring", - "type": "somestring" - } - -**504** -^^^^^^^ - -Failed to connect with DCAE controller - -Type: :ref:`ApiResponseMessage <d_8a94f348f7df00259702f8d9b7d2ea84>` - -**Example:** - -.. code-block:: javascript - - { - "code": 1, - "message": "somestring", - "type": "somestring" - } - -PUT ``/dcae-services/{serviceId}`` ----------------------------------- - -Description -+++++++++++ - -.. raw:: html - - Put a new or update an existing `DCAEService` object. - -Parameters -++++++++++ - -.. csv-table:: - :delim: | - :header: "Name", "Located in", "Required", "Type", "Format", "Properties", "Description" - :widths: 20, 15, 10, 10, 10, 20, 30 - - serviceId | path | Yes | string | | | - -Request -+++++++ - -.. _d_81c18e0dd7a3af8fb1ba658e72907e7b: - -Body -^^^^ - -.. csv-table:: - :delim: | - :header: "Name", "Required", "Type", "Format", "Properties", "Description" - :widths: 20, 10, 15, 15, 30, 25 - - components | Yes | array of :ref:`DCAEServiceComponentRequest <d_55af22c43245c290d643f75be1f4f254>` | | | List of DCAE service components that this service is composed of - deploymentRef | No | string | | | Reference to a Cloudify deployment - typeId | Yes | string | | | Id of the associated DCAE service type - vnfId | Yes | string | | | Id of the associated VNF that this service is monitoring - vnfLocation | Yes | string | | | Location identifier of the associated VNF that this service is monitoring - vnfType | Yes | string | | | The type of the associated VNF that this service is monitoring - -.. code-block:: javascript - - { - "components": [ - { - "componentId": "somestring", - "componentSource": "DCAEController", - "componentType": "somestring", - "shareable": 1 - }, - { - "componentId": "somestring", - "componentSource": "DCAEController", - "componentType": "somestring", - "shareable": 1 - } - ], - "deploymentRef": "somestring", - "typeId": "somestring", - "vnfId": "somestring", - "vnfLocation": "somestring", - "vnfType": "somestring" - } - -Responses -+++++++++ - -**200** -^^^^^^^ - -Single `DCAEService` object - -Type: :ref:`DCAEService <d_ae85cd292c2b4046e1ea1bbb02c7ea63>` - -**Example:** - -.. code-block:: javascript - - { - "components": [ - { - "componentId": "somestring", - "componentLink": { - "params": {}, - "rel": "somestring", - "rels": [ - "somestring", - "somestring" - ], - "title": "somestring", - "type": "somestring", - "uri": "somestring", - "uriBuilder": {} - }, - "componentSource": "DCAEController", - "componentType": "somestring", - "created": "2015-01-01T15:00:00.000Z", - "location": "somestring", - "modified": "2015-01-01T15:00:00.000Z", - "shareable": 1, - "status": "somestring" - }, - { - "componentId": "somestring", - "componentLink": { - "params": {}, - "rel": "somestring", - "rels": [ - "somestring", - "somestring" - ], - "title": "somestring", - "type": "somestring", - "uri": "somestring", - "uriBuilder": {} - }, - "componentSource": "DCAEController", - "componentType": "somestring", - "created": "2015-01-01T15:00:00.000Z", - "location": "somestring", - "modified": "2015-01-01T15:00:00.000Z", - "shareable": 1, - "status": "somestring" - } - ], - "created": "2015-01-01T15:00:00.000Z", - "deploymentRef": "somestring", - "modified": "2015-01-01T15:00:00.000Z", - "selfLink": { - "params": {}, - "rel": "somestring", - "rels": [ - "somestring", - "somestring" - ], - "title": "somestring", - "type": "somestring", - "uri": "somestring", - "uriBuilder": {} - }, - "serviceId": "somestring", - "typeLink": { - "params": {}, - "rel": "somestring", - "rels": [ - "somestring", - "somestring" - ], - "title": "somestring", - "type": "somestring", - "uri": "somestring", - "uriBuilder": {} - }, - "vnfId": "somestring", - "vnfLink": { - "params": {}, - "rel": "somestring", - "rels": [ - "somestring", - "somestring" - ], - "title": "somestring", - "type": "somestring", - "uri": "somestring", - "uriBuilder": {} - }, - "vnfLocation": "somestring", - "vnfType": "somestring" - } - -**422** -^^^^^^^ - -Bad request provided - -Type: :ref:`ApiResponseMessage <d_8a94f348f7df00259702f8d9b7d2ea84>` - -**Example:** - -.. code-block:: javascript - - { - "code": 1, - "message": "somestring", - "type": "somestring" - } - -Data Structures -~~~~~~~~~~~~~~~ - -.. _d_8a94f348f7df00259702f8d9b7d2ea84: - -ApiResponseMessage Model Structure ----------------------------------- - -.. csv-table:: - :delim: | - :header: "Name", "Required", "Type", "Format", "Properties", "Description" - :widths: 20, 10, 15, 15, 30, 25 - - code | No | integer | int32 | | - message | No | string | | | - type | No | string | | | - -.. _d_ae85cd292c2b4046e1ea1bbb02c7ea63: - -DCAEService Model Structure ---------------------------- - -.. csv-table:: - :delim: | - :header: "Name", "Required", "Type", "Format", "Properties", "Description" - :widths: 20, 10, 15, 15, 30, 25 - - components | No | array of :ref:`DCAEServiceComponent <d_51674dafcc623be79f21ecea545c345d>` | | | - created | No | string | date-time | | - deploymentRef | No | string | | | Reference to a Cloudify deployment - modified | No | string | date-time | | - selfLink | No | :ref:`Link <d_add3c3fd2e145f9e5a78be6e7b208ebb>` | | | Link.title is serviceId - serviceId | No | string | | | - typeLink | No | :ref:`Link <d_add3c3fd2e145f9e5a78be6e7b208ebb>` | | | Link.title is typeId - vnfId | No | string | | | - vnfLink | No | :ref:`Link <d_add3c3fd2e145f9e5a78be6e7b208ebb>` | | | Link.title is vnfId - vnfLocation | No | string | | | Location information of the associated VNF - vnfType | No | string | | | - -.. _d_51674dafcc623be79f21ecea545c345d: - -DCAEServiceComponent Model Structure ------------------------------------- - -.. csv-table:: - :delim: | - :header: "Name", "Required", "Type", "Format", "Properties", "Description" - :widths: 20, 10, 15, 15, 30, 25 - - componentId | Yes | string | | | The id format is unique to the source - componentLink | Yes | :ref:`Link <d_add3c3fd2e145f9e5a78be6e7b208ebb>` | | | Link to the underlying resource of this component - componentSource | Yes | string | | {'enum': ['DCAEController', 'DMaaPController']} | Specifies the name of the underying source service that is responsible for this components - componentType | Yes | string | | | - created | Yes | string | date-time | | - location | No | string | | | Location information of the component - modified | Yes | string | date-time | | - shareable | Yes | integer | int32 | | Used to determine if this component can be shared amongst different DCAE services - status | No | string | | | - -.. _d_55af22c43245c290d643f75be1f4f254: - -DCAEServiceComponentRequest Model Structure -------------------------------------------- - -.. csv-table:: - :delim: | - :header: "Name", "Required", "Type", "Format", "Properties", "Description" - :widths: 20, 10, 15, 15, 30, 25 - - componentId | Yes | string | | | The id format is unique to the source - componentSource | Yes | string | | {'enum': ['DCAEController', 'DMaaPController']} | Specifies the name of the underying source service that is responsible for this components - componentType | Yes | string | | | - shareable | Yes | integer | int32 | | Used to determine if this component can be shared amongst different DCAE services - -.. _d_a6dc4f986873bc126fc916189ffa5e91: - -DCAEServiceGroupByResults Model Structure ------------------------------------------ - -.. csv-table:: - :delim: | - :header: "Name", "Required", "Type", "Format", "Properties", "Description" - :widths: 20, 10, 15, 15, 30, 25 - - propertyName | No | string | | | Property name of DCAE service that the group by operation was performed on - propertyValues | No | array of :ref:`DCAEServiceGroupByResultsPropertyValues <d_0119caa52e274e5e2311b367df38d686>` | | | - -.. _d_0119caa52e274e5e2311b367df38d686: - -DCAEServiceGroupByResultsPropertyValues Model Structure -------------------------------------------------------- - -.. csv-table:: - :delim: | - :header: "Name", "Required", "Type", "Format", "Properties", "Description" - :widths: 20, 10, 15, 15, 30, 25 - - count | No | integer | int32 | | - dcaeServiceQueryLink | No | :ref:`Link <d_add3c3fd2e145f9e5a78be6e7b208ebb>` | | | Link.title is the DCAE service property value. Following this link will provide a list of DCAE services that all have this property value. - propertyValue | No | string | | | - -DCAEServiceRequest Model Structure ----------------------------------- - -.. csv-table:: - :delim: | - :header: "Name", "Required", "Type", "Format", "Properties", "Description" - :widths: 20, 10, 15, 15, 30, 25 - - components | Yes | array of :ref:`DCAEServiceComponentRequest <d_55af22c43245c290d643f75be1f4f254>` | | | List of DCAE service components that this service is composed of - deploymentRef | No | string | | | Reference to a Cloudify deployment - typeId | Yes | string | | | Id of the associated DCAE service type - vnfId | Yes | string | | | Id of the associated VNF that this service is monitoring - vnfLocation | Yes | string | | | Location identifier of the associated VNF that this service is monitoring - vnfType | Yes | string | | | The type of the associated VNF that this service is monitoring - -.. _d_b0cb5f12dbde8c0c42487c089983687e: - -DCAEServiceType Model Structure -------------------------------- - -.. csv-table:: - :delim: | - :header: "Name", "Required", "Type", "Format", "Properties", "Description" - :widths: 20, 10, 15, 15, 30, 25 - - asdcResourceId | No | string | | | Id of vf/vnf instance this DCAE service type is associated with. Value source is from ASDC's notification event's field `resourceInvariantUUID`. - asdcServiceId | No | string | | | Id of service this DCAE service type is associated with. Value source is from ASDC's notification event's field `serviceInvariantUUID`. - asdcServiceURL | No | string | | | URL to the ASDC service model - blueprintTemplate | Yes | string | | | String representation of a Cloudify blueprint with unbound variables - created | Yes | string | date-time | | Created timestamp for this DCAE service type in epoch time - deactivated | No | string | date-time | | Deactivated timestamp for this DCAE service type in epoch time - owner | Yes | string | | | - selfLink | Yes | :ref:`Link <d_add3c3fd2e145f9e5a78be6e7b208ebb>` | | | Link to self where the Link.title is typeName - serviceIds | No | array of string | | | List of service ids that are used to associate with DCAE service type. DCAE service types with this propery as null or empty means them apply for every service id. - serviceLocations | No | array of string | | | List of service locations that are used to associate with DCAE service type. DCAE service types with this propery as null or empty means them apply for every service location. - typeId | Yes | string | | | Unique identifier for this DCAE service type - typeName | Yes | string | | | Descriptive name for this DCAE service type - typeVersion | Yes | integer | int32 | | Version number for this DCAE service type - vnfTypes | No | array of string | | | - -DCAEServiceTypeRequest Model Structure --------------------------------------- - -.. csv-table:: - :delim: | - :header: "Name", "Required", "Type", "Format", "Properties", "Description" - :widths: 20, 10, 15, 15, 30, 25 - - asdcResourceId | No | string | | | Id of vf/vnf instance this DCAE service type is associated with. Value source is from ASDC's notification event's field `resourceInvariantUUID`. - asdcServiceId | No | string | | | Id of service this DCAE service type is associated with. Value source is from ASDC's notification event's field `serviceInvariantUUID`. - asdcServiceURL | No | string | | | URL to the ASDC service model - blueprintTemplate | Yes | string | | | String representation of a Cloudify blueprint with unbound variables - owner | Yes | string | | | - serviceIds | No | array of string | | | List of service ids that are used to associate with DCAE service type. DCAE service types with this propery as null or empty means them apply for every service id. - serviceLocations | No | array of string | | | List of service locations that are used to associate with DCAE service type. DCAE service types with this propery as null or empty means them apply for every service location. - typeName | Yes | string | | | Descriptive name for this DCAE service type - typeVersion | Yes | integer | int32 | | Version number for this DCAE service type - vnfTypes | No | array of string | | | - -.. _d_b1ccd4187d31690b8e704c0aa01b2c59: - -InlineResponse200 Model Structure ---------------------------------- - -.. csv-table:: - :delim: | - :header: "Name", "Required", "Type", "Format", "Properties", "Description" - :widths: 20, 10, 15, 15, 30, 25 - - items | No | array of :ref:`DCAEServiceType <d_b0cb5f12dbde8c0c42487c089983687e>` | | | - links | No | :ref:`InlineResponse200Links <d_e52a59e574408d4d622b3f1f61619b1c>` | | | - totalCount | No | integer | int32 | | - -.. _d_31bb361a8900a0bed20df49b94f1e33b: - -InlineResponse2001 Model Structure ----------------------------------- - -.. csv-table:: - :delim: | - :header: "Name", "Required", "Type", "Format", "Properties", "Description" - :widths: 20, 10, 15, 15, 30, 25 - - items | No | array of :ref:`DCAEService <d_ae85cd292c2b4046e1ea1bbb02c7ea63>` | | | - links | No | :ref:`InlineResponse200Links <d_e52a59e574408d4d622b3f1f61619b1c>` | | | - totalCount | No | integer | int32 | | - -.. _d_e52a59e574408d4d622b3f1f61619b1c: - -InlineResponse200Links Model Structure --------------------------------------- - -Pagination links - -.. csv-table:: - :delim: | - :header: "Name", "Required", "Type", "Format", "Properties", "Description" - :widths: 20, 10, 15, 15, 30, 25 - - nextLink | No | :ref:`Link <d_add3c3fd2e145f9e5a78be6e7b208ebb>` | | | - previousLink | No | :ref:`Link <d_add3c3fd2e145f9e5a78be6e7b208ebb>` | | | - -.. _d_add3c3fd2e145f9e5a78be6e7b208ebb: - -Link Model Structure --------------------- - -.. csv-table:: - :delim: | - :header: "Name", "Required", "Type", "Format", "Properties", "Description" - :widths: 20, 10, 15, 15, 30, 25 - - params | No | :ref:`params <i_f76783e4d75c137d1fc68696fcfdb72c>` | | | - rel | No | string | | | - rels | No | array of string | | | - title | No | string | | | - type | No | string | | | - uri | No | string | uri | | - uriBuilder | No | :ref:`UriBuilder <d_a7b6b5c694147ea9dcfb5a5a6cbef017>` | | | - -.. _i_f76783e4d75c137d1fc68696fcfdb72c: - -**Params schema:** - -Map of {"key":"string"} - -.. _d_a7b6b5c694147ea9dcfb5a5a6cbef017: - -UriBuilder Model Structure --------------------------- - |