.. contents::
   :depth: 3
..
.. This work is licensed under a Creative Commons Attribution 4.0 International License.
.. http://creativecommons.org/licenses/by/4.0

\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_

====================
 AAI Custom Queries
====================

Overview
========

Before You Start!
-----------------

It's important that you engage the AAI team before using these
queries. We're are actively evolving our schema, queries, and other
things in AAI. Queries and query parameters may change or be removed
in the future. It's important that, at the very least, we know who is
using which queries so we can be cautious of changes in the
future. And we can help you find the best way to get the data you
need.

Getting Started with the Custom Query API
-----------------------------------------

To execute a custom query, a client will perform a PUT on the query
API and include a payload indicating the starting node and the query
to be run. While the example below is for v11, this can be called in
any version v11 or higher. The version dictates which release's REST
API version the output will be based on.

API URI
=======

.. code::

   PUT /aai/v$/query?format={format}

When calling the query API, the client must specify the output format
as a query string. The currently available output formats are below,
along with examples.


count
-----

Provides an count of the objects returned in the query.

.. code::

   PUT /aai/v$/query?format=count

Example reponse

.. code-block:: json

   {
     "results": [
       {
	 "pnf": 4,
	 "p-interface": 5,
	 "l-interface": 3,
	 "pserver": 1
       }
     ]
   }

id 
--- 

Provides an array of objects containing resource-type (AAI's node
type; i.e., pnf) and a URI using the vertex ID from AAI's graph.

.. code::

   PUT /aai/v$/query?format=id

Example Response
   
.. code-block:: json

   {
     "results": [
       {
	 "resource-type": "complex",
	 "resource-link": "/aai/v1/resources/id/8159312"
       },
       {
	 "resource-type": "complex",
	 "resource-link": "/aai/v1/resources/id/389256"
       }
     ]
   }

pathed
------

Provides an array of objects containing resource-type (AAIs node type;
i.e., pnf) and a URI using the AAI REST API pathed URIs

.. code::

   PUT /aai/v$/query?format=pathed

Example Response
   
.. code-block:: json

   {
     "results": [
       {
	 "resource-type": "complex",
	 "resource-link": "/aai/v1/cloud-infrastructure/complexes/complex/complex1"
       },
       {
	 "resource-type": "complex",
	 "resource-link": "/aai/v1/cloud-infrastructure/complexes/complex/complex1"
       }
     ]
   }

resource
--------

Provides each object in the results array in the same format as AAI's
REST API with depth = 1 (first level children and cousin
relationships).

.. code::

   PUT /aai/v$/query?format=resource


Example Response

.. code-block:: json

   {
       "results": [
	   {
	       "complex": {
		   "city": "Anywhere",
		   "complex-name": "complex-mccomplexface",
		   "country": "USA",
		   "data-center-code": "CHG",
		   "latitude": "30.123456",
		   "longitude": "-78.135344",
		   "physical-location-id": "complextest1",
		   "physical-location-type": "lab",
		   "postal-code": "90210",
		   "region": "West",
		   "relationship-list": {
		       "relationship": [
			   {
			       "related-link": "/aai/v1/network/zones/zone/zone1",
			       "related-to": "zone",
			       "related-to-property": [
				   {
				       "property-key": "zone.zone-name",
				       "property-value": "zone-name1"
				   }
			       ],
			       "relationship-data": [
				   {
				       "relationship-key": "zone.zone-id",
				       "relationship-value": "zone1"
				   }
			       ],
			       "relationship-label": "org.onap.relationships.inventory.LocatedIn"
			   },
			   {
			       "related-link": "/aai/v1/cloud-infrastructure/cloud-regions/cloud-region/Cloud-Region/Region1",
			       "related-to": "cloud-region",
			       "related-to-property": [
				   {
				       "property-key": "cloud-region.owner-defined-type"
				   }
			       ],
			       "relationship-data": [
				   {
				       "relationship-key": "cloud-region.cloud-owner",
				       "relationship-value": "Cloud-Region"
				   },
				   {
				       "relationship-key": "cloud-region.cloud-region-id",
				       "relationship-value": "Region1"
				   }
			       ],
			       "relationship-label": "org.onap.relationships.inventory.LocatedIn"
			   }
		       ]
		   },
		   "resource-version": "1531233769164",
		   "state": "CA",
		   "street1": "100 Main St",
		   "street2": "C3-3W03"
	       }
	   }
       ]
   }

resource_and_uri
----------------

Provides each object in the results array in the same format as AAI’s
REST API with depth = 1 (first level children and cousin
relationships) plus the pathed url for the result object in AAI.

.. code::

   PUT /aai/v$/query?format=resource_and_url

Example Response

.. code-block:: json

  {
      "results": [
	  {
	      "complex": {
		  "city": "Anywhere",
		  "complex-name": "complex-mccomplexface",
		  "country": "USA",
		  "data-center-code": "CHG",
		  "latitude": "30.123456",
		  "longitude": "-78.135344",
		  "physical-location-id": "complextest1",
		  "physical-location-type": "lab",
		  "postal-code": "90210",
		  "region": "West",
		  "relationship-list": {
		      "relationship": [
			  {
			      "related-link": "/aai/v1/network/zones/zone/zone1",
			      "related-to": "zone",
			      "related-to-property": [
				  {
				      "property-key": "zone.zone-name",
				      "property-value": "zone-name1"
				  }
			      ],
			      "relationship-data": [
				  {
				      "relationship-key": "zone.zone-id",
				      "relationship-value": "zone1"
				  }
			      ],
			      "relationship-label": "org.onap.relationships.inventory.LocatedIn"
			  },
			  {
			      "related-link": "/aai/v1/cloud-infrastructure/cloud-regions/cloud-region/Cloud-Region/Region1",
			      "related-to": "cloud-region",
			      "related-to-property": [
				  {
				      "property-key": "cloud-region.owner-defined-type"
				  }
			      ],
			      "relationship-data": [
				  {
				      "relationship-key": "cloud-region.cloud-owner",
				      "relationship-value": "Cloud-REgion"
				  },
				  {
				      "relationship-key": "cloud-region.cloud-region-id",
				      "relationship-value": "Region1"
				  }
			      ],
			      "relationship-label": "org.onap.relationships.inventory.LocatedIn"
			  }
		      ]
		  },
		  "resource-version": "1531233769164",
		  "state": "CA",
		  "street1": "100 Main St",
		  "street2": "C3-3W03"
	      },
	      "url": "/aai/v11/cloud-infrastructure/complexes/complex/complextest1"
	  }
      ]
  }

simple
------

Provides each result object in a simplified format. The node-type,
graph vertex id, pathed url, object properties, and directly related
objects in the graph are all returned. Both direct parent/child
objects and cousin objects are included in the related-to array.

.. code::

   PUT /aai/v$/query?format=simple

Example Response

.. code-block:: json

   {
       "results": [
	   {
	       "id": "81924184",
	       "node-type": "complex",
	       "properties": {
		   "city": "Anywhere",
		   "complex-name": "complex-mccomplexface",
		   "country": "USA",
		   "data-center-code": "CHG",
		   "latitude": "30.123456",
		   "longitude": "-78.135344",
		   "physical-location-id": "complextest1",
		   "physical-location-type": "lab",
		   "postal-code": "90210",
		   "region": "West",
		   "resource-version": "1531233769164",
		   "state": "CA",
		   "street1": "100 Main St",
		   "street2": "C3-3W03"
	       },
	       "related-to": [
		   {
		       "id": "40968400",
		       "node-type": "zone",
		       "relationship-label": "org.onap.relationships.inventory.LocatedIn",
		       "url": "/aai/v1/network/zones/zone/zone1"
		   },
		   {
		       "id": "122884184",
		       "node-type": "cloud-region",
		       "relationship-label": "org.onap.relationships.inventory.LocatedIn",
		       "url": "/aai/v1/cloud-infrastructure/cloud-regions/cloud-region/Cloud-Region/Region1"
		   },
		   {
		       "id": "122884296",
		       "node-type": "rack",
		       "relationship-label": "org.onap.relationships.inventory.LocatedIn",
		       "url": "/aai/v1/cloud-infrastructure/complexes/complex/complextest1/racks/rack/rackname1-1test"
		   }
	       ],
	       "url": "/aai/v1/cloud-infrastructure/complexes/complex/complextest1"
	   }
       ]
   }

graphson
--------

Provides the results using the graphson standard.

.. code::

   PUT /aai/v$/query?format=graphson

Example Response

.. code-block:: json

   {
       "results": [
	   {
	       "id": 81924184,
	       "inE": {
		   "org.onap.relationships.inventory.LocatedIn": [
		       {
			   "id": "oeioq-oe3f4-74l-1crx3s",
			   "outV": 40968400,
			   "properties": {
			       "aai-uuid": "9e75af3d-aa7f-4e8e-a7eb-32d8096f03cc",
			       "contains-other-v": "NONE",
			       "delete-other-v": "NONE",
			       "prevent-delete": "IN",
			       "private": false
			   }
		       },
		       {
			   "id": "216a6j-215u1k-74l-1crx3s",
			   "outV": 122884184,
			   "properties": {
			       "aai-uuid": "4b3693be-b399-4355-8747-4ea2bb298dff",
			       "contains-other-v": "NONE",
			       "delete-other-v": "NONE",
			       "prevent-delete": "IN",
			       "private": false
			   }
		       },
		       {
			   "id": "215xjt-215u4o-74l-1crx3s",
			   "outV": 122884296,
			   "properties": {
			       "aai-uuid": "958b8e10-6c42-4145-9cc1-76f50bb3e513",
			       "contains-other-v": "IN",
			       "delete-other-v": "IN",
			       "prevent-delete": "NONE",
			       "private": false
			   }
		       }
		   ]
	       },
	       "label": "vertex",
	       "properties": {
		   "aai-created-ts": [
		       {
			   "id": "1crvgr-1crx3s-6bk5",
			   "value": 1531231973518
		       }
		   ],
		   "aai-last-mod-ts": [
		       {
			   "id": "215vkb-1crx3s-6dxh",
			   "value": 1531233769164
		       }
		   ],
		   "aai-node-type": [
		       {
			   "id": "215urv-1crx3s-69z9",
			   "value": "complex"
		       }
		   ],
		   "aai-uri": [
		       {
			   "id": "1crxfv-1crx3s-6gat",
			   "value": "/cloud-infrastructure/complexes/complex/complextest1"
		       }
		   ],
		   "aai-uuid": [
		       {
			   "id": "1crvuz-1crx3s-1ybp",
			   "value": "3959ceca-3a89-4e92-a2ff-073b6f409303"
		       }
		   ],
		   "city": [
		       {
			   "id": "1cs0zv-1crx3s-4irp",
			   "value": "Beverley Hills"
		       }
		   ],
		   "complex-name": [
		       {
			   "id": "215wcr-1crx3s-4d8l",
			   "value": "chcil"
		       }
		   ],
		   "country": [
		       {
			   "id": "1cs26j-1crx3s-4l51",
			   "value": "USA"
		       }
		   ],
		   "data-center-code": [
		       {
			   "id": "215ssr-1crx3s-4bnp",
			   "value": "CHG"
		       }
		   ],
		   "last-mod-source-of-truth": [
		       {
			   "id": "215vyj-1crx3s-696t",
			   "value": "aai-AppId"
		       }
		   ],
		   "latitude": [
		       {
			   "id": "1cs2yz-1crx3s-4mpx",
			   "value": "30.123456"
		       }
		   ],
		   "longitude": [
		       {
			   "id": "1cs3d7-1crx3s-4nid",
			   "value": "-174.135344"
		       }
		   ],
		   "physical-location-id": [
		       {
			   "id": "1crzez-1crx3s-4a2t",
			   "value": "complextest1"
		       }
		   ],
		   "physical-location-type": [
		       {
			   "id": "1crzt7-1crx3s-4ged",
			   "value": "lab"
		       }
		   ],
		   "postal-code": [
		       {
			   "id": "1cs1sb-1crx3s-4kcl",
			   "value": "90210"
		       }
		   ],
		   "region": [
		       {
			   "id": "1cs2kr-1crx3s-4lxh",
			   "value": "West"
		       }
		   ],
		   "resource-version": [
		       {
			   "id": "215v63-1crx3s-glh",
			   "value": "1531233769164"
		       }
		   ],
		   "source-of-truth": [
		       {
			   "id": "1crv2j-1crx3s-6epx",
			   "value": "foo"
		       }
		   ],
		   "state": [
		       {
			   "id": "1cs1e3-1crx3s-4jk5",
			   "value": "CA"
		       }
		   ],
		   "street1": [
		       {
			   "id": "1cs07f-1crx3s-4h6t",
			   "value": "100 Main St"
		       }
		   ],
		   "street2": [
		       {
			   "id": "1cs0ln-1crx3s-4hz9",
			   "value": "Room 101"
		       }
		   ]
	       }
	   }
       ]
   }

Optional Query Parameters
-------------------------

depth
~~~~~

You can pass the depth query parameter to specify how many levels of
children/grandchildren to return. The default depth is 1.

.. code::
  
   PUT /aai/v$/query?format={resource OR resource_and_url}}&depth=0

nodesOnly
~~~~~~~~~

You can pass the nodesOnly query parameter to have the output only
contain the object properties with no relationships.

.. code:: 

   PUT /aai/v$/query?format={format}&nodesOnly=true

subgraph
~~~~~~~~

You can pass a subgraph query parameter that determines the behavior
of the output.  Using subgraph=prune returns all of the objects from
the query and only the edges between those objects. Using
subgraph=star returns all of the objects from the query plus all of
the objects they relate to.

The default is subgraph=star

.. code::

   PUT /aai/v$/query?format={format}&subgraph={subgraph}

Payload
-------

Typically the query payload will include both a "start" and a "query"
portion. The "start" can indicate one or more starting nodes in the
graph. If multiple nodes are specified, the result will contain the
query results for all of the start nodes. The "query" indicates the
name of the query to be run and also takes query parameters depending
on the query. Please reference the page for each specific saved query
for how it should be used, but keep in mind that any URI can be used
in the start parameter as long as it provides the same object
types. **Note: The start URI must adhere to standard percent-encoding
rules to properly account for special characters.**

.. code-block:: json

   {
     "start" : ["{namespace}/{resource}"],
     "query" : "query/{query-name}"
   }

There also the option to pass a "start" to the query API with no
specified query. This will return the input node(s) in the format
requested.

.. code-block:: json

   {
       "start" : ["{namespace}/{resource}"]
   }

Switching to Custom Query from Named Query
==========================================

You can find the custom query intended to replace the named query you
are using by searching this page (ctrl + f) for either the named query
name or the named query uuid. Suggested query parameters to use to
receive output in the closest format to the named query output are
also provided.

Available Queries
=================

access-service-fromServiceInstance
----------------------------------

The "**access-service-fromServiceInstance**" query allows a client to
provide A&AI a global-customer-id a service-type for a
service-subscription, and a service-instance-id to retrieve
service-subscription, customer, forwarding-path, configuration, evc,
forwarder, forwarder-evc, p-interface, pnf, lag-interface, and
logical-link of link-type LAG.

availabilityZoneAndComplex-fromCloudRegion
------------------------------------------

  The "**availabilityZoneAndComplex-fromCloudRegion**" query allows a client
  to provide A&AI a cloud-owner and cloud-region-id to retrieve the
  availability-zones and complex.

cloud-region-and-source-FromConfiguration
-----------------------------------------

  The "**cloud-region-and-source-FromConfiguration**" query allows a client
  to provide A&AI with a configuration-id and retrieve the source
  cloud-region and source vnf..  Query needs to be submitted using
  format=simple&nodesOnly=true

cloudRegion-fromCountry
-----------------------

  The "cloudRegion-fromCountry" query allows a client to provide A&AI
  with a country and retrieve all appropriate cloud-regions.

cloudRegion-fromCountryCloudRegionVersion
-----------------------------------------

  The "**cloudRegion-fromCountryCloudRegionVersion**" query allows a client
  to provide A&AI with a country code and cloud-region-version and
  returns the appropriate cloud-regions.

cloudRegion-fromNfType
----------------------

  The "cloudRegion-fromNfType" query allows a client to provide A&AI
  with an nf-type and returns the cloud-regions running those vnfs.

cloudRegion-fromNfTypeVendorVersion
-----------------------------------

  The "**cloudRegion-fromNfTypeVendorVersion**" query allows a client to
  provide A&AI with an nf-type, application-vendor, and optional
  application-version and retrieve the cloud-regions.

cloud-region-fromVnf
--------------------

  The "**cloud-region-fromVnf**" query allows a client to provide A&AI
  with a vnf-id and retrieves the tenant, cloud-region, and cloud-owner.

cloud-region-sites
------------------

  The "**cloud-region-sites**" query allows a client to provide A&AI
  with a cloud-owner and retrieves the cloud-regions having that owner
  and all of the complexes containing those cloud-regions.

cluster-topology
----------------

  The "**cluster-topology**" query allows a client to quickly retrieve
  the topology of a given cluster/pnf.

colocated-devices
-----------------

  The "**colocated-devices**" query allows a client to provide A&AI a
  physical server and retrieves all other physical devices in the same
  location along with details on their physical interfaces and links.

complex-fromVnf
---------------

  The "**complex-fromVnf**" query allows a client to provide A&AI a vnf
  name or ID to retrieve the generic-vnf, pserver, complex, licenses,
  and entitlements.

count-vnf-byVnfType
-------------------

  The "**count-vnf-byVnfType**" query allows a client to get a list of
  the number of generic-vnfs for each vnf type.  Format must be set to
  "console", otherwise no data will be displayed.

destination-FromConfiguration
-----------------------------

  The "**destination-FromConfiguration**" query allows a client to
  provide A&AI with a configuration-id and retrieve the destination vnf
  or pnf..  Query needs to be submitted using
  format=simple&nodesOnly=true

fabric-information-fromVnf
--------------------------

  The fabric-information-fromVnf query will retrieve fabric information
  for a given VNF.

fn-topology
-----------

  The "**fn-topology**" query allows a client to provide A&AI
  service-instance-id or line-of-business-name then return vnf, vnfc,
  vserver, pserver, pnf.

generic-vnfFromModelbyRegion
----------------------------

  The "**generic-vnfFromModelbyRegion**" query allows a client to
  provide A&AI with a global-customer-id, service-type, model
  parameters, and cloud-region-id and retrieves the related
  generic-vnfs.

getComplexByPNFName
-------------------

  The "**getComplexByPnfName**" query allows a client to provide A&AI a
  PNF and retrieve the PNF details and its location.  This query is
  meant to replace the named query "getComplexByPnfName", which had
  named query uuid "d27ccfea-7098-42d7-a4cd-bbddb37bf205". The format
  closest to the original query can be achieved with
  ?format=resource&depth=0&nodesOnly=true

getComplexFromHostname
----------------------

  The "**getComplexFromHostname**" query allows a client to provide A&AI
  a pserver and retrieve the pserver details and its location.  This
  query is meant to replace the named query "dhv-complex-by-hostname",
  which had named query uuid "670a94e9-874f-4087-8501-62d4d289c519". The
  format closest to the original query can be achieved with
  ?format=simple

getCustomerVPNBondingServiceDetails
-----------------------------------

  The "**getCustomerVPNBondingServiceDetails**" query that takes
  customer (customer.global-customer-id) and service-type as input and
  return customer VPN Bonding service details.

getDHVLogicalLink
-----------------

  The "**getDHVLogicalLink**" query allows a client to provide A&AI a
  VNF and retrieve its interface and link details.  This query is meant
  to replace the named query "logical-link-by-vnf-name", which had named
  query uuid "47e5e7c7-719e-45af-b96f-0c15fa0691b9". The format closest
  to the original query can be achieved with
  ?format=simple&nodes-only=true

getL3networkCloudRegionByNetworkRole
------------------------------------

  The "**getL3networkCloudRegionByNetworkRole**" query allows a client
  to provide A&AI a Network Role value and retrieve all L3 networks,
  their connected VNFs, VMs, Tenants and Cloud Regions.  This query is
  meant to replace the named query
  "l3network-cloud-region-by-network-role", which had named query uuid
  "96e54642-c0e1-4aa2-af53-e37c623b8d01". The format closest to the
  original query can be achieved with
  ?format=simple&depth=0&nodesOnly=true

getLogicalLinkByCloudRegionId
-----------------------------

  The "**getLogicalLinkByCloudRegionId**" query allows a client to
  provide A&AI a Cloud Region and retrieve its Links in that region.
  This query is meant to replace the named query
  "getLogicalLinkByCloudRegionId", which had named query uuid
  "25096aa7-bc97-4ece-8a81-41dd28cd0f7d". The format closest to the
  original query can be achieved with
  ?format=simple&depth=0&nodesOnly=true

getNetworks
-----------

  The getNetworks query will retrieve l3-networks for a given
  network-role, cloud-region and owning-entity

getNetworksByServiceInstance
----------------------------

  The "**getNetworksByServiceInstance**" query allows a client to return
  provider networks with associated vlan-tags and tenant networks with
  associated vlan-tags by service-instance-id.

getPinterfacePhysicalLinkBySvcInstId
------------------------------------

  The "**getPinterfacePhysicalLinkBySvcInstId**" query allows a client
  to provide A&AI a Service Instance and retrieves the related VNFs,
  VMs, Physical Server(s), Physical Interfaces and Links.  This query is
  meant to replace the named query
  "pinterface-physical-link-by-service-instance-id", which had named
  query uuid "75d55786-200b-49fd-92d7-1393e755d693". The format closest
  to the original query can be achieved with
  ?format=resource&depth=0&nodesOnly=true

getRouterRoadmTailSummary
-------------------------

  The "**getRouterRoadmTailSummary**" query allows a client to provide
  A&AI a PNF and retrieve its Physical Interfaces, Links, related PNFs
  and their Physical Interfaces, Service Instance(s), Service
  Subscriptions and Customers.  This query is meant to replace the named
  query "GetRouterRoadmTailSummary", which had named query uuid
  "cbf22b8a-f29a-4b9b-a466-a878095b258a". The format closest to the
  original query can be achieved with ?format=resource_and_url&depth=0

getServiceTopology
------------------

  The "**getServiceTopology**" query allows a client to provide A&AI
  with a service-instance and retrieve the generic-vnfs, vlans,
  vservers, l-interfaces, pservers, complexes, and
  allotted-resources. It then finds any service-instances attached to
  the allotted-resources and retrieves the above values for those
  service-instances except for pservers, complexes, and
  allotted-resources. The client must provide a path to the
  service-instance from customer and service-subscription.  This query
  is meant to replace the named query "dhv-service-topology-2", which
  had named query uuid "09236f18-a9d2-4468-9086-464b8385b706". The
  format closest to this original query can be found with
  format=simple&depth=0&nodesOnly=true

getSvcSubscriberModelInfo
-------------------------

  The "**getSvcSubscriberModelInfo**" query allows a client to provide
  A&AI a service-instance or a list of service-instances and retrieve
  the human readable model name and model version.  This query is meant
  to replace the named query "get-service-instance-model-info", which
  had named query uuid "6e806bc2-8f9b-4534-bb68-be91267ff6c8".

getVNFVpnBondingServiceDetails
------------------------------

  The "**getVNFVpnBondingServiceDetails**" query that takes customer
  (customer.global-customer-id) and service-type as input and return
  customer VPN Bonding service details.

images-fromCloudRegionNfType
----------------------------

  The "**images-fromCloudRegionNfType**" query allows a client to
  provide A&AI with a cloud-region-id and nf-type and retrieve all
  related images.

instance-groups-byCloudRegion
-----------------------------

  The "**instance-groups-byCloudRegion**" query allows the user to get
  all instance-groups by cloud-region-id and filter by instance-group
  type/role/function.


ips-networks-fromVnf
--------------------

  The "**ips-networks-fromVnf**" query allows a client to provide A&AI
  one or more VNFs and retrieve various data all associated VIP and
  fixed IPs and their related networks.

l3-networks-by-cloud-region-network-role
----------------------------------------

  The "**l3-networks-by-cloud-region-network-role**" query retrieves
  l3-networks for a given cloud-region-id, tenant.tenant-id (Optional)
  and network-role.


linked-devices
--------------

  The "**linked-devices**" query allows a client to provide A&AI a
  generic-vnf, vserver, or newvce and retrieve all connected
  generic-vnfs, vservers, and newvces.

locationNetTypeNetRole-fromCloudRegion
--------------------------------------

  The "**locationNetTypeNetRole-fromCloudRegion**" query allows a client
  to provide A&AI with a cloud-region-id and returns the cloud-region,
  complex, and l3-networks.

network-collection-ByServiceInstance
------------------------------------

  The "**network-collection-ByServiceInstance**" query returns the
  service-instance and associated collection, instance-group and
  associated l3-networks for a given service-instance-id.

network-name-fromNetwork-role
-----------------------------

  The "** network-name-fromNetwork-role**" query allows a client to
  provide A&AI with a cloud-owner and cloud-region-id and retrieves the
  related l3-networks and network-policies.

nfType-fromCloudRegion
----------------------

  The "**nfType-fromCloudRegion**" query allows a client to provide A&AI
  with a cloud-region-id and returns a list of all generic-vnfs with an
  nf-type.

owning-entity-fromService-instance
----------------------------------

  The "**owning-entity-fromService-instance**" query allows a client to
  provide A&AI with a service-instance-id and retrieves the
  owning-entity.

pending-topology-detail
-----------------------

  The "**pending-topology-detail**" query allows a client to provide
  A&AI a generic as input and returns the generic-vnf, platform(s),
  line(s)-of-business, owning-entity, project, vnfc(s), vnfc ip
  address(es), vip ip addresses subnet(s), and l3-networks.

pnf-fromModel-byRegion
----------------------

  The "**pnf-fromModel-byRegion**" query allows a client to provide A&AI
  with a cloud-region, equip-vendor, equip-model, model-invariant-id of
  service-instance, model-version-id of service-instance and retrieves
  the pnf.

pnf-topology
------------

  The "**pnf-topology**" query allows a client to provide A&AI a D1
  Device, using the hostname, and retrieve data related to that device
  and its connected uCPE and/or other D1 device. This includes data
  about the D1 device itself (the pnf, and location) as well as about a
  connected uCPE (the pserver, interfaces and physical links used for
  the connection) and/or other D1 device (the pnf, interfaces and
  physical links used for the connection).

pserver-fromConfiguration
-------------------------

  The "**pserver-fromConfiguration**" query allows a client to provide
  A&AI with a configuration-id and retrieves the configuration and
  related l-interfaces, pservers, and generic-vnfs.

pserver-fromConfigurationFilterInterfaceId
------------------------------------------

  The "**pserver-fromConfigurationFilterInterfaceId**" query allows a
  client to provide A&AI with a configuration-id and interface-id and
  retrieves the configuration, l-interface, and related pservers, and
  generic-vnfs.

pservers-fromVnf
----------------

  The "**pservers-fromVnf**" query allows a client to provide A&AI a vNF
  and retrieve all of the pservers hosting that vNF.

pservers-withNoComplex
----------------------

  The "**pservers-withNoComplex**" query allows a client to get a list
  of pservers that have no edge to any complex.  Format must be set to
  "console", otherwise no data will be displayed.

related-to
----------

  The "**related-to**" query allows a client to provide A&AI any
  starting node and request all related nodes of a requested node-type.

service-fromPserverandSubsName
------------------------------

  The "**service-fromPServerandSubsName**" query allows a client to
  provide A&AI a hostname and subscriber name, then return service
  instance and service subscription information.

serviceModels-byDistributionStatus
----------------------------------

  The "**serviceModels-byDistributionStatus**" query allows a client to
  provide A&AI with a distribution-status and optional
  model-invariant-id and retrieve the model and model-ver.

service-sites
-------------

  The "**service-sites**" query allows a client to provide A&AI a
  service type and a customer id to retrieve the service-instances,
  cloud regions, generic-vnfs, and complexes.

service-topology
----------------

  The "**service-topology**" query allows a client to provide A&AI with
  a service-instance and retrieve the generic-vnfs, connected tenants,
  vservers, vnfcs, pservers, and their interfaces.  This query is
  intended to use with format=resource_and_url and depth=0, using the
  node urls to identify parent-child relationships.

site-l3network-cloudRegion
--------------------------

  The "**site-l3network-cloudRegion**" query allows a client to provide
  A&AI with a physical-location-id and returns the network-role,
  country, cloud-region-id and cloud-region-version in that location.

sites-byCloudRegionId
---------------------

  The "**sites-byCloudRegionId**" query allows a client to provide A&AI
  with a cloud-region-id and an optional cloud-region-version and
  returns the appropriate complexes.

sites-byCountryFilterCloudRegionId
----------------------------------

  The "**sites-byCountryFilterCloudRegionId**" query allows a client to
  provide A&AI with a 3-digit country code and cloud-region-id to
  retrieve the appropriate complexes.

sites-byCountryFilterCloudRegionVer
-----------------------------------

  The "**sites-byCountryFilterCloudRegionVer**" query allows a client to
  provide A&AI with a 3-digit country code and cloud-region-version
  number to retrieve the appropriate complexes.

so-request-vfModule
-------------------

  The "**so-request-vfModule**" query allows a client to provide A&AI a
  vf-module then return all the reference objects needed to send SO an
  orchestration request.

spaas-topology-fromServiceInstance
----------------------------------

  The "**spaas-topology-fromServiceInstance**" query allows a client to
  provide A&AI global-custom-id and service-type, then return vertical
  topology for overlay and underlay information.

topology-detail
---------------

  The "**topology-detail**" query allows a client to provide A&AI a
  generic-vnf as input and returns the generic-vnf, platform(s),
  line(s)-of-business, owning-entity, project, vnfc(s), vserver(s),
  vserver l-interface(s), ip address(es), subnet(s), l3-networks,
  cloud-region and complex.

topology-detail-fromVnf
-----------------------

  The "**topology-detail-fromVnf**" query allows a client to provide
  A&AI with a service-id of a VNF and retrieve various data related to
  that VNF. This includes data about the VNF itself (the generic-vnf),
  the related vnfc, the related vserver (along with the tenant,
  cloud-region, image and flavor) and the related pserver (along with
  the complex) as done in the topology-summary query. In addition, this
  query returns availability-zone, service-instance, l-interface,
  l3-interface-ipv4-address-list, l3-interface-ipv6-address-list, and
  volume-group.

topology-detail-fromVserver
---------------------------

  The "**topology-detail-fromVserver**" query allows a client to provide
  A&AI a vserver as input and returns the generic-vnf, platform(s),
  line(s)-of-business, owning-entity, project, vnfc(s), vserver(s),
  vserver l-interface(s), ip address(es), subnet(s), l3-networks,
  cloud-region and complex. Updated in 1806 to return the following
  additional objects: pserver, availability-zone, tenant, image, flavor,
  virtual-data-center, vf-module, and volume-group.

topology-fromCloudRegionIdandServiceId
--------------------------------------

  The "**topology-fromCloudRegionIdandServiceId**" query allows a client
  to provide A&AI cloud-owner, cloud-region-id and service-id, then
  return topology related to the service id.

topology-summary
----------------

  The "**topology-summary**" query allows a client to provide A&AI one
  or more VNFs and retrieve various data related to that VNF. This
  includes data about the VNF itself (the generic-vnf), the related
  vnfc, the related vserver (along with the tenant, cloud-region, image
  and flavor) and the related pserver (along with the complex).

topology-summary-fromCloudRegion
--------------------------------

  The "**topology-summary-fromCloudRegion**" query allows a client to
  provide A&AI a cloud region and retrieve a summary of the topology
  within that cloud region including the tenants, VMs, VNFs and physical
  servers.

topology-summary-fromTenant
---------------------------

  The "**topology-summary-fromTenant**" query allows a client to provide
  A&AI a tenant and retrieve a summary of the topology within that
  tenant including VMs, VNFs and physical servers and the containing
  cloud region.

ucpe-instance
-------------

  The "**ucpe-instance**" query allows a client to provide A&AI a
  physical server or physical network device, using the hostname, and
  retrieve the device and the complex it is located in. This includes
  the pserver or pnf itself and the complex.

ucpe-topology
-------------

  The "**ucpe-topology**" query allows a client to provide A&AI a uCPE
  physical server, using the hostname, and retrieve various data related
  to that uCPE. This includes data about the uCPE itself (the pserver,
  location, interfaces, hosted vnfs, service instances, service
  subscriptions and customer) as well as about a connected physical D1
  device (the pnf, interfaces and physical links).

vfModule-fromServiceInstance
----------------------------

  The "**vfModule-fromServiceInstance**" query allows a client to
  provide A&AI a service-instance-id to retrieve vf-module only.
 
vnf-instances-fromServiceInstancebyModelVersion
-----------------------------------------------

  The "**vnf-instances-fromServiceInstancebyModelVersion**" query allows
  a client to provide A&AI a list of service-instances for a customer
  and service-type and return the generic-vnfs using a particular
  model-version-id.

vnfs-fromPserver
----------------

  The "**vnfs-fromPserver**" query allows a client to provide A&AI with
  a pserver hostname and retrieve the generic-vnfs related to it. This
  query also supports pre-filtering the vnf results.

vnfs-fromServiceInstance
------------------------

  The "**vnfs-fromServiceInstance**" query allows a client to provide
  A&AI a service-instance and retrieve the related VNFs.

vnfs-vlans-fromServiceInstance
------------------------------

  The "**vnfs-vlans-fromServiceInstance**" query allows a client to
  provide A&AI a service-instance id, then return associated vnfs and
  corresponding VLAN ID assignment information for each VNF that is
  associated to the VNF.

vnf-topology-fromServiceInstance
--------------------------------

  The "**vnf-topology-fromServiceInstance**" query allows a client to
  provide A&AI a service-instance and retrieve much of the topology
  related to it. The related VNF, vservers and pserver, along with any
  IP addresses and l3-networks on the VNF or vserver, the
  service-instance and allotted-resource, the tenant and cloud region.

vnf-topology-fromVfModule
-------------------------

  The "**vnf-topology-fromVfModule**" query allows a client to provide
  A&AI a vf-module and retrieve much of the topology related to it. The
  related VNF, vservers and pserver, along with any IP addresses and
  l3-networks on the VNF or vserver, the service-instance and
  allotted-resource, the tenant and cloud region.

vnf-topology-fromVnf
--------------------

  The "**vnf-topology-fromVnf**" query allows a client to provide A&AI a
  generic-vnf and retrieve much of the topology related to it. The
  related VNF, vservers and pserver, along with any IP addresses and
  l3-networks on the VNF or vserver, the service-instance and
  allotted-resource, the tenant and cloud region.

vnf-to-service-instance
-----------------------

  The "**vnf-to-service-instance**" query allows a client to provide
  A&AI a VNF and retrieve the related Service Instance and ALL VNFs
  within that instance.  This query is meant to replace the named query
  "vnf-to-service-instance", which had named query uuid
  "a93ac487-409c-4e8c-9e5f-334ae8f99087".

vserver-fromInstanceGroup
-------------------------

  The "**vserver-fromInstanceGroup**" query allows a client to provide
  A&AI a instance-group.id to retrieve VNF and vserver information.

vserver-fromVnf
---------------

  The "**vserver-fromVnf**" query allows a client to provide A&AI with a
  vnf-id and nfc-function of the vnfc and retrieves the vserver, vnfc,
  and l-interface.

vserverlogicallink-frompServer
------------------------------

  The "**vserverlogicallink-frompServer**" query allows a client to
  provide A&AI a hostname, then return logical link of vserver from the
  compute node.

vservers-fromPserver-tree
-------------------------

  The "**vservers-fromPserver-tree**" query allows a client to provide
  A&AI one or more pservers and retrieve each pserver with the vservers
  it hosts nested under it in the output.