Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents
maxLevel3

Warning
titleUpdate

In current Network Discovery microservice development (Dublin), southbound REST API sends OpenStack API requests instead of AAI Enricher API requests.

Architecture

Overview

  • Will demonstrate Network Discovery Microservice and Service Decomposition Microservice
  • Relies on supporting Microservices not yet in ONAP, but we can show
    • Standardized API and provide a sense of its extensibility to support discovering of additional components
    • VM attributes from Openstack
    • How this fits into POMBA architecture
    • How this could be leveraged in other use cases

Southbound API

  • The following is the information expected from the southbound interface to network discovery
    • Examples (coming soon)
    • Mocking in SoapUI (soon)

Video

The demo shows a request being sent to POMBA's Network Discovery Context Builder, which makes use of Service Decomposition in order to build a list of resources that comprise the specified service. The context builder then takes advantage of the Network Discovery service to obtain details from the network for each of those resources. The context builder collates the information returned by Network Discovery for each resource before providing the collected data to POMBA's Context Aggregator for inclusion in an audit.

View file
nameONAP_SDNC_Network_Discovery_Demo_2018-09-12.mp4
height400

Captures

Service Decomposition

Network Discovery Context Builder → Service Decomposition

The context builder first needs to determine what resources comprise the service undergoing auditing and so it employs Service Decomposition.

Request
Code Block
languagejs
collapsetrue
http://10.147.112.136:8080/service-decomposition/service/context?serviceInstanceId=c6456519-6acf-4adb-997c-3c363dd4caaf







Service Decomposition → AAI

Service Decomposition needs to send a series of requests to the AAI in order to effectively mine the data source for the service instance's component resources.

Request
Code Block
languagejs
collapsetrue
http://10.147.112.136:8443/aai/v13/nodes/service-instance/c6456519-6acf-4adb-997c-3c363dd4caaf

Response

true
Code Block
languagejs
collapse

Response

Code Block
languagejs
collapsetrue
{
    "
relationship
service-instance-
list
id": 
{
"c6456519-6acf-4adb-997c-3c363dd4caaf",
    
"relationship
"service-instance-name": 
[{
"Firewall1",
    
"model-invariant-id": "0c5a20de-87ad-442c-9190-f38ab0a6bb7f",
    "
related
model-version-
to
id": "
generic-vnf
d3d6cf83-d03a-43cc-99ff-206d40bb9a72",
    
"resource-version": "1527637758480",
    "relationship-
data
list": 
[
{
        "relationship": [
        
"relationship-value": "6700c313-fbb7-4cf9-ac70-0293ec56df68",
    {
                "
relationship
related-
key
to": "generic-vnf
.vnf-id"
",
    
}],
            
"related-link": "/aai/v13/network/generic-vnfs/generic-vnf/6700c313-fbb7-4cf9-ac70-0293ec56df68",
                "
related
relationship-
to-property
data": [
{

                  
"property-key": "generic
  {
                        "relationship-key": "generic-vnf.vnf-
name
id",
                        "
property
relationship-value": "
PacketGenerator-1"
6700c313-fbb7-4cf9-ac70-0293ec56df68"
                    }
]

          
},
      ],
  
{
              "related-to-property": 
"generic-vnf",
[
         
"relationship-data":
 
[{
          {
      
"relationship-value":
 
"6700c313-fbb7-4cf9-ac70-0293ec56df69",
                 "
relationship
property-key": "generic-vnf.vnf-
id
name",
            
}],
            "
related
property-
link
value": "
/aai/v13/network/generic-vnfs/generic-vnf/6700c313-fbb7-4cf9-ac70-0293ec56df69",
PacketGenerator-1"
            
"related-to-property": [{
        }
        
"property-key":
 
"generic-vnf.vnf-name",
       ]
         
"property-value":
 
"PacketGenerator-2"
  },
          
}]
  {
      
}]
     
},
     "
model
related-
version-id
to": "
d3d6cf83-d03a-43cc-99ff-206d40bb9a72",
generic-vnf",
                "
service
related-
instance-id
link": "
c6456519-6acf-4adb-997c-3c363dd4caaf
/aai/v13/network/generic-vnfs/generic-vnf/8a9ddb25-2e79-449c-a40d-5011bac0da39",
    
"resource-version": "1527637758480",
            "
generic
relationship-
vnfs
data": [
{

           
"nf-role":
 
"",
        {
"service-id":
 
"8ea56b0d-459d-4668-b363-c9567432d8b7",
         
"relationship-list":
 
{
             "relationship-key":
[{
 "generic-vnf.vnf-id",
                        "
related
relationship-
to
value": "
service-instance",
8a9ddb25-2e79-449c-a40d-5011bac0da39"
                 
"relationship-data":
 
[{
  }
                
"relationship-value": "Demonstration"
],
                
"relationship-key
"related-to-property": 
"customer.global-customer-id"
[
                
},
    
{
     
{
                   
"
relationship
property-
value
key": "
vFWCL
generic-vnf.vnf-name",
                        "
relationship
property-
key
value": "
service-subscription.service-type
Firewall-1"
                
},
    }
            
{
    ]
            
"relationship-value": "c6456519-6acf-4adb-997c-3c363dd4caaf",
}
        ]
    
}
}
Response
Code Block
languagejs
collapsetrue
{
    "relationship-keylist": "service-instance.service-instance-id"{
                }],"relationship": [{
                  "related-linkto": "/aai/v11/business/customers/customer/Demonstration/service-subscriptions/service-subscription/vFWCL/service-instances/service-instance/c6456519-6acf-4adb-997c-3c363dd4caaf",
   generic-vnf",
            "relatedrelationship-to-propertydata": [{
                    "propertyrelationship-keyvalue": "service-instance.service-instance-name6700c313-fbb7-4cf9-ac70-0293ec56df68",
                    "property-value"relationship-key": "Firewall1"
   generic-vnf.vnf-id"
            }],
            },"related-link": "/aai/v13/network/generic-vnfs/generic-vnf/6700c313-fbb7-4cf9-ac70-0293ec56df68",
            "related-to-property": [{
                "relatedproperty-tokey": "l3-networkgeneric-vnf.vnf-name",
                "relationshipproperty-datavalue": [{"PacketGenerator-1"
            }]
       "relationship-value": "HNP1d77c-1094-41ec-b7f3-94bb30951870", },
        {
            "relationshiprelated-keyto": "l3-network.network-id"generic-vnf",
                }],"relationship-data": [{
                "relatedrelationship-linkvalue": "/aai/v13/network/l3-networks/l3-network/HNP1d77c-1094-41ec-b7f3-94bb309518706700c313-fbb7-4cf9-ac70-0293ec56df69",
                "relationship-labelkey": "org.onap.relationships.inventory.Uses",generic-vnf.vnf-id"
            }],
    "related-to-property": [{       "related-link": "/aai/v13/network/generic-vnfs/generic-vnf/6700c313-fbb7-4cf9-ac70-0293ec56df69",
            "related-to-property-key": "l3-network.network-name",
    [{
                "property-valuekey": "HNPORTALOAM.OAM"generic-vnf.vnf-name",
                }] "property-value": "PacketGenerator-2"
            },]
        }]
   { },
    "model-version-id": "d3d6cf83-d03a-43cc-99ff-206d40bb9a72",
         "related-to"service-instance-id": "vserverc6456519-6acf-4adb-997c-3c363dd4caaf",
    "resource-version": "1527637758480",
          "relationship-data"generic-vnfs": [{
        "nf-role": "",
          "relationshipservice-valueid": "CloudOwner8ea56b0d-459d-4668-b363-c9567432d8b7",
        "relationship-list": {
            "relationship-key": "cloud-region.cloud-owner" [{
                 }"related-to": "service-instance",
                "relationship-data": [{
                    "relationship-value": "RegionOneDemonstration",
                    "relationship-key": "cloud-regioncustomer.cloudglobal-regioncustomer-id"
                },
                {
                    "relationship-value": "b49b830686654191bb1e952a74b014advFWCL",
                    "relationship-key": "tenantservice-subscription.tenantservice-idtype"
                },
                {
                    "relationship-value": "25fb07abc6456519-04786acf-465e4adb-a021997c-6384ac2996713c363dd4caaf",
                    "relationship-key": "vserver.vserverservice-instance.service-instance-id"
                }],
                "related-link": "/aai/v13/cloud-infrastructure/cloud-regions/cloud-region/CloudOwner/RegionOne/tenants/tenant/b49b830686654191bb1e952a74b014ad/vservers/vserver/25fb07ab-0478-465e-a021-6384ac299671"/v11/business/customers/customer/Demonstration/service-subscriptions/service-subscription/vFWCL/service-instances/service-instance/c6456519-6acf-4adb-997c-3c363dd4caaf",
            },       "related-to-property": [{
     {                 "relatedproperty-tokey": "vserverservice-instance.service-instance-name",
                    "relationshipproperty-datavalue": [{"Firewall1"
                }]
   "relationship-value": "CloudOwner",        },
            "relationship-key": "cloud-region.cloud-owner"{
                 }"related-to": "l3-network",
                "relationship-data": [{
                    "relationship-value": "RegionOneHNP1d77c-1094-41ec-b7f3-94bb30951870",
                    "relationship-key": "cloudl3-regionnetwork.cloud-regionnetwork-id"
                }],
                {
  "related-link": "/aai/v13/network/l3-networks/l3-network/HNP1d77c-1094-41ec-b7f3-94bb30951870",
                 "relationship-valuelabel": "b49b830686654191bb1e952a74b014ad",org.onap.relationships.inventory.Uses",
                "related-to-property": [{
                    "relationshipproperty-key": "tenantl3-network.tenantnetwork-idname",
                },    "property-value": "HNPORTALOAM.OAM"
           {     }]
            },
       "relationship-value": "25fb07ab-0478-465e-a021-6384ac299672",    {
                "relationshiprelated-keyto": "vserver.vserver-id",
                "relationship-data": [{
   }],                 "relatedrelationship-linkvalue": "/aai/v13/cloud-infrastructure/cloud-regions/cloud-region/CloudOwner/RegionOne/tenants/tenant/b49b830686654191bb1e952a74b014ad/vservers/vserver/25fb07ab-0478-465e-a021-6384ac299672"",
            }]         },"relationship-key": "cloud-region.cloud-owner"
        "vnf-id": "6700c313-fbb7-4cf9-ac70-0293ec56df68",         "nf-type": "",
},
         "l3-networks": [{      {
      "network-role": "HNPORTALOAM.OAM",             "networkrelationship-technologyvalue": "ovsRegionOne",
                    "servicerelationship-idkey": "V7611HNPcloud-1222region.cloud-48f1region-8085-94aef0c6ef3d51870",id"
               "network-id": "HNP1d77c-1222-41ec-b7f3-94bb30951870" },
            "neutron-network-id": "491c7cef-a3f4-4990-883e-b0af397466d0",    {
          "is-external-network": false,
            "is-bound-to-vpnrelationship-value": false,"b49b830686654191bb1e952a74b014ad",
                    "isrelationship-provider-networkkey": false,"tenant.tenant-id"
            "network-type": "OVS_PROVIDER_VLAN",   },
         "orchestration-status": "active",      {
      "network-role-instance": 0,             "resourcerelationship-versionvalue": "1526558298075",25fb07ab-0478-465e-a021-6384ac299671",
                    "networkrelationship-namekey": "HNPORTALOAMvserver.OAMvserver-id",
             "is-shared-network": false
        }],
        "prov-status": "PREPROV",         "vnfrelated-typelink": "vFW-vSINK-service/vPKG 0",/aai/v13/cloud-infrastructure/cloud-regions/cloud-region/CloudOwner/RegionOne/tenants/tenant/b49b830686654191bb1e952a74b014ad/vservers/vserver/25fb07ab-0478-465e-a021-6384ac299671"
           "orchestration-status": "Created", },
         "nf-naming-code": "",  {
      "in-maint": false,         "nfrelated-functionto": "vserver",
         "model-version-id": "a5565bf4-d55a-4964-8fbc-6a7674a2e676",
          "vserversrelationship-data": [{
   
        "relationship-list": {                 "relationship-value": [{"CloudOwner",
                    "relatedrelationship-tokey": "generic-vnf",cloud-region.cloud-owner"
                },
           "relationship-data": [{    {
                    "relationship-value": "8a9ddb25-2e79-449c-a40d-5011bac0da39RegionOne",
  
                     "relationship-key": "genericcloud-vnfregion.vnfcloud-region-id"
                },
    }],            {
        "related-link": "/aai/v11/network/generic-vnfs/generic-vnf/8a9ddb25-2e79-449c-a40d-5011bac0da39",
                    "relatedrelationship-to-propertyvalue": [{
   "b49b830686654191bb1e952a74b014ad",
                    "propertyrelationship-key": "generic-vnftenant.vnftenant-nameid",
                },
         "property-value": "Firewall-1"      {
              }]      "relationship-value": "25fb07ab-0478-465e-a021-6384ac299672",
         },           "relationship-key": "vserver.vserver-id"
    {            }],
        "related-to": "flavor",        "related-link": "/aai/v13/cloud-infrastructure/cloud-regions/cloud-region/CloudOwner/RegionOne/tenants/tenant/b49b830686654191bb1e952a74b014ad/vservers/vserver/25fb07ab-0478-465e-a021-6384ac299672"
            }]
 "relationship-data": [{      },
        "vnf-id": "6700c313-fbb7-4cf9-ac70-0293ec56df68",
        "relationshipnf-valuetype": "CloudOwner",
        "l3-networks": [{
              "relationshipnetwork-keyrole": "cloud-region.cloud-owner"HNPORTALOAM.OAM",
                    }"network-technology": "ovs",
            "service-id": "V7611HNP-1222-48f1-8085-94aef0c6ef3d51870",
      {         "network-id": "HNP1d77c-1222-41ec-b7f3-94bb30951870",
               "relationship-value"neutron-network-id": "RegionOne491c7cef-a3f4-4990-883e-b0af397466d0",
            "is-external-network": false,
           "relationship-key": "cloudis-region.cloudbound-regionto-idvpn": false,
                   }"is-provider-network": false,
            "network-type": "OVS_PROVIDER_VLAN",
      {      "orchestration-status": "active",
                 "relationship-value"network-role-instance": "764efb04-5a46-4806-a766-2bdd24559f39"0,
            "resource-version": "1526558298075",
            "relationshipnetwork-keyname": "flavorHNPORTALOAM.flavor-idOAM",
            "is-shared-network": false
        }],
           "prov-status": "PREPROV",
        "relatedvnf-linktype": "/aai/v11/cloud-infrastructure/cloud-regions/cloud-region/CloudOwner/RegionOne/flavors/flavor/764efb04-5a46-4806-a766-2bdd24559f39",vFW-vSINK-service/vPKG 0",
            "orchestration-status": "Created",
        "relatednf-tonaming-propertycode": [{"",
        "in-maint": false,
        "nf-function": "",
        "propertymodel-version-keyid": "flavor.flavor-namea5565bf4-d55a-4964-8fbc-6a7674a2e676",
        "vservers": [{
              "propertyrelationship-valuelist": "m1.medium" {
                "relationship": [{
    }]                 }"related-to": "generic-vnf",
                {
                    "related-to": "image",
                    "relationship-data": [{
                        "relationship-value": "CloudOwner8a9ddb25-2e79-449c-a40d-5011bac0da39",
                        "relationship-key": "cloudgeneric-regionvnf.cloudvnf-ownerid"
                    }],
                    {
   "related-link": "/aai/v11/network/generic-vnfs/generic-vnf/8a9ddb25-2e79-449c-a40d-5011bac0da39",
                    "relationshiprelated-to-valueproperty": "RegionOne",[{
                        "relationshipproperty-key": "cloudgeneric-region.cloud-region-idvnf.vnf-name",
                        "property-value": "Firewall-1"
                    },]
                },
          {      {
                    "relationshiprelated-valueto": "42fd42f8-cf81-4f4c-a552-d4b124f83b0bflavor",
   
                    "relationship-keydata": "image.image-id"[{
                         }],"relationship-value": "CloudOwner",
                        "relatedrelationship-linkkey": "/aai/v11/cloud-infrastructure/cloud-regions/cloud-region/CloudOwner/RegionOne/images/image/42fd42f8-cf81-4f4c-a552-d4b124f83b0b"region.cloud-owner"
                    },
                    "related-to-property": [{
                        "propertyrelationship-keyvalue": "image.image-nameRegionOne",
                        "propertyrelationship-valuekey": "unknowncloud-region.cloud-region-id"
                    }],
                   }] {
           },             "inrelationship-maintvalue": false"764efb04-5a46-4806-a766-2bdd24559f39",
            "resource-version": "1528481820321",             "vserver-name"relationship-key": "Firewallflavor.flavor-0",id"
                   "prov-status": "ACTIVE", }],
                    "vserverrelated-idlink": "25fb07ab-0478-465e-a021-6384ac299671",/aai/v11/cloud-infrastructure/cloud-regions/cloud-region/CloudOwner/RegionOne/flavors/flavor/764efb04-5a46-4806-a766-2bdd24559f39",
               "vserver-name2": "Firewall-0",     "related-to-property": [{
                        "vserverproperty-selflinkkey": "http://10.12.25.2:8774/v2.1/b49b830686654191bb1e952a74b014ad/servers/25fb07ab-0478-465e-a021-6384ac299671",flavor.flavor-name",
                  "is-closed-loop-disabled": false      "property-value": "m1.medium"
             },       }]
 {             "relationship-list": { },
               "relationship": [{
                    "related-to": "generic-vnfimage",
                    "relationship-data": [{
                        "relationship-value": "8a9ddb25-2e79-449c-a40d-5011bac0da39CloudOwner",
                        "relationship-key": "genericcloud-vnfregion.vnfcloud-idowner"
                    }],
                    {
    "related-link": "/aai/v11/network/generic-vnfs/generic-vnf/8a9ddb25-2e79-449c-a40d-5011bac0da39",                     "relatedrelationship-to-propertyvalue": [{"RegionOne",
                        "propertyrelationship-key": "genericcloud-vnfregion.vnfcloud-region-nameid",
                        "property-value": "Firewall-1"},
                    {
}]                 },             "relationship-value": "42fd42f8-cf81-4f4c-a552-d4b124f83b0b",
   {                     "relatedrelationship-tokey": "flavorimage.image-id",
                    "relationship-data": [{}],
                     "related-link": "/aai/v11/cloud-infrastructure/cloud-regions/cloud-region/CloudOwner/RegionOne/images/image/42fd42f8-cf81-4f4c-a552-d4b124f83b0b",
                    "relationshiprelated-to-valueproperty": "CloudOwner",[{
                        "relationshipproperty-key": "cloud-regionimage.cloudimage-ownername",
                    },    "property-value": "unknown"
               {     }]
                   "relationship-value": "RegionOne",}]
            },
            "relationshipin-keymaint": "cloud-region.cloud-region-id"false,
                    }"resource-version": "1528481820321",
            "vserver-name": "Firewall-0",
      {        "prov-status": "ACTIVE",
                "relationshipvserver-valueid": "764efb0425fb07ab-5a460478-4806465e-a766a021-2bdd24559f396384ac299671",
           
            "relationshipvserver-keyname2": "flavor.flavorFirewall-id0",
                    }],
       "vserver-selflink": "http://10.12.25.2:8774/v2.1/b49b830686654191bb1e952a74b014ad/servers/25fb07ab-0478-465e-a021-6384ac299671",
            "related-linkis-closed-loop-disabled": "/aai/v11/cloud-infrastructure/cloud-regions/cloud-region/CloudOwner/RegionOne/flavors/flavor/764efb04-5a46-4806-a766-2bdd24559f39", false
        },
        {
    "related-to-property": [{       "relationship-list": {
                "property-keyrelationship": "flavor.flavor-name",[{
                        "propertyrelated-valueto": "m1.medium"generic-vnf",
                    }]
"relationship-data": [{
               },         "relationship-value": "8a9ddb25-2e79-449c-a40d-5011bac0da39",
      {
                    "relatedrelationship-tokey": "image",generic-vnf.vnf-id"
                    "relationship-data": [{}],
                        "relationshiprelated-valuelink": "CloudOwner/aai/v11/network/generic-vnfs/generic-vnf/8a9ddb25-2e79-449c-a40d-5011bac0da39",

                       "relationship-key": "cloud-region.cloud-owner""related-to-property": [{
                        },"property-key": "generic-vnf.vnf-name",
                        "property-value": "Firewall-1"
  {                  }]
       "relationship-value": "RegionOne",        },
                "relationship-key": "cloud-region.cloud-region-id"{
                     },"related-to": "flavor",
                    "relationship-data": [{
                        "relationship-value": "42fd42f8-cf81-4f4c-a552-d4b124f83b0bCloudOwner",
                        "relationship-key": "imagecloud-region.imagecloud-idowner"
                    }],
                    "related-link": "/aai/v11/cloud-infrastructure/cloud-regions/cloud-region/CloudOwner/RegionOne/images/image/42fd42f8-cf81-4f4c-a552-d4b124f83b0b",{
                        "relatedrelationship-to-propertyvalue": [{"RegionOne",
                        "propertyrelationship-key": "image.image-name",cloud-region.cloud-region-id"
                    },
     "property-value": "unknown"               {
       }]                 }]
"relationship-value": "764efb04-5a46-4806-a766-2bdd24559f39",
           },             "inrelationship-maintkey": false,"flavor.flavor-id"
              "resource-version": "1528481820321",      }],
                    "vserverrelated-namelink": "Firewall-0",/aai/v11/cloud-infrastructure/cloud-regions/cloud-region/CloudOwner/RegionOne/flavors/flavor/764efb04-5a46-4806-a766-2bdd24559f39",
                    "provrelated-to-statusproperty": "ACTIVE",
[{
           "vserver-id": "25fb07ab-0478-465e-a021-6384ac299672",             "vserverproperty-name2key": "Firewallflavor.flavor-0name",
             "vserver-selflink": "http://10.12.25.2:8774/v2.1/b49b830686654191bb1e952a74b014ad/servers/25fb07ab-0478-465e-a021-6384ac299672",
              "is-closed-loop-disabled": falseproperty-value": "m1.medium"
          }],         "resource-version": "1527638176989", }]
        "model-customization-id": "4cc1e555-361f-4d69-ae21-9f371ea9f40c",       },
 "vf-modules": {             "vf-module": [{
                    "vfrelated-module-nameto": "vPacketGen-VNF-1128-3","image",
                    "modelrelationship-version-iddata": "d6d4a002-a584-4640-bdce-a50e9bce552b", [{
                        "heatrelationship-stack-idvalue": "vPacketGen-VNF-1128-3/df34f5d6-ed39-4184-b785-51c37cfa8ac2",CloudOwner",
                        "resourcerelationship-versionkey": "1527641224058",cloud-region.cloud-owner"
                   "model-customization-id": "49c8f521-e5ee-4095-bb87-4090166e49ab", },
                 "is-base-vf-module": true,  {
              "vf-module-id": "0f792076-f5b3-4251-9fcc-c4d5afae0eb1",         "relationship-value": "RegionOne",
      "module-index": 0,                 "modelrelationship-invariant-idkey": "2a8844a8cloud-f5f7region.cloud-46ddregion-a732-472c6972a28e",id"
                    "orchestration-status": "active"},
             }]       {
 },         "vserver": [{             "vserverrelationship-namevalue": "Firewall-142fd42f8-cf81-4f4c-a552-d4b124f83b0b",
            "vserver-id": "25fb07ab-0478-465e-a021-6384ac299671",             "modelrelationship-invariant-idkey": "0c5a20de-87ad-442c-9190-f38ab0a6bb7f"image.image-id"
                    }],
                    "modelrelated-invariant-idlink": "99f1fd3f-845c-48f5-a0ba-11fbde6ae557",/aai/v11/cloud-infrastructure/cloud-regions/cloud-region/CloudOwner/RegionOne/images/image/42fd42f8-cf81-4f4c-a552-d4b124f83b0b",
          "vnf-name": "PacketGenerator-1",         "isrelated-closedto-loop-disabledproperty": false[{
    },     {         "nf-role": "",         "service-id""property-key": "8ea56b0d-459d-4668-b363-c9567432d8b9image.image-name",
         "relationship-list": {               "relationshipproperty-value": [{
"unknown"
               "related-to": "service-instance",    }]
            "relationship-data": [{   }]
            },
    "relationship-value": "Demonstration",       "in-maint": false,
            "relationshipresource-keyversion": "customer.global-customer-id"1528481820321",
                }"vserver-name": "Firewall-0",
                {
"prov-status": "ACTIVE",
                   "relationship-value"vserver-id": "vFWCL",
       25fb07ab-0478-465e-a021-6384ac299672",
            "relationshipvserver-keyname2": "service-subscription.service-type"Firewall-0",
            "vserver-selflink": "http://10.12.25.2:8774/v2.1/b49b830686654191bb1e952a74b014ad/servers/25fb07ab-0478-465e-a021-6384ac299672",
   },         "is-closed-loop-disabled": false
      {  }],
        "resource-version": "1527638176989",
        "relationshipmodel-valuecustomization-id": "c64565194cc1e555-6acf361f-4adb4d69-997cae21-3c363dd4caaf9f371ea9f40c",
        "vf-modules": {
            "relationshipvf-keymodule": "service-instance.service-instance-id"[{
                 }]"vf-module-name": "vPacketGen-VNF-1128-3",
                "relatedmodel-version-linkid": "/aai/v11/business/customers/customer/Demonstration/service-subscriptions/service-subscription/vFWCL/service-instances/service-instance/c6456519-6acf-4adb-997c-3c363dd4caafd6d4a002-a584-4640-bdce-a50e9bce552b",
                "relatedheat-tostack-propertyid": [{
   "vPacketGen-VNF-1128-3/df34f5d6-ed39-4184-b785-51c37cfa8ac2",
                "propertyresource-keyversion": "service-instance.service-instance-name1527641224058",
   
                "propertymodel-customization-valueid": "Firewall1"49c8f521-e5ee-4095-bb87-4090166e49ab",
                }]
            },
            {"is-base-vf-module": true,
                "relatedvf-module-toid": "l3-network0f792076-f5b3-4251-9fcc-c4d5afae0eb1",
                "relationshipmodule-dataindex": [{0,
                    "relationship-value"model-invariant-id": "HNP1d77c2a8844a8-1094f5f7-41ec46dd-b7f3a732-94bb30951870472c6972a28e",
  
                 "relationshiporchestration-keystatus": "l3-network.network-id"
 active"
              }],
        },
        "related-linkvserver": "/aai/v13/network/l3-networks/l3-network/HNP1d77c-1094-41ec-b7f3-94bb30951871",
   [{
            "relationshipvserver-labelname": "org.onap.relationships.inventory.UsesFirewall-1",
                "related-to-property": [{"vserver-id": "25fb07ab-0478-465e-a021-6384ac299671",
                     "property-key"model-invariant-id": "l3-network.network-name",0c5a20de-87ad-442c-9190-f38ab0a6bb7f"
           }],
        "propertymodel-invariant-valueid": "HNPORTALOAM.OAM"99f1fd3f-845c-48f5-a0ba-11fbde6ae557",
        "vnf-name": "PacketGenerator-1",
      }]      "is-closed-loop-disabled": false
      },
    {
       {    "nf-role": "",
            "relatedservice-toid": "vserver8ea56b0d-459d-4668-b363-c9567432d8b9",
                "relationship-data""relationship-list": [{
       
            "relationship-value": "CloudOwner",
   [{
                "relationshiprelated-keyto": "cloud-region.cloud-owner"service-instance",
                },
                "relationship-data": [{
                    "relationship-value": "RegionOneDemonstration",
                    "relationship-key": "cloud-regioncustomer.cloudglobal-regioncustomer-id"
                },
                {
                    "relationship-value": "b49b830686654191bb1e952a74b014advFWCL",
                    "relationship-key": "tenantservice-subscription.tenantservice-idtype"
                },
                {
                    "relationship-value": "25fb07abc6456519-04786acf-465e4adb-a021997c-6384ac2996713c363dd4caaf",
                    "relationship-key": "vserver.vserverservice-instance.service-instance-id"
                }],
                "related-link": "/aai/v13v11/cloud-infrastructure/cloud-regions/cloud-region/CloudOwner/RegionOne/tenants/tenant/b49b830686654191bb1e952a74b014ad/vservers/vserver/b494cd6e-b9f3-45e0-afe7-e1d1a5f5d74b"business/customers/customer/Demonstration/service-subscriptions/service-subscription/vFWCL/service-instances/service-instance/c6456519-6acf-4adb-997c-3c363dd4caaf",
                "related-to-property": [{
  }]         },         "vnfproperty-idkey": "6700c313service-fbb7instance.service-4cf9instance-ac70-0293ec56df69name",
          "nf-type": "",         "l3property-networksvalue": "Firewall1"
 [{             "network-role": "HNPORTALOAM.OAM",
 }]
           "network-technology": "ovs" },
            "service-id": "V7611HNP-1222-48f1-8085-94aef0c6ef3d51870",{
                "networkrelated-idto": "HNP1d77c-1222-41ec-b7f3-94bb30951870l3-network",
                "neutronrelationship-network-iddata": "491c7cef-a3f4-4990-883e-b0af397466d0", [{
              "is-external-network": false,     "relationship-value": "HNP1d77c-1094-41ec-b7f3-94bb30951870",
      "is-bound-to-vpn": false,             "is-provider-network": false,relationship-key": "l3-network.network-id"
               "network-type": "OVS_PROVIDER_VLAN", }],
                "related-link": "/aai/v13/network/l3-networks/l3-network/HNP1d77c-1094-41ec-b7f3-94bb30951871",
                "orchestrationrelationship-statuslabel": "activeorg.onap.relationships.inventory.Uses",
                "networkrelated-roleto-instanceproperty": 0, [{
                    "resourceproperty-versionkey": "1526558298075l3-network.network-name",
                    "networkproperty-namevalue": "HNPORTALOAM.OAM",
            "is-shared-network": false    }]
            }],
        "prov-status": "PREPROV",   {
     "vnf-type": "vFW-vSINK-service/vPKG 0",         "orchestrationrelated-statusto": "Createdvserver",
        "nf-naming-code": "",         "inrelationship-maintdata": false,[{
          "nf-function": "",         "modelrelationship-version-idvalue": "a5565bf4-d55a-4964-8fbc-6a7674a2e676CloudOwner",
        "vservers": [{             "relationship-listkey": {
  "cloud-region.cloud-owner"
                },
             "relationship": [   {
                    "relatedrelationship-tovalue": "generic-vnfRegionOne",
                    "relationship-data": [{key": "cloud-region.cloud-region-id"
                },
                {
                    "relationship-value": "8a9ddb25-2e79-449c-a40d-5011bac0da39b49b830686654191bb1e952a74b014ad",

                       "relationship-key": "generic-vnftenant.vnftenant-id"
                },
    }],            {
        "related-link": "/aai/v11/network/generic-vnfs/generic-vnf/8a9ddb25-2e79-449c-a40d-5011bac0da39            "relationship-value": "25fb07ab-0478-465e-a021-6384ac299671",
                    "related-to-property": [{relationship-key": "vserver.vserver-id"
                }],
                "propertyrelated-keylink": "generic-vnf.vnf-name",/aai/v13/cloud-infrastructure/cloud-regions/cloud-region/CloudOwner/RegionOne/tenants/tenant/b49b830686654191bb1e952a74b014ad/vservers/vserver/b494cd6e-b9f3-45e0-afe7-e1d1a5f5d74b"
            }]
        },
        "propertyvnf-valueid": "Firewall-1"6700c313-fbb7-4cf9-ac70-0293ec56df69",
        "nf-type": "",
        "l3-networks": [{
}]            "network-role": "HNPORTALOAM.OAM",
   },         "network-technology": "ovs",
      {        "service-id": "V7611HNP-1222-48f1-8085-94aef0c6ef3d51870",
            "relatednetwork-toid": "flavorHNP1d77c-1222-41ec-b7f3-94bb30951870",
            "neutron-network-id": "491c7cef-a3f4-4990-883e-b0af397466d0",
       "relationship-data": [{     "is-external-network": false,
            "is-bound-to-vpn": false,
            "relationshipis-provider-valuenetwork": "CloudOwner"false,
            "network-type": "OVS_PROVIDER_VLAN",
            "relationshiporchestration-keystatus": "cloud-region.cloud-owner"active",
            "network-role-instance": 0,
             }"resource-version": "1526558298075",
            "network-name": "HNPORTALOAM.OAM",
      {      "is-shared-network": false
        }],
        "relationshipprov-valuestatus": "RegionOnePREPROV",
        "vnf-type": "vFW-vSINK-service/vPKG 0",
             "relationshiporchestration-keystatus": "cloud-region.cloud-region-id"Created",
        "nf-naming-code": "",
          }"in-maint": false,
        "nf-function": "",
        "model-version-id":  {"a5565bf4-d55a-4964-8fbc-6a7674a2e676",
           "vservers": [{
             "relationship-valuelist": "764efb04-5a46-4806-a766-2bdd24559f39",{
                        "relationship-key": "flavor.flavor-id"
              "relationship": [{
     }],                     "related-linkto": "/aai/v11/cloud-infrastructure/cloud-regions/cloud-region/CloudOwner/RegionOne/flavors/flavor/764efb04-5a46-4806-a766-2bdd24559f39generic-vnf",
                    "relatedrelationship-to-propertydata": [{
                        "propertyrelationship-keyvalue": "flavor.flavor-name8a9ddb25-2e79-449c-a40d-5011bac0da39",
                        "propertyrelationship-valuekey": "m1.mediumgeneric-vnf.vnf-id"
                    }],
                },                 {
                    "related-to": "image"related-link": "/aai/v11/network/generic-vnfs/generic-vnf/8a9ddb25-2e79-449c-a40d-5011bac0da39",
                    "relationshiprelated-to-dataproperty": [{
                        "relationshipproperty-valuekey": "CloudOwnergeneric-vnf.vnf-name",
                        "relationshipproperty-keyvalue": "cloud-region.cloud-ownerFirewall-1"
                    },]
                },
            {    {
                    "relationshiprelated-valueto": "RegionOneflavor",
                        "relationship-keydata": [{
                        "relationship-value": "CloudOwner",
                        "relationship-key": "cloud-region.cloud-region-idowner"
                    },
                    {
                        "relationship-value": "42fd42f8-cf81-4f4c-a552-d4b124f83b0bRegionOne",
                        "relationship-key": "image.imagecloud-region.cloud-region-id"
                    }],
,
                    {
                        "relatedrelationship-linkvalue": "/aai/v11/cloud-infrastructure/cloud-regions/cloud-region/CloudOwner/RegionOne/images/image/42fd42f8-cf81-4f4c-a552-d4b124f83b0b764efb04-5a46-4806-a766-2bdd24559f39",
                        "relatedrelationship-to-propertykey": [{"flavor.flavor-id"
                        "property-key": "image.image-name",
   }],
                    "propertyrelated-valuelink": "unknown"/aai/v11/cloud-infrastructure/cloud-regions/cloud-region/CloudOwner/RegionOne/flavors/flavor/764efb04-5a46-4806-a766-2bdd24559f39",
                    }]"related-to-property": [{
                        }]
"property-key": "flavor.flavor-name",
           },             "inproperty-maintvalue": false, "m1.medium"
                   "resource-version": "1528481820321", }]
            "vserver-name": "Firewall-0",   },
         "prov-status": "ACTIVE",      {
      "vserver-id": "b494cd6e-b9f3-45e0-afe7-e1d1a5f5d74b",             "vserverrelated-name2to": "Firewall-0image",
            "vserver-selflink": "http://10.12.25.2:8774/v2.1/b49b830686654191bb1e952a74b014ad/servers/25fb07ab-0478-465e-a021-6384ac299671",        "relationship-data": [{
     "is-closed-loop-disabled": false         }],         "resourcerelationship-versionvalue": "1527638176989CloudOwner",
              "model-customization-id": "4cc1e555-361f-4d69-ae21-9f371ea9f40c",         "vfrelationship-moduleskey": { "cloud-region.cloud-owner"
             "vf-module": [{      },
          "vf-module-name": "vPacketGen-VNF-1128-3",          {
      "model-version-id": "d6d4a002-a584-4640-bdce-a50e9bce552b",                 "heatrelationship-stack-idvalue": "vPacketGen-VNF-1128-3/df34f5d6-ed39-4184-b785-51c37cfa8ac2RegionOne",
  
             "resource-version": "1527641224058",                 "modelrelationship-customization-idkey": "49c8f521cloud-e5eeregion.cloud-4095region-bb87-4090166e49ab",id"
                   "is-base-vf-module": true },
                "vf-module-id": "0f792076-f5b3-4251-9fcc-c4d5afae0eb1",     {
            "module-index": 0,                 "modelrelationship-invariant-idvalue": "2a8844a842fd42f8-f5f7cf81-46dd4f4c-a732a552-472c6972a28ed4b124f83b0b",
                        "orchestrationrelationship-statuskey": "activeimage.image-id"
            }]         }],
 
      "vserver": [{             "vserverrelated-namelink": "Firewall-1",
            "vserver-id": "25fb07ab-0478-465e-a021-6384ac299672",/aai/v11/cloud-infrastructure/cloud-regions/cloud-region/CloudOwner/RegionOne/images/image/42fd42f8-cf81-4f4c-a552-d4b124f83b0b",
                    "modelrelated-invariantto-idproperty": "0c5a20de-87ad-442c-9190-f38ab0a6bb7f" [{
               }],         "modelproperty-invariant-idkey": "99f1fd3f-845c-48f5-a0ba-11fbde6ae557",image.image-name",
                        "vnfproperty-namevalue": "PacketGenerator-2unknown",
         "is-closed-loop-disabled": false     }],     "model-invariant-id": "0c5a20de-87ad-442c-9190-f38ab0a6bb7f",}]
                }]
            },
            "in-maint": false,
            "resource-version": "1528481820321",
            "service-instancevserver-name": "Firewall1"
}

Network Discovery

Network Discovery Context Builder →
Firewall-0",
            "prov-status": "ACTIVE",
            "vserver-id": "b494cd6e-b9f3-45e0-afe7-e1d1a5f5d74b",
            "vserver-name2": "Firewall-0",
            "vserver-selflink": "http://10.12.25.2:8774/v2.1/b49b830686654191bb1e952a74b014ad/servers/25fb07ab-0478-465e-a021-6384ac299671",
            "is-closed-loop-disabled": false
        }],
        "resource-version": "1527638176989",
        "model-customization-id": "4cc1e555-361f-4d69-ae21-9f371ea9f40c",
        "vf-modules": {
            "vf-module": [{
                "vf-module-name": "vPacketGen-VNF-1128-3",
                "model-version-id": "d6d4a002-a584-4640-bdce-a50e9bce552b",
                "heat-stack-id": "vPacketGen-VNF-1128-3/df34f5d6-ed39-4184-b785-51c37cfa8ac2",
                "resource-version": "1527641224058",
                "model-customization-id": "49c8f521-e5ee-4095-bb87-4090166e49ab",
                "is-base-vf-module": true,
                "vf-module-id": "0f792076-f5b3-4251-9fcc-c4d5afae0eb1",
                "module-index": 0,
                "model-invariant-id": "2a8844a8-f5f7-46dd-a732-472c6972a28e",
                "orchestration-status": "active"
            }]
        },
        "vserver": [{
            "vserver-name": "Firewall-1",
            "vserver-id": "25fb07ab-0478-465e-a021-6384ac299672",
            "model-invariant-id": "0c5a20de-87ad-442c-9190-f38ab0a6bb7f"
        }],
        "model-invariant-id": "99f1fd3f-845c-48f5-a0ba-11fbde6ae557",
        "vnf-name": "PacketGenerator-2",
        "is-closed-loop-disabled": false
    }],
    "model-invariant-id": "0c5a20de-87ad-442c-9190-f38ab0a6bb7f",
    "service-instance-name": "Firewall1"
}

Network Discovery

Network Discovery Context Builder → Network Discovery

The context builder next needs to send multiple requests – one for each resource provided by Service Decomposition – to Network Discovery in order to obtain the values of associated attributes.

Request (Network Resource)
Code Block
languagejs
collapsetrue
http://10.147.112.148:8080/network-discovery/v1/network/resource?id?requestId=d4ec9585-eb78-4450-b52c-dc3fa6194667___3?resourceType=l3-network?resourceId=HNP1d77c-1222-41ec-b7f3-94bb30951870?notificationURL=http://10.147.112.148:8080/network-discovery/v1/network/resource






Network Discovery → AAI Enricher

For each resource passed to it, Network Discovery simply hands off the discovery work to the AAI Enricher, which utilizes addons to query live networks. (Note: Enricher is not in ONAP at this time but the responses could be mocked.)

Request

mocked.)

Request
Code Block
languagejs
collapsetrue
https://d2enrichment:9505/enricher/v11/network/l3-networks/l3-network/HNP1d77c-1222-41ec-b7f3-94bb30951870?sot=!aai


Response
Code Block
languagejsxml
collapsetrue
httpse.g.


<l3-network xmlns="http://d2enrichment:9505/enricher/v11/network/l3-networks/l3-network/HNP1d77c-1222-41ec-b7f3-94bb30951870?sot=!aai
Response
org.openecomp.aai.inventory/v10">
  <network-id>HNP1d77c-1222-41ec-b7f3-94bb30951870</network-id>
  <network-name>networkname</network-name>
  <is-shared-network>true</is-shared-network>
  <in-maint>false</in-maint>
  <retrieval-timestamp>2018-09-12 01:02:03 +0000</retrieval-timestamp>
</l3-network>
Response (Network Resource)
Code Block
language
xml
js
collapsetrue
[requestId=9d9bbc4a-787a-44d3-8ac4-37daed95b252___13, code=200, message=OK, ackFinalIndicator=true, resources=[Resource [id=HNP1d77c-1222-41ec-b7f3-94bb30951870, name=null, type=l3-network, dataQuality=DataQuality [status=error, errorText=ENRICHER-312, Unknown SoT as Enricher could not recognize the SoT reference.], attributeList=null]]]




Request (VM Resource)
Code Block
languagejs
collapsetrue

     

Network Discovery → AAI Enricher

Request
Code Block
languagejs
collapsetrue


Response
Code Block
language
js
xml
collapsetrue
[requestId=9d9bbc4a-787a-44d3-8ac4-37daed95b252___13, code=200, message=OK, ackFinalIndicator=true, resources=[Resource [id=HNP1d77c-1222-41ec-b7f3-94bb30951870, name=null, type=l3-network, dataQuality=DataQuality [status=error, errorText=ENRICHER-312, Unknown SoT as Enricher could not recognize the SoT reference.], attributeList=null]]]
e.g.


<vserver xmlns="http://org.openecomp.aai.invetory/v10">
  <vserver-id>9168b536-cd40-4630-b43f-b259807c6e87</vserver-id>
  <vserver-name>new-server-test</vserver-name>
  <locked>false</locked>
  <hostname>kll0123</hostname>
  <image-id>70a599e0-31e7-49b7-b260-868f441e862b</image-id>
  <retrieval-timestamp>2018-09-04 01:23:45 +0000</retrieval-timestamp>
</vserver>
Response (VM Resource)
Code Block
languagejs
collapsetrue