___________________________________________________________________
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.
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.
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.