summaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
authorJimmy Forsyth <jf2512@att.com>2018-11-07 16:53:02 -0500
committerJimmy Forsyth <jf2512@att.com>2018-11-07 16:53:07 -0500
commit6edb62395a4a18481ff851a218af3e570f085b4e (patch)
treee4fbd5e8b0132a0d7844aaaf94dfac91ae4310b4 /docs
parent84e5a3a494565d21fae0ea79b470b0ef7f31a6d6 (diff)
Update API doc and custom query doc
Issue-ID: AAI-1878 Change-Id: I597eed7bfc64f73b2ac4300ca63f77384e727813 Signed-off-by: Jimmy Forsyth <jf2512@att.com>
Diffstat (limited to 'docs')
-rw-r--r--docs/AAI REST API Documentation/AAIRESTAPI_CASABLANCA.rst21
-rw-r--r--docs/AAI REST API Documentation/customQueries.rst1233
2 files changed, 1244 insertions, 10 deletions
diff --git a/docs/AAI REST API Documentation/AAIRESTAPI_CASABLANCA.rst b/docs/AAI REST API Documentation/AAIRESTAPI_CASABLANCA.rst
index 95f5cdc2..49dc1077 100644
--- a/docs/AAI REST API Documentation/AAIRESTAPI_CASABLANCA.rst
+++ b/docs/AAI REST API Documentation/AAIRESTAPI_CASABLANCA.rst
@@ -1543,7 +1543,7 @@ Example Response
"city": [
{
"id": "1cs0zv-1crx3s-4irp",
- "value": "Middletown"
+ "value": "Beverley Hills"
}
],
"complex-name": [
@@ -1579,7 +1579,7 @@ Example Response
"longitude": [
{
"id": "1cs3d7-1crx3s-4nid",
- "value": "-74.135344"
+ "value": "-174.135344"
}
],
"physical-location-id": [
@@ -1591,19 +1591,19 @@ Example Response
"physical-location-type": [
{
"id": "1crzt7-1crx3s-4ged",
- "value": "nj-lab"
+ "value": "lab"
}
],
"postal-code": [
{
"id": "1cs1sb-1crx3s-4kcl",
- "value": "07748"
+ "value": "90210"
}
],
"region": [
{
"id": "1cs2kr-1crx3s-4lxh",
- "value": "Northeast"
+ "value": "West"
}
],
"resource-version": [
@@ -1615,31 +1615,32 @@ Example Response
"source-of-truth": [
{
"id": "1crv2j-1crx3s-6epx",
- "value": "rx2202"
+ "value": "foo"
}
],
"state": [
{
"id": "1cs1e3-1crx3s-4jk5",
- "value": "NJ"
+ "value": "CA"
}
],
"street1": [
{
"id": "1cs07f-1crx3s-4h6t",
- "value": "200 Laurel Av"
+ "value": "100 Main St"
}
],
"street2": [
{
"id": "1cs0ln-1crx3s-4hz9",
- "value": "C3-3W03"
+ "value": "Room 101"
}
]
}
}
]
}
+
Optional Query Parameters
~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -1652,7 +1653,7 @@ children/grandchildren to return. The default depth is 1.
.. code::
- PUT /aai/v$/query?format={format}&depth=0
+ PUT /aai/v$/query?format={}&depth=0
nodesOnly
^^^^^^^^^
diff --git a/docs/AAI REST API Documentation/customQueries.rst b/docs/AAI REST API Documentation/customQueries.rst
index 87c88ed9..0fdc9d07 100644
--- a/docs/AAI REST API Documentation/customQueries.rst
+++ b/docs/AAI REST API Documentation/customQueries.rst
@@ -13,3 +13,1236 @@
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.