___________________________________________________________________

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

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.

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

Example reponse

{
  "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.

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

Example Response

{
  "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

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

Example Response

{
  "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).

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

Example Response

{
    "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.

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

Example Response

{
    "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.

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

Example Response

{
    "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.

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

Example Response

{
    "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.

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.

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

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.

{
  "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.

{
    "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.

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.

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.

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.