added new aai-schema-ingest library
[aai/aai-common.git] / aai-schema / src / main / resources / aai_swagger_yaml / aai_swagger_v11.yaml
index ea3badd..7b6536a 100644 (file)
@@ -1,6 +1,9 @@
 swagger: "2.0"
 info:
   description: |
+
+    [Differences versus the previous schema version](apidocs/aai_swagger_v11.diff)
+
     Copyright © 2017 AT&T Intellectual Property. All rights reserved.
 
     Licensed under the Creative Commons License, Attribution 4.0 Intl. (the "License"); you may not use this documentation except in compliance with the License.
@@ -49,19 +52,22 @@ paths:
           description: Unique identifier for physical location, e.g., CLLI
           required: true
           type: string
+          example: __PHYSICAL-LOCATION-ID__
         - name: target-pe
           in: path
           description: The Target provider edge router
           required: true
           type: string
+          example: __TARGET-PE__
         - name: availability-zone-name
           in: path
           description: Name of the availability zone
           required: true
           type: string
+          example: __AVAILABILITY-ZONE-NAME__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureComplexesComplexCtagPoolsCtagPool.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -86,16 +92,19 @@ paths:
           description: Unique identifier for physical location, e.g., CLLI
           required: true
           type: string
+          example: __PHYSICAL-LOCATION-ID__
         - name: target-pe
           in: path
           description: The Target provider edge router
           required: true
           type: string
+          example: __TARGET-PE__
         - name: availability-zone-name
           in: path
           description: Name of the availability zone
           required: true
           type: string
+          example: __AVAILABILITY-ZONE-NAME__
   /cloud-infrastructure/complexes/complex/{physical-location-id}/ctag-pools/ctag-pool/{target-pe}/{availability-zone-name}:
     get:
       tags:
@@ -110,7 +119,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/ctag-pool"
+              $ref: "#/getDefinitions/ctag-pool"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -119,16 +128,19 @@ paths:
           description: Unique identifier for physical location, e.g., CLLI
           required: true
           type: string
+          example: __PHYSICAL-LOCATION-ID__
         - name: target-pe
           in: path
           description: The Target provider edge router
           required: true
           type: string
+          example: __TARGET-PE__
         - name: availability-zone-name
           in: path
           description: Name of the availability zone
           required: true
           type: string
+          example: __AVAILABILITY-ZONE-NAME__
         - name: data-center-code
           in: query
           description: Data center code which can be an alternate way to identify a complex
@@ -148,7 +160,10 @@ paths:
       tags:
         - CloudInfrastructure
       summary: create or update an existing ctag-pool
-      description: create or update an existing ctag-pool
+      description: |
+        Create or update an existing ctag-pool.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
       operationId: createOrUpdateCloudInfrastructureComplexesComplexCtagPoolsCtagPool
       consumes:
         - application/json
@@ -165,22 +180,76 @@ paths:
           description: Unique identifier for physical location, e.g., CLLI
           required: true
           type: string
+          example: __PHYSICAL-LOCATION-ID__
         - name: target-pe
           in: path
           description: The Target provider edge router
           required: true
           type: string
+          example: __TARGET-PE__
         - name: availability-zone-name
           in: path
           description: Name of the availability zone
           required: true
           type: string
+          example: __AVAILABILITY-ZONE-NAME__
         - name: body
           in: body
-          description: ctag-pool object that needs to be created or updated
+          description: ctag-pool object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureComplexesComplexCtagPoolsCtagPool.json)
           required: true
           schema:
             $ref: "#/definitions/ctag-pool"
+    patch:
+      tags:
+        - CloudInfrastructure
+      summary: update an existing ctag-pool
+      description: |
+        Update an existing ctag-pool
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateCloudInfrastructureComplexesComplexCtagPoolsCtagPool
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: physical-location-id
+          in: path
+          description: Unique identifier for physical location, e.g., CLLI
+          required: true
+          type: string
+          example: __PHYSICAL-LOCATION-ID__
+        - name: target-pe
+          in: path
+          description: The Target provider edge router
+          required: true
+          type: string
+          example: __TARGET-PE__
+        - name: availability-zone-name
+          in: path
+          description: Name of the availability zone
+          required: true
+          type: string
+          example: __AVAILABILITY-ZONE-NAME__
+        - name: body
+          in: body
+          description: ctag-pool object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/ctag-pool"
     delete:
       tags:
         - CloudInfrastructure
@@ -202,16 +271,19 @@ paths:
           description: Unique identifier for physical location, e.g., CLLI
           required: true
           type: string
+          example: __PHYSICAL-LOCATION-ID__
         - name: target-pe
           in: path
           description: The Target provider edge router
           required: true
           type: string
+          example: __TARGET-PE__
         - name: availability-zone-name
           in: path
           description: Name of the availability zone
           required: true
           type: string
+          example: __AVAILABILITY-ZONE-NAME__
         - name: resource-version
           in: query
           description: resource-version for concurrency
@@ -231,7 +303,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/ctag-pools"
+              $ref: "#/getDefinitions/ctag-pools"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -240,6 +312,7 @@ paths:
           description: Unique identifier for physical location, e.g., CLLI
           required: true
           type: string
+          example: __PHYSICAL-LOCATION-ID__
         - name: data-center-code
           in: query
           description: Data center code which can be an alternate way to identify a complex
@@ -276,9 +349,10 @@ paths:
           description: Unique identifier for physical location, e.g., CLLI
           required: true
           type: string
+          example: __PHYSICAL-LOCATION-ID__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureComplexesComplex.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -303,6 +377,7 @@ paths:
           description: Unique identifier for physical location, e.g., CLLI
           required: true
           type: string
+          example: __PHYSICAL-LOCATION-ID__
   /cloud-infrastructure/complexes/complex/{physical-location-id}:
     get:
       tags:
@@ -317,7 +392,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/complex"
+              $ref: "#/getDefinitions/complex"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -326,6 +401,7 @@ paths:
           description: Unique identifier for physical location, e.g., CLLI
           required: true
           type: string
+          example: __PHYSICAL-LOCATION-ID__
         - name: data-center-code
           in: query
           description: Data center code which can be an alternate way to identify a complex
@@ -345,7 +421,10 @@ paths:
       tags:
         - CloudInfrastructure
       summary: create or update an existing complex
-      description: create or update an existing complex
+      description: |
+        Create or update an existing complex.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
       operationId: createOrUpdateCloudInfrastructureComplexesComplex
       consumes:
         - application/json
@@ -362,12 +441,52 @@ paths:
           description: Unique identifier for physical location, e.g., CLLI
           required: true
           type: string
+          example: __PHYSICAL-LOCATION-ID__
         - name: body
           in: body
-          description: complex object that needs to be created or updated
+          description: complex object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureComplexesComplex.json)
           required: true
           schema:
             $ref: "#/definitions/complex"
+    patch:
+      tags:
+        - CloudInfrastructure
+      summary: update an existing complex
+      description: |
+        Update an existing complex
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateCloudInfrastructureComplexesComplex
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: physical-location-id
+          in: path
+          description: Unique identifier for physical location, e.g., CLLI
+          required: true
+          type: string
+          example: __PHYSICAL-LOCATION-ID__
+        - name: body
+          in: body
+          description: complex object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/complex"
     delete:
       tags:
         - CloudInfrastructure
@@ -389,6 +508,7 @@ paths:
           description: Unique identifier for physical location, e.g., CLLI
           required: true
           type: string
+          example: __PHYSICAL-LOCATION-ID__
         - name: resource-version
           in: query
           description: resource-version for concurrency
@@ -408,7 +528,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/complexes"
+              $ref: "#/getDefinitions/complexes"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
   /cloud-infrastructure/cloud-regions/cloud-region/{cloud-owner}/{cloud-region-id}/volume-groups/volume-group/{volume-group-id}/relationship-list/relationship:
@@ -432,19 +552,22 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: volume-group-id
           in: path
           description: Unique ID of volume-group.
           required: true
           type: string
+          example: __VOLUME-GROUP-ID__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionVolumeGroupsVolumeGroup.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -469,16 +592,19 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: volume-group-id
           in: path
           description: Unique ID of volume-group.
           required: true
           type: string
+          example: __VOLUME-GROUP-ID__
   /cloud-infrastructure/cloud-regions/cloud-region/{cloud-owner}/{cloud-region-id}/volume-groups/volume-group/{volume-group-id}:
     get:
       tags:
@@ -493,7 +619,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/volume-group"
+              $ref: "#/getDefinitions/volume-group"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -502,16 +628,19 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: volume-group-id
           in: path
           description: Unique ID of volume-group.
           required: true
           type: string
+          example: __VOLUME-GROUP-ID__
         - name: cloud-type
           in: query
           description: Type of the cloud (e.g., openstack)
@@ -541,7 +670,10 @@ paths:
       tags:
         - CloudInfrastructure
       summary: create or update an existing volume-group
-      description: create or update an existing volume-group
+      description: |
+        Create or update an existing volume-group.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
       operationId: createOrUpdateCloudInfrastructureCloudRegionsCloudRegionVolumeGroupsVolumeGroup
       consumes:
         - application/json
@@ -558,22 +690,76 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: volume-group-id
           in: path
           description: Unique ID of volume-group.
           required: true
           type: string
+          example: __VOLUME-GROUP-ID__
         - name: body
           in: body
-          description: volume-group object that needs to be created or updated
+          description: volume-group object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionVolumeGroupsVolumeGroup.json)
           required: true
           schema:
             $ref: "#/definitions/volume-group"
+    patch:
+      tags:
+        - CloudInfrastructure
+      summary: update an existing volume-group
+      description: |
+        Update an existing volume-group
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateCloudInfrastructureCloudRegionsCloudRegionVolumeGroupsVolumeGroup
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: cloud-owner
+          in: path
+          description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
+          required: true
+          type: string
+          example: __CLOUD-OWNER__
+        - name: cloud-region-id
+          in: path
+          description: Identifier used by the vendor for the region. Second part of composite key
+          required: true
+          type: string
+          example: __CLOUD-REGION-ID__
+        - name: volume-group-id
+          in: path
+          description: Unique ID of volume-group.
+          required: true
+          type: string
+          example: __VOLUME-GROUP-ID__
+        - name: body
+          in: body
+          description: volume-group object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/volume-group"
     delete:
       tags:
         - CloudInfrastructure
@@ -595,16 +781,19 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: volume-group-id
           in: path
           description: Unique ID of volume-group.
           required: true
           type: string
+          example: __VOLUME-GROUP-ID__
         - name: resource-version
           in: query
           description: resource-version for concurrency
@@ -624,7 +813,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/volume-groups"
+              $ref: "#/getDefinitions/volume-groups"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -633,11 +822,13 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: cloud-type
           in: query
           description: Type of the cloud (e.g., openstack)
@@ -669,29 +860,34 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: tenant-id
           in: path
           description: Unique id relative to the cloud-region.
           required: true
           type: string
+          example: __TENANT-ID__
         - name: vserver-id
           in: path
           description: Unique identifier for this vserver relative to its tenant
           required: true
           type: string
+          example: __VSERVER-ID__
         - name: volume-id
           in: path
           description: Unique ID of block storage volume relative to the vserver.
           required: true
           type: string
+          example: __VOLUME-ID__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverVolumesVolume.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -716,26 +912,31 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: tenant-id
           in: path
           description: Unique id relative to the cloud-region.
           required: true
           type: string
+          example: __TENANT-ID__
         - name: vserver-id
           in: path
           description: Unique identifier for this vserver relative to its tenant
           required: true
           type: string
+          example: __VSERVER-ID__
         - name: volume-id
           in: path
           description: Unique ID of block storage volume relative to the vserver.
           required: true
           type: string
+          example: __VOLUME-ID__
   /cloud-infrastructure/cloud-regions/cloud-region/{cloud-owner}/{cloud-region-id}/tenants/tenant/{tenant-id}/vservers/vserver/{vserver-id}/volumes/volume/{volume-id}:
     get:
       tags:
@@ -750,7 +951,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/volume"
+              $ref: "#/getDefinitions/volume"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -759,26 +960,31 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: tenant-id
           in: path
           description: Unique id relative to the cloud-region.
           required: true
           type: string
+          example: __TENANT-ID__
         - name: vserver-id
           in: path
           description: Unique identifier for this vserver relative to its tenant
           required: true
           type: string
+          example: __VSERVER-ID__
         - name: volume-id
           in: path
           description: Unique ID of block storage volume relative to the vserver.
           required: true
           type: string
+          example: __VOLUME-ID__
         - name: cloud-type
           in: query
           description: Type of the cloud (e.g., openstack)
@@ -826,7 +1032,10 @@ paths:
       tags:
         - CloudInfrastructure
       summary: create or update an existing volume
-      description: create or update an existing volume
+      description: |
+        Create or update an existing volume.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
       operationId: createOrUpdateCloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverVolumesVolume
       consumes:
         - application/json
@@ -843,32 +1052,100 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: tenant-id
           in: path
           description: Unique id relative to the cloud-region.
           required: true
           type: string
+          example: __TENANT-ID__
         - name: vserver-id
           in: path
           description: Unique identifier for this vserver relative to its tenant
           required: true
           type: string
+          example: __VSERVER-ID__
         - name: volume-id
           in: path
           description: Unique ID of block storage volume relative to the vserver.
           required: true
           type: string
+          example: __VOLUME-ID__
         - name: body
           in: body
-          description: volume object that needs to be created or updated
+          description: volume object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverVolumesVolume.json)
           required: true
           schema:
             $ref: "#/definitions/volume"
+    patch:
+      tags:
+        - CloudInfrastructure
+      summary: update an existing volume
+      description: |
+        Update an existing volume
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateCloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverVolumesVolume
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: cloud-owner
+          in: path
+          description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
+          required: true
+          type: string
+          example: __CLOUD-OWNER__
+        - name: cloud-region-id
+          in: path
+          description: Identifier used by the vendor for the region. Second part of composite key
+          required: true
+          type: string
+          example: __CLOUD-REGION-ID__
+        - name: tenant-id
+          in: path
+          description: Unique id relative to the cloud-region.
+          required: true
+          type: string
+          example: __TENANT-ID__
+        - name: vserver-id
+          in: path
+          description: Unique identifier for this vserver relative to its tenant
+          required: true
+          type: string
+          example: __VSERVER-ID__
+        - name: volume-id
+          in: path
+          description: Unique ID of block storage volume relative to the vserver.
+          required: true
+          type: string
+          example: __VOLUME-ID__
+        - name: body
+          in: body
+          description: volume object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/volume"
     delete:
       tags:
         - CloudInfrastructure
@@ -890,26 +1167,31 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: tenant-id
           in: path
           description: Unique id relative to the cloud-region.
           required: true
           type: string
+          example: __TENANT-ID__
         - name: vserver-id
           in: path
           description: Unique identifier for this vserver relative to its tenant
           required: true
           type: string
+          example: __VSERVER-ID__
         - name: volume-id
           in: path
           description: Unique ID of block storage volume relative to the vserver.
           required: true
           type: string
+          example: __VOLUME-ID__
         - name: resource-version
           in: query
           description: resource-version for concurrency
@@ -929,7 +1211,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/volumes"
+              $ref: "#/getDefinitions/volumes"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -938,21 +1220,25 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: tenant-id
           in: path
           description: Unique id relative to the cloud-region.
           required: true
           type: string
+          example: __TENANT-ID__
         - name: vserver-id
           in: path
           description: Unique identifier for this vserver relative to its tenant
           required: true
           type: string
+          example: __VSERVER-ID__
         - name: cloud-type
           in: query
           description: Type of the cloud (e.g., openstack)
@@ -1017,24 +1303,28 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: tenant-id
           in: path
           description: Unique id relative to the cloud-region.
           required: true
           type: string
+          example: __TENANT-ID__
         - name: vserver-id
           in: path
           description: Unique identifier for this vserver relative to its tenant
           required: true
           type: string
+          example: __VSERVER-ID__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserver.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -1059,21 +1349,25 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: tenant-id
           in: path
           description: Unique id relative to the cloud-region.
           required: true
           type: string
+          example: __TENANT-ID__
         - name: vserver-id
           in: path
           description: Unique identifier for this vserver relative to its tenant
           required: true
           type: string
+          example: __VSERVER-ID__
   /cloud-infrastructure/cloud-regions/cloud-region/{cloud-owner}/{cloud-region-id}/tenants/tenant/{tenant-id}/vservers/vserver/{vserver-id}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/relationship-list/relationship:
     put:
       tags:
@@ -1095,34 +1389,40 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: tenant-id
           in: path
           description: Unique id relative to the cloud-region.
           required: true
           type: string
+          example: __TENANT-ID__
         - name: vserver-id
           in: path
           description: Unique identifier for this vserver relative to its tenant
           required: true
           type: string
+          example: __VSERVER-ID__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vlan-interface
           in: path
           description: String that identifies the interface
           required: true
           type: string
+          example: __VLAN-INTERFACE__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterfaceVlansVlan.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -1147,31 +1447,37 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: tenant-id
           in: path
           description: Unique id relative to the cloud-region.
           required: true
           type: string
+          example: __TENANT-ID__
         - name: vserver-id
           in: path
           description: Unique identifier for this vserver relative to its tenant
           required: true
           type: string
+          example: __VSERVER-ID__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vlan-interface
           in: path
           description: String that identifies the interface
           required: true
           type: string
+          example: __VLAN-INTERFACE__
   /cloud-infrastructure/cloud-regions/cloud-region/{cloud-owner}/{cloud-region-id}/tenants/tenant/{tenant-id}/vservers/vserver/{vserver-id}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}/relationship-list/relationship:
     put:
       tags:
@@ -1193,39 +1499,46 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: tenant-id
           in: path
           description: Unique id relative to the cloud-region.
           required: true
           type: string
+          example: __TENANT-ID__
         - name: vserver-id
           in: path
           description: Unique identifier for this vserver relative to its tenant
           required: true
           type: string
+          example: __VSERVER-ID__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vlan-interface
           in: path
           description: String that identifies the interface
           required: true
           type: string
+          example: __VLAN-INTERFACE__
         - name: l3-interface-ipv4-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -1250,36 +1563,43 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: tenant-id
           in: path
           description: Unique id relative to the cloud-region.
           required: true
           type: string
+          example: __TENANT-ID__
         - name: vserver-id
           in: path
           description: Unique identifier for this vserver relative to its tenant
           required: true
           type: string
+          example: __VSERVER-ID__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vlan-interface
           in: path
           description: String that identifies the interface
           required: true
           type: string
+          example: __VLAN-INTERFACE__
         - name: l3-interface-ipv4-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
   /cloud-infrastructure/cloud-regions/cloud-region/{cloud-owner}/{cloud-region-id}/tenants/tenant/{tenant-id}/vservers/vserver/{vserver-id}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}:
     get:
       tags:
@@ -1294,7 +1614,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/l3-interface-ipv4-address-list"
+              $ref: "#/getDefinitions/l3-interface-ipv4-address-list"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -1303,36 +1623,43 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: tenant-id
           in: path
           description: Unique id relative to the cloud-region.
           required: true
           type: string
+          example: __TENANT-ID__
         - name: vserver-id
           in: path
           description: Unique identifier for this vserver relative to its tenant
           required: true
           type: string
+          example: __VSERVER-ID__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vlan-interface
           in: path
           description: String that identifies the interface
           required: true
           type: string
+          example: __VLAN-INTERFACE__
         - name: l3-interface-ipv4-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
         - name: cloud-type
           in: query
           description: Type of the cloud (e.g., openstack)
@@ -1422,7 +1749,10 @@ paths:
       tags:
         - CloudInfrastructure
       summary: create or update an existing l3-interface-ipv4-address-list
-      description: create or update an existing l3-interface-ipv4-address-list
+      description: |
+        Create or update an existing l3-interface-ipv4-address-list.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
       operationId: createOrUpdateCloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList
       consumes:
         - application/json
@@ -1439,42 +1769,124 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: tenant-id
           in: path
           description: Unique id relative to the cloud-region.
           required: true
           type: string
+          example: __TENANT-ID__
         - name: vserver-id
           in: path
           description: Unique identifier for this vserver relative to its tenant
           required: true
           type: string
+          example: __VSERVER-ID__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vlan-interface
           in: path
           description: String that identifies the interface
           required: true
           type: string
+          example: __VLAN-INTERFACE__
         - name: l3-interface-ipv4-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
         - name: body
           in: body
-          description: l3-interface-ipv4-address-list object that needs to be created or updated
+          description: l3-interface-ipv4-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList.json)
           required: true
           schema:
             $ref: "#/definitions/l3-interface-ipv4-address-list"
+    patch:
+      tags:
+        - CloudInfrastructure
+      summary: update an existing l3-interface-ipv4-address-list
+      description: |
+        Update an existing l3-interface-ipv4-address-list
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateCloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: cloud-owner
+          in: path
+          description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
+          required: true
+          type: string
+          example: __CLOUD-OWNER__
+        - name: cloud-region-id
+          in: path
+          description: Identifier used by the vendor for the region. Second part of composite key
+          required: true
+          type: string
+          example: __CLOUD-REGION-ID__
+        - name: tenant-id
+          in: path
+          description: Unique id relative to the cloud-region.
+          required: true
+          type: string
+          example: __TENANT-ID__
+        - name: vserver-id
+          in: path
+          description: Unique identifier for this vserver relative to its tenant
+          required: true
+          type: string
+          example: __VSERVER-ID__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
+          type: string
+          example: __VLAN-INTERFACE__
+        - name: l3-interface-ipv4-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
+        - name: body
+          in: body
+          description: l3-interface-ipv4-address-list object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/l3-interface-ipv4-address-list"
     delete:
       tags:
         - CloudInfrastructure
@@ -1496,36 +1908,43 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: tenant-id
           in: path
           description: Unique id relative to the cloud-region.
           required: true
           type: string
+          example: __TENANT-ID__
         - name: vserver-id
           in: path
           description: Unique identifier for this vserver relative to its tenant
           required: true
           type: string
+          example: __VSERVER-ID__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vlan-interface
           in: path
           description: String that identifies the interface
           required: true
           type: string
+          example: __VLAN-INTERFACE__
         - name: l3-interface-ipv4-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
         - name: resource-version
           in: query
           description: resource-version for concurrency
@@ -1552,39 +1971,46 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: tenant-id
           in: path
           description: Unique id relative to the cloud-region.
           required: true
           type: string
+          example: __TENANT-ID__
         - name: vserver-id
           in: path
           description: Unique identifier for this vserver relative to its tenant
           required: true
           type: string
+          example: __VSERVER-ID__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vlan-interface
           in: path
           description: String that identifies the interface
           required: true
           type: string
+          example: __VLAN-INTERFACE__
         - name: l3-interface-ipv6-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -1609,36 +2035,43 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: tenant-id
           in: path
           description: Unique id relative to the cloud-region.
           required: true
           type: string
+          example: __TENANT-ID__
         - name: vserver-id
           in: path
           description: Unique identifier for this vserver relative to its tenant
           required: true
           type: string
+          example: __VSERVER-ID__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vlan-interface
           in: path
           description: String that identifies the interface
           required: true
           type: string
+          example: __VLAN-INTERFACE__
         - name: l3-interface-ipv6-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
   /cloud-infrastructure/cloud-regions/cloud-region/{cloud-owner}/{cloud-region-id}/tenants/tenant/{tenant-id}/vservers/vserver/{vserver-id}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}:
     get:
       tags:
@@ -1653,7 +2086,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/l3-interface-ipv6-address-list"
+              $ref: "#/getDefinitions/l3-interface-ipv6-address-list"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -1662,36 +2095,43 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: tenant-id
           in: path
           description: Unique id relative to the cloud-region.
           required: true
           type: string
+          example: __TENANT-ID__
         - name: vserver-id
           in: path
           description: Unique identifier for this vserver relative to its tenant
           required: true
           type: string
+          example: __VSERVER-ID__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vlan-interface
           in: path
           description: String that identifies the interface
           required: true
           type: string
+          example: __VLAN-INTERFACE__
         - name: l3-interface-ipv6-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
         - name: cloud-type
           in: query
           description: Type of the cloud (e.g., openstack)
@@ -1781,7 +2221,10 @@ paths:
       tags:
         - CloudInfrastructure
       summary: create or update an existing l3-interface-ipv6-address-list
-      description: create or update an existing l3-interface-ipv6-address-list
+      description: |
+        Create or update an existing l3-interface-ipv6-address-list.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
       operationId: createOrUpdateCloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList
       consumes:
         - application/json
@@ -1798,42 +2241,124 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: tenant-id
           in: path
           description: Unique id relative to the cloud-region.
           required: true
           type: string
+          example: __TENANT-ID__
         - name: vserver-id
           in: path
           description: Unique identifier for this vserver relative to its tenant
           required: true
           type: string
+          example: __VSERVER-ID__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vlan-interface
           in: path
           description: String that identifies the interface
           required: true
           type: string
+          example: __VLAN-INTERFACE__
         - name: l3-interface-ipv6-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
         - name: body
           in: body
-          description: l3-interface-ipv6-address-list object that needs to be created or updated
+          description: l3-interface-ipv6-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList.json)
           required: true
           schema:
             $ref: "#/definitions/l3-interface-ipv6-address-list"
+    patch:
+      tags:
+        - CloudInfrastructure
+      summary: update an existing l3-interface-ipv6-address-list
+      description: |
+        Update an existing l3-interface-ipv6-address-list
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateCloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: cloud-owner
+          in: path
+          description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
+          required: true
+          type: string
+          example: __CLOUD-OWNER__
+        - name: cloud-region-id
+          in: path
+          description: Identifier used by the vendor for the region. Second part of composite key
+          required: true
+          type: string
+          example: __CLOUD-REGION-ID__
+        - name: tenant-id
+          in: path
+          description: Unique id relative to the cloud-region.
+          required: true
+          type: string
+          example: __TENANT-ID__
+        - name: vserver-id
+          in: path
+          description: Unique identifier for this vserver relative to its tenant
+          required: true
+          type: string
+          example: __VSERVER-ID__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
+          type: string
+          example: __VLAN-INTERFACE__
+        - name: l3-interface-ipv6-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
+        - name: body
+          in: body
+          description: l3-interface-ipv6-address-list object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/l3-interface-ipv6-address-list"
     delete:
       tags:
         - CloudInfrastructure
@@ -1855,36 +2380,43 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: tenant-id
           in: path
           description: Unique id relative to the cloud-region.
           required: true
           type: string
+          example: __TENANT-ID__
         - name: vserver-id
           in: path
           description: Unique identifier for this vserver relative to its tenant
           required: true
           type: string
+          example: __VSERVER-ID__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vlan-interface
           in: path
           description: String that identifies the interface
           required: true
           type: string
+          example: __VLAN-INTERFACE__
         - name: l3-interface-ipv6-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
         - name: resource-version
           in: query
           description: resource-version for concurrency
@@ -1904,7 +2436,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/vlan"
+              $ref: "#/getDefinitions/vlan"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -1913,31 +2445,37 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: tenant-id
           in: path
           description: Unique id relative to the cloud-region.
           required: true
           type: string
+          example: __TENANT-ID__
         - name: vserver-id
           in: path
           description: Unique identifier for this vserver relative to its tenant
           required: true
           type: string
+          example: __VSERVER-ID__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vlan-interface
           in: path
           description: String that identifies the interface
           required: true
           type: string
+          example: __VLAN-INTERFACE__
         - name: cloud-type
           in: query
           description: Type of the cloud (e.g., openstack)
@@ -2011,7 +2549,10 @@ paths:
       tags:
         - CloudInfrastructure
       summary: create or update an existing vlan
-      description: create or update an existing vlan
+      description: |
+        Create or update an existing vlan.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
       operationId: createOrUpdateCloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterfaceVlansVlan
       consumes:
         - application/json
@@ -2028,37 +2569,112 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: tenant-id
           in: path
           description: Unique id relative to the cloud-region.
           required: true
           type: string
+          example: __TENANT-ID__
         - name: vserver-id
           in: path
           description: Unique identifier for this vserver relative to its tenant
           required: true
           type: string
+          example: __VSERVER-ID__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vlan-interface
           in: path
           description: String that identifies the interface
           required: true
           type: string
+          example: __VLAN-INTERFACE__
         - name: body
           in: body
-          description: vlan object that needs to be created or updated
+          description: vlan object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterfaceVlansVlan.json)
           required: true
           schema:
             $ref: "#/definitions/vlan"
+    patch:
+      tags:
+        - CloudInfrastructure
+      summary: update an existing vlan
+      description: |
+        Update an existing vlan
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateCloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterfaceVlansVlan
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: cloud-owner
+          in: path
+          description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
+          required: true
+          type: string
+          example: __CLOUD-OWNER__
+        - name: cloud-region-id
+          in: path
+          description: Identifier used by the vendor for the region. Second part of composite key
+          required: true
+          type: string
+          example: __CLOUD-REGION-ID__
+        - name: tenant-id
+          in: path
+          description: Unique id relative to the cloud-region.
+          required: true
+          type: string
+          example: __TENANT-ID__
+        - name: vserver-id
+          in: path
+          description: Unique identifier for this vserver relative to its tenant
+          required: true
+          type: string
+          example: __VSERVER-ID__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
+          type: string
+          example: __VLAN-INTERFACE__
+        - name: body
+          in: body
+          description: vlan object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/vlan"
     delete:
       tags:
         - CloudInfrastructure
@@ -2080,31 +2696,37 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: tenant-id
           in: path
           description: Unique id relative to the cloud-region.
           required: true
           type: string
+          example: __TENANT-ID__
         - name: vserver-id
           in: path
           description: Unique identifier for this vserver relative to its tenant
           required: true
           type: string
+          example: __VSERVER-ID__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vlan-interface
           in: path
           description: String that identifies the interface
           required: true
           type: string
+          example: __VLAN-INTERFACE__
         - name: resource-version
           in: query
           description: resource-version for concurrency
@@ -2124,7 +2746,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/vlans"
+              $ref: "#/getDefinitions/vlans"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -2133,26 +2755,31 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: tenant-id
           in: path
           description: Unique id relative to the cloud-region.
           required: true
           type: string
+          example: __TENANT-ID__
         - name: vserver-id
           in: path
           description: Unique identifier for this vserver relative to its tenant
           required: true
           type: string
+          example: __VSERVER-ID__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: cloud-type
           in: query
           description: Type of the cloud (e.g., openstack)
@@ -2232,34 +2859,40 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: tenant-id
           in: path
           description: Unique id relative to the cloud-region.
           required: true
           type: string
+          example: __TENANT-ID__
         - name: vserver-id
           in: path
           description: Unique identifier for this vserver relative to its tenant
           required: true
           type: string
+          example: __VSERVER-ID__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: pci-id
           in: path
           description: PCI ID used to identify the sriov-vf
           required: true
           type: string
+          example: __PCI-ID__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterfaceSriovVfsSriovVf.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -2284,31 +2917,37 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: tenant-id
           in: path
           description: Unique id relative to the cloud-region.
           required: true
           type: string
+          example: __TENANT-ID__
         - name: vserver-id
           in: path
           description: Unique identifier for this vserver relative to its tenant
           required: true
           type: string
+          example: __VSERVER-ID__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: pci-id
           in: path
           description: PCI ID used to identify the sriov-vf
           required: true
           type: string
+          example: __PCI-ID__
   /cloud-infrastructure/cloud-regions/cloud-region/{cloud-owner}/{cloud-region-id}/tenants/tenant/{tenant-id}/vservers/vserver/{vserver-id}/l-interfaces/l-interface/{interface-name}/sriov-vfs/sriov-vf/{pci-id}:
     get:
       tags:
@@ -2323,7 +2962,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/sriov-vf"
+              $ref: "#/getDefinitions/sriov-vf"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -2332,31 +2971,37 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: tenant-id
           in: path
           description: Unique id relative to the cloud-region.
           required: true
           type: string
+          example: __TENANT-ID__
         - name: vserver-id
           in: path
           description: Unique identifier for this vserver relative to its tenant
           required: true
           type: string
+          example: __VSERVER-ID__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: pci-id
           in: path
           description: PCI ID used to identify the sriov-vf
           required: true
           type: string
+          example: __PCI-ID__
         - name: cloud-type
           in: query
           description: Type of the cloud (e.g., openstack)
@@ -2439,7 +3084,10 @@ paths:
       tags:
         - CloudInfrastructure
       summary: create or update an existing sriov-vf
-      description: create or update an existing sriov-vf
+      description: |
+        Create or update an existing sriov-vf.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
       operationId: createOrUpdateCloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterfaceSriovVfsSriovVf
       consumes:
         - application/json
@@ -2456,37 +3104,112 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: tenant-id
           in: path
           description: Unique id relative to the cloud-region.
           required: true
           type: string
+          example: __TENANT-ID__
         - name: vserver-id
           in: path
           description: Unique identifier for this vserver relative to its tenant
           required: true
           type: string
+          example: __VSERVER-ID__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: pci-id
           in: path
           description: PCI ID used to identify the sriov-vf
           required: true
           type: string
+          example: __PCI-ID__
         - name: body
           in: body
-          description: sriov-vf object that needs to be created or updated
+          description: sriov-vf object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterfaceSriovVfsSriovVf.json)
           required: true
           schema:
             $ref: "#/definitions/sriov-vf"
+    patch:
+      tags:
+        - CloudInfrastructure
+      summary: update an existing sriov-vf
+      description: |
+        Update an existing sriov-vf
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateCloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterfaceSriovVfsSriovVf
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: cloud-owner
+          in: path
+          description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
+          required: true
+          type: string
+          example: __CLOUD-OWNER__
+        - name: cloud-region-id
+          in: path
+          description: Identifier used by the vendor for the region. Second part of composite key
+          required: true
+          type: string
+          example: __CLOUD-REGION-ID__
+        - name: tenant-id
+          in: path
+          description: Unique id relative to the cloud-region.
+          required: true
+          type: string
+          example: __TENANT-ID__
+        - name: vserver-id
+          in: path
+          description: Unique identifier for this vserver relative to its tenant
+          required: true
+          type: string
+          example: __VSERVER-ID__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: pci-id
+          in: path
+          description: PCI ID used to identify the sriov-vf
+          required: true
+          type: string
+          example: __PCI-ID__
+        - name: body
+          in: body
+          description: sriov-vf object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/sriov-vf"
     delete:
       tags:
         - CloudInfrastructure
@@ -2508,31 +3231,37 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: tenant-id
           in: path
           description: Unique id relative to the cloud-region.
           required: true
           type: string
+          example: __TENANT-ID__
         - name: vserver-id
           in: path
           description: Unique identifier for this vserver relative to its tenant
           required: true
           type: string
+          example: __VSERVER-ID__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: pci-id
           in: path
           description: PCI ID used to identify the sriov-vf
           required: true
           type: string
+          example: __PCI-ID__
         - name: resource-version
           in: query
           description: resource-version for concurrency
@@ -2552,7 +3281,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/sriov-vfs"
+              $ref: "#/getDefinitions/sriov-vfs"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -2561,26 +3290,31 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: tenant-id
           in: path
           description: Unique id relative to the cloud-region.
           required: true
           type: string
+          example: __TENANT-ID__
         - name: vserver-id
           in: path
           description: Unique identifier for this vserver relative to its tenant
           required: true
           type: string
+          example: __VSERVER-ID__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: cloud-type
           in: query
           description: Type of the cloud (e.g., openstack)
@@ -2660,29 +3394,34 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: tenant-id
           in: path
           description: Unique id relative to the cloud-region.
           required: true
           type: string
+          example: __TENANT-ID__
         - name: vserver-id
           in: path
           description: Unique identifier for this vserver relative to its tenant
           required: true
           type: string
+          example: __VSERVER-ID__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterface.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -2707,26 +3446,31 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: tenant-id
           in: path
           description: Unique id relative to the cloud-region.
           required: true
           type: string
+          example: __TENANT-ID__
         - name: vserver-id
           in: path
           description: Unique identifier for this vserver relative to its tenant
           required: true
           type: string
+          example: __VSERVER-ID__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
   /cloud-infrastructure/cloud-regions/cloud-region/{cloud-owner}/{cloud-region-id}/tenants/tenant/{tenant-id}/vservers/vserver/{vserver-id}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}/relationship-list/relationship:
     put:
       tags:
@@ -2748,34 +3492,40 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: tenant-id
           in: path
           description: Unique id relative to the cloud-region.
           required: true
           type: string
+          example: __TENANT-ID__
         - name: vserver-id
           in: path
           description: Unique identifier for this vserver relative to its tenant
           required: true
           type: string
+          example: __VSERVER-ID__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: l3-interface-ipv4-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterfaceL3InterfaceIpv4AddressList.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -2800,31 +3550,37 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: tenant-id
           in: path
           description: Unique id relative to the cloud-region.
           required: true
           type: string
+          example: __TENANT-ID__
         - name: vserver-id
           in: path
           description: Unique identifier for this vserver relative to its tenant
           required: true
           type: string
+          example: __VSERVER-ID__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: l3-interface-ipv4-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
   /cloud-infrastructure/cloud-regions/cloud-region/{cloud-owner}/{cloud-region-id}/tenants/tenant/{tenant-id}/vservers/vserver/{vserver-id}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}:
     get:
       tags:
@@ -2839,7 +3595,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/l3-interface-ipv4-address-list"
+              $ref: "#/getDefinitions/l3-interface-ipv4-address-list"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -2848,31 +3604,37 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: tenant-id
           in: path
           description: Unique id relative to the cloud-region.
           required: true
           type: string
+          example: __TENANT-ID__
         - name: vserver-id
           in: path
           description: Unique identifier for this vserver relative to its tenant
           required: true
           type: string
+          example: __VSERVER-ID__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: l3-interface-ipv4-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
         - name: cloud-type
           in: query
           description: Type of the cloud (e.g., openstack)
@@ -2951,7 +3713,10 @@ paths:
       tags:
         - CloudInfrastructure
       summary: create or update an existing l3-interface-ipv4-address-list
-      description: create or update an existing l3-interface-ipv4-address-list
+      description: |
+        Create or update an existing l3-interface-ipv4-address-list.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
       operationId: createOrUpdateCloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterfaceL3InterfaceIpv4AddressList
       consumes:
         - application/json
@@ -2968,43 +3733,60 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: tenant-id
           in: path
           description: Unique id relative to the cloud-region.
           required: true
           type: string
+          example: __TENANT-ID__
         - name: vserver-id
           in: path
           description: Unique identifier for this vserver relative to its tenant
           required: true
           type: string
+          example: __VSERVER-ID__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: l3-interface-ipv4-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
         - name: body
           in: body
-          description: l3-interface-ipv4-address-list object that needs to be created or updated
+          description: l3-interface-ipv4-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterfaceL3InterfaceIpv4AddressList.json)
           required: true
           schema:
             $ref: "#/definitions/l3-interface-ipv4-address-list"
-    delete:
+    patch:
       tags:
         - CloudInfrastructure
-      summary: delete an existing l3-interface-ipv4-address-list
-      description: delete an existing l3-interface-ipv4-address-list
-      operationId: deleteCloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterfaceL3InterfaceIpv4AddressList
+      summary: update an existing l3-interface-ipv4-address-list
+      description: |
+        Update an existing l3-interface-ipv4-address-list
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateCloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterfaceL3InterfaceIpv4AddressList
       consumes:
         - application/json
         - application/xml
@@ -3020,94 +3802,49 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: tenant-id
           in: path
           description: Unique id relative to the cloud-region.
           required: true
           type: string
+          example: __TENANT-ID__
         - name: vserver-id
           in: path
           description: Unique identifier for this vserver relative to its tenant
           required: true
           type: string
+          example: __VSERVER-ID__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: l3-interface-ipv4-address
           in: path
           description: IP address
           required: true
           type: string
-        - name: resource-version
-          in: query
-          description: resource-version for concurrency
-          required: true
-          type: string
-  /cloud-infrastructure/cloud-regions/cloud-region/{cloud-owner}/{cloud-region-id}/tenants/tenant/{tenant-id}/vservers/vserver/{vserver-id}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}/relationship-list/relationship:
-    put:
-      tags:
-        - CloudInfrastructure
-      summary: see node definition for valid relationships
-      operationId: createOrUpdateCloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterfaceL3InterfaceIpv6AddressListRelationshipListRelationship
-      consumes:
-        - application/json
-        - application/xml
-      produces:
-        - application/json
-        - application/xml
-      responses:
-        "default":
-          description: Response codes found in [response codes](https://wiki.onap.org/).
-      parameters:
-        - name: cloud-owner
-          in: path
-          description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
-          required: true
-          type: string
-        - name: cloud-region-id
-          in: path
-          description: Identifier used by the vendor for the region. Second part of composite key
-          required: true
-          type: string
-        - name: tenant-id
-          in: path
-          description: Unique id relative to the cloud-region.
-          required: true
-          type: string
-        - name: vserver-id
-          in: path
-          description: Unique identifier for this vserver relative to its tenant
-          required: true
-          type: string
-        - name: interface-name
-          in: path
-          description: Name given to the interface
-          required: true
-          type: string
-        - name: l3-interface-ipv6-address
-          in: path
-          description: IP address
-          required: true
-          type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: l3-interface-ipv4-address-list object that needs to be created or updated. 
           required: true
           schema:
-            $ref: "#/definitions/relationship"
+            $ref: "#/patchDefinitions/l3-interface-ipv4-address-list"
     delete:
       tags:
         - CloudInfrastructure
-      summary: delete an existing relationship
-      description: delete an existing relationship
-      operationId: deleteCloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterfaceL3InterfaceIpv6AddressListRelationshipListRelationship
+      summary: delete an existing l3-interface-ipv4-address-list
+      description: delete an existing l3-interface-ipv4-address-list
+      operationId: deleteCloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterfaceL3InterfaceIpv4AddressList
       consumes:
         - application/json
         - application/xml
@@ -3123,159 +3860,48 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: tenant-id
           in: path
           description: Unique id relative to the cloud-region.
           required: true
           type: string
+          example: __TENANT-ID__
         - name: vserver-id
           in: path
           description: Unique identifier for this vserver relative to its tenant
           required: true
           type: string
+          example: __VSERVER-ID__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
-        - name: l3-interface-ipv6-address
-          in: path
-          description: IP address
-          required: true
-          type: string
-  /cloud-infrastructure/cloud-regions/cloud-region/{cloud-owner}/{cloud-region-id}/tenants/tenant/{tenant-id}/vservers/vserver/{vserver-id}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}:
-    get:
-      tags:
-        - CloudInfrastructure
-      summary: returns l3-interface-ipv6-address-list
-      description: returns l3-interface-ipv6-address-list
-      operationId: getCloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterfaceL3InterfaceIpv6AddressList
-      produces:
-        - application/json
-        - application/xml
-      responses:
-        "200":
-          description: successful operation
-          schema:
-              $ref: "#/definitions/l3-interface-ipv6-address-list"
-        "default":
-          description: Response codes found in [response codes](https://wiki.onap.org/).
-      parameters:
-        - name: cloud-owner
-          in: path
-          description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
-          required: true
-          type: string
-        - name: cloud-region-id
-          in: path
-          description: Identifier used by the vendor for the region. Second part of composite key
-          required: true
-          type: string
-        - name: tenant-id
-          in: path
-          description: Unique id relative to the cloud-region.
-          required: true
-          type: string
-        - name: vserver-id
-          in: path
-          description: Unique identifier for this vserver relative to its tenant
-          required: true
-          type: string
-        - name: interface-name
-          in: path
-          description: Name given to the interface
-          required: true
-          type: string
-        - name: l3-interface-ipv6-address
+          example: __INTERFACE-NAME__
+        - name: l3-interface-ipv4-address
           in: path
           description: IP address
           required: true
           type: string
-        - name: cloud-type
-          in: query
-          description: Type of the cloud (e.g., openstack)
-          required: false
-          type: string
-        - name: owner-defined-type
-          in: query
-          description: Cloud-owner defined type indicator (e.g., dcp, lcp)
-          required: false
-          type: string
-        - name: tenant-name
-          in: query
-          description: Readable name of tenant
-          required: false
-          type: string
-        - name: tenant-context
-          in: query
-          description: This field will store the tenant context.
-          required: false
-          type: string
-        - name: vserver-name
-          in: query
-          description: Name of vserver
-          required: false
-          type: string
-        - name: vserver-name2
-          in: query
-          description: Alternative name of vserver
-          required: false
-          type: string
-        - name: prov-status
-          in: query
-          description: Trigger for operational monitoring of this resource by Service Assurance systems.
-          required: false
-          type: string
-        - name: in-maint
-          in: query
-          required: false
-          type: boolean
-        - name: is-closed-loop-disabled
-          in: query
-          required: false
-          type: boolean
-        - name: interface-id
-          in: query
-          description: ID of interface
-          required: false
-          type: string
-        - name: macaddr
-          in: query
-          description: MAC address for the interface
-          required: false
-          type: string
-        - name: network-name
-          in: query
-          description: Name of the network
-          required: false
-          type: string
-        - name: vlan-id-inner
-          in: query
-          description: Inner VLAN tag
-          required: false
-          type: integer
-          format: int64
-        - name: neutron-network-id
-          in: query
-          description: Neutron network id of the interface that address belongs to
-          required: false
-          type: string
-        - name: neutron-subnet-id
+          example: __L3-INTERFACE-IPV4-ADDRESS__
+        - name: resource-version
           in: query
-          description: Neutron id of subnet that address belongs to
-          required: false
+          description: resource-version for concurrency
+          required: true
           type: string
+  /cloud-infrastructure/cloud-regions/cloud-region/{cloud-owner}/{cloud-region-id}/tenants/tenant/{tenant-id}/vservers/vserver/{vserver-id}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}/relationship-list/relationship:
     put:
       tags:
         - CloudInfrastructure
-      summary: create or update an existing l3-interface-ipv6-address-list
-      description: create or update an existing l3-interface-ipv6-address-list
-      operationId: createOrUpdateCloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterfaceL3InterfaceIpv6AddressList
+      summary: see node definition for valid relationships
+      operationId: createOrUpdateCloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterfaceL3InterfaceIpv6AddressListRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -3291,43 +3917,49 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: tenant-id
           in: path
           description: Unique id relative to the cloud-region.
           required: true
           type: string
+          example: __TENANT-ID__
         - name: vserver-id
           in: path
           description: Unique identifier for this vserver relative to its tenant
           required: true
           type: string
+          example: __VSERVER-ID__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: l3-interface-ipv6-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
         - name: body
           in: body
-          description: l3-interface-ipv6-address-list object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterfaceL3InterfaceIpv6AddressList.json)
           required: true
           schema:
-            $ref: "#/definitions/l3-interface-ipv6-address-list"
+            $ref: "#/definitions/relationship"
     delete:
       tags:
         - CloudInfrastructure
-      summary: delete an existing l3-interface-ipv6-address-list
-      description: delete an existing l3-interface-ipv6-address-list
-      operationId: deleteCloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterfaceL3InterfaceIpv6AddressList
+      summary: delete an existing relationship
+      description: delete an existing relationship
+      operationId: deleteCloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterfaceL3InterfaceIpv6AddressListRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -3343,43 +3975,44 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: tenant-id
           in: path
           description: Unique id relative to the cloud-region.
           required: true
           type: string
+          example: __TENANT-ID__
         - name: vserver-id
           in: path
           description: Unique identifier for this vserver relative to its tenant
           required: true
           type: string
+          example: __VSERVER-ID__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: l3-interface-ipv6-address
           in: path
           description: IP address
           required: true
           type: string
-        - name: resource-version
-          in: query
-          description: resource-version for concurrency
-          required: true
-          type: string
-  /cloud-infrastructure/cloud-regions/cloud-region/{cloud-owner}/{cloud-region-id}/tenants/tenant/{tenant-id}/vservers/vserver/{vserver-id}/l-interfaces/l-interface/{interface-name}:
+          example: __L3-INTERFACE-IPV6-ADDRESS__
+  /cloud-infrastructure/cloud-regions/cloud-region/{cloud-owner}/{cloud-region-id}/tenants/tenant/{tenant-id}/vservers/vserver/{vserver-id}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}:
     get:
       tags:
         - CloudInfrastructure
-      summary: returns l-interface
-      description: returns l-interface
-      operationId: getCloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterface
+      summary: returns l3-interface-ipv6-address-list
+      description: returns l3-interface-ipv6-address-list
+      operationId: getCloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterfaceL3InterfaceIpv6AddressList
       produces:
         - application/json
         - application/xml
@@ -3387,7 +4020,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/l-interface"
+              $ref: "#/getDefinitions/l3-interface-ipv6-address-list"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -3396,26 +4029,346 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: tenant-id
           in: path
           description: Unique id relative to the cloud-region.
           required: true
           type: string
+          example: __TENANT-ID__
         - name: vserver-id
           in: path
           description: Unique identifier for this vserver relative to its tenant
           required: true
           type: string
+          example: __VSERVER-ID__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
+        - name: l3-interface-ipv6-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
+        - name: cloud-type
+          in: query
+          description: Type of the cloud (e.g., openstack)
+          required: false
+          type: string
+        - name: owner-defined-type
+          in: query
+          description: Cloud-owner defined type indicator (e.g., dcp, lcp)
+          required: false
+          type: string
+        - name: tenant-name
+          in: query
+          description: Readable name of tenant
+          required: false
+          type: string
+        - name: tenant-context
+          in: query
+          description: This field will store the tenant context.
+          required: false
+          type: string
+        - name: vserver-name
+          in: query
+          description: Name of vserver
+          required: false
+          type: string
+        - name: vserver-name2
+          in: query
+          description: Alternative name of vserver
+          required: false
+          type: string
+        - name: prov-status
+          in: query
+          description: Trigger for operational monitoring of this resource by Service Assurance systems.
+          required: false
+          type: string
+        - name: in-maint
+          in: query
+          required: false
+          type: boolean
+        - name: is-closed-loop-disabled
+          in: query
+          required: false
+          type: boolean
+        - name: interface-id
+          in: query
+          description: ID of interface
+          required: false
+          type: string
+        - name: macaddr
+          in: query
+          description: MAC address for the interface
+          required: false
+          type: string
+        - name: network-name
+          in: query
+          description: Name of the network
+          required: false
+          type: string
+        - name: vlan-id-inner
+          in: query
+          description: Inner VLAN tag
+          required: false
+          type: integer
+          format: int64
+        - name: neutron-network-id
+          in: query
+          description: Neutron network id of the interface that address belongs to
+          required: false
+          type: string
+        - name: neutron-subnet-id
+          in: query
+          description: Neutron id of subnet that address belongs to
+          required: false
+          type: string
+    put:
+      tags:
+        - CloudInfrastructure
+      summary: create or update an existing l3-interface-ipv6-address-list
+      description: |
+        Create or update an existing l3-interface-ipv6-address-list.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateCloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterfaceL3InterfaceIpv6AddressList
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: cloud-owner
+          in: path
+          description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
+          required: true
+          type: string
+          example: __CLOUD-OWNER__
+        - name: cloud-region-id
+          in: path
+          description: Identifier used by the vendor for the region. Second part of composite key
+          required: true
+          type: string
+          example: __CLOUD-REGION-ID__
+        - name: tenant-id
+          in: path
+          description: Unique id relative to the cloud-region.
+          required: true
+          type: string
+          example: __TENANT-ID__
+        - name: vserver-id
+          in: path
+          description: Unique identifier for this vserver relative to its tenant
+          required: true
+          type: string
+          example: __VSERVER-ID__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: l3-interface-ipv6-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
+        - name: body
+          in: body
+          description: l3-interface-ipv6-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterfaceL3InterfaceIpv6AddressList.json)
+          required: true
+          schema:
+            $ref: "#/definitions/l3-interface-ipv6-address-list"
+    patch:
+      tags:
+        - CloudInfrastructure
+      summary: update an existing l3-interface-ipv6-address-list
+      description: |
+        Update an existing l3-interface-ipv6-address-list
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateCloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterfaceL3InterfaceIpv6AddressList
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: cloud-owner
+          in: path
+          description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
+          required: true
+          type: string
+          example: __CLOUD-OWNER__
+        - name: cloud-region-id
+          in: path
+          description: Identifier used by the vendor for the region. Second part of composite key
+          required: true
+          type: string
+          example: __CLOUD-REGION-ID__
+        - name: tenant-id
+          in: path
+          description: Unique id relative to the cloud-region.
+          required: true
+          type: string
+          example: __TENANT-ID__
+        - name: vserver-id
+          in: path
+          description: Unique identifier for this vserver relative to its tenant
+          required: true
+          type: string
+          example: __VSERVER-ID__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: l3-interface-ipv6-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
+        - name: body
+          in: body
+          description: l3-interface-ipv6-address-list object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/l3-interface-ipv6-address-list"
+    delete:
+      tags:
+        - CloudInfrastructure
+      summary: delete an existing l3-interface-ipv6-address-list
+      description: delete an existing l3-interface-ipv6-address-list
+      operationId: deleteCloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterfaceL3InterfaceIpv6AddressList
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: cloud-owner
+          in: path
+          description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
+          required: true
+          type: string
+          example: __CLOUD-OWNER__
+        - name: cloud-region-id
+          in: path
+          description: Identifier used by the vendor for the region. Second part of composite key
+          required: true
+          type: string
+          example: __CLOUD-REGION-ID__
+        - name: tenant-id
+          in: path
+          description: Unique id relative to the cloud-region.
+          required: true
+          type: string
+          example: __TENANT-ID__
+        - name: vserver-id
+          in: path
+          description: Unique identifier for this vserver relative to its tenant
+          required: true
+          type: string
+          example: __VSERVER-ID__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: l3-interface-ipv6-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
+        - name: resource-version
+          in: query
+          description: resource-version for concurrency
+          required: true
+          type: string
+  /cloud-infrastructure/cloud-regions/cloud-region/{cloud-owner}/{cloud-region-id}/tenants/tenant/{tenant-id}/vservers/vserver/{vserver-id}/l-interfaces/l-interface/{interface-name}:
+    get:
+      tags:
+        - CloudInfrastructure
+      summary: returns l-interface
+      description: returns l-interface
+      operationId: getCloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterface
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "200":
+          description: successful operation
+          schema:
+              $ref: "#/getDefinitions/l-interface"
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: cloud-owner
+          in: path
+          description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
+          required: true
+          type: string
+          example: __CLOUD-OWNER__
+        - name: cloud-region-id
+          in: path
+          description: Identifier used by the vendor for the region. Second part of composite key
+          required: true
+          type: string
+          example: __CLOUD-REGION-ID__
+        - name: tenant-id
+          in: path
+          description: Unique id relative to the cloud-region.
+          required: true
+          type: string
+          example: __TENANT-ID__
+        - name: vserver-id
+          in: path
+          description: Unique identifier for this vserver relative to its tenant
+          required: true
+          type: string
+          example: __VSERVER-ID__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
         - name: cloud-type
           in: query
           description: Type of the cloud (e.g., openstack)
@@ -3478,7 +4431,10 @@ paths:
       tags:
         - CloudInfrastructure
       summary: create or update an existing l-interface
-      description: create or update an existing l-interface
+      description: |
+        Create or update an existing l-interface.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
       operationId: createOrUpdateCloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterface
       consumes:
         - application/json
@@ -3495,32 +4451,100 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: tenant-id
           in: path
           description: Unique id relative to the cloud-region.
           required: true
           type: string
+          example: __TENANT-ID__
         - name: vserver-id
           in: path
           description: Unique identifier for this vserver relative to its tenant
           required: true
           type: string
+          example: __VSERVER-ID__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: body
           in: body
-          description: l-interface object that needs to be created or updated
+          description: l-interface object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterface.json)
           required: true
           schema:
             $ref: "#/definitions/l-interface"
+    patch:
+      tags:
+        - CloudInfrastructure
+      summary: update an existing l-interface
+      description: |
+        Update an existing l-interface
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateCloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterface
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: cloud-owner
+          in: path
+          description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
+          required: true
+          type: string
+          example: __CLOUD-OWNER__
+        - name: cloud-region-id
+          in: path
+          description: Identifier used by the vendor for the region. Second part of composite key
+          required: true
+          type: string
+          example: __CLOUD-REGION-ID__
+        - name: tenant-id
+          in: path
+          description: Unique id relative to the cloud-region.
+          required: true
+          type: string
+          example: __TENANT-ID__
+        - name: vserver-id
+          in: path
+          description: Unique identifier for this vserver relative to its tenant
+          required: true
+          type: string
+          example: __VSERVER-ID__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: body
+          in: body
+          description: l-interface object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/l-interface"
     delete:
       tags:
         - CloudInfrastructure
@@ -3542,26 +4566,31 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: tenant-id
           in: path
           description: Unique id relative to the cloud-region.
           required: true
           type: string
+          example: __TENANT-ID__
         - name: vserver-id
           in: path
           description: Unique identifier for this vserver relative to its tenant
           required: true
           type: string
+          example: __VSERVER-ID__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: resource-version
           in: query
           description: resource-version for concurrency
@@ -3581,7 +4610,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/l-interfaces"
+              $ref: "#/getDefinitions/l-interfaces"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -3590,21 +4619,25 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: tenant-id
           in: path
           description: Unique id relative to the cloud-region.
           required: true
           type: string
+          example: __TENANT-ID__
         - name: vserver-id
           in: path
           description: Unique identifier for this vserver relative to its tenant
           required: true
           type: string
+          example: __VSERVER-ID__
         - name: cloud-type
           in: query
           description: Type of the cloud (e.g., openstack)
@@ -3662,7 +4695,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/vserver"
+              $ref: "#/getDefinitions/vserver"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -3671,21 +4704,25 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: tenant-id
           in: path
           description: Unique id relative to the cloud-region.
           required: true
           type: string
+          example: __TENANT-ID__
         - name: vserver-id
           in: path
           description: Unique identifier for this vserver relative to its tenant
           required: true
           type: string
+          example: __VSERVER-ID__
         - name: cloud-type
           in: query
           description: Type of the cloud (e.g., openstack)
@@ -3733,7 +4770,10 @@ paths:
       tags:
         - CloudInfrastructure
       summary: create or update an existing vserver
-      description: create or update an existing vserver
+      description: |
+        Create or update an existing vserver.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
       operationId: createOrUpdateCloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserver
       consumes:
         - application/json
@@ -3750,27 +4790,88 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: tenant-id
           in: path
           description: Unique id relative to the cloud-region.
           required: true
           type: string
+          example: __TENANT-ID__
         - name: vserver-id
           in: path
           description: Unique identifier for this vserver relative to its tenant
           required: true
           type: string
+          example: __VSERVER-ID__
         - name: body
           in: body
-          description: vserver object that needs to be created or updated
+          description: vserver object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserver.json)
           required: true
           schema:
             $ref: "#/definitions/vserver"
+    patch:
+      tags:
+        - CloudInfrastructure
+      summary: update an existing vserver
+      description: |
+        Update an existing vserver
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateCloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserver
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: cloud-owner
+          in: path
+          description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
+          required: true
+          type: string
+          example: __CLOUD-OWNER__
+        - name: cloud-region-id
+          in: path
+          description: Identifier used by the vendor for the region. Second part of composite key
+          required: true
+          type: string
+          example: __CLOUD-REGION-ID__
+        - name: tenant-id
+          in: path
+          description: Unique id relative to the cloud-region.
+          required: true
+          type: string
+          example: __TENANT-ID__
+        - name: vserver-id
+          in: path
+          description: Unique identifier for this vserver relative to its tenant
+          required: true
+          type: string
+          example: __VSERVER-ID__
+        - name: body
+          in: body
+          description: vserver object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/vserver"
     delete:
       tags:
         - CloudInfrastructure
@@ -3792,21 +4893,25 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: tenant-id
           in: path
           description: Unique id relative to the cloud-region.
           required: true
           type: string
+          example: __TENANT-ID__
         - name: vserver-id
           in: path
           description: Unique identifier for this vserver relative to its tenant
           required: true
           type: string
+          example: __VSERVER-ID__
         - name: resource-version
           in: query
           description: resource-version for concurrency
@@ -3826,7 +4931,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/vservers"
+              $ref: "#/getDefinitions/vservers"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -3835,16 +4940,19 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: tenant-id
           in: path
           description: Unique id relative to the cloud-region.
           required: true
           type: string
+          example: __TENANT-ID__
         - name: cloud-type
           in: query
           description: Type of the cloud (e.g., openstack)
@@ -3886,19 +4994,22 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: tenant-id
           in: path
           description: Unique id relative to the cloud-region.
           required: true
           type: string
+          example: __TENANT-ID__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionTenantsTenant.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -3923,16 +5034,19 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: tenant-id
           in: path
           description: Unique id relative to the cloud-region.
           required: true
           type: string
+          example: __TENANT-ID__
   /cloud-infrastructure/cloud-regions/cloud-region/{cloud-owner}/{cloud-region-id}/tenants/tenant/{tenant-id}:
     get:
       tags:
@@ -3947,7 +5061,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/tenant"
+              $ref: "#/getDefinitions/tenant"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -3956,16 +5070,19 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: tenant-id
           in: path
           description: Unique id relative to the cloud-region.
           required: true
           type: string
+          example: __TENANT-ID__
         - name: cloud-type
           in: query
           description: Type of the cloud (e.g., openstack)
@@ -3990,7 +5107,10 @@ paths:
       tags:
         - CloudInfrastructure
       summary: create or update an existing tenant
-      description: create or update an existing tenant
+      description: |
+        Create or update an existing tenant.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
       operationId: createOrUpdateCloudInfrastructureCloudRegionsCloudRegionTenantsTenant
       consumes:
         - application/json
@@ -4007,22 +5127,76 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: tenant-id
           in: path
           description: Unique id relative to the cloud-region.
           required: true
           type: string
+          example: __TENANT-ID__
         - name: body
           in: body
-          description: tenant object that needs to be created or updated
+          description: tenant object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionTenantsTenant.json)
           required: true
           schema:
             $ref: "#/definitions/tenant"
+    patch:
+      tags:
+        - CloudInfrastructure
+      summary: update an existing tenant
+      description: |
+        Update an existing tenant
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateCloudInfrastructureCloudRegionsCloudRegionTenantsTenant
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: cloud-owner
+          in: path
+          description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
+          required: true
+          type: string
+          example: __CLOUD-OWNER__
+        - name: cloud-region-id
+          in: path
+          description: Identifier used by the vendor for the region. Second part of composite key
+          required: true
+          type: string
+          example: __CLOUD-REGION-ID__
+        - name: tenant-id
+          in: path
+          description: Unique id relative to the cloud-region.
+          required: true
+          type: string
+          example: __TENANT-ID__
+        - name: body
+          in: body
+          description: tenant object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/tenant"
     delete:
       tags:
         - CloudInfrastructure
@@ -4044,16 +5218,19 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: tenant-id
           in: path
           description: Unique id relative to the cloud-region.
           required: true
           type: string
+          example: __TENANT-ID__
         - name: resource-version
           in: query
           description: resource-version for concurrency
@@ -4073,7 +5250,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/tenants"
+              $ref: "#/getDefinitions/tenants"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -4082,11 +5259,13 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: cloud-type
           in: query
           description: Type of the cloud (e.g., openstack)
@@ -4118,19 +5297,22 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: flavor-id
           in: path
           description: Flavor id, expected to be unique across cloud-region.
           required: true
           type: string
+          example: __FLAVOR-ID__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionFlavorsFlavor.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -4155,16 +5337,19 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: flavor-id
           in: path
           description: Flavor id, expected to be unique across cloud-region.
           required: true
           type: string
+          example: __FLAVOR-ID__
   /cloud-infrastructure/cloud-regions/cloud-region/{cloud-owner}/{cloud-region-id}/flavors/flavor/{flavor-id}:
     get:
       tags:
@@ -4179,7 +5364,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/flavor"
+              $ref: "#/getDefinitions/flavor"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -4188,16 +5373,19 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: flavor-id
           in: path
           description: Flavor id, expected to be unique across cloud-region.
           required: true
           type: string
+          example: __FLAVOR-ID__
         - name: cloud-type
           in: query
           description: Type of the cloud (e.g., openstack)
@@ -4217,7 +5405,10 @@ paths:
       tags:
         - CloudInfrastructure
       summary: create or update an existing flavor
-      description: create or update an existing flavor
+      description: |
+        Create or update an existing flavor.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
       operationId: createOrUpdateCloudInfrastructureCloudRegionsCloudRegionFlavorsFlavor
       consumes:
         - application/json
@@ -4234,22 +5425,76 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: flavor-id
           in: path
           description: Flavor id, expected to be unique across cloud-region.
           required: true
           type: string
+          example: __FLAVOR-ID__
         - name: body
           in: body
-          description: flavor object that needs to be created or updated
+          description: flavor object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionFlavorsFlavor.json)
           required: true
           schema:
             $ref: "#/definitions/flavor"
+    patch:
+      tags:
+        - CloudInfrastructure
+      summary: update an existing flavor
+      description: |
+        Update an existing flavor
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateCloudInfrastructureCloudRegionsCloudRegionFlavorsFlavor
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: cloud-owner
+          in: path
+          description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
+          required: true
+          type: string
+          example: __CLOUD-OWNER__
+        - name: cloud-region-id
+          in: path
+          description: Identifier used by the vendor for the region. Second part of composite key
+          required: true
+          type: string
+          example: __CLOUD-REGION-ID__
+        - name: flavor-id
+          in: path
+          description: Flavor id, expected to be unique across cloud-region.
+          required: true
+          type: string
+          example: __FLAVOR-ID__
+        - name: body
+          in: body
+          description: flavor object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/flavor"
     delete:
       tags:
         - CloudInfrastructure
@@ -4271,16 +5516,19 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: flavor-id
           in: path
           description: Flavor id, expected to be unique across cloud-region.
           required: true
           type: string
+          example: __FLAVOR-ID__
         - name: resource-version
           in: query
           description: resource-version for concurrency
@@ -4300,7 +5548,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/flavors"
+              $ref: "#/getDefinitions/flavors"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -4309,11 +5557,13 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: cloud-type
           in: query
           description: Type of the cloud (e.g., openstack)
@@ -4345,19 +5595,22 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: group-id
           in: path
           description: Group id, expected to be unique across cloud-region.
           required: true
           type: string
+          example: __GROUP-ID__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionGroupAssignmentsGroupAssignment.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -4382,16 +5635,19 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: group-id
           in: path
           description: Group id, expected to be unique across cloud-region.
           required: true
           type: string
+          example: __GROUP-ID__
   /cloud-infrastructure/cloud-regions/cloud-region/{cloud-owner}/{cloud-region-id}/group-assignments/group-assignment/{group-id}:
     get:
       tags:
@@ -4406,7 +5662,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/group-assignment"
+              $ref: "#/getDefinitions/group-assignment"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -4415,16 +5671,19 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: group-id
           in: path
           description: Group id, expected to be unique across cloud-region.
           required: true
           type: string
+          example: __GROUP-ID__
         - name: cloud-type
           in: query
           description: Type of the cloud (e.g., openstack)
@@ -4449,7 +5708,10 @@ paths:
       tags:
         - CloudInfrastructure
       summary: create or update an existing group-assignment
-      description: create or update an existing group-assignment
+      description: |
+        Create or update an existing group-assignment.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
       operationId: createOrUpdateCloudInfrastructureCloudRegionsCloudRegionGroupAssignmentsGroupAssignment
       consumes:
         - application/json
@@ -4466,22 +5728,76 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: group-id
           in: path
           description: Group id, expected to be unique across cloud-region.
           required: true
           type: string
+          example: __GROUP-ID__
         - name: body
           in: body
-          description: group-assignment object that needs to be created or updated
+          description: group-assignment object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionGroupAssignmentsGroupAssignment.json)
           required: true
           schema:
             $ref: "#/definitions/group-assignment"
+    patch:
+      tags:
+        - CloudInfrastructure
+      summary: update an existing group-assignment
+      description: |
+        Update an existing group-assignment
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateCloudInfrastructureCloudRegionsCloudRegionGroupAssignmentsGroupAssignment
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: cloud-owner
+          in: path
+          description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
+          required: true
+          type: string
+          example: __CLOUD-OWNER__
+        - name: cloud-region-id
+          in: path
+          description: Identifier used by the vendor for the region. Second part of composite key
+          required: true
+          type: string
+          example: __CLOUD-REGION-ID__
+        - name: group-id
+          in: path
+          description: Group id, expected to be unique across cloud-region.
+          required: true
+          type: string
+          example: __GROUP-ID__
+        - name: body
+          in: body
+          description: group-assignment object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/group-assignment"
     delete:
       tags:
         - CloudInfrastructure
@@ -4503,16 +5819,19 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: group-id
           in: path
           description: Group id, expected to be unique across cloud-region.
           required: true
           type: string
+          example: __GROUP-ID__
         - name: resource-version
           in: query
           description: resource-version for concurrency
@@ -4532,7 +5851,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/group-assignments"
+              $ref: "#/getDefinitions/group-assignments"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -4541,11 +5860,13 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: cloud-type
           in: query
           description: Type of the cloud (e.g., openstack)
@@ -4577,19 +5898,22 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: snapshot-id
           in: path
           description: Snapshot id, this is the key UUID assoc associated in glance with the snapshots.
           required: true
           type: string
+          example: __SNAPSHOT-ID__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionSnapshotsSnapshot.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -4614,16 +5938,19 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: snapshot-id
           in: path
           description: Snapshot id, this is the key UUID assoc associated in glance with the snapshots.
           required: true
           type: string
+          example: __SNAPSHOT-ID__
   /cloud-infrastructure/cloud-regions/cloud-region/{cloud-owner}/{cloud-region-id}/snapshots/snapshot/{snapshot-id}:
     get:
       tags:
@@ -4638,7 +5965,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/snapshot"
+              $ref: "#/getDefinitions/snapshot"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -4647,16 +5974,19 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: snapshot-id
           in: path
           description: Snapshot id, this is the key UUID assoc associated in glance with the snapshots.
           required: true
           type: string
+          example: __SNAPSHOT-ID__
         - name: cloud-type
           in: query
           description: Type of the cloud (e.g., openstack)
@@ -4696,7 +6026,10 @@ paths:
       tags:
         - CloudInfrastructure
       summary: create or update an existing snapshot
-      description: create or update an existing snapshot
+      description: |
+        Create or update an existing snapshot.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
       operationId: createOrUpdateCloudInfrastructureCloudRegionsCloudRegionSnapshotsSnapshot
       consumes:
         - application/json
@@ -4713,22 +6046,76 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: snapshot-id
           in: path
           description: Snapshot id, this is the key UUID assoc associated in glance with the snapshots.
           required: true
           type: string
+          example: __SNAPSHOT-ID__
         - name: body
           in: body
-          description: snapshot object that needs to be created or updated
+          description: snapshot object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionSnapshotsSnapshot.json)
           required: true
           schema:
             $ref: "#/definitions/snapshot"
+    patch:
+      tags:
+        - CloudInfrastructure
+      summary: update an existing snapshot
+      description: |
+        Update an existing snapshot
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateCloudInfrastructureCloudRegionsCloudRegionSnapshotsSnapshot
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: cloud-owner
+          in: path
+          description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
+          required: true
+          type: string
+          example: __CLOUD-OWNER__
+        - name: cloud-region-id
+          in: path
+          description: Identifier used by the vendor for the region. Second part of composite key
+          required: true
+          type: string
+          example: __CLOUD-REGION-ID__
+        - name: snapshot-id
+          in: path
+          description: Snapshot id, this is the key UUID assoc associated in glance with the snapshots.
+          required: true
+          type: string
+          example: __SNAPSHOT-ID__
+        - name: body
+          in: body
+          description: snapshot object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/snapshot"
     delete:
       tags:
         - CloudInfrastructure
@@ -4750,16 +6137,19 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: snapshot-id
           in: path
           description: Snapshot id, this is the key UUID assoc associated in glance with the snapshots.
           required: true
           type: string
+          example: __SNAPSHOT-ID__
         - name: resource-version
           in: query
           description: resource-version for concurrency
@@ -4779,7 +6169,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/snapshots"
+              $ref: "#/getDefinitions/snapshots"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -4788,11 +6178,13 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: cloud-type
           in: query
           description: Type of the cloud (e.g., openstack)
@@ -4824,19 +6216,22 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: image-id
           in: path
           description: Image id, expected to be unique across cloud region
           required: true
           type: string
+          example: __IMAGE-ID__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionImagesImage.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -4861,16 +6256,19 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: image-id
           in: path
           description: Image id, expected to be unique across cloud region
           required: true
           type: string
+          example: __IMAGE-ID__
   /cloud-infrastructure/cloud-regions/cloud-region/{cloud-owner}/{cloud-region-id}/images/image/{image-id}/metadata/metadatum/{metaname}:
     get:
       tags:
@@ -4885,7 +6283,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/metadatum"
+              $ref: "#/getDefinitions/metadatum"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -4894,20 +6292,24 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: image-id
           in: path
           description: Image id, expected to be unique across cloud region
           required: true
           type: string
+          example: __IMAGE-ID__
         - name: metaname
           in: path
           required: true
           type: string
+          example: __METANAME__
         - name: cloud-type
           in: query
           description: Type of the cloud (e.g., openstack)
@@ -4942,7 +6344,10 @@ paths:
       tags:
         - CloudInfrastructure
       summary: create or update an existing metadatum
-      description: create or update an existing metadatum
+      description: |
+        Create or update an existing metadatum.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
       operationId: createOrUpdateCloudInfrastructureCloudRegionsCloudRegionImagesImageMetadataMetadatum
       consumes:
         - application/json
@@ -4959,26 +6364,86 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: image-id
           in: path
           description: Image id, expected to be unique across cloud region
           required: true
           type: string
+          example: __IMAGE-ID__
         - name: metaname
           in: path
           required: true
           type: string
+          example: __METANAME__
         - name: body
           in: body
-          description: metadatum object that needs to be created or updated
+          description: metadatum object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionImagesImageMetadataMetadatum.json)
           required: true
           schema:
             $ref: "#/definitions/metadatum"
+    patch:
+      tags:
+        - CloudInfrastructure
+      summary: update an existing metadatum
+      description: |
+        Update an existing metadatum
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateCloudInfrastructureCloudRegionsCloudRegionImagesImageMetadataMetadatum
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: cloud-owner
+          in: path
+          description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
+          required: true
+          type: string
+          example: __CLOUD-OWNER__
+        - name: cloud-region-id
+          in: path
+          description: Identifier used by the vendor for the region. Second part of composite key
+          required: true
+          type: string
+          example: __CLOUD-REGION-ID__
+        - name: image-id
+          in: path
+          description: Image id, expected to be unique across cloud region
+          required: true
+          type: string
+          example: __IMAGE-ID__
+        - name: metaname
+          in: path
+          required: true
+          type: string
+          example: __METANAME__
+        - name: body
+          in: body
+          description: metadatum object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/metadatum"
     delete:
       tags:
         - CloudInfrastructure
@@ -5000,20 +6465,24 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: image-id
           in: path
           description: Image id, expected to be unique across cloud region
           required: true
           type: string
+          example: __IMAGE-ID__
         - name: metaname
           in: path
           required: true
           type: string
+          example: __METANAME__
         - name: resource-version
           in: query
           description: resource-version for concurrency
@@ -5033,7 +6502,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/metadata"
+              $ref: "#/getDefinitions/metadata"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -5042,16 +6511,19 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: image-id
           in: path
           description: Image id, expected to be unique across cloud region
           required: true
           type: string
+          example: __IMAGE-ID__
         - name: cloud-type
           in: query
           description: Type of the cloud (e.g., openstack)
@@ -5096,7 +6568,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/image"
+              $ref: "#/getDefinitions/image"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -5105,16 +6577,19 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: image-id
           in: path
           description: Image id, expected to be unique across cloud region
           required: true
           type: string
+          example: __IMAGE-ID__
         - name: cloud-type
           in: query
           description: Type of the cloud (e.g., openstack)
@@ -5149,7 +6624,10 @@ paths:
       tags:
         - CloudInfrastructure
       summary: create or update an existing image
-      description: create or update an existing image
+      description: |
+        Create or update an existing image.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
       operationId: createOrUpdateCloudInfrastructureCloudRegionsCloudRegionImagesImage
       consumes:
         - application/json
@@ -5166,22 +6644,76 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: image-id
           in: path
           description: Image id, expected to be unique across cloud region
           required: true
           type: string
+          example: __IMAGE-ID__
         - name: body
           in: body
-          description: image object that needs to be created or updated
+          description: image object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionImagesImage.json)
           required: true
           schema:
             $ref: "#/definitions/image"
+    patch:
+      tags:
+        - CloudInfrastructure
+      summary: update an existing image
+      description: |
+        Update an existing image
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateCloudInfrastructureCloudRegionsCloudRegionImagesImage
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: cloud-owner
+          in: path
+          description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
+          required: true
+          type: string
+          example: __CLOUD-OWNER__
+        - name: cloud-region-id
+          in: path
+          description: Identifier used by the vendor for the region. Second part of composite key
+          required: true
+          type: string
+          example: __CLOUD-REGION-ID__
+        - name: image-id
+          in: path
+          description: Image id, expected to be unique across cloud region
+          required: true
+          type: string
+          example: __IMAGE-ID__
+        - name: body
+          in: body
+          description: image object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/image"
     delete:
       tags:
         - CloudInfrastructure
@@ -5203,16 +6735,19 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: image-id
           in: path
           description: Image id, expected to be unique across cloud region
           required: true
           type: string
+          example: __IMAGE-ID__
         - name: resource-version
           in: query
           description: resource-version for concurrency
@@ -5232,7 +6767,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/images"
+              $ref: "#/getDefinitions/images"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -5241,11 +6776,13 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: cloud-type
           in: query
           description: Type of the cloud (e.g., openstack)
@@ -5277,19 +6814,22 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: switch-name
           in: path
           description: DVS switch name
           required: true
           type: string
+          example: __SWITCH-NAME__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionDvsSwitchesDvsSwitch.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -5314,16 +6854,19 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: switch-name
           in: path
           description: DVS switch name
           required: true
           type: string
+          example: __SWITCH-NAME__
   /cloud-infrastructure/cloud-regions/cloud-region/{cloud-owner}/{cloud-region-id}/dvs-switches/dvs-switch/{switch-name}:
     get:
       tags:
@@ -5338,7 +6881,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/dvs-switch"
+              $ref: "#/getDefinitions/dvs-switch"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -5347,16 +6890,19 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: switch-name
           in: path
           description: DVS switch name
           required: true
           type: string
+          example: __SWITCH-NAME__
         - name: cloud-type
           in: query
           description: Type of the cloud (e.g., openstack)
@@ -5376,7 +6922,10 @@ paths:
       tags:
         - CloudInfrastructure
       summary: create or update an existing dvs-switch
-      description: create or update an existing dvs-switch
+      description: |
+        Create or update an existing dvs-switch.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
       operationId: createOrUpdateCloudInfrastructureCloudRegionsCloudRegionDvsSwitchesDvsSwitch
       consumes:
         - application/json
@@ -5393,28 +6942,42 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: switch-name
           in: path
           description: DVS switch name
           required: true
           type: string
+          example: __SWITCH-NAME__
         - name: body
           in: body
-          description: dvs-switch object that needs to be created or updated
+          description: dvs-switch object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionDvsSwitchesDvsSwitch.json)
           required: true
           schema:
             $ref: "#/definitions/dvs-switch"
-    delete:
+    patch:
       tags:
         - CloudInfrastructure
-      summary: delete an existing dvs-switch
-      description: delete an existing dvs-switch
-      operationId: deleteCloudInfrastructureCloudRegionsCloudRegionDvsSwitchesDvsSwitch
+      summary: update an existing dvs-switch
+      description: |
+        Update an existing dvs-switch
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateCloudInfrastructureCloudRegionsCloudRegionDvsSwitchesDvsSwitch
       consumes:
         - application/json
         - application/xml
@@ -5430,102 +6993,31 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: switch-name
           in: path
           description: DVS switch name
           required: true
           type: string
-        - name: resource-version
-          in: query
-          description: resource-version for concurrency
-          required: true
-          type: string
-  /cloud-infrastructure/cloud-regions/cloud-region/{cloud-owner}/{cloud-region-id}/dvs-switches:
-    get:
-      tags:
-        - CloudInfrastructure
-      summary: returns dvs-switches
-      description: returns dvs-switches
-      operationId: getCloudInfrastructureCloudRegionsCloudRegionDvsSwitches
-      produces:
-        - application/json
-        - application/xml
-      responses:
-        "200":
-          description: successful operation
-          schema:
-              $ref: "#/definitions/dvs-switches"
-        "default":
-          description: Response codes found in [response codes](https://wiki.onap.org/).
-      parameters:
-        - name: cloud-owner
-          in: path
-          description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
-          required: true
-          type: string
-        - name: cloud-region-id
-          in: path
-          description: Identifier used by the vendor for the region. Second part of composite key
-          required: true
-          type: string
-        - name: cloud-type
-          in: query
-          description: Type of the cloud (e.g., openstack)
-          required: false
-          type: string
-        - name: owner-defined-type
-          in: query
-          description: Cloud-owner defined type indicator (e.g., dcp, lcp)
-          required: false
-          type: string
-  /cloud-infrastructure/cloud-regions/cloud-region/{cloud-owner}/{cloud-region-id}/oam-networks/oam-network/{network-uuid}/relationship-list/relationship:
-    put:
-      tags:
-        - CloudInfrastructure
-      summary: see node definition for valid relationships
-      operationId: createOrUpdateCloudInfrastructureCloudRegionsCloudRegionOamNetworksOamNetworkRelationshipListRelationship
-      consumes:
-        - application/json
-        - application/xml
-      produces:
-        - application/json
-        - application/xml
-      responses:
-        "default":
-          description: Response codes found in [response codes](https://wiki.onap.org/).
-      parameters:
-        - name: cloud-owner
-          in: path
-          description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
-          required: true
-          type: string
-        - name: cloud-region-id
-          in: path
-          description: Identifier used by the vendor for the region. Second part of composite key
-          required: true
-          type: string
-        - name: network-uuid
-          in: path
-          description: UUID of the network. Unique across a cloud-region
-          required: true
-          type: string
+          example: __SWITCH-NAME__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: dvs-switch object that needs to be created or updated. 
           required: true
           schema:
-            $ref: "#/definitions/relationship"
+            $ref: "#/patchDefinitions/dvs-switch"
     delete:
       tags:
         - CloudInfrastructure
-      summary: delete an existing relationship
-      description: delete an existing relationship
-      operationId: deleteCloudInfrastructureCloudRegionsCloudRegionOamNetworksOamNetworkRelationshipListRelationship
+      summary: delete an existing dvs-switch
+      description: delete an existing dvs-switch
+      operationId: deleteCloudInfrastructureCloudRegionsCloudRegionDvsSwitchesDvsSwitch
       consumes:
         - application/json
         - application/xml
@@ -5541,23 +7033,31 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
-        - name: network-uuid
+          example: __CLOUD-REGION-ID__
+        - name: switch-name
           in: path
-          description: UUID of the network. Unique across a cloud-region
+          description: DVS switch name
           required: true
           type: string
-  /cloud-infrastructure/cloud-regions/cloud-region/{cloud-owner}/{cloud-region-id}/oam-networks/oam-network/{network-uuid}:
+          example: __SWITCH-NAME__
+        - name: resource-version
+          in: query
+          description: resource-version for concurrency
+          required: true
+          type: string
+  /cloud-infrastructure/cloud-regions/cloud-region/{cloud-owner}/{cloud-region-id}/dvs-switches:
     get:
       tags:
         - CloudInfrastructure
-      summary: returns oam-network
-      description: returns oam-network
-      operationId: getCloudInfrastructureCloudRegionsCloudRegionOamNetworksOamNetwork
+      summary: returns dvs-switches
+      description: returns dvs-switches
+      operationId: getCloudInfrastructureCloudRegionsCloudRegionDvsSwitches
       produces:
         - application/json
         - application/xml
@@ -5565,7 +7065,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/oam-network"
+              $ref: "#/getDefinitions/dvs-switches"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -5574,16 +7074,133 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
+        - name: cloud-type
+          in: query
+          description: Type of the cloud (e.g., openstack)
+          required: false
+          type: string
+        - name: owner-defined-type
+          in: query
+          description: Cloud-owner defined type indicator (e.g., dcp, lcp)
+          required: false
+          type: string
+  /cloud-infrastructure/cloud-regions/cloud-region/{cloud-owner}/{cloud-region-id}/oam-networks/oam-network/{network-uuid}/relationship-list/relationship:
+    put:
+      tags:
+        - CloudInfrastructure
+      summary: see node definition for valid relationships
+      operationId: createOrUpdateCloudInfrastructureCloudRegionsCloudRegionOamNetworksOamNetworkRelationshipListRelationship
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: cloud-owner
+          in: path
+          description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
+          required: true
+          type: string
+          example: __CLOUD-OWNER__
+        - name: cloud-region-id
+          in: path
+          description: Identifier used by the vendor for the region. Second part of composite key
+          required: true
+          type: string
+          example: __CLOUD-REGION-ID__
+        - name: network-uuid
+          in: path
+          description: UUID of the network. Unique across a cloud-region
+          required: true
+          type: string
+          example: __NETWORK-UUID__
+        - name: body
+          in: body
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionOamNetworksOamNetwork.json)
+          required: true
+          schema:
+            $ref: "#/definitions/relationship"
+    delete:
+      tags:
+        - CloudInfrastructure
+      summary: delete an existing relationship
+      description: delete an existing relationship
+      operationId: deleteCloudInfrastructureCloudRegionsCloudRegionOamNetworksOamNetworkRelationshipListRelationship
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: cloud-owner
+          in: path
+          description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
+          required: true
+          type: string
+          example: __CLOUD-OWNER__
+        - name: cloud-region-id
+          in: path
+          description: Identifier used by the vendor for the region. Second part of composite key
+          required: true
+          type: string
+          example: __CLOUD-REGION-ID__
+        - name: network-uuid
+          in: path
+          description: UUID of the network. Unique across a cloud-region
+          required: true
+          type: string
+          example: __NETWORK-UUID__
+  /cloud-infrastructure/cloud-regions/cloud-region/{cloud-owner}/{cloud-region-id}/oam-networks/oam-network/{network-uuid}:
+    get:
+      tags:
+        - CloudInfrastructure
+      summary: returns oam-network
+      description: returns oam-network
+      operationId: getCloudInfrastructureCloudRegionsCloudRegionOamNetworksOamNetwork
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "200":
+          description: successful operation
+          schema:
+              $ref: "#/getDefinitions/oam-network"
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: cloud-owner
+          in: path
+          description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
+          required: true
+          type: string
+          example: __CLOUD-OWNER__
+        - name: cloud-region-id
+          in: path
+          description: Identifier used by the vendor for the region. Second part of composite key
+          required: true
+          type: string
+          example: __CLOUD-REGION-ID__
         - name: network-uuid
           in: path
           description: UUID of the network. Unique across a cloud-region
           required: true
           type: string
+          example: __NETWORK-UUID__
         - name: cloud-type
           in: query
           description: Type of the cloud (e.g., openstack)
@@ -5609,7 +7226,10 @@ paths:
       tags:
         - CloudInfrastructure
       summary: create or update an existing oam-network
-      description: create or update an existing oam-network
+      description: |
+        Create or update an existing oam-network.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
       operationId: createOrUpdateCloudInfrastructureCloudRegionsCloudRegionOamNetworksOamNetwork
       consumes:
         - application/json
@@ -5626,22 +7246,76 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: network-uuid
           in: path
           description: UUID of the network. Unique across a cloud-region
           required: true
           type: string
+          example: __NETWORK-UUID__
         - name: body
           in: body
-          description: oam-network object that needs to be created or updated
+          description: oam-network object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionOamNetworksOamNetwork.json)
           required: true
           schema:
             $ref: "#/definitions/oam-network"
+    patch:
+      tags:
+        - CloudInfrastructure
+      summary: update an existing oam-network
+      description: |
+        Update an existing oam-network
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateCloudInfrastructureCloudRegionsCloudRegionOamNetworksOamNetwork
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: cloud-owner
+          in: path
+          description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
+          required: true
+          type: string
+          example: __CLOUD-OWNER__
+        - name: cloud-region-id
+          in: path
+          description: Identifier used by the vendor for the region. Second part of composite key
+          required: true
+          type: string
+          example: __CLOUD-REGION-ID__
+        - name: network-uuid
+          in: path
+          description: UUID of the network. Unique across a cloud-region
+          required: true
+          type: string
+          example: __NETWORK-UUID__
+        - name: body
+          in: body
+          description: oam-network object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/oam-network"
     delete:
       tags:
         - CloudInfrastructure
@@ -5663,16 +7337,19 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: network-uuid
           in: path
           description: UUID of the network. Unique across a cloud-region
           required: true
           type: string
+          example: __NETWORK-UUID__
         - name: resource-version
           in: query
           description: resource-version for concurrency
@@ -5692,7 +7369,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/oam-networks"
+              $ref: "#/getDefinitions/oam-networks"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -5701,11 +7378,13 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: cloud-type
           in: query
           description: Type of the cloud (e.g., openstack)
@@ -5737,19 +7416,22 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: availability-zone-name
           in: path
           description: Name of the availability zone.  Unique across a cloud region
           required: true
           type: string
+          example: __AVAILABILITY-ZONE-NAME__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionAvailabilityZonesAvailabilityZone.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -5774,16 +7456,19 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: availability-zone-name
           in: path
           description: Name of the availability zone.  Unique across a cloud region
           required: true
           type: string
+          example: __AVAILABILITY-ZONE-NAME__
   /cloud-infrastructure/cloud-regions/cloud-region/{cloud-owner}/{cloud-region-id}/availability-zones/availability-zone/{availability-zone-name}:
     get:
       tags:
@@ -5798,7 +7483,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/availability-zone"
+              $ref: "#/getDefinitions/availability-zone"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -5807,16 +7492,19 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: availability-zone-name
           in: path
           description: Name of the availability zone.  Unique across a cloud region
           required: true
           type: string
+          example: __AVAILABILITY-ZONE-NAME__
         - name: cloud-type
           in: query
           description: Type of the cloud (e.g., openstack)
@@ -5831,7 +7519,10 @@ paths:
       tags:
         - CloudInfrastructure
       summary: create or update an existing availability-zone
-      description: create or update an existing availability-zone
+      description: |
+        Create or update an existing availability-zone.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
       operationId: createOrUpdateCloudInfrastructureCloudRegionsCloudRegionAvailabilityZonesAvailabilityZone
       consumes:
         - application/json
@@ -5848,22 +7539,76 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: availability-zone-name
           in: path
           description: Name of the availability zone.  Unique across a cloud region
           required: true
           type: string
+          example: __AVAILABILITY-ZONE-NAME__
         - name: body
           in: body
-          description: availability-zone object that needs to be created or updated
+          description: availability-zone object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionAvailabilityZonesAvailabilityZone.json)
           required: true
           schema:
             $ref: "#/definitions/availability-zone"
+    patch:
+      tags:
+        - CloudInfrastructure
+      summary: update an existing availability-zone
+      description: |
+        Update an existing availability-zone
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateCloudInfrastructureCloudRegionsCloudRegionAvailabilityZonesAvailabilityZone
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: cloud-owner
+          in: path
+          description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
+          required: true
+          type: string
+          example: __CLOUD-OWNER__
+        - name: cloud-region-id
+          in: path
+          description: Identifier used by the vendor for the region. Second part of composite key
+          required: true
+          type: string
+          example: __CLOUD-REGION-ID__
+        - name: availability-zone-name
+          in: path
+          description: Name of the availability zone.  Unique across a cloud region
+          required: true
+          type: string
+          example: __AVAILABILITY-ZONE-NAME__
+        - name: body
+          in: body
+          description: availability-zone object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/availability-zone"
     delete:
       tags:
         - CloudInfrastructure
@@ -5885,16 +7630,19 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: availability-zone-name
           in: path
           description: Name of the availability zone.  Unique across a cloud region
           required: true
           type: string
+          example: __AVAILABILITY-ZONE-NAME__
         - name: resource-version
           in: query
           description: resource-version for concurrency
@@ -5914,7 +7662,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/availability-zones"
+              $ref: "#/getDefinitions/availability-zones"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -5923,11 +7671,13 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: cloud-type
           in: query
           description: Type of the cloud (e.g., openstack)
@@ -5959,14 +7709,16 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegion.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -5991,17 +7743,19 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
-  /cloud-infrastructure/cloud-regions/cloud-region/{cloud-owner}/{cloud-region-id}/auth-info-items/auth-info-item/{auth-info-item-id}/relationship-list/relationship:
+          example: __CLOUD-REGION-ID__
+  /cloud-infrastructure/cloud-regions/cloud-region/{cloud-owner}/{cloud-region-id}/esr-system-info-list/esr-system-info/{esr-system-info-id}/relationship-list/relationship:
     put:
       tags:
         - CloudInfrastructure
       summary: see node definition for valid relationships
-      operationId: createOrUpdateCloudInfrastructureCloudRegionsCloudRegionAuthInfoItemsAuthInfoItemRelationshipListRelationship
+      operationId: createOrUpdateCloudInfrastructureCloudRegionsCloudRegionEsrSystemInfoListEsrSystemInfoRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -6017,19 +7771,22 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
-        - name: auth-info-item-id
+          example: __CLOUD-REGION-ID__
+        - name: esr-system-info-id
           in: path
-          description: Unique ID of auth-info-item.
+          description: Unique ID of esr system info.
           required: true
           type: string
+          example: __ESR-SYSTEM-INFO-ID__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionEsrSystemInfoListEsrSystemInfo.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -6038,7 +7795,7 @@ paths:
         - CloudInfrastructure
       summary: delete an existing relationship
       description: delete an existing relationship
-      operationId: deleteCloudInfrastructureCloudRegionsCloudRegionAuthInfoItemsAuthInfoItemRelationshipListRelationship
+      operationId: deleteCloudInfrastructureCloudRegionsCloudRegionEsrSystemInfoListEsrSystemInfoRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -6054,23 +7811,26 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
-        - name: auth-info-item-id
+          example: __CLOUD-REGION-ID__
+        - name: esr-system-info-id
           in: path
-          description: Unique ID of auth-info-item.
+          description: Unique ID of esr system info.
           required: true
           type: string
-  /cloud-infrastructure/cloud-regions/cloud-region/{cloud-owner}/{cloud-region-id}/auth-info-items/auth-info-item/{auth-info-item-id}:
+          example: __ESR-SYSTEM-INFO-ID__
+  /cloud-infrastructure/cloud-regions/cloud-region/{cloud-owner}/{cloud-region-id}/esr-system-info-list/esr-system-info/{esr-system-info-id}:
     get:
       tags:
         - CloudInfrastructure
-      summary: returns auth-info-item
-      description: returns auth-info-item
-      operationId: getCloudInfrastructureCloudRegionsCloudRegionAuthInfoItemsAuthInfoItem
+      summary: returns esr-system-info
+      description: returns esr-system-info
+      operationId: getCloudInfrastructureCloudRegionsCloudRegionEsrSystemInfoListEsrSystemInfo
       produces:
         - application/json
         - application/xml
@@ -6078,7 +7838,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/auth-info-item"
+              $ref: "#/getDefinitions/esr-system-info"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -6087,16 +7847,19 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
-        - name: auth-info-item-id
+          example: __CLOUD-REGION-ID__
+        - name: esr-system-info-id
           in: path
-          description: Unique ID of auth-info-item.
+          description: Unique ID of esr system info.
           required: true
           type: string
+          example: __ESR-SYSTEM-INFO-ID__
         - name: cloud-type
           in: query
           description: Type of the cloud (e.g., openstack)
@@ -6107,22 +7870,25 @@ paths:
           description: Cloud-owner defined type indicator (e.g., dcp, lcp)
           required: false
           type: string
-        - name: username
+        - name: system-name
           in: query
-          description: user name of auth infomation to access VIM.
+          description: name of external system.
           required: false
           type: string
-        - name: auth-url
+        - name: system-type
           in: query
-          description: authentication url of the cloud.
+          description: it could be vim/vnfm/thirdparty-sdnc/ems-resource/ems-performance/ems-alarm.
           required: false
           type: string
     put:
       tags:
         - CloudInfrastructure
-      summary: create or update an existing auth-info-item
-      description: create or update an existing auth-info-item
-      operationId: createOrUpdateCloudInfrastructureCloudRegionsCloudRegionAuthInfoItemsAuthInfoItem
+      summary: create or update an existing esr-system-info
+      description: |
+        Create or update an existing esr-system-info.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateCloudInfrastructureCloudRegionsCloudRegionEsrSystemInfoListEsrSystemInfo
       consumes:
         - application/json
         - application/xml
@@ -6138,28 +7904,42 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
-        - name: auth-info-item-id
+          example: __CLOUD-REGION-ID__
+        - name: esr-system-info-id
           in: path
-          description: Unique ID of auth-info-item.
+          description: Unique ID of esr system info.
           required: true
           type: string
+          example: __ESR-SYSTEM-INFO-ID__
         - name: body
           in: body
-          description: auth-info-item object that needs to be created or updated
+          description: esr-system-info object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionEsrSystemInfoListEsrSystemInfo.json)
           required: true
           schema:
-            $ref: "#/definitions/auth-info-item"
-    delete:
+            $ref: "#/definitions/esr-system-info"
+    patch:
       tags:
         - CloudInfrastructure
-      summary: delete an existing auth-info-item
-      description: delete an existing auth-info-item
-      operationId: deleteCloudInfrastructureCloudRegionsCloudRegionAuthInfoItemsAuthInfoItem
+      summary: update an existing esr-system-info
+      description: |
+        Update an existing esr-system-info
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateCloudInfrastructureCloudRegionsCloudRegionEsrSystemInfoListEsrSystemInfo
       consumes:
         - application/json
         - application/xml
@@ -6175,36 +7955,38 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
-        - name: auth-info-item-id
+          example: __CLOUD-REGION-ID__
+        - name: esr-system-info-id
           in: path
-          description: Unique ID of auth-info-item.
+          description: Unique ID of esr system info.
           required: true
           type: string
-        - name: resource-version
-          in: query
-          description: resource-version for concurrency
+          example: __ESR-SYSTEM-INFO-ID__
+        - name: body
+          in: body
+          description: esr-system-info object that needs to be created or updated. 
           required: true
-          type: string
-  /cloud-infrastructure/cloud-regions/cloud-region/{cloud-owner}/{cloud-region-id}/auth-info-items:
-    get:
+          schema:
+            $ref: "#/patchDefinitions/esr-system-info"
+    delete:
       tags:
         - CloudInfrastructure
-      summary: returns auth-info-items
-      description: returns auth-info-items
-      operationId: getCloudInfrastructureCloudRegionsCloudRegionAuthInfoItems
+      summary: delete an existing esr-system-info
+      description: delete an existing esr-system-info
+      operationId: deleteCloudInfrastructureCloudRegionsCloudRegionEsrSystemInfoListEsrSystemInfo
+      consumes:
+        - application/json
+        - application/xml
       produces:
         - application/json
         - application/xml
       responses:
-        "200":
-          description: successful operation
-          schema:
-              $ref: "#/definitions/auth-info-items"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -6213,28 +7995,31 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
-        - name: cloud-type
-          in: query
-          description: Type of the cloud (e.g., openstack)
-          required: false
+          example: __CLOUD-REGION-ID__
+        - name: esr-system-info-id
+          in: path
+          description: Unique ID of esr system info.
+          required: true
           type: string
-        - name: owner-defined-type
+          example: __ESR-SYSTEM-INFO-ID__
+        - name: resource-version
           in: query
-          description: Cloud-owner defined type indicator (e.g., dcp, lcp)
-          required: false
+          description: resource-version for concurrency
+          required: true
           type: string
-  /cloud-infrastructure/cloud-regions/cloud-region/{cloud-owner}/{cloud-region-id}:
+  /cloud-infrastructure/cloud-regions/cloud-region/{cloud-owner}/{cloud-region-id}/esr-system-info-list:
     get:
       tags:
         - CloudInfrastructure
-      summary: returns cloud-region
-      description: returns cloud-region
-      operationId: getCloudInfrastructureCloudRegionsCloudRegion
+      summary: returns esr-system-info-list
+      description: returns esr-system-info-list
+      operationId: getCloudInfrastructureCloudRegionsCloudRegionEsrSystemInfoList
       produces:
         - application/json
         - application/xml
@@ -6242,7 +8027,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/cloud-region"
+              $ref: "#/getDefinitions/esr-system-info-list"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -6251,11 +8036,13 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
         - name: cloud-type
           in: query
           description: Type of the cloud (e.g., openstack)
@@ -6266,12 +8053,12 @@ paths:
           description: Cloud-owner defined type indicator (e.g., dcp, lcp)
           required: false
           type: string
+  /cloud-infrastructure/cloud-regions/cloud-region/{cloud-owner}/{cloud-region-id}/vip-ipv4-address-list/{vip-ipv4-address}/relationship-list/relationship:
     put:
       tags:
         - CloudInfrastructure
-      summary: create or update an existing cloud-region
-      description: create or update an existing cloud-region
-      operationId: createOrUpdateCloudInfrastructureCloudRegionsCloudRegion
+      summary: see node definition for valid relationships
+      operationId: createOrUpdateCloudInfrastructureCloudRegionsCloudRegionVipIpv4AddressListRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -6287,23 +8074,130 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
+        - name: vip-ipv4-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __VIP-IPV4-ADDRESS__
         - name: body
           in: body
-          description: cloud-region object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionVipIpv4AddressList.json)
           required: true
           schema:
-            $ref: "#/definitions/cloud-region"
+            $ref: "#/definitions/relationship"
     delete:
       tags:
         - CloudInfrastructure
-      summary: delete an existing cloud-region
-      description: delete an existing cloud-region
-      operationId: deleteCloudInfrastructureCloudRegionsCloudRegion
+      summary: delete an existing relationship
+      description: delete an existing relationship
+      operationId: deleteCloudInfrastructureCloudRegionsCloudRegionVipIpv4AddressListRelationshipListRelationship
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: cloud-owner
+          in: path
+          description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
+          required: true
+          type: string
+          example: __CLOUD-OWNER__
+        - name: cloud-region-id
+          in: path
+          description: Identifier used by the vendor for the region. Second part of composite key
+          required: true
+          type: string
+          example: __CLOUD-REGION-ID__
+        - name: vip-ipv4-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __VIP-IPV4-ADDRESS__
+  /cloud-infrastructure/cloud-regions/cloud-region/{cloud-owner}/{cloud-region-id}/vip-ipv4-address-list/{vip-ipv4-address}:
+    get:
+      tags:
+        - CloudInfrastructure
+      summary: returns vip-ipv4-address-list
+      description: returns vip-ipv4-address-list
+      operationId: getCloudInfrastructureCloudRegionsCloudRegionVipIpv4AddressList
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "200":
+          description: successful operation
+          schema:
+              $ref: "#/getDefinitions/vip-ipv4-address-list"
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: cloud-owner
+          in: path
+          description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
+          required: true
+          type: string
+          example: __CLOUD-OWNER__
+        - name: cloud-region-id
+          in: path
+          description: Identifier used by the vendor for the region. Second part of composite key
+          required: true
+          type: string
+          example: __CLOUD-REGION-ID__
+        - name: vip-ipv4-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __VIP-IPV4-ADDRESS__
+        - name: cloud-type
+          in: query
+          description: Type of the cloud (e.g., openstack)
+          required: false
+          type: string
+        - name: owner-defined-type
+          in: query
+          description: Cloud-owner defined type indicator (e.g., dcp, lcp)
+          required: false
+          type: string
+        - name: vlan-id-inner
+          in: query
+          description: Inner VLAN tag
+          required: false
+          type: integer
+          format: int64
+        - name: neutron-network-id
+          in: query
+          description: Neutron network id of the interface that address belongs to
+          required: false
+          type: string
+        - name: neutron-subnet-id
+          in: query
+          description: Neutron id of subnet that address belongs to
+          required: false
+          type: string
+    put:
+      tags:
+        - CloudInfrastructure
+      summary: create or update an existing vip-ipv4-address-list
+      description: |
+        Create or update an existing vip-ipv4-address-list.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateCloudInfrastructureCloudRegionsCloudRegionVipIpv4AddressList
       consumes:
         - application/json
         - application/xml
@@ -6319,11 +8213,534 @@ paths:
           description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
+          example: __CLOUD-OWNER__
         - name: cloud-region-id
           in: path
           description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
+          example: __CLOUD-REGION-ID__
+        - name: vip-ipv4-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __VIP-IPV4-ADDRESS__
+        - name: body
+          in: body
+          description: vip-ipv4-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionVipIpv4AddressList.json)
+          required: true
+          schema:
+            $ref: "#/definitions/vip-ipv4-address-list"
+    patch:
+      tags:
+        - CloudInfrastructure
+      summary: update an existing vip-ipv4-address-list
+      description: |
+        Update an existing vip-ipv4-address-list
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateCloudInfrastructureCloudRegionsCloudRegionVipIpv4AddressList
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: cloud-owner
+          in: path
+          description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
+          required: true
+          type: string
+          example: __CLOUD-OWNER__
+        - name: cloud-region-id
+          in: path
+          description: Identifier used by the vendor for the region. Second part of composite key
+          required: true
+          type: string
+          example: __CLOUD-REGION-ID__
+        - name: vip-ipv4-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __VIP-IPV4-ADDRESS__
+        - name: body
+          in: body
+          description: vip-ipv4-address-list object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/vip-ipv4-address-list"
+    delete:
+      tags:
+        - CloudInfrastructure
+      summary: delete an existing vip-ipv4-address-list
+      description: delete an existing vip-ipv4-address-list
+      operationId: deleteCloudInfrastructureCloudRegionsCloudRegionVipIpv4AddressList
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: cloud-owner
+          in: path
+          description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
+          required: true
+          type: string
+          example: __CLOUD-OWNER__
+        - name: cloud-region-id
+          in: path
+          description: Identifier used by the vendor for the region. Second part of composite key
+          required: true
+          type: string
+          example: __CLOUD-REGION-ID__
+        - name: vip-ipv4-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __VIP-IPV4-ADDRESS__
+        - name: resource-version
+          in: query
+          description: resource-version for concurrency
+          required: true
+          type: string
+  /cloud-infrastructure/cloud-regions/cloud-region/{cloud-owner}/{cloud-region-id}/vip-ipv6-address-list/{vip-ipv6-address}/relationship-list/relationship:
+    put:
+      tags:
+        - CloudInfrastructure
+      summary: see node definition for valid relationships
+      operationId: createOrUpdateCloudInfrastructureCloudRegionsCloudRegionVipIpv6AddressListRelationshipListRelationship
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: cloud-owner
+          in: path
+          description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
+          required: true
+          type: string
+          example: __CLOUD-OWNER__
+        - name: cloud-region-id
+          in: path
+          description: Identifier used by the vendor for the region. Second part of composite key
+          required: true
+          type: string
+          example: __CLOUD-REGION-ID__
+        - name: vip-ipv6-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __VIP-IPV6-ADDRESS__
+        - name: body
+          in: body
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionVipIpv6AddressList.json)
+          required: true
+          schema:
+            $ref: "#/definitions/relationship"
+    delete:
+      tags:
+        - CloudInfrastructure
+      summary: delete an existing relationship
+      description: delete an existing relationship
+      operationId: deleteCloudInfrastructureCloudRegionsCloudRegionVipIpv6AddressListRelationshipListRelationship
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: cloud-owner
+          in: path
+          description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
+          required: true
+          type: string
+          example: __CLOUD-OWNER__
+        - name: cloud-region-id
+          in: path
+          description: Identifier used by the vendor for the region. Second part of composite key
+          required: true
+          type: string
+          example: __CLOUD-REGION-ID__
+        - name: vip-ipv6-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __VIP-IPV6-ADDRESS__
+  /cloud-infrastructure/cloud-regions/cloud-region/{cloud-owner}/{cloud-region-id}/vip-ipv6-address-list/{vip-ipv6-address}:
+    get:
+      tags:
+        - CloudInfrastructure
+      summary: returns vip-ipv6-address-list
+      description: returns vip-ipv6-address-list
+      operationId: getCloudInfrastructureCloudRegionsCloudRegionVipIpv6AddressList
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "200":
+          description: successful operation
+          schema:
+              $ref: "#/getDefinitions/vip-ipv6-address-list"
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: cloud-owner
+          in: path
+          description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
+          required: true
+          type: string
+          example: __CLOUD-OWNER__
+        - name: cloud-region-id
+          in: path
+          description: Identifier used by the vendor for the region. Second part of composite key
+          required: true
+          type: string
+          example: __CLOUD-REGION-ID__
+        - name: vip-ipv6-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __VIP-IPV6-ADDRESS__
+        - name: cloud-type
+          in: query
+          description: Type of the cloud (e.g., openstack)
+          required: false
+          type: string
+        - name: owner-defined-type
+          in: query
+          description: Cloud-owner defined type indicator (e.g., dcp, lcp)
+          required: false
+          type: string
+        - name: vlan-id-inner
+          in: query
+          description: Inner VLAN tag
+          required: false
+          type: integer
+          format: int64
+        - name: neutron-network-id
+          in: query
+          description: Neutron network id of the interface that address belongs to
+          required: false
+          type: string
+        - name: neutron-subnet-id
+          in: query
+          description: Neutron id of subnet that address belongs to
+          required: false
+          type: string
+    put:
+      tags:
+        - CloudInfrastructure
+      summary: create or update an existing vip-ipv6-address-list
+      description: |
+        Create or update an existing vip-ipv6-address-list.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateCloudInfrastructureCloudRegionsCloudRegionVipIpv6AddressList
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: cloud-owner
+          in: path
+          description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
+          required: true
+          type: string
+          example: __CLOUD-OWNER__
+        - name: cloud-region-id
+          in: path
+          description: Identifier used by the vendor for the region. Second part of composite key
+          required: true
+          type: string
+          example: __CLOUD-REGION-ID__
+        - name: vip-ipv6-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __VIP-IPV6-ADDRESS__
+        - name: body
+          in: body
+          description: vip-ipv6-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegionVipIpv6AddressList.json)
+          required: true
+          schema:
+            $ref: "#/definitions/vip-ipv6-address-list"
+    patch:
+      tags:
+        - CloudInfrastructure
+      summary: update an existing vip-ipv6-address-list
+      description: |
+        Update an existing vip-ipv6-address-list
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateCloudInfrastructureCloudRegionsCloudRegionVipIpv6AddressList
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: cloud-owner
+          in: path
+          description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
+          required: true
+          type: string
+          example: __CLOUD-OWNER__
+        - name: cloud-region-id
+          in: path
+          description: Identifier used by the vendor for the region. Second part of composite key
+          required: true
+          type: string
+          example: __CLOUD-REGION-ID__
+        - name: vip-ipv6-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __VIP-IPV6-ADDRESS__
+        - name: body
+          in: body
+          description: vip-ipv6-address-list object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/vip-ipv6-address-list"
+    delete:
+      tags:
+        - CloudInfrastructure
+      summary: delete an existing vip-ipv6-address-list
+      description: delete an existing vip-ipv6-address-list
+      operationId: deleteCloudInfrastructureCloudRegionsCloudRegionVipIpv6AddressList
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: cloud-owner
+          in: path
+          description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
+          required: true
+          type: string
+          example: __CLOUD-OWNER__
+        - name: cloud-region-id
+          in: path
+          description: Identifier used by the vendor for the region. Second part of composite key
+          required: true
+          type: string
+          example: __CLOUD-REGION-ID__
+        - name: vip-ipv6-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __VIP-IPV6-ADDRESS__
+        - name: resource-version
+          in: query
+          description: resource-version for concurrency
+          required: true
+          type: string
+  /cloud-infrastructure/cloud-regions/cloud-region/{cloud-owner}/{cloud-region-id}:
+    get:
+      tags:
+        - CloudInfrastructure
+      summary: returns cloud-region
+      description: returns cloud-region
+      operationId: getCloudInfrastructureCloudRegionsCloudRegion
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "200":
+          description: successful operation
+          schema:
+              $ref: "#/getDefinitions/cloud-region"
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: cloud-owner
+          in: path
+          description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
+          required: true
+          type: string
+          example: __CLOUD-OWNER__
+        - name: cloud-region-id
+          in: path
+          description: Identifier used by the vendor for the region. Second part of composite key
+          required: true
+          type: string
+          example: __CLOUD-REGION-ID__
+        - name: cloud-type
+          in: query
+          description: Type of the cloud (e.g., openstack)
+          required: false
+          type: string
+        - name: owner-defined-type
+          in: query
+          description: Cloud-owner defined type indicator (e.g., dcp, lcp)
+          required: false
+          type: string
+    put:
+      tags:
+        - CloudInfrastructure
+      summary: create or update an existing cloud-region
+      description: |
+        Create or update an existing cloud-region.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateCloudInfrastructureCloudRegionsCloudRegion
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: cloud-owner
+          in: path
+          description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
+          required: true
+          type: string
+          example: __CLOUD-OWNER__
+        - name: cloud-region-id
+          in: path
+          description: Identifier used by the vendor for the region. Second part of composite key
+          required: true
+          type: string
+          example: __CLOUD-REGION-ID__
+        - name: body
+          in: body
+          description: cloud-region object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureCloudRegionsCloudRegion.json)
+          required: true
+          schema:
+            $ref: "#/definitions/cloud-region"
+    patch:
+      tags:
+        - CloudInfrastructure
+      summary: update an existing cloud-region
+      description: |
+        Update an existing cloud-region
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateCloudInfrastructureCloudRegionsCloudRegion
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: cloud-owner
+          in: path
+          description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
+          required: true
+          type: string
+          example: __CLOUD-OWNER__
+        - name: cloud-region-id
+          in: path
+          description: Identifier used by the vendor for the region. Second part of composite key
+          required: true
+          type: string
+          example: __CLOUD-REGION-ID__
+        - name: body
+          in: body
+          description: cloud-region object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/cloud-region"
+    delete:
+      tags:
+        - CloudInfrastructure
+      summary: delete an existing cloud-region
+      description: delete an existing cloud-region
+      operationId: deleteCloudInfrastructureCloudRegionsCloudRegion
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: cloud-owner
+          in: path
+          description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
+          required: true
+          type: string
+          example: __CLOUD-OWNER__
+        - name: cloud-region-id
+          in: path
+          description: Identifier used by the vendor for the region. Second part of composite key
+          required: true
+          type: string
+          example: __CLOUD-REGION-ID__
         - name: resource-version
           in: query
           description: resource-version for concurrency
@@ -6343,7 +8760,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/cloud-regions"
+              $ref: "#/getDefinitions/cloud-regions"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
   /cloud-infrastructure/network-profiles/network-profile/{nm-profile-name}/relationship-list/relationship:
@@ -6367,9 +8784,10 @@ paths:
           description: Unique name of network profile.
           required: true
           type: string
+          example: __NM-PROFILE-NAME__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureNetworkProfilesNetworkProfile.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -6394,6 +8812,7 @@ paths:
           description: Unique name of network profile.
           required: true
           type: string
+          example: __NM-PROFILE-NAME__
   /cloud-infrastructure/network-profiles/network-profile/{nm-profile-name}:
     get:
       tags:
@@ -6408,7 +8827,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/network-profile"
+              $ref: "#/getDefinitions/network-profile"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -6417,11 +8836,15 @@ paths:
           description: Unique name of network profile.
           required: true
           type: string
+          example: __NM-PROFILE-NAME__
     put:
       tags:
         - CloudInfrastructure
       summary: create or update an existing network-profile
-      description: create or update an existing network-profile
+      description: |
+        Create or update an existing network-profile.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
       operationId: createOrUpdateCloudInfrastructureNetworkProfilesNetworkProfile
       consumes:
         - application/json
@@ -6438,12 +8861,52 @@ paths:
           description: Unique name of network profile.
           required: true
           type: string
+          example: __NM-PROFILE-NAME__
         - name: body
           in: body
-          description: network-profile object that needs to be created or updated
+          description: network-profile object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureNetworkProfilesNetworkProfile.json)
           required: true
           schema:
             $ref: "#/definitions/network-profile"
+    patch:
+      tags:
+        - CloudInfrastructure
+      summary: update an existing network-profile
+      description: |
+        Update an existing network-profile
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateCloudInfrastructureNetworkProfilesNetworkProfile
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: nm-profile-name
+          in: path
+          description: Unique name of network profile.
+          required: true
+          type: string
+          example: __NM-PROFILE-NAME__
+        - name: body
+          in: body
+          description: network-profile object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/network-profile"
     delete:
       tags:
         - CloudInfrastructure
@@ -6465,6 +8928,7 @@ paths:
           description: Unique name of network profile.
           required: true
           type: string
+          example: __NM-PROFILE-NAME__
         - name: resource-version
           in: query
           description: resource-version for concurrency
@@ -6484,7 +8948,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/network-profiles"
+              $ref: "#/getDefinitions/network-profiles"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
   /cloud-infrastructure/pservers/pserver/{hostname}/relationship-list/relationship:
@@ -6508,9 +8972,10 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructurePserversPserver.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -6535,6 +9000,7 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
   /cloud-infrastructure/pservers/pserver/{hostname}/p-interfaces/p-interface/{interface-name}/relationship-list/relationship:
     put:
       tags:
@@ -6556,14 +9022,16 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructurePserversPserverPInterfacesPInterface.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -6588,11 +9056,13 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
   /cloud-infrastructure/pservers/pserver/{hostname}/p-interfaces/p-interface/{interface-name}/sriov-pfs/sriov-pf/{pf-pci-id}/relationship-list/relationship:
     put:
       tags:
@@ -6614,19 +9084,22 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: pf-pci-id
           in: path
           description: Identifier for the sriov-pf
           required: true
           type: string
+          example: __PF-PCI-ID__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructurePserversPserverPInterfacesPInterfaceSriovPfsSriovPf.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -6651,16 +9124,19 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: pf-pci-id
           in: path
           description: Identifier for the sriov-pf
           required: true
           type: string
+          example: __PF-PCI-ID__
   /cloud-infrastructure/pservers/pserver/{hostname}/p-interfaces/p-interface/{interface-name}/sriov-pfs/sriov-pf/{pf-pci-id}:
     get:
       tags:
@@ -6675,7 +9151,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/sriov-pf"
+              $ref: "#/getDefinitions/sriov-pf"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -6684,16 +9160,19 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: pf-pci-id
           in: path
           description: Identifier for the sriov-pf
           required: true
           type: string
+          example: __PF-PCI-ID__
         - name: inv-status
           in: query
           description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
@@ -6722,7 +9201,10 @@ paths:
       tags:
         - CloudInfrastructure
       summary: create or update an existing sriov-pf
-      description: create or update an existing sriov-pf
+      description: |
+        Create or update an existing sriov-pf.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
       operationId: createOrUpdateCloudInfrastructurePserversPserverPInterfacesPInterfaceSriovPfsSriovPf
       consumes:
         - application/json
@@ -6739,22 +9221,76 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: pf-pci-id
           in: path
           description: Identifier for the sriov-pf
           required: true
           type: string
+          example: __PF-PCI-ID__
         - name: body
           in: body
-          description: sriov-pf object that needs to be created or updated
+          description: sriov-pf object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructurePserversPserverPInterfacesPInterfaceSriovPfsSriovPf.json)
           required: true
           schema:
             $ref: "#/definitions/sriov-pf"
+    patch:
+      tags:
+        - CloudInfrastructure
+      summary: update an existing sriov-pf
+      description: |
+        Update an existing sriov-pf
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateCloudInfrastructurePserversPserverPInterfacesPInterfaceSriovPfsSriovPf
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: hostname
+          in: path
+          description: Value from executing hostname on the compute node.
+          required: true
+          type: string
+          example: __HOSTNAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the physical interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: pf-pci-id
+          in: path
+          description: Identifier for the sriov-pf
+          required: true
+          type: string
+          example: __PF-PCI-ID__
+        - name: body
+          in: body
+          description: sriov-pf object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/sriov-pf"
     delete:
       tags:
         - CloudInfrastructure
@@ -6776,16 +9312,19 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: pf-pci-id
           in: path
           description: Identifier for the sriov-pf
           required: true
           type: string
+          example: __PF-PCI-ID__
         - name: resource-version
           in: query
           description: resource-version for concurrency
@@ -6805,7 +9344,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/sriov-pfs"
+              $ref: "#/getDefinitions/sriov-pfs"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -6814,11 +9353,13 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: inv-status
           in: query
           description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
@@ -6864,24 +9405,28 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vlan-interface
           in: path
           description: String that identifies the interface
           required: true
           type: string
+          example: __VLAN-INTERFACE__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceVlansVlan.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -6906,21 +9451,25 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vlan-interface
           in: path
           description: String that identifies the interface
           required: true
           type: string
+          example: __VLAN-INTERFACE__
   /cloud-infrastructure/pservers/pserver/{hostname}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}/relationship-list/relationship:
     put:
       tags:
@@ -6942,29 +9491,34 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vlan-interface
           in: path
           description: String that identifies the interface
           required: true
           type: string
+          example: __VLAN-INTERFACE__
         - name: l3-interface-ipv4-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -6989,26 +9543,31 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vlan-interface
           in: path
           description: String that identifies the interface
           required: true
           type: string
+          example: __VLAN-INTERFACE__
         - name: l3-interface-ipv4-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
   /cloud-infrastructure/pservers/pserver/{hostname}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}:
     get:
       tags:
@@ -7023,7 +9582,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/l3-interface-ipv4-address-list"
+              $ref: "#/getDefinitions/l3-interface-ipv4-address-list"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -7032,26 +9591,31 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vlan-interface
           in: path
           description: String that identifies the interface
           required: true
           type: string
+          example: __VLAN-INTERFACE__
         - name: l3-interface-ipv4-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
         - name: inv-status
           in: query
           description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
@@ -7122,7 +9686,10 @@ paths:
       tags:
         - CloudInfrastructure
       summary: create or update an existing l3-interface-ipv4-address-list
-      description: create or update an existing l3-interface-ipv4-address-list
+      description: |
+        Create or update an existing l3-interface-ipv4-address-list.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
       operationId: createOrUpdateCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList
       consumes:
         - application/json
@@ -7139,32 +9706,100 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vlan-interface
           in: path
           description: String that identifies the interface
           required: true
           type: string
+          example: __VLAN-INTERFACE__
         - name: l3-interface-ipv4-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
         - name: body
           in: body
-          description: l3-interface-ipv4-address-list object that needs to be created or updated
+          description: l3-interface-ipv4-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList.json)
           required: true
           schema:
             $ref: "#/definitions/l3-interface-ipv4-address-list"
+    patch:
+      tags:
+        - CloudInfrastructure
+      summary: update an existing l3-interface-ipv4-address-list
+      description: |
+        Update an existing l3-interface-ipv4-address-list
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: hostname
+          in: path
+          description: Value from executing hostname on the compute node.
+          required: true
+          type: string
+          example: __HOSTNAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the physical interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
+          type: string
+          example: __VLAN-INTERFACE__
+        - name: l3-interface-ipv4-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
+        - name: body
+          in: body
+          description: l3-interface-ipv4-address-list object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/l3-interface-ipv4-address-list"
     delete:
       tags:
         - CloudInfrastructure
@@ -7186,26 +9821,31 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vlan-interface
           in: path
           description: String that identifies the interface
           required: true
           type: string
+          example: __VLAN-INTERFACE__
         - name: l3-interface-ipv4-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
         - name: resource-version
           in: query
           description: resource-version for concurrency
@@ -7232,29 +9872,34 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vlan-interface
           in: path
           description: String that identifies the interface
           required: true
           type: string
+          example: __VLAN-INTERFACE__
         - name: l3-interface-ipv6-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -7279,26 +9924,31 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vlan-interface
           in: path
           description: String that identifies the interface
           required: true
           type: string
+          example: __VLAN-INTERFACE__
         - name: l3-interface-ipv6-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
   /cloud-infrastructure/pservers/pserver/{hostname}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}:
     get:
       tags:
@@ -7313,7 +9963,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/l3-interface-ipv6-address-list"
+              $ref: "#/getDefinitions/l3-interface-ipv6-address-list"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -7322,26 +9972,31 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vlan-interface
           in: path
           description: String that identifies the interface
           required: true
           type: string
+          example: __VLAN-INTERFACE__
         - name: l3-interface-ipv6-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
         - name: inv-status
           in: query
           description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
@@ -7412,7 +10067,10 @@ paths:
       tags:
         - CloudInfrastructure
       summary: create or update an existing l3-interface-ipv6-address-list
-      description: create or update an existing l3-interface-ipv6-address-list
+      description: |
+        Create or update an existing l3-interface-ipv6-address-list.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
       operationId: createOrUpdateCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList
       consumes:
         - application/json
@@ -7429,32 +10087,100 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vlan-interface
           in: path
           description: String that identifies the interface
           required: true
           type: string
+          example: __VLAN-INTERFACE__
         - name: l3-interface-ipv6-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
         - name: body
           in: body
-          description: l3-interface-ipv6-address-list object that needs to be created or updated
+          description: l3-interface-ipv6-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList.json)
           required: true
           schema:
             $ref: "#/definitions/l3-interface-ipv6-address-list"
+    patch:
+      tags:
+        - CloudInfrastructure
+      summary: update an existing l3-interface-ipv6-address-list
+      description: |
+        Update an existing l3-interface-ipv6-address-list
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: hostname
+          in: path
+          description: Value from executing hostname on the compute node.
+          required: true
+          type: string
+          example: __HOSTNAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the physical interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
+          type: string
+          example: __VLAN-INTERFACE__
+        - name: l3-interface-ipv6-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
+        - name: body
+          in: body
+          description: l3-interface-ipv6-address-list object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/l3-interface-ipv6-address-list"
     delete:
       tags:
         - CloudInfrastructure
@@ -7476,26 +10202,31 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vlan-interface
           in: path
           description: String that identifies the interface
           required: true
           type: string
+          example: __VLAN-INTERFACE__
         - name: l3-interface-ipv6-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
         - name: resource-version
           in: query
           description: resource-version for concurrency
@@ -7515,7 +10246,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/vlan"
+              $ref: "#/getDefinitions/vlan"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -7524,21 +10255,25 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vlan-interface
           in: path
           description: String that identifies the interface
           required: true
           type: string
+          example: __VLAN-INTERFACE__
         - name: inv-status
           in: query
           description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
@@ -7593,7 +10328,10 @@ paths:
       tags:
         - CloudInfrastructure
       summary: create or update an existing vlan
-      description: create or update an existing vlan
+      description: |
+        Create or update an existing vlan.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
       operationId: createOrUpdateCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceVlansVlan
       consumes:
         - application/json
@@ -7610,27 +10348,88 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vlan-interface
           in: path
           description: String that identifies the interface
           required: true
           type: string
+          example: __VLAN-INTERFACE__
         - name: body
           in: body
-          description: vlan object that needs to be created or updated
+          description: vlan object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceVlansVlan.json)
           required: true
           schema:
             $ref: "#/definitions/vlan"
+    patch:
+      tags:
+        - CloudInfrastructure
+      summary: update an existing vlan
+      description: |
+        Update an existing vlan
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceVlansVlan
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: hostname
+          in: path
+          description: Value from executing hostname on the compute node.
+          required: true
+          type: string
+          example: __HOSTNAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the physical interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
+          type: string
+          example: __VLAN-INTERFACE__
+        - name: body
+          in: body
+          description: vlan object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/vlan"
     delete:
       tags:
         - CloudInfrastructure
@@ -7652,21 +10451,25 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vlan-interface
           in: path
           description: String that identifies the interface
           required: true
           type: string
+          example: __VLAN-INTERFACE__
         - name: resource-version
           in: query
           description: resource-version for concurrency
@@ -7686,7 +10489,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/vlans"
+              $ref: "#/getDefinitions/vlans"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -7695,16 +10498,19 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: inv-status
           in: query
           description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
@@ -7765,24 +10571,28 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: pci-id
           in: path
           description: PCI ID used to identify the sriov-vf
           required: true
           type: string
+          example: __PCI-ID__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceSriovVfsSriovVf.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -7807,21 +10617,25 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: pci-id
           in: path
           description: PCI ID used to identify the sriov-vf
           required: true
           type: string
+          example: __PCI-ID__
   /cloud-infrastructure/pservers/pserver/{hostname}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/sriov-vfs/sriov-vf/{pci-id}:
     get:
       tags:
@@ -7836,7 +10650,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/sriov-vf"
+              $ref: "#/getDefinitions/sriov-vf"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -7845,21 +10659,25 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: pci-id
           in: path
           description: PCI ID used to identify the sriov-vf
           required: true
           type: string
+          example: __PCI-ID__
         - name: inv-status
           in: query
           description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
@@ -7923,7 +10741,10 @@ paths:
       tags:
         - CloudInfrastructure
       summary: create or update an existing sriov-vf
-      description: create or update an existing sriov-vf
+      description: |
+        Create or update an existing sriov-vf.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
       operationId: createOrUpdateCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceSriovVfsSriovVf
       consumes:
         - application/json
@@ -7940,27 +10761,88 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: pci-id
           in: path
           description: PCI ID used to identify the sriov-vf
           required: true
           type: string
+          example: __PCI-ID__
         - name: body
           in: body
-          description: sriov-vf object that needs to be created or updated
+          description: sriov-vf object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceSriovVfsSriovVf.json)
           required: true
           schema:
             $ref: "#/definitions/sriov-vf"
+    patch:
+      tags:
+        - CloudInfrastructure
+      summary: update an existing sriov-vf
+      description: |
+        Update an existing sriov-vf
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceSriovVfsSriovVf
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: hostname
+          in: path
+          description: Value from executing hostname on the compute node.
+          required: true
+          type: string
+          example: __HOSTNAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the physical interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: pci-id
+          in: path
+          description: PCI ID used to identify the sriov-vf
+          required: true
+          type: string
+          example: __PCI-ID__
+        - name: body
+          in: body
+          description: sriov-vf object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/sriov-vf"
     delete:
       tags:
         - CloudInfrastructure
@@ -7982,21 +10864,25 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: pci-id
           in: path
           description: PCI ID used to identify the sriov-vf
           required: true
           type: string
+          example: __PCI-ID__
         - name: resource-version
           in: query
           description: resource-version for concurrency
@@ -8016,7 +10902,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/sriov-vfs"
+              $ref: "#/getDefinitions/sriov-vfs"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -8025,16 +10911,19 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: inv-status
           in: query
           description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
@@ -8095,19 +10984,22 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterface.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -8132,16 +11024,19 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
   /cloud-infrastructure/pservers/pserver/{hostname}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}/relationship-list/relationship:
     put:
       tags:
@@ -8163,24 +11058,28 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: l3-interface-ipv4-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -8205,21 +11104,25 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: l3-interface-ipv4-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
   /cloud-infrastructure/pservers/pserver/{hostname}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}:
     get:
       tags:
@@ -8234,7 +11137,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/l3-interface-ipv4-address-list"
+              $ref: "#/getDefinitions/l3-interface-ipv4-address-list"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -8243,21 +11146,25 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: l3-interface-ipv4-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
         - name: inv-status
           in: query
           description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
@@ -8317,7 +11224,10 @@ paths:
       tags:
         - CloudInfrastructure
       summary: create or update an existing l3-interface-ipv4-address-list
-      description: create or update an existing l3-interface-ipv4-address-list
+      description: |
+        Create or update an existing l3-interface-ipv4-address-list.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
       operationId: createOrUpdateCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList
       consumes:
         - application/json
@@ -8334,27 +11244,88 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: l3-interface-ipv4-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
         - name: body
           in: body
-          description: l3-interface-ipv4-address-list object that needs to be created or updated
+          description: l3-interface-ipv4-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList.json)
           required: true
           schema:
             $ref: "#/definitions/l3-interface-ipv4-address-list"
+    patch:
+      tags:
+        - CloudInfrastructure
+      summary: update an existing l3-interface-ipv4-address-list
+      description: |
+        Update an existing l3-interface-ipv4-address-list
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: hostname
+          in: path
+          description: Value from executing hostname on the compute node.
+          required: true
+          type: string
+          example: __HOSTNAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the physical interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: l3-interface-ipv4-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
+        - name: body
+          in: body
+          description: l3-interface-ipv4-address-list object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/l3-interface-ipv4-address-list"
     delete:
       tags:
         - CloudInfrastructure
@@ -8376,21 +11347,25 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: l3-interface-ipv4-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
         - name: resource-version
           in: query
           description: resource-version for concurrency
@@ -8417,24 +11392,28 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: l3-interface-ipv6-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -8459,21 +11438,25 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: l3-interface-ipv6-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
   /cloud-infrastructure/pservers/pserver/{hostname}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}:
     get:
       tags:
@@ -8488,7 +11471,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/l3-interface-ipv6-address-list"
+              $ref: "#/getDefinitions/l3-interface-ipv6-address-list"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -8497,21 +11480,25 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: l3-interface-ipv6-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
         - name: inv-status
           in: query
           description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
@@ -8571,7 +11558,10 @@ paths:
       tags:
         - CloudInfrastructure
       summary: create or update an existing l3-interface-ipv6-address-list
-      description: create or update an existing l3-interface-ipv6-address-list
+      description: |
+        Create or update an existing l3-interface-ipv6-address-list.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
       operationId: createOrUpdateCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList
       consumes:
         - application/json
@@ -8588,27 +11578,88 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: l3-interface-ipv6-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
         - name: body
           in: body
-          description: l3-interface-ipv6-address-list object that needs to be created or updated
+          description: l3-interface-ipv6-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList.json)
           required: true
           schema:
             $ref: "#/definitions/l3-interface-ipv6-address-list"
+    patch:
+      tags:
+        - CloudInfrastructure
+      summary: update an existing l3-interface-ipv6-address-list
+      description: |
+        Update an existing l3-interface-ipv6-address-list
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: hostname
+          in: path
+          description: Value from executing hostname on the compute node.
+          required: true
+          type: string
+          example: __HOSTNAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the physical interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: l3-interface-ipv6-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
+        - name: body
+          in: body
+          description: l3-interface-ipv6-address-list object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/l3-interface-ipv6-address-list"
     delete:
       tags:
         - CloudInfrastructure
@@ -8630,21 +11681,25 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: l3-interface-ipv6-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
         - name: resource-version
           in: query
           description: resource-version for concurrency
@@ -8664,7 +11719,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/l-interface"
+              $ref: "#/getDefinitions/l-interface"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -8673,16 +11728,19 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: inv-status
           in: query
           description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
@@ -8726,7 +11784,10 @@ paths:
       tags:
         - CloudInfrastructure
       summary: create or update an existing l-interface
-      description: create or update an existing l-interface
+      description: |
+        Create or update an existing l-interface.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
       operationId: createOrUpdateCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterface
       consumes:
         - application/json
@@ -8743,22 +11804,76 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: body
           in: body
-          description: l-interface object that needs to be created or updated
+          description: l-interface object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterface.json)
           required: true
           schema:
             $ref: "#/definitions/l-interface"
+    patch:
+      tags:
+        - CloudInfrastructure
+      summary: update an existing l-interface
+      description: |
+        Update an existing l-interface
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterface
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: hostname
+          in: path
+          description: Value from executing hostname on the compute node.
+          required: true
+          type: string
+          example: __HOSTNAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the physical interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: body
+          in: body
+          description: l-interface object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/l-interface"
     delete:
       tags:
         - CloudInfrastructure
@@ -8780,16 +11895,19 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: resource-version
           in: query
           description: resource-version for concurrency
@@ -8809,7 +11927,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/l-interfaces"
+              $ref: "#/getDefinitions/l-interfaces"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -8818,11 +11936,13 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: inv-status
           in: query
           description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
@@ -8861,7 +11981,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/p-interface"
+              $ref: "#/getDefinitions/p-interface"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -8870,11 +11990,13 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: inv-status
           in: query
           description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
@@ -8903,7 +12025,10 @@ paths:
       tags:
         - CloudInfrastructure
       summary: create or update an existing p-interface
-      description: create or update an existing p-interface
+      description: |
+        Create or update an existing p-interface.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
       operationId: createOrUpdateCloudInfrastructurePserversPserverPInterfacesPInterface
       consumes:
         - application/json
@@ -8920,17 +12045,64 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: body
           in: body
-          description: p-interface object that needs to be created or updated
+          description: p-interface object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructurePserversPserverPInterfacesPInterface.json)
           required: true
           schema:
             $ref: "#/definitions/p-interface"
+    patch:
+      tags:
+        - CloudInfrastructure
+      summary: update an existing p-interface
+      description: |
+        Update an existing p-interface
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateCloudInfrastructurePserversPserverPInterfacesPInterface
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: hostname
+          in: path
+          description: Value from executing hostname on the compute node.
+          required: true
+          type: string
+          example: __HOSTNAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the physical interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: body
+          in: body
+          description: p-interface object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/p-interface"
     delete:
       tags:
         - CloudInfrastructure
@@ -8952,11 +12124,13 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: resource-version
           in: query
           description: resource-version for concurrency
@@ -8976,7 +12150,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/p-interfaces"
+              $ref: "#/getDefinitions/p-interfaces"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -8985,6 +12159,7 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: inv-status
           in: query
           description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
@@ -9025,14 +12200,16 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the link aggregate interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructurePserversPserverLagInterfacesLagInterface.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -9057,11 +12234,13 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the link aggregate interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
   /cloud-infrastructure/pservers/pserver/{hostname}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/relationship-list/relationship:
     put:
       tags:
@@ -9083,24 +12262,28 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the link aggregate interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vlan-interface
           in: path
           description: String that identifies the interface
           required: true
           type: string
+          example: __VLAN-INTERFACE__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlan.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -9125,21 +12308,25 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the link aggregate interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vlan-interface
           in: path
           description: String that identifies the interface
           required: true
           type: string
+          example: __VLAN-INTERFACE__
   /cloud-infrastructure/pservers/pserver/{hostname}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}/relationship-list/relationship:
     put:
       tags:
@@ -9161,29 +12348,34 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the link aggregate interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vlan-interface
           in: path
           description: String that identifies the interface
           required: true
           type: string
+          example: __VLAN-INTERFACE__
         - name: l3-interface-ipv4-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -9208,26 +12400,31 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the link aggregate interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vlan-interface
           in: path
           description: String that identifies the interface
           required: true
           type: string
+          example: __VLAN-INTERFACE__
         - name: l3-interface-ipv4-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
   /cloud-infrastructure/pservers/pserver/{hostname}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}:
     get:
       tags:
@@ -9242,7 +12439,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/l3-interface-ipv4-address-list"
+              $ref: "#/getDefinitions/l3-interface-ipv4-address-list"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -9251,26 +12448,31 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the link aggregate interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vlan-interface
           in: path
           description: String that identifies the interface
           required: true
           type: string
+          example: __VLAN-INTERFACE__
         - name: l3-interface-ipv4-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
         - name: inv-status
           in: query
           description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
@@ -9346,7 +12548,10 @@ paths:
       tags:
         - CloudInfrastructure
       summary: create or update an existing l3-interface-ipv4-address-list
-      description: create or update an existing l3-interface-ipv4-address-list
+      description: |
+        Create or update an existing l3-interface-ipv4-address-list.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
       operationId: createOrUpdateCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList
       consumes:
         - application/json
@@ -9363,38 +12568,54 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the link aggregate interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vlan-interface
           in: path
           description: String that identifies the interface
           required: true
           type: string
+          example: __VLAN-INTERFACE__
         - name: l3-interface-ipv4-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
         - name: body
           in: body
-          description: l3-interface-ipv4-address-list object that needs to be created or updated
+          description: l3-interface-ipv4-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList.json)
           required: true
           schema:
             $ref: "#/definitions/l3-interface-ipv4-address-list"
-    delete:
+    patch:
       tags:
         - CloudInfrastructure
-      summary: delete an existing l3-interface-ipv4-address-list
-      description: delete an existing l3-interface-ipv4-address-list
-      operationId: deleteCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList
+      summary: update an existing l3-interface-ipv4-address-list
+      description: |
+        Update an existing l3-interface-ipv4-address-list
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList
       consumes:
         - application/json
         - application/xml
@@ -9410,37 +12631,43 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the link aggregate interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vlan-interface
           in: path
           description: String that identifies the interface
           required: true
           type: string
+          example: __VLAN-INTERFACE__
         - name: l3-interface-ipv4-address
           in: path
           description: IP address
           required: true
           type: string
-        - name: resource-version
-          in: query
-          description: resource-version for concurrency
+          example: __L3-INTERFACE-IPV4-ADDRESS__
+        - name: body
+          in: body
+          description: l3-interface-ipv4-address-list object that needs to be created or updated. 
           required: true
-          type: string
-  /cloud-infrastructure/pservers/pserver/{hostname}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}/relationship-list/relationship:
-    put:
+          schema:
+            $ref: "#/patchDefinitions/l3-interface-ipv4-address-list"
+    delete:
       tags:
         - CloudInfrastructure
-      summary: see node definition for valid relationships
-      operationId: createOrUpdateCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressListRelationshipListRelationship
+      summary: delete an existing l3-interface-ipv4-address-list
+      description: delete an existing l3-interface-ipv4-address-list
+      operationId: deleteCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList
       consumes:
         - application/json
         - application/xml
@@ -9456,29 +12683,85 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the link aggregate interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vlan-interface
           in: path
           description: String that identifies the interface
           required: true
           type: string
+          example: __VLAN-INTERFACE__
+        - name: l3-interface-ipv4-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
+        - name: resource-version
+          in: query
+          description: resource-version for concurrency
+          required: true
+          type: string
+  /cloud-infrastructure/pservers/pserver/{hostname}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}/relationship-list/relationship:
+    put:
+      tags:
+        - CloudInfrastructure
+      summary: see node definition for valid relationships
+      operationId: createOrUpdateCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressListRelationshipListRelationship
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: hostname
+          in: path
+          description: Value from executing hostname on the compute node.
+          required: true
+          type: string
+          example: __HOSTNAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
+          type: string
+          example: __VLAN-INTERFACE__
         - name: l3-interface-ipv6-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -9503,26 +12786,31 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the link aggregate interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vlan-interface
           in: path
           description: String that identifies the interface
           required: true
           type: string
+          example: __VLAN-INTERFACE__
         - name: l3-interface-ipv6-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
   /cloud-infrastructure/pservers/pserver/{hostname}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}:
     get:
       tags:
@@ -9537,7 +12825,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/l3-interface-ipv6-address-list"
+              $ref: "#/getDefinitions/l3-interface-ipv6-address-list"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -9546,26 +12834,31 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the link aggregate interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vlan-interface
           in: path
           description: String that identifies the interface
           required: true
           type: string
+          example: __VLAN-INTERFACE__
         - name: l3-interface-ipv6-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
         - name: inv-status
           in: query
           description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
@@ -9641,7 +12934,10 @@ paths:
       tags:
         - CloudInfrastructure
       summary: create or update an existing l3-interface-ipv6-address-list
-      description: create or update an existing l3-interface-ipv6-address-list
+      description: |
+        Create or update an existing l3-interface-ipv6-address-list.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
       operationId: createOrUpdateCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList
       consumes:
         - application/json
@@ -9658,32 +12954,100 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the link aggregate interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vlan-interface
           in: path
           description: String that identifies the interface
           required: true
           type: string
+          example: __VLAN-INTERFACE__
         - name: l3-interface-ipv6-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
         - name: body
           in: body
-          description: l3-interface-ipv6-address-list object that needs to be created or updated
+          description: l3-interface-ipv6-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList.json)
           required: true
           schema:
             $ref: "#/definitions/l3-interface-ipv6-address-list"
+    patch:
+      tags:
+        - CloudInfrastructure
+      summary: update an existing l3-interface-ipv6-address-list
+      description: |
+        Update an existing l3-interface-ipv6-address-list
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: hostname
+          in: path
+          description: Value from executing hostname on the compute node.
+          required: true
+          type: string
+          example: __HOSTNAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
+          type: string
+          example: __VLAN-INTERFACE__
+        - name: l3-interface-ipv6-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
+        - name: body
+          in: body
+          description: l3-interface-ipv6-address-list object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/l3-interface-ipv6-address-list"
     delete:
       tags:
         - CloudInfrastructure
@@ -9705,26 +13069,31 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the link aggregate interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vlan-interface
           in: path
           description: String that identifies the interface
           required: true
           type: string
+          example: __VLAN-INTERFACE__
         - name: l3-interface-ipv6-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
         - name: resource-version
           in: query
           description: resource-version for concurrency
@@ -9744,7 +13113,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/vlan"
+              $ref: "#/getDefinitions/vlan"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -9753,21 +13122,25 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the link aggregate interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vlan-interface
           in: path
           description: String that identifies the interface
           required: true
           type: string
+          example: __VLAN-INTERFACE__
         - name: inv-status
           in: query
           description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
@@ -9827,7 +13200,10 @@ paths:
       tags:
         - CloudInfrastructure
       summary: create or update an existing vlan
-      description: create or update an existing vlan
+      description: |
+        Create or update an existing vlan.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
       operationId: createOrUpdateCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlan
       consumes:
         - application/json
@@ -9844,27 +13220,88 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the link aggregate interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vlan-interface
           in: path
           description: String that identifies the interface
           required: true
           type: string
+          example: __VLAN-INTERFACE__
         - name: body
           in: body
-          description: vlan object that needs to be created or updated
+          description: vlan object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlan.json)
           required: true
           schema:
             $ref: "#/definitions/vlan"
+    patch:
+      tags:
+        - CloudInfrastructure
+      summary: update an existing vlan
+      description: |
+        Update an existing vlan
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlan
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: hostname
+          in: path
+          description: Value from executing hostname on the compute node.
+          required: true
+          type: string
+          example: __HOSTNAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
+          type: string
+          example: __VLAN-INTERFACE__
+        - name: body
+          in: body
+          description: vlan object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/vlan"
     delete:
       tags:
         - CloudInfrastructure
@@ -9886,21 +13323,25 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the link aggregate interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vlan-interface
           in: path
           description: String that identifies the interface
           required: true
           type: string
+          example: __VLAN-INTERFACE__
         - name: resource-version
           in: query
           description: resource-version for concurrency
@@ -9920,7 +13361,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/vlans"
+              $ref: "#/getDefinitions/vlans"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -9929,16 +13370,19 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the link aggregate interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: inv-status
           in: query
           description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
@@ -10004,24 +13448,28 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the link aggregate interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: pci-id
           in: path
           description: PCI ID used to identify the sriov-vf
           required: true
           type: string
+          example: __PCI-ID__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfsSriovVf.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -10046,21 +13494,25 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the link aggregate interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: pci-id
           in: path
           description: PCI ID used to identify the sriov-vf
           required: true
           type: string
+          example: __PCI-ID__
   /cloud-infrastructure/pservers/pserver/{hostname}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/sriov-vfs/sriov-vf/{pci-id}:
     get:
       tags:
@@ -10075,7 +13527,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/sriov-vf"
+              $ref: "#/getDefinitions/sriov-vf"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -10084,21 +13536,25 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the link aggregate interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: pci-id
           in: path
           description: PCI ID used to identify the sriov-vf
           required: true
           type: string
+          example: __PCI-ID__
         - name: inv-status
           in: query
           description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
@@ -10167,7 +13623,10 @@ paths:
       tags:
         - CloudInfrastructure
       summary: create or update an existing sriov-vf
-      description: create or update an existing sriov-vf
+      description: |
+        Create or update an existing sriov-vf.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
       operationId: createOrUpdateCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfsSriovVf
       consumes:
         - application/json
@@ -10184,27 +13643,88 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the link aggregate interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: pci-id
           in: path
           description: PCI ID used to identify the sriov-vf
           required: true
           type: string
+          example: __PCI-ID__
         - name: body
           in: body
-          description: sriov-vf object that needs to be created or updated
+          description: sriov-vf object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfsSriovVf.json)
           required: true
           schema:
             $ref: "#/definitions/sriov-vf"
+    patch:
+      tags:
+        - CloudInfrastructure
+      summary: update an existing sriov-vf
+      description: |
+        Update an existing sriov-vf
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfsSriovVf
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: hostname
+          in: path
+          description: Value from executing hostname on the compute node.
+          required: true
+          type: string
+          example: __HOSTNAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: pci-id
+          in: path
+          description: PCI ID used to identify the sriov-vf
+          required: true
+          type: string
+          example: __PCI-ID__
+        - name: body
+          in: body
+          description: sriov-vf object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/sriov-vf"
     delete:
       tags:
         - CloudInfrastructure
@@ -10226,21 +13746,25 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the link aggregate interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: pci-id
           in: path
           description: PCI ID used to identify the sriov-vf
           required: true
           type: string
+          example: __PCI-ID__
         - name: resource-version
           in: query
           description: resource-version for concurrency
@@ -10260,7 +13784,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/sriov-vfs"
+              $ref: "#/getDefinitions/sriov-vfs"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -10269,16 +13793,19 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the link aggregate interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: inv-status
           in: query
           description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
@@ -10344,19 +13871,22 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the link aggregate interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterface.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -10381,16 +13911,19 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the link aggregate interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
   /cloud-infrastructure/pservers/pserver/{hostname}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}/relationship-list/relationship:
     put:
       tags:
@@ -10412,24 +13945,28 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the link aggregate interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: l3-interface-ipv4-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -10454,21 +13991,25 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the link aggregate interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: l3-interface-ipv4-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
   /cloud-infrastructure/pservers/pserver/{hostname}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}:
     get:
       tags:
@@ -10483,7 +14024,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/l3-interface-ipv4-address-list"
+              $ref: "#/getDefinitions/l3-interface-ipv4-address-list"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -10492,21 +14033,25 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the link aggregate interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: l3-interface-ipv4-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
         - name: inv-status
           in: query
           description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
@@ -10571,7 +14116,10 @@ paths:
       tags:
         - CloudInfrastructure
       summary: create or update an existing l3-interface-ipv4-address-list
-      description: create or update an existing l3-interface-ipv4-address-list
+      description: |
+        Create or update an existing l3-interface-ipv4-address-list.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
       operationId: createOrUpdateCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList
       consumes:
         - application/json
@@ -10588,27 +14136,88 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the link aggregate interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: l3-interface-ipv4-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
         - name: body
           in: body
-          description: l3-interface-ipv4-address-list object that needs to be created or updated
+          description: l3-interface-ipv4-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList.json)
           required: true
           schema:
             $ref: "#/definitions/l3-interface-ipv4-address-list"
+    patch:
+      tags:
+        - CloudInfrastructure
+      summary: update an existing l3-interface-ipv4-address-list
+      description: |
+        Update an existing l3-interface-ipv4-address-list
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: hostname
+          in: path
+          description: Value from executing hostname on the compute node.
+          required: true
+          type: string
+          example: __HOSTNAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: l3-interface-ipv4-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
+        - name: body
+          in: body
+          description: l3-interface-ipv4-address-list object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/l3-interface-ipv4-address-list"
     delete:
       tags:
         - CloudInfrastructure
@@ -10630,21 +14239,25 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the link aggregate interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: l3-interface-ipv4-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
         - name: resource-version
           in: query
           description: resource-version for concurrency
@@ -10671,24 +14284,28 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the link aggregate interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: l3-interface-ipv6-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -10713,21 +14330,25 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the link aggregate interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: l3-interface-ipv6-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
   /cloud-infrastructure/pservers/pserver/{hostname}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}:
     get:
       tags:
@@ -10742,7 +14363,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/l3-interface-ipv6-address-list"
+              $ref: "#/getDefinitions/l3-interface-ipv6-address-list"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -10751,21 +14372,25 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the link aggregate interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: l3-interface-ipv6-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
         - name: inv-status
           in: query
           description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
@@ -10830,7 +14455,10 @@ paths:
       tags:
         - CloudInfrastructure
       summary: create or update an existing l3-interface-ipv6-address-list
-      description: create or update an existing l3-interface-ipv6-address-list
+      description: |
+        Create or update an existing l3-interface-ipv6-address-list.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
       operationId: createOrUpdateCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList
       consumes:
         - application/json
@@ -10847,27 +14475,88 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the link aggregate interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: l3-interface-ipv6-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
         - name: body
           in: body
-          description: l3-interface-ipv6-address-list object that needs to be created or updated
+          description: l3-interface-ipv6-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList.json)
           required: true
           schema:
             $ref: "#/definitions/l3-interface-ipv6-address-list"
+    patch:
+      tags:
+        - CloudInfrastructure
+      summary: update an existing l3-interface-ipv6-address-list
+      description: |
+        Update an existing l3-interface-ipv6-address-list
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: hostname
+          in: path
+          description: Value from executing hostname on the compute node.
+          required: true
+          type: string
+          example: __HOSTNAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: l3-interface-ipv6-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
+        - name: body
+          in: body
+          description: l3-interface-ipv6-address-list object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/l3-interface-ipv6-address-list"
     delete:
       tags:
         - CloudInfrastructure
@@ -10889,21 +14578,25 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the link aggregate interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: l3-interface-ipv6-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
         - name: resource-version
           in: query
           description: resource-version for concurrency
@@ -10923,7 +14616,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/l-interface"
+              $ref: "#/getDefinitions/l-interface"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -10932,16 +14625,19 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the link aggregate interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: inv-status
           in: query
           description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
@@ -10990,7 +14686,10 @@ paths:
       tags:
         - CloudInfrastructure
       summary: create or update an existing l-interface
-      description: create or update an existing l-interface
+      description: |
+        Create or update an existing l-interface.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
       operationId: createOrUpdateCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterface
       consumes:
         - application/json
@@ -11007,22 +14706,76 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the link aggregate interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: body
           in: body
-          description: l-interface object that needs to be created or updated
+          description: l-interface object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterface.json)
           required: true
           schema:
             $ref: "#/definitions/l-interface"
+    patch:
+      tags:
+        - CloudInfrastructure
+      summary: update an existing l-interface
+      description: |
+        Update an existing l-interface
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterface
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: hostname
+          in: path
+          description: Value from executing hostname on the compute node.
+          required: true
+          type: string
+          example: __HOSTNAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: body
+          in: body
+          description: l-interface object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/l-interface"
     delete:
       tags:
         - CloudInfrastructure
@@ -11044,16 +14797,19 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the link aggregate interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: resource-version
           in: query
           description: resource-version for concurrency
@@ -11073,7 +14829,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/l-interfaces"
+              $ref: "#/getDefinitions/l-interfaces"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -11082,11 +14838,13 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the link aggregate interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: inv-status
           in: query
           description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
@@ -11130,7 +14888,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/lag-interface"
+              $ref: "#/getDefinitions/lag-interface"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -11139,11 +14897,13 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the link aggregate interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: inv-status
           in: query
           description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
@@ -11177,7 +14937,10 @@ paths:
       tags:
         - CloudInfrastructure
       summary: create or update an existing lag-interface
-      description: create or update an existing lag-interface
+      description: |
+        Create or update an existing lag-interface.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
       operationId: createOrUpdateCloudInfrastructurePserversPserverLagInterfacesLagInterface
       consumes:
         - application/json
@@ -11194,17 +14957,64 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the link aggregate interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: body
           in: body
-          description: lag-interface object that needs to be created or updated
+          description: lag-interface object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructurePserversPserverLagInterfacesLagInterface.json)
           required: true
           schema:
             $ref: "#/definitions/lag-interface"
+    patch:
+      tags:
+        - CloudInfrastructure
+      summary: update an existing lag-interface
+      description: |
+        Update an existing lag-interface
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateCloudInfrastructurePserversPserverLagInterfacesLagInterface
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: hostname
+          in: path
+          description: Value from executing hostname on the compute node.
+          required: true
+          type: string
+          example: __HOSTNAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: body
+          in: body
+          description: lag-interface object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/lag-interface"
     delete:
       tags:
         - CloudInfrastructure
@@ -11226,11 +15036,13 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: interface-name
           in: path
           description: Name that identifies the link aggregate interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: resource-version
           in: query
           description: resource-version for concurrency
@@ -11250,7 +15062,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/lag-interfaces"
+              $ref: "#/getDefinitions/lag-interfaces"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -11259,6 +15071,7 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: inv-status
           in: query
           description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
@@ -11292,7 +15105,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/pserver"
+              $ref: "#/getDefinitions/pserver"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -11301,6 +15114,7 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: inv-status
           in: query
           description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
@@ -11324,7 +15138,10 @@ paths:
       tags:
         - CloudInfrastructure
       summary: create or update an existing pserver
-      description: create or update an existing pserver
+      description: |
+        Create or update an existing pserver.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
       operationId: createOrUpdateCloudInfrastructurePserversPserver
       consumes:
         - application/json
@@ -11341,12 +15158,52 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: body
           in: body
-          description: pserver object that needs to be created or updated
+          description: pserver object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructurePserversPserver.json)
           required: true
           schema:
             $ref: "#/definitions/pserver"
+    patch:
+      tags:
+        - CloudInfrastructure
+      summary: update an existing pserver
+      description: |
+        Update an existing pserver
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateCloudInfrastructurePserversPserver
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: hostname
+          in: path
+          description: Value from executing hostname on the compute node.
+          required: true
+          type: string
+          example: __HOSTNAME__
+        - name: body
+          in: body
+          description: pserver object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/pserver"
     delete:
       tags:
         - CloudInfrastructure
@@ -11368,6 +15225,7 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: resource-version
           in: query
           description: resource-version for concurrency
@@ -11387,7 +15245,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/pservers"
+              $ref: "#/getDefinitions/pservers"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
   /cloud-infrastructure/virtual-data-centers/virtual-data-center/{vdc-id}/relationship-list/relationship:
@@ -11411,9 +15269,10 @@ paths:
           description: Unique ID of the vdc
           required: true
           type: string
+          example: __VDC-ID__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureVirtualDataCentersVirtualDataCenter.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -11438,6 +15297,7 @@ paths:
           description: Unique ID of the vdc
           required: true
           type: string
+          example: __VDC-ID__
   /cloud-infrastructure/virtual-data-centers/virtual-data-center/{vdc-id}:
     get:
       tags:
@@ -11452,7 +15312,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/virtual-data-center"
+              $ref: "#/getDefinitions/virtual-data-center"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -11461,6 +15321,7 @@ paths:
           description: Unique ID of the vdc
           required: true
           type: string
+          example: __VDC-ID__
         - name: vdc-name
           in: query
           description: Name of the virtual data center
@@ -11470,7 +15331,10 @@ paths:
       tags:
         - CloudInfrastructure
       summary: create or update an existing virtual-data-center
-      description: create or update an existing virtual-data-center
+      description: |
+        Create or update an existing virtual-data-center.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
       operationId: createOrUpdateCloudInfrastructureVirtualDataCentersVirtualDataCenter
       consumes:
         - application/json
@@ -11487,12 +15351,52 @@ paths:
           description: Unique ID of the vdc
           required: true
           type: string
+          example: __VDC-ID__
         - name: body
           in: body
-          description: virtual-data-center object that needs to be created or updated
+          description: virtual-data-center object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureVirtualDataCentersVirtualDataCenter.json)
           required: true
           schema:
             $ref: "#/definitions/virtual-data-center"
+    patch:
+      tags:
+        - CloudInfrastructure
+      summary: update an existing virtual-data-center
+      description: |
+        Update an existing virtual-data-center
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateCloudInfrastructureVirtualDataCentersVirtualDataCenter
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: vdc-id
+          in: path
+          description: Unique ID of the vdc
+          required: true
+          type: string
+          example: __VDC-ID__
+        - name: body
+          in: body
+          description: virtual-data-center object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/virtual-data-center"
     delete:
       tags:
         - CloudInfrastructure
@@ -11514,6 +15418,7 @@ paths:
           description: Unique ID of the vdc
           required: true
           type: string
+          example: __VDC-ID__
         - name: resource-version
           in: query
           description: resource-version for concurrency
@@ -11533,7 +15438,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/virtual-data-centers"
+              $ref: "#/getDefinitions/virtual-data-centers"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
   /business/connectors/connector/{resource-instance-id}/relationship-list/relationship:
@@ -11557,9 +15462,10 @@ paths:
           description: Unique id of resource instance.
           required: true
           type: string
+          example: __RESOURCE-INSTANCE-ID__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/BusinessConnectorsConnector.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -11584,6 +15490,7 @@ paths:
           description: Unique id of resource instance.
           required: true
           type: string
+          example: __RESOURCE-INSTANCE-ID__
   /business/connectors/connector/{resource-instance-id}/metadata/metadatum/{metaname}:
     get:
       tags:
@@ -11598,7 +15505,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/metadatum"
+              $ref: "#/getDefinitions/metadatum"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -11607,10 +15514,12 @@ paths:
           description: Unique id of resource instance.
           required: true
           type: string
+          example: __RESOURCE-INSTANCE-ID__
         - name: metaname
           in: path
           required: true
           type: string
+          example: __METANAME__
         - name: model-invariant-id
           in: query
           description: the ASDC model id for this resource or service model.
@@ -11635,7 +15544,10 @@ paths:
       tags:
         - Business
       summary: create or update an existing metadatum
-      description: create or update an existing metadatum
+      description: |
+        Create or update an existing metadatum.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
       operationId: createOrUpdateBusinessConnectorsConnectorMetadataMetadatum
       consumes:
         - application/json
@@ -11652,16 +15564,62 @@ paths:
           description: Unique id of resource instance.
           required: true
           type: string
+          example: __RESOURCE-INSTANCE-ID__
         - name: metaname
           in: path
           required: true
           type: string
+          example: __METANAME__
         - name: body
           in: body
-          description: metadatum object that needs to be created or updated
+          description: metadatum object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/BusinessConnectorsConnectorMetadataMetadatum.json)
           required: true
           schema:
             $ref: "#/definitions/metadatum"
+    patch:
+      tags:
+        - Business
+      summary: update an existing metadatum
+      description: |
+        Update an existing metadatum
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateBusinessConnectorsConnectorMetadataMetadatum
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: resource-instance-id
+          in: path
+          description: Unique id of resource instance.
+          required: true
+          type: string
+          example: __RESOURCE-INSTANCE-ID__
+        - name: metaname
+          in: path
+          required: true
+          type: string
+          example: __METANAME__
+        - name: body
+          in: body
+          description: metadatum object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/metadatum"
     delete:
       tags:
         - Business
@@ -11683,10 +15641,12 @@ paths:
           description: Unique id of resource instance.
           required: true
           type: string
+          example: __RESOURCE-INSTANCE-ID__
         - name: metaname
           in: path
           required: true
           type: string
+          example: __METANAME__
         - name: resource-version
           in: query
           description: resource-version for concurrency
@@ -11706,7 +15666,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/metadata"
+              $ref: "#/getDefinitions/metadata"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -11715,6 +15675,7 @@ paths:
           description: Unique id of resource instance.
           required: true
           type: string
+          example: __RESOURCE-INSTANCE-ID__
         - name: model-invariant-id
           in: query
           description: the ASDC model id for this resource or service model.
@@ -11749,7 +15710,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/connector"
+              $ref: "#/getDefinitions/connector"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -11758,6 +15719,7 @@ paths:
           description: Unique id of resource instance.
           required: true
           type: string
+          example: __RESOURCE-INSTANCE-ID__
         - name: model-invariant-id
           in: query
           description: the ASDC model id for this resource or service model.
@@ -11782,7 +15744,10 @@ paths:
       tags:
         - Business
       summary: create or update an existing connector
-      description: create or update an existing connector
+      description: |
+        Create or update an existing connector.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
       operationId: createOrUpdateBusinessConnectorsConnector
       consumes:
         - application/json
@@ -11799,12 +15764,52 @@ paths:
           description: Unique id of resource instance.
           required: true
           type: string
+          example: __RESOURCE-INSTANCE-ID__
         - name: body
           in: body
-          description: connector object that needs to be created or updated
+          description: connector object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/BusinessConnectorsConnector.json)
           required: true
           schema:
             $ref: "#/definitions/connector"
+    patch:
+      tags:
+        - Business
+      summary: update an existing connector
+      description: |
+        Update an existing connector
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateBusinessConnectorsConnector
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: resource-instance-id
+          in: path
+          description: Unique id of resource instance.
+          required: true
+          type: string
+          example: __RESOURCE-INSTANCE-ID__
+        - name: body
+          in: body
+          description: connector object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/connector"
     delete:
       tags:
         - Business
@@ -11826,6 +15831,7 @@ paths:
           description: Unique id of resource instance.
           required: true
           type: string
+          example: __RESOURCE-INSTANCE-ID__
         - name: resource-version
           in: query
           description: resource-version for concurrency
@@ -11845,7 +15851,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/connectors"
+              $ref: "#/getDefinitions/connectors"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
   /business/customers/customer/{global-customer-id}/service-subscriptions/service-subscription/{service-type}/service-instances/service-instance/{service-instance-id}/relationship-list/relationship:
@@ -11869,19 +15875,22 @@ paths:
           description: Global customer id used across ECOMP to uniquely identify customer.
           required: true
           type: string
+          example: __GLOBAL-CUSTOMER-ID__
         - name: service-type
           in: path
           description: Value defined by orchestration to identify this service across ECOMP.
           required: true
           type: string
+          example: __SERVICE-TYPE__
         - name: service-instance-id
           in: path
           description: Uniquely identifies this instance of a service
           required: true
           type: string
+          example: __SERVICE-INSTANCE-ID__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/BusinessCustomersCustomerServiceSubscriptionsServiceSubscriptionServiceInstancesServiceInstance.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -11906,16 +15915,19 @@ paths:
           description: Global customer id used across ECOMP to uniquely identify customer.
           required: true
           type: string
+          example: __GLOBAL-CUSTOMER-ID__
         - name: service-type
           in: path
           description: Value defined by orchestration to identify this service across ECOMP.
           required: true
           type: string
+          example: __SERVICE-TYPE__
         - name: service-instance-id
           in: path
           description: Uniquely identifies this instance of a service
           required: true
           type: string
+          example: __SERVICE-INSTANCE-ID__
   /business/customers/customer/{global-customer-id}/service-subscriptions/service-subscription/{service-type}/service-instances/service-instance/{service-instance-id}/metadata/metadatum/{metaname}:
     get:
       tags:
@@ -11930,7 +15942,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/metadatum"
+              $ref: "#/getDefinitions/metadatum"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -11939,20 +15951,24 @@ paths:
           description: Global customer id used across ECOMP to uniquely identify customer.
           required: true
           type: string
+          example: __GLOBAL-CUSTOMER-ID__
         - name: service-type
           in: path
           description: Value defined by orchestration to identify this service across ECOMP.
           required: true
           type: string
+          example: __SERVICE-TYPE__
         - name: service-instance-id
           in: path
           description: Uniquely identifies this instance of a service
           required: true
           type: string
+          example: __SERVICE-INSTANCE-ID__
         - name: metaname
           in: path
           required: true
           type: string
+          example: __METANAME__
         - name: subscriber-name
           in: query
           description: Subscriber name, an alternate way to retrieve a customer.
@@ -12012,7 +16028,10 @@ paths:
       tags:
         - Business
       summary: create or update an existing metadatum
-      description: create or update an existing metadatum
+      description: |
+        Create or update an existing metadatum.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
       operationId: createOrUpdateBusinessCustomersCustomerServiceSubscriptionsServiceSubscriptionServiceInstancesServiceInstanceMetadataMetadatum
       consumes:
         - application/json
@@ -12029,26 +16048,86 @@ paths:
           description: Global customer id used across ECOMP to uniquely identify customer.
           required: true
           type: string
+          example: __GLOBAL-CUSTOMER-ID__
         - name: service-type
           in: path
           description: Value defined by orchestration to identify this service across ECOMP.
           required: true
           type: string
+          example: __SERVICE-TYPE__
         - name: service-instance-id
           in: path
           description: Uniquely identifies this instance of a service
           required: true
           type: string
+          example: __SERVICE-INSTANCE-ID__
         - name: metaname
           in: path
           required: true
           type: string
+          example: __METANAME__
         - name: body
           in: body
-          description: metadatum object that needs to be created or updated
+          description: metadatum object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/BusinessCustomersCustomerServiceSubscriptionsServiceSubscriptionServiceInstancesServiceInstanceMetadataMetadatum.json)
           required: true
           schema:
             $ref: "#/definitions/metadatum"
+    patch:
+      tags:
+        - Business
+      summary: update an existing metadatum
+      description: |
+        Update an existing metadatum
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateBusinessCustomersCustomerServiceSubscriptionsServiceSubscriptionServiceInstancesServiceInstanceMetadataMetadatum
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: global-customer-id
+          in: path
+          description: Global customer id used across ECOMP to uniquely identify customer.
+          required: true
+          type: string
+          example: __GLOBAL-CUSTOMER-ID__
+        - name: service-type
+          in: path
+          description: Value defined by orchestration to identify this service across ECOMP.
+          required: true
+          type: string
+          example: __SERVICE-TYPE__
+        - name: service-instance-id
+          in: path
+          description: Uniquely identifies this instance of a service
+          required: true
+          type: string
+          example: __SERVICE-INSTANCE-ID__
+        - name: metaname
+          in: path
+          required: true
+          type: string
+          example: __METANAME__
+        - name: body
+          in: body
+          description: metadatum object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/metadatum"
     delete:
       tags:
         - Business
@@ -12070,20 +16149,24 @@ paths:
           description: Global customer id used across ECOMP to uniquely identify customer.
           required: true
           type: string
+          example: __GLOBAL-CUSTOMER-ID__
         - name: service-type
           in: path
           description: Value defined by orchestration to identify this service across ECOMP.
           required: true
           type: string
+          example: __SERVICE-TYPE__
         - name: service-instance-id
           in: path
           description: Uniquely identifies this instance of a service
           required: true
           type: string
+          example: __SERVICE-INSTANCE-ID__
         - name: metaname
           in: path
           required: true
           type: string
+          example: __METANAME__
         - name: resource-version
           in: query
           description: resource-version for concurrency
@@ -12103,7 +16186,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/metadata"
+              $ref: "#/getDefinitions/metadata"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -12112,16 +16195,19 @@ paths:
           description: Global customer id used across ECOMP to uniquely identify customer.
           required: true
           type: string
+          example: __GLOBAL-CUSTOMER-ID__
         - name: service-type
           in: path
           description: Value defined by orchestration to identify this service across ECOMP.
           required: true
           type: string
+          example: __SERVICE-TYPE__
         - name: service-instance-id
           in: path
           description: Uniquely identifies this instance of a service
           required: true
           type: string
+          example: __SERVICE-INSTANCE-ID__
         - name: subscriber-name
           in: query
           description: Subscriber name, an alternate way to retrieve a customer.
@@ -12198,29 +16284,34 @@ paths:
           description: Global customer id used across ECOMP to uniquely identify customer.
           required: true
           type: string
+          example: __GLOBAL-CUSTOMER-ID__
         - name: service-type
           in: path
           description: Value defined by orchestration to identify this service across ECOMP.
           required: true
           type: string
+          example: __SERVICE-TYPE__
         - name: service-instance-id
           in: path
           description: Uniquely identifies this instance of a service
           required: true
           type: string
+          example: __SERVICE-INSTANCE-ID__
         - name: id
           in: path
           description: Allotted Resource id UUID assigned to this instance.
           required: true
           type: string
+          example: __ID__
         - name: id
           in: path
           description: Allotted Resource id UUID assigned to this instance.
           required: true
           type: string
+          example: __ID__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/BusinessCustomersCustomerServiceSubscriptionsServiceSubscriptionServiceInstancesServiceInstanceAllottedResourcesAllottedResourceTunnelXconnectsTunnelXconnect.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -12245,26 +16336,31 @@ paths:
           description: Global customer id used across ECOMP to uniquely identify customer.
           required: true
           type: string
+          example: __GLOBAL-CUSTOMER-ID__
         - name: service-type
           in: path
           description: Value defined by orchestration to identify this service across ECOMP.
           required: true
           type: string
+          example: __SERVICE-TYPE__
         - name: service-instance-id
           in: path
           description: Uniquely identifies this instance of a service
           required: true
           type: string
+          example: __SERVICE-INSTANCE-ID__
         - name: id
           in: path
           description: Allotted Resource id UUID assigned to this instance.
           required: true
           type: string
+          example: __ID__
         - name: id
           in: path
           description: Allotted Resource id UUID assigned to this instance.
           required: true
           type: string
+          example: __ID__
   /business/customers/customer/{global-customer-id}/service-subscriptions/service-subscription/{service-type}/service-instances/service-instance/{service-instance-id}/allotted-resources/allotted-resource/{id}/tunnel-xconnects/tunnel-xconnect/{id}:
     get:
       tags:
@@ -12279,7 +16375,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/tunnel-xconnect"
+              $ref: "#/getDefinitions/tunnel-xconnect"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -12288,26 +16384,31 @@ paths:
           description: Global customer id used across ECOMP to uniquely identify customer.
           required: true
           type: string
+          example: __GLOBAL-CUSTOMER-ID__
         - name: service-type
           in: path
           description: Value defined by orchestration to identify this service across ECOMP.
           required: true
           type: string
+          example: __SERVICE-TYPE__
         - name: service-instance-id
           in: path
           description: Uniquely identifies this instance of a service
           required: true
           type: string
+          example: __SERVICE-INSTANCE-ID__
         - name: id
           in: path
           description: Allotted Resource id UUID assigned to this instance.
           required: true
           type: string
+          example: __ID__
         - name: id
           in: path
           description: Allotted Resource id UUID assigned to this instance.
           required: true
           type: string
+          example: __ID__
         - name: subscriber-name
           in: query
           description: Subscriber name, an alternate way to retrieve a customer.
@@ -12387,7 +16488,10 @@ paths:
       tags:
         - Business
       summary: create or update an existing tunnel-xconnect
-      description: create or update an existing tunnel-xconnect
+      description: |
+        Create or update an existing tunnel-xconnect.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
       operationId: createOrUpdateBusinessCustomersCustomerServiceSubscriptionsServiceSubscriptionServiceInstancesServiceInstanceAllottedResourcesAllottedResourceTunnelXconnectsTunnelXconnect
       consumes:
         - application/json
@@ -12404,32 +16508,100 @@ paths:
           description: Global customer id used across ECOMP to uniquely identify customer.
           required: true
           type: string
+          example: __GLOBAL-CUSTOMER-ID__
         - name: service-type
           in: path
           description: Value defined by orchestration to identify this service across ECOMP.
           required: true
           type: string
+          example: __SERVICE-TYPE__
         - name: service-instance-id
           in: path
           description: Uniquely identifies this instance of a service
           required: true
           type: string
+          example: __SERVICE-INSTANCE-ID__
         - name: id
           in: path
           description: Allotted Resource id UUID assigned to this instance.
           required: true
           type: string
+          example: __ID__
         - name: id
           in: path
           description: Allotted Resource id UUID assigned to this instance.
           required: true
           type: string
+          example: __ID__
         - name: body
           in: body
-          description: tunnel-xconnect object that needs to be created or updated
+          description: tunnel-xconnect object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/BusinessCustomersCustomerServiceSubscriptionsServiceSubscriptionServiceInstancesServiceInstanceAllottedResourcesAllottedResourceTunnelXconnectsTunnelXconnect.json)
           required: true
           schema:
             $ref: "#/definitions/tunnel-xconnect"
+    patch:
+      tags:
+        - Business
+      summary: update an existing tunnel-xconnect
+      description: |
+        Update an existing tunnel-xconnect
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateBusinessCustomersCustomerServiceSubscriptionsServiceSubscriptionServiceInstancesServiceInstanceAllottedResourcesAllottedResourceTunnelXconnectsTunnelXconnect
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: global-customer-id
+          in: path
+          description: Global customer id used across ECOMP to uniquely identify customer.
+          required: true
+          type: string
+          example: __GLOBAL-CUSTOMER-ID__
+        - name: service-type
+          in: path
+          description: Value defined by orchestration to identify this service across ECOMP.
+          required: true
+          type: string
+          example: __SERVICE-TYPE__
+        - name: service-instance-id
+          in: path
+          description: Uniquely identifies this instance of a service
+          required: true
+          type: string
+          example: __SERVICE-INSTANCE-ID__
+        - name: id
+          in: path
+          description: Allotted Resource id UUID assigned to this instance.
+          required: true
+          type: string
+          example: __ID__
+        - name: id
+          in: path
+          description: Allotted Resource id UUID assigned to this instance.
+          required: true
+          type: string
+          example: __ID__
+        - name: body
+          in: body
+          description: tunnel-xconnect object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/tunnel-xconnect"
     delete:
       tags:
         - Business
@@ -12451,26 +16623,31 @@ paths:
           description: Global customer id used across ECOMP to uniquely identify customer.
           required: true
           type: string
+          example: __GLOBAL-CUSTOMER-ID__
         - name: service-type
           in: path
           description: Value defined by orchestration to identify this service across ECOMP.
           required: true
           type: string
+          example: __SERVICE-TYPE__
         - name: service-instance-id
           in: path
           description: Uniquely identifies this instance of a service
           required: true
           type: string
+          example: __SERVICE-INSTANCE-ID__
         - name: id
           in: path
           description: Allotted Resource id UUID assigned to this instance.
           required: true
           type: string
+          example: __ID__
         - name: id
           in: path
           description: Allotted Resource id UUID assigned to this instance.
           required: true
           type: string
+          example: __ID__
         - name: resource-version
           in: query
           description: resource-version for concurrency
@@ -12490,7 +16667,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/tunnel-xconnects"
+              $ref: "#/getDefinitions/tunnel-xconnects"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -12499,21 +16676,25 @@ paths:
           description: Global customer id used across ECOMP to uniquely identify customer.
           required: true
           type: string
+          example: __GLOBAL-CUSTOMER-ID__
         - name: service-type
           in: path
           description: Value defined by orchestration to identify this service across ECOMP.
           required: true
           type: string
+          example: __SERVICE-TYPE__
         - name: service-instance-id
           in: path
           description: Uniquely identifies this instance of a service
           required: true
           type: string
+          example: __SERVICE-INSTANCE-ID__
         - name: id
           in: path
           description: Allotted Resource id UUID assigned to this instance.
           required: true
           type: string
+          example: __ID__
         - name: subscriber-name
           in: query
           description: Subscriber name, an alternate way to retrieve a customer.
@@ -12610,24 +16791,28 @@ paths:
           description: Global customer id used across ECOMP to uniquely identify customer.
           required: true
           type: string
+          example: __GLOBAL-CUSTOMER-ID__
         - name: service-type
           in: path
           description: Value defined by orchestration to identify this service across ECOMP.
           required: true
           type: string
+          example: __SERVICE-TYPE__
         - name: service-instance-id
           in: path
           description: Uniquely identifies this instance of a service
           required: true
           type: string
+          example: __SERVICE-INSTANCE-ID__
         - name: id
           in: path
           description: Allotted Resource id UUID assigned to this instance.
           required: true
           type: string
+          example: __ID__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/BusinessCustomersCustomerServiceSubscriptionsServiceSubscriptionServiceInstancesServiceInstanceAllottedResourcesAllottedResource.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -12652,21 +16837,25 @@ paths:
           description: Global customer id used across ECOMP to uniquely identify customer.
           required: true
           type: string
+          example: __GLOBAL-CUSTOMER-ID__
         - name: service-type
           in: path
           description: Value defined by orchestration to identify this service across ECOMP.
           required: true
           type: string
+          example: __SERVICE-TYPE__
         - name: service-instance-id
           in: path
           description: Uniquely identifies this instance of a service
           required: true
           type: string
+          example: __SERVICE-INSTANCE-ID__
         - name: id
           in: path
           description: Allotted Resource id UUID assigned to this instance.
           required: true
           type: string
+          example: __ID__
   /business/customers/customer/{global-customer-id}/service-subscriptions/service-subscription/{service-type}/service-instances/service-instance/{service-instance-id}/allotted-resources/allotted-resource/{id}:
     get:
       tags:
@@ -12681,7 +16870,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/allotted-resource"
+              $ref: "#/getDefinitions/allotted-resource"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -12690,21 +16879,25 @@ paths:
           description: Global customer id used across ECOMP to uniquely identify customer.
           required: true
           type: string
+          example: __GLOBAL-CUSTOMER-ID__
         - name: service-type
           in: path
           description: Value defined by orchestration to identify this service across ECOMP.
           required: true
           type: string
+          example: __SERVICE-TYPE__
         - name: service-instance-id
           in: path
           description: Uniquely identifies this instance of a service
           required: true
           type: string
+          example: __SERVICE-INSTANCE-ID__
         - name: id
           in: path
           description: Allotted Resource id UUID assigned to this instance.
           required: true
           type: string
+          example: __ID__
         - name: subscriber-name
           in: query
           description: Subscriber name, an alternate way to retrieve a customer.
@@ -12784,7 +16977,10 @@ paths:
       tags:
         - Business
       summary: create or update an existing allotted-resource
-      description: create or update an existing allotted-resource
+      description: |
+        Create or update an existing allotted-resource.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
       operationId: createOrUpdateBusinessCustomersCustomerServiceSubscriptionsServiceSubscriptionServiceInstancesServiceInstanceAllottedResourcesAllottedResource
       consumes:
         - application/json
@@ -12801,27 +16997,88 @@ paths:
           description: Global customer id used across ECOMP to uniquely identify customer.
           required: true
           type: string
+          example: __GLOBAL-CUSTOMER-ID__
         - name: service-type
           in: path
           description: Value defined by orchestration to identify this service across ECOMP.
           required: true
           type: string
+          example: __SERVICE-TYPE__
         - name: service-instance-id
           in: path
           description: Uniquely identifies this instance of a service
           required: true
           type: string
+          example: __SERVICE-INSTANCE-ID__
         - name: id
           in: path
           description: Allotted Resource id UUID assigned to this instance.
           required: true
           type: string
+          example: __ID__
         - name: body
           in: body
-          description: allotted-resource object that needs to be created or updated
+          description: allotted-resource object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/BusinessCustomersCustomerServiceSubscriptionsServiceSubscriptionServiceInstancesServiceInstanceAllottedResourcesAllottedResource.json)
           required: true
           schema:
             $ref: "#/definitions/allotted-resource"
+    patch:
+      tags:
+        - Business
+      summary: update an existing allotted-resource
+      description: |
+        Update an existing allotted-resource
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateBusinessCustomersCustomerServiceSubscriptionsServiceSubscriptionServiceInstancesServiceInstanceAllottedResourcesAllottedResource
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: global-customer-id
+          in: path
+          description: Global customer id used across ECOMP to uniquely identify customer.
+          required: true
+          type: string
+          example: __GLOBAL-CUSTOMER-ID__
+        - name: service-type
+          in: path
+          description: Value defined by orchestration to identify this service across ECOMP.
+          required: true
+          type: string
+          example: __SERVICE-TYPE__
+        - name: service-instance-id
+          in: path
+          description: Uniquely identifies this instance of a service
+          required: true
+          type: string
+          example: __SERVICE-INSTANCE-ID__
+        - name: id
+          in: path
+          description: Allotted Resource id UUID assigned to this instance.
+          required: true
+          type: string
+          example: __ID__
+        - name: body
+          in: body
+          description: allotted-resource object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/allotted-resource"
     delete:
       tags:
         - Business
@@ -12843,21 +17100,25 @@ paths:
           description: Global customer id used across ECOMP to uniquely identify customer.
           required: true
           type: string
+          example: __GLOBAL-CUSTOMER-ID__
         - name: service-type
           in: path
           description: Value defined by orchestration to identify this service across ECOMP.
           required: true
           type: string
+          example: __SERVICE-TYPE__
         - name: service-instance-id
           in: path
           description: Uniquely identifies this instance of a service
           required: true
           type: string
+          example: __SERVICE-INSTANCE-ID__
         - name: id
           in: path
           description: Allotted Resource id UUID assigned to this instance.
           required: true
           type: string
+          example: __ID__
         - name: resource-version
           in: query
           description: resource-version for concurrency
@@ -12877,7 +17138,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/allotted-resources"
+              $ref: "#/getDefinitions/allotted-resources"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -12886,16 +17147,19 @@ paths:
           description: Global customer id used across ECOMP to uniquely identify customer.
           required: true
           type: string
+          example: __GLOBAL-CUSTOMER-ID__
         - name: service-type
           in: path
           description: Value defined by orchestration to identify this service across ECOMP.
           required: true
           type: string
+          example: __SERVICE-TYPE__
         - name: service-instance-id
           in: path
           description: Uniquely identifies this instance of a service
           required: true
           type: string
+          example: __SERVICE-INSTANCE-ID__
         - name: subscriber-name
           in: query
           description: Subscriber name, an alternate way to retrieve a customer.
@@ -12965,7 +17229,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/service-instance"
+              $ref: "#/getDefinitions/service-instance"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -12974,16 +17238,19 @@ paths:
           description: Global customer id used across ECOMP to uniquely identify customer.
           required: true
           type: string
+          example: __GLOBAL-CUSTOMER-ID__
         - name: service-type
           in: path
           description: Value defined by orchestration to identify this service across ECOMP.
           required: true
           type: string
+          example: __SERVICE-TYPE__
         - name: service-instance-id
           in: path
           description: Uniquely identifies this instance of a service
           required: true
           type: string
+          example: __SERVICE-INSTANCE-ID__
         - name: subscriber-name
           in: query
           description: Subscriber name, an alternate way to retrieve a customer.
@@ -13043,7 +17310,10 @@ paths:
       tags:
         - Business
       summary: create or update an existing service-instance
-      description: create or update an existing service-instance
+      description: |
+        Create or update an existing service-instance.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
       operationId: createOrUpdateBusinessCustomersCustomerServiceSubscriptionsServiceSubscriptionServiceInstancesServiceInstance
       consumes:
         - application/json
@@ -13060,22 +17330,76 @@ paths:
           description: Global customer id used across ECOMP to uniquely identify customer.
           required: true
           type: string
+          example: __GLOBAL-CUSTOMER-ID__
         - name: service-type
           in: path
           description: Value defined by orchestration to identify this service across ECOMP.
           required: true
           type: string
+          example: __SERVICE-TYPE__
         - name: service-instance-id
           in: path
           description: Uniquely identifies this instance of a service
           required: true
           type: string
+          example: __SERVICE-INSTANCE-ID__
         - name: body
           in: body
-          description: service-instance object that needs to be created or updated
+          description: service-instance object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/BusinessCustomersCustomerServiceSubscriptionsServiceSubscriptionServiceInstancesServiceInstance.json)
           required: true
           schema:
             $ref: "#/definitions/service-instance"
+    patch:
+      tags:
+        - Business
+      summary: update an existing service-instance
+      description: |
+        Update an existing service-instance
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateBusinessCustomersCustomerServiceSubscriptionsServiceSubscriptionServiceInstancesServiceInstance
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: global-customer-id
+          in: path
+          description: Global customer id used across ECOMP to uniquely identify customer.
+          required: true
+          type: string
+          example: __GLOBAL-CUSTOMER-ID__
+        - name: service-type
+          in: path
+          description: Value defined by orchestration to identify this service across ECOMP.
+          required: true
+          type: string
+          example: __SERVICE-TYPE__
+        - name: service-instance-id
+          in: path
+          description: Uniquely identifies this instance of a service
+          required: true
+          type: string
+          example: __SERVICE-INSTANCE-ID__
+        - name: body
+          in: body
+          description: service-instance object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/service-instance"
     delete:
       tags:
         - Business
@@ -13097,16 +17421,19 @@ paths:
           description: Global customer id used across ECOMP to uniquely identify customer.
           required: true
           type: string
+          example: __GLOBAL-CUSTOMER-ID__
         - name: service-type
           in: path
           description: Value defined by orchestration to identify this service across ECOMP.
           required: true
           type: string
+          example: __SERVICE-TYPE__
         - name: service-instance-id
           in: path
           description: Uniquely identifies this instance of a service
           required: true
           type: string
+          example: __SERVICE-INSTANCE-ID__
         - name: resource-version
           in: query
           description: resource-version for concurrency
@@ -13126,7 +17453,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/service-instances"
+              $ref: "#/getDefinitions/service-instances"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -13135,11 +17462,13 @@ paths:
           description: Global customer id used across ECOMP to uniquely identify customer.
           required: true
           type: string
+          example: __GLOBAL-CUSTOMER-ID__
         - name: service-type
           in: path
           description: Value defined by orchestration to identify this service across ECOMP.
           required: true
           type: string
+          example: __SERVICE-TYPE__
         - name: subscriber-name
           in: query
           description: Subscriber name, an alternate way to retrieve a customer.
@@ -13171,14 +17500,16 @@ paths:
           description: Global customer id used across ECOMP to uniquely identify customer.
           required: true
           type: string
+          example: __GLOBAL-CUSTOMER-ID__
         - name: service-type
           in: path
           description: Value defined by orchestration to identify this service across ECOMP.
           required: true
           type: string
+          example: __SERVICE-TYPE__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/BusinessCustomersCustomerServiceSubscriptionsServiceSubscription.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -13203,11 +17534,13 @@ paths:
           description: Global customer id used across ECOMP to uniquely identify customer.
           required: true
           type: string
+          example: __GLOBAL-CUSTOMER-ID__
         - name: service-type
           in: path
           description: Value defined by orchestration to identify this service across ECOMP.
           required: true
           type: string
+          example: __SERVICE-TYPE__
   /business/customers/customer/{global-customer-id}/service-subscriptions/service-subscription/{service-type}:
     get:
       tags:
@@ -13222,7 +17555,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/service-subscription"
+              $ref: "#/getDefinitions/service-subscription"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -13231,11 +17564,13 @@ paths:
           description: Global customer id used across ECOMP to uniquely identify customer.
           required: true
           type: string
+          example: __GLOBAL-CUSTOMER-ID__
         - name: service-type
           in: path
           description: Value defined by orchestration to identify this service across ECOMP.
           required: true
           type: string
+          example: __SERVICE-TYPE__
         - name: subscriber-name
           in: query
           description: Subscriber name, an alternate way to retrieve a customer.
@@ -13250,7 +17585,10 @@ paths:
       tags:
         - Business
       summary: create or update an existing service-subscription
-      description: create or update an existing service-subscription
+      description: |
+        Create or update an existing service-subscription.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
       operationId: createOrUpdateBusinessCustomersCustomerServiceSubscriptionsServiceSubscription
       consumes:
         - application/json
@@ -13267,17 +17605,64 @@ paths:
           description: Global customer id used across ECOMP to uniquely identify customer.
           required: true
           type: string
+          example: __GLOBAL-CUSTOMER-ID__
         - name: service-type
           in: path
           description: Value defined by orchestration to identify this service across ECOMP.
           required: true
           type: string
+          example: __SERVICE-TYPE__
         - name: body
           in: body
-          description: service-subscription object that needs to be created or updated
+          description: service-subscription object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/BusinessCustomersCustomerServiceSubscriptionsServiceSubscription.json)
           required: true
           schema:
             $ref: "#/definitions/service-subscription"
+    patch:
+      tags:
+        - Business
+      summary: update an existing service-subscription
+      description: |
+        Update an existing service-subscription
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateBusinessCustomersCustomerServiceSubscriptionsServiceSubscription
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: global-customer-id
+          in: path
+          description: Global customer id used across ECOMP to uniquely identify customer.
+          required: true
+          type: string
+          example: __GLOBAL-CUSTOMER-ID__
+        - name: service-type
+          in: path
+          description: Value defined by orchestration to identify this service across ECOMP.
+          required: true
+          type: string
+          example: __SERVICE-TYPE__
+        - name: body
+          in: body
+          description: service-subscription object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/service-subscription"
     delete:
       tags:
         - Business
@@ -13299,11 +17684,13 @@ paths:
           description: Global customer id used across ECOMP to uniquely identify customer.
           required: true
           type: string
+          example: __GLOBAL-CUSTOMER-ID__
         - name: service-type
           in: path
           description: Value defined by orchestration to identify this service across ECOMP.
           required: true
           type: string
+          example: __SERVICE-TYPE__
         - name: resource-version
           in: query
           description: resource-version for concurrency
@@ -13323,7 +17710,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/service-subscriptions"
+              $ref: "#/getDefinitions/service-subscriptions"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -13332,6 +17719,7 @@ paths:
           description: Global customer id used across ECOMP to uniquely identify customer.
           required: true
           type: string
+          example: __GLOBAL-CUSTOMER-ID__
         - name: subscriber-name
           in: query
           description: Subscriber name, an alternate way to retrieve a customer.
@@ -13363,9 +17751,10 @@ paths:
           description: Global customer id used across ECOMP to uniquely identify customer.
           required: true
           type: string
+          example: __GLOBAL-CUSTOMER-ID__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/BusinessCustomersCustomer.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -13390,6 +17779,7 @@ paths:
           description: Global customer id used across ECOMP to uniquely identify customer.
           required: true
           type: string
+          example: __GLOBAL-CUSTOMER-ID__
   /business/customers/customer/{global-customer-id}:
     get:
       tags:
@@ -13404,7 +17794,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/customer"
+              $ref: "#/getDefinitions/customer"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -13413,6 +17803,7 @@ paths:
           description: Global customer id used across ECOMP to uniquely identify customer.
           required: true
           type: string
+          example: __GLOBAL-CUSTOMER-ID__
         - name: subscriber-name
           in: query
           description: Subscriber name, an alternate way to retrieve a customer.
@@ -13427,7 +17818,10 @@ paths:
       tags:
         - Business
       summary: create or update an existing customer
-      description: create or update an existing customer
+      description: |
+        Create or update an existing customer.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
       operationId: createOrUpdateBusinessCustomersCustomer
       consumes:
         - application/json
@@ -13444,12 +17838,52 @@ paths:
           description: Global customer id used across ECOMP to uniquely identify customer.
           required: true
           type: string
+          example: __GLOBAL-CUSTOMER-ID__
         - name: body
           in: body
-          description: customer object that needs to be created or updated
+          description: customer object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/BusinessCustomersCustomer.json)
           required: true
           schema:
             $ref: "#/definitions/customer"
+    patch:
+      tags:
+        - Business
+      summary: update an existing customer
+      description: |
+        Update an existing customer
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateBusinessCustomersCustomer
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: global-customer-id
+          in: path
+          description: Global customer id used across ECOMP to uniquely identify customer.
+          required: true
+          type: string
+          example: __GLOBAL-CUSTOMER-ID__
+        - name: body
+          in: body
+          description: customer object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/customer"
     delete:
       tags:
         - Business
@@ -13471,6 +17905,7 @@ paths:
           description: Global customer id used across ECOMP to uniquely identify customer.
           required: true
           type: string
+          example: __GLOBAL-CUSTOMER-ID__
         - name: resource-version
           in: query
           description: resource-version for concurrency
@@ -13490,15 +17925,15 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/customers"
+              $ref: "#/getDefinitions/customers"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
-  /service-design-and-creation/vnf-images/vnf-image/{vnf-image-uuid}/relationship-list/relationship:
+  /business/lines-of-business/line-of-business/{line-of-business-name}/relationship-list/relationship:
     put:
       tags:
-        - ServiceDesignAndCreation
+        - Business
       summary: see node definition for valid relationships
-      operationId: createOrUpdateServiceDesignAndCreationVnfImagesVnfImageRelationshipListRelationship
+      operationId: createOrUpdateBusinessLinesOfBusinessLineOfBusinessRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -13509,23 +17944,24 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-image-uuid
+        - name: line-of-business-name
           in: path
-          description: Unique ID of this asset
+          description: Name of the line-of-business (product)
           required: true
           type: string
+          example: __LINE-OF-BUSINESS-NAME__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/BusinessLinesOfBusinessLineOfBusiness.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
     delete:
       tags:
-        - ServiceDesignAndCreation
+        - Business
       summary: delete an existing relationship
       description: delete an existing relationship
-      operationId: deleteServiceDesignAndCreationVnfImagesVnfImageRelationshipListRelationship
+      operationId: deleteBusinessLinesOfBusinessLineOfBusinessRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -13536,18 +17972,19 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-image-uuid
+        - name: line-of-business-name
           in: path
-          description: Unique ID of this asset
+          description: Name of the line-of-business (product)
           required: true
           type: string
-  /service-design-and-creation/vnf-images/vnf-image/{vnf-image-uuid}:
+          example: __LINE-OF-BUSINESS-NAME__
+  /business/lines-of-business/line-of-business/{line-of-business-name}:
     get:
       tags:
-        - ServiceDesignAndCreation
-      summary: returns vnf-image
-      description: returns vnf-image
-      operationId: getServiceDesignAndCreationVnfImagesVnfImage
+        - Business
+      summary: returns line-of-business
+      description: returns line-of-business
+      operationId: getBusinessLinesOfBusinessLineOfBusiness
       produces:
         - application/json
         - application/xml
@@ -13555,36 +17992,25 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/vnf-image"
+              $ref: "#/getDefinitions/line-of-business"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-image-uuid
+        - name: line-of-business-name
           in: path
-          description: Unique ID of this asset
+          description: Name of the line-of-business (product)
           required: true
           type: string
-        - name: application
-          in: query
-          description: The application that the image instantiates.
-          required: false
-          type: string
-        - name: application-vendor
-          in: query
-          description: The vendor of the application.
-          required: false
-          type: string
-        - name: application-version
-          in: query
-          description: The version of the application.
-          required: false
-          type: string
+          example: __LINE-OF-BUSINESS-NAME__
     put:
       tags:
-        - ServiceDesignAndCreation
-      summary: create or update an existing vnf-image
-      description: create or update an existing vnf-image
-      operationId: createOrUpdateServiceDesignAndCreationVnfImagesVnfImage
+        - Business
+      summary: create or update an existing line-of-business
+      description: |
+        Create or update an existing line-of-business.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateBusinessLinesOfBusinessLineOfBusiness
       consumes:
         - application/json
         - application/xml
@@ -13595,23 +18021,63 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-image-uuid
+        - name: line-of-business-name
           in: path
-          description: Unique ID of this asset
+          description: Name of the line-of-business (product)
           required: true
           type: string
+          example: __LINE-OF-BUSINESS-NAME__
         - name: body
           in: body
-          description: vnf-image object that needs to be created or updated
+          description: line-of-business object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/BusinessLinesOfBusinessLineOfBusiness.json)
           required: true
           schema:
-            $ref: "#/definitions/vnf-image"
+            $ref: "#/definitions/line-of-business"
+    patch:
+      tags:
+        - Business
+      summary: update an existing line-of-business
+      description: |
+        Update an existing line-of-business
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateBusinessLinesOfBusinessLineOfBusiness
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: line-of-business-name
+          in: path
+          description: Name of the line-of-business (product)
+          required: true
+          type: string
+          example: __LINE-OF-BUSINESS-NAME__
+        - name: body
+          in: body
+          description: line-of-business object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/line-of-business"
     delete:
       tags:
-        - ServiceDesignAndCreation
-      summary: delete an existing vnf-image
-      description: delete an existing vnf-image
-      operationId: deleteServiceDesignAndCreationVnfImagesVnfImage
+        - Business
+      summary: delete an existing line-of-business
+      description: delete an existing line-of-business
+      operationId: deleteBusinessLinesOfBusinessLineOfBusiness
       consumes:
         - application/json
         - application/xml
@@ -13622,23 +18088,24 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-image-uuid
+        - name: line-of-business-name
           in: path
-          description: Unique ID of this asset
+          description: Name of the line-of-business (product)
           required: true
           type: string
+          example: __LINE-OF-BUSINESS-NAME__
         - name: resource-version
           in: query
           description: resource-version for concurrency
           required: true
           type: string
-  /service-design-and-creation/vnf-images:
+  /business/lines-of-business:
     get:
       tags:
-        - ServiceDesignAndCreation
-      summary: returns vnf-images
-      description: returns vnf-images
-      operationId: getServiceDesignAndCreationVnfImages
+        - Business
+      summary: returns lines-of-business
+      description: returns lines-of-business
+      operationId: getBusinessLinesOfBusiness
       produces:
         - application/json
         - application/xml
@@ -13646,15 +18113,15 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/vnf-images"
+              $ref: "#/getDefinitions/lines-of-business"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
-  /service-design-and-creation/services/service/{service-id}/relationship-list/relationship:
+  /business/owning-entities/owning-entity/{owning-entity-id}/relationship-list/relationship:
     put:
       tags:
-        - ServiceDesignAndCreation
+        - Business
       summary: see node definition for valid relationships
-      operationId: createOrUpdateServiceDesignAndCreationServicesServiceRelationshipListRelationship
+      operationId: createOrUpdateBusinessOwningEntitiesOwningEntityRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -13665,23 +18132,24 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: service-id
+        - name: owning-entity-id
           in: path
-          description: This gets defined by others to provide a unique ID for the service, we accept what is sent.
+          description: UUID of an owning entity
           required: true
           type: string
+          example: __OWNING-ENTITY-ID__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/BusinessOwningEntitiesOwningEntity.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
     delete:
       tags:
-        - ServiceDesignAndCreation
+        - Business
       summary: delete an existing relationship
       description: delete an existing relationship
-      operationId: deleteServiceDesignAndCreationServicesServiceRelationshipListRelationship
+      operationId: deleteBusinessOwningEntitiesOwningEntityRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -13692,18 +18160,19 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: service-id
+        - name: owning-entity-id
           in: path
-          description: This gets defined by others to provide a unique ID for the service, we accept what is sent.
+          description: UUID of an owning entity
           required: true
           type: string
-  /service-design-and-creation/services/service/{service-id}:
+          example: __OWNING-ENTITY-ID__
+  /business/owning-entities/owning-entity/{owning-entity-id}:
     get:
       tags:
-        - ServiceDesignAndCreation
-      summary: returns service
-      description: returns service
-      operationId: getServiceDesignAndCreationServicesService
+        - Business
+      summary: returns owning-entity
+      description: returns owning-entity
+      operationId: getBusinessOwningEntitiesOwningEntity
       produces:
         - application/json
         - application/xml
@@ -13711,26 +18180,25 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/service"
+              $ref: "#/getDefinitions/owning-entity"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: service-id
+        - name: owning-entity-id
           in: path
-          description: This gets defined by others to provide a unique ID for the service, we accept what is sent.
+          description: UUID of an owning entity
           required: true
           type: string
-        - name: service-description
-          in: query
-          description: Description of the service
-          required: false
-          type: string
+          example: __OWNING-ENTITY-ID__
     put:
       tags:
-        - ServiceDesignAndCreation
-      summary: create or update an existing service
-      description: create or update an existing service
-      operationId: createOrUpdateServiceDesignAndCreationServicesService
+        - Business
+      summary: create or update an existing owning-entity
+      description: |
+        Create or update an existing owning-entity.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateBusinessOwningEntitiesOwningEntity
       consumes:
         - application/json
         - application/xml
@@ -13741,23 +18209,63 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: service-id
+        - name: owning-entity-id
           in: path
-          description: This gets defined by others to provide a unique ID for the service, we accept what is sent.
+          description: UUID of an owning entity
           required: true
           type: string
+          example: __OWNING-ENTITY-ID__
         - name: body
           in: body
-          description: service object that needs to be created or updated
+          description: owning-entity object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/BusinessOwningEntitiesOwningEntity.json)
           required: true
           schema:
-            $ref: "#/definitions/service"
+            $ref: "#/definitions/owning-entity"
+    patch:
+      tags:
+        - Business
+      summary: update an existing owning-entity
+      description: |
+        Update an existing owning-entity
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateBusinessOwningEntitiesOwningEntity
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: owning-entity-id
+          in: path
+          description: UUID of an owning entity
+          required: true
+          type: string
+          example: __OWNING-ENTITY-ID__
+        - name: body
+          in: body
+          description: owning-entity object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/owning-entity"
     delete:
       tags:
-        - ServiceDesignAndCreation
-      summary: delete an existing service
-      description: delete an existing service
-      operationId: deleteServiceDesignAndCreationServicesService
+        - Business
+      summary: delete an existing owning-entity
+      description: delete an existing owning-entity
+      operationId: deleteBusinessOwningEntitiesOwningEntity
       consumes:
         - application/json
         - application/xml
@@ -13768,23 +18276,24 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: service-id
+        - name: owning-entity-id
           in: path
-          description: This gets defined by others to provide a unique ID for the service, we accept what is sent.
+          description: UUID of an owning entity
           required: true
           type: string
+          example: __OWNING-ENTITY-ID__
         - name: resource-version
           in: query
           description: resource-version for concurrency
           required: true
           type: string
-  /service-design-and-creation/services:
+  /business/owning-entities:
     get:
       tags:
-        - ServiceDesignAndCreation
-      summary: returns services
-      description: returns services
-      operationId: getServiceDesignAndCreationServices
+        - Business
+      summary: returns owning-entities
+      description: returns owning-entities
+      operationId: getBusinessOwningEntities
       produces:
         - application/json
         - application/xml
@@ -13792,15 +18301,15 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/services"
+              $ref: "#/getDefinitions/owning-entities"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
-  /service-design-and-creation/service-capabilities/service-capability/{service-type}/{vnf-type}/relationship-list/relationship:
+  /business/platforms/platform/{platform-name}/relationship-list/relationship:
     put:
       tags:
-        - ServiceDesignAndCreation
+        - Business
       summary: see node definition for valid relationships
-      operationId: createOrUpdateServiceDesignAndCreationServiceCapabilitiesServiceCapabilityRelationshipListRelationship
+      operationId: createOrUpdateBusinessPlatformsPlatformRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -13811,28 +18320,24 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: service-type
-          in: path
-          description: This gets defined by others to provide a unique ID for the service, we accept what is sent.
-          required: true
-          type: string
-        - name: vnf-type
+        - name: platform-name
           in: path
-          description: String capturing type of vnf, that was intended to identify the ASDC resource.  This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures.
+          description: Name of the platform
           required: true
           type: string
+          example: __PLATFORM-NAME__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/BusinessPlatformsPlatform.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
     delete:
       tags:
-        - ServiceDesignAndCreation
+        - Business
       summary: delete an existing relationship
       description: delete an existing relationship
-      operationId: deleteServiceDesignAndCreationServiceCapabilitiesServiceCapabilityRelationshipListRelationship
+      operationId: deleteBusinessPlatformsPlatformRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -13843,23 +18348,19 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: service-type
-          in: path
-          description: This gets defined by others to provide a unique ID for the service, we accept what is sent.
-          required: true
-          type: string
-        - name: vnf-type
+        - name: platform-name
           in: path
-          description: String capturing type of vnf, that was intended to identify the ASDC resource.  This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures.
+          description: Name of the platform
           required: true
           type: string
-  /service-design-and-creation/service-capabilities/service-capability/{service-type}/{vnf-type}:
+          example: __PLATFORM-NAME__
+  /business/platforms/platform/{platform-name}:
     get:
       tags:
-        - ServiceDesignAndCreation
-      summary: returns service-capability
-      description: returns service-capability
-      operationId: getServiceDesignAndCreationServiceCapabilitiesServiceCapability
+        - Business
+      summary: returns platform
+      description: returns platform
+      operationId: getBusinessPlatformsPlatform
       produces:
         - application/json
         - application/xml
@@ -13867,26 +18368,25 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/service-capability"
+              $ref: "#/getDefinitions/platform"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: service-type
-          in: path
-          description: This gets defined by others to provide a unique ID for the service, we accept what is sent.
-          required: true
-          type: string
-        - name: vnf-type
+        - name: platform-name
           in: path
-          description: String capturing type of vnf, that was intended to identify the ASDC resource.  This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures.
+          description: Name of the platform
           required: true
           type: string
+          example: __PLATFORM-NAME__
     put:
       tags:
-        - ServiceDesignAndCreation
-      summary: create or update an existing service-capability
-      description: create or update an existing service-capability
-      operationId: createOrUpdateServiceDesignAndCreationServiceCapabilitiesServiceCapability
+        - Business
+      summary: create or update an existing platform
+      description: |
+        Create or update an existing platform.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateBusinessPlatformsPlatform
       consumes:
         - application/json
         - application/xml
@@ -13897,28 +18397,63 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: service-type
+        - name: platform-name
           in: path
-          description: This gets defined by others to provide a unique ID for the service, we accept what is sent.
+          description: Name of the platform
           required: true
           type: string
-        - name: vnf-type
+          example: __PLATFORM-NAME__
+        - name: body
+          in: body
+          description: platform object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/BusinessPlatformsPlatform.json)
+          required: true
+          schema:
+            $ref: "#/definitions/platform"
+    patch:
+      tags:
+        - Business
+      summary: update an existing platform
+      description: |
+        Update an existing platform
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateBusinessPlatformsPlatform
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: platform-name
           in: path
-          description: String capturing type of vnf, that was intended to identify the ASDC resource.  This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures.
+          description: Name of the platform
           required: true
           type: string
+          example: __PLATFORM-NAME__
         - name: body
           in: body
-          description: service-capability object that needs to be created or updated
+          description: platform object that needs to be created or updated. 
           required: true
           schema:
-            $ref: "#/definitions/service-capability"
+            $ref: "#/patchDefinitions/platform"
     delete:
       tags:
-        - ServiceDesignAndCreation
-      summary: delete an existing service-capability
-      description: delete an existing service-capability
-      operationId: deleteServiceDesignAndCreationServiceCapabilitiesServiceCapability
+        - Business
+      summary: delete an existing platform
+      description: delete an existing platform
+      operationId: deleteBusinessPlatformsPlatform
       consumes:
         - application/json
         - application/xml
@@ -13929,28 +18464,24 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: service-type
+        - name: platform-name
           in: path
-          description: This gets defined by others to provide a unique ID for the service, we accept what is sent.
-          required: true
-          type: string
-        - name: vnf-type
-          in: path
-          description: String capturing type of vnf, that was intended to identify the ASDC resource.  This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures.
+          description: Name of the platform
           required: true
           type: string
+          example: __PLATFORM-NAME__
         - name: resource-version
           in: query
           description: resource-version for concurrency
           required: true
           type: string
-  /service-design-and-creation/service-capabilities:
+  /business/platforms:
     get:
       tags:
-        - ServiceDesignAndCreation
-      summary: returns service-capabilities
-      description: returns service-capabilities
-      operationId: getServiceDesignAndCreationServiceCapabilities
+        - Business
+      summary: returns platforms
+      description: returns platforms
+      operationId: getBusinessPlatforms
       produces:
         - application/json
         - application/xml
@@ -13958,15 +18489,15 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/service-capabilities"
+              $ref: "#/getDefinitions/platforms"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
-  /service-design-and-creation/models/model/{model-invariant-id}/model-vers/model-ver/{model-version-id}/model-elements/model-element/{model-element-uuid}/model-constraints/model-constraint/{model-constraint-uuid}/constrained-element-sets/constrained-element-set/{constrained-element-set-uuid}/element-choice-sets/element-choice-set/{element-choice-set-uuid}/relationship-list/relationship:
+  /business/projects/project/{project-name}/relationship-list/relationship:
     put:
       tags:
-        - ServiceDesignAndCreation
+        - Business
       summary: see node definition for valid relationships
-      operationId: createOrUpdateServiceDesignAndCreationModelsModelModelVersModelVerModelElementsModelElementModelConstraintsModelConstraintConstrainedElementSetsConstrainedElementSetElementChoiceSetsElementChoiceSetRelationshipListRelationship
+      operationId: createOrUpdateBusinessProjectsProjectRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -13977,44 +18508,24 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: model-invariant-id
-          in: path
-          description: Unique identifier corresponding to the main definition of a model in ASDC
-          required: true
-          type: string
-        - name: model-version-id
-          in: path
-          description: Unique identifier corresponding to one version of a model in ASDC
-          required: true
-          type: string
-        - name: model-element-uuid
-          in: path
-          required: true
-          type: string
-        - name: model-constraint-uuid
-          in: path
-          required: true
-          type: string
-        - name: constrained-element-set-uuid
-          in: path
-          required: true
-          type: string
-        - name: element-choice-set-uuid
+        - name: project-name
           in: path
+          description: Name of the project deploying a service
           required: true
           type: string
+          example: __PROJECT-NAME__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/BusinessProjectsProject.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
     delete:
       tags:
-        - ServiceDesignAndCreation
+        - Business
       summary: delete an existing relationship
       description: delete an existing relationship
-      operationId: deleteServiceDesignAndCreationModelsModelModelVersModelVerModelElementsModelElementModelConstraintsModelConstraintConstrainedElementSetsConstrainedElementSetElementChoiceSetsElementChoiceSetRelationshipListRelationship
+      operationId: deleteBusinessProjectsProjectRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -14025,39 +18536,19 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: model-invariant-id
-          in: path
-          description: Unique identifier corresponding to the main definition of a model in ASDC
-          required: true
-          type: string
-        - name: model-version-id
-          in: path
-          description: Unique identifier corresponding to one version of a model in ASDC
-          required: true
-          type: string
-        - name: model-element-uuid
-          in: path
-          required: true
-          type: string
-        - name: model-constraint-uuid
-          in: path
-          required: true
-          type: string
-        - name: constrained-element-set-uuid
-          in: path
-          required: true
-          type: string
-        - name: element-choice-set-uuid
+        - name: project-name
           in: path
+          description: Name of the project deploying a service
           required: true
           type: string
-  /service-design-and-creation/models/model/{model-invariant-id}/model-vers/model-ver/{model-version-id}/model-elements/model-element/{model-element-uuid}/model-constraints/model-constraint/{model-constraint-uuid}/constrained-element-sets/constrained-element-set/{constrained-element-set-uuid}/element-choice-sets/element-choice-set/{element-choice-set-uuid}:
+          example: __PROJECT-NAME__
+  /business/projects/project/{project-name}:
     get:
       tags:
-        - ServiceDesignAndCreation
-      summary: returns element-choice-set
-      description: returns element-choice-set
-      operationId: getServiceDesignAndCreationModelsModelModelVersModelVerModelElementsModelElementModelConstraintsModelConstraintConstrainedElementSetsConstrainedElementSetElementChoiceSetsElementChoiceSet
+        - Business
+      summary: returns project
+      description: returns project
+      operationId: getBusinessProjectsProject
       produces:
         - application/json
         - application/xml
@@ -14065,57 +18556,25 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/element-choice-set"
+              $ref: "#/getDefinitions/project"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: model-invariant-id
-          in: path
-          description: Unique identifier corresponding to the main definition of a model in ASDC
-          required: true
-          type: string
-        - name: model-version-id
-          in: path
-          description: Unique identifier corresponding to one version of a model in ASDC
-          required: true
-          type: string
-        - name: model-element-uuid
-          in: path
-          required: true
-          type: string
-        - name: model-constraint-uuid
-          in: path
-          required: true
-          type: string
-        - name: constrained-element-set-uuid
-          in: path
-          required: true
-          type: string
-        - name: element-choice-set-uuid
+        - name: project-name
           in: path
+          description: Name of the project deploying a service
           required: true
           type: string
-        - name: model-type
-          in: query
-          description: Type of the model, e.g., service, resource, widget, etc.
-          required: false
-          type: string
-        - name: model-name
-          in: query
-          description: Name of the model, which can change from version to version.
-          required: false
-          type: string
-        - name: model-version
-          in: query
-          description: Version
-          required: false
-          type: string
+          example: __PROJECT-NAME__
     put:
       tags:
-        - ServiceDesignAndCreation
-      summary: create or update an existing element-choice-set
-      description: create or update an existing element-choice-set
-      operationId: createOrUpdateServiceDesignAndCreationModelsModelModelVersModelVerModelElementsModelElementModelConstraintsModelConstraintConstrainedElementSetsConstrainedElementSetElementChoiceSetsElementChoiceSet
+        - Business
+      summary: create or update an existing project
+      description: |
+        Create or update an existing project.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateBusinessProjectsProject
       consumes:
         - application/json
         - application/xml
@@ -14126,44 +18585,63 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: model-invariant-id
-          in: path
-          description: Unique identifier corresponding to the main definition of a model in ASDC
-          required: true
-          type: string
-        - name: model-version-id
-          in: path
-          description: Unique identifier corresponding to one version of a model in ASDC
-          required: true
-          type: string
-        - name: model-element-uuid
-          in: path
-          required: true
-          type: string
-        - name: model-constraint-uuid
+        - name: project-name
           in: path
+          description: Name of the project deploying a service
           required: true
           type: string
-        - name: constrained-element-set-uuid
-          in: path
+          example: __PROJECT-NAME__
+        - name: body
+          in: body
+          description: project object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/BusinessProjectsProject.json)
           required: true
-          type: string
-        - name: element-choice-set-uuid
+          schema:
+            $ref: "#/definitions/project"
+    patch:
+      tags:
+        - Business
+      summary: update an existing project
+      description: |
+        Update an existing project
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateBusinessProjectsProject
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: project-name
           in: path
+          description: Name of the project deploying a service
           required: true
           type: string
+          example: __PROJECT-NAME__
         - name: body
           in: body
-          description: element-choice-set object that needs to be created or updated
+          description: project object that needs to be created or updated. 
           required: true
           schema:
-            $ref: "#/definitions/element-choice-set"
+            $ref: "#/patchDefinitions/project"
     delete:
       tags:
-        - ServiceDesignAndCreation
-      summary: delete an existing element-choice-set
-      description: delete an existing element-choice-set
-      operationId: deleteServiceDesignAndCreationModelsModelModelVersModelVerModelElementsModelElementModelConstraintsModelConstraintConstrainedElementSetsConstrainedElementSetElementChoiceSetsElementChoiceSet
+        - Business
+      summary: delete an existing project
+      description: delete an existing project
+      operationId: deleteBusinessProjectsProject
       consumes:
         - application/json
         - application/xml
@@ -14174,44 +18652,24 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: model-invariant-id
-          in: path
-          description: Unique identifier corresponding to the main definition of a model in ASDC
-          required: true
-          type: string
-        - name: model-version-id
-          in: path
-          description: Unique identifier corresponding to one version of a model in ASDC
-          required: true
-          type: string
-        - name: model-element-uuid
-          in: path
-          required: true
-          type: string
-        - name: model-constraint-uuid
-          in: path
-          required: true
-          type: string
-        - name: constrained-element-set-uuid
-          in: path
-          required: true
-          type: string
-        - name: element-choice-set-uuid
+        - name: project-name
           in: path
+          description: Name of the project deploying a service
           required: true
           type: string
+          example: __PROJECT-NAME__
         - name: resource-version
           in: query
           description: resource-version for concurrency
           required: true
           type: string
-  /service-design-and-creation/models/model/{model-invariant-id}/model-vers/model-ver/{model-version-id}/model-elements/model-element/{model-element-uuid}/model-constraints/model-constraint/{model-constraint-uuid}/constrained-element-sets/constrained-element-set/{constrained-element-set-uuid}/element-choice-sets:
+  /business/projects:
     get:
       tags:
-        - ServiceDesignAndCreation
-      summary: returns element-choice-sets
-      description: returns element-choice-sets
-      operationId: getServiceDesignAndCreationModelsModelModelVersModelVerModelElementsModelElementModelConstraintsModelConstraintConstrainedElementSetsConstrainedElementSetElementChoiceSets
+        - Business
+      summary: returns projects
+      description: returns projects
+      operationId: getBusinessProjects
       produces:
         - application/json
         - application/xml
@@ -14219,53 +18677,15 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/element-choice-sets"
+              $ref: "#/getDefinitions/projects"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
-      parameters:
-        - name: model-invariant-id
-          in: path
-          description: Unique identifier corresponding to the main definition of a model in ASDC
-          required: true
-          type: string
-        - name: model-version-id
-          in: path
-          description: Unique identifier corresponding to one version of a model in ASDC
-          required: true
-          type: string
-        - name: model-element-uuid
-          in: path
-          required: true
-          type: string
-        - name: model-constraint-uuid
-          in: path
-          required: true
-          type: string
-        - name: constrained-element-set-uuid
-          in: path
-          required: true
-          type: string
-        - name: model-type
-          in: query
-          description: Type of the model, e.g., service, resource, widget, etc.
-          required: false
-          type: string
-        - name: model-name
-          in: query
-          description: Name of the model, which can change from version to version.
-          required: false
-          type: string
-        - name: model-version
-          in: query
-          description: Version
-          required: false
-          type: string
-  /service-design-and-creation/models/model/{model-invariant-id}/model-vers/model-ver/{model-version-id}/model-elements/model-element/{model-element-uuid}/model-constraints/model-constraint/{model-constraint-uuid}/constrained-element-sets/constrained-element-set/{constrained-element-set-uuid}/relationship-list/relationship:
+  /service-design-and-creation/vnf-images/vnf-image/{vnf-image-uuid}/relationship-list/relationship:
     put:
       tags:
         - ServiceDesignAndCreation
       summary: see node definition for valid relationships
-      operationId: createOrUpdateServiceDesignAndCreationModelsModelModelVersModelVerModelElementsModelElementModelConstraintsModelConstraintConstrainedElementSetsConstrainedElementSetRelationshipListRelationship
+      operationId: createOrUpdateServiceDesignAndCreationVnfImagesVnfImageRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -14276,31 +18696,15 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: model-invariant-id
-          in: path
-          description: Unique identifier corresponding to the main definition of a model in ASDC
-          required: true
-          type: string
-        - name: model-version-id
-          in: path
-          description: Unique identifier corresponding to one version of a model in ASDC
-          required: true
-          type: string
-        - name: model-element-uuid
-          in: path
-          required: true
-          type: string
-        - name: model-constraint-uuid
-          in: path
-          required: true
-          type: string
-        - name: constrained-element-set-uuid
+        - name: vnf-image-uuid
           in: path
+          description: Unique ID of this asset
           required: true
           type: string
+          example: __VNF-IMAGE-UUID__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/ServiceDesignAndCreationVnfImagesVnfImage.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -14309,7 +18713,7 @@ paths:
         - ServiceDesignAndCreation
       summary: delete an existing relationship
       description: delete an existing relationship
-      operationId: deleteServiceDesignAndCreationModelsModelModelVersModelVerModelElementsModelElementModelConstraintsModelConstraintConstrainedElementSetsConstrainedElementSetRelationshipListRelationship
+      operationId: deleteServiceDesignAndCreationVnfImagesVnfImageRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -14320,35 +18724,19 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: model-invariant-id
-          in: path
-          description: Unique identifier corresponding to the main definition of a model in ASDC
-          required: true
-          type: string
-        - name: model-version-id
-          in: path
-          description: Unique identifier corresponding to one version of a model in ASDC
-          required: true
-          type: string
-        - name: model-element-uuid
-          in: path
-          required: true
-          type: string
-        - name: model-constraint-uuid
+        - name: vnf-image-uuid
           in: path
+          description: Unique ID of this asset
           required: true
           type: string
-        - name: constrained-element-set-uuid
-          in: path
-          required: true
-          type: string
-  /service-design-and-creation/models/model/{model-invariant-id}/model-vers/model-ver/{model-version-id}/model-elements/model-element/{model-element-uuid}/model-constraints/model-constraint/{model-constraint-uuid}/constrained-element-sets/constrained-element-set/{constrained-element-set-uuid}:
+          example: __VNF-IMAGE-UUID__
+  /service-design-and-creation/vnf-images/vnf-image/{vnf-image-uuid}:
     get:
       tags:
         - ServiceDesignAndCreation
-      summary: returns constrained-element-set
-      description: returns constrained-element-set
-      operationId: getServiceDesignAndCreationModelsModelModelVersModelVerModelElementsModelElementModelConstraintsModelConstraintConstrainedElementSetsConstrainedElementSet
+      summary: returns vnf-image
+      description: returns vnf-image
+      operationId: getServiceDesignAndCreationVnfImagesVnfImage
       produces:
         - application/json
         - application/xml
@@ -14356,53 +18744,40 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/constrained-element-set"
+              $ref: "#/getDefinitions/vnf-image"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: model-invariant-id
-          in: path
-          description: Unique identifier corresponding to the main definition of a model in ASDC
-          required: true
-          type: string
-        - name: model-version-id
-          in: path
-          description: Unique identifier corresponding to one version of a model in ASDC
-          required: true
-          type: string
-        - name: model-element-uuid
-          in: path
-          required: true
-          type: string
-        - name: model-constraint-uuid
-          in: path
-          required: true
-          type: string
-        - name: constrained-element-set-uuid
+        - name: vnf-image-uuid
           in: path
+          description: Unique ID of this asset
           required: true
           type: string
-        - name: model-type
+          example: __VNF-IMAGE-UUID__
+        - name: application
           in: query
-          description: Type of the model, e.g., service, resource, widget, etc.
+          description: The application that the image instantiates.
           required: false
           type: string
-        - name: model-name
+        - name: application-vendor
           in: query
-          description: Name of the model, which can change from version to version.
+          description: The vendor of the application.
           required: false
           type: string
-        - name: model-version
+        - name: application-version
           in: query
-          description: Version
+          description: The version of the application.
           required: false
           type: string
     put:
       tags:
         - ServiceDesignAndCreation
-      summary: create or update an existing constrained-element-set
-      description: create or update an existing constrained-element-set
-      operationId: createOrUpdateServiceDesignAndCreationModelsModelModelVersModelVerModelElementsModelElementModelConstraintsModelConstraintConstrainedElementSetsConstrainedElementSet
+      summary: create or update an existing vnf-image
+      description: |
+        Create or update an existing vnf-image.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateServiceDesignAndCreationVnfImagesVnfImage
       consumes:
         - application/json
         - application/xml
@@ -14413,40 +18788,135 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: model-invariant-id
+        - name: vnf-image-uuid
           in: path
-          description: Unique identifier corresponding to the main definition of a model in ASDC
+          description: Unique ID of this asset
           required: true
           type: string
-        - name: model-version-id
+          example: __VNF-IMAGE-UUID__
+        - name: body
+          in: body
+          description: vnf-image object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/ServiceDesignAndCreationVnfImagesVnfImage.json)
+          required: true
+          schema:
+            $ref: "#/definitions/vnf-image"
+    patch:
+      tags:
+        - ServiceDesignAndCreation
+      summary: update an existing vnf-image
+      description: |
+        Update an existing vnf-image
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateServiceDesignAndCreationVnfImagesVnfImage
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: vnf-image-uuid
           in: path
-          description: Unique identifier corresponding to one version of a model in ASDC
+          description: Unique ID of this asset
           required: true
           type: string
-        - name: model-element-uuid
+          example: __VNF-IMAGE-UUID__
+        - name: body
+          in: body
+          description: vnf-image object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/vnf-image"
+    delete:
+      tags:
+        - ServiceDesignAndCreation
+      summary: delete an existing vnf-image
+      description: delete an existing vnf-image
+      operationId: deleteServiceDesignAndCreationVnfImagesVnfImage
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: vnf-image-uuid
           in: path
+          description: Unique ID of this asset
           required: true
           type: string
-        - name: model-constraint-uuid
-          in: path
+          example: __VNF-IMAGE-UUID__
+        - name: resource-version
+          in: query
+          description: resource-version for concurrency
           required: true
           type: string
-        - name: constrained-element-set-uuid
+  /service-design-and-creation/vnf-images:
+    get:
+      tags:
+        - ServiceDesignAndCreation
+      summary: returns vnf-images
+      description: returns vnf-images
+      operationId: getServiceDesignAndCreationVnfImages
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "200":
+          description: successful operation
+          schema:
+              $ref: "#/getDefinitions/vnf-images"
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+  /service-design-and-creation/services/service/{service-id}/relationship-list/relationship:
+    put:
+      tags:
+        - ServiceDesignAndCreation
+      summary: see node definition for valid relationships
+      operationId: createOrUpdateServiceDesignAndCreationServicesServiceRelationshipListRelationship
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: service-id
           in: path
+          description: This gets defined by others to provide a unique ID for the service, we accept what is sent.
           required: true
           type: string
+          example: __SERVICE-ID__
         - name: body
           in: body
-          description: constrained-element-set object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/ServiceDesignAndCreationServicesService.json)
           required: true
           schema:
-            $ref: "#/definitions/constrained-element-set"
+            $ref: "#/definitions/relationship"
     delete:
       tags:
         - ServiceDesignAndCreation
-      summary: delete an existing constrained-element-set
-      description: delete an existing constrained-element-set
-      operationId: deleteServiceDesignAndCreationModelsModelModelVersModelVerModelElementsModelElementModelConstraintsModelConstraintConstrainedElementSetsConstrainedElementSet
+      summary: delete an existing relationship
+      description: delete an existing relationship
+      operationId: deleteServiceDesignAndCreationServicesServiceRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -14457,40 +18927,145 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: model-invariant-id
+        - name: service-id
           in: path
-          description: Unique identifier corresponding to the main definition of a model in ASDC
+          description: This gets defined by others to provide a unique ID for the service, we accept what is sent.
           required: true
           type: string
-        - name: model-version-id
+          example: __SERVICE-ID__
+  /service-design-and-creation/services/service/{service-id}:
+    get:
+      tags:
+        - ServiceDesignAndCreation
+      summary: returns service
+      description: returns service
+      operationId: getServiceDesignAndCreationServicesService
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "200":
+          description: successful operation
+          schema:
+              $ref: "#/getDefinitions/service"
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: service-id
           in: path
-          description: Unique identifier corresponding to one version of a model in ASDC
+          description: This gets defined by others to provide a unique ID for the service, we accept what is sent.
           required: true
           type: string
-        - name: model-element-uuid
+          example: __SERVICE-ID__
+        - name: service-description
+          in: query
+          description: Description of the service
+          required: false
+          type: string
+    put:
+      tags:
+        - ServiceDesignAndCreation
+      summary: create or update an existing service
+      description: |
+        Create or update an existing service.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateServiceDesignAndCreationServicesService
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: service-id
           in: path
+          description: This gets defined by others to provide a unique ID for the service, we accept what is sent.
           required: true
           type: string
-        - name: model-constraint-uuid
+          example: __SERVICE-ID__
+        - name: body
+          in: body
+          description: service object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/ServiceDesignAndCreationServicesService.json)
+          required: true
+          schema:
+            $ref: "#/definitions/service"
+    patch:
+      tags:
+        - ServiceDesignAndCreation
+      summary: update an existing service
+      description: |
+        Update an existing service
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateServiceDesignAndCreationServicesService
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: service-id
           in: path
+          description: This gets defined by others to provide a unique ID for the service, we accept what is sent.
           required: true
           type: string
-        - name: constrained-element-set-uuid
+          example: __SERVICE-ID__
+        - name: body
+          in: body
+          description: service object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/service"
+    delete:
+      tags:
+        - ServiceDesignAndCreation
+      summary: delete an existing service
+      description: delete an existing service
+      operationId: deleteServiceDesignAndCreationServicesService
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: service-id
           in: path
+          description: This gets defined by others to provide a unique ID for the service, we accept what is sent.
           required: true
           type: string
+          example: __SERVICE-ID__
         - name: resource-version
           in: query
           description: resource-version for concurrency
           required: true
           type: string
-  /service-design-and-creation/models/model/{model-invariant-id}/model-vers/model-ver/{model-version-id}/model-elements/model-element/{model-element-uuid}/model-constraints/model-constraint/{model-constraint-uuid}/constrained-element-sets:
+  /service-design-and-creation/services:
     get:
       tags:
         - ServiceDesignAndCreation
-      summary: returns constrained-element-sets
-      description: returns constrained-element-sets
-      operationId: getServiceDesignAndCreationModelsModelModelVersModelVerModelElementsModelElementModelConstraintsModelConstraintConstrainedElementSets
+      summary: returns services
+      description: returns services
+      operationId: getServiceDesignAndCreationServices
       produces:
         - application/json
         - application/xml
@@ -14498,50 +19073,78 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/constrained-element-sets"
+              $ref: "#/getDefinitions/services"
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+  /service-design-and-creation/service-capabilities/service-capability/{service-type}/{vnf-type}/relationship-list/relationship:
+    put:
+      tags:
+        - ServiceDesignAndCreation
+      summary: see node definition for valid relationships
+      operationId: createOrUpdateServiceDesignAndCreationServiceCapabilitiesServiceCapabilityRelationshipListRelationship
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: model-invariant-id
+        - name: service-type
           in: path
-          description: Unique identifier corresponding to the main definition of a model in ASDC
+          description: This gets defined by others to provide a unique ID for the service, we accept what is sent.
           required: true
           type: string
-        - name: model-version-id
+          example: __SERVICE-TYPE__
+        - name: vnf-type
           in: path
-          description: Unique identifier corresponding to one version of a model in ASDC
+          description: String capturing type of vnf, that was intended to identify the ASDC resource.  This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures.
           required: true
           type: string
-        - name: model-element-uuid
+          example: __VNF-TYPE__
+        - name: body
+          in: body
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/ServiceDesignAndCreationServiceCapabilitiesServiceCapability.json)
+          required: true
+          schema:
+            $ref: "#/definitions/relationship"
+    delete:
+      tags:
+        - ServiceDesignAndCreation
+      summary: delete an existing relationship
+      description: delete an existing relationship
+      operationId: deleteServiceDesignAndCreationServiceCapabilitiesServiceCapabilityRelationshipListRelationship
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: service-type
           in: path
+          description: This gets defined by others to provide a unique ID for the service, we accept what is sent.
           required: true
           type: string
-        - name: model-constraint-uuid
+          example: __SERVICE-TYPE__
+        - name: vnf-type
           in: path
+          description: String capturing type of vnf, that was intended to identify the ASDC resource.  This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures.
           required: true
           type: string
-        - name: model-type
-          in: query
-          description: Type of the model, e.g., service, resource, widget, etc.
-          required: false
-          type: string
-        - name: model-name
-          in: query
-          description: Name of the model, which can change from version to version.
-          required: false
-          type: string
-        - name: model-version
-          in: query
-          description: Version
-          required: false
-          type: string
-  /service-design-and-creation/models/model/{model-invariant-id}/model-vers/model-ver/{model-version-id}/model-elements/model-element/{model-element-uuid}/model-constraints/model-constraint/{model-constraint-uuid}:
+          example: __VNF-TYPE__
+  /service-design-and-creation/service-capabilities/service-capability/{service-type}/{vnf-type}:
     get:
       tags:
         - ServiceDesignAndCreation
-      summary: returns model-constraint
-      description: returns model-constraint
-      operationId: getServiceDesignAndCreationModelsModelModelVersModelVerModelElementsModelElementModelConstraintsModelConstraint
+      summary: returns service-capability
+      description: returns service-capability
+      operationId: getServiceDesignAndCreationServiceCapabilitiesServiceCapability
       produces:
         - application/json
         - application/xml
@@ -14549,49 +19152,31 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/model-constraint"
+              $ref: "#/getDefinitions/service-capability"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: model-invariant-id
-          in: path
-          description: Unique identifier corresponding to the main definition of a model in ASDC
-          required: true
-          type: string
-        - name: model-version-id
-          in: path
-          description: Unique identifier corresponding to one version of a model in ASDC
-          required: true
-          type: string
-        - name: model-element-uuid
+        - name: service-type
           in: path
+          description: This gets defined by others to provide a unique ID for the service, we accept what is sent.
           required: true
           type: string
-        - name: model-constraint-uuid
+          example: __SERVICE-TYPE__
+        - name: vnf-type
           in: path
+          description: String capturing type of vnf, that was intended to identify the ASDC resource.  This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures.
           required: true
           type: string
-        - name: model-type
-          in: query
-          description: Type of the model, e.g., service, resource, widget, etc.
-          required: false
-          type: string
-        - name: model-name
-          in: query
-          description: Name of the model, which can change from version to version.
-          required: false
-          type: string
-        - name: model-version
-          in: query
-          description: Version
-          required: false
-          type: string
+          example: __VNF-TYPE__
     put:
       tags:
         - ServiceDesignAndCreation
-      summary: create or update an existing model-constraint
-      description: create or update an existing model-constraint
-      operationId: createOrUpdateServiceDesignAndCreationModelsModelModelVersModelVerModelElementsModelElementModelConstraintsModelConstraint
+      summary: create or update an existing service-capability
+      description: |
+        Create or update an existing service-capability.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateServiceDesignAndCreationServiceCapabilitiesServiceCapability
       consumes:
         - application/json
         - application/xml
@@ -14602,36 +19187,75 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: model-invariant-id
+        - name: service-type
           in: path
-          description: Unique identifier corresponding to the main definition of a model in ASDC
+          description: This gets defined by others to provide a unique ID for the service, we accept what is sent.
           required: true
           type: string
-        - name: model-version-id
+          example: __SERVICE-TYPE__
+        - name: vnf-type
           in: path
-          description: Unique identifier corresponding to one version of a model in ASDC
+          description: String capturing type of vnf, that was intended to identify the ASDC resource.  This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures.
           required: true
           type: string
-        - name: model-element-uuid
+          example: __VNF-TYPE__
+        - name: body
+          in: body
+          description: service-capability object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/ServiceDesignAndCreationServiceCapabilitiesServiceCapability.json)
+          required: true
+          schema:
+            $ref: "#/definitions/service-capability"
+    patch:
+      tags:
+        - ServiceDesignAndCreation
+      summary: update an existing service-capability
+      description: |
+        Update an existing service-capability
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateServiceDesignAndCreationServiceCapabilitiesServiceCapability
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: service-type
           in: path
+          description: This gets defined by others to provide a unique ID for the service, we accept what is sent.
           required: true
           type: string
-        - name: model-constraint-uuid
+          example: __SERVICE-TYPE__
+        - name: vnf-type
           in: path
+          description: String capturing type of vnf, that was intended to identify the ASDC resource.  This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures.
           required: true
           type: string
+          example: __VNF-TYPE__
         - name: body
           in: body
-          description: model-constraint object that needs to be created or updated
+          description: service-capability object that needs to be created or updated. 
           required: true
           schema:
-            $ref: "#/definitions/model-constraint"
+            $ref: "#/patchDefinitions/service-capability"
     delete:
       tags:
         - ServiceDesignAndCreation
-      summary: delete an existing model-constraint
-      description: delete an existing model-constraint
-      operationId: deleteServiceDesignAndCreationModelsModelModelVersModelVerModelElementsModelElementModelConstraintsModelConstraint
+      summary: delete an existing service-capability
+      description: delete an existing service-capability
+      operationId: deleteServiceDesignAndCreationServiceCapabilitiesServiceCapability
       consumes:
         - application/json
         - application/xml
@@ -14642,36 +19266,30 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: model-invariant-id
-          in: path
-          description: Unique identifier corresponding to the main definition of a model in ASDC
-          required: true
-          type: string
-        - name: model-version-id
-          in: path
-          description: Unique identifier corresponding to one version of a model in ASDC
-          required: true
-          type: string
-        - name: model-element-uuid
+        - name: service-type
           in: path
+          description: This gets defined by others to provide a unique ID for the service, we accept what is sent.
           required: true
           type: string
-        - name: model-constraint-uuid
+          example: __SERVICE-TYPE__
+        - name: vnf-type
           in: path
+          description: String capturing type of vnf, that was intended to identify the ASDC resource.  This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures.
           required: true
           type: string
+          example: __VNF-TYPE__
         - name: resource-version
           in: query
           description: resource-version for concurrency
           required: true
           type: string
-  /service-design-and-creation/models/model/{model-invariant-id}/model-vers/model-ver/{model-version-id}/model-elements/model-element/{model-element-uuid}/model-constraints:
+  /service-design-and-creation/service-capabilities:
     get:
       tags:
         - ServiceDesignAndCreation
-      summary: returns model-constraints
-      description: returns model-constraints
-      operationId: getServiceDesignAndCreationModelsModelModelVersModelVerModelElementsModelElementModelConstraints
+      summary: returns service-capabilities
+      description: returns service-capabilities
+      operationId: getServiceDesignAndCreationServiceCapabilities
       produces:
         - application/json
         - application/xml
@@ -14679,45 +19297,15 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/model-constraints"
+              $ref: "#/getDefinitions/service-capabilities"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
-      parameters:
-        - name: model-invariant-id
-          in: path
-          description: Unique identifier corresponding to the main definition of a model in ASDC
-          required: true
-          type: string
-        - name: model-version-id
-          in: path
-          description: Unique identifier corresponding to one version of a model in ASDC
-          required: true
-          type: string
-        - name: model-element-uuid
-          in: path
-          required: true
-          type: string
-        - name: model-type
-          in: query
-          description: Type of the model, e.g., service, resource, widget, etc.
-          required: false
-          type: string
-        - name: model-name
-          in: query
-          description: Name of the model, which can change from version to version.
-          required: false
-          type: string
-        - name: model-version
-          in: query
-          description: Version
-          required: false
-          type: string
-  /service-design-and-creation/models/model/{model-invariant-id}/model-vers/model-ver/{model-version-id}/model-elements/model-element/{model-element-uuid}/relationship-list/relationship:
+  /service-design-and-creation/models/model/{model-invariant-id}/model-vers/model-ver/{model-version-id}/model-elements/model-element/{model-element-uuid}/model-constraints/model-constraint/{model-constraint-uuid}/constrained-element-sets/constrained-element-set/{constrained-element-set-uuid}/element-choice-sets/element-choice-set/{element-choice-set-uuid}/relationship-list/relationship:
     put:
       tags:
         - ServiceDesignAndCreation
       summary: see node definition for valid relationships
-      operationId: createOrUpdateServiceDesignAndCreationModelsModelModelVersModelVerModelElementsModelElementRelationshipListRelationship
+      operationId: createOrUpdateServiceDesignAndCreationModelsModelModelVersModelVerModelElementsModelElementModelConstraintsModelConstraintConstrainedElementSetsConstrainedElementSetElementChoiceSetsElementChoiceSetRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -14733,18 +19321,36 @@ paths:
           description: Unique identifier corresponding to the main definition of a model in ASDC
           required: true
           type: string
+          example: __MODEL-INVARIANT-ID__
         - name: model-version-id
           in: path
           description: Unique identifier corresponding to one version of a model in ASDC
           required: true
           type: string
+          example: __MODEL-VERSION-ID__
         - name: model-element-uuid
           in: path
           required: true
           type: string
+          example: __MODEL-ELEMENT-UUID__
+        - name: model-constraint-uuid
+          in: path
+          required: true
+          type: string
+          example: __MODEL-CONSTRAINT-UUID__
+        - name: constrained-element-set-uuid
+          in: path
+          required: true
+          type: string
+          example: __CONSTRAINED-ELEMENT-SET-UUID__
+        - name: element-choice-set-uuid
+          in: path
+          required: true
+          type: string
+          example: __ELEMENT-CHOICE-SET-UUID__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/ServiceDesignAndCreationModelsModelModelVersModelVerModelElementsModelElementModelConstraintsModelConstraintConstrainedElementSetsConstrainedElementSetElementChoiceSetsElementChoiceSet.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -14753,7 +19359,7 @@ paths:
         - ServiceDesignAndCreation
       summary: delete an existing relationship
       description: delete an existing relationship
-      operationId: deleteServiceDesignAndCreationModelsModelModelVersModelVerModelElementsModelElementRelationshipListRelationship
+      operationId: deleteServiceDesignAndCreationModelsModelModelVersModelVerModelElementsModelElementModelConstraintsModelConstraintConstrainedElementSetsConstrainedElementSetElementChoiceSetsElementChoiceSetRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -14769,22 +19375,40 @@ paths:
           description: Unique identifier corresponding to the main definition of a model in ASDC
           required: true
           type: string
+          example: __MODEL-INVARIANT-ID__
         - name: model-version-id
           in: path
           description: Unique identifier corresponding to one version of a model in ASDC
           required: true
           type: string
+          example: __MODEL-VERSION-ID__
         - name: model-element-uuid
           in: path
           required: true
           type: string
-  /service-design-and-creation/models/model/{model-invariant-id}/model-vers/model-ver/{model-version-id}/model-elements/model-element/{model-element-uuid}:
+          example: __MODEL-ELEMENT-UUID__
+        - name: model-constraint-uuid
+          in: path
+          required: true
+          type: string
+          example: __MODEL-CONSTRAINT-UUID__
+        - name: constrained-element-set-uuid
+          in: path
+          required: true
+          type: string
+          example: __CONSTRAINED-ELEMENT-SET-UUID__
+        - name: element-choice-set-uuid
+          in: path
+          required: true
+          type: string
+          example: __ELEMENT-CHOICE-SET-UUID__
+  /service-design-and-creation/models/model/{model-invariant-id}/model-vers/model-ver/{model-version-id}/model-elements/model-element/{model-element-uuid}/model-constraints/model-constraint/{model-constraint-uuid}/constrained-element-sets/constrained-element-set/{constrained-element-set-uuid}/element-choice-sets/element-choice-set/{element-choice-set-uuid}:
     get:
       tags:
         - ServiceDesignAndCreation
-      summary: returns model-element
-      description: returns model-element
-      operationId: getServiceDesignAndCreationModelsModelModelVersModelVerModelElementsModelElement
+      summary: returns element-choice-set
+      description: returns element-choice-set
+      operationId: getServiceDesignAndCreationModelsModelModelVersModelVerModelElementsModelElementModelConstraintsModelConstraintConstrainedElementSetsConstrainedElementSetElementChoiceSetsElementChoiceSet
       produces:
         - application/json
         - application/xml
@@ -14792,7 +19416,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/model-element"
+              $ref: "#/getDefinitions/element-choice-set"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -14801,15 +19425,33 @@ paths:
           description: Unique identifier corresponding to the main definition of a model in ASDC
           required: true
           type: string
+          example: __MODEL-INVARIANT-ID__
         - name: model-version-id
           in: path
           description: Unique identifier corresponding to one version of a model in ASDC
           required: true
           type: string
+          example: __MODEL-VERSION-ID__
         - name: model-element-uuid
           in: path
           required: true
           type: string
+          example: __MODEL-ELEMENT-UUID__
+        - name: model-constraint-uuid
+          in: path
+          required: true
+          type: string
+          example: __MODEL-CONSTRAINT-UUID__
+        - name: constrained-element-set-uuid
+          in: path
+          required: true
+          type: string
+          example: __CONSTRAINED-ELEMENT-SET-UUID__
+        - name: element-choice-set-uuid
+          in: path
+          required: true
+          type: string
+          example: __ELEMENT-CHOICE-SET-UUID__
         - name: model-type
           in: query
           description: Type of the model, e.g., service, resource, widget, etc.
@@ -14828,9 +19470,12 @@ paths:
     put:
       tags:
         - ServiceDesignAndCreation
-      summary: create or update an existing model-element
-      description: create or update an existing model-element
-      operationId: createOrUpdateServiceDesignAndCreationModelsModelModelVersModelVerModelElementsModelElement
+      summary: create or update an existing element-choice-set
+      description: |
+        Create or update an existing element-choice-set.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateServiceDesignAndCreationModelsModelModelVersModelVerModelElementsModelElementModelConstraintsModelConstraintConstrainedElementSetsConstrainedElementSetElementChoiceSetsElementChoiceSet
       consumes:
         - application/json
         - application/xml
@@ -14846,27 +19491,56 @@ paths:
           description: Unique identifier corresponding to the main definition of a model in ASDC
           required: true
           type: string
+          example: __MODEL-INVARIANT-ID__
         - name: model-version-id
           in: path
           description: Unique identifier corresponding to one version of a model in ASDC
           required: true
           type: string
+          example: __MODEL-VERSION-ID__
         - name: model-element-uuid
           in: path
           required: true
           type: string
+          example: __MODEL-ELEMENT-UUID__
+        - name: model-constraint-uuid
+          in: path
+          required: true
+          type: string
+          example: __MODEL-CONSTRAINT-UUID__
+        - name: constrained-element-set-uuid
+          in: path
+          required: true
+          type: string
+          example: __CONSTRAINED-ELEMENT-SET-UUID__
+        - name: element-choice-set-uuid
+          in: path
+          required: true
+          type: string
+          example: __ELEMENT-CHOICE-SET-UUID__
         - name: body
           in: body
-          description: model-element object that needs to be created or updated
+          description: element-choice-set object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/ServiceDesignAndCreationModelsModelModelVersModelVerModelElementsModelElementModelConstraintsModelConstraintConstrainedElementSetsConstrainedElementSetElementChoiceSetsElementChoiceSet.json)
           required: true
           schema:
-            $ref: "#/definitions/model-element"
-    delete:
+            $ref: "#/definitions/element-choice-set"
+    patch:
       tags:
         - ServiceDesignAndCreation
-      summary: delete an existing model-element
-      description: delete an existing model-element
-      operationId: deleteServiceDesignAndCreationModelsModelModelVersModelVerModelElementsModelElement
+      summary: update an existing element-choice-set
+      description: |
+        Update an existing element-choice-set
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateServiceDesignAndCreationModelsModelModelVersModelVerModelElementsModelElementModelConstraintsModelConstraintConstrainedElementSetsConstrainedElementSetElementChoiceSetsElementChoiceSet
       consumes:
         - application/json
         - application/xml
@@ -14882,35 +19556,52 @@ paths:
           description: Unique identifier corresponding to the main definition of a model in ASDC
           required: true
           type: string
+          example: __MODEL-INVARIANT-ID__
         - name: model-version-id
           in: path
           description: Unique identifier corresponding to one version of a model in ASDC
           required: true
           type: string
+          example: __MODEL-VERSION-ID__
         - name: model-element-uuid
           in: path
           required: true
           type: string
-        - name: resource-version
-          in: query
-          description: resource-version for concurrency
+          example: __MODEL-ELEMENT-UUID__
+        - name: model-constraint-uuid
+          in: path
           required: true
           type: string
-  /service-design-and-creation/models/model/{model-invariant-id}/model-vers/model-ver/{model-version-id}/model-elements:
-    get:
+          example: __MODEL-CONSTRAINT-UUID__
+        - name: constrained-element-set-uuid
+          in: path
+          required: true
+          type: string
+          example: __CONSTRAINED-ELEMENT-SET-UUID__
+        - name: element-choice-set-uuid
+          in: path
+          required: true
+          type: string
+          example: __ELEMENT-CHOICE-SET-UUID__
+        - name: body
+          in: body
+          description: element-choice-set object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/element-choice-set"
+    delete:
       tags:
         - ServiceDesignAndCreation
-      summary: returns model-elements
-      description: returns model-elements
-      operationId: getServiceDesignAndCreationModelsModelModelVersModelVerModelElements
+      summary: delete an existing element-choice-set
+      description: delete an existing element-choice-set
+      operationId: deleteServiceDesignAndCreationModelsModelModelVersModelVerModelElementsModelElementModelConstraintsModelConstraintConstrainedElementSetsConstrainedElementSetElementChoiceSetsElementChoiceSet
+      consumes:
+        - application/json
+        - application/xml
       produces:
         - application/json
         - application/xml
       responses:
-        "200":
-          description: successful operation
-          schema:
-              $ref: "#/definitions/model-elements"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -14919,33 +19610,45 @@ paths:
           description: Unique identifier corresponding to the main definition of a model in ASDC
           required: true
           type: string
+          example: __MODEL-INVARIANT-ID__
         - name: model-version-id
           in: path
           description: Unique identifier corresponding to one version of a model in ASDC
           required: true
           type: string
-        - name: model-type
-          in: query
-          description: Type of the model, e.g., service, resource, widget, etc.
-          required: false
+          example: __MODEL-VERSION-ID__
+        - name: model-element-uuid
+          in: path
+          required: true
           type: string
-        - name: model-name
-          in: query
-          description: Name of the model, which can change from version to version.
-          required: false
+          example: __MODEL-ELEMENT-UUID__
+        - name: model-constraint-uuid
+          in: path
+          required: true
           type: string
-        - name: model-version
+          example: __MODEL-CONSTRAINT-UUID__
+        - name: constrained-element-set-uuid
+          in: path
+          required: true
+          type: string
+          example: __CONSTRAINED-ELEMENT-SET-UUID__
+        - name: element-choice-set-uuid
+          in: path
+          required: true
+          type: string
+          example: __ELEMENT-CHOICE-SET-UUID__
+        - name: resource-version
           in: query
-          description: Version
-          required: false
+          description: resource-version for concurrency
+          required: true
           type: string
-  /service-design-and-creation/models/model/{model-invariant-id}/model-vers/model-ver/{model-version-id}/metadata/metadatum/{metaname}:
+  /service-design-and-creation/models/model/{model-invariant-id}/model-vers/model-ver/{model-version-id}/model-elements/model-element/{model-element-uuid}/model-constraints/model-constraint/{model-constraint-uuid}/constrained-element-sets/constrained-element-set/{constrained-element-set-uuid}/element-choice-sets:
     get:
       tags:
         - ServiceDesignAndCreation
-      summary: returns metadatum
-      description: returns metadatum
-      operationId: getServiceDesignAndCreationModelsModelModelVersModelVerMetadataMetadatum
+      summary: returns element-choice-sets
+      description: returns element-choice-sets
+      operationId: getServiceDesignAndCreationModelsModelModelVersModelVerModelElementsModelElementModelConstraintsModelConstraintConstrainedElementSetsConstrainedElementSetElementChoiceSets
       produces:
         - application/json
         - application/xml
@@ -14953,7 +19656,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/metadatum"
+              $ref: "#/getDefinitions/element-choice-sets"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -14962,15 +19665,28 @@ paths:
           description: Unique identifier corresponding to the main definition of a model in ASDC
           required: true
           type: string
+          example: __MODEL-INVARIANT-ID__
         - name: model-version-id
           in: path
           description: Unique identifier corresponding to one version of a model in ASDC
           required: true
           type: string
-        - name: metaname
+          example: __MODEL-VERSION-ID__
+        - name: model-element-uuid
+          in: path
+          required: true
+          type: string
+          example: __MODEL-ELEMENT-UUID__
+        - name: model-constraint-uuid
+          in: path
+          required: true
+          type: string
+          example: __MODEL-CONSTRAINT-UUID__
+        - name: constrained-element-set-uuid
           in: path
           required: true
           type: string
+          example: __CONSTRAINED-ELEMENT-SET-UUID__
         - name: model-type
           in: query
           description: Type of the model, e.g., service, resource, widget, etc.
@@ -14986,12 +19702,12 @@ paths:
           description: Version
           required: false
           type: string
+  /service-design-and-creation/models/model/{model-invariant-id}/model-vers/model-ver/{model-version-id}/model-elements/model-element/{model-element-uuid}/model-constraints/model-constraint/{model-constraint-uuid}/constrained-element-sets/constrained-element-set/{constrained-element-set-uuid}/relationship-list/relationship:
     put:
       tags:
         - ServiceDesignAndCreation
-      summary: create or update an existing metadatum
-      description: create or update an existing metadatum
-      operationId: createOrUpdateServiceDesignAndCreationModelsModelModelVersModelVerMetadataMetadatum
+      summary: see node definition for valid relationships
+      operationId: createOrUpdateServiceDesignAndCreationModelsModelModelVersModelVerModelElementsModelElementModelConstraintsModelConstraintConstrainedElementSetsConstrainedElementSetRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -15007,27 +19723,40 @@ paths:
           description: Unique identifier corresponding to the main definition of a model in ASDC
           required: true
           type: string
+          example: __MODEL-INVARIANT-ID__
         - name: model-version-id
           in: path
           description: Unique identifier corresponding to one version of a model in ASDC
           required: true
           type: string
-        - name: metaname
+          example: __MODEL-VERSION-ID__
+        - name: model-element-uuid
+          in: path
+          required: true
+          type: string
+          example: __MODEL-ELEMENT-UUID__
+        - name: model-constraint-uuid
+          in: path
+          required: true
+          type: string
+          example: __MODEL-CONSTRAINT-UUID__
+        - name: constrained-element-set-uuid
           in: path
           required: true
           type: string
+          example: __CONSTRAINED-ELEMENT-SET-UUID__
         - name: body
           in: body
-          description: metadatum object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/ServiceDesignAndCreationModelsModelModelVersModelVerModelElementsModelElementModelConstraintsModelConstraintConstrainedElementSetsConstrainedElementSet.json)
           required: true
           schema:
-            $ref: "#/definitions/metadatum"
+            $ref: "#/definitions/relationship"
     delete:
       tags:
         - ServiceDesignAndCreation
-      summary: delete an existing metadatum
-      description: delete an existing metadatum
-      operationId: deleteServiceDesignAndCreationModelsModelModelVersModelVerMetadataMetadatum
+      summary: delete an existing relationship
+      description: delete an existing relationship
+      operationId: deleteServiceDesignAndCreationModelsModelModelVersModelVerModelElementsModelElementModelConstraintsModelConstraintConstrainedElementSetsConstrainedElementSetRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -15043,27 +19772,35 @@ paths:
           description: Unique identifier corresponding to the main definition of a model in ASDC
           required: true
           type: string
+          example: __MODEL-INVARIANT-ID__
         - name: model-version-id
           in: path
           description: Unique identifier corresponding to one version of a model in ASDC
           required: true
           type: string
-        - name: metaname
+          example: __MODEL-VERSION-ID__
+        - name: model-element-uuid
           in: path
           required: true
           type: string
-        - name: resource-version
-          in: query
-          description: resource-version for concurrency
+          example: __MODEL-ELEMENT-UUID__
+        - name: model-constraint-uuid
+          in: path
           required: true
           type: string
-  /service-design-and-creation/models/model/{model-invariant-id}/model-vers/model-ver/{model-version-id}/metadata:
+          example: __MODEL-CONSTRAINT-UUID__
+        - name: constrained-element-set-uuid
+          in: path
+          required: true
+          type: string
+          example: __CONSTRAINED-ELEMENT-SET-UUID__
+  /service-design-and-creation/models/model/{model-invariant-id}/model-vers/model-ver/{model-version-id}/model-elements/model-element/{model-element-uuid}/model-constraints/model-constraint/{model-constraint-uuid}/constrained-element-sets/constrained-element-set/{constrained-element-set-uuid}:
     get:
       tags:
         - ServiceDesignAndCreation
-      summary: returns metadata
-      description: returns metadata
-      operationId: getServiceDesignAndCreationModelsModelModelVersModelVerMetadata
+      summary: returns constrained-element-set
+      description: returns constrained-element-set
+      operationId: getServiceDesignAndCreationModelsModelModelVersModelVerModelElementsModelElementModelConstraintsModelConstraintConstrainedElementSetsConstrainedElementSet
       produces:
         - application/json
         - application/xml
@@ -15071,7 +19808,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/metadata"
+              $ref: "#/getDefinitions/constrained-element-set"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -15080,11 +19817,28 @@ paths:
           description: Unique identifier corresponding to the main definition of a model in ASDC
           required: true
           type: string
+          example: __MODEL-INVARIANT-ID__
         - name: model-version-id
           in: path
           description: Unique identifier corresponding to one version of a model in ASDC
           required: true
           type: string
+          example: __MODEL-VERSION-ID__
+        - name: model-element-uuid
+          in: path
+          required: true
+          type: string
+          example: __MODEL-ELEMENT-UUID__
+        - name: model-constraint-uuid
+          in: path
+          required: true
+          type: string
+          example: __MODEL-CONSTRAINT-UUID__
+        - name: constrained-element-set-uuid
+          in: path
+          required: true
+          type: string
+          example: __CONSTRAINED-ELEMENT-SET-UUID__
         - name: model-type
           in: query
           description: Type of the model, e.g., service, resource, widget, etc.
@@ -15100,12 +19854,15 @@ paths:
           description: Version
           required: false
           type: string
-  /service-design-and-creation/models/model/{model-invariant-id}/model-vers/model-ver/{model-version-id}/relationship-list/relationship:
     put:
       tags:
         - ServiceDesignAndCreation
-      summary: see node definition for valid relationships
-      operationId: createOrUpdateServiceDesignAndCreationModelsModelModelVersModelVerRelationshipListRelationship
+      summary: create or update an existing constrained-element-set
+      description: |
+        Create or update an existing constrained-element-set.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateServiceDesignAndCreationModelsModelModelVersModelVerModelElementsModelElementModelConstraintsModelConstraintConstrainedElementSetsConstrainedElementSet
       consumes:
         - application/json
         - application/xml
@@ -15121,23 +19878,51 @@ paths:
           description: Unique identifier corresponding to the main definition of a model in ASDC
           required: true
           type: string
+          example: __MODEL-INVARIANT-ID__
         - name: model-version-id
           in: path
           description: Unique identifier corresponding to one version of a model in ASDC
           required: true
           type: string
+          example: __MODEL-VERSION-ID__
+        - name: model-element-uuid
+          in: path
+          required: true
+          type: string
+          example: __MODEL-ELEMENT-UUID__
+        - name: model-constraint-uuid
+          in: path
+          required: true
+          type: string
+          example: __MODEL-CONSTRAINT-UUID__
+        - name: constrained-element-set-uuid
+          in: path
+          required: true
+          type: string
+          example: __CONSTRAINED-ELEMENT-SET-UUID__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: constrained-element-set object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/ServiceDesignAndCreationModelsModelModelVersModelVerModelElementsModelElementModelConstraintsModelConstraintConstrainedElementSetsConstrainedElementSet.json)
           required: true
           schema:
-            $ref: "#/definitions/relationship"
-    delete:
+            $ref: "#/definitions/constrained-element-set"
+    patch:
       tags:
         - ServiceDesignAndCreation
-      summary: delete an existing relationship
-      description: delete an existing relationship
-      operationId: deleteServiceDesignAndCreationModelsModelModelVersModelVerRelationshipListRelationship
+      summary: update an existing constrained-element-set
+      description: |
+        Update an existing constrained-element-set
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateServiceDesignAndCreationModelsModelModelVersModelVerModelElementsModelElementModelConstraintsModelConstraintConstrainedElementSetsConstrainedElementSet
       consumes:
         - application/json
         - application/xml
@@ -15153,60 +19938,40 @@ paths:
           description: Unique identifier corresponding to the main definition of a model in ASDC
           required: true
           type: string
+          example: __MODEL-INVARIANT-ID__
         - name: model-version-id
           in: path
           description: Unique identifier corresponding to one version of a model in ASDC
           required: true
           type: string
-  /service-design-and-creation/models/model/{model-invariant-id}/model-vers/model-ver/{model-version-id}:
-    get:
-      tags:
-        - ServiceDesignAndCreation
-      summary: returns model-ver
-      description: returns model-ver
-      operationId: getServiceDesignAndCreationModelsModelModelVersModelVer
-      produces:
-        - application/json
-        - application/xml
-      responses:
-        "200":
-          description: successful operation
-          schema:
-              $ref: "#/definitions/model-ver"
-        "default":
-          description: Response codes found in [response codes](https://wiki.onap.org/).
-      parameters:
-        - name: model-invariant-id
+          example: __MODEL-VERSION-ID__
+        - name: model-element-uuid
           in: path
-          description: Unique identifier corresponding to the main definition of a model in ASDC
           required: true
           type: string
-        - name: model-version-id
+          example: __MODEL-ELEMENT-UUID__
+        - name: model-constraint-uuid
           in: path
-          description: Unique identifier corresponding to one version of a model in ASDC
           required: true
           type: string
-        - name: model-type
-          in: query
-          description: Type of the model, e.g., service, resource, widget, etc.
-          required: false
-          type: string
-        - name: model-name
-          in: query
-          description: Name of the model, which can change from version to version.
-          required: false
-          type: string
-        - name: model-version
-          in: query
-          description: Version
-          required: false
+          example: __MODEL-CONSTRAINT-UUID__
+        - name: constrained-element-set-uuid
+          in: path
+          required: true
           type: string
-    put:
+          example: __CONSTRAINED-ELEMENT-SET-UUID__
+        - name: body
+          in: body
+          description: constrained-element-set object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/constrained-element-set"
+    delete:
       tags:
         - ServiceDesignAndCreation
-      summary: create or update an existing model-ver
-      description: create or update an existing model-ver
-      operationId: createOrUpdateServiceDesignAndCreationModelsModelModelVersModelVer
+      summary: delete an existing constrained-element-set
+      description: delete an existing constrained-element-set
+      operationId: deleteServiceDesignAndCreationModelsModelModelVersModelVerModelElementsModelElementModelConstraintsModelConstraintConstrainedElementSetsConstrainedElementSet
       consumes:
         - application/json
         - application/xml
@@ -15222,30 +19987,48 @@ paths:
           description: Unique identifier corresponding to the main definition of a model in ASDC
           required: true
           type: string
+          example: __MODEL-INVARIANT-ID__
         - name: model-version-id
           in: path
           description: Unique identifier corresponding to one version of a model in ASDC
           required: true
           type: string
-        - name: body
-          in: body
-          description: model-ver object that needs to be created or updated
+          example: __MODEL-VERSION-ID__
+        - name: model-element-uuid
+          in: path
           required: true
-          schema:
-            $ref: "#/definitions/model-ver"
-    delete:
+          type: string
+          example: __MODEL-ELEMENT-UUID__
+        - name: model-constraint-uuid
+          in: path
+          required: true
+          type: string
+          example: __MODEL-CONSTRAINT-UUID__
+        - name: constrained-element-set-uuid
+          in: path
+          required: true
+          type: string
+          example: __CONSTRAINED-ELEMENT-SET-UUID__
+        - name: resource-version
+          in: query
+          description: resource-version for concurrency
+          required: true
+          type: string
+  /service-design-and-creation/models/model/{model-invariant-id}/model-vers/model-ver/{model-version-id}/model-elements/model-element/{model-element-uuid}/model-constraints/model-constraint/{model-constraint-uuid}/constrained-element-sets:
+    get:
       tags:
         - ServiceDesignAndCreation
-      summary: delete an existing model-ver
-      description: delete an existing model-ver
-      operationId: deleteServiceDesignAndCreationModelsModelModelVersModelVer
-      consumes:
-        - application/json
-        - application/xml
+      summary: returns constrained-element-sets
+      description: returns constrained-element-sets
+      operationId: getServiceDesignAndCreationModelsModelModelVersModelVerModelElementsModelElementModelConstraintsModelConstraintConstrainedElementSets
       produces:
         - application/json
         - application/xml
       responses:
+        "200":
+          description: successful operation
+          schema:
+              $ref: "#/getDefinitions/constrained-element-sets"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -15254,23 +20037,45 @@ paths:
           description: Unique identifier corresponding to the main definition of a model in ASDC
           required: true
           type: string
+          example: __MODEL-INVARIANT-ID__
         - name: model-version-id
           in: path
           description: Unique identifier corresponding to one version of a model in ASDC
           required: true
           type: string
-        - name: resource-version
-          in: query
-          description: resource-version for concurrency
+          example: __MODEL-VERSION-ID__
+        - name: model-element-uuid
+          in: path
           required: true
           type: string
-  /service-design-and-creation/models/model/{model-invariant-id}/model-vers:
+          example: __MODEL-ELEMENT-UUID__
+        - name: model-constraint-uuid
+          in: path
+          required: true
+          type: string
+          example: __MODEL-CONSTRAINT-UUID__
+        - name: model-type
+          in: query
+          description: Type of the model, e.g., service, resource, widget, etc.
+          required: false
+          type: string
+        - name: model-name
+          in: query
+          description: Name of the model, which can change from version to version.
+          required: false
+          type: string
+        - name: model-version
+          in: query
+          description: Version
+          required: false
+          type: string
+  /service-design-and-creation/models/model/{model-invariant-id}/model-vers/model-ver/{model-version-id}/model-elements/model-element/{model-element-uuid}/model-constraints/model-constraint/{model-constraint-uuid}:
     get:
       tags:
         - ServiceDesignAndCreation
-      summary: returns model-vers
-      description: returns model-vers
-      operationId: getServiceDesignAndCreationModelsModelModelVers
+      summary: returns model-constraint
+      description: returns model-constraint
+      operationId: getServiceDesignAndCreationModelsModelModelVersModelVerModelElementsModelElementModelConstraintsModelConstraint
       produces:
         - application/json
         - application/xml
@@ -15278,7 +20083,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/model-vers"
+              $ref: "#/getDefinitions/model-constraint"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -15287,17 +20092,47 @@ paths:
           description: Unique identifier corresponding to the main definition of a model in ASDC
           required: true
           type: string
+          example: __MODEL-INVARIANT-ID__
+        - name: model-version-id
+          in: path
+          description: Unique identifier corresponding to one version of a model in ASDC
+          required: true
+          type: string
+          example: __MODEL-VERSION-ID__
+        - name: model-element-uuid
+          in: path
+          required: true
+          type: string
+          example: __MODEL-ELEMENT-UUID__
+        - name: model-constraint-uuid
+          in: path
+          required: true
+          type: string
+          example: __MODEL-CONSTRAINT-UUID__
         - name: model-type
           in: query
           description: Type of the model, e.g., service, resource, widget, etc.
           required: false
           type: string
-  /service-design-and-creation/models/model/{model-invariant-id}/relationship-list/relationship:
+        - name: model-name
+          in: query
+          description: Name of the model, which can change from version to version.
+          required: false
+          type: string
+        - name: model-version
+          in: query
+          description: Version
+          required: false
+          type: string
     put:
       tags:
         - ServiceDesignAndCreation
-      summary: see node definition for valid relationships
-      operationId: createOrUpdateServiceDesignAndCreationModelsModelRelationshipListRelationship
+      summary: create or update an existing model-constraint
+      description: |
+        Create or update an existing model-constraint.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateServiceDesignAndCreationModelsModelModelVersModelVerModelElementsModelElementModelConstraintsModelConstraint
       consumes:
         - application/json
         - application/xml
@@ -15313,18 +20148,46 @@ paths:
           description: Unique identifier corresponding to the main definition of a model in ASDC
           required: true
           type: string
+          example: __MODEL-INVARIANT-ID__
+        - name: model-version-id
+          in: path
+          description: Unique identifier corresponding to one version of a model in ASDC
+          required: true
+          type: string
+          example: __MODEL-VERSION-ID__
+        - name: model-element-uuid
+          in: path
+          required: true
+          type: string
+          example: __MODEL-ELEMENT-UUID__
+        - name: model-constraint-uuid
+          in: path
+          required: true
+          type: string
+          example: __MODEL-CONSTRAINT-UUID__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: model-constraint object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/ServiceDesignAndCreationModelsModelModelVersModelVerModelElementsModelElementModelConstraintsModelConstraint.json)
           required: true
           schema:
-            $ref: "#/definitions/relationship"
-    delete:
+            $ref: "#/definitions/model-constraint"
+    patch:
       tags:
         - ServiceDesignAndCreation
-      summary: delete an existing relationship
-      description: delete an existing relationship
-      operationId: deleteServiceDesignAndCreationModelsModelRelationshipListRelationship
+      summary: update an existing model-constraint
+      description: |
+        Update an existing model-constraint
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateServiceDesignAndCreationModelsModelModelVersModelVerModelElementsModelElementModelConstraintsModelConstraint
       consumes:
         - application/json
         - application/xml
@@ -15340,67 +20203,35 @@ paths:
           description: Unique identifier corresponding to the main definition of a model in ASDC
           required: true
           type: string
-  /service-design-and-creation/models/model/{model-invariant-id}:
-    get:
-      tags:
-        - ServiceDesignAndCreation
-      summary: returns model
-      description: returns model
-      operationId: getServiceDesignAndCreationModelsModel
-      produces:
-        - application/json
-        - application/xml
-      responses:
-        "200":
-          description: successful operation
-          schema:
-              $ref: "#/definitions/model"
-        "default":
-          description: Response codes found in [response codes](https://wiki.onap.org/).
-      parameters:
-        - name: model-invariant-id
+          example: __MODEL-INVARIANT-ID__
+        - name: model-version-id
           in: path
-          description: Unique identifier corresponding to the main definition of a model in ASDC
+          description: Unique identifier corresponding to one version of a model in ASDC
           required: true
           type: string
-        - name: model-type
-          in: query
-          description: Type of the model, e.g., service, resource, widget, etc.
-          required: false
+          example: __MODEL-VERSION-ID__
+        - name: model-element-uuid
+          in: path
+          required: true
           type: string
-    put:
-      tags:
-        - ServiceDesignAndCreation
-      summary: create or update an existing model
-      description: create or update an existing model
-      operationId: createOrUpdateServiceDesignAndCreationModelsModel
-      consumes:
-        - application/json
-        - application/xml
-      produces:
-        - application/json
-        - application/xml
-      responses:
-        "default":
-          description: Response codes found in [response codes](https://wiki.onap.org/).
-      parameters:
-        - name: model-invariant-id
+          example: __MODEL-ELEMENT-UUID__
+        - name: model-constraint-uuid
           in: path
-          description: Unique identifier corresponding to the main definition of a model in ASDC
           required: true
           type: string
+          example: __MODEL-CONSTRAINT-UUID__
         - name: body
           in: body
-          description: model object that needs to be created or updated
+          description: model-constraint object that needs to be created or updated. 
           required: true
           schema:
-            $ref: "#/definitions/model"
+            $ref: "#/patchDefinitions/model-constraint"
     delete:
       tags:
         - ServiceDesignAndCreation
-      summary: delete an existing model
-      description: delete an existing model
-      operationId: deleteServiceDesignAndCreationModelsModel
+      summary: delete an existing model-constraint
+      description: delete an existing model-constraint
+      operationId: deleteServiceDesignAndCreationModelsModelModelVersModelVerModelElementsModelElementModelConstraintsModelConstraint
       consumes:
         - application/json
         - application/xml
@@ -15416,18 +20247,35 @@ paths:
           description: Unique identifier corresponding to the main definition of a model in ASDC
           required: true
           type: string
+          example: __MODEL-INVARIANT-ID__
+        - name: model-version-id
+          in: path
+          description: Unique identifier corresponding to one version of a model in ASDC
+          required: true
+          type: string
+          example: __MODEL-VERSION-ID__
+        - name: model-element-uuid
+          in: path
+          required: true
+          type: string
+          example: __MODEL-ELEMENT-UUID__
+        - name: model-constraint-uuid
+          in: path
+          required: true
+          type: string
+          example: __MODEL-CONSTRAINT-UUID__
         - name: resource-version
           in: query
           description: resource-version for concurrency
           required: true
           type: string
-  /service-design-and-creation/models:
+  /service-design-and-creation/models/model/{model-invariant-id}/model-vers/model-ver/{model-version-id}/model-elements/model-element/{model-element-uuid}/model-constraints:
     get:
       tags:
         - ServiceDesignAndCreation
-      summary: returns models
-      description: returns models
-      operationId: getServiceDesignAndCreationModels
+      summary: returns model-constraints
+      description: returns model-constraints
+      operationId: getServiceDesignAndCreationModelsModelModelVersModelVerModelElementsModelElementModelConstraints
       produces:
         - application/json
         - application/xml
@@ -15435,15 +20283,48 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/models"
+              $ref: "#/getDefinitions/model-constraints"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
-  /service-design-and-creation/named-queries/named-query/{named-query-uuid}/named-query-elements/named-query-element/{named-query-element-uuid}/related-lookups/related-lookup/{related-lookup-uuid}/relationship-list/relationship:
+      parameters:
+        - name: model-invariant-id
+          in: path
+          description: Unique identifier corresponding to the main definition of a model in ASDC
+          required: true
+          type: string
+          example: __MODEL-INVARIANT-ID__
+        - name: model-version-id
+          in: path
+          description: Unique identifier corresponding to one version of a model in ASDC
+          required: true
+          type: string
+          example: __MODEL-VERSION-ID__
+        - name: model-element-uuid
+          in: path
+          required: true
+          type: string
+          example: __MODEL-ELEMENT-UUID__
+        - name: model-type
+          in: query
+          description: Type of the model, e.g., service, resource, widget, etc.
+          required: false
+          type: string
+        - name: model-name
+          in: query
+          description: Name of the model, which can change from version to version.
+          required: false
+          type: string
+        - name: model-version
+          in: query
+          description: Version
+          required: false
+          type: string
+  /service-design-and-creation/models/model/{model-invariant-id}/model-vers/model-ver/{model-version-id}/model-elements/model-element/{model-element-uuid}/relationship-list/relationship:
     put:
       tags:
         - ServiceDesignAndCreation
       summary: see node definition for valid relationships
-      operationId: createOrUpdateServiceDesignAndCreationNamedQueriesNamedQueryNamedQueryElementsNamedQueryElementRelatedLookupsRelatedLookupRelationshipListRelationship
+      operationId: createOrUpdateServiceDesignAndCreationModelsModelModelVersModelVerModelElementsModelElementRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -15454,21 +20335,26 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: named-query-uuid
+        - name: model-invariant-id
           in: path
+          description: Unique identifier corresponding to the main definition of a model in ASDC
           required: true
           type: string
-        - name: named-query-element-uuid
+          example: __MODEL-INVARIANT-ID__
+        - name: model-version-id
           in: path
+          description: Unique identifier corresponding to one version of a model in ASDC
           required: true
           type: string
-        - name: related-lookup-uuid
+          example: __MODEL-VERSION-ID__
+        - name: model-element-uuid
           in: path
           required: true
           type: string
+          example: __MODEL-ELEMENT-UUID__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/ServiceDesignAndCreationModelsModelModelVersModelVerModelElementsModelElement.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -15477,7 +20363,7 @@ paths:
         - ServiceDesignAndCreation
       summary: delete an existing relationship
       description: delete an existing relationship
-      operationId: deleteServiceDesignAndCreationNamedQueriesNamedQueryNamedQueryElementsNamedQueryElementRelatedLookupsRelatedLookupRelationshipListRelationship
+      operationId: deleteServiceDesignAndCreationModelsModelModelVersModelVerModelElementsModelElementRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -15488,25 +20374,30 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: named-query-uuid
+        - name: model-invariant-id
           in: path
+          description: Unique identifier corresponding to the main definition of a model in ASDC
           required: true
           type: string
-        - name: named-query-element-uuid
+          example: __MODEL-INVARIANT-ID__
+        - name: model-version-id
           in: path
+          description: Unique identifier corresponding to one version of a model in ASDC
           required: true
           type: string
-        - name: related-lookup-uuid
+          example: __MODEL-VERSION-ID__
+        - name: model-element-uuid
           in: path
           required: true
           type: string
-  /service-design-and-creation/named-queries/named-query/{named-query-uuid}/named-query-elements/named-query-element/{named-query-element-uuid}/related-lookups/related-lookup/{related-lookup-uuid}:
+          example: __MODEL-ELEMENT-UUID__
+  /service-design-and-creation/models/model/{model-invariant-id}/model-vers/model-ver/{model-version-id}/model-elements/model-element/{model-element-uuid}:
     get:
       tags:
         - ServiceDesignAndCreation
-      summary: returns related-lookup
-      description: returns related-lookup
-      operationId: getServiceDesignAndCreationNamedQueriesNamedQueryNamedQueryElementsNamedQueryElementRelatedLookupsRelatedLookup
+      summary: returns model-element
+      description: returns model-element
+      operationId: getServiceDesignAndCreationModelsModelModelVersModelVerModelElementsModelElement
       produces:
         - application/json
         - application/xml
@@ -15514,32 +20405,51 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/related-lookup"
+              $ref: "#/getDefinitions/model-element"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: named-query-uuid
+        - name: model-invariant-id
           in: path
+          description: Unique identifier corresponding to the main definition of a model in ASDC
           required: true
           type: string
-        - name: named-query-element-uuid
+          example: __MODEL-INVARIANT-ID__
+        - name: model-version-id
           in: path
+          description: Unique identifier corresponding to one version of a model in ASDC
           required: true
           type: string
-        - name: related-lookup-uuid
+          example: __MODEL-VERSION-ID__
+        - name: model-element-uuid
           in: path
           required: true
           type: string
-        - name: named-query-name
+          example: __MODEL-ELEMENT-UUID__
+        - name: model-type
+          in: query
+          description: Type of the model, e.g., service, resource, widget, etc.
+          required: false
+          type: string
+        - name: model-name
+          in: query
+          description: Name of the model, which can change from version to version.
+          required: false
+          type: string
+        - name: model-version
           in: query
+          description: Version
           required: false
           type: string
     put:
       tags:
         - ServiceDesignAndCreation
-      summary: create or update an existing related-lookup
-      description: create or update an existing related-lookup
-      operationId: createOrUpdateServiceDesignAndCreationNamedQueriesNamedQueryNamedQueryElementsNamedQueryElementRelatedLookupsRelatedLookup
+      summary: create or update an existing model-element
+      description: |
+        Create or update an existing model-element.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateServiceDesignAndCreationModelsModelModelVersModelVerModelElementsModelElement
       consumes:
         - application/json
         - application/xml
@@ -15550,30 +20460,46 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: named-query-uuid
+        - name: model-invariant-id
           in: path
+          description: Unique identifier corresponding to the main definition of a model in ASDC
           required: true
           type: string
-        - name: named-query-element-uuid
+          example: __MODEL-INVARIANT-ID__
+        - name: model-version-id
           in: path
+          description: Unique identifier corresponding to one version of a model in ASDC
           required: true
           type: string
-        - name: related-lookup-uuid
+          example: __MODEL-VERSION-ID__
+        - name: model-element-uuid
           in: path
           required: true
           type: string
+          example: __MODEL-ELEMENT-UUID__
         - name: body
           in: body
-          description: related-lookup object that needs to be created or updated
+          description: model-element object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/ServiceDesignAndCreationModelsModelModelVersModelVerModelElementsModelElement.json)
           required: true
           schema:
-            $ref: "#/definitions/related-lookup"
-    delete:
+            $ref: "#/definitions/model-element"
+    patch:
       tags:
         - ServiceDesignAndCreation
-      summary: delete an existing related-lookup
-      description: delete an existing related-lookup
-      operationId: deleteServiceDesignAndCreationNamedQueriesNamedQueryNamedQueryElementsNamedQueryElementRelatedLookupsRelatedLookup
+      summary: update an existing model-element
+      description: |
+        Update an existing model-element
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateServiceDesignAndCreationModelsModelModelVersModelVerModelElementsModelElement
       consumes:
         - application/json
         - application/xml
@@ -15584,30 +20510,74 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: named-query-uuid
+        - name: model-invariant-id
           in: path
+          description: Unique identifier corresponding to the main definition of a model in ASDC
           required: true
           type: string
-        - name: named-query-element-uuid
+          example: __MODEL-INVARIANT-ID__
+        - name: model-version-id
           in: path
+          description: Unique identifier corresponding to one version of a model in ASDC
           required: true
           type: string
-        - name: related-lookup-uuid
+          example: __MODEL-VERSION-ID__
+        - name: model-element-uuid
           in: path
           required: true
           type: string
-        - name: resource-version
-          in: query
-          description: resource-version for concurrency
+          example: __MODEL-ELEMENT-UUID__
+        - name: body
+          in: body
+          description: model-element object that needs to be created or updated. 
           required: true
-          type: string
-  /service-design-and-creation/named-queries/named-query/{named-query-uuid}/named-query-elements/named-query-element/{named-query-element-uuid}/related-lookups:
+          schema:
+            $ref: "#/patchDefinitions/model-element"
+    delete:
+      tags:
+        - ServiceDesignAndCreation
+      summary: delete an existing model-element
+      description: delete an existing model-element
+      operationId: deleteServiceDesignAndCreationModelsModelModelVersModelVerModelElementsModelElement
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: model-invariant-id
+          in: path
+          description: Unique identifier corresponding to the main definition of a model in ASDC
+          required: true
+          type: string
+          example: __MODEL-INVARIANT-ID__
+        - name: model-version-id
+          in: path
+          description: Unique identifier corresponding to one version of a model in ASDC
+          required: true
+          type: string
+          example: __MODEL-VERSION-ID__
+        - name: model-element-uuid
+          in: path
+          required: true
+          type: string
+          example: __MODEL-ELEMENT-UUID__
+        - name: resource-version
+          in: query
+          description: resource-version for concurrency
+          required: true
+          type: string
+  /service-design-and-creation/models/model/{model-invariant-id}/model-vers/model-ver/{model-version-id}/model-elements:
     get:
       tags:
         - ServiceDesignAndCreation
-      summary: returns related-lookups
-      description: returns related-lookups
-      operationId: getServiceDesignAndCreationNamedQueriesNamedQueryNamedQueryElementsNamedQueryElementRelatedLookups
+      summary: returns model-elements
+      description: returns model-elements
+      operationId: getServiceDesignAndCreationModelsModelModelVersModelVerModelElements
       produces:
         - application/json
         - application/xml
@@ -15615,29 +20585,44 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/related-lookups"
+              $ref: "#/getDefinitions/model-elements"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: named-query-uuid
+        - name: model-invariant-id
           in: path
+          description: Unique identifier corresponding to the main definition of a model in ASDC
           required: true
           type: string
-        - name: named-query-element-uuid
+          example: __MODEL-INVARIANT-ID__
+        - name: model-version-id
           in: path
+          description: Unique identifier corresponding to one version of a model in ASDC
           required: true
           type: string
-        - name: named-query-name
+          example: __MODEL-VERSION-ID__
+        - name: model-type
           in: query
+          description: Type of the model, e.g., service, resource, widget, etc.
           required: false
           type: string
-  /service-design-and-creation/named-queries/named-query/{named-query-uuid}/named-query-elements/named-query-element/{named-query-element-uuid}/property-constraints/property-constraint/{property-constraint-uuid}:
+        - name: model-name
+          in: query
+          description: Name of the model, which can change from version to version.
+          required: false
+          type: string
+        - name: model-version
+          in: query
+          description: Version
+          required: false
+          type: string
+  /service-design-and-creation/models/model/{model-invariant-id}/model-vers/model-ver/{model-version-id}/metadata/metadatum/{metaname}:
     get:
       tags:
         - ServiceDesignAndCreation
-      summary: returns property-constraint
-      description: returns property-constraint
-      operationId: getServiceDesignAndCreationNamedQueriesNamedQueryNamedQueryElementsNamedQueryElementPropertyConstraintsPropertyConstraint
+      summary: returns metadatum
+      description: returns metadatum
+      operationId: getServiceDesignAndCreationModelsModelModelVersModelVerMetadataMetadatum
       produces:
         - application/json
         - application/xml
@@ -15645,32 +20630,51 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/property-constraint"
+              $ref: "#/getDefinitions/metadatum"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: named-query-uuid
+        - name: model-invariant-id
           in: path
+          description: Unique identifier corresponding to the main definition of a model in ASDC
           required: true
           type: string
-        - name: named-query-element-uuid
+          example: __MODEL-INVARIANT-ID__
+        - name: model-version-id
           in: path
+          description: Unique identifier corresponding to one version of a model in ASDC
           required: true
           type: string
-        - name: property-constraint-uuid
+          example: __MODEL-VERSION-ID__
+        - name: metaname
           in: path
           required: true
           type: string
-        - name: named-query-name
+          example: __METANAME__
+        - name: model-type
           in: query
+          description: Type of the model, e.g., service, resource, widget, etc.
+          required: false
+          type: string
+        - name: model-name
+          in: query
+          description: Name of the model, which can change from version to version.
+          required: false
+          type: string
+        - name: model-version
+          in: query
+          description: Version
           required: false
           type: string
     put:
       tags:
         - ServiceDesignAndCreation
-      summary: create or update an existing property-constraint
-      description: create or update an existing property-constraint
-      operationId: createOrUpdateServiceDesignAndCreationNamedQueriesNamedQueryNamedQueryElementsNamedQueryElementPropertyConstraintsPropertyConstraint
+      summary: create or update an existing metadatum
+      description: |
+        Create or update an existing metadatum.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateServiceDesignAndCreationModelsModelModelVersModelVerMetadataMetadatum
       consumes:
         - application/json
         - application/xml
@@ -15681,30 +20685,85 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: named-query-uuid
+        - name: model-invariant-id
           in: path
+          description: Unique identifier corresponding to the main definition of a model in ASDC
           required: true
           type: string
-        - name: named-query-element-uuid
+          example: __MODEL-INVARIANT-ID__
+        - name: model-version-id
           in: path
+          description: Unique identifier corresponding to one version of a model in ASDC
           required: true
           type: string
-        - name: property-constraint-uuid
+          example: __MODEL-VERSION-ID__
+        - name: metaname
           in: path
           required: true
           type: string
+          example: __METANAME__
         - name: body
           in: body
-          description: property-constraint object that needs to be created or updated
+          description: metadatum object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/ServiceDesignAndCreationModelsModelModelVersModelVerMetadataMetadatum.json)
           required: true
           schema:
-            $ref: "#/definitions/property-constraint"
+            $ref: "#/definitions/metadatum"
+    patch:
+      tags:
+        - ServiceDesignAndCreation
+      summary: update an existing metadatum
+      description: |
+        Update an existing metadatum
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateServiceDesignAndCreationModelsModelModelVersModelVerMetadataMetadatum
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: model-invariant-id
+          in: path
+          description: Unique identifier corresponding to the main definition of a model in ASDC
+          required: true
+          type: string
+          example: __MODEL-INVARIANT-ID__
+        - name: model-version-id
+          in: path
+          description: Unique identifier corresponding to one version of a model in ASDC
+          required: true
+          type: string
+          example: __MODEL-VERSION-ID__
+        - name: metaname
+          in: path
+          required: true
+          type: string
+          example: __METANAME__
+        - name: body
+          in: body
+          description: metadatum object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/metadatum"
     delete:
       tags:
         - ServiceDesignAndCreation
-      summary: delete an existing property-constraint
-      description: delete an existing property-constraint
-      operationId: deleteServiceDesignAndCreationNamedQueriesNamedQueryNamedQueryElementsNamedQueryElementPropertyConstraintsPropertyConstraint
+      summary: delete an existing metadatum
+      description: delete an existing metadatum
+      operationId: deleteServiceDesignAndCreationModelsModelModelVersModelVerMetadataMetadatum
       consumes:
         - application/json
         - application/xml
@@ -15715,30 +20774,35 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: named-query-uuid
+        - name: model-invariant-id
           in: path
+          description: Unique identifier corresponding to the main definition of a model in ASDC
           required: true
           type: string
-        - name: named-query-element-uuid
+          example: __MODEL-INVARIANT-ID__
+        - name: model-version-id
           in: path
+          description: Unique identifier corresponding to one version of a model in ASDC
           required: true
           type: string
-        - name: property-constraint-uuid
+          example: __MODEL-VERSION-ID__
+        - name: metaname
           in: path
           required: true
           type: string
+          example: __METANAME__
         - name: resource-version
           in: query
           description: resource-version for concurrency
           required: true
           type: string
-  /service-design-and-creation/named-queries/named-query/{named-query-uuid}/named-query-elements/named-query-element/{named-query-element-uuid}/property-constraints:
+  /service-design-and-creation/models/model/{model-invariant-id}/model-vers/model-ver/{model-version-id}/metadata:
     get:
       tags:
         - ServiceDesignAndCreation
-      summary: returns property-constraints
-      description: returns property-constraints
-      operationId: getServiceDesignAndCreationNamedQueriesNamedQueryNamedQueryElementsNamedQueryElementPropertyConstraints
+      summary: returns metadata
+      description: returns metadata
+      operationId: getServiceDesignAndCreationModelsModelModelVersModelVerMetadata
       produces:
         - application/json
         - application/xml
@@ -15746,28 +20810,43 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/property-constraints"
+              $ref: "#/getDefinitions/metadata"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: named-query-uuid
+        - name: model-invariant-id
           in: path
+          description: Unique identifier corresponding to the main definition of a model in ASDC
           required: true
           type: string
-        - name: named-query-element-uuid
+          example: __MODEL-INVARIANT-ID__
+        - name: model-version-id
           in: path
+          description: Unique identifier corresponding to one version of a model in ASDC
           required: true
           type: string
-        - name: named-query-name
+          example: __MODEL-VERSION-ID__
+        - name: model-type
           in: query
+          description: Type of the model, e.g., service, resource, widget, etc.
           required: false
           type: string
-  /service-design-and-creation/named-queries/named-query/{named-query-uuid}/named-query-elements/named-query-element/{named-query-element-uuid}/relationship-list/relationship:
+        - name: model-name
+          in: query
+          description: Name of the model, which can change from version to version.
+          required: false
+          type: string
+        - name: model-version
+          in: query
+          description: Version
+          required: false
+          type: string
+  /service-design-and-creation/models/model/{model-invariant-id}/model-vers/model-ver/{model-version-id}/relationship-list/relationship:
     put:
       tags:
         - ServiceDesignAndCreation
       summary: see node definition for valid relationships
-      operationId: createOrUpdateServiceDesignAndCreationNamedQueriesNamedQueryNamedQueryElementsNamedQueryElementRelationshipListRelationship
+      operationId: createOrUpdateServiceDesignAndCreationModelsModelModelVersModelVerRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -15778,17 +20857,21 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: named-query-uuid
+        - name: model-invariant-id
           in: path
+          description: Unique identifier corresponding to the main definition of a model in ASDC
           required: true
           type: string
-        - name: named-query-element-uuid
+          example: __MODEL-INVARIANT-ID__
+        - name: model-version-id
           in: path
+          description: Unique identifier corresponding to one version of a model in ASDC
           required: true
           type: string
+          example: __MODEL-VERSION-ID__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/ServiceDesignAndCreationModelsModelModelVersModelVer.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -15797,7 +20880,7 @@ paths:
         - ServiceDesignAndCreation
       summary: delete an existing relationship
       description: delete an existing relationship
-      operationId: deleteServiceDesignAndCreationNamedQueriesNamedQueryNamedQueryElementsNamedQueryElementRelationshipListRelationship
+      operationId: deleteServiceDesignAndCreationModelsModelModelVersModelVerRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -15808,21 +20891,25 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: named-query-uuid
+        - name: model-invariant-id
           in: path
+          description: Unique identifier corresponding to the main definition of a model in ASDC
           required: true
           type: string
-        - name: named-query-element-uuid
+          example: __MODEL-INVARIANT-ID__
+        - name: model-version-id
           in: path
+          description: Unique identifier corresponding to one version of a model in ASDC
           required: true
           type: string
-  /service-design-and-creation/named-queries/named-query/{named-query-uuid}/named-query-elements/named-query-element/{named-query-element-uuid}:
+          example: __MODEL-VERSION-ID__
+  /service-design-and-creation/models/model/{model-invariant-id}/model-vers/model-ver/{model-version-id}:
     get:
       tags:
         - ServiceDesignAndCreation
-      summary: returns named-query-element
-      description: returns named-query-element
-      operationId: getServiceDesignAndCreationNamedQueriesNamedQueryNamedQueryElementsNamedQueryElement
+      summary: returns model-ver
+      description: returns model-ver
+      operationId: getServiceDesignAndCreationModelsModelModelVersModelVer
       produces:
         - application/json
         - application/xml
@@ -15830,28 +20917,46 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/named-query-element"
+              $ref: "#/getDefinitions/model-ver"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: named-query-uuid
+        - name: model-invariant-id
           in: path
+          description: Unique identifier corresponding to the main definition of a model in ASDC
           required: true
           type: string
-        - name: named-query-element-uuid
+          example: __MODEL-INVARIANT-ID__
+        - name: model-version-id
           in: path
+          description: Unique identifier corresponding to one version of a model in ASDC
           required: true
           type: string
-        - name: named-query-name
+          example: __MODEL-VERSION-ID__
+        - name: model-type
+          in: query
+          description: Type of the model, e.g., service, resource, widget, etc.
+          required: false
+          type: string
+        - name: model-name
+          in: query
+          description: Name of the model, which can change from version to version.
+          required: false
+          type: string
+        - name: model-version
           in: query
+          description: Version
           required: false
           type: string
     put:
       tags:
         - ServiceDesignAndCreation
-      summary: create or update an existing named-query-element
-      description: create or update an existing named-query-element
-      operationId: createOrUpdateServiceDesignAndCreationNamedQueriesNamedQueryNamedQueryElementsNamedQueryElement
+      summary: create or update an existing model-ver
+      description: |
+        Create or update an existing model-ver.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateServiceDesignAndCreationModelsModelModelVersModelVer
       consumes:
         - application/json
         - application/xml
@@ -15862,26 +20967,75 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: named-query-uuid
+        - name: model-invariant-id
           in: path
+          description: Unique identifier corresponding to the main definition of a model in ASDC
           required: true
           type: string
-        - name: named-query-element-uuid
+          example: __MODEL-INVARIANT-ID__
+        - name: model-version-id
           in: path
+          description: Unique identifier corresponding to one version of a model in ASDC
           required: true
           type: string
+          example: __MODEL-VERSION-ID__
         - name: body
           in: body
-          description: named-query-element object that needs to be created or updated
+          description: model-ver object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/ServiceDesignAndCreationModelsModelModelVersModelVer.json)
           required: true
           schema:
-            $ref: "#/definitions/named-query-element"
+            $ref: "#/definitions/model-ver"
+    patch:
+      tags:
+        - ServiceDesignAndCreation
+      summary: update an existing model-ver
+      description: |
+        Update an existing model-ver
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateServiceDesignAndCreationModelsModelModelVersModelVer
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: model-invariant-id
+          in: path
+          description: Unique identifier corresponding to the main definition of a model in ASDC
+          required: true
+          type: string
+          example: __MODEL-INVARIANT-ID__
+        - name: model-version-id
+          in: path
+          description: Unique identifier corresponding to one version of a model in ASDC
+          required: true
+          type: string
+          example: __MODEL-VERSION-ID__
+        - name: body
+          in: body
+          description: model-ver object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/model-ver"
     delete:
       tags:
         - ServiceDesignAndCreation
-      summary: delete an existing named-query-element
-      description: delete an existing named-query-element
-      operationId: deleteServiceDesignAndCreationNamedQueriesNamedQueryNamedQueryElementsNamedQueryElement
+      summary: delete an existing model-ver
+      description: delete an existing model-ver
+      operationId: deleteServiceDesignAndCreationModelsModelModelVersModelVer
       consumes:
         - application/json
         - application/xml
@@ -15892,26 +21046,30 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: named-query-uuid
+        - name: model-invariant-id
           in: path
+          description: Unique identifier corresponding to the main definition of a model in ASDC
           required: true
           type: string
-        - name: named-query-element-uuid
+          example: __MODEL-INVARIANT-ID__
+        - name: model-version-id
           in: path
+          description: Unique identifier corresponding to one version of a model in ASDC
           required: true
           type: string
+          example: __MODEL-VERSION-ID__
         - name: resource-version
           in: query
           description: resource-version for concurrency
           required: true
           type: string
-  /service-design-and-creation/named-queries/named-query/{named-query-uuid}/named-query-elements:
+  /service-design-and-creation/models/model/{model-invariant-id}/model-vers:
     get:
       tags:
         - ServiceDesignAndCreation
-      summary: returns named-query-elements
-      description: returns named-query-elements
-      operationId: getServiceDesignAndCreationNamedQueriesNamedQueryNamedQueryElements
+      summary: returns model-vers
+      description: returns model-vers
+      operationId: getServiceDesignAndCreationModelsModelModelVers
       produces:
         - application/json
         - application/xml
@@ -15919,24 +21077,27 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/named-query-elements"
+              $ref: "#/getDefinitions/model-vers"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: named-query-uuid
+        - name: model-invariant-id
           in: path
+          description: Unique identifier corresponding to the main definition of a model in ASDC
           required: true
           type: string
-        - name: named-query-name
+          example: __MODEL-INVARIANT-ID__
+        - name: model-type
           in: query
+          description: Type of the model, e.g., service, resource, widget, etc.
           required: false
           type: string
-  /service-design-and-creation/named-queries/named-query/{named-query-uuid}/relationship-list/relationship:
+  /service-design-and-creation/models/model/{model-invariant-id}/relationship-list/relationship:
     put:
       tags:
         - ServiceDesignAndCreation
       summary: see node definition for valid relationships
-      operationId: createOrUpdateServiceDesignAndCreationNamedQueriesNamedQueryRelationshipListRelationship
+      operationId: createOrUpdateServiceDesignAndCreationModelsModelRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -15947,13 +21108,15 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: named-query-uuid
+        - name: model-invariant-id
           in: path
+          description: Unique identifier corresponding to the main definition of a model in ASDC
           required: true
           type: string
+          example: __MODEL-INVARIANT-ID__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/ServiceDesignAndCreationModelsModel.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -15962,7 +21125,7 @@ paths:
         - ServiceDesignAndCreation
       summary: delete an existing relationship
       description: delete an existing relationship
-      operationId: deleteServiceDesignAndCreationNamedQueriesNamedQueryRelationshipListRelationship
+      operationId: deleteServiceDesignAndCreationModelsModelRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -15973,17 +21136,19 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: named-query-uuid
+        - name: model-invariant-id
           in: path
+          description: Unique identifier corresponding to the main definition of a model in ASDC
           required: true
           type: string
-  /service-design-and-creation/named-queries/named-query/{named-query-uuid}:
+          example: __MODEL-INVARIANT-ID__
+  /service-design-and-creation/models/model/{model-invariant-id}:
     get:
       tags:
         - ServiceDesignAndCreation
-      summary: returns named-query
-      description: returns named-query
-      operationId: getServiceDesignAndCreationNamedQueriesNamedQuery
+      summary: returns model
+      description: returns model
+      operationId: getServiceDesignAndCreationModelsModel
       produces:
         - application/json
         - application/xml
@@ -15991,24 +21156,30 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/named-query"
+              $ref: "#/getDefinitions/model"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: named-query-uuid
+        - name: model-invariant-id
           in: path
+          description: Unique identifier corresponding to the main definition of a model in ASDC
           required: true
           type: string
-        - name: named-query-name
+          example: __MODEL-INVARIANT-ID__
+        - name: model-type
           in: query
+          description: Type of the model, e.g., service, resource, widget, etc.
           required: false
           type: string
     put:
       tags:
         - ServiceDesignAndCreation
-      summary: create or update an existing named-query
-      description: create or update an existing named-query
-      operationId: createOrUpdateServiceDesignAndCreationNamedQueriesNamedQuery
+      summary: create or update an existing model
+      description: |
+        Create or update an existing model.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateServiceDesignAndCreationModelsModel
       consumes:
         - application/json
         - application/xml
@@ -16019,22 +21190,63 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: named-query-uuid
+        - name: model-invariant-id
           in: path
+          description: Unique identifier corresponding to the main definition of a model in ASDC
           required: true
           type: string
+          example: __MODEL-INVARIANT-ID__
         - name: body
           in: body
-          description: named-query object that needs to be created or updated
+          description: model object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/ServiceDesignAndCreationModelsModel.json)
           required: true
           schema:
-            $ref: "#/definitions/named-query"
+            $ref: "#/definitions/model"
+    patch:
+      tags:
+        - ServiceDesignAndCreation
+      summary: update an existing model
+      description: |
+        Update an existing model
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateServiceDesignAndCreationModelsModel
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: model-invariant-id
+          in: path
+          description: Unique identifier corresponding to the main definition of a model in ASDC
+          required: true
+          type: string
+          example: __MODEL-INVARIANT-ID__
+        - name: body
+          in: body
+          description: model object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/model"
     delete:
       tags:
         - ServiceDesignAndCreation
-      summary: delete an existing named-query
-      description: delete an existing named-query
-      operationId: deleteServiceDesignAndCreationNamedQueriesNamedQuery
+      summary: delete an existing model
+      description: delete an existing model
+      operationId: deleteServiceDesignAndCreationModelsModel
       consumes:
         - application/json
         - application/xml
@@ -16045,22 +21257,24 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: named-query-uuid
+        - name: model-invariant-id
           in: path
+          description: Unique identifier corresponding to the main definition of a model in ASDC
           required: true
           type: string
+          example: __MODEL-INVARIANT-ID__
         - name: resource-version
           in: query
           description: resource-version for concurrency
           required: true
           type: string
-  /service-design-and-creation/named-queries:
+  /service-design-and-creation/models:
     get:
       tags:
         - ServiceDesignAndCreation
-      summary: returns named-queries
-      description: returns named-queries
-      operationId: getServiceDesignAndCreationNamedQueries
+      summary: returns models
+      description: returns models
+      operationId: getServiceDesignAndCreationModels
       produces:
         - application/json
         - application/xml
@@ -16068,15 +21282,15 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/named-queries"
+              $ref: "#/getDefinitions/models"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
-  /network/logical-links/logical-link/{link-name}/relationship-list/relationship:
+  /service-design-and-creation/named-queries/named-query/{named-query-uuid}/named-query-elements/named-query-element/{named-query-element-uuid}/related-lookups/related-lookup/{related-lookup-uuid}/relationship-list/relationship:
     put:
       tags:
-        - Network
+        - ServiceDesignAndCreation
       summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkLogicalLinksLogicalLinkRelationshipListRelationship
+      operationId: createOrUpdateServiceDesignAndCreationNamedQueriesNamedQueryNamedQueryElementsNamedQueryElementRelatedLookupsRelatedLookupRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -16087,23 +21301,33 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: link-name
+        - name: named-query-uuid
+          in: path
+          required: true
+          type: string
+          example: __NAMED-QUERY-UUID__
+        - name: named-query-element-uuid
+          in: path
+          required: true
+          type: string
+          example: __NAMED-QUERY-ELEMENT-UUID__
+        - name: related-lookup-uuid
           in: path
-          description: e.g., evc-name, or vnf-nameA_interface-nameA_vnf-nameZ_interface-nameZ
           required: true
           type: string
+          example: __RELATED-LOOKUP-UUID__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/ServiceDesignAndCreationNamedQueriesNamedQueryNamedQueryElementsNamedQueryElementRelatedLookupsRelatedLookup.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
     delete:
       tags:
-        - Network
+        - ServiceDesignAndCreation
       summary: delete an existing relationship
       description: delete an existing relationship
-      operationId: deleteNetworkLogicalLinksLogicalLinkRelationshipListRelationship
+      operationId: deleteServiceDesignAndCreationNamedQueriesNamedQueryNamedQueryElementsNamedQueryElementRelatedLookupsRelatedLookupRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -16114,18 +21338,28 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: link-name
+        - name: named-query-uuid
           in: path
-          description: e.g., evc-name, or vnf-nameA_interface-nameA_vnf-nameZ_interface-nameZ
           required: true
           type: string
-  /network/logical-links/logical-link/{link-name}:
+          example: __NAMED-QUERY-UUID__
+        - name: named-query-element-uuid
+          in: path
+          required: true
+          type: string
+          example: __NAMED-QUERY-ELEMENT-UUID__
+        - name: related-lookup-uuid
+          in: path
+          required: true
+          type: string
+          example: __RELATED-LOOKUP-UUID__
+  /service-design-and-creation/named-queries/named-query/{named-query-uuid}/named-query-elements/named-query-element/{named-query-element-uuid}/related-lookups/related-lookup/{related-lookup-uuid}:
     get:
       tags:
-        - Network
-      summary: returns logical-link
-      description: returns logical-link
-      operationId: getNetworkLogicalLinksLogicalLink
+        - ServiceDesignAndCreation
+      summary: returns related-lookup
+      description: returns related-lookup
+      operationId: getServiceDesignAndCreationNamedQueriesNamedQueryNamedQueryElementsNamedQueryElementRelatedLookupsRelatedLookup
       produces:
         - application/json
         - application/xml
@@ -16133,61 +21367,38 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/logical-link"
+              $ref: "#/getDefinitions/related-lookup"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: link-name
+        - name: named-query-uuid
           in: path
-          description: e.g., evc-name, or vnf-nameA_interface-nameA_vnf-nameZ_interface-nameZ
           required: true
           type: string
-        - name: model-invariant-id
-          in: query
-          description: the ASDC model id for this resource or service model.
-          required: false
-          type: string
-        - name: model-version-id
-          in: query
-          description: the ASDC model version for this resource or service model.
-          required: false
-          type: string
-        - name: widget-model-id
-          in: query
-          description: the ASDC data dictionary widget model. This maps directly to the A&AI widget.
-          required: false
-          type: string
-        - name: widget-model-version
-          in: query
-          description: the ASDC data dictionary version of the widget model.This maps directly to the A&AI version of the widget.
-          required: false
-          type: string
-        - name: prov-status
-          in: query
-          description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems.
-          required: false
-          type: string
-        - name: link-id
-          in: query
-          description: UUID of the logical-link, SDNC generates this.
-          required: false
+          example: __NAMED-QUERY-UUID__
+        - name: named-query-element-uuid
+          in: path
+          required: true
           type: string
-        - name: circuit-id
-          in: query
-          description: Circuit id
-          required: false
+          example: __NAMED-QUERY-ELEMENT-UUID__
+        - name: related-lookup-uuid
+          in: path
+          required: true
           type: string
-        - name: purpose
+          example: __RELATED-LOOKUP-UUID__
+        - name: named-query-name
           in: query
-          description: Reason for this entity, role it is playing
           required: false
           type: string
     put:
       tags:
-        - Network
-      summary: create or update an existing logical-link
-      description: create or update an existing logical-link
-      operationId: createOrUpdateNetworkLogicalLinksLogicalLink
+        - ServiceDesignAndCreation
+      summary: create or update an existing related-lookup
+      description: |
+        Create or update an existing related-lookup.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateServiceDesignAndCreationNamedQueriesNamedQueryNamedQueryElementsNamedQueryElementRelatedLookupsRelatedLookup
       consumes:
         - application/json
         - application/xml
@@ -16198,23 +21409,44 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: link-name
+        - name: named-query-uuid
+          in: path
+          required: true
+          type: string
+          example: __NAMED-QUERY-UUID__
+        - name: named-query-element-uuid
+          in: path
+          required: true
+          type: string
+          example: __NAMED-QUERY-ELEMENT-UUID__
+        - name: related-lookup-uuid
           in: path
-          description: e.g., evc-name, or vnf-nameA_interface-nameA_vnf-nameZ_interface-nameZ
           required: true
           type: string
+          example: __RELATED-LOOKUP-UUID__
         - name: body
           in: body
-          description: logical-link object that needs to be created or updated
+          description: related-lookup object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/ServiceDesignAndCreationNamedQueriesNamedQueryNamedQueryElementsNamedQueryElementRelatedLookupsRelatedLookup.json)
           required: true
           schema:
-            $ref: "#/definitions/logical-link"
-    delete:
+            $ref: "#/definitions/related-lookup"
+    patch:
       tags:
-        - Network
-      summary: delete an existing logical-link
-      description: delete an existing logical-link
-      operationId: deleteNetworkLogicalLinksLogicalLink
+        - ServiceDesignAndCreation
+      summary: update an existing related-lookup
+      description: |
+        Update an existing related-lookup
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateServiceDesignAndCreationNamedQueriesNamedQueryNamedQueryElementsNamedQueryElementRelatedLookupsRelatedLookup
       consumes:
         - application/json
         - application/xml
@@ -16225,39 +21457,33 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: link-name
+        - name: named-query-uuid
           in: path
-          description: e.g., evc-name, or vnf-nameA_interface-nameA_vnf-nameZ_interface-nameZ
           required: true
           type: string
-        - name: resource-version
-          in: query
-          description: resource-version for concurrency
+          example: __NAMED-QUERY-UUID__
+        - name: named-query-element-uuid
+          in: path
           required: true
           type: string
-  /network/logical-links:
-    get:
-      tags:
-        - Network
-      summary: returns logical-links
-      description: returns logical-links
-      operationId: getNetworkLogicalLinks
-      produces:
-        - application/json
-        - application/xml
-      responses:
-        "200":
-          description: successful operation
+          example: __NAMED-QUERY-ELEMENT-UUID__
+        - name: related-lookup-uuid
+          in: path
+          required: true
+          type: string
+          example: __RELATED-LOOKUP-UUID__
+        - name: body
+          in: body
+          description: related-lookup object that needs to be created or updated. 
+          required: true
           schema:
-              $ref: "#/definitions/logical-links"
-        "default":
-          description: Response codes found in [response codes](https://wiki.onap.org/).
-  /network/site-pair-sets/site-pair-set/{site-pair-set-id}/routing-instances/routing-instance/{routing-instance-id}/site-pairs/site-pair/{site-pair-id}/classes-of-service/class-of-service/{cos}/relationship-list/relationship:
-    put:
+            $ref: "#/patchDefinitions/related-lookup"
+    delete:
       tags:
-        - Network
-      summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkSitePairSetsSitePairSetRoutingInstancesRoutingInstanceSitePairsSitePairClassesOfServiceClassOfServiceRelationshipListRelationship
+        - ServiceDesignAndCreation
+      summary: delete an existing related-lookup
+      description: delete an existing related-lookup
+      operationId: deleteServiceDesignAndCreationNamedQueriesNamedQueryNamedQueryElementsNamedQueryElementRelatedLookupsRelatedLookup
       consumes:
         - application/json
         - application/xml
@@ -16268,75 +21494,65 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: site-pair-set-id
+        - name: named-query-uuid
           in: path
-          description: Unique id of site pair set.
           required: true
           type: string
-        - name: routing-instance-id
+          example: __NAMED-QUERY-UUID__
+        - name: named-query-element-uuid
           in: path
-          description: Unique id of routing instance
           required: true
           type: string
-        - name: site-pair-id
+          example: __NAMED-QUERY-ELEMENT-UUID__
+        - name: related-lookup-uuid
           in: path
-          description: unique identifier of probe
           required: true
           type: string
-        - name: cos
-          in: path
-          description: unique identifier of probe
+          example: __RELATED-LOOKUP-UUID__
+        - name: resource-version
+          in: query
+          description: resource-version for concurrency
           required: true
           type: string
-        - name: body
-          in: body
-          description: relationship object that needs to be created or updated
-          required: true
-          schema:
-            $ref: "#/definitions/relationship"
-    delete:
+  /service-design-and-creation/named-queries/named-query/{named-query-uuid}/named-query-elements/named-query-element/{named-query-element-uuid}/related-lookups:
+    get:
       tags:
-        - Network
-      summary: delete an existing relationship
-      description: delete an existing relationship
-      operationId: deleteNetworkSitePairSetsSitePairSetRoutingInstancesRoutingInstanceSitePairsSitePairClassesOfServiceClassOfServiceRelationshipListRelationship
-      consumes:
-        - application/json
-        - application/xml
+        - ServiceDesignAndCreation
+      summary: returns related-lookups
+      description: returns related-lookups
+      operationId: getServiceDesignAndCreationNamedQueriesNamedQueryNamedQueryElementsNamedQueryElementRelatedLookups
       produces:
         - application/json
         - application/xml
       responses:
+        "200":
+          description: successful operation
+          schema:
+              $ref: "#/getDefinitions/related-lookups"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: site-pair-set-id
-          in: path
-          description: Unique id of site pair set.
-          required: true
-          type: string
-        - name: routing-instance-id
+        - name: named-query-uuid
           in: path
-          description: Unique id of routing instance
           required: true
           type: string
-        - name: site-pair-id
+          example: __NAMED-QUERY-UUID__
+        - name: named-query-element-uuid
           in: path
-          description: unique identifier of probe
           required: true
           type: string
-        - name: cos
-          in: path
-          description: unique identifier of probe
-          required: true
+          example: __NAMED-QUERY-ELEMENT-UUID__
+        - name: named-query-name
+          in: query
+          required: false
           type: string
-  /network/site-pair-sets/site-pair-set/{site-pair-set-id}/routing-instances/routing-instance/{routing-instance-id}/site-pairs/site-pair/{site-pair-id}/classes-of-service/class-of-service/{cos}:
+  /service-design-and-creation/named-queries/named-query/{named-query-uuid}/named-query-elements/named-query-element/{named-query-element-uuid}/property-constraints/property-constraint/{property-constraint-uuid}:
     get:
       tags:
-        - Network
-      summary: returns class-of-service
-      description: returns class-of-service
-      operationId: getNetworkSitePairSetsSitePairSetRoutingInstancesRoutingInstanceSitePairsSitePairClassesOfServiceClassOfService
+        - ServiceDesignAndCreation
+      summary: returns property-constraint
+      description: returns property-constraint
+      operationId: getServiceDesignAndCreationNamedQueriesNamedQueryNamedQueryElementsNamedQueryElementPropertyConstraintsPropertyConstraint
       produces:
         - application/json
         - application/xml
@@ -16344,36 +21560,38 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/class-of-service"
+              $ref: "#/getDefinitions/property-constraint"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: site-pair-set-id
+        - name: named-query-uuid
           in: path
-          description: Unique id of site pair set.
           required: true
           type: string
-        - name: routing-instance-id
+          example: __NAMED-QUERY-UUID__
+        - name: named-query-element-uuid
           in: path
-          description: Unique id of routing instance
           required: true
           type: string
-        - name: site-pair-id
+          example: __NAMED-QUERY-ELEMENT-UUID__
+        - name: property-constraint-uuid
           in: path
-          description: unique identifier of probe
           required: true
           type: string
-        - name: cos
-          in: path
-          description: unique identifier of probe
-          required: true
+          example: __PROPERTY-CONSTRAINT-UUID__
+        - name: named-query-name
+          in: query
+          required: false
           type: string
     put:
       tags:
-        - Network
-      summary: create or update an existing class-of-service
-      description: create or update an existing class-of-service
-      operationId: createOrUpdateNetworkSitePairSetsSitePairSetRoutingInstancesRoutingInstanceSitePairsSitePairClassesOfServiceClassOfService
+        - ServiceDesignAndCreation
+      summary: create or update an existing property-constraint
+      description: |
+        Create or update an existing property-constraint.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateServiceDesignAndCreationNamedQueriesNamedQueryNamedQueryElementsNamedQueryElementPropertyConstraintsPropertyConstraint
       consumes:
         - application/json
         - application/xml
@@ -16384,38 +21602,81 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: site-pair-set-id
+        - name: named-query-uuid
           in: path
-          description: Unique id of site pair set.
           required: true
           type: string
-        - name: routing-instance-id
+          example: __NAMED-QUERY-UUID__
+        - name: named-query-element-uuid
           in: path
-          description: Unique id of routing instance
           required: true
           type: string
-        - name: site-pair-id
+          example: __NAMED-QUERY-ELEMENT-UUID__
+        - name: property-constraint-uuid
           in: path
-          description: unique identifier of probe
           required: true
           type: string
-        - name: cos
+          example: __PROPERTY-CONSTRAINT-UUID__
+        - name: body
+          in: body
+          description: property-constraint object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/ServiceDesignAndCreationNamedQueriesNamedQueryNamedQueryElementsNamedQueryElementPropertyConstraintsPropertyConstraint.json)
+          required: true
+          schema:
+            $ref: "#/definitions/property-constraint"
+    patch:
+      tags:
+        - ServiceDesignAndCreation
+      summary: update an existing property-constraint
+      description: |
+        Update an existing property-constraint
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateServiceDesignAndCreationNamedQueriesNamedQueryNamedQueryElementsNamedQueryElementPropertyConstraintsPropertyConstraint
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: named-query-uuid
+          in: path
+          required: true
+          type: string
+          example: __NAMED-QUERY-UUID__
+        - name: named-query-element-uuid
+          in: path
+          required: true
+          type: string
+          example: __NAMED-QUERY-ELEMENT-UUID__
+        - name: property-constraint-uuid
           in: path
-          description: unique identifier of probe
           required: true
           type: string
+          example: __PROPERTY-CONSTRAINT-UUID__
         - name: body
           in: body
-          description: class-of-service object that needs to be created or updated
+          description: property-constraint object that needs to be created or updated. 
           required: true
           schema:
-            $ref: "#/definitions/class-of-service"
+            $ref: "#/patchDefinitions/property-constraint"
     delete:
       tags:
-        - Network
-      summary: delete an existing class-of-service
-      description: delete an existing class-of-service
-      operationId: deleteNetworkSitePairSetsSitePairSetRoutingInstancesRoutingInstanceSitePairsSitePairClassesOfServiceClassOfService
+        - ServiceDesignAndCreation
+      summary: delete an existing property-constraint
+      description: delete an existing property-constraint
+      operationId: deleteServiceDesignAndCreationNamedQueriesNamedQueryNamedQueryElementsNamedQueryElementPropertyConstraintsPropertyConstraint
       consumes:
         - application/json
         - application/xml
@@ -16426,38 +21687,33 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: site-pair-set-id
-          in: path
-          description: Unique id of site pair set.
-          required: true
-          type: string
-        - name: routing-instance-id
+        - name: named-query-uuid
           in: path
-          description: Unique id of routing instance
           required: true
           type: string
-        - name: site-pair-id
+          example: __NAMED-QUERY-UUID__
+        - name: named-query-element-uuid
           in: path
-          description: unique identifier of probe
           required: true
           type: string
-        - name: cos
+          example: __NAMED-QUERY-ELEMENT-UUID__
+        - name: property-constraint-uuid
           in: path
-          description: unique identifier of probe
           required: true
           type: string
+          example: __PROPERTY-CONSTRAINT-UUID__
         - name: resource-version
           in: query
           description: resource-version for concurrency
           required: true
           type: string
-  /network/site-pair-sets/site-pair-set/{site-pair-set-id}/routing-instances/routing-instance/{routing-instance-id}/site-pairs/site-pair/{site-pair-id}/classes-of-service:
+  /service-design-and-creation/named-queries/named-query/{named-query-uuid}/named-query-elements/named-query-element/{named-query-element-uuid}/property-constraints:
     get:
       tags:
-        - Network
-      summary: returns classes-of-service
-      description: returns classes-of-service
-      operationId: getNetworkSitePairSetsSitePairSetRoutingInstancesRoutingInstanceSitePairsSitePairClassesOfService
+        - ServiceDesignAndCreation
+      summary: returns property-constraints
+      description: returns property-constraints
+      operationId: getServiceDesignAndCreationNamedQueriesNamedQueryNamedQueryElementsNamedQueryElementPropertyConstraints
       produces:
         - application/json
         - application/xml
@@ -16465,31 +21721,30 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/classes-of-service"
+              $ref: "#/getDefinitions/property-constraints"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: site-pair-set-id
+        - name: named-query-uuid
           in: path
-          description: Unique id of site pair set.
           required: true
           type: string
-        - name: routing-instance-id
+          example: __NAMED-QUERY-UUID__
+        - name: named-query-element-uuid
           in: path
-          description: Unique id of routing instance
           required: true
           type: string
-        - name: site-pair-id
-          in: path
-          description: unique identifier of probe
-          required: true
+          example: __NAMED-QUERY-ELEMENT-UUID__
+        - name: named-query-name
+          in: query
+          required: false
           type: string
-  /network/site-pair-sets/site-pair-set/{site-pair-set-id}/routing-instances/routing-instance/{routing-instance-id}/site-pairs/site-pair/{site-pair-id}/relationship-list/relationship:
+  /service-design-and-creation/named-queries/named-query/{named-query-uuid}/named-query-elements/named-query-element/{named-query-element-uuid}/relationship-list/relationship:
     put:
       tags:
-        - Network
+        - ServiceDesignAndCreation
       summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkSitePairSetsSitePairSetRoutingInstancesRoutingInstanceSitePairsSitePairRelationshipListRelationship
+      operationId: createOrUpdateServiceDesignAndCreationNamedQueriesNamedQueryNamedQueryElementsNamedQueryElementRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -16500,33 +21755,28 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: site-pair-set-id
-          in: path
-          description: Unique id of site pair set.
-          required: true
-          type: string
-        - name: routing-instance-id
+        - name: named-query-uuid
           in: path
-          description: Unique id of routing instance
           required: true
           type: string
-        - name: site-pair-id
+          example: __NAMED-QUERY-UUID__
+        - name: named-query-element-uuid
           in: path
-          description: unique identifier of probe
           required: true
           type: string
+          example: __NAMED-QUERY-ELEMENT-UUID__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/ServiceDesignAndCreationNamedQueriesNamedQueryNamedQueryElementsNamedQueryElement.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
     delete:
       tags:
-        - Network
+        - ServiceDesignAndCreation
       summary: delete an existing relationship
       description: delete an existing relationship
-      operationId: deleteNetworkSitePairSetsSitePairSetRoutingInstancesRoutingInstanceSitePairsSitePairRelationshipListRelationship
+      operationId: deleteServiceDesignAndCreationNamedQueriesNamedQueryNamedQueryElementsNamedQueryElementRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -16537,28 +21787,23 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: site-pair-set-id
-          in: path
-          description: Unique id of site pair set.
-          required: true
-          type: string
-        - name: routing-instance-id
+        - name: named-query-uuid
           in: path
-          description: Unique id of routing instance
           required: true
           type: string
-        - name: site-pair-id
+          example: __NAMED-QUERY-UUID__
+        - name: named-query-element-uuid
           in: path
-          description: unique identifier of probe
           required: true
           type: string
-  /network/site-pair-sets/site-pair-set/{site-pair-set-id}/routing-instances/routing-instance/{routing-instance-id}/site-pairs/site-pair/{site-pair-id}:
+          example: __NAMED-QUERY-ELEMENT-UUID__
+  /service-design-and-creation/named-queries/named-query/{named-query-uuid}/named-query-elements/named-query-element/{named-query-element-uuid}:
     get:
       tags:
-        - Network
-      summary: returns site-pair
-      description: returns site-pair
-      operationId: getNetworkSitePairSetsSitePairSetRoutingInstancesRoutingInstanceSitePairsSitePair
+        - ServiceDesignAndCreation
+      summary: returns named-query-element
+      description: returns named-query-element
+      operationId: getServiceDesignAndCreationNamedQueriesNamedQueryNamedQueryElementsNamedQueryElement
       produces:
         - application/json
         - application/xml
@@ -16566,31 +21811,33 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/site-pair"
+              $ref: "#/getDefinitions/named-query-element"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: site-pair-set-id
+        - name: named-query-uuid
           in: path
-          description: Unique id of site pair set.
           required: true
           type: string
-        - name: routing-instance-id
+          example: __NAMED-QUERY-UUID__
+        - name: named-query-element-uuid
           in: path
-          description: Unique id of routing instance
           required: true
           type: string
-        - name: site-pair-id
-          in: path
-          description: unique identifier of probe
-          required: true
+          example: __NAMED-QUERY-ELEMENT-UUID__
+        - name: named-query-name
+          in: query
+          required: false
           type: string
     put:
       tags:
-        - Network
-      summary: create or update an existing site-pair
-      description: create or update an existing site-pair
-      operationId: createOrUpdateNetworkSitePairSetsSitePairSetRoutingInstancesRoutingInstanceSitePairsSitePair
+        - ServiceDesignAndCreation
+      summary: create or update an existing named-query-element
+      description: |
+        Create or update an existing named-query-element.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateServiceDesignAndCreationNamedQueriesNamedQueryNamedQueryElementsNamedQueryElement
       consumes:
         - application/json
         - application/xml
@@ -16601,33 +21848,71 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: site-pair-set-id
+        - name: named-query-uuid
           in: path
-          description: Unique id of site pair set.
           required: true
           type: string
-        - name: routing-instance-id
+          example: __NAMED-QUERY-UUID__
+        - name: named-query-element-uuid
           in: path
-          description: Unique id of routing instance
           required: true
           type: string
-        - name: site-pair-id
+          example: __NAMED-QUERY-ELEMENT-UUID__
+        - name: body
+          in: body
+          description: named-query-element object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/ServiceDesignAndCreationNamedQueriesNamedQueryNamedQueryElementsNamedQueryElement.json)
+          required: true
+          schema:
+            $ref: "#/definitions/named-query-element"
+    patch:
+      tags:
+        - ServiceDesignAndCreation
+      summary: update an existing named-query-element
+      description: |
+        Update an existing named-query-element
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateServiceDesignAndCreationNamedQueriesNamedQueryNamedQueryElementsNamedQueryElement
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: named-query-uuid
+          in: path
+          required: true
+          type: string
+          example: __NAMED-QUERY-UUID__
+        - name: named-query-element-uuid
           in: path
-          description: unique identifier of probe
           required: true
           type: string
+          example: __NAMED-QUERY-ELEMENT-UUID__
         - name: body
           in: body
-          description: site-pair object that needs to be created or updated
+          description: named-query-element object that needs to be created or updated. 
           required: true
           schema:
-            $ref: "#/definitions/site-pair"
+            $ref: "#/patchDefinitions/named-query-element"
     delete:
       tags:
-        - Network
-      summary: delete an existing site-pair
-      description: delete an existing site-pair
-      operationId: deleteNetworkSitePairSetsSitePairSetRoutingInstancesRoutingInstanceSitePairsSitePair
+        - ServiceDesignAndCreation
+      summary: delete an existing named-query-element
+      description: delete an existing named-query-element
+      operationId: deleteServiceDesignAndCreationNamedQueriesNamedQueryNamedQueryElementsNamedQueryElement
       consumes:
         - application/json
         - application/xml
@@ -16638,33 +21923,28 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: site-pair-set-id
-          in: path
-          description: Unique id of site pair set.
-          required: true
-          type: string
-        - name: routing-instance-id
+        - name: named-query-uuid
           in: path
-          description: Unique id of routing instance
           required: true
           type: string
-        - name: site-pair-id
+          example: __NAMED-QUERY-UUID__
+        - name: named-query-element-uuid
           in: path
-          description: unique identifier of probe
           required: true
           type: string
+          example: __NAMED-QUERY-ELEMENT-UUID__
         - name: resource-version
           in: query
           description: resource-version for concurrency
           required: true
           type: string
-  /network/site-pair-sets/site-pair-set/{site-pair-set-id}/routing-instances/routing-instance/{routing-instance-id}/site-pairs:
+  /service-design-and-creation/named-queries/named-query/{named-query-uuid}/named-query-elements:
     get:
       tags:
-        - Network
-      summary: returns site-pairs
-      description: returns site-pairs
-      operationId: getNetworkSitePairSetsSitePairSetRoutingInstancesRoutingInstanceSitePairs
+        - ServiceDesignAndCreation
+      summary: returns named-query-elements
+      description: returns named-query-elements
+      operationId: getServiceDesignAndCreationNamedQueriesNamedQueryNamedQueryElements
       produces:
         - application/json
         - application/xml
@@ -16672,26 +21952,25 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/site-pairs"
+              $ref: "#/getDefinitions/named-query-elements"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: site-pair-set-id
+        - name: named-query-uuid
           in: path
-          description: Unique id of site pair set.
           required: true
           type: string
-        - name: routing-instance-id
-          in: path
-          description: Unique id of routing instance
-          required: true
+          example: __NAMED-QUERY-UUID__
+        - name: named-query-name
+          in: query
+          required: false
           type: string
-  /network/site-pair-sets/site-pair-set/{site-pair-set-id}/routing-instances/routing-instance/{routing-instance-id}/relationship-list/relationship:
+  /service-design-and-creation/named-queries/named-query/{named-query-uuid}/relationship-list/relationship:
     put:
       tags:
-        - Network
+        - ServiceDesignAndCreation
       summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkSitePairSetsSitePairSetRoutingInstancesRoutingInstanceRelationshipListRelationship
+      operationId: createOrUpdateServiceDesignAndCreationNamedQueriesNamedQueryRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -16702,28 +21981,23 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: site-pair-set-id
-          in: path
-          description: Unique id of site pair set.
-          required: true
-          type: string
-        - name: routing-instance-id
+        - name: named-query-uuid
           in: path
-          description: Unique id of routing instance
           required: true
           type: string
+          example: __NAMED-QUERY-UUID__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/ServiceDesignAndCreationNamedQueriesNamedQuery.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
     delete:
       tags:
-        - Network
+        - ServiceDesignAndCreation
       summary: delete an existing relationship
       description: delete an existing relationship
-      operationId: deleteNetworkSitePairSetsSitePairSetRoutingInstancesRoutingInstanceRelationshipListRelationship
+      operationId: deleteServiceDesignAndCreationNamedQueriesNamedQueryRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -16734,23 +22008,18 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: site-pair-set-id
-          in: path
-          description: Unique id of site pair set.
-          required: true
-          type: string
-        - name: routing-instance-id
+        - name: named-query-uuid
           in: path
-          description: Unique id of routing instance
           required: true
           type: string
-  /network/site-pair-sets/site-pair-set/{site-pair-set-id}/routing-instances/routing-instance/{routing-instance-id}:
+          example: __NAMED-QUERY-UUID__
+  /service-design-and-creation/named-queries/named-query/{named-query-uuid}:
     get:
       tags:
-        - Network
-      summary: returns routing-instance
-      description: returns routing-instance
-      operationId: getNetworkSitePairSetsSitePairSetRoutingInstancesRoutingInstance
+        - ServiceDesignAndCreation
+      summary: returns named-query
+      description: returns named-query
+      operationId: getServiceDesignAndCreationNamedQueriesNamedQuery
       produces:
         - application/json
         - application/xml
@@ -16758,26 +22027,28 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/routing-instance"
+              $ref: "#/getDefinitions/named-query"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: site-pair-set-id
+        - name: named-query-uuid
           in: path
-          description: Unique id of site pair set.
           required: true
           type: string
-        - name: routing-instance-id
-          in: path
-          description: Unique id of routing instance
-          required: true
+          example: __NAMED-QUERY-UUID__
+        - name: named-query-name
+          in: query
+          required: false
           type: string
     put:
       tags:
-        - Network
-      summary: create or update an existing routing-instance
-      description: create or update an existing routing-instance
-      operationId: createOrUpdateNetworkSitePairSetsSitePairSetRoutingInstancesRoutingInstance
+        - ServiceDesignAndCreation
+      summary: create or update an existing named-query
+      description: |
+        Create or update an existing named-query.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateServiceDesignAndCreationNamedQueriesNamedQuery
       consumes:
         - application/json
         - application/xml
@@ -16788,28 +22059,61 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: site-pair-set-id
+        - name: named-query-uuid
           in: path
-          description: Unique id of site pair set.
           required: true
           type: string
-        - name: routing-instance-id
+          example: __NAMED-QUERY-UUID__
+        - name: body
+          in: body
+          description: named-query object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/ServiceDesignAndCreationNamedQueriesNamedQuery.json)
+          required: true
+          schema:
+            $ref: "#/definitions/named-query"
+    patch:
+      tags:
+        - ServiceDesignAndCreation
+      summary: update an existing named-query
+      description: |
+        Update an existing named-query
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateServiceDesignAndCreationNamedQueriesNamedQuery
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: named-query-uuid
           in: path
-          description: Unique id of routing instance
           required: true
           type: string
+          example: __NAMED-QUERY-UUID__
         - name: body
           in: body
-          description: routing-instance object that needs to be created or updated
+          description: named-query object that needs to be created or updated. 
           required: true
           schema:
-            $ref: "#/definitions/routing-instance"
+            $ref: "#/patchDefinitions/named-query"
     delete:
       tags:
-        - Network
-      summary: delete an existing routing-instance
-      description: delete an existing routing-instance
-      operationId: deleteNetworkSitePairSetsSitePairSetRoutingInstancesRoutingInstance
+        - ServiceDesignAndCreation
+      summary: delete an existing named-query
+      description: delete an existing named-query
+      operationId: deleteServiceDesignAndCreationNamedQueriesNamedQuery
       consumes:
         - application/json
         - application/xml
@@ -16820,28 +22124,23 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: site-pair-set-id
-          in: path
-          description: Unique id of site pair set.
-          required: true
-          type: string
-        - name: routing-instance-id
+        - name: named-query-uuid
           in: path
-          description: Unique id of routing instance
           required: true
           type: string
+          example: __NAMED-QUERY-UUID__
         - name: resource-version
           in: query
           description: resource-version for concurrency
           required: true
           type: string
-  /network/site-pair-sets/site-pair-set/{site-pair-set-id}/routing-instances:
+  /service-design-and-creation/named-queries:
     get:
       tags:
-        - Network
-      summary: returns routing-instances
-      description: returns routing-instances
-      operationId: getNetworkSitePairSetsSitePairSetRoutingInstances
+        - ServiceDesignAndCreation
+      summary: returns named-queries
+      description: returns named-queries
+      operationId: getServiceDesignAndCreationNamedQueries
       produces:
         - application/json
         - application/xml
@@ -16849,21 +22148,15 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/routing-instances"
+              $ref: "#/getDefinitions/named-queries"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
-      parameters:
-        - name: site-pair-set-id
-          in: path
-          description: Unique id of site pair set.
-          required: true
-          type: string
-  /network/site-pair-sets/site-pair-set/{site-pair-set-id}/relationship-list/relationship:
+  /network/logical-links/logical-link/{link-name}/relationship-list/relationship:
     put:
       tags:
         - Network
       summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkSitePairSetsSitePairSetRelationshipListRelationship
+      operationId: createOrUpdateNetworkLogicalLinksLogicalLinkRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -16874,14 +22167,15 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: site-pair-set-id
+        - name: link-name
           in: path
-          description: Unique id of site pair set.
+          description: e.g., evc-name, or vnf-nameA_interface-nameA_vnf-nameZ_interface-nameZ
           required: true
           type: string
+          example: __LINK-NAME__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkLogicalLinksLogicalLink.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -16890,7 +22184,7 @@ paths:
         - Network
       summary: delete an existing relationship
       description: delete an existing relationship
-      operationId: deleteNetworkSitePairSetsSitePairSetRelationshipListRelationship
+      operationId: deleteNetworkLogicalLinksLogicalLinkRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -16901,18 +22195,19 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: site-pair-set-id
+        - name: link-name
           in: path
-          description: Unique id of site pair set.
+          description: e.g., evc-name, or vnf-nameA_interface-nameA_vnf-nameZ_interface-nameZ
           required: true
           type: string
-  /network/site-pair-sets/site-pair-set/{site-pair-set-id}:
+          example: __LINK-NAME__
+  /network/logical-links/logical-link/{link-name}:
     get:
       tags:
         - Network
-      summary: returns site-pair-set
-      description: returns site-pair-set
-      operationId: getNetworkSitePairSetsSitePairSet
+      summary: returns logical-link
+      description: returns logical-link
+      operationId: getNetworkLogicalLinksLogicalLink
       produces:
         - application/json
         - application/xml
@@ -16920,21 +22215,65 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/site-pair-set"
+              $ref: "#/getDefinitions/logical-link"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: site-pair-set-id
+        - name: link-name
           in: path
-          description: Unique id of site pair set.
+          description: e.g., evc-name, or vnf-nameA_interface-nameA_vnf-nameZ_interface-nameZ
           required: true
           type: string
+          example: __LINK-NAME__
+        - name: model-invariant-id
+          in: query
+          description: the ASDC model id for this resource or service model.
+          required: false
+          type: string
+        - name: model-version-id
+          in: query
+          description: the ASDC model version for this resource or service model.
+          required: false
+          type: string
+        - name: widget-model-id
+          in: query
+          description: the ASDC data dictionary widget model. This maps directly to the A&AI widget.
+          required: false
+          type: string
+        - name: widget-model-version
+          in: query
+          description: the ASDC data dictionary version of the widget model.This maps directly to the A&AI version of the widget.
+          required: false
+          type: string
+        - name: prov-status
+          in: query
+          description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems.
+          required: false
+          type: string
+        - name: link-id
+          in: query
+          description: UUID of the logical-link, SDNC generates this.
+          required: false
+          type: string
+        - name: circuit-id
+          in: query
+          description: Circuit id
+          required: false
+          type: string
+        - name: purpose
+          in: query
+          description: Reason for this entity, role it is playing
+          required: false
+          type: string
     put:
       tags:
         - Network
-      summary: create or update an existing site-pair-set
-      description: create or update an existing site-pair-set
-      operationId: createOrUpdateNetworkSitePairSetsSitePairSet
+      summary: create or update an existing logical-link
+      description: |
+        Create or update an existing logical-link.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkLogicalLinksLogicalLink
       consumes:
         - application/json
         - application/xml
@@ -16945,23 +22284,35 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: site-pair-set-id
+        - name: link-name
           in: path
-          description: Unique id of site pair set.
+          description: e.g., evc-name, or vnf-nameA_interface-nameA_vnf-nameZ_interface-nameZ
           required: true
           type: string
+          example: __LINK-NAME__
         - name: body
           in: body
-          description: site-pair-set object that needs to be created or updated
+          description: logical-link object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkLogicalLinksLogicalLink.json)
           required: true
           schema:
-            $ref: "#/definitions/site-pair-set"
-    delete:
+            $ref: "#/definitions/logical-link"
+    patch:
       tags:
         - Network
-      summary: delete an existing site-pair-set
-      description: delete an existing site-pair-set
-      operationId: deleteNetworkSitePairSetsSitePairSet
+      summary: update an existing logical-link
+      description: |
+        Update an existing logical-link
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkLogicalLinksLogicalLink
       consumes:
         - application/json
         - application/xml
@@ -16972,39 +22323,68 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: site-pair-set-id
+        - name: link-name
           in: path
-          description: Unique id of site pair set.
+          description: e.g., evc-name, or vnf-nameA_interface-nameA_vnf-nameZ_interface-nameZ
           required: true
           type: string
-        - name: resource-version
-          in: query
-          description: resource-version for concurrency
+          example: __LINK-NAME__
+        - name: body
+          in: body
+          description: logical-link object that needs to be created or updated. 
           required: true
-          type: string
-  /network/site-pair-sets:
-    get:
+          schema:
+            $ref: "#/patchDefinitions/logical-link"
+    delete:
       tags:
         - Network
-      summary: returns site-pair-sets
-      description: returns site-pair-sets
-      operationId: getNetworkSitePairSets
+      summary: delete an existing logical-link
+      description: delete an existing logical-link
+      operationId: deleteNetworkLogicalLinksLogicalLink
+      consumes:
+        - application/json
+        - application/xml
       produces:
         - application/json
         - application/xml
       responses:
-        "200":
-          description: successful operation
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: link-name
+          in: path
+          description: e.g., evc-name, or vnf-nameA_interface-nameA_vnf-nameZ_interface-nameZ
+          required: true
+          type: string
+          example: __LINK-NAME__
+        - name: resource-version
+          in: query
+          description: resource-version for concurrency
+          required: true
+          type: string
+  /network/logical-links:
+    get:
+      tags:
+        - Network
+      summary: returns logical-links
+      description: returns logical-links
+      operationId: getNetworkLogicalLinks
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "200":
+          description: successful operation
           schema:
-              $ref: "#/definitions/site-pair-sets"
+              $ref: "#/getDefinitions/logical-links"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
-  /network/vpn-bindings/vpn-binding/{vpn-id}/route-targets/route-target/{global-route-target}/{route-target-role}/relationship-list/relationship:
+  /network/site-pair-sets/site-pair-set/{site-pair-set-id}/routing-instances/routing-instance/{routing-instance-id}/site-pairs/site-pair/{site-pair-id}/classes-of-service/class-of-service/{cos}/relationship-list/relationship:
     put:
       tags:
         - Network
       summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkVpnBindingsVpnBindingRouteTargetsRouteTargetRelationshipListRelationship
+      operationId: createOrUpdateNetworkSitePairSetsSitePairSetRoutingInstancesRoutingInstanceSitePairsSitePairClassesOfServiceClassOfServiceRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -17015,24 +22395,33 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vpn-id
+        - name: site-pair-set-id
           in: path
-          description: VPN ID, globally unique within A&AI
+          description: Unique id of site pair set.
           required: true
           type: string
-        - name: global-route-target
+          example: __SITE-PAIR-SET-ID__
+        - name: routing-instance-id
           in: path
-          description: Number used to identify an RT, globally unique in the network
+          description: Unique id of routing instance
           required: true
           type: string
-        - name: route-target-role
+          example: __ROUTING-INSTANCE-ID__
+        - name: site-pair-id
           in: path
-          description: Role assigned to this route target
+          description: unique identifier of probe
+          required: true
+          type: string
+          example: __SITE-PAIR-ID__
+        - name: cos
+          in: path
+          description: unique identifier of probe
           required: true
           type: string
+          example: __COS__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkSitePairSetsSitePairSetRoutingInstancesRoutingInstanceSitePairsSitePairClassesOfServiceClassOfService.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -17041,7 +22430,7 @@ paths:
         - Network
       summary: delete an existing relationship
       description: delete an existing relationship
-      operationId: deleteNetworkVpnBindingsVpnBindingRouteTargetsRouteTargetRelationshipListRelationship
+      operationId: deleteNetworkSitePairSetsSitePairSetRoutingInstancesRoutingInstanceSitePairsSitePairClassesOfServiceClassOfServiceRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -17052,28 +22441,37 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vpn-id
+        - name: site-pair-set-id
           in: path
-          description: VPN ID, globally unique within A&AI
+          description: Unique id of site pair set.
           required: true
           type: string
-        - name: global-route-target
+          example: __SITE-PAIR-SET-ID__
+        - name: routing-instance-id
           in: path
-          description: Number used to identify an RT, globally unique in the network
+          description: Unique id of routing instance
           required: true
           type: string
-        - name: route-target-role
+          example: __ROUTING-INSTANCE-ID__
+        - name: site-pair-id
           in: path
-          description: Role assigned to this route target
+          description: unique identifier of probe
           required: true
           type: string
-  /network/vpn-bindings/vpn-binding/{vpn-id}/route-targets/route-target/{global-route-target}/{route-target-role}:
+          example: __SITE-PAIR-ID__
+        - name: cos
+          in: path
+          description: unique identifier of probe
+          required: true
+          type: string
+          example: __COS__
+  /network/site-pair-sets/site-pair-set/{site-pair-set-id}/routing-instances/routing-instance/{routing-instance-id}/site-pairs/site-pair/{site-pair-id}/classes-of-service/class-of-service/{cos}:
     get:
       tags:
         - Network
-      summary: returns route-target
-      description: returns route-target
-      operationId: getNetworkVpnBindingsVpnBindingRouteTargetsRouteTarget
+      summary: returns class-of-service
+      description: returns class-of-service
+      operationId: getNetworkSitePairSetsSitePairSetRoutingInstancesRoutingInstanceSitePairsSitePairClassesOfServiceClassOfService
       produces:
         - application/json
         - application/xml
@@ -17081,41 +22479,43 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/route-target"
+              $ref: "#/getDefinitions/class-of-service"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vpn-id
+        - name: site-pair-set-id
           in: path
-          description: VPN ID, globally unique within A&AI
+          description: Unique id of site pair set.
           required: true
           type: string
-        - name: global-route-target
+          example: __SITE-PAIR-SET-ID__
+        - name: routing-instance-id
           in: path
-          description: Number used to identify an RT, globally unique in the network
+          description: Unique id of routing instance
           required: true
           type: string
-        - name: route-target-role
+          example: __ROUTING-INSTANCE-ID__
+        - name: site-pair-id
           in: path
-          description: Role assigned to this route target
+          description: unique identifier of probe
           required: true
           type: string
-        - name: vpn-name
-          in: query
-          description: VPN Name
-          required: false
-          type: string
-        - name: vpn-type
-          in: query
-          description: Type of the vpn, should be taken from enumerated/valid values
-          required: false
+          example: __SITE-PAIR-ID__
+        - name: cos
+          in: path
+          description: unique identifier of probe
+          required: true
           type: string
+          example: __COS__
     put:
       tags:
         - Network
-      summary: create or update an existing route-target
-      description: create or update an existing route-target
-      operationId: createOrUpdateNetworkVpnBindingsVpnBindingRouteTargetsRouteTarget
+      summary: create or update an existing class-of-service
+      description: |
+        Create or update an existing class-of-service.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkSitePairSetsSitePairSetRoutingInstancesRoutingInstanceSitePairsSitePairClassesOfServiceClassOfService
       consumes:
         - application/json
         - application/xml
@@ -17126,33 +22526,99 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vpn-id
+        - name: site-pair-set-id
           in: path
-          description: VPN ID, globally unique within A&AI
+          description: Unique id of site pair set.
           required: true
           type: string
-        - name: global-route-target
+          example: __SITE-PAIR-SET-ID__
+        - name: routing-instance-id
           in: path
-          description: Number used to identify an RT, globally unique in the network
+          description: Unique id of routing instance
           required: true
           type: string
-        - name: route-target-role
+          example: __ROUTING-INSTANCE-ID__
+        - name: site-pair-id
           in: path
-          description: Role assigned to this route target
+          description: unique identifier of probe
+          required: true
+          type: string
+          example: __SITE-PAIR-ID__
+        - name: cos
+          in: path
+          description: unique identifier of probe
           required: true
           type: string
+          example: __COS__
         - name: body
           in: body
-          description: route-target object that needs to be created or updated
+          description: class-of-service object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkSitePairSetsSitePairSetRoutingInstancesRoutingInstanceSitePairsSitePairClassesOfServiceClassOfService.json)
           required: true
           schema:
-            $ref: "#/definitions/route-target"
+            $ref: "#/definitions/class-of-service"
+    patch:
+      tags:
+        - Network
+      summary: update an existing class-of-service
+      description: |
+        Update an existing class-of-service
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkSitePairSetsSitePairSetRoutingInstancesRoutingInstanceSitePairsSitePairClassesOfServiceClassOfService
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: site-pair-set-id
+          in: path
+          description: Unique id of site pair set.
+          required: true
+          type: string
+          example: __SITE-PAIR-SET-ID__
+        - name: routing-instance-id
+          in: path
+          description: Unique id of routing instance
+          required: true
+          type: string
+          example: __ROUTING-INSTANCE-ID__
+        - name: site-pair-id
+          in: path
+          description: unique identifier of probe
+          required: true
+          type: string
+          example: __SITE-PAIR-ID__
+        - name: cos
+          in: path
+          description: unique identifier of probe
+          required: true
+          type: string
+          example: __COS__
+        - name: body
+          in: body
+          description: class-of-service object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/class-of-service"
     delete:
       tags:
         - Network
-      summary: delete an existing route-target
-      description: delete an existing route-target
-      operationId: deleteNetworkVpnBindingsVpnBindingRouteTargetsRouteTarget
+      summary: delete an existing class-of-service
+      description: delete an existing class-of-service
+      operationId: deleteNetworkSitePairSetsSitePairSetRoutingInstancesRoutingInstanceSitePairsSitePairClassesOfServiceClassOfService
       consumes:
         - application/json
         - application/xml
@@ -17163,33 +22629,42 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vpn-id
+        - name: site-pair-set-id
           in: path
-          description: VPN ID, globally unique within A&AI
+          description: Unique id of site pair set.
           required: true
           type: string
-        - name: global-route-target
+          example: __SITE-PAIR-SET-ID__
+        - name: routing-instance-id
           in: path
-          description: Number used to identify an RT, globally unique in the network
+          description: Unique id of routing instance
           required: true
           type: string
-        - name: route-target-role
+          example: __ROUTING-INSTANCE-ID__
+        - name: site-pair-id
           in: path
-          description: Role assigned to this route target
+          description: unique identifier of probe
           required: true
           type: string
+          example: __SITE-PAIR-ID__
+        - name: cos
+          in: path
+          description: unique identifier of probe
+          required: true
+          type: string
+          example: __COS__
         - name: resource-version
           in: query
           description: resource-version for concurrency
           required: true
           type: string
-  /network/vpn-bindings/vpn-binding/{vpn-id}/route-targets:
+  /network/site-pair-sets/site-pair-set/{site-pair-set-id}/routing-instances/routing-instance/{routing-instance-id}/site-pairs/site-pair/{site-pair-id}/classes-of-service:
     get:
       tags:
         - Network
-      summary: returns route-targets
-      description: returns route-targets
-      operationId: getNetworkVpnBindingsVpnBindingRouteTargets
+      summary: returns classes-of-service
+      description: returns classes-of-service
+      operationId: getNetworkSitePairSetsSitePairSetRoutingInstancesRoutingInstanceSitePairsSitePairClassesOfService
       produces:
         - application/json
         - application/xml
@@ -17197,31 +22672,34 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/route-targets"
+              $ref: "#/getDefinitions/classes-of-service"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vpn-id
+        - name: site-pair-set-id
           in: path
-          description: VPN ID, globally unique within A&AI
+          description: Unique id of site pair set.
           required: true
           type: string
-        - name: vpn-name
-          in: query
-          description: VPN Name
-          required: false
+          example: __SITE-PAIR-SET-ID__
+        - name: routing-instance-id
+          in: path
+          description: Unique id of routing instance
+          required: true
           type: string
-        - name: vpn-type
-          in: query
-          description: Type of the vpn, should be taken from enumerated/valid values
-          required: false
+          example: __ROUTING-INSTANCE-ID__
+        - name: site-pair-id
+          in: path
+          description: unique identifier of probe
+          required: true
           type: string
-  /network/vpn-bindings/vpn-binding/{vpn-id}/relationship-list/relationship:
+          example: __SITE-PAIR-ID__
+  /network/site-pair-sets/site-pair-set/{site-pair-set-id}/routing-instances/routing-instance/{routing-instance-id}/site-pairs/site-pair/{site-pair-id}/relationship-list/relationship:
     put:
       tags:
         - Network
       summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkVpnBindingsVpnBindingRelationshipListRelationship
+      operationId: createOrUpdateNetworkSitePairSetsSitePairSetRoutingInstancesRoutingInstanceSitePairsSitePairRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -17232,14 +22710,27 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vpn-id
+        - name: site-pair-set-id
           in: path
-          description: VPN ID, globally unique within A&AI
+          description: Unique id of site pair set.
+          required: true
+          type: string
+          example: __SITE-PAIR-SET-ID__
+        - name: routing-instance-id
+          in: path
+          description: Unique id of routing instance
+          required: true
+          type: string
+          example: __ROUTING-INSTANCE-ID__
+        - name: site-pair-id
+          in: path
+          description: unique identifier of probe
           required: true
           type: string
+          example: __SITE-PAIR-ID__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkSitePairSetsSitePairSetRoutingInstancesRoutingInstanceSitePairsSitePair.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -17248,7 +22739,7 @@ paths:
         - Network
       summary: delete an existing relationship
       description: delete an existing relationship
-      operationId: deleteNetworkVpnBindingsVpnBindingRelationshipListRelationship
+      operationId: deleteNetworkSitePairSetsSitePairSetRoutingInstancesRoutingInstanceSitePairsSitePairRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -17259,18 +22750,31 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vpn-id
+        - name: site-pair-set-id
           in: path
-          description: VPN ID, globally unique within A&AI
+          description: Unique id of site pair set.
           required: true
           type: string
-  /network/vpn-bindings/vpn-binding/{vpn-id}:
+          example: __SITE-PAIR-SET-ID__
+        - name: routing-instance-id
+          in: path
+          description: Unique id of routing instance
+          required: true
+          type: string
+          example: __ROUTING-INSTANCE-ID__
+        - name: site-pair-id
+          in: path
+          description: unique identifier of probe
+          required: true
+          type: string
+          example: __SITE-PAIR-ID__
+  /network/site-pair-sets/site-pair-set/{site-pair-set-id}/routing-instances/routing-instance/{routing-instance-id}/site-pairs/site-pair/{site-pair-id}:
     get:
       tags:
         - Network
-      summary: returns vpn-binding
-      description: returns vpn-binding
-      operationId: getNetworkVpnBindingsVpnBinding
+      summary: returns site-pair
+      description: returns site-pair
+      operationId: getNetworkSitePairSetsSitePairSetRoutingInstancesRoutingInstanceSitePairsSitePair
       produces:
         - application/json
         - application/xml
@@ -17278,31 +22782,37 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/vpn-binding"
+              $ref: "#/getDefinitions/site-pair"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vpn-id
+        - name: site-pair-set-id
           in: path
-          description: VPN ID, globally unique within A&AI
+          description: Unique id of site pair set.
           required: true
           type: string
-        - name: vpn-name
-          in: query
-          description: VPN Name
-          required: false
+          example: __SITE-PAIR-SET-ID__
+        - name: routing-instance-id
+          in: path
+          description: Unique id of routing instance
+          required: true
           type: string
-        - name: vpn-type
-          in: query
-          description: Type of the vpn, should be taken from enumerated/valid values
-          required: false
+          example: __ROUTING-INSTANCE-ID__
+        - name: site-pair-id
+          in: path
+          description: unique identifier of probe
+          required: true
           type: string
+          example: __SITE-PAIR-ID__
     put:
       tags:
         - Network
-      summary: create or update an existing vpn-binding
-      description: create or update an existing vpn-binding
-      operationId: createOrUpdateNetworkVpnBindingsVpnBinding
+      summary: create or update an existing site-pair
+      description: |
+        Create or update an existing site-pair.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkSitePairSetsSitePairSetRoutingInstancesRoutingInstanceSitePairsSitePair
       consumes:
         - application/json
         - application/xml
@@ -17313,23 +22823,87 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vpn-id
+        - name: site-pair-set-id
           in: path
-          description: VPN ID, globally unique within A&AI
+          description: Unique id of site pair set.
+          required: true
+          type: string
+          example: __SITE-PAIR-SET-ID__
+        - name: routing-instance-id
+          in: path
+          description: Unique id of routing instance
+          required: true
+          type: string
+          example: __ROUTING-INSTANCE-ID__
+        - name: site-pair-id
+          in: path
+          description: unique identifier of probe
           required: true
           type: string
+          example: __SITE-PAIR-ID__
         - name: body
           in: body
-          description: vpn-binding object that needs to be created or updated
+          description: site-pair object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkSitePairSetsSitePairSetRoutingInstancesRoutingInstanceSitePairsSitePair.json)
           required: true
           schema:
-            $ref: "#/definitions/vpn-binding"
+            $ref: "#/definitions/site-pair"
+    patch:
+      tags:
+        - Network
+      summary: update an existing site-pair
+      description: |
+        Update an existing site-pair
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkSitePairSetsSitePairSetRoutingInstancesRoutingInstanceSitePairsSitePair
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: site-pair-set-id
+          in: path
+          description: Unique id of site pair set.
+          required: true
+          type: string
+          example: __SITE-PAIR-SET-ID__
+        - name: routing-instance-id
+          in: path
+          description: Unique id of routing instance
+          required: true
+          type: string
+          example: __ROUTING-INSTANCE-ID__
+        - name: site-pair-id
+          in: path
+          description: unique identifier of probe
+          required: true
+          type: string
+          example: __SITE-PAIR-ID__
+        - name: body
+          in: body
+          description: site-pair object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/site-pair"
     delete:
       tags:
         - Network
-      summary: delete an existing vpn-binding
-      description: delete an existing vpn-binding
-      operationId: deleteNetworkVpnBindingsVpnBinding
+      summary: delete an existing site-pair
+      description: delete an existing site-pair
+      operationId: deleteNetworkSitePairSetsSitePairSetRoutingInstancesRoutingInstanceSitePairsSitePair
       consumes:
         - application/json
         - application/xml
@@ -17340,23 +22914,36 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vpn-id
+        - name: site-pair-set-id
           in: path
-          description: VPN ID, globally unique within A&AI
+          description: Unique id of site pair set.
+          required: true
+          type: string
+          example: __SITE-PAIR-SET-ID__
+        - name: routing-instance-id
+          in: path
+          description: Unique id of routing instance
+          required: true
+          type: string
+          example: __ROUTING-INSTANCE-ID__
+        - name: site-pair-id
+          in: path
+          description: unique identifier of probe
           required: true
           type: string
+          example: __SITE-PAIR-ID__
         - name: resource-version
           in: query
           description: resource-version for concurrency
           required: true
           type: string
-  /network/vpn-bindings:
+  /network/site-pair-sets/site-pair-set/{site-pair-set-id}/routing-instances/routing-instance/{routing-instance-id}/site-pairs:
     get:
       tags:
         - Network
-      summary: returns vpn-bindings
-      description: returns vpn-bindings
-      operationId: getNetworkVpnBindings
+      summary: returns site-pairs
+      description: returns site-pairs
+      operationId: getNetworkSitePairSetsSitePairSetRoutingInstancesRoutingInstanceSitePairs
       produces:
         - application/json
         - application/xml
@@ -17364,15 +22951,28 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/vpn-bindings"
+              $ref: "#/getDefinitions/site-pairs"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
-  /network/vpls-pes/vpls-pe/{equipment-name}/relationship-list/relationship:
+      parameters:
+        - name: site-pair-set-id
+          in: path
+          description: Unique id of site pair set.
+          required: true
+          type: string
+          example: __SITE-PAIR-SET-ID__
+        - name: routing-instance-id
+          in: path
+          description: Unique id of routing instance
+          required: true
+          type: string
+          example: __ROUTING-INSTANCE-ID__
+  /network/site-pair-sets/site-pair-set/{site-pair-set-id}/routing-instances/routing-instance/{routing-instance-id}/relationship-list/relationship:
     put:
       tags:
         - Network
       summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkVplsPesVplsPeRelationshipListRelationship
+      operationId: createOrUpdateNetworkSitePairSetsSitePairSetRoutingInstancesRoutingInstanceRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -17383,13 +22983,21 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: equipment-name
+        - name: site-pair-set-id
+          in: path
+          description: Unique id of site pair set.
+          required: true
+          type: string
+          example: __SITE-PAIR-SET-ID__
+        - name: routing-instance-id
           in: path
+          description: Unique id of routing instance
           required: true
           type: string
+          example: __ROUTING-INSTANCE-ID__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkSitePairSetsSitePairSetRoutingInstancesRoutingInstance.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -17398,7 +23006,7 @@ paths:
         - Network
       summary: delete an existing relationship
       description: delete an existing relationship
-      operationId: deleteNetworkVplsPesVplsPeRelationshipListRelationship
+      operationId: deleteNetworkSitePairSetsSitePairSetRoutingInstancesRoutingInstanceRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -17409,47 +23017,57 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: equipment-name
+        - name: site-pair-set-id
           in: path
+          description: Unique id of site pair set.
           required: true
           type: string
-  /network/vpls-pes/vpls-pe/{equipment-name}/p-interfaces/p-interface/{interface-name}/relationship-list/relationship:
-    put:
+          example: __SITE-PAIR-SET-ID__
+        - name: routing-instance-id
+          in: path
+          description: Unique id of routing instance
+          required: true
+          type: string
+          example: __ROUTING-INSTANCE-ID__
+  /network/site-pair-sets/site-pair-set/{site-pair-set-id}/routing-instances/routing-instance/{routing-instance-id}:
+    get:
       tags:
         - Network
-      summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkVplsPesVplsPePInterfacesPInterfaceRelationshipListRelationship
-      consumes:
-        - application/json
-        - application/xml
+      summary: returns routing-instance
+      description: returns routing-instance
+      operationId: getNetworkSitePairSetsSitePairSetRoutingInstancesRoutingInstance
       produces:
         - application/json
         - application/xml
       responses:
+        "200":
+          description: successful operation
+          schema:
+              $ref: "#/getDefinitions/routing-instance"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: equipment-name
+        - name: site-pair-set-id
           in: path
+          description: Unique id of site pair set.
           required: true
           type: string
-        - name: interface-name
+          example: __SITE-PAIR-SET-ID__
+        - name: routing-instance-id
           in: path
-          description: Name that identifies the physical interface
+          description: Unique id of routing instance
           required: true
           type: string
-        - name: body
-          in: body
-          description: relationship object that needs to be created or updated
-          required: true
-          schema:
-            $ref: "#/definitions/relationship"
-    delete:
+          example: __ROUTING-INSTANCE-ID__
+    put:
       tags:
         - Network
-      summary: delete an existing relationship
-      description: delete an existing relationship
-      operationId: deleteNetworkVplsPesVplsPePInterfacesPInterfaceRelationshipListRelationship
+      summary: create or update an existing routing-instance
+      description: |
+        Create or update an existing routing-instance.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkSitePairSetsSitePairSetRoutingInstancesRoutingInstance
       consumes:
         - application/json
         - application/xml
@@ -17460,21 +23078,41 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: equipment-name
+        - name: site-pair-set-id
           in: path
+          description: Unique id of site pair set.
           required: true
           type: string
-        - name: interface-name
+          example: __SITE-PAIR-SET-ID__
+        - name: routing-instance-id
           in: path
-          description: Name that identifies the physical interface
+          description: Unique id of routing instance
           required: true
           type: string
-  /network/vpls-pes/vpls-pe/{equipment-name}/p-interfaces/p-interface/{interface-name}/sriov-pfs/sriov-pf/{pf-pci-id}/relationship-list/relationship:
-    put:
+          example: __ROUTING-INSTANCE-ID__
+        - name: body
+          in: body
+          description: routing-instance object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkSitePairSetsSitePairSetRoutingInstancesRoutingInstance.json)
+          required: true
+          schema:
+            $ref: "#/definitions/routing-instance"
+    patch:
       tags:
         - Network
-      summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkVplsPesVplsPePInterfacesPInterfaceSriovPfsSriovPfRelationshipListRelationship
+      summary: update an existing routing-instance
+      description: |
+        Update an existing routing-instance
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkSitePairSetsSitePairSetRoutingInstancesRoutingInstance
       consumes:
         - application/json
         - application/xml
@@ -17485,32 +23123,30 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: equipment-name
-          in: path
-          required: true
-          type: string
-        - name: interface-name
+        - name: site-pair-set-id
           in: path
-          description: Name that identifies the physical interface
+          description: Unique id of site pair set.
           required: true
           type: string
-        - name: pf-pci-id
+          example: __SITE-PAIR-SET-ID__
+        - name: routing-instance-id
           in: path
-          description: Identifier for the sriov-pf
+          description: Unique id of routing instance
           required: true
           type: string
+          example: __ROUTING-INSTANCE-ID__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: routing-instance object that needs to be created or updated. 
           required: true
           schema:
-            $ref: "#/definitions/relationship"
+            $ref: "#/patchDefinitions/routing-instance"
     delete:
       tags:
         - Network
-      summary: delete an existing relationship
-      description: delete an existing relationship
-      operationId: deleteNetworkVplsPesVplsPePInterfacesPInterfaceSriovPfsSriovPfRelationshipListRelationship
+      summary: delete an existing routing-instance
+      description: delete an existing routing-instance
+      operationId: deleteNetworkSitePairSetsSitePairSetRoutingInstancesRoutingInstance
       consumes:
         - application/json
         - application/xml
@@ -17521,27 +23157,30 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: equipment-name
+        - name: site-pair-set-id
           in: path
+          description: Unique id of site pair set.
           required: true
           type: string
-        - name: interface-name
+          example: __SITE-PAIR-SET-ID__
+        - name: routing-instance-id
           in: path
-          description: Name that identifies the physical interface
+          description: Unique id of routing instance
           required: true
           type: string
-        - name: pf-pci-id
-          in: path
-          description: Identifier for the sriov-pf
+          example: __ROUTING-INSTANCE-ID__
+        - name: resource-version
+          in: query
+          description: resource-version for concurrency
           required: true
           type: string
-  /network/vpls-pes/vpls-pe/{equipment-name}/p-interfaces/p-interface/{interface-name}/sriov-pfs/sriov-pf/{pf-pci-id}:
+  /network/site-pair-sets/site-pair-set/{site-pair-set-id}/routing-instances:
     get:
       tags:
         - Network
-      summary: returns sriov-pf
-      description: returns sriov-pf
-      operationId: getNetworkVplsPesVplsPePInterfacesPInterfaceSriovPfsSriovPf
+      summary: returns routing-instances
+      description: returns routing-instances
+      operationId: getNetworkSitePairSetsSitePairSetRoutingInstances
       produces:
         - application/json
         - application/xml
@@ -17549,40 +23188,22 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/sriov-pf"
+              $ref: "#/getDefinitions/routing-instances"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: equipment-name
-          in: path
-          required: true
-          type: string
-        - name: interface-name
-          in: path
-          description: Name that identifies the physical interface
-          required: true
-          type: string
-        - name: pf-pci-id
+        - name: site-pair-set-id
           in: path
-          description: Identifier for the sriov-pf
+          description: Unique id of site pair set.
           required: true
           type: string
-        - name: prov-status
-          in: query
-          description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems.
-          required: false
-          type: string
-        - name: prov-status
-          in: query
-          description: Trigger for operational monitoring of this resource by Service Assurance systems.
-          required: false
-          type: string
+          example: __SITE-PAIR-SET-ID__
+  /network/site-pair-sets/site-pair-set/{site-pair-set-id}/relationship-list/relationship:
     put:
       tags:
         - Network
-      summary: create or update an existing sriov-pf
-      description: create or update an existing sriov-pf
-      operationId: createOrUpdateNetworkVplsPesVplsPePInterfacesPInterfaceSriovPfsSriovPf
+      summary: see node definition for valid relationships
+      operationId: createOrUpdateNetworkSitePairSetsSitePairSetRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -17593,32 +23214,24 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: equipment-name
+        - name: site-pair-set-id
           in: path
+          description: Unique id of site pair set.
           required: true
           type: string
-        - name: interface-name
-          in: path
-          description: Name that identifies the physical interface
-          required: true
-          type: string
-        - name: pf-pci-id
-          in: path
-          description: Identifier for the sriov-pf
-          required: true
-          type: string
-        - name: body
-          in: body
-          description: sriov-pf object that needs to be created or updated
+          example: __SITE-PAIR-SET-ID__
+        - name: body
+          in: body
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkSitePairSetsSitePairSet.json)
           required: true
           schema:
-            $ref: "#/definitions/sriov-pf"
+            $ref: "#/definitions/relationship"
     delete:
       tags:
         - Network
-      summary: delete an existing sriov-pf
-      description: delete an existing sriov-pf
-      operationId: deleteNetworkVplsPesVplsPePInterfacesPInterfaceSriovPfsSriovPf
+      summary: delete an existing relationship
+      description: delete an existing relationship
+      operationId: deleteNetworkSitePairSetsSitePairSetRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -17629,32 +23242,19 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: equipment-name
-          in: path
-          required: true
-          type: string
-        - name: interface-name
-          in: path
-          description: Name that identifies the physical interface
-          required: true
-          type: string
-        - name: pf-pci-id
+        - name: site-pair-set-id
           in: path
-          description: Identifier for the sriov-pf
-          required: true
-          type: string
-        - name: resource-version
-          in: query
-          description: resource-version for concurrency
+          description: Unique id of site pair set.
           required: true
           type: string
-  /network/vpls-pes/vpls-pe/{equipment-name}/p-interfaces/p-interface/{interface-name}/sriov-pfs:
+          example: __SITE-PAIR-SET-ID__
+  /network/site-pair-sets/site-pair-set/{site-pair-set-id}:
     get:
       tags:
         - Network
-      summary: returns sriov-pfs
-      description: returns sriov-pfs
-      operationId: getNetworkVplsPesVplsPePInterfacesPInterfaceSriovPfs
+      summary: returns site-pair-set
+      description: returns site-pair-set
+      operationId: getNetworkSitePairSetsSitePairSet
       produces:
         - application/json
         - application/xml
@@ -17662,35 +23262,25 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/sriov-pfs"
+              $ref: "#/getDefinitions/site-pair-set"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: equipment-name
-          in: path
-          required: true
-          type: string
-        - name: interface-name
+        - name: site-pair-set-id
           in: path
-          description: Name that identifies the physical interface
+          description: Unique id of site pair set.
           required: true
           type: string
-        - name: prov-status
-          in: query
-          description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems.
-          required: false
-          type: string
-        - name: prov-status
-          in: query
-          description: Trigger for operational monitoring of this resource by Service Assurance systems.
-          required: false
-          type: string
-  /network/vpls-pes/vpls-pe/{equipment-name}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/relationship-list/relationship:
+          example: __SITE-PAIR-SET-ID__
     put:
       tags:
         - Network
-      summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceVlansVlanRelationshipListRelationship
+      summary: create or update an existing site-pair-set
+      description: |
+        Create or update an existing site-pair-set.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkSitePairSetsSitePairSet
       consumes:
         - application/json
         - application/xml
@@ -17701,37 +23291,63 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: equipment-name
-          in: path
-          required: true
-          type: string
-        - name: interface-name
+        - name: site-pair-set-id
           in: path
-          description: Name that identifies the physical interface
+          description: Unique id of site pair set.
           required: true
           type: string
-        - name: interface-name
-          in: path
-          description: Name given to the interface
+          example: __SITE-PAIR-SET-ID__
+        - name: body
+          in: body
+          description: site-pair-set object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkSitePairSetsSitePairSet.json)
           required: true
-          type: string
-        - name: vlan-interface
+          schema:
+            $ref: "#/definitions/site-pair-set"
+    patch:
+      tags:
+        - Network
+      summary: update an existing site-pair-set
+      description: |
+        Update an existing site-pair-set
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkSitePairSetsSitePairSet
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: site-pair-set-id
           in: path
-          description: String that identifies the interface
+          description: Unique id of site pair set.
           required: true
           type: string
+          example: __SITE-PAIR-SET-ID__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: site-pair-set object that needs to be created or updated. 
           required: true
           schema:
-            $ref: "#/definitions/relationship"
+            $ref: "#/patchDefinitions/site-pair-set"
     delete:
       tags:
         - Network
-      summary: delete an existing relationship
-      description: delete an existing relationship
-      operationId: deleteNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceVlansVlanRelationshipListRelationship
+      summary: delete an existing site-pair-set
+      description: delete an existing site-pair-set
+      operationId: deleteNetworkSitePairSetsSitePairSet
       consumes:
         - application/json
         - application/xml
@@ -17742,31 +23358,40 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: equipment-name
-          in: path
-          required: true
-          type: string
-        - name: interface-name
-          in: path
-          description: Name that identifies the physical interface
-          required: true
-          type: string
-        - name: interface-name
+        - name: site-pair-set-id
           in: path
-          description: Name given to the interface
+          description: Unique id of site pair set.
           required: true
           type: string
-        - name: vlan-interface
-          in: path
-          description: String that identifies the interface
+          example: __SITE-PAIR-SET-ID__
+        - name: resource-version
+          in: query
+          description: resource-version for concurrency
           required: true
           type: string
-  /network/vpls-pes/vpls-pe/{equipment-name}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}/relationship-list/relationship:
+  /network/site-pair-sets:
+    get:
+      tags:
+        - Network
+      summary: returns site-pair-sets
+      description: returns site-pair-sets
+      operationId: getNetworkSitePairSets
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "200":
+          description: successful operation
+          schema:
+              $ref: "#/getDefinitions/site-pair-sets"
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+  /network/vpn-bindings/vpn-binding/{vpn-id}/route-targets/route-target/{global-route-target}/{route-target-role}/relationship-list/relationship:
     put:
       tags:
         - Network
       summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressListRelationshipListRelationship
+      operationId: createOrUpdateNetworkVpnBindingsVpnBindingRouteTargetsRouteTargetRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -17777,33 +23402,27 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: equipment-name
-          in: path
-          required: true
-          type: string
-        - name: interface-name
-          in: path
-          description: Name that identifies the physical interface
-          required: true
-          type: string
-        - name: interface-name
+        - name: vpn-id
           in: path
-          description: Name given to the interface
+          description: VPN ID, globally unique within A&AI
           required: true
           type: string
-        - name: vlan-interface
+          example: __VPN-ID__
+        - name: global-route-target
           in: path
-          description: String that identifies the interface
+          description: Number used to identify an RT, globally unique in the network
           required: true
           type: string
-        - name: l3-interface-ipv4-address
+          example: __GLOBAL-ROUTE-TARGET__
+        - name: route-target-role
           in: path
-          description: IP address
+          description: Role assigned to this route target
           required: true
           type: string
+          example: __ROUTE-TARGET-ROLE__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVpnBindingsVpnBindingRouteTargetsRouteTarget.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -17812,7 +23431,7 @@ paths:
         - Network
       summary: delete an existing relationship
       description: delete an existing relationship
-      operationId: deleteNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressListRelationshipListRelationship
+      operationId: deleteNetworkVpnBindingsVpnBindingRouteTargetsRouteTargetRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -17823,37 +23442,31 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: equipment-name
-          in: path
-          required: true
-          type: string
-        - name: interface-name
-          in: path
-          description: Name that identifies the physical interface
-          required: true
-          type: string
-        - name: interface-name
+        - name: vpn-id
           in: path
-          description: Name given to the interface
+          description: VPN ID, globally unique within A&AI
           required: true
           type: string
-        - name: vlan-interface
+          example: __VPN-ID__
+        - name: global-route-target
           in: path
-          description: String that identifies the interface
+          description: Number used to identify an RT, globally unique in the network
           required: true
           type: string
-        - name: l3-interface-ipv4-address
+          example: __GLOBAL-ROUTE-TARGET__
+        - name: route-target-role
           in: path
-          description: IP address
+          description: Role assigned to this route target
           required: true
           type: string
-  /network/vpls-pes/vpls-pe/{equipment-name}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}:
+          example: __ROUTE-TARGET-ROLE__
+  /network/vpn-bindings/vpn-binding/{vpn-id}/route-targets/route-target/{global-route-target}/{route-target-role}:
     get:
       tags:
         - Network
-      summary: returns l3-interface-ipv4-address-list
-      description: returns l3-interface-ipv4-address-list
-      operationId: getNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList
+      summary: returns route-target
+      description: returns route-target
+      operationId: getNetworkVpnBindingsVpnBindingRouteTargetsRouteTarget
       produces:
         - application/json
         - application/xml
@@ -17861,92 +23474,47 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/l3-interface-ipv4-address-list"
+              $ref: "#/getDefinitions/route-target"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: equipment-name
-          in: path
-          required: true
-          type: string
-        - name: interface-name
-          in: path
-          description: Name that identifies the physical interface
-          required: true
-          type: string
-        - name: interface-name
+        - name: vpn-id
           in: path
-          description: Name given to the interface
+          description: VPN ID, globally unique within A&AI
           required: true
           type: string
-        - name: vlan-interface
+          example: __VPN-ID__
+        - name: global-route-target
           in: path
-          description: String that identifies the interface
+          description: Number used to identify an RT, globally unique in the network
           required: true
           type: string
-        - name: l3-interface-ipv4-address
+          example: __GLOBAL-ROUTE-TARGET__
+        - name: route-target-role
           in: path
-          description: IP address
+          description: Role assigned to this route target
           required: true
           type: string
-        - name: prov-status
-          in: query
-          description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems.
-          required: false
-          type: string
-        - name: prov-status
-          in: query
-          description: Trigger for operational monitoring of this resource by Service Assurance systems.
-          required: false
-          type: string
-        - name: interface-id
-          in: query
-          description: ID of interface
-          required: false
-          type: string
-        - name: macaddr
-          in: query
-          description: MAC address for the interface
-          required: false
-          type: string
-        - name: network-name
-          in: query
-          description: Name of the network
-          required: false
-          type: string
-        - name: vlan-id-inner
-          in: query
-          description: Inner VLAN tag
-          required: false
-          type: integer
-          format: int64
-        - name: vpn-key
-          in: query
-          description: This indicates the customers VPN ID associated with this vlan
-          required: false
-          type: string
-        - name: vlan-id-inner
-          in: query
-          description: Inner VLAN tag
-          required: false
-          type: integer
-          format: int64
-        - name: neutron-network-id
+          example: __ROUTE-TARGET-ROLE__
+        - name: vpn-name
           in: query
-          description: Neutron network id of the interface that address belongs to
+          description: VPN Name
           required: false
           type: string
-        - name: neutron-subnet-id
+        - name: vpn-type
           in: query
-          description: Neutron id of subnet that address belongs to
+          description: Type of the vpn, should be taken from enumerated/valid values
           required: false
           type: string
     put:
       tags:
         - Network
-      summary: create or update an existing l3-interface-ipv4-address-list
-      description: create or update an existing l3-interface-ipv4-address-list
-      operationId: createOrUpdateNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList
+      summary: create or update an existing route-target
+      description: |
+        Create or update an existing route-target.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkVpnBindingsVpnBindingRouteTargetsRouteTarget
       consumes:
         - application/json
         - application/xml
@@ -17957,42 +23525,87 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: equipment-name
+        - name: vpn-id
           in: path
+          description: VPN ID, globally unique within A&AI
           required: true
           type: string
-        - name: interface-name
+          example: __VPN-ID__
+        - name: global-route-target
           in: path
-          description: Name that identifies the physical interface
+          description: Number used to identify an RT, globally unique in the network
           required: true
           type: string
-        - name: interface-name
+          example: __GLOBAL-ROUTE-TARGET__
+        - name: route-target-role
           in: path
-          description: Name given to the interface
+          description: Role assigned to this route target
           required: true
           type: string
-        - name: vlan-interface
+          example: __ROUTE-TARGET-ROLE__
+        - name: body
+          in: body
+          description: route-target object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVpnBindingsVpnBindingRouteTargetsRouteTarget.json)
+          required: true
+          schema:
+            $ref: "#/definitions/route-target"
+    patch:
+      tags:
+        - Network
+      summary: update an existing route-target
+      description: |
+        Update an existing route-target
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkVpnBindingsVpnBindingRouteTargetsRouteTarget
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: vpn-id
           in: path
-          description: String that identifies the interface
+          description: VPN ID, globally unique within A&AI
           required: true
           type: string
-        - name: l3-interface-ipv4-address
+          example: __VPN-ID__
+        - name: global-route-target
           in: path
-          description: IP address
+          description: Number used to identify an RT, globally unique in the network
           required: true
           type: string
+          example: __GLOBAL-ROUTE-TARGET__
+        - name: route-target-role
+          in: path
+          description: Role assigned to this route target
+          required: true
+          type: string
+          example: __ROUTE-TARGET-ROLE__
         - name: body
           in: body
-          description: l3-interface-ipv4-address-list object that needs to be created or updated
+          description: route-target object that needs to be created or updated. 
           required: true
           schema:
-            $ref: "#/definitions/l3-interface-ipv4-address-list"
+            $ref: "#/patchDefinitions/route-target"
     delete:
       tags:
         - Network
-      summary: delete an existing l3-interface-ipv4-address-list
-      description: delete an existing l3-interface-ipv4-address-list
-      operationId: deleteNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList
+      summary: delete an existing route-target
+      description: delete an existing route-target
+      operationId: deleteNetworkVpnBindingsVpnBindingRouteTargetsRouteTarget
       consumes:
         - application/json
         - application/xml
@@ -18003,41 +23616,69 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: equipment-name
+        - name: vpn-id
           in: path
+          description: VPN ID, globally unique within A&AI
           required: true
           type: string
-        - name: interface-name
+          example: __VPN-ID__
+        - name: global-route-target
           in: path
-          description: Name that identifies the physical interface
+          description: Number used to identify an RT, globally unique in the network
           required: true
           type: string
-        - name: interface-name
+          example: __GLOBAL-ROUTE-TARGET__
+        - name: route-target-role
           in: path
-          description: Name given to the interface
+          description: Role assigned to this route target
           required: true
           type: string
-        - name: vlan-interface
-          in: path
-          description: String that identifies the interface
+          example: __ROUTE-TARGET-ROLE__
+        - name: resource-version
+          in: query
+          description: resource-version for concurrency
           required: true
           type: string
-        - name: l3-interface-ipv4-address
+  /network/vpn-bindings/vpn-binding/{vpn-id}/route-targets:
+    get:
+      tags:
+        - Network
+      summary: returns route-targets
+      description: returns route-targets
+      operationId: getNetworkVpnBindingsVpnBindingRouteTargets
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "200":
+          description: successful operation
+          schema:
+              $ref: "#/getDefinitions/route-targets"
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: vpn-id
           in: path
-          description: IP address
+          description: VPN ID, globally unique within A&AI
           required: true
           type: string
-        - name: resource-version
+          example: __VPN-ID__
+        - name: vpn-name
           in: query
-          description: resource-version for concurrency
-          required: true
+          description: VPN Name
+          required: false
           type: string
-  /network/vpls-pes/vpls-pe/{equipment-name}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}/relationship-list/relationship:
+        - name: vpn-type
+          in: query
+          description: Type of the vpn, should be taken from enumerated/valid values
+          required: false
+          type: string
+  /network/vpn-bindings/vpn-binding/{vpn-id}/relationship-list/relationship:
     put:
       tags:
         - Network
       summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressListRelationshipListRelationship
+      operationId: createOrUpdateNetworkVpnBindingsVpnBindingRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -18048,33 +23689,15 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: equipment-name
-          in: path
-          required: true
-          type: string
-        - name: interface-name
-          in: path
-          description: Name that identifies the physical interface
-          required: true
-          type: string
-        - name: interface-name
-          in: path
-          description: Name given to the interface
-          required: true
-          type: string
-        - name: vlan-interface
-          in: path
-          description: String that identifies the interface
-          required: true
-          type: string
-        - name: l3-interface-ipv6-address
+        - name: vpn-id
           in: path
-          description: IP address
+          description: VPN ID, globally unique within A&AI
           required: true
           type: string
+          example: __VPN-ID__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVpnBindingsVpnBinding.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -18083,7 +23706,7 @@ paths:
         - Network
       summary: delete an existing relationship
       description: delete an existing relationship
-      operationId: deleteNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressListRelationshipListRelationship
+      operationId: deleteNetworkVpnBindingsVpnBindingRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -18094,37 +23717,19 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: equipment-name
-          in: path
-          required: true
-          type: string
-        - name: interface-name
-          in: path
-          description: Name that identifies the physical interface
-          required: true
-          type: string
-        - name: interface-name
-          in: path
-          description: Name given to the interface
-          required: true
-          type: string
-        - name: vlan-interface
-          in: path
-          description: String that identifies the interface
-          required: true
-          type: string
-        - name: l3-interface-ipv6-address
+        - name: vpn-id
           in: path
-          description: IP address
+          description: VPN ID, globally unique within A&AI
           required: true
           type: string
-  /network/vpls-pes/vpls-pe/{equipment-name}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}:
+          example: __VPN-ID__
+  /network/vpn-bindings/vpn-binding/{vpn-id}:
     get:
       tags:
         - Network
-      summary: returns l3-interface-ipv6-address-list
-      description: returns l3-interface-ipv6-address-list
-      operationId: getNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList
+      summary: returns vpn-binding
+      description: returns vpn-binding
+      operationId: getNetworkVpnBindingsVpnBinding
       produces:
         - application/json
         - application/xml
@@ -18132,92 +23737,35 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/l3-interface-ipv6-address-list"
+              $ref: "#/getDefinitions/vpn-binding"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: equipment-name
-          in: path
-          required: true
-          type: string
-        - name: interface-name
-          in: path
-          description: Name that identifies the physical interface
-          required: true
-          type: string
-        - name: interface-name
-          in: path
-          description: Name given to the interface
-          required: true
-          type: string
-        - name: vlan-interface
-          in: path
-          description: String that identifies the interface
-          required: true
-          type: string
-        - name: l3-interface-ipv6-address
+        - name: vpn-id
           in: path
-          description: IP address
+          description: VPN ID, globally unique within A&AI
           required: true
           type: string
-        - name: prov-status
-          in: query
-          description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems.
-          required: false
-          type: string
-        - name: prov-status
-          in: query
-          description: Trigger for operational monitoring of this resource by Service Assurance systems.
-          required: false
-          type: string
-        - name: interface-id
-          in: query
-          description: ID of interface
-          required: false
-          type: string
-        - name: macaddr
-          in: query
-          description: MAC address for the interface
-          required: false
-          type: string
-        - name: network-name
-          in: query
-          description: Name of the network
-          required: false
-          type: string
-        - name: vlan-id-inner
-          in: query
-          description: Inner VLAN tag
-          required: false
-          type: integer
-          format: int64
-        - name: vpn-key
-          in: query
-          description: This indicates the customers VPN ID associated with this vlan
-          required: false
-          type: string
-        - name: vlan-id-inner
-          in: query
-          description: Inner VLAN tag
-          required: false
-          type: integer
-          format: int64
-        - name: neutron-network-id
+          example: __VPN-ID__
+        - name: vpn-name
           in: query
-          description: Neutron network id of the interface that address belongs to
+          description: VPN Name
           required: false
           type: string
-        - name: neutron-subnet-id
+        - name: vpn-type
           in: query
-          description: Neutron id of subnet that address belongs to
+          description: Type of the vpn, should be taken from enumerated/valid values
           required: false
           type: string
     put:
       tags:
         - Network
-      summary: create or update an existing l3-interface-ipv6-address-list
-      description: create or update an existing l3-interface-ipv6-address-list
-      operationId: createOrUpdateNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList
+      summary: create or update an existing vpn-binding
+      description: |
+        Create or update an existing vpn-binding.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkVpnBindingsVpnBinding
       consumes:
         - application/json
         - application/xml
@@ -18228,42 +23776,63 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: equipment-name
+        - name: vpn-id
           in: path
+          description: VPN ID, globally unique within A&AI
           required: true
           type: string
-        - name: interface-name
-          in: path
-          description: Name that identifies the physical interface
+          example: __VPN-ID__
+        - name: body
+          in: body
+          description: vpn-binding object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVpnBindingsVpnBinding.json)
           required: true
-          type: string
-        - name: interface-name
-          in: path
-          description: Name given to the interface
-          required: true
-          type: string
-        - name: vlan-interface
-          in: path
-          description: String that identifies the interface
-          required: true
-          type: string
-        - name: l3-interface-ipv6-address
+          schema:
+            $ref: "#/definitions/vpn-binding"
+    patch:
+      tags:
+        - Network
+      summary: update an existing vpn-binding
+      description: |
+        Update an existing vpn-binding
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkVpnBindingsVpnBinding
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: vpn-id
           in: path
-          description: IP address
+          description: VPN ID, globally unique within A&AI
           required: true
           type: string
+          example: __VPN-ID__
         - name: body
           in: body
-          description: l3-interface-ipv6-address-list object that needs to be created or updated
+          description: vpn-binding object that needs to be created or updated. 
           required: true
           schema:
-            $ref: "#/definitions/l3-interface-ipv6-address-list"
+            $ref: "#/patchDefinitions/vpn-binding"
     delete:
       tags:
         - Network
-      summary: delete an existing l3-interface-ipv6-address-list
-      description: delete an existing l3-interface-ipv6-address-list
-      operationId: deleteNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList
+      summary: delete an existing vpn-binding
+      description: delete an existing vpn-binding
+      operationId: deleteNetworkVpnBindingsVpnBinding
       consumes:
         - application/json
         - application/xml
@@ -18274,42 +23843,24 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: equipment-name
-          in: path
-          required: true
-          type: string
-        - name: interface-name
-          in: path
-          description: Name that identifies the physical interface
-          required: true
-          type: string
-        - name: interface-name
-          in: path
-          description: Name given to the interface
-          required: true
-          type: string
-        - name: vlan-interface
-          in: path
-          description: String that identifies the interface
-          required: true
-          type: string
-        - name: l3-interface-ipv6-address
+        - name: vpn-id
           in: path
-          description: IP address
+          description: VPN ID, globally unique within A&AI
           required: true
           type: string
+          example: __VPN-ID__
         - name: resource-version
           in: query
           description: resource-version for concurrency
           required: true
           type: string
-  /network/vpls-pes/vpls-pe/{equipment-name}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}:
+  /network/vpn-bindings:
     get:
       tags:
         - Network
-      summary: returns vlan
-      description: returns vlan
-      operationId: getNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceVlansVlan
+      summary: returns vpn-bindings
+      description: returns vpn-bindings
+      operationId: getNetworkVpnBindings
       produces:
         - application/json
         - application/xml
@@ -18317,71 +23868,15 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/vlan"
+              $ref: "#/getDefinitions/vpn-bindings"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
-      parameters:
-        - name: equipment-name
-          in: path
-          required: true
-          type: string
-        - name: interface-name
-          in: path
-          description: Name that identifies the physical interface
-          required: true
-          type: string
-        - name: interface-name
-          in: path
-          description: Name given to the interface
-          required: true
-          type: string
-        - name: vlan-interface
-          in: path
-          description: String that identifies the interface
-          required: true
-          type: string
-        - name: prov-status
-          in: query
-          description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems.
-          required: false
-          type: string
-        - name: prov-status
-          in: query
-          description: Trigger for operational monitoring of this resource by Service Assurance systems.
-          required: false
-          type: string
-        - name: interface-id
-          in: query
-          description: ID of interface
-          required: false
-          type: string
-        - name: macaddr
-          in: query
-          description: MAC address for the interface
-          required: false
-          type: string
-        - name: network-name
-          in: query
-          description: Name of the network
-          required: false
-          type: string
-        - name: vlan-id-inner
-          in: query
-          description: Inner VLAN tag
-          required: false
-          type: integer
-          format: int64
-        - name: vpn-key
-          in: query
-          description: This indicates the customers VPN ID associated with this vlan
-          required: false
-          type: string
+  /network/vpls-pes/vpls-pe/{equipment-name}/relationship-list/relationship:
     put:
       tags:
         - Network
-      summary: create or update an existing vlan
-      description: create or update an existing vlan
-      operationId: createOrUpdateNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceVlansVlan
+      summary: see node definition for valid relationships
+      operationId: createOrUpdateNetworkVplsPesVplsPeRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -18396,33 +23891,19 @@ paths:
           in: path
           required: true
           type: string
-        - name: interface-name
-          in: path
-          description: Name that identifies the physical interface
-          required: true
-          type: string
-        - name: interface-name
-          in: path
-          description: Name given to the interface
-          required: true
-          type: string
-        - name: vlan-interface
-          in: path
-          description: String that identifies the interface
-          required: true
-          type: string
+          example: __EQUIPMENT-NAME__
         - name: body
           in: body
-          description: vlan object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVplsPesVplsPe.json)
           required: true
           schema:
-            $ref: "#/definitions/vlan"
+            $ref: "#/definitions/relationship"
     delete:
       tags:
         - Network
-      summary: delete an existing vlan
-      description: delete an existing vlan
-      operationId: deleteNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceVlansVlan
+      summary: delete an existing relationship
+      description: delete an existing relationship
+      operationId: deleteNetworkVplsPesVplsPeRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -18437,41 +23918,53 @@ paths:
           in: path
           required: true
           type: string
-        - name: interface-name
+          example: __EQUIPMENT-NAME__
+  /network/vpls-pes/vpls-pe/{equipment-name}/p-interfaces/p-interface/{interface-name}/relationship-list/relationship:
+    put:
+      tags:
+        - Network
+      summary: see node definition for valid relationships
+      operationId: createOrUpdateNetworkVplsPesVplsPePInterfacesPInterfaceRelationshipListRelationship
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: equipment-name
           in: path
-          description: Name that identifies the physical interface
           required: true
           type: string
+          example: __EQUIPMENT-NAME__
         - name: interface-name
           in: path
-          description: Name given to the interface
-          required: true
-          type: string
-        - name: vlan-interface
-          in: path
-          description: String that identifies the interface
+          description: Name that identifies the physical interface
           required: true
           type: string
-        - name: resource-version
-          in: query
-          description: resource-version for concurrency
+          example: __INTERFACE-NAME__
+        - name: body
+          in: body
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVplsPesVplsPePInterfacesPInterface.json)
           required: true
-          type: string
-  /network/vpls-pes/vpls-pe/{equipment-name}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans:
-    get:
+          schema:
+            $ref: "#/definitions/relationship"
+    delete:
       tags:
         - Network
-      summary: returns vlans
-      description: returns vlans
-      operationId: getNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceVlans
+      summary: delete an existing relationship
+      description: delete an existing relationship
+      operationId: deleteNetworkVplsPesVplsPePInterfacesPInterfaceRelationshipListRelationship
+      consumes:
+        - application/json
+        - application/xml
       produces:
         - application/json
         - application/xml
       responses:
-        "200":
-          description: successful operation
-          schema:
-              $ref: "#/definitions/vlans"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -18479,47 +23972,19 @@ paths:
           in: path
           required: true
           type: string
+          example: __EQUIPMENT-NAME__
         - name: interface-name
           in: path
           description: Name that identifies the physical interface
           required: true
           type: string
-        - name: interface-name
-          in: path
-          description: Name given to the interface
-          required: true
-          type: string
-        - name: prov-status
-          in: query
-          description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems.
-          required: false
-          type: string
-        - name: prov-status
-          in: query
-          description: Trigger for operational monitoring of this resource by Service Assurance systems.
-          required: false
-          type: string
-        - name: interface-id
-          in: query
-          description: ID of interface
-          required: false
-          type: string
-        - name: macaddr
-          in: query
-          description: MAC address for the interface
-          required: false
-          type: string
-        - name: network-name
-          in: query
-          description: Name of the network
-          required: false
-          type: string
-  /network/vpls-pes/vpls-pe/{equipment-name}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/sriov-vfs/sriov-vf/{pci-id}/relationship-list/relationship:
+          example: __INTERFACE-NAME__
+  /network/vpls-pes/vpls-pe/{equipment-name}/p-interfaces/p-interface/{interface-name}/sriov-pfs/sriov-pf/{pf-pci-id}/relationship-list/relationship:
     put:
       tags:
         - Network
       summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceSriovVfsSriovVfRelationshipListRelationship
+      operationId: createOrUpdateNetworkVplsPesVplsPePInterfacesPInterfaceSriovPfsSriovPfRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -18534,24 +23999,22 @@ paths:
           in: path
           required: true
           type: string
+          example: __EQUIPMENT-NAME__
         - name: interface-name
           in: path
           description: Name that identifies the physical interface
           required: true
           type: string
-        - name: interface-name
-          in: path
-          description: Name given to the interface
-          required: true
-          type: string
-        - name: pci-id
+          example: __INTERFACE-NAME__
+        - name: pf-pci-id
           in: path
-          description: PCI ID used to identify the sriov-vf
+          description: Identifier for the sriov-pf
           required: true
           type: string
+          example: __PF-PCI-ID__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVplsPesVplsPePInterfacesPInterfaceSriovPfsSriovPf.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -18560,7 +24023,7 @@ paths:
         - Network
       summary: delete an existing relationship
       description: delete an existing relationship
-      operationId: deleteNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceSriovVfsSriovVfRelationshipListRelationship
+      operationId: deleteNetworkVplsPesVplsPePInterfacesPInterfaceSriovPfsSriovPfRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -18575,28 +24038,26 @@ paths:
           in: path
           required: true
           type: string
+          example: __EQUIPMENT-NAME__
         - name: interface-name
           in: path
           description: Name that identifies the physical interface
           required: true
           type: string
-        - name: interface-name
-          in: path
-          description: Name given to the interface
-          required: true
-          type: string
-        - name: pci-id
+          example: __INTERFACE-NAME__
+        - name: pf-pci-id
           in: path
-          description: PCI ID used to identify the sriov-vf
+          description: Identifier for the sriov-pf
           required: true
           type: string
-  /network/vpls-pes/vpls-pe/{equipment-name}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/sriov-vfs/sriov-vf/{pci-id}:
+          example: __PF-PCI-ID__
+  /network/vpls-pes/vpls-pe/{equipment-name}/p-interfaces/p-interface/{interface-name}/sriov-pfs/sriov-pf/{pf-pci-id}:
     get:
       tags:
         - Network
-      summary: returns sriov-vf
-      description: returns sriov-vf
-      operationId: getNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceSriovVfsSriovVf
+      summary: returns sriov-pf
+      description: returns sriov-pf
+      operationId: getNetworkVplsPesVplsPePInterfacesPInterfaceSriovPfsSriovPf
       produces:
         - application/json
         - application/xml
@@ -18604,7 +24065,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/sriov-vf"
+              $ref: "#/getDefinitions/sriov-pf"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -18612,21 +24073,19 @@ paths:
           in: path
           required: true
           type: string
+          example: __EQUIPMENT-NAME__
         - name: interface-name
           in: path
           description: Name that identifies the physical interface
           required: true
           type: string
-        - name: interface-name
-          in: path
-          description: Name given to the interface
-          required: true
-          type: string
-        - name: pci-id
+          example: __INTERFACE-NAME__
+        - name: pf-pci-id
           in: path
-          description: PCI ID used to identify the sriov-vf
+          description: Identifier for the sriov-pf
           required: true
           type: string
+          example: __PF-PCI-ID__
         - name: prov-status
           in: query
           description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems.
@@ -18637,47 +24096,15 @@ paths:
           description: Trigger for operational monitoring of this resource by Service Assurance systems.
           required: false
           type: string
-        - name: interface-id
-          in: query
-          description: ID of interface
-          required: false
-          type: string
-        - name: macaddr
-          in: query
-          description: MAC address for the interface
-          required: false
-          type: string
-        - name: network-name
-          in: query
-          description: Name of the network
-          required: false
-          type: string
-        - name: vf-vlan-filter
-          in: query
-          description: This metadata provides option to specify list of VLAN filters applied on VF to pass the traffic to VM.
-          required: false
-          type: string
-        - name: vf-mac-filter
-          in: query
-          description: When MAC filters are specified, VF-agent service configures VFs to do MAC level filtering before the traffic is passed to VM.
-          required: false
-          type: string
-        - name: vf-vlan-strip
-          in: query
-          description: When this field is set to true, VF will configured to strip the outer TAG before the traffic is passed to VM.
-          required: false
-          type: boolean
-        - name: neutron-network-id
-          in: query
-          description: Neutron network id of the interface
-          required: false
-          type: string
     put:
       tags:
         - Network
-      summary: create or update an existing sriov-vf
-      description: create or update an existing sriov-vf
-      operationId: createOrUpdateNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceSriovVfsSriovVf
+      summary: create or update an existing sriov-pf
+      description: |
+        Create or update an existing sriov-pf.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkVplsPesVplsPePInterfacesPInterfaceSriovPfsSriovPf
       consumes:
         - application/json
         - application/xml
@@ -18692,33 +24119,81 @@ paths:
           in: path
           required: true
           type: string
+          example: __EQUIPMENT-NAME__
         - name: interface-name
           in: path
           description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
+        - name: pf-pci-id
+          in: path
+          description: Identifier for the sriov-pf
+          required: true
+          type: string
+          example: __PF-PCI-ID__
+        - name: body
+          in: body
+          description: sriov-pf object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVplsPesVplsPePInterfacesPInterfaceSriovPfsSriovPf.json)
+          required: true
+          schema:
+            $ref: "#/definitions/sriov-pf"
+    patch:
+      tags:
+        - Network
+      summary: update an existing sriov-pf
+      description: |
+        Update an existing sriov-pf
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkVplsPesVplsPePInterfacesPInterfaceSriovPfsSriovPf
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: equipment-name
+          in: path
+          required: true
+          type: string
+          example: __EQUIPMENT-NAME__
         - name: interface-name
           in: path
-          description: Name given to the interface
+          description: Name that identifies the physical interface
           required: true
           type: string
-        - name: pci-id
+          example: __INTERFACE-NAME__
+        - name: pf-pci-id
           in: path
-          description: PCI ID used to identify the sriov-vf
+          description: Identifier for the sriov-pf
           required: true
           type: string
+          example: __PF-PCI-ID__
         - name: body
           in: body
-          description: sriov-vf object that needs to be created or updated
+          description: sriov-pf object that needs to be created or updated. 
           required: true
           schema:
-            $ref: "#/definitions/sriov-vf"
+            $ref: "#/patchDefinitions/sriov-pf"
     delete:
       tags:
         - Network
-      summary: delete an existing sriov-vf
-      description: delete an existing sriov-vf
-      operationId: deleteNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceSriovVfsSriovVf
+      summary: delete an existing sriov-pf
+      description: delete an existing sriov-pf
+      operationId: deleteNetworkVplsPesVplsPePInterfacesPInterfaceSriovPfsSriovPf
       consumes:
         - application/json
         - application/xml
@@ -18733,33 +24208,31 @@ paths:
           in: path
           required: true
           type: string
+          example: __EQUIPMENT-NAME__
         - name: interface-name
           in: path
           description: Name that identifies the physical interface
           required: true
           type: string
-        - name: interface-name
-          in: path
-          description: Name given to the interface
-          required: true
-          type: string
-        - name: pci-id
+          example: __INTERFACE-NAME__
+        - name: pf-pci-id
           in: path
-          description: PCI ID used to identify the sriov-vf
+          description: Identifier for the sriov-pf
           required: true
           type: string
+          example: __PF-PCI-ID__
         - name: resource-version
           in: query
           description: resource-version for concurrency
           required: true
           type: string
-  /network/vpls-pes/vpls-pe/{equipment-name}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/sriov-vfs:
+  /network/vpls-pes/vpls-pe/{equipment-name}/p-interfaces/p-interface/{interface-name}/sriov-pfs:
     get:
       tags:
         - Network
-      summary: returns sriov-vfs
-      description: returns sriov-vfs
-      operationId: getNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceSriovVfs
+      summary: returns sriov-pfs
+      description: returns sriov-pfs
+      operationId: getNetworkVplsPesVplsPePInterfacesPInterfaceSriovPfs
       produces:
         - application/json
         - application/xml
@@ -18767,7 +24240,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/sriov-vfs"
+              $ref: "#/getDefinitions/sriov-pfs"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -18775,16 +24248,13 @@ paths:
           in: path
           required: true
           type: string
+          example: __EQUIPMENT-NAME__
         - name: interface-name
           in: path
           description: Name that identifies the physical interface
           required: true
           type: string
-        - name: interface-name
-          in: path
-          description: Name given to the interface
-          required: true
-          type: string
+          example: __INTERFACE-NAME__
         - name: prov-status
           in: query
           description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems.
@@ -18795,27 +24265,12 @@ paths:
           description: Trigger for operational monitoring of this resource by Service Assurance systems.
           required: false
           type: string
-        - name: interface-id
-          in: query
-          description: ID of interface
-          required: false
-          type: string
-        - name: macaddr
-          in: query
-          description: MAC address for the interface
-          required: false
-          type: string
-        - name: network-name
-          in: query
-          description: Name of the network
-          required: false
-          type: string
-  /network/vpls-pes/vpls-pe/{equipment-name}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/relationship-list/relationship:
+  /network/vpls-pes/vpls-pe/{equipment-name}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/relationship-list/relationship:
     put:
       tags:
         - Network
       summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceRelationshipListRelationship
+      operationId: createOrUpdateNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceVlansVlanRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -18830,19 +24285,28 @@ paths:
           in: path
           required: true
           type: string
+          example: __EQUIPMENT-NAME__
         - name: interface-name
           in: path
           description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
+          type: string
+          example: __VLAN-INTERFACE__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceVlansVlan.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -18851,7 +24315,7 @@ paths:
         - Network
       summary: delete an existing relationship
       description: delete an existing relationship
-      operationId: deleteNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceRelationshipListRelationship
+      operationId: deleteNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceVlansVlanRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -18866,22 +24330,31 @@ paths:
           in: path
           required: true
           type: string
+          example: __EQUIPMENT-NAME__
         - name: interface-name
           in: path
           description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
-  /network/vpls-pes/vpls-pe/{equipment-name}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}/relationship-list/relationship:
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
+          type: string
+          example: __VLAN-INTERFACE__
+  /network/vpls-pes/vpls-pe/{equipment-name}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}/relationship-list/relationship:
     put:
       tags:
         - Network
       summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressListRelationshipListRelationship
+      operationId: createOrUpdateNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressListRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -18896,24 +24369,34 @@ paths:
           in: path
           required: true
           type: string
+          example: __EQUIPMENT-NAME__
         - name: interface-name
           in: path
           description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
+          type: string
+          example: __VLAN-INTERFACE__
         - name: l3-interface-ipv4-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -18922,7 +24405,7 @@ paths:
         - Network
       summary: delete an existing relationship
       description: delete an existing relationship
-      operationId: deleteNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressListRelationshipListRelationship
+      operationId: deleteNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressListRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -18937,28 +24420,38 @@ paths:
           in: path
           required: true
           type: string
+          example: __EQUIPMENT-NAME__
         - name: interface-name
           in: path
           description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
+          type: string
+          example: __VLAN-INTERFACE__
         - name: l3-interface-ipv4-address
           in: path
           description: IP address
           required: true
           type: string
-  /network/vpls-pes/vpls-pe/{equipment-name}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}:
+          example: __L3-INTERFACE-IPV4-ADDRESS__
+  /network/vpls-pes/vpls-pe/{equipment-name}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}:
     get:
       tags:
         - Network
       summary: returns l3-interface-ipv4-address-list
       description: returns l3-interface-ipv4-address-list
-      operationId: getNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList
+      operationId: getNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList
       produces:
         - application/json
         - application/xml
@@ -18966,7 +24459,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/l3-interface-ipv4-address-list"
+              $ref: "#/getDefinitions/l3-interface-ipv4-address-list"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -18974,21 +24467,31 @@ paths:
           in: path
           required: true
           type: string
+          example: __EQUIPMENT-NAME__
         - name: interface-name
           in: path
           description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
+          type: string
+          example: __VLAN-INTERFACE__
         - name: l3-interface-ipv4-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
         - name: prov-status
           in: query
           description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems.
@@ -19020,6 +24523,17 @@ paths:
           required: false
           type: integer
           format: int64
+        - name: vpn-key
+          in: query
+          description: This indicates the customers VPN ID associated with this vlan
+          required: false
+          type: string
+        - name: vlan-id-inner
+          in: query
+          description: Inner VLAN tag
+          required: false
+          type: integer
+          format: int64
         - name: neutron-network-id
           in: query
           description: Neutron network id of the interface that address belongs to
@@ -19034,8 +24548,11 @@ paths:
       tags:
         - Network
       summary: create or update an existing l3-interface-ipv4-address-list
-      description: create or update an existing l3-interface-ipv4-address-list
-      operationId: createOrUpdateNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList
+      description: |
+        Create or update an existing l3-interface-ipv4-address-list.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList
       consumes:
         - application/json
         - application/xml
@@ -19050,33 +24567,105 @@ paths:
           in: path
           required: true
           type: string
+          example: __EQUIPMENT-NAME__
         - name: interface-name
           in: path
           description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
+          type: string
+          example: __VLAN-INTERFACE__
         - name: l3-interface-ipv4-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
         - name: body
           in: body
-          description: l3-interface-ipv4-address-list object that needs to be created or updated
+          description: l3-interface-ipv4-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList.json)
           required: true
           schema:
             $ref: "#/definitions/l3-interface-ipv4-address-list"
+    patch:
+      tags:
+        - Network
+      summary: update an existing l3-interface-ipv4-address-list
+      description: |
+        Update an existing l3-interface-ipv4-address-list
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: equipment-name
+          in: path
+          required: true
+          type: string
+          example: __EQUIPMENT-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the physical interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
+          type: string
+          example: __VLAN-INTERFACE__
+        - name: l3-interface-ipv4-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
+        - name: body
+          in: body
+          description: l3-interface-ipv4-address-list object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/l3-interface-ipv4-address-list"
     delete:
       tags:
         - Network
       summary: delete an existing l3-interface-ipv4-address-list
       description: delete an existing l3-interface-ipv4-address-list
-      operationId: deleteNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList
+      operationId: deleteNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList
       consumes:
         - application/json
         - application/xml
@@ -19091,32 +24680,42 @@ paths:
           in: path
           required: true
           type: string
+          example: __EQUIPMENT-NAME__
         - name: interface-name
           in: path
           description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
+          type: string
+          example: __VLAN-INTERFACE__
         - name: l3-interface-ipv4-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
         - name: resource-version
           in: query
           description: resource-version for concurrency
           required: true
           type: string
-  /network/vpls-pes/vpls-pe/{equipment-name}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}/relationship-list/relationship:
+  /network/vpls-pes/vpls-pe/{equipment-name}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}/relationship-list/relationship:
     put:
       tags:
         - Network
       summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressListRelationshipListRelationship
+      operationId: createOrUpdateNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressListRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -19131,24 +24730,34 @@ paths:
           in: path
           required: true
           type: string
+          example: __EQUIPMENT-NAME__
         - name: interface-name
           in: path
           description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
+          type: string
+          example: __VLAN-INTERFACE__
         - name: l3-interface-ipv6-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -19157,7 +24766,7 @@ paths:
         - Network
       summary: delete an existing relationship
       description: delete an existing relationship
-      operationId: deleteNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressListRelationshipListRelationship
+      operationId: deleteNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressListRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -19172,28 +24781,38 @@ paths:
           in: path
           required: true
           type: string
+          example: __EQUIPMENT-NAME__
         - name: interface-name
           in: path
           description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
+          type: string
+          example: __VLAN-INTERFACE__
         - name: l3-interface-ipv6-address
           in: path
           description: IP address
           required: true
           type: string
-  /network/vpls-pes/vpls-pe/{equipment-name}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}:
+          example: __L3-INTERFACE-IPV6-ADDRESS__
+  /network/vpls-pes/vpls-pe/{equipment-name}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}:
     get:
       tags:
         - Network
       summary: returns l3-interface-ipv6-address-list
       description: returns l3-interface-ipv6-address-list
-      operationId: getNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList
+      operationId: getNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList
       produces:
         - application/json
         - application/xml
@@ -19201,7 +24820,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/l3-interface-ipv6-address-list"
+              $ref: "#/getDefinitions/l3-interface-ipv6-address-list"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -19209,21 +24828,31 @@ paths:
           in: path
           required: true
           type: string
+          example: __EQUIPMENT-NAME__
         - name: interface-name
           in: path
           description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
-        - name: l3-interface-ipv6-address
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
+          type: string
+          example: __VLAN-INTERFACE__
+        - name: l3-interface-ipv6-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
         - name: prov-status
           in: query
           description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems.
@@ -19255,6 +24884,17 @@ paths:
           required: false
           type: integer
           format: int64
+        - name: vpn-key
+          in: query
+          description: This indicates the customers VPN ID associated with this vlan
+          required: false
+          type: string
+        - name: vlan-id-inner
+          in: query
+          description: Inner VLAN tag
+          required: false
+          type: integer
+          format: int64
         - name: neutron-network-id
           in: query
           description: Neutron network id of the interface that address belongs to
@@ -19269,8 +24909,11 @@ paths:
       tags:
         - Network
       summary: create or update an existing l3-interface-ipv6-address-list
-      description: create or update an existing l3-interface-ipv6-address-list
-      operationId: createOrUpdateNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList
+      description: |
+        Create or update an existing l3-interface-ipv6-address-list.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList
       consumes:
         - application/json
         - application/xml
@@ -19285,33 +24928,105 @@ paths:
           in: path
           required: true
           type: string
+          example: __EQUIPMENT-NAME__
         - name: interface-name
           in: path
           description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
+          type: string
+          example: __VLAN-INTERFACE__
         - name: l3-interface-ipv6-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
         - name: body
           in: body
-          description: l3-interface-ipv6-address-list object that needs to be created or updated
+          description: l3-interface-ipv6-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList.json)
           required: true
           schema:
             $ref: "#/definitions/l3-interface-ipv6-address-list"
+    patch:
+      tags:
+        - Network
+      summary: update an existing l3-interface-ipv6-address-list
+      description: |
+        Update an existing l3-interface-ipv6-address-list
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: equipment-name
+          in: path
+          required: true
+          type: string
+          example: __EQUIPMENT-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the physical interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
+          type: string
+          example: __VLAN-INTERFACE__
+        - name: l3-interface-ipv6-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
+        - name: body
+          in: body
+          description: l3-interface-ipv6-address-list object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/l3-interface-ipv6-address-list"
     delete:
       tags:
         - Network
       summary: delete an existing l3-interface-ipv6-address-list
       description: delete an existing l3-interface-ipv6-address-list
-      operationId: deleteNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList
+      operationId: deleteNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList
       consumes:
         - application/json
         - application/xml
@@ -19326,33 +25041,43 @@ paths:
           in: path
           required: true
           type: string
+          example: __EQUIPMENT-NAME__
         - name: interface-name
           in: path
           description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
+          type: string
+          example: __VLAN-INTERFACE__
         - name: l3-interface-ipv6-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
         - name: resource-version
           in: query
           description: resource-version for concurrency
           required: true
           type: string
-  /network/vpls-pes/vpls-pe/{equipment-name}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}:
+  /network/vpls-pes/vpls-pe/{equipment-name}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}:
     get:
       tags:
         - Network
-      summary: returns l-interface
-      description: returns l-interface
-      operationId: getNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterface
+      summary: returns vlan
+      description: returns vlan
+      operationId: getNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceVlansVlan
       produces:
         - application/json
         - application/xml
@@ -19360,7 +25085,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/l-interface"
+              $ref: "#/getDefinitions/vlan"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -19368,16 +25093,25 @@ paths:
           in: path
           required: true
           type: string
+          example: __EQUIPMENT-NAME__
         - name: interface-name
           in: path
           description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
+          type: string
+          example: __VLAN-INTERFACE__
         - name: prov-status
           in: query
           description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems.
@@ -19403,12 +25137,26 @@ paths:
           description: Name of the network
           required: false
           type: string
+        - name: vlan-id-inner
+          in: query
+          description: Inner VLAN tag
+          required: false
+          type: integer
+          format: int64
+        - name: vpn-key
+          in: query
+          description: This indicates the customers VPN ID associated with this vlan
+          required: false
+          type: string
     put:
       tags:
         - Network
-      summary: create or update an existing l-interface
-      description: create or update an existing l-interface
-      operationId: createOrUpdateNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterface
+      summary: create or update an existing vlan
+      description: |
+        Create or update an existing vlan.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceVlansVlan
       consumes:
         - application/json
         - application/xml
@@ -19423,28 +25171,48 @@ paths:
           in: path
           required: true
           type: string
+          example: __EQUIPMENT-NAME__
         - name: interface-name
           in: path
           description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
+          type: string
+          example: __VLAN-INTERFACE__
         - name: body
           in: body
-          description: l-interface object that needs to be created or updated
+          description: vlan object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceVlansVlan.json)
           required: true
           schema:
-            $ref: "#/definitions/l-interface"
-    delete:
+            $ref: "#/definitions/vlan"
+    patch:
       tags:
         - Network
-      summary: delete an existing l-interface
-      description: delete an existing l-interface
-      operationId: deleteNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterface
+      summary: update an existing vlan
+      description: |
+        Update an existing vlan
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceVlansVlan
       consumes:
         - application/json
         - application/xml
@@ -19459,36 +25227,44 @@ paths:
           in: path
           required: true
           type: string
+          example: __EQUIPMENT-NAME__
         - name: interface-name
           in: path
           description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
-        - name: resource-version
-          in: query
-          description: resource-version for concurrency
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
           required: true
           type: string
-  /network/vpls-pes/vpls-pe/{equipment-name}/p-interfaces/p-interface/{interface-name}/l-interfaces:
-    get:
+          example: __VLAN-INTERFACE__
+        - name: body
+          in: body
+          description: vlan object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/vlan"
+    delete:
       tags:
         - Network
-      summary: returns l-interfaces
-      description: returns l-interfaces
-      operationId: getNetworkVplsPesVplsPePInterfacesPInterfaceLInterfaces
+      summary: delete an existing vlan
+      description: delete an existing vlan
+      operationId: deleteNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceVlansVlan
+      consumes:
+        - application/json
+        - application/xml
       produces:
         - application/json
         - application/xml
       responses:
-        "200":
-          description: successful operation
-          schema:
-              $ref: "#/definitions/l-interfaces"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -19496,28 +25272,37 @@ paths:
           in: path
           required: true
           type: string
+          example: __EQUIPMENT-NAME__
         - name: interface-name
           in: path
           description: Name that identifies the physical interface
           required: true
           type: string
-        - name: prov-status
-          in: query
-          description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems.
-          required: false
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
           type: string
-        - name: prov-status
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
+          type: string
+          example: __VLAN-INTERFACE__
+        - name: resource-version
           in: query
-          description: Trigger for operational monitoring of this resource by Service Assurance systems.
-          required: false
+          description: resource-version for concurrency
+          required: true
           type: string
-  /network/vpls-pes/vpls-pe/{equipment-name}/p-interfaces/p-interface/{interface-name}:
+  /network/vpls-pes/vpls-pe/{equipment-name}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans:
     get:
       tags:
         - Network
-      summary: returns p-interface
-      description: returns p-interface
-      operationId: getNetworkVplsPesVplsPePInterfacesPInterface
+      summary: returns vlans
+      description: returns vlans
+      operationId: getNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceVlans
       produces:
         - application/json
         - application/xml
@@ -19525,7 +25310,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/p-interface"
+              $ref: "#/getDefinitions/vlans"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -19533,11 +25318,19 @@ paths:
           in: path
           required: true
           type: string
+          example: __EQUIPMENT-NAME__
         - name: interface-name
           in: path
           description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
         - name: prov-status
           in: query
           description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems.
@@ -19548,12 +25341,27 @@ paths:
           description: Trigger for operational monitoring of this resource by Service Assurance systems.
           required: false
           type: string
+        - name: interface-id
+          in: query
+          description: ID of interface
+          required: false
+          type: string
+        - name: macaddr
+          in: query
+          description: MAC address for the interface
+          required: false
+          type: string
+        - name: network-name
+          in: query
+          description: Name of the network
+          required: false
+          type: string
+  /network/vpls-pes/vpls-pe/{equipment-name}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/sriov-vfs/sriov-vf/{pci-id}/relationship-list/relationship:
     put:
       tags:
         - Network
-      summary: create or update an existing p-interface
-      description: create or update an existing p-interface
-      operationId: createOrUpdateNetworkVplsPesVplsPePInterfacesPInterface
+      summary: see node definition for valid relationships
+      operationId: createOrUpdateNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceSriovVfsSriovVfRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -19568,23 +25376,37 @@ paths:
           in: path
           required: true
           type: string
+          example: __EQUIPMENT-NAME__
         - name: interface-name
           in: path
           description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: pci-id
+          in: path
+          description: PCI ID used to identify the sriov-vf
+          required: true
+          type: string
+          example: __PCI-ID__
         - name: body
           in: body
-          description: p-interface object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceSriovVfsSriovVf.json)
           required: true
           schema:
-            $ref: "#/definitions/p-interface"
+            $ref: "#/definitions/relationship"
     delete:
       tags:
         - Network
-      summary: delete an existing p-interface
-      description: delete an existing p-interface
-      operationId: deleteNetworkVplsPesVplsPePInterfacesPInterface
+      summary: delete an existing relationship
+      description: delete an existing relationship
+      operationId: deleteNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceSriovVfsSriovVfRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -19599,23 +25421,32 @@ paths:
           in: path
           required: true
           type: string
+          example: __EQUIPMENT-NAME__
         - name: interface-name
           in: path
           description: Name that identifies the physical interface
           required: true
           type: string
-        - name: resource-version
-          in: query
-          description: resource-version for concurrency
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
           required: true
           type: string
-  /network/vpls-pes/vpls-pe/{equipment-name}/p-interfaces:
+          example: __INTERFACE-NAME__
+        - name: pci-id
+          in: path
+          description: PCI ID used to identify the sriov-vf
+          required: true
+          type: string
+          example: __PCI-ID__
+  /network/vpls-pes/vpls-pe/{equipment-name}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/sriov-vfs/sriov-vf/{pci-id}:
     get:
       tags:
         - Network
-      summary: returns p-interfaces
-      description: returns p-interfaces
-      operationId: getNetworkVplsPesVplsPePInterfaces
+      summary: returns sriov-vf
+      description: returns sriov-vf
+      operationId: getNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceSriovVfsSriovVf
       produces:
         - application/json
         - application/xml
@@ -19623,7 +25454,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/p-interfaces"
+              $ref: "#/getDefinitions/sriov-vf"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -19631,17 +25462,79 @@ paths:
           in: path
           required: true
           type: string
+          example: __EQUIPMENT-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the physical interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: pci-id
+          in: path
+          description: PCI ID used to identify the sriov-vf
+          required: true
+          type: string
+          example: __PCI-ID__
         - name: prov-status
           in: query
           description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems.
           required: false
           type: string
-  /network/vpls-pes/vpls-pe/{equipment-name}/lag-interfaces/lag-interface/{interface-name}/relationship-list/relationship:
+        - name: prov-status
+          in: query
+          description: Trigger for operational monitoring of this resource by Service Assurance systems.
+          required: false
+          type: string
+        - name: interface-id
+          in: query
+          description: ID of interface
+          required: false
+          type: string
+        - name: macaddr
+          in: query
+          description: MAC address for the interface
+          required: false
+          type: string
+        - name: network-name
+          in: query
+          description: Name of the network
+          required: false
+          type: string
+        - name: vf-vlan-filter
+          in: query
+          description: This metadata provides option to specify list of VLAN filters applied on VF to pass the traffic to VM.
+          required: false
+          type: string
+        - name: vf-mac-filter
+          in: query
+          description: When MAC filters are specified, VF-agent service configures VFs to do MAC level filtering before the traffic is passed to VM.
+          required: false
+          type: string
+        - name: vf-vlan-strip
+          in: query
+          description: When this field is set to true, VF will configured to strip the outer TAG before the traffic is passed to VM.
+          required: false
+          type: boolean
+        - name: neutron-network-id
+          in: query
+          description: Neutron network id of the interface
+          required: false
+          type: string
     put:
       tags:
         - Network
-      summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkVplsPesVplsPeLagInterfacesLagInterfaceRelationshipListRelationship
+      summary: create or update an existing sriov-vf
+      description: |
+        Create or update an existing sriov-vf.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceSriovVfsSriovVf
       consumes:
         - application/json
         - application/xml
@@ -19656,23 +25549,48 @@ paths:
           in: path
           required: true
           type: string
+          example: __EQUIPMENT-NAME__
         - name: interface-name
           in: path
-          description: Name that identifies the link aggregate interface
+          description: Name that identifies the physical interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: pci-id
+          in: path
+          description: PCI ID used to identify the sriov-vf
           required: true
           type: string
+          example: __PCI-ID__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: sriov-vf object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceSriovVfsSriovVf.json)
           required: true
           schema:
-            $ref: "#/definitions/relationship"
-    delete:
+            $ref: "#/definitions/sriov-vf"
+    patch:
       tags:
         - Network
-      summary: delete an existing relationship
-      description: delete an existing relationship
-      operationId: deleteNetworkVplsPesVplsPeLagInterfacesLagInterfaceRelationshipListRelationship
+      summary: update an existing sriov-vf
+      description: |
+        Update an existing sriov-vf
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceSriovVfsSriovVf
       consumes:
         - application/json
         - application/xml
@@ -19687,17 +25605,37 @@ paths:
           in: path
           required: true
           type: string
+          example: __EQUIPMENT-NAME__
         - name: interface-name
           in: path
-          description: Name that identifies the link aggregate interface
+          description: Name that identifies the physical interface
           required: true
           type: string
-  /network/vpls-pes/vpls-pe/{equipment-name}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/relationship-list/relationship:
-    put:
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: pci-id
+          in: path
+          description: PCI ID used to identify the sriov-vf
+          required: true
+          type: string
+          example: __PCI-ID__
+        - name: body
+          in: body
+          description: sriov-vf object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/sriov-vf"
+    delete:
       tags:
         - Network
-      summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanRelationshipListRelationship
+      summary: delete an existing sriov-vf
+      description: delete an existing sriov-vf
+      operationId: deleteNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceSriovVfsSriovVf
       consumes:
         - application/json
         - application/xml
@@ -19712,24 +25650,126 @@ paths:
           in: path
           required: true
           type: string
+          example: __EQUIPMENT-NAME__
         - name: interface-name
           in: path
-          description: Name that identifies the link aggregate interface
+          description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
-        - name: vlan-interface
+          example: __INTERFACE-NAME__
+        - name: pci-id
           in: path
-          description: String that identifies the interface
+          description: PCI ID used to identify the sriov-vf
+          required: true
+          type: string
+          example: __PCI-ID__
+        - name: resource-version
+          in: query
+          description: resource-version for concurrency
+          required: true
+          type: string
+  /network/vpls-pes/vpls-pe/{equipment-name}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/sriov-vfs:
+    get:
+      tags:
+        - Network
+      summary: returns sriov-vfs
+      description: returns sriov-vfs
+      operationId: getNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceSriovVfs
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "200":
+          description: successful operation
+          schema:
+              $ref: "#/getDefinitions/sriov-vfs"
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: equipment-name
+          in: path
+          required: true
+          type: string
+          example: __EQUIPMENT-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the physical interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: prov-status
+          in: query
+          description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems.
+          required: false
+          type: string
+        - name: prov-status
+          in: query
+          description: Trigger for operational monitoring of this resource by Service Assurance systems.
+          required: false
+          type: string
+        - name: interface-id
+          in: query
+          description: ID of interface
+          required: false
+          type: string
+        - name: macaddr
+          in: query
+          description: MAC address for the interface
+          required: false
+          type: string
+        - name: network-name
+          in: query
+          description: Name of the network
+          required: false
+          type: string
+  /network/vpls-pes/vpls-pe/{equipment-name}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/relationship-list/relationship:
+    put:
+      tags:
+        - Network
+      summary: see node definition for valid relationships
+      operationId: createOrUpdateNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceRelationshipListRelationship
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: equipment-name
+          in: path
+          required: true
+          type: string
+          example: __EQUIPMENT-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the physical interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterface.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -19738,7 +25778,7 @@ paths:
         - Network
       summary: delete an existing relationship
       description: delete an existing relationship
-      operationId: deleteNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanRelationshipListRelationship
+      operationId: deleteNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -19753,27 +25793,25 @@ paths:
           in: path
           required: true
           type: string
+          example: __EQUIPMENT-NAME__
         - name: interface-name
           in: path
-          description: Name that identifies the link aggregate interface
+          description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
-        - name: vlan-interface
-          in: path
-          description: String that identifies the interface
-          required: true
-          type: string
-  /network/vpls-pes/vpls-pe/{equipment-name}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}/relationship-list/relationship:
+          example: __INTERFACE-NAME__
+  /network/vpls-pes/vpls-pe/{equipment-name}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}/relationship-list/relationship:
     put:
       tags:
         - Network
       summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressListRelationshipListRelationship
+      operationId: createOrUpdateNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressListRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -19788,29 +25826,28 @@ paths:
           in: path
           required: true
           type: string
+          example: __EQUIPMENT-NAME__
         - name: interface-name
           in: path
-          description: Name that identifies the link aggregate interface
+          description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
-        - name: vlan-interface
-          in: path
-          description: String that identifies the interface
-          required: true
-          type: string
+          example: __INTERFACE-NAME__
         - name: l3-interface-ipv4-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -19819,7 +25856,7 @@ paths:
         - Network
       summary: delete an existing relationship
       description: delete an existing relationship
-      operationId: deleteNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressListRelationshipListRelationship
+      operationId: deleteNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressListRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -19834,33 +25871,32 @@ paths:
           in: path
           required: true
           type: string
+          example: __EQUIPMENT-NAME__
         - name: interface-name
           in: path
-          description: Name that identifies the link aggregate interface
+          description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
-        - name: vlan-interface
-          in: path
-          description: String that identifies the interface
-          required: true
-          type: string
+          example: __INTERFACE-NAME__
         - name: l3-interface-ipv4-address
           in: path
           description: IP address
           required: true
           type: string
-  /network/vpls-pes/vpls-pe/{equipment-name}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}:
+          example: __L3-INTERFACE-IPV4-ADDRESS__
+  /network/vpls-pes/vpls-pe/{equipment-name}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}:
     get:
       tags:
         - Network
       summary: returns l3-interface-ipv4-address-list
       description: returns l3-interface-ipv4-address-list
-      operationId: getNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList
+      operationId: getNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList
       produces:
         - application/json
         - application/xml
@@ -19868,7 +25904,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/l3-interface-ipv4-address-list"
+              $ref: "#/getDefinitions/l3-interface-ipv4-address-list"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -19876,39 +25912,33 @@ paths:
           in: path
           required: true
           type: string
+          example: __EQUIPMENT-NAME__
         - name: interface-name
           in: path
-          description: Name that identifies the link aggregate interface
+          description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
-        - name: vlan-interface
-          in: path
-          description: String that identifies the interface
-          required: true
-          type: string
+          example: __INTERFACE-NAME__
         - name: l3-interface-ipv4-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
         - name: prov-status
           in: query
           description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems.
           required: false
           type: string
-        - name: interface-id
-          in: query
-          description: ID of interface
-          required: false
-          type: string
-        - name: interface-role
+        - name: prov-status
           in: query
-          description: Role assigned to this Interface, should use values as defined in ECOMP Yang models.
+          description: Trigger for operational monitoring of this resource by Service Assurance systems.
           required: false
           type: string
         - name: interface-id
@@ -19932,17 +25962,6 @@ paths:
           required: false
           type: integer
           format: int64
-        - name: vpn-key
-          in: query
-          description: This indicates the customers VPN ID associated with this vlan
-          required: false
-          type: string
-        - name: vlan-id-inner
-          in: query
-          description: Inner VLAN tag
-          required: false
-          type: integer
-          format: int64
         - name: neutron-network-id
           in: query
           description: Neutron network id of the interface that address belongs to
@@ -19957,8 +25976,11 @@ paths:
       tags:
         - Network
       summary: create or update an existing l3-interface-ipv4-address-list
-      description: create or update an existing l3-interface-ipv4-address-list
-      operationId: createOrUpdateNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList
+      description: |
+        Create or update an existing l3-interface-ipv4-address-list.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList
       consumes:
         - application/json
         - application/xml
@@ -19973,38 +25995,48 @@ paths:
           in: path
           required: true
           type: string
+          example: __EQUIPMENT-NAME__
         - name: interface-name
           in: path
-          description: Name that identifies the link aggregate interface
+          description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
-        - name: vlan-interface
-          in: path
-          description: String that identifies the interface
-          required: true
-          type: string
+          example: __INTERFACE-NAME__
         - name: l3-interface-ipv4-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
         - name: body
           in: body
-          description: l3-interface-ipv4-address-list object that needs to be created or updated
+          description: l3-interface-ipv4-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList.json)
           required: true
           schema:
             $ref: "#/definitions/l3-interface-ipv4-address-list"
-    delete:
+    patch:
       tags:
         - Network
-      summary: delete an existing l3-interface-ipv4-address-list
-      description: delete an existing l3-interface-ipv4-address-list
-      operationId: deleteNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList
+      summary: update an existing l3-interface-ipv4-address-list
+      description: |
+        Update an existing l3-interface-ipv4-address-list
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList
       consumes:
         - application/json
         - application/xml
@@ -20019,37 +26051,37 @@ paths:
           in: path
           required: true
           type: string
+          example: __EQUIPMENT-NAME__
         - name: interface-name
           in: path
-          description: Name that identifies the link aggregate interface
+          description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
-        - name: vlan-interface
-          in: path
-          description: String that identifies the interface
-          required: true
-          type: string
+          example: __INTERFACE-NAME__
         - name: l3-interface-ipv4-address
           in: path
           description: IP address
           required: true
           type: string
-        - name: resource-version
-          in: query
-          description: resource-version for concurrency
+          example: __L3-INTERFACE-IPV4-ADDRESS__
+        - name: body
+          in: body
+          description: l3-interface-ipv4-address-list object that needs to be created or updated. 
           required: true
-          type: string
-  /network/vpls-pes/vpls-pe/{equipment-name}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}/relationship-list/relationship:
-    put:
+          schema:
+            $ref: "#/patchDefinitions/l3-interface-ipv4-address-list"
+    delete:
       tags:
         - Network
-      summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressListRelationshipListRelationship
+      summary: delete an existing l3-interface-ipv4-address-list
+      description: delete an existing l3-interface-ipv4-address-list
+      operationId: deleteNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList
       consumes:
         - application/json
         - application/xml
@@ -20064,29 +26096,72 @@ paths:
           in: path
           required: true
           type: string
+          example: __EQUIPMENT-NAME__
         - name: interface-name
           in: path
-          description: Name that identifies the link aggregate interface
+          description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
-        - name: vlan-interface
+          example: __INTERFACE-NAME__
+        - name: l3-interface-ipv4-address
           in: path
-          description: String that identifies the interface
+          description: IP address
+          required: true
+          type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
+        - name: resource-version
+          in: query
+          description: resource-version for concurrency
+          required: true
+          type: string
+  /network/vpls-pes/vpls-pe/{equipment-name}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}/relationship-list/relationship:
+    put:
+      tags:
+        - Network
+      summary: see node definition for valid relationships
+      operationId: createOrUpdateNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressListRelationshipListRelationship
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: equipment-name
+          in: path
+          required: true
+          type: string
+          example: __EQUIPMENT-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the physical interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: l3-interface-ipv6-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -20095,7 +26170,7 @@ paths:
         - Network
       summary: delete an existing relationship
       description: delete an existing relationship
-      operationId: deleteNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressListRelationshipListRelationship
+      operationId: deleteNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressListRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -20110,33 +26185,32 @@ paths:
           in: path
           required: true
           type: string
+          example: __EQUIPMENT-NAME__
         - name: interface-name
           in: path
-          description: Name that identifies the link aggregate interface
+          description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
-        - name: vlan-interface
-          in: path
-          description: String that identifies the interface
-          required: true
-          type: string
+          example: __INTERFACE-NAME__
         - name: l3-interface-ipv6-address
           in: path
           description: IP address
           required: true
           type: string
-  /network/vpls-pes/vpls-pe/{equipment-name}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}:
+          example: __L3-INTERFACE-IPV6-ADDRESS__
+  /network/vpls-pes/vpls-pe/{equipment-name}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}:
     get:
       tags:
         - Network
       summary: returns l3-interface-ipv6-address-list
       description: returns l3-interface-ipv6-address-list
-      operationId: getNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList
+      operationId: getNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList
       produces:
         - application/json
         - application/xml
@@ -20144,7 +26218,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/l3-interface-ipv6-address-list"
+              $ref: "#/getDefinitions/l3-interface-ipv6-address-list"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -20152,39 +26226,33 @@ paths:
           in: path
           required: true
           type: string
+          example: __EQUIPMENT-NAME__
         - name: interface-name
           in: path
-          description: Name that identifies the link aggregate interface
+          description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
-        - name: vlan-interface
-          in: path
-          description: String that identifies the interface
-          required: true
-          type: string
+          example: __INTERFACE-NAME__
         - name: l3-interface-ipv6-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
         - name: prov-status
           in: query
           description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems.
           required: false
           type: string
-        - name: interface-id
-          in: query
-          description: ID of interface
-          required: false
-          type: string
-        - name: interface-role
+        - name: prov-status
           in: query
-          description: Role assigned to this Interface, should use values as defined in ECOMP Yang models.
+          description: Trigger for operational monitoring of this resource by Service Assurance systems.
           required: false
           type: string
         - name: interface-id
@@ -20208,17 +26276,6 @@ paths:
           required: false
           type: integer
           format: int64
-        - name: vpn-key
-          in: query
-          description: This indicates the customers VPN ID associated with this vlan
-          required: false
-          type: string
-        - name: vlan-id-inner
-          in: query
-          description: Inner VLAN tag
-          required: false
-          type: integer
-          format: int64
         - name: neutron-network-id
           in: query
           description: Neutron network id of the interface that address belongs to
@@ -20233,8 +26290,11 @@ paths:
       tags:
         - Network
       summary: create or update an existing l3-interface-ipv6-address-list
-      description: create or update an existing l3-interface-ipv6-address-list
-      operationId: createOrUpdateNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList
+      description: |
+        Create or update an existing l3-interface-ipv6-address-list.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList
       consumes:
         - application/json
         - application/xml
@@ -20249,38 +26309,93 @@ paths:
           in: path
           required: true
           type: string
+          example: __EQUIPMENT-NAME__
         - name: interface-name
           in: path
-          description: Name that identifies the link aggregate interface
+          description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
-        - name: vlan-interface
+          example: __INTERFACE-NAME__
+        - name: l3-interface-ipv6-address
           in: path
-          description: String that identifies the interface
+          description: IP address
+          required: true
+          type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
+        - name: body
+          in: body
+          description: l3-interface-ipv6-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList.json)
+          required: true
+          schema:
+            $ref: "#/definitions/l3-interface-ipv6-address-list"
+    patch:
+      tags:
+        - Network
+      summary: update an existing l3-interface-ipv6-address-list
+      description: |
+        Update an existing l3-interface-ipv6-address-list
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: equipment-name
+          in: path
+          required: true
+          type: string
+          example: __EQUIPMENT-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
         - name: l3-interface-ipv6-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
         - name: body
           in: body
-          description: l3-interface-ipv6-address-list object that needs to be created or updated
+          description: l3-interface-ipv6-address-list object that needs to be created or updated
           required: true
           schema:
-            $ref: "#/definitions/l3-interface-ipv6-address-list"
+            $ref: "#/patchDefinitions/l3-interface-ipv6-address-list"
     delete:
       tags:
         - Network
       summary: delete an existing l3-interface-ipv6-address-list
       description: delete an existing l3-interface-ipv6-address-list
-      operationId: deleteNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList
+      operationId: deleteNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList
       consumes:
         - application/json
         - application/xml
@@ -20295,38 +26410,37 @@ paths:
           in: path
           required: true
           type: string
+          example: __EQUIPMENT-NAME__
         - name: interface-name
           in: path
-          description: Name that identifies the link aggregate interface
+          description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
-        - name: vlan-interface
-          in: path
-          description: String that identifies the interface
-          required: true
-          type: string
+          example: __INTERFACE-NAME__
         - name: l3-interface-ipv6-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
         - name: resource-version
           in: query
           description: resource-version for concurrency
           required: true
           type: string
-  /network/vpls-pes/vpls-pe/{equipment-name}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}:
+  /network/vpls-pes/vpls-pe/{equipment-name}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}:
     get:
       tags:
         - Network
-      summary: returns vlan
-      description: returns vlan
-      operationId: getNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlan
+      summary: returns l-interface
+      description: returns l-interface
+      operationId: getNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterface
       produces:
         - application/json
         - application/xml
@@ -20334,7 +26448,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/vlan"
+              $ref: "#/getDefinitions/l-interface"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -20342,34 +26456,27 @@ paths:
           in: path
           required: true
           type: string
+          example: __EQUIPMENT-NAME__
         - name: interface-name
           in: path
-          description: Name that identifies the link aggregate interface
+          description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
-        - name: vlan-interface
-          in: path
-          description: String that identifies the interface
-          required: true
-          type: string
+          example: __INTERFACE-NAME__
         - name: prov-status
           in: query
           description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems.
           required: false
           type: string
-        - name: interface-id
-          in: query
-          description: ID of interface
-          required: false
-          type: string
-        - name: interface-role
+        - name: prov-status
           in: query
-          description: Role assigned to this Interface, should use values as defined in ECOMP Yang models.
+          description: Trigger for operational monitoring of this resource by Service Assurance systems.
           required: false
           type: string
         - name: interface-id
@@ -20387,23 +26494,15 @@ paths:
           description: Name of the network
           required: false
           type: string
-        - name: vlan-id-inner
-          in: query
-          description: Inner VLAN tag
-          required: false
-          type: integer
-          format: int64
-        - name: vpn-key
-          in: query
-          description: This indicates the customers VPN ID associated with this vlan
-          required: false
-          type: string
     put:
       tags:
         - Network
-      summary: create or update an existing vlan
-      description: create or update an existing vlan
-      operationId: createOrUpdateNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlan
+      summary: create or update an existing l-interface
+      description: |
+        Create or update an existing l-interface.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterface
       consumes:
         - application/json
         - application/xml
@@ -20418,33 +26517,42 @@ paths:
           in: path
           required: true
           type: string
+          example: __EQUIPMENT-NAME__
         - name: interface-name
           in: path
-          description: Name that identifies the link aggregate interface
+          description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
-        - name: vlan-interface
-          in: path
-          description: String that identifies the interface
-          required: true
-          type: string
+          example: __INTERFACE-NAME__
         - name: body
           in: body
-          description: vlan object that needs to be created or updated
+          description: l-interface object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterface.json)
           required: true
           schema:
-            $ref: "#/definitions/vlan"
-    delete:
+            $ref: "#/definitions/l-interface"
+    patch:
       tags:
         - Network
-      summary: delete an existing vlan
-      description: delete an existing vlan
-      operationId: deleteNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlan
+      summary: update an existing l-interface
+      description: |
+        Update an existing l-interface
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterface
       consumes:
         - application/json
         - application/xml
@@ -20459,94 +26567,31 @@ paths:
           in: path
           required: true
           type: string
+          example: __EQUIPMENT-NAME__
         - name: interface-name
           in: path
-          description: Name that identifies the link aggregate interface
+          description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
-        - name: vlan-interface
-          in: path
-          description: String that identifies the interface
-          required: true
-          type: string
-        - name: resource-version
-          in: query
-          description: resource-version for concurrency
+          example: __INTERFACE-NAME__
+        - name: body
+          in: body
+          description: l-interface object that needs to be created or updated. 
           required: true
-          type: string
-  /network/vpls-pes/vpls-pe/{equipment-name}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans:
-    get:
-      tags:
-        - Network
-      summary: returns vlans
-      description: returns vlans
-      operationId: getNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceVlans
-      produces:
-        - application/json
-        - application/xml
-      responses:
-        "200":
-          description: successful operation
           schema:
-              $ref: "#/definitions/vlans"
-        "default":
-          description: Response codes found in [response codes](https://wiki.onap.org/).
-      parameters:
-        - name: equipment-name
-          in: path
-          required: true
-          type: string
-        - name: interface-name
-          in: path
-          description: Name that identifies the link aggregate interface
-          required: true
-          type: string
-        - name: interface-name
-          in: path
-          description: Name given to the interface
-          required: true
-          type: string
-        - name: prov-status
-          in: query
-          description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems.
-          required: false
-          type: string
-        - name: interface-id
-          in: query
-          description: ID of interface
-          required: false
-          type: string
-        - name: interface-role
-          in: query
-          description: Role assigned to this Interface, should use values as defined in ECOMP Yang models.
-          required: false
-          type: string
-        - name: interface-id
-          in: query
-          description: ID of interface
-          required: false
-          type: string
-        - name: macaddr
-          in: query
-          description: MAC address for the interface
-          required: false
-          type: string
-        - name: network-name
-          in: query
-          description: Name of the network
-          required: false
-          type: string
-  /network/vpls-pes/vpls-pe/{equipment-name}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/sriov-vfs/sriov-vf/{pci-id}/relationship-list/relationship:
-    put:
+            $ref: "#/patchDefinitions/l-interface"
+    delete:
       tags:
         - Network
-      summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfsSriovVfRelationshipListRelationship
+      summary: delete an existing l-interface
+      description: delete an existing l-interface
+      operationId: deleteNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterface
       consumes:
         - application/json
         - application/xml
@@ -20561,40 +26606,39 @@ paths:
           in: path
           required: true
           type: string
+          example: __EQUIPMENT-NAME__
         - name: interface-name
           in: path
-          description: Name that identifies the link aggregate interface
+          description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
-        - name: pci-id
-          in: path
-          description: PCI ID used to identify the sriov-vf
+          example: __INTERFACE-NAME__
+        - name: resource-version
+          in: query
+          description: resource-version for concurrency
           required: true
           type: string
-        - name: body
-          in: body
-          description: relationship object that needs to be created or updated
-          required: true
-          schema:
-            $ref: "#/definitions/relationship"
-    delete:
+  /network/vpls-pes/vpls-pe/{equipment-name}/p-interfaces/p-interface/{interface-name}/l-interfaces:
+    get:
       tags:
         - Network
-      summary: delete an existing relationship
-      description: delete an existing relationship
-      operationId: deleteNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfsSriovVfRelationshipListRelationship
-      consumes:
-        - application/json
-        - application/xml
+      summary: returns l-interfaces
+      description: returns l-interfaces
+      operationId: getNetworkVplsPesVplsPePInterfacesPInterfaceLInterfaces
       produces:
         - application/json
         - application/xml
       responses:
+        "200":
+          description: successful operation
+          schema:
+              $ref: "#/getDefinitions/l-interfaces"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -20602,28 +26646,30 @@ paths:
           in: path
           required: true
           type: string
+          example: __EQUIPMENT-NAME__
         - name: interface-name
           in: path
-          description: Name that identifies the link aggregate interface
+          description: Name that identifies the physical interface
           required: true
           type: string
-        - name: interface-name
-          in: path
-          description: Name given to the interface
-          required: true
+          example: __INTERFACE-NAME__
+        - name: prov-status
+          in: query
+          description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems.
+          required: false
           type: string
-        - name: pci-id
-          in: path
-          description: PCI ID used to identify the sriov-vf
-          required: true
+        - name: prov-status
+          in: query
+          description: Trigger for operational monitoring of this resource by Service Assurance systems.
+          required: false
           type: string
-  /network/vpls-pes/vpls-pe/{equipment-name}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/sriov-vfs/sriov-vf/{pci-id}:
+  /network/vpls-pes/vpls-pe/{equipment-name}/p-interfaces/p-interface/{interface-name}:
     get:
       tags:
         - Network
-      summary: returns sriov-vf
-      description: returns sriov-vf
-      operationId: getNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfsSriovVf
+      summary: returns p-interface
+      description: returns p-interface
+      operationId: getNetworkVplsPesVplsPePInterfacesPInterface
       produces:
         - application/json
         - application/xml
@@ -20631,7 +26677,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/sriov-vf"
+              $ref: "#/getDefinitions/p-interface"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -20639,77 +26685,32 @@ paths:
           in: path
           required: true
           type: string
+          example: __EQUIPMENT-NAME__
         - name: interface-name
           in: path
-          description: Name that identifies the link aggregate interface
-          required: true
-          type: string
-        - name: interface-name
-          in: path
-          description: Name given to the interface
-          required: true
-          type: string
-        - name: pci-id
-          in: path
-          description: PCI ID used to identify the sriov-vf
+          description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: prov-status
           in: query
           description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems.
           required: false
           type: string
-        - name: interface-id
-          in: query
-          description: ID of interface
-          required: false
-          type: string
-        - name: interface-role
-          in: query
-          description: Role assigned to this Interface, should use values as defined in ECOMP Yang models.
-          required: false
-          type: string
-        - name: interface-id
-          in: query
-          description: ID of interface
-          required: false
-          type: string
-        - name: macaddr
-          in: query
-          description: MAC address for the interface
-          required: false
-          type: string
-        - name: network-name
-          in: query
-          description: Name of the network
-          required: false
-          type: string
-        - name: vf-vlan-filter
-          in: query
-          description: This metadata provides option to specify list of VLAN filters applied on VF to pass the traffic to VM.
-          required: false
-          type: string
-        - name: vf-mac-filter
-          in: query
-          description: When MAC filters are specified, VF-agent service configures VFs to do MAC level filtering before the traffic is passed to VM.
-          required: false
-          type: string
-        - name: vf-vlan-strip
-          in: query
-          description: When this field is set to true, VF will configured to strip the outer TAG before the traffic is passed to VM.
-          required: false
-          type: boolean
-        - name: neutron-network-id
+        - name: prov-status
           in: query
-          description: Neutron network id of the interface
+          description: Trigger for operational monitoring of this resource by Service Assurance systems.
           required: false
           type: string
     put:
       tags:
         - Network
-      summary: create or update an existing sriov-vf
-      description: create or update an existing sriov-vf
-      operationId: createOrUpdateNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfsSriovVf
+      summary: create or update an existing p-interface
+      description: |
+        Create or update an existing p-interface.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkVplsPesVplsPePInterfacesPInterface
       consumes:
         - application/json
         - application/xml
@@ -20724,33 +26725,69 @@ paths:
           in: path
           required: true
           type: string
+          example: __EQUIPMENT-NAME__
         - name: interface-name
           in: path
-          description: Name that identifies the link aggregate interface
+          description: Name that identifies the physical interface
           required: true
           type: string
-        - name: interface-name
+          example: __INTERFACE-NAME__
+        - name: body
+          in: body
+          description: p-interface object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVplsPesVplsPePInterfacesPInterface.json)
+          required: true
+          schema:
+            $ref: "#/definitions/p-interface"
+    patch:
+      tags:
+        - Network
+      summary: update an existing p-interface
+      description: |
+        Update an existing p-interface
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkVplsPesVplsPePInterfacesPInterface
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: equipment-name
           in: path
-          description: Name given to the interface
           required: true
           type: string
-        - name: pci-id
+          example: __EQUIPMENT-NAME__
+        - name: interface-name
           in: path
-          description: PCI ID used to identify the sriov-vf
+          description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: body
           in: body
-          description: sriov-vf object that needs to be created or updated
+          description: p-interface object that needs to be created or updated. 
           required: true
           schema:
-            $ref: "#/definitions/sriov-vf"
+            $ref: "#/patchDefinitions/p-interface"
     delete:
       tags:
         - Network
-      summary: delete an existing sriov-vf
-      description: delete an existing sriov-vf
-      operationId: deleteNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfsSriovVf
+      summary: delete an existing p-interface
+      description: delete an existing p-interface
+      operationId: deleteNetworkVplsPesVplsPePInterfacesPInterface
       consumes:
         - application/json
         - application/xml
@@ -20765,33 +26802,25 @@ paths:
           in: path
           required: true
           type: string
+          example: __EQUIPMENT-NAME__
         - name: interface-name
           in: path
-          description: Name that identifies the link aggregate interface
-          required: true
-          type: string
-        - name: interface-name
-          in: path
-          description: Name given to the interface
-          required: true
-          type: string
-        - name: pci-id
-          in: path
-          description: PCI ID used to identify the sriov-vf
+          description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: resource-version
           in: query
           description: resource-version for concurrency
           required: true
           type: string
-  /network/vpls-pes/vpls-pe/{equipment-name}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/sriov-vfs:
+  /network/vpls-pes/vpls-pe/{equipment-name}/p-interfaces:
     get:
       tags:
         - Network
-      summary: returns sriov-vfs
-      description: returns sriov-vfs
-      operationId: getNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfs
+      summary: returns p-interfaces
+      description: returns p-interfaces
+      operationId: getNetworkVplsPesVplsPePInterfaces
       produces:
         - application/json
         - application/xml
@@ -20799,7 +26828,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/sriov-vfs"
+              $ref: "#/getDefinitions/p-interfaces"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -20807,52 +26836,18 @@ paths:
           in: path
           required: true
           type: string
-        - name: interface-name
-          in: path
-          description: Name that identifies the link aggregate interface
-          required: true
-          type: string
-        - name: interface-name
-          in: path
-          description: Name given to the interface
-          required: true
-          type: string
+          example: __EQUIPMENT-NAME__
         - name: prov-status
           in: query
           description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems.
           required: false
           type: string
-        - name: interface-id
-          in: query
-          description: ID of interface
-          required: false
-          type: string
-        - name: interface-role
-          in: query
-          description: Role assigned to this Interface, should use values as defined in ECOMP Yang models.
-          required: false
-          type: string
-        - name: interface-id
-          in: query
-          description: ID of interface
-          required: false
-          type: string
-        - name: macaddr
-          in: query
-          description: MAC address for the interface
-          required: false
-          type: string
-        - name: network-name
-          in: query
-          description: Name of the network
-          required: false
-          type: string
-  /network/vpls-pes/vpls-pe/{equipment-name}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/relationship-list/relationship:
+  /network/vpls-pes/vpls-pe/{equipment-name}/lag-interfaces/lag-interface/{interface-name}/relationship-list/relationship:
     put:
       tags:
         - Network
       summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceRelationshipListRelationship
+      operationId: createOrUpdateNetworkVplsPesVplsPeLagInterfacesLagInterfaceRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -20867,19 +26862,16 @@ paths:
           in: path
           required: true
           type: string
+          example: __EQUIPMENT-NAME__
         - name: interface-name
           in: path
           description: Name that identifies the link aggregate interface
           required: true
           type: string
-        - name: interface-name
-          in: path
-          description: Name given to the interface
-          required: true
-          type: string
+          example: __INTERFACE-NAME__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVplsPesVplsPeLagInterfacesLagInterface.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -20888,7 +26880,7 @@ paths:
         - Network
       summary: delete an existing relationship
       description: delete an existing relationship
-      operationId: deleteNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceRelationshipListRelationship
+      operationId: deleteNetworkVplsPesVplsPeLagInterfacesLagInterfaceRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -20903,22 +26895,19 @@ paths:
           in: path
           required: true
           type: string
+          example: __EQUIPMENT-NAME__
         - name: interface-name
           in: path
           description: Name that identifies the link aggregate interface
           required: true
           type: string
-        - name: interface-name
-          in: path
-          description: Name given to the interface
-          required: true
-          type: string
-  /network/vpls-pes/vpls-pe/{equipment-name}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}/relationship-list/relationship:
+          example: __INTERFACE-NAME__
+  /network/vpls-pes/vpls-pe/{equipment-name}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/relationship-list/relationship:
     put:
       tags:
         - Network
       summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressListRelationshipListRelationship
+      operationId: createOrUpdateNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -20933,24 +26922,28 @@ paths:
           in: path
           required: true
           type: string
+          example: __EQUIPMENT-NAME__
         - name: interface-name
           in: path
           description: Name that identifies the link aggregate interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
-        - name: l3-interface-ipv4-address
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
           in: path
-          description: IP address
+          description: String that identifies the interface
           required: true
           type: string
+          example: __VLAN-INTERFACE__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlan.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -20959,7 +26952,7 @@ paths:
         - Network
       summary: delete an existing relationship
       description: delete an existing relationship
-      operationId: deleteNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressListRelationshipListRelationship
+      operationId: deleteNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -20974,28 +26967,128 @@ paths:
           in: path
           required: true
           type: string
+          example: __EQUIPMENT-NAME__
         - name: interface-name
           in: path
           description: Name that identifies the link aggregate interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
-        - name: l3-interface-ipv4-address
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
           in: path
-          description: IP address
+          description: String that identifies the interface
           required: true
           type: string
-  /network/vpls-pes/vpls-pe/{equipment-name}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}:
-    get:
+          example: __VLAN-INTERFACE__
+  /network/vpls-pes/vpls-pe/{equipment-name}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}/relationship-list/relationship:
+    put:
       tags:
         - Network
-      summary: returns l3-interface-ipv4-address-list
-      description: returns l3-interface-ipv4-address-list
-      operationId: getNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList
+      summary: see node definition for valid relationships
+      operationId: createOrUpdateNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressListRelationshipListRelationship
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: equipment-name
+          in: path
+          required: true
+          type: string
+          example: __EQUIPMENT-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
+          type: string
+          example: __VLAN-INTERFACE__
+        - name: l3-interface-ipv4-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
+        - name: body
+          in: body
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList.json)
+          required: true
+          schema:
+            $ref: "#/definitions/relationship"
+    delete:
+      tags:
+        - Network
+      summary: delete an existing relationship
+      description: delete an existing relationship
+      operationId: deleteNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressListRelationshipListRelationship
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: equipment-name
+          in: path
+          required: true
+          type: string
+          example: __EQUIPMENT-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
+          type: string
+          example: __VLAN-INTERFACE__
+        - name: l3-interface-ipv4-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
+  /network/vpls-pes/vpls-pe/{equipment-name}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}:
+    get:
+      tags:
+        - Network
+      summary: returns l3-interface-ipv4-address-list
+      description: returns l3-interface-ipv4-address-list
+      operationId: getNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList
       produces:
         - application/json
         - application/xml
@@ -21003,7 +27096,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/l3-interface-ipv4-address-list"
+              $ref: "#/getDefinitions/l3-interface-ipv4-address-list"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -21011,21 +27104,31 @@ paths:
           in: path
           required: true
           type: string
+          example: __EQUIPMENT-NAME__
         - name: interface-name
           in: path
           description: Name that identifies the link aggregate interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
+          type: string
+          example: __VLAN-INTERFACE__
         - name: l3-interface-ipv4-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
         - name: prov-status
           in: query
           description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems.
@@ -21062,6 +27165,17 @@ paths:
           required: false
           type: integer
           format: int64
+        - name: vpn-key
+          in: query
+          description: This indicates the customers VPN ID associated with this vlan
+          required: false
+          type: string
+        - name: vlan-id-inner
+          in: query
+          description: Inner VLAN tag
+          required: false
+          type: integer
+          format: int64
         - name: neutron-network-id
           in: query
           description: Neutron network id of the interface that address belongs to
@@ -21076,8 +27190,11 @@ paths:
       tags:
         - Network
       summary: create or update an existing l3-interface-ipv4-address-list
-      description: create or update an existing l3-interface-ipv4-address-list
-      operationId: createOrUpdateNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList
+      description: |
+        Create or update an existing l3-interface-ipv4-address-list.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList
       consumes:
         - application/json
         - application/xml
@@ -21092,33 +27209,105 @@ paths:
           in: path
           required: true
           type: string
+          example: __EQUIPMENT-NAME__
         - name: interface-name
           in: path
           description: Name that identifies the link aggregate interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
+          type: string
+          example: __VLAN-INTERFACE__
         - name: l3-interface-ipv4-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
         - name: body
           in: body
-          description: l3-interface-ipv4-address-list object that needs to be created or updated
+          description: l3-interface-ipv4-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList.json)
           required: true
           schema:
             $ref: "#/definitions/l3-interface-ipv4-address-list"
+    patch:
+      tags:
+        - Network
+      summary: update an existing l3-interface-ipv4-address-list
+      description: |
+        Update an existing l3-interface-ipv4-address-list
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: equipment-name
+          in: path
+          required: true
+          type: string
+          example: __EQUIPMENT-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
+          type: string
+          example: __VLAN-INTERFACE__
+        - name: l3-interface-ipv4-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
+        - name: body
+          in: body
+          description: l3-interface-ipv4-address-list object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/l3-interface-ipv4-address-list"
     delete:
       tags:
         - Network
       summary: delete an existing l3-interface-ipv4-address-list
       description: delete an existing l3-interface-ipv4-address-list
-      operationId: deleteNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList
+      operationId: deleteNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList
       consumes:
         - application/json
         - application/xml
@@ -21133,32 +27322,42 @@ paths:
           in: path
           required: true
           type: string
+          example: __EQUIPMENT-NAME__
         - name: interface-name
           in: path
           description: Name that identifies the link aggregate interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
+          type: string
+          example: __VLAN-INTERFACE__
         - name: l3-interface-ipv4-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
         - name: resource-version
           in: query
           description: resource-version for concurrency
           required: true
           type: string
-  /network/vpls-pes/vpls-pe/{equipment-name}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}/relationship-list/relationship:
+  /network/vpls-pes/vpls-pe/{equipment-name}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}/relationship-list/relationship:
     put:
       tags:
         - Network
       summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressListRelationshipListRelationship
+      operationId: createOrUpdateNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressListRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -21173,24 +27372,34 @@ paths:
           in: path
           required: true
           type: string
+          example: __EQUIPMENT-NAME__
         - name: interface-name
           in: path
           description: Name that identifies the link aggregate interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
+          type: string
+          example: __VLAN-INTERFACE__
         - name: l3-interface-ipv6-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -21199,7 +27408,7 @@ paths:
         - Network
       summary: delete an existing relationship
       description: delete an existing relationship
-      operationId: deleteNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressListRelationshipListRelationship
+      operationId: deleteNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressListRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -21214,28 +27423,38 @@ paths:
           in: path
           required: true
           type: string
+          example: __EQUIPMENT-NAME__
         - name: interface-name
           in: path
           description: Name that identifies the link aggregate interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
+          type: string
+          example: __VLAN-INTERFACE__
         - name: l3-interface-ipv6-address
           in: path
           description: IP address
           required: true
           type: string
-  /network/vpls-pes/vpls-pe/{equipment-name}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}:
+          example: __L3-INTERFACE-IPV6-ADDRESS__
+  /network/vpls-pes/vpls-pe/{equipment-name}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}:
     get:
       tags:
         - Network
       summary: returns l3-interface-ipv6-address-list
       description: returns l3-interface-ipv6-address-list
-      operationId: getNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList
+      operationId: getNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList
       produces:
         - application/json
         - application/xml
@@ -21243,7 +27462,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/l3-interface-ipv6-address-list"
+              $ref: "#/getDefinitions/l3-interface-ipv6-address-list"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -21251,21 +27470,31 @@ paths:
           in: path
           required: true
           type: string
+          example: __EQUIPMENT-NAME__
         - name: interface-name
           in: path
           description: Name that identifies the link aggregate interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
+          type: string
+          example: __VLAN-INTERFACE__
         - name: l3-interface-ipv6-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
         - name: prov-status
           in: query
           description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems.
@@ -21302,6 +27531,17 @@ paths:
           required: false
           type: integer
           format: int64
+        - name: vpn-key
+          in: query
+          description: This indicates the customers VPN ID associated with this vlan
+          required: false
+          type: string
+        - name: vlan-id-inner
+          in: query
+          description: Inner VLAN tag
+          required: false
+          type: integer
+          format: int64
         - name: neutron-network-id
           in: query
           description: Neutron network id of the interface that address belongs to
@@ -21316,8 +27556,11 @@ paths:
       tags:
         - Network
       summary: create or update an existing l3-interface-ipv6-address-list
-      description: create or update an existing l3-interface-ipv6-address-list
-      operationId: createOrUpdateNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList
+      description: |
+        Create or update an existing l3-interface-ipv6-address-list.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList
       consumes:
         - application/json
         - application/xml
@@ -21332,33 +27575,105 @@ paths:
           in: path
           required: true
           type: string
+          example: __EQUIPMENT-NAME__
         - name: interface-name
           in: path
           description: Name that identifies the link aggregate interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
+          type: string
+          example: __VLAN-INTERFACE__
         - name: l3-interface-ipv6-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
         - name: body
           in: body
-          description: l3-interface-ipv6-address-list object that needs to be created or updated
+          description: l3-interface-ipv6-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList.json)
           required: true
           schema:
             $ref: "#/definitions/l3-interface-ipv6-address-list"
+    patch:
+      tags:
+        - Network
+      summary: update an existing l3-interface-ipv6-address-list
+      description: |
+        Update an existing l3-interface-ipv6-address-list
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: equipment-name
+          in: path
+          required: true
+          type: string
+          example: __EQUIPMENT-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
+          type: string
+          example: __VLAN-INTERFACE__
+        - name: l3-interface-ipv6-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
+        - name: body
+          in: body
+          description: l3-interface-ipv6-address-list object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/l3-interface-ipv6-address-list"
     delete:
       tags:
         - Network
       summary: delete an existing l3-interface-ipv6-address-list
       description: delete an existing l3-interface-ipv6-address-list
-      operationId: deleteNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList
+      operationId: deleteNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList
       consumes:
         - application/json
         - application/xml
@@ -21373,33 +27688,43 @@ paths:
           in: path
           required: true
           type: string
+          example: __EQUIPMENT-NAME__
         - name: interface-name
           in: path
           description: Name that identifies the link aggregate interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
+          type: string
+          example: __VLAN-INTERFACE__
         - name: l3-interface-ipv6-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
         - name: resource-version
           in: query
           description: resource-version for concurrency
           required: true
           type: string
-  /network/vpls-pes/vpls-pe/{equipment-name}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}:
+  /network/vpls-pes/vpls-pe/{equipment-name}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}:
     get:
       tags:
         - Network
-      summary: returns l-interface
-      description: returns l-interface
-      operationId: getNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterface
+      summary: returns vlan
+      description: returns vlan
+      operationId: getNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlan
       produces:
         - application/json
         - application/xml
@@ -21407,7 +27732,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/l-interface"
+              $ref: "#/getDefinitions/vlan"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -21415,16 +27740,25 @@ paths:
           in: path
           required: true
           type: string
+          example: __EQUIPMENT-NAME__
         - name: interface-name
           in: path
           description: Name that identifies the link aggregate interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
+          type: string
+          example: __VLAN-INTERFACE__
         - name: prov-status
           in: query
           description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems.
@@ -21455,12 +27789,26 @@ paths:
           description: Name of the network
           required: false
           type: string
+        - name: vlan-id-inner
+          in: query
+          description: Inner VLAN tag
+          required: false
+          type: integer
+          format: int64
+        - name: vpn-key
+          in: query
+          description: This indicates the customers VPN ID associated with this vlan
+          required: false
+          type: string
     put:
       tags:
         - Network
-      summary: create or update an existing l-interface
-      description: create or update an existing l-interface
-      operationId: createOrUpdateNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterface
+      summary: create or update an existing vlan
+      description: |
+        Create or update an existing vlan.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlan
       consumes:
         - application/json
         - application/xml
@@ -21475,28 +27823,48 @@ paths:
           in: path
           required: true
           type: string
+          example: __EQUIPMENT-NAME__
         - name: interface-name
           in: path
           description: Name that identifies the link aggregate interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
+          type: string
+          example: __VLAN-INTERFACE__
         - name: body
           in: body
-          description: l-interface object that needs to be created or updated
+          description: vlan object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlan.json)
           required: true
           schema:
-            $ref: "#/definitions/l-interface"
-    delete:
+            $ref: "#/definitions/vlan"
+    patch:
       tags:
         - Network
-      summary: delete an existing l-interface
-      description: delete an existing l-interface
-      operationId: deleteNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterface
+      summary: update an existing vlan
+      description: |
+        Update an existing vlan
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlan
       consumes:
         - application/json
         - application/xml
@@ -21511,36 +27879,44 @@ paths:
           in: path
           required: true
           type: string
+          example: __EQUIPMENT-NAME__
         - name: interface-name
           in: path
           description: Name that identifies the link aggregate interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
-        - name: resource-version
-          in: query
-          description: resource-version for concurrency
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
           required: true
           type: string
-  /network/vpls-pes/vpls-pe/{equipment-name}/lag-interfaces/lag-interface/{interface-name}/l-interfaces:
-    get:
+          example: __VLAN-INTERFACE__
+        - name: body
+          in: body
+          description: vlan object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/vlan"
+    delete:
       tags:
         - Network
-      summary: returns l-interfaces
-      description: returns l-interfaces
-      operationId: getNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfaces
+      summary: delete an existing vlan
+      description: delete an existing vlan
+      operationId: deleteNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlan
+      consumes:
+        - application/json
+        - application/xml
       produces:
         - application/json
         - application/xml
       responses:
-        "200":
-          description: successful operation
-          schema:
-              $ref: "#/definitions/l-interfaces"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -21548,33 +27924,37 @@ paths:
           in: path
           required: true
           type: string
+          example: __EQUIPMENT-NAME__
         - name: interface-name
           in: path
           description: Name that identifies the link aggregate interface
           required: true
           type: string
-        - name: prov-status
-          in: query
-          description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems.
-          required: false
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
           type: string
-        - name: interface-id
-          in: query
-          description: ID of interface
-          required: false
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
           type: string
-        - name: interface-role
+          example: __VLAN-INTERFACE__
+        - name: resource-version
           in: query
-          description: Role assigned to this Interface, should use values as defined in ECOMP Yang models.
-          required: false
+          description: resource-version for concurrency
+          required: true
           type: string
-  /network/vpls-pes/vpls-pe/{equipment-name}/lag-interfaces/lag-interface/{interface-name}:
+  /network/vpls-pes/vpls-pe/{equipment-name}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans:
     get:
       tags:
         - Network
-      summary: returns lag-interface
-      description: returns lag-interface
-      operationId: getNetworkVplsPesVplsPeLagInterfacesLagInterface
+      summary: returns vlans
+      description: returns vlans
+      operationId: getNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceVlans
       produces:
         - application/json
         - application/xml
@@ -21582,7 +27962,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/lag-interface"
+              $ref: "#/getDefinitions/vlans"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -21590,11 +27970,19 @@ paths:
           in: path
           required: true
           type: string
+          example: __EQUIPMENT-NAME__
         - name: interface-name
           in: path
           description: Name that identifies the link aggregate interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
         - name: prov-status
           in: query
           description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems.
@@ -21610,12 +27998,27 @@ paths:
           description: Role assigned to this Interface, should use values as defined in ECOMP Yang models.
           required: false
           type: string
+        - name: interface-id
+          in: query
+          description: ID of interface
+          required: false
+          type: string
+        - name: macaddr
+          in: query
+          description: MAC address for the interface
+          required: false
+          type: string
+        - name: network-name
+          in: query
+          description: Name of the network
+          required: false
+          type: string
+  /network/vpls-pes/vpls-pe/{equipment-name}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/sriov-vfs/sriov-vf/{pci-id}/relationship-list/relationship:
     put:
       tags:
         - Network
-      summary: create or update an existing lag-interface
-      description: create or update an existing lag-interface
-      operationId: createOrUpdateNetworkVplsPesVplsPeLagInterfacesLagInterface
+      summary: see node definition for valid relationships
+      operationId: createOrUpdateNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfsSriovVfRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -21630,23 +28033,37 @@ paths:
           in: path
           required: true
           type: string
+          example: __EQUIPMENT-NAME__
         - name: interface-name
           in: path
           description: Name that identifies the link aggregate interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: pci-id
+          in: path
+          description: PCI ID used to identify the sriov-vf
+          required: true
+          type: string
+          example: __PCI-ID__
         - name: body
           in: body
-          description: lag-interface object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfsSriovVf.json)
           required: true
           schema:
-            $ref: "#/definitions/lag-interface"
+            $ref: "#/definitions/relationship"
     delete:
       tags:
         - Network
-      summary: delete an existing lag-interface
-      description: delete an existing lag-interface
-      operationId: deleteNetworkVplsPesVplsPeLagInterfacesLagInterface
+      summary: delete an existing relationship
+      description: delete an existing relationship
+      operationId: deleteNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfsSriovVfRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -21661,23 +28078,32 @@ paths:
           in: path
           required: true
           type: string
+          example: __EQUIPMENT-NAME__
         - name: interface-name
           in: path
           description: Name that identifies the link aggregate interface
           required: true
           type: string
-        - name: resource-version
-          in: query
-          description: resource-version for concurrency
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
           required: true
           type: string
-  /network/vpls-pes/vpls-pe/{equipment-name}/lag-interfaces:
+          example: __INTERFACE-NAME__
+        - name: pci-id
+          in: path
+          description: PCI ID used to identify the sriov-vf
+          required: true
+          type: string
+          example: __PCI-ID__
+  /network/vpls-pes/vpls-pe/{equipment-name}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/sriov-vfs/sriov-vf/{pci-id}:
     get:
       tags:
         - Network
-      summary: returns lag-interfaces
-      description: returns lag-interfaces
-      operationId: getNetworkVplsPesVplsPeLagInterfaces
+      summary: returns sriov-vf
+      description: returns sriov-vf
+      operationId: getNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfsSriovVf
       produces:
         - application/json
         - application/xml
@@ -21685,7 +28111,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/lag-interfaces"
+              $ref: "#/getDefinitions/sriov-vf"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -21693,44 +28119,84 @@ paths:
           in: path
           required: true
           type: string
-        - name: prov-status
-          in: query
-          description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems.
-          required: false
+          example: __EQUIPMENT-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
+          required: true
           type: string
-  /network/vpls-pes/vpls-pe/{equipment-name}:
-    get:
-      tags:
-        - Network
-      summary: returns vpls-pe
-      description: returns vpls-pe
-      operationId: getNetworkVplsPesVplsPe
-      produces:
-        - application/json
-        - application/xml
-      responses:
-        "200":
-          description: successful operation
-          schema:
-              $ref: "#/definitions/vpls-pe"
-        "default":
-          description: Response codes found in [response codes](https://wiki.onap.org/).
-      parameters:
-        - name: equipment-name
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: pci-id
           in: path
+          description: PCI ID used to identify the sriov-vf
           required: true
           type: string
+          example: __PCI-ID__
         - name: prov-status
           in: query
           description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems.
           required: false
           type: string
+        - name: interface-id
+          in: query
+          description: ID of interface
+          required: false
+          type: string
+        - name: interface-role
+          in: query
+          description: Role assigned to this Interface, should use values as defined in ECOMP Yang models.
+          required: false
+          type: string
+        - name: interface-id
+          in: query
+          description: ID of interface
+          required: false
+          type: string
+        - name: macaddr
+          in: query
+          description: MAC address for the interface
+          required: false
+          type: string
+        - name: network-name
+          in: query
+          description: Name of the network
+          required: false
+          type: string
+        - name: vf-vlan-filter
+          in: query
+          description: This metadata provides option to specify list of VLAN filters applied on VF to pass the traffic to VM.
+          required: false
+          type: string
+        - name: vf-mac-filter
+          in: query
+          description: When MAC filters are specified, VF-agent service configures VFs to do MAC level filtering before the traffic is passed to VM.
+          required: false
+          type: string
+        - name: vf-vlan-strip
+          in: query
+          description: When this field is set to true, VF will configured to strip the outer TAG before the traffic is passed to VM.
+          required: false
+          type: boolean
+        - name: neutron-network-id
+          in: query
+          description: Neutron network id of the interface
+          required: false
+          type: string
     put:
       tags:
         - Network
-      summary: create or update an existing vpls-pe
-      description: create or update an existing vpls-pe
-      operationId: createOrUpdateNetworkVplsPesVplsPe
+      summary: create or update an existing sriov-vf
+      description: |
+        Create or update an existing sriov-vf.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfsSriovVf
       consumes:
         - application/json
         - application/xml
@@ -21745,18 +28211,48 @@ paths:
           in: path
           required: true
           type: string
+          example: __EQUIPMENT-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: pci-id
+          in: path
+          description: PCI ID used to identify the sriov-vf
+          required: true
+          type: string
+          example: __PCI-ID__
         - name: body
           in: body
-          description: vpls-pe object that needs to be created or updated
+          description: sriov-vf object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfsSriovVf.json)
           required: true
           schema:
-            $ref: "#/definitions/vpls-pe"
-    delete:
+            $ref: "#/definitions/sriov-vf"
+    patch:
       tags:
         - Network
-      summary: delete an existing vpls-pe
-      description: delete an existing vpls-pe
-      operationId: deleteNetworkVplsPesVplsPe
+      summary: update an existing sriov-vf
+      description: |
+        Update an existing sriov-vf
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfsSriovVf
       consumes:
         - application/json
         - application/xml
@@ -21771,61 +28267,37 @@ paths:
           in: path
           required: true
           type: string
-        - name: resource-version
-          in: query
-          description: resource-version for concurrency
+          example: __EQUIPMENT-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
           required: true
           type: string
-  /network/vpls-pes:
-    get:
-      tags:
-        - Network
-      summary: returns vpls-pes
-      description: returns vpls-pes
-      operationId: getNetworkVplsPes
-      produces:
-        - application/json
-        - application/xml
-      responses:
-        "200":
-          description: successful operation
-          schema:
-              $ref: "#/definitions/vpls-pes"
-        "default":
-          description: Response codes found in [response codes](https://wiki.onap.org/).
-  /network/multicast-configurations/multicast-configuration/{multicast-configuration-id}/relationship-list/relationship:
-    put:
-      tags:
-        - Network
-      summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkMulticastConfigurationsMulticastConfigurationRelationshipListRelationship
-      consumes:
-        - application/json
-        - application/xml
-      produces:
-        - application/json
-        - application/xml
-      responses:
-        "default":
-          description: Response codes found in [response codes](https://wiki.onap.org/).
-      parameters:
-        - name: multicast-configuration-id
+          example: __INTERFACE-NAME__
+        - name: interface-name
           in: path
-          description: Unique id of multicast configuration.
+          description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
+        - name: pci-id
+          in: path
+          description: PCI ID used to identify the sriov-vf
+          required: true
+          type: string
+          example: __PCI-ID__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: sriov-vf object that needs to be created or updated. 
           required: true
           schema:
-            $ref: "#/definitions/relationship"
+            $ref: "#/patchDefinitions/sriov-vf"
     delete:
       tags:
         - Network
-      summary: delete an existing relationship
-      description: delete an existing relationship
-      operationId: deleteNetworkMulticastConfigurationsMulticastConfigurationRelationshipListRelationship
+      summary: delete an existing sriov-vf
+      description: delete an existing sriov-vf
+      operationId: deleteNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfsSriovVf
       consumes:
         - application/json
         - application/xml
@@ -21836,18 +28308,41 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: multicast-configuration-id
+        - name: equipment-name
           in: path
-          description: Unique id of multicast configuration.
           required: true
           type: string
-  /network/multicast-configurations/multicast-configuration/{multicast-configuration-id}:
+          example: __EQUIPMENT-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: pci-id
+          in: path
+          description: PCI ID used to identify the sriov-vf
+          required: true
+          type: string
+          example: __PCI-ID__
+        - name: resource-version
+          in: query
+          description: resource-version for concurrency
+          required: true
+          type: string
+  /network/vpls-pes/vpls-pe/{equipment-name}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/sriov-vfs:
     get:
       tags:
         - Network
-      summary: returns multicast-configuration
-      description: returns multicast-configuration
-      operationId: getNetworkMulticastConfigurationsMulticastConfiguration
+      summary: returns sriov-vfs
+      description: returns sriov-vfs
+      operationId: getNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfs
       produces:
         - application/json
         - application/xml
@@ -21855,21 +28350,63 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/multicast-configuration"
+              $ref: "#/getDefinitions/sriov-vfs"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: multicast-configuration-id
+        - name: equipment-name
           in: path
-          description: Unique id of multicast configuration.
           required: true
           type: string
+          example: __EQUIPMENT-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: prov-status
+          in: query
+          description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems.
+          required: false
+          type: string
+        - name: interface-id
+          in: query
+          description: ID of interface
+          required: false
+          type: string
+        - name: interface-role
+          in: query
+          description: Role assigned to this Interface, should use values as defined in ECOMP Yang models.
+          required: false
+          type: string
+        - name: interface-id
+          in: query
+          description: ID of interface
+          required: false
+          type: string
+        - name: macaddr
+          in: query
+          description: MAC address for the interface
+          required: false
+          type: string
+        - name: network-name
+          in: query
+          description: Name of the network
+          required: false
+          type: string
+  /network/vpls-pes/vpls-pe/{equipment-name}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/relationship-list/relationship:
     put:
       tags:
         - Network
-      summary: create or update an existing multicast-configuration
-      description: create or update an existing multicast-configuration
-      operationId: createOrUpdateNetworkMulticastConfigurationsMulticastConfiguration
+      summary: see node definition for valid relationships
+      operationId: createOrUpdateNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -21880,23 +28417,35 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: multicast-configuration-id
+        - name: equipment-name
           in: path
-          description: Unique id of multicast configuration.
           required: true
           type: string
+          example: __EQUIPMENT-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
         - name: body
           in: body
-          description: multicast-configuration object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterface.json)
           required: true
           schema:
-            $ref: "#/definitions/multicast-configuration"
+            $ref: "#/definitions/relationship"
     delete:
       tags:
         - Network
-      summary: delete an existing multicast-configuration
-      description: delete an existing multicast-configuration
-      operationId: deleteNetworkMulticastConfigurationsMulticastConfiguration
+      summary: delete an existing relationship
+      description: delete an existing relationship
+      operationId: deleteNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -21907,39 +28456,29 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: multicast-configuration-id
+        - name: equipment-name
           in: path
-          description: Unique id of multicast configuration.
           required: true
           type: string
-        - name: resource-version
-          in: query
-          description: resource-version for concurrency
+          example: __EQUIPMENT-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
           required: true
           type: string
-  /network/multicast-configurations:
-    get:
-      tags:
-        - Network
-      summary: returns multicast-configurations
-      description: returns multicast-configurations
-      operationId: getNetworkMulticastConfigurations
-      produces:
-        - application/json
-        - application/xml
-      responses:
-        "200":
-          description: successful operation
-          schema:
-              $ref: "#/definitions/multicast-configurations"
-        "default":
-          description: Response codes found in [response codes](https://wiki.onap.org/).
-  /network/vces/vce/{vnf-id}/port-groups/port-group/{interface-id}/cvlan-tags/cvlan-tag-entry/{cvlan-tag}/relationship-list/relationship:
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+  /network/vpls-pes/vpls-pe/{equipment-name}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}/relationship-list/relationship:
     put:
       tags:
         - Network
       summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkVcesVcePortGroupsPortGroupCvlanTagsCvlanTagEntryRelationshipListRelationship
+      operationId: createOrUpdateNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressListRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -21950,25 +28489,32 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id
+        - name: equipment-name
           in: path
-          description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: interface-id
+          example: __EQUIPMENT-NAME__
+        - name: interface-name
           in: path
-          description: Unique ID of the interface
+          description: Name that identifies the link aggregate interface
           required: true
           type: string
-        - name: cvlan-tag
+          example: __INTERFACE-NAME__
+        - name: interface-name
           in: path
-          description: See mis-na-virtualization-platform.yang
+          description: Name given to the interface
           required: true
-          type: integer
-          format: int64
+          type: string
+          example: __INTERFACE-NAME__
+        - name: l3-interface-ipv4-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -21977,7 +28523,7 @@ paths:
         - Network
       summary: delete an existing relationship
       description: delete an existing relationship
-      operationId: deleteNetworkVcesVcePortGroupsPortGroupCvlanTagsCvlanTagEntryRelationshipListRelationship
+      operationId: deleteNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressListRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -21988,29 +28534,36 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id
+        - name: equipment-name
           in: path
-          description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: interface-id
+          example: __EQUIPMENT-NAME__
+        - name: interface-name
           in: path
-          description: Unique ID of the interface
+          description: Name that identifies the link aggregate interface
           required: true
           type: string
-        - name: cvlan-tag
+          example: __INTERFACE-NAME__
+        - name: interface-name
           in: path
-          description: See mis-na-virtualization-platform.yang
+          description: Name given to the interface
           required: true
-          type: integer
-          format: int64
-  /network/vces/vce/{vnf-id}/port-groups/port-group/{interface-id}/cvlan-tags/cvlan-tag-entry/{cvlan-tag}:
+          type: string
+          example: __INTERFACE-NAME__
+        - name: l3-interface-ipv4-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
+  /network/vpls-pes/vpls-pe/{equipment-name}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}:
     get:
       tags:
         - Network
-      summary: returns cvlan-tag-entry
-      description: returns cvlan-tag-entry
-      operationId: getNetworkVcesVcePortGroupsPortGroupCvlanTagsCvlanTagEntry
+      summary: returns l3-interface-ipv4-address-list
+      description: returns l3-interface-ipv4-address-list
+      operationId: getNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList
       produces:
         - application/json
         - application/xml
@@ -22018,87 +28571,88 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/cvlan-tag-entry"
+              $ref: "#/getDefinitions/l3-interface-ipv4-address-list"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id
+        - name: equipment-name
           in: path
-          description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: interface-id
+          example: __EQUIPMENT-NAME__
+        - name: interface-name
           in: path
-          description: Unique ID of the interface
+          description: Name that identifies the link aggregate interface
           required: true
           type: string
-        - name: cvlan-tag
+          example: __INTERFACE-NAME__
+        - name: interface-name
           in: path
-          description: See mis-na-virtualization-platform.yang
+          description: Name given to the interface
           required: true
-          type: integer
-          format: int64
-        - name: vnf-name
-          in: query
-          description: Name of VNF.
-          required: false
           type: string
-        - name: vnf-name2
-          in: query
-          description: Alternate name of VNF.
-          required: false
+          example: __INTERFACE-NAME__
+        - name: l3-interface-ipv4-address
+          in: path
+          description: IP address
+          required: true
           type: string
-        - name: vnf-type
+          example: __L3-INTERFACE-IPV4-ADDRESS__
+        - name: prov-status
           in: query
-          description: String capturing type of vnf, that was intended to identify the ASDC resource.  This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures.
+          description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems.
           required: false
           type: string
-        - name: service-id
+        - name: interface-id
           in: query
-          description: Unique identifier of service, does not strictly map to ASDC services, SOON TO BE DEPRECATED.
+          description: ID of interface
           required: false
           type: string
-        - name: regional-resource-zone
+        - name: interface-role
           in: query
-          description: Regional way of organizing pservers, source of truth should define values
+          description: Role assigned to this Interface, should use values as defined in ECOMP Yang models.
           required: false
           type: string
-        - name: prov-status
+        - name: interface-id
           in: query
-          description: Trigger for operational monitoring of this resource by Service Assurance systems.
+          description: ID of interface
           required: false
           type: string
-        - name: heat-stack-id
+        - name: macaddr
           in: query
-          description: Heat stack id corresponding to this instance, managed by MSO
+          description: MAC address for the interface
           required: false
           type: string
-        - name: vpe-id
+        - name: network-name
           in: query
-          description: Unique ID of VPE connected to this VCE.
+          description: Name of the network
           required: false
           type: string
-        - name: port-group-id
+        - name: vlan-id-inner
           in: query
-          description: Unique ID for port group in vmware
+          description: Inner VLAN tag
           required: false
-          type: string
-        - name: switch-name
+          type: integer
+          format: int64
+        - name: neutron-network-id
           in: query
-          description: DVS or standard switch name (should be non-null for port groups associated with DVS)
+          description: Neutron network id of the interface that address belongs to
           required: false
           type: string
-        - name: heat-stack-id
+        - name: neutron-subnet-id
           in: query
-          description: Heat stack id corresponding to this instance, managed by MSO
+          description: Neutron id of subnet that address belongs to
           required: false
           type: string
     put:
       tags:
         - Network
-      summary: create or update an existing cvlan-tag-entry
-      description: create or update an existing cvlan-tag-entry
-      operationId: createOrUpdateNetworkVcesVcePortGroupsPortGroupCvlanTagsCvlanTagEntry
+      summary: create or update an existing l3-interface-ipv4-address-list
+      description: |
+        Create or update an existing l3-interface-ipv4-address-list.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList
       consumes:
         - application/json
         - application/xml
@@ -22109,34 +28663,52 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id
+        - name: equipment-name
           in: path
-          description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: interface-id
+          example: __EQUIPMENT-NAME__
+        - name: interface-name
           in: path
-          description: Unique ID of the interface
+          description: Name that identifies the link aggregate interface
           required: true
           type: string
-        - name: cvlan-tag
+          example: __INTERFACE-NAME__
+        - name: interface-name
           in: path
-          description: See mis-na-virtualization-platform.yang
+          description: Name given to the interface
           required: true
-          type: integer
-          format: int64
+          type: string
+          example: __INTERFACE-NAME__
+        - name: l3-interface-ipv4-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
         - name: body
           in: body
-          description: cvlan-tag-entry object that needs to be created or updated
+          description: l3-interface-ipv4-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList.json)
           required: true
           schema:
-            $ref: "#/definitions/cvlan-tag-entry"
-    delete:
+            $ref: "#/definitions/l3-interface-ipv4-address-list"
+    patch:
       tags:
         - Network
-      summary: delete an existing cvlan-tag-entry
-      description: delete an existing cvlan-tag-entry
-      operationId: deleteNetworkVcesVcePortGroupsPortGroupCvlanTagsCvlanTagEntry
+      summary: update an existing l3-interface-ipv4-address-list
+      description: |
+        Update an existing l3-interface-ipv4-address-list
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList
       consumes:
         - application/json
         - application/xml
@@ -22147,116 +28719,85 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id
+        - name: equipment-name
           in: path
-          description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: interface-id
+          example: __EQUIPMENT-NAME__
+        - name: interface-name
           in: path
-          description: Unique ID of the interface
+          description: Name that identifies the link aggregate interface
           required: true
           type: string
-        - name: cvlan-tag
+          example: __INTERFACE-NAME__
+        - name: interface-name
           in: path
-          description: See mis-na-virtualization-platform.yang
+          description: Name given to the interface
           required: true
-          type: integer
-          format: int64
-        - name: resource-version
-          in: query
-          description: resource-version for concurrency
+          type: string
+          example: __INTERFACE-NAME__
+        - name: l3-interface-ipv4-address
+          in: path
+          description: IP address
           required: true
           type: string
-  /network/vces/vce/{vnf-id}/port-groups/port-group/{interface-id}/cvlan-tags:
-    get:
+          example: __L3-INTERFACE-IPV4-ADDRESS__
+        - name: body
+          in: body
+          description: l3-interface-ipv4-address-list object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/l3-interface-ipv4-address-list"
+    delete:
       tags:
         - Network
-      summary: returns cvlan-tags
-      description: returns cvlan-tags
-      operationId: getNetworkVcesVcePortGroupsPortGroupCvlanTags
+      summary: delete an existing l3-interface-ipv4-address-list
+      description: delete an existing l3-interface-ipv4-address-list
+      operationId: deleteNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList
+      consumes:
+        - application/json
+        - application/xml
       produces:
         - application/json
         - application/xml
       responses:
-        "200":
-          description: successful operation
-          schema:
-              $ref: "#/definitions/cvlan-tags"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id
+        - name: equipment-name
           in: path
-          description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: interface-id
+          example: __EQUIPMENT-NAME__
+        - name: interface-name
           in: path
-          description: Unique ID of the interface
+          description: Name that identifies the link aggregate interface
           required: true
           type: string
-        - name: vnf-name
-          in: query
-          description: Name of VNF.
-          required: false
-          type: string
-        - name: vnf-name2
-          in: query
-          description: Alternate name of VNF.
-          required: false
-          type: string
-        - name: vnf-type
-          in: query
-          description: String capturing type of vnf, that was intended to identify the ASDC resource.  This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures.
-          required: false
-          type: string
-        - name: service-id
-          in: query
-          description: Unique identifier of service, does not strictly map to ASDC services, SOON TO BE DEPRECATED.
-          required: false
-          type: string
-        - name: regional-resource-zone
-          in: query
-          description: Regional way of organizing pservers, source of truth should define values
-          required: false
-          type: string
-        - name: prov-status
-          in: query
-          description: Trigger for operational monitoring of this resource by Service Assurance systems.
-          required: false
-          type: string
-        - name: heat-stack-id
-          in: query
-          description: Heat stack id corresponding to this instance, managed by MSO
-          required: false
-          type: string
-        - name: vpe-id
-          in: query
-          description: Unique ID of VPE connected to this VCE.
-          required: false
-          type: string
-        - name: port-group-id
-          in: query
-          description: Unique ID for port group in vmware
-          required: false
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
           type: string
-        - name: switch-name
-          in: query
-          description: DVS or standard switch name (should be non-null for port groups associated with DVS)
-          required: false
+          example: __INTERFACE-NAME__
+        - name: l3-interface-ipv4-address
+          in: path
+          description: IP address
+          required: true
           type: string
-        - name: heat-stack-id
+          example: __L3-INTERFACE-IPV4-ADDRESS__
+        - name: resource-version
           in: query
-          description: Heat stack id corresponding to this instance, managed by MSO
-          required: false
+          description: resource-version for concurrency
+          required: true
           type: string
-  /network/vces/vce/{vnf-id}/port-groups/port-group/{interface-id}/relationship-list/relationship:
+  /network/vpls-pes/vpls-pe/{equipment-name}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}/relationship-list/relationship:
     put:
       tags:
         - Network
       summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkVcesVcePortGroupsPortGroupRelationshipListRelationship
+      operationId: createOrUpdateNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressListRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -22267,19 +28808,32 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id
+        - name: equipment-name
           in: path
-          description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: interface-id
+          example: __EQUIPMENT-NAME__
+        - name: interface-name
           in: path
-          description: Unique ID of the interface
+          description: Name that identifies the link aggregate interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: l3-interface-ipv6-address
+          in: path
+          description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -22288,7 +28842,7 @@ paths:
         - Network
       summary: delete an existing relationship
       description: delete an existing relationship
-      operationId: deleteNetworkVcesVcePortGroupsPortGroupRelationshipListRelationship
+      operationId: deleteNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressListRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -22299,23 +28853,36 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id
+        - name: equipment-name
           in: path
-          description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: interface-id
+          example: __EQUIPMENT-NAME__
+        - name: interface-name
           in: path
-          description: Unique ID of the interface
+          description: Name that identifies the link aggregate interface
           required: true
           type: string
-  /network/vces/vce/{vnf-id}/port-groups/port-group/{interface-id}:
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: l3-interface-ipv6-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
+  /network/vpls-pes/vpls-pe/{equipment-name}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}:
     get:
       tags:
         - Network
-      summary: returns port-group
-      description: returns port-group
-      operationId: getNetworkVcesVcePortGroupsPortGroup
+      summary: returns l3-interface-ipv6-address-list
+      description: returns l3-interface-ipv6-address-list
+      operationId: getNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList
       produces:
         - application/json
         - application/xml
@@ -22323,81 +28890,144 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/port-group"
+              $ref: "#/getDefinitions/l3-interface-ipv6-address-list"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id
+        - name: equipment-name
           in: path
-          description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: interface-id
+          example: __EQUIPMENT-NAME__
+        - name: interface-name
           in: path
-          description: Unique ID of the interface
+          description: Name that identifies the link aggregate interface
           required: true
           type: string
-        - name: vnf-name
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: l3-interface-ipv6-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
+        - name: prov-status
           in: query
-          description: Name of VNF.
+          description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems.
           required: false
           type: string
-        - name: vnf-name2
+        - name: interface-id
           in: query
-          description: Alternate name of VNF.
+          description: ID of interface
           required: false
           type: string
-        - name: vnf-type
+        - name: interface-role
           in: query
-          description: String capturing type of vnf, that was intended to identify the ASDC resource.  This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures.
+          description: Role assigned to this Interface, should use values as defined in ECOMP Yang models.
           required: false
           type: string
-        - name: service-id
+        - name: interface-id
           in: query
-          description: Unique identifier of service, does not strictly map to ASDC services, SOON TO BE DEPRECATED.
+          description: ID of interface
           required: false
           type: string
-        - name: regional-resource-zone
+        - name: macaddr
           in: query
-          description: Regional way of organizing pservers, source of truth should define values
+          description: MAC address for the interface
           required: false
           type: string
-        - name: prov-status
+        - name: network-name
           in: query
-          description: Trigger for operational monitoring of this resource by Service Assurance systems.
+          description: Name of the network
           required: false
           type: string
-        - name: heat-stack-id
+        - name: vlan-id-inner
           in: query
-          description: Heat stack id corresponding to this instance, managed by MSO
+          description: Inner VLAN tag
           required: false
-          type: string
-        - name: vpe-id
+          type: integer
+          format: int64
+        - name: neutron-network-id
           in: query
-          description: Unique ID of VPE connected to this VCE.
+          description: Neutron network id of the interface that address belongs to
           required: false
           type: string
-        - name: port-group-id
+        - name: neutron-subnet-id
           in: query
-          description: Unique ID for port group in vmware
+          description: Neutron id of subnet that address belongs to
           required: false
           type: string
-        - name: switch-name
-          in: query
-          description: DVS or standard switch name (should be non-null for port groups associated with DVS)
-          required: false
+    put:
+      tags:
+        - Network
+      summary: create or update an existing l3-interface-ipv6-address-list
+      description: |
+        Create or update an existing l3-interface-ipv6-address-list.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: equipment-name
+          in: path
+          required: true
           type: string
-        - name: heat-stack-id
-          in: query
-          description: Heat stack id corresponding to this instance, managed by MSO
-          required: false
+          example: __EQUIPMENT-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
+          required: true
           type: string
-    put:
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: l3-interface-ipv6-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
+        - name: body
+          in: body
+          description: l3-interface-ipv6-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList.json)
+          required: true
+          schema:
+            $ref: "#/definitions/l3-interface-ipv6-address-list"
+    patch:
       tags:
         - Network
-      summary: create or update an existing port-group
-      description: create or update an existing port-group
-      operationId: createOrUpdateNetworkVcesVcePortGroupsPortGroup
+      summary: update an existing l3-interface-ipv6-address-list
+      description: |
+        Update an existing l3-interface-ipv6-address-list
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList
       consumes:
         - application/json
         - application/xml
@@ -22408,28 +29038,41 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id
+        - name: equipment-name
           in: path
-          description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: interface-id
+          example: __EQUIPMENT-NAME__
+        - name: interface-name
           in: path
-          description: Unique ID of the interface
+          description: Name that identifies the link aggregate interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: l3-interface-ipv6-address
+          in: path
+          description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
         - name: body
           in: body
-          description: port-group object that needs to be created or updated
+          description: l3-interface-ipv6-address-list object that needs to be created or updated. 
           required: true
           schema:
-            $ref: "#/definitions/port-group"
+            $ref: "#/patchDefinitions/l3-interface-ipv6-address-list"
     delete:
       tags:
         - Network
-      summary: delete an existing port-group
-      description: delete an existing port-group
-      operationId: deleteNetworkVcesVcePortGroupsPortGroup
+      summary: delete an existing l3-interface-ipv6-address-list
+      description: delete an existing l3-interface-ipv6-address-list
+      operationId: deleteNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList
       consumes:
         - application/json
         - application/xml
@@ -22440,28 +29083,41 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id
+        - name: equipment-name
           in: path
-          description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: interface-id
+          example: __EQUIPMENT-NAME__
+        - name: interface-name
           in: path
-          description: Unique ID of the interface
+          description: Name that identifies the link aggregate interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: l3-interface-ipv6-address
+          in: path
+          description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
         - name: resource-version
           in: query
           description: resource-version for concurrency
           required: true
           type: string
-  /network/vces/vce/{vnf-id}/port-groups:
+  /network/vpls-pes/vpls-pe/{equipment-name}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}:
     get:
       tags:
         - Network
-      summary: returns port-groups
-      description: returns port-groups
-      operationId: getNetworkVcesVcePortGroups
+      summary: returns l-interface
+      description: returns l-interface
+      operationId: getNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterface
       produces:
         - application/json
         - application/xml
@@ -22469,61 +29125,66 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/port-groups"
+              $ref: "#/getDefinitions/l-interface"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id
+        - name: equipment-name
           in: path
-          description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: vnf-name
-          in: query
-          description: Name of VNF.
-          required: false
+          example: __EQUIPMENT-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
+          required: true
           type: string
-        - name: vnf-name2
-          in: query
-          description: Alternate name of VNF.
-          required: false
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
           type: string
-        - name: vnf-type
+          example: __INTERFACE-NAME__
+        - name: prov-status
           in: query
-          description: String capturing type of vnf, that was intended to identify the ASDC resource.  This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures.
+          description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems.
           required: false
           type: string
-        - name: service-id
+        - name: interface-id
           in: query
-          description: Unique identifier of service, does not strictly map to ASDC services, SOON TO BE DEPRECATED.
+          description: ID of interface
           required: false
           type: string
-        - name: regional-resource-zone
+        - name: interface-role
           in: query
-          description: Regional way of organizing pservers, source of truth should define values
+          description: Role assigned to this Interface, should use values as defined in ECOMP Yang models.
           required: false
           type: string
-        - name: prov-status
+        - name: interface-id
           in: query
-          description: Trigger for operational monitoring of this resource by Service Assurance systems.
+          description: ID of interface
           required: false
           type: string
-        - name: heat-stack-id
+        - name: macaddr
           in: query
-          description: Heat stack id corresponding to this instance, managed by MSO
+          description: MAC address for the interface
           required: false
           type: string
-        - name: vpe-id
+        - name: network-name
           in: query
-          description: Unique ID of VPE connected to this VCE.
+          description: Name of the network
           required: false
           type: string
-  /network/vces/vce/{vnf-id}/licenses/license/{group-uuid}/{resource-uuid}/relationship-list/relationship:
     put:
       tags:
         - Network
-      summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkVcesVceLicensesLicenseRelationshipListRelationship
+      summary: create or update an existing l-interface
+      description: |
+        Create or update an existing l-interface.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterface
       consumes:
         - application/json
         - application/xml
@@ -22534,33 +29195,85 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id
+        - name: equipment-name
           in: path
-          description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: group-uuid
+          example: __EQUIPMENT-NAME__
+        - name: interface-name
           in: path
-          description: Unique ID for the license group the resource belongs to, should be uuid.
+          description: Name that identifies the link aggregate interface
           required: true
           type: string
-        - name: resource-uuid
+          example: __INTERFACE-NAME__
+        - name: interface-name
           in: path
-          description: Unique ID of a license resource. 
+          description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: l-interface object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterface.json)
           required: true
           schema:
-            $ref: "#/definitions/relationship"
+            $ref: "#/definitions/l-interface"
+    patch:
+      tags:
+        - Network
+      summary: update an existing l-interface
+      description: |
+        Update an existing l-interface
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterface
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: equipment-name
+          in: path
+          required: true
+          type: string
+          example: __EQUIPMENT-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: body
+          in: body
+          description: l-interface object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/l-interface"
     delete:
       tags:
         - Network
-      summary: delete an existing relationship
-      description: delete an existing relationship
-      operationId: deleteNetworkVcesVceLicensesLicenseRelationshipListRelationship
+      summary: delete an existing l-interface
+      description: delete an existing l-interface
+      operationId: deleteNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterface
       consumes:
         - application/json
         - application/xml
@@ -22571,28 +29284,35 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id
+        - name: equipment-name
           in: path
-          description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: group-uuid
+          example: __EQUIPMENT-NAME__
+        - name: interface-name
           in: path
-          description: Unique ID for the license group the resource belongs to, should be uuid.
+          description: Name that identifies the link aggregate interface
           required: true
           type: string
-        - name: resource-uuid
+          example: __INTERFACE-NAME__
+        - name: interface-name
           in: path
-          description: Unique ID of a license resource. 
+          description: Name given to the interface
           required: true
           type: string
-  /network/vces/vce/{vnf-id}/licenses/license/{group-uuid}/{resource-uuid}:
+          example: __INTERFACE-NAME__
+        - name: resource-version
+          in: query
+          description: resource-version for concurrency
+          required: true
+          type: string
+  /network/vpls-pes/vpls-pe/{equipment-name}/lag-interfaces/lag-interface/{interface-name}/l-interfaces:
     get:
       tags:
         - Network
-      summary: returns license
-      description: returns license
-      operationId: getNetworkVcesVceLicensesLicense
+      summary: returns l-interfaces
+      description: returns l-interfaces
+      operationId: getNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfaces
       produces:
         - application/json
         - application/xml
@@ -22600,71 +29320,89 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/license"
+              $ref: "#/getDefinitions/l-interfaces"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id
-          in: path
-          description: Unique id of VNF.  This is unique across the graph.
-          required: true
-          type: string
-        - name: group-uuid
+        - name: equipment-name
           in: path
-          description: Unique ID for the license group the resource belongs to, should be uuid.
           required: true
           type: string
-        - name: resource-uuid
+          example: __EQUIPMENT-NAME__
+        - name: interface-name
           in: path
-          description: Unique ID of a license resource. 
+          description: Name that identifies the link aggregate interface
           required: true
           type: string
-        - name: vnf-name
+          example: __INTERFACE-NAME__
+        - name: prov-status
           in: query
-          description: Name of VNF.
+          description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems.
           required: false
           type: string
-        - name: vnf-name2
+        - name: interface-id
           in: query
-          description: Alternate name of VNF.
+          description: ID of interface
           required: false
           type: string
-        - name: vnf-type
+        - name: interface-role
           in: query
-          description: String capturing type of vnf, that was intended to identify the ASDC resource.  This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures.
+          description: Role assigned to this Interface, should use values as defined in ECOMP Yang models.
           required: false
           type: string
-        - name: service-id
-          in: query
-          description: Unique identifier of service, does not strictly map to ASDC services, SOON TO BE DEPRECATED.
-          required: false
+  /network/vpls-pes/vpls-pe/{equipment-name}/lag-interfaces/lag-interface/{interface-name}:
+    get:
+      tags:
+        - Network
+      summary: returns lag-interface
+      description: returns lag-interface
+      operationId: getNetworkVplsPesVplsPeLagInterfacesLagInterface
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "200":
+          description: successful operation
+          schema:
+              $ref: "#/getDefinitions/lag-interface"
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: equipment-name
+          in: path
+          required: true
           type: string
-        - name: regional-resource-zone
-          in: query
-          description: Regional way of organizing pservers, source of truth should define values
-          required: false
+          example: __EQUIPMENT-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
+          required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: prov-status
           in: query
-          description: Trigger for operational monitoring of this resource by Service Assurance systems.
+          description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems.
           required: false
           type: string
-        - name: heat-stack-id
+        - name: interface-id
           in: query
-          description: Heat stack id corresponding to this instance, managed by MSO
+          description: ID of interface
           required: false
           type: string
-        - name: vpe-id
+        - name: interface-role
           in: query
-          description: Unique ID of VPE connected to this VCE.
+          description: Role assigned to this Interface, should use values as defined in ECOMP Yang models.
           required: false
           type: string
     put:
       tags:
         - Network
-      summary: create or update an existing license
-      description: create or update an existing license
-      operationId: createOrUpdateNetworkVcesVceLicensesLicense
+      summary: create or update an existing lag-interface
+      description: |
+        Create or update an existing lag-interface.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkVplsPesVplsPeLagInterfacesLagInterface
       consumes:
         - application/json
         - application/xml
@@ -22675,33 +29413,73 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id
+        - name: equipment-name
           in: path
-          description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: group-uuid
+          example: __EQUIPMENT-NAME__
+        - name: interface-name
           in: path
-          description: Unique ID for the license group the resource belongs to, should be uuid.
+          description: Name that identifies the link aggregate interface
           required: true
           type: string
-        - name: resource-uuid
+          example: __INTERFACE-NAME__
+        - name: body
+          in: body
+          description: lag-interface object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVplsPesVplsPeLagInterfacesLagInterface.json)
+          required: true
+          schema:
+            $ref: "#/definitions/lag-interface"
+    patch:
+      tags:
+        - Network
+      summary: update an existing lag-interface
+      description: |
+        Update an existing lag-interface
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkVplsPesVplsPeLagInterfacesLagInterface
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: equipment-name
           in: path
-          description: Unique ID of a license resource. 
           required: true
           type: string
+          example: __EQUIPMENT-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
         - name: body
           in: body
-          description: license object that needs to be created or updated
+          description: lag-interface object that needs to be created or updated. 
           required: true
           schema:
-            $ref: "#/definitions/license"
+            $ref: "#/patchDefinitions/lag-interface"
     delete:
       tags:
         - Network
-      summary: delete an existing license
-      description: delete an existing license
-      operationId: deleteNetworkVcesVceLicensesLicense
+      summary: delete an existing lag-interface
+      description: delete an existing lag-interface
+      operationId: deleteNetworkVplsPesVplsPeLagInterfacesLagInterface
       consumes:
         - application/json
         - application/xml
@@ -22712,33 +29490,29 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id
-          in: path
-          description: Unique id of VNF.  This is unique across the graph.
-          required: true
-          type: string
-        - name: group-uuid
+        - name: equipment-name
           in: path
-          description: Unique ID for the license group the resource belongs to, should be uuid.
           required: true
           type: string
-        - name: resource-uuid
+          example: __EQUIPMENT-NAME__
+        - name: interface-name
           in: path
-          description: Unique ID of a license resource. 
+          description: Name that identifies the link aggregate interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: resource-version
           in: query
           description: resource-version for concurrency
           required: true
           type: string
-  /network/vces/vce/{vnf-id}/licenses:
+  /network/vpls-pes/vpls-pe/{equipment-name}/lag-interfaces:
     get:
       tags:
         - Network
-      summary: returns licenses
-      description: returns licenses
-      operationId: getNetworkVcesVceLicenses
+      summary: returns lag-interfaces
+      description: returns lag-interfaces
+      operationId: getNetworkVplsPesVplsPeLagInterfaces
       produces:
         - application/json
         - application/xml
@@ -22746,61 +29520,57 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/licenses"
+              $ref: "#/getDefinitions/lag-interfaces"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id
+        - name: equipment-name
           in: path
-          description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: vnf-name
-          in: query
-          description: Name of VNF.
-          required: false
-          type: string
-        - name: vnf-name2
-          in: query
-          description: Alternate name of VNF.
-          required: false
-          type: string
-        - name: vnf-type
-          in: query
-          description: String capturing type of vnf, that was intended to identify the ASDC resource.  This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures.
-          required: false
-          type: string
-        - name: service-id
-          in: query
-          description: Unique identifier of service, does not strictly map to ASDC services, SOON TO BE DEPRECATED.
-          required: false
-          type: string
-        - name: regional-resource-zone
-          in: query
-          description: Regional way of organizing pservers, source of truth should define values
-          required: false
-          type: string
+          example: __EQUIPMENT-NAME__
         - name: prov-status
           in: query
-          description: Trigger for operational monitoring of this resource by Service Assurance systems.
+          description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems.
           required: false
           type: string
-        - name: heat-stack-id
-          in: query
-          description: Heat stack id corresponding to this instance, managed by MSO
-          required: false
+  /network/vpls-pes/vpls-pe/{equipment-name}:
+    get:
+      tags:
+        - Network
+      summary: returns vpls-pe
+      description: returns vpls-pe
+      operationId: getNetworkVplsPesVplsPe
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "200":
+          description: successful operation
+          schema:
+              $ref: "#/getDefinitions/vpls-pe"
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: equipment-name
+          in: path
+          required: true
           type: string
-        - name: vpe-id
+          example: __EQUIPMENT-NAME__
+        - name: prov-status
           in: query
-          description: Unique ID of VPE connected to this VCE.
+          description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems.
           required: false
           type: string
-  /network/vces/vce/{vnf-id}/entitlements/entitlement/{group-uuid}/{resource-uuid}/relationship-list/relationship:
     put:
       tags:
         - Network
-      summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkVcesVceEntitlementsEntitlementRelationshipListRelationship
+      summary: create or update an existing vpls-pe
+      description: |
+        Create or update an existing vpls-pe.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkVplsPesVplsPe
       consumes:
         - application/json
         - application/xml
@@ -22811,33 +29581,61 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id
+        - name: equipment-name
           in: path
-          description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: group-uuid
-          in: path
-          description: Unique ID for the entitlement group the resource comes from, should be uuid.
+          example: __EQUIPMENT-NAME__
+        - name: body
+          in: body
+          description: vpls-pe object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVplsPesVplsPe.json)
           required: true
-          type: string
-        - name: resource-uuid
+          schema:
+            $ref: "#/definitions/vpls-pe"
+    patch:
+      tags:
+        - Network
+      summary: update an existing vpls-pe
+      description: |
+        Update an existing vpls-pe
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkVplsPesVplsPe
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: equipment-name
           in: path
-          description: Unique ID of an entitlement resource. 
           required: true
           type: string
+          example: __EQUIPMENT-NAME__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: vpls-pe object that needs to be created or updated. 
           required: true
           schema:
-            $ref: "#/definitions/relationship"
+            $ref: "#/patchDefinitions/vpls-pe"
     delete:
       tags:
         - Network
-      summary: delete an existing relationship
-      description: delete an existing relationship
-      operationId: deleteNetworkVcesVceEntitlementsEntitlementRelationshipListRelationship
+      summary: delete an existing vpls-pe
+      description: delete an existing vpls-pe
+      operationId: deleteNetworkVplsPesVplsPe
       consumes:
         - application/json
         - application/xml
@@ -22848,28 +29646,23 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id
-          in: path
-          description: Unique id of VNF.  This is unique across the graph.
-          required: true
-          type: string
-        - name: group-uuid
+        - name: equipment-name
           in: path
-          description: Unique ID for the entitlement group the resource comes from, should be uuid.
           required: true
           type: string
-        - name: resource-uuid
-          in: path
-          description: Unique ID of an entitlement resource. 
+          example: __EQUIPMENT-NAME__
+        - name: resource-version
+          in: query
+          description: resource-version for concurrency
           required: true
           type: string
-  /network/vces/vce/{vnf-id}/entitlements/entitlement/{group-uuid}/{resource-uuid}:
+  /network/vpls-pes:
     get:
       tags:
         - Network
-      summary: returns entitlement
-      description: returns entitlement
-      operationId: getNetworkVcesVceEntitlementsEntitlement
+      summary: returns vpls-pes
+      description: returns vpls-pes
+      operationId: getNetworkVplsPes
       produces:
         - application/json
         - application/xml
@@ -22877,25 +29670,310 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/entitlement"
+              $ref: "#/getDefinitions/vpls-pes"
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+  /network/multicast-configurations/multicast-configuration/{multicast-configuration-id}/relationship-list/relationship:
+    put:
+      tags:
+        - Network
+      summary: see node definition for valid relationships
+      operationId: createOrUpdateNetworkMulticastConfigurationsMulticastConfigurationRelationshipListRelationship
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id
+        - name: multicast-configuration-id
           in: path
-          description: Unique id of VNF.  This is unique across the graph.
+          description: Unique id of multicast configuration.
           required: true
           type: string
-        - name: group-uuid
-          in: path
-          description: Unique ID for the entitlement group the resource comes from, should be uuid.
+          example: __MULTICAST-CONFIGURATION-ID__
+        - name: body
+          in: body
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkMulticastConfigurationsMulticastConfiguration.json)
           required: true
-          type: string
-        - name: resource-uuid
-          in: path
-          description: Unique ID of an entitlement resource. 
+          schema:
+            $ref: "#/definitions/relationship"
+    delete:
+      tags:
+        - Network
+      summary: delete an existing relationship
+      description: delete an existing relationship
+      operationId: deleteNetworkMulticastConfigurationsMulticastConfigurationRelationshipListRelationship
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: multicast-configuration-id
+          in: path
+          description: Unique id of multicast configuration.
+          required: true
+          type: string
+          example: __MULTICAST-CONFIGURATION-ID__
+  /network/multicast-configurations/multicast-configuration/{multicast-configuration-id}:
+    get:
+      tags:
+        - Network
+      summary: returns multicast-configuration
+      description: returns multicast-configuration
+      operationId: getNetworkMulticastConfigurationsMulticastConfiguration
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "200":
+          description: successful operation
+          schema:
+              $ref: "#/getDefinitions/multicast-configuration"
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: multicast-configuration-id
+          in: path
+          description: Unique id of multicast configuration.
+          required: true
+          type: string
+          example: __MULTICAST-CONFIGURATION-ID__
+    put:
+      tags:
+        - Network
+      summary: create or update an existing multicast-configuration
+      description: |
+        Create or update an existing multicast-configuration.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkMulticastConfigurationsMulticastConfiguration
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: multicast-configuration-id
+          in: path
+          description: Unique id of multicast configuration.
+          required: true
+          type: string
+          example: __MULTICAST-CONFIGURATION-ID__
+        - name: body
+          in: body
+          description: multicast-configuration object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkMulticastConfigurationsMulticastConfiguration.json)
+          required: true
+          schema:
+            $ref: "#/definitions/multicast-configuration"
+    patch:
+      tags:
+        - Network
+      summary: update an existing multicast-configuration
+      description: |
+        Update an existing multicast-configuration
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkMulticastConfigurationsMulticastConfiguration
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: multicast-configuration-id
+          in: path
+          description: Unique id of multicast configuration.
+          required: true
+          type: string
+          example: __MULTICAST-CONFIGURATION-ID__
+        - name: body
+          in: body
+          description: multicast-configuration object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/multicast-configuration"
+    delete:
+      tags:
+        - Network
+      summary: delete an existing multicast-configuration
+      description: delete an existing multicast-configuration
+      operationId: deleteNetworkMulticastConfigurationsMulticastConfiguration
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: multicast-configuration-id
+          in: path
+          description: Unique id of multicast configuration.
+          required: true
+          type: string
+          example: __MULTICAST-CONFIGURATION-ID__
+        - name: resource-version
+          in: query
+          description: resource-version for concurrency
+          required: true
+          type: string
+  /network/multicast-configurations:
+    get:
+      tags:
+        - Network
+      summary: returns multicast-configurations
+      description: returns multicast-configurations
+      operationId: getNetworkMulticastConfigurations
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "200":
+          description: successful operation
+          schema:
+              $ref: "#/getDefinitions/multicast-configurations"
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+  /network/vces/vce/{vnf-id}/port-groups/port-group/{interface-id}/cvlan-tags/cvlan-tag-entry/{cvlan-tag}/relationship-list/relationship:
+    put:
+      tags:
+        - Network
+      summary: see node definition for valid relationships
+      operationId: createOrUpdateNetworkVcesVcePortGroupsPortGroupCvlanTagsCvlanTagEntryRelationshipListRelationship
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: vnf-id
+          in: path
+          description: Unique id of VNF.  This is unique across the graph.
+          required: true
+          type: string
+          example: __VNF-ID__
+        - name: interface-id
+          in: path
+          description: Unique ID of the interface
+          required: true
+          type: string
+          example: __INTERFACE-ID__
+        - name: cvlan-tag
+          in: path
+          description: See mis-na-virtualization-platform.yang
+          required: true
+          type: integer
+          format: int64
+          example: __CVLAN-TAG__
+        - name: body
+          in: body
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVcesVcePortGroupsPortGroupCvlanTagsCvlanTagEntry.json)
+          required: true
+          schema:
+            $ref: "#/definitions/relationship"
+    delete:
+      tags:
+        - Network
+      summary: delete an existing relationship
+      description: delete an existing relationship
+      operationId: deleteNetworkVcesVcePortGroupsPortGroupCvlanTagsCvlanTagEntryRelationshipListRelationship
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: vnf-id
+          in: path
+          description: Unique id of VNF.  This is unique across the graph.
+          required: true
+          type: string
+          example: __VNF-ID__
+        - name: interface-id
+          in: path
+          description: Unique ID of the interface
+          required: true
+          type: string
+          example: __INTERFACE-ID__
+        - name: cvlan-tag
+          in: path
+          description: See mis-na-virtualization-platform.yang
+          required: true
+          type: integer
+          format: int64
+          example: __CVLAN-TAG__
+  /network/vces/vce/{vnf-id}/port-groups/port-group/{interface-id}/cvlan-tags/cvlan-tag-entry/{cvlan-tag}:
+    get:
+      tags:
+        - Network
+      summary: returns cvlan-tag-entry
+      description: returns cvlan-tag-entry
+      operationId: getNetworkVcesVcePortGroupsPortGroupCvlanTagsCvlanTagEntry
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "200":
+          description: successful operation
+          schema:
+              $ref: "#/getDefinitions/cvlan-tag-entry"
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: vnf-id
+          in: path
+          description: Unique id of VNF.  This is unique across the graph.
+          required: true
+          type: string
+          example: __VNF-ID__
+        - name: interface-id
+          in: path
+          description: Unique ID of the interface
           required: true
           type: string
+          example: __INTERFACE-ID__
+        - name: cvlan-tag
+          in: path
+          description: See mis-na-virtualization-platform.yang
+          required: true
+          type: integer
+          format: int64
+          example: __CVLAN-TAG__
         - name: vnf-name
           in: query
           description: Name of VNF.
@@ -22936,12 +30014,30 @@ paths:
           description: Unique ID of VPE connected to this VCE.
           required: false
           type: string
+        - name: port-group-id
+          in: query
+          description: Unique ID for port group in vmware
+          required: false
+          type: string
+        - name: switch-name
+          in: query
+          description: DVS or standard switch name (should be non-null for port groups associated with DVS)
+          required: false
+          type: string
+        - name: heat-stack-id
+          in: query
+          description: Heat stack id corresponding to this instance, managed by MSO
+          required: false
+          type: string
     put:
       tags:
         - Network
-      summary: create or update an existing entitlement
-      description: create or update an existing entitlement
-      operationId: createOrUpdateNetworkVcesVceEntitlementsEntitlement
+      summary: create or update an existing cvlan-tag-entry
+      description: |
+        Create or update an existing cvlan-tag-entry.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkVcesVcePortGroupsPortGroupCvlanTagsCvlanTagEntry
       consumes:
         - application/json
         - application/xml
@@ -22957,28 +30053,84 @@ paths:
           description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: group-uuid
+          example: __VNF-ID__
+        - name: interface-id
           in: path
-          description: Unique ID for the entitlement group the resource comes from, should be uuid.
+          description: Unique ID of the interface
           required: true
           type: string
-        - name: resource-uuid
+          example: __INTERFACE-ID__
+        - name: cvlan-tag
           in: path
-          description: Unique ID of an entitlement resource. 
+          description: See mis-na-virtualization-platform.yang
+          required: true
+          type: integer
+          format: int64
+          example: __CVLAN-TAG__
+        - name: body
+          in: body
+          description: cvlan-tag-entry object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVcesVcePortGroupsPortGroupCvlanTagsCvlanTagEntry.json)
+          required: true
+          schema:
+            $ref: "#/definitions/cvlan-tag-entry"
+    patch:
+      tags:
+        - Network
+      summary: update an existing cvlan-tag-entry
+      description: |
+        Update an existing cvlan-tag-entry
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkVcesVcePortGroupsPortGroupCvlanTagsCvlanTagEntry
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: vnf-id
+          in: path
+          description: Unique id of VNF.  This is unique across the graph.
+          required: true
+          type: string
+          example: __VNF-ID__
+        - name: interface-id
+          in: path
+          description: Unique ID of the interface
           required: true
           type: string
+          example: __INTERFACE-ID__
+        - name: cvlan-tag
+          in: path
+          description: See mis-na-virtualization-platform.yang
+          required: true
+          type: integer
+          format: int64
+          example: __CVLAN-TAG__
         - name: body
           in: body
-          description: entitlement object that needs to be created or updated
+          description: cvlan-tag-entry object that needs to be created or updated. 
           required: true
           schema:
-            $ref: "#/definitions/entitlement"
+            $ref: "#/patchDefinitions/cvlan-tag-entry"
     delete:
       tags:
         - Network
-      summary: delete an existing entitlement
-      description: delete an existing entitlement
-      operationId: deleteNetworkVcesVceEntitlementsEntitlement
+      summary: delete an existing cvlan-tag-entry
+      description: delete an existing cvlan-tag-entry
+      operationId: deleteNetworkVcesVcePortGroupsPortGroupCvlanTagsCvlanTagEntry
       consumes:
         - application/json
         - application/xml
@@ -22994,28 +30146,32 @@ paths:
           description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: group-uuid
+          example: __VNF-ID__
+        - name: interface-id
           in: path
-          description: Unique ID for the entitlement group the resource comes from, should be uuid.
+          description: Unique ID of the interface
           required: true
           type: string
-        - name: resource-uuid
+          example: __INTERFACE-ID__
+        - name: cvlan-tag
           in: path
-          description: Unique ID of an entitlement resource. 
+          description: See mis-na-virtualization-platform.yang
           required: true
-          type: string
+          type: integer
+          format: int64
+          example: __CVLAN-TAG__
         - name: resource-version
           in: query
           description: resource-version for concurrency
           required: true
           type: string
-  /network/vces/vce/{vnf-id}/entitlements:
+  /network/vces/vce/{vnf-id}/port-groups/port-group/{interface-id}/cvlan-tags:
     get:
       tags:
         - Network
-      summary: returns entitlements
-      description: returns entitlements
-      operationId: getNetworkVcesVceEntitlements
+      summary: returns cvlan-tags
+      description: returns cvlan-tags
+      operationId: getNetworkVcesVcePortGroupsPortGroupCvlanTags
       produces:
         - application/json
         - application/xml
@@ -23023,7 +30179,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/entitlements"
+              $ref: "#/getDefinitions/cvlan-tags"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -23032,6 +30188,13 @@ paths:
           description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
+          example: __VNF-ID__
+        - name: interface-id
+          in: path
+          description: Unique ID of the interface
+          required: true
+          type: string
+          example: __INTERFACE-ID__
         - name: vnf-name
           in: query
           description: Name of VNF.
@@ -23072,12 +30235,27 @@ paths:
           description: Unique ID of VPE connected to this VCE.
           required: false
           type: string
-  /network/vces/vce/{vnf-id}/relationship-list/relationship:
+        - name: port-group-id
+          in: query
+          description: Unique ID for port group in vmware
+          required: false
+          type: string
+        - name: switch-name
+          in: query
+          description: DVS or standard switch name (should be non-null for port groups associated with DVS)
+          required: false
+          type: string
+        - name: heat-stack-id
+          in: query
+          description: Heat stack id corresponding to this instance, managed by MSO
+          required: false
+          type: string
+  /network/vces/vce/{vnf-id}/port-groups/port-group/{interface-id}/relationship-list/relationship:
     put:
       tags:
         - Network
       summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkVcesVceRelationshipListRelationship
+      operationId: createOrUpdateNetworkVcesVcePortGroupsPortGroupRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -23093,9 +30271,16 @@ paths:
           description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
+          example: __VNF-ID__
+        - name: interface-id
+          in: path
+          description: Unique ID of the interface
+          required: true
+          type: string
+          example: __INTERFACE-ID__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVcesVcePortGroupsPortGroup.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -23104,7 +30289,7 @@ paths:
         - Network
       summary: delete an existing relationship
       description: delete an existing relationship
-      operationId: deleteNetworkVcesVceRelationshipListRelationship
+      operationId: deleteNetworkVcesVcePortGroupsPortGroupRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -23120,13 +30305,20 @@ paths:
           description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-  /network/vces/vce/{vnf-id}:
+          example: __VNF-ID__
+        - name: interface-id
+          in: path
+          description: Unique ID of the interface
+          required: true
+          type: string
+          example: __INTERFACE-ID__
+  /network/vces/vce/{vnf-id}/port-groups/port-group/{interface-id}:
     get:
       tags:
         - Network
-      summary: returns vce
-      description: returns vce
-      operationId: getNetworkVcesVce
+      summary: returns port-group
+      description: returns port-group
+      operationId: getNetworkVcesVcePortGroupsPortGroup
       produces:
         - application/json
         - application/xml
@@ -23134,7 +30326,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/vce"
+              $ref: "#/getDefinitions/port-group"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -23143,6 +30335,13 @@ paths:
           description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
+          example: __VNF-ID__
+        - name: interface-id
+          in: path
+          description: Unique ID of the interface
+          required: true
+          type: string
+          example: __INTERFACE-ID__
         - name: vnf-name
           in: query
           description: Name of VNF.
@@ -23183,12 +30382,30 @@ paths:
           description: Unique ID of VPE connected to this VCE.
           required: false
           type: string
+        - name: port-group-id
+          in: query
+          description: Unique ID for port group in vmware
+          required: false
+          type: string
+        - name: switch-name
+          in: query
+          description: DVS or standard switch name (should be non-null for port groups associated with DVS)
+          required: false
+          type: string
+        - name: heat-stack-id
+          in: query
+          description: Heat stack id corresponding to this instance, managed by MSO
+          required: false
+          type: string
     put:
       tags:
         - Network
-      summary: create or update an existing vce
-      description: create or update an existing vce
-      operationId: createOrUpdateNetworkVcesVce
+      summary: create or update an existing port-group
+      description: |
+        Create or update an existing port-group.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkVcesVcePortGroupsPortGroup
       consumes:
         - application/json
         - application/xml
@@ -23204,18 +30421,36 @@ paths:
           description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
+          example: __VNF-ID__
+        - name: interface-id
+          in: path
+          description: Unique ID of the interface
+          required: true
+          type: string
+          example: __INTERFACE-ID__
         - name: body
           in: body
-          description: vce object that needs to be created or updated
+          description: port-group object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVcesVcePortGroupsPortGroup.json)
           required: true
           schema:
-            $ref: "#/definitions/vce"
-    delete:
+            $ref: "#/definitions/port-group"
+    patch:
       tags:
         - Network
-      summary: delete an existing vce
-      description: delete an existing vce
-      operationId: deleteNetworkVcesVce
+      summary: update an existing port-group
+      description: |
+        Update an existing port-group
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkVcesVcePortGroupsPortGroup
       consumes:
         - application/json
         - application/xml
@@ -23231,61 +30466,25 @@ paths:
           description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: resource-version
-          in: query
-          description: resource-version for concurrency
-          required: true
-          type: string
-  /network/vces:
-    get:
-      tags:
-        - Network
-      summary: returns vces
-      description: returns vces
-      operationId: getNetworkVces
-      produces:
-        - application/json
-        - application/xml
-      responses:
-        "200":
-          description: successful operation
-          schema:
-              $ref: "#/definitions/vces"
-        "default":
-          description: Response codes found in [response codes](https://wiki.onap.org/).
-  /network/vnfcs/vnfc/{vnfc-name}/relationship-list/relationship:
-    put:
-      tags:
-        - Network
-      summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkVnfcsVnfcRelationshipListRelationship
-      consumes:
-        - application/json
-        - application/xml
-      produces:
-        - application/json
-        - application/xml
-      responses:
-        "default":
-          description: Response codes found in [response codes](https://wiki.onap.org/).
-      parameters:
-        - name: vnfc-name
+          example: __VNF-ID__
+        - name: interface-id
           in: path
-          description: Unique ID of vnfc.
+          description: Unique ID of the interface
           required: true
           type: string
+          example: __INTERFACE-ID__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: port-group object that needs to be created or updated. 
           required: true
           schema:
-            $ref: "#/definitions/relationship"
+            $ref: "#/patchDefinitions/port-group"
     delete:
       tags:
         - Network
-      summary: delete an existing relationship
-      description: delete an existing relationship
-      operationId: deleteNetworkVnfcsVnfcRelationshipListRelationship
+      summary: delete an existing port-group
+      description: delete an existing port-group
+      operationId: deleteNetworkVcesVcePortGroupsPortGroup
       consumes:
         - application/json
         - application/xml
@@ -23296,18 +30495,30 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnfc-name
+        - name: vnf-id
           in: path
-          description: Unique ID of vnfc.
+          description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-  /network/vnfcs/vnfc/{vnfc-name}:
+          example: __VNF-ID__
+        - name: interface-id
+          in: path
+          description: Unique ID of the interface
+          required: true
+          type: string
+          example: __INTERFACE-ID__
+        - name: resource-version
+          in: query
+          description: resource-version for concurrency
+          required: true
+          type: string
+  /network/vces/vce/{vnf-id}/port-groups:
     get:
       tags:
         - Network
-      summary: returns vnfc
-      description: returns vnfc
-      operationId: getNetworkVnfcsVnfc
+      summary: returns port-groups
+      description: returns port-groups
+      operationId: getNetworkVcesVcePortGroups
       produces:
         - application/json
         - application/xml
@@ -23315,91 +30526,62 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/vnfc"
+              $ref: "#/getDefinitions/port-groups"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnfc-name
+        - name: vnf-id
           in: path
-          description: Unique ID of vnfc.
+          description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: nfc-naming-code
+          example: __VNF-ID__
+        - name: vnf-name
           in: query
-          description: Short code that is used in naming instances of the item being modeled
+          description: Name of VNF.
           required: false
           type: string
-        - name: nfc-function
+        - name: vnf-name2
           in: query
-          description: English description of function that the specific resource deployment is providing. Assigned as part of the customization of a resource in a service
+          description: Alternate name of VNF.
           required: false
           type: string
-        - name: prov-status
+        - name: vnf-type
           in: query
-          description: prov status of this vnfc
+          description: String capturing type of vnf, that was intended to identify the ASDC resource.  This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures.
           required: false
           type: string
-        - name: ipaddress-v4-oam-vip
+        - name: service-id
           in: query
-          description: Oam V4 vip address of this vnfc
+          description: Unique identifier of service, does not strictly map to ASDC services, SOON TO BE DEPRECATED.
           required: false
           type: string
-        - name: in-maint
-          in: query
-          required: false
-          type: boolean
-        - name: is-closed-loop-disabled
+        - name: regional-resource-zone
           in: query
+          description: Regional way of organizing pservers, source of truth should define values
           required: false
-          type: boolean
-        - name: group-notation
+          type: string
+        - name: prov-status
           in: query
-          description: Group notation of VNFC
+          description: Trigger for operational monitoring of this resource by Service Assurance systems.
           required: false
           type: string
-        - name: model-invariant-id
+        - name: heat-stack-id
           in: query
-          description: the ASDC model id for this resource or service model.
+          description: Heat stack id corresponding to this instance, managed by MSO
           required: false
           type: string
-        - name: model-version-id
+        - name: vpe-id
           in: query
-          description: the ASDC model version for this resource or service model.
+          description: Unique ID of VPE connected to this VCE.
           required: false
           type: string
+  /network/vces/vce/{vnf-id}/licenses/license/{group-uuid}/{resource-uuid}/relationship-list/relationship:
     put:
       tags:
         - Network
-      summary: create or update an existing vnfc
-      description: create or update an existing vnfc
-      operationId: createOrUpdateNetworkVnfcsVnfc
-      consumes:
-        - application/json
-        - application/xml
-      produces:
-        - application/json
-        - application/xml
-      responses:
-        "default":
-          description: Response codes found in [response codes](https://wiki.onap.org/).
-      parameters:
-        - name: vnfc-name
-          in: path
-          description: Unique ID of vnfc.
-          required: true
-          type: string
-        - name: body
-          in: body
-          description: vnfc object that needs to be created or updated
-          required: true
-          schema:
-            $ref: "#/definitions/vnfc"
-    delete:
-      tags:
-        - Network
-      summary: delete an existing vnfc
-      description: delete an existing vnfc
-      operationId: deleteNetworkVnfcsVnfc
+      summary: see node definition for valid relationships
+      operationId: createOrUpdateNetworkVcesVceLicensesLicenseRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -23410,62 +30592,27 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnfc-name
+        - name: vnf-id
           in: path
-          description: Unique ID of vnfc.
-          required: true
-          type: string
-        - name: resource-version
-          in: query
-          description: resource-version for concurrency
+          description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-  /network/vnfcs:
-    get:
-      tags:
-        - Network
-      summary: returns vnfcs
-      description: returns vnfcs
-      operationId: getNetworkVnfcs
-      produces:
-        - application/json
-        - application/xml
-      responses:
-        "200":
-          description: successful operation
-          schema:
-              $ref: "#/definitions/vnfcs"
-        "default":
-          description: Response codes found in [response codes](https://wiki.onap.org/).
-  /network/l3-networks/l3-network/{network-id}/subnets/subnet/{subnet-id}/relationship-list/relationship:
-    put:
-      tags:
-        - Network
-      summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkL3NetworksL3NetworkSubnetsSubnetRelationshipListRelationship
-      consumes:
-        - application/json
-        - application/xml
-      produces:
-        - application/json
-        - application/xml
-      responses:
-        "default":
-          description: Response codes found in [response codes](https://wiki.onap.org/).
-      parameters:
-        - name: network-id
+          example: __VNF-ID__
+        - name: group-uuid
           in: path
-          description: Network ID, should be uuid. Unique across A&AI.
+          description: Unique ID for the license group the resource belongs to, should be uuid.
           required: true
           type: string
-        - name: subnet-id
+          example: __GROUP-UUID__
+        - name: resource-uuid
           in: path
-          description: Subnet ID, should be UUID.
+          description: Unique ID of a license resource. 
           required: true
           type: string
+          example: __RESOURCE-UUID__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVcesVceLicensesLicense.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -23474,7 +30621,7 @@ paths:
         - Network
       summary: delete an existing relationship
       description: delete an existing relationship
-      operationId: deleteNetworkL3NetworksL3NetworkSubnetsSubnetRelationshipListRelationship
+      operationId: deleteNetworkVcesVceLicensesLicenseRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -23485,23 +30632,31 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: network-id
+        - name: vnf-id
           in: path
-          description: Network ID, should be uuid. Unique across A&AI.
+          description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: subnet-id
+          example: __VNF-ID__
+        - name: group-uuid
           in: path
-          description: Subnet ID, should be UUID.
+          description: Unique ID for the license group the resource belongs to, should be uuid.
           required: true
           type: string
-  /network/l3-networks/l3-network/{network-id}/subnets/subnet/{subnet-id}:
+          example: __GROUP-UUID__
+        - name: resource-uuid
+          in: path
+          description: Unique ID of a license resource. 
+          required: true
+          type: string
+          example: __RESOURCE-UUID__
+  /network/vces/vce/{vnf-id}/licenses/license/{group-uuid}/{resource-uuid}:
     get:
       tags:
         - Network
-      summary: returns subnet
-      description: returns subnet
-      operationId: getNetworkL3NetworksL3NetworkSubnetsSubnet
+      summary: returns license
+      description: returns license
+      operationId: getNetworkVcesVceLicensesLicense
       produces:
         - application/json
         - application/xml
@@ -23509,76 +30664,77 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/subnet"
+              $ref: "#/getDefinitions/license"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: network-id
+        - name: vnf-id
           in: path
-          description: Network ID, should be uuid. Unique across A&AI.
+          description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: subnet-id
+          example: __VNF-ID__
+        - name: group-uuid
           in: path
-          description: Subnet ID, should be UUID.
+          description: Unique ID for the license group the resource belongs to, should be uuid.
           required: true
           type: string
-        - name: network-name
-          in: query
-          description: Name of the network, governed by some naming convention..
-          required: false
-          type: string
-        - name: network-role
-          in: query
-          description: Role the network plans - who defines these values?
-          required: false
+          example: __GROUP-UUID__
+        - name: resource-uuid
+          in: path
+          description: Unique ID of a license resource. 
+          required: true
           type: string
-        - name: service-id
+          example: __RESOURCE-UUID__
+        - name: vnf-name
           in: query
-          description: Unique identifier of service from ASDC.  Does not strictly map to ASDC services.  SOON TO BE DEPRECATED
+          description: Name of VNF.
           required: false
           type: string
-        - name: heat-stack-id
+        - name: vnf-name2
           in: query
-          description: Heat stack id corresponding to this instance, managed by MSO
+          description: Alternate name of VNF.
           required: false
           type: string
-        - name: contrail-network-fqdn
+        - name: vnf-type
           in: query
-          description: Contrail FQDN for the network
+          description: String capturing type of vnf, that was intended to identify the ASDC resource.  This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures.
           required: false
           type: string
-        - name: model-invariant-id
+        - name: service-id
           in: query
-          description: the ASDC model id for this resource or service model.
+          description: Unique identifier of service, does not strictly map to ASDC services, SOON TO BE DEPRECATED.
           required: false
           type: string
-        - name: model-version-id
+        - name: regional-resource-zone
           in: query
-          description: the ASDC model version for this resource or service model.
+          description: Regional way of organizing pservers, source of truth should define values
           required: false
           type: string
-        - name: widget-model-id
+        - name: prov-status
           in: query
-          description: the ASDC data dictionary widget model. This maps directly to the A&AI widget.
+          description: Trigger for operational monitoring of this resource by Service Assurance systems.
           required: false
           type: string
-        - name: widget-model-version
+        - name: heat-stack-id
           in: query
-          description: the ASDC data dictionary version of the widget model.This maps directly to the A&AI version of the widget.
+          description: Heat stack id corresponding to this instance, managed by MSO
           required: false
           type: string
-        - name: subnet-name
+        - name: vpe-id
           in: query
-          description: Name associated with the subnet.
+          description: Unique ID of VPE connected to this VCE.
           required: false
           type: string
     put:
       tags:
         - Network
-      summary: create or update an existing subnet
-      description: create or update an existing subnet
-      operationId: createOrUpdateNetworkL3NetworksL3NetworkSubnetsSubnet
+      summary: create or update an existing license
+      description: |
+        Create or update an existing license.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkVcesVceLicensesLicense
       consumes:
         - application/json
         - application/xml
@@ -23589,28 +30745,87 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: network-id
+        - name: vnf-id
           in: path
-          description: Network ID, should be uuid. Unique across A&AI.
+          description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: subnet-id
+          example: __VNF-ID__
+        - name: group-uuid
           in: path
-          description: Subnet ID, should be UUID.
+          description: Unique ID for the license group the resource belongs to, should be uuid.
+          required: true
+          type: string
+          example: __GROUP-UUID__
+        - name: resource-uuid
+          in: path
+          description: Unique ID of a license resource. 
           required: true
           type: string
+          example: __RESOURCE-UUID__
         - name: body
           in: body
-          description: subnet object that needs to be created or updated
+          description: license object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVcesVceLicensesLicense.json)
           required: true
           schema:
-            $ref: "#/definitions/subnet"
+            $ref: "#/definitions/license"
+    patch:
+      tags:
+        - Network
+      summary: update an existing license
+      description: |
+        Update an existing license
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkVcesVceLicensesLicense
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: vnf-id
+          in: path
+          description: Unique id of VNF.  This is unique across the graph.
+          required: true
+          type: string
+          example: __VNF-ID__
+        - name: group-uuid
+          in: path
+          description: Unique ID for the license group the resource belongs to, should be uuid.
+          required: true
+          type: string
+          example: __GROUP-UUID__
+        - name: resource-uuid
+          in: path
+          description: Unique ID of a license resource. 
+          required: true
+          type: string
+          example: __RESOURCE-UUID__
+        - name: body
+          in: body
+          description: license object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/license"
     delete:
       tags:
         - Network
-      summary: delete an existing subnet
-      description: delete an existing subnet
-      operationId: deleteNetworkL3NetworksL3NetworkSubnetsSubnet
+      summary: delete an existing license
+      description: delete an existing license
+      operationId: deleteNetworkVcesVceLicensesLicense
       consumes:
         - application/json
         - application/xml
@@ -23621,28 +30836,36 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: network-id
+        - name: vnf-id
           in: path
-          description: Network ID, should be uuid. Unique across A&AI.
+          description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: subnet-id
+          example: __VNF-ID__
+        - name: group-uuid
           in: path
-          description: Subnet ID, should be UUID.
+          description: Unique ID for the license group the resource belongs to, should be uuid.
+          required: true
+          type: string
+          example: __GROUP-UUID__
+        - name: resource-uuid
+          in: path
+          description: Unique ID of a license resource. 
           required: true
           type: string
+          example: __RESOURCE-UUID__
         - name: resource-version
           in: query
           description: resource-version for concurrency
           required: true
           type: string
-  /network/l3-networks/l3-network/{network-id}/subnets:
+  /network/vces/vce/{vnf-id}/licenses:
     get:
       tags:
         - Network
-      summary: returns subnets
-      description: returns subnets
-      operationId: getNetworkL3NetworksL3NetworkSubnets
+      summary: returns licenses
+      description: returns licenses
+      operationId: getNetworkVcesVceLicenses
       produces:
         - application/json
         - application/xml
@@ -23650,66 +30873,62 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/subnets"
+              $ref: "#/getDefinitions/licenses"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: network-id
+        - name: vnf-id
           in: path
-          description: Network ID, should be uuid. Unique across A&AI.
+          description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: network-name
-          in: query
-          description: Name of the network, governed by some naming convention..
-          required: false
-          type: string
-        - name: network-role
+          example: __VNF-ID__
+        - name: vnf-name
           in: query
-          description: Role the network plans - who defines these values?
+          description: Name of VNF.
           required: false
           type: string
-        - name: service-id
+        - name: vnf-name2
           in: query
-          description: Unique identifier of service from ASDC.  Does not strictly map to ASDC services.  SOON TO BE DEPRECATED
+          description: Alternate name of VNF.
           required: false
           type: string
-        - name: heat-stack-id
+        - name: vnf-type
           in: query
-          description: Heat stack id corresponding to this instance, managed by MSO
+          description: String capturing type of vnf, that was intended to identify the ASDC resource.  This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures.
           required: false
           type: string
-        - name: contrail-network-fqdn
+        - name: service-id
           in: query
-          description: Contrail FQDN for the network
+          description: Unique identifier of service, does not strictly map to ASDC services, SOON TO BE DEPRECATED.
           required: false
           type: string
-        - name: model-invariant-id
+        - name: regional-resource-zone
           in: query
-          description: the ASDC model id for this resource or service model.
+          description: Regional way of organizing pservers, source of truth should define values
           required: false
           type: string
-        - name: model-version-id
+        - name: prov-status
           in: query
-          description: the ASDC model version for this resource or service model.
+          description: Trigger for operational monitoring of this resource by Service Assurance systems.
           required: false
           type: string
-        - name: widget-model-id
+        - name: heat-stack-id
           in: query
-          description: the ASDC data dictionary widget model. This maps directly to the A&AI widget.
+          description: Heat stack id corresponding to this instance, managed by MSO
           required: false
           type: string
-        - name: widget-model-version
+        - name: vpe-id
           in: query
-          description: the ASDC data dictionary version of the widget model.This maps directly to the A&AI version of the widget.
+          description: Unique ID of VPE connected to this VCE.
           required: false
           type: string
-  /network/l3-networks/l3-network/{network-id}/ctag-assignments/ctag-assignment/{vlan-id-inner}/relationship-list/relationship:
+  /network/vces/vce/{vnf-id}/entitlements/entitlement/{group-uuid}/{resource-uuid}/relationship-list/relationship:
     put:
       tags:
         - Network
       summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkL3NetworksL3NetworkCtagAssignmentsCtagAssignmentRelationshipListRelationship
+      operationId: createOrUpdateNetworkVcesVceEntitlementsEntitlementRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -23720,20 +30939,27 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: network-id
+        - name: vnf-id
           in: path
-          description: Network ID, should be uuid. Unique across A&AI.
+          description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: vlan-id-inner
+          example: __VNF-ID__
+        - name: group-uuid
           in: path
-          description: id.
+          description: Unique ID for the entitlement group the resource comes from, should be uuid.
           required: true
-          type: integer
-          format: int64
+          type: string
+          example: __GROUP-UUID__
+        - name: resource-uuid
+          in: path
+          description: Unique ID of an entitlement resource. 
+          required: true
+          type: string
+          example: __RESOURCE-UUID__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVcesVceEntitlementsEntitlement.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -23742,7 +30968,7 @@ paths:
         - Network
       summary: delete an existing relationship
       description: delete an existing relationship
-      operationId: deleteNetworkL3NetworksL3NetworkCtagAssignmentsCtagAssignmentRelationshipListRelationship
+      operationId: deleteNetworkVcesVceEntitlementsEntitlementRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -23753,24 +30979,31 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: network-id
+        - name: vnf-id
           in: path
-          description: Network ID, should be uuid. Unique across A&AI.
+          description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: vlan-id-inner
+          example: __VNF-ID__
+        - name: group-uuid
           in: path
-          description: id.
+          description: Unique ID for the entitlement group the resource comes from, should be uuid.
           required: true
-          type: integer
-          format: int64
-  /network/l3-networks/l3-network/{network-id}/ctag-assignments/ctag-assignment/{vlan-id-inner}:
+          type: string
+          example: __GROUP-UUID__
+        - name: resource-uuid
+          in: path
+          description: Unique ID of an entitlement resource. 
+          required: true
+          type: string
+          example: __RESOURCE-UUID__
+  /network/vces/vce/{vnf-id}/entitlements/entitlement/{group-uuid}/{resource-uuid}:
     get:
       tags:
         - Network
-      summary: returns ctag-assignment
-      description: returns ctag-assignment
-      operationId: getNetworkL3NetworksL3NetworkCtagAssignmentsCtagAssignment
+      summary: returns entitlement
+      description: returns entitlement
+      operationId: getNetworkVcesVceEntitlementsEntitlement
       produces:
         - application/json
         - application/xml
@@ -23778,72 +31011,77 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/ctag-assignment"
+              $ref: "#/getDefinitions/entitlement"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: network-id
+        - name: vnf-id
           in: path
-          description: Network ID, should be uuid. Unique across A&AI.
+          description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: vlan-id-inner
+          example: __VNF-ID__
+        - name: group-uuid
           in: path
-          description: id.
+          description: Unique ID for the entitlement group the resource comes from, should be uuid.
           required: true
-          type: integer
-          format: int64
-        - name: network-name
-          in: query
-          description: Name of the network, governed by some naming convention..
-          required: false
           type: string
-        - name: network-role
+          example: __GROUP-UUID__
+        - name: resource-uuid
+          in: path
+          description: Unique ID of an entitlement resource. 
+          required: true
+          type: string
+          example: __RESOURCE-UUID__
+        - name: vnf-name
           in: query
-          description: Role the network plans - who defines these values?
+          description: Name of VNF.
           required: false
           type: string
-        - name: service-id
+        - name: vnf-name2
           in: query
-          description: Unique identifier of service from ASDC.  Does not strictly map to ASDC services.  SOON TO BE DEPRECATED
+          description: Alternate name of VNF.
           required: false
           type: string
-        - name: heat-stack-id
+        - name: vnf-type
           in: query
-          description: Heat stack id corresponding to this instance, managed by MSO
+          description: String capturing type of vnf, that was intended to identify the ASDC resource.  This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures.
           required: false
           type: string
-        - name: contrail-network-fqdn
+        - name: service-id
           in: query
-          description: Contrail FQDN for the network
+          description: Unique identifier of service, does not strictly map to ASDC services, SOON TO BE DEPRECATED.
           required: false
           type: string
-        - name: model-invariant-id
+        - name: regional-resource-zone
           in: query
-          description: the ASDC model id for this resource or service model.
+          description: Regional way of organizing pservers, source of truth should define values
           required: false
           type: string
-        - name: model-version-id
+        - name: prov-status
           in: query
-          description: the ASDC model version for this resource or service model.
+          description: Trigger for operational monitoring of this resource by Service Assurance systems.
           required: false
           type: string
-        - name: widget-model-id
+        - name: heat-stack-id
           in: query
-          description: the ASDC data dictionary widget model. This maps directly to the A&AI widget.
+          description: Heat stack id corresponding to this instance, managed by MSO
           required: false
           type: string
-        - name: widget-model-version
+        - name: vpe-id
           in: query
-          description: the ASDC data dictionary version of the widget model.This maps directly to the A&AI version of the widget.
+          description: Unique ID of VPE connected to this VCE.
           required: false
           type: string
     put:
       tags:
         - Network
-      summary: create or update an existing ctag-assignment
-      description: create or update an existing ctag-assignment
-      operationId: createOrUpdateNetworkL3NetworksL3NetworkCtagAssignmentsCtagAssignment
+      summary: create or update an existing entitlement
+      description: |
+        Create or update an existing entitlement.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkVcesVceEntitlementsEntitlement
       consumes:
         - application/json
         - application/xml
@@ -23854,29 +31092,87 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: network-id
+        - name: vnf-id
           in: path
-          description: Network ID, should be uuid. Unique across A&AI.
+          description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: vlan-id-inner
+          example: __VNF-ID__
+        - name: group-uuid
           in: path
-          description: id.
+          description: Unique ID for the entitlement group the resource comes from, should be uuid.
           required: true
-          type: integer
-          format: int64
+          type: string
+          example: __GROUP-UUID__
+        - name: resource-uuid
+          in: path
+          description: Unique ID of an entitlement resource. 
+          required: true
+          type: string
+          example: __RESOURCE-UUID__
         - name: body
           in: body
-          description: ctag-assignment object that needs to be created or updated
+          description: entitlement object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVcesVceEntitlementsEntitlement.json)
           required: true
           schema:
-            $ref: "#/definitions/ctag-assignment"
+            $ref: "#/definitions/entitlement"
+    patch:
+      tags:
+        - Network
+      summary: update an existing entitlement
+      description: |
+        Update an existing entitlement
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkVcesVceEntitlementsEntitlement
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: vnf-id
+          in: path
+          description: Unique id of VNF.  This is unique across the graph.
+          required: true
+          type: string
+          example: __VNF-ID__
+        - name: group-uuid
+          in: path
+          description: Unique ID for the entitlement group the resource comes from, should be uuid.
+          required: true
+          type: string
+          example: __GROUP-UUID__
+        - name: resource-uuid
+          in: path
+          description: Unique ID of an entitlement resource. 
+          required: true
+          type: string
+          example: __RESOURCE-UUID__
+        - name: body
+          in: body
+          description: entitlement object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/entitlement"
     delete:
       tags:
         - Network
-      summary: delete an existing ctag-assignment
-      description: delete an existing ctag-assignment
-      operationId: deleteNetworkL3NetworksL3NetworkCtagAssignmentsCtagAssignment
+      summary: delete an existing entitlement
+      description: delete an existing entitlement
+      operationId: deleteNetworkVcesVceEntitlementsEntitlement
       consumes:
         - application/json
         - application/xml
@@ -23887,29 +31183,36 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: network-id
+        - name: vnf-id
           in: path
-          description: Network ID, should be uuid. Unique across A&AI.
+          description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: vlan-id-inner
+          example: __VNF-ID__
+        - name: group-uuid
           in: path
-          description: id.
+          description: Unique ID for the entitlement group the resource comes from, should be uuid.
           required: true
-          type: integer
-          format: int64
+          type: string
+          example: __GROUP-UUID__
+        - name: resource-uuid
+          in: path
+          description: Unique ID of an entitlement resource. 
+          required: true
+          type: string
+          example: __RESOURCE-UUID__
         - name: resource-version
           in: query
           description: resource-version for concurrency
           required: true
           type: string
-  /network/l3-networks/l3-network/{network-id}/ctag-assignments:
+  /network/vces/vce/{vnf-id}/entitlements:
     get:
       tags:
         - Network
-      summary: returns ctag-assignments
-      description: returns ctag-assignments
-      operationId: getNetworkL3NetworksL3NetworkCtagAssignments
+      summary: returns entitlements
+      description: returns entitlements
+      operationId: getNetworkVcesVceEntitlements
       produces:
         - application/json
         - application/xml
@@ -23917,66 +31220,62 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/ctag-assignments"
+              $ref: "#/getDefinitions/entitlements"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: network-id
+        - name: vnf-id
           in: path
-          description: Network ID, should be uuid. Unique across A&AI.
+          description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: network-name
-          in: query
-          description: Name of the network, governed by some naming convention..
-          required: false
-          type: string
-        - name: network-role
+          example: __VNF-ID__
+        - name: vnf-name
           in: query
-          description: Role the network plans - who defines these values?
+          description: Name of VNF.
           required: false
           type: string
-        - name: service-id
+        - name: vnf-name2
           in: query
-          description: Unique identifier of service from ASDC.  Does not strictly map to ASDC services.  SOON TO BE DEPRECATED
+          description: Alternate name of VNF.
           required: false
           type: string
-        - name: heat-stack-id
+        - name: vnf-type
           in: query
-          description: Heat stack id corresponding to this instance, managed by MSO
+          description: String capturing type of vnf, that was intended to identify the ASDC resource.  This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures.
           required: false
           type: string
-        - name: contrail-network-fqdn
+        - name: service-id
           in: query
-          description: Contrail FQDN for the network
+          description: Unique identifier of service, does not strictly map to ASDC services, SOON TO BE DEPRECATED.
           required: false
           type: string
-        - name: model-invariant-id
+        - name: regional-resource-zone
           in: query
-          description: the ASDC model id for this resource or service model.
+          description: Regional way of organizing pservers, source of truth should define values
           required: false
           type: string
-        - name: model-version-id
+        - name: prov-status
           in: query
-          description: the ASDC model version for this resource or service model.
+          description: Trigger for operational monitoring of this resource by Service Assurance systems.
           required: false
           type: string
-        - name: widget-model-id
+        - name: heat-stack-id
           in: query
-          description: the ASDC data dictionary widget model. This maps directly to the A&AI widget.
+          description: Heat stack id corresponding to this instance, managed by MSO
           required: false
           type: string
-        - name: widget-model-version
+        - name: vpe-id
           in: query
-          description: the ASDC data dictionary version of the widget model.This maps directly to the A&AI version of the widget.
+          description: Unique ID of VPE connected to this VCE.
           required: false
           type: string
-  /network/l3-networks/l3-network/{network-id}/segmentation-assignments/segmentation-assignment/{segmentation-id}/relationship-list/relationship:
+  /network/vces/vce/{vnf-id}/relationship-list/relationship:
     put:
       tags:
         - Network
       summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkL3NetworksL3NetworkSegmentationAssignmentsSegmentationAssignmentRelationshipListRelationship
+      operationId: createOrUpdateNetworkVcesVceRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -23987,19 +31286,15 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: network-id
-          in: path
-          description: Network ID, should be uuid. Unique across A&AI.
-          required: true
-          type: string
-        - name: segmentation-id
+        - name: vnf-id
           in: path
-          description: Route Table Reference id, UUID assigned to this instance.
+          description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
+          example: __VNF-ID__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVcesVce.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -24008,7 +31303,7 @@ paths:
         - Network
       summary: delete an existing relationship
       description: delete an existing relationship
-      operationId: deleteNetworkL3NetworksL3NetworkSegmentationAssignmentsSegmentationAssignmentRelationshipListRelationship
+      operationId: deleteNetworkVcesVceRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -24019,23 +31314,19 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: network-id
+        - name: vnf-id
           in: path
-          description: Network ID, should be uuid. Unique across A&AI.
+          description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: segmentation-id
-          in: path
-          description: Route Table Reference id, UUID assigned to this instance.
-          required: true
-          type: string
-  /network/l3-networks/l3-network/{network-id}/segmentation-assignments/segmentation-assignment/{segmentation-id}:
+          example: __VNF-ID__
+  /network/vces/vce/{vnf-id}:
     get:
       tags:
         - Network
-      summary: returns segmentation-assignment
-      description: returns segmentation-assignment
-      operationId: getNetworkL3NetworksL3NetworkSegmentationAssignmentsSegmentationAssignment
+      summary: returns vce
+      description: returns vce
+      operationId: getNetworkVcesVce
       produces:
         - application/json
         - application/xml
@@ -24043,71 +31334,65 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/segmentation-assignment"
+              $ref: "#/getDefinitions/vce"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: network-id
-          in: path
-          description: Network ID, should be uuid. Unique across A&AI.
-          required: true
-          type: string
-        - name: segmentation-id
+        - name: vnf-id
           in: path
-          description: Route Table Reference id, UUID assigned to this instance.
+          description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: network-name
-          in: query
-          description: Name of the network, governed by some naming convention..
-          required: false
-          type: string
-        - name: network-role
+          example: __VNF-ID__
+        - name: vnf-name
           in: query
-          description: Role the network plans - who defines these values?
+          description: Name of VNF.
           required: false
           type: string
-        - name: service-id
+        - name: vnf-name2
           in: query
-          description: Unique identifier of service from ASDC.  Does not strictly map to ASDC services.  SOON TO BE DEPRECATED
+          description: Alternate name of VNF.
           required: false
           type: string
-        - name: heat-stack-id
+        - name: vnf-type
           in: query
-          description: Heat stack id corresponding to this instance, managed by MSO
+          description: String capturing type of vnf, that was intended to identify the ASDC resource.  This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures.
           required: false
           type: string
-        - name: contrail-network-fqdn
+        - name: service-id
           in: query
-          description: Contrail FQDN for the network
+          description: Unique identifier of service, does not strictly map to ASDC services, SOON TO BE DEPRECATED.
           required: false
           type: string
-        - name: model-invariant-id
+        - name: regional-resource-zone
           in: query
-          description: the ASDC model id for this resource or service model.
+          description: Regional way of organizing pservers, source of truth should define values
           required: false
           type: string
-        - name: model-version-id
+        - name: prov-status
           in: query
-          description: the ASDC model version for this resource or service model.
+          description: Trigger for operational monitoring of this resource by Service Assurance systems.
           required: false
           type: string
-        - name: widget-model-id
+        - name: heat-stack-id
           in: query
-          description: the ASDC data dictionary widget model. This maps directly to the A&AI widget.
+          description: Heat stack id corresponding to this instance, managed by MSO
           required: false
           type: string
-        - name: widget-model-version
+        - name: vpe-id
           in: query
-          description: the ASDC data dictionary version of the widget model.This maps directly to the A&AI version of the widget.
+          description: Unique ID of VPE connected to this VCE.
           required: false
           type: string
     put:
       tags:
         - Network
-      summary: create or update an existing segmentation-assignment
-      description: create or update an existing segmentation-assignment
-      operationId: createOrUpdateNetworkL3NetworksL3NetworkSegmentationAssignmentsSegmentationAssignment
+      summary: create or update an existing vce
+      description: |
+        Create or update an existing vce.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkVcesVce
       consumes:
         - application/json
         - application/xml
@@ -24118,28 +31403,63 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: network-id
+        - name: vnf-id
           in: path
-          description: Network ID, should be uuid. Unique across A&AI.
+          description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: segmentation-id
+          example: __VNF-ID__
+        - name: body
+          in: body
+          description: vce object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVcesVce.json)
+          required: true
+          schema:
+            $ref: "#/definitions/vce"
+    patch:
+      tags:
+        - Network
+      summary: update an existing vce
+      description: |
+        Update an existing vce
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkVcesVce
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: vnf-id
           in: path
-          description: Route Table Reference id, UUID assigned to this instance.
+          description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
+          example: __VNF-ID__
         - name: body
           in: body
-          description: segmentation-assignment object that needs to be created or updated
+          description: vce object that needs to be created or updated. 
           required: true
           schema:
-            $ref: "#/definitions/segmentation-assignment"
+            $ref: "#/patchDefinitions/vce"
     delete:
       tags:
         - Network
-      summary: delete an existing segmentation-assignment
-      description: delete an existing segmentation-assignment
-      operationId: deleteNetworkL3NetworksL3NetworkSegmentationAssignmentsSegmentationAssignment
+      summary: delete an existing vce
+      description: delete an existing vce
+      operationId: deleteNetworkVcesVce
       consumes:
         - application/json
         - application/xml
@@ -24150,28 +31470,24 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: network-id
-          in: path
-          description: Network ID, should be uuid. Unique across A&AI.
-          required: true
-          type: string
-        - name: segmentation-id
+        - name: vnf-id
           in: path
-          description: Route Table Reference id, UUID assigned to this instance.
+          description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
+          example: __VNF-ID__
         - name: resource-version
           in: query
           description: resource-version for concurrency
           required: true
           type: string
-  /network/l3-networks/l3-network/{network-id}/segmentation-assignments:
+  /network/vces:
     get:
       tags:
         - Network
-      summary: returns segmentation-assignments
-      description: returns segmentation-assignments
-      operationId: getNetworkL3NetworksL3NetworkSegmentationAssignments
+      summary: returns vces
+      description: returns vces
+      operationId: getNetworkVces
       produces:
         - application/json
         - application/xml
@@ -24179,66 +31495,65 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/segmentation-assignments"
+              $ref: "#/getDefinitions/vces"
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+  /network/vnfcs/vnfc/{vnfc-name}/relationship-list/relationship:
+    put:
+      tags:
+        - Network
+      summary: see node definition for valid relationships
+      operationId: createOrUpdateNetworkVnfcsVnfcRelationshipListRelationship
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: network-id
+        - name: vnfc-name
           in: path
-          description: Network ID, should be uuid. Unique across A&AI.
+          description: Unique ID of vnfc.
           required: true
           type: string
-        - name: network-name
-          in: query
-          description: Name of the network, governed by some naming convention..
-          required: false
-          type: string
-        - name: network-role
-          in: query
-          description: Role the network plans - who defines these values?
-          required: false
-          type: string
-        - name: service-id
-          in: query
-          description: Unique identifier of service from ASDC.  Does not strictly map to ASDC services.  SOON TO BE DEPRECATED
-          required: false
-          type: string
-        - name: heat-stack-id
-          in: query
-          description: Heat stack id corresponding to this instance, managed by MSO
-          required: false
-          type: string
-        - name: contrail-network-fqdn
-          in: query
-          description: Contrail FQDN for the network
-          required: false
-          type: string
-        - name: model-invariant-id
-          in: query
-          description: the ASDC model id for this resource or service model.
-          required: false
-          type: string
-        - name: model-version-id
-          in: query
-          description: the ASDC model version for this resource or service model.
-          required: false
-          type: string
-        - name: widget-model-id
-          in: query
-          description: the ASDC data dictionary widget model. This maps directly to the A&AI widget.
-          required: false
-          type: string
-        - name: widget-model-version
-          in: query
-          description: the ASDC data dictionary version of the widget model.This maps directly to the A&AI version of the widget.
-          required: false
+          example: __VNFC-NAME__
+        - name: body
+          in: body
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVnfcsVnfc.json)
+          required: true
+          schema:
+            $ref: "#/definitions/relationship"
+    delete:
+      tags:
+        - Network
+      summary: delete an existing relationship
+      description: delete an existing relationship
+      operationId: deleteNetworkVnfcsVnfcRelationshipListRelationship
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: vnfc-name
+          in: path
+          description: Unique ID of vnfc.
+          required: true
           type: string
-  /network/l3-networks/l3-network/{network-id}/relationship-list/relationship:
+          example: __VNFC-NAME__
+  /network/vnfcs/vnfc/{vnfc-name}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}/relationship-list/relationship:
     put:
       tags:
         - Network
       summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkL3NetworksL3NetworkRelationshipListRelationship
+      operationId: createOrUpdateNetworkVnfcsVnfcL3InterfaceIpv4AddressListRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -24249,14 +31564,21 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: network-id
+        - name: vnfc-name
           in: path
-          description: Network ID, should be uuid. Unique across A&AI.
+          description: Unique ID of vnfc.
+          required: true
+          type: string
+          example: __VNFC-NAME__
+        - name: l3-interface-ipv4-address
+          in: path
+          description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVnfcsVnfcL3InterfaceIpv4AddressList.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -24265,7 +31587,7 @@ paths:
         - Network
       summary: delete an existing relationship
       description: delete an existing relationship
-      operationId: deleteNetworkL3NetworksL3NetworkRelationshipListRelationship
+      operationId: deleteNetworkVnfcsVnfcL3InterfaceIpv4AddressListRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -24276,18 +31598,25 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: network-id
+        - name: vnfc-name
           in: path
-          description: Network ID, should be uuid. Unique across A&AI.
+          description: Unique ID of vnfc.
           required: true
           type: string
-  /network/l3-networks/l3-network/{network-id}:
+          example: __VNFC-NAME__
+        - name: l3-interface-ipv4-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
+  /network/vnfcs/vnfc/{vnfc-name}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}:
     get:
       tags:
         - Network
-      summary: returns l3-network
-      description: returns l3-network
-      operationId: getNetworkL3NetworksL3Network
+      summary: returns l3-interface-ipv4-address-list
+      description: returns l3-interface-ipv4-address-list
+      operationId: getNetworkVnfcsVnfcL3InterfaceIpv4AddressList
       produces:
         - application/json
         - application/xml
@@ -24295,38 +31624,53 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/l3-network"
+              $ref: "#/getDefinitions/l3-interface-ipv4-address-list"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: network-id
+        - name: vnfc-name
           in: path
-          description: Network ID, should be uuid. Unique across A&AI.
+          description: Unique ID of vnfc.
           required: true
           type: string
-        - name: network-name
+          example: __VNFC-NAME__
+        - name: l3-interface-ipv4-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
+        - name: nfc-naming-code
           in: query
-          description: Name of the network, governed by some naming convention..
+          description: Short code that is used in naming instances of the item being modeled
           required: false
           type: string
-        - name: network-role
+        - name: nfc-function
           in: query
-          description: Role the network plans - who defines these values?
+          description: English description of function that the specific resource deployment is providing. Assigned as part of the customization of a resource in a service
           required: false
           type: string
-        - name: service-id
+        - name: prov-status
           in: query
-          description: Unique identifier of service from ASDC.  Does not strictly map to ASDC services.  SOON TO BE DEPRECATED
+          description: prov status of this vnfc
           required: false
           type: string
-        - name: heat-stack-id
+        - name: ipaddress-v4-oam-vip
           in: query
-          description: Heat stack id corresponding to this instance, managed by MSO
+          description: Oam V4 vip address of this vnfc
           required: false
           type: string
-        - name: contrail-network-fqdn
+        - name: in-maint
           in: query
-          description: Contrail FQDN for the network
+          required: false
+          type: boolean
+        - name: is-closed-loop-disabled
+          in: query
+          required: false
+          type: boolean
+        - name: group-notation
+          in: query
+          description: Group notation of VNFC
           required: false
           type: string
         - name: model-invariant-id
@@ -24339,22 +31683,31 @@ paths:
           description: the ASDC model version for this resource or service model.
           required: false
           type: string
-        - name: widget-model-id
+        - name: vlan-id-inner
           in: query
-          description: the ASDC data dictionary widget model. This maps directly to the A&AI widget.
+          description: Inner VLAN tag
+          required: false
+          type: integer
+          format: int64
+        - name: neutron-network-id
+          in: query
+          description: Neutron network id of the interface that address belongs to
           required: false
           type: string
-        - name: widget-model-version
+        - name: neutron-subnet-id
           in: query
-          description: the ASDC data dictionary version of the widget model.This maps directly to the A&AI version of the widget.
+          description: Neutron id of subnet that address belongs to
           required: false
           type: string
     put:
       tags:
         - Network
-      summary: create or update an existing l3-network
-      description: create or update an existing l3-network
-      operationId: createOrUpdateNetworkL3NetworksL3Network
+      summary: create or update an existing l3-interface-ipv4-address-list
+      description: |
+        Create or update an existing l3-interface-ipv4-address-list.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkVnfcsVnfcL3InterfaceIpv4AddressList
       consumes:
         - application/json
         - application/xml
@@ -24365,23 +31718,41 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: network-id
+        - name: vnfc-name
           in: path
-          description: Network ID, should be uuid. Unique across A&AI.
+          description: Unique ID of vnfc.
+          required: true
+          type: string
+          example: __VNFC-NAME__
+        - name: l3-interface-ipv4-address
+          in: path
+          description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
         - name: body
           in: body
-          description: l3-network object that needs to be created or updated
+          description: l3-interface-ipv4-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVnfcsVnfcL3InterfaceIpv4AddressList.json)
           required: true
           schema:
-            $ref: "#/definitions/l3-network"
-    delete:
+            $ref: "#/definitions/l3-interface-ipv4-address-list"
+    patch:
       tags:
         - Network
-      summary: delete an existing l3-network
-      description: delete an existing l3-network
-      operationId: deleteNetworkL3NetworksL3Network
+      summary: update an existing l3-interface-ipv4-address-list
+      description: |
+        Update an existing l3-interface-ipv4-address-list
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkVnfcsVnfcL3InterfaceIpv4AddressList
       consumes:
         - application/json
         - application/xml
@@ -24392,39 +31763,63 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: network-id
+        - name: vnfc-name
           in: path
-          description: Network ID, should be uuid. Unique across A&AI.
+          description: Unique ID of vnfc.
           required: true
           type: string
-        - name: resource-version
-          in: query
-          description: resource-version for concurrency
+          example: __VNFC-NAME__
+        - name: l3-interface-ipv4-address
+          in: path
+          description: IP address
           required: true
           type: string
-  /network/l3-networks:
-    get:
+          example: __L3-INTERFACE-IPV4-ADDRESS__
+        - name: body
+          in: body
+          description: l3-interface-ipv4-address-list object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/l3-interface-ipv4-address-list"
+    delete:
       tags:
         - Network
-      summary: returns l3-networks
-      description: returns l3-networks
-      operationId: getNetworkL3Networks
+      summary: delete an existing l3-interface-ipv4-address-list
+      description: delete an existing l3-interface-ipv4-address-list
+      operationId: deleteNetworkVnfcsVnfcL3InterfaceIpv4AddressList
+      consumes:
+        - application/json
+        - application/xml
       produces:
         - application/json
         - application/xml
       responses:
-        "200":
-          description: successful operation
-          schema:
-              $ref: "#/definitions/l3-networks"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
-  /network/network-policies/network-policy/{network-policy-id}/relationship-list/relationship:
+      parameters:
+        - name: vnfc-name
+          in: path
+          description: Unique ID of vnfc.
+          required: true
+          type: string
+          example: __VNFC-NAME__
+        - name: l3-interface-ipv4-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
+        - name: resource-version
+          in: query
+          description: resource-version for concurrency
+          required: true
+          type: string
+  /network/vnfcs/vnfc/{vnfc-name}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}/relationship-list/relationship:
     put:
       tags:
         - Network
       summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkNetworkPoliciesNetworkPolicyRelationshipListRelationship
+      operationId: createOrUpdateNetworkVnfcsVnfcL3InterfaceIpv6AddressListRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -24435,14 +31830,21 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: network-policy-id
+        - name: vnfc-name
           in: path
-          description: UUID representing unique key to this instance
+          description: Unique ID of vnfc.
+          required: true
+          type: string
+          example: __VNFC-NAME__
+        - name: l3-interface-ipv6-address
+          in: path
+          description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVnfcsVnfcL3InterfaceIpv6AddressList.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -24451,7 +31853,7 @@ paths:
         - Network
       summary: delete an existing relationship
       description: delete an existing relationship
-      operationId: deleteNetworkNetworkPoliciesNetworkPolicyRelationshipListRelationship
+      operationId: deleteNetworkVnfcsVnfcL3InterfaceIpv6AddressListRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -24462,18 +31864,25 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: network-policy-id
+        - name: vnfc-name
           in: path
-          description: UUID representing unique key to this instance
+          description: Unique ID of vnfc.
           required: true
           type: string
-  /network/network-policies/network-policy/{network-policy-id}:
+          example: __VNFC-NAME__
+        - name: l3-interface-ipv6-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
+  /network/vnfcs/vnfc/{vnfc-name}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}:
     get:
       tags:
         - Network
-      summary: returns network-policy
-      description: returns network-policy
-      operationId: getNetworkNetworkPoliciesNetworkPolicy
+      summary: returns l3-interface-ipv6-address-list
+      description: returns l3-interface-ipv6-address-list
+      operationId: getNetworkVnfcsVnfcL3InterfaceIpv6AddressList
       produces:
         - application/json
         - application/xml
@@ -24481,26 +31890,90 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/network-policy"
+              $ref: "#/getDefinitions/l3-interface-ipv6-address-list"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: network-policy-id
+        - name: vnfc-name
           in: path
-          description: UUID representing unique key to this instance
+          description: Unique ID of vnfc.
           required: true
           type: string
-        - name: network-policy-fqdn
+          example: __VNFC-NAME__
+        - name: l3-interface-ipv6-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
+        - name: nfc-naming-code
           in: query
-          description: Contrail FQDN for the policy
+          description: Short code that is used in naming instances of the item being modeled
+          required: false
+          type: string
+        - name: nfc-function
+          in: query
+          description: English description of function that the specific resource deployment is providing. Assigned as part of the customization of a resource in a service
+          required: false
+          type: string
+        - name: prov-status
+          in: query
+          description: prov status of this vnfc
+          required: false
+          type: string
+        - name: ipaddress-v4-oam-vip
+          in: query
+          description: Oam V4 vip address of this vnfc
+          required: false
+          type: string
+        - name: in-maint
+          in: query
+          required: false
+          type: boolean
+        - name: is-closed-loop-disabled
+          in: query
+          required: false
+          type: boolean
+        - name: group-notation
+          in: query
+          description: Group notation of VNFC
+          required: false
+          type: string
+        - name: model-invariant-id
+          in: query
+          description: the ASDC model id for this resource or service model.
+          required: false
+          type: string
+        - name: model-version-id
+          in: query
+          description: the ASDC model version for this resource or service model.
+          required: false
+          type: string
+        - name: vlan-id-inner
+          in: query
+          description: Inner VLAN tag
+          required: false
+          type: integer
+          format: int64
+        - name: neutron-network-id
+          in: query
+          description: Neutron network id of the interface that address belongs to
+          required: false
+          type: string
+        - name: neutron-subnet-id
+          in: query
+          description: Neutron id of subnet that address belongs to
           required: false
           type: string
     put:
       tags:
         - Network
-      summary: create or update an existing network-policy
-      description: create or update an existing network-policy
-      operationId: createOrUpdateNetworkNetworkPoliciesNetworkPolicy
+      summary: create or update an existing l3-interface-ipv6-address-list
+      description: |
+        Create or update an existing l3-interface-ipv6-address-list.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkVnfcsVnfcL3InterfaceIpv6AddressList
       consumes:
         - application/json
         - application/xml
@@ -24511,23 +31984,41 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: network-policy-id
+        - name: vnfc-name
           in: path
-          description: UUID representing unique key to this instance
+          description: Unique ID of vnfc.
+          required: true
+          type: string
+          example: __VNFC-NAME__
+        - name: l3-interface-ipv6-address
+          in: path
+          description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
         - name: body
           in: body
-          description: network-policy object that needs to be created or updated
+          description: l3-interface-ipv6-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVnfcsVnfcL3InterfaceIpv6AddressList.json)
           required: true
           schema:
-            $ref: "#/definitions/network-policy"
-    delete:
+            $ref: "#/definitions/l3-interface-ipv6-address-list"
+    patch:
       tags:
         - Network
-      summary: delete an existing network-policy
-      description: delete an existing network-policy
-      operationId: deleteNetworkNetworkPoliciesNetworkPolicy
+      summary: update an existing l3-interface-ipv6-address-list
+      description: |
+        Update an existing l3-interface-ipv6-address-list
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkVnfcsVnfcL3InterfaceIpv6AddressList
       consumes:
         - application/json
         - application/xml
@@ -24538,66 +32029,30 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: network-policy-id
+        - name: vnfc-name
           in: path
-          description: UUID representing unique key to this instance
-          required: true
-          type: string
-        - name: resource-version
-          in: query
-          description: resource-version for concurrency
+          description: Unique ID of vnfc.
           required: true
           type: string
-  /network/network-policies:
-    get:
-      tags:
-        - Network
-      summary: returns network-policies
-      description: returns network-policies
-      operationId: getNetworkNetworkPolicies
-      produces:
-        - application/json
-        - application/xml
-      responses:
-        "200":
-          description: successful operation
-          schema:
-              $ref: "#/definitions/network-policies"
-        "default":
-          description: Response codes found in [response codes](https://wiki.onap.org/).
-  /network/generic-vnfs/generic-vnf/{vnf-id}/relationship-list/relationship:
-    put:
-      tags:
-        - Network
-      summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkGenericVnfsGenericVnfRelationshipListRelationship
-      consumes:
-        - application/json
-        - application/xml
-      produces:
-        - application/json
-        - application/xml
-      responses:
-        "default":
-          description: Response codes found in [response codes](https://wiki.onap.org/).
-      parameters:
-        - name: vnf-id
+          example: __VNFC-NAME__
+        - name: l3-interface-ipv6-address
           in: path
-          description: Unique id of VNF.  This is unique across the graph.
+          description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: l3-interface-ipv6-address-list object that needs to be created or updated. 
           required: true
           schema:
-            $ref: "#/definitions/relationship"
+            $ref: "#/patchDefinitions/l3-interface-ipv6-address-list"
     delete:
       tags:
         - Network
-      summary: delete an existing relationship
-      description: delete an existing relationship
-      operationId: deleteNetworkGenericVnfsGenericVnfRelationshipListRelationship
+      summary: delete an existing l3-interface-ipv6-address-list
+      description: delete an existing l3-interface-ipv6-address-list
+      operationId: deleteNetworkVnfcsVnfcL3InterfaceIpv6AddressList
       consumes:
         - application/json
         - application/xml
@@ -24608,17 +32063,99 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id
+        - name: vnfc-name
           in: path
-          description: Unique id of VNF.  This is unique across the graph.
+          description: Unique ID of vnfc.
           required: true
           type: string
-  /network/generic-vnfs/generic-vnf/{vnf-id}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/relationship-list/relationship:
-    put:
-      tags:
-        - Network
-      summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkGenericVnfsGenericVnfLInterfacesLInterfaceVlansVlanRelationshipListRelationship
+          example: __VNFC-NAME__
+        - name: l3-interface-ipv6-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
+        - name: resource-version
+          in: query
+          description: resource-version for concurrency
+          required: true
+          type: string
+  /network/vnfcs/vnfc/{vnfc-name}:
+    get:
+      tags:
+        - Network
+      summary: returns vnfc
+      description: returns vnfc
+      operationId: getNetworkVnfcsVnfc
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "200":
+          description: successful operation
+          schema:
+              $ref: "#/getDefinitions/vnfc"
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: vnfc-name
+          in: path
+          description: Unique ID of vnfc.
+          required: true
+          type: string
+          example: __VNFC-NAME__
+        - name: nfc-naming-code
+          in: query
+          description: Short code that is used in naming instances of the item being modeled
+          required: false
+          type: string
+        - name: nfc-function
+          in: query
+          description: English description of function that the specific resource deployment is providing. Assigned as part of the customization of a resource in a service
+          required: false
+          type: string
+        - name: prov-status
+          in: query
+          description: prov status of this vnfc
+          required: false
+          type: string
+        - name: ipaddress-v4-oam-vip
+          in: query
+          description: Oam V4 vip address of this vnfc
+          required: false
+          type: string
+        - name: in-maint
+          in: query
+          required: false
+          type: boolean
+        - name: is-closed-loop-disabled
+          in: query
+          required: false
+          type: boolean
+        - name: group-notation
+          in: query
+          description: Group notation of VNFC
+          required: false
+          type: string
+        - name: model-invariant-id
+          in: query
+          description: the ASDC model id for this resource or service model.
+          required: false
+          type: string
+        - name: model-version-id
+          in: query
+          description: the ASDC model version for this resource or service model.
+          required: false
+          type: string
+    put:
+      tags:
+        - Network
+      summary: create or update an existing vnfc
+      description: |
+        Create or update an existing vnfc.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkVnfcsVnfc
       consumes:
         - application/json
         - application/xml
@@ -24629,33 +32166,63 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id
+        - name: vnfc-name
           in: path
-          description: Unique id of VNF.  This is unique across the graph.
+          description: Unique ID of vnfc.
           required: true
           type: string
-        - name: interface-name
-          in: path
-          description: Name given to the interface
+          example: __VNFC-NAME__
+        - name: body
+          in: body
+          description: vnfc object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVnfcsVnfc.json)
           required: true
-          type: string
-        - name: vlan-interface
+          schema:
+            $ref: "#/definitions/vnfc"
+    patch:
+      tags:
+        - Network
+      summary: update an existing vnfc
+      description: |
+        Update an existing vnfc
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkVnfcsVnfc
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: vnfc-name
           in: path
-          description: String that identifies the interface
+          description: Unique ID of vnfc.
           required: true
           type: string
+          example: __VNFC-NAME__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: vnfc object that needs to be created or updated. 
           required: true
           schema:
-            $ref: "#/definitions/relationship"
+            $ref: "#/patchDefinitions/vnfc"
     delete:
       tags:
         - Network
-      summary: delete an existing relationship
-      description: delete an existing relationship
-      operationId: deleteNetworkGenericVnfsGenericVnfLInterfacesLInterfaceVlansVlanRelationshipListRelationship
+      summary: delete an existing vnfc
+      description: delete an existing vnfc
+      operationId: deleteNetworkVnfcsVnfc
       consumes:
         - application/json
         - application/xml
@@ -24666,27 +32233,40 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id
-          in: path
-          description: Unique id of VNF.  This is unique across the graph.
-          required: true
-          type: string
-        - name: interface-name
+        - name: vnfc-name
           in: path
-          description: Name given to the interface
+          description: Unique ID of vnfc.
           required: true
           type: string
-        - name: vlan-interface
-          in: path
-          description: String that identifies the interface
+          example: __VNFC-NAME__
+        - name: resource-version
+          in: query
+          description: resource-version for concurrency
           required: true
           type: string
-  /network/generic-vnfs/generic-vnf/{vnf-id}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}/relationship-list/relationship:
+  /network/vnfcs:
+    get:
+      tags:
+        - Network
+      summary: returns vnfcs
+      description: returns vnfcs
+      operationId: getNetworkVnfcs
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "200":
+          description: successful operation
+          schema:
+              $ref: "#/getDefinitions/vnfcs"
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+  /network/l3-networks/l3-network/{network-id}/subnets/subnet/{subnet-id}/host-routes/host-route/{host-route-id}/relationship-list/relationship:
     put:
       tags:
         - Network
       summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkGenericVnfsGenericVnfLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressListRelationshipListRelationship
+      operationId: createOrUpdateNetworkL3NetworksL3NetworkSubnetsSubnetHostRoutesHostRouteRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -24697,29 +32277,27 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id
-          in: path
-          description: Unique id of VNF.  This is unique across the graph.
-          required: true
-          type: string
-        - name: interface-name
+        - name: network-id
           in: path
-          description: Name given to the interface
+          description: Network ID, should be uuid. Unique across A&AI.
           required: true
           type: string
-        - name: vlan-interface
+          example: __NETWORK-ID__
+        - name: subnet-id
           in: path
-          description: String that identifies the interface
+          description: Subnet ID, should be UUID.
           required: true
           type: string
-        - name: l3-interface-ipv4-address
+          example: __SUBNET-ID__
+        - name: host-route-id
           in: path
-          description: IP address
+          description: host-route id
           required: true
           type: string
+          example: __HOST-ROUTE-ID__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkL3NetworksL3NetworkSubnetsSubnetHostRoutesHostRoute.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -24728,7 +32306,7 @@ paths:
         - Network
       summary: delete an existing relationship
       description: delete an existing relationship
-      operationId: deleteNetworkGenericVnfsGenericVnfLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressListRelationshipListRelationship
+      operationId: deleteNetworkL3NetworksL3NetworkSubnetsSubnetHostRoutesHostRouteRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -24739,33 +32317,31 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id
-          in: path
-          description: Unique id of VNF.  This is unique across the graph.
-          required: true
-          type: string
-        - name: interface-name
+        - name: network-id
           in: path
-          description: Name given to the interface
+          description: Network ID, should be uuid. Unique across A&AI.
           required: true
           type: string
-        - name: vlan-interface
+          example: __NETWORK-ID__
+        - name: subnet-id
           in: path
-          description: String that identifies the interface
+          description: Subnet ID, should be UUID.
           required: true
           type: string
-        - name: l3-interface-ipv4-address
+          example: __SUBNET-ID__
+        - name: host-route-id
           in: path
-          description: IP address
+          description: host-route id
           required: true
           type: string
-  /network/generic-vnfs/generic-vnf/{vnf-id}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}:
+          example: __HOST-ROUTE-ID__
+  /network/l3-networks/l3-network/{network-id}/subnets/subnet/{subnet-id}/host-routes/host-route/{host-route-id}:
     get:
       tags:
         - Network
-      summary: returns l3-interface-ipv4-address-list
-      description: returns l3-interface-ipv4-address-list
-      operationId: getNetworkGenericVnfsGenericVnfLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList
+      summary: returns host-route
+      description: returns host-route
+      operationId: getNetworkL3NetworksL3NetworkSubnetsSubnetHostRoutesHostRoute
       produces:
         - application/json
         - application/xml
@@ -24773,58 +32349,41 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/l3-interface-ipv4-address-list"
+              $ref: "#/getDefinitions/host-route"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id
-          in: path
-          description: Unique id of VNF.  This is unique across the graph.
-          required: true
-          type: string
-        - name: interface-name
+        - name: network-id
           in: path
-          description: Name given to the interface
+          description: Network ID, should be uuid. Unique across A&AI.
           required: true
           type: string
-        - name: vlan-interface
+          example: __NETWORK-ID__
+        - name: subnet-id
           in: path
-          description: String that identifies the interface
+          description: Subnet ID, should be UUID.
           required: true
           type: string
-        - name: l3-interface-ipv4-address
+          example: __SUBNET-ID__
+        - name: host-route-id
           in: path
-          description: IP address
+          description: host-route id
           required: true
           type: string
-        - name: vnf-name
-          in: query
-          description: Name of VNF.
-          required: false
-          type: string
-        - name: vnf-name2
+          example: __HOST-ROUTE-ID__
+        - name: network-name
           in: query
-          description: Alternate name of VNF.
+          description: Name of the network, governed by some naming convention..
           required: false
           type: string
-        - name: vnf-type
+        - name: network-role
           in: query
-          description: String capturing type of vnf, that was intended to identify the ASDC resource.  This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures.
+          description: Role the network plans - who defines these values?
           required: false
           type: string
         - name: service-id
           in: query
-          description: Unique identifier of service, does not necessarily map to ASDC service models.  SOON TO BE DEPRECATED
-          required: false
-          type: string
-        - name: regional-resource-zone
-          in: query
-          description: Regional way of organizing pservers, source of truth should define values
-          required: false
-          type: string
-        - name: prov-status
-          in: query
-          description: Trigger for operational monitoring of this resource by Service Assurance systems.
+          description: Unique identifier of service from ASDC.  Does not strictly map to ASDC services.  SOON TO BE DEPRECATED
           required: false
           type: string
         - name: heat-stack-id
@@ -24832,14 +32391,11 @@ paths:
           description: Heat stack id corresponding to this instance, managed by MSO
           required: false
           type: string
-        - name: in-maint
-          in: query
-          required: false
-          type: boolean
-        - name: is-closed-loop-disabled
+        - name: contrail-network-fqdn
           in: query
+          description: Contrail FQDN for the network
           required: false
-          type: boolean
+          type: string
         - name: model-invariant-id
           in: query
           description: the ASDC model id for this resource or service model.
@@ -24860,74 +32416,20 @@ paths:
           description: the ASDC data dictionary version of the widget model.This maps directly to the A&AI version of the widget.
           required: false
           type: string
-        - name: nf-type
-          in: query
-          description: Generic description of the type of NF
-          required: false
-          type: string
-        - name: nf-function
-          in: query
-          description: English description of Network function that the specific VNF deployment is providing
-          required: false
-          type: string
-        - name: nf-role
-          in: query
-          description: role in the network that this model will be providing
-          required: false
-          type: string
-        - name: nf-naming-code
-          in: query
-          description: string assigned to this model used for naming purposes
-          required: false
-          type: string
-        - name: interface-id
-          in: query
-          description: ID of interface
-          required: false
-          type: string
-        - name: macaddr
-          in: query
-          description: MAC address for the interface
-          required: false
-          type: string
-        - name: network-name
-          in: query
-          description: Name of the network
-          required: false
-          type: string
-        - name: vlan-id-inner
-          in: query
-          description: Inner VLAN tag
-          required: false
-          type: integer
-          format: int64
-        - name: vpn-key
-          in: query
-          description: This indicates the customers VPN ID associated with this vlan
-          required: false
-          type: string
-        - name: vlan-id-inner
-          in: query
-          description: Inner VLAN tag
-          required: false
-          type: integer
-          format: int64
-        - name: neutron-network-id
-          in: query
-          description: Neutron network id of the interface that address belongs to
-          required: false
-          type: string
-        - name: neutron-subnet-id
+        - name: subnet-name
           in: query
-          description: Neutron id of subnet that address belongs to
+          description: Name associated with the subnet.
           required: false
           type: string
     put:
       tags:
         - Network
-      summary: create or update an existing l3-interface-ipv4-address-list
-      description: create or update an existing l3-interface-ipv4-address-list
-      operationId: createOrUpdateNetworkGenericVnfsGenericVnfLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList
+      summary: create or update an existing host-route
+      description: |
+        Create or update an existing host-route.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkL3NetworksL3NetworkSubnetsSubnetHostRoutesHostRoute
       consumes:
         - application/json
         - application/xml
@@ -24938,79 +32440,47 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id
-          in: path
-          description: Unique id of VNF.  This is unique across the graph.
-          required: true
-          type: string
-        - name: interface-name
+        - name: network-id
           in: path
-          description: Name given to the interface
+          description: Network ID, should be uuid. Unique across A&AI.
           required: true
           type: string
-        - name: vlan-interface
+          example: __NETWORK-ID__
+        - name: subnet-id
           in: path
-          description: String that identifies the interface
+          description: Subnet ID, should be UUID.
           required: true
           type: string
-        - name: l3-interface-ipv4-address
+          example: __SUBNET-ID__
+        - name: host-route-id
           in: path
-          description: IP address
+          description: host-route id
           required: true
           type: string
+          example: __HOST-ROUTE-ID__
         - name: body
           in: body
-          description: l3-interface-ipv4-address-list object that needs to be created or updated
+          description: host-route object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkL3NetworksL3NetworkSubnetsSubnetHostRoutesHostRoute.json)
           required: true
           schema:
-            $ref: "#/definitions/l3-interface-ipv4-address-list"
-    delete:
-      tags:
-        - Network
-      summary: delete an existing l3-interface-ipv4-address-list
-      description: delete an existing l3-interface-ipv4-address-list
-      operationId: deleteNetworkGenericVnfsGenericVnfLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList
-      consumes:
-        - application/json
-        - application/xml
-      produces:
-        - application/json
-        - application/xml
-      responses:
-        "default":
-          description: Response codes found in [response codes](https://wiki.onap.org/).
-      parameters:
-        - name: vnf-id
-          in: path
-          description: Unique id of VNF.  This is unique across the graph.
-          required: true
-          type: string
-        - name: interface-name
-          in: path
-          description: Name given to the interface
-          required: true
-          type: string
-        - name: vlan-interface
-          in: path
-          description: String that identifies the interface
-          required: true
-          type: string
-        - name: l3-interface-ipv4-address
-          in: path
-          description: IP address
-          required: true
-          type: string
-        - name: resource-version
-          in: query
-          description: resource-version for concurrency
-          required: true
-          type: string
-  /network/generic-vnfs/generic-vnf/{vnf-id}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}/relationship-list/relationship:
-    put:
+            $ref: "#/definitions/host-route"
+    patch:
       tags:
         - Network
-      summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkGenericVnfsGenericVnfLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressListRelationshipListRelationship
+      summary: update an existing host-route
+      description: |
+        Update an existing host-route
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkL3NetworksL3NetworkSubnetsSubnetHostRoutesHostRoute
       consumes:
         - application/json
         - application/xml
@@ -25021,38 +32491,36 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id
-          in: path
-          description: Unique id of VNF.  This is unique across the graph.
-          required: true
-          type: string
-        - name: interface-name
+        - name: network-id
           in: path
-          description: Name given to the interface
+          description: Network ID, should be uuid. Unique across A&AI.
           required: true
           type: string
-        - name: vlan-interface
+          example: __NETWORK-ID__
+        - name: subnet-id
           in: path
-          description: String that identifies the interface
+          description: Subnet ID, should be UUID.
           required: true
           type: string
-        - name: l3-interface-ipv6-address
+          example: __SUBNET-ID__
+        - name: host-route-id
           in: path
-          description: IP address
+          description: host-route id
           required: true
           type: string
+          example: __HOST-ROUTE-ID__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: host-route object that needs to be created or updated. 
           required: true
           schema:
-            $ref: "#/definitions/relationship"
+            $ref: "#/patchDefinitions/host-route"
     delete:
       tags:
         - Network
-      summary: delete an existing relationship
-      description: delete an existing relationship
-      operationId: deleteNetworkGenericVnfsGenericVnfLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressListRelationshipListRelationship
+      summary: delete an existing host-route
+      description: delete an existing host-route
+      operationId: deleteNetworkL3NetworksL3NetworkSubnetsSubnetHostRoutesHostRoute
       consumes:
         - application/json
         - application/xml
@@ -25063,33 +32531,36 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id
+        - name: network-id
           in: path
-          description: Unique id of VNF.  This is unique across the graph.
+          description: Network ID, should be uuid. Unique across A&AI.
           required: true
           type: string
-        - name: interface-name
+          example: __NETWORK-ID__
+        - name: subnet-id
           in: path
-          description: Name given to the interface
+          description: Subnet ID, should be UUID.
           required: true
           type: string
-        - name: vlan-interface
+          example: __SUBNET-ID__
+        - name: host-route-id
           in: path
-          description: String that identifies the interface
+          description: host-route id
           required: true
           type: string
-        - name: l3-interface-ipv6-address
-          in: path
-          description: IP address
+          example: __HOST-ROUTE-ID__
+        - name: resource-version
+          in: query
+          description: resource-version for concurrency
           required: true
           type: string
-  /network/generic-vnfs/generic-vnf/{vnf-id}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}:
+  /network/l3-networks/l3-network/{network-id}/subnets/subnet/{subnet-id}/host-routes:
     get:
       tags:
         - Network
-      summary: returns l3-interface-ipv6-address-list
-      description: returns l3-interface-ipv6-address-list
-      operationId: getNetworkGenericVnfsGenericVnfLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList
+      summary: returns host-routes
+      description: returns host-routes
+      operationId: getNetworkL3NetworksL3NetworkSubnetsSubnetHostRoutes
       produces:
         - application/json
         - application/xml
@@ -25097,58 +32568,35 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/l3-interface-ipv6-address-list"
+              $ref: "#/getDefinitions/host-routes"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id
-          in: path
-          description: Unique id of VNF.  This is unique across the graph.
-          required: true
-          type: string
-        - name: interface-name
-          in: path
-          description: Name given to the interface
-          required: true
-          type: string
-        - name: vlan-interface
+        - name: network-id
           in: path
-          description: String that identifies the interface
+          description: Network ID, should be uuid. Unique across A&AI.
           required: true
           type: string
-        - name: l3-interface-ipv6-address
+          example: __NETWORK-ID__
+        - name: subnet-id
           in: path
-          description: IP address
+          description: Subnet ID, should be UUID.
           required: true
           type: string
-        - name: vnf-name
-          in: query
-          description: Name of VNF.
-          required: false
-          type: string
-        - name: vnf-name2
+          example: __SUBNET-ID__
+        - name: network-name
           in: query
-          description: Alternate name of VNF.
+          description: Name of the network, governed by some naming convention..
           required: false
           type: string
-        - name: vnf-type
+        - name: network-role
           in: query
-          description: String capturing type of vnf, that was intended to identify the ASDC resource.  This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures.
+          description: Role the network plans - who defines these values?
           required: false
           type: string
         - name: service-id
           in: query
-          description: Unique identifier of service, does not necessarily map to ASDC service models.  SOON TO BE DEPRECATED
-          required: false
-          type: string
-        - name: regional-resource-zone
-          in: query
-          description: Regional way of organizing pservers, source of truth should define values
-          required: false
-          type: string
-        - name: prov-status
-          in: query
-          description: Trigger for operational monitoring of this resource by Service Assurance systems.
+          description: Unique identifier of service from ASDC.  Does not strictly map to ASDC services.  SOON TO BE DEPRECATED
           required: false
           type: string
         - name: heat-stack-id
@@ -25156,14 +32604,11 @@ paths:
           description: Heat stack id corresponding to this instance, managed by MSO
           required: false
           type: string
-        - name: in-maint
-          in: query
-          required: false
-          type: boolean
-        - name: is-closed-loop-disabled
+        - name: contrail-network-fqdn
           in: query
+          description: Contrail FQDN for the network
           required: false
-          type: boolean
+          type: string
         - name: model-invariant-id
           in: query
           description: the ASDC model id for this resource or service model.
@@ -25184,74 +32629,17 @@ paths:
           description: the ASDC data dictionary version of the widget model.This maps directly to the A&AI version of the widget.
           required: false
           type: string
-        - name: nf-type
-          in: query
-          description: Generic description of the type of NF
-          required: false
-          type: string
-        - name: nf-function
-          in: query
-          description: English description of Network function that the specific VNF deployment is providing
-          required: false
-          type: string
-        - name: nf-role
-          in: query
-          description: role in the network that this model will be providing
-          required: false
-          type: string
-        - name: nf-naming-code
-          in: query
-          description: string assigned to this model used for naming purposes
-          required: false
-          type: string
-        - name: interface-id
-          in: query
-          description: ID of interface
-          required: false
-          type: string
-        - name: macaddr
-          in: query
-          description: MAC address for the interface
-          required: false
-          type: string
-        - name: network-name
-          in: query
-          description: Name of the network
-          required: false
-          type: string
-        - name: vlan-id-inner
-          in: query
-          description: Inner VLAN tag
-          required: false
-          type: integer
-          format: int64
-        - name: vpn-key
-          in: query
-          description: This indicates the customers VPN ID associated with this vlan
-          required: false
-          type: string
-        - name: vlan-id-inner
-          in: query
-          description: Inner VLAN tag
-          required: false
-          type: integer
-          format: int64
-        - name: neutron-network-id
-          in: query
-          description: Neutron network id of the interface that address belongs to
-          required: false
-          type: string
-        - name: neutron-subnet-id
+        - name: subnet-name
           in: query
-          description: Neutron id of subnet that address belongs to
+          description: Name associated with the subnet.
           required: false
           type: string
+  /network/l3-networks/l3-network/{network-id}/subnets/subnet/{subnet-id}/relationship-list/relationship:
     put:
       tags:
         - Network
-      summary: create or update an existing l3-interface-ipv6-address-list
-      description: create or update an existing l3-interface-ipv6-address-list
-      operationId: createOrUpdateNetworkGenericVnfsGenericVnfLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList
+      summary: see node definition for valid relationships
+      operationId: createOrUpdateNetworkL3NetworksL3NetworkSubnetsSubnetRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -25262,38 +32650,30 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id
-          in: path
-          description: Unique id of VNF.  This is unique across the graph.
-          required: true
-          type: string
-        - name: interface-name
-          in: path
-          description: Name given to the interface
-          required: true
-          type: string
-        - name: vlan-interface
+        - name: network-id
           in: path
-          description: String that identifies the interface
+          description: Network ID, should be uuid. Unique across A&AI.
           required: true
           type: string
-        - name: l3-interface-ipv6-address
+          example: __NETWORK-ID__
+        - name: subnet-id
           in: path
-          description: IP address
+          description: Subnet ID, should be UUID.
           required: true
           type: string
+          example: __SUBNET-ID__
         - name: body
           in: body
-          description: l3-interface-ipv6-address-list object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkL3NetworksL3NetworkSubnetsSubnet.json)
           required: true
           schema:
-            $ref: "#/definitions/l3-interface-ipv6-address-list"
+            $ref: "#/definitions/relationship"
     delete:
       tags:
         - Network
-      summary: delete an existing l3-interface-ipv6-address-list
-      description: delete an existing l3-interface-ipv6-address-list
-      operationId: deleteNetworkGenericVnfsGenericVnfLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList
+      summary: delete an existing relationship
+      description: delete an existing relationship
+      operationId: deleteNetworkL3NetworksL3NetworkSubnetsSubnetRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -25304,38 +32684,25 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id
-          in: path
-          description: Unique id of VNF.  This is unique across the graph.
-          required: true
-          type: string
-        - name: interface-name
-          in: path
-          description: Name given to the interface
-          required: true
-          type: string
-        - name: vlan-interface
+        - name: network-id
           in: path
-          description: String that identifies the interface
+          description: Network ID, should be uuid. Unique across A&AI.
           required: true
           type: string
-        - name: l3-interface-ipv6-address
+          example: __NETWORK-ID__
+        - name: subnet-id
           in: path
-          description: IP address
-          required: true
-          type: string
-        - name: resource-version
-          in: query
-          description: resource-version for concurrency
+          description: Subnet ID, should be UUID.
           required: true
           type: string
-  /network/generic-vnfs/generic-vnf/{vnf-id}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}:
+          example: __SUBNET-ID__
+  /network/l3-networks/l3-network/{network-id}/subnets/subnet/{subnet-id}:
     get:
       tags:
         - Network
-      summary: returns vlan
-      description: returns vlan
-      operationId: getNetworkGenericVnfsGenericVnfLInterfacesLInterfaceVlansVlan
+      summary: returns subnet
+      description: returns subnet
+      operationId: getNetworkL3NetworksL3NetworkSubnetsSubnet
       produces:
         - application/json
         - application/xml
@@ -25343,53 +32710,35 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/vlan"
+              $ref: "#/getDefinitions/subnet"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id
-          in: path
-          description: Unique id of VNF.  This is unique across the graph.
-          required: true
-          type: string
-        - name: interface-name
+        - name: network-id
           in: path
-          description: Name given to the interface
+          description: Network ID, should be uuid. Unique across A&AI.
           required: true
           type: string
-        - name: vlan-interface
+          example: __NETWORK-ID__
+        - name: subnet-id
           in: path
-          description: String that identifies the interface
+          description: Subnet ID, should be UUID.
           required: true
           type: string
-        - name: vnf-name
-          in: query
-          description: Name of VNF.
-          required: false
-          type: string
-        - name: vnf-name2
+          example: __SUBNET-ID__
+        - name: network-name
           in: query
-          description: Alternate name of VNF.
+          description: Name of the network, governed by some naming convention..
           required: false
           type: string
-        - name: vnf-type
+        - name: network-role
           in: query
-          description: String capturing type of vnf, that was intended to identify the ASDC resource.  This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures.
+          description: Role the network plans - who defines these values?
           required: false
           type: string
         - name: service-id
           in: query
-          description: Unique identifier of service, does not necessarily map to ASDC service models.  SOON TO BE DEPRECATED
-          required: false
-          type: string
-        - name: regional-resource-zone
-          in: query
-          description: Regional way of organizing pservers, source of truth should define values
-          required: false
-          type: string
-        - name: prov-status
-          in: query
-          description: Trigger for operational monitoring of this resource by Service Assurance systems.
+          description: Unique identifier of service from ASDC.  Does not strictly map to ASDC services.  SOON TO BE DEPRECATED
           required: false
           type: string
         - name: heat-stack-id
@@ -25397,14 +32746,11 @@ paths:
           description: Heat stack id corresponding to this instance, managed by MSO
           required: false
           type: string
-        - name: in-maint
-          in: query
-          required: false
-          type: boolean
-        - name: is-closed-loop-disabled
+        - name: contrail-network-fqdn
           in: query
+          description: Contrail FQDN for the network
           required: false
-          type: boolean
+          type: string
         - name: model-invariant-id
           in: query
           description: the ASDC model id for this resource or service model.
@@ -25425,58 +32771,20 @@ paths:
           description: the ASDC data dictionary version of the widget model.This maps directly to the A&AI version of the widget.
           required: false
           type: string
-        - name: nf-type
-          in: query
-          description: Generic description of the type of NF
-          required: false
-          type: string
-        - name: nf-function
-          in: query
-          description: English description of Network function that the specific VNF deployment is providing
-          required: false
-          type: string
-        - name: nf-role
-          in: query
-          description: role in the network that this model will be providing
-          required: false
-          type: string
-        - name: nf-naming-code
-          in: query
-          description: string assigned to this model used for naming purposes
-          required: false
-          type: string
-        - name: interface-id
-          in: query
-          description: ID of interface
-          required: false
-          type: string
-        - name: macaddr
-          in: query
-          description: MAC address for the interface
-          required: false
-          type: string
-        - name: network-name
-          in: query
-          description: Name of the network
-          required: false
-          type: string
-        - name: vlan-id-inner
-          in: query
-          description: Inner VLAN tag
-          required: false
-          type: integer
-          format: int64
-        - name: vpn-key
+        - name: subnet-name
           in: query
-          description: This indicates the customers VPN ID associated with this vlan
+          description: Name associated with the subnet.
           required: false
           type: string
     put:
       tags:
         - Network
-      summary: create or update an existing vlan
-      description: create or update an existing vlan
-      operationId: createOrUpdateNetworkGenericVnfsGenericVnfLInterfacesLInterfaceVlansVlan
+      summary: create or update an existing subnet
+      description: |
+        Create or update an existing subnet.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkL3NetworksL3NetworkSubnetsSubnet
       consumes:
         - application/json
         - application/xml
@@ -25487,33 +32795,75 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id
+        - name: network-id
           in: path
-          description: Unique id of VNF.  This is unique across the graph.
+          description: Network ID, should be uuid. Unique across A&AI.
           required: true
           type: string
-        - name: interface-name
+          example: __NETWORK-ID__
+        - name: subnet-id
           in: path
-          description: Name given to the interface
+          description: Subnet ID, should be UUID.
           required: true
           type: string
-        - name: vlan-interface
+          example: __SUBNET-ID__
+        - name: body
+          in: body
+          description: subnet object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkL3NetworksL3NetworkSubnetsSubnet.json)
+          required: true
+          schema:
+            $ref: "#/definitions/subnet"
+    patch:
+      tags:
+        - Network
+      summary: update an existing subnet
+      description: |
+        Update an existing subnet
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkL3NetworksL3NetworkSubnetsSubnet
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: network-id
           in: path
-          description: String that identifies the interface
+          description: Network ID, should be uuid. Unique across A&AI.
           required: true
           type: string
+          example: __NETWORK-ID__
+        - name: subnet-id
+          in: path
+          description: Subnet ID, should be UUID.
+          required: true
+          type: string
+          example: __SUBNET-ID__
         - name: body
           in: body
-          description: vlan object that needs to be created or updated
+          description: subnet object that needs to be created or updated. 
           required: true
           schema:
-            $ref: "#/definitions/vlan"
+            $ref: "#/patchDefinitions/subnet"
     delete:
       tags:
         - Network
-      summary: delete an existing vlan
-      description: delete an existing vlan
-      operationId: deleteNetworkGenericVnfsGenericVnfLInterfacesLInterfaceVlansVlan
+      summary: delete an existing subnet
+      description: delete an existing subnet
+      operationId: deleteNetworkL3NetworksL3NetworkSubnetsSubnet
       consumes:
         - application/json
         - application/xml
@@ -25524,33 +32874,30 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id
-          in: path
-          description: Unique id of VNF.  This is unique across the graph.
-          required: true
-          type: string
-        - name: interface-name
+        - name: network-id
           in: path
-          description: Name given to the interface
+          description: Network ID, should be uuid. Unique across A&AI.
           required: true
           type: string
-        - name: vlan-interface
+          example: __NETWORK-ID__
+        - name: subnet-id
           in: path
-          description: String that identifies the interface
+          description: Subnet ID, should be UUID.
           required: true
           type: string
+          example: __SUBNET-ID__
         - name: resource-version
           in: query
           description: resource-version for concurrency
           required: true
           type: string
-  /network/generic-vnfs/generic-vnf/{vnf-id}/l-interfaces/l-interface/{interface-name}/vlans:
+  /network/l3-networks/l3-network/{network-id}/subnets:
     get:
       tags:
         - Network
-      summary: returns vlans
-      description: returns vlans
-      operationId: getNetworkGenericVnfsGenericVnfLInterfacesLInterfaceVlans
+      summary: returns subnets
+      description: returns subnets
+      operationId: getNetworkL3NetworksL3NetworkSubnets
       produces:
         - application/json
         - application/xml
@@ -25558,48 +32905,29 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/vlans"
+              $ref: "#/getDefinitions/subnets"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id
-          in: path
-          description: Unique id of VNF.  This is unique across the graph.
-          required: true
-          type: string
-        - name: interface-name
+        - name: network-id
           in: path
-          description: Name given to the interface
+          description: Network ID, should be uuid. Unique across A&AI.
           required: true
           type: string
-        - name: vnf-name
-          in: query
-          description: Name of VNF.
-          required: false
-          type: string
-        - name: vnf-name2
+          example: __NETWORK-ID__
+        - name: network-name
           in: query
-          description: Alternate name of VNF.
+          description: Name of the network, governed by some naming convention..
           required: false
           type: string
-        - name: vnf-type
+        - name: network-role
           in: query
-          description: String capturing type of vnf, that was intended to identify the ASDC resource.  This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures.
+          description: Role the network plans - who defines these values?
           required: false
           type: string
         - name: service-id
           in: query
-          description: Unique identifier of service, does not necessarily map to ASDC service models.  SOON TO BE DEPRECATED
-          required: false
-          type: string
-        - name: regional-resource-zone
-          in: query
-          description: Regional way of organizing pservers, source of truth should define values
-          required: false
-          type: string
-        - name: prov-status
-          in: query
-          description: Trigger for operational monitoring of this resource by Service Assurance systems.
+          description: Unique identifier of service from ASDC.  Does not strictly map to ASDC services.  SOON TO BE DEPRECATED
           required: false
           type: string
         - name: heat-stack-id
@@ -25607,14 +32935,11 @@ paths:
           description: Heat stack id corresponding to this instance, managed by MSO
           required: false
           type: string
-        - name: in-maint
-          in: query
-          required: false
-          type: boolean
-        - name: is-closed-loop-disabled
+        - name: contrail-network-fqdn
           in: query
+          description: Contrail FQDN for the network
           required: false
-          type: boolean
+          type: string
         - name: model-invariant-id
           in: query
           description: the ASDC model id for this resource or service model.
@@ -25635,47 +32960,12 @@ paths:
           description: the ASDC data dictionary version of the widget model.This maps directly to the A&AI version of the widget.
           required: false
           type: string
-        - name: nf-type
-          in: query
-          description: Generic description of the type of NF
-          required: false
-          type: string
-        - name: nf-function
-          in: query
-          description: English description of Network function that the specific VNF deployment is providing
-          required: false
-          type: string
-        - name: nf-role
-          in: query
-          description: role in the network that this model will be providing
-          required: false
-          type: string
-        - name: nf-naming-code
-          in: query
-          description: string assigned to this model used for naming purposes
-          required: false
-          type: string
-        - name: interface-id
-          in: query
-          description: ID of interface
-          required: false
-          type: string
-        - name: macaddr
-          in: query
-          description: MAC address for the interface
-          required: false
-          type: string
-        - name: network-name
-          in: query
-          description: Name of the network
-          required: false
-          type: string
-  /network/generic-vnfs/generic-vnf/{vnf-id}/l-interfaces/l-interface/{interface-name}/sriov-vfs/sriov-vf/{pci-id}/relationship-list/relationship:
+  /network/l3-networks/l3-network/{network-id}/ctag-assignments/ctag-assignment/{vlan-id-inner}/relationship-list/relationship:
     put:
       tags:
         - Network
       summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkGenericVnfsGenericVnfLInterfacesLInterfaceSriovVfsSriovVfRelationshipListRelationship
+      operationId: createOrUpdateNetworkL3NetworksL3NetworkCtagAssignmentsCtagAssignmentRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -25686,24 +32976,22 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id
-          in: path
-          description: Unique id of VNF.  This is unique across the graph.
-          required: true
-          type: string
-        - name: interface-name
+        - name: network-id
           in: path
-          description: Name given to the interface
+          description: Network ID, should be uuid. Unique across A&AI.
           required: true
           type: string
-        - name: pci-id
+          example: __NETWORK-ID__
+        - name: vlan-id-inner
           in: path
-          description: PCI ID used to identify the sriov-vf
+          description: id.
           required: true
-          type: string
+          type: integer
+          format: int64
+          example: __VLAN-ID-INNER__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkL3NetworksL3NetworkCtagAssignmentsCtagAssignment.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -25712,7 +33000,7 @@ paths:
         - Network
       summary: delete an existing relationship
       description: delete an existing relationship
-      operationId: deleteNetworkGenericVnfsGenericVnfLInterfacesLInterfaceSriovVfsSriovVfRelationshipListRelationship
+      operationId: deleteNetworkL3NetworksL3NetworkCtagAssignmentsCtagAssignmentRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -25723,28 +33011,26 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id
-          in: path
-          description: Unique id of VNF.  This is unique across the graph.
-          required: true
-          type: string
-        - name: interface-name
+        - name: network-id
           in: path
-          description: Name given to the interface
+          description: Network ID, should be uuid. Unique across A&AI.
           required: true
           type: string
-        - name: pci-id
+          example: __NETWORK-ID__
+        - name: vlan-id-inner
           in: path
-          description: PCI ID used to identify the sriov-vf
+          description: id.
           required: true
-          type: string
-  /network/generic-vnfs/generic-vnf/{vnf-id}/l-interfaces/l-interface/{interface-name}/sriov-vfs/sriov-vf/{pci-id}:
+          type: integer
+          format: int64
+          example: __VLAN-ID-INNER__
+  /network/l3-networks/l3-network/{network-id}/ctag-assignments/ctag-assignment/{vlan-id-inner}:
     get:
       tags:
         - Network
-      summary: returns sriov-vf
-      description: returns sriov-vf
-      operationId: getNetworkGenericVnfsGenericVnfLInterfacesLInterfaceSriovVfsSriovVf
+      summary: returns ctag-assignment
+      description: returns ctag-assignment
+      operationId: getNetworkL3NetworksL3NetworkCtagAssignmentsCtagAssignment
       produces:
         - application/json
         - application/xml
@@ -25752,53 +33038,36 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/sriov-vf"
+              $ref: "#/getDefinitions/ctag-assignment"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id
-          in: path
-          description: Unique id of VNF.  This is unique across the graph.
-          required: true
-          type: string
-        - name: interface-name
+        - name: network-id
           in: path
-          description: Name given to the interface
+          description: Network ID, should be uuid. Unique across A&AI.
           required: true
           type: string
-        - name: pci-id
+          example: __NETWORK-ID__
+        - name: vlan-id-inner
           in: path
-          description: PCI ID used to identify the sriov-vf
+          description: id.
           required: true
-          type: string
-        - name: vnf-name
-          in: query
-          description: Name of VNF.
-          required: false
-          type: string
-        - name: vnf-name2
+          type: integer
+          format: int64
+          example: __VLAN-ID-INNER__
+        - name: network-name
           in: query
-          description: Alternate name of VNF.
+          description: Name of the network, governed by some naming convention..
           required: false
           type: string
-        - name: vnf-type
+        - name: network-role
           in: query
-          description: String capturing type of vnf, that was intended to identify the ASDC resource.  This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures.
+          description: Role the network plans - who defines these values?
           required: false
           type: string
         - name: service-id
           in: query
-          description: Unique identifier of service, does not necessarily map to ASDC service models.  SOON TO BE DEPRECATED
-          required: false
-          type: string
-        - name: regional-resource-zone
-          in: query
-          description: Regional way of organizing pservers, source of truth should define values
-          required: false
-          type: string
-        - name: prov-status
-          in: query
-          description: Trigger for operational monitoring of this resource by Service Assurance systems.
+          description: Unique identifier of service from ASDC.  Does not strictly map to ASDC services.  SOON TO BE DEPRECATED
           required: false
           type: string
         - name: heat-stack-id
@@ -25806,14 +33075,11 @@ paths:
           description: Heat stack id corresponding to this instance, managed by MSO
           required: false
           type: string
-        - name: in-maint
-          in: query
-          required: false
-          type: boolean
-        - name: is-closed-loop-disabled
+        - name: contrail-network-fqdn
           in: query
+          description: Contrail FQDN for the network
           required: false
-          type: boolean
+          type: string
         - name: model-invariant-id
           in: query
           description: the ASDC model id for this resource or service model.
@@ -25834,67 +33100,15 @@ paths:
           description: the ASDC data dictionary version of the widget model.This maps directly to the A&AI version of the widget.
           required: false
           type: string
-        - name: nf-type
-          in: query
-          description: Generic description of the type of NF
-          required: false
-          type: string
-        - name: nf-function
-          in: query
-          description: English description of Network function that the specific VNF deployment is providing
-          required: false
-          type: string
-        - name: nf-role
-          in: query
-          description: role in the network that this model will be providing
-          required: false
-          type: string
-        - name: nf-naming-code
-          in: query
-          description: string assigned to this model used for naming purposes
-          required: false
-          type: string
-        - name: interface-id
-          in: query
-          description: ID of interface
-          required: false
-          type: string
-        - name: macaddr
-          in: query
-          description: MAC address for the interface
-          required: false
-          type: string
-        - name: network-name
-          in: query
-          description: Name of the network
-          required: false
-          type: string
-        - name: vf-vlan-filter
-          in: query
-          description: This metadata provides option to specify list of VLAN filters applied on VF to pass the traffic to VM.
-          required: false
-          type: string
-        - name: vf-mac-filter
-          in: query
-          description: When MAC filters are specified, VF-agent service configures VFs to do MAC level filtering before the traffic is passed to VM.
-          required: false
-          type: string
-        - name: vf-vlan-strip
-          in: query
-          description: When this field is set to true, VF will configured to strip the outer TAG before the traffic is passed to VM.
-          required: false
-          type: boolean
-        - name: neutron-network-id
-          in: query
-          description: Neutron network id of the interface
-          required: false
-          type: string
     put:
       tags:
         - Network
-      summary: create or update an existing sriov-vf
-      description: create or update an existing sriov-vf
-      operationId: createOrUpdateNetworkGenericVnfsGenericVnfLInterfacesLInterfaceSriovVfsSriovVf
+      summary: create or update an existing ctag-assignment
+      description: |
+        Create or update an existing ctag-assignment.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkL3NetworksL3NetworkCtagAssignmentsCtagAssignment
       consumes:
         - application/json
         - application/xml
@@ -25905,33 +33119,42 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id
-          in: path
-          description: Unique id of VNF.  This is unique across the graph.
-          required: true
-          type: string
-        - name: interface-name
+        - name: network-id
           in: path
-          description: Name given to the interface
+          description: Network ID, should be uuid. Unique across A&AI.
           required: true
           type: string
-        - name: pci-id
+          example: __NETWORK-ID__
+        - name: vlan-id-inner
           in: path
-          description: PCI ID used to identify the sriov-vf
+          description: id.
           required: true
-          type: string
+          type: integer
+          format: int64
+          example: __VLAN-ID-INNER__
         - name: body
           in: body
-          description: sriov-vf object that needs to be created or updated
+          description: ctag-assignment object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkL3NetworksL3NetworkCtagAssignmentsCtagAssignment.json)
           required: true
           schema:
-            $ref: "#/definitions/sriov-vf"
-    delete:
+            $ref: "#/definitions/ctag-assignment"
+    patch:
       tags:
         - Network
-      summary: delete an existing sriov-vf
-      description: delete an existing sriov-vf
-      operationId: deleteNetworkGenericVnfsGenericVnfLInterfacesLInterfaceSriovVfsSriovVf
+      summary: update an existing ctag-assignment
+      description: |
+        Update an existing ctag-assignment
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkL3NetworksL3NetworkCtagAssignmentsCtagAssignment
       consumes:
         - application/json
         - application/xml
@@ -25942,82 +33165,96 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id
-          in: path
-          description: Unique id of VNF.  This is unique across the graph.
-          required: true
-          type: string
-        - name: interface-name
+        - name: network-id
           in: path
-          description: Name given to the interface
+          description: Network ID, should be uuid. Unique across A&AI.
           required: true
           type: string
-        - name: pci-id
+          example: __NETWORK-ID__
+        - name: vlan-id-inner
           in: path
-          description: PCI ID used to identify the sriov-vf
+          description: id.
           required: true
-          type: string
-        - name: resource-version
-          in: query
-          description: resource-version for concurrency
+          type: integer
+          format: int64
+          example: __VLAN-ID-INNER__
+        - name: body
+          in: body
+          description: ctag-assignment object that needs to be created or updated. 
           required: true
-          type: string
-  /network/generic-vnfs/generic-vnf/{vnf-id}/l-interfaces/l-interface/{interface-name}/sriov-vfs:
-    get:
+          schema:
+            $ref: "#/patchDefinitions/ctag-assignment"
+    delete:
       tags:
         - Network
-      summary: returns sriov-vfs
-      description: returns sriov-vfs
-      operationId: getNetworkGenericVnfsGenericVnfLInterfacesLInterfaceSriovVfs
+      summary: delete an existing ctag-assignment
+      description: delete an existing ctag-assignment
+      operationId: deleteNetworkL3NetworksL3NetworkCtagAssignmentsCtagAssignment
+      consumes:
+        - application/json
+        - application/xml
       produces:
         - application/json
         - application/xml
       responses:
-        "200":
-          description: successful operation
-          schema:
-              $ref: "#/definitions/sriov-vfs"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id
+        - name: network-id
           in: path
-          description: Unique id of VNF.  This is unique across the graph.
+          description: Network ID, should be uuid. Unique across A&AI.
           required: true
           type: string
-        - name: interface-name
+          example: __NETWORK-ID__
+        - name: vlan-id-inner
           in: path
-          description: Name given to the interface
+          description: id.
           required: true
-          type: string
-        - name: vnf-name
-          in: query
-          description: Name of VNF.
-          required: false
-          type: string
-        - name: vnf-name2
+          type: integer
+          format: int64
+          example: __VLAN-ID-INNER__
+        - name: resource-version
           in: query
-          description: Alternate name of VNF.
-          required: false
+          description: resource-version for concurrency
+          required: true
           type: string
-        - name: vnf-type
-          in: query
-          description: String capturing type of vnf, that was intended to identify the ASDC resource.  This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures.
-          required: false
+  /network/l3-networks/l3-network/{network-id}/ctag-assignments:
+    get:
+      tags:
+        - Network
+      summary: returns ctag-assignments
+      description: returns ctag-assignments
+      operationId: getNetworkL3NetworksL3NetworkCtagAssignments
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "200":
+          description: successful operation
+          schema:
+              $ref: "#/getDefinitions/ctag-assignments"
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: network-id
+          in: path
+          description: Network ID, should be uuid. Unique across A&AI.
+          required: true
           type: string
-        - name: service-id
+          example: __NETWORK-ID__
+        - name: network-name
           in: query
-          description: Unique identifier of service, does not necessarily map to ASDC service models.  SOON TO BE DEPRECATED
+          description: Name of the network, governed by some naming convention..
           required: false
           type: string
-        - name: regional-resource-zone
+        - name: network-role
           in: query
-          description: Regional way of organizing pservers, source of truth should define values
+          description: Role the network plans - who defines these values?
           required: false
           type: string
-        - name: prov-status
+        - name: service-id
           in: query
-          description: Trigger for operational monitoring of this resource by Service Assurance systems.
+          description: Unique identifier of service from ASDC.  Does not strictly map to ASDC services.  SOON TO BE DEPRECATED
           required: false
           type: string
         - name: heat-stack-id
@@ -26025,14 +33262,11 @@ paths:
           description: Heat stack id corresponding to this instance, managed by MSO
           required: false
           type: string
-        - name: in-maint
-          in: query
-          required: false
-          type: boolean
-        - name: is-closed-loop-disabled
+        - name: contrail-network-fqdn
           in: query
+          description: Contrail FQDN for the network
           required: false
-          type: boolean
+          type: string
         - name: model-invariant-id
           in: query
           description: the ASDC model id for this resource or service model.
@@ -26053,47 +33287,12 @@ paths:
           description: the ASDC data dictionary version of the widget model.This maps directly to the A&AI version of the widget.
           required: false
           type: string
-        - name: nf-type
-          in: query
-          description: Generic description of the type of NF
-          required: false
-          type: string
-        - name: nf-function
-          in: query
-          description: English description of Network function that the specific VNF deployment is providing
-          required: false
-          type: string
-        - name: nf-role
-          in: query
-          description: role in the network that this model will be providing
-          required: false
-          type: string
-        - name: nf-naming-code
-          in: query
-          description: string assigned to this model used for naming purposes
-          required: false
-          type: string
-        - name: interface-id
-          in: query
-          description: ID of interface
-          required: false
-          type: string
-        - name: macaddr
-          in: query
-          description: MAC address for the interface
-          required: false
-          type: string
-        - name: network-name
-          in: query
-          description: Name of the network
-          required: false
-          type: string
-  /network/generic-vnfs/generic-vnf/{vnf-id}/l-interfaces/l-interface/{interface-name}/relationship-list/relationship:
+  /network/l3-networks/l3-network/{network-id}/segmentation-assignments/segmentation-assignment/{segmentation-id}/relationship-list/relationship:
     put:
       tags:
         - Network
       summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkGenericVnfsGenericVnfLInterfacesLInterfaceRelationshipListRelationship
+      operationId: createOrUpdateNetworkL3NetworksL3NetworkSegmentationAssignmentsSegmentationAssignmentRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -26104,19 +33303,21 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id
+        - name: network-id
           in: path
-          description: Unique id of VNF.  This is unique across the graph.
+          description: Network ID, should be uuid. Unique across A&AI.
           required: true
           type: string
-        - name: interface-name
+          example: __NETWORK-ID__
+        - name: segmentation-id
           in: path
-          description: Name given to the interface
+          description: Route Table Reference id, UUID assigned to this instance.
           required: true
           type: string
+          example: __SEGMENTATION-ID__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkL3NetworksL3NetworkSegmentationAssignmentsSegmentationAssignment.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -26125,7 +33326,7 @@ paths:
         - Network
       summary: delete an existing relationship
       description: delete an existing relationship
-      operationId: deleteNetworkGenericVnfsGenericVnfLInterfacesLInterfaceRelationshipListRelationship
+      operationId: deleteNetworkL3NetworksL3NetworkSegmentationAssignmentsSegmentationAssignmentRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -26136,22 +33337,102 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id
+        - name: network-id
           in: path
-          description: Unique id of VNF.  This is unique across the graph.
+          description: Network ID, should be uuid. Unique across A&AI.
           required: true
           type: string
-        - name: interface-name
+          example: __NETWORK-ID__
+        - name: segmentation-id
           in: path
-          description: Name given to the interface
+          description: Route Table Reference id, UUID assigned to this instance.
           required: true
           type: string
-  /network/generic-vnfs/generic-vnf/{vnf-id}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}/relationship-list/relationship:
+          example: __SEGMENTATION-ID__
+  /network/l3-networks/l3-network/{network-id}/segmentation-assignments/segmentation-assignment/{segmentation-id}:
+    get:
+      tags:
+        - Network
+      summary: returns segmentation-assignment
+      description: returns segmentation-assignment
+      operationId: getNetworkL3NetworksL3NetworkSegmentationAssignmentsSegmentationAssignment
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "200":
+          description: successful operation
+          schema:
+              $ref: "#/getDefinitions/segmentation-assignment"
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: network-id
+          in: path
+          description: Network ID, should be uuid. Unique across A&AI.
+          required: true
+          type: string
+          example: __NETWORK-ID__
+        - name: segmentation-id
+          in: path
+          description: Route Table Reference id, UUID assigned to this instance.
+          required: true
+          type: string
+          example: __SEGMENTATION-ID__
+        - name: network-name
+          in: query
+          description: Name of the network, governed by some naming convention..
+          required: false
+          type: string
+        - name: network-role
+          in: query
+          description: Role the network plans - who defines these values?
+          required: false
+          type: string
+        - name: service-id
+          in: query
+          description: Unique identifier of service from ASDC.  Does not strictly map to ASDC services.  SOON TO BE DEPRECATED
+          required: false
+          type: string
+        - name: heat-stack-id
+          in: query
+          description: Heat stack id corresponding to this instance, managed by MSO
+          required: false
+          type: string
+        - name: contrail-network-fqdn
+          in: query
+          description: Contrail FQDN for the network
+          required: false
+          type: string
+        - name: model-invariant-id
+          in: query
+          description: the ASDC model id for this resource or service model.
+          required: false
+          type: string
+        - name: model-version-id
+          in: query
+          description: the ASDC model version for this resource or service model.
+          required: false
+          type: string
+        - name: widget-model-id
+          in: query
+          description: the ASDC data dictionary widget model. This maps directly to the A&AI widget.
+          required: false
+          type: string
+        - name: widget-model-version
+          in: query
+          description: the ASDC data dictionary version of the widget model.This maps directly to the A&AI version of the widget.
+          required: false
+          type: string
     put:
       tags:
         - Network
-      summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkGenericVnfsGenericVnfLInterfacesLInterfaceL3InterfaceIpv4AddressListRelationshipListRelationship
+      summary: create or update an existing segmentation-assignment
+      description: |
+        Create or update an existing segmentation-assignment.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkL3NetworksL3NetworkSegmentationAssignmentsSegmentationAssignment
       consumes:
         - application/json
         - application/xml
@@ -26162,33 +33443,75 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id
+        - name: network-id
           in: path
-          description: Unique id of VNF.  This is unique across the graph.
+          description: Network ID, should be uuid. Unique across A&AI.
           required: true
           type: string
-        - name: interface-name
+          example: __NETWORK-ID__
+        - name: segmentation-id
           in: path
-          description: Name given to the interface
+          description: Route Table Reference id, UUID assigned to this instance.
           required: true
           type: string
-        - name: l3-interface-ipv4-address
+          example: __SEGMENTATION-ID__
+        - name: body
+          in: body
+          description: segmentation-assignment object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkL3NetworksL3NetworkSegmentationAssignmentsSegmentationAssignment.json)
+          required: true
+          schema:
+            $ref: "#/definitions/segmentation-assignment"
+    patch:
+      tags:
+        - Network
+      summary: update an existing segmentation-assignment
+      description: |
+        Update an existing segmentation-assignment
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkL3NetworksL3NetworkSegmentationAssignmentsSegmentationAssignment
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: network-id
           in: path
-          description: IP address
+          description: Network ID, should be uuid. Unique across A&AI.
+          required: true
+          type: string
+          example: __NETWORK-ID__
+        - name: segmentation-id
+          in: path
+          description: Route Table Reference id, UUID assigned to this instance.
           required: true
           type: string
+          example: __SEGMENTATION-ID__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: segmentation-assignment object that needs to be created or updated. 
           required: true
           schema:
-            $ref: "#/definitions/relationship"
+            $ref: "#/patchDefinitions/segmentation-assignment"
     delete:
       tags:
         - Network
-      summary: delete an existing relationship
-      description: delete an existing relationship
-      operationId: deleteNetworkGenericVnfsGenericVnfLInterfacesLInterfaceL3InterfaceIpv4AddressListRelationshipListRelationship
+      summary: delete an existing segmentation-assignment
+      description: delete an existing segmentation-assignment
+      operationId: deleteNetworkL3NetworksL3NetworkSegmentationAssignmentsSegmentationAssignment
       consumes:
         - application/json
         - application/xml
@@ -26199,28 +33522,30 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id
+        - name: network-id
           in: path
-          description: Unique id of VNF.  This is unique across the graph.
+          description: Network ID, should be uuid. Unique across A&AI.
           required: true
           type: string
-        - name: interface-name
+          example: __NETWORK-ID__
+        - name: segmentation-id
           in: path
-          description: Name given to the interface
+          description: Route Table Reference id, UUID assigned to this instance.
           required: true
           type: string
-        - name: l3-interface-ipv4-address
-          in: path
-          description: IP address
+          example: __SEGMENTATION-ID__
+        - name: resource-version
+          in: query
+          description: resource-version for concurrency
           required: true
           type: string
-  /network/generic-vnfs/generic-vnf/{vnf-id}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}:
+  /network/l3-networks/l3-network/{network-id}/segmentation-assignments:
     get:
       tags:
         - Network
-      summary: returns l3-interface-ipv4-address-list
-      description: returns l3-interface-ipv4-address-list
-      operationId: getNetworkGenericVnfsGenericVnfLInterfacesLInterfaceL3InterfaceIpv4AddressList
+      summary: returns segmentation-assignments
+      description: returns segmentation-assignments
+      operationId: getNetworkL3NetworksL3NetworkSegmentationAssignments
       produces:
         - application/json
         - application/xml
@@ -26228,53 +33553,29 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/l3-interface-ipv4-address-list"
+              $ref: "#/getDefinitions/segmentation-assignments"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id
-          in: path
-          description: Unique id of VNF.  This is unique across the graph.
-          required: true
-          type: string
-        - name: interface-name
-          in: path
-          description: Name given to the interface
-          required: true
-          type: string
-        - name: l3-interface-ipv4-address
+        - name: network-id
           in: path
-          description: IP address
+          description: Network ID, should be uuid. Unique across A&AI.
           required: true
           type: string
-        - name: vnf-name
-          in: query
-          description: Name of VNF.
-          required: false
-          type: string
-        - name: vnf-name2
+          example: __NETWORK-ID__
+        - name: network-name
           in: query
-          description: Alternate name of VNF.
+          description: Name of the network, governed by some naming convention..
           required: false
           type: string
-        - name: vnf-type
+        - name: network-role
           in: query
-          description: String capturing type of vnf, that was intended to identify the ASDC resource.  This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures.
+          description: Role the network plans - who defines these values?
           required: false
           type: string
         - name: service-id
           in: query
-          description: Unique identifier of service, does not necessarily map to ASDC service models.  SOON TO BE DEPRECATED
-          required: false
-          type: string
-        - name: regional-resource-zone
-          in: query
-          description: Regional way of organizing pservers, source of truth should define values
-          required: false
-          type: string
-        - name: prov-status
-          in: query
-          description: Trigger for operational monitoring of this resource by Service Assurance systems.
+          description: Unique identifier of service from ASDC.  Does not strictly map to ASDC services.  SOON TO BE DEPRECATED
           required: false
           type: string
         - name: heat-stack-id
@@ -26282,14 +33583,11 @@ paths:
           description: Heat stack id corresponding to this instance, managed by MSO
           required: false
           type: string
-        - name: in-maint
-          in: query
-          required: false
-          type: boolean
-        - name: is-closed-loop-disabled
+        - name: contrail-network-fqdn
           in: query
+          description: Contrail FQDN for the network
           required: false
-          type: boolean
+          type: string
         - name: model-invariant-id
           in: query
           description: the ASDC model id for this resource or service model.
@@ -26310,63 +33608,134 @@ paths:
           description: the ASDC data dictionary version of the widget model.This maps directly to the A&AI version of the widget.
           required: false
           type: string
-        - name: nf-type
-          in: query
-          description: Generic description of the type of NF
-          required: false
+  /network/l3-networks/l3-network/{network-id}/relationship-list/relationship:
+    put:
+      tags:
+        - Network
+      summary: see node definition for valid relationships
+      operationId: createOrUpdateNetworkL3NetworksL3NetworkRelationshipListRelationship
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: network-id
+          in: path
+          description: Network ID, should be uuid. Unique across A&AI.
+          required: true
           type: string
-        - name: nf-function
+          example: __NETWORK-ID__
+        - name: body
+          in: body
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkL3NetworksL3Network.json)
+          required: true
+          schema:
+            $ref: "#/definitions/relationship"
+    delete:
+      tags:
+        - Network
+      summary: delete an existing relationship
+      description: delete an existing relationship
+      operationId: deleteNetworkL3NetworksL3NetworkRelationshipListRelationship
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: network-id
+          in: path
+          description: Network ID, should be uuid. Unique across A&AI.
+          required: true
+          type: string
+          example: __NETWORK-ID__
+  /network/l3-networks/l3-network/{network-id}:
+    get:
+      tags:
+        - Network
+      summary: returns l3-network
+      description: returns l3-network
+      operationId: getNetworkL3NetworksL3Network
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "200":
+          description: successful operation
+          schema:
+              $ref: "#/getDefinitions/l3-network"
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: network-id
+          in: path
+          description: Network ID, should be uuid. Unique across A&AI.
+          required: true
+          type: string
+          example: __NETWORK-ID__
+        - name: network-name
           in: query
-          description: English description of Network function that the specific VNF deployment is providing
+          description: Name of the network, governed by some naming convention..
           required: false
           type: string
-        - name: nf-role
+        - name: network-role
           in: query
-          description: role in the network that this model will be providing
+          description: Role the network plans - who defines these values?
           required: false
           type: string
-        - name: nf-naming-code
+        - name: service-id
           in: query
-          description: string assigned to this model used for naming purposes
+          description: Unique identifier of service from ASDC.  Does not strictly map to ASDC services.  SOON TO BE DEPRECATED
           required: false
           type: string
-        - name: interface-id
+        - name: heat-stack-id
           in: query
-          description: ID of interface
+          description: Heat stack id corresponding to this instance, managed by MSO
           required: false
           type: string
-        - name: macaddr
+        - name: contrail-network-fqdn
           in: query
-          description: MAC address for the interface
+          description: Contrail FQDN for the network
           required: false
           type: string
-        - name: network-name
+        - name: model-invariant-id
           in: query
-          description: Name of the network
+          description: the ASDC model id for this resource or service model.
           required: false
           type: string
-        - name: vlan-id-inner
+        - name: model-version-id
           in: query
-          description: Inner VLAN tag
+          description: the ASDC model version for this resource or service model.
           required: false
-          type: integer
-          format: int64
-        - name: neutron-network-id
+          type: string
+        - name: widget-model-id
           in: query
-          description: Neutron network id of the interface that address belongs to
+          description: the ASDC data dictionary widget model. This maps directly to the A&AI widget.
           required: false
           type: string
-        - name: neutron-subnet-id
+        - name: widget-model-version
           in: query
-          description: Neutron id of subnet that address belongs to
+          description: the ASDC data dictionary version of the widget model.This maps directly to the A&AI version of the widget.
           required: false
           type: string
     put:
       tags:
         - Network
-      summary: create or update an existing l3-interface-ipv4-address-list
-      description: create or update an existing l3-interface-ipv4-address-list
-      operationId: createOrUpdateNetworkGenericVnfsGenericVnfLInterfacesLInterfaceL3InterfaceIpv4AddressList
+      summary: create or update an existing l3-network
+      description: |
+        Create or update an existing l3-network.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkL3NetworksL3Network
       consumes:
         - application/json
         - application/xml
@@ -26377,33 +33746,63 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id
+        - name: network-id
           in: path
-          description: Unique id of VNF.  This is unique across the graph.
+          description: Network ID, should be uuid. Unique across A&AI.
           required: true
           type: string
-        - name: interface-name
-          in: path
-          description: Name given to the interface
+          example: __NETWORK-ID__
+        - name: body
+          in: body
+          description: l3-network object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkL3NetworksL3Network.json)
           required: true
-          type: string
-        - name: l3-interface-ipv4-address
+          schema:
+            $ref: "#/definitions/l3-network"
+    patch:
+      tags:
+        - Network
+      summary: update an existing l3-network
+      description: |
+        Update an existing l3-network
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkL3NetworksL3Network
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: network-id
           in: path
-          description: IP address
+          description: Network ID, should be uuid. Unique across A&AI.
           required: true
           type: string
+          example: __NETWORK-ID__
         - name: body
           in: body
-          description: l3-interface-ipv4-address-list object that needs to be created or updated
+          description: l3-network object that needs to be created or updated. 
           required: true
           schema:
-            $ref: "#/definitions/l3-interface-ipv4-address-list"
+            $ref: "#/patchDefinitions/l3-network"
     delete:
       tags:
         - Network
-      summary: delete an existing l3-interface-ipv4-address-list
-      description: delete an existing l3-interface-ipv4-address-list
-      operationId: deleteNetworkGenericVnfsGenericVnfLInterfacesLInterfaceL3InterfaceIpv4AddressList
+      summary: delete an existing l3-network
+      description: delete an existing l3-network
+      operationId: deleteNetworkL3NetworksL3Network
       consumes:
         - application/json
         - application/xml
@@ -26414,32 +33813,40 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id
-          in: path
-          description: Unique id of VNF.  This is unique across the graph.
-          required: true
-          type: string
-        - name: interface-name
-          in: path
-          description: Name given to the interface
-          required: true
-          type: string
-        - name: l3-interface-ipv4-address
+        - name: network-id
           in: path
-          description: IP address
+          description: Network ID, should be uuid. Unique across A&AI.
           required: true
           type: string
+          example: __NETWORK-ID__
         - name: resource-version
           in: query
           description: resource-version for concurrency
           required: true
           type: string
-  /network/generic-vnfs/generic-vnf/{vnf-id}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}/relationship-list/relationship:
+  /network/l3-networks:
+    get:
+      tags:
+        - Network
+      summary: returns l3-networks
+      description: returns l3-networks
+      operationId: getNetworkL3Networks
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "200":
+          description: successful operation
+          schema:
+              $ref: "#/getDefinitions/l3-networks"
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+  /network/network-policies/network-policy/{network-policy-id}/relationship-list/relationship:
     put:
       tags:
         - Network
       summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkGenericVnfsGenericVnfLInterfacesLInterfaceL3InterfaceIpv6AddressListRelationshipListRelationship
+      operationId: createOrUpdateNetworkNetworkPoliciesNetworkPolicyRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -26450,24 +33857,15 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id
-          in: path
-          description: Unique id of VNF.  This is unique across the graph.
-          required: true
-          type: string
-        - name: interface-name
-          in: path
-          description: Name given to the interface
-          required: true
-          type: string
-        - name: l3-interface-ipv6-address
+        - name: network-policy-id
           in: path
-          description: IP address
+          description: UUID representing unique key to this instance
           required: true
           type: string
+          example: __NETWORK-POLICY-ID__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkNetworkPoliciesNetworkPolicy.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -26476,7 +33874,7 @@ paths:
         - Network
       summary: delete an existing relationship
       description: delete an existing relationship
-      operationId: deleteNetworkGenericVnfsGenericVnfLInterfacesLInterfaceL3InterfaceIpv6AddressListRelationshipListRelationship
+      operationId: deleteNetworkNetworkPoliciesNetworkPolicyRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -26487,28 +33885,19 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id
-          in: path
-          description: Unique id of VNF.  This is unique across the graph.
-          required: true
-          type: string
-        - name: interface-name
-          in: path
-          description: Name given to the interface
-          required: true
-          type: string
-        - name: l3-interface-ipv6-address
+        - name: network-policy-id
           in: path
-          description: IP address
+          description: UUID representing unique key to this instance
           required: true
           type: string
-  /network/generic-vnfs/generic-vnf/{vnf-id}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}:
+          example: __NETWORK-POLICY-ID__
+  /network/network-policies/network-policy/{network-policy-id}:
     get:
       tags:
         - Network
-      summary: returns l3-interface-ipv6-address-list
-      description: returns l3-interface-ipv6-address-list
-      operationId: getNetworkGenericVnfsGenericVnfLInterfacesLInterfaceL3InterfaceIpv6AddressList
+      summary: returns network-policy
+      description: returns network-policy
+      operationId: getNetworkNetworkPoliciesNetworkPolicy
       produces:
         - application/json
         - application/xml
@@ -26516,145 +33905,30 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/l3-interface-ipv6-address-list"
+              $ref: "#/getDefinitions/network-policy"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id
-          in: path
-          description: Unique id of VNF.  This is unique across the graph.
-          required: true
-          type: string
-        - name: interface-name
-          in: path
-          description: Name given to the interface
-          required: true
-          type: string
-        - name: l3-interface-ipv6-address
+        - name: network-policy-id
           in: path
-          description: IP address
+          description: UUID representing unique key to this instance
           required: true
           type: string
-        - name: vnf-name
-          in: query
-          description: Name of VNF.
-          required: false
-          type: string
-        - name: vnf-name2
-          in: query
-          description: Alternate name of VNF.
-          required: false
-          type: string
-        - name: vnf-type
-          in: query
-          description: String capturing type of vnf, that was intended to identify the ASDC resource.  This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures.
-          required: false
-          type: string
-        - name: service-id
-          in: query
-          description: Unique identifier of service, does not necessarily map to ASDC service models.  SOON TO BE DEPRECATED
-          required: false
-          type: string
-        - name: regional-resource-zone
-          in: query
-          description: Regional way of organizing pservers, source of truth should define values
-          required: false
-          type: string
-        - name: prov-status
-          in: query
-          description: Trigger for operational monitoring of this resource by Service Assurance systems.
-          required: false
-          type: string
-        - name: heat-stack-id
-          in: query
-          description: Heat stack id corresponding to this instance, managed by MSO
-          required: false
-          type: string
-        - name: in-maint
-          in: query
-          required: false
-          type: boolean
-        - name: is-closed-loop-disabled
-          in: query
-          required: false
-          type: boolean
-        - name: model-invariant-id
-          in: query
-          description: the ASDC model id for this resource or service model.
-          required: false
-          type: string
-        - name: model-version-id
-          in: query
-          description: the ASDC model version for this resource or service model.
-          required: false
-          type: string
-        - name: widget-model-id
-          in: query
-          description: the ASDC data dictionary widget model. This maps directly to the A&AI widget.
-          required: false
-          type: string
-        - name: widget-model-version
-          in: query
-          description: the ASDC data dictionary version of the widget model.This maps directly to the A&AI version of the widget.
-          required: false
-          type: string
-        - name: nf-type
-          in: query
-          description: Generic description of the type of NF
-          required: false
-          type: string
-        - name: nf-function
-          in: query
-          description: English description of Network function that the specific VNF deployment is providing
-          required: false
-          type: string
-        - name: nf-role
-          in: query
-          description: role in the network that this model will be providing
-          required: false
-          type: string
-        - name: nf-naming-code
-          in: query
-          description: string assigned to this model used for naming purposes
-          required: false
-          type: string
-        - name: interface-id
-          in: query
-          description: ID of interface
-          required: false
-          type: string
-        - name: macaddr
-          in: query
-          description: MAC address for the interface
-          required: false
-          type: string
-        - name: network-name
-          in: query
-          description: Name of the network
-          required: false
-          type: string
-        - name: vlan-id-inner
-          in: query
-          description: Inner VLAN tag
-          required: false
-          type: integer
-          format: int64
-        - name: neutron-network-id
-          in: query
-          description: Neutron network id of the interface that address belongs to
-          required: false
-          type: string
-        - name: neutron-subnet-id
+          example: __NETWORK-POLICY-ID__
+        - name: network-policy-fqdn
           in: query
-          description: Neutron id of subnet that address belongs to
+          description: Contrail FQDN for the policy
           required: false
           type: string
     put:
       tags:
         - Network
-      summary: create or update an existing l3-interface-ipv6-address-list
-      description: create or update an existing l3-interface-ipv6-address-list
-      operationId: createOrUpdateNetworkGenericVnfsGenericVnfLInterfacesLInterfaceL3InterfaceIpv6AddressList
+      summary: create or update an existing network-policy
+      description: |
+        Create or update an existing network-policy.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkNetworkPoliciesNetworkPolicy
       consumes:
         - application/json
         - application/xml
@@ -26665,195 +33939,35 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id
-          in: path
-          description: Unique id of VNF.  This is unique across the graph.
-          required: true
-          type: string
-        - name: interface-name
-          in: path
-          description: Name given to the interface
-          required: true
-          type: string
-        - name: l3-interface-ipv6-address
+        - name: network-policy-id
           in: path
-          description: IP address
+          description: UUID representing unique key to this instance
           required: true
           type: string
+          example: __NETWORK-POLICY-ID__
         - name: body
           in: body
-          description: l3-interface-ipv6-address-list object that needs to be created or updated
-          required: true
-          schema:
-            $ref: "#/definitions/l3-interface-ipv6-address-list"
-    delete:
-      tags:
-        - Network
-      summary: delete an existing l3-interface-ipv6-address-list
-      description: delete an existing l3-interface-ipv6-address-list
-      operationId: deleteNetworkGenericVnfsGenericVnfLInterfacesLInterfaceL3InterfaceIpv6AddressList
-      consumes:
-        - application/json
-        - application/xml
-      produces:
-        - application/json
-        - application/xml
-      responses:
-        "default":
-          description: Response codes found in [response codes](https://wiki.onap.org/).
-      parameters:
-        - name: vnf-id
-          in: path
-          description: Unique id of VNF.  This is unique across the graph.
-          required: true
-          type: string
-        - name: interface-name
-          in: path
-          description: Name given to the interface
-          required: true
-          type: string
-        - name: l3-interface-ipv6-address
-          in: path
-          description: IP address
-          required: true
-          type: string
-        - name: resource-version
-          in: query
-          description: resource-version for concurrency
+          description: network-policy object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkNetworkPoliciesNetworkPolicy.json)
           required: true
-          type: string
-  /network/generic-vnfs/generic-vnf/{vnf-id}/l-interfaces/l-interface/{interface-name}:
-    get:
-      tags:
-        - Network
-      summary: returns l-interface
-      description: returns l-interface
-      operationId: getNetworkGenericVnfsGenericVnfLInterfacesLInterface
-      produces:
-        - application/json
-        - application/xml
-      responses:
-        "200":
-          description: successful operation
           schema:
-              $ref: "#/definitions/l-interface"
-        "default":
-          description: Response codes found in [response codes](https://wiki.onap.org/).
-      parameters:
-        - name: vnf-id
-          in: path
-          description: Unique id of VNF.  This is unique across the graph.
-          required: true
-          type: string
-        - name: interface-name
-          in: path
-          description: Name given to the interface
-          required: true
-          type: string
-        - name: vnf-name
-          in: query
-          description: Name of VNF.
-          required: false
-          type: string
-        - name: vnf-name2
-          in: query
-          description: Alternate name of VNF.
-          required: false
-          type: string
-        - name: vnf-type
-          in: query
-          description: String capturing type of vnf, that was intended to identify the ASDC resource.  This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures.
-          required: false
-          type: string
-        - name: service-id
-          in: query
-          description: Unique identifier of service, does not necessarily map to ASDC service models.  SOON TO BE DEPRECATED
-          required: false
-          type: string
-        - name: regional-resource-zone
-          in: query
-          description: Regional way of organizing pservers, source of truth should define values
-          required: false
-          type: string
-        - name: prov-status
-          in: query
-          description: Trigger for operational monitoring of this resource by Service Assurance systems.
-          required: false
-          type: string
-        - name: heat-stack-id
-          in: query
-          description: Heat stack id corresponding to this instance, managed by MSO
-          required: false
-          type: string
-        - name: in-maint
-          in: query
-          required: false
-          type: boolean
-        - name: is-closed-loop-disabled
-          in: query
-          required: false
-          type: boolean
-        - name: model-invariant-id
-          in: query
-          description: the ASDC model id for this resource or service model.
-          required: false
-          type: string
-        - name: model-version-id
-          in: query
-          description: the ASDC model version for this resource or service model.
-          required: false
-          type: string
-        - name: widget-model-id
-          in: query
-          description: the ASDC data dictionary widget model. This maps directly to the A&AI widget.
-          required: false
-          type: string
-        - name: widget-model-version
-          in: query
-          description: the ASDC data dictionary version of the widget model.This maps directly to the A&AI version of the widget.
-          required: false
-          type: string
-        - name: nf-type
-          in: query
-          description: Generic description of the type of NF
-          required: false
-          type: string
-        - name: nf-function
-          in: query
-          description: English description of Network function that the specific VNF deployment is providing
-          required: false
-          type: string
-        - name: nf-role
-          in: query
-          description: role in the network that this model will be providing
-          required: false
-          type: string
-        - name: nf-naming-code
-          in: query
-          description: string assigned to this model used for naming purposes
-          required: false
-          type: string
-        - name: interface-id
-          in: query
-          description: ID of interface
-          required: false
-          type: string
-        - name: macaddr
-          in: query
-          description: MAC address for the interface
-          required: false
-          type: string
-        - name: network-name
-          in: query
-          description: Name of the network
-          required: false
-          type: string
-    put:
+            $ref: "#/definitions/network-policy"
+    patch:
       tags:
         - Network
-      summary: create or update an existing l-interface
-      description: create or update an existing l-interface
-      operationId: createOrUpdateNetworkGenericVnfsGenericVnfLInterfacesLInterface
+      summary: update an existing network-policy
+      description: |
+        Update an existing network-policy
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkNetworkPoliciesNetworkPolicy
       consumes:
         - application/json
         - application/xml
@@ -26864,28 +33978,24 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id
-          in: path
-          description: Unique id of VNF.  This is unique across the graph.
-          required: true
-          type: string
-        - name: interface-name
+        - name: network-policy-id
           in: path
-          description: Name given to the interface
+          description: UUID representing unique key to this instance
           required: true
           type: string
+          example: __NETWORK-POLICY-ID__
         - name: body
           in: body
-          description: l-interface object that needs to be created or updated
+          description: network-policy object that needs to be created or updated. 
           required: true
           schema:
-            $ref: "#/definitions/l-interface"
+            $ref: "#/patchDefinitions/network-policy"
     delete:
       tags:
         - Network
-      summary: delete an existing l-interface
-      description: delete an existing l-interface
-      operationId: deleteNetworkGenericVnfsGenericVnfLInterfacesLInterface
+      summary: delete an existing network-policy
+      description: delete an existing network-policy
+      operationId: deleteNetworkNetworkPoliciesNetworkPolicy
       consumes:
         - application/json
         - application/xml
@@ -26896,28 +34006,24 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id
-          in: path
-          description: Unique id of VNF.  This is unique across the graph.
-          required: true
-          type: string
-        - name: interface-name
+        - name: network-policy-id
           in: path
-          description: Name given to the interface
+          description: UUID representing unique key to this instance
           required: true
           type: string
+          example: __NETWORK-POLICY-ID__
         - name: resource-version
           in: query
           description: resource-version for concurrency
           required: true
           type: string
-  /network/generic-vnfs/generic-vnf/{vnf-id}/l-interfaces:
+  /network/network-policies:
     get:
       tags:
         - Network
-      summary: returns l-interfaces
-      description: returns l-interfaces
-      operationId: getNetworkGenericVnfsGenericVnfLInterfaces
+      summary: returns network-policies
+      description: returns network-policies
+      operationId: getNetworkNetworkPolicies
       produces:
         - application/json
         - application/xml
@@ -26925,104 +34031,15 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/l-interfaces"
+              $ref: "#/getDefinitions/network-policies"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
-      parameters:
-        - name: vnf-id
-          in: path
-          description: Unique id of VNF.  This is unique across the graph.
-          required: true
-          type: string
-        - name: vnf-name
-          in: query
-          description: Name of VNF.
-          required: false
-          type: string
-        - name: vnf-name2
-          in: query
-          description: Alternate name of VNF.
-          required: false
-          type: string
-        - name: vnf-type
-          in: query
-          description: String capturing type of vnf, that was intended to identify the ASDC resource.  This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures.
-          required: false
-          type: string
-        - name: service-id
-          in: query
-          description: Unique identifier of service, does not necessarily map to ASDC service models.  SOON TO BE DEPRECATED
-          required: false
-          type: string
-        - name: regional-resource-zone
-          in: query
-          description: Regional way of organizing pservers, source of truth should define values
-          required: false
-          type: string
-        - name: prov-status
-          in: query
-          description: Trigger for operational monitoring of this resource by Service Assurance systems.
-          required: false
-          type: string
-        - name: heat-stack-id
-          in: query
-          description: Heat stack id corresponding to this instance, managed by MSO
-          required: false
-          type: string
-        - name: in-maint
-          in: query
-          required: false
-          type: boolean
-        - name: is-closed-loop-disabled
-          in: query
-          required: false
-          type: boolean
-        - name: model-invariant-id
-          in: query
-          description: the ASDC model id for this resource or service model.
-          required: false
-          type: string
-        - name: model-version-id
-          in: query
-          description: the ASDC model version for this resource or service model.
-          required: false
-          type: string
-        - name: widget-model-id
-          in: query
-          description: the ASDC data dictionary widget model. This maps directly to the A&AI widget.
-          required: false
-          type: string
-        - name: widget-model-version
-          in: query
-          description: the ASDC data dictionary version of the widget model.This maps directly to the A&AI version of the widget.
-          required: false
-          type: string
-        - name: nf-type
-          in: query
-          description: Generic description of the type of NF
-          required: false
-          type: string
-        - name: nf-function
-          in: query
-          description: English description of Network function that the specific VNF deployment is providing
-          required: false
-          type: string
-        - name: nf-role
-          in: query
-          description: role in the network that this model will be providing
-          required: false
-          type: string
-        - name: nf-naming-code
-          in: query
-          description: string assigned to this model used for naming purposes
-          required: false
-          type: string
-  /network/generic-vnfs/generic-vnf/{vnf-id}/lag-interfaces/lag-interface/{interface-name}/relationship-list/relationship:
+  /network/generic-vnfs/generic-vnf/{vnf-id}/relationship-list/relationship:
     put:
       tags:
         - Network
       summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceRelationshipListRelationship
+      operationId: createOrUpdateNetworkGenericVnfsGenericVnfRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -27038,14 +34055,10 @@ paths:
           description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: interface-name
-          in: path
-          description: Name that identifies the link aggregate interface
-          required: true
-          type: string
+          example: __VNF-ID__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkGenericVnfsGenericVnf.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -27054,7 +34067,7 @@ paths:
         - Network
       summary: delete an existing relationship
       description: delete an existing relationship
-      operationId: deleteNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceRelationshipListRelationship
+      operationId: deleteNetworkGenericVnfsGenericVnfRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -27070,17 +34083,13 @@ paths:
           description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: interface-name
-          in: path
-          description: Name that identifies the link aggregate interface
-          required: true
-          type: string
-  /network/generic-vnfs/generic-vnf/{vnf-id}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/relationship-list/relationship:
+          example: __VNF-ID__
+  /network/generic-vnfs/generic-vnf/{vnf-id}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/relationship-list/relationship:
     put:
       tags:
         - Network
       summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanRelationshipListRelationship
+      operationId: createOrUpdateNetworkGenericVnfsGenericVnfLInterfacesLInterfaceVlansVlanRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -27096,24 +34105,22 @@ paths:
           description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: interface-name
-          in: path
-          description: Name that identifies the link aggregate interface
-          required: true
-          type: string
+          example: __VNF-ID__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vlan-interface
           in: path
           description: String that identifies the interface
           required: true
           type: string
+          example: __VLAN-INTERFACE__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkGenericVnfsGenericVnfLInterfacesLInterfaceVlansVlan.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -27122,7 +34129,7 @@ paths:
         - Network
       summary: delete an existing relationship
       description: delete an existing relationship
-      operationId: deleteNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanRelationshipListRelationship
+      operationId: deleteNetworkGenericVnfsGenericVnfLInterfacesLInterfaceVlansVlanRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -27138,27 +34145,25 @@ paths:
           description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: interface-name
-          in: path
-          description: Name that identifies the link aggregate interface
-          required: true
-          type: string
+          example: __VNF-ID__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vlan-interface
           in: path
           description: String that identifies the interface
           required: true
           type: string
-  /network/generic-vnfs/generic-vnf/{vnf-id}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}/relationship-list/relationship:
+          example: __VLAN-INTERFACE__
+  /network/generic-vnfs/generic-vnf/{vnf-id}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}/relationship-list/relationship:
     put:
       tags:
         - Network
       summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressListRelationshipListRelationship
+      operationId: createOrUpdateNetworkGenericVnfsGenericVnfLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressListRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -27174,29 +34179,28 @@ paths:
           description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: interface-name
-          in: path
-          description: Name that identifies the link aggregate interface
-          required: true
-          type: string
+          example: __VNF-ID__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vlan-interface
           in: path
           description: String that identifies the interface
           required: true
           type: string
+          example: __VLAN-INTERFACE__
         - name: l3-interface-ipv4-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkGenericVnfsGenericVnfLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -27205,7 +34209,7 @@ paths:
         - Network
       summary: delete an existing relationship
       description: delete an existing relationship
-      operationId: deleteNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressListRelationshipListRelationship
+      operationId: deleteNetworkGenericVnfsGenericVnfLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressListRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -27221,33 +34225,32 @@ paths:
           description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: interface-name
-          in: path
-          description: Name that identifies the link aggregate interface
-          required: true
-          type: string
+          example: __VNF-ID__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vlan-interface
           in: path
           description: String that identifies the interface
           required: true
           type: string
+          example: __VLAN-INTERFACE__
         - name: l3-interface-ipv4-address
           in: path
           description: IP address
           required: true
           type: string
-  /network/generic-vnfs/generic-vnf/{vnf-id}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}:
+          example: __L3-INTERFACE-IPV4-ADDRESS__
+  /network/generic-vnfs/generic-vnf/{vnf-id}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}:
     get:
       tags:
         - Network
       summary: returns l3-interface-ipv4-address-list
       description: returns l3-interface-ipv4-address-list
-      operationId: getNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList
+      operationId: getNetworkGenericVnfsGenericVnfLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList
       produces:
         - application/json
         - application/xml
@@ -27255,7 +34258,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/l3-interface-ipv4-address-list"
+              $ref: "#/getDefinitions/l3-interface-ipv4-address-list"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -27264,26 +34267,25 @@ paths:
           description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: interface-name
-          in: path
-          description: Name that identifies the link aggregate interface
-          required: true
-          type: string
+          example: __VNF-ID__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vlan-interface
           in: path
           description: String that identifies the interface
           required: true
           type: string
+          example: __VLAN-INTERFACE__
         - name: l3-interface-ipv4-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
         - name: vnf-name
           in: query
           description: Name of VNF.
@@ -27372,16 +34374,6 @@ paths:
           description: ID of interface
           required: false
           type: string
-        - name: interface-role
-          in: query
-          description: Role assigned to this Interface, should use values as defined in ECOMP Yang models.
-          required: false
-          type: string
-        - name: interface-id
-          in: query
-          description: ID of interface
-          required: false
-          type: string
         - name: macaddr
           in: query
           description: MAC address for the interface
@@ -27423,8 +34415,11 @@ paths:
       tags:
         - Network
       summary: create or update an existing l3-interface-ipv4-address-list
-      description: create or update an existing l3-interface-ipv4-address-list
-      operationId: createOrUpdateNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList
+      description: |
+        Create or update an existing l3-interface-ipv4-address-list.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkGenericVnfsGenericVnfLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList
       consumes:
         - application/json
         - application/xml
@@ -27440,38 +34435,94 @@ paths:
           description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
+          example: __VNF-ID__
         - name: interface-name
           in: path
-          description: Name that identifies the link aggregate interface
+          description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
+          type: string
+          example: __VLAN-INTERFACE__
+        - name: l3-interface-ipv4-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
+        - name: body
+          in: body
+          description: l3-interface-ipv4-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkGenericVnfsGenericVnfLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList.json)
+          required: true
+          schema:
+            $ref: "#/definitions/l3-interface-ipv4-address-list"
+    patch:
+      tags:
+        - Network
+      summary: update an existing l3-interface-ipv4-address-list
+      description: |
+        Update an existing l3-interface-ipv4-address-list
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkGenericVnfsGenericVnfLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: vnf-id
+          in: path
+          description: Unique id of VNF.  This is unique across the graph.
+          required: true
+          type: string
+          example: __VNF-ID__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vlan-interface
           in: path
           description: String that identifies the interface
           required: true
           type: string
+          example: __VLAN-INTERFACE__
         - name: l3-interface-ipv4-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
         - name: body
           in: body
-          description: l3-interface-ipv4-address-list object that needs to be created or updated
+          description: l3-interface-ipv4-address-list object that needs to be created or updated
           required: true
           schema:
-            $ref: "#/definitions/l3-interface-ipv4-address-list"
+            $ref: "#/patchDefinitions/l3-interface-ipv4-address-list"
     delete:
       tags:
         - Network
       summary: delete an existing l3-interface-ipv4-address-list
       description: delete an existing l3-interface-ipv4-address-list
-      operationId: deleteNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList
+      operationId: deleteNetworkGenericVnfsGenericVnfLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList
       consumes:
         - application/json
         - application/xml
@@ -27487,37 +34538,36 @@ paths:
           description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: interface-name
-          in: path
-          description: Name that identifies the link aggregate interface
-          required: true
-          type: string
+          example: __VNF-ID__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vlan-interface
           in: path
           description: String that identifies the interface
           required: true
           type: string
+          example: __VLAN-INTERFACE__
         - name: l3-interface-ipv4-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
         - name: resource-version
           in: query
           description: resource-version for concurrency
           required: true
           type: string
-  /network/generic-vnfs/generic-vnf/{vnf-id}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}/relationship-list/relationship:
+  /network/generic-vnfs/generic-vnf/{vnf-id}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}/relationship-list/relationship:
     put:
       tags:
         - Network
       summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressListRelationshipListRelationship
+      operationId: createOrUpdateNetworkGenericVnfsGenericVnfLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressListRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -27533,29 +34583,28 @@ paths:
           description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: interface-name
-          in: path
-          description: Name that identifies the link aggregate interface
-          required: true
-          type: string
+          example: __VNF-ID__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vlan-interface
           in: path
           description: String that identifies the interface
           required: true
           type: string
+          example: __VLAN-INTERFACE__
         - name: l3-interface-ipv6-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkGenericVnfsGenericVnfLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -27564,7 +34613,7 @@ paths:
         - Network
       summary: delete an existing relationship
       description: delete an existing relationship
-      operationId: deleteNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressListRelationshipListRelationship
+      operationId: deleteNetworkGenericVnfsGenericVnfLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressListRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -27580,33 +34629,32 @@ paths:
           description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: interface-name
-          in: path
-          description: Name that identifies the link aggregate interface
-          required: true
-          type: string
+          example: __VNF-ID__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vlan-interface
           in: path
           description: String that identifies the interface
           required: true
           type: string
+          example: __VLAN-INTERFACE__
         - name: l3-interface-ipv6-address
           in: path
           description: IP address
           required: true
           type: string
-  /network/generic-vnfs/generic-vnf/{vnf-id}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}:
+          example: __L3-INTERFACE-IPV6-ADDRESS__
+  /network/generic-vnfs/generic-vnf/{vnf-id}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}:
     get:
       tags:
         - Network
       summary: returns l3-interface-ipv6-address-list
       description: returns l3-interface-ipv6-address-list
-      operationId: getNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList
+      operationId: getNetworkGenericVnfsGenericVnfLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList
       produces:
         - application/json
         - application/xml
@@ -27614,7 +34662,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/l3-interface-ipv6-address-list"
+              $ref: "#/getDefinitions/l3-interface-ipv6-address-list"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -27623,26 +34671,25 @@ paths:
           description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: interface-name
-          in: path
-          description: Name that identifies the link aggregate interface
-          required: true
-          type: string
+          example: __VNF-ID__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vlan-interface
           in: path
           description: String that identifies the interface
           required: true
           type: string
+          example: __VLAN-INTERFACE__
         - name: l3-interface-ipv6-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
         - name: vnf-name
           in: query
           description: Name of VNF.
@@ -27731,16 +34778,6 @@ paths:
           description: ID of interface
           required: false
           type: string
-        - name: interface-role
-          in: query
-          description: Role assigned to this Interface, should use values as defined in ECOMP Yang models.
-          required: false
-          type: string
-        - name: interface-id
-          in: query
-          description: ID of interface
-          required: false
-          type: string
         - name: macaddr
           in: query
           description: MAC address for the interface
@@ -27782,8 +34819,11 @@ paths:
       tags:
         - Network
       summary: create or update an existing l3-interface-ipv6-address-list
-      description: create or update an existing l3-interface-ipv6-address-list
-      operationId: createOrUpdateNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList
+      description: |
+        Create or update an existing l3-interface-ipv6-address-list.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkGenericVnfsGenericVnfLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList
       consumes:
         - application/json
         - application/xml
@@ -27799,38 +34839,94 @@ paths:
           description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
+          example: __VNF-ID__
         - name: interface-name
           in: path
-          description: Name that identifies the link aggregate interface
+          description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
+          type: string
+          example: __VLAN-INTERFACE__
+        - name: l3-interface-ipv6-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
+        - name: body
+          in: body
+          description: l3-interface-ipv6-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkGenericVnfsGenericVnfLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList.json)
+          required: true
+          schema:
+            $ref: "#/definitions/l3-interface-ipv6-address-list"
+    patch:
+      tags:
+        - Network
+      summary: update an existing l3-interface-ipv6-address-list
+      description: |
+        Update an existing l3-interface-ipv6-address-list
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkGenericVnfsGenericVnfLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: vnf-id
+          in: path
+          description: Unique id of VNF.  This is unique across the graph.
+          required: true
+          type: string
+          example: __VNF-ID__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vlan-interface
           in: path
           description: String that identifies the interface
           required: true
           type: string
+          example: __VLAN-INTERFACE__
         - name: l3-interface-ipv6-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
         - name: body
           in: body
-          description: l3-interface-ipv6-address-list object that needs to be created or updated
+          description: l3-interface-ipv6-address-list object that needs to be created or updated
           required: true
           schema:
-            $ref: "#/definitions/l3-interface-ipv6-address-list"
+            $ref: "#/patchDefinitions/l3-interface-ipv6-address-list"
     delete:
       tags:
         - Network
       summary: delete an existing l3-interface-ipv6-address-list
       description: delete an existing l3-interface-ipv6-address-list
-      operationId: deleteNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList
+      operationId: deleteNetworkGenericVnfsGenericVnfLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList
       consumes:
         - application/json
         - application/xml
@@ -27846,38 +34942,37 @@ paths:
           description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: interface-name
-          in: path
-          description: Name that identifies the link aggregate interface
-          required: true
-          type: string
+          example: __VNF-ID__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vlan-interface
           in: path
           description: String that identifies the interface
           required: true
           type: string
+          example: __VLAN-INTERFACE__
         - name: l3-interface-ipv6-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
         - name: resource-version
           in: query
           description: resource-version for concurrency
           required: true
           type: string
-  /network/generic-vnfs/generic-vnf/{vnf-id}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}:
+  /network/generic-vnfs/generic-vnf/{vnf-id}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}:
     get:
       tags:
         - Network
       summary: returns vlan
       description: returns vlan
-      operationId: getNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlan
+      operationId: getNetworkGenericVnfsGenericVnfLInterfacesLInterfaceVlansVlan
       produces:
         - application/json
         - application/xml
@@ -27885,7 +34980,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/vlan"
+              $ref: "#/getDefinitions/vlan"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -27894,21 +34989,19 @@ paths:
           description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: interface-name
-          in: path
-          description: Name that identifies the link aggregate interface
-          required: true
-          type: string
+          example: __VNF-ID__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vlan-interface
           in: path
           description: String that identifies the interface
           required: true
           type: string
+          example: __VLAN-INTERFACE__
         - name: vnf-name
           in: query
           description: Name of VNF.
@@ -27997,16 +35090,6 @@ paths:
           description: ID of interface
           required: false
           type: string
-        - name: interface-role
-          in: query
-          description: Role assigned to this Interface, should use values as defined in ECOMP Yang models.
-          required: false
-          type: string
-        - name: interface-id
-          in: query
-          description: ID of interface
-          required: false
-          type: string
         - name: macaddr
           in: query
           description: MAC address for the interface
@@ -28032,8 +35115,11 @@ paths:
       tags:
         - Network
       summary: create or update an existing vlan
-      description: create or update an existing vlan
-      operationId: createOrUpdateNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlan
+      description: |
+        Create or update an existing vlan.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkGenericVnfsGenericVnfLInterfacesLInterfaceVlansVlan
       consumes:
         - application/json
         - application/xml
@@ -28049,33 +35135,82 @@ paths:
           description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
+          example: __VNF-ID__
         - name: interface-name
           in: path
-          description: Name that identifies the link aggregate interface
+          description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
+          type: string
+          example: __VLAN-INTERFACE__
+        - name: body
+          in: body
+          description: vlan object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkGenericVnfsGenericVnfLInterfacesLInterfaceVlansVlan.json)
+          required: true
+          schema:
+            $ref: "#/definitions/vlan"
+    patch:
+      tags:
+        - Network
+      summary: update an existing vlan
+      description: |
+        Update an existing vlan
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkGenericVnfsGenericVnfLInterfacesLInterfaceVlansVlan
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: vnf-id
+          in: path
+          description: Unique id of VNF.  This is unique across the graph.
+          required: true
+          type: string
+          example: __VNF-ID__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vlan-interface
           in: path
           description: String that identifies the interface
           required: true
           type: string
+          example: __VLAN-INTERFACE__
         - name: body
           in: body
-          description: vlan object that needs to be created or updated
+          description: vlan object that needs to be created or updated
           required: true
           schema:
-            $ref: "#/definitions/vlan"
+            $ref: "#/patchDefinitions/vlan"
     delete:
       tags:
         - Network
       summary: delete an existing vlan
       description: delete an existing vlan
-      operationId: deleteNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlan
+      operationId: deleteNetworkGenericVnfsGenericVnfLInterfacesLInterfaceVlansVlan
       consumes:
         - application/json
         - application/xml
@@ -28091,33 +35226,31 @@ paths:
           description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: interface-name
-          in: path
-          description: Name that identifies the link aggregate interface
-          required: true
-          type: string
+          example: __VNF-ID__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vlan-interface
           in: path
           description: String that identifies the interface
           required: true
           type: string
+          example: __VLAN-INTERFACE__
         - name: resource-version
           in: query
           description: resource-version for concurrency
           required: true
           type: string
-  /network/generic-vnfs/generic-vnf/{vnf-id}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans:
+  /network/generic-vnfs/generic-vnf/{vnf-id}/l-interfaces/l-interface/{interface-name}/vlans:
     get:
       tags:
         - Network
       summary: returns vlans
       description: returns vlans
-      operationId: getNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlans
+      operationId: getNetworkGenericVnfsGenericVnfLInterfacesLInterfaceVlans
       produces:
         - application/json
         - application/xml
@@ -28125,7 +35258,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/vlans"
+              $ref: "#/getDefinitions/vlans"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -28134,16 +35267,13 @@ paths:
           description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: interface-name
-          in: path
-          description: Name that identifies the link aggregate interface
-          required: true
-          type: string
+          example: __VNF-ID__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vnf-name
           in: query
           description: Name of VNF.
@@ -28232,16 +35362,6 @@ paths:
           description: ID of interface
           required: false
           type: string
-        - name: interface-role
-          in: query
-          description: Role assigned to this Interface, should use values as defined in ECOMP Yang models.
-          required: false
-          type: string
-        - name: interface-id
-          in: query
-          description: ID of interface
-          required: false
-          type: string
         - name: macaddr
           in: query
           description: MAC address for the interface
@@ -28252,12 +35372,12 @@ paths:
           description: Name of the network
           required: false
           type: string
-  /network/generic-vnfs/generic-vnf/{vnf-id}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/sriov-vfs/sriov-vf/{pci-id}/relationship-list/relationship:
+  /network/generic-vnfs/generic-vnf/{vnf-id}/l-interfaces/l-interface/{interface-name}/sriov-vfs/sriov-vf/{pci-id}/relationship-list/relationship:
     put:
       tags:
         - Network
       summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfsSriovVfRelationshipListRelationship
+      operationId: createOrUpdateNetworkGenericVnfsGenericVnfLInterfacesLInterfaceSriovVfsSriovVfRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -28273,24 +35393,22 @@ paths:
           description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: interface-name
-          in: path
-          description: Name that identifies the link aggregate interface
-          required: true
-          type: string
+          example: __VNF-ID__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: pci-id
           in: path
           description: PCI ID used to identify the sriov-vf
           required: true
           type: string
+          example: __PCI-ID__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkGenericVnfsGenericVnfLInterfacesLInterfaceSriovVfsSriovVf.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -28299,7 +35417,7 @@ paths:
         - Network
       summary: delete an existing relationship
       description: delete an existing relationship
-      operationId: deleteNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfsSriovVfRelationshipListRelationship
+      operationId: deleteNetworkGenericVnfsGenericVnfLInterfacesLInterfaceSriovVfsSriovVfRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -28315,28 +35433,26 @@ paths:
           description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: interface-name
-          in: path
-          description: Name that identifies the link aggregate interface
-          required: true
-          type: string
+          example: __VNF-ID__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: pci-id
           in: path
           description: PCI ID used to identify the sriov-vf
           required: true
           type: string
-  /network/generic-vnfs/generic-vnf/{vnf-id}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/sriov-vfs/sriov-vf/{pci-id}:
+          example: __PCI-ID__
+  /network/generic-vnfs/generic-vnf/{vnf-id}/l-interfaces/l-interface/{interface-name}/sriov-vfs/sriov-vf/{pci-id}:
     get:
       tags:
         - Network
       summary: returns sriov-vf
       description: returns sriov-vf
-      operationId: getNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfsSriovVf
+      operationId: getNetworkGenericVnfsGenericVnfLInterfacesLInterfaceSriovVfsSriovVf
       produces:
         - application/json
         - application/xml
@@ -28344,7 +35460,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/sriov-vf"
+              $ref: "#/getDefinitions/sriov-vf"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -28353,21 +35469,19 @@ paths:
           description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: interface-name
-          in: path
-          description: Name that identifies the link aggregate interface
-          required: true
-          type: string
+          example: __VNF-ID__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: pci-id
           in: path
           description: PCI ID used to identify the sriov-vf
           required: true
           type: string
+          example: __PCI-ID__
         - name: vnf-name
           in: query
           description: Name of VNF.
@@ -28456,16 +35570,6 @@ paths:
           description: ID of interface
           required: false
           type: string
-        - name: interface-role
-          in: query
-          description: Role assigned to this Interface, should use values as defined in ECOMP Yang models.
-          required: false
-          type: string
-        - name: interface-id
-          in: query
-          description: ID of interface
-          required: false
-          type: string
         - name: macaddr
           in: query
           description: MAC address for the interface
@@ -28500,8 +35604,11 @@ paths:
       tags:
         - Network
       summary: create or update an existing sriov-vf
-      description: create or update an existing sriov-vf
-      operationId: createOrUpdateNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfsSriovVf
+      description: |
+        Create or update an existing sriov-vf.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkGenericVnfsGenericVnfLInterfacesLInterfaceSriovVfsSriovVf
       consumes:
         - application/json
         - application/xml
@@ -28517,33 +35624,82 @@ paths:
           description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
+          example: __VNF-ID__
         - name: interface-name
           in: path
-          description: Name that identifies the link aggregate interface
+          description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
+        - name: pci-id
+          in: path
+          description: PCI ID used to identify the sriov-vf
+          required: true
+          type: string
+          example: __PCI-ID__
+        - name: body
+          in: body
+          description: sriov-vf object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkGenericVnfsGenericVnfLInterfacesLInterfaceSriovVfsSriovVf.json)
+          required: true
+          schema:
+            $ref: "#/definitions/sriov-vf"
+    patch:
+      tags:
+        - Network
+      summary: update an existing sriov-vf
+      description: |
+        Update an existing sriov-vf
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkGenericVnfsGenericVnfLInterfacesLInterfaceSriovVfsSriovVf
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: vnf-id
+          in: path
+          description: Unique id of VNF.  This is unique across the graph.
+          required: true
+          type: string
+          example: __VNF-ID__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: pci-id
           in: path
           description: PCI ID used to identify the sriov-vf
           required: true
           type: string
+          example: __PCI-ID__
         - name: body
           in: body
-          description: sriov-vf object that needs to be created or updated
+          description: sriov-vf object that needs to be created or updated
           required: true
           schema:
-            $ref: "#/definitions/sriov-vf"
+            $ref: "#/patchDefinitions/sriov-vf"
     delete:
       tags:
         - Network
       summary: delete an existing sriov-vf
       description: delete an existing sriov-vf
-      operationId: deleteNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfsSriovVf
+      operationId: deleteNetworkGenericVnfsGenericVnfLInterfacesLInterfaceSriovVfsSriovVf
       consumes:
         - application/json
         - application/xml
@@ -28559,33 +35715,31 @@ paths:
           description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: interface-name
-          in: path
-          description: Name that identifies the link aggregate interface
-          required: true
-          type: string
+          example: __VNF-ID__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: pci-id
           in: path
           description: PCI ID used to identify the sriov-vf
           required: true
           type: string
+          example: __PCI-ID__
         - name: resource-version
           in: query
           description: resource-version for concurrency
           required: true
           type: string
-  /network/generic-vnfs/generic-vnf/{vnf-id}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/sriov-vfs:
+  /network/generic-vnfs/generic-vnf/{vnf-id}/l-interfaces/l-interface/{interface-name}/sriov-vfs:
     get:
       tags:
         - Network
       summary: returns sriov-vfs
       description: returns sriov-vfs
-      operationId: getNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfs
+      operationId: getNetworkGenericVnfsGenericVnfLInterfacesLInterfaceSriovVfs
       produces:
         - application/json
         - application/xml
@@ -28593,7 +35747,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/sriov-vfs"
+              $ref: "#/getDefinitions/sriov-vfs"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -28602,16 +35756,13 @@ paths:
           description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: interface-name
-          in: path
-          description: Name that identifies the link aggregate interface
-          required: true
-          type: string
+          example: __VNF-ID__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vnf-name
           in: query
           description: Name of VNF.
@@ -28700,16 +35851,6 @@ paths:
           description: ID of interface
           required: false
           type: string
-        - name: interface-role
-          in: query
-          description: Role assigned to this Interface, should use values as defined in ECOMP Yang models.
-          required: false
-          type: string
-        - name: interface-id
-          in: query
-          description: ID of interface
-          required: false
-          type: string
         - name: macaddr
           in: query
           description: MAC address for the interface
@@ -28720,12 +35861,12 @@ paths:
           description: Name of the network
           required: false
           type: string
-  /network/generic-vnfs/generic-vnf/{vnf-id}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/relationship-list/relationship:
+  /network/generic-vnfs/generic-vnf/{vnf-id}/l-interfaces/l-interface/{interface-name}/relationship-list/relationship:
     put:
       tags:
         - Network
       summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceRelationshipListRelationship
+      operationId: createOrUpdateNetworkGenericVnfsGenericVnfLInterfacesLInterfaceRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -28741,19 +35882,16 @@ paths:
           description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: interface-name
-          in: path
-          description: Name that identifies the link aggregate interface
-          required: true
-          type: string
+          example: __VNF-ID__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkGenericVnfsGenericVnfLInterfacesLInterface.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -28762,7 +35900,7 @@ paths:
         - Network
       summary: delete an existing relationship
       description: delete an existing relationship
-      operationId: deleteNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceRelationshipListRelationship
+      operationId: deleteNetworkGenericVnfsGenericVnfLInterfacesLInterfaceRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -28778,22 +35916,19 @@ paths:
           description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: interface-name
-          in: path
-          description: Name that identifies the link aggregate interface
-          required: true
-          type: string
+          example: __VNF-ID__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
-  /network/generic-vnfs/generic-vnf/{vnf-id}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}/relationship-list/relationship:
+          example: __INTERFACE-NAME__
+  /network/generic-vnfs/generic-vnf/{vnf-id}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}/relationship-list/relationship:
     put:
       tags:
         - Network
       summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressListRelationshipListRelationship
+      operationId: createOrUpdateNetworkGenericVnfsGenericVnfLInterfacesLInterfaceL3InterfaceIpv4AddressListRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -28809,24 +35944,22 @@ paths:
           description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: interface-name
-          in: path
-          description: Name that identifies the link aggregate interface
-          required: true
-          type: string
+          example: __VNF-ID__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: l3-interface-ipv4-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkGenericVnfsGenericVnfLInterfacesLInterfaceL3InterfaceIpv4AddressList.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -28835,7 +35968,7 @@ paths:
         - Network
       summary: delete an existing relationship
       description: delete an existing relationship
-      operationId: deleteNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressListRelationshipListRelationship
+      operationId: deleteNetworkGenericVnfsGenericVnfLInterfacesLInterfaceL3InterfaceIpv4AddressListRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -28851,28 +35984,26 @@ paths:
           description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: interface-name
-          in: path
-          description: Name that identifies the link aggregate interface
-          required: true
-          type: string
+          example: __VNF-ID__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: l3-interface-ipv4-address
           in: path
           description: IP address
           required: true
           type: string
-  /network/generic-vnfs/generic-vnf/{vnf-id}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}:
+          example: __L3-INTERFACE-IPV4-ADDRESS__
+  /network/generic-vnfs/generic-vnf/{vnf-id}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}:
     get:
       tags:
         - Network
       summary: returns l3-interface-ipv4-address-list
       description: returns l3-interface-ipv4-address-list
-      operationId: getNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList
+      operationId: getNetworkGenericVnfsGenericVnfLInterfacesLInterfaceL3InterfaceIpv4AddressList
       produces:
         - application/json
         - application/xml
@@ -28880,7 +36011,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/l3-interface-ipv4-address-list"
+              $ref: "#/getDefinitions/l3-interface-ipv4-address-list"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -28889,21 +36020,19 @@ paths:
           description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: interface-name
-          in: path
-          description: Name that identifies the link aggregate interface
-          required: true
-          type: string
+          example: __VNF-ID__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: l3-interface-ipv4-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
         - name: vnf-name
           in: query
           description: Name of VNF.
@@ -28992,16 +36121,6 @@ paths:
           description: ID of interface
           required: false
           type: string
-        - name: interface-role
-          in: query
-          description: Role assigned to this Interface, should use values as defined in ECOMP Yang models.
-          required: false
-          type: string
-        - name: interface-id
-          in: query
-          description: ID of interface
-          required: false
-          type: string
         - name: macaddr
           in: query
           description: MAC address for the interface
@@ -29032,8 +36151,11 @@ paths:
       tags:
         - Network
       summary: create or update an existing l3-interface-ipv4-address-list
-      description: create or update an existing l3-interface-ipv4-address-list
-      operationId: createOrUpdateNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList
+      description: |
+        Create or update an existing l3-interface-ipv4-address-list.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkGenericVnfsGenericVnfLInterfacesLInterfaceL3InterfaceIpv4AddressList
       consumes:
         - application/json
         - application/xml
@@ -29049,33 +36171,82 @@ paths:
           description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
+          example: __VNF-ID__
         - name: interface-name
           in: path
-          description: Name that identifies the link aggregate interface
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: l3-interface-ipv4-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
+        - name: body
+          in: body
+          description: l3-interface-ipv4-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkGenericVnfsGenericVnfLInterfacesLInterfaceL3InterfaceIpv4AddressList.json)
+          required: true
+          schema:
+            $ref: "#/definitions/l3-interface-ipv4-address-list"
+    patch:
+      tags:
+        - Network
+      summary: update an existing l3-interface-ipv4-address-list
+      description: |
+        Update an existing l3-interface-ipv4-address-list
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkGenericVnfsGenericVnfLInterfacesLInterfaceL3InterfaceIpv4AddressList
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: vnf-id
+          in: path
+          description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
+          example: __VNF-ID__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: l3-interface-ipv4-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
         - name: body
           in: body
-          description: l3-interface-ipv4-address-list object that needs to be created or updated
+          description: l3-interface-ipv4-address-list object that needs to be created or updated
           required: true
           schema:
-            $ref: "#/definitions/l3-interface-ipv4-address-list"
+            $ref: "#/patchDefinitions/l3-interface-ipv4-address-list"
     delete:
       tags:
         - Network
       summary: delete an existing l3-interface-ipv4-address-list
       description: delete an existing l3-interface-ipv4-address-list
-      operationId: deleteNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList
+      operationId: deleteNetworkGenericVnfsGenericVnfLInterfacesLInterfaceL3InterfaceIpv4AddressList
       consumes:
         - application/json
         - application/xml
@@ -29091,32 +36262,30 @@ paths:
           description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: interface-name
-          in: path
-          description: Name that identifies the link aggregate interface
-          required: true
-          type: string
+          example: __VNF-ID__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: l3-interface-ipv4-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
         - name: resource-version
           in: query
           description: resource-version for concurrency
           required: true
           type: string
-  /network/generic-vnfs/generic-vnf/{vnf-id}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}/relationship-list/relationship:
+  /network/generic-vnfs/generic-vnf/{vnf-id}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}/relationship-list/relationship:
     put:
       tags:
         - Network
       summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressListRelationshipListRelationship
+      operationId: createOrUpdateNetworkGenericVnfsGenericVnfLInterfacesLInterfaceL3InterfaceIpv6AddressListRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -29132,24 +36301,22 @@ paths:
           description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: interface-name
-          in: path
-          description: Name that identifies the link aggregate interface
-          required: true
-          type: string
+          example: __VNF-ID__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: l3-interface-ipv6-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkGenericVnfsGenericVnfLInterfacesLInterfaceL3InterfaceIpv6AddressList.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -29158,7 +36325,7 @@ paths:
         - Network
       summary: delete an existing relationship
       description: delete an existing relationship
-      operationId: deleteNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressListRelationshipListRelationship
+      operationId: deleteNetworkGenericVnfsGenericVnfLInterfacesLInterfaceL3InterfaceIpv6AddressListRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -29174,28 +36341,26 @@ paths:
           description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: interface-name
-          in: path
-          description: Name that identifies the link aggregate interface
-          required: true
-          type: string
+          example: __VNF-ID__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: l3-interface-ipv6-address
           in: path
           description: IP address
           required: true
           type: string
-  /network/generic-vnfs/generic-vnf/{vnf-id}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}:
+          example: __L3-INTERFACE-IPV6-ADDRESS__
+  /network/generic-vnfs/generic-vnf/{vnf-id}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}:
     get:
       tags:
         - Network
       summary: returns l3-interface-ipv6-address-list
       description: returns l3-interface-ipv6-address-list
-      operationId: getNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList
+      operationId: getNetworkGenericVnfsGenericVnfLInterfacesLInterfaceL3InterfaceIpv6AddressList
       produces:
         - application/json
         - application/xml
@@ -29203,7 +36368,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/l3-interface-ipv6-address-list"
+              $ref: "#/getDefinitions/l3-interface-ipv6-address-list"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -29212,21 +36377,19 @@ paths:
           description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: interface-name
-          in: path
-          description: Name that identifies the link aggregate interface
-          required: true
-          type: string
+          example: __VNF-ID__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: l3-interface-ipv6-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
         - name: vnf-name
           in: query
           description: Name of VNF.
@@ -29315,16 +36478,6 @@ paths:
           description: ID of interface
           required: false
           type: string
-        - name: interface-role
-          in: query
-          description: Role assigned to this Interface, should use values as defined in ECOMP Yang models.
-          required: false
-          type: string
-        - name: interface-id
-          in: query
-          description: ID of interface
-          required: false
-          type: string
         - name: macaddr
           in: query
           description: MAC address for the interface
@@ -29355,8 +36508,11 @@ paths:
       tags:
         - Network
       summary: create or update an existing l3-interface-ipv6-address-list
-      description: create or update an existing l3-interface-ipv6-address-list
-      operationId: createOrUpdateNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList
+      description: |
+        Create or update an existing l3-interface-ipv6-address-list.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkGenericVnfsGenericVnfLInterfacesLInterfaceL3InterfaceIpv6AddressList
       consumes:
         - application/json
         - application/xml
@@ -29372,33 +36528,82 @@ paths:
           description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
+          example: __VNF-ID__
         - name: interface-name
           in: path
-          description: Name that identifies the link aggregate interface
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: l3-interface-ipv6-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
+        - name: body
+          in: body
+          description: l3-interface-ipv6-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkGenericVnfsGenericVnfLInterfacesLInterfaceL3InterfaceIpv6AddressList.json)
+          required: true
+          schema:
+            $ref: "#/definitions/l3-interface-ipv6-address-list"
+    patch:
+      tags:
+        - Network
+      summary: update an existing l3-interface-ipv6-address-list
+      description: |
+        Update an existing l3-interface-ipv6-address-list
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkGenericVnfsGenericVnfLInterfacesLInterfaceL3InterfaceIpv6AddressList
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: vnf-id
+          in: path
+          description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
+          example: __VNF-ID__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: l3-interface-ipv6-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
         - name: body
           in: body
-          description: l3-interface-ipv6-address-list object that needs to be created or updated
+          description: l3-interface-ipv6-address-list object that needs to be created or updated
           required: true
           schema:
-            $ref: "#/definitions/l3-interface-ipv6-address-list"
+            $ref: "#/patchDefinitions/l3-interface-ipv6-address-list"
     delete:
       tags:
         - Network
       summary: delete an existing l3-interface-ipv6-address-list
       description: delete an existing l3-interface-ipv6-address-list
-      operationId: deleteNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList
+      operationId: deleteNetworkGenericVnfsGenericVnfLInterfacesLInterfaceL3InterfaceIpv6AddressList
       consumes:
         - application/json
         - application/xml
@@ -29414,33 +36619,31 @@ paths:
           description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: interface-name
-          in: path
-          description: Name that identifies the link aggregate interface
-          required: true
-          type: string
+          example: __VNF-ID__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: l3-interface-ipv6-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
         - name: resource-version
           in: query
           description: resource-version for concurrency
           required: true
           type: string
-  /network/generic-vnfs/generic-vnf/{vnf-id}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}:
+  /network/generic-vnfs/generic-vnf/{vnf-id}/l-interfaces/l-interface/{interface-name}:
     get:
       tags:
         - Network
       summary: returns l-interface
       description: returns l-interface
-      operationId: getNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterface
+      operationId: getNetworkGenericVnfsGenericVnfLInterfacesLInterface
       produces:
         - application/json
         - application/xml
@@ -29448,7 +36651,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/l-interface"
+              $ref: "#/getDefinitions/l-interface"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -29457,16 +36660,13 @@ paths:
           description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: interface-name
-          in: path
-          description: Name that identifies the link aggregate interface
-          required: true
-          type: string
+          example: __VNF-ID__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vnf-name
           in: query
           description: Name of VNF.
@@ -29555,16 +36755,6 @@ paths:
           description: ID of interface
           required: false
           type: string
-        - name: interface-role
-          in: query
-          description: Role assigned to this Interface, should use values as defined in ECOMP Yang models.
-          required: false
-          type: string
-        - name: interface-id
-          in: query
-          description: ID of interface
-          required: false
-          type: string
         - name: macaddr
           in: query
           description: MAC address for the interface
@@ -29579,8 +36769,11 @@ paths:
       tags:
         - Network
       summary: create or update an existing l-interface
-      description: create or update an existing l-interface
-      operationId: createOrUpdateNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterface
+      description: |
+        Create or update an existing l-interface.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkGenericVnfsGenericVnfLInterfacesLInterface
       consumes:
         - application/json
         - application/xml
@@ -29596,28 +36789,36 @@ paths:
           description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: interface-name
-          in: path
-          description: Name that identifies the link aggregate interface
-          required: true
-          type: string
+          example: __VNF-ID__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: body
           in: body
-          description: l-interface object that needs to be created or updated
+          description: l-interface object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkGenericVnfsGenericVnfLInterfacesLInterface.json)
           required: true
           schema:
             $ref: "#/definitions/l-interface"
-    delete:
+    patch:
       tags:
         - Network
-      summary: delete an existing l-interface
-      description: delete an existing l-interface
-      operationId: deleteNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterface
+      summary: update an existing l-interface
+      description: |
+        Update an existing l-interface
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkGenericVnfsGenericVnfLInterfacesLInterface
       consumes:
         - application/json
         - application/xml
@@ -29633,36 +36834,32 @@ paths:
           description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: interface-name
-          in: path
-          description: Name that identifies the link aggregate interface
-          required: true
-          type: string
+          example: __VNF-ID__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
-        - name: resource-version
-          in: query
-          description: resource-version for concurrency
+          example: __INTERFACE-NAME__
+        - name: body
+          in: body
+          description: l-interface object that needs to be created or updated. 
           required: true
-          type: string
-  /network/generic-vnfs/generic-vnf/{vnf-id}/lag-interfaces/lag-interface/{interface-name}/l-interfaces:
-    get:
+          schema:
+            $ref: "#/patchDefinitions/l-interface"
+    delete:
       tags:
         - Network
-      summary: returns l-interfaces
-      description: returns l-interfaces
-      operationId: getNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfaces
+      summary: delete an existing l-interface
+      description: delete an existing l-interface
+      operationId: deleteNetworkGenericVnfsGenericVnfLInterfacesLInterface
+      consumes:
+        - application/json
+        - application/xml
       produces:
         - application/json
         - application/xml
       responses:
-        "200":
-          description: successful operation
-          schema:
-              $ref: "#/definitions/l-interfaces"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -29671,111 +36868,25 @@ paths:
           description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
+          example: __VNF-ID__
         - name: interface-name
           in: path
-          description: Name that identifies the link aggregate interface
+          description: Name given to the interface
           required: true
           type: string
-        - name: vnf-name
-          in: query
-          description: Name of VNF.
-          required: false
-          type: string
-        - name: vnf-name2
-          in: query
-          description: Alternate name of VNF.
-          required: false
-          type: string
-        - name: vnf-type
-          in: query
-          description: String capturing type of vnf, that was intended to identify the ASDC resource.  This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures.
-          required: false
-          type: string
-        - name: service-id
-          in: query
-          description: Unique identifier of service, does not necessarily map to ASDC service models.  SOON TO BE DEPRECATED
-          required: false
-          type: string
-        - name: regional-resource-zone
-          in: query
-          description: Regional way of organizing pservers, source of truth should define values
-          required: false
-          type: string
-        - name: prov-status
-          in: query
-          description: Trigger for operational monitoring of this resource by Service Assurance systems.
-          required: false
-          type: string
-        - name: heat-stack-id
-          in: query
-          description: Heat stack id corresponding to this instance, managed by MSO
-          required: false
-          type: string
-        - name: in-maint
-          in: query
-          required: false
-          type: boolean
-        - name: is-closed-loop-disabled
-          in: query
-          required: false
-          type: boolean
-        - name: model-invariant-id
-          in: query
-          description: the ASDC model id for this resource or service model.
-          required: false
-          type: string
-        - name: model-version-id
-          in: query
-          description: the ASDC model version for this resource or service model.
-          required: false
-          type: string
-        - name: widget-model-id
-          in: query
-          description: the ASDC data dictionary widget model. This maps directly to the A&AI widget.
-          required: false
-          type: string
-        - name: widget-model-version
-          in: query
-          description: the ASDC data dictionary version of the widget model.This maps directly to the A&AI version of the widget.
-          required: false
-          type: string
-        - name: nf-type
-          in: query
-          description: Generic description of the type of NF
-          required: false
-          type: string
-        - name: nf-function
-          in: query
-          description: English description of Network function that the specific VNF deployment is providing
-          required: false
-          type: string
-        - name: nf-role
-          in: query
-          description: role in the network that this model will be providing
-          required: false
-          type: string
-        - name: nf-naming-code
-          in: query
-          description: string assigned to this model used for naming purposes
-          required: false
-          type: string
-        - name: interface-id
-          in: query
-          description: ID of interface
-          required: false
-          type: string
-        - name: interface-role
+          example: __INTERFACE-NAME__
+        - name: resource-version
           in: query
-          description: Role assigned to this Interface, should use values as defined in ECOMP Yang models.
-          required: false
+          description: resource-version for concurrency
+          required: true
           type: string
-  /network/generic-vnfs/generic-vnf/{vnf-id}/lag-interfaces/lag-interface/{interface-name}:
+  /network/generic-vnfs/generic-vnf/{vnf-id}/l-interfaces:
     get:
       tags:
         - Network
-      summary: returns lag-interface
-      description: returns lag-interface
-      operationId: getNetworkGenericVnfsGenericVnfLagInterfacesLagInterface
+      summary: returns l-interfaces
+      description: returns l-interfaces
+      operationId: getNetworkGenericVnfsGenericVnfLInterfaces
       produces:
         - application/json
         - application/xml
@@ -29783,7 +36894,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/lag-interface"
+              $ref: "#/getDefinitions/l-interfaces"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -29792,11 +36903,7 @@ paths:
           description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: interface-name
-          in: path
-          description: Name that identifies the link aggregate interface
-          required: true
-          type: string
+          example: __VNF-ID__
         - name: vnf-name
           in: query
           description: Name of VNF.
@@ -29880,22 +36987,12 @@ paths:
           description: string assigned to this model used for naming purposes
           required: false
           type: string
-        - name: interface-id
-          in: query
-          description: ID of interface
-          required: false
-          type: string
-        - name: interface-role
-          in: query
-          description: Role assigned to this Interface, should use values as defined in ECOMP Yang models.
-          required: false
-          type: string
+  /network/generic-vnfs/generic-vnf/{vnf-id}/lag-interfaces/lag-interface/{interface-name}/relationship-list/relationship:
     put:
       tags:
         - Network
-      summary: create or update an existing lag-interface
-      description: create or update an existing lag-interface
-      operationId: createOrUpdateNetworkGenericVnfsGenericVnfLagInterfacesLagInterface
+      summary: see node definition for valid relationships
+      operationId: createOrUpdateNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -29911,23 +37008,25 @@ paths:
           description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
+          example: __VNF-ID__
         - name: interface-name
           in: path
           description: Name that identifies the link aggregate interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: body
           in: body
-          description: lag-interface object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkGenericVnfsGenericVnfLagInterfacesLagInterface.json)
           required: true
           schema:
-            $ref: "#/definitions/lag-interface"
+            $ref: "#/definitions/relationship"
     delete:
       tags:
         - Network
-      summary: delete an existing lag-interface
-      description: delete an existing lag-interface
-      operationId: deleteNetworkGenericVnfsGenericVnfLagInterfacesLagInterface
+      summary: delete an existing relationship
+      description: delete an existing relationship
+      operationId: deleteNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -29943,31 +37042,26 @@ paths:
           description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
+          example: __VNF-ID__
         - name: interface-name
           in: path
           description: Name that identifies the link aggregate interface
           required: true
           type: string
-        - name: resource-version
-          in: query
-          description: resource-version for concurrency
-          required: true
-          type: string
-  /network/generic-vnfs/generic-vnf/{vnf-id}/lag-interfaces:
-    get:
+          example: __INTERFACE-NAME__
+  /network/generic-vnfs/generic-vnf/{vnf-id}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/relationship-list/relationship:
+    put:
       tags:
         - Network
-      summary: returns lag-interfaces
-      description: returns lag-interfaces
-      operationId: getNetworkGenericVnfsGenericVnfLagInterfaces
+      summary: see node definition for valid relationships
+      operationId: createOrUpdateNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanRelationshipListRelationship
+      consumes:
+        - application/json
+        - application/xml
       produces:
         - application/json
         - application/xml
       responses:
-        "200":
-          description: successful operation
-          schema:
-              $ref: "#/definitions/lag-interfaces"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -29976,95 +37070,77 @@ paths:
           description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: vnf-name
-          in: query
-          description: Name of VNF.
-          required: false
-          type: string
-        - name: vnf-name2
-          in: query
-          description: Alternate name of VNF.
-          required: false
-          type: string
-        - name: vnf-type
-          in: query
-          description: String capturing type of vnf, that was intended to identify the ASDC resource.  This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures.
-          required: false
-          type: string
-        - name: service-id
-          in: query
-          description: Unique identifier of service, does not necessarily map to ASDC service models.  SOON TO BE DEPRECATED
-          required: false
-          type: string
-        - name: regional-resource-zone
-          in: query
-          description: Regional way of organizing pservers, source of truth should define values
-          required: false
-          type: string
-        - name: prov-status
-          in: query
-          description: Trigger for operational monitoring of this resource by Service Assurance systems.
-          required: false
-          type: string
-        - name: heat-stack-id
-          in: query
-          description: Heat stack id corresponding to this instance, managed by MSO
-          required: false
-          type: string
-        - name: in-maint
-          in: query
-          required: false
-          type: boolean
-        - name: is-closed-loop-disabled
-          in: query
-          required: false
-          type: boolean
-        - name: model-invariant-id
-          in: query
-          description: the ASDC model id for this resource or service model.
-          required: false
-          type: string
-        - name: model-version-id
-          in: query
-          description: the ASDC model version for this resource or service model.
-          required: false
+          example: __VNF-ID__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
+          required: true
           type: string
-        - name: widget-model-id
-          in: query
-          description: the ASDC data dictionary widget model. This maps directly to the A&AI widget.
-          required: false
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
           type: string
-        - name: widget-model-version
-          in: query
-          description: the ASDC data dictionary version of the widget model.This maps directly to the A&AI version of the widget.
-          required: false
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
           type: string
-        - name: nf-type
-          in: query
-          description: Generic description of the type of NF
-          required: false
+          example: __VLAN-INTERFACE__
+        - name: body
+          in: body
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlan.json)
+          required: true
+          schema:
+            $ref: "#/definitions/relationship"
+    delete:
+      tags:
+        - Network
+      summary: delete an existing relationship
+      description: delete an existing relationship
+      operationId: deleteNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanRelationshipListRelationship
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: vnf-id
+          in: path
+          description: Unique id of VNF.  This is unique across the graph.
+          required: true
           type: string
-        - name: nf-function
-          in: query
-          description: English description of Network function that the specific VNF deployment is providing
-          required: false
+          example: __VNF-ID__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
+          required: true
           type: string
-        - name: nf-role
-          in: query
-          description: role in the network that this model will be providing
-          required: false
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
           type: string
-        - name: nf-naming-code
-          in: query
-          description: string assigned to this model used for naming purposes
-          required: false
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
           type: string
-  /network/generic-vnfs/generic-vnf/{vnf-id}/vf-modules/vf-module/{vf-module-id}/relationship-list/relationship:
+          example: __VLAN-INTERFACE__
+  /network/generic-vnfs/generic-vnf/{vnf-id}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}/relationship-list/relationship:
     put:
       tags:
         - Network
       summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkGenericVnfsGenericVnfVfModulesVfModuleRelationshipListRelationship
+      operationId: createOrUpdateNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressListRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -30080,14 +37156,34 @@ paths:
           description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: vf-module-id
+          example: __VNF-ID__
+        - name: interface-name
           in: path
-          description: Unique ID of vf-module.
+          description: Name that identifies the link aggregate interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
+          type: string
+          example: __VLAN-INTERFACE__
+        - name: l3-interface-ipv4-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -30096,7 +37192,7 @@ paths:
         - Network
       summary: delete an existing relationship
       description: delete an existing relationship
-      operationId: deleteNetworkGenericVnfsGenericVnfVfModulesVfModuleRelationshipListRelationship
+      operationId: deleteNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressListRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -30112,18 +37208,38 @@ paths:
           description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: vf-module-id
+          example: __VNF-ID__
+        - name: interface-name
           in: path
-          description: Unique ID of vf-module.
+          description: Name that identifies the link aggregate interface
           required: true
           type: string
-  /network/generic-vnfs/generic-vnf/{vnf-id}/vf-modules/vf-module/{vf-module-id}:
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
+          type: string
+          example: __VLAN-INTERFACE__
+        - name: l3-interface-ipv4-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
+  /network/generic-vnfs/generic-vnf/{vnf-id}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}:
     get:
       tags:
         - Network
-      summary: returns vf-module
-      description: returns vf-module
-      operationId: getNetworkGenericVnfsGenericVnfVfModulesVfModule
+      summary: returns l3-interface-ipv4-address-list
+      description: returns l3-interface-ipv4-address-list
+      operationId: getNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList
       produces:
         - application/json
         - application/xml
@@ -30131,7 +37247,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/vf-module"
+              $ref: "#/getDefinitions/l3-interface-ipv4-address-list"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -30140,11 +37256,31 @@ paths:
           description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: vf-module-id
+          example: __VNF-ID__
+        - name: interface-name
           in: path
-          description: Unique ID of vf-module.
+          description: Name that identifies the link aggregate interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
+          type: string
+          example: __VLAN-INTERFACE__
+        - name: l3-interface-ipv4-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
         - name: vnf-name
           in: query
           description: Name of VNF.
@@ -30228,47 +37364,67 @@ paths:
           description: string assigned to this model used for naming purposes
           required: false
           type: string
-        - name: vf-module-name
+        - name: interface-id
           in: query
-          description: Name of vf-module
+          description: ID of interface
           required: false
           type: string
-        - name: heat-stack-id
+        - name: interface-role
           in: query
-          description: Heat stack id corresponding to this instance.
+          description: Role assigned to this Interface, should use values as defined in ECOMP Yang models.
           required: false
           type: string
-        - name: model-invariant-id
+        - name: interface-id
           in: query
-          description: the ASDC model id for this resource or service model.
+          description: ID of interface
           required: false
           type: string
-        - name: model-version-id
+        - name: macaddr
           in: query
-          description: the ASDC model version for this resource or service model.
+          description: MAC address for the interface
           required: false
           type: string
-        - name: widget-model-id
+        - name: network-name
           in: query
-          description: the ASDC data dictionary widget model. This maps directly to the A&AI widget.
+          description: Name of the network
           required: false
           type: string
-        - name: widget-model-version
+        - name: vlan-id-inner
           in: query
-          description: the ASDC data dictionary version of the widget model.This maps directly to the A&AI version of the widget.
+          description: Inner VLAN tag
+          required: false
+          type: integer
+          format: int64
+        - name: vpn-key
+          in: query
+          description: This indicates the customers VPN ID associated with this vlan
           required: false
           type: string
-        - name: contrail-service-instance-fqdn
+        - name: vlan-id-inner
           in: query
-          description: the Contrail unique ID for a service-instance
+          description: Inner VLAN tag
+          required: false
+          type: integer
+          format: int64
+        - name: neutron-network-id
+          in: query
+          description: Neutron network id of the interface that address belongs to
+          required: false
+          type: string
+        - name: neutron-subnet-id
+          in: query
+          description: Neutron id of subnet that address belongs to
           required: false
           type: string
     put:
       tags:
         - Network
-      summary: create or update an existing vf-module
-      description: create or update an existing vf-module
-      operationId: createOrUpdateNetworkGenericVnfsGenericVnfVfModulesVfModule
+      summary: create or update an existing l3-interface-ipv4-address-list
+      description: |
+        Create or update an existing l3-interface-ipv4-address-list.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList
       consumes:
         - application/json
         - application/xml
@@ -30284,23 +37440,106 @@ paths:
           description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: vf-module-id
+          example: __VNF-ID__
+        - name: interface-name
           in: path
-          description: Unique ID of vf-module.
+          description: Name that identifies the link aggregate interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
+          type: string
+          example: __VLAN-INTERFACE__
+        - name: l3-interface-ipv4-address
+          in: path
+          description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
         - name: body
           in: body
-          description: vf-module object that needs to be created or updated
+          description: l3-interface-ipv4-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList.json)
           required: true
           schema:
-            $ref: "#/definitions/vf-module"
+            $ref: "#/definitions/l3-interface-ipv4-address-list"
+    patch:
+      tags:
+        - Network
+      summary: update an existing l3-interface-ipv4-address-list
+      description: |
+        Update an existing l3-interface-ipv4-address-list
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: vnf-id
+          in: path
+          description: Unique id of VNF.  This is unique across the graph.
+          required: true
+          type: string
+          example: __VNF-ID__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
+          type: string
+          example: __VLAN-INTERFACE__
+        - name: l3-interface-ipv4-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
+        - name: body
+          in: body
+          description: l3-interface-ipv4-address-list object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/l3-interface-ipv4-address-list"
     delete:
       tags:
         - Network
-      summary: delete an existing vf-module
-      description: delete an existing vf-module
-      operationId: deleteNetworkGenericVnfsGenericVnfVfModulesVfModule
+      summary: delete an existing l3-interface-ipv4-address-list
+      description: delete an existing l3-interface-ipv4-address-list
+      operationId: deleteNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList
       consumes:
         - application/json
         - application/xml
@@ -30316,23 +37555,141 @@ paths:
           description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: vf-module-id
+          example: __VNF-ID__
+        - name: interface-name
           in: path
-          description: Unique ID of vf-module.
+          description: Name that identifies the link aggregate interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
+          type: string
+          example: __VLAN-INTERFACE__
+        - name: l3-interface-ipv4-address
+          in: path
+          description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
         - name: resource-version
           in: query
           description: resource-version for concurrency
           required: true
           type: string
-  /network/generic-vnfs/generic-vnf/{vnf-id}/vf-modules:
+  /network/generic-vnfs/generic-vnf/{vnf-id}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}/relationship-list/relationship:
+    put:
+      tags:
+        - Network
+      summary: see node definition for valid relationships
+      operationId: createOrUpdateNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressListRelationshipListRelationship
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: vnf-id
+          in: path
+          description: Unique id of VNF.  This is unique across the graph.
+          required: true
+          type: string
+          example: __VNF-ID__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
+          type: string
+          example: __VLAN-INTERFACE__
+        - name: l3-interface-ipv6-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
+        - name: body
+          in: body
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList.json)
+          required: true
+          schema:
+            $ref: "#/definitions/relationship"
+    delete:
+      tags:
+        - Network
+      summary: delete an existing relationship
+      description: delete an existing relationship
+      operationId: deleteNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressListRelationshipListRelationship
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: vnf-id
+          in: path
+          description: Unique id of VNF.  This is unique across the graph.
+          required: true
+          type: string
+          example: __VNF-ID__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
+          type: string
+          example: __VLAN-INTERFACE__
+        - name: l3-interface-ipv6-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
+  /network/generic-vnfs/generic-vnf/{vnf-id}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}:
     get:
       tags:
         - Network
-      summary: returns vf-modules
-      description: returns vf-modules
-      operationId: getNetworkGenericVnfsGenericVnfVfModules
+      summary: returns l3-interface-ipv6-address-list
+      description: returns l3-interface-ipv6-address-list
+      operationId: getNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList
       produces:
         - application/json
         - application/xml
@@ -30340,7 +37697,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/vf-modules"
+              $ref: "#/getDefinitions/l3-interface-ipv6-address-list"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -30349,6 +37706,31 @@ paths:
           description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
+          example: __VNF-ID__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
+          type: string
+          example: __VLAN-INTERFACE__
+        - name: l3-interface-ipv6-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
         - name: vnf-name
           in: query
           description: Name of VNF.
@@ -30432,49 +37814,182 @@ paths:
           description: string assigned to this model used for naming purposes
           required: false
           type: string
-  /network/generic-vnfs/generic-vnf/{vnf-id}/licenses/license/{group-uuid}/{resource-uuid}/relationship-list/relationship:
-    put:
-      tags:
-        - Network
-      summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkGenericVnfsGenericVnfLicensesLicenseRelationshipListRelationship
-      consumes:
-        - application/json
-        - application/xml
-      produces:
-        - application/json
-        - application/xml
-      responses:
-        "default":
-          description: Response codes found in [response codes](https://wiki.onap.org/).
-      parameters:
-        - name: vnf-id
-          in: path
-          description: Unique id of VNF.  This is unique across the graph.
-          required: true
-          type: string
-        - name: group-uuid
+        - name: interface-id
+          in: query
+          description: ID of interface
+          required: false
+          type: string
+        - name: interface-role
+          in: query
+          description: Role assigned to this Interface, should use values as defined in ECOMP Yang models.
+          required: false
+          type: string
+        - name: interface-id
+          in: query
+          description: ID of interface
+          required: false
+          type: string
+        - name: macaddr
+          in: query
+          description: MAC address for the interface
+          required: false
+          type: string
+        - name: network-name
+          in: query
+          description: Name of the network
+          required: false
+          type: string
+        - name: vlan-id-inner
+          in: query
+          description: Inner VLAN tag
+          required: false
+          type: integer
+          format: int64
+        - name: vpn-key
+          in: query
+          description: This indicates the customers VPN ID associated with this vlan
+          required: false
+          type: string
+        - name: vlan-id-inner
+          in: query
+          description: Inner VLAN tag
+          required: false
+          type: integer
+          format: int64
+        - name: neutron-network-id
+          in: query
+          description: Neutron network id of the interface that address belongs to
+          required: false
+          type: string
+        - name: neutron-subnet-id
+          in: query
+          description: Neutron id of subnet that address belongs to
+          required: false
+          type: string
+    put:
+      tags:
+        - Network
+      summary: create or update an existing l3-interface-ipv6-address-list
+      description: |
+        Create or update an existing l3-interface-ipv6-address-list.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: vnf-id
           in: path
-          description: Unique ID for the license group the resource belongs to, should be uuid.
+          description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: resource-uuid
+          example: __VNF-ID__
+        - name: interface-name
           in: path
-          description: Unique ID of a license resource. 
+          description: Name that identifies the link aggregate interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
+          type: string
+          example: __VLAN-INTERFACE__
+        - name: l3-interface-ipv6-address
+          in: path
+          description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: l3-interface-ipv6-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList.json)
           required: true
           schema:
-            $ref: "#/definitions/relationship"
+            $ref: "#/definitions/l3-interface-ipv6-address-list"
+    patch:
+      tags:
+        - Network
+      summary: update an existing l3-interface-ipv6-address-list
+      description: |
+        Update an existing l3-interface-ipv6-address-list
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: vnf-id
+          in: path
+          description: Unique id of VNF.  This is unique across the graph.
+          required: true
+          type: string
+          example: __VNF-ID__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
+          type: string
+          example: __VLAN-INTERFACE__
+        - name: l3-interface-ipv6-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
+        - name: body
+          in: body
+          description: l3-interface-ipv6-address-list object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/l3-interface-ipv6-address-list"
     delete:
       tags:
         - Network
-      summary: delete an existing relationship
-      description: delete an existing relationship
-      operationId: deleteNetworkGenericVnfsGenericVnfLicensesLicenseRelationshipListRelationship
+      summary: delete an existing l3-interface-ipv6-address-list
+      description: delete an existing l3-interface-ipv6-address-list
+      operationId: deleteNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList
       consumes:
         - application/json
         - application/xml
@@ -30490,23 +38005,43 @@ paths:
           description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: group-uuid
+          example: __VNF-ID__
+        - name: interface-name
           in: path
-          description: Unique ID for the license group the resource belongs to, should be uuid.
+          description: Name that identifies the link aggregate interface
           required: true
           type: string
-        - name: resource-uuid
+          example: __INTERFACE-NAME__
+        - name: interface-name
           in: path
-          description: Unique ID of a license resource. 
+          description: Name given to the interface
           required: true
           type: string
-  /network/generic-vnfs/generic-vnf/{vnf-id}/licenses/license/{group-uuid}/{resource-uuid}:
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
+          type: string
+          example: __VLAN-INTERFACE__
+        - name: l3-interface-ipv6-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
+        - name: resource-version
+          in: query
+          description: resource-version for concurrency
+          required: true
+          type: string
+  /network/generic-vnfs/generic-vnf/{vnf-id}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}:
     get:
       tags:
         - Network
-      summary: returns license
-      description: returns license
-      operationId: getNetworkGenericVnfsGenericVnfLicensesLicense
+      summary: returns vlan
+      description: returns vlan
+      operationId: getNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlan
       produces:
         - application/json
         - application/xml
@@ -30514,7 +38049,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/license"
+              $ref: "#/getDefinitions/vlan"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -30523,16 +38058,25 @@ paths:
           description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: group-uuid
+          example: __VNF-ID__
+        - name: interface-name
           in: path
-          description: Unique ID for the license group the resource belongs to, should be uuid.
+          description: Name that identifies the link aggregate interface
           required: true
           type: string
-        - name: resource-uuid
+          example: __INTERFACE-NAME__
+        - name: interface-name
           in: path
-          description: Unique ID of a license resource. 
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
           required: true
           type: string
+          example: __VLAN-INTERFACE__
         - name: vnf-name
           in: query
           description: Name of VNF.
@@ -30616,12 +38160,51 @@ paths:
           description: string assigned to this model used for naming purposes
           required: false
           type: string
+        - name: interface-id
+          in: query
+          description: ID of interface
+          required: false
+          type: string
+        - name: interface-role
+          in: query
+          description: Role assigned to this Interface, should use values as defined in ECOMP Yang models.
+          required: false
+          type: string
+        - name: interface-id
+          in: query
+          description: ID of interface
+          required: false
+          type: string
+        - name: macaddr
+          in: query
+          description: MAC address for the interface
+          required: false
+          type: string
+        - name: network-name
+          in: query
+          description: Name of the network
+          required: false
+          type: string
+        - name: vlan-id-inner
+          in: query
+          description: Inner VLAN tag
+          required: false
+          type: integer
+          format: int64
+        - name: vpn-key
+          in: query
+          description: This indicates the customers VPN ID associated with this vlan
+          required: false
+          type: string
     put:
       tags:
         - Network
-      summary: create or update an existing license
-      description: create or update an existing license
-      operationId: createOrUpdateNetworkGenericVnfsGenericVnfLicensesLicense
+      summary: create or update an existing vlan
+      description: |
+        Create or update an existing vlan.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlan
       consumes:
         - application/json
         - application/xml
@@ -30637,28 +38220,94 @@ paths:
           description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: group-uuid
+          example: __VNF-ID__
+        - name: interface-name
           in: path
-          description: Unique ID for the license group the resource belongs to, should be uuid.
+          description: Name that identifies the link aggregate interface
           required: true
           type: string
-        - name: resource-uuid
+          example: __INTERFACE-NAME__
+        - name: interface-name
           in: path
-          description: Unique ID of a license resource. 
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
           required: true
           type: string
+          example: __VLAN-INTERFACE__
         - name: body
           in: body
-          description: license object that needs to be created or updated
+          description: vlan object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlan.json)
           required: true
           schema:
-            $ref: "#/definitions/license"
+            $ref: "#/definitions/vlan"
+    patch:
+      tags:
+        - Network
+      summary: update an existing vlan
+      description: |
+        Update an existing vlan
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlan
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: vnf-id
+          in: path
+          description: Unique id of VNF.  This is unique across the graph.
+          required: true
+          type: string
+          example: __VNF-ID__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
+          type: string
+          example: __VLAN-INTERFACE__
+        - name: body
+          in: body
+          description: vlan object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/vlan"
     delete:
       tags:
         - Network
-      summary: delete an existing license
-      description: delete an existing license
-      operationId: deleteNetworkGenericVnfsGenericVnfLicensesLicense
+      summary: delete an existing vlan
+      description: delete an existing vlan
+      operationId: deleteNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlan
       consumes:
         - application/json
         - application/xml
@@ -30674,28 +38323,37 @@ paths:
           description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: group-uuid
+          example: __VNF-ID__
+        - name: interface-name
           in: path
-          description: Unique ID for the license group the resource belongs to, should be uuid.
+          description: Name that identifies the link aggregate interface
           required: true
           type: string
-        - name: resource-uuid
+          example: __INTERFACE-NAME__
+        - name: interface-name
           in: path
-          description: Unique ID of a license resource. 
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
           required: true
           type: string
+          example: __VLAN-INTERFACE__
         - name: resource-version
           in: query
           description: resource-version for concurrency
           required: true
           type: string
-  /network/generic-vnfs/generic-vnf/{vnf-id}/licenses:
+  /network/generic-vnfs/generic-vnf/{vnf-id}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans:
     get:
       tags:
         - Network
-      summary: returns licenses
-      description: returns licenses
-      operationId: getNetworkGenericVnfsGenericVnfLicenses
+      summary: returns vlans
+      description: returns vlans
+      operationId: getNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlans
       produces:
         - application/json
         - application/xml
@@ -30703,7 +38361,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/licenses"
+              $ref: "#/getDefinitions/vlans"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -30712,6 +38370,19 @@ paths:
           description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
+          example: __VNF-ID__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
         - name: vnf-name
           in: query
           description: Name of VNF.
@@ -30795,12 +38466,37 @@ paths:
           description: string assigned to this model used for naming purposes
           required: false
           type: string
-  /network/generic-vnfs/generic-vnf/{vnf-id}/entitlements/entitlement/{group-uuid}/{resource-uuid}/relationship-list/relationship:
+        - name: interface-id
+          in: query
+          description: ID of interface
+          required: false
+          type: string
+        - name: interface-role
+          in: query
+          description: Role assigned to this Interface, should use values as defined in ECOMP Yang models.
+          required: false
+          type: string
+        - name: interface-id
+          in: query
+          description: ID of interface
+          required: false
+          type: string
+        - name: macaddr
+          in: query
+          description: MAC address for the interface
+          required: false
+          type: string
+        - name: network-name
+          in: query
+          description: Name of the network
+          required: false
+          type: string
+  /network/generic-vnfs/generic-vnf/{vnf-id}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/sriov-vfs/sriov-vf/{pci-id}/relationship-list/relationship:
     put:
       tags:
         - Network
       summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkGenericVnfsGenericVnfEntitlementsEntitlementRelationshipListRelationship
+      operationId: createOrUpdateNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfsSriovVfRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -30816,19 +38512,28 @@ paths:
           description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: group-uuid
+          example: __VNF-ID__
+        - name: interface-name
           in: path
-          description: Unique ID for the entitlement group the resource comes from, should be uuid.
+          description: Name that identifies the link aggregate interface
           required: true
           type: string
-        - name: resource-uuid
+          example: __INTERFACE-NAME__
+        - name: interface-name
           in: path
-          description: Unique ID of an entitlement resource. 
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: pci-id
+          in: path
+          description: PCI ID used to identify the sriov-vf
           required: true
           type: string
+          example: __PCI-ID__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfsSriovVf.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -30837,7 +38542,7 @@ paths:
         - Network
       summary: delete an existing relationship
       description: delete an existing relationship
-      operationId: deleteNetworkGenericVnfsGenericVnfEntitlementsEntitlementRelationshipListRelationship
+      operationId: deleteNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfsSriovVfRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -30853,23 +38558,32 @@ paths:
           description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: group-uuid
+          example: __VNF-ID__
+        - name: interface-name
           in: path
-          description: Unique ID for the entitlement group the resource comes from, should be uuid.
+          description: Name that identifies the link aggregate interface
           required: true
           type: string
-        - name: resource-uuid
+          example: __INTERFACE-NAME__
+        - name: interface-name
           in: path
-          description: Unique ID of an entitlement resource. 
+          description: Name given to the interface
           required: true
           type: string
-  /network/generic-vnfs/generic-vnf/{vnf-id}/entitlements/entitlement/{group-uuid}/{resource-uuid}:
+          example: __INTERFACE-NAME__
+        - name: pci-id
+          in: path
+          description: PCI ID used to identify the sriov-vf
+          required: true
+          type: string
+          example: __PCI-ID__
+  /network/generic-vnfs/generic-vnf/{vnf-id}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/sriov-vfs/sriov-vf/{pci-id}:
     get:
       tags:
         - Network
-      summary: returns entitlement
-      description: returns entitlement
-      operationId: getNetworkGenericVnfsGenericVnfEntitlementsEntitlement
+      summary: returns sriov-vf
+      description: returns sriov-vf
+      operationId: getNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfsSriovVf
       produces:
         - application/json
         - application/xml
@@ -30877,7 +38591,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/entitlement"
+              $ref: "#/getDefinitions/sriov-vf"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -30886,16 +38600,25 @@ paths:
           description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: group-uuid
+          example: __VNF-ID__
+        - name: interface-name
           in: path
-          description: Unique ID for the entitlement group the resource comes from, should be uuid.
+          description: Name that identifies the link aggregate interface
           required: true
           type: string
-        - name: resource-uuid
+          example: __INTERFACE-NAME__
+        - name: interface-name
           in: path
-          description: Unique ID of an entitlement resource. 
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: pci-id
+          in: path
+          description: PCI ID used to identify the sriov-vf
           required: true
           type: string
+          example: __PCI-ID__
         - name: vnf-name
           in: query
           description: Name of VNF.
@@ -30979,12 +38702,60 @@ paths:
           description: string assigned to this model used for naming purposes
           required: false
           type: string
+        - name: interface-id
+          in: query
+          description: ID of interface
+          required: false
+          type: string
+        - name: interface-role
+          in: query
+          description: Role assigned to this Interface, should use values as defined in ECOMP Yang models.
+          required: false
+          type: string
+        - name: interface-id
+          in: query
+          description: ID of interface
+          required: false
+          type: string
+        - name: macaddr
+          in: query
+          description: MAC address for the interface
+          required: false
+          type: string
+        - name: network-name
+          in: query
+          description: Name of the network
+          required: false
+          type: string
+        - name: vf-vlan-filter
+          in: query
+          description: This metadata provides option to specify list of VLAN filters applied on VF to pass the traffic to VM.
+          required: false
+          type: string
+        - name: vf-mac-filter
+          in: query
+          description: When MAC filters are specified, VF-agent service configures VFs to do MAC level filtering before the traffic is passed to VM.
+          required: false
+          type: string
+        - name: vf-vlan-strip
+          in: query
+          description: When this field is set to true, VF will configured to strip the outer TAG before the traffic is passed to VM.
+          required: false
+          type: boolean
+        - name: neutron-network-id
+          in: query
+          description: Neutron network id of the interface
+          required: false
+          type: string
     put:
       tags:
         - Network
-      summary: create or update an existing entitlement
-      description: create or update an existing entitlement
-      operationId: createOrUpdateNetworkGenericVnfsGenericVnfEntitlementsEntitlement
+      summary: create or update an existing sriov-vf
+      description: |
+        Create or update an existing sriov-vf.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfsSriovVf
       consumes:
         - application/json
         - application/xml
@@ -31000,28 +38771,48 @@ paths:
           description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: group-uuid
+          example: __VNF-ID__
+        - name: interface-name
           in: path
-          description: Unique ID for the entitlement group the resource comes from, should be uuid.
+          description: Name that identifies the link aggregate interface
           required: true
           type: string
-        - name: resource-uuid
+          example: __INTERFACE-NAME__
+        - name: interface-name
           in: path
-          description: Unique ID of an entitlement resource. 
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: pci-id
+          in: path
+          description: PCI ID used to identify the sriov-vf
           required: true
           type: string
+          example: __PCI-ID__
         - name: body
           in: body
-          description: entitlement object that needs to be created or updated
+          description: sriov-vf object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfsSriovVf.json)
           required: true
           schema:
-            $ref: "#/definitions/entitlement"
-    delete:
+            $ref: "#/definitions/sriov-vf"
+    patch:
       tags:
         - Network
-      summary: delete an existing entitlement
-      description: delete an existing entitlement
-      operationId: deleteNetworkGenericVnfsGenericVnfEntitlementsEntitlement
+      summary: update an existing sriov-vf
+      description: |
+        Update an existing sriov-vf
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfsSriovVf
       consumes:
         - application/json
         - application/xml
@@ -31037,36 +38828,44 @@ paths:
           description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: group-uuid
+          example: __VNF-ID__
+        - name: interface-name
           in: path
-          description: Unique ID for the entitlement group the resource comes from, should be uuid.
+          description: Name that identifies the link aggregate interface
           required: true
           type: string
-        - name: resource-uuid
+          example: __INTERFACE-NAME__
+        - name: interface-name
           in: path
-          description: Unique ID of an entitlement resource. 
+          description: Name given to the interface
           required: true
           type: string
-        - name: resource-version
-          in: query
-          description: resource-version for concurrency
+          example: __INTERFACE-NAME__
+        - name: pci-id
+          in: path
+          description: PCI ID used to identify the sriov-vf
           required: true
           type: string
-  /network/generic-vnfs/generic-vnf/{vnf-id}/entitlements:
-    get:
+          example: __PCI-ID__
+        - name: body
+          in: body
+          description: sriov-vf object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/sriov-vf"
+    delete:
       tags:
         - Network
-      summary: returns entitlements
-      description: returns entitlements
-      operationId: getNetworkGenericVnfsGenericVnfEntitlements
+      summary: delete an existing sriov-vf
+      description: delete an existing sriov-vf
+      operationId: deleteNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfsSriovVf
+      consumes:
+        - application/json
+        - application/xml
       produces:
         - application/json
         - application/xml
       responses:
-        "200":
-          description: successful operation
-          schema:
-              $ref: "#/definitions/entitlements"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -31075,96 +38874,37 @@ paths:
           description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: vnf-name
-          in: query
-          description: Name of VNF.
-          required: false
+          example: __VNF-ID__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
+          required: true
           type: string
-        - name: vnf-name2
-          in: query
-          description: Alternate name of VNF.
-          required: false
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
           type: string
-        - name: vnf-type
+          example: __INTERFACE-NAME__
+        - name: pci-id
+          in: path
+          description: PCI ID used to identify the sriov-vf
+          required: true
+          type: string
+          example: __PCI-ID__
+        - name: resource-version
           in: query
-          description: String capturing type of vnf, that was intended to identify the ASDC resource.  This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures.
-          required: false
-          type: string
-        - name: service-id
-          in: query
-          description: Unique identifier of service, does not necessarily map to ASDC service models.  SOON TO BE DEPRECATED
-          required: false
-          type: string
-        - name: regional-resource-zone
-          in: query
-          description: Regional way of organizing pservers, source of truth should define values
-          required: false
-          type: string
-        - name: prov-status
-          in: query
-          description: Trigger for operational monitoring of this resource by Service Assurance systems.
-          required: false
-          type: string
-        - name: heat-stack-id
-          in: query
-          description: Heat stack id corresponding to this instance, managed by MSO
-          required: false
-          type: string
-        - name: in-maint
-          in: query
-          required: false
-          type: boolean
-        - name: is-closed-loop-disabled
-          in: query
-          required: false
-          type: boolean
-        - name: model-invariant-id
-          in: query
-          description: the ASDC model id for this resource or service model.
-          required: false
-          type: string
-        - name: model-version-id
-          in: query
-          description: the ASDC model version for this resource or service model.
-          required: false
-          type: string
-        - name: widget-model-id
-          in: query
-          description: the ASDC data dictionary widget model. This maps directly to the A&AI widget.
-          required: false
-          type: string
-        - name: widget-model-version
-          in: query
-          description: the ASDC data dictionary version of the widget model.This maps directly to the A&AI version of the widget.
-          required: false
-          type: string
-        - name: nf-type
-          in: query
-          description: Generic description of the type of NF
-          required: false
-          type: string
-        - name: nf-function
-          in: query
-          description: English description of Network function that the specific VNF deployment is providing
-          required: false
-          type: string
-        - name: nf-role
-          in: query
-          description: role in the network that this model will be providing
-          required: false
-          type: string
-        - name: nf-naming-code
-          in: query
-          description: string assigned to this model used for naming purposes
-          required: false
+          description: resource-version for concurrency
+          required: true
           type: string
-  /network/generic-vnfs/generic-vnf/{vnf-id}:
+  /network/generic-vnfs/generic-vnf/{vnf-id}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/sriov-vfs:
     get:
       tags:
         - Network
-      summary: returns generic-vnf
-      description: returns generic-vnf
-      operationId: getNetworkGenericVnfsGenericVnf
+      summary: returns sriov-vfs
+      description: returns sriov-vfs
+      operationId: getNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfs
       produces:
         - application/json
         - application/xml
@@ -31172,7 +38912,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/generic-vnf"
+              $ref: "#/getDefinitions/sriov-vfs"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -31181,6 +38921,19 @@ paths:
           description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
+          example: __VNF-ID__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
         - name: vnf-name
           in: query
           description: Name of VNF.
@@ -31264,250 +39017,37 @@ paths:
           description: string assigned to this model used for naming purposes
           required: false
           type: string
-    put:
-      tags:
-        - Network
-      summary: create or update an existing generic-vnf
-      description: create or update an existing generic-vnf
-      operationId: createOrUpdateNetworkGenericVnfsGenericVnf
-      consumes:
-        - application/json
-        - application/xml
-      produces:
-        - application/json
-        - application/xml
-      responses:
-        "default":
-          description: Response codes found in [response codes](https://wiki.onap.org/).
-      parameters:
-        - name: vnf-id
-          in: path
-          description: Unique id of VNF.  This is unique across the graph.
-          required: true
-          type: string
-        - name: body
-          in: body
-          description: generic-vnf object that needs to be created or updated
-          required: true
-          schema:
-            $ref: "#/definitions/generic-vnf"
-    delete:
-      tags:
-        - Network
-      summary: delete an existing generic-vnf
-      description: delete an existing generic-vnf
-      operationId: deleteNetworkGenericVnfsGenericVnf
-      consumes:
-        - application/json
-        - application/xml
-      produces:
-        - application/json
-        - application/xml
-      responses:
-        "default":
-          description: Response codes found in [response codes](https://wiki.onap.org/).
-      parameters:
-        - name: vnf-id
-          in: path
-          description: Unique id of VNF.  This is unique across the graph.
-          required: true
-          type: string
-        - name: resource-version
+        - name: interface-id
           in: query
-          description: resource-version for concurrency
-          required: true
-          type: string
-  /network/generic-vnfs:
-    get:
-      tags:
-        - Network
-      summary: returns generic-vnfs
-      description: returns generic-vnfs
-      operationId: getNetworkGenericVnfs
-      produces:
-        - application/json
-        - application/xml
-      responses:
-        "200":
-          description: successful operation
-          schema:
-              $ref: "#/definitions/generic-vnfs"
-        "default":
-          description: Response codes found in [response codes](https://wiki.onap.org/).
-  /network/lag-links/lag-link/{link-name}/relationship-list/relationship:
-    put:
-      tags:
-        - Network
-      summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkLagLinksLagLinkRelationshipListRelationship
-      consumes:
-        - application/json
-        - application/xml
-      produces:
-        - application/json
-        - application/xml
-      responses:
-        "default":
-          description: Response codes found in [response codes](https://wiki.onap.org/).
-      parameters:
-        - name: link-name
-          in: path
-          description: Alphabetical concatenation of lag-interface names
-          required: true
-          type: string
-        - name: body
-          in: body
-          description: relationship object that needs to be created or updated
-          required: true
-          schema:
-            $ref: "#/definitions/relationship"
-    delete:
-      tags:
-        - Network
-      summary: delete an existing relationship
-      description: delete an existing relationship
-      operationId: deleteNetworkLagLinksLagLinkRelationshipListRelationship
-      consumes:
-        - application/json
-        - application/xml
-      produces:
-        - application/json
-        - application/xml
-      responses:
-        "default":
-          description: Response codes found in [response codes](https://wiki.onap.org/).
-      parameters:
-        - name: link-name
-          in: path
-          description: Alphabetical concatenation of lag-interface names
-          required: true
+          description: ID of interface
+          required: false
           type: string
-  /network/lag-links/lag-link/{link-name}:
-    get:
-      tags:
-        - Network
-      summary: returns lag-link
-      description: returns lag-link
-      operationId: getNetworkLagLinksLagLink
-      produces:
-        - application/json
-        - application/xml
-      responses:
-        "200":
-          description: successful operation
-          schema:
-              $ref: "#/definitions/lag-link"
-        "default":
-          description: Response codes found in [response codes](https://wiki.onap.org/).
-      parameters:
-        - name: link-name
-          in: path
-          description: Alphabetical concatenation of lag-interface names
-          required: true
+        - name: interface-role
+          in: query
+          description: Role assigned to this Interface, should use values as defined in ECOMP Yang models.
+          required: false
           type: string
-    put:
-      tags:
-        - Network
-      summary: create or update an existing lag-link
-      description: create or update an existing lag-link
-      operationId: createOrUpdateNetworkLagLinksLagLink
-      consumes:
-        - application/json
-        - application/xml
-      produces:
-        - application/json
-        - application/xml
-      responses:
-        "default":
-          description: Response codes found in [response codes](https://wiki.onap.org/).
-      parameters:
-        - name: link-name
-          in: path
-          description: Alphabetical concatenation of lag-interface names
-          required: true
+        - name: interface-id
+          in: query
+          description: ID of interface
+          required: false
           type: string
-        - name: body
-          in: body
-          description: lag-link object that needs to be created or updated
-          required: true
-          schema:
-            $ref: "#/definitions/lag-link"
-    delete:
-      tags:
-        - Network
-      summary: delete an existing lag-link
-      description: delete an existing lag-link
-      operationId: deleteNetworkLagLinksLagLink
-      consumes:
-        - application/json
-        - application/xml
-      produces:
-        - application/json
-        - application/xml
-      responses:
-        "default":
-          description: Response codes found in [response codes](https://wiki.onap.org/).
-      parameters:
-        - name: link-name
-          in: path
-          description: Alphabetical concatenation of lag-interface names
-          required: true
+        - name: macaddr
+          in: query
+          description: MAC address for the interface
+          required: false
           type: string
-        - name: resource-version
+        - name: network-name
           in: query
-          description: resource-version for concurrency
-          required: true
+          description: Name of the network
+          required: false
           type: string
-  /network/lag-links:
-    get:
-      tags:
-        - Network
-      summary: returns lag-links
-      description: returns lag-links
-      operationId: getNetworkLagLinks
-      produces:
-        - application/json
-        - application/xml
-      responses:
-        "200":
-          description: successful operation
-          schema:
-              $ref: "#/definitions/lag-links"
-        "default":
-          description: Response codes found in [response codes](https://wiki.onap.org/).
-  /network/newvces/newvce/{vnf-id2}/relationship-list/relationship:
+  /network/generic-vnfs/generic-vnf/{vnf-id}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/relationship-list/relationship:
     put:
       tags:
         - Network
       summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkNewvcesNewvceRelationshipListRelationship
-      consumes:
-        - application/json
-        - application/xml
-      produces:
-        - application/json
-        - application/xml
-      responses:
-        "default":
-          description: Response codes found in [response codes](https://wiki.onap.org/).
-      parameters:
-        - name: vnf-id2
-          in: path
-          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
-          required: true
-          type: string
-        - name: body
-          in: body
-          description: relationship object that needs to be created or updated
-          required: true
-          schema:
-            $ref: "#/definitions/relationship"
-    delete:
-      tags:
-        - Network
-      summary: delete an existing relationship
-      description: delete an existing relationship
-      operationId: deleteNetworkNewvcesNewvceRelationshipListRelationship
+      operationId: createOrUpdateNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -31518,45 +39058,27 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id2
+        - name: vnf-id
           in: path
-          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
+          description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-  /network/newvces/newvce/{vnf-id2}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/relationship-list/relationship:
-    put:
-      tags:
-        - Network
-      summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkNewvcesNewvceLInterfacesLInterfaceVlansVlanRelationshipListRelationship
-      consumes:
-        - application/json
-        - application/xml
-      produces:
-        - application/json
-        - application/xml
-      responses:
-        "default":
-          description: Response codes found in [response codes](https://wiki.onap.org/).
-      parameters:
-        - name: vnf-id2
+          example: __VNF-ID__
+        - name: interface-name
           in: path
-          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
+          description: Name that identifies the link aggregate interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
-        - name: vlan-interface
-          in: path
-          description: String that identifies the interface
-          required: true
-          type: string
+          example: __INTERFACE-NAME__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterface.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -31565,7 +39087,7 @@ paths:
         - Network
       summary: delete an existing relationship
       description: delete an existing relationship
-      operationId: deleteNetworkNewvcesNewvceLInterfacesLInterfaceVlansVlanRelationshipListRelationship
+      operationId: deleteNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -31576,27 +39098,30 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id2
+        - name: vnf-id
           in: path
-          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
+          description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
+          example: __VNF-ID__
         - name: interface-name
           in: path
-          description: Name given to the interface
+          description: Name that identifies the link aggregate interface
           required: true
           type: string
-        - name: vlan-interface
+          example: __INTERFACE-NAME__
+        - name: interface-name
           in: path
-          description: String that identifies the interface
+          description: Name given to the interface
           required: true
           type: string
-  /network/newvces/newvce/{vnf-id2}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}/relationship-list/relationship:
+          example: __INTERFACE-NAME__
+  /network/generic-vnfs/generic-vnf/{vnf-id}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}/relationship-list/relationship:
     put:
       tags:
         - Network
       summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkNewvcesNewvceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressListRelationshipListRelationship
+      operationId: createOrUpdateNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressListRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -31607,29 +39132,33 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id2
+        - name: vnf-id
           in: path
-          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
+          description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
+          example: __VNF-ID__
         - name: interface-name
           in: path
-          description: Name given to the interface
+          description: Name that identifies the link aggregate interface
           required: true
           type: string
-        - name: vlan-interface
+          example: __INTERFACE-NAME__
+        - name: interface-name
           in: path
-          description: String that identifies the interface
+          description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: l3-interface-ipv4-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -31638,7 +39167,7 @@ paths:
         - Network
       summary: delete an existing relationship
       description: delete an existing relationship
-      operationId: deleteNetworkNewvcesNewvceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressListRelationshipListRelationship
+      operationId: deleteNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressListRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -31649,33 +39178,37 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id2
+        - name: vnf-id
           in: path
-          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
+          description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
+          example: __VNF-ID__
         - name: interface-name
           in: path
-          description: Name given to the interface
+          description: Name that identifies the link aggregate interface
           required: true
           type: string
-        - name: vlan-interface
+          example: __INTERFACE-NAME__
+        - name: interface-name
           in: path
-          description: String that identifies the interface
+          description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: l3-interface-ipv4-address
           in: path
           description: IP address
           required: true
           type: string
-  /network/newvces/newvce/{vnf-id2}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}:
+          example: __L3-INTERFACE-IPV4-ADDRESS__
+  /network/generic-vnfs/generic-vnf/{vnf-id}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}:
     get:
       tags:
         - Network
       summary: returns l3-interface-ipv4-address-list
       description: returns l3-interface-ipv4-address-list
-      operationId: getNetworkNewvcesNewvceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList
+      operationId: getNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList
       produces:
         - application/json
         - application/xml
@@ -31683,30 +39216,34 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/l3-interface-ipv4-address-list"
+              $ref: "#/getDefinitions/l3-interface-ipv4-address-list"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id2
+        - name: vnf-id
           in: path
-          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
+          description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
+          example: __VNF-ID__
         - name: interface-name
           in: path
-          description: Name given to the interface
+          description: Name that identifies the link aggregate interface
           required: true
           type: string
-        - name: vlan-interface
+          example: __INTERFACE-NAME__
+        - name: interface-name
           in: path
-          description: String that identifies the interface
+          description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: l3-interface-ipv4-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
         - name: vnf-name
           in: query
           description: Name of VNF.
@@ -31722,9 +39259,19 @@ paths:
           description: String capturing type of vnf, that was intended to identify the ASDC resource.  This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures.
           required: false
           type: string
+        - name: service-id
+          in: query
+          description: Unique identifier of service, does not necessarily map to ASDC service models.  SOON TO BE DEPRECATED
+          required: false
+          type: string
+        - name: regional-resource-zone
+          in: query
+          description: Regional way of organizing pservers, source of truth should define values
+          required: false
+          type: string
         - name: prov-status
           in: query
-          description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems.
+          description: Trigger for operational monitoring of this resource by Service Assurance systems.
           required: false
           type: string
         - name: heat-stack-id
@@ -31732,30 +39279,77 @@ paths:
           description: Heat stack id corresponding to this instance, managed by MSO
           required: false
           type: string
+        - name: in-maint
+          in: query
+          required: false
+          type: boolean
+        - name: is-closed-loop-disabled
+          in: query
+          required: false
+          type: boolean
+        - name: model-invariant-id
+          in: query
+          description: the ASDC model id for this resource or service model.
+          required: false
+          type: string
+        - name: model-version-id
+          in: query
+          description: the ASDC model version for this resource or service model.
+          required: false
+          type: string
+        - name: widget-model-id
+          in: query
+          description: the ASDC data dictionary widget model. This maps directly to the A&AI widget.
+          required: false
+          type: string
+        - name: widget-model-version
+          in: query
+          description: the ASDC data dictionary version of the widget model.This maps directly to the A&AI version of the widget.
+          required: false
+          type: string
+        - name: nf-type
+          in: query
+          description: Generic description of the type of NF
+          required: false
+          type: string
+        - name: nf-function
+          in: query
+          description: English description of Network function that the specific VNF deployment is providing
+          required: false
+          type: string
+        - name: nf-role
+          in: query
+          description: role in the network that this model will be providing
+          required: false
+          type: string
+        - name: nf-naming-code
+          in: query
+          description: string assigned to this model used for naming purposes
+          required: false
+          type: string
         - name: interface-id
           in: query
           description: ID of interface
           required: false
           type: string
-        - name: macaddr
+        - name: interface-role
           in: query
-          description: MAC address for the interface
+          description: Role assigned to this Interface, should use values as defined in ECOMP Yang models.
           required: false
           type: string
-        - name: network-name
+        - name: interface-id
           in: query
-          description: Name of the network
+          description: ID of interface
           required: false
           type: string
-        - name: vlan-id-inner
+        - name: macaddr
           in: query
-          description: Inner VLAN tag
+          description: MAC address for the interface
           required: false
-          type: integer
-          format: int64
-        - name: vpn-key
+          type: string
+        - name: network-name
           in: query
-          description: This indicates the customers VPN ID associated with this vlan
+          description: Name of the network
           required: false
           type: string
         - name: vlan-id-inner
@@ -31778,8 +39372,11 @@ paths:
       tags:
         - Network
       summary: create or update an existing l3-interface-ipv4-address-list
-      description: create or update an existing l3-interface-ipv4-address-list
-      operationId: createOrUpdateNetworkNewvcesNewvceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList
+      description: |
+        Create or update an existing l3-interface-ipv4-address-list.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList
       consumes:
         - application/json
         - application/xml
@@ -31790,38 +39387,53 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id2
+        - name: vnf-id
           in: path
-          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
+          description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
+          example: __VNF-ID__
         - name: interface-name
           in: path
-          description: Name given to the interface
+          description: Name that identifies the link aggregate interface
           required: true
           type: string
-        - name: vlan-interface
+          example: __INTERFACE-NAME__
+        - name: interface-name
           in: path
-          description: String that identifies the interface
+          description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: l3-interface-ipv4-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
         - name: body
           in: body
-          description: l3-interface-ipv4-address-list object that needs to be created or updated
+          description: l3-interface-ipv4-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList.json)
           required: true
           schema:
             $ref: "#/definitions/l3-interface-ipv4-address-list"
-    delete:
+    patch:
       tags:
         - Network
-      summary: delete an existing l3-interface-ipv4-address-list
-      description: delete an existing l3-interface-ipv4-address-list
-      operationId: deleteNetworkNewvcesNewvceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList
+      summary: update an existing l3-interface-ipv4-address-list
+      description: |
+        Update an existing l3-interface-ipv4-address-list
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList
       consumes:
         - application/json
         - application/xml
@@ -31832,37 +39444,87 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id2
+        - name: vnf-id
           in: path
-          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
+          description: Unique id of VNF.  This is unique across the graph.
+          required: true
+          type: string
+          example: __VNF-ID__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
-        - name: vlan-interface
+          example: __INTERFACE-NAME__
+        - name: l3-interface-ipv4-address
           in: path
-          description: String that identifies the interface
+          description: IP address
+          required: true
+          type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
+        - name: body
+          in: body
+          description: l3-interface-ipv4-address-list object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/l3-interface-ipv4-address-list"
+    delete:
+      tags:
+        - Network
+      summary: delete an existing l3-interface-ipv4-address-list
+      description: delete an existing l3-interface-ipv4-address-list
+      operationId: deleteNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: vnf-id
+          in: path
+          description: Unique id of VNF.  This is unique across the graph.
+          required: true
+          type: string
+          example: __VNF-ID__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: l3-interface-ipv4-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
         - name: resource-version
           in: query
           description: resource-version for concurrency
           required: true
           type: string
-  /network/newvces/newvce/{vnf-id2}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}/relationship-list/relationship:
+  /network/generic-vnfs/generic-vnf/{vnf-id}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}/relationship-list/relationship:
     put:
       tags:
         - Network
       summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkNewvcesNewvceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressListRelationshipListRelationship
+      operationId: createOrUpdateNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressListRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -31873,29 +39535,33 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id2
+        - name: vnf-id
           in: path
-          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
+          description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
+          example: __VNF-ID__
         - name: interface-name
           in: path
-          description: Name given to the interface
+          description: Name that identifies the link aggregate interface
           required: true
           type: string
-        - name: vlan-interface
+          example: __INTERFACE-NAME__
+        - name: interface-name
           in: path
-          description: String that identifies the interface
+          description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: l3-interface-ipv6-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -31904,7 +39570,7 @@ paths:
         - Network
       summary: delete an existing relationship
       description: delete an existing relationship
-      operationId: deleteNetworkNewvcesNewvceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressListRelationshipListRelationship
+      operationId: deleteNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressListRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -31915,33 +39581,37 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id2
+        - name: vnf-id
           in: path
-          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
+          description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
+          example: __VNF-ID__
         - name: interface-name
           in: path
-          description: Name given to the interface
+          description: Name that identifies the link aggregate interface
           required: true
           type: string
-        - name: vlan-interface
+          example: __INTERFACE-NAME__
+        - name: interface-name
           in: path
-          description: String that identifies the interface
+          description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: l3-interface-ipv6-address
           in: path
           description: IP address
           required: true
           type: string
-  /network/newvces/newvce/{vnf-id2}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}:
+          example: __L3-INTERFACE-IPV6-ADDRESS__
+  /network/generic-vnfs/generic-vnf/{vnf-id}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}:
     get:
       tags:
         - Network
       summary: returns l3-interface-ipv6-address-list
       description: returns l3-interface-ipv6-address-list
-      operationId: getNetworkNewvcesNewvceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList
+      operationId: getNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList
       produces:
         - application/json
         - application/xml
@@ -31949,30 +39619,34 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/l3-interface-ipv6-address-list"
+              $ref: "#/getDefinitions/l3-interface-ipv6-address-list"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id2
+        - name: vnf-id
           in: path
-          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
+          description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
+          example: __VNF-ID__
         - name: interface-name
           in: path
-          description: Name given to the interface
+          description: Name that identifies the link aggregate interface
           required: true
           type: string
-        - name: vlan-interface
+          example: __INTERFACE-NAME__
+        - name: interface-name
           in: path
-          description: String that identifies the interface
+          description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: l3-interface-ipv6-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
         - name: vnf-name
           in: query
           description: Name of VNF.
@@ -31988,9 +39662,19 @@ paths:
           description: String capturing type of vnf, that was intended to identify the ASDC resource.  This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures.
           required: false
           type: string
+        - name: service-id
+          in: query
+          description: Unique identifier of service, does not necessarily map to ASDC service models.  SOON TO BE DEPRECATED
+          required: false
+          type: string
+        - name: regional-resource-zone
+          in: query
+          description: Regional way of organizing pservers, source of truth should define values
+          required: false
+          type: string
         - name: prov-status
           in: query
-          description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems.
+          description: Trigger for operational monitoring of this resource by Service Assurance systems.
           required: false
           type: string
         - name: heat-stack-id
@@ -31998,30 +39682,77 @@ paths:
           description: Heat stack id corresponding to this instance, managed by MSO
           required: false
           type: string
+        - name: in-maint
+          in: query
+          required: false
+          type: boolean
+        - name: is-closed-loop-disabled
+          in: query
+          required: false
+          type: boolean
+        - name: model-invariant-id
+          in: query
+          description: the ASDC model id for this resource or service model.
+          required: false
+          type: string
+        - name: model-version-id
+          in: query
+          description: the ASDC model version for this resource or service model.
+          required: false
+          type: string
+        - name: widget-model-id
+          in: query
+          description: the ASDC data dictionary widget model. This maps directly to the A&AI widget.
+          required: false
+          type: string
+        - name: widget-model-version
+          in: query
+          description: the ASDC data dictionary version of the widget model.This maps directly to the A&AI version of the widget.
+          required: false
+          type: string
+        - name: nf-type
+          in: query
+          description: Generic description of the type of NF
+          required: false
+          type: string
+        - name: nf-function
+          in: query
+          description: English description of Network function that the specific VNF deployment is providing
+          required: false
+          type: string
+        - name: nf-role
+          in: query
+          description: role in the network that this model will be providing
+          required: false
+          type: string
+        - name: nf-naming-code
+          in: query
+          description: string assigned to this model used for naming purposes
+          required: false
+          type: string
         - name: interface-id
           in: query
           description: ID of interface
           required: false
           type: string
-        - name: macaddr
+        - name: interface-role
           in: query
-          description: MAC address for the interface
+          description: Role assigned to this Interface, should use values as defined in ECOMP Yang models.
           required: false
           type: string
-        - name: network-name
+        - name: interface-id
           in: query
-          description: Name of the network
+          description: ID of interface
           required: false
           type: string
-        - name: vlan-id-inner
+        - name: macaddr
           in: query
-          description: Inner VLAN tag
+          description: MAC address for the interface
           required: false
-          type: integer
-          format: int64
-        - name: vpn-key
+          type: string
+        - name: network-name
           in: query
-          description: This indicates the customers VPN ID associated with this vlan
+          description: Name of the network
           required: false
           type: string
         - name: vlan-id-inner
@@ -32044,8 +39775,11 @@ paths:
       tags:
         - Network
       summary: create or update an existing l3-interface-ipv6-address-list
-      description: create or update an existing l3-interface-ipv6-address-list
-      operationId: createOrUpdateNetworkNewvcesNewvceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList
+      description: |
+        Create or update an existing l3-interface-ipv6-address-list.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList
       consumes:
         - application/json
         - application/xml
@@ -32056,38 +39790,99 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id2
+        - name: vnf-id
           in: path
-          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
+          description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
+          example: __VNF-ID__
         - name: interface-name
           in: path
-          description: Name given to the interface
+          description: Name that identifies the link aggregate interface
           required: true
           type: string
-        - name: vlan-interface
+          example: __INTERFACE-NAME__
+        - name: interface-name
           in: path
-          description: String that identifies the interface
+          description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: l3-interface-ipv6-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
         - name: body
           in: body
-          description: l3-interface-ipv6-address-list object that needs to be created or updated
+          description: l3-interface-ipv6-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList.json)
           required: true
           schema:
             $ref: "#/definitions/l3-interface-ipv6-address-list"
+    patch:
+      tags:
+        - Network
+      summary: update an existing l3-interface-ipv6-address-list
+      description: |
+        Update an existing l3-interface-ipv6-address-list
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: vnf-id
+          in: path
+          description: Unique id of VNF.  This is unique across the graph.
+          required: true
+          type: string
+          example: __VNF-ID__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: l3-interface-ipv6-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
+        - name: body
+          in: body
+          description: l3-interface-ipv6-address-list object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/l3-interface-ipv6-address-list"
     delete:
       tags:
         - Network
       summary: delete an existing l3-interface-ipv6-address-list
       description: delete an existing l3-interface-ipv6-address-list
-      operationId: deleteNetworkNewvcesNewvceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList
+      operationId: deleteNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList
       consumes:
         - application/json
         - application/xml
@@ -32098,38 +39893,42 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id2
+        - name: vnf-id
           in: path
-          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
+          description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
+          example: __VNF-ID__
         - name: interface-name
           in: path
-          description: Name given to the interface
+          description: Name that identifies the link aggregate interface
           required: true
           type: string
-        - name: vlan-interface
+          example: __INTERFACE-NAME__
+        - name: interface-name
           in: path
-          description: String that identifies the interface
+          description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: l3-interface-ipv6-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
         - name: resource-version
           in: query
           description: resource-version for concurrency
           required: true
           type: string
-  /network/newvces/newvce/{vnf-id2}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}:
+  /network/generic-vnfs/generic-vnf/{vnf-id}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}:
     get:
       tags:
         - Network
-      summary: returns vlan
-      description: returns vlan
-      operationId: getNetworkNewvcesNewvceLInterfacesLInterfaceVlansVlan
+      summary: returns l-interface
+      description: returns l-interface
+      operationId: getNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterface
       produces:
         - application/json
         - application/xml
@@ -32137,25 +39936,28 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/vlan"
+              $ref: "#/getDefinitions/l-interface"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id2
+        - name: vnf-id
           in: path
-          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
+          description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
+          example: __VNF-ID__
         - name: interface-name
           in: path
-          description: Name given to the interface
+          description: Name that identifies the link aggregate interface
           required: true
           type: string
-        - name: vlan-interface
+          example: __INTERFACE-NAME__
+        - name: interface-name
           in: path
-          description: String that identifies the interface
+          description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vnf-name
           in: query
           description: Name of VNF.
@@ -32171,166 +39973,82 @@ paths:
           description: String capturing type of vnf, that was intended to identify the ASDC resource.  This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures.
           required: false
           type: string
-        - name: prov-status
+        - name: service-id
           in: query
-          description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems.
+          description: Unique identifier of service, does not necessarily map to ASDC service models.  SOON TO BE DEPRECATED
           required: false
           type: string
-        - name: heat-stack-id
+        - name: regional-resource-zone
           in: query
-          description: Heat stack id corresponding to this instance, managed by MSO
+          description: Regional way of organizing pservers, source of truth should define values
           required: false
           type: string
-        - name: interface-id
+        - name: prov-status
           in: query
-          description: ID of interface
+          description: Trigger for operational monitoring of this resource by Service Assurance systems.
           required: false
           type: string
-        - name: macaddr
+        - name: heat-stack-id
           in: query
-          description: MAC address for the interface
+          description: Heat stack id corresponding to this instance, managed by MSO
           required: false
           type: string
-        - name: network-name
+        - name: in-maint
           in: query
-          description: Name of the network
           required: false
-          type: string
-        - name: vlan-id-inner
+          type: boolean
+        - name: is-closed-loop-disabled
           in: query
-          description: Inner VLAN tag
           required: false
-          type: integer
-          format: int64
-        - name: vpn-key
+          type: boolean
+        - name: model-invariant-id
           in: query
-          description: This indicates the customers VPN ID associated with this vlan
+          description: the ASDC model id for this resource or service model.
           required: false
           type: string
-    put:
-      tags:
-        - Network
-      summary: create or update an existing vlan
-      description: create or update an existing vlan
-      operationId: createOrUpdateNetworkNewvcesNewvceLInterfacesLInterfaceVlansVlan
-      consumes:
-        - application/json
-        - application/xml
-      produces:
-        - application/json
-        - application/xml
-      responses:
-        "default":
-          description: Response codes found in [response codes](https://wiki.onap.org/).
-      parameters:
-        - name: vnf-id2
-          in: path
-          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
-          required: true
-          type: string
-        - name: interface-name
-          in: path
-          description: Name given to the interface
-          required: true
-          type: string
-        - name: vlan-interface
-          in: path
-          description: String that identifies the interface
-          required: true
-          type: string
-        - name: body
-          in: body
-          description: vlan object that needs to be created or updated
-          required: true
-          schema:
-            $ref: "#/definitions/vlan"
-    delete:
-      tags:
-        - Network
-      summary: delete an existing vlan
-      description: delete an existing vlan
-      operationId: deleteNetworkNewvcesNewvceLInterfacesLInterfaceVlansVlan
-      consumes:
-        - application/json
-        - application/xml
-      produces:
-        - application/json
-        - application/xml
-      responses:
-        "default":
-          description: Response codes found in [response codes](https://wiki.onap.org/).
-      parameters:
-        - name: vnf-id2
-          in: path
-          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
-          required: true
-          type: string
-        - name: interface-name
-          in: path
-          description: Name given to the interface
-          required: true
-          type: string
-        - name: vlan-interface
-          in: path
-          description: String that identifies the interface
-          required: true
+        - name: model-version-id
+          in: query
+          description: the ASDC model version for this resource or service model.
+          required: false
           type: string
-        - name: resource-version
+        - name: widget-model-id
           in: query
-          description: resource-version for concurrency
-          required: true
+          description: the ASDC data dictionary widget model. This maps directly to the A&AI widget.
+          required: false
           type: string
-  /network/newvces/newvce/{vnf-id2}/l-interfaces/l-interface/{interface-name}/vlans:
-    get:
-      tags:
-        - Network
-      summary: returns vlans
-      description: returns vlans
-      operationId: getNetworkNewvcesNewvceLInterfacesLInterfaceVlans
-      produces:
-        - application/json
-        - application/xml
-      responses:
-        "200":
-          description: successful operation
-          schema:
-              $ref: "#/definitions/vlans"
-        "default":
-          description: Response codes found in [response codes](https://wiki.onap.org/).
-      parameters:
-        - name: vnf-id2
-          in: path
-          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
-          required: true
+        - name: widget-model-version
+          in: query
+          description: the ASDC data dictionary version of the widget model.This maps directly to the A&AI version of the widget.
+          required: false
           type: string
-        - name: interface-name
-          in: path
-          description: Name given to the interface
-          required: true
+        - name: nf-type
+          in: query
+          description: Generic description of the type of NF
+          required: false
           type: string
-        - name: vnf-name
+        - name: nf-function
           in: query
-          description: Name of VNF.
+          description: English description of Network function that the specific VNF deployment is providing
           required: false
           type: string
-        - name: vnf-name2
+        - name: nf-role
           in: query
-          description: Alternate name of VNF.
+          description: role in the network that this model will be providing
           required: false
           type: string
-        - name: vnf-type
+        - name: nf-naming-code
           in: query
-          description: String capturing type of vnf, that was intended to identify the ASDC resource.  This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures.
+          description: string assigned to this model used for naming purposes
           required: false
           type: string
-        - name: prov-status
+        - name: interface-id
           in: query
-          description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems.
+          description: ID of interface
           required: false
           type: string
-        - name: heat-stack-id
+        - name: interface-role
           in: query
-          description: Heat stack id corresponding to this instance, managed by MSO
+          description: Role assigned to this Interface, should use values as defined in ECOMP Yang models.
           required: false
           type: string
         - name: interface-id
@@ -32348,12 +40066,15 @@ paths:
           description: Name of the network
           required: false
           type: string
-  /network/newvces/newvce/{vnf-id2}/l-interfaces/l-interface/{interface-name}/sriov-vfs/sriov-vf/{pci-id}/relationship-list/relationship:
     put:
       tags:
         - Network
-      summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkNewvcesNewvceLInterfacesLInterfaceSriovVfsSriovVfRelationshipListRelationship
+      summary: create or update an existing l-interface
+      description: |
+        Create or update an existing l-interface.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterface
       consumes:
         - application/json
         - application/xml
@@ -32364,33 +40085,87 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id2
+        - name: vnf-id
           in: path
-          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
+          description: Unique id of VNF.  This is unique across the graph.
+          required: true
+          type: string
+          example: __VNF-ID__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
-        - name: pci-id
+          example: __INTERFACE-NAME__
+        - name: body
+          in: body
+          description: l-interface object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterface.json)
+          required: true
+          schema:
+            $ref: "#/definitions/l-interface"
+    patch:
+      tags:
+        - Network
+      summary: update an existing l-interface
+      description: |
+        Update an existing l-interface
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterface
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: vnf-id
           in: path
-          description: PCI ID used to identify the sriov-vf
+          description: Unique id of VNF.  This is unique across the graph.
+          required: true
+          type: string
+          example: __VNF-ID__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: l-interface object that needs to be created or updated. 
           required: true
           schema:
-            $ref: "#/definitions/relationship"
+            $ref: "#/patchDefinitions/l-interface"
     delete:
       tags:
         - Network
-      summary: delete an existing relationship
-      description: delete an existing relationship
-      operationId: deleteNetworkNewvcesNewvceLInterfacesLInterfaceSriovVfsSriovVfRelationshipListRelationship
+      summary: delete an existing l-interface
+      description: delete an existing l-interface
+      operationId: deleteNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterface
       consumes:
         - application/json
         - application/xml
@@ -32401,28 +40176,36 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id2
+        - name: vnf-id
           in: path
-          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
+          description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
+          example: __VNF-ID__
         - name: interface-name
           in: path
-          description: Name given to the interface
+          description: Name that identifies the link aggregate interface
           required: true
           type: string
-        - name: pci-id
+          example: __INTERFACE-NAME__
+        - name: interface-name
           in: path
-          description: PCI ID used to identify the sriov-vf
+          description: Name given to the interface
           required: true
           type: string
-  /network/newvces/newvce/{vnf-id2}/l-interfaces/l-interface/{interface-name}/sriov-vfs/sriov-vf/{pci-id}:
+          example: __INTERFACE-NAME__
+        - name: resource-version
+          in: query
+          description: resource-version for concurrency
+          required: true
+          type: string
+  /network/generic-vnfs/generic-vnf/{vnf-id}/lag-interfaces/lag-interface/{interface-name}/l-interfaces:
     get:
       tags:
         - Network
-      summary: returns sriov-vf
-      description: returns sriov-vf
-      operationId: getNetworkNewvcesNewvceLInterfacesLInterfaceSriovVfsSriovVf
+      summary: returns l-interfaces
+      description: returns l-interfaces
+      operationId: getNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfaces
       produces:
         - application/json
         - application/xml
@@ -32430,25 +40213,22 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/sriov-vf"
+              $ref: "#/getDefinitions/l-interfaces"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id2
+        - name: vnf-id
           in: path
-          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
+          description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
+          example: __VNF-ID__
         - name: interface-name
           in: path
-          description: Name given to the interface
-          required: true
-          type: string
-        - name: pci-id
-          in: path
-          description: PCI ID used to identify the sriov-vf
+          description: Name that identifies the link aggregate interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vnf-name
           in: query
           description: Name of VNF.
@@ -32464,131 +40244,91 @@ paths:
           description: String capturing type of vnf, that was intended to identify the ASDC resource.  This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures.
           required: false
           type: string
-        - name: prov-status
+        - name: service-id
           in: query
-          description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems.
+          description: Unique identifier of service, does not necessarily map to ASDC service models.  SOON TO BE DEPRECATED
           required: false
           type: string
-        - name: heat-stack-id
+        - name: regional-resource-zone
           in: query
-          description: Heat stack id corresponding to this instance, managed by MSO
+          description: Regional way of organizing pservers, source of truth should define values
           required: false
           type: string
-        - name: interface-id
+        - name: prov-status
           in: query
-          description: ID of interface
+          description: Trigger for operational monitoring of this resource by Service Assurance systems.
           required: false
           type: string
-        - name: macaddr
+        - name: heat-stack-id
           in: query
-          description: MAC address for the interface
+          description: Heat stack id corresponding to this instance, managed by MSO
           required: false
           type: string
-        - name: network-name
+        - name: in-maint
           in: query
-          description: Name of the network
           required: false
-          type: string
-        - name: vf-vlan-filter
+          type: boolean
+        - name: is-closed-loop-disabled
           in: query
-          description: This metadata provides option to specify list of VLAN filters applied on VF to pass the traffic to VM.
           required: false
-          type: string
-        - name: vf-mac-filter
+          type: boolean
+        - name: model-invariant-id
           in: query
-          description: When MAC filters are specified, VF-agent service configures VFs to do MAC level filtering before the traffic is passed to VM.
+          description: the ASDC model id for this resource or service model.
           required: false
           type: string
-        - name: vf-vlan-strip
+        - name: model-version-id
           in: query
-          description: When this field is set to true, VF will configured to strip the outer TAG before the traffic is passed to VM.
+          description: the ASDC model version for this resource or service model.
           required: false
-          type: boolean
-        - name: neutron-network-id
+          type: string
+        - name: widget-model-id
           in: query
-          description: Neutron network id of the interface
+          description: the ASDC data dictionary widget model. This maps directly to the A&AI widget.
           required: false
           type: string
-    put:
-      tags:
-        - Network
-      summary: create or update an existing sriov-vf
-      description: create or update an existing sriov-vf
-      operationId: createOrUpdateNetworkNewvcesNewvceLInterfacesLInterfaceSriovVfsSriovVf
-      consumes:
-        - application/json
-        - application/xml
-      produces:
-        - application/json
-        - application/xml
-      responses:
-        "default":
-          description: Response codes found in [response codes](https://wiki.onap.org/).
-      parameters:
-        - name: vnf-id2
-          in: path
-          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
-          required: true
+        - name: widget-model-version
+          in: query
+          description: the ASDC data dictionary version of the widget model.This maps directly to the A&AI version of the widget.
+          required: false
           type: string
-        - name: interface-name
-          in: path
-          description: Name given to the interface
-          required: true
+        - name: nf-type
+          in: query
+          description: Generic description of the type of NF
+          required: false
           type: string
-        - name: pci-id
-          in: path
-          description: PCI ID used to identify the sriov-vf
-          required: true
+        - name: nf-function
+          in: query
+          description: English description of Network function that the specific VNF deployment is providing
+          required: false
           type: string
-        - name: body
-          in: body
-          description: sriov-vf object that needs to be created or updated
-          required: true
-          schema:
-            $ref: "#/definitions/sriov-vf"
-    delete:
-      tags:
-        - Network
-      summary: delete an existing sriov-vf
-      description: delete an existing sriov-vf
-      operationId: deleteNetworkNewvcesNewvceLInterfacesLInterfaceSriovVfsSriovVf
-      consumes:
-        - application/json
-        - application/xml
-      produces:
-        - application/json
-        - application/xml
-      responses:
-        "default":
-          description: Response codes found in [response codes](https://wiki.onap.org/).
-      parameters:
-        - name: vnf-id2
-          in: path
-          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
-          required: true
+        - name: nf-role
+          in: query
+          description: role in the network that this model will be providing
+          required: false
           type: string
-        - name: interface-name
-          in: path
-          description: Name given to the interface
-          required: true
+        - name: nf-naming-code
+          in: query
+          description: string assigned to this model used for naming purposes
+          required: false
           type: string
-        - name: pci-id
-          in: path
-          description: PCI ID used to identify the sriov-vf
-          required: true
+        - name: interface-id
+          in: query
+          description: ID of interface
+          required: false
           type: string
-        - name: resource-version
+        - name: interface-role
           in: query
-          description: resource-version for concurrency
-          required: true
+          description: Role assigned to this Interface, should use values as defined in ECOMP Yang models.
+          required: false
           type: string
-  /network/newvces/newvce/{vnf-id2}/l-interfaces/l-interface/{interface-name}/sriov-vfs:
+  /network/generic-vnfs/generic-vnf/{vnf-id}/lag-interfaces/lag-interface/{interface-name}:
     get:
       tags:
         - Network
-      summary: returns sriov-vfs
-      description: returns sriov-vfs
-      operationId: getNetworkNewvcesNewvceLInterfacesLInterfaceSriovVfs
+      summary: returns lag-interface
+      description: returns lag-interface
+      operationId: getNetworkGenericVnfsGenericVnfLagInterfacesLagInterface
       produces:
         - application/json
         - application/xml
@@ -32596,20 +40336,22 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/sriov-vfs"
+              $ref: "#/getDefinitions/lag-interface"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id2
+        - name: vnf-id
           in: path
-          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
+          description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
+          example: __VNF-ID__
         - name: interface-name
           in: path
-          description: Name given to the interface
+          description: Name that identifies the link aggregate interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vnf-name
           in: query
           description: Name of VNF.
@@ -32625,9 +40367,19 @@ paths:
           description: String capturing type of vnf, that was intended to identify the ASDC resource.  This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures.
           required: false
           type: string
+        - name: service-id
+          in: query
+          description: Unique identifier of service, does not necessarily map to ASDC service models.  SOON TO BE DEPRECATED
+          required: false
+          type: string
+        - name: regional-resource-zone
+          in: query
+          description: Regional way of organizing pservers, source of truth should define values
+          required: false
+          type: string
         - name: prov-status
           in: query
-          description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems.
+          description: Trigger for operational monitoring of this resource by Service Assurance systems.
           required: false
           type: string
         - name: heat-stack-id
@@ -32635,27 +40387,73 @@ paths:
           description: Heat stack id corresponding to this instance, managed by MSO
           required: false
           type: string
-        - name: interface-id
+        - name: in-maint
           in: query
-          description: ID of interface
+          required: false
+          type: boolean
+        - name: is-closed-loop-disabled
+          in: query
+          required: false
+          type: boolean
+        - name: model-invariant-id
+          in: query
+          description: the ASDC model id for this resource or service model.
           required: false
           type: string
-        - name: macaddr
+        - name: model-version-id
           in: query
-          description: MAC address for the interface
+          description: the ASDC model version for this resource or service model.
           required: false
           type: string
-        - name: network-name
+        - name: widget-model-id
           in: query
-          description: Name of the network
+          description: the ASDC data dictionary widget model. This maps directly to the A&AI widget.
+          required: false
+          type: string
+        - name: widget-model-version
+          in: query
+          description: the ASDC data dictionary version of the widget model.This maps directly to the A&AI version of the widget.
+          required: false
+          type: string
+        - name: nf-type
+          in: query
+          description: Generic description of the type of NF
+          required: false
+          type: string
+        - name: nf-function
+          in: query
+          description: English description of Network function that the specific VNF deployment is providing
+          required: false
+          type: string
+        - name: nf-role
+          in: query
+          description: role in the network that this model will be providing
+          required: false
+          type: string
+        - name: nf-naming-code
+          in: query
+          description: string assigned to this model used for naming purposes
+          required: false
+          type: string
+        - name: interface-id
+          in: query
+          description: ID of interface
+          required: false
+          type: string
+        - name: interface-role
+          in: query
+          description: Role assigned to this Interface, should use values as defined in ECOMP Yang models.
           required: false
           type: string
-  /network/newvces/newvce/{vnf-id2}/l-interfaces/l-interface/{interface-name}/relationship-list/relationship:
     put:
       tags:
         - Network
-      summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkNewvcesNewvceLInterfacesLInterfaceRelationshipListRelationship
+      summary: create or update an existing lag-interface
+      description: |
+        Create or update an existing lag-interface.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkGenericVnfsGenericVnfLagInterfacesLagInterface
       consumes:
         - application/json
         - application/xml
@@ -32666,54 +40464,41 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id2
+        - name: vnf-id
           in: path
-          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
+          description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
+          example: __VNF-ID__
         - name: interface-name
           in: path
-          description: Name given to the interface
+          description: Name that identifies the link aggregate interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: lag-interface object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkGenericVnfsGenericVnfLagInterfacesLagInterface.json)
           required: true
           schema:
-            $ref: "#/definitions/relationship"
-    delete:
-      tags:
-        - Network
-      summary: delete an existing relationship
-      description: delete an existing relationship
-      operationId: deleteNetworkNewvcesNewvceLInterfacesLInterfaceRelationshipListRelationship
-      consumes:
-        - application/json
-        - application/xml
-      produces:
-        - application/json
-        - application/xml
-      responses:
-        "default":
-          description: Response codes found in [response codes](https://wiki.onap.org/).
-      parameters:
-        - name: vnf-id2
-          in: path
-          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
-          required: true
-          type: string
-        - name: interface-name
-          in: path
-          description: Name given to the interface
-          required: true
-          type: string
-  /network/newvces/newvce/{vnf-id2}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}/relationship-list/relationship:
-    put:
+            $ref: "#/definitions/lag-interface"
+    patch:
       tags:
         - Network
-      summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkNewvcesNewvceLInterfacesLInterfaceL3InterfaceIpv4AddressListRelationshipListRelationship
+      summary: update an existing lag-interface
+      description: |
+        Update an existing lag-interface
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkGenericVnfsGenericVnfLagInterfacesLagInterface
       consumes:
         - application/json
         - application/xml
@@ -32724,33 +40509,30 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id2
+        - name: vnf-id
           in: path
-          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
+          description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
+          example: __VNF-ID__
         - name: interface-name
           in: path
-          description: Name given to the interface
-          required: true
-          type: string
-        - name: l3-interface-ipv4-address
-          in: path
-          description: IP address
+          description: Name that identifies the link aggregate interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: lag-interface object that needs to be created or updated. 
           required: true
           schema:
-            $ref: "#/definitions/relationship"
+            $ref: "#/patchDefinitions/lag-interface"
     delete:
       tags:
         - Network
-      summary: delete an existing relationship
-      description: delete an existing relationship
-      operationId: deleteNetworkNewvcesNewvceLInterfacesLInterfaceL3InterfaceIpv4AddressListRelationshipListRelationship
+      summary: delete an existing lag-interface
+      description: delete an existing lag-interface
+      operationId: deleteNetworkGenericVnfsGenericVnfLagInterfacesLagInterface
       consumes:
         - application/json
         - application/xml
@@ -32761,28 +40543,30 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id2
+        - name: vnf-id
           in: path
-          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
+          description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
+          example: __VNF-ID__
         - name: interface-name
           in: path
-          description: Name given to the interface
+          description: Name that identifies the link aggregate interface
           required: true
           type: string
-        - name: l3-interface-ipv4-address
-          in: path
-          description: IP address
+          example: __INTERFACE-NAME__
+        - name: resource-version
+          in: query
+          description: resource-version for concurrency
           required: true
           type: string
-  /network/newvces/newvce/{vnf-id2}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}:
+  /network/generic-vnfs/generic-vnf/{vnf-id}/lag-interfaces:
     get:
       tags:
         - Network
-      summary: returns l3-interface-ipv4-address-list
-      description: returns l3-interface-ipv4-address-list
-      operationId: getNetworkNewvcesNewvceLInterfacesLInterfaceL3InterfaceIpv4AddressList
+      summary: returns lag-interfaces
+      description: returns lag-interfaces
+      operationId: getNetworkGenericVnfsGenericVnfLagInterfaces
       produces:
         - application/json
         - application/xml
@@ -32790,25 +40574,16 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/l3-interface-ipv4-address-list"
+              $ref: "#/getDefinitions/lag-interfaces"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id2
-          in: path
-          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
-          required: true
-          type: string
-        - name: interface-name
-          in: path
-          description: Name given to the interface
-          required: true
-          type: string
-        - name: l3-interface-ipv4-address
+        - name: vnf-id
           in: path
-          description: IP address
+          description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
+          example: __VNF-ID__
         - name: vnf-name
           in: query
           description: Name of VNF.
@@ -32824,126 +40599,80 @@ paths:
           description: String capturing type of vnf, that was intended to identify the ASDC resource.  This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures.
           required: false
           type: string
-        - name: prov-status
+        - name: service-id
           in: query
-          description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems.
+          description: Unique identifier of service, does not necessarily map to ASDC service models.  SOON TO BE DEPRECATED
           required: false
           type: string
-        - name: heat-stack-id
+        - name: regional-resource-zone
           in: query
-          description: Heat stack id corresponding to this instance, managed by MSO
+          description: Regional way of organizing pservers, source of truth should define values
           required: false
           type: string
-        - name: interface-id
+        - name: prov-status
           in: query
-          description: ID of interface
+          description: Trigger for operational monitoring of this resource by Service Assurance systems.
           required: false
           type: string
-        - name: macaddr
+        - name: heat-stack-id
           in: query
-          description: MAC address for the interface
+          description: Heat stack id corresponding to this instance, managed by MSO
           required: false
           type: string
-        - name: network-name
+        - name: in-maint
           in: query
-          description: Name of the network
           required: false
-          type: string
-        - name: vlan-id-inner
+          type: boolean
+        - name: is-closed-loop-disabled
           in: query
-          description: Inner VLAN tag
           required: false
-          type: integer
-          format: int64
-        - name: neutron-network-id
+          type: boolean
+        - name: model-invariant-id
           in: query
-          description: Neutron network id of the interface that address belongs to
+          description: the ASDC model id for this resource or service model.
           required: false
           type: string
-        - name: neutron-subnet-id
+        - name: model-version-id
           in: query
-          description: Neutron id of subnet that address belongs to
+          description: the ASDC model version for this resource or service model.
           required: false
           type: string
-    put:
-      tags:
-        - Network
-      summary: create or update an existing l3-interface-ipv4-address-list
-      description: create or update an existing l3-interface-ipv4-address-list
-      operationId: createOrUpdateNetworkNewvcesNewvceLInterfacesLInterfaceL3InterfaceIpv4AddressList
-      consumes:
-        - application/json
-        - application/xml
-      produces:
-        - application/json
-        - application/xml
-      responses:
-        "default":
-          description: Response codes found in [response codes](https://wiki.onap.org/).
-      parameters:
-        - name: vnf-id2
-          in: path
-          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
-          required: true
-          type: string
-        - name: interface-name
-          in: path
-          description: Name given to the interface
-          required: true
+        - name: widget-model-id
+          in: query
+          description: the ASDC data dictionary widget model. This maps directly to the A&AI widget.
+          required: false
           type: string
-        - name: l3-interface-ipv4-address
-          in: path
-          description: IP address
-          required: true
+        - name: widget-model-version
+          in: query
+          description: the ASDC data dictionary version of the widget model.This maps directly to the A&AI version of the widget.
+          required: false
           type: string
-        - name: body
-          in: body
-          description: l3-interface-ipv4-address-list object that needs to be created or updated
-          required: true
-          schema:
-            $ref: "#/definitions/l3-interface-ipv4-address-list"
-    delete:
-      tags:
-        - Network
-      summary: delete an existing l3-interface-ipv4-address-list
-      description: delete an existing l3-interface-ipv4-address-list
-      operationId: deleteNetworkNewvcesNewvceLInterfacesLInterfaceL3InterfaceIpv4AddressList
-      consumes:
-        - application/json
-        - application/xml
-      produces:
-        - application/json
-        - application/xml
-      responses:
-        "default":
-          description: Response codes found in [response codes](https://wiki.onap.org/).
-      parameters:
-        - name: vnf-id2
-          in: path
-          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
-          required: true
+        - name: nf-type
+          in: query
+          description: Generic description of the type of NF
+          required: false
           type: string
-        - name: interface-name
-          in: path
-          description: Name given to the interface
-          required: true
+        - name: nf-function
+          in: query
+          description: English description of Network function that the specific VNF deployment is providing
+          required: false
           type: string
-        - name: l3-interface-ipv4-address
-          in: path
-          description: IP address
-          required: true
+        - name: nf-role
+          in: query
+          description: role in the network that this model will be providing
+          required: false
           type: string
-        - name: resource-version
+        - name: nf-naming-code
           in: query
-          description: resource-version for concurrency
-          required: true
+          description: string assigned to this model used for naming purposes
+          required: false
           type: string
-  /network/newvces/newvce/{vnf-id2}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}/relationship-list/relationship:
+  /network/generic-vnfs/generic-vnf/{vnf-id}/vf-modules/vf-module/{vf-module-id}/relationship-list/relationship:
     put:
       tags:
         - Network
       summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkNewvcesNewvceLInterfacesLInterfaceL3InterfaceIpv6AddressListRelationshipListRelationship
+      operationId: createOrUpdateNetworkGenericVnfsGenericVnfVfModulesVfModuleRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -32954,24 +40683,21 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id2
-          in: path
-          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
-          required: true
-          type: string
-        - name: interface-name
+        - name: vnf-id
           in: path
-          description: Name given to the interface
+          description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: l3-interface-ipv6-address
+          example: __VNF-ID__
+        - name: vf-module-id
           in: path
-          description: IP address
+          description: Unique ID of vf-module.
           required: true
           type: string
+          example: __VF-MODULE-ID__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkGenericVnfsGenericVnfVfModulesVfModule.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -32980,7 +40706,7 @@ paths:
         - Network
       summary: delete an existing relationship
       description: delete an existing relationship
-      operationId: deleteNetworkNewvcesNewvceLInterfacesLInterfaceL3InterfaceIpv6AddressListRelationshipListRelationship
+      operationId: deleteNetworkGenericVnfsGenericVnfVfModulesVfModuleRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -32991,28 +40717,25 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id2
-          in: path
-          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
-          required: true
-          type: string
-        - name: interface-name
+        - name: vnf-id
           in: path
-          description: Name given to the interface
+          description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: l3-interface-ipv6-address
+          example: __VNF-ID__
+        - name: vf-module-id
           in: path
-          description: IP address
+          description: Unique ID of vf-module.
           required: true
           type: string
-  /network/newvces/newvce/{vnf-id2}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}:
+          example: __VF-MODULE-ID__
+  /network/generic-vnfs/generic-vnf/{vnf-id}/vf-modules/vf-module/{vf-module-id}:
     get:
       tags:
         - Network
-      summary: returns l3-interface-ipv6-address-list
-      description: returns l3-interface-ipv6-address-list
-      operationId: getNetworkNewvcesNewvceLInterfacesLInterfaceL3InterfaceIpv6AddressList
+      summary: returns vf-module
+      description: returns vf-module
+      operationId: getNetworkGenericVnfsGenericVnfVfModulesVfModule
       produces:
         - application/json
         - application/xml
@@ -33020,25 +40743,22 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/l3-interface-ipv6-address-list"
+              $ref: "#/getDefinitions/vf-module"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id2
-          in: path
-          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
-          required: true
-          type: string
-        - name: interface-name
+        - name: vnf-id
           in: path
-          description: Name given to the interface
+          description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: l3-interface-ipv6-address
+          example: __VNF-ID__
+        - name: vf-module-id
           in: path
-          description: IP address
+          description: Unique ID of vf-module.
           required: true
           type: string
+          example: __VF-MODULE-ID__
         - name: vnf-name
           in: query
           description: Name of VNF.
@@ -33054,9 +40774,19 @@ paths:
           description: String capturing type of vnf, that was intended to identify the ASDC resource.  This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures.
           required: false
           type: string
+        - name: service-id
+          in: query
+          description: Unique identifier of service, does not necessarily map to ASDC service models.  SOON TO BE DEPRECATED
+          required: false
+          type: string
+        - name: regional-resource-zone
+          in: query
+          description: Regional way of organizing pservers, source of truth should define values
+          required: false
+          type: string
         - name: prov-status
           in: query
-          description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems.
+          description: Trigger for operational monitoring of this resource by Service Assurance systems.
           required: false
           type: string
         - name: heat-stack-id
@@ -33064,46 +40794,101 @@ paths:
           description: Heat stack id corresponding to this instance, managed by MSO
           required: false
           type: string
-        - name: interface-id
+        - name: in-maint
           in: query
-          description: ID of interface
+          required: false
+          type: boolean
+        - name: is-closed-loop-disabled
+          in: query
+          required: false
+          type: boolean
+        - name: model-invariant-id
+          in: query
+          description: the ASDC model id for this resource or service model.
           required: false
           type: string
-        - name: macaddr
+        - name: model-version-id
           in: query
-          description: MAC address for the interface
+          description: the ASDC model version for this resource or service model.
           required: false
           type: string
-        - name: network-name
+        - name: widget-model-id
           in: query
-          description: Name of the network
+          description: the ASDC data dictionary widget model. This maps directly to the A&AI widget.
           required: false
           type: string
-        - name: vlan-id-inner
+        - name: widget-model-version
           in: query
-          description: Inner VLAN tag
+          description: the ASDC data dictionary version of the widget model.This maps directly to the A&AI version of the widget.
           required: false
-          type: integer
-          format: int64
-        - name: neutron-network-id
+          type: string
+        - name: nf-type
           in: query
-          description: Neutron network id of the interface that address belongs to
+          description: Generic description of the type of NF
           required: false
           type: string
-        - name: neutron-subnet-id
+        - name: nf-function
           in: query
-          description: Neutron id of subnet that address belongs to
+          description: English description of Network function that the specific VNF deployment is providing
           required: false
           type: string
-    put:
-      tags:
-        - Network
-      summary: create or update an existing l3-interface-ipv6-address-list
-      description: create or update an existing l3-interface-ipv6-address-list
-      operationId: createOrUpdateNetworkNewvcesNewvceLInterfacesLInterfaceL3InterfaceIpv6AddressList
-      consumes:
-        - application/json
-        - application/xml
+        - name: nf-role
+          in: query
+          description: role in the network that this model will be providing
+          required: false
+          type: string
+        - name: nf-naming-code
+          in: query
+          description: string assigned to this model used for naming purposes
+          required: false
+          type: string
+        - name: vf-module-name
+          in: query
+          description: Name of vf-module
+          required: false
+          type: string
+        - name: heat-stack-id
+          in: query
+          description: Heat stack id corresponding to this instance.
+          required: false
+          type: string
+        - name: model-invariant-id
+          in: query
+          description: the ASDC model id for this resource or service model.
+          required: false
+          type: string
+        - name: model-version-id
+          in: query
+          description: the ASDC model version for this resource or service model.
+          required: false
+          type: string
+        - name: widget-model-id
+          in: query
+          description: the ASDC data dictionary widget model. This maps directly to the A&AI widget.
+          required: false
+          type: string
+        - name: widget-model-version
+          in: query
+          description: the ASDC data dictionary version of the widget model.This maps directly to the A&AI version of the widget.
+          required: false
+          type: string
+        - name: contrail-service-instance-fqdn
+          in: query
+          description: the Contrail unique ID for a service-instance
+          required: false
+          type: string
+    put:
+      tags:
+        - Network
+      summary: create or update an existing vf-module
+      description: |
+        Create or update an existing vf-module.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkGenericVnfsGenericVnfVfModulesVfModule
+      consumes:
+        - application/json
+        - application/xml
       produces:
         - application/json
         - application/xml
@@ -33111,33 +40896,75 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id2
+        - name: vnf-id
           in: path
-          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
+          description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: interface-name
+          example: __VNF-ID__
+        - name: vf-module-id
           in: path
-          description: Name given to the interface
+          description: Unique ID of vf-module.
           required: true
           type: string
-        - name: l3-interface-ipv6-address
+          example: __VF-MODULE-ID__
+        - name: body
+          in: body
+          description: vf-module object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkGenericVnfsGenericVnfVfModulesVfModule.json)
+          required: true
+          schema:
+            $ref: "#/definitions/vf-module"
+    patch:
+      tags:
+        - Network
+      summary: update an existing vf-module
+      description: |
+        Update an existing vf-module
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkGenericVnfsGenericVnfVfModulesVfModule
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: vnf-id
           in: path
-          description: IP address
+          description: Unique id of VNF.  This is unique across the graph.
+          required: true
+          type: string
+          example: __VNF-ID__
+        - name: vf-module-id
+          in: path
+          description: Unique ID of vf-module.
           required: true
           type: string
+          example: __VF-MODULE-ID__
         - name: body
           in: body
-          description: l3-interface-ipv6-address-list object that needs to be created or updated
+          description: vf-module object that needs to be created or updated. 
           required: true
           schema:
-            $ref: "#/definitions/l3-interface-ipv6-address-list"
+            $ref: "#/patchDefinitions/vf-module"
     delete:
       tags:
         - Network
-      summary: delete an existing l3-interface-ipv6-address-list
-      description: delete an existing l3-interface-ipv6-address-list
-      operationId: deleteNetworkNewvcesNewvceLInterfacesLInterfaceL3InterfaceIpv6AddressList
+      summary: delete an existing vf-module
+      description: delete an existing vf-module
+      operationId: deleteNetworkGenericVnfsGenericVnfVfModulesVfModule
       consumes:
         - application/json
         - application/xml
@@ -33148,33 +40975,30 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id2
-          in: path
-          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
-          required: true
-          type: string
-        - name: interface-name
+        - name: vnf-id
           in: path
-          description: Name given to the interface
+          description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: l3-interface-ipv6-address
+          example: __VNF-ID__
+        - name: vf-module-id
           in: path
-          description: IP address
+          description: Unique ID of vf-module.
           required: true
           type: string
+          example: __VF-MODULE-ID__
         - name: resource-version
           in: query
           description: resource-version for concurrency
           required: true
           type: string
-  /network/newvces/newvce/{vnf-id2}/l-interfaces/l-interface/{interface-name}:
+  /network/generic-vnfs/generic-vnf/{vnf-id}/vf-modules:
     get:
       tags:
         - Network
-      summary: returns l-interface
-      description: returns l-interface
-      operationId: getNetworkNewvcesNewvceLInterfacesLInterface
+      summary: returns vf-modules
+      description: returns vf-modules
+      operationId: getNetworkGenericVnfsGenericVnfVfModules
       produces:
         - application/json
         - application/xml
@@ -33182,20 +41006,16 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/l-interface"
+              $ref: "#/getDefinitions/vf-modules"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id2
-          in: path
-          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
-          required: true
-          type: string
-        - name: interface-name
+        - name: vnf-id
           in: path
-          description: Name given to the interface
+          description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
+          example: __VNF-ID__
         - name: vnf-name
           in: query
           description: Name of VNF.
@@ -33211,9 +41031,19 @@ paths:
           description: String capturing type of vnf, that was intended to identify the ASDC resource.  This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures.
           required: false
           type: string
+        - name: service-id
+          in: query
+          description: Unique identifier of service, does not necessarily map to ASDC service models.  SOON TO BE DEPRECATED
+          required: false
+          type: string
+        - name: regional-resource-zone
+          in: query
+          description: Regional way of organizing pservers, source of truth should define values
+          required: false
+          type: string
         - name: prov-status
           in: query
-          description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems.
+          description: Trigger for operational monitoring of this resource by Service Assurance systems.
           required: false
           type: string
         - name: heat-stack-id
@@ -33221,27 +41051,60 @@ paths:
           description: Heat stack id corresponding to this instance, managed by MSO
           required: false
           type: string
-        - name: interface-id
+        - name: in-maint
           in: query
-          description: ID of interface
+          required: false
+          type: boolean
+        - name: is-closed-loop-disabled
+          in: query
+          required: false
+          type: boolean
+        - name: model-invariant-id
+          in: query
+          description: the ASDC model id for this resource or service model.
           required: false
           type: string
-        - name: macaddr
+        - name: model-version-id
           in: query
-          description: MAC address for the interface
+          description: the ASDC model version for this resource or service model.
           required: false
           type: string
-        - name: network-name
+        - name: widget-model-id
           in: query
-          description: Name of the network
+          description: the ASDC data dictionary widget model. This maps directly to the A&AI widget.
+          required: false
+          type: string
+        - name: widget-model-version
+          in: query
+          description: the ASDC data dictionary version of the widget model.This maps directly to the A&AI version of the widget.
+          required: false
+          type: string
+        - name: nf-type
+          in: query
+          description: Generic description of the type of NF
+          required: false
+          type: string
+        - name: nf-function
+          in: query
+          description: English description of Network function that the specific VNF deployment is providing
+          required: false
+          type: string
+        - name: nf-role
+          in: query
+          description: role in the network that this model will be providing
           required: false
           type: string
+        - name: nf-naming-code
+          in: query
+          description: string assigned to this model used for naming purposes
+          required: false
+          type: string
+  /network/generic-vnfs/generic-vnf/{vnf-id}/licenses/license/{group-uuid}/{resource-uuid}/relationship-list/relationship:
     put:
       tags:
         - Network
-      summary: create or update an existing l-interface
-      description: create or update an existing l-interface
-      operationId: createOrUpdateNetworkNewvcesNewvceLInterfacesLInterface
+      summary: see node definition for valid relationships
+      operationId: createOrUpdateNetworkGenericVnfsGenericVnfLicensesLicenseRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -33252,28 +41115,36 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id2
+        - name: vnf-id
           in: path
-          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
+          description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: interface-name
+          example: __VNF-ID__
+        - name: group-uuid
           in: path
-          description: Name given to the interface
+          description: Unique ID for the license group the resource belongs to, should be uuid.
+          required: true
+          type: string
+          example: __GROUP-UUID__
+        - name: resource-uuid
+          in: path
+          description: Unique ID of a license resource. 
           required: true
           type: string
+          example: __RESOURCE-UUID__
         - name: body
           in: body
-          description: l-interface object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkGenericVnfsGenericVnfLicensesLicense.json)
           required: true
           schema:
-            $ref: "#/definitions/l-interface"
+            $ref: "#/definitions/relationship"
     delete:
       tags:
         - Network
-      summary: delete an existing l-interface
-      description: delete an existing l-interface
-      operationId: deleteNetworkNewvcesNewvceLInterfacesLInterface
+      summary: delete an existing relationship
+      description: delete an existing relationship
+      operationId: deleteNetworkGenericVnfsGenericVnfLicensesLicenseRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -33284,28 +41155,31 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id2
+        - name: vnf-id
           in: path
-          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
+          description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: interface-name
+          example: __VNF-ID__
+        - name: group-uuid
           in: path
-          description: Name given to the interface
+          description: Unique ID for the license group the resource belongs to, should be uuid.
           required: true
           type: string
-        - name: resource-version
-          in: query
-          description: resource-version for concurrency
+          example: __GROUP-UUID__
+        - name: resource-uuid
+          in: path
+          description: Unique ID of a license resource. 
           required: true
           type: string
-  /network/newvces/newvce/{vnf-id2}/l-interfaces:
+          example: __RESOURCE-UUID__
+  /network/generic-vnfs/generic-vnf/{vnf-id}/licenses/license/{group-uuid}/{resource-uuid}:
     get:
       tags:
         - Network
-      summary: returns l-interfaces
-      description: returns l-interfaces
-      operationId: getNetworkNewvcesNewvceLInterfaces
+      summary: returns license
+      description: returns license
+      operationId: getNetworkGenericVnfsGenericVnfLicensesLicense
       produces:
         - application/json
         - application/xml
@@ -33313,15 +41187,28 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/l-interfaces"
+              $ref: "#/getDefinitions/license"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id2
+        - name: vnf-id
           in: path
-          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
+          description: Unique id of VNF.  This is unique across the graph.
+          required: true
+          type: string
+          example: __VNF-ID__
+        - name: group-uuid
+          in: path
+          description: Unique ID for the license group the resource belongs to, should be uuid.
+          required: true
+          type: string
+          example: __GROUP-UUID__
+        - name: resource-uuid
+          in: path
+          description: Unique ID of a license resource. 
           required: true
           type: string
+          example: __RESOURCE-UUID__
         - name: vnf-name
           in: query
           description: Name of VNF.
@@ -33337,9 +41224,19 @@ paths:
           description: String capturing type of vnf, that was intended to identify the ASDC resource.  This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures.
           required: false
           type: string
+        - name: service-id
+          in: query
+          description: Unique identifier of service, does not necessarily map to ASDC service models.  SOON TO BE DEPRECATED
+          required: false
+          type: string
+        - name: regional-resource-zone
+          in: query
+          description: Regional way of organizing pservers, source of truth should define values
+          required: false
+          type: string
         - name: prov-status
           in: query
-          description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems.
+          description: Trigger for operational monitoring of this resource by Service Assurance systems.
           required: false
           type: string
         - name: heat-stack-id
@@ -33347,60 +41244,63 @@ paths:
           description: Heat stack id corresponding to this instance, managed by MSO
           required: false
           type: string
-  /network/newvces/newvce/{vnf-id2}:
-    get:
-      tags:
-        - Network
-      summary: returns newvce
-      description: returns newvce
-      operationId: getNetworkNewvcesNewvce
-      produces:
-        - application/json
-        - application/xml
-      responses:
-        "200":
-          description: successful operation
-          schema:
-              $ref: "#/definitions/newvce"
-        "default":
-          description: Response codes found in [response codes](https://wiki.onap.org/).
-      parameters:
-        - name: vnf-id2
-          in: path
-          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
-          required: true
+        - name: in-maint
+          in: query
+          required: false
+          type: boolean
+        - name: is-closed-loop-disabled
+          in: query
+          required: false
+          type: boolean
+        - name: model-invariant-id
+          in: query
+          description: the ASDC model id for this resource or service model.
+          required: false
           type: string
-        - name: vnf-name
+        - name: model-version-id
           in: query
-          description: Name of VNF.
+          description: the ASDC model version for this resource or service model.
           required: false
           type: string
-        - name: vnf-name2
+        - name: widget-model-id
           in: query
-          description: Alternate name of VNF.
+          description: the ASDC data dictionary widget model. This maps directly to the A&AI widget.
           required: false
           type: string
-        - name: vnf-type
+        - name: widget-model-version
           in: query
-          description: String capturing type of vnf, that was intended to identify the ASDC resource.  This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures.
+          description: the ASDC data dictionary version of the widget model.This maps directly to the A&AI version of the widget.
           required: false
           type: string
-        - name: prov-status
+        - name: nf-type
           in: query
-          description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems.
+          description: Generic description of the type of NF
           required: false
           type: string
-        - name: heat-stack-id
+        - name: nf-function
           in: query
-          description: Heat stack id corresponding to this instance, managed by MSO
+          description: English description of Network function that the specific VNF deployment is providing
+          required: false
+          type: string
+        - name: nf-role
+          in: query
+          description: role in the network that this model will be providing
+          required: false
+          type: string
+        - name: nf-naming-code
+          in: query
+          description: string assigned to this model used for naming purposes
           required: false
           type: string
     put:
       tags:
         - Network
-      summary: create or update an existing newvce
-      description: create or update an existing newvce
-      operationId: createOrUpdateNetworkNewvcesNewvce
+      summary: create or update an existing license
+      description: |
+        Create or update an existing license.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkGenericVnfsGenericVnfLicensesLicense
       consumes:
         - application/json
         - application/xml
@@ -33411,23 +41311,87 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id2
+        - name: vnf-id
           in: path
-          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
+          description: Unique id of VNF.  This is unique across the graph.
+          required: true
+          type: string
+          example: __VNF-ID__
+        - name: group-uuid
+          in: path
+          description: Unique ID for the license group the resource belongs to, should be uuid.
+          required: true
+          type: string
+          example: __GROUP-UUID__
+        - name: resource-uuid
+          in: path
+          description: Unique ID of a license resource. 
           required: true
           type: string
+          example: __RESOURCE-UUID__
         - name: body
           in: body
-          description: newvce object that needs to be created or updated
+          description: license object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkGenericVnfsGenericVnfLicensesLicense.json)
           required: true
           schema:
-            $ref: "#/definitions/newvce"
+            $ref: "#/definitions/license"
+    patch:
+      tags:
+        - Network
+      summary: update an existing license
+      description: |
+        Update an existing license
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkGenericVnfsGenericVnfLicensesLicense
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: vnf-id
+          in: path
+          description: Unique id of VNF.  This is unique across the graph.
+          required: true
+          type: string
+          example: __VNF-ID__
+        - name: group-uuid
+          in: path
+          description: Unique ID for the license group the resource belongs to, should be uuid.
+          required: true
+          type: string
+          example: __GROUP-UUID__
+        - name: resource-uuid
+          in: path
+          description: Unique ID of a license resource. 
+          required: true
+          type: string
+          example: __RESOURCE-UUID__
+        - name: body
+          in: body
+          description: license object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/license"
     delete:
       tags:
         - Network
-      summary: delete an existing newvce
-      description: delete an existing newvce
-      operationId: deleteNetworkNewvcesNewvce
+      summary: delete an existing license
+      description: delete an existing license
+      operationId: deleteNetworkGenericVnfsGenericVnfLicensesLicense
       consumes:
         - application/json
         - application/xml
@@ -33438,23 +41402,36 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnf-id2
+        - name: vnf-id
           in: path
-          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
+          description: Unique id of VNF.  This is unique across the graph.
+          required: true
+          type: string
+          example: __VNF-ID__
+        - name: group-uuid
+          in: path
+          description: Unique ID for the license group the resource belongs to, should be uuid.
           required: true
           type: string
+          example: __GROUP-UUID__
+        - name: resource-uuid
+          in: path
+          description: Unique ID of a license resource. 
+          required: true
+          type: string
+          example: __RESOURCE-UUID__
         - name: resource-version
           in: query
           description: resource-version for concurrency
           required: true
           type: string
-  /network/newvces:
+  /network/generic-vnfs/generic-vnf/{vnf-id}/licenses:
     get:
       tags:
         - Network
-      summary: returns newvces
-      description: returns newvces
-      operationId: getNetworkNewvces
+      summary: returns licenses
+      description: returns licenses
+      operationId: getNetworkGenericVnfsGenericVnfLicenses
       produces:
         - application/json
         - application/xml
@@ -33462,15 +41439,105 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/newvces"
+              $ref: "#/getDefinitions/licenses"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
-  /network/pnfs/pnf/{pnf-name}/relationship-list/relationship:
+      parameters:
+        - name: vnf-id
+          in: path
+          description: Unique id of VNF.  This is unique across the graph.
+          required: true
+          type: string
+          example: __VNF-ID__
+        - name: vnf-name
+          in: query
+          description: Name of VNF.
+          required: false
+          type: string
+        - name: vnf-name2
+          in: query
+          description: Alternate name of VNF.
+          required: false
+          type: string
+        - name: vnf-type
+          in: query
+          description: String capturing type of vnf, that was intended to identify the ASDC resource.  This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures.
+          required: false
+          type: string
+        - name: service-id
+          in: query
+          description: Unique identifier of service, does not necessarily map to ASDC service models.  SOON TO BE DEPRECATED
+          required: false
+          type: string
+        - name: regional-resource-zone
+          in: query
+          description: Regional way of organizing pservers, source of truth should define values
+          required: false
+          type: string
+        - name: prov-status
+          in: query
+          description: Trigger for operational monitoring of this resource by Service Assurance systems.
+          required: false
+          type: string
+        - name: heat-stack-id
+          in: query
+          description: Heat stack id corresponding to this instance, managed by MSO
+          required: false
+          type: string
+        - name: in-maint
+          in: query
+          required: false
+          type: boolean
+        - name: is-closed-loop-disabled
+          in: query
+          required: false
+          type: boolean
+        - name: model-invariant-id
+          in: query
+          description: the ASDC model id for this resource or service model.
+          required: false
+          type: string
+        - name: model-version-id
+          in: query
+          description: the ASDC model version for this resource or service model.
+          required: false
+          type: string
+        - name: widget-model-id
+          in: query
+          description: the ASDC data dictionary widget model. This maps directly to the A&AI widget.
+          required: false
+          type: string
+        - name: widget-model-version
+          in: query
+          description: the ASDC data dictionary version of the widget model.This maps directly to the A&AI version of the widget.
+          required: false
+          type: string
+        - name: nf-type
+          in: query
+          description: Generic description of the type of NF
+          required: false
+          type: string
+        - name: nf-function
+          in: query
+          description: English description of Network function that the specific VNF deployment is providing
+          required: false
+          type: string
+        - name: nf-role
+          in: query
+          description: role in the network that this model will be providing
+          required: false
+          type: string
+        - name: nf-naming-code
+          in: query
+          description: string assigned to this model used for naming purposes
+          required: false
+          type: string
+  /network/generic-vnfs/generic-vnf/{vnf-id}/entitlements/entitlement/{group-uuid}/{resource-uuid}/relationship-list/relationship:
     put:
       tags:
         - Network
       summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkPnfsPnfRelationshipListRelationship
+      operationId: createOrUpdateNetworkGenericVnfsGenericVnfEntitlementsEntitlementRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -33481,14 +41548,27 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: pnf-name
+        - name: vnf-id
           in: path
-          description: unique name of Physical Network Function.
+          description: Unique id of VNF.  This is unique across the graph.
+          required: true
+          type: string
+          example: __VNF-ID__
+        - name: group-uuid
+          in: path
+          description: Unique ID for the entitlement group the resource comes from, should be uuid.
+          required: true
+          type: string
+          example: __GROUP-UUID__
+        - name: resource-uuid
+          in: path
+          description: Unique ID of an entitlement resource. 
           required: true
           type: string
+          example: __RESOURCE-UUID__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkGenericVnfsGenericVnfEntitlementsEntitlement.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -33497,7 +41577,7 @@ paths:
         - Network
       summary: delete an existing relationship
       description: delete an existing relationship
-      operationId: deleteNetworkPnfsPnfRelationshipListRelationship
+      operationId: deleteNetworkGenericVnfsGenericVnfEntitlementsEntitlementRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -33508,49 +41588,152 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: pnf-name
+        - name: vnf-id
           in: path
-          description: unique name of Physical Network Function.
+          description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-  /network/pnfs/pnf/{pnf-name}/p-interfaces/p-interface/{interface-name}/relationship-list/relationship:
-    put:
+          example: __VNF-ID__
+        - name: group-uuid
+          in: path
+          description: Unique ID for the entitlement group the resource comes from, should be uuid.
+          required: true
+          type: string
+          example: __GROUP-UUID__
+        - name: resource-uuid
+          in: path
+          description: Unique ID of an entitlement resource. 
+          required: true
+          type: string
+          example: __RESOURCE-UUID__
+  /network/generic-vnfs/generic-vnf/{vnf-id}/entitlements/entitlement/{group-uuid}/{resource-uuid}:
+    get:
       tags:
         - Network
-      summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkPnfsPnfPInterfacesPInterfaceRelationshipListRelationship
-      consumes:
-        - application/json
-        - application/xml
+      summary: returns entitlement
+      description: returns entitlement
+      operationId: getNetworkGenericVnfsGenericVnfEntitlementsEntitlement
       produces:
         - application/json
         - application/xml
       responses:
+        "200":
+          description: successful operation
+          schema:
+              $ref: "#/getDefinitions/entitlement"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: pnf-name
+        - name: vnf-id
           in: path
-          description: unique name of Physical Network Function.
+          description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: interface-name
+          example: __VNF-ID__
+        - name: group-uuid
           in: path
-          description: Name that identifies the physical interface
+          description: Unique ID for the entitlement group the resource comes from, should be uuid.
           required: true
           type: string
-        - name: body
-          in: body
-          description: relationship object that needs to be created or updated
+          example: __GROUP-UUID__
+        - name: resource-uuid
+          in: path
+          description: Unique ID of an entitlement resource. 
           required: true
-          schema:
-            $ref: "#/definitions/relationship"
-    delete:
+          type: string
+          example: __RESOURCE-UUID__
+        - name: vnf-name
+          in: query
+          description: Name of VNF.
+          required: false
+          type: string
+        - name: vnf-name2
+          in: query
+          description: Alternate name of VNF.
+          required: false
+          type: string
+        - name: vnf-type
+          in: query
+          description: String capturing type of vnf, that was intended to identify the ASDC resource.  This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures.
+          required: false
+          type: string
+        - name: service-id
+          in: query
+          description: Unique identifier of service, does not necessarily map to ASDC service models.  SOON TO BE DEPRECATED
+          required: false
+          type: string
+        - name: regional-resource-zone
+          in: query
+          description: Regional way of organizing pservers, source of truth should define values
+          required: false
+          type: string
+        - name: prov-status
+          in: query
+          description: Trigger for operational monitoring of this resource by Service Assurance systems.
+          required: false
+          type: string
+        - name: heat-stack-id
+          in: query
+          description: Heat stack id corresponding to this instance, managed by MSO
+          required: false
+          type: string
+        - name: in-maint
+          in: query
+          required: false
+          type: boolean
+        - name: is-closed-loop-disabled
+          in: query
+          required: false
+          type: boolean
+        - name: model-invariant-id
+          in: query
+          description: the ASDC model id for this resource or service model.
+          required: false
+          type: string
+        - name: model-version-id
+          in: query
+          description: the ASDC model version for this resource or service model.
+          required: false
+          type: string
+        - name: widget-model-id
+          in: query
+          description: the ASDC data dictionary widget model. This maps directly to the A&AI widget.
+          required: false
+          type: string
+        - name: widget-model-version
+          in: query
+          description: the ASDC data dictionary version of the widget model.This maps directly to the A&AI version of the widget.
+          required: false
+          type: string
+        - name: nf-type
+          in: query
+          description: Generic description of the type of NF
+          required: false
+          type: string
+        - name: nf-function
+          in: query
+          description: English description of Network function that the specific VNF deployment is providing
+          required: false
+          type: string
+        - name: nf-role
+          in: query
+          description: role in the network that this model will be providing
+          required: false
+          type: string
+        - name: nf-naming-code
+          in: query
+          description: string assigned to this model used for naming purposes
+          required: false
+          type: string
+    put:
       tags:
         - Network
-      summary: delete an existing relationship
-      description: delete an existing relationship
-      operationId: deleteNetworkPnfsPnfPInterfacesPInterfaceRelationshipListRelationship
+      summary: create or update an existing entitlement
+      description: |
+        Create or update an existing entitlement.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkGenericVnfsGenericVnfEntitlementsEntitlement
       consumes:
         - application/json
         - application/xml
@@ -33561,22 +41744,47 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: pnf-name
+        - name: vnf-id
           in: path
-          description: unique name of Physical Network Function.
+          description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: interface-name
+          example: __VNF-ID__
+        - name: group-uuid
           in: path
-          description: Name that identifies the physical interface
+          description: Unique ID for the entitlement group the resource comes from, should be uuid.
           required: true
           type: string
-  /network/pnfs/pnf/{pnf-name}/p-interfaces/p-interface/{interface-name}/sriov-pfs/sriov-pf/{pf-pci-id}/relationship-list/relationship:
-    put:
+          example: __GROUP-UUID__
+        - name: resource-uuid
+          in: path
+          description: Unique ID of an entitlement resource. 
+          required: true
+          type: string
+          example: __RESOURCE-UUID__
+        - name: body
+          in: body
+          description: entitlement object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkGenericVnfsGenericVnfEntitlementsEntitlement.json)
+          required: true
+          schema:
+            $ref: "#/definitions/entitlement"
+    patch:
       tags:
         - Network
-      summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkPnfsPnfPInterfacesPInterfaceSriovPfsSriovPfRelationshipListRelationship
+      summary: update an existing entitlement
+      description: |
+        Update an existing entitlement
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkGenericVnfsGenericVnfEntitlementsEntitlement
       consumes:
         - application/json
         - application/xml
@@ -33587,33 +41795,36 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: pnf-name
+        - name: vnf-id
           in: path
-          description: unique name of Physical Network Function.
+          description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: interface-name
+          example: __VNF-ID__
+        - name: group-uuid
           in: path
-          description: Name that identifies the physical interface
+          description: Unique ID for the entitlement group the resource comes from, should be uuid.
           required: true
           type: string
-        - name: pf-pci-id
+          example: __GROUP-UUID__
+        - name: resource-uuid
           in: path
-          description: Identifier for the sriov-pf
+          description: Unique ID of an entitlement resource. 
           required: true
           type: string
+          example: __RESOURCE-UUID__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: entitlement object that needs to be created or updated. 
           required: true
           schema:
-            $ref: "#/definitions/relationship"
+            $ref: "#/patchDefinitions/entitlement"
     delete:
       tags:
         - Network
-      summary: delete an existing relationship
-      description: delete an existing relationship
-      operationId: deleteNetworkPnfsPnfPInterfacesPInterfaceSriovPfsSriovPfRelationshipListRelationship
+      summary: delete an existing entitlement
+      description: delete an existing entitlement
+      operationId: deleteNetworkGenericVnfsGenericVnfEntitlementsEntitlement
       consumes:
         - application/json
         - application/xml
@@ -33624,28 +41835,36 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: pnf-name
+        - name: vnf-id
           in: path
-          description: unique name of Physical Network Function.
+          description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: interface-name
+          example: __VNF-ID__
+        - name: group-uuid
           in: path
-          description: Name that identifies the physical interface
+          description: Unique ID for the entitlement group the resource comes from, should be uuid.
           required: true
           type: string
-        - name: pf-pci-id
+          example: __GROUP-UUID__
+        - name: resource-uuid
           in: path
-          description: Identifier for the sriov-pf
+          description: Unique ID of an entitlement resource. 
           required: true
           type: string
-  /network/pnfs/pnf/{pnf-name}/p-interfaces/p-interface/{interface-name}/sriov-pfs/sriov-pf/{pf-pci-id}:
+          example: __RESOURCE-UUID__
+        - name: resource-version
+          in: query
+          description: resource-version for concurrency
+          required: true
+          type: string
+  /network/generic-vnfs/generic-vnf/{vnf-id}/entitlements:
     get:
       tags:
         - Network
-      summary: returns sriov-pf
-      description: returns sriov-pf
-      operationId: getNetworkPnfsPnfPInterfacesPInterfaceSriovPfsSriovPf
+      summary: returns entitlements
+      description: returns entitlements
+      operationId: getNetworkGenericVnfsGenericVnfEntitlements
       produces:
         - application/json
         - application/xml
@@ -33653,28 +41872,146 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/sriov-pf"
+              $ref: "#/getDefinitions/entitlements"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: pnf-name
+        - name: vnf-id
           in: path
-          description: unique name of Physical Network Function.
+          description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: interface-name
-          in: path
-          description: Name that identifies the physical interface
-          required: true
+          example: __VNF-ID__
+        - name: vnf-name
+          in: query
+          description: Name of VNF.
+          required: false
           type: string
-        - name: pf-pci-id
+        - name: vnf-name2
+          in: query
+          description: Alternate name of VNF.
+          required: false
+          type: string
+        - name: vnf-type
+          in: query
+          description: String capturing type of vnf, that was intended to identify the ASDC resource.  This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures.
+          required: false
+          type: string
+        - name: service-id
+          in: query
+          description: Unique identifier of service, does not necessarily map to ASDC service models.  SOON TO BE DEPRECATED
+          required: false
+          type: string
+        - name: regional-resource-zone
+          in: query
+          description: Regional way of organizing pservers, source of truth should define values
+          required: false
+          type: string
+        - name: prov-status
+          in: query
+          description: Trigger for operational monitoring of this resource by Service Assurance systems.
+          required: false
+          type: string
+        - name: heat-stack-id
+          in: query
+          description: Heat stack id corresponding to this instance, managed by MSO
+          required: false
+          type: string
+        - name: in-maint
+          in: query
+          required: false
+          type: boolean
+        - name: is-closed-loop-disabled
+          in: query
+          required: false
+          type: boolean
+        - name: model-invariant-id
+          in: query
+          description: the ASDC model id for this resource or service model.
+          required: false
+          type: string
+        - name: model-version-id
+          in: query
+          description: the ASDC model version for this resource or service model.
+          required: false
+          type: string
+        - name: widget-model-id
+          in: query
+          description: the ASDC data dictionary widget model. This maps directly to the A&AI widget.
+          required: false
+          type: string
+        - name: widget-model-version
+          in: query
+          description: the ASDC data dictionary version of the widget model.This maps directly to the A&AI version of the widget.
+          required: false
+          type: string
+        - name: nf-type
+          in: query
+          description: Generic description of the type of NF
+          required: false
+          type: string
+        - name: nf-function
+          in: query
+          description: English description of Network function that the specific VNF deployment is providing
+          required: false
+          type: string
+        - name: nf-role
+          in: query
+          description: role in the network that this model will be providing
+          required: false
+          type: string
+        - name: nf-naming-code
+          in: query
+          description: string assigned to this model used for naming purposes
+          required: false
+          type: string
+  /network/generic-vnfs/generic-vnf/{vnf-id}:
+    get:
+      tags:
+        - Network
+      summary: returns generic-vnf
+      description: returns generic-vnf
+      operationId: getNetworkGenericVnfsGenericVnf
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "200":
+          description: successful operation
+          schema:
+              $ref: "#/getDefinitions/generic-vnf"
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: vnf-id
           in: path
-          description: Identifier for the sriov-pf
+          description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: inv-status
+          example: __VNF-ID__
+        - name: vnf-name
           in: query
-          description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
+          description: Name of VNF.
+          required: false
+          type: string
+        - name: vnf-name2
+          in: query
+          description: Alternate name of VNF.
+          required: false
+          type: string
+        - name: vnf-type
+          in: query
+          description: String capturing type of vnf, that was intended to identify the ASDC resource.  This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures.
+          required: false
+          type: string
+        - name: service-id
+          in: query
+          description: Unique identifier of service, does not necessarily map to ASDC service models.  SOON TO BE DEPRECATED
+          required: false
+          type: string
+        - name: regional-resource-zone
+          in: query
+          description: Regional way of organizing pservers, source of truth should define values
           required: false
           type: string
         - name: prov-status
@@ -33682,12 +42019,68 @@ paths:
           description: Trigger for operational monitoring of this resource by Service Assurance systems.
           required: false
           type: string
+        - name: heat-stack-id
+          in: query
+          description: Heat stack id corresponding to this instance, managed by MSO
+          required: false
+          type: string
+        - name: in-maint
+          in: query
+          required: false
+          type: boolean
+        - name: is-closed-loop-disabled
+          in: query
+          required: false
+          type: boolean
+        - name: model-invariant-id
+          in: query
+          description: the ASDC model id for this resource or service model.
+          required: false
+          type: string
+        - name: model-version-id
+          in: query
+          description: the ASDC model version for this resource or service model.
+          required: false
+          type: string
+        - name: widget-model-id
+          in: query
+          description: the ASDC data dictionary widget model. This maps directly to the A&AI widget.
+          required: false
+          type: string
+        - name: widget-model-version
+          in: query
+          description: the ASDC data dictionary version of the widget model.This maps directly to the A&AI version of the widget.
+          required: false
+          type: string
+        - name: nf-type
+          in: query
+          description: Generic description of the type of NF
+          required: false
+          type: string
+        - name: nf-function
+          in: query
+          description: English description of Network function that the specific VNF deployment is providing
+          required: false
+          type: string
+        - name: nf-role
+          in: query
+          description: role in the network that this model will be providing
+          required: false
+          type: string
+        - name: nf-naming-code
+          in: query
+          description: string assigned to this model used for naming purposes
+          required: false
+          type: string
     put:
       tags:
         - Network
-      summary: create or update an existing sriov-pf
-      description: create or update an existing sriov-pf
-      operationId: createOrUpdateNetworkPnfsPnfPInterfacesPInterfaceSriovPfsSriovPf
+      summary: create or update an existing generic-vnf
+      description: |
+        Create or update an existing generic-vnf.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkGenericVnfsGenericVnf
       consumes:
         - application/json
         - application/xml
@@ -33698,33 +42091,63 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: pnf-name
+        - name: vnf-id
           in: path
-          description: unique name of Physical Network Function.
+          description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
-        - name: interface-name
-          in: path
-          description: Name that identifies the physical interface
+          example: __VNF-ID__
+        - name: body
+          in: body
+          description: generic-vnf object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkGenericVnfsGenericVnf.json)
           required: true
-          type: string
-        - name: pf-pci-id
+          schema:
+            $ref: "#/definitions/generic-vnf"
+    patch:
+      tags:
+        - Network
+      summary: update an existing generic-vnf
+      description: |
+        Update an existing generic-vnf
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkGenericVnfsGenericVnf
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: vnf-id
           in: path
-          description: Identifier for the sriov-pf
+          description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
+          example: __VNF-ID__
         - name: body
           in: body
-          description: sriov-pf object that needs to be created or updated
+          description: generic-vnf object that needs to be created or updated. 
           required: true
           schema:
-            $ref: "#/definitions/sriov-pf"
+            $ref: "#/patchDefinitions/generic-vnf"
     delete:
       tags:
         - Network
-      summary: delete an existing sriov-pf
-      description: delete an existing sriov-pf
-      operationId: deleteNetworkPnfsPnfPInterfacesPInterfaceSriovPfsSriovPf
+      summary: delete an existing generic-vnf
+      description: delete an existing generic-vnf
+      operationId: deleteNetworkGenericVnfsGenericVnf
       consumes:
         - application/json
         - application/xml
@@ -33735,33 +42158,24 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: pnf-name
-          in: path
-          description: unique name of Physical Network Function.
-          required: true
-          type: string
-        - name: interface-name
-          in: path
-          description: Name that identifies the physical interface
-          required: true
-          type: string
-        - name: pf-pci-id
+        - name: vnf-id
           in: path
-          description: Identifier for the sriov-pf
+          description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
+          example: __VNF-ID__
         - name: resource-version
           in: query
           description: resource-version for concurrency
           required: true
           type: string
-  /network/pnfs/pnf/{pnf-name}/p-interfaces/p-interface/{interface-name}/sriov-pfs:
+  /network/generic-vnfs:
     get:
       tags:
         - Network
-      summary: returns sriov-pfs
-      description: returns sriov-pfs
-      operationId: getNetworkPnfsPnfPInterfacesPInterfaceSriovPfs
+      summary: returns generic-vnfs
+      description: returns generic-vnfs
+      operationId: getNetworkGenericVnfs
       produces:
         - application/json
         - application/xml
@@ -33769,36 +42183,15 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/sriov-pfs"
+              $ref: "#/getDefinitions/generic-vnfs"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
-      parameters:
-        - name: pnf-name
-          in: path
-          description: unique name of Physical Network Function.
-          required: true
-          type: string
-        - name: interface-name
-          in: path
-          description: Name that identifies the physical interface
-          required: true
-          type: string
-        - name: inv-status
-          in: query
-          description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
-          required: false
-          type: string
-        - name: prov-status
-          in: query
-          description: Trigger for operational monitoring of this resource by Service Assurance systems.
-          required: false
-          type: string
-  /network/pnfs/pnf/{pnf-name}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/relationship-list/relationship:
+  /network/lag-links/lag-link/{link-name}/relationship-list/relationship:
     put:
       tags:
         - Network
       summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceVlansVlanRelationshipListRelationship
+      operationId: createOrUpdateNetworkLagLinksLagLinkRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -33809,29 +42202,15 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: pnf-name
-          in: path
-          description: unique name of Physical Network Function.
-          required: true
-          type: string
-        - name: interface-name
-          in: path
-          description: Name that identifies the physical interface
-          required: true
-          type: string
-        - name: interface-name
-          in: path
-          description: Name given to the interface
-          required: true
-          type: string
-        - name: vlan-interface
+        - name: link-name
           in: path
-          description: String that identifies the interface
+          description: Alphabetical concatenation of lag-interface names
           required: true
           type: string
+          example: __LINK-NAME__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkLagLinksLagLink.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -33840,7 +42219,7 @@ paths:
         - Network
       summary: delete an existing relationship
       description: delete an existing relationship
-      operationId: deleteNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceVlansVlanRelationshipListRelationship
+      operationId: deleteNetworkLagLinksLagLinkRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -33851,32 +42230,156 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: pnf-name
-          in: path
-          description: unique name of Physical Network Function.
-          required: true
-          type: string
-        - name: interface-name
-          in: path
-          description: Name that identifies the physical interface
-          required: true
-          type: string
-        - name: interface-name
-          in: path
-          description: Name given to the interface
-          required: true
-          type: string
-        - name: vlan-interface
+        - name: link-name
           in: path
-          description: String that identifies the interface
+          description: Alphabetical concatenation of lag-interface names
           required: true
           type: string
-  /network/pnfs/pnf/{pnf-name}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}/relationship-list/relationship:
-    put:
-      tags:
+          example: __LINK-NAME__
+  /network/lag-links/lag-link/{link-name}:
+    get:
+      tags:
+        - Network
+      summary: returns lag-link
+      description: returns lag-link
+      operationId: getNetworkLagLinksLagLink
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "200":
+          description: successful operation
+          schema:
+              $ref: "#/getDefinitions/lag-link"
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: link-name
+          in: path
+          description: Alphabetical concatenation of lag-interface names
+          required: true
+          type: string
+          example: __LINK-NAME__
+    put:
+      tags:
+        - Network
+      summary: create or update an existing lag-link
+      description: |
+        Create or update an existing lag-link.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkLagLinksLagLink
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: link-name
+          in: path
+          description: Alphabetical concatenation of lag-interface names
+          required: true
+          type: string
+          example: __LINK-NAME__
+        - name: body
+          in: body
+          description: lag-link object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkLagLinksLagLink.json)
+          required: true
+          schema:
+            $ref: "#/definitions/lag-link"
+    patch:
+      tags:
+        - Network
+      summary: update an existing lag-link
+      description: |
+        Update an existing lag-link
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkLagLinksLagLink
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: link-name
+          in: path
+          description: Alphabetical concatenation of lag-interface names
+          required: true
+          type: string
+          example: __LINK-NAME__
+        - name: body
+          in: body
+          description: lag-link object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/lag-link"
+    delete:
+      tags:
+        - Network
+      summary: delete an existing lag-link
+      description: delete an existing lag-link
+      operationId: deleteNetworkLagLinksLagLink
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: link-name
+          in: path
+          description: Alphabetical concatenation of lag-interface names
+          required: true
+          type: string
+          example: __LINK-NAME__
+        - name: resource-version
+          in: query
+          description: resource-version for concurrency
+          required: true
+          type: string
+  /network/lag-links:
+    get:
+      tags:
+        - Network
+      summary: returns lag-links
+      description: returns lag-links
+      operationId: getNetworkLagLinks
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "200":
+          description: successful operation
+          schema:
+              $ref: "#/getDefinitions/lag-links"
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+  /network/newvces/newvce/{vnf-id2}/relationship-list/relationship:
+    put:
+      tags:
         - Network
       summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressListRelationshipListRelationship
+      operationId: createOrUpdateNetworkNewvcesNewvceRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -33887,34 +42390,157 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: pnf-name
+        - name: vnf-id2
           in: path
-          description: unique name of Physical Network Function.
+          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
+          required: true
+          type: string
+          example: __VNF-ID2__
+        - name: body
+          in: body
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkNewvcesNewvce.json)
+          required: true
+          schema:
+            $ref: "#/definitions/relationship"
+    delete:
+      tags:
+        - Network
+      summary: delete an existing relationship
+      description: delete an existing relationship
+      operationId: deleteNetworkNewvcesNewvceRelationshipListRelationship
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: vnf-id2
+          in: path
+          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
+          required: true
+          type: string
+          example: __VNF-ID2__
+  /network/newvces/newvce/{vnf-id2}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/relationship-list/relationship:
+    put:
+      tags:
+        - Network
+      summary: see node definition for valid relationships
+      operationId: createOrUpdateNetworkNewvcesNewvceLInterfacesLInterfaceVlansVlanRelationshipListRelationship
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: vnf-id2
+          in: path
+          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
           required: true
           type: string
+          example: __VNF-ID2__
         - name: interface-name
           in: path
-          description: Name that identifies the physical interface
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
+          type: string
+          example: __VLAN-INTERFACE__
+        - name: body
+          in: body
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkNewvcesNewvceLInterfacesLInterfaceVlansVlan.json)
+          required: true
+          schema:
+            $ref: "#/definitions/relationship"
+    delete:
+      tags:
+        - Network
+      summary: delete an existing relationship
+      description: delete an existing relationship
+      operationId: deleteNetworkNewvcesNewvceLInterfacesLInterfaceVlansVlanRelationshipListRelationship
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: vnf-id2
+          in: path
+          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
+          required: true
+          type: string
+          example: __VNF-ID2__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
+          type: string
+          example: __VLAN-INTERFACE__
+  /network/newvces/newvce/{vnf-id2}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}/relationship-list/relationship:
+    put:
+      tags:
+        - Network
+      summary: see node definition for valid relationships
+      operationId: createOrUpdateNetworkNewvcesNewvceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressListRelationshipListRelationship
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: vnf-id2
+          in: path
+          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
           required: true
           type: string
+          example: __VNF-ID2__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vlan-interface
           in: path
           description: String that identifies the interface
           required: true
           type: string
+          example: __VLAN-INTERFACE__
         - name: l3-interface-ipv4-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkNewvcesNewvceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -33923,7 +42549,7 @@ paths:
         - Network
       summary: delete an existing relationship
       description: delete an existing relationship
-      operationId: deleteNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressListRelationshipListRelationship
+      operationId: deleteNetworkNewvcesNewvceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressListRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -33934,38 +42560,37 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: pnf-name
-          in: path
-          description: unique name of Physical Network Function.
-          required: true
-          type: string
-        - name: interface-name
+        - name: vnf-id2
           in: path
-          description: Name that identifies the physical interface
+          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
           required: true
           type: string
+          example: __VNF-ID2__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vlan-interface
           in: path
           description: String that identifies the interface
           required: true
           type: string
+          example: __VLAN-INTERFACE__
         - name: l3-interface-ipv4-address
           in: path
           description: IP address
           required: true
           type: string
-  /network/pnfs/pnf/{pnf-name}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}:
+          example: __L3-INTERFACE-IPV4-ADDRESS__
+  /network/newvces/newvce/{vnf-id2}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}:
     get:
       tags:
         - Network
       summary: returns l3-interface-ipv4-address-list
       description: returns l3-interface-ipv4-address-list
-      operationId: getNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList
+      operationId: getNetworkNewvcesNewvceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList
       produces:
         - application/json
         - application/xml
@@ -33973,43 +42598,57 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/l3-interface-ipv4-address-list"
+              $ref: "#/getDefinitions/l3-interface-ipv4-address-list"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: pnf-name
-          in: path
-          description: unique name of Physical Network Function.
-          required: true
-          type: string
-        - name: interface-name
+        - name: vnf-id2
           in: path
-          description: Name that identifies the physical interface
+          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
           required: true
           type: string
+          example: __VNF-ID2__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vlan-interface
           in: path
           description: String that identifies the interface
           required: true
           type: string
+          example: __VLAN-INTERFACE__
         - name: l3-interface-ipv4-address
           in: path
           description: IP address
           required: true
           type: string
-        - name: inv-status
+          example: __L3-INTERFACE-IPV4-ADDRESS__
+        - name: vnf-name
           in: query
-          description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
+          description: Name of VNF.
+          required: false
+          type: string
+        - name: vnf-name2
+          in: query
+          description: Alternate name of VNF.
+          required: false
+          type: string
+        - name: vnf-type
+          in: query
+          description: String capturing type of vnf, that was intended to identify the ASDC resource.  This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures.
           required: false
           type: string
         - name: prov-status
           in: query
-          description: Trigger for operational monitoring of this resource by Service Assurance systems.
+          description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems.
+          required: false
+          type: string
+        - name: heat-stack-id
+          in: query
+          description: Heat stack id corresponding to this instance, managed by MSO
           required: false
           type: string
         - name: interface-id
@@ -34058,8 +42697,11 @@ paths:
       tags:
         - Network
       summary: create or update an existing l3-interface-ipv4-address-list
-      description: create or update an existing l3-interface-ipv4-address-list
-      operationId: createOrUpdateNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList
+      description: |
+        Create or update an existing l3-interface-ipv4-address-list.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkNewvcesNewvceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList
       consumes:
         - application/json
         - application/xml
@@ -34070,43 +42712,99 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: pnf-name
+        - name: vnf-id2
           in: path
-          description: unique name of Physical Network Function.
+          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
           required: true
           type: string
+          example: __VNF-ID2__
         - name: interface-name
           in: path
-          description: Name that identifies the physical interface
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
           required: true
           type: string
+          example: __VLAN-INTERFACE__
+        - name: l3-interface-ipv4-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
+        - name: body
+          in: body
+          description: l3-interface-ipv4-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkNewvcesNewvceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList.json)
+          required: true
+          schema:
+            $ref: "#/definitions/l3-interface-ipv4-address-list"
+    patch:
+      tags:
+        - Network
+      summary: update an existing l3-interface-ipv4-address-list
+      description: |
+        Update an existing l3-interface-ipv4-address-list
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkNewvcesNewvceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: vnf-id2
+          in: path
+          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
+          required: true
+          type: string
+          example: __VNF-ID2__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vlan-interface
           in: path
           description: String that identifies the interface
           required: true
           type: string
+          example: __VLAN-INTERFACE__
         - name: l3-interface-ipv4-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
         - name: body
           in: body
-          description: l3-interface-ipv4-address-list object that needs to be created or updated
+          description: l3-interface-ipv4-address-list object that needs to be created or updated
           required: true
           schema:
-            $ref: "#/definitions/l3-interface-ipv4-address-list"
+            $ref: "#/patchDefinitions/l3-interface-ipv4-address-list"
     delete:
       tags:
         - Network
       summary: delete an existing l3-interface-ipv4-address-list
       description: delete an existing l3-interface-ipv4-address-list
-      operationId: deleteNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList
+      operationId: deleteNetworkNewvcesNewvceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList
       consumes:
         - application/json
         - application/xml
@@ -34117,42 +42815,41 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: pnf-name
-          in: path
-          description: unique name of Physical Network Function.
-          required: true
-          type: string
-        - name: interface-name
+        - name: vnf-id2
           in: path
-          description: Name that identifies the physical interface
+          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
           required: true
           type: string
+          example: __VNF-ID2__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vlan-interface
           in: path
           description: String that identifies the interface
           required: true
           type: string
+          example: __VLAN-INTERFACE__
         - name: l3-interface-ipv4-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
         - name: resource-version
           in: query
           description: resource-version for concurrency
           required: true
           type: string
-  /network/pnfs/pnf/{pnf-name}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}/relationship-list/relationship:
+  /network/newvces/newvce/{vnf-id2}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}/relationship-list/relationship:
     put:
       tags:
         - Network
       summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressListRelationshipListRelationship
+      operationId: createOrUpdateNetworkNewvcesNewvceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressListRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -34163,34 +42860,33 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: pnf-name
-          in: path
-          description: unique name of Physical Network Function.
-          required: true
-          type: string
-        - name: interface-name
+        - name: vnf-id2
           in: path
-          description: Name that identifies the physical interface
+          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
           required: true
           type: string
+          example: __VNF-ID2__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vlan-interface
           in: path
           description: String that identifies the interface
           required: true
           type: string
+          example: __VLAN-INTERFACE__
         - name: l3-interface-ipv6-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkNewvcesNewvceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -34199,7 +42895,7 @@ paths:
         - Network
       summary: delete an existing relationship
       description: delete an existing relationship
-      operationId: deleteNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressListRelationshipListRelationship
+      operationId: deleteNetworkNewvcesNewvceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressListRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -34210,38 +42906,37 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: pnf-name
-          in: path
-          description: unique name of Physical Network Function.
-          required: true
-          type: string
-        - name: interface-name
+        - name: vnf-id2
           in: path
-          description: Name that identifies the physical interface
+          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
           required: true
           type: string
+          example: __VNF-ID2__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vlan-interface
           in: path
           description: String that identifies the interface
           required: true
           type: string
+          example: __VLAN-INTERFACE__
         - name: l3-interface-ipv6-address
           in: path
           description: IP address
           required: true
           type: string
-  /network/pnfs/pnf/{pnf-name}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}:
+          example: __L3-INTERFACE-IPV6-ADDRESS__
+  /network/newvces/newvce/{vnf-id2}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}:
     get:
       tags:
         - Network
       summary: returns l3-interface-ipv6-address-list
       description: returns l3-interface-ipv6-address-list
-      operationId: getNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList
+      operationId: getNetworkNewvcesNewvceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList
       produces:
         - application/json
         - application/xml
@@ -34249,43 +42944,57 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/l3-interface-ipv6-address-list"
+              $ref: "#/getDefinitions/l3-interface-ipv6-address-list"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: pnf-name
-          in: path
-          description: unique name of Physical Network Function.
-          required: true
-          type: string
-        - name: interface-name
+        - name: vnf-id2
           in: path
-          description: Name that identifies the physical interface
+          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
           required: true
           type: string
+          example: __VNF-ID2__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vlan-interface
           in: path
           description: String that identifies the interface
           required: true
           type: string
+          example: __VLAN-INTERFACE__
         - name: l3-interface-ipv6-address
           in: path
           description: IP address
           required: true
           type: string
-        - name: inv-status
+          example: __L3-INTERFACE-IPV6-ADDRESS__
+        - name: vnf-name
           in: query
-          description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
+          description: Name of VNF.
+          required: false
+          type: string
+        - name: vnf-name2
+          in: query
+          description: Alternate name of VNF.
+          required: false
+          type: string
+        - name: vnf-type
+          in: query
+          description: String capturing type of vnf, that was intended to identify the ASDC resource.  This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures.
           required: false
           type: string
         - name: prov-status
           in: query
-          description: Trigger for operational monitoring of this resource by Service Assurance systems.
+          description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems.
+          required: false
+          type: string
+        - name: heat-stack-id
+          in: query
+          description: Heat stack id corresponding to this instance, managed by MSO
           required: false
           type: string
         - name: interface-id
@@ -34334,8 +43043,11 @@ paths:
       tags:
         - Network
       summary: create or update an existing l3-interface-ipv6-address-list
-      description: create or update an existing l3-interface-ipv6-address-list
-      operationId: createOrUpdateNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList
+      description: |
+        Create or update an existing l3-interface-ipv6-address-list.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkNewvcesNewvceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList
       consumes:
         - application/json
         - application/xml
@@ -34346,43 +43058,99 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: pnf-name
+        - name: vnf-id2
           in: path
-          description: unique name of Physical Network Function.
+          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
           required: true
           type: string
+          example: __VNF-ID2__
         - name: interface-name
           in: path
-          description: Name that identifies the physical interface
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
+          type: string
+          example: __VLAN-INTERFACE__
+        - name: l3-interface-ipv6-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
+        - name: body
+          in: body
+          description: l3-interface-ipv6-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkNewvcesNewvceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList.json)
+          required: true
+          schema:
+            $ref: "#/definitions/l3-interface-ipv6-address-list"
+    patch:
+      tags:
+        - Network
+      summary: update an existing l3-interface-ipv6-address-list
+      description: |
+        Update an existing l3-interface-ipv6-address-list
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkNewvcesNewvceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: vnf-id2
+          in: path
+          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
           required: true
           type: string
+          example: __VNF-ID2__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vlan-interface
           in: path
           description: String that identifies the interface
           required: true
           type: string
+          example: __VLAN-INTERFACE__
         - name: l3-interface-ipv6-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
         - name: body
           in: body
-          description: l3-interface-ipv6-address-list object that needs to be created or updated
+          description: l3-interface-ipv6-address-list object that needs to be created or updated
           required: true
           schema:
-            $ref: "#/definitions/l3-interface-ipv6-address-list"
+            $ref: "#/patchDefinitions/l3-interface-ipv6-address-list"
     delete:
       tags:
         - Network
       summary: delete an existing l3-interface-ipv6-address-list
       description: delete an existing l3-interface-ipv6-address-list
-      operationId: deleteNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList
+      operationId: deleteNetworkNewvcesNewvceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList
       consumes:
         - application/json
         - application/xml
@@ -34393,43 +43161,42 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: pnf-name
-          in: path
-          description: unique name of Physical Network Function.
-          required: true
-          type: string
-        - name: interface-name
+        - name: vnf-id2
           in: path
-          description: Name that identifies the physical interface
+          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
           required: true
           type: string
+          example: __VNF-ID2__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vlan-interface
           in: path
           description: String that identifies the interface
           required: true
           type: string
+          example: __VLAN-INTERFACE__
         - name: l3-interface-ipv6-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
         - name: resource-version
           in: query
           description: resource-version for concurrency
           required: true
           type: string
-  /network/pnfs/pnf/{pnf-name}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}:
+  /network/newvces/newvce/{vnf-id2}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}:
     get:
       tags:
         - Network
       summary: returns vlan
       description: returns vlan
-      operationId: getNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceVlansVlan
+      operationId: getNetworkNewvcesNewvceLInterfacesLInterfaceVlansVlan
       produces:
         - application/json
         - application/xml
@@ -34437,38 +43204,51 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/vlan"
+              $ref: "#/getDefinitions/vlan"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: pnf-name
-          in: path
-          description: unique name of Physical Network Function.
-          required: true
-          type: string
-        - name: interface-name
+        - name: vnf-id2
           in: path
-          description: Name that identifies the physical interface
+          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
           required: true
           type: string
+          example: __VNF-ID2__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vlan-interface
           in: path
           description: String that identifies the interface
           required: true
           type: string
-        - name: inv-status
+          example: __VLAN-INTERFACE__
+        - name: vnf-name
           in: query
-          description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
+          description: Name of VNF.
+          required: false
+          type: string
+        - name: vnf-name2
+          in: query
+          description: Alternate name of VNF.
+          required: false
+          type: string
+        - name: vnf-type
+          in: query
+          description: String capturing type of vnf, that was intended to identify the ASDC resource.  This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures.
           required: false
           type: string
         - name: prov-status
           in: query
-          description: Trigger for operational monitoring of this resource by Service Assurance systems.
+          description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems.
+          required: false
+          type: string
+        - name: heat-stack-id
+          in: query
+          description: Heat stack id corresponding to this instance, managed by MSO
           required: false
           type: string
         - name: interface-id
@@ -34501,8 +43281,11 @@ paths:
       tags:
         - Network
       summary: create or update an existing vlan
-      description: create or update an existing vlan
-      operationId: createOrUpdateNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceVlansVlan
+      description: |
+        Create or update an existing vlan.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkNewvcesNewvceLInterfacesLInterfaceVlansVlan
       consumes:
         - application/json
         - application/xml
@@ -34513,38 +43296,47 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: pnf-name
-          in: path
-          description: unique name of Physical Network Function.
-          required: true
-          type: string
-        - name: interface-name
+        - name: vnf-id2
           in: path
-          description: Name that identifies the physical interface
+          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
           required: true
           type: string
+          example: __VNF-ID2__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vlan-interface
           in: path
           description: String that identifies the interface
           required: true
           type: string
+          example: __VLAN-INTERFACE__
         - name: body
           in: body
-          description: vlan object that needs to be created or updated
+          description: vlan object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkNewvcesNewvceLInterfacesLInterfaceVlansVlan.json)
           required: true
           schema:
             $ref: "#/definitions/vlan"
-    delete:
+    patch:
       tags:
         - Network
-      summary: delete an existing vlan
-      description: delete an existing vlan
-      operationId: deleteNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceVlansVlan
+      summary: update an existing vlan
+      description: |
+        Update an existing vlan
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkNewvcesNewvceLInterfacesLInterfaceVlansVlan
       consumes:
         - application/json
         - application/xml
@@ -34555,72 +43347,122 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: pnf-name
-          in: path
-          description: unique name of Physical Network Function.
-          required: true
-          type: string
-        - name: interface-name
+        - name: vnf-id2
           in: path
-          description: Name that identifies the physical interface
+          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
           required: true
           type: string
+          example: __VNF-ID2__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vlan-interface
           in: path
           description: String that identifies the interface
           required: true
           type: string
-        - name: resource-version
-          in: query
-          description: resource-version for concurrency
+          example: __VLAN-INTERFACE__
+        - name: body
+          in: body
+          description: vlan object that needs to be created or updated. 
           required: true
-          type: string
-  /network/pnfs/pnf/{pnf-name}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans:
-    get:
+          schema:
+            $ref: "#/patchDefinitions/vlan"
+    delete:
       tags:
         - Network
-      summary: returns vlans
-      description: returns vlans
-      operationId: getNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceVlans
-      produces:
-        - application/json
-        - application/xml
-      responses:
-        "200":
-          description: successful operation
-          schema:
-              $ref: "#/definitions/vlans"
+      summary: delete an existing vlan
+      description: delete an existing vlan
+      operationId: deleteNetworkNewvcesNewvceLInterfacesLInterfaceVlansVlan
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: pnf-name
+        - name: vnf-id2
           in: path
-          description: unique name of Physical Network Function.
+          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
           required: true
           type: string
+          example: __VNF-ID2__
         - name: interface-name
           in: path
-          description: Name that identifies the physical interface
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
+          type: string
+          example: __VLAN-INTERFACE__
+        - name: resource-version
+          in: query
+          description: resource-version for concurrency
+          required: true
+          type: string
+  /network/newvces/newvce/{vnf-id2}/l-interfaces/l-interface/{interface-name}/vlans:
+    get:
+      tags:
+        - Network
+      summary: returns vlans
+      description: returns vlans
+      operationId: getNetworkNewvcesNewvceLInterfacesLInterfaceVlans
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "200":
+          description: successful operation
+          schema:
+              $ref: "#/getDefinitions/vlans"
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: vnf-id2
+          in: path
+          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
           required: true
           type: string
+          example: __VNF-ID2__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
-        - name: inv-status
+          example: __INTERFACE-NAME__
+        - name: vnf-name
           in: query
-          description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
+          description: Name of VNF.
+          required: false
+          type: string
+        - name: vnf-name2
+          in: query
+          description: Alternate name of VNF.
+          required: false
+          type: string
+        - name: vnf-type
+          in: query
+          description: String capturing type of vnf, that was intended to identify the ASDC resource.  This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures.
           required: false
           type: string
         - name: prov-status
           in: query
-          description: Trigger for operational monitoring of this resource by Service Assurance systems.
+          description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems.
+          required: false
+          type: string
+        - name: heat-stack-id
+          in: query
+          description: Heat stack id corresponding to this instance, managed by MSO
           required: false
           type: string
         - name: interface-id
@@ -34638,12 +43480,12 @@ paths:
           description: Name of the network
           required: false
           type: string
-  /network/pnfs/pnf/{pnf-name}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/sriov-vfs/sriov-vf/{pci-id}/relationship-list/relationship:
+  /network/newvces/newvce/{vnf-id2}/l-interfaces/l-interface/{interface-name}/sriov-vfs/sriov-vf/{pci-id}/relationship-list/relationship:
     put:
       tags:
         - Network
       summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceSriovVfsSriovVfRelationshipListRelationship
+      operationId: createOrUpdateNetworkNewvcesNewvceLInterfacesLInterfaceSriovVfsSriovVfRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -34654,29 +43496,27 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: pnf-name
-          in: path
-          description: unique name of Physical Network Function.
-          required: true
-          type: string
-        - name: interface-name
+        - name: vnf-id2
           in: path
-          description: Name that identifies the physical interface
+          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
           required: true
           type: string
+          example: __VNF-ID2__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: pci-id
           in: path
           description: PCI ID used to identify the sriov-vf
           required: true
           type: string
+          example: __PCI-ID__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkNewvcesNewvceLInterfacesLInterfaceSriovVfsSriovVf.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -34685,7 +43525,7 @@ paths:
         - Network
       summary: delete an existing relationship
       description: delete an existing relationship
-      operationId: deleteNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceSriovVfsSriovVfRelationshipListRelationship
+      operationId: deleteNetworkNewvcesNewvceLInterfacesLInterfaceSriovVfsSriovVfRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -34696,33 +43536,31 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: pnf-name
-          in: path
-          description: unique name of Physical Network Function.
-          required: true
-          type: string
-        - name: interface-name
+        - name: vnf-id2
           in: path
-          description: Name that identifies the physical interface
+          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
           required: true
           type: string
+          example: __VNF-ID2__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: pci-id
           in: path
           description: PCI ID used to identify the sriov-vf
           required: true
           type: string
-  /network/pnfs/pnf/{pnf-name}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/sriov-vfs/sriov-vf/{pci-id}:
+          example: __PCI-ID__
+  /network/newvces/newvce/{vnf-id2}/l-interfaces/l-interface/{interface-name}/sriov-vfs/sriov-vf/{pci-id}:
     get:
       tags:
         - Network
       summary: returns sriov-vf
       description: returns sriov-vf
-      operationId: getNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceSriovVfsSriovVf
+      operationId: getNetworkNewvcesNewvceLInterfacesLInterfaceSriovVfsSriovVf
       produces:
         - application/json
         - application/xml
@@ -34730,38 +43568,51 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/sriov-vf"
+              $ref: "#/getDefinitions/sriov-vf"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: pnf-name
-          in: path
-          description: unique name of Physical Network Function.
-          required: true
-          type: string
-        - name: interface-name
+        - name: vnf-id2
           in: path
-          description: Name that identifies the physical interface
+          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
           required: true
           type: string
+          example: __VNF-ID2__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: pci-id
           in: path
           description: PCI ID used to identify the sriov-vf
           required: true
           type: string
-        - name: inv-status
+          example: __PCI-ID__
+        - name: vnf-name
           in: query
-          description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
+          description: Name of VNF.
+          required: false
+          type: string
+        - name: vnf-name2
+          in: query
+          description: Alternate name of VNF.
+          required: false
+          type: string
+        - name: vnf-type
+          in: query
+          description: String capturing type of vnf, that was intended to identify the ASDC resource.  This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures.
           required: false
           type: string
         - name: prov-status
           in: query
-          description: Trigger for operational monitoring of this resource by Service Assurance systems.
+          description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems.
+          required: false
+          type: string
+        - name: heat-stack-id
+          in: query
+          description: Heat stack id corresponding to this instance, managed by MSO
           required: false
           type: string
         - name: interface-id
@@ -34803,8 +43654,11 @@ paths:
       tags:
         - Network
       summary: create or update an existing sriov-vf
-      description: create or update an existing sriov-vf
-      operationId: createOrUpdateNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceSriovVfsSriovVf
+      description: |
+        Create or update an existing sriov-vf.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkNewvcesNewvceLInterfacesLInterfaceSriovVfsSriovVf
       consumes:
         - application/json
         - application/xml
@@ -34815,38 +43669,87 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: pnf-name
+        - name: vnf-id2
           in: path
-          description: unique name of Physical Network Function.
+          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
           required: true
           type: string
+          example: __VNF-ID2__
         - name: interface-name
           in: path
-          description: Name that identifies the physical interface
+          description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
+        - name: pci-id
+          in: path
+          description: PCI ID used to identify the sriov-vf
+          required: true
+          type: string
+          example: __PCI-ID__
+        - name: body
+          in: body
+          description: sriov-vf object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkNewvcesNewvceLInterfacesLInterfaceSriovVfsSriovVf.json)
+          required: true
+          schema:
+            $ref: "#/definitions/sriov-vf"
+    patch:
+      tags:
+        - Network
+      summary: update an existing sriov-vf
+      description: |
+        Update an existing sriov-vf
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkNewvcesNewvceLInterfacesLInterfaceSriovVfsSriovVf
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: vnf-id2
+          in: path
+          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
+          required: true
+          type: string
+          example: __VNF-ID2__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: pci-id
           in: path
           description: PCI ID used to identify the sriov-vf
           required: true
           type: string
+          example: __PCI-ID__
         - name: body
           in: body
-          description: sriov-vf object that needs to be created or updated
+          description: sriov-vf object that needs to be created or updated
           required: true
           schema:
-            $ref: "#/definitions/sriov-vf"
+            $ref: "#/patchDefinitions/sriov-vf"
     delete:
       tags:
         - Network
       summary: delete an existing sriov-vf
       description: delete an existing sriov-vf
-      operationId: deleteNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceSriovVfsSriovVf
+      operationId: deleteNetworkNewvcesNewvceLInterfacesLInterfaceSriovVfsSriovVf
       consumes:
         - application/json
         - application/xml
@@ -34857,38 +43760,36 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: pnf-name
-          in: path
-          description: unique name of Physical Network Function.
-          required: true
-          type: string
-        - name: interface-name
+        - name: vnf-id2
           in: path
-          description: Name that identifies the physical interface
+          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
           required: true
           type: string
+          example: __VNF-ID2__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: pci-id
           in: path
           description: PCI ID used to identify the sriov-vf
           required: true
           type: string
+          example: __PCI-ID__
         - name: resource-version
           in: query
           description: resource-version for concurrency
           required: true
           type: string
-  /network/pnfs/pnf/{pnf-name}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/sriov-vfs:
+  /network/newvces/newvce/{vnf-id2}/l-interfaces/l-interface/{interface-name}/sriov-vfs:
     get:
       tags:
         - Network
       summary: returns sriov-vfs
       description: returns sriov-vfs
-      operationId: getNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceSriovVfs
+      operationId: getNetworkNewvcesNewvceLInterfacesLInterfaceSriovVfs
       produces:
         - application/json
         - application/xml
@@ -34896,33 +43797,45 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/sriov-vfs"
+              $ref: "#/getDefinitions/sriov-vfs"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: pnf-name
-          in: path
-          description: unique name of Physical Network Function.
-          required: true
-          type: string
-        - name: interface-name
+        - name: vnf-id2
           in: path
-          description: Name that identifies the physical interface
+          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
           required: true
           type: string
+          example: __VNF-ID2__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
-        - name: inv-status
+          example: __INTERFACE-NAME__
+        - name: vnf-name
           in: query
-          description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
+          description: Name of VNF.
+          required: false
+          type: string
+        - name: vnf-name2
+          in: query
+          description: Alternate name of VNF.
+          required: false
+          type: string
+        - name: vnf-type
+          in: query
+          description: String capturing type of vnf, that was intended to identify the ASDC resource.  This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures.
           required: false
           type: string
         - name: prov-status
           in: query
-          description: Trigger for operational monitoring of this resource by Service Assurance systems.
+          description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems.
+          required: false
+          type: string
+        - name: heat-stack-id
+          in: query
+          description: Heat stack id corresponding to this instance, managed by MSO
           required: false
           type: string
         - name: interface-id
@@ -34940,12 +43853,12 @@ paths:
           description: Name of the network
           required: false
           type: string
-  /network/pnfs/pnf/{pnf-name}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/relationship-list/relationship:
+  /network/newvces/newvce/{vnf-id2}/l-interfaces/l-interface/{interface-name}/relationship-list/relationship:
     put:
       tags:
         - Network
       summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceRelationshipListRelationship
+      operationId: createOrUpdateNetworkNewvcesNewvceLInterfacesLInterfaceRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -34956,24 +43869,21 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: pnf-name
-          in: path
-          description: unique name of Physical Network Function.
-          required: true
-          type: string
-        - name: interface-name
+        - name: vnf-id2
           in: path
-          description: Name that identifies the physical interface
+          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
           required: true
           type: string
+          example: __VNF-ID2__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkNewvcesNewvceLInterfacesLInterface.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -34982,7 +43892,7 @@ paths:
         - Network
       summary: delete an existing relationship
       description: delete an existing relationship
-      operationId: deleteNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceRelationshipListRelationship
+      operationId: deleteNetworkNewvcesNewvceLInterfacesLInterfaceRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -34993,27 +43903,24 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: pnf-name
-          in: path
-          description: unique name of Physical Network Function.
-          required: true
-          type: string
-        - name: interface-name
+        - name: vnf-id2
           in: path
-          description: Name that identifies the physical interface
+          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
           required: true
           type: string
+          example: __VNF-ID2__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
-  /network/pnfs/pnf/{pnf-name}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}/relationship-list/relationship:
+          example: __INTERFACE-NAME__
+  /network/newvces/newvce/{vnf-id2}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}/relationship-list/relationship:
     put:
       tags:
         - Network
       summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressListRelationshipListRelationship
+      operationId: createOrUpdateNetworkNewvcesNewvceLInterfacesLInterfaceL3InterfaceIpv4AddressListRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -35024,29 +43931,27 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: pnf-name
-          in: path
-          description: unique name of Physical Network Function.
-          required: true
-          type: string
-        - name: interface-name
+        - name: vnf-id2
           in: path
-          description: Name that identifies the physical interface
+          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
           required: true
           type: string
+          example: __VNF-ID2__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: l3-interface-ipv4-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkNewvcesNewvceLInterfacesLInterfaceL3InterfaceIpv4AddressList.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -35055,7 +43960,7 @@ paths:
         - Network
       summary: delete an existing relationship
       description: delete an existing relationship
-      operationId: deleteNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressListRelationshipListRelationship
+      operationId: deleteNetworkNewvcesNewvceLInterfacesLInterfaceL3InterfaceIpv4AddressListRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -35066,33 +43971,31 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: pnf-name
-          in: path
-          description: unique name of Physical Network Function.
-          required: true
-          type: string
-        - name: interface-name
+        - name: vnf-id2
           in: path
-          description: Name that identifies the physical interface
+          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
           required: true
           type: string
+          example: __VNF-ID2__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: l3-interface-ipv4-address
           in: path
           description: IP address
           required: true
           type: string
-  /network/pnfs/pnf/{pnf-name}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}:
+          example: __L3-INTERFACE-IPV4-ADDRESS__
+  /network/newvces/newvce/{vnf-id2}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}:
     get:
       tags:
         - Network
       summary: returns l3-interface-ipv4-address-list
       description: returns l3-interface-ipv4-address-list
-      operationId: getNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList
+      operationId: getNetworkNewvcesNewvceLInterfacesLInterfaceL3InterfaceIpv4AddressList
       produces:
         - application/json
         - application/xml
@@ -35100,38 +44003,51 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/l3-interface-ipv4-address-list"
+              $ref: "#/getDefinitions/l3-interface-ipv4-address-list"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: pnf-name
-          in: path
-          description: unique name of Physical Network Function.
-          required: true
-          type: string
-        - name: interface-name
+        - name: vnf-id2
           in: path
-          description: Name that identifies the physical interface
+          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
           required: true
           type: string
+          example: __VNF-ID2__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: l3-interface-ipv4-address
           in: path
           description: IP address
           required: true
           type: string
-        - name: inv-status
+          example: __L3-INTERFACE-IPV4-ADDRESS__
+        - name: vnf-name
           in: query
-          description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
+          description: Name of VNF.
+          required: false
+          type: string
+        - name: vnf-name2
+          in: query
+          description: Alternate name of VNF.
+          required: false
+          type: string
+        - name: vnf-type
+          in: query
+          description: String capturing type of vnf, that was intended to identify the ASDC resource.  This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures.
           required: false
           type: string
         - name: prov-status
           in: query
-          description: Trigger for operational monitoring of this resource by Service Assurance systems.
+          description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems.
+          required: false
+          type: string
+        - name: heat-stack-id
+          in: query
+          description: Heat stack id corresponding to this instance, managed by MSO
           required: false
           type: string
         - name: interface-id
@@ -35169,8 +44085,11 @@ paths:
       tags:
         - Network
       summary: create or update an existing l3-interface-ipv4-address-list
-      description: create or update an existing l3-interface-ipv4-address-list
-      operationId: createOrUpdateNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList
+      description: |
+        Create or update an existing l3-interface-ipv4-address-list.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkNewvcesNewvceLInterfacesLInterfaceL3InterfaceIpv4AddressList
       consumes:
         - application/json
         - application/xml
@@ -35181,38 +44100,87 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: pnf-name
+        - name: vnf-id2
           in: path
-          description: unique name of Physical Network Function.
+          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
           required: true
           type: string
+          example: __VNF-ID2__
         - name: interface-name
           in: path
-          description: Name that identifies the physical interface
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: l3-interface-ipv4-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
+        - name: body
+          in: body
+          description: l3-interface-ipv4-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkNewvcesNewvceLInterfacesLInterfaceL3InterfaceIpv4AddressList.json)
+          required: true
+          schema:
+            $ref: "#/definitions/l3-interface-ipv4-address-list"
+    patch:
+      tags:
+        - Network
+      summary: update an existing l3-interface-ipv4-address-list
+      description: |
+        Update an existing l3-interface-ipv4-address-list
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkNewvcesNewvceLInterfacesLInterfaceL3InterfaceIpv4AddressList
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: vnf-id2
+          in: path
+          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
           required: true
           type: string
+          example: __VNF-ID2__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: l3-interface-ipv4-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
         - name: body
           in: body
-          description: l3-interface-ipv4-address-list object that needs to be created or updated
+          description: l3-interface-ipv4-address-list object that needs to be created or updated
           required: true
           schema:
-            $ref: "#/definitions/l3-interface-ipv4-address-list"
+            $ref: "#/patchDefinitions/l3-interface-ipv4-address-list"
     delete:
       tags:
         - Network
       summary: delete an existing l3-interface-ipv4-address-list
       description: delete an existing l3-interface-ipv4-address-list
-      operationId: deleteNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList
+      operationId: deleteNetworkNewvcesNewvceLInterfacesLInterfaceL3InterfaceIpv4AddressList
       consumes:
         - application/json
         - application/xml
@@ -35223,37 +44191,35 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: pnf-name
-          in: path
-          description: unique name of Physical Network Function.
-          required: true
-          type: string
-        - name: interface-name
+        - name: vnf-id2
           in: path
-          description: Name that identifies the physical interface
+          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
           required: true
           type: string
+          example: __VNF-ID2__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: l3-interface-ipv4-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
         - name: resource-version
           in: query
           description: resource-version for concurrency
           required: true
           type: string
-  /network/pnfs/pnf/{pnf-name}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}/relationship-list/relationship:
+  /network/newvces/newvce/{vnf-id2}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}/relationship-list/relationship:
     put:
       tags:
         - Network
       summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressListRelationshipListRelationship
+      operationId: createOrUpdateNetworkNewvcesNewvceLInterfacesLInterfaceL3InterfaceIpv6AddressListRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -35264,29 +44230,27 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: pnf-name
-          in: path
-          description: unique name of Physical Network Function.
-          required: true
-          type: string
-        - name: interface-name
+        - name: vnf-id2
           in: path
-          description: Name that identifies the physical interface
+          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
           required: true
           type: string
+          example: __VNF-ID2__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: l3-interface-ipv6-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkNewvcesNewvceLInterfacesLInterfaceL3InterfaceIpv6AddressList.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -35295,7 +44259,7 @@ paths:
         - Network
       summary: delete an existing relationship
       description: delete an existing relationship
-      operationId: deleteNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressListRelationshipListRelationship
+      operationId: deleteNetworkNewvcesNewvceLInterfacesLInterfaceL3InterfaceIpv6AddressListRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -35306,33 +44270,31 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: pnf-name
-          in: path
-          description: unique name of Physical Network Function.
-          required: true
-          type: string
-        - name: interface-name
+        - name: vnf-id2
           in: path
-          description: Name that identifies the physical interface
+          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
           required: true
           type: string
+          example: __VNF-ID2__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: l3-interface-ipv6-address
           in: path
           description: IP address
           required: true
           type: string
-  /network/pnfs/pnf/{pnf-name}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}:
+          example: __L3-INTERFACE-IPV6-ADDRESS__
+  /network/newvces/newvce/{vnf-id2}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}:
     get:
       tags:
         - Network
       summary: returns l3-interface-ipv6-address-list
       description: returns l3-interface-ipv6-address-list
-      operationId: getNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList
+      operationId: getNetworkNewvcesNewvceLInterfacesLInterfaceL3InterfaceIpv6AddressList
       produces:
         - application/json
         - application/xml
@@ -35340,38 +44302,51 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/l3-interface-ipv6-address-list"
+              $ref: "#/getDefinitions/l3-interface-ipv6-address-list"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: pnf-name
-          in: path
-          description: unique name of Physical Network Function.
-          required: true
-          type: string
-        - name: interface-name
+        - name: vnf-id2
           in: path
-          description: Name that identifies the physical interface
+          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
           required: true
           type: string
+          example: __VNF-ID2__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: l3-interface-ipv6-address
           in: path
           description: IP address
           required: true
           type: string
-        - name: inv-status
+          example: __L3-INTERFACE-IPV6-ADDRESS__
+        - name: vnf-name
           in: query
-          description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
+          description: Name of VNF.
+          required: false
+          type: string
+        - name: vnf-name2
+          in: query
+          description: Alternate name of VNF.
+          required: false
+          type: string
+        - name: vnf-type
+          in: query
+          description: String capturing type of vnf, that was intended to identify the ASDC resource.  This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures.
           required: false
           type: string
         - name: prov-status
           in: query
-          description: Trigger for operational monitoring of this resource by Service Assurance systems.
+          description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems.
+          required: false
+          type: string
+        - name: heat-stack-id
+          in: query
+          description: Heat stack id corresponding to this instance, managed by MSO
           required: false
           type: string
         - name: interface-id
@@ -35409,8 +44384,11 @@ paths:
       tags:
         - Network
       summary: create or update an existing l3-interface-ipv6-address-list
-      description: create or update an existing l3-interface-ipv6-address-list
-      operationId: createOrUpdateNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList
+      description: |
+        Create or update an existing l3-interface-ipv6-address-list.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkNewvcesNewvceLInterfacesLInterfaceL3InterfaceIpv6AddressList
       consumes:
         - application/json
         - application/xml
@@ -35421,38 +44399,87 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: pnf-name
+        - name: vnf-id2
           in: path
-          description: unique name of Physical Network Function.
+          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
           required: true
           type: string
+          example: __VNF-ID2__
         - name: interface-name
           in: path
-          description: Name that identifies the physical interface
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: l3-interface-ipv6-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
+        - name: body
+          in: body
+          description: l3-interface-ipv6-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkNewvcesNewvceLInterfacesLInterfaceL3InterfaceIpv6AddressList.json)
+          required: true
+          schema:
+            $ref: "#/definitions/l3-interface-ipv6-address-list"
+    patch:
+      tags:
+        - Network
+      summary: update an existing l3-interface-ipv6-address-list
+      description: |
+        Update an existing l3-interface-ipv6-address-list
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkNewvcesNewvceLInterfacesLInterfaceL3InterfaceIpv6AddressList
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: vnf-id2
+          in: path
+          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
           required: true
           type: string
+          example: __VNF-ID2__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: l3-interface-ipv6-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
         - name: body
           in: body
-          description: l3-interface-ipv6-address-list object that needs to be created or updated
+          description: l3-interface-ipv6-address-list object that needs to be created or updated
           required: true
           schema:
-            $ref: "#/definitions/l3-interface-ipv6-address-list"
+            $ref: "#/patchDefinitions/l3-interface-ipv6-address-list"
     delete:
       tags:
         - Network
       summary: delete an existing l3-interface-ipv6-address-list
       description: delete an existing l3-interface-ipv6-address-list
-      operationId: deleteNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList
+      operationId: deleteNetworkNewvcesNewvceLInterfacesLInterfaceL3InterfaceIpv6AddressList
       consumes:
         - application/json
         - application/xml
@@ -35463,38 +44490,36 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: pnf-name
-          in: path
-          description: unique name of Physical Network Function.
-          required: true
-          type: string
-        - name: interface-name
+        - name: vnf-id2
           in: path
-          description: Name that identifies the physical interface
+          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
           required: true
           type: string
+          example: __VNF-ID2__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: l3-interface-ipv6-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
         - name: resource-version
           in: query
           description: resource-version for concurrency
           required: true
           type: string
-  /network/pnfs/pnf/{pnf-name}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}:
+  /network/newvces/newvce/{vnf-id2}/l-interfaces/l-interface/{interface-name}:
     get:
       tags:
         - Network
       summary: returns l-interface
       description: returns l-interface
-      operationId: getNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterface
+      operationId: getNetworkNewvcesNewvceLInterfacesLInterface
       produces:
         - application/json
         - application/xml
@@ -35502,33 +44527,45 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/l-interface"
+              $ref: "#/getDefinitions/l-interface"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: pnf-name
-          in: path
-          description: unique name of Physical Network Function.
-          required: true
-          type: string
-        - name: interface-name
+        - name: vnf-id2
           in: path
-          description: Name that identifies the physical interface
+          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
           required: true
           type: string
+          example: __VNF-ID2__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
-        - name: inv-status
+          example: __INTERFACE-NAME__
+        - name: vnf-name
           in: query
-          description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
+          description: Name of VNF.
+          required: false
+          type: string
+        - name: vnf-name2
+          in: query
+          description: Alternate name of VNF.
+          required: false
+          type: string
+        - name: vnf-type
+          in: query
+          description: String capturing type of vnf, that was intended to identify the ASDC resource.  This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures.
           required: false
           type: string
         - name: prov-status
           in: query
-          description: Trigger for operational monitoring of this resource by Service Assurance systems.
+          description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems.
+          required: false
+          type: string
+        - name: heat-stack-id
+          in: query
+          description: Heat stack id corresponding to this instance, managed by MSO
           required: false
           type: string
         - name: interface-id
@@ -35550,8 +44587,11 @@ paths:
       tags:
         - Network
       summary: create or update an existing l-interface
-      description: create or update an existing l-interface
-      operationId: createOrUpdateNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterface
+      description: |
+        Create or update an existing l-interface.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkNewvcesNewvceLInterfacesLInterface
       consumes:
         - application/json
         - application/xml
@@ -35562,33 +44602,75 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: pnf-name
+        - name: vnf-id2
           in: path
-          description: unique name of Physical Network Function.
+          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
           required: true
           type: string
+          example: __VNF-ID2__
         - name: interface-name
           in: path
-          description: Name that identifies the physical interface
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: body
+          in: body
+          description: l-interface object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkNewvcesNewvceLInterfacesLInterface.json)
+          required: true
+          schema:
+            $ref: "#/definitions/l-interface"
+    patch:
+      tags:
+        - Network
+      summary: update an existing l-interface
+      description: |
+        Update an existing l-interface
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkNewvcesNewvceLInterfacesLInterface
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: vnf-id2
+          in: path
+          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
           required: true
           type: string
+          example: __VNF-ID2__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: body
           in: body
-          description: l-interface object that needs to be created or updated
+          description: l-interface object that needs to be created or updated
           required: true
           schema:
-            $ref: "#/definitions/l-interface"
+            $ref: "#/patchDefinitions/l-interface"
     delete:
       tags:
         - Network
       summary: delete an existing l-interface
       description: delete an existing l-interface
-      operationId: deleteNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterface
+      operationId: deleteNetworkNewvcesNewvceLInterfacesLInterface
       consumes:
         - application/json
         - application/xml
@@ -35599,33 +44681,30 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: pnf-name
-          in: path
-          description: unique name of Physical Network Function.
-          required: true
-          type: string
-        - name: interface-name
+        - name: vnf-id2
           in: path
-          description: Name that identifies the physical interface
+          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
           required: true
           type: string
+          example: __VNF-ID2__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: resource-version
           in: query
           description: resource-version for concurrency
           required: true
           type: string
-  /network/pnfs/pnf/{pnf-name}/p-interfaces/p-interface/{interface-name}/l-interfaces:
+  /network/newvces/newvce/{vnf-id2}/l-interfaces:
     get:
       tags:
         - Network
       summary: returns l-interfaces
       description: returns l-interfaces
-      operationId: getNetworkPnfsPnfPInterfacesPInterfaceLInterfaces
+      operationId: getNetworkNewvcesNewvceLInterfaces
       produces:
         - application/json
         - application/xml
@@ -35633,37 +44712,48 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/l-interfaces"
+              $ref: "#/getDefinitions/l-interfaces"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: pnf-name
+        - name: vnf-id2
           in: path
-          description: unique name of Physical Network Function.
+          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
           required: true
           type: string
-        - name: interface-name
-          in: path
-          description: Name that identifies the physical interface
-          required: true
+          example: __VNF-ID2__
+        - name: vnf-name
+          in: query
+          description: Name of VNF.
+          required: false
           type: string
-        - name: inv-status
+        - name: vnf-name2
           in: query
-          description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
+          description: Alternate name of VNF.
+          required: false
+          type: string
+        - name: vnf-type
+          in: query
+          description: String capturing type of vnf, that was intended to identify the ASDC resource.  This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures.
           required: false
           type: string
         - name: prov-status
           in: query
-          description: Trigger for operational monitoring of this resource by Service Assurance systems.
+          description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems.
           required: false
           type: string
-  /network/pnfs/pnf/{pnf-name}/p-interfaces/p-interface/{interface-name}:
+        - name: heat-stack-id
+          in: query
+          description: Heat stack id corresponding to this instance, managed by MSO
+          required: false
+          type: string
+  /network/newvces/newvce/{vnf-id2}:
     get:
       tags:
         - Network
-      summary: returns p-interface
-      description: returns p-interface
-      operationId: getNetworkPnfsPnfPInterfacesPInterface
+      summary: returns newvce
+      description: returns newvce
+      operationId: getNetworkNewvcesNewvce
       produces:
         - application/json
         - application/xml
@@ -35671,36 +44761,50 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/p-interface"
+              $ref: "#/getDefinitions/newvce"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: pnf-name
+        - name: vnf-id2
           in: path
-          description: unique name of Physical Network Function.
+          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
           required: true
           type: string
-        - name: interface-name
-          in: path
-          description: Name that identifies the physical interface
-          required: true
+          example: __VNF-ID2__
+        - name: vnf-name
+          in: query
+          description: Name of VNF.
+          required: false
           type: string
-        - name: inv-status
+        - name: vnf-name2
           in: query
-          description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
+          description: Alternate name of VNF.
+          required: false
+          type: string
+        - name: vnf-type
+          in: query
+          description: String capturing type of vnf, that was intended to identify the ASDC resource.  This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures.
           required: false
           type: string
         - name: prov-status
           in: query
-          description: Trigger for operational monitoring of this resource by Service Assurance systems.
+          description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems.
+          required: false
+          type: string
+        - name: heat-stack-id
+          in: query
+          description: Heat stack id corresponding to this instance, managed by MSO
           required: false
           type: string
     put:
       tags:
         - Network
-      summary: create or update an existing p-interface
-      description: create or update an existing p-interface
-      operationId: createOrUpdateNetworkPnfsPnfPInterfacesPInterface
+      summary: create or update an existing newvce
+      description: |
+        Create or update an existing newvce.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkNewvcesNewvce
       consumes:
         - application/json
         - application/xml
@@ -35711,28 +44815,63 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: pnf-name
+        - name: vnf-id2
           in: path
-          description: unique name of Physical Network Function.
+          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
           required: true
           type: string
-        - name: interface-name
+          example: __VNF-ID2__
+        - name: body
+          in: body
+          description: newvce object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkNewvcesNewvce.json)
+          required: true
+          schema:
+            $ref: "#/definitions/newvce"
+    patch:
+      tags:
+        - Network
+      summary: update an existing newvce
+      description: |
+        Update an existing newvce
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkNewvcesNewvce
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: vnf-id2
           in: path
-          description: Name that identifies the physical interface
+          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
           required: true
           type: string
+          example: __VNF-ID2__
         - name: body
           in: body
-          description: p-interface object that needs to be created or updated
+          description: newvce object that needs to be created or updated. 
           required: true
           schema:
-            $ref: "#/definitions/p-interface"
+            $ref: "#/patchDefinitions/newvce"
     delete:
       tags:
         - Network
-      summary: delete an existing p-interface
-      description: delete an existing p-interface
-      operationId: deleteNetworkPnfsPnfPInterfacesPInterface
+      summary: delete an existing newvce
+      description: delete an existing newvce
+      operationId: deleteNetworkNewvcesNewvce
       consumes:
         - application/json
         - application/xml
@@ -35743,28 +44882,24 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: pnf-name
-          in: path
-          description: unique name of Physical Network Function.
-          required: true
-          type: string
-        - name: interface-name
+        - name: vnf-id2
           in: path
-          description: Name that identifies the physical interface
+          description: Unique id of VNF, can't use same attribute name right now until we promote this new object
           required: true
           type: string
+          example: __VNF-ID2__
         - name: resource-version
           in: query
           description: resource-version for concurrency
           required: true
           type: string
-  /network/pnfs/pnf/{pnf-name}/p-interfaces:
+  /network/newvces:
     get:
       tags:
         - Network
-      summary: returns p-interfaces
-      description: returns p-interfaces
-      operationId: getNetworkPnfsPnfPInterfaces
+      summary: returns newvces
+      description: returns newvces
+      operationId: getNetworkNewvces
       produces:
         - application/json
         - application/xml
@@ -35772,26 +44907,15 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/p-interfaces"
+              $ref: "#/getDefinitions/newvces"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
-      parameters:
-        - name: pnf-name
-          in: path
-          description: unique name of Physical Network Function.
-          required: true
-          type: string
-        - name: inv-status
-          in: query
-          description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
-          required: false
-          type: string
-  /network/pnfs/pnf/{pnf-name}/lag-interfaces/lag-interface/{interface-name}/relationship-list/relationship:
+  /network/pnfs/pnf/{pnf-name}/relationship-list/relationship:
     put:
       tags:
         - Network
       summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkPnfsPnfLagInterfacesLagInterfaceRelationshipListRelationship
+      operationId: createOrUpdateNetworkPnfsPnfRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -35807,14 +44931,10 @@ paths:
           description: unique name of Physical Network Function.
           required: true
           type: string
-        - name: interface-name
-          in: path
-          description: Name that identifies the link aggregate interface
-          required: true
-          type: string
+          example: __PNF-NAME__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkPnfsPnf.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -35823,7 +44943,7 @@ paths:
         - Network
       summary: delete an existing relationship
       description: delete an existing relationship
-      operationId: deleteNetworkPnfsPnfLagInterfacesLagInterfaceRelationshipListRelationship
+      operationId: deleteNetworkPnfsPnfRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -35839,17 +44959,13 @@ paths:
           description: unique name of Physical Network Function.
           required: true
           type: string
-        - name: interface-name
-          in: path
-          description: Name that identifies the link aggregate interface
-          required: true
-          type: string
-  /network/pnfs/pnf/{pnf-name}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/relationship-list/relationship:
+          example: __PNF-NAME__
+  /network/pnfs/pnf/{pnf-name}/p-interfaces/p-interface/{interface-name}/relationship-list/relationship:
     put:
       tags:
         - Network
       summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanRelationshipListRelationship
+      operationId: createOrUpdateNetworkPnfsPnfPInterfacesPInterfaceRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -35865,24 +44981,16 @@ paths:
           description: unique name of Physical Network Function.
           required: true
           type: string
+          example: __PNF-NAME__
         - name: interface-name
           in: path
-          description: Name that identifies the link aggregate interface
-          required: true
-          type: string
-        - name: interface-name
-          in: path
-          description: Name given to the interface
-          required: true
-          type: string
-        - name: vlan-interface
-          in: path
-          description: String that identifies the interface
+          description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkPnfsPnfPInterfacesPInterface.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -35891,7 +44999,7 @@ paths:
         - Network
       summary: delete an existing relationship
       description: delete an existing relationship
-      operationId: deleteNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanRelationshipListRelationship
+      operationId: deleteNetworkPnfsPnfPInterfacesPInterfaceRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -35907,27 +45015,19 @@ paths:
           description: unique name of Physical Network Function.
           required: true
           type: string
+          example: __PNF-NAME__
         - name: interface-name
           in: path
-          description: Name that identifies the link aggregate interface
-          required: true
-          type: string
-        - name: interface-name
-          in: path
-          description: Name given to the interface
-          required: true
-          type: string
-        - name: vlan-interface
-          in: path
-          description: String that identifies the interface
+          description: Name that identifies the physical interface
           required: true
           type: string
-  /network/pnfs/pnf/{pnf-name}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}/relationship-list/relationship:
+          example: __INTERFACE-NAME__
+  /network/pnfs/pnf/{pnf-name}/p-interfaces/p-interface/{interface-name}/sriov-pfs/sriov-pf/{pf-pci-id}/relationship-list/relationship:
     put:
       tags:
         - Network
       summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressListRelationshipListRelationship
+      operationId: createOrUpdateNetworkPnfsPnfPInterfacesPInterfaceSriovPfsSriovPfRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -35943,29 +45043,22 @@ paths:
           description: unique name of Physical Network Function.
           required: true
           type: string
+          example: __PNF-NAME__
         - name: interface-name
           in: path
-          description: Name that identifies the link aggregate interface
-          required: true
-          type: string
-        - name: interface-name
-          in: path
-          description: Name given to the interface
-          required: true
-          type: string
-        - name: vlan-interface
-          in: path
-          description: String that identifies the interface
+          description: Name that identifies the physical interface
           required: true
           type: string
-        - name: l3-interface-ipv4-address
+          example: __INTERFACE-NAME__
+        - name: pf-pci-id
           in: path
-          description: IP address
+          description: Identifier for the sriov-pf
           required: true
           type: string
+          example: __PF-PCI-ID__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkPnfsPnfPInterfacesPInterfaceSriovPfsSriovPf.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -35974,7 +45067,7 @@ paths:
         - Network
       summary: delete an existing relationship
       description: delete an existing relationship
-      operationId: deleteNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressListRelationshipListRelationship
+      operationId: deleteNetworkPnfsPnfPInterfacesPInterfaceSriovPfsSriovPfRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -35990,33 +45083,26 @@ paths:
           description: unique name of Physical Network Function.
           required: true
           type: string
+          example: __PNF-NAME__
         - name: interface-name
           in: path
-          description: Name that identifies the link aggregate interface
-          required: true
-          type: string
-        - name: interface-name
-          in: path
-          description: Name given to the interface
-          required: true
-          type: string
-        - name: vlan-interface
-          in: path
-          description: String that identifies the interface
+          description: Name that identifies the physical interface
           required: true
           type: string
-        - name: l3-interface-ipv4-address
+          example: __INTERFACE-NAME__
+        - name: pf-pci-id
           in: path
-          description: IP address
+          description: Identifier for the sriov-pf
           required: true
           type: string
-  /network/pnfs/pnf/{pnf-name}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}:
+          example: __PF-PCI-ID__
+  /network/pnfs/pnf/{pnf-name}/p-interfaces/p-interface/{interface-name}/sriov-pfs/sriov-pf/{pf-pci-id}:
     get:
       tags:
         - Network
-      summary: returns l3-interface-ipv4-address-list
-      description: returns l3-interface-ipv4-address-list
-      operationId: getNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList
+      summary: returns sriov-pf
+      description: returns sriov-pf
+      operationId: getNetworkPnfsPnfPInterfacesPInterfaceSriovPfsSriovPf
       produces:
         - application/json
         - application/xml
@@ -36024,7 +45110,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/l3-interface-ipv4-address-list"
+              $ref: "#/getDefinitions/sriov-pf"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -36033,89 +45119,38 @@ paths:
           description: unique name of Physical Network Function.
           required: true
           type: string
+          example: __PNF-NAME__
         - name: interface-name
           in: path
-          description: Name that identifies the link aggregate interface
-          required: true
-          type: string
-        - name: interface-name
-          in: path
-          description: Name given to the interface
-          required: true
-          type: string
-        - name: vlan-interface
-          in: path
-          description: String that identifies the interface
+          description: Name that identifies the physical interface
           required: true
           type: string
-        - name: l3-interface-ipv4-address
+          example: __INTERFACE-NAME__
+        - name: pf-pci-id
           in: path
-          description: IP address
+          description: Identifier for the sriov-pf
           required: true
           type: string
+          example: __PF-PCI-ID__
         - name: inv-status
           in: query
           description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
           required: false
           type: string
-        - name: interface-id
-          in: query
-          description: ID of interface
-          required: false
-          type: string
-        - name: interface-role
-          in: query
-          description: Role assigned to this Interface, should use values as defined in ECOMP Yang models.
-          required: false
-          type: string
-        - name: interface-id
-          in: query
-          description: ID of interface
-          required: false
-          type: string
-        - name: macaddr
-          in: query
-          description: MAC address for the interface
-          required: false
-          type: string
-        - name: network-name
-          in: query
-          description: Name of the network
-          required: false
-          type: string
-        - name: vlan-id-inner
-          in: query
-          description: Inner VLAN tag
-          required: false
-          type: integer
-          format: int64
-        - name: vpn-key
-          in: query
-          description: This indicates the customers VPN ID associated with this vlan
-          required: false
-          type: string
-        - name: vlan-id-inner
-          in: query
-          description: Inner VLAN tag
-          required: false
-          type: integer
-          format: int64
-        - name: neutron-network-id
-          in: query
-          description: Neutron network id of the interface that address belongs to
-          required: false
-          type: string
-        - name: neutron-subnet-id
+        - name: prov-status
           in: query
-          description: Neutron id of subnet that address belongs to
+          description: Trigger for operational monitoring of this resource by Service Assurance systems.
           required: false
           type: string
     put:
       tags:
         - Network
-      summary: create or update an existing l3-interface-ipv4-address-list
-      description: create or update an existing l3-interface-ipv4-address-list
-      operationId: createOrUpdateNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList
+      summary: create or update an existing sriov-pf
+      description: |
+        Create or update an existing sriov-pf.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkPnfsPnfPInterfacesPInterfaceSriovPfsSriovPf
       consumes:
         - application/json
         - application/xml
@@ -36131,38 +45166,42 @@ paths:
           description: unique name of Physical Network Function.
           required: true
           type: string
+          example: __PNF-NAME__
         - name: interface-name
           in: path
-          description: Name that identifies the link aggregate interface
-          required: true
-          type: string
-        - name: interface-name
-          in: path
-          description: Name given to the interface
-          required: true
-          type: string
-        - name: vlan-interface
-          in: path
-          description: String that identifies the interface
+          description: Name that identifies the physical interface
           required: true
           type: string
-        - name: l3-interface-ipv4-address
+          example: __INTERFACE-NAME__
+        - name: pf-pci-id
           in: path
-          description: IP address
+          description: Identifier for the sriov-pf
           required: true
           type: string
+          example: __PF-PCI-ID__
         - name: body
           in: body
-          description: l3-interface-ipv4-address-list object that needs to be created or updated
+          description: sriov-pf object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkPnfsPnfPInterfacesPInterfaceSriovPfsSriovPf.json)
           required: true
           schema:
-            $ref: "#/definitions/l3-interface-ipv4-address-list"
-    delete:
+            $ref: "#/definitions/sriov-pf"
+    patch:
       tags:
         - Network
-      summary: delete an existing l3-interface-ipv4-address-list
-      description: delete an existing l3-interface-ipv4-address-list
-      operationId: deleteNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList
+      summary: update an existing sriov-pf
+      description: |
+        Update an existing sriov-pf
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkPnfsPnfPInterfacesPInterfaceSriovPfsSriovPf
       consumes:
         - application/json
         - application/xml
@@ -36178,37 +45217,31 @@ paths:
           description: unique name of Physical Network Function.
           required: true
           type: string
+          example: __PNF-NAME__
         - name: interface-name
           in: path
-          description: Name that identifies the link aggregate interface
-          required: true
-          type: string
-        - name: interface-name
-          in: path
-          description: Name given to the interface
-          required: true
-          type: string
-        - name: vlan-interface
-          in: path
-          description: String that identifies the interface
+          description: Name that identifies the physical interface
           required: true
           type: string
-        - name: l3-interface-ipv4-address
+          example: __INTERFACE-NAME__
+        - name: pf-pci-id
           in: path
-          description: IP address
+          description: Identifier for the sriov-pf
           required: true
           type: string
-        - name: resource-version
-          in: query
-          description: resource-version for concurrency
+          example: __PF-PCI-ID__
+        - name: body
+          in: body
+          description: sriov-pf object that needs to be created or updated. 
           required: true
-          type: string
-  /network/pnfs/pnf/{pnf-name}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}/relationship-list/relationship:
-    put:
+          schema:
+            $ref: "#/patchDefinitions/sriov-pf"
+    delete:
       tags:
         - Network
-      summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressListRelationshipListRelationship
+      summary: delete an existing sriov-pf
+      description: delete an existing sriov-pf
+      operationId: deleteNetworkPnfsPnfPInterfacesPInterfaceSriovPfsSriovPf
       consumes:
         - application/json
         - application/xml
@@ -36224,45 +45257,39 @@ paths:
           description: unique name of Physical Network Function.
           required: true
           type: string
+          example: __PNF-NAME__
         - name: interface-name
           in: path
-          description: Name that identifies the link aggregate interface
-          required: true
-          type: string
-        - name: interface-name
-          in: path
-          description: Name given to the interface
+          description: Name that identifies the physical interface
           required: true
           type: string
-        - name: vlan-interface
+          example: __INTERFACE-NAME__
+        - name: pf-pci-id
           in: path
-          description: String that identifies the interface
+          description: Identifier for the sriov-pf
           required: true
           type: string
-        - name: l3-interface-ipv6-address
-          in: path
-          description: IP address
+          example: __PF-PCI-ID__
+        - name: resource-version
+          in: query
+          description: resource-version for concurrency
           required: true
           type: string
-        - name: body
-          in: body
-          description: relationship object that needs to be created or updated
-          required: true
-          schema:
-            $ref: "#/definitions/relationship"
-    delete:
+  /network/pnfs/pnf/{pnf-name}/p-interfaces/p-interface/{interface-name}/sriov-pfs:
+    get:
       tags:
         - Network
-      summary: delete an existing relationship
-      description: delete an existing relationship
-      operationId: deleteNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressListRelationshipListRelationship
-      consumes:
-        - application/json
-        - application/xml
+      summary: returns sriov-pfs
+      description: returns sriov-pfs
+      operationId: getNetworkPnfsPnfPInterfacesPInterfaceSriovPfs
       produces:
         - application/json
         - application/xml
       responses:
+        "200":
+          description: successful operation
+          schema:
+              $ref: "#/getDefinitions/sriov-pfs"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -36271,41 +45298,82 @@ paths:
           description: unique name of Physical Network Function.
           required: true
           type: string
+          example: __PNF-NAME__
         - name: interface-name
           in: path
-          description: Name that identifies the link aggregate interface
+          description: Name that identifies the physical interface
           required: true
           type: string
-        - name: interface-name
-          in: path
+          example: __INTERFACE-NAME__
+        - name: inv-status
+          in: query
+          description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
+          required: false
+          type: string
+        - name: prov-status
+          in: query
+          description: Trigger for operational monitoring of this resource by Service Assurance systems.
+          required: false
+          type: string
+  /network/pnfs/pnf/{pnf-name}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/relationship-list/relationship:
+    put:
+      tags:
+        - Network
+      summary: see node definition for valid relationships
+      operationId: createOrUpdateNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceVlansVlanRelationshipListRelationship
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: pnf-name
+          in: path
+          description: unique name of Physical Network Function.
+          required: true
+          type: string
+          example: __PNF-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the physical interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vlan-interface
           in: path
           description: String that identifies the interface
           required: true
           type: string
-        - name: l3-interface-ipv6-address
-          in: path
-          description: IP address
+          example: __VLAN-INTERFACE__
+        - name: body
+          in: body
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceVlansVlan.json)
           required: true
-          type: string
-  /network/pnfs/pnf/{pnf-name}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}:
-    get:
+          schema:
+            $ref: "#/definitions/relationship"
+    delete:
       tags:
         - Network
-      summary: returns l3-interface-ipv6-address-list
-      description: returns l3-interface-ipv6-address-list
-      operationId: getNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList
+      summary: delete an existing relationship
+      description: delete an existing relationship
+      operationId: deleteNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceVlansVlanRelationshipListRelationship
+      consumes:
+        - application/json
+        - application/xml
       produces:
         - application/json
         - application/xml
       responses:
-        "200":
-          description: successful operation
-          schema:
-              $ref: "#/definitions/l3-interface-ipv6-address-list"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -36314,89 +45382,31 @@ paths:
           description: unique name of Physical Network Function.
           required: true
           type: string
+          example: __PNF-NAME__
         - name: interface-name
           in: path
-          description: Name that identifies the link aggregate interface
+          description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vlan-interface
           in: path
           description: String that identifies the interface
           required: true
           type: string
-        - name: l3-interface-ipv6-address
-          in: path
-          description: IP address
-          required: true
-          type: string
-        - name: inv-status
-          in: query
-          description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
-          required: false
-          type: string
-        - name: interface-id
-          in: query
-          description: ID of interface
-          required: false
-          type: string
-        - name: interface-role
-          in: query
-          description: Role assigned to this Interface, should use values as defined in ECOMP Yang models.
-          required: false
-          type: string
-        - name: interface-id
-          in: query
-          description: ID of interface
-          required: false
-          type: string
-        - name: macaddr
-          in: query
-          description: MAC address for the interface
-          required: false
-          type: string
-        - name: network-name
-          in: query
-          description: Name of the network
-          required: false
-          type: string
-        - name: vlan-id-inner
-          in: query
-          description: Inner VLAN tag
-          required: false
-          type: integer
-          format: int64
-        - name: vpn-key
-          in: query
-          description: This indicates the customers VPN ID associated with this vlan
-          required: false
-          type: string
-        - name: vlan-id-inner
-          in: query
-          description: Inner VLAN tag
-          required: false
-          type: integer
-          format: int64
-        - name: neutron-network-id
-          in: query
-          description: Neutron network id of the interface that address belongs to
-          required: false
-          type: string
-        - name: neutron-subnet-id
-          in: query
-          description: Neutron id of subnet that address belongs to
-          required: false
-          type: string
+          example: __VLAN-INTERFACE__
+  /network/pnfs/pnf/{pnf-name}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}/relationship-list/relationship:
     put:
       tags:
         - Network
-      summary: create or update an existing l3-interface-ipv6-address-list
-      description: create or update an existing l3-interface-ipv6-address-list
-      operationId: createOrUpdateNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList
+      summary: see node definition for valid relationships
+      operationId: createOrUpdateNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressListRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -36412,38 +45422,43 @@ paths:
           description: unique name of Physical Network Function.
           required: true
           type: string
+          example: __PNF-NAME__
         - name: interface-name
           in: path
-          description: Name that identifies the link aggregate interface
+          description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vlan-interface
           in: path
           description: String that identifies the interface
           required: true
           type: string
-        - name: l3-interface-ipv6-address
+          example: __VLAN-INTERFACE__
+        - name: l3-interface-ipv4-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
         - name: body
           in: body
-          description: l3-interface-ipv6-address-list object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList.json)
           required: true
           schema:
-            $ref: "#/definitions/l3-interface-ipv6-address-list"
+            $ref: "#/definitions/relationship"
     delete:
       tags:
         - Network
-      summary: delete an existing l3-interface-ipv6-address-list
-      description: delete an existing l3-interface-ipv6-address-list
-      operationId: deleteNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList
+      summary: delete an existing relationship
+      description: delete an existing relationship
+      operationId: deleteNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressListRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -36459,38 +45474,38 @@ paths:
           description: unique name of Physical Network Function.
           required: true
           type: string
+          example: __PNF-NAME__
         - name: interface-name
           in: path
-          description: Name that identifies the link aggregate interface
+          description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vlan-interface
           in: path
           description: String that identifies the interface
           required: true
           type: string
-        - name: l3-interface-ipv6-address
+          example: __VLAN-INTERFACE__
+        - name: l3-interface-ipv4-address
           in: path
           description: IP address
           required: true
           type: string
-        - name: resource-version
-          in: query
-          description: resource-version for concurrency
-          required: true
-          type: string
-  /network/pnfs/pnf/{pnf-name}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}:
+          example: __L3-INTERFACE-IPV4-ADDRESS__
+  /network/pnfs/pnf/{pnf-name}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}:
     get:
       tags:
         - Network
-      summary: returns vlan
-      description: returns vlan
-      operationId: getNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlan
+      summary: returns l3-interface-ipv4-address-list
+      description: returns l3-interface-ipv4-address-list
+      operationId: getNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList
       produces:
         - application/json
         - application/xml
@@ -36498,7 +45513,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/vlan"
+              $ref: "#/getDefinitions/l3-interface-ipv4-address-list"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -36507,34 +45522,39 @@ paths:
           description: unique name of Physical Network Function.
           required: true
           type: string
+          example: __PNF-NAME__
         - name: interface-name
           in: path
-          description: Name that identifies the link aggregate interface
+          description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vlan-interface
           in: path
           description: String that identifies the interface
           required: true
           type: string
+          example: __VLAN-INTERFACE__
+        - name: l3-interface-ipv4-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
         - name: inv-status
           in: query
           description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
           required: false
           type: string
-        - name: interface-id
-          in: query
-          description: ID of interface
-          required: false
-          type: string
-        - name: interface-role
+        - name: prov-status
           in: query
-          description: Role assigned to this Interface, should use values as defined in ECOMP Yang models.
+          description: Trigger for operational monitoring of this resource by Service Assurance systems.
           required: false
           type: string
         - name: interface-id
@@ -36563,12 +45583,31 @@ paths:
           description: This indicates the customers VPN ID associated with this vlan
           required: false
           type: string
+        - name: vlan-id-inner
+          in: query
+          description: Inner VLAN tag
+          required: false
+          type: integer
+          format: int64
+        - name: neutron-network-id
+          in: query
+          description: Neutron network id of the interface that address belongs to
+          required: false
+          type: string
+        - name: neutron-subnet-id
+          in: query
+          description: Neutron id of subnet that address belongs to
+          required: false
+          type: string
     put:
       tags:
         - Network
-      summary: create or update an existing vlan
-      description: create or update an existing vlan
-      operationId: createOrUpdateNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlan
+      summary: create or update an existing l3-interface-ipv4-address-list
+      description: |
+        Create or update an existing l3-interface-ipv4-address-list.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList
       consumes:
         - application/json
         - application/xml
@@ -36584,33 +45623,54 @@ paths:
           description: unique name of Physical Network Function.
           required: true
           type: string
+          example: __PNF-NAME__
         - name: interface-name
           in: path
-          description: Name that identifies the link aggregate interface
+          description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vlan-interface
           in: path
           description: String that identifies the interface
           required: true
           type: string
+          example: __VLAN-INTERFACE__
+        - name: l3-interface-ipv4-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
         - name: body
           in: body
-          description: vlan object that needs to be created or updated
+          description: l3-interface-ipv4-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList.json)
           required: true
           schema:
-            $ref: "#/definitions/vlan"
-    delete:
+            $ref: "#/definitions/l3-interface-ipv4-address-list"
+    patch:
       tags:
         - Network
-      summary: delete an existing vlan
-      description: delete an existing vlan
-      operationId: deleteNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlan
+      summary: update an existing l3-interface-ipv4-address-list
+      description: |
+        Update an existing l3-interface-ipv4-address-list
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList
       consumes:
         - application/json
         - application/xml
@@ -36626,41 +45686,50 @@ paths:
           description: unique name of Physical Network Function.
           required: true
           type: string
+          example: __PNF-NAME__
         - name: interface-name
           in: path
-          description: Name that identifies the link aggregate interface
+          description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: vlan-interface
           in: path
           description: String that identifies the interface
           required: true
           type: string
-        - name: resource-version
-          in: query
-          description: resource-version for concurrency
+          example: __VLAN-INTERFACE__
+        - name: l3-interface-ipv4-address
+          in: path
+          description: IP address
           required: true
           type: string
-  /network/pnfs/pnf/{pnf-name}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans:
-    get:
+          example: __L3-INTERFACE-IPV4-ADDRESS__
+        - name: body
+          in: body
+          description: l3-interface-ipv4-address-list object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/l3-interface-ipv4-address-list"
+    delete:
       tags:
         - Network
-      summary: returns vlans
-      description: returns vlans
-      operationId: getNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlans
+      summary: delete an existing l3-interface-ipv4-address-list
+      description: delete an existing l3-interface-ipv4-address-list
+      operationId: deleteNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList
+      consumes:
+        - application/json
+        - application/xml
       produces:
         - application/json
         - application/xml
       responses:
-        "200":
-          description: successful operation
-          schema:
-              $ref: "#/definitions/vlans"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -36669,52 +45738,42 @@ paths:
           description: unique name of Physical Network Function.
           required: true
           type: string
+          example: __PNF-NAME__
         - name: interface-name
           in: path
-          description: Name that identifies the link aggregate interface
+          description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
-        - name: inv-status
-          in: query
-          description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
-          required: false
-          type: string
-        - name: interface-id
-          in: query
-          description: ID of interface
-          required: false
-          type: string
-        - name: interface-role
-          in: query
-          description: Role assigned to this Interface, should use values as defined in ECOMP Yang models.
-          required: false
-          type: string
-        - name: interface-id
-          in: query
-          description: ID of interface
-          required: false
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
           type: string
-        - name: macaddr
-          in: query
-          description: MAC address for the interface
-          required: false
+          example: __VLAN-INTERFACE__
+        - name: l3-interface-ipv4-address
+          in: path
+          description: IP address
+          required: true
           type: string
-        - name: network-name
+          example: __L3-INTERFACE-IPV4-ADDRESS__
+        - name: resource-version
           in: query
-          description: Name of the network
-          required: false
+          description: resource-version for concurrency
+          required: true
           type: string
-  /network/pnfs/pnf/{pnf-name}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/sriov-vfs/sriov-vf/{pci-id}/relationship-list/relationship:
+  /network/pnfs/pnf/{pnf-name}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}/relationship-list/relationship:
     put:
       tags:
         - Network
       summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfsSriovVfRelationshipListRelationship
+      operationId: createOrUpdateNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressListRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -36730,24 +45789,34 @@ paths:
           description: unique name of Physical Network Function.
           required: true
           type: string
+          example: __PNF-NAME__
         - name: interface-name
           in: path
-          description: Name that identifies the link aggregate interface
+          description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
-        - name: pci-id
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
           in: path
-          description: PCI ID used to identify the sriov-vf
+          description: String that identifies the interface
+          required: true
+          type: string
+          example: __VLAN-INTERFACE__
+        - name: l3-interface-ipv6-address
+          in: path
+          description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -36756,7 +45825,7 @@ paths:
         - Network
       summary: delete an existing relationship
       description: delete an existing relationship
-      operationId: deleteNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfsSriovVfRelationshipListRelationship
+      operationId: deleteNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressListRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -36772,28 +45841,38 @@ paths:
           description: unique name of Physical Network Function.
           required: true
           type: string
+          example: __PNF-NAME__
         - name: interface-name
           in: path
-          description: Name that identifies the link aggregate interface
+          description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
-        - name: pci-id
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
           in: path
-          description: PCI ID used to identify the sriov-vf
+          description: String that identifies the interface
           required: true
           type: string
-  /network/pnfs/pnf/{pnf-name}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/sriov-vfs/sriov-vf/{pci-id}:
+          example: __VLAN-INTERFACE__
+        - name: l3-interface-ipv6-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
+  /network/pnfs/pnf/{pnf-name}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}:
     get:
       tags:
         - Network
-      summary: returns sriov-vf
-      description: returns sriov-vf
-      operationId: getNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfsSriovVf
+      summary: returns l3-interface-ipv6-address-list
+      description: returns l3-interface-ipv6-address-list
+      operationId: getNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList
       produces:
         - application/json
         - application/xml
@@ -36801,7 +45880,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/sriov-vf"
+              $ref: "#/getDefinitions/l3-interface-ipv6-address-list"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -36810,34 +45889,39 @@ paths:
           description: unique name of Physical Network Function.
           required: true
           type: string
+          example: __PNF-NAME__
         - name: interface-name
           in: path
-          description: Name that identifies the link aggregate interface
+          description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
-        - name: pci-id
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
           in: path
-          description: PCI ID used to identify the sriov-vf
+          description: String that identifies the interface
+          required: true
+          type: string
+          example: __VLAN-INTERFACE__
+        - name: l3-interface-ipv6-address
+          in: path
+          description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
         - name: inv-status
           in: query
           description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
           required: false
           type: string
-        - name: interface-id
-          in: query
-          description: ID of interface
-          required: false
-          type: string
-        - name: interface-role
+        - name: prov-status
           in: query
-          description: Role assigned to this Interface, should use values as defined in ECOMP Yang models.
+          description: Trigger for operational monitoring of this resource by Service Assurance systems.
           required: false
           type: string
         - name: interface-id
@@ -36855,32 +45939,42 @@ paths:
           description: Name of the network
           required: false
           type: string
-        - name: vf-vlan-filter
+        - name: vlan-id-inner
           in: query
-          description: This metadata provides option to specify list of VLAN filters applied on VF to pass the traffic to VM.
+          description: Inner VLAN tag
           required: false
-          type: string
-        - name: vf-mac-filter
+          type: integer
+          format: int64
+        - name: vpn-key
           in: query
-          description: When MAC filters are specified, VF-agent service configures VFs to do MAC level filtering before the traffic is passed to VM.
+          description: This indicates the customers VPN ID associated with this vlan
           required: false
           type: string
-        - name: vf-vlan-strip
+        - name: vlan-id-inner
           in: query
-          description: When this field is set to true, VF will configured to strip the outer TAG before the traffic is passed to VM.
+          description: Inner VLAN tag
           required: false
-          type: boolean
+          type: integer
+          format: int64
         - name: neutron-network-id
           in: query
-          description: Neutron network id of the interface
+          description: Neutron network id of the interface that address belongs to
+          required: false
+          type: string
+        - name: neutron-subnet-id
+          in: query
+          description: Neutron id of subnet that address belongs to
           required: false
           type: string
     put:
       tags:
         - Network
-      summary: create or update an existing sriov-vf
-      description: create or update an existing sriov-vf
-      operationId: createOrUpdateNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfsSriovVf
+      summary: create or update an existing l3-interface-ipv6-address-list
+      description: |
+        Create or update an existing l3-interface-ipv6-address-list.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList
       consumes:
         - application/json
         - application/xml
@@ -36896,33 +45990,106 @@ paths:
           description: unique name of Physical Network Function.
           required: true
           type: string
+          example: __PNF-NAME__
         - name: interface-name
           in: path
-          description: Name that identifies the link aggregate interface
+          description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
-        - name: pci-id
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
           in: path
-          description: PCI ID used to identify the sriov-vf
+          description: String that identifies the interface
+          required: true
+          type: string
+          example: __VLAN-INTERFACE__
+        - name: l3-interface-ipv6-address
+          in: path
+          description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
         - name: body
           in: body
-          description: sriov-vf object that needs to be created or updated
+          description: l3-interface-ipv6-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList.json)
           required: true
           schema:
-            $ref: "#/definitions/sriov-vf"
+            $ref: "#/definitions/l3-interface-ipv6-address-list"
+    patch:
+      tags:
+        - Network
+      summary: update an existing l3-interface-ipv6-address-list
+      description: |
+        Update an existing l3-interface-ipv6-address-list
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: pnf-name
+          in: path
+          description: unique name of Physical Network Function.
+          required: true
+          type: string
+          example: __PNF-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the physical interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
+          type: string
+          example: __VLAN-INTERFACE__
+        - name: l3-interface-ipv6-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
+        - name: body
+          in: body
+          description: l3-interface-ipv6-address-list object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/l3-interface-ipv6-address-list"
     delete:
       tags:
         - Network
-      summary: delete an existing sriov-vf
-      description: delete an existing sriov-vf
-      operationId: deleteNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfsSriovVf
+      summary: delete an existing l3-interface-ipv6-address-list
+      description: delete an existing l3-interface-ipv6-address-list
+      operationId: deleteNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList
       consumes:
         - application/json
         - application/xml
@@ -36938,33 +46105,43 @@ paths:
           description: unique name of Physical Network Function.
           required: true
           type: string
+          example: __PNF-NAME__
         - name: interface-name
           in: path
-          description: Name that identifies the link aggregate interface
+          description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
-        - name: pci-id
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
           in: path
-          description: PCI ID used to identify the sriov-vf
+          description: String that identifies the interface
+          required: true
+          type: string
+          example: __VLAN-INTERFACE__
+        - name: l3-interface-ipv6-address
+          in: path
+          description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
         - name: resource-version
           in: query
           description: resource-version for concurrency
           required: true
           type: string
-  /network/pnfs/pnf/{pnf-name}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/sriov-vfs:
+  /network/pnfs/pnf/{pnf-name}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}:
     get:
       tags:
         - Network
-      summary: returns sriov-vfs
-      description: returns sriov-vfs
-      operationId: getNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfs
+      summary: returns vlan
+      description: returns vlan
+      operationId: getNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceVlansVlan
       produces:
         - application/json
         - application/xml
@@ -36972,7 +46149,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/sriov-vfs"
+              $ref: "#/getDefinitions/vlan"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -36981,29 +46158,33 @@ paths:
           description: unique name of Physical Network Function.
           required: true
           type: string
+          example: __PNF-NAME__
         - name: interface-name
           in: path
-          description: Name that identifies the link aggregate interface
+          description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
+          type: string
+          example: __VLAN-INTERFACE__
         - name: inv-status
           in: query
           description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
           required: false
           type: string
-        - name: interface-id
-          in: query
-          description: ID of interface
-          required: false
-          type: string
-        - name: interface-role
+        - name: prov-status
           in: query
-          description: Role assigned to this Interface, should use values as defined in ECOMP Yang models.
+          description: Trigger for operational monitoring of this resource by Service Assurance systems.
           required: false
           type: string
         - name: interface-id
@@ -37021,12 +46202,26 @@ paths:
           description: Name of the network
           required: false
           type: string
-  /network/pnfs/pnf/{pnf-name}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/relationship-list/relationship:
+        - name: vlan-id-inner
+          in: query
+          description: Inner VLAN tag
+          required: false
+          type: integer
+          format: int64
+        - name: vpn-key
+          in: query
+          description: This indicates the customers VPN ID associated with this vlan
+          required: false
+          type: string
     put:
       tags:
         - Network
-      summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceRelationshipListRelationship
+      summary: create or update an existing vlan
+      description: |
+        Create or update an existing vlan.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceVlansVlan
       consumes:
         - application/json
         - application/xml
@@ -37042,28 +46237,48 @@ paths:
           description: unique name of Physical Network Function.
           required: true
           type: string
+          example: __PNF-NAME__
         - name: interface-name
           in: path
-          description: Name that identifies the link aggregate interface
+          description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
+          type: string
+          example: __VLAN-INTERFACE__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: vlan object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceVlansVlan.json)
           required: true
           schema:
-            $ref: "#/definitions/relationship"
-    delete:
+            $ref: "#/definitions/vlan"
+    patch:
       tags:
         - Network
-      summary: delete an existing relationship
-      description: delete an existing relationship
-      operationId: deleteNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceRelationshipListRelationship
+      summary: update an existing vlan
+      description: |
+        Update an existing vlan
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceVlansVlan
       consumes:
         - application/json
         - application/xml
@@ -37079,22 +46294,37 @@ paths:
           description: unique name of Physical Network Function.
           required: true
           type: string
+          example: __PNF-NAME__
         - name: interface-name
           in: path
-          description: Name that identifies the link aggregate interface
+          description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
-  /network/pnfs/pnf/{pnf-name}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}/relationship-list/relationship:
-    put:
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
+          type: string
+          example: __VLAN-INTERFACE__
+        - name: body
+          in: body
+          description: vlan object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/vlan"
+    delete:
       tags:
         - Network
-      summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressListRelationshipListRelationship
+      summary: delete an existing vlan
+      description: delete an existing vlan
+      operationId: deleteNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceVlansVlan
       consumes:
         - application/json
         - application/xml
@@ -37110,33 +46340,143 @@ paths:
           description: unique name of Physical Network Function.
           required: true
           type: string
+          example: __PNF-NAME__
         - name: interface-name
           in: path
-          description: Name that identifies the link aggregate interface
+          description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
-        - name: l3-interface-ipv4-address
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
           in: path
-          description: IP address
+          description: String that identifies the interface
           required: true
           type: string
-        - name: body
-          in: body
-          description: relationship object that needs to be created or updated
-          required: true
-          schema:
+          example: __VLAN-INTERFACE__
+        - name: resource-version
+          in: query
+          description: resource-version for concurrency
+          required: true
+          type: string
+  /network/pnfs/pnf/{pnf-name}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans:
+    get:
+      tags:
+        - Network
+      summary: returns vlans
+      description: returns vlans
+      operationId: getNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceVlans
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "200":
+          description: successful operation
+          schema:
+              $ref: "#/getDefinitions/vlans"
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: pnf-name
+          in: path
+          description: unique name of Physical Network Function.
+          required: true
+          type: string
+          example: __PNF-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the physical interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: inv-status
+          in: query
+          description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
+          required: false
+          type: string
+        - name: prov-status
+          in: query
+          description: Trigger for operational monitoring of this resource by Service Assurance systems.
+          required: false
+          type: string
+        - name: interface-id
+          in: query
+          description: ID of interface
+          required: false
+          type: string
+        - name: macaddr
+          in: query
+          description: MAC address for the interface
+          required: false
+          type: string
+        - name: network-name
+          in: query
+          description: Name of the network
+          required: false
+          type: string
+  /network/pnfs/pnf/{pnf-name}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/sriov-vfs/sriov-vf/{pci-id}/relationship-list/relationship:
+    put:
+      tags:
+        - Network
+      summary: see node definition for valid relationships
+      operationId: createOrUpdateNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceSriovVfsSriovVfRelationshipListRelationship
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: pnf-name
+          in: path
+          description: unique name of Physical Network Function.
+          required: true
+          type: string
+          example: __PNF-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the physical interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: pci-id
+          in: path
+          description: PCI ID used to identify the sriov-vf
+          required: true
+          type: string
+          example: __PCI-ID__
+        - name: body
+          in: body
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceSriovVfsSriovVf.json)
+          required: true
+          schema:
             $ref: "#/definitions/relationship"
     delete:
       tags:
         - Network
       summary: delete an existing relationship
       description: delete an existing relationship
-      operationId: deleteNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressListRelationshipListRelationship
+      operationId: deleteNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceSriovVfsSriovVfRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -37152,28 +46492,32 @@ paths:
           description: unique name of Physical Network Function.
           required: true
           type: string
+          example: __PNF-NAME__
         - name: interface-name
           in: path
-          description: Name that identifies the link aggregate interface
+          description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
-        - name: l3-interface-ipv4-address
+          example: __INTERFACE-NAME__
+        - name: pci-id
           in: path
-          description: IP address
+          description: PCI ID used to identify the sriov-vf
           required: true
           type: string
-  /network/pnfs/pnf/{pnf-name}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}:
+          example: __PCI-ID__
+  /network/pnfs/pnf/{pnf-name}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/sriov-vfs/sriov-vf/{pci-id}:
     get:
       tags:
         - Network
-      summary: returns l3-interface-ipv4-address-list
-      description: returns l3-interface-ipv4-address-list
-      operationId: getNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList
+      summary: returns sriov-vf
+      description: returns sriov-vf
+      operationId: getNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceSriovVfsSriovVf
       produces:
         - application/json
         - application/xml
@@ -37181,7 +46525,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/l3-interface-ipv4-address-list"
+              $ref: "#/getDefinitions/sriov-vf"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -37190,34 +46534,33 @@ paths:
           description: unique name of Physical Network Function.
           required: true
           type: string
+          example: __PNF-NAME__
         - name: interface-name
           in: path
-          description: Name that identifies the link aggregate interface
+          description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
-        - name: l3-interface-ipv4-address
+          example: __INTERFACE-NAME__
+        - name: pci-id
           in: path
-          description: IP address
+          description: PCI ID used to identify the sriov-vf
           required: true
           type: string
+          example: __PCI-ID__
         - name: inv-status
           in: query
           description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
           required: false
           type: string
-        - name: interface-id
-          in: query
-          description: ID of interface
-          required: false
-          type: string
-        - name: interface-role
+        - name: prov-status
           in: query
-          description: Role assigned to this Interface, should use values as defined in ECOMP Yang models.
+          description: Trigger for operational monitoring of this resource by Service Assurance systems.
           required: false
           type: string
         - name: interface-id
@@ -37235,28 +46578,35 @@ paths:
           description: Name of the network
           required: false
           type: string
-        - name: vlan-id-inner
+        - name: vf-vlan-filter
           in: query
-          description: Inner VLAN tag
+          description: This metadata provides option to specify list of VLAN filters applied on VF to pass the traffic to VM.
           required: false
-          type: integer
-          format: int64
-        - name: neutron-network-id
+          type: string
+        - name: vf-mac-filter
           in: query
-          description: Neutron network id of the interface that address belongs to
+          description: When MAC filters are specified, VF-agent service configures VFs to do MAC level filtering before the traffic is passed to VM.
           required: false
           type: string
-        - name: neutron-subnet-id
+        - name: vf-vlan-strip
           in: query
-          description: Neutron id of subnet that address belongs to
+          description: When this field is set to true, VF will configured to strip the outer TAG before the traffic is passed to VM.
+          required: false
+          type: boolean
+        - name: neutron-network-id
+          in: query
+          description: Neutron network id of the interface
           required: false
           type: string
     put:
       tags:
         - Network
-      summary: create or update an existing l3-interface-ipv4-address-list
-      description: create or update an existing l3-interface-ipv4-address-list
-      operationId: createOrUpdateNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList
+      summary: create or update an existing sriov-vf
+      description: |
+        Create or update an existing sriov-vf.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceSriovVfsSriovVf
       consumes:
         - application/json
         - application/xml
@@ -37272,33 +46622,94 @@ paths:
           description: unique name of Physical Network Function.
           required: true
           type: string
+          example: __PNF-NAME__
         - name: interface-name
           in: path
-          description: Name that identifies the link aggregate interface
+          description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
-        - name: l3-interface-ipv4-address
+          example: __INTERFACE-NAME__
+        - name: pci-id
           in: path
-          description: IP address
+          description: PCI ID used to identify the sriov-vf
           required: true
           type: string
+          example: __PCI-ID__
         - name: body
           in: body
-          description: l3-interface-ipv4-address-list object that needs to be created or updated
+          description: sriov-vf object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceSriovVfsSriovVf.json)
           required: true
           schema:
-            $ref: "#/definitions/l3-interface-ipv4-address-list"
+            $ref: "#/definitions/sriov-vf"
+    patch:
+      tags:
+        - Network
+      summary: update an existing sriov-vf
+      description: |
+        Update an existing sriov-vf
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceSriovVfsSriovVf
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: pnf-name
+          in: path
+          description: unique name of Physical Network Function.
+          required: true
+          type: string
+          example: __PNF-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the physical interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: pci-id
+          in: path
+          description: PCI ID used to identify the sriov-vf
+          required: true
+          type: string
+          example: __PCI-ID__
+        - name: body
+          in: body
+          description: sriov-vf object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/sriov-vf"
     delete:
       tags:
         - Network
-      summary: delete an existing l3-interface-ipv4-address-list
-      description: delete an existing l3-interface-ipv4-address-list
-      operationId: deleteNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList
+      summary: delete an existing sriov-vf
+      description: delete an existing sriov-vf
+      operationId: deleteNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceSriovVfsSriovVf
       consumes:
         - application/json
         - application/xml
@@ -37314,32 +46725,97 @@ paths:
           description: unique name of Physical Network Function.
           required: true
           type: string
+          example: __PNF-NAME__
         - name: interface-name
           in: path
-          description: Name that identifies the link aggregate interface
+          description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
-        - name: l3-interface-ipv4-address
+          example: __INTERFACE-NAME__
+        - name: pci-id
           in: path
-          description: IP address
+          description: PCI ID used to identify the sriov-vf
           required: true
           type: string
+          example: __PCI-ID__
         - name: resource-version
           in: query
           description: resource-version for concurrency
           required: true
           type: string
-  /network/pnfs/pnf/{pnf-name}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}/relationship-list/relationship:
+  /network/pnfs/pnf/{pnf-name}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/sriov-vfs:
+    get:
+      tags:
+        - Network
+      summary: returns sriov-vfs
+      description: returns sriov-vfs
+      operationId: getNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceSriovVfs
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "200":
+          description: successful operation
+          schema:
+              $ref: "#/getDefinitions/sriov-vfs"
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: pnf-name
+          in: path
+          description: unique name of Physical Network Function.
+          required: true
+          type: string
+          example: __PNF-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the physical interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: inv-status
+          in: query
+          description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
+          required: false
+          type: string
+        - name: prov-status
+          in: query
+          description: Trigger for operational monitoring of this resource by Service Assurance systems.
+          required: false
+          type: string
+        - name: interface-id
+          in: query
+          description: ID of interface
+          required: false
+          type: string
+        - name: macaddr
+          in: query
+          description: MAC address for the interface
+          required: false
+          type: string
+        - name: network-name
+          in: query
+          description: Name of the network
+          required: false
+          type: string
+  /network/pnfs/pnf/{pnf-name}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/relationship-list/relationship:
     put:
       tags:
         - Network
       summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressListRelationshipListRelationship
+      operationId: createOrUpdateNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -37355,24 +46831,102 @@ paths:
           description: unique name of Physical Network Function.
           required: true
           type: string
+          example: __PNF-NAME__
         - name: interface-name
           in: path
-          description: Name that identifies the link aggregate interface
+          description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
-        - name: l3-interface-ipv6-address
+          example: __INTERFACE-NAME__
+        - name: body
+          in: body
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterface.json)
+          required: true
+          schema:
+            $ref: "#/definitions/relationship"
+    delete:
+      tags:
+        - Network
+      summary: delete an existing relationship
+      description: delete an existing relationship
+      operationId: deleteNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceRelationshipListRelationship
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: pnf-name
+          in: path
+          description: unique name of Physical Network Function.
+          required: true
+          type: string
+          example: __PNF-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the physical interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+  /network/pnfs/pnf/{pnf-name}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}/relationship-list/relationship:
+    put:
+      tags:
+        - Network
+      summary: see node definition for valid relationships
+      operationId: createOrUpdateNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressListRelationshipListRelationship
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: pnf-name
+          in: path
+          description: unique name of Physical Network Function.
+          required: true
+          type: string
+          example: __PNF-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the physical interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: l3-interface-ipv4-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -37381,7 +46935,7 @@ paths:
         - Network
       summary: delete an existing relationship
       description: delete an existing relationship
-      operationId: deleteNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressListRelationshipListRelationship
+      operationId: deleteNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressListRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -37397,28 +46951,32 @@ paths:
           description: unique name of Physical Network Function.
           required: true
           type: string
+          example: __PNF-NAME__
         - name: interface-name
           in: path
-          description: Name that identifies the link aggregate interface
+          description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
-        - name: l3-interface-ipv6-address
+          example: __INTERFACE-NAME__
+        - name: l3-interface-ipv4-address
           in: path
           description: IP address
           required: true
           type: string
-  /network/pnfs/pnf/{pnf-name}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}:
+          example: __L3-INTERFACE-IPV4-ADDRESS__
+  /network/pnfs/pnf/{pnf-name}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}:
     get:
       tags:
         - Network
-      summary: returns l3-interface-ipv6-address-list
-      description: returns l3-interface-ipv6-address-list
-      operationId: getNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList
+      summary: returns l3-interface-ipv4-address-list
+      description: returns l3-interface-ipv4-address-list
+      operationId: getNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList
       produces:
         - application/json
         - application/xml
@@ -37426,7 +46984,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/l3-interface-ipv6-address-list"
+              $ref: "#/getDefinitions/l3-interface-ipv4-address-list"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -37435,34 +46993,33 @@ paths:
           description: unique name of Physical Network Function.
           required: true
           type: string
+          example: __PNF-NAME__
         - name: interface-name
           in: path
-          description: Name that identifies the link aggregate interface
+          description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
-        - name: l3-interface-ipv6-address
+          example: __INTERFACE-NAME__
+        - name: l3-interface-ipv4-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
         - name: inv-status
           in: query
           description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
           required: false
           type: string
-        - name: interface-id
-          in: query
-          description: ID of interface
-          required: false
-          type: string
-        - name: interface-role
+        - name: prov-status
           in: query
-          description: Role assigned to this Interface, should use values as defined in ECOMP Yang models.
+          description: Trigger for operational monitoring of this resource by Service Assurance systems.
           required: false
           type: string
         - name: interface-id
@@ -37499,9 +47056,12 @@ paths:
     put:
       tags:
         - Network
-      summary: create or update an existing l3-interface-ipv6-address-list
-      description: create or update an existing l3-interface-ipv6-address-list
-      operationId: createOrUpdateNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList
+      summary: create or update an existing l3-interface-ipv4-address-list
+      description: |
+        Create or update an existing l3-interface-ipv4-address-list.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList
       consumes:
         - application/json
         - application/xml
@@ -37517,33 +47077,48 @@ paths:
           description: unique name of Physical Network Function.
           required: true
           type: string
+          example: __PNF-NAME__
         - name: interface-name
           in: path
-          description: Name that identifies the link aggregate interface
+          description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
-        - name: l3-interface-ipv6-address
+          example: __INTERFACE-NAME__
+        - name: l3-interface-ipv4-address
           in: path
           description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
         - name: body
           in: body
-          description: l3-interface-ipv6-address-list object that needs to be created or updated
+          description: l3-interface-ipv4-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList.json)
           required: true
           schema:
-            $ref: "#/definitions/l3-interface-ipv6-address-list"
-    delete:
+            $ref: "#/definitions/l3-interface-ipv4-address-list"
+    patch:
       tags:
         - Network
-      summary: delete an existing l3-interface-ipv6-address-list
-      description: delete an existing l3-interface-ipv6-address-list
-      operationId: deleteNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList
+      summary: update an existing l3-interface-ipv4-address-list
+      description: |
+        Update an existing l3-interface-ipv4-address-list
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList
       consumes:
         - application/json
         - application/xml
@@ -37559,41 +47134,44 @@ paths:
           description: unique name of Physical Network Function.
           required: true
           type: string
+          example: __PNF-NAME__
         - name: interface-name
           in: path
-          description: Name that identifies the link aggregate interface
+          description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
-        - name: l3-interface-ipv6-address
+          example: __INTERFACE-NAME__
+        - name: l3-interface-ipv4-address
           in: path
           description: IP address
           required: true
           type: string
-        - name: resource-version
-          in: query
-          description: resource-version for concurrency
+          example: __L3-INTERFACE-IPV4-ADDRESS__
+        - name: body
+          in: body
+          description: l3-interface-ipv4-address-list object that needs to be created or updated. 
           required: true
-          type: string
-  /network/pnfs/pnf/{pnf-name}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}:
-    get:
+          schema:
+            $ref: "#/patchDefinitions/l3-interface-ipv4-address-list"
+    delete:
       tags:
         - Network
-      summary: returns l-interface
-      description: returns l-interface
-      operationId: getNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterface
+      summary: delete an existing l3-interface-ipv4-address-list
+      description: delete an existing l3-interface-ipv4-address-list
+      operationId: deleteNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList
+      consumes:
+        - application/json
+        - application/xml
       produces:
         - application/json
         - application/xml
       responses:
-        "200":
-          description: successful operation
-          schema:
-              $ref: "#/definitions/l-interface"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -37602,52 +47180,36 @@ paths:
           description: unique name of Physical Network Function.
           required: true
           type: string
+          example: __PNF-NAME__
         - name: interface-name
           in: path
-          description: Name that identifies the link aggregate interface
+          description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
-        - name: inv-status
-          in: query
-          description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
-          required: false
-          type: string
-        - name: interface-id
-          in: query
-          description: ID of interface
-          required: false
-          type: string
-        - name: interface-role
-          in: query
-          description: Role assigned to this Interface, should use values as defined in ECOMP Yang models.
-          required: false
-          type: string
-        - name: interface-id
-          in: query
-          description: ID of interface
-          required: false
-          type: string
-        - name: macaddr
-          in: query
-          description: MAC address for the interface
-          required: false
+          example: __INTERFACE-NAME__
+        - name: l3-interface-ipv4-address
+          in: path
+          description: IP address
+          required: true
           type: string
-        - name: network-name
+          example: __L3-INTERFACE-IPV4-ADDRESS__
+        - name: resource-version
           in: query
-          description: Name of the network
-          required: false
+          description: resource-version for concurrency
+          required: true
           type: string
+  /network/pnfs/pnf/{pnf-name}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}/relationship-list/relationship:
     put:
       tags:
         - Network
-      summary: create or update an existing l-interface
-      description: create or update an existing l-interface
-      operationId: createOrUpdateNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterface
+      summary: see node definition for valid relationships
+      operationId: createOrUpdateNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressListRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -37663,28 +47225,37 @@ paths:
           description: unique name of Physical Network Function.
           required: true
           type: string
+          example: __PNF-NAME__
         - name: interface-name
           in: path
-          description: Name that identifies the link aggregate interface
+          description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
+        - name: l3-interface-ipv6-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
         - name: body
           in: body
-          description: l-interface object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList.json)
           required: true
           schema:
-            $ref: "#/definitions/l-interface"
+            $ref: "#/definitions/relationship"
     delete:
       tags:
         - Network
-      summary: delete an existing l-interface
-      description: delete an existing l-interface
-      operationId: deleteNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterface
+      summary: delete an existing relationship
+      description: delete an existing relationship
+      operationId: deleteNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressListRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -37700,28 +47271,32 @@ paths:
           description: unique name of Physical Network Function.
           required: true
           type: string
+          example: __PNF-NAME__
         - name: interface-name
           in: path
-          description: Name that identifies the link aggregate interface
+          description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: interface-name
           in: path
           description: Name given to the interface
           required: true
           type: string
-        - name: resource-version
-          in: query
-          description: resource-version for concurrency
+          example: __INTERFACE-NAME__
+        - name: l3-interface-ipv6-address
+          in: path
+          description: IP address
           required: true
           type: string
-  /network/pnfs/pnf/{pnf-name}/lag-interfaces/lag-interface/{interface-name}/l-interfaces:
+          example: __L3-INTERFACE-IPV6-ADDRESS__
+  /network/pnfs/pnf/{pnf-name}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}:
     get:
       tags:
         - Network
-      summary: returns l-interfaces
-      description: returns l-interfaces
-      operationId: getNetworkPnfsPnfLagInterfacesLagInterfaceLInterfaces
+      summary: returns l3-interface-ipv6-address-list
+      description: returns l3-interface-ipv6-address-list
+      operationId: getNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList
       produces:
         - application/json
         - application/xml
@@ -37729,7 +47304,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/l-interfaces"
+              $ref: "#/getDefinitions/l3-interface-ipv6-address-list"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -37738,41 +47313,82 @@ paths:
           description: unique name of Physical Network Function.
           required: true
           type: string
+          example: __PNF-NAME__
         - name: interface-name
           in: path
-          description: Name that identifies the link aggregate interface
+          description: Name that identifies the physical interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: l3-interface-ipv6-address
+          in: path
+          description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
         - name: inv-status
           in: query
           description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
           required: false
           type: string
+        - name: prov-status
+          in: query
+          description: Trigger for operational monitoring of this resource by Service Assurance systems.
+          required: false
+          type: string
         - name: interface-id
           in: query
           description: ID of interface
           required: false
           type: string
-        - name: interface-role
+        - name: macaddr
           in: query
-          description: Role assigned to this Interface, should use values as defined in ECOMP Yang models.
+          description: MAC address for the interface
           required: false
           type: string
-  /network/pnfs/pnf/{pnf-name}/lag-interfaces/lag-interface/{interface-name}:
-    get:
-      tags:
-        - Network
-      summary: returns lag-interface
-      description: returns lag-interface
-      operationId: getNetworkPnfsPnfLagInterfacesLagInterface
+        - name: network-name
+          in: query
+          description: Name of the network
+          required: false
+          type: string
+        - name: vlan-id-inner
+          in: query
+          description: Inner VLAN tag
+          required: false
+          type: integer
+          format: int64
+        - name: neutron-network-id
+          in: query
+          description: Neutron network id of the interface that address belongs to
+          required: false
+          type: string
+        - name: neutron-subnet-id
+          in: query
+          description: Neutron id of subnet that address belongs to
+          required: false
+          type: string
+    put:
+      tags:
+        - Network
+      summary: create or update an existing l3-interface-ipv6-address-list
+      description: |
+        Create or update an existing l3-interface-ipv6-address-list.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList
+      consumes:
+        - application/json
+        - application/xml
       produces:
         - application/json
         - application/xml
       responses:
-        "200":
-          description: successful operation
-          schema:
-              $ref: "#/definitions/lag-interface"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -37781,32 +47397,48 @@ paths:
           description: unique name of Physical Network Function.
           required: true
           type: string
+          example: __PNF-NAME__
         - name: interface-name
           in: path
-          description: Name that identifies the link aggregate interface
+          description: Name that identifies the physical interface
           required: true
           type: string
-        - name: inv-status
-          in: query
-          description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
-          required: false
-          type: string
-        - name: interface-id
-          in: query
-          description: ID of interface
-          required: false
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
           type: string
-        - name: interface-role
-          in: query
-          description: Role assigned to this Interface, should use values as defined in ECOMP Yang models.
-          required: false
+          example: __INTERFACE-NAME__
+        - name: l3-interface-ipv6-address
+          in: path
+          description: IP address
+          required: true
           type: string
-    put:
+          example: __L3-INTERFACE-IPV6-ADDRESS__
+        - name: body
+          in: body
+          description: l3-interface-ipv6-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList.json)
+          required: true
+          schema:
+            $ref: "#/definitions/l3-interface-ipv6-address-list"
+    patch:
       tags:
         - Network
-      summary: create or update an existing lag-interface
-      description: create or update an existing lag-interface
-      operationId: createOrUpdateNetworkPnfsPnfLagInterfacesLagInterface
+      summary: update an existing l3-interface-ipv6-address-list
+      description: |
+        Update an existing l3-interface-ipv6-address-list
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList
       consumes:
         - application/json
         - application/xml
@@ -37822,23 +47454,37 @@ paths:
           description: unique name of Physical Network Function.
           required: true
           type: string
+          example: __PNF-NAME__
         - name: interface-name
           in: path
-          description: Name that identifies the link aggregate interface
+          description: Name that identifies the physical interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: l3-interface-ipv6-address
+          in: path
+          description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
         - name: body
           in: body
-          description: lag-interface object that needs to be created or updated
+          description: l3-interface-ipv6-address-list object that needs to be created or updated. 
           required: true
           schema:
-            $ref: "#/definitions/lag-interface"
+            $ref: "#/patchDefinitions/l3-interface-ipv6-address-list"
     delete:
       tags:
         - Network
-      summary: delete an existing lag-interface
-      description: delete an existing lag-interface
-      operationId: deleteNetworkPnfsPnfLagInterfacesLagInterface
+      summary: delete an existing l3-interface-ipv6-address-list
+      description: delete an existing l3-interface-ipv6-address-list
+      operationId: deleteNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList
       consumes:
         - application/json
         - application/xml
@@ -37854,23 +47500,37 @@ paths:
           description: unique name of Physical Network Function.
           required: true
           type: string
+          example: __PNF-NAME__
         - name: interface-name
           in: path
-          description: Name that identifies the link aggregate interface
+          description: Name that identifies the physical interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: l3-interface-ipv6-address
+          in: path
+          description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
         - name: resource-version
           in: query
           description: resource-version for concurrency
           required: true
           type: string
-  /network/pnfs/pnf/{pnf-name}/lag-interfaces:
+  /network/pnfs/pnf/{pnf-name}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}:
     get:
       tags:
         - Network
-      summary: returns lag-interfaces
-      description: returns lag-interfaces
-      operationId: getNetworkPnfsPnfLagInterfaces
+      summary: returns l-interface
+      description: returns l-interface
+      operationId: getNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterface
       produces:
         - application/json
         - application/xml
@@ -37878,7 +47538,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/lag-interfaces"
+              $ref: "#/getDefinitions/l-interface"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -37887,26 +47547,60 @@ paths:
           description: unique name of Physical Network Function.
           required: true
           type: string
+          example: __PNF-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the physical interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
         - name: inv-status
           in: query
           description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
           required: false
           type: string
-  /network/pnfs/pnf/{pnf-name}:
-    get:
+        - name: prov-status
+          in: query
+          description: Trigger for operational monitoring of this resource by Service Assurance systems.
+          required: false
+          type: string
+        - name: interface-id
+          in: query
+          description: ID of interface
+          required: false
+          type: string
+        - name: macaddr
+          in: query
+          description: MAC address for the interface
+          required: false
+          type: string
+        - name: network-name
+          in: query
+          description: Name of the network
+          required: false
+          type: string
+    put:
       tags:
         - Network
-      summary: returns pnf
-      description: returns pnf
-      operationId: getNetworkPnfsPnf
+      summary: create or update an existing l-interface
+      description: |
+        Create or update an existing l-interface.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterface
+      consumes:
+        - application/json
+        - application/xml
       produces:
         - application/json
         - application/xml
       responses:
-        "200":
-          description: successful operation
-          schema:
-              $ref: "#/definitions/pnf"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -37915,17 +47609,42 @@ paths:
           description: unique name of Physical Network Function.
           required: true
           type: string
-        - name: inv-status
-          in: query
-          description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
-          required: false
+          example: __PNF-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the physical interface
+          required: true
           type: string
-    put:
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: body
+          in: body
+          description: l-interface object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterface.json)
+          required: true
+          schema:
+            $ref: "#/definitions/l-interface"
+    patch:
       tags:
         - Network
-      summary: create or update an existing pnf
-      description: create or update an existing pnf
-      operationId: createOrUpdateNetworkPnfsPnf
+      summary: update an existing l-interface
+      description: |
+        Update an existing l-interface
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterface
       consumes:
         - application/json
         - application/xml
@@ -37941,18 +47660,31 @@ paths:
           description: unique name of Physical Network Function.
           required: true
           type: string
+          example: __PNF-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the physical interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
         - name: body
           in: body
-          description: pnf object that needs to be created or updated
+          description: l-interface object that needs to be created or updated. 
           required: true
           schema:
-            $ref: "#/definitions/pnf"
+            $ref: "#/patchDefinitions/l-interface"
     delete:
       tags:
         - Network
-      summary: delete an existing pnf
-      description: delete an existing pnf
-      operationId: deleteNetworkPnfsPnf
+      summary: delete an existing l-interface
+      description: delete an existing l-interface
+      operationId: deleteNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterface
       consumes:
         - application/json
         - application/xml
@@ -37968,18 +47700,31 @@ paths:
           description: unique name of Physical Network Function.
           required: true
           type: string
+          example: __PNF-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the physical interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
         - name: resource-version
           in: query
           description: resource-version for concurrency
           required: true
           type: string
-  /network/pnfs:
+  /network/pnfs/pnf/{pnf-name}/p-interfaces/p-interface/{interface-name}/l-interfaces:
     get:
       tags:
         - Network
-      summary: returns pnfs
-      description: returns pnfs
-      operationId: getNetworkPnfs
+      summary: returns l-interfaces
+      description: returns l-interfaces
+      operationId: getNetworkPnfsPnfPInterfacesPInterfaceLInterfaces
       produces:
         - application/json
         - application/xml
@@ -37987,42 +47732,81 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/pnfs"
+              $ref: "#/getDefinitions/l-interfaces"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
-  /network/physical-links/physical-link/{link-name}/relationship-list/relationship:
-    put:
+      parameters:
+        - name: pnf-name
+          in: path
+          description: unique name of Physical Network Function.
+          required: true
+          type: string
+          example: __PNF-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the physical interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: inv-status
+          in: query
+          description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
+          required: false
+          type: string
+        - name: prov-status
+          in: query
+          description: Trigger for operational monitoring of this resource by Service Assurance systems.
+          required: false
+          type: string
+  /network/pnfs/pnf/{pnf-name}/p-interfaces/p-interface/{interface-name}:
+    get:
       tags:
         - Network
-      summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkPhysicalLinksPhysicalLinkRelationshipListRelationship
-      consumes:
-        - application/json
-        - application/xml
+      summary: returns p-interface
+      description: returns p-interface
+      operationId: getNetworkPnfsPnfPInterfacesPInterface
       produces:
         - application/json
         - application/xml
       responses:
+        "200":
+          description: successful operation
+          schema:
+              $ref: "#/getDefinitions/p-interface"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: link-name
+        - name: pnf-name
           in: path
-          description: e.g., hostnameA_p-connection_nameA_hostnameZ+p_connection-nameZ
+          description: unique name of Physical Network Function.
           required: true
           type: string
-        - name: body
-          in: body
-          description: relationship object that needs to be created or updated
+          example: __PNF-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the physical interface
           required: true
-          schema:
-            $ref: "#/definitions/relationship"
-    delete:
+          type: string
+          example: __INTERFACE-NAME__
+        - name: inv-status
+          in: query
+          description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
+          required: false
+          type: string
+        - name: prov-status
+          in: query
+          description: Trigger for operational monitoring of this resource by Service Assurance systems.
+          required: false
+          type: string
+    put:
       tags:
         - Network
-      summary: delete an existing relationship
-      description: delete an existing relationship
-      operationId: deleteNetworkPhysicalLinksPhysicalLinkRelationshipListRelationship
+      summary: create or update an existing p-interface
+      description: |
+        Create or update an existing p-interface.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkPnfsPnfPInterfacesPInterface
       consumes:
         - application/json
         - application/xml
@@ -38033,45 +47817,41 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: link-name
+        - name: pnf-name
           in: path
-          description: e.g., hostnameA_p-connection_nameA_hostnameZ+p_connection-nameZ
+          description: unique name of Physical Network Function.
           required: true
           type: string
-  /network/physical-links/physical-link/{link-name}:
-    get:
-      tags:
-        - Network
-      summary: returns physical-link
-      description: returns physical-link
-      operationId: getNetworkPhysicalLinksPhysicalLink
-      produces:
-        - application/json
-        - application/xml
-      responses:
-        "200":
-          description: successful operation
-          schema:
-              $ref: "#/definitions/physical-link"
-        "default":
-          description: Response codes found in [response codes](https://wiki.onap.org/).
-      parameters:
-        - name: link-name
+          example: __PNF-NAME__
+        - name: interface-name
           in: path
-          description: e.g., hostnameA_p-connection_nameA_hostnameZ+p_connection-nameZ
+          description: Name that identifies the physical interface
           required: true
           type: string
-        - name: circuit-id
-          in: query
-          description: Circuit it
-          required: false
-          type: string
-    put:
+          example: __INTERFACE-NAME__
+        - name: body
+          in: body
+          description: p-interface object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkPnfsPnfPInterfacesPInterface.json)
+          required: true
+          schema:
+            $ref: "#/definitions/p-interface"
+    patch:
       tags:
         - Network
-      summary: create or update an existing physical-link
-      description: create or update an existing physical-link
-      operationId: createOrUpdateNetworkPhysicalLinksPhysicalLink
+      summary: update an existing p-interface
+      description: |
+        Update an existing p-interface
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkPnfsPnfPInterfacesPInterface
       consumes:
         - application/json
         - application/xml
@@ -38082,23 +47862,30 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: link-name
+        - name: pnf-name
           in: path
-          description: e.g., hostnameA_p-connection_nameA_hostnameZ+p_connection-nameZ
+          description: unique name of Physical Network Function.
+          required: true
+          type: string
+          example: __PNF-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: body
           in: body
-          description: physical-link object that needs to be created or updated
+          description: p-interface object that needs to be created or updated. 
           required: true
           schema:
-            $ref: "#/definitions/physical-link"
+            $ref: "#/patchDefinitions/p-interface"
     delete:
       tags:
         - Network
-      summary: delete an existing physical-link
-      description: delete an existing physical-link
-      operationId: deleteNetworkPhysicalLinksPhysicalLink
+      summary: delete an existing p-interface
+      description: delete an existing p-interface
+      operationId: deleteNetworkPnfsPnfPInterfacesPInterface
       consumes:
         - application/json
         - application/xml
@@ -38109,23 +47896,30 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: link-name
+        - name: pnf-name
           in: path
-          description: e.g., hostnameA_p-connection_nameA_hostnameZ+p_connection-nameZ
+          description: unique name of Physical Network Function.
+          required: true
+          type: string
+          example: __PNF-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the physical interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: resource-version
           in: query
           description: resource-version for concurrency
           required: true
           type: string
-  /network/physical-links:
+  /network/pnfs/pnf/{pnf-name}/p-interfaces:
     get:
       tags:
         - Network
-      summary: returns physical-links
-      description: returns physical-links
-      operationId: getNetworkPhysicalLinks
+      summary: returns p-interfaces
+      description: returns p-interfaces
+      operationId: getNetworkPnfsPnfPInterfaces
       produces:
         - application/json
         - application/xml
@@ -38133,15 +47927,27 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/physical-links"
+              $ref: "#/getDefinitions/p-interfaces"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
-  /network/ipsec-configurations/ipsec-configuration/{ipsec-configuration-id}/relationship-list/relationship:
+      parameters:
+        - name: pnf-name
+          in: path
+          description: unique name of Physical Network Function.
+          required: true
+          type: string
+          example: __PNF-NAME__
+        - name: inv-status
+          in: query
+          description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
+          required: false
+          type: string
+  /network/pnfs/pnf/{pnf-name}/lag-interfaces/lag-interface/{interface-name}/relationship-list/relationship:
     put:
       tags:
         - Network
       summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkIpsecConfigurationsIpsecConfigurationRelationshipListRelationship
+      operationId: createOrUpdateNetworkPnfsPnfLagInterfacesLagInterfaceRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -38152,14 +47958,21 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: ipsec-configuration-id
+        - name: pnf-name
           in: path
-          description: UUID of this configuration
+          description: unique name of Physical Network Function.
+          required: true
+          type: string
+          example: __PNF-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkPnfsPnfLagInterfacesLagInterface.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -38168,7 +47981,7 @@ paths:
         - Network
       summary: delete an existing relationship
       description: delete an existing relationship
-      operationId: deleteNetworkIpsecConfigurationsIpsecConfigurationRelationshipListRelationship
+      operationId: deleteNetworkPnfsPnfLagInterfacesLagInterfaceRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -38179,17 +47992,24 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: ipsec-configuration-id
+        - name: pnf-name
           in: path
-          description: UUID of this configuration
+          description: unique name of Physical Network Function.
           required: true
           type: string
-  /network/ipsec-configurations/ipsec-configuration/{ipsec-configuration-id}/vig-servers/vig-server/{vig-address-type}/relationship-list/relationship:
+          example: __PNF-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+  /network/pnfs/pnf/{pnf-name}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/relationship-list/relationship:
     put:
       tags:
         - Network
       summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkIpsecConfigurationsIpsecConfigurationVigServersVigServerRelationshipListRelationship
+      operationId: createOrUpdateNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -38200,19 +48020,33 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: ipsec-configuration-id
+        - name: pnf-name
           in: path
-          description: UUID of this configuration
+          description: unique name of Physical Network Function.
           required: true
           type: string
-        - name: vig-address-type
+          example: __PNF-NAME__
+        - name: interface-name
           in: path
-          description: indicates whether the VIG is for AVPN or INTERNET
+          description: Name that identifies the link aggregate interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
           required: true
           type: string
+          example: __VLAN-INTERFACE__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlan.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -38221,7 +48055,7 @@ paths:
         - Network
       summary: delete an existing relationship
       description: delete an existing relationship
-      operationId: deleteNetworkIpsecConfigurationsIpsecConfigurationVigServersVigServerRelationshipListRelationship
+      operationId: deleteNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -38232,50 +48066,36 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: ipsec-configuration-id
+        - name: pnf-name
           in: path
-          description: UUID of this configuration
+          description: unique name of Physical Network Function.
           required: true
           type: string
-        - name: vig-address-type
+          example: __PNF-NAME__
+        - name: interface-name
           in: path
-          description: indicates whether the VIG is for AVPN or INTERNET
+          description: Name that identifies the link aggregate interface
           required: true
           type: string
-  /network/ipsec-configurations/ipsec-configuration/{ipsec-configuration-id}/vig-servers/vig-server/{vig-address-type}:
-    get:
-      tags:
-        - Network
-      summary: returns vig-server
-      description: returns vig-server
-      operationId: getNetworkIpsecConfigurationsIpsecConfigurationVigServersVigServer
-      produces:
-        - application/json
-        - application/xml
-      responses:
-        "200":
-          description: successful operation
-          schema:
-              $ref: "#/definitions/vig-server"
-        "default":
-          description: Response codes found in [response codes](https://wiki.onap.org/).
-      parameters:
-        - name: ipsec-configuration-id
+          example: __INTERFACE-NAME__
+        - name: interface-name
           in: path
-          description: UUID of this configuration
+          description: Name given to the interface
           required: true
           type: string
-        - name: vig-address-type
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
           in: path
-          description: indicates whether the VIG is for AVPN or INTERNET
+          description: String that identifies the interface
           required: true
           type: string
+          example: __VLAN-INTERFACE__
+  /network/pnfs/pnf/{pnf-name}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}/relationship-list/relationship:
     put:
       tags:
         - Network
-      summary: create or update an existing vig-server
-      description: create or update an existing vig-server
-      operationId: createOrUpdateNetworkIpsecConfigurationsIpsecConfigurationVigServersVigServer
+      summary: see node definition for valid relationships
+      operationId: createOrUpdateNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressListRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -38286,28 +48106,48 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: ipsec-configuration-id
+        - name: pnf-name
           in: path
-          description: UUID of this configuration
+          description: unique name of Physical Network Function.
           required: true
           type: string
-        - name: vig-address-type
+          example: __PNF-NAME__
+        - name: interface-name
           in: path
-          description: indicates whether the VIG is for AVPN or INTERNET
+          description: Name that identifies the link aggregate interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
+          type: string
+          example: __VLAN-INTERFACE__
+        - name: l3-interface-ipv4-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
         - name: body
           in: body
-          description: vig-server object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList.json)
           required: true
           schema:
-            $ref: "#/definitions/vig-server"
+            $ref: "#/definitions/relationship"
     delete:
       tags:
         - Network
-      summary: delete an existing vig-server
-      description: delete an existing vig-server
-      operationId: deleteNetworkIpsecConfigurationsIpsecConfigurationVigServersVigServer
+      summary: delete an existing relationship
+      description: delete an existing relationship
+      operationId: deleteNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressListRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -38318,28 +48158,43 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: ipsec-configuration-id
+        - name: pnf-name
           in: path
-          description: UUID of this configuration
+          description: unique name of Physical Network Function.
           required: true
           type: string
-        - name: vig-address-type
+          example: __PNF-NAME__
+        - name: interface-name
           in: path
-          description: indicates whether the VIG is for AVPN or INTERNET
+          description: Name that identifies the link aggregate interface
           required: true
           type: string
-        - name: resource-version
-          in: query
-          description: resource-version for concurrency
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
           required: true
           type: string
-  /network/ipsec-configurations/ipsec-configuration/{ipsec-configuration-id}/vig-servers:
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
+          type: string
+          example: __VLAN-INTERFACE__
+        - name: l3-interface-ipv4-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
+  /network/pnfs/pnf/{pnf-name}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}:
     get:
       tags:
         - Network
-      summary: returns vig-servers
-      description: returns vig-servers
-      operationId: getNetworkIpsecConfigurationsIpsecConfigurationVigServers
+      summary: returns l3-interface-ipv4-address-list
+      description: returns l3-interface-ipv4-address-list
+      operationId: getNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList
       produces:
         - application/json
         - application/xml
@@ -38347,114 +48202,106 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/vig-servers"
+              $ref: "#/getDefinitions/l3-interface-ipv4-address-list"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: ipsec-configuration-id
+        - name: pnf-name
           in: path
-          description: UUID of this configuration
+          description: unique name of Physical Network Function.
           required: true
           type: string
-  /network/ipsec-configurations/ipsec-configuration/{ipsec-configuration-id}:
-    get:
-      tags:
-        - Network
-      summary: returns ipsec-configuration
-      description: returns ipsec-configuration
-      operationId: getNetworkIpsecConfigurationsIpsecConfiguration
-      produces:
-        - application/json
-        - application/xml
-      responses:
-        "200":
-          description: successful operation
-          schema:
-              $ref: "#/definitions/ipsec-configuration"
-        "default":
-          description: Response codes found in [response codes](https://wiki.onap.org/).
-      parameters:
-        - name: ipsec-configuration-id
+          example: __PNF-NAME__
+        - name: interface-name
           in: path
-          description: UUID of this configuration
+          description: Name that identifies the link aggregate interface
           required: true
           type: string
-    put:
-      tags:
-        - Network
-      summary: create or update an existing ipsec-configuration
-      description: create or update an existing ipsec-configuration
-      operationId: createOrUpdateNetworkIpsecConfigurationsIpsecConfiguration
-      consumes:
-        - application/json
-        - application/xml
-      produces:
-        - application/json
-        - application/xml
-      responses:
-        "default":
-          description: Response codes found in [response codes](https://wiki.onap.org/).
-      parameters:
-        - name: ipsec-configuration-id
+          example: __INTERFACE-NAME__
+        - name: interface-name
           in: path
-          description: UUID of this configuration
+          description: Name given to the interface
           required: true
           type: string
-        - name: body
-          in: body
-          description: ipsec-configuration object that needs to be created or updated
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
           required: true
-          schema:
-            $ref: "#/definitions/ipsec-configuration"
-    delete:
-      tags:
-        - Network
-      summary: delete an existing ipsec-configuration
-      description: delete an existing ipsec-configuration
-      operationId: deleteNetworkIpsecConfigurationsIpsecConfiguration
-      consumes:
-        - application/json
-        - application/xml
-      produces:
-        - application/json
-        - application/xml
-      responses:
-        "default":
-          description: Response codes found in [response codes](https://wiki.onap.org/).
-      parameters:
-        - name: ipsec-configuration-id
+          type: string
+          example: __VLAN-INTERFACE__
+        - name: l3-interface-ipv4-address
           in: path
-          description: UUID of this configuration
+          description: IP address
           required: true
           type: string
-        - name: resource-version
+          example: __L3-INTERFACE-IPV4-ADDRESS__
+        - name: inv-status
           in: query
-          description: resource-version for concurrency
-          required: true
+          description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
+          required: false
+          type: string
+        - name: interface-id
+          in: query
+          description: ID of interface
+          required: false
+          type: string
+        - name: interface-role
+          in: query
+          description: Role assigned to this Interface, should use values as defined in ECOMP Yang models.
+          required: false
+          type: string
+        - name: interface-id
+          in: query
+          description: ID of interface
+          required: false
+          type: string
+        - name: macaddr
+          in: query
+          description: MAC address for the interface
+          required: false
+          type: string
+        - name: network-name
+          in: query
+          description: Name of the network
+          required: false
+          type: string
+        - name: vlan-id-inner
+          in: query
+          description: Inner VLAN tag
+          required: false
+          type: integer
+          format: int64
+        - name: vpn-key
+          in: query
+          description: This indicates the customers VPN ID associated with this vlan
+          required: false
+          type: string
+        - name: vlan-id-inner
+          in: query
+          description: Inner VLAN tag
+          required: false
+          type: integer
+          format: int64
+        - name: neutron-network-id
+          in: query
+          description: Neutron network id of the interface that address belongs to
+          required: false
+          type: string
+        - name: neutron-subnet-id
+          in: query
+          description: Neutron id of subnet that address belongs to
+          required: false
           type: string
-  /network/ipsec-configurations:
-    get:
-      tags:
-        - Network
-      summary: returns ipsec-configurations
-      description: returns ipsec-configurations
-      operationId: getNetworkIpsecConfigurations
-      produces:
-        - application/json
-        - application/xml
-      responses:
-        "200":
-          description: successful operation
-          schema:
-              $ref: "#/definitions/ipsec-configurations"
-        "default":
-          description: Response codes found in [response codes](https://wiki.onap.org/).
-  /network/route-table-references/route-table-reference/{route-table-reference-id}/relationship-list/relationship:
     put:
       tags:
         - Network
-      summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkRouteTableReferencesRouteTableReferenceRelationshipListRelationship
+      summary: create or update an existing l3-interface-ipv4-address-list
+      description: |
+        Create or update an existing l3-interface-ipv4-address-list.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList
       consumes:
         - application/json
         - application/xml
@@ -38465,23 +48312,59 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: route-table-reference-id
+        - name: pnf-name
           in: path
-          description: Route Table Reference id, UUID assigned to this instance.
+          description: unique name of Physical Network Function.
+          required: true
+          type: string
+          example: __PNF-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
+          type: string
+          example: __VLAN-INTERFACE__
+        - name: l3-interface-ipv4-address
+          in: path
+          description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: l3-interface-ipv4-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList.json)
           required: true
           schema:
-            $ref: "#/definitions/relationship"
-    delete:
+            $ref: "#/definitions/l3-interface-ipv4-address-list"
+    patch:
       tags:
         - Network
-      summary: delete an existing relationship
-      description: delete an existing relationship
-      operationId: deleteNetworkRouteTableReferencesRouteTableReferenceRelationshipListRelationship
+      summary: update an existing l3-interface-ipv4-address-list
+      description: |
+        Update an existing l3-interface-ipv4-address-list
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList
       consumes:
         - application/json
         - application/xml
@@ -38492,72 +48375,48 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: route-table-reference-id
+        - name: pnf-name
           in: path
-          description: Route Table Reference id, UUID assigned to this instance.
+          description: unique name of Physical Network Function.
           required: true
           type: string
-  /network/route-table-references/route-table-reference/{route-table-reference-id}:
-    get:
-      tags:
-        - Network
-      summary: returns route-table-reference
-      description: returns route-table-reference
-      operationId: getNetworkRouteTableReferencesRouteTableReference
-      produces:
-        - application/json
-        - application/xml
-      responses:
-        "200":
-          description: successful operation
-          schema:
-              $ref: "#/definitions/route-table-reference"
-        "default":
-          description: Response codes found in [response codes](https://wiki.onap.org/).
-      parameters:
-        - name: route-table-reference-id
+          example: __PNF-NAME__
+        - name: interface-name
           in: path
-          description: Route Table Reference id, UUID assigned to this instance.
+          description: Name that identifies the link aggregate interface
           required: true
           type: string
-        - name: route-table-reference-fqdn
-          in: query
-          description: FQDN entry in the route table.
-          required: false
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
           type: string
-    put:
-      tags:
-        - Network
-      summary: create or update an existing route-table-reference
-      description: create or update an existing route-table-reference
-      operationId: createOrUpdateNetworkRouteTableReferencesRouteTableReference
-      consumes:
-        - application/json
-        - application/xml
-      produces:
-        - application/json
-        - application/xml
-      responses:
-        "default":
-          description: Response codes found in [response codes](https://wiki.onap.org/).
-      parameters:
-        - name: route-table-reference-id
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
           in: path
-          description: Route Table Reference id, UUID assigned to this instance.
+          description: String that identifies the interface
+          required: true
+          type: string
+          example: __VLAN-INTERFACE__
+        - name: l3-interface-ipv4-address
+          in: path
+          description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
         - name: body
           in: body
-          description: route-table-reference object that needs to be created or updated
+          description: l3-interface-ipv4-address-list object that needs to be created or updated. 
           required: true
           schema:
-            $ref: "#/definitions/route-table-reference"
+            $ref: "#/patchDefinitions/l3-interface-ipv4-address-list"
     delete:
       tags:
         - Network
-      summary: delete an existing route-table-reference
-      description: delete an existing route-table-reference
-      operationId: deleteNetworkRouteTableReferencesRouteTableReference
+      summary: delete an existing l3-interface-ipv4-address-list
+      description: delete an existing l3-interface-ipv4-address-list
+      operationId: deleteNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList
       consumes:
         - application/json
         - application/xml
@@ -38568,39 +48427,47 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: route-table-reference-id
+        - name: pnf-name
           in: path
-          description: Route Table Reference id, UUID assigned to this instance.
+          description: unique name of Physical Network Function.
+          required: true
+          type: string
+          example: __PNF-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
+          type: string
+          example: __VLAN-INTERFACE__
+        - name: l3-interface-ipv4-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
         - name: resource-version
           in: query
           description: resource-version for concurrency
           required: true
           type: string
-  /network/route-table-references:
-    get:
-      tags:
-        - Network
-      summary: returns route-table-references
-      description: returns route-table-references
-      operationId: getNetworkRouteTableReferences
-      produces:
-        - application/json
-        - application/xml
-      responses:
-        "200":
-          description: successful operation
-          schema:
-              $ref: "#/definitions/route-table-references"
-        "default":
-          description: Response codes found in [response codes](https://wiki.onap.org/).
-  /network/instance-groups/instance-group/{id}/relationship-list/relationship:
+  /network/pnfs/pnf/{pnf-name}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}/relationship-list/relationship:
     put:
       tags:
         - Network
       summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkInstanceGroupsInstanceGroupRelationshipListRelationship
+      operationId: createOrUpdateNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressListRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -38611,14 +48478,39 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: id
+        - name: pnf-name
           in: path
-          description: Instance Group ID, UUID assigned to this instance.
+          description: unique name of Physical Network Function.
+          required: true
+          type: string
+          example: __PNF-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
+          type: string
+          example: __VLAN-INTERFACE__
+        - name: l3-interface-ipv6-address
+          in: path
+          description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -38627,7 +48519,7 @@ paths:
         - Network
       summary: delete an existing relationship
       description: delete an existing relationship
-      operationId: deleteNetworkInstanceGroupsInstanceGroupRelationshipListRelationship
+      operationId: deleteNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressListRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -38638,18 +48530,43 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: id
+        - name: pnf-name
           in: path
-          description: Instance Group ID, UUID assigned to this instance.
+          description: unique name of Physical Network Function.
           required: true
           type: string
-  /network/instance-groups/instance-group/{id}:
+          example: __PNF-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
+          type: string
+          example: __VLAN-INTERFACE__
+        - name: l3-interface-ipv6-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
+  /network/pnfs/pnf/{pnf-name}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}:
     get:
       tags:
         - Network
-      summary: returns instance-group
-      description: returns instance-group
-      operationId: getNetworkInstanceGroupsInstanceGroup
+      summary: returns l3-interface-ipv6-address-list
+      description: returns l3-interface-ipv6-address-list
+      operationId: getNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList
       produces:
         - application/json
         - application/xml
@@ -38657,36 +48574,106 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/instance-group"
+              $ref: "#/getDefinitions/l3-interface-ipv6-address-list"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: id
+        - name: pnf-name
           in: path
-          description: Instance Group ID, UUID assigned to this instance.
+          description: unique name of Physical Network Function.
           required: true
           type: string
-        - name: description
+          example: __PNF-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
+          type: string
+          example: __VLAN-INTERFACE__
+        - name: l3-interface-ipv6-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
+        - name: inv-status
           in: query
-          description: Descriptive text to help identify the usage of this instance-group
+          description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
           required: false
           type: string
-        - name: type
+        - name: interface-id
           in: query
-          description: Only valid value today is lower case ha for high availability
+          description: ID of interface
           required: false
           type: string
-        - name: sub-type
+        - name: interface-role
           in: query
-          description: Valid values for ha type are [geo-activeactive, geo-activestandby, local-activeactive, local-activestandby]
+          description: Role assigned to this Interface, should use values as defined in ECOMP Yang models.
+          required: false
+          type: string
+        - name: interface-id
+          in: query
+          description: ID of interface
+          required: false
+          type: string
+        - name: macaddr
+          in: query
+          description: MAC address for the interface
+          required: false
+          type: string
+        - name: network-name
+          in: query
+          description: Name of the network
+          required: false
+          type: string
+        - name: vlan-id-inner
+          in: query
+          description: Inner VLAN tag
+          required: false
+          type: integer
+          format: int64
+        - name: vpn-key
+          in: query
+          description: This indicates the customers VPN ID associated with this vlan
+          required: false
+          type: string
+        - name: vlan-id-inner
+          in: query
+          description: Inner VLAN tag
+          required: false
+          type: integer
+          format: int64
+        - name: neutron-network-id
+          in: query
+          description: Neutron network id of the interface that address belongs to
+          required: false
+          type: string
+        - name: neutron-subnet-id
+          in: query
+          description: Neutron id of subnet that address belongs to
           required: false
           type: string
     put:
       tags:
         - Network
-      summary: create or update an existing instance-group
-      description: create or update an existing instance-group
-      operationId: createOrUpdateNetworkInstanceGroupsInstanceGroup
+      summary: create or update an existing l3-interface-ipv6-address-list
+      description: |
+        Create or update an existing l3-interface-ipv6-address-list.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList
       consumes:
         - application/json
         - application/xml
@@ -38697,23 +48684,59 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: id
+        - name: pnf-name
           in: path
-          description: Instance Group ID, UUID assigned to this instance.
+          description: unique name of Physical Network Function.
+          required: true
+          type: string
+          example: __PNF-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
+          type: string
+          example: __VLAN-INTERFACE__
+        - name: l3-interface-ipv6-address
+          in: path
+          description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
         - name: body
           in: body
-          description: instance-group object that needs to be created or updated
+          description: l3-interface-ipv6-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList.json)
           required: true
           schema:
-            $ref: "#/definitions/instance-group"
-    delete:
+            $ref: "#/definitions/l3-interface-ipv6-address-list"
+    patch:
       tags:
         - Network
-      summary: delete an existing instance-group
-      description: delete an existing instance-group
-      operationId: deleteNetworkInstanceGroupsInstanceGroup
+      summary: update an existing l3-interface-ipv6-address-list
+      description: |
+        Update an existing l3-interface-ipv6-address-list
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList
       consumes:
         - application/json
         - application/xml
@@ -38724,66 +48747,48 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: id
+        - name: pnf-name
           in: path
-          description: Instance Group ID, UUID assigned to this instance.
+          description: unique name of Physical Network Function.
           required: true
           type: string
-        - name: resource-version
-          in: query
-          description: resource-version for concurrency
+          example: __PNF-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
           required: true
           type: string
-  /network/instance-groups:
-    get:
-      tags:
-        - Network
-      summary: returns instance-groups
-      description: returns instance-groups
-      operationId: getNetworkInstanceGroups
-      produces:
-        - application/json
-        - application/xml
-      responses:
-        "200":
-          description: successful operation
-          schema:
-              $ref: "#/definitions/instance-groups"
-        "default":
-          description: Response codes found in [response codes](https://wiki.onap.org/).
-  /network/zones/zone/{zone-id}/relationship-list/relationship:
-    put:
-      tags:
-        - Network
-      summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkZonesZoneRelationshipListRelationship
-      consumes:
-        - application/json
-        - application/xml
-      produces:
-        - application/json
-        - application/xml
-      responses:
-        "default":
-          description: Response codes found in [response codes](https://wiki.onap.org/).
-      parameters:
-        - name: zone-id
+          example: __INTERFACE-NAME__
+        - name: interface-name
           in: path
-          description: Code assigned by AIC to the zone
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
           required: true
           type: string
+          example: __VLAN-INTERFACE__
+        - name: l3-interface-ipv6-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: l3-interface-ipv6-address-list object that needs to be created or updated. 
           required: true
           schema:
-            $ref: "#/definitions/relationship"
+            $ref: "#/patchDefinitions/l3-interface-ipv6-address-list"
     delete:
       tags:
         - Network
-      summary: delete an existing relationship
-      description: delete an existing relationship
-      operationId: deleteNetworkZonesZoneRelationshipListRelationship
+      summary: delete an existing l3-interface-ipv6-address-list
+      description: delete an existing l3-interface-ipv6-address-list
+      operationId: deleteNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList
       consumes:
         - application/json
         - application/xml
@@ -38794,18 +48799,48 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: zone-id
+        - name: pnf-name
           in: path
-          description: Code assigned by AIC to the zone
+          description: unique name of Physical Network Function.
           required: true
           type: string
-  /network/zones/zone/{zone-id}:
+          example: __PNF-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
+          type: string
+          example: __VLAN-INTERFACE__
+        - name: l3-interface-ipv6-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
+        - name: resource-version
+          in: query
+          description: resource-version for concurrency
+          required: true
+          type: string
+  /network/pnfs/pnf/{pnf-name}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}:
     get:
       tags:
         - Network
-      summary: returns zone
-      description: returns zone
-      operationId: getNetworkZonesZone
+      summary: returns vlan
+      description: returns vlan
+      operationId: getNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlan
       produces:
         - application/json
         - application/xml
@@ -38813,31 +48848,84 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/zone"
+              $ref: "#/getDefinitions/vlan"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: zone-id
+        - name: pnf-name
           in: path
-          description: Code assigned by AIC to the zone
+          description: unique name of Physical Network Function.
           required: true
           type: string
-        - name: design-type
+          example: __PNF-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
+          type: string
+          example: __VLAN-INTERFACE__
+        - name: inv-status
           in: query
-          description: Design of zone [Medium/Large?]
+          description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
           required: false
           type: string
-        - name: zone-context
+        - name: interface-id
           in: query
-          description: Context of zone [production/test]
+          description: ID of interface
+          required: false
+          type: string
+        - name: interface-role
+          in: query
+          description: Role assigned to this Interface, should use values as defined in ECOMP Yang models.
+          required: false
+          type: string
+        - name: interface-id
+          in: query
+          description: ID of interface
+          required: false
+          type: string
+        - name: macaddr
+          in: query
+          description: MAC address for the interface
+          required: false
+          type: string
+        - name: network-name
+          in: query
+          description: Name of the network
+          required: false
+          type: string
+        - name: vlan-id-inner
+          in: query
+          description: Inner VLAN tag
+          required: false
+          type: integer
+          format: int64
+        - name: vpn-key
+          in: query
+          description: This indicates the customers VPN ID associated with this vlan
           required: false
           type: string
     put:
       tags:
         - Network
-      summary: create or update an existing zone
-      description: create or update an existing zone
-      operationId: createOrUpdateNetworkZonesZone
+      summary: create or update an existing vlan
+      description: |
+        Create or update an existing vlan.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlan
       consumes:
         - application/json
         - application/xml
@@ -38848,23 +48936,99 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: zone-id
+        - name: pnf-name
           in: path
-          description: Code assigned by AIC to the zone
+          description: unique name of Physical Network Function.
+          required: true
+          type: string
+          example: __PNF-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
           required: true
           type: string
+          example: __VLAN-INTERFACE__
         - name: body
           in: body
-          description: zone object that needs to be created or updated
+          description: vlan object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlan.json)
           required: true
           schema:
-            $ref: "#/definitions/zone"
+            $ref: "#/definitions/vlan"
+    patch:
+      tags:
+        - Network
+      summary: update an existing vlan
+      description: |
+        Update an existing vlan
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlan
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: pnf-name
+          in: path
+          description: unique name of Physical Network Function.
+          required: true
+          type: string
+          example: __PNF-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
+          type: string
+          example: __VLAN-INTERFACE__
+        - name: body
+          in: body
+          description: vlan object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/vlan"
     delete:
       tags:
         - Network
-      summary: delete an existing zone
-      description: delete an existing zone
-      operationId: deleteNetworkZonesZone
+      summary: delete an existing vlan
+      description: delete an existing vlan
+      operationId: deleteNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlan
       consumes:
         - application/json
         - application/xml
@@ -38875,23 +49039,42 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: zone-id
+        - name: pnf-name
           in: path
-          description: Code assigned by AIC to the zone
+          description: unique name of Physical Network Function.
+          required: true
+          type: string
+          example: __PNF-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
           required: true
           type: string
+          example: __VLAN-INTERFACE__
         - name: resource-version
           in: query
           description: resource-version for concurrency
           required: true
           type: string
-  /network/zones:
+  /network/pnfs/pnf/{pnf-name}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans:
     get:
       tags:
         - Network
-      summary: returns zones
-      description: returns zones
-      operationId: getNetworkZones
+      summary: returns vlans
+      description: returns vlans
+      operationId: getNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlans
       produces:
         - application/json
         - application/xml
@@ -38899,791 +49082,14644 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/zones"
+              $ref: "#/getDefinitions/vlans"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
-definitions:
-  search:
-    properties:
-      edge-tag-query-result:
-        type: object
-        $ref: "#/definitions/edge-tag-query-result"
-      edge-tag-query-request:
-        type: object
-        $ref: "#/definitions/edge-tag-query-request"
-      search-results:
-        type: object
-        $ref: "#/definitions/search-results"
-      sdn-zone-response:
-        type: object
-        $ref: "#/definitions/sdn-zone-response"
-  actions:
-    description: |
-      APIs that are more action related than REST (e.g., notify, update).
-    properties:
-      update:
-        type: object
-        $ref: "#/definitions/update"
-      notify:
-        type: object
-        $ref: "#/definitions/notify"
-  relationship-data:
-    required:
-    - relationship-key
-    - relationship-value
-    properties:
-      relationship-key:
-        type: string
-        description: A keyword provided by A&AI to indicate an attribute.
-      relationship-value:
-        type: string
-        description: Value of the attribute.
-  related-to-property:
-    properties:
-      property-key:
-        type: string
-        description: Key part of a key/value pair
-      property-value:
-        type: string
-        description: Value part of a key/value pair
-  relationship:
-    properties:
-      related-to:
-        type: string
-        description: A keyword provided by A&AI to indicate type of node.
-      related-link:
-        type: string
-        description: URL to the object in A&AI.
-      relationship-data:
-        type: array
-        items:          
-          $ref: "#/definitions/relationship-data"
-      related-to-property:
-        type: array
-        items:          
-          $ref: "#/definitions/related-to-property"
-  relationship-list:
-    properties:
-      relationship:
-        type: array
-        items:          
-          $ref: "#/definitions/relationship"
-  ctag-pool:
-    description: |
-      A collection of C tags (vlan tags) grouped for a specific purpose.
-      ###### Default Delete Scope
-      THIS_NODE_ONLY
-      ###### Related Nodes
-      - TO availability-zone (Many2Many)
-      - FROM complex (is composed of ctag-pool)
-      - FROM vpls-pe
-      - FROM generic-vnf
-    required:
-    - target-pe
-    - availability-zone-name
-    - ctag-pool-purpose
-    properties:
-      target-pe:
-        type: string
-        description: The Target provider edge router
-      availability-zone-name:
-        type: string
-        description: Name of the availability zone
-      ctag-pool-purpose:
-        type: string
-        description: Describes what the intended purpose of this pool is.
-      ctag-values:
-        type: string
-        description: Comma separated list of ctags
-      resource-version:
-        type: string
-        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
-      relationship-list:
-        type: array
-        items:
-          $ref: "#/definitions/relationship"
-  ctag-pools:
-    properties:
-      ctag-pool:
-        type: array
-        items:          
-          $ref: "#/definitions/ctag-pool"
-  complex:
-    description: |
-      Collection of physical locations that can house cloud-regions.
-      ###### Default Delete Scope
-      ERROR_4_IN_EDGES_OR_CASCADE
-      ###### Related Nodes
-      - TO ctag-pool (comprises complex, Many2Many)
-      - TO l3-network (Many2Many)
-      - FROM availability-zone
-      - FROM cloud-region
-      - FROM oam-network
-      - FROM pserver
-      - FROM pnf
-      - FROM vce
-      - FROM vpls-pe
-      - FROM volume-group
-      - FROM zone
-      - FROM generic-vnf
-    required:
-    - physical-location-id
-    - physical-location-type
-    - street1
-    - city
-    - postal-code
-    - country
-    - region
+      parameters:
+        - name: pnf-name
+          in: path
+          description: unique name of Physical Network Function.
+          required: true
+          type: string
+          example: __PNF-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: inv-status
+          in: query
+          description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
+          required: false
+          type: string
+        - name: interface-id
+          in: query
+          description: ID of interface
+          required: false
+          type: string
+        - name: interface-role
+          in: query
+          description: Role assigned to this Interface, should use values as defined in ECOMP Yang models.
+          required: false
+          type: string
+        - name: interface-id
+          in: query
+          description: ID of interface
+          required: false
+          type: string
+        - name: macaddr
+          in: query
+          description: MAC address for the interface
+          required: false
+          type: string
+        - name: network-name
+          in: query
+          description: Name of the network
+          required: false
+          type: string
+  /network/pnfs/pnf/{pnf-name}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/sriov-vfs/sriov-vf/{pci-id}/relationship-list/relationship:
+    put:
+      tags:
+        - Network
+      summary: see node definition for valid relationships
+      operationId: createOrUpdateNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfsSriovVfRelationshipListRelationship
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: pnf-name
+          in: path
+          description: unique name of Physical Network Function.
+          required: true
+          type: string
+          example: __PNF-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: pci-id
+          in: path
+          description: PCI ID used to identify the sriov-vf
+          required: true
+          type: string
+          example: __PCI-ID__
+        - name: body
+          in: body
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfsSriovVf.json)
+          required: true
+          schema:
+            $ref: "#/definitions/relationship"
+    delete:
+      tags:
+        - Network
+      summary: delete an existing relationship
+      description: delete an existing relationship
+      operationId: deleteNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfsSriovVfRelationshipListRelationship
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: pnf-name
+          in: path
+          description: unique name of Physical Network Function.
+          required: true
+          type: string
+          example: __PNF-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: pci-id
+          in: path
+          description: PCI ID used to identify the sriov-vf
+          required: true
+          type: string
+          example: __PCI-ID__
+  /network/pnfs/pnf/{pnf-name}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/sriov-vfs/sriov-vf/{pci-id}:
+    get:
+      tags:
+        - Network
+      summary: returns sriov-vf
+      description: returns sriov-vf
+      operationId: getNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfsSriovVf
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "200":
+          description: successful operation
+          schema:
+              $ref: "#/getDefinitions/sriov-vf"
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: pnf-name
+          in: path
+          description: unique name of Physical Network Function.
+          required: true
+          type: string
+          example: __PNF-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: pci-id
+          in: path
+          description: PCI ID used to identify the sriov-vf
+          required: true
+          type: string
+          example: __PCI-ID__
+        - name: inv-status
+          in: query
+          description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
+          required: false
+          type: string
+        - name: interface-id
+          in: query
+          description: ID of interface
+          required: false
+          type: string
+        - name: interface-role
+          in: query
+          description: Role assigned to this Interface, should use values as defined in ECOMP Yang models.
+          required: false
+          type: string
+        - name: interface-id
+          in: query
+          description: ID of interface
+          required: false
+          type: string
+        - name: macaddr
+          in: query
+          description: MAC address for the interface
+          required: false
+          type: string
+        - name: network-name
+          in: query
+          description: Name of the network
+          required: false
+          type: string
+        - name: vf-vlan-filter
+          in: query
+          description: This metadata provides option to specify list of VLAN filters applied on VF to pass the traffic to VM.
+          required: false
+          type: string
+        - name: vf-mac-filter
+          in: query
+          description: When MAC filters are specified, VF-agent service configures VFs to do MAC level filtering before the traffic is passed to VM.
+          required: false
+          type: string
+        - name: vf-vlan-strip
+          in: query
+          description: When this field is set to true, VF will configured to strip the outer TAG before the traffic is passed to VM.
+          required: false
+          type: boolean
+        - name: neutron-network-id
+          in: query
+          description: Neutron network id of the interface
+          required: false
+          type: string
+    put:
+      tags:
+        - Network
+      summary: create or update an existing sriov-vf
+      description: |
+        Create or update an existing sriov-vf.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfsSriovVf
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: pnf-name
+          in: path
+          description: unique name of Physical Network Function.
+          required: true
+          type: string
+          example: __PNF-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: pci-id
+          in: path
+          description: PCI ID used to identify the sriov-vf
+          required: true
+          type: string
+          example: __PCI-ID__
+        - name: body
+          in: body
+          description: sriov-vf object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfsSriovVf.json)
+          required: true
+          schema:
+            $ref: "#/definitions/sriov-vf"
+    patch:
+      tags:
+        - Network
+      summary: update an existing sriov-vf
+      description: |
+        Update an existing sriov-vf
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfsSriovVf
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: pnf-name
+          in: path
+          description: unique name of Physical Network Function.
+          required: true
+          type: string
+          example: __PNF-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: pci-id
+          in: path
+          description: PCI ID used to identify the sriov-vf
+          required: true
+          type: string
+          example: __PCI-ID__
+        - name: body
+          in: body
+          description: sriov-vf object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/sriov-vf"
+    delete:
+      tags:
+        - Network
+      summary: delete an existing sriov-vf
+      description: delete an existing sriov-vf
+      operationId: deleteNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfsSriovVf
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: pnf-name
+          in: path
+          description: unique name of Physical Network Function.
+          required: true
+          type: string
+          example: __PNF-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: pci-id
+          in: path
+          description: PCI ID used to identify the sriov-vf
+          required: true
+          type: string
+          example: __PCI-ID__
+        - name: resource-version
+          in: query
+          description: resource-version for concurrency
+          required: true
+          type: string
+  /network/pnfs/pnf/{pnf-name}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/sriov-vfs:
+    get:
+      tags:
+        - Network
+      summary: returns sriov-vfs
+      description: returns sriov-vfs
+      operationId: getNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfs
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "200":
+          description: successful operation
+          schema:
+              $ref: "#/getDefinitions/sriov-vfs"
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: pnf-name
+          in: path
+          description: unique name of Physical Network Function.
+          required: true
+          type: string
+          example: __PNF-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: inv-status
+          in: query
+          description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
+          required: false
+          type: string
+        - name: interface-id
+          in: query
+          description: ID of interface
+          required: false
+          type: string
+        - name: interface-role
+          in: query
+          description: Role assigned to this Interface, should use values as defined in ECOMP Yang models.
+          required: false
+          type: string
+        - name: interface-id
+          in: query
+          description: ID of interface
+          required: false
+          type: string
+        - name: macaddr
+          in: query
+          description: MAC address for the interface
+          required: false
+          type: string
+        - name: network-name
+          in: query
+          description: Name of the network
+          required: false
+          type: string
+  /network/pnfs/pnf/{pnf-name}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/relationship-list/relationship:
+    put:
+      tags:
+        - Network
+      summary: see node definition for valid relationships
+      operationId: createOrUpdateNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceRelationshipListRelationship
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: pnf-name
+          in: path
+          description: unique name of Physical Network Function.
+          required: true
+          type: string
+          example: __PNF-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: body
+          in: body
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterface.json)
+          required: true
+          schema:
+            $ref: "#/definitions/relationship"
+    delete:
+      tags:
+        - Network
+      summary: delete an existing relationship
+      description: delete an existing relationship
+      operationId: deleteNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceRelationshipListRelationship
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: pnf-name
+          in: path
+          description: unique name of Physical Network Function.
+          required: true
+          type: string
+          example: __PNF-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+  /network/pnfs/pnf/{pnf-name}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}/relationship-list/relationship:
+    put:
+      tags:
+        - Network
+      summary: see node definition for valid relationships
+      operationId: createOrUpdateNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressListRelationshipListRelationship
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: pnf-name
+          in: path
+          description: unique name of Physical Network Function.
+          required: true
+          type: string
+          example: __PNF-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: l3-interface-ipv4-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
+        - name: body
+          in: body
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList.json)
+          required: true
+          schema:
+            $ref: "#/definitions/relationship"
+    delete:
+      tags:
+        - Network
+      summary: delete an existing relationship
+      description: delete an existing relationship
+      operationId: deleteNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressListRelationshipListRelationship
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: pnf-name
+          in: path
+          description: unique name of Physical Network Function.
+          required: true
+          type: string
+          example: __PNF-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: l3-interface-ipv4-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
+  /network/pnfs/pnf/{pnf-name}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}:
+    get:
+      tags:
+        - Network
+      summary: returns l3-interface-ipv4-address-list
+      description: returns l3-interface-ipv4-address-list
+      operationId: getNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "200":
+          description: successful operation
+          schema:
+              $ref: "#/getDefinitions/l3-interface-ipv4-address-list"
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: pnf-name
+          in: path
+          description: unique name of Physical Network Function.
+          required: true
+          type: string
+          example: __PNF-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: l3-interface-ipv4-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
+        - name: inv-status
+          in: query
+          description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
+          required: false
+          type: string
+        - name: interface-id
+          in: query
+          description: ID of interface
+          required: false
+          type: string
+        - name: interface-role
+          in: query
+          description: Role assigned to this Interface, should use values as defined in ECOMP Yang models.
+          required: false
+          type: string
+        - name: interface-id
+          in: query
+          description: ID of interface
+          required: false
+          type: string
+        - name: macaddr
+          in: query
+          description: MAC address for the interface
+          required: false
+          type: string
+        - name: network-name
+          in: query
+          description: Name of the network
+          required: false
+          type: string
+        - name: vlan-id-inner
+          in: query
+          description: Inner VLAN tag
+          required: false
+          type: integer
+          format: int64
+        - name: neutron-network-id
+          in: query
+          description: Neutron network id of the interface that address belongs to
+          required: false
+          type: string
+        - name: neutron-subnet-id
+          in: query
+          description: Neutron id of subnet that address belongs to
+          required: false
+          type: string
+    put:
+      tags:
+        - Network
+      summary: create or update an existing l3-interface-ipv4-address-list
+      description: |
+        Create or update an existing l3-interface-ipv4-address-list.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: pnf-name
+          in: path
+          description: unique name of Physical Network Function.
+          required: true
+          type: string
+          example: __PNF-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: l3-interface-ipv4-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
+        - name: body
+          in: body
+          description: l3-interface-ipv4-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList.json)
+          required: true
+          schema:
+            $ref: "#/definitions/l3-interface-ipv4-address-list"
+    patch:
+      tags:
+        - Network
+      summary: update an existing l3-interface-ipv4-address-list
+      description: |
+        Update an existing l3-interface-ipv4-address-list
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: pnf-name
+          in: path
+          description: unique name of Physical Network Function.
+          required: true
+          type: string
+          example: __PNF-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: l3-interface-ipv4-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
+        - name: body
+          in: body
+          description: l3-interface-ipv4-address-list object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/l3-interface-ipv4-address-list"
+    delete:
+      tags:
+        - Network
+      summary: delete an existing l3-interface-ipv4-address-list
+      description: delete an existing l3-interface-ipv4-address-list
+      operationId: deleteNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: pnf-name
+          in: path
+          description: unique name of Physical Network Function.
+          required: true
+          type: string
+          example: __PNF-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: l3-interface-ipv4-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
+        - name: resource-version
+          in: query
+          description: resource-version for concurrency
+          required: true
+          type: string
+  /network/pnfs/pnf/{pnf-name}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}/relationship-list/relationship:
+    put:
+      tags:
+        - Network
+      summary: see node definition for valid relationships
+      operationId: createOrUpdateNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressListRelationshipListRelationship
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: pnf-name
+          in: path
+          description: unique name of Physical Network Function.
+          required: true
+          type: string
+          example: __PNF-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: l3-interface-ipv6-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
+        - name: body
+          in: body
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList.json)
+          required: true
+          schema:
+            $ref: "#/definitions/relationship"
+    delete:
+      tags:
+        - Network
+      summary: delete an existing relationship
+      description: delete an existing relationship
+      operationId: deleteNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressListRelationshipListRelationship
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: pnf-name
+          in: path
+          description: unique name of Physical Network Function.
+          required: true
+          type: string
+          example: __PNF-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: l3-interface-ipv6-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
+  /network/pnfs/pnf/{pnf-name}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}:
+    get:
+      tags:
+        - Network
+      summary: returns l3-interface-ipv6-address-list
+      description: returns l3-interface-ipv6-address-list
+      operationId: getNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "200":
+          description: successful operation
+          schema:
+              $ref: "#/getDefinitions/l3-interface-ipv6-address-list"
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: pnf-name
+          in: path
+          description: unique name of Physical Network Function.
+          required: true
+          type: string
+          example: __PNF-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: l3-interface-ipv6-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
+        - name: inv-status
+          in: query
+          description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
+          required: false
+          type: string
+        - name: interface-id
+          in: query
+          description: ID of interface
+          required: false
+          type: string
+        - name: interface-role
+          in: query
+          description: Role assigned to this Interface, should use values as defined in ECOMP Yang models.
+          required: false
+          type: string
+        - name: interface-id
+          in: query
+          description: ID of interface
+          required: false
+          type: string
+        - name: macaddr
+          in: query
+          description: MAC address for the interface
+          required: false
+          type: string
+        - name: network-name
+          in: query
+          description: Name of the network
+          required: false
+          type: string
+        - name: vlan-id-inner
+          in: query
+          description: Inner VLAN tag
+          required: false
+          type: integer
+          format: int64
+        - name: neutron-network-id
+          in: query
+          description: Neutron network id of the interface that address belongs to
+          required: false
+          type: string
+        - name: neutron-subnet-id
+          in: query
+          description: Neutron id of subnet that address belongs to
+          required: false
+          type: string
+    put:
+      tags:
+        - Network
+      summary: create or update an existing l3-interface-ipv6-address-list
+      description: |
+        Create or update an existing l3-interface-ipv6-address-list.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: pnf-name
+          in: path
+          description: unique name of Physical Network Function.
+          required: true
+          type: string
+          example: __PNF-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: l3-interface-ipv6-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
+        - name: body
+          in: body
+          description: l3-interface-ipv6-address-list object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList.json)
+          required: true
+          schema:
+            $ref: "#/definitions/l3-interface-ipv6-address-list"
+    patch:
+      tags:
+        - Network
+      summary: update an existing l3-interface-ipv6-address-list
+      description: |
+        Update an existing l3-interface-ipv6-address-list
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: pnf-name
+          in: path
+          description: unique name of Physical Network Function.
+          required: true
+          type: string
+          example: __PNF-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: l3-interface-ipv6-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
+        - name: body
+          in: body
+          description: l3-interface-ipv6-address-list object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/l3-interface-ipv6-address-list"
+    delete:
+      tags:
+        - Network
+      summary: delete an existing l3-interface-ipv6-address-list
+      description: delete an existing l3-interface-ipv6-address-list
+      operationId: deleteNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: pnf-name
+          in: path
+          description: unique name of Physical Network Function.
+          required: true
+          type: string
+          example: __PNF-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: l3-interface-ipv6-address
+          in: path
+          description: IP address
+          required: true
+          type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
+        - name: resource-version
+          in: query
+          description: resource-version for concurrency
+          required: true
+          type: string
+  /network/pnfs/pnf/{pnf-name}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}:
+    get:
+      tags:
+        - Network
+      summary: returns l-interface
+      description: returns l-interface
+      operationId: getNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterface
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "200":
+          description: successful operation
+          schema:
+              $ref: "#/getDefinitions/l-interface"
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: pnf-name
+          in: path
+          description: unique name of Physical Network Function.
+          required: true
+          type: string
+          example: __PNF-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: inv-status
+          in: query
+          description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
+          required: false
+          type: string
+        - name: interface-id
+          in: query
+          description: ID of interface
+          required: false
+          type: string
+        - name: interface-role
+          in: query
+          description: Role assigned to this Interface, should use values as defined in ECOMP Yang models.
+          required: false
+          type: string
+        - name: interface-id
+          in: query
+          description: ID of interface
+          required: false
+          type: string
+        - name: macaddr
+          in: query
+          description: MAC address for the interface
+          required: false
+          type: string
+        - name: network-name
+          in: query
+          description: Name of the network
+          required: false
+          type: string
+    put:
+      tags:
+        - Network
+      summary: create or update an existing l-interface
+      description: |
+        Create or update an existing l-interface.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterface
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: pnf-name
+          in: path
+          description: unique name of Physical Network Function.
+          required: true
+          type: string
+          example: __PNF-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: body
+          in: body
+          description: l-interface object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterface.json)
+          required: true
+          schema:
+            $ref: "#/definitions/l-interface"
+    patch:
+      tags:
+        - Network
+      summary: update an existing l-interface
+      description: |
+        Update an existing l-interface
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterface
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: pnf-name
+          in: path
+          description: unique name of Physical Network Function.
+          required: true
+          type: string
+          example: __PNF-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: body
+          in: body
+          description: l-interface object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/l-interface"
+    delete:
+      tags:
+        - Network
+      summary: delete an existing l-interface
+      description: delete an existing l-interface
+      operationId: deleteNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterface
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: pnf-name
+          in: path
+          description: unique name of Physical Network Function.
+          required: true
+          type: string
+          example: __PNF-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: resource-version
+          in: query
+          description: resource-version for concurrency
+          required: true
+          type: string
+  /network/pnfs/pnf/{pnf-name}/lag-interfaces/lag-interface/{interface-name}/l-interfaces:
+    get:
+      tags:
+        - Network
+      summary: returns l-interfaces
+      description: returns l-interfaces
+      operationId: getNetworkPnfsPnfLagInterfacesLagInterfaceLInterfaces
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "200":
+          description: successful operation
+          schema:
+              $ref: "#/getDefinitions/l-interfaces"
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: pnf-name
+          in: path
+          description: unique name of Physical Network Function.
+          required: true
+          type: string
+          example: __PNF-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: inv-status
+          in: query
+          description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
+          required: false
+          type: string
+        - name: interface-id
+          in: query
+          description: ID of interface
+          required: false
+          type: string
+        - name: interface-role
+          in: query
+          description: Role assigned to this Interface, should use values as defined in ECOMP Yang models.
+          required: false
+          type: string
+  /network/pnfs/pnf/{pnf-name}/lag-interfaces/lag-interface/{interface-name}:
+    get:
+      tags:
+        - Network
+      summary: returns lag-interface
+      description: returns lag-interface
+      operationId: getNetworkPnfsPnfLagInterfacesLagInterface
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "200":
+          description: successful operation
+          schema:
+              $ref: "#/getDefinitions/lag-interface"
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: pnf-name
+          in: path
+          description: unique name of Physical Network Function.
+          required: true
+          type: string
+          example: __PNF-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: inv-status
+          in: query
+          description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
+          required: false
+          type: string
+        - name: interface-id
+          in: query
+          description: ID of interface
+          required: false
+          type: string
+        - name: interface-role
+          in: query
+          description: Role assigned to this Interface, should use values as defined in ECOMP Yang models.
+          required: false
+          type: string
+    put:
+      tags:
+        - Network
+      summary: create or update an existing lag-interface
+      description: |
+        Create or update an existing lag-interface.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkPnfsPnfLagInterfacesLagInterface
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: pnf-name
+          in: path
+          description: unique name of Physical Network Function.
+          required: true
+          type: string
+          example: __PNF-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: body
+          in: body
+          description: lag-interface object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkPnfsPnfLagInterfacesLagInterface.json)
+          required: true
+          schema:
+            $ref: "#/definitions/lag-interface"
+    patch:
+      tags:
+        - Network
+      summary: update an existing lag-interface
+      description: |
+        Update an existing lag-interface
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkPnfsPnfLagInterfacesLagInterface
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: pnf-name
+          in: path
+          description: unique name of Physical Network Function.
+          required: true
+          type: string
+          example: __PNF-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: body
+          in: body
+          description: lag-interface object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/lag-interface"
+    delete:
+      tags:
+        - Network
+      summary: delete an existing lag-interface
+      description: delete an existing lag-interface
+      operationId: deleteNetworkPnfsPnfLagInterfacesLagInterface
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: pnf-name
+          in: path
+          description: unique name of Physical Network Function.
+          required: true
+          type: string
+          example: __PNF-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
+          required: true
+          type: string
+          example: __INTERFACE-NAME__
+        - name: resource-version
+          in: query
+          description: resource-version for concurrency
+          required: true
+          type: string
+  /network/pnfs/pnf/{pnf-name}/lag-interfaces:
+    get:
+      tags:
+        - Network
+      summary: returns lag-interfaces
+      description: returns lag-interfaces
+      operationId: getNetworkPnfsPnfLagInterfaces
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "200":
+          description: successful operation
+          schema:
+              $ref: "#/getDefinitions/lag-interfaces"
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: pnf-name
+          in: path
+          description: unique name of Physical Network Function.
+          required: true
+          type: string
+          example: __PNF-NAME__
+        - name: inv-status
+          in: query
+          description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
+          required: false
+          type: string
+  /network/pnfs/pnf/{pnf-name}:
+    get:
+      tags:
+        - Network
+      summary: returns pnf
+      description: returns pnf
+      operationId: getNetworkPnfsPnf
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "200":
+          description: successful operation
+          schema:
+              $ref: "#/getDefinitions/pnf"
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: pnf-name
+          in: path
+          description: unique name of Physical Network Function.
+          required: true
+          type: string
+          example: __PNF-NAME__
+        - name: inv-status
+          in: query
+          description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
+          required: false
+          type: string
+    put:
+      tags:
+        - Network
+      summary: create or update an existing pnf
+      description: |
+        Create or update an existing pnf.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkPnfsPnf
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: pnf-name
+          in: path
+          description: unique name of Physical Network Function.
+          required: true
+          type: string
+          example: __PNF-NAME__
+        - name: body
+          in: body
+          description: pnf object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkPnfsPnf.json)
+          required: true
+          schema:
+            $ref: "#/definitions/pnf"
+    patch:
+      tags:
+        - Network
+      summary: update an existing pnf
+      description: |
+        Update an existing pnf
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkPnfsPnf
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: pnf-name
+          in: path
+          description: unique name of Physical Network Function.
+          required: true
+          type: string
+          example: __PNF-NAME__
+        - name: body
+          in: body
+          description: pnf object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/pnf"
+    delete:
+      tags:
+        - Network
+      summary: delete an existing pnf
+      description: delete an existing pnf
+      operationId: deleteNetworkPnfsPnf
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: pnf-name
+          in: path
+          description: unique name of Physical Network Function.
+          required: true
+          type: string
+          example: __PNF-NAME__
+        - name: resource-version
+          in: query
+          description: resource-version for concurrency
+          required: true
+          type: string
+  /network/pnfs:
+    get:
+      tags:
+        - Network
+      summary: returns pnfs
+      description: returns pnfs
+      operationId: getNetworkPnfs
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "200":
+          description: successful operation
+          schema:
+              $ref: "#/getDefinitions/pnfs"
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+  /network/physical-links/physical-link/{link-name}/relationship-list/relationship:
+    put:
+      tags:
+        - Network
+      summary: see node definition for valid relationships
+      operationId: createOrUpdateNetworkPhysicalLinksPhysicalLinkRelationshipListRelationship
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: link-name
+          in: path
+          description: e.g., hostnameA_p-connection_nameA_hostnameZ+p_connection-nameZ
+          required: true
+          type: string
+          example: __LINK-NAME__
+        - name: body
+          in: body
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkPhysicalLinksPhysicalLink.json)
+          required: true
+          schema:
+            $ref: "#/definitions/relationship"
+    delete:
+      tags:
+        - Network
+      summary: delete an existing relationship
+      description: delete an existing relationship
+      operationId: deleteNetworkPhysicalLinksPhysicalLinkRelationshipListRelationship
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: link-name
+          in: path
+          description: e.g., hostnameA_p-connection_nameA_hostnameZ+p_connection-nameZ
+          required: true
+          type: string
+          example: __LINK-NAME__
+  /network/physical-links/physical-link/{link-name}:
+    get:
+      tags:
+        - Network
+      summary: returns physical-link
+      description: returns physical-link
+      operationId: getNetworkPhysicalLinksPhysicalLink
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "200":
+          description: successful operation
+          schema:
+              $ref: "#/getDefinitions/physical-link"
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: link-name
+          in: path
+          description: e.g., hostnameA_p-connection_nameA_hostnameZ+p_connection-nameZ
+          required: true
+          type: string
+          example: __LINK-NAME__
+        - name: circuit-id
+          in: query
+          description: Circuit it
+          required: false
+          type: string
+    put:
+      tags:
+        - Network
+      summary: create or update an existing physical-link
+      description: |
+        Create or update an existing physical-link.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkPhysicalLinksPhysicalLink
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: link-name
+          in: path
+          description: e.g., hostnameA_p-connection_nameA_hostnameZ+p_connection-nameZ
+          required: true
+          type: string
+          example: __LINK-NAME__
+        - name: body
+          in: body
+          description: physical-link object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkPhysicalLinksPhysicalLink.json)
+          required: true
+          schema:
+            $ref: "#/definitions/physical-link"
+    patch:
+      tags:
+        - Network
+      summary: update an existing physical-link
+      description: |
+        Update an existing physical-link
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkPhysicalLinksPhysicalLink
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: link-name
+          in: path
+          description: e.g., hostnameA_p-connection_nameA_hostnameZ+p_connection-nameZ
+          required: true
+          type: string
+          example: __LINK-NAME__
+        - name: body
+          in: body
+          description: physical-link object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/physical-link"
+    delete:
+      tags:
+        - Network
+      summary: delete an existing physical-link
+      description: delete an existing physical-link
+      operationId: deleteNetworkPhysicalLinksPhysicalLink
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: link-name
+          in: path
+          description: e.g., hostnameA_p-connection_nameA_hostnameZ+p_connection-nameZ
+          required: true
+          type: string
+          example: __LINK-NAME__
+        - name: resource-version
+          in: query
+          description: resource-version for concurrency
+          required: true
+          type: string
+  /network/physical-links:
+    get:
+      tags:
+        - Network
+      summary: returns physical-links
+      description: returns physical-links
+      operationId: getNetworkPhysicalLinks
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "200":
+          description: successful operation
+          schema:
+              $ref: "#/getDefinitions/physical-links"
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+  /network/ipsec-configurations/ipsec-configuration/{ipsec-configuration-id}/relationship-list/relationship:
+    put:
+      tags:
+        - Network
+      summary: see node definition for valid relationships
+      operationId: createOrUpdateNetworkIpsecConfigurationsIpsecConfigurationRelationshipListRelationship
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: ipsec-configuration-id
+          in: path
+          description: UUID of this configuration
+          required: true
+          type: string
+          example: __IPSEC-CONFIGURATION-ID__
+        - name: body
+          in: body
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkIpsecConfigurationsIpsecConfiguration.json)
+          required: true
+          schema:
+            $ref: "#/definitions/relationship"
+    delete:
+      tags:
+        - Network
+      summary: delete an existing relationship
+      description: delete an existing relationship
+      operationId: deleteNetworkIpsecConfigurationsIpsecConfigurationRelationshipListRelationship
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: ipsec-configuration-id
+          in: path
+          description: UUID of this configuration
+          required: true
+          type: string
+          example: __IPSEC-CONFIGURATION-ID__
+  /network/ipsec-configurations/ipsec-configuration/{ipsec-configuration-id}/vig-servers/vig-server/{vig-address-type}/relationship-list/relationship:
+    put:
+      tags:
+        - Network
+      summary: see node definition for valid relationships
+      operationId: createOrUpdateNetworkIpsecConfigurationsIpsecConfigurationVigServersVigServerRelationshipListRelationship
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: ipsec-configuration-id
+          in: path
+          description: UUID of this configuration
+          required: true
+          type: string
+          example: __IPSEC-CONFIGURATION-ID__
+        - name: vig-address-type
+          in: path
+          description: indicates whether the VIG is for AVPN or INTERNET
+          required: true
+          type: string
+          example: __VIG-ADDRESS-TYPE__
+        - name: body
+          in: body
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkIpsecConfigurationsIpsecConfigurationVigServersVigServer.json)
+          required: true
+          schema:
+            $ref: "#/definitions/relationship"
+    delete:
+      tags:
+        - Network
+      summary: delete an existing relationship
+      description: delete an existing relationship
+      operationId: deleteNetworkIpsecConfigurationsIpsecConfigurationVigServersVigServerRelationshipListRelationship
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: ipsec-configuration-id
+          in: path
+          description: UUID of this configuration
+          required: true
+          type: string
+          example: __IPSEC-CONFIGURATION-ID__
+        - name: vig-address-type
+          in: path
+          description: indicates whether the VIG is for AVPN or INTERNET
+          required: true
+          type: string
+          example: __VIG-ADDRESS-TYPE__
+  /network/ipsec-configurations/ipsec-configuration/{ipsec-configuration-id}/vig-servers/vig-server/{vig-address-type}:
+    get:
+      tags:
+        - Network
+      summary: returns vig-server
+      description: returns vig-server
+      operationId: getNetworkIpsecConfigurationsIpsecConfigurationVigServersVigServer
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "200":
+          description: successful operation
+          schema:
+              $ref: "#/getDefinitions/vig-server"
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: ipsec-configuration-id
+          in: path
+          description: UUID of this configuration
+          required: true
+          type: string
+          example: __IPSEC-CONFIGURATION-ID__
+        - name: vig-address-type
+          in: path
+          description: indicates whether the VIG is for AVPN or INTERNET
+          required: true
+          type: string
+          example: __VIG-ADDRESS-TYPE__
+    put:
+      tags:
+        - Network
+      summary: create or update an existing vig-server
+      description: |
+        Create or update an existing vig-server.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkIpsecConfigurationsIpsecConfigurationVigServersVigServer
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: ipsec-configuration-id
+          in: path
+          description: UUID of this configuration
+          required: true
+          type: string
+          example: __IPSEC-CONFIGURATION-ID__
+        - name: vig-address-type
+          in: path
+          description: indicates whether the VIG is for AVPN or INTERNET
+          required: true
+          type: string
+          example: __VIG-ADDRESS-TYPE__
+        - name: body
+          in: body
+          description: vig-server object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkIpsecConfigurationsIpsecConfigurationVigServersVigServer.json)
+          required: true
+          schema:
+            $ref: "#/definitions/vig-server"
+    patch:
+      tags:
+        - Network
+      summary: update an existing vig-server
+      description: |
+        Update an existing vig-server
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkIpsecConfigurationsIpsecConfigurationVigServersVigServer
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: ipsec-configuration-id
+          in: path
+          description: UUID of this configuration
+          required: true
+          type: string
+          example: __IPSEC-CONFIGURATION-ID__
+        - name: vig-address-type
+          in: path
+          description: indicates whether the VIG is for AVPN or INTERNET
+          required: true
+          type: string
+          example: __VIG-ADDRESS-TYPE__
+        - name: body
+          in: body
+          description: vig-server object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/vig-server"
+    delete:
+      tags:
+        - Network
+      summary: delete an existing vig-server
+      description: delete an existing vig-server
+      operationId: deleteNetworkIpsecConfigurationsIpsecConfigurationVigServersVigServer
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: ipsec-configuration-id
+          in: path
+          description: UUID of this configuration
+          required: true
+          type: string
+          example: __IPSEC-CONFIGURATION-ID__
+        - name: vig-address-type
+          in: path
+          description: indicates whether the VIG is for AVPN or INTERNET
+          required: true
+          type: string
+          example: __VIG-ADDRESS-TYPE__
+        - name: resource-version
+          in: query
+          description: resource-version for concurrency
+          required: true
+          type: string
+  /network/ipsec-configurations/ipsec-configuration/{ipsec-configuration-id}/vig-servers:
+    get:
+      tags:
+        - Network
+      summary: returns vig-servers
+      description: returns vig-servers
+      operationId: getNetworkIpsecConfigurationsIpsecConfigurationVigServers
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "200":
+          description: successful operation
+          schema:
+              $ref: "#/getDefinitions/vig-servers"
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: ipsec-configuration-id
+          in: path
+          description: UUID of this configuration
+          required: true
+          type: string
+          example: __IPSEC-CONFIGURATION-ID__
+  /network/ipsec-configurations/ipsec-configuration/{ipsec-configuration-id}:
+    get:
+      tags:
+        - Network
+      summary: returns ipsec-configuration
+      description: returns ipsec-configuration
+      operationId: getNetworkIpsecConfigurationsIpsecConfiguration
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "200":
+          description: successful operation
+          schema:
+              $ref: "#/getDefinitions/ipsec-configuration"
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: ipsec-configuration-id
+          in: path
+          description: UUID of this configuration
+          required: true
+          type: string
+          example: __IPSEC-CONFIGURATION-ID__
+    put:
+      tags:
+        - Network
+      summary: create or update an existing ipsec-configuration
+      description: |
+        Create or update an existing ipsec-configuration.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkIpsecConfigurationsIpsecConfiguration
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: ipsec-configuration-id
+          in: path
+          description: UUID of this configuration
+          required: true
+          type: string
+          example: __IPSEC-CONFIGURATION-ID__
+        - name: body
+          in: body
+          description: ipsec-configuration object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkIpsecConfigurationsIpsecConfiguration.json)
+          required: true
+          schema:
+            $ref: "#/definitions/ipsec-configuration"
+    patch:
+      tags:
+        - Network
+      summary: update an existing ipsec-configuration
+      description: |
+        Update an existing ipsec-configuration
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkIpsecConfigurationsIpsecConfiguration
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: ipsec-configuration-id
+          in: path
+          description: UUID of this configuration
+          required: true
+          type: string
+          example: __IPSEC-CONFIGURATION-ID__
+        - name: body
+          in: body
+          description: ipsec-configuration object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/ipsec-configuration"
+    delete:
+      tags:
+        - Network
+      summary: delete an existing ipsec-configuration
+      description: delete an existing ipsec-configuration
+      operationId: deleteNetworkIpsecConfigurationsIpsecConfiguration
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: ipsec-configuration-id
+          in: path
+          description: UUID of this configuration
+          required: true
+          type: string
+          example: __IPSEC-CONFIGURATION-ID__
+        - name: resource-version
+          in: query
+          description: resource-version for concurrency
+          required: true
+          type: string
+  /network/ipsec-configurations:
+    get:
+      tags:
+        - Network
+      summary: returns ipsec-configurations
+      description: returns ipsec-configurations
+      operationId: getNetworkIpsecConfigurations
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "200":
+          description: successful operation
+          schema:
+              $ref: "#/getDefinitions/ipsec-configurations"
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+  /network/route-table-references/route-table-reference/{route-table-reference-id}/relationship-list/relationship:
+    put:
+      tags:
+        - Network
+      summary: see node definition for valid relationships
+      operationId: createOrUpdateNetworkRouteTableReferencesRouteTableReferenceRelationshipListRelationship
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: route-table-reference-id
+          in: path
+          description: Route Table Reference id, UUID assigned to this instance.
+          required: true
+          type: string
+          example: __ROUTE-TABLE-REFERENCE-ID__
+        - name: body
+          in: body
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkRouteTableReferencesRouteTableReference.json)
+          required: true
+          schema:
+            $ref: "#/definitions/relationship"
+    delete:
+      tags:
+        - Network
+      summary: delete an existing relationship
+      description: delete an existing relationship
+      operationId: deleteNetworkRouteTableReferencesRouteTableReferenceRelationshipListRelationship
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: route-table-reference-id
+          in: path
+          description: Route Table Reference id, UUID assigned to this instance.
+          required: true
+          type: string
+          example: __ROUTE-TABLE-REFERENCE-ID__
+  /network/route-table-references/route-table-reference/{route-table-reference-id}:
+    get:
+      tags:
+        - Network
+      summary: returns route-table-reference
+      description: returns route-table-reference
+      operationId: getNetworkRouteTableReferencesRouteTableReference
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "200":
+          description: successful operation
+          schema:
+              $ref: "#/getDefinitions/route-table-reference"
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: route-table-reference-id
+          in: path
+          description: Route Table Reference id, UUID assigned to this instance.
+          required: true
+          type: string
+          example: __ROUTE-TABLE-REFERENCE-ID__
+        - name: route-table-reference-fqdn
+          in: query
+          description: FQDN entry in the route table.
+          required: false
+          type: string
+    put:
+      tags:
+        - Network
+      summary: create or update an existing route-table-reference
+      description: |
+        Create or update an existing route-table-reference.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkRouteTableReferencesRouteTableReference
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: route-table-reference-id
+          in: path
+          description: Route Table Reference id, UUID assigned to this instance.
+          required: true
+          type: string
+          example: __ROUTE-TABLE-REFERENCE-ID__
+        - name: body
+          in: body
+          description: route-table-reference object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkRouteTableReferencesRouteTableReference.json)
+          required: true
+          schema:
+            $ref: "#/definitions/route-table-reference"
+    patch:
+      tags:
+        - Network
+      summary: update an existing route-table-reference
+      description: |
+        Update an existing route-table-reference
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkRouteTableReferencesRouteTableReference
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: route-table-reference-id
+          in: path
+          description: Route Table Reference id, UUID assigned to this instance.
+          required: true
+          type: string
+          example: __ROUTE-TABLE-REFERENCE-ID__
+        - name: body
+          in: body
+          description: route-table-reference object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/route-table-reference"
+    delete:
+      tags:
+        - Network
+      summary: delete an existing route-table-reference
+      description: delete an existing route-table-reference
+      operationId: deleteNetworkRouteTableReferencesRouteTableReference
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: route-table-reference-id
+          in: path
+          description: Route Table Reference id, UUID assigned to this instance.
+          required: true
+          type: string
+          example: __ROUTE-TABLE-REFERENCE-ID__
+        - name: resource-version
+          in: query
+          description: resource-version for concurrency
+          required: true
+          type: string
+  /network/route-table-references:
+    get:
+      tags:
+        - Network
+      summary: returns route-table-references
+      description: returns route-table-references
+      operationId: getNetworkRouteTableReferences
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "200":
+          description: successful operation
+          schema:
+              $ref: "#/getDefinitions/route-table-references"
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+  /network/instance-groups/instance-group/{id}/relationship-list/relationship:
+    put:
+      tags:
+        - Network
+      summary: see node definition for valid relationships
+      operationId: createOrUpdateNetworkInstanceGroupsInstanceGroupRelationshipListRelationship
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: id
+          in: path
+          description: Instance Group ID, UUID assigned to this instance.
+          required: true
+          type: string
+          example: __ID__
+        - name: body
+          in: body
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkInstanceGroupsInstanceGroup.json)
+          required: true
+          schema:
+            $ref: "#/definitions/relationship"
+    delete:
+      tags:
+        - Network
+      summary: delete an existing relationship
+      description: delete an existing relationship
+      operationId: deleteNetworkInstanceGroupsInstanceGroupRelationshipListRelationship
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: id
+          in: path
+          description: Instance Group ID, UUID assigned to this instance.
+          required: true
+          type: string
+          example: __ID__
+  /network/instance-groups/instance-group/{id}:
+    get:
+      tags:
+        - Network
+      summary: returns instance-group
+      description: returns instance-group
+      operationId: getNetworkInstanceGroupsInstanceGroup
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "200":
+          description: successful operation
+          schema:
+              $ref: "#/getDefinitions/instance-group"
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: id
+          in: path
+          description: Instance Group ID, UUID assigned to this instance.
+          required: true
+          type: string
+          example: __ID__
+        - name: description
+          in: query
+          description: Descriptive text to help identify the usage of this instance-group
+          required: false
+          type: string
+        - name: type
+          in: query
+          description: Only valid value today is lower case ha for high availability
+          required: false
+          type: string
+        - name: sub-type
+          in: query
+          description: Valid values for ha type are [geo-activeactive, geo-activestandby, local-activeactive, local-activestandby]
+          required: false
+          type: string
+    put:
+      tags:
+        - Network
+      summary: create or update an existing instance-group
+      description: |
+        Create or update an existing instance-group.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkInstanceGroupsInstanceGroup
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: id
+          in: path
+          description: Instance Group ID, UUID assigned to this instance.
+          required: true
+          type: string
+          example: __ID__
+        - name: body
+          in: body
+          description: instance-group object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkInstanceGroupsInstanceGroup.json)
+          required: true
+          schema:
+            $ref: "#/definitions/instance-group"
+    patch:
+      tags:
+        - Network
+      summary: update an existing instance-group
+      description: |
+        Update an existing instance-group
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkInstanceGroupsInstanceGroup
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: id
+          in: path
+          description: Instance Group ID, UUID assigned to this instance.
+          required: true
+          type: string
+          example: __ID__
+        - name: body
+          in: body
+          description: instance-group object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/instance-group"
+    delete:
+      tags:
+        - Network
+      summary: delete an existing instance-group
+      description: delete an existing instance-group
+      operationId: deleteNetworkInstanceGroupsInstanceGroup
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: id
+          in: path
+          description: Instance Group ID, UUID assigned to this instance.
+          required: true
+          type: string
+          example: __ID__
+        - name: resource-version
+          in: query
+          description: resource-version for concurrency
+          required: true
+          type: string
+  /network/instance-groups:
+    get:
+      tags:
+        - Network
+      summary: returns instance-groups
+      description: returns instance-groups
+      operationId: getNetworkInstanceGroups
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "200":
+          description: successful operation
+          schema:
+              $ref: "#/getDefinitions/instance-groups"
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+  /network/zones/zone/{zone-id}/relationship-list/relationship:
+    put:
+      tags:
+        - Network
+      summary: see node definition for valid relationships
+      operationId: createOrUpdateNetworkZonesZoneRelationshipListRelationship
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: zone-id
+          in: path
+          description: Code assigned by AIC to the zone
+          required: true
+          type: string
+          example: __ZONE-ID__
+        - name: body
+          in: body
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkZonesZone.json)
+          required: true
+          schema:
+            $ref: "#/definitions/relationship"
+    delete:
+      tags:
+        - Network
+      summary: delete an existing relationship
+      description: delete an existing relationship
+      operationId: deleteNetworkZonesZoneRelationshipListRelationship
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: zone-id
+          in: path
+          description: Code assigned by AIC to the zone
+          required: true
+          type: string
+          example: __ZONE-ID__
+  /network/zones/zone/{zone-id}:
+    get:
+      tags:
+        - Network
+      summary: returns zone
+      description: returns zone
+      operationId: getNetworkZonesZone
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "200":
+          description: successful operation
+          schema:
+              $ref: "#/getDefinitions/zone"
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: zone-id
+          in: path
+          description: Code assigned by AIC to the zone
+          required: true
+          type: string
+          example: __ZONE-ID__
+        - name: design-type
+          in: query
+          description: Design of zone [Medium/Large?]
+          required: false
+          type: string
+        - name: zone-context
+          in: query
+          description: Context of zone [production/test]
+          required: false
+          type: string
+    put:
+      tags:
+        - Network
+      summary: create or update an existing zone
+      description: |
+        Create or update an existing zone.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkZonesZone
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: zone-id
+          in: path
+          description: Code assigned by AIC to the zone
+          required: true
+          type: string
+          example: __ZONE-ID__
+        - name: body
+          in: body
+          description: zone object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkZonesZone.json)
+          required: true
+          schema:
+            $ref: "#/definitions/zone"
+    patch:
+      tags:
+        - Network
+      summary: update an existing zone
+      description: |
+        Update an existing zone
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkZonesZone
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: zone-id
+          in: path
+          description: Code assigned by AIC to the zone
+          required: true
+          type: string
+          example: __ZONE-ID__
+        - name: body
+          in: body
+          description: zone object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/zone"
+    delete:
+      tags:
+        - Network
+      summary: delete an existing zone
+      description: delete an existing zone
+      operationId: deleteNetworkZonesZone
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: zone-id
+          in: path
+          description: Code assigned by AIC to the zone
+          required: true
+          type: string
+          example: __ZONE-ID__
+        - name: resource-version
+          in: query
+          description: resource-version for concurrency
+          required: true
+          type: string
+  /network/zones:
+    get:
+      tags:
+        - Network
+      summary: returns zones
+      description: returns zones
+      operationId: getNetworkZones
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "200":
+          description: successful operation
+          schema:
+              $ref: "#/getDefinitions/zones"
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+  /network/configurations/configuration/{configuration-id}/relationship-list/relationship:
+    put:
+      tags:
+        - Network
+      summary: see node definition for valid relationships
+      operationId: createOrUpdateNetworkConfigurationsConfigurationRelationshipListRelationship
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: configuration-id
+          in: path
+          description: UUID assigned to configuration.
+          required: true
+          type: string
+          example: __CONFIGURATION-ID__
+        - name: body
+          in: body
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkConfigurationsConfiguration.json)
+          required: true
+          schema:
+            $ref: "#/definitions/relationship"
+    delete:
+      tags:
+        - Network
+      summary: delete an existing relationship
+      description: delete an existing relationship
+      operationId: deleteNetworkConfigurationsConfigurationRelationshipListRelationship
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: configuration-id
+          in: path
+          description: UUID assigned to configuration.
+          required: true
+          type: string
+          example: __CONFIGURATION-ID__
+  /network/configurations/configuration/{configuration-id}/metadata/metadatum/{metaname}:
+    get:
+      tags:
+        - Network
+      summary: returns metadatum
+      description: returns metadatum
+      operationId: getNetworkConfigurationsConfigurationMetadataMetadatum
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "200":
+          description: successful operation
+          schema:
+              $ref: "#/getDefinitions/metadatum"
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: configuration-id
+          in: path
+          description: UUID assigned to configuration.
+          required: true
+          type: string
+          example: __CONFIGURATION-ID__
+        - name: metaname
+          in: path
+          required: true
+          type: string
+          example: __METANAME__
+        - name: model-invariant-id
+          in: query
+          description: the ASDC model id for this resource or service model.
+          required: false
+          type: string
+        - name: model-version-id
+          in: query
+          description: the ASDC model version for this resource or service model.
+          required: false
+          type: string
+    put:
+      tags:
+        - Network
+      summary: create or update an existing metadatum
+      description: |
+        Create or update an existing metadatum.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkConfigurationsConfigurationMetadataMetadatum
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: configuration-id
+          in: path
+          description: UUID assigned to configuration.
+          required: true
+          type: string
+          example: __CONFIGURATION-ID__
+        - name: metaname
+          in: path
+          required: true
+          type: string
+          example: __METANAME__
+        - name: body
+          in: body
+          description: metadatum object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkConfigurationsConfigurationMetadataMetadatum.json)
+          required: true
+          schema:
+            $ref: "#/definitions/metadatum"
+    patch:
+      tags:
+        - Network
+      summary: update an existing metadatum
+      description: |
+        Update an existing metadatum
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkConfigurationsConfigurationMetadataMetadatum
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: configuration-id
+          in: path
+          description: UUID assigned to configuration.
+          required: true
+          type: string
+          example: __CONFIGURATION-ID__
+        - name: metaname
+          in: path
+          required: true
+          type: string
+          example: __METANAME__
+        - name: body
+          in: body
+          description: metadatum object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/metadatum"
+    delete:
+      tags:
+        - Network
+      summary: delete an existing metadatum
+      description: delete an existing metadatum
+      operationId: deleteNetworkConfigurationsConfigurationMetadataMetadatum
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: configuration-id
+          in: path
+          description: UUID assigned to configuration.
+          required: true
+          type: string
+          example: __CONFIGURATION-ID__
+        - name: metaname
+          in: path
+          required: true
+          type: string
+          example: __METANAME__
+        - name: resource-version
+          in: query
+          description: resource-version for concurrency
+          required: true
+          type: string
+  /network/configurations/configuration/{configuration-id}/metadata:
+    get:
+      tags:
+        - Network
+      summary: returns metadata
+      description: returns metadata
+      operationId: getNetworkConfigurationsConfigurationMetadata
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "200":
+          description: successful operation
+          schema:
+              $ref: "#/getDefinitions/metadata"
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: configuration-id
+          in: path
+          description: UUID assigned to configuration.
+          required: true
+          type: string
+          example: __CONFIGURATION-ID__
+        - name: model-invariant-id
+          in: query
+          description: the ASDC model id for this resource or service model.
+          required: false
+          type: string
+        - name: model-version-id
+          in: query
+          description: the ASDC model version for this resource or service model.
+          required: false
+          type: string
+  /network/configurations/configuration/{configuration-id}:
+    get:
+      tags:
+        - Network
+      summary: returns configuration
+      description: returns configuration
+      operationId: getNetworkConfigurationsConfiguration
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "200":
+          description: successful operation
+          schema:
+              $ref: "#/getDefinitions/configuration"
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: configuration-id
+          in: path
+          description: UUID assigned to configuration.
+          required: true
+          type: string
+          example: __CONFIGURATION-ID__
+        - name: model-invariant-id
+          in: query
+          description: the ASDC model id for this resource or service model.
+          required: false
+          type: string
+        - name: model-version-id
+          in: query
+          description: the ASDC model version for this resource or service model.
+          required: false
+          type: string
+    put:
+      tags:
+        - Network
+      summary: create or update an existing configuration
+      description: |
+        Create or update an existing configuration.
+        #
+        Note! This PUT method has a corresponding PATCH method that can be used to update just a few of the fields of an existing object, rather than a full object replacement.  An example can be found in the [PATCH section] below
+      operationId: createOrUpdateNetworkConfigurationsConfiguration
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: configuration-id
+          in: path
+          description: UUID assigned to configuration.
+          required: true
+          type: string
+          example: __CONFIGURATION-ID__
+        - name: body
+          in: body
+          description: configuration object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkConfigurationsConfiguration.json)
+          required: true
+          schema:
+            $ref: "#/definitions/configuration"
+    patch:
+      tags:
+        - Network
+      summary: update an existing configuration
+      description: |
+        Update an existing configuration
+        #
+        Note:  Endpoints that are not devoted to object relationships support both PUT and PATCH operations.
+        The PUT operation will entirely replace an existing object.
+        The PATCH operation sends a "description of changes" for an existing object.  The entire set of changes must be applied.  An error result means no change occurs.
+        #
+        Other differences between PUT and PATCH are:
+        #
+        - For PATCH, you can send any of the values shown in sample REQUEST body.  There are no required values.
+        - For PATCH, resource-id which is a required REQUEST body element for PUT, must not be sent.
+        - PATCH cannot be used to update relationship elements; there are dedicated PUT operations for this.
+      operationId: UpdateNetworkConfigurationsConfiguration
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: configuration-id
+          in: path
+          description: UUID assigned to configuration.
+          required: true
+          type: string
+          example: __CONFIGURATION-ID__
+        - name: body
+          in: body
+          description: configuration object that needs to be created or updated. 
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/configuration"
+    delete:
+      tags:
+        - Network
+      summary: delete an existing configuration
+      description: delete an existing configuration
+      operationId: deleteNetworkConfigurationsConfiguration
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: configuration-id
+          in: path
+          description: UUID assigned to configuration.
+          required: true
+          type: string
+          example: __CONFIGURATION-ID__
+        - name: resource-version
+          in: query
+          description: resource-version for concurrency
+          required: true
+          type: string
+  /network/configurations:
+    get:
+      tags:
+        - Network
+      summary: returns configurations
+      description: returns configurations
+      operationId: getNetworkConfigurations
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "200":
+          description: successful operation
+          schema:
+              $ref: "#/getDefinitions/configurations"
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+definitions:
+  aai-internal:
+    properties:
+      property-name:
+        type: string
+      property-value:
+        type: string
+  action:
+    properties:
+      action-type:
+        type: string
+      action-data:
+        type: array
+        items:          
+          $ref: "#/definitions/action-data"
+  action-data:
+    properties:
+      property-name:
+        type: string
+      property-value:
+        type: string
+  actions:
+    description: |
+      APIs that are more action related than REST (e.g., notify, update).
+    properties:
+      update:
+        type: object
+        $ref: "#/definitions/update"
+      notify:
+        type: object
+        $ref: "#/definitions/notify"
+  allotted-resource:
+    description: |
+      Represents a slice or partial piece of a resource that gets separately allotted
+      ###### Related Nodes
+      - TO allotted-resource( allotted-resource tosca.relationships.network.BindsTo allotted-resource, ONE2ONE)
+      - TO generic-vnf( allotted-resource org.onap.relationships.inventory.PartOf generic-vnf, MANY2MANY)
+      - TO instance-group( allotted-resource org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY)
+      - TO l3-network( allotted-resource org.onap.relationships.inventory.PartOf l3-network, MANY2MANY)
+      - TO l-interface( allotted-resource org.onap.relationships.inventory.Uses l-interface, ONE2MANY)
+      - TO network-policy( allotted-resource org.onap.relationships.inventory.Uses network-policy, ONE2ONE)
+      - TO vlan( allotted-resource org.onap.relationships.inventory.PartOf vlan, MANY2MANY)
+      - TO vpn-binding( allotted-resource org.onap.relationships.inventory.BelongsTo vpn-binding, MANY2MANY)
+      - TO service-instance( allotted-resource org.onap.relationships.inventory.BelongsTo service-instance, MANY2ONE)
+      - FROM tunnel-xconnect( tunnel-xconnect org.onap.relationships.inventory.BelongsTo allotted-resource, ONE2ONE)
+      - FROM configuration( configuration org.onap.relationships.inventory.Uses allotted-resource, ONE2ONE)
+      - FROM service-instance( service-instance org.onap.relationships.inventory.Uses allotted-resource, MANY2MANY)
+      - FROM allotted-resource( allotted-resource tosca.relationships.network.BindsTo allotted-resource, ONE2ONE)
+      - ALLOTTED-RESOURCE is DELETED when these are DELETED TUNNEL-XCONNECT
+    required:
+    - id
+    properties:
+      id:
+        type: string
+        description: Allotted Resource id UUID assigned to this instance.
+      description:
+        type: string
+        description: The descriptive information assigned to this allotted resource instance
+      selflink:
+        type: string
+        description: Link back to more information in the controller
+      model-invariant-id:
+        type: string
+        description: the ASDC model id for this resource or service model.
+      model-version-id:
+        type: string
+        description: the ASDC model version for this resource or service model.
+      persona-model-version:
+        type: string
+        description: the ASDC model version for this resource or service model.
+      resource-version:
+        type: string
+        description: Concurrency value
+      orchestration-status:
+        type: string
+        description: Orchestration status
+      operational-status:
+        type: string
+        description: Indicator for whether the resource is considered operational
+      type:
+        type: string
+        description: Generic description of the type of allotted resource.
+      role:
+        type: string
+        description: role in the network that this resource will be providing.
+      tunnel-xconnects:
+        type: array
+        items:
+          $ref: "#/definitions/tunnel-xconnect"
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+  allotted-resources:
+    description: |
+      This object is used to store slices of services being offered
+    properties:
+      allotted-resource:
+        type: array
+        items:          
+          $ref: "#/definitions/allotted-resource"
+  availability-zone:
+    description: |
+      Availability zone, a collection of compute hosts/pservers
+      ###### Related Nodes
+      - TO complex( availability-zone org.onap.relationships.inventory.LocatedIn complex, MANY2ONE)
+      - TO service-capability( availability-zone org.onap.relationships.inventory.AppliesTo service-capability, MANY2MANY)
+      - TO cloud-region( availability-zone org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE)
+      - FROM ctag-pool( ctag-pool org.onap.relationships.inventory.AppliesTo availability-zone, MANY2MANY)
+      - FROM dvs-switch( dvs-switch org.onap.relationships.inventory.AppliesTo availability-zone, MANY2MANY)
+      - FROM generic-vnf( generic-vnf org.onap.relationships.inventory.Uses availability-zone, MANY2MANY)
+      - FROM pserver( pserver org.onap.relationships.inventory.MemberOf availability-zone, MANY2ONE)
+      - FROM vce( vce org.onap.relationships.inventory.Uses availability-zone, MANY2MANY)
+      - AVAILABILITY-ZONE cannot be deleted if linked to CTAG-POOL,DVS-SWITCH,GENERIC-VNF,PSERVER,VCE
+    required:
+    - availability-zone-name
+    - hypervisor-type
+    properties:
+      availability-zone-name:
+        type: string
+        description: Name of the availability zone.  Unique across a cloud region
+      hypervisor-type:
+        type: string
+        description: Type of hypervisor.  Source of truth should define valid values.
+      operational-status:
+        type: string
+        description: State that indicates whether the availability zone should be used, etc.  Source of truth should define valid values.
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+  availability-zones:
+    description: |
+      Collection of availability zones
+    properties:
+      availability-zone:
+        type: array
+        items:          
+          $ref: "#/definitions/availability-zone"
+  az-and-dvs-switches:
+    properties:
+      dvs-switches:
+        type: object
+        $ref: "#/definitions/dvs-switches"
+      availability-zone:
+        type: object
+        $ref: "#/definitions/availability-zone"
+  business:
+    description: |
+      Namespace for business related constructs
+    properties:
+      connectors:
+        type: array
+        items:
+          $ref: "#/definitions/connector"
+      customers:
+        type: array
+        items:
+          $ref: "#/definitions/customer"
+      lines-of-business:
+        type: array
+        items:
+          $ref: "#/definitions/line-of-business"
+      owning-entities:
+        type: array
+        items:
+          $ref: "#/definitions/owning-entity"
+      platforms:
+        type: array
+        items:
+          $ref: "#/definitions/platform"
+      projects:
+        type: array
+        items:
+          $ref: "#/definitions/project"
+  class-of-service:
+    description: |
+      ###### Related Nodes
+      - TO site-pair( class-of-service org.onap.relationships.inventory.BelongsTo site-pair, MANY2ONE)
+    required:
+    - cos
+    properties:
+      cos:
+        type: string
+        description: unique identifier of probe
+      probe-id:
+        type: string
+        description: identifier of probe
+      probe-type:
+        type: string
+        description: type of probe
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+  classes-of-service:
+    description: |
+      class-of-service of probe
+    properties:
+      class-of-service:
+        type: array
+        items:          
+          $ref: "#/definitions/class-of-service"
+  cloud-infrastructure:
+    description: |
+      Namespace for cloud infrastructure.
+    properties:
+      complexes:
+        type: array
+        items:
+          $ref: "#/definitions/complex"
+      cloud-regions:
+        type: array
+        items:
+          $ref: "#/definitions/cloud-region"
+      network-profiles:
+        type: array
+        items:
+          $ref: "#/definitions/network-profile"
+      pservers:
+        type: array
+        items:
+          $ref: "#/definitions/pserver"
+      virtual-data-centers:
+        type: array
+        items:
+          $ref: "#/definitions/virtual-data-center"
+  cloud-region:
+    description: |
+      cloud-region designates an installation of a cloud cluster or region or instantiation.
+      ###### Related Nodes
+      - TO esr-system-info (CHILD of cloud-region, cloud-region has esr-system-info, One2Many)
+      - TO complex( cloud-region org.onap.relationships.inventory.LocatedIn complex, MANY2ONE)
+      - TO l3-network( cloud-region org.onap.relationships.inventory.Uses l3-network, MANY2MANY)
+      - TO zone( cloud-region org.onap.relationships.inventory.LocatedIn zone, MANY2ONE)
+      - FROM availability-zone( availability-zone org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE)
+      - FROM dvs-switch( dvs-switch org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE)
+      - FROM flavor( flavor org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE)
+      - FROM group-assignment( group-assignment org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE)
+      - FROM image( image org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE)
+      - FROM oam-network( oam-network org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE)
+      - FROM snapshot( snapshot org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE)
+      - FROM tenant( tenant org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE)
+      - FROM vip-ipv4-address-list( vip-ipv4-address-list org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE)
+      - FROM vip-ipv6-address-list( vip-ipv6-address-list org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE)
+      - FROM volume-group( volume-group org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE)
+      - FROM logical-link( logical-link org.onap.relationships.inventory.LocatedIn cloud-region, MANY2MANY)
+      - FROM pserver( pserver org.onap.relationships.inventory.LocatedIn cloud-region, MANY2ONE)
+      - CLOUD-REGION cannot be deleted if linked to DVS-SWITCH,FLAVOR,GROUP-ASSIGNMENT,IMAGE,OAM-NETWORK,SNAPSHOT,TENANT,VIP-IPV4-ADDRESS-LIST,VIP-IPV6-ADDRESS-LIST,VOLUME-GROUP
+      - CLOUD-REGION is DELETED when these are DELETED AVAILABILITY-ZONE
+      - CLOUD-REGION deletion means associated objects of these types are also DELETED:ESR-SYSTEM-INFO
+    required:
+    - cloud-owner
+    - cloud-region-id
+    - sriov-automation
+    properties:
+      cloud-owner:
+        type: string
+        description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
+      cloud-region-id:
+        type: string
+        description: Identifier used by the vendor for the region. Second part of composite key
+      cloud-type:
+        type: string
+        description: Type of the cloud (e.g., openstack)
+      owner-defined-type:
+        type: string
+        description: Cloud-owner defined type indicator (e.g., dcp, lcp)
+      cloud-region-version:
+        type: string
+        description: Software version employed at the site.  NOTE - THIS FIELD IS NOT KEPT UP TO DATE.
+      identity-url:
+        type: string
+        description: URL of the keystone identity service
+      cloud-zone:
+        type: string
+        description: Zone where the cloud is homed.  NOTE - THIS FIELD IS NOT CORRECTLY POPULATED.
+      complex-name:
+        type: string
+        description: complex name for cloud-region instance.  NOTE - THIS FIELD IS NOT CORRECTLY POPULATED.
+      sriov-automation:
+        type: boolean
+      cloud-extra-info:
+        type: string
+        description: ESR inputs extra information about the VIM or Cloud which will be decoded by MultiVIM.
+      cloud-epa-caps:
+        type: string
+        description: MultiVIM will discover and expose EPA capabilities.
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      volume-groups:
+        type: array
+        items:
+          $ref: "#/definitions/volume-group"
+      tenants:
+        type: array
+        items:
+          $ref: "#/definitions/tenant"
+      flavors:
+        type: array
+        items:
+          $ref: "#/definitions/flavor"
+      group-assignments:
+        type: array
+        items:
+          $ref: "#/definitions/group-assignment"
+      snapshots:
+        type: array
+        items:
+          $ref: "#/definitions/snapshot"
+      images:
+        type: array
+        items:
+          $ref: "#/definitions/image"
+      dvs-switches:
+        type: array
+        items:
+          $ref: "#/definitions/dvs-switch"
+      oam-networks:
+        type: array
+        items:
+          $ref: "#/definitions/oam-network"
+      availability-zones:
+        type: array
+        items:
+          $ref: "#/definitions/availability-zone"
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+      esr-system-info-list:
+        type: array
+        items:
+          $ref: "#/definitions/esr-system-info"
+      vip-ipv4-address-list:
+        type: array
+        items:          
+          $ref: "#/definitions/vip-ipv4-address-list"
+      vip-ipv6-address-list:
+        type: array
+        items:          
+          $ref: "#/definitions/vip-ipv6-address-list"
+  cloud-regions:
+    properties:
+      cloud-region:
+        type: array
+        items:          
+          $ref: "#/definitions/cloud-region"
+  complex:
+    description: |
+      Collection of physical locations that can house cloud-regions.
+      ###### Related Nodes
+      - TO l3-network( complex org.onap.relationships.inventory.Uses l3-network, MANY2MANY)
+      - FROM availability-zone( availability-zone org.onap.relationships.inventory.LocatedIn complex, MANY2ONE)
+      - FROM cloud-region( cloud-region org.onap.relationships.inventory.LocatedIn complex, MANY2ONE)
+      - FROM ctag-pool( ctag-pool org.onap.relationships.inventory.BelongsTo complex, MANY2ONE)
+      - FROM generic-vnf( generic-vnf org.onap.relationships.inventory.LocatedIn complex, MANY2MANY)
+      - FROM oam-network( oam-network org.onap.relationships.inventory.AppliesTo complex, MANY2MANY)
+      - FROM pnf( pnf org.onap.relationships.inventory.LocatedIn complex, MANY2ONE)
+      - FROM pserver( pserver org.onap.relationships.inventory.LocatedIn complex, MANY2ONE)
+      - FROM vce( vce org.onap.relationships.inventory.LocatedIn complex, MANY2MANY)
+      - FROM volume-group( volume-group org.onap.relationships.inventory.LocatedIn complex, MANY2ONE)
+      - FROM vpls-pe( vpls-pe org.onap.relationships.inventory.LocatedIn complex, MANY2ONE)
+      - FROM zone( zone org.onap.relationships.inventory.LocatedIn complex, MANY2ONE)
+      - COMPLEX cannot be deleted if linked to AVAILABILITY-ZONE,CLOUD-REGION,GENERIC-VNF,OAM-NETWORK,PNF,PSERVER,VCE,VOLUME-GROUP,VPLS-PE,ZONE
+      - COMPLEX is DELETED when these are DELETED CTAG-POOL
+    required:
+    - physical-location-id
+    - physical-location-type
+    - street1
+    - city
+    - postal-code
+    - country
+    - region
+    properties:
+      physical-location-id:
+        type: string
+        description: Unique identifier for physical location, e.g., CLLI
+      data-center-code:
+        type: string
+        description: Data center code which can be an alternate way to identify a complex
+      complex-name:
+        type: string
+        description: Gamma complex name for LCP instance.
+      identity-url:
+        type: string
+        description: URL of the keystone identity service
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      physical-location-type:
+        type: string
+        description: Type, e.g., central office, data center.
+      street1:
+        type: string
+      street2:
+        type: string
+      city:
+        type: string
+      state:
+        type: string
+      postal-code:
+        type: string
+      country:
+        type: string
+      region:
+        type: string
+      latitude:
+        type: string
+      longitude:
+        type: string
+      elevation:
+        type: string
+      lata:
+        type: string
+      ctag-pools:
+        type: array
+        items:
+          $ref: "#/definitions/ctag-pool"
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+  complexes:
+    description: |
+      Collection of physical locations that can house cloud-regions.
+    properties:
+      complex:
+        type: array
+        items:          
+          $ref: "#/definitions/complex"
+  configuration:
+    description: |
+      Port Mirror Configuration.
+      ###### Related Nodes
+      - TO allotted-resource( configuration org.onap.relationships.inventory.Uses allotted-resource, ONE2ONE)
+      - TO logical-link( configuration org.onap.relationships.inventory.Uses logical-link, ONE2MANY)
+      - FROM metadatum( metadatum org.onap.relationships.inventory.BelongsTo configuration, MANY2ONE)
+      - FROM generic-vnf( generic-vnf org.onap.relationships.inventory.Uses configuration, ONE2MANY)
+      - FROM service-instance( service-instance org.onap.relationships.inventory.Uses configuration, ONE2MANY)
+      - CONFIGURATION is DELETED when these are DELETED METADATUM
+      - CONFIGURATION deletion means associated objects of these types are also DELETED:ALLOTTED-RESOURCE,LOGICAL-LINK
+    required:
+    - configuration-id
+    - configuration-type
+    - configuration-sub-type
+    - orchestration-status
+    - operational-status
+    - configuration-selflink
+    - model-customization-id
+    properties:
+      configuration-id:
+        type: string
+        description: UUID assigned to configuration.
+      management-option:
+        type: string
+        description: Indicates the entity that will manage this feature. Could be an organization or the name of the application as well.
+      configuration-name:
+        type: string
+        description: Name of the configuration.
+      configuration-type:
+        type: string
+        description: port-mirroring-configuration.
+      configuration-sub-type:
+        type: string
+        description: vprobe, pprobe.
+      model-invariant-id:
+        type: string
+        description: the ASDC model id for this resource or service model.
+      model-version-id:
+        type: string
+        description: the ASDC model version for this resource or service model.
+      orchestration-status:
+        type: string
+        description: Orchestration status of the configuration.
+      operational-status:
+        type: string
+        description: Indicator for whether the resource is considered operational.
+      configuration-selflink:
+        type: string
+        description: URL to endpoint where AAI can get more details from SDN-GC.
+      model-customization-id:
+        type: string
+        description: id of  the configuration used to customize the resource
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+      metadata:
+        type: array
+        items:
+          $ref: "#/definitions/metadatum"
+  configurations:
+    description: |
+      Collection of configurations
+    properties:
+      configuration:
+        type: array
+        items:          
+          $ref: "#/definitions/configuration"
+  connector:
+    description: |
+      Collection of resource instances used to connect a variety of disparate inventory widgets
+      ###### Related Nodes
+      - TO virtual-data-center( connector org.onap.relationships.inventory.LocatedIn virtual-data-center, MANY2MANY)
+      - FROM metadatum( metadatum org.onap.relationships.inventory.BelongsTo connector, MANY2ONE)
+      - FROM service-instance( service-instance org.onap.relationships.inventory.Uses connector, MANY2MANY)
+      - CONNECTOR is DELETED when these are DELETED METADATUM
+    required:
+    - resource-instance-id
+    properties:
+      resource-instance-id:
+        type: string
+        description: Unique id of resource instance.
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      model-invariant-id:
+        type: string
+        description: the ASDC model id for this resource or service model.
+      model-version-id:
+        type: string
+        description: the ASDC model version for this resource or service model.
+      persona-model-version:
+        type: string
+        description: the ASDC model version for this resource or service model.
+      widget-model-id:
+        type: string
+        description: the ASDC data dictionary widget model. This maps directly to the A&AI widget.
+      widget-model-version:
+        type: string
+        description: the ASDC data dictionary version of the widget model.This maps directly to the A&AI version of the widget.
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+      metadata:
+        type: array
+        items:
+          $ref: "#/definitions/metadatum"
+  connectors:
+    description: |
+      Collection of resource instances used to connect a variety of disparate inventory widgets
+    properties:
+      connector:
+        type: array
+        items:          
+          $ref: "#/definitions/connector"
+  constrained-element-set:
+    description: |
+      This is how we would capture constraints defining allowed sets of elements.
+      ###### Related Nodes
+      - TO model-constraint( constrained-element-set org.onap.relationships.inventory.BelongsTo model-constraint, MANY2ONE)
+      - TO model-element( constrained-element-set org.onap.relationships.inventory.BelongsTo model-element, MANY2ONE)
+      - FROM element-choice-set( element-choice-set org.onap.relationships.inventory.BelongsTo constrained-element-set, MANY2ONE)
+      - CONSTRAINED-ELEMENT-SET is DELETED when these are DELETED ELEMENT-CHOICE-SET
+    required:
+    - constrained-element-set-uuid
+    - constraint-type
+    - check-type
+    properties:
+      constrained-element-set-uuid:
+        type: string
+      constraint-type:
+        type: string
+      check-type:
+        type: string
+      resource-version:
+        type: string
+      element-choice-sets:
+        type: array
+        items:
+          $ref: "#/definitions/element-choice-set"
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+  constrained-element-sets:
+    properties:
+      constrained-element-set:
+        type: array
+        items:          
+          $ref: "#/definitions/constrained-element-set"
+  ctag-assignment:
+    description: |
+      ###### Related Nodes
+      - TO l3-network( ctag-assignment org.onap.relationships.inventory.BelongsTo l3-network, MANY2ONE)
+      - FROM service-instance( service-instance org.onap.relationships.inventory.Uses ctag-assignment, ONE2MANY)
+    required:
+    - vlan-id-inner
+    properties:
+      vlan-id-inner:
+        type: integer
+        format: int64
+        description: id.
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+  ctag-assignments:
+    properties:
+      ctag-assignment:
+        type: array
+        items:          
+          $ref: "#/definitions/ctag-assignment"
+  ctag-pool:
+    description: |
+      A collection of C tags (vlan tags) grouped for a specific purpose.
+      ###### Related Nodes
+      - TO complex( ctag-pool org.onap.relationships.inventory.BelongsTo complex, MANY2ONE)
+      - TO availability-zone( ctag-pool org.onap.relationships.inventory.AppliesTo availability-zone, MANY2MANY)
+      - FROM generic-vnf( generic-vnf org.onap.relationships.inventory.Uses ctag-pool, MANY2MANY)
+      - FROM vpls-pe( vpls-pe org.onap.relationships.inventory.Uses ctag-pool, MANY2MANY)
+    required:
+    - target-pe
+    - availability-zone-name
+    - ctag-pool-purpose
+    properties:
+      target-pe:
+        type: string
+        description: The Target provider edge router
+      availability-zone-name:
+        type: string
+        description: Name of the availability zone
+      ctag-pool-purpose:
+        type: string
+        description: Describes what the intended purpose of this pool is.
+      ctag-values:
+        type: string
+        description: Comma separated list of ctags
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+  ctag-pools:
+    properties:
+      ctag-pool:
+        type: array
+        items:          
+          $ref: "#/definitions/ctag-pool"
+  customer:
+    description: |
+      customer identifiers to provide linkage back to BSS information.
+      ###### Related Nodes
+      - FROM service-subscription( service-subscription org.onap.relationships.inventory.BelongsTo customer, MANY2ONE)
+      - CUSTOMER is DELETED when these are DELETED SERVICE-SUBSCRIPTION
+    required:
+    - global-customer-id
+    - subscriber-name
+    - subscriber-type
+    properties:
+      global-customer-id:
+        type: string
+        description: Global customer id used across ECOMP to uniquely identify customer.
+      subscriber-name:
+        type: string
+        description: Subscriber name, an alternate way to retrieve a customer.
+      subscriber-type:
+        type: string
+        description: Subscriber type, a way to provide VID with only the INFRA customers.
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      service-subscriptions:
+        type: array
+        items:
+          $ref: "#/definitions/service-subscription"
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+  customers:
+    description: |
+      Collection of customer identifiers to provide linkage back to BSS information.
+    properties:
+      customer:
+        type: array
+        items:          
+          $ref: "#/definitions/customer"
+  cvlan-tag-entry:
+    required:
+    - cvlan-tag
+    properties:
+      cvlan-tag:
+        type: integer
+        format: int64
+        description: See mis-na-virtualization-platform.yang
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+  cvlan-tags:
+    properties:
+      cvlan-tag-entry:
+        type: array
+        items:          
+          $ref: "#/definitions/cvlan-tag-entry"
+  dvs-switch:
+    description: |
+      Digital virtual switch metadata, used by SDN-C to configure VCEs.  A&AI needs to receive this data from the PO deployment team and administer it using the provisioningTool.sh into A&AI. 
+      ###### Related Nodes
+      - TO cloud-region( dvs-switch org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE)
+      - TO availability-zone( dvs-switch org.onap.relationships.inventory.AppliesTo availability-zone, MANY2MANY)
+    required:
+    - switch-name
+    - vcenter-url
+    properties:
+      switch-name:
+        type: string
+        description: DVS switch name
+      vcenter-url:
+        type: string
+        description: URL used to reach the vcenter
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+  dvs-switches:
+    description: |
+      Collection of digital virtual switch metadata used for vmWare VCEs and GenericVnfs.
+    properties:
+      dvs-switch:
+        type: array
+        items:          
+          $ref: "#/definitions/dvs-switch"
+  edge-prop-names:
+    description: |
+      Internal map to define the properties of an edge and interpret the map EdgeRules
+    properties:
+      edgeLabel:
+        type: string
+      direction:
+        type: string
+      multiplicityRule:
+        type: string
+      contains-other-v:
+        type: string
+      delete-other-v:
+        type: string
+      SVC-INFRA:
+        type: string
+      prevent-delete:
+        type: string
+  edge-tag-query-request:
+    properties:
+      edge-tag:
+        type: string
+      result-detail:
+        type: string
+      start-node-type:
+        type: string
+      start-node-filter:
+        type: array
+        items:          
+          $ref: "#/definitions/start-node-filter"
+      include-node-filter:
+        type: array
+        items:          
+          $ref: "#/definitions/include-node-filter"
+      secondary-filter:
+        type: array
+        items:          
+          $ref: "#/definitions/secondary-filter"
+  edge-tag-query-result:
+    properties:
+      tagged-inventory-item-list:
+        type: array
+        items:          
+          $ref: "#/definitions/tagged-inventory-item-list"
+  element-choice-set:
+    description: |
+      This is how we would capture constraints defining allowed sets of elements.
+      ###### Related Nodes
+      - TO constrained-element-set( element-choice-set org.onap.relationships.inventory.BelongsTo constrained-element-set, MANY2ONE)
+      - FROM model-element( model-element org.onap.relationships.inventory.BelongsTo element-choice-set, MANY2ONE)
+      - ELEMENT-CHOICE-SET is DELETED when these are DELETED MODEL-ELEMENT
+    required:
+    - element-choice-set-uuid
+    - element-choice-set-name
+    properties:
+      element-choice-set-uuid:
+        type: string
+      element-choice-set-name:
+        type: string
+      cardinality:
+        type: string
+      resource-version:
+        type: string
+      model-elements:
+        type: array
+        items:
+          $ref: "#/definitions/model-element"
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+  element-choice-sets:
+    properties:
+      element-choice-set:
+        type: array
+        items:          
+          $ref: "#/definitions/element-choice-set"
+  entitlement:
+    description: |
+      Metadata for entitlement group.
+      ###### Related Nodes
+      - TO generic-vnf( entitlement org.onap.relationships.inventory.BelongsTo generic-vnf, MANY2ONE)
+      - TO vce( entitlement org.onap.relationships.inventory.BelongsTo vce, MANY2ONE)
+    required:
+    - group-uuid
+    - resource-uuid
+    properties:
+      group-uuid:
+        type: string
+        description: Unique ID for the entitlement group the resource comes from, should be uuid.
+      resource-uuid:
+        type: string
+        description: Unique ID of an entitlement resource. 
+      resource-version:
+        type: string
+        description: Concurrency value
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+  entitlements:
+    description: |
+      Entitlements, keyed by group-uuid and resource-uuid, related to license management
+    properties:
+      entitlement:
+        type: array
+        items:          
+          $ref: "#/definitions/entitlement"
+  esr-ems:
+    description: |
+      Persist EMS address information used by EMS driver.
+      ###### Related Nodes
+      - TO esr-system-info (CHILD of esr-ems, esr-ems has esr-system-info, One2Many)
+      - ESR-EMS deletion means associated objects of these types are also DELETED:ESR-SYSTEM-INFO
+    required:
+    - ems-id
+    properties:
+      ems-id:
+        type: string
+        description: Unique ID of EMS.
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      esr-system-info-list:
+        type: object
+        $ref: "#/definitions/esr-system-info-list"
+      relationship-list:
+        type: object
+        $ref: "#/definitions/relationship-list"
+  esr-ems-list:
+    properties:
+      esr-ems:
+        type: array
+        items:          
+          $ref: "#/definitions/esr-ems"
+  esr-system-info:
+    description: |
+      Persist common address information of external systems.
+      ###### Related Nodes
+      - FROM esr-ems (PARENT of esr-system-info, esr-ems has esr-system-info)
+      - FROM esr-vnfm (PARENT of esr-system-info, esr-vnfm has esr-system-info)
+      - FROM esr-thirdparty-sdnc (PARENT of esr-system-info, esr-thirdparty-sdnc has esr-system-info)
+      - FROM cloud-region (PARENT of esr-system-info, cloud-region has esr-system-info)
+    required:
+    - esr-system-info-id
+    - user-name
+    - password
+    - system-type
+    properties:
+      esr-system-info-id:
+        type: string
+        description: Unique ID of esr system info.
+      system-name:
+        type: string
+        description: name of external system.
+      type:
+        type: string
+        description: type of external systems.
+      vendor:
+        type: string
+        description: vendor of external systems.
+      version:
+        type: string
+        description: version of external systems.
+      service-url:
+        type: string
+        description: url used to access external systems.
+      user-name:
+        type: string
+        description: username used to access external systems.
+      password:
+        type: string
+        description: password used to access external systems.
+      system-type:
+        type: string
+        description: it could be vim/vnfm/thirdparty-sdnc/ems-resource/ems-performance/ems-alarm.
+      protocol:
+        type: string
+        description: protocol of third party SDNC, for example netconf/snmp.
+      ssl-cacert:
+        type: string
+        description: ca file content if enabled ssl on auth-url.
+      ssl-insecure:
+        type: boolean
+        description: Whether to verify VIM's certificate.
+      ip-address:
+        type: string
+        description: service IP of ftp server.
+      port:
+        type: string
+        description: service port of ftp server.
+      cloud-domain:
+        type: string
+        description: domain info for authentication.
+      default-tenant:
+        type: string
+        description: default tenant of VIM.
+      passive:
+        type: boolean
+        description: ftp passive mode or not.
+      remote-path:
+        type: string
+        description: resource or performance data file path.
+      system-status:
+        type: string
+        description: the status of external system.
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+  esr-system-info-list:
+    description: |
+      Collection of persistent block-level external system auth info.
+    properties:
+      esr-system-info:
+        type: array
+        items:          
+          $ref: "#/definitions/esr-system-info"
+  esr-thirdparty-sdnc:
+    description: |
+      Persist SDNC address information used by ONAP SDNC.
+      ###### Related Nodes
+      - TO esr-system-info (CHILD of esr-thirdparty-sdnc, esr-thirdparty-sdnc has esr-system-info, One2One)
+      - TO pnf( esr-thirdparty-sdnc has pnf, One2Many)
+      - ESR-THIRDPARTY-SDNC deletion means associated objects of these types are also DELETED:ESR-SYSTEM-INFO
+    required:
+    - thirdparty-sdnc-id
+    properties:
+      thirdparty-sdnc-id:
+        type: string
+        description: Unique ID of SDNC.
+      location:
+        type: string
+        description: used for DC type to indicate the location of SDNC, such as Core or Edge.
+      product-name:
+        type: string
+        description: password used to access SDNC server.
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      esr-system-info-list:
+        type: object
+        $ref: "#/definitions/esr-system-info-list"
+      relationship-list:
+        type: object
+        $ref: "#/definitions/relationship-list"
+  esr-thirdparty-sdnc-list:
+    properties:
+      esr-thirdparty-sdnc:
+        type: array
+        items:          
+          $ref: "#/definitions/esr-thirdparty-sdnc"
+  esr-vnfm:
+    description: |
+      Persist VNFM address information used by VF-C.
+      ###### Related Nodes
+      - TO esr-system-info (CHILD of esr-vnfm, esr-vnfm has esr-system-info, One2One)
+      - ESR-VNFM deletion means associated objects of these types are also DELETED:ESR-SYSTEM-INFO
+    required:
+    - vnfm-id
+    properties:
+      vnfm-id:
+        type: string
+        description: Unique ID of VNFM.
+      vim-id:
+        type: string
+        description: indecate the VIM to deploy VNF.
+      certificate-url:
+        type: string
+        description: certificate url of VNFM.
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      esr-system-info-list:
+        type: object
+        $ref: "#/definitions/esr-system-info-list"
+      relationship-list:
+        type: object
+        $ref: "#/definitions/relationship-list"
+  esr-vnfm-list:
+    properties:
+      esr-vnfm:
+        type: array
+        items:          
+          $ref: "#/definitions/esr-vnfm"
+  evc:
+    description: |
+      evc object is an optional child object of the Configuration object.
+      ###### Related Nodes
+      - TO configuration( evc org.onap.relationships.inventory.BelongsTo configuration, ONE2ONE)
+    required:
+    - evc-id
+    properties:
+      evc-id:
+        type: string
+        description: Unique/key field for the evc object
+      forwarding-path-topology:
+        type: string
+        description: Point-to-Point, Multi-Point
+      cir-value:
+        type: string
+        description: Commited Information Rate
+      cir-units:
+        type: string
+        description: CIR units
+      connection-diversity-group-id:
+        type: string
+        description: Diversity Group ID
+      service-hours:
+        type: string
+        description: formerly Performance Group
+      esp-evc-circuit-id:
+        type: string
+        description: EVC Circuit ID of ESP EVC
+      esp-evc-cir-value:
+        type: string
+        description: Committed Information Rate (For ESP)
+      esp-evc-cir-units:
+        type: string
+        description: CIR units (For ESP)
+      esp-itu-code:
+        type: string
+        description: Identifies ESP
+      collector-pop-clli:
+        type: string
+        description: Collector POP CLLI (from the hostname of the access pnf)
+      inter-connect-type-ingress:
+        type: string
+        description: Interconnect type on ingress side of EVC.
+      tagmode-access-ingress:
+        type: string
+        description: tagode for collector side of EVC
+      tagmode-access-egress:
+        type: string
+        description: tagMode for network side of EVC
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency. Must be empty on create, valid on update and delete.
+  evcs:
+    properties:
+      evc:
+        type: array
+        items:          
+          $ref: "#/definitions/evc"
+  external-system:
+    description: |
+      Namespace for external system.
+    properties:
+      esr-ems-list:
+        type: object
+        $ref: "#/definitions/esr-ems-list"
+      esr-vnfm-list:
+        type: object
+        $ref: "#/definitions/esr-vnfm-list"
+      esr-thirdparty-sdnc-list:
+        type: object
+        $ref: "#/definitions/esr-thirdparty-sdnc-list"
+  extra-properties:
+    description: |
+      Extra properties for inventory item for response list
+    properties:
+      extra-property:
+        type: array
+        items:          
+          $ref: "#/definitions/extra-property"
+  extra-property:
+    properties:
+      property-name:
+        type: string
+      property-value:
+        type: string
+  flavor:
+    description: |
+      Openstack flavor.
+      ###### Related Nodes
+      - TO cloud-region( flavor org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE)
+      - FROM vserver( vserver org.onap.relationships.inventory.Uses flavor, MANY2ONE)
+      - FLAVOR cannot be deleted if linked to VSERVER
+    required:
+    - flavor-id
+    - flavor-name
+    - flavor-selflink
+    properties:
+      flavor-id:
+        type: string
+        description: Flavor id, expected to be unique across cloud-region.
+      flavor-name:
+        type: string
+        description: Flavor name
+      flavor-vcpus:
+        type: integer
+        format: int32
+        description: Number of CPUs
+      flavor-ram:
+        type: integer
+        format: int32
+        description: Amount of memory
+      flavor-disk:
+        type: integer
+        format: int32
+        description: Disk space
+      flavor-ephemeral:
+        type: integer
+        format: int32
+        description: Amount of ephemeral disk space
+      flavor-swap:
+        type: string
+        description: amount of swap space allocation
+      flavor-is-public:
+        type: boolean
+        description: whether flavor is available to all users or private to the tenant it was created in.
+      flavor-selflink:
+        type: string
+        description: URL to endpoint where AAI can get more details
+      flavor-disabled:
+        type: boolean
+        description: Boolean as to whether this flavor is no longer enabled
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+  flavors:
+    description: |
+      Collection of openstack flavors.
+    properties:
+      flavor:
+        type: array
+        items:          
+          $ref: "#/definitions/flavor"
+  forwarder:
+    description: |
+      Entity describing a sequenced segment of forwarding path
+      ###### Related Nodes
+      - TO forwarding-path( forwarder org.onap.relationships.inventory.BelongsTo forwarding-path, MANY2ONE)
+      - TO l-interface( forwarder org.onap.relationships.inventory.ForwardsTo l-interface, MANY2ONE)
+      - TO configuration( forwarder org.onap.relationships.inventory.Uses configuration, ONE2ONE)
+      - TO lag-interface( forwarder org.onap.relationships.inventory.ForwardsTo lag-interface, MANY2ONE)
+      - TO p-interface( forwarder org.onap.relationships.inventory.ForwardsTo p-interface, MANY2ONE)
+      - FORWARDER deletion means associated objects of these types are also DELETED:CONFIGURATION
+    required:
+    - sequence
+    properties:
+      sequence:
+        type: integer
+        format: int32
+        description: Unique ID of this segmentation
+      forwarder-role:
+        type: string
+        description: ingress, intermediate, egress
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency. Must be empty on create, valid on update and delete.
+  forwarder-evc:
+    description: |
+      forwarder object is an optional child object of the Configuration object.
+      ###### Related Nodes
+      - TO configuration( forwarder-evc org.onap.relationships.inventory.BelongsTo configuration, ONE2ONE)
+    required:
+    - forwarder-evc-id
+    properties:
+      forwarder-evc-id:
+        type: string
+        description: Key for forwarder-evc object
+      circuit-id:
+        type: string
+        description: Circuit ID from customer/ESP/ingress end of EVC, or reference to beater circuit on gateway/network/egress end of EVC
+      ivlan:
+        type: string
+        description: Internal VLAN.
+      svlan:
+        type: string
+        description: SVLAN value for ingress of egress forwarder.
+      cvlan:
+        type: string
+        description: CVLAN value for ingress of egress forwarder.
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency. Must be empty on create, valid on update and delete.
+  forwarder-evcs:
+    properties:
+      forwarder-evc:
+        type: array
+        items:          
+          $ref: "#/definitions/forwarder-evc"
+  forwarders:
+    properties:
+      forwarder:
+        type: array
+        items:          
+          $ref: "#/definitions/forwarder"
+  forwarding-path:
+    description: |
+      Entity that describes the sequenced forwarding path between interfaces of services or resources
+      ###### Related Nodes
+      - TO service-instance( forwarding-path org.onap.relationships.inventory.AppliesTo service-instance, MANY2ONE)
+      - TO configuration( forwarding-path org.onap.relationships.inventory.Uses configuration, ONE2ONE)
+      - FROM forwarder( forwarder org.onap.relationships.inventory.BelongsTo forwarding-path, MANY2ONE)
+      - FORWARDING-PATH is DELETED when these are DELETED FORWARDER
+      - FORWARDING-PATH deletion means associated objects of these types are also DELETED:CONFIGURATION
+    required:
+    - forwarding-path-id
+    - forwarding-path-name
+    properties:
+      forwarding-path-id:
+        type: string
+        description: Unique ID of this FP
+      forwarding-path-name:
+        type: string
+        description: Name of the FP
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency. Must be empty on create, valid on update and delete.
+      selflink:
+        type: string
+        description: the self link for this FP
+      forwarders:
+        type: array
+        items:
+          $ref: "#/definitions/forwarder"
+  forwarding-paths:
+    properties:
+      forwarding-path:
+        type: array
+        items:          
+          $ref: "#/definitions/forwarding-path"
+  generic-vnf:
+    description: |
+      General purpose VNF
+      ###### Related Nodes
+      - TO availability-zone( generic-vnf org.onap.relationships.inventory.Uses availability-zone, MANY2MANY)
+      - TO complex( generic-vnf org.onap.relationships.inventory.LocatedIn complex, MANY2MANY)
+      - TO configuration( generic-vnf org.onap.relationships.inventory.Uses configuration, ONE2MANY)
+      - TO ctag-pool( generic-vnf org.onap.relationships.inventory.Uses ctag-pool, MANY2MANY)
+      - TO instance-group( generic-vnf org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY)
+      - TO ipsec-configuration( generic-vnf org.onap.relationships.inventory.Uses ipsec-configuration, MANY2ONE)
+      - TO l3-network( generic-vnf org.onap.relationships.inventory.Uses l3-network, MANY2MANY)
+      - TO license-key-resource( generic-vnf org.onap.relationships.inventory.Uses license-key-resource, MANY2MANY)
+      - TO pnf( generic-vnf tosca.relationships.HostedOn pnf, MANY2MANY)
+      - TO pserver( generic-vnf tosca.relationships.HostedOn pserver, MANY2MANY)
+      - TO vnf-image( generic-vnf org.onap.relationships.inventory.Uses vnf-image, MANY2ONE)
+      - TO volume-group( generic-vnf org.onap.relationships.inventory.DependsOn volume-group, ONE2MANY)
+      - TO vserver( generic-vnf tosca.relationships.HostedOn vserver, ONE2MANY)
+      - TO virtual-data-center( generic-vnf org.onap.relationships.inventory.LocatedIn virtual-data-center, MANY2MANY)
+      - FROM allotted-resource( allotted-resource org.onap.relationships.inventory.PartOf generic-vnf, MANY2MANY)
+      - FROM entitlement( entitlement org.onap.relationships.inventory.BelongsTo generic-vnf, MANY2ONE)
+      - FROM vnfc( vnfc org.onap.relationships.inventory.BelongsTo generic-vnf, MANY2ONE)
+      - FROM lag-interface( lag-interface org.onap.relationships.inventory.BelongsTo generic-vnf, MANY2ONE)
+      - FROM license( license org.onap.relationships.inventory.BelongsTo generic-vnf, MANY2ONE)
+      - FROM l-interface( l-interface org.onap.relationships.inventory.BelongsTo generic-vnf, MANY2ONE)
+      - FROM network-profile( network-profile org.onap.relationships.inventory.AppliesTo generic-vnf, MANY2MANY)
+      - FROM service-instance( service-instance org.onap.relationships.inventory.ComposedOf generic-vnf, ONE2MANY)
+      - FROM site-pair-set( site-pair-set org.onap.relationships.inventory.AppliesTo generic-vnf, MANY2MANY)
+      - FROM vf-module( vf-module org.onap.relationships.inventory.BelongsTo generic-vnf, MANY2ONE)
+      - FROM line-of-business( line-of-business org.onap.relationships.inventory.Uses generic-vnf, MANY2MANY)
+      - FROM logical-link( logical-link org.onap.relationships.inventory.BridgedTo generic-vnf, MANY2MANY)
+      - FROM platform( platform org.onap.relationships.inventory.Uses generic-vnf, MANY2MANY)
+      - GENERIC-VNF is DELETED when these are DELETED ENTITLEMENT,VNFC,LAG-INTERFACE,LICENSE,L-INTERFACE,VF-MODULE
+      - GENERIC-VNF deletion means associated objects of these types are also DELETED:CONFIGURATION
+    required:
+    - vnf-id
+    - vnf-instance-id
+    - vnf-name
+    - vnf-type
+    - vnf-package-name
+    - vnf-discriptor-name
+    - job-id
+    - in-maint
+    - is-closed-loop-disabled
+    properties:
+      vnf-id:
+        type: string
+        description: Unique id of VNF.  This is unique across the graph.
+      vnf-instance-id:
+        type: string
+        description: vnf instance id.
+      vnf-name:
+        type: string
+        description: Name of VNF.
+      vnf-name2:
+        type: string
+        description: Alternate name of VNF.
+      vnf-type:
+        type: string
+        description: String capturing type of vnf, that was intended to identify the ASDC resource.  This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures.
+      service-id:
+        type: string
+        description: Unique identifier of service, does not necessarily map to ASDC service models.  SOON TO BE DEPRECATED
+      regional-resource-zone:
+        type: string
+        description: Regional way of organizing pservers, source of truth should define values
+      prov-status:
+        type: string
+        description: Trigger for operational monitoring of this resource by Service Assurance systems.
+      operational-status:
+        type: string
+        description: Indicator for whether the resource is considered operational.  Valid values are in-service-path and out-of-service-path.
+      license-key:
+        type: string
+        description: OBSOLETE -  do not use
+      equipment-role:
+        type: string
+        description: Client should send valid enumerated value
+      orchestration-status:
+        type: string
+        description: Orchestration status of this VNF, used by MSO.
+      vnf-package-name:
+        type: string
+      vnf-discriptor-name:
+        type: string
+        description: vnf discriptor name
+      job-id:
+        type: string
+        description: job id corresponding to vnf
+      heat-stack-id:
+        type: string
+        description: Heat stack id corresponding to this instance, managed by MSO
+      mso-catalog-key:
+        type: string
+        description: Corresponds to the SDN-C catalog id used to configure this VCE
+      management-option:
+        type: string
+        description: identifier of managed by ATT or customer
+      ipv4-oam-address:
+        type: string
+        description: Address tail-f uses to configure generic-vnf, also used for troubleshooting and is IP used for traps generated by generic-vnf.
+      ipv4-loopback0-address:
+        type: string
+        description: v4 Loopback0 address
+      nm-lan-v6-address:
+        type: string
+        description: v6 Loopback address
+      management-v6-address:
+        type: string
+        description: v6 management address
+      vcpu:
+        type: integer
+        format: int64
+        description: number of vcpus ordered for this instance of VNF, used for VNFs with no vservers/flavors, to be used only by uCPE
+      vcpu-units:
+        type: string
+        description: units associated with vcpu, used for VNFs with no vservers/flavors, to be used only by uCPE
+      vmemory:
+        type: integer
+        format: int64
+        description: number of GB of memory ordered for this instance of VNF, used for VNFs with no vservers/flavors, to be used only by uCPE
+      vmemory-units:
+        type: string
+        description: units associated with vmemory, used for VNFs with no vservers/flavors, to be used only by uCPE
+      vdisk:
+        type: integer
+        format: int64
+        description: number of vdisks ordered for this instance of VNF, used for VNFs with no vservers/flavors, to be used only uCPE
+      vdisk-units:
+        type: string
+        description: units associated with vdisk, used for VNFs with no vservers/flavors, to be used only by uCPE
+      nshd:
+        type: integer
+        format: int64
+        description: number of associated SHD in vnf.
+      nvm:
+        type: integer
+        format: int64
+        description: number of vms in vnf.
+      nnet:
+        type: integer
+        format: int64
+        description: number of network in vnf.
+      in-maint:
+        type: boolean
+      is-closed-loop-disabled:
+        type: boolean
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      summary-status:
+        type: string
+        description: details regarding the generic-vnf operation, PLEASE DISCONTINUE USE OF THIS FIELD.
+      encrypted-access-flag:
+        type: boolean
+        description: indicates whether generic-vnf access uses SSH
+      entitlement-assignment-group-uuid:
+        type: string
+        description: UUID of the Entitlement group used for licensing VNFs, OBSOLETE -  See child relationships.
+      entitlement-resource-uuid:
+        type: string
+        description: UUID of the specific entitlement resource.  OBSOLETE -  See child relationships.
+      license-assignment-group-uuid:
+        type: string
+        description: UUID of the license assignment group.  OBSOLETE -  See child relationships.
+      license-key-uuid:
+        type: string
+        description: UUID of the actual license resource.  OBSOLETE -  See child relationships.
+      model-invariant-id:
+        type: string
+        description: the ASDC model id for this resource or service model.
+      model-version-id:
+        type: string
+        description: the ASDC model version for this resource or service model.
+      persona-model-version:
+        type: string
+        description: the ASDC model version for this resource or service model.
+      model-customization-id:
+        type: string
+        description: captures the id of all the configuration used to customize the resource for the service.
+      widget-model-id:
+        type: string
+        description: the ASDC data dictionary widget model. This maps directly to the A&AI widget.
+      widget-model-version:
+        type: string
+        description: the ASDC data dictionary version of the widget model.This maps directly to the A&AI version of the widget.
+      as-number:
+        type: string
+        description: as-number of the VNF
+      regional-resource-subzone:
+        type: string
+        description: represents sub zone of the rr plane
+      nf-type:
+        type: string
+        description: Generic description of the type of NF
+      nf-function:
+        type: string
+        description: English description of Network function that the specific VNF deployment is providing
+      nf-role:
+        type: string
+        description: role in the network that this model will be providing
+      nf-naming-code:
+        type: string
+        description: string assigned to this model used for naming purposes
+      selflink:
+        type: string
+        description: Path to the controller object.
+      ipv4-oam-gateway-address:
+        type: string
+        description: Gateway address
+      ipv4-oam-gateway-address-prefix-length:
+        type: integer
+        format: int32
+        description: Prefix length for oam-address
+      vlan-id-outer:
+        type: integer
+        format: int64
+        description: Temporary location for S-TAG to get to VCE
+      nm-profile-name:
+        type: string
+        description: Network Management profile of this VNF
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+      l-interfaces:
+        type: array
+        items:
+          $ref: "#/definitions/l-interface"
+      lag-interfaces:
+        type: array
+        items:
+          $ref: "#/definitions/lag-interface"
+      vf-modules:
+        type: array
+        items:
+          $ref: "#/definitions/vf-module"
+      licenses:
+        type: array
+        items:
+          $ref: "#/definitions/license"
+      entitlements:
+        type: array
+        items:
+          $ref: "#/definitions/entitlement"
+  generic-vnfs:
+    description: |
+      Collection of VNFs
+    properties:
+      generic-vnf:
+        type: array
+        items:          
+          $ref: "#/definitions/generic-vnf"
+  group-assignment:
+    description: |
+      Openstack group-assignment used to store exclusivity groups (EG).
+      ###### Related Nodes
+      - TO cloud-region( group-assignment org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE)
+      - FROM pserver( pserver org.onap.relationships.inventory.MemberOf group-assignment, MANY2ONE)
+      - FROM tenant( tenant org.onap.relationships.inventory.MemberOf group-assignment, MANY2MANY)
+    required:
+    - group-id
+    - group-type
+    - group-name
+    properties:
+      group-id:
+        type: string
+        description: Group id, expected to be unique across cloud-region.
+      group-type:
+        type: string
+        description: Group type - the type of group this instance refers to
+      group-name:
+        type: string
+        description: Group name - name assigned to the group
+      group-description:
+        type: string
+        description: Group description - description of the group
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+  group-assignments:
+    description: |
+      Collection of openstack group assignments
+    properties:
+      group-assignment:
+        type: array
+        items:          
+          $ref: "#/definitions/group-assignment"
+  host-route:
+    description: |
+      ###### Related Nodes
+      - TO subnet( host-route org.onap.relationships.inventory.BelongsTo subnet, MANY2ONE)
+    required:
+    - host-route-id
+    - route-prefix
+    - next-hop
+    properties:
+      host-route-id:
+        type: string
+        description: host-route id
+      route-prefix:
+        type: string
+        description: subnet prefix
+      next-hop:
+        type: string
+        description: Could be ip-address, hostname, or service-instance
+      next-hop-type:
+        type: string
+        description: Should be ip-address, hostname, or service-instance to match next-hop
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+  host-routes:
+    properties:
+      host-route:
+        type: array
+        items:          
+          $ref: "#/definitions/host-route"
+  hpa-capabilities:
+    description: |
+      Collection of HPA Capabilities
+    properties:
+      hpa-capability:
+        type: array
+        items:          
+          $ref: "#/definitions/hpa-capability"
+  hpa-capability:
+    description: |
+      Represents a HPA capability
+      ###### Related Nodes
+      - TO flavor( hpa-capability org.onap.relationships.inventory.BelongsTo flavor, MANY2ONE)
+      - TO cloud-region( hpa-capability org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE)
+      - FROM hpa-feature-attributes( hpa-feature-attributes org.onap.relationships.inventory.BelongsTo hpa-capability, MANY2ONE)
+      - HPA-CAPABILITY is DELETED when these are DELETED HPA-FEATURE-ATTRIBUTES
+    required:
+    - hpa-capability-id
+    - hpa-feature
+    properties:
+      hpa-capability-id:
+        type: string
+        description: UUID to uniquely identify a HPA capability
+      hpa-feature:
+        type: string
+        description: Name of the HPACapability
+      hpa-version:
+        type: string
+        description: HPA schema version
+      hpa-hw-arch:
+        type: string
+        description: Hardware architecture
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+      hpa-feature-attributes:
+        type: array
+        items:          
+          $ref: "#/definitions/hpa-feature-attributes"
+  hpa-feature-attributes:
+    description: |
+      HPA Capability Feature attributes
+      ###### Related Nodes
+      - TO hpa-capability( hpa-feature-attributes org.onap.relationships.inventory.BelongsTo hpa-capability, MANY2ONE)
+    properties:
+      hpa-attr-key:
+        type: string
+        description: name of the specific HPA attribute
+      hpa-attr-value:
+        type: string
+        description: JSON string specifying the value, unit and type of the specific HPA attribute
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+  image:
+    description: |
+      Openstack image.
+      ###### Related Nodes
+      - TO cloud-region( image org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE)
+      - FROM metadatum( metadatum org.onap.relationships.inventory.BelongsTo image, MANY2ONE)
+      - FROM vserver( vserver org.onap.relationships.inventory.Uses image, MANY2ONE)
+      - IMAGE cannot be deleted if linked to VSERVER
+      - IMAGE is DELETED when these are DELETED METADATUM
+    required:
+    - image-id
+    - image-name
+    - image-os-distro
+    - image-os-version
+    - image-selflink
+    properties:
+      image-id:
+        type: string
+        description: Image id, expected to be unique across cloud region
+      image-name:
+        type: string
+        description: Image name
+      image-architecture:
+        type: string
+        description: Operating system architecture.
+      image-os-distro:
+        type: string
+        description: The common name of the operating system distribution in lowercase
+      image-os-version:
+        type: string
+        description: The operating system version as specified by the distributor.
+      application:
+        type: string
+        description: The application that the image instantiates.
+      application-vendor:
+        type: string
+        description: The vendor of the application.
+      application-version:
+        type: string
+        description: The version of the application.
+      image-selflink:
+        type: string
+        description: URL to endpoint where AAI can get more details
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+      metadata:
+        type: array
+        items:
+          $ref: "#/definitions/metadatum"
+  images:
+    description: |
+      Collectio of Openstack images.
+    properties:
+      image:
+        type: array
+        items:          
+          $ref: "#/definitions/image"
+  include-node-filter:
+    properties:
+      include-node-type:
+        type: string
+  instance-filter:
+    description: |
+      InstanceFilter for performing a named-query or model query
+  instance-filters:
+    description: |
+      InstanceFilters for performing a named-query or model query
+    properties:
+      instance-filter:
+        type: array
+        items:          
+          $ref: "#/definitions/instance-filter"
+  instance-group:
+    description: |
+      General mechanism for grouping instances
+      ###### Related Nodes
+      - TO model( instance-group org.onap.relationships.inventory.Targets model, MANY2MANY)
+      - FROM allotted-resource( allotted-resource org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY)
+      - FROM generic-vnf( generic-vnf org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY)
+      - FROM l3-interface-ipv4-address-list( l3-interface-ipv4-address-list org.onap.relationships.inventory.network.MemberOf instance-group, MANY2MANY)
+      - FROM l3-interface-ipv6-address-list( l3-interface-ipv6-address-list org.onap.relationships.inventory.network.MemberOf instance-group, MANY2MANY)
+      - FROM l3-network( l3-network org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY)
+      - FROM l-interface( l-interface org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY)
+      - FROM pnf( pnf org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY)
+      - FROM service-instance( service-instance org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY)
+      - FROM vip-ipv4-address-list( vip-ipv4-address-list org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY)
+      - FROM vip-ipv6-address-list( vip-ipv6-address-list org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY)
+      - FROM vnfc( vnfc org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY)
+    required:
+    - instance-group-role
+    - model-invariant-id
+    - model-version-id
+    - id
+    - description
+    - type
+    properties:
+      instance-group-role:
+        type: string
+        description: role of the instance group.
+      model-invariant-id:
+        type: string
+        description: ASDC model id for this resource or service model.
+      model-version-id:
+        type: string
+        description: ASDC model version uid for this resource model.
+      id:
+        type: string
+        description: Instance Group ID, UUID assigned to this instance.
+      description:
+        type: string
+        description: Descriptive text to help identify the usage of this instance-group
+      type:
+        type: string
+        description: Only valid value today is lower case ha for high availability
+      sub-type:
+        type: string
+        description: Valid values for ha type are [geo-activeactive, geo-activestandby, local-activeactive, local-activestandby]
+      resource-version:
+        type: string
+        description: Concurrency value
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+  instance-groups:
+    description: |
+      Collection of openstack route table references
+    properties:
+      instance-group:
+        type: array
+        items:          
+          $ref: "#/definitions/instance-group"
+  inventory:
+    properties:
+      search:
+        type: object
+        $ref: "#/definitions/search"
+      actions:
+        type: object
+        $ref: "#/definitions/actions"
+      cloud-infrastructure:
+        type: object
+        $ref: "#/definitions/cloud-infrastructure"
+      external-system:
+        type: object
+        $ref: "#/definitions/external-system"
+      business:
+        type: object
+        $ref: "#/definitions/business"
+      service-design-and-creation:
+        type: object
+        $ref: "#/definitions/service-design-and-creation"
+      network:
+        type: object
+        $ref: "#/definitions/network"
+      aai-internal:
+        type: object
+        $ref: "#/definitions/aai-internal"
+      nodes:
+        type: array
+        items:
+          $ref: "#/definitions/aai-internal"
+  inventory-item:
+    properties:
+      inventory-item-type:
+        type: string
+      inventory-item-link:
+        type: string
+      inventory-item-data:
+        type: array
+        items:          
+          $ref: "#/definitions/inventory-item-data"
+      tagged-inventory-item-list:
+        type: array
+        items:          
+          $ref: "#/definitions/tagged-inventory-item-list"
+  inventory-item-data:
+    properties:
+      property-name:
+        type: string
+      property-value:
+        type: string
+  inventory-response-item:
+    description: |
+      Inventory item for response list
+    properties:
+      model-name:
+        type: string
+      extra-properties:
+        type: object
+        $ref: "#/definitions/extra-properties"
+      inventory-response-items:
+        type: object
+        $ref: "#/definitions/inventory-response-items"
+  inventory-response-items:
+    description: |
+      Container for inventory items in response list
+    properties:
+      inventory-response-item:
+        type: array
+        items:          
+          $ref: "#/definitions/inventory-response-item"
+  ipsec-configuration:
+    description: |
+      IPSec configuration node will contain various configuration data for the NMTE VNF. This node will have an edge to the generic-vnf (vnf type = TE). Starting 1607, this data will be populated by SDN-C
+      ###### Related Nodes
+      - FROM generic-vnf( generic-vnf org.onap.relationships.inventory.Uses ipsec-configuration, MANY2ONE)
+      - FROM vig-server( vig-server org.onap.relationships.inventory.BelongsTo ipsec-configuration, MANY2ONE)
+      - IPSEC-CONFIGURATION is DELETED when these are DELETED VIG-SERVER
+    required:
+    - ipsec-configuration-id
+    properties:
+      ipsec-configuration-id:
+        type: string
+        description: UUID of this configuration
+      requested-vig-address-type:
+        type: string
+        description: Indicate the type of VIG server like AVPN, INTERNET, BOTH
+      requested-encryption-strength:
+        type: string
+        description: Encryption values like 3des-cbc, des-cbc, aes-128-cbc, aes-192-cbc, aes-265-cbc
+      requested-dmz-type:
+        type: string
+        description: ATT can offer a shared DMZ or a DMZ specific to a customer
+      shared-dmz-network-address:
+        type: string
+        description: Network address of shared DMZ
+      requested-customer-name:
+        type: string
+        description: If the DMZ is a custom DMZ, this field will indicate the customer information
+      ike-version:
+        type: string
+        description: can be 1 or 2
+      ikev1-authentication:
+        type: string
+        description: Contains values like md5, sha1, sha256, sha384
+      ikev1-encryption:
+        type: string
+        description: Encyption values like 3des-cbc, des-cbc, aes-128-cbc,?aes-192-cbc, aes-265-cbc
+      ikev1-dh-group:
+        type: string
+        description: Diffie-Hellman group like DH-GROUP2, DH-GROUP5, DH-GROUP14
+      ikev1-am-group-id:
+        type: string
+        description: Group name defined in VIG for clients using aggressive mode
+      ikev1-am-password:
+        type: string
+        description: pre-shared key for the above group name 
+      ikev1-sa-lifetime:
+        type: string
+        description: Lifetime for IKEv1 SA
+      ipsec-authentication:
+        type: string
+        description: md5, sha1, sha256, sha384
+      ipsec-encryption:
+        type: string
+        description: 3des-cbc, des-cbc, aes-128-cbc,?aes-192-cbc, aes-265-cbc
+      ipsec-sa-lifetime:
+        type: string
+        description: Life time for IPSec SA
+      ipsec-pfs:
+        type: string
+        description: enable PFS or not
+      xauth-userid:
+        type: string
+        description: user ID for xAuth, sm-user,ucpeHostName,nmteHostName
+      xauth-user-password:
+        type: string
+        description: Encrypted using the Juniper $9$ algorithm
+      dpd-interval:
+        type: string
+        description: The time between DPD probe
+      dpd-frequency:
+        type: string
+        description: Maximum number of DPD before claiming the tunnel is down
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+      vig-servers:
+        type: array
+        items:
+          $ref: "#/definitions/vig-server"
+  ipsec-configurations:
+    properties:
+      ipsec-configuration:
+        type: array
+        items:          
+          $ref: "#/definitions/ipsec-configuration"
+  key-data:
+    properties:
+      key-name:
+        type: string
+      key-value:
+        type: string
+  l-interface:
+    description: |
+      Logical interfaces, e.g., a vnic.
+      ###### Related Nodes
+      - TO generic-vnf( l-interface org.onap.relationships.inventory.BelongsTo generic-vnf, MANY2ONE)
+      - TO lag-interface( l-interface org.onap.relationships.inventory.BelongsTo lag-interface, MANY2ONE)
+      - TO instance-group( l-interface org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY)
+      - TO l-interface( l-interface org.onap.relationships.inventory.BelongsTo l-interface, MANY2ONE)
+      - TO logical-link( l-interface tosca.relationships.network.LinksTo logical-link, MANY2MANY)
+      - TO newvce( l-interface org.onap.relationships.inventory.BelongsTo newvce, MANY2ONE)
+      - TO p-interface( l-interface tosca.relationships.network.BindsTo p-interface, MANY2ONE)
+      - TO vserver( l-interface tosca.relationships.network.BindsTo vserver, MANY2ONE)
+      - FROM allotted-resource( allotted-resource org.onap.relationships.inventory.Uses l-interface, ONE2MANY)
+      - FROM l3-interface-ipv4-address-list( l3-interface-ipv4-address-list org.onap.relationships.inventory.BelongsTo l-interface, MANY2ONE)
+      - FROM l3-interface-ipv6-address-list( l3-interface-ipv6-address-list org.onap.relationships.inventory.BelongsTo l-interface, MANY2ONE)
+      - FROM sriov-vf( sriov-vf org.onap.relationships.inventory.BelongsTo l-interface, ONE2ONE)
+      - FROM vlan( vlan tosca.relationships.network.LinksTo l-interface, MANY2ONE)
+      - FROM l-interface( l-interface org.onap.relationships.inventory.BelongsTo l-interface, MANY2ONE)
+      - L-INTERFACE is DELETED when these are DELETED L3-INTERFACE-IPV4-ADDRESS-LIST,L3-INTERFACE-IPV6-ADDRESS-LIST,SRIOV-VF,VLAN
+      - L-INTERFACE deletion means associated objects of these types are also DELETED:LOGICAL-LINK
+    required:
+    - interface-name
+    - is-port-mirrored
+    - in-maint
+    - is-ip-unnumbered
+    properties:
+      interface-name:
+        type: string
+        description: Name given to the interface
+      interface-role:
+        type: string
+        description: E.g., CUSTOMER, UPLINK, etc.
+      v6-wan-link-ip:
+        type: string
+        description: Questionably placed - v6 ip addr of this interface (is in vr-lan-interface from Mary B.
+      selflink:
+        type: string
+        description: URL to endpoint where AAI can get more details
+      interface-id:
+        type: string
+        description: ID of interface
+      macaddr:
+        type: string
+        description: MAC address for the interface
+      network-name:
+        type: string
+        description: Name of the network
+      management-option:
+        type: string
+        description: Whether A&AI should be managing this interface of not. Could have value like CUSTOMER
+      interface-description:
+        type: string
+        description: Human friendly text regarding this interface.
+      is-port-mirrored:
+        type: boolean
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      in-maint:
+        type: boolean
+      prov-status:
+        type: string
+        description: Prov Status of the logical interface. Valid values [PREPROV/NVTPROV/PROV].
+      is-ip-unnumbered:
+        type: boolean
+      allowed-address-pairs:
+        type: string
+        description: Freeform field for storing an ip address, list of ip addresses or a subnet block.
+      vlans:
+        type: array
+        items:
+          $ref: "#/definitions/vlan"
+      sriov-vfs:
+        type: array
+        items:
+          $ref: "#/definitions/sriov-vf"
+      l-interfaces:
+        type: array
+        items:
+          $ref: "#/definitions/l-interface"
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+      l3-interface-ipv4-address-list:
+        type: array
+        items:          
+          $ref: "#/definitions/l3-interface-ipv4-address-list"
+      l3-interface-ipv6-address-list:
+        type: array
+        items:          
+          $ref: "#/definitions/l3-interface-ipv6-address-list"
+  l-interfaces:
+    description: |
+      Collection of logical interfaces.
+    properties:
+      l-interface:
+        type: array
+        items:          
+          $ref: "#/definitions/l-interface"
+  l3-interface-ipv4-address-list:
+    description: |
+      IPv4 Address Range
+      ###### Related Nodes
+      - TO instance-group( l3-interface-ipv4-address-list org.onap.relationships.inventory.network.MemberOf instance-group, MANY2MANY)
+      - TO l3-network( l3-interface-ipv4-address-list org.onap.relationships.inventory.network.MemberOf l3-network, MANY2MANY)
+      - TO subnet( l3-interface-ipv4-address-list org.onap.relationships.inventory.network.MemberOf subnet, MANY2MANY)
+      - TO l-interface( l3-interface-ipv4-address-list org.onap.relationships.inventory.BelongsTo l-interface, MANY2ONE)
+      - TO vlan( l3-interface-ipv4-address-list org.onap.relationships.inventory.BelongsTo vlan, MANY2ONE)
+      - TO vnfc( l3-interface-ipv4-address-list org.onap.relationships.inventory.BelongsTo vnfc, MANY2ONE)
+    required:
+    - l3-interface-ipv4-address
+    properties:
+      l3-interface-ipv4-address:
+        type: string
+        description: IP address
+      l3-interface-ipv4-prefix-length:
+        type: integer
+        format: int64
+        description: Prefix length, 32 for single address
+      vlan-id-inner:
+        type: integer
+        format: int64
+        description: Inner VLAN tag
+      vlan-id-outer:
+        type: integer
+        format: int64
+        description: Outer VLAN tag
+      is-floating:
+        type: boolean
+        description: Indicator of fixed or floating address
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      neutron-network-id:
+        type: string
+        description: Neutron network id of the interface that address belongs to
+      neutron-subnet-id:
+        type: string
+        description: Neutron id of subnet that address belongs to
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+  l3-interface-ipv6-address-list:
+    description: |
+      IPv6 Address Range
+      ###### Related Nodes
+      - TO instance-group( l3-interface-ipv6-address-list org.onap.relationships.inventory.network.MemberOf instance-group, MANY2MANY)
+      - TO l3-network( l3-interface-ipv6-address-list org.onap.relationships.inventory.network.MemberOf l3-network, MANY2MANY)
+      - TO subnet( l3-interface-ipv6-address-list org.onap.relationships.inventory.network.MemberOf subnet, MANY2MANY)
+      - TO l-interface( l3-interface-ipv6-address-list org.onap.relationships.inventory.BelongsTo l-interface, MANY2ONE)
+      - TO vlan( l3-interface-ipv6-address-list org.onap.relationships.inventory.BelongsTo vlan, MANY2ONE)
+      - TO vnfc( l3-interface-ipv6-address-list org.onap.relationships.inventory.BelongsTo vnfc, MANY2ONE)
+    required:
+    - l3-interface-ipv6-address
+    properties:
+      l3-interface-ipv6-address:
+        type: string
+        description: IP address
+      l3-interface-ipv6-prefix-length:
+        type: integer
+        format: int64
+        description: Prefix length, 128 for single address
+      vlan-id-inner:
+        type: integer
+        format: int64
+        description: Inner VLAN tag
+      vlan-id-outer:
+        type: integer
+        format: int64
+        description: Outer VLAN tag
+      is-floating:
+        type: boolean
+        description: Indicator of fixed or floating address
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      neutron-network-id:
+        type: string
+        description: Neutron network id of the interface that address belongs to
+      neutron-subnet-id:
+        type: string
+        description: Neutron id of subnet that address belongs to
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+  l3-network:
+    description: |
+      Generic network definition
+      ###### Related Nodes
+      - TO instance-group( l3-network org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY)
+      - TO network-policy( l3-network org.onap.relationships.inventory.Uses network-policy, MANY2MANY)
+      - TO route-table-reference( l3-network org.onap.relationships.inventory.Uses route-table-reference, MANY2MANY)
+      - TO vpn-binding( l3-network org.onap.relationships.inventory.Uses vpn-binding, MANY2MANY)
+      - FROM allotted-resource( allotted-resource org.onap.relationships.inventory.PartOf l3-network, MANY2MANY)
+      - FROM cloud-region( cloud-region org.onap.relationships.inventory.Uses l3-network, MANY2MANY)
+      - FROM complex( complex org.onap.relationships.inventory.Uses l3-network, MANY2MANY)
+      - FROM generic-vnf( generic-vnf org.onap.relationships.inventory.Uses l3-network, MANY2MANY)
+      - FROM l3-interface-ipv4-address-list( l3-interface-ipv4-address-list org.onap.relationships.inventory.network.MemberOf l3-network, MANY2MANY)
+      - FROM l3-interface-ipv6-address-list( l3-interface-ipv6-address-list org.onap.relationships.inventory.network.MemberOf l3-network, MANY2MANY)
+      - FROM ctag-assignment( ctag-assignment org.onap.relationships.inventory.BelongsTo l3-network, MANY2ONE)
+      - FROM segmentation-assignment( segmentation-assignment org.onap.relationships.inventory.BelongsTo l3-network, MANY2ONE)
+      - FROM service-instance( service-instance org.onap.relationships.inventory.ComposedOf l3-network, ONE2MANY)
+      - FROM subnet( subnet org.onap.relationships.inventory.BelongsTo l3-network, MANY2ONE)
+      - FROM tenant( tenant org.onap.relationships.inventory.Uses l3-network, MANY2MANY)
+      - FROM vf-module( vf-module org.onap.relationships.inventory.DependsOn l3-network, MANY2MANY)
+      - L3-NETWORK is DELETED when these are DELETED CTAG-ASSIGNMENT,SEGMENTATION-ASSIGNMENT,SUBNET
+    required:
+    - network-id
+    - network-name
+    - is-bound-to-vpn
+    - is-provider-network
+    - is-shared-network
+    - is-external-network
+    properties:
+      network-id:
+        type: string
+        description: Network ID, should be uuid. Unique across A&AI.
+      network-name:
+        type: string
+        description: Name of the network, governed by some naming convention..
+      network-type:
+        type: string
+        description: Type of the network - who defines these values?
+      network-role:
+        type: string
+        description: Role the network plans - who defines these values?
+      network-technology:
+        type: string
+        description: Network technology - who defines these values?
+      neutron-network-id:
+        type: string
+        description: Neutron network id of this Interface
+      is-bound-to-vpn:
+        type: boolean
+      service-id:
+        type: string
+        description: Unique identifier of service from ASDC.  Does not strictly map to ASDC services.  SOON TO BE DEPRECATED
+      network-role-instance:
+        type: integer
+        format: int64
+        description: network role instance
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      orchestration-status:
+        type: string
+        description: Orchestration status of this VNF, mastered by MSO
+      heat-stack-id:
+        type: string
+        description: Heat stack id corresponding to this instance, managed by MSO
+      mso-catalog-key:
+        type: string
+        description: Corresponds to the SDN-C catalog id used to configure this VCE
+      contrail-network-fqdn:
+        type: string
+        description: Contrail FQDN for the network
+      model-invariant-id:
+        type: string
+        description: the ASDC model id for this resource or service model.
+      model-version-id:
+        type: string
+        description: the ASDC model version for this resource or service model.
+      persona-model-version:
+        type: string
+        description: the ASDC model version for this resource or service model.
+      model-customization-id:
+        type: string
+        description: captures the id of all the configuration used to customize the resource for the service.
+      widget-model-id:
+        type: string
+        description: the ASDC data dictionary widget model. This maps directly to the A&AI widget.
+      widget-model-version:
+        type: string
+        description: the ASDC data dictionary version of the widget model.This maps directly to the A&AI version of the widget.
+      physical-network-name:
+        type: string
+        description: Name associated with the physical network.
+      is-provider-network:
+        type: boolean
+      is-shared-network:
+        type: boolean
+      is-external-network:
+        type: boolean
+      selflink:
+        type: string
+        description: Path to the controller object.
+      operational-status:
+        type: string
+        description: Indicator for whether the resource is considered operational.
+      subnets:
+        type: array
+        items:
+          $ref: "#/definitions/subnet"
+      ctag-assignments:
+        type: array
+        items:
+          $ref: "#/definitions/ctag-assignment"
+      segmentation-assignments:
+        type: array
+        items:
+          $ref: "#/definitions/segmentation-assignment"
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+        description: Relates to tenant (or is it a child of tenant), complex, service, vpn-binding
+  l3-networks:
+    properties:
+      l3-network:
+        type: array
+        items:          
+          $ref: "#/definitions/l3-network"
+  lag-interface:
+    description: |
+      Link aggregate interface
+      ###### Related Nodes
+      - TO generic-vnf( lag-interface org.onap.relationships.inventory.BelongsTo generic-vnf, MANY2ONE)
+      - TO lag-link( lag-interface tosca.relationships.network.LinksTo lag-link, MANY2MANY)
+      - TO logical-link( lag-interface org.onap.relationships.inventory.Uses logical-link, MANY2MANY)
+      - TO p-interface( lag-interface org.onap.relationships.inventory.Uses p-interface, MANY2MANY)
+      - TO pnf( lag-interface tosca.relationships.network.BindsTo pnf, MANY2ONE)
+      - TO pserver( lag-interface tosca.relationships.network.BindsTo pserver, MANY2ONE)
+      - TO vpls-pe( lag-interface tosca.relationships.network.BindsTo vpls-pe, MANY2ONE)
+      - FROM l-interface( l-interface org.onap.relationships.inventory.BelongsTo lag-interface, MANY2ONE)
+      - LAG-INTERFACE is DELETED when these are DELETED L-INTERFACE
+      - LAG-INTERFACE deletion means associated objects of these types are also DELETED:LAG-LINK,LOGICAL-LINK
+    required:
+    - interface-name
+    - in-maint
+    properties:
+      interface-name:
+        type: string
+        description: Name that identifies the link aggregate interface
+      interface-description:
+        type: string
+        description: Human friendly text regarding this interface.
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      speed-value:
+        type: string
+        description: Captures the numeric part of the speed
+      speed-units:
+        type: string
+        description: Captures the units corresponding to the speed
+      interface-id:
+        type: string
+        description: ID of interface
+      interface-role:
+        type: string
+        description: Role assigned to this Interface, should use values as defined in ECOMP Yang models.
+      prov-status:
+        type: string
+        description: Trigger for operational monitoring of this resource by Service Assurance systems.
+      in-maint:
+        type: boolean
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+      l-interfaces:
+        type: array
+        items:
+          $ref: "#/definitions/l-interface"
+  lag-interfaces:
+    description: |
+      Collection of link aggregate interfaces.
+    properties:
+      lag-interface:
+        type: array
+        items:          
+          $ref: "#/definitions/lag-interface"
+  lag-link:
+    description: |
+      LAG links can connect lag-interfaces
+      ###### Related Nodes
+      - FROM lag-interface( lag-interface tosca.relationships.network.LinksTo lag-link, MANY2MANY)
+      - FROM logical-link( logical-link org.onap.relationships.inventory.Uses lag-link, MANY2MANY)
+    required:
+    - link-name
+    properties:
+      link-name:
+        type: string
+        description: Alphabetical concatenation of lag-interface names
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+  lag-links:
+    description: |
+      Collection of link aggregation connections
+    properties:
+      lag-link:
+        type: array
+        items:          
+          $ref: "#/definitions/lag-link"
+  license:
+    description: |
+      Metadata for license group.
+      ###### Related Nodes
+      - TO generic-vnf( license org.onap.relationships.inventory.BelongsTo generic-vnf, MANY2ONE)
+      - TO vce( license org.onap.relationships.inventory.BelongsTo vce, MANY2ONE)
+    required:
+    - group-uuid
+    - resource-uuid
+    properties:
+      group-uuid:
+        type: string
+        description: Unique ID for the license group the resource belongs to, should be uuid.
+      resource-uuid:
+        type: string
+        description: Unique ID of a license resource. 
+      resource-version:
+        type: string
+        description: Concurrency value
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+  licenses:
+    description: |
+      Licenses to be allocated across resources, keyed by group-uuid and resource-uuid, related to license management
+    properties:
+      license:
+        type: array
+        items:          
+          $ref: "#/definitions/license"
+  line-of-business:
+    description: |
+      describes a line-of-business
+      ###### Related Nodes
+      - TO generic-vnf( line-of-business org.onap.relationships.inventory.Uses generic-vnf, MANY2MANY)
+    required:
+    - line-of-business-name
+    properties:
+      line-of-business-name:
+        type: string
+        description: Name of the line-of-business (product)
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+  lines-of-business:
+    description: |
+      Collection of lines-of-business
+    properties:
+      line-of-business:
+        type: array
+        items:          
+          $ref: "#/definitions/line-of-business"
+  logical-link:
+    description: |
+      Logical links generally connect l-interfaces but are used to express logical connectivity between two points
+      ###### Related Nodes
+      - TO cloud-region( logical-link org.onap.relationships.inventory.LocatedIn cloud-region, MANY2MANY)
+      - TO generic-vnf( logical-link org.onap.relationships.inventory.BridgedTo generic-vnf, MANY2MANY)
+      - TO lag-link( logical-link org.onap.relationships.inventory.Uses lag-link, MANY2MANY)
+      - TO logical-link( logical-link org.onap.relationships.inventory.Uses logical-link, MANY2MANY)
+      - TO pnf( logical-link org.onap.relationships.inventory.BridgedTo pnf, MANY2MANY)
+      - TO pserver( logical-link org.onap.relationships.inventory.BridgedTo pserver, MANY2MANY)
+      - TO vpn-binding( logical-link org.onap.relationships.inventory.Uses vpn-binding, MANY2MANY)
+      - TO virtual-data-center( logical-link org.onap.relationships.inventory.LocatedIn virtual-data-center, MANY2MANY)
+      - FROM configuration( configuration org.onap.relationships.inventory.Uses logical-link, ONE2MANY)
+      - FROM lag-interface( lag-interface org.onap.relationships.inventory.Uses logical-link, MANY2MANY)
+      - FROM l-interface( l-interface tosca.relationships.network.LinksTo logical-link, MANY2MANY)
+      - FROM p-interface( p-interface tosca.relationships.network.LinksTo logical-link, MANY2ONE)
+      - FROM service-instance( service-instance org.onap.relationships.inventory.Uses logical-link, ONE2MANY)
+      - FROM vlan( vlan org.onap.relationships.inventory.Uses logical-link, MANY2MANY)
+      - FROM logical-link( logical-link org.onap.relationships.inventory.Uses logical-link, MANY2MANY)
+    required:
+    - link-name
+    - in-maint
+    - link-type
+    properties:
+      link-name:
+        type: string
+        description: e.g., evc-name, or vnf-nameA_interface-nameA_vnf-nameZ_interface-nameZ
+      in-maint:
+        type: boolean
+      link-type:
+        type: string
+        description: Type of logical link, e.g., evc
+      speed-value:
+        type: string
+        description: Captures the numeric part of the speed
+      speed-units:
+        type: string
+        description: Captures the units corresponding to the speed
+      ip-version:
+        type: string
+        description: v4, v6, or ds for dual stack
+      routing-protocol:
+        type: string
+        description: For example, static or BGP
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      model-invariant-id:
+        type: string
+        description: the ASDC model id for this resource or service model.
+      model-version-id:
+        type: string
+        description: the ASDC model version for this resource or service model.
+      persona-model-version:
+        type: string
+        description: the ASDC model version for this resource or service model.
+      widget-model-id:
+        type: string
+        description: the ASDC data dictionary widget model. This maps directly to the A&AI widget.
+      widget-model-version:
+        type: string
+        description: the ASDC data dictionary version of the widget model.This maps directly to the A&AI version of the widget.
+      operational-status:
+        type: string
+        description: Indication of operational status of the logical link.
+      prov-status:
+        type: string
+        description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems.
+      link-role:
+        type: string
+        description: Indication of the network use of the logical link.
+      link-name2:
+        type: string
+        description: Alias or alternate name (CLCI or D1 name).
+      link-id:
+        type: string
+        description: UUID of the logical-link, SDNC generates this.
+      circuit-id:
+        type: string
+        description: Circuit id
+      purpose:
+        type: string
+        description: Reason for this entity, role it is playing
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+  logical-links:
+    description: |
+      Collection of logical connections
+    properties:
+      logical-link:
+        type: array
+        items:          
+          $ref: "#/definitions/logical-link"
+  metadata:
+    description: |
+      Collection of metadatum (key/value pairs)
+    properties:
+      metadatum:
+        type: array
+        items:          
+          $ref: "#/definitions/metadatum"
+  metadatum:
+    description: |
+      Key/value pairs
+      ###### Related Nodes
+      - TO configuration( metadatum org.onap.relationships.inventory.BelongsTo configuration, MANY2ONE)
+      - TO connector( metadatum org.onap.relationships.inventory.BelongsTo connector, MANY2ONE)
+      - TO image( metadatum org.onap.relationships.inventory.BelongsTo image, MANY2ONE)
+      - TO service-instance( metadatum org.onap.relationships.inventory.BelongsTo service-instance, MANY2ONE)
+      - TO model-ver( metadatum org.onap.relationships.inventory.BelongsTo model-ver, MANY2ONE)
+    required:
+    - metaname
+    - metaval
+    properties:
+      metaname:
+        type: string
+      metaval:
+        type: string
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+  model:
+    description: |
+      Subgraph definition provided by ASDC to describe an inventory asset and its connections related to ASDC models, independent of version
+      ###### Related Nodes
+      - TO model( model-ver org.onap.relationships.inventory.BelongsTo model, MANY2ONE)
+      - FROM instance-group( instance-group org.onap.relationships.inventory.Targets model, MANY2MANY)
+      - FROM model-ver( model-ver org.onap.relationships.inventory.BelongsTo model, MANY2ONE)
+      - FROM named-query( named-query org.onap.relationships.inventory.AppliesTo model, ONE2MANY)
+      - FROM named-query-element( named-query-element org.onap.relationships.inventory.IsA model, MANY2ONE)
+      - MODEL cannot be deleted if linked to INSTANCE-GROUP,NAMED-QUERY,NAMED-QUERY-ELEMENT
+      - MODEL is DELETED when these are DELETED MODEL-VER
+    required:
+    - model-invariant-id
+    - model-type
+    properties:
+      model-invariant-id:
+        type: string
+        description: Unique identifier corresponding to the main definition of a model in ASDC
+      model-type:
+        type: string
+        description: Type of the model, e.g., service, resource, widget, etc.
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      model-vers:
+        type: array
+        items:
+          $ref: "#/definitions/model-ver"
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+  model-and-named-query-search:
+    description: |
+      ModelAndNamedQuerySearch holds query-parameters and instance-properties for performing a named-query or model query
+    properties:
+      query-parameters:
+        type: object
+        $ref: "#/definitions/query-parameters"
+      instance-filters:
+        type: object
+        $ref: "#/definitions/instance-filters"
+      secondary-filts:
+        type: object
+        $ref: "#/definitions/secondary-filts"
+      top-node-type:
+        type: string
+      secondary-filter-cut-point:
+        type: string
+  model-constraint:
+    description: |
+      This is how we would capture constraints defining allowed sets of elements.
+      ###### Related Nodes
+      - TO model-element( model-constraint org.onap.relationships.inventory.BelongsTo model-element, MANY2ONE)
+      - FROM constrained-element-set( constrained-element-set org.onap.relationships.inventory.BelongsTo model-constraint, MANY2ONE)
+      - MODEL-CONSTRAINT is DELETED when these are DELETED CONSTRAINED-ELEMENT-SET
+    required:
+    - model-constraint-uuid
+    - constrained-element-set-uuid-to-replace
+    properties:
+      model-constraint-uuid:
+        type: string
+      constrained-element-set-uuid-to-replace:
+        type: string
+      constrained-element-sets:
+        type: array
+        items:
+          $ref: "#/definitions/constrained-element-set"
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+  model-constraints:
+    properties:
+      model-constraint:
+        type: array
+        items:          
+          $ref: "#/definitions/model-constraint"
+  model-element:
+    description: |
+      Defines how other models combine to make up a higher-level model.
+      ###### Related Nodes
+      - TO element-choice-set( model-element org.onap.relationships.inventory.BelongsTo element-choice-set, MANY2ONE)
+      - TO model-element( model-element org.onap.relationships.inventory.BelongsTo model-element, MANY2ONE)
+      - TO model-ver( model-element org.onap.relationships.inventory.IsA model-ver, MANY2ONE)
+      - TO model-ver( model-element org.onap.relationships.inventory.BelongsTo model-ver, MANY2ONE)
+      - FROM constrained-element-set( constrained-element-set org.onap.relationships.inventory.BelongsTo model-element, MANY2ONE)
+      - FROM model-constraint( model-constraint org.onap.relationships.inventory.BelongsTo model-element, MANY2ONE)
+      - FROM model-element( model-element org.onap.relationships.inventory.BelongsTo model-element, MANY2ONE)
+      - MODEL-ELEMENT is DELETED when these are DELETED CONSTRAINED-ELEMENT-SET,MODEL-CONSTRAINT
+    required:
+    - model-element-uuid
+    - new-data-del-flag
+    - cardinality
+    properties:
+      model-element-uuid:
+        type: string
+      new-data-del-flag:
+        type: string
+        description: Indicates whether this element was created as part of instantiation from this model
+      cardinality:
+        type: string
+        description: How many of this type of element are required/allowed
+      linkage-points:
+        type: string
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      model-elements:
+        type: array
+        items:
+          $ref: "#/definitions/model-element"
+        description: Defines how other models combine to make up a higher-level model
+      model-constraints:
+        type: array
+        items:
+          $ref: "#/definitions/model-constraint"
+        description: Describes new constraints on this model element that are not part of that model's definition
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+  model-elements:
+    properties:
+      model-element:
+        type: array
+        items:          
+          $ref: "#/definitions/model-element"
+  model-ver:
+    description: |
+      Subgraph definition provided by ASDC to describe a specific version of an inventory asset and its connections related to ASDC models
+      ###### Related Nodes
+      - TO model( model-ver org.onap.relationships.inventory.BelongsTo model, MANY2ONE)
+      - FROM model-element( model-element org.onap.relationships.inventory.IsA model-ver, MANY2ONE)
+      - FROM model-element( model-element org.onap.relationships.inventory.BelongsTo model-ver, MANY2ONE)
+      - FROM metadatum( metadatum org.onap.relationships.inventory.BelongsTo model-ver, MANY2ONE)
+      - MODEL-VER cannot be deleted if linked to MODEL-ELEMENT
+      - MODEL-VER is DELETED when these are DELETED MODEL-ELEMENT,METADATUM
+    required:
+    - model-version-id
+    - model-name
+    - model-version
+    properties:
+      model-version-id:
+        type: string
+        description: Unique identifier corresponding to one version of a model in ASDC
+      model-name:
+        type: string
+        description: Name of the model, which can change from version to version.
+      model-version:
+        type: string
+        description: Version
+      model-description:
+        type: string
+        description: Description
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      model-elements:
+        type: array
+        items:
+          $ref: "#/definitions/model-element"
+      metadata:
+        type: array
+        items:
+          $ref: "#/definitions/metadatum"
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+  model-vers:
+    properties:
+      model-ver:
+        type: array
+        items:          
+          $ref: "#/definitions/model-ver"
+  models:
+    description: |
+      Collection of subgraph definitions provided by ASDC to describe the inventory assets and their connections related to ASDC models
+    properties:
+      model:
+        type: array
+        items:          
+          $ref: "#/definitions/model"
+  multicast-configuration:
+    description: |
+      ###### Related Nodes
+      - FROM vlan( vlan org.onap.relationships.inventory.Uses multicast-configuration, MANY2MANY)
+    required:
+    - multicast-configuration-id
+    - multicast-protocol
+    - rp-type
+    properties:
+      multicast-configuration-id:
+        type: string
+        description: Unique id of multicast configuration.
+      multicast-protocol:
+        type: string
+        description: protocol of multicast configuration
+      rp-type:
+        type: string
+        description: rp type of multicast configuration
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+  multicast-configurations:
+    description: |
+      multicast configuration of generic-vnf ip-address
+    properties:
+      multicast-configuration:
+        type: array
+        items:          
+          $ref: "#/definitions/multicast-configuration"
+  named-queries:
+    properties:
+      named-query:
+        type: array
+        items:          
+          $ref: "#/definitions/named-query"
+  named-query:
+    description: |
+      TBD
+      ###### Related Nodes
+      - TO named-query( named-query-element org.onap.relationships.inventory.BelongsTo named-query, ONE2ONE)
+      - TO model( named-query org.onap.relationships.inventory.AppliesTo model, ONE2MANY)
+      - FROM named-query-element( named-query-element org.onap.relationships.inventory.BelongsTo named-query, ONE2ONE)
+      - NAMED-QUERY is DELETED when these are DELETED NAMED-QUERY-ELEMENT
+    required:
+    - named-query-uuid
+    - named-query-name
+    - named-query-version
+    properties:
+      named-query-uuid:
+        type: string
+      named-query-name:
+        type: string
+      named-query-version:
+        type: string
+      required-input-param:
+        type: string
+      description:
+        type: string
+      resource-version:
+        type: string
+      named-query-elements:
+        type: array
+        items:
+          $ref: "#/definitions/named-query-element"
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+  named-query-element:
+    description: |
+      TBD
+      ###### Related Nodes
+      - TO named-query( named-query-element org.onap.relationships.inventory.BelongsTo named-query, ONE2ONE)
+      - TO model( named-query-element org.onap.relationships.inventory.IsA model, MANY2ONE)
+      - TO named-query-element( named-query-element org.onap.relationships.inventory.BelongsTo named-query-element, MANY2ONE)
+      - FROM property-constraint( property-constraint org.onap.relationships.inventory.BelongsTo named-query-element, MANY2ONE)
+      - FROM related-lookup( related-lookup org.onap.relationships.inventory.BelongsTo named-query-element, MANY2ONE)
+      - FROM named-query-element( named-query-element org.onap.relationships.inventory.BelongsTo named-query-element, MANY2ONE)
+      - NAMED-QUERY-ELEMENT is DELETED when these are DELETED PROPERTY-CONSTRAINT,RELATED-LOOKUP
+    required:
+    - named-query-element-uuid
+    properties:
+      named-query-element-uuid:
+        type: string
+      property-collect-list:
+        type: string
+      resource-version:
+        type: string
+      property-limit-desc:
+        type: string
+      do-not-output:
+        type: string
+      named-query-elements:
+        type: array
+        items:
+          $ref: "#/definitions/named-query-element"
+      related-lookups:
+        type: array
+        items:
+          $ref: "#/definitions/related-lookup"
+      property-constraints:
+        type: array
+        items:
+          $ref: "#/definitions/property-constraint"
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+  named-query-elements:
+    properties:
+      named-query-element:
+        type: array
+        items:          
+          $ref: "#/definitions/named-query-element"
+  network:
+    description: |
+      Namespace for network inventory resources.
+    properties:
+      logical-links:
+        type: array
+        items:
+          $ref: "#/definitions/logical-link"
+      site-pair-sets:
+        type: array
+        items:
+          $ref: "#/definitions/site-pair-set"
+      vpn-bindings:
+        type: array
+        items:
+          $ref: "#/definitions/vpn-binding"
+      vpls-pes:
+        type: array
+        items:
+          $ref: "#/definitions/vpls-pe"
+      multicast-configurations:
+        type: array
+        items:
+          $ref: "#/definitions/multicast-configuration"
+      vces:
+        type: array
+        items:
+          $ref: "#/definitions/vce"
+      vnfcs:
+        type: array
+        items:
+          $ref: "#/definitions/vnfc"
+      l3-networks:
+        type: array
+        items:
+          $ref: "#/definitions/l3-network"
+      network-policies:
+        type: array
+        items:
+          $ref: "#/definitions/network-policy"
+      generic-vnfs:
+        type: array
+        items:
+          $ref: "#/definitions/generic-vnf"
+      lag-links:
+        type: array
+        items:
+          $ref: "#/definitions/lag-link"
+      newvces:
+        type: array
+        items:
+          $ref: "#/definitions/newvce"
+      pnfs:
+        type: array
+        items:
+          $ref: "#/definitions/pnf"
+      physical-links:
+        type: array
+        items:
+          $ref: "#/definitions/physical-link"
+      ipsec-configurations:
+        type: array
+        items:
+          $ref: "#/definitions/ipsec-configuration"
+      route-table-references:
+        type: array
+        items:
+          $ref: "#/definitions/route-table-reference"
+      instance-groups:
+        type: array
+        items:
+          $ref: "#/definitions/instance-group"
+      zones:
+        type: array
+        items:
+          $ref: "#/definitions/zone"
+      configurations:
+        type: array
+        items:
+          $ref: "#/definitions/configurations"
+  network-policies:
+    properties:
+      network-policy:
+        type: array
+        items:          
+          $ref: "#/definitions/network-policy"
+  network-policy:
+    description: |
+      ###### Related Nodes
+      - FROM allotted-resource( allotted-resource org.onap.relationships.inventory.Uses network-policy, ONE2ONE)
+      - FROM l3-network( l3-network org.onap.relationships.inventory.Uses network-policy, MANY2MANY)
+    required:
+    - network-policy-id
+    properties:
+      network-policy-id:
+        type: string
+        description: UUID representing unique key to this instance
+      network-policy-fqdn:
+        type: string
+        description: Contrail FQDN for the policy
+      heat-stack-id:
+        type: string
+        description: ID for the openStack Heat instance
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+  network-profile:
+    description: |
+      Network profile populated by SDN-GP for SNMP
+      ###### Related Nodes
+      - TO generic-vnf( network-profile org.onap.relationships.inventory.AppliesTo generic-vnf, MANY2MANY)
+    required:
+    - nm-profile-name
+    properties:
+      nm-profile-name:
+        type: string
+        description: Unique name of network profile.
+      community-string:
+        type: string
+        description: Encrypted SNMP community string
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+  network-profiles:
+    description: |
+      Collection of network profiles
+    properties:
+      network-profile:
+        type: array
+        items:          
+          $ref: "#/definitions/network-profile"
+  newvce:
+    description: |
+      This object fills in the gaps from vce that were incorporated into generic-vnf.  This object will be retired with vce.
+      ###### Related Nodes
+      - FROM l-interface( l-interface org.onap.relationships.inventory.BelongsTo newvce, MANY2ONE)
+      - NEWVCE is DELETED when these are DELETED L-INTERFACE
+    required:
+    - vnf-id2
+    - vnf-name
+    - vnf-type
+    properties:
+      vnf-id2:
+        type: string
+        description: Unique id of VNF, can't use same attribute name right now until we promote this new object
+      vnf-name:
+        type: string
+        description: Name of VNF.
+      vnf-name2:
+        type: string
+        description: Alternate name of VNF.
+      vnf-type:
+        type: string
+        description: String capturing type of vnf, that was intended to identify the ASDC resource.  This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures.
+      prov-status:
+        type: string
+        description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems.
+      operational-status:
+        type: string
+        description: Indicator for whether the resource is considered operational
+      license-key:
+        type: string
+        description: OBSOLETE -  do not use
+      ipv4-oam-address:
+        type: string
+        description: Address tail-f uses to configure generic-vnf, also used for troubleshooting and is IP used for traps generated by GenericVnf (v4-loopback0-ip-address).
+      equipment-role:
+        type: string
+        description: Client should send valid enumerated value.
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      ipv4-loopback0-address:
+        type: string
+        description: v4 Loopback0 address
+      orchestration-status:
+        type: string
+        description: Orchestration status of this VNF, mastered by MSO.
+      heat-stack-id:
+        type: string
+        description: Heat stack id corresponding to this instance, managed by MSO
+      mso-catalog-key:
+        type: string
+        description: Corresponds to the SDN-C catalog id used to configure this VCE
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+      l-interfaces:
+        type: array
+        items:
+          $ref: "#/definitions/l-interface"
+  newvces:
+    description: |
+      This object fills in the gaps from vce that were incorporated into generic-vnf.  This object will be retired with vce.
+    properties:
+      newvce:
+        type: array
+        items:          
+          $ref: "#/definitions/newvce"
+  notification-event:
+    properties:
+      cambria.partition:
+        type: string
+      notification-event-header:
+        type: object
+        $ref: "#/definitions/notification-event-header"
+  notification-event-header:
+    properties:
+      id:
+        type: string
+      timestamp:
+        type: string
+      source-name:
+        type: string
+      domain:
+        type: string
+      sequence-number:
+        type: string
+      severity:
+        type: string
+      event-type:
+        type: string
+      version:
+        type: string
+      action:
+        type: string
+      entity-type:
+        type: string
+      top-entity-type:
+        type: string
+      entity-link:
+        type: string
+      status:
+        type: string
+  notify:
+    required:
+    - event-id
+    properties:
+      event-id:
+        type: string
+      node-type:
+        type: string
+      event-trigger:
+        type: string
+      key-data:
+        type: array
+        items:          
+          $ref: "#/definitions/key-data"
+      selflink:
+        type: string
+  oam-network:
+    description: |
+      OAM network, to be deprecated shortly.  Do not use for new purposes. 
+      ###### Related Nodes
+      - TO cloud-region( oam-network org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE)
+      - TO complex( oam-network org.onap.relationships.inventory.AppliesTo complex, MANY2MANY)
+      - TO service-capability( oam-network org.onap.relationships.inventory.AppliesTo service-capability, MANY2MANY)
+    required:
+    - network-uuid
+    - network-name
+    - cvlan-tag
+    properties:
+      network-uuid:
+        type: string
+        description: UUID of the network. Unique across a cloud-region
+      network-name:
+        type: string
+        description: Name of the network.
+      cvlan-tag:
+        type: integer
+        format: int64
+        description: cvlan-id
+      ipv4-oam-gateway-address:
+        type: string
+        description: Used for VNF firewall rule so customer cannot send customer traffic over this oam network
+      ipv4-oam-gateway-address-prefix-length:
+        type: integer
+        format: int32
+        description: Used for VNF firewall rule so customer cannot send customer traffic over this oam network
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+  oam-networks:
+    description: |
+      Collection of OAM networks, to be deprecated shortly.  Do not use for new purposes. 
+    properties:
+      oam-network:
+        type: array
+        items:          
+          $ref: "#/definitions/oam-network"
+  operational-environment:
+    description: |
+      It is a logical partition of the cloud which allows to have multiple environments in the production AIC.
+      ###### Related Nodes
+      - TO operational-environment( operational-environment org.onap.relationships.inventory.Uses operational-environment, ONE2ONE)
+      - FROM operational-environment( operational-environment org.onap.relationships.inventory.Uses operational-environment, ONE2ONE)
+    required:
+    - operational-environment-id
+    - operational-environment-name
+    - operational-environment-type
+    - operational-environment-status
+    - tenant-context
+    - workload-context
+    properties:
+      operational-environment-id:
+        type: string
+        description: UUID of an operational environment
+      operational-environment-name:
+        type: string
+        description: Operational Environment name
+      operational-environment-type:
+        type: string
+        description: Operational Environment Type.
+      operational-environment-status:
+        type: string
+        description: Status
+      tenant-context:
+        type: string
+        description: Tenant Context.
+      workload-context:
+        type: string
+        description: Workload Context.
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+  operational-environments:
+    description: |
+      a logical partition of the cloud which allows to have multiple environments in the production AIC.
+    properties:
+      operational-environment:
+        type: array
+        items:          
+          $ref: "#/definitions/operational-environment"
+  overloaded-model:
+    description: |
+      Allows for legacy POST of old-style and new-style models
+    required:
+    - model-invariant-id
+    - model-name-version-id
+    - model-type
+    - model-name
+    - model-id
+    - model-version
+    properties:
+      model-invariant-id:
+        type: string
+        description: Unique identifier corresponding to the main definition of a model in ASDC
+      model-name-version-id:
+        type: string
+        description: Unique identifier corresponding to one version of a model in ASDC
+      model-type:
+        type: string
+        description: Type of the model, e.g., service, resource, widget, etc.
+      model-name:
+        type: string
+        description: Name of the model, which can change from version to version.
+      model-id:
+        type: string
+        description: Invariant unique ID which does not change from version to version
+      model-version:
+        type: string
+        description: Version
+      model-description:
+        type: string
+        description: Description
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      model-vers:
+        type: object
+        $ref: "#/definitions/model-vers"
+      relationship-list:
+        type: object
+        $ref: "#/definitions/relationship-list"
+  owning-entities:
+    description: |
+      Collection of owning-entities
+    properties:
+      owning-entity:
+        type: array
+        items:          
+          $ref: "#/definitions/owning-entity"
+  owning-entity:
+    description: |
+      describes an owning-entity
+      ###### Related Nodes
+      - FROM service-instance( service-instance org.onap.relationships.inventory.BelongsTo owning-entity, MANY2ONE)
+    required:
+    - owning-entity-id
+    - owning-entity-name
+    properties:
+      owning-entity-id:
+        type: string
+        description: UUID of an owning entity
+      owning-entity-name:
+        type: string
+        description: Owning entity name
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+  p-interface:
+    description: |
+      Physical interface (e.g., nic)
+      ###### Related Nodes
+      - TO logical-link( p-interface tosca.relationships.network.LinksTo logical-link, MANY2ONE)
+      - TO physical-link( p-interface tosca.relationships.network.LinksTo physical-link, MANY2ONE)
+      - TO pnf( p-interface tosca.relationships.network.BindsTo pnf, MANY2ONE)
+      - TO pserver( p-interface tosca.relationships.network.BindsTo pserver, MANY2ONE)
+      - TO vpls-pe( p-interface tosca.relationships.network.BindsTo vpls-pe, MANY2ONE)
+      - FROM lag-interface( lag-interface org.onap.relationships.inventory.Uses p-interface, MANY2MANY)
+      - FROM l-interface( l-interface tosca.relationships.network.BindsTo p-interface, MANY2ONE)
+      - FROM sriov-pf( sriov-pf org.onap.relationships.inventory.BelongsTo p-interface, ONE2ONE)
+      - P-INTERFACE is DELETED when these are DELETED L-INTERFACE,SRIOV-PF
+      - P-INTERFACE deletion means associated objects of these types are also DELETED:PHYSICAL-LINK
+    required:
+    - interface-name
+    - in-maint
+    properties:
+      interface-name:
+        type: string
+        description: Name that identifies the physical interface
+      speed-value:
+        type: string
+        description: Captures the numeric part of the speed
+      speed-units:
+        type: string
+        description: Captures the units corresponding to the speed
+      port-description:
+        type: string
+        description: Nature of the services and connectivity on this port.
+      equipment-identifier:
+        type: string
+        description: CLEI or other specification for p-interface hardware.
+      interface-role:
+        type: string
+        description: Role specification for p-interface hardware.
+      interface-type:
+        type: string
+        description: Indicates the physical properties of the interface.
+      prov-status:
+        type: string
+        description: Trigger for operational monitoring of this resource by Service Assurance systems.
+      mac-addresss:
+        type: string
+        description: MAC Address of the p-interface.
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      in-maint:
+        type: boolean
+      inv-status:
+        type: string
+        description: inventory status
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+      sriov-pfs:
+        type: array
+        items:
+          $ref: "#/definitions/sriov-pf"
+      l-interfaces:
+        type: array
+        items:
+          $ref: "#/definitions/l-interface"
+  p-interfaces:
+    description: |
+      Collection of physical interfaces.
+    properties:
+      p-interface:
+        type: array
+        items:          
+          $ref: "#/definitions/p-interface"
+  physical-link:
+    description: |
+      Collection of physical connections, typically between p-interfaces
+      ###### Related Nodes
+      - FROM p-interface( p-interface tosca.relationships.network.LinksTo physical-link, MANY2ONE)
+    required:
+    - link-name
+    properties:
+      link-name:
+        type: string
+        description: e.g., hostnameA_p-connection_nameA_hostnameZ+p_connection-nameZ
+      speed-value:
+        type: string
+        description: Captures the numeric part of the speed
+      speed-units:
+        type: string
+        description: Captures the units corresponding to the speed
+      circuit-id:
+        type: string
+        description: Circuit it
+      dual-mode:
+        type: string
+        description: Dual access mode (e.g., primary, secondary
+      management-option:
+        type: string
+        description: To provide information on who manages this circuit. A&AI or 3rd party transport provider
+      service-provider-name:
+        type: string
+        description: Name of the service Provider on this link.
+      service-provider-bandwidth-up-value:
+        type: integer
+        format: int32
+        description: Upstream Bandwidth value agreed with the service provider
+      service-provider-bandwidth-up-units:
+        type: string
+        description: Units for the upstream BW value
+      service-provider-bandwidth-down-value:
+        type: integer
+        format: int32
+        description: Downstream Bandwidth value agreed with the service provider
+      service-provider-bandwidth-down-units:
+        type: string
+        description: Units for downstream BW value
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+  physical-links:
+    description: |
+      Collection of physical connections, typically between p-interfaces
+    properties:
+      physical-link:
+        type: array
+        items:          
+          $ref: "#/definitions/physical-link"
+  platform:
+    description: |
+      describes a platform
+      ###### Related Nodes
+      - TO generic-vnf( platform org.onap.relationships.inventory.Uses generic-vnf, MANY2MANY)
+    required:
+    - platform-name
+    properties:
+      platform-name:
+        type: string
+        description: Name of the platform
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+  platforms:
+    description: |
+      Collection of platforms
+    properties:
+      platform:
+        type: array
+        items:          
+          $ref: "#/definitions/platform"
+  pnf:
+    description: |
+      PNF represents a physical network function. typically equipment used in the D1 world. in 1607, this will be populated by SDN-C to represent a premises router that a uCPE connects to. But this can be used to represent any physical device that is not an AIC node or uCPE.
+      ###### Related Nodes
+      - TO complex( pnf org.onap.relationships.inventory.LocatedIn complex, MANY2ONE)
+      - TO instance-group( pnf org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY)
+      - TO zone( pnf org.onap.relationships.inventory.LocatedIn zone, MANY2ONE)
+      - FROM esr-thirdparty-sdnc( esr-thirdparty-sdnc has pnf, One2Many)
+      - FROM generic-vnf( generic-vnf tosca.relationships.HostedOn pnf, MANY2MANY)
+      - FROM logical-link( logical-link org.onap.relationships.inventory.BridgedTo pnf, MANY2MANY)
+      - FROM lag-interface( lag-interface tosca.relationships.network.BindsTo pnf, MANY2ONE)
+      - FROM p-interface( p-interface tosca.relationships.network.BindsTo pnf, MANY2ONE)
+      - FROM service-instance( service-instance org.onap.relationships.inventory.ComposedOf pnf, ONE2MANY)
+      - PNF is DELETED when these are DELETED LAG-INTERFACE,P-INTERFACE
+    required:
+    - pnf-name
+    - in-maint
+    properties:
+      pnf-name:
+        type: string
+        description: unique name of Physical Network Function.
+      pnf-name2:
+        type: string
+        description: name of Physical Network Function.
+      pnf-name2-source:
+        type: string
+        description: source of name2
+      pnf-id:
+        type: string
+        description: id of pnf
+      equip-type:
+        type: string
+        description: Equipment type.  Source of truth should define valid values.
+      equip-vendor:
+        type: string
+        description: Equipment vendor.  Source of truth should define valid values.
+      equip-model:
+        type: string
+        description: Equipment model.  Source of truth should define valid values.
+      management-option:
+        type: string
+        description: identifier of managed by ATT or customer
+      ipaddress-v4-oam:
+        type: string
+        description: ipv4-oam-address with new naming convention for IP addresses
+      sw-version:
+        type: string
+        description: sw-version is the version of SW for the hosted application on the PNF.
+      in-maint:
+        type: boolean
+      frame-id:
+        type: string
+        description: ID of the physical frame (relay rack) where pnf is installed.
+      serial-number:
+        type: string
+        description: Serial number of the device
+      ipaddress-v4-loopback-0:
+        type: string
+        description: IPV4 Loopback 0 address
+      ipaddress-v6-loopback-0:
+        type: string
+        description: IPV6 Loopback 0 address
+      ipaddress-v4-aim:
+        type: string
+        description: IPV4 AIM address
+      ipaddress-v6-aim:
+        type: string
+        description: IPV6 AIM address
+      ipaddress-v6-oam:
+        type: string
+        description: IPV6 OAM address
+      inv-status:
+        type: string
+        description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      prov-status:
+        type: string
+        description: Prov Status of this device (not under canopi control) Valid values [PREPROV/NVTPROV/PROV]
+      nf-role:
+        type: string
+        description: Nf Role is the role performed by this instance in the network.
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+      p-interfaces:
+        type: array
+        items:
+          $ref: "#/definitions/p-interface"
+      lag-interfaces:
+        type: array
+        items:
+          $ref: "#/definitions/lag-interface"
+  pnfs:
+    description: |
+      Collection of Physical Network Functions.
+    properties:
+      pnf:
+        type: array
+        items:          
+          $ref: "#/definitions/pnf"
+  port-group:
+    description: |
+      Used to capture the network interfaces of this VCE
+      ###### Related Nodes
+      - TO vce( port-group org.onap.relationships.inventory.BelongsTo vce, MANY2ONE)
+      - FROM cvlan-tag( cvlan-tag org.onap.relationships.inventory.BelongsTo port-group, MANY2ONE)
+      - PORT-GROUP is DELETED when these are DELETED CVLAN-TAG
+    required:
+    - interface-id
+    - orchestration-status
+    properties:
+      interface-id:
+        type: string
+        description: Unique ID of the interface
+      neutron-network-id:
+        type: string
+        description: Neutron network id of this Interface
+      neutron-network-name:
+        type: string
+        description: Neutron network name of this Interface
+      interface-role:
+        type: string
+        description: Role assigned to this Interface, should use values as defined in ECOMP Yang models.
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      port-group-id:
+        type: string
+        description: Unique ID for port group in vmware
+      port-group-name:
+        type: string
+        description: Likely to duplicate value of neutron network name
+      switch-name:
+        type: string
+        description: DVS or standard switch name (should be non-null for port groups associated with DVS)
+      orchestration-status:
+        type: string
+        description: Orchestration status of this VNF, mastered by MSO
+      heat-stack-id:
+        type: string
+        description: Heat stack id corresponding to this instance, managed by MSO
+      mso-catalog-key:
+        type: string
+        description: Corresponds to the SDN-C catalog id used to configure this VCE
+      cvlan-tags:
+        type: array
+        items:
+          $ref: "#/definitions/cvlan-tag-entry"
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+  port-groups:
+    properties:
+      port-group:
+        type: array
+        items:          
+          $ref: "#/definitions/port-group"
+  project:
+    description: |
+      describes the project
+      ###### Related Nodes
+      - TO service-instance( project org.onap.relationships.inventory.Uses service-instance, ONE2MANY)
+    required:
+    - project-name
+    properties:
+      project-name:
+        type: string
+        description: Name of the project deploying a service
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+  projects:
+    description: |
+      Collection of projects
+    properties:
+      project:
+        type: array
+        items:          
+          $ref: "#/definitions/project"
+  properties:
+    description: |
+      Property holder for query properties or instance properties
+    properties:
+      property-name:
+        type: string
+      property-value:
+        type: string
+  property-constraint:
+    description: |
+      TBD
+      ###### Related Nodes
+      - TO named-query-element( property-constraint org.onap.relationships.inventory.BelongsTo named-query-element, MANY2ONE)
+    required:
+    - property-constraint-uuid
+    - constraint-type
+    - property-name
+    - property-value
+    properties:
+      property-constraint-uuid:
+        type: string
+      constraint-type:
+        type: string
+      property-name:
+        type: string
+      property-value:
+        type: string
+      resource-version:
+        type: string
+  property-constraints:
+    properties:
+      property-constraint:
+        type: array
+        items:          
+          $ref: "#/definitions/property-constraint"
+  pserver:
+    description: |
+      Compute host whose hostname must be unique and must exactly match what is sent as a relationship to a vserver.
+      ###### Related Nodes
+      - TO group-assignment( pserver org.onap.relationships.inventory.MemberOf group-assignment, MANY2ONE)
+      - TO availability-zone( pserver org.onap.relationships.inventory.MemberOf availability-zone, MANY2ONE)
+      - TO cloud-region( pserver org.onap.relationships.inventory.LocatedIn cloud-region, MANY2ONE)
+      - TO complex( pserver org.onap.relationships.inventory.LocatedIn complex, MANY2ONE)
+      - TO zone( pserver org.onap.relationships.inventory.LocatedIn zone, MANY2ONE)
+      - FROM generic-vnf( generic-vnf tosca.relationships.HostedOn pserver, MANY2MANY)
+      - FROM logical-link( logical-link org.onap.relationships.inventory.BridgedTo pserver, MANY2MANY)
+      - FROM lag-interface( lag-interface tosca.relationships.network.BindsTo pserver, MANY2ONE)
+      - FROM p-interface( p-interface tosca.relationships.network.BindsTo pserver, MANY2ONE)
+      - FROM vserver( vserver tosca.relationships.HostedOn pserver, MANY2ONE)
+      - PSERVER cannot be deleted if linked to GENERIC-VNF,LOGICAL-LINK,VSERVER
+      - PSERVER is DELETED when these are DELETED LAG-INTERFACE,P-INTERFACE
+      - PSERVER cannot be deleted if linked to GROUP-ASSIGNMENT
+    required:
+    - hostname
+    - in-maint
+    properties:
+      hostname:
+        type: string
+        description: Value from executing hostname on the compute node.
+      ptnii-equip-name:
+        type: string
+        description: PTNII name
+      number-of-cpus:
+        type: integer
+        format: int32
+        description: Number of cpus
+      disk-in-gigabytes:
+        type: integer
+        format: int32
+        description: Disk size, in GBs
+      ram-in-megabytes:
+        type: integer
+        format: int32
+        description: RAM size, in MBs
+      equip-type:
+        type: string
+        description: Equipment type.  Source of truth should define valid values.
+      equip-vendor:
+        type: string
+        description: Equipment vendor.  Source of truth should define valid values.
+      equip-model:
+        type: string
+        description: Equipment model.  Source of truth should define valid values.
+      fqdn:
+        type: string
+        description: Fully-qualified domain name
+      pserver-selflink:
+        type: string
+        description: URL to endpoint where AAI can get more details
+      ipv4-oam-address:
+        type: string
+        description: Used to configure device, also used for troubleshooting and is IP used for traps generated by device.
+      serial-number:
+        type: string
+        description: Serial number, may be queried
+      ipaddress-v4-loopback-0:
+        type: string
+        description: IPV4 Loopback 0 address
+      ipaddress-v6-loopback-0:
+        type: string
+        description: IPV6 Loopback 0 address
+      ipaddress-v4-aim:
+        type: string
+        description: IPV4 AIM address
+      ipaddress-v6-aim:
+        type: string
+        description: IPV6 AIM address
+      ipaddress-v6-oam:
+        type: string
+        description: IPV6 OAM address
+      inv-status:
+        type: string
+        description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
+      pserver-id:
+        type: string
+        description: ID of Pserver
+      internet-topology:
+        type: string
+        description: internet topology of Pserver
+      in-maint:
+        type: boolean
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      pserver-name2:
+        type: string
+        description: alternative pserver name
+      purpose:
+        type: string
+        description: purpose of pserver
+      prov-status:
+        type: string
+        description: Prov Status of this device (not under canopi control) Valid values [PREPROV/NVTPROV/PROV]
+      management-option:
+        type: string
+        description: Indicates who owns and or manages the device.
+      host-profile:
+        type: string
+        description: The host profile that defines the configuration of the pserver.
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+      p-interfaces:
+        type: array
+        items:
+          $ref: "#/definitions/p-interface"
+      lag-interfaces:
+        type: array
+        items:
+          $ref: "#/definitions/lag-interface"
+  pservers:
+    description: |
+      Collection of compute hosts.
+    properties:
+      pserver:
+        type: array
+        items:          
+          $ref: "#/definitions/pserver"
+  query-parameters:
+    description: |
+      QueryParameters for performing a named-query or model query
+    properties:
+      named-query:
+        type: object
+        $ref: "#/definitions/named-query"
+      overloaded-model:
+        type: object
+        $ref: "#/definitions/overloaded-model"
+  related-lookup:
+    description: |
+      TBD
+      ###### Related Nodes
+      - TO named-query-element( related-lookup org.onap.relationships.inventory.BelongsTo named-query-element, MANY2ONE)
+    required:
+    - related-lookup-uuid
+    - source-node-type
+    - source-node-property
+    - target-node-type
+    - target-node-property
+    properties:
+      related-lookup-uuid:
+        type: string
+      source-node-type:
+        type: string
+      source-node-property:
+        type: string
+      target-node-type:
+        type: string
+      target-node-property:
+        type: string
+      property-collect-list:
+        type: string
+      resource-version:
+        type: string
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+  related-lookups:
+    properties:
+      related-lookup:
+        type: array
+        items:          
+          $ref: "#/definitions/related-lookup"
+  related-to-property:
+    properties:
+      property-key:
+        type: string
+        description: Key part of a key/value pair
+      property-value:
+        type: string
+        description: Value part of a key/value pair
+  relationship:
+    properties:
+      related-to:
+        type: string
+        description: A keyword provided by A&AI to indicate type of node.
+      related-link:
+        type: string
+        description: URL to the object in A&AI.
+      relationship-data:
+        type: array
+        items:          
+          $ref: "#/definitions/relationship-data"
+  relationship-data:
+    required:
+    - relationship-key
+    - relationship-value
+    properties:
+      relationship-key:
+        type: string
+        description: A keyword provided by A&AI to indicate an attribute.
+      relationship-value:
+        type: string
+        description: Value of the attribute.
+  relationship-list:
+    properties:
+      relationship:
+        type: array
+        items:          
+          $ref: "#/definitions/relationship"
+  reserved-prop-names:
+    description: |
+      Internal map to define some reserved properties of a vertex
+    properties:
+      last-mod-source-of-truth:
+        type: string
+      aai-node-type:
+        type: string
+      aai-created-ts:
+        type: integer
+        format: int64
+      aai-unique-key:
+        type: string
+      aai-last-mod-ts:
+        type: integer
+        format: int64
+      source-of-truth:
+        type: string
+      aai-uri:
+        type: string
+  response-list:
+    description: |
+      Response container for the results of a named-query or model query
+    properties:
+      inventory-response-items:
+        type: object
+        $ref: "#/definitions/inventory-response-items"
+  result-data:
+    properties:
+      resource-type:
+        type: string
+        description: The specific type of node in the A&AI graph
+      resource-link:
+        type: string
+        description: The URL to the specific resource
+  route-table-reference:
+    description: |
+      Openstack route table reference.
+      ###### Related Nodes
+      - FROM l3-network( l3-network org.onap.relationships.inventory.Uses route-table-reference, MANY2MANY)
+    required:
+    - route-table-reference-id
+    - route-table-reference-fqdn
+    properties:
+      route-table-reference-id:
+        type: string
+        description: Route Table Reference id, UUID assigned to this instance.
+      route-table-reference-fqdn:
+        type: string
+        description: FQDN entry in the route table.
+      resource-version:
+        type: string
+        description: Concurrency value
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+  route-table-references:
+    description: |
+      Collection of openstack route table references
+    properties:
+      route-table-reference:
+        type: array
+        items:          
+          $ref: "#/definitions/route-table-reference"
+  route-target:
+    description: |
+      Route target information
+      ###### Related Nodes
+      - TO vpn-binding( route-target org.onap.relationships.inventory.BelongsTo vpn-binding, MANY2ONE)
+    required:
+    - global-route-target
+    - route-target-role
+    properties:
+      global-route-target:
+        type: string
+        description: Number used to identify an RT, globally unique in the network
+      route-target-role:
+        type: string
+        description: Role assigned to this route target
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+  route-targets:
+    description: |
+      Collection of route target information
+    properties:
+      route-target:
+        type: array
+        items:          
+          $ref: "#/definitions/route-target"
+  routing-instance:
+    description: |
+      ###### Related Nodes
+      - TO site-pair-set( routing-instance org.onap.relationships.inventory.BelongsTo site-pair-set, MANY2ONE)
+      - FROM site-pair( site-pair org.onap.relationships.inventory.BelongsTo routing-instance, MANY2ONE)
+      - ROUTING-INSTANCE is DELETED when these are DELETED SITE-PAIR
+    required:
+    - routing-instance-id
+    properties:
+      routing-instance-id:
+        type: string
+        description: Unique id of routing instance
+      rpm-owner:
+        type: string
+        description: rpm owner
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      site-pairs:
+        type: array
+        items:
+          $ref: "#/definitions/site-pair"
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+  routing-instances:
+    description: |
+      set of probes related to generic-vnf routing instance
+    properties:
+      routing-instance:
+        type: array
+        items:          
+          $ref: "#/definitions/routing-instance"
+  sdn-zone-response:
+    properties:
+      oam-networks:
+        type: object
+        $ref: "#/definitions/oam-networks"
+      az-and-dvs-switches:
+        type: array
+        items:          
+          $ref: "#/definitions/az-and-dvs-switches"
+  search:
+    properties:
+      edge-tag-query-result:
+        type: object
+        $ref: "#/definitions/edge-tag-query-result"
+      edge-tag-query-request:
+        type: object
+        $ref: "#/definitions/edge-tag-query-request"
+      search-results:
+        type: object
+        $ref: "#/definitions/search-results"
+      sdn-zone-response:
+        type: object
+        $ref: "#/definitions/sdn-zone-response"
+  search-results:
+    properties:
+      result-data:
+        type: array
+        items:          
+          $ref: "#/definitions/result-data"
+  secondary-filt:
+    description: |
+      SecondaryFilt for performing a named-query or model query
+  secondary-filter:
+    properties:
+      property-name:
+        type: string
+      filter-type:
+        type: string
+      property-value:
+        type: string
+  secondary-filts:
+    description: |
+      SecondaryFilts for performing a named-query or model query
+    properties:
+      secondary-filt:
+        type: array
+        items:          
+          $ref: "#/definitions/secondary-filt"
+  segmentation-assignment:
+    description: |
+      Openstack segmentation assignment.
+      ###### Related Nodes
+      - TO l3-network( segmentation-assignment org.onap.relationships.inventory.BelongsTo l3-network, MANY2ONE)
+    required:
+    - segmentation-id
+    properties:
+      segmentation-id:
+        type: string
+        description: Route Table Reference id, UUID assigned to this instance.
+      resource-version:
+        type: string
+        description: Concurrency value
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+  segmentation-assignments:
+    description: |
+      Collection of openstack segmentation assignments
+    properties:
+      segmentation-assignment:
+        type: array
+        items:          
+          $ref: "#/definitions/segmentation-assignment"
+  service:
+    description: |
+      Stand-in for service model definitions.  Likely to be deprecated in favor of models from ASDC.  Does not strictly map to ASDC services.
+    required:
+    - service-id
+    - service-description
+    properties:
+      service-id:
+        type: string
+        description: This gets defined by others to provide a unique ID for the service, we accept what is sent.
+      service-description:
+        type: string
+        description: Description of the service
+      service-selflink:
+        type: string
+        description: URL to endpoint where AAI can get more details
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      service-version:
+        type: string
+        description: service version
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+  service-capabilities:
+    description: |
+      Collection of service capabilities.
+    properties:
+      service-capability:
+        type: array
+        items:          
+          $ref: "#/definitions/service-capability"
+  service-capability:
+    description: |
+      Early definition of server/resource pairings, likely to be replaced by models.  No new use should be made of this.
+      ###### Related Nodes
+      - FROM availability-zone( availability-zone org.onap.relationships.inventory.AppliesTo service-capability, MANY2MANY)
+      - FROM oam-network( oam-network org.onap.relationships.inventory.AppliesTo service-capability, MANY2MANY)
+      - SERVICE-CAPABILITY cannot be deleted if linked to AVAILABILITY-ZONE,OAM-NETWORK
+    required:
+    - service-type
+    - vnf-type
+    properties:
+      service-type:
+        type: string
+        description: This gets defined by others to provide a unique ID for the service, we accept what is sent.
+      vnf-type:
+        type: string
+        description: String capturing type of vnf, that was intended to identify the ASDC resource.  This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures.
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+  service-design-and-creation:
+    description: |
+      Namespace for objects managed by ASDC
+    properties:
+      vnf-images:
+        type: array
+        items:
+          $ref: "#/definitions/vnf-image"
+      services:
+        type: array
+        items:
+          $ref: "#/definitions/service"
+      service-capabilities:
+        type: array
+        items:
+          $ref: "#/definitions/service-capability"
+      models:
+        type: array
+        items:
+          $ref: "#/definitions/model"
+      named-queries:
+        type: array
+        items:
+          $ref: "#/definitions/named-query"
+  service-instance:
+    description: |
+      Instance of a service
+      ###### Related Nodes
+      - TO generic-vnf( service-instance org.onap.relationships.inventory.ComposedOf generic-vnf, ONE2MANY)
+      - TO l3-network( service-instance org.onap.relationships.inventory.ComposedOf l3-network, ONE2MANY)
+      - TO owning-entity( service-instance org.onap.relationships.inventory.BelongsTo owning-entity, MANY2ONE)
+      - TO allotted-resource( service-instance org.onap.relationships.inventory.Uses allotted-resource, MANY2MANY)
+      - TO configuration( service-instance org.onap.relationships.inventory.Uses configuration, ONE2MANY)
+      - TO connector( service-instance org.onap.relationships.inventory.Uses connector, MANY2MANY)
+      - TO ctag-assignment( service-instance org.onap.relationships.inventory.Uses ctag-assignment, ONE2MANY)
+      - TO cvlan-tag( service-instance org.onap.relationships.inventory.ComposedOf cvlan-tag, MANY2MANY)
+      - TO instance-group( service-instance org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY)
+      - TO logical-link( service-instance org.onap.relationships.inventory.Uses logical-link, ONE2MANY)
+      - TO pnf( service-instance org.onap.relationships.inventory.ComposedOf pnf, ONE2MANY)
+      - TO service-instance( service-instance org.onap.relationships.inventory.ComposedOf service-instance, ONE2MANY)
+      - TO vlan( service-instance org.onap.relationships.inventory.ComposedOf vlan, ONE2MANY)
+      - TO zone( service-instance org.onap.relationships.inventory.LocatedIn zone, MANY2ONE)
+      - TO service-subscription( service-instance org.onap.relationships.inventory.BelongsTo service-subscription, MANY2ONE)
+      - TO vce( service-instance org.onap.relationships.inventory.ComposedOf vce, ONE2MANY)
+      - FROM project( project org.onap.relationships.inventory.Uses service-instance, ONE2MANY)
+      - FROM allotted-resource( allotted-resource org.onap.relationships.inventory.BelongsTo service-instance, MANY2ONE)
+      - FROM metadatum( metadatum org.onap.relationships.inventory.BelongsTo service-instance, MANY2ONE)
+      - FROM service-instance( service-instance org.onap.relationships.inventory.ComposedOf service-instance, ONE2MANY)
+      - SERVICE-INSTANCE is DELETED when these are DELETED ALLOTTED-RESOURCE,METADATUM
+      - SERVICE-INSTANCE deletion means associated objects of these types are also DELETED:LOGICAL-LINK
+    required:
+    - service-instance-id
+    - service-type
+    - service-role
+    - created-at
+    - updated-at
+    - description
+    properties:
+      service-instance-id:
+        type: string
+        description: Uniquely identifies this instance of a service
+      service-instance-name:
+        type: string
+        description: This field will store a name assigned to the service-instance.
+      service-type:
+        type: string
+        description: String capturing type of service.
+      service-role:
+        type: string
+        description: String capturing the service role.
+      environment-context:
+        type: string
+        description: This field will store the environment context assigned to the service-instance.
+      workload-context:
+        type: string
+        description: This field will store the workload context assigned to the service-instance.
+      created-at:
+        type: string
+        description: create time of Network Service.
+      updated-at:
+        type: string
+        description: last update of Network Service.
+      description:
+        type: string
+        description: short description for service-instance.
+      model-invariant-id:
+        type: string
+        description: the ASDC model id for this resource or service model.
+      model-version-id:
+        type: string
+        description: the ASDC model version for this resource or service model.
+      persona-model-version:
+        type: string
+        description: the ASDC model version for this resource or service model.
+      widget-model-id:
+        type: string
+        description: the ASDC data dictionary widget model. This maps directly to the A&AI widget.
+      widget-model-version:
+        type: string
+        description: the ASDC data dictionary version of the widget model.This maps directly to the A&AI version of the widget.
+      bandwidth-total:
+        type: string
+        description: Indicates the total bandwidth to be used for this service.
+      bandwidth-up-wan1:
+        type: string
+        description: indicates the upstream bandwidth this service will use on the WAN1 port of the physical device.
+      bandwidth-down-wan1:
+        type: string
+        description: indicates the downstream bandwidth this service will use on the WAN1 port of the physical device.
+      bandwidth-up-wan2:
+        type: string
+        description: indicates the upstream bandwidth this service will use on the WAN2 port of the physical device.
+      bandwidth-down-wan2:
+        type: string
+        description: indicates the downstream bandwidth this service will use on the WAN2 port of the physical device.
+      vhn-portal-url:
+        type: string
+        description: URL customers will use to access the vHN Portal.
+      service-instance-location-id:
+        type: string
+        description: An identifier that customers assign to the location where this service is being used.
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      selflink:
+        type: string
+        description: Path to the controller object.
+      orchestration-status:
+        type: string
+        description: Orchestration status of this service.
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+      metadata:
+        type: array
+        items:
+          $ref: "#/definitions/metadatum"
+      allotted-resources:
+        type: array
+        items:
+          $ref: "#/definitions/allotted-resource"
+  service-instances:
+    description: |
+      Collection of service instances
+    properties:
+      service-instance:
+        type: array
+        items:          
+          $ref: "#/definitions/service-instance"
+  service-subscription:
+    description: |
+      Object that group service instances.
+      ###### Related Nodes
+      - TO customer( service-subscription org.onap.relationships.inventory.BelongsTo customer, MANY2ONE)
+      - TO tenant( service-subscription org.onap.relationships.inventory.Uses tenant, MANY2MANY)
+      - FROM service-instance( service-instance org.onap.relationships.inventory.BelongsTo service-subscription, MANY2ONE)
+      - SERVICE-SUBSCRIPTION is DELETED when these are DELETED SERVICE-INSTANCE
+    required:
+    - service-type
+    properties:
+      service-type:
+        type: string
+        description: Value defined by orchestration to identify this service across ECOMP.
+      temp-ub-sub-account-id:
+        type: string
+        description: This property will be deleted from A&AI in the near future. Only stop gap solution.
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      service-instances:
+        type: array
+        items:
+          $ref: "#/definitions/service-instance"
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+  service-subscriptions:
+    description: |
+      Collection of objects that group service instances.
+    properties:
+      service-subscription:
+        type: array
+        items:          
+          $ref: "#/definitions/service-subscription"
+  services:
+    description: |
+      Collection of service model definitions.  Likely to be deprecated in favor of models from ASDC.
+    properties:
+      service:
+        type: array
+        items:          
+          $ref: "#/definitions/service"
+  site-pair:
+    description: |
+      ###### Related Nodes
+      - TO routing-instance( site-pair org.onap.relationships.inventory.BelongsTo routing-instance, MANY2ONE)
+      - FROM class-of-service( class-of-service org.onap.relationships.inventory.BelongsTo site-pair, MANY2ONE)
+      - SITE-PAIR is DELETED when these are DELETED CLASS-OF-SERVICE
+    required:
+    - site-pair-id
+    properties:
+      site-pair-id:
+        type: string
+        description: unique identifier of probe
+      source-ip:
+        type: string
+        description: Prefix address
+      destination-ip:
+        type: string
+        description: Prefix address
+      ip-version:
+        type: string
+        description: ip version, v4, v6
+      destination-hostname:
+        type: string
+        description: Hostname of the destination equipment to which SLAs are measured against.
+      destination-equip-type:
+        type: string
+        description: The type of destinatination equipment. Could be Router, UCPE, etc.
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      classes-of-service:
+        type: array
+        items:
+          $ref: "#/definitions/class-of-service"
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+  site-pair-set:
+    description: |
+      Set of instances for probes used to measure service level agreements
+      ###### Related Nodes
+      - TO generic-vnf( site-pair-set org.onap.relationships.inventory.AppliesTo generic-vnf, MANY2MANY)
+      - FROM routing-instance( routing-instance org.onap.relationships.inventory.BelongsTo site-pair-set, MANY2ONE)
+      - SITE-PAIR-SET is DELETED when these are DELETED ROUTING-INSTANCE
+    required:
+    - site-pair-set-id
+    properties:
+      site-pair-set-id:
+        type: string
+        description: Unique id of site pair set.
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      routing-instances:
+        type: array
+        items:
+          $ref: "#/definitions/routing-instance"
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+  site-pair-sets:
+    description: |
+      Collection of sets of instances for probes related to generic-vnf
+    properties:
+      site-pair-set:
+        type: array
+        items:          
+          $ref: "#/definitions/site-pair-set"
+  site-pairs:
+    description: |
+      probe within a set
+    properties:
+      site-pair:
+        type: array
+        items:          
+          $ref: "#/definitions/site-pair"
+  snapshot:
+    description: |
+      Openstack snapshot
+      ###### Related Nodes
+      - TO cloud-region( snapshot org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE)
+      - FROM vserver( vserver org.onap.relationships.inventory.Uses snapshot, ONE2ONE)
+    required:
+    - snapshot-id
+    properties:
+      snapshot-id:
+        type: string
+        description: Snapshot id, this is the key UUID assoc associated in glance with the snapshots.
+      snapshot-name:
+        type: string
+        description: Snapshot name
+      snapshot-architecture:
+        type: string
+        description: Operating system architecture
+      snapshot-os-distro:
+        type: string
+        description: The common name of the operating system distribution in lowercase
+      snapshot-os-version:
+        type: string
+        description: The operating system version as specified by the distributor.
+      application:
+        type: string
+        description: The application that the image instantiates.
+      application-vendor:
+        type: string
+        description: The vendor of the application.
+      application-version:
+        type: string
+        description: The version of the application.
+      snapshot-selflink:
+        type: string
+        description: URL to endpoint where AAI can get more details
+      prev-snapshot-id:
+        type: string
+        description: This field contains the UUID of the previous snapshot (if any).
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+  snapshots:
+    description: |
+      Collection of openstack snapshots
+    properties:
+      snapshot:
+        type: array
+        items:          
+          $ref: "#/definitions/snapshot"
+  sriov-pf:
+    description: |
+      SR-IOV Physical Function
+      ###### Related Nodes
+      - TO p-interface( sriov-pf org.onap.relationships.inventory.BelongsTo p-interface, ONE2ONE)
+      - FROM sriov-vf( sriov-vf org.onap.relationships.inventory.Uses sriov-pf, MANY2ONE)
+    required:
+    - pf-pci-id
+    properties:
+      pf-pci-id:
+        type: string
+        description: Identifier for the sriov-pf
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+  sriov-pfs:
+    description: |
+      Collection of SR-IOV Physical Functions.
+    properties:
+      sriov-pf:
+        type: array
+        items:          
+          $ref: "#/definitions/sriov-pf"
+  sriov-vf:
+    description: |
+      SR-IOV Virtual Function (not to be confused with virtual network function)
+      ###### Related Nodes
+      - TO l-interface( sriov-vf org.onap.relationships.inventory.BelongsTo l-interface, ONE2ONE)
+      - TO sriov-pf( sriov-vf org.onap.relationships.inventory.Uses sriov-pf, MANY2ONE)
+    required:
+    - pci-id
+    properties:
+      pci-id:
+        type: string
+        description: PCI ID used to identify the sriov-vf
+      vf-vlan-filter:
+        type: string
+        description: This metadata provides option to specify list of VLAN filters applied on VF to pass the traffic to VM.
+      vf-mac-filter:
+        type: string
+        description: When MAC filters are specified, VF-agent service configures VFs to do MAC level filtering before the traffic is passed to VM.
+      vf-vlan-strip:
+        type: boolean
+        description: When this field is set to true, VF will configured to strip the outer TAG before the traffic is passed to VM.
+      vf-vlan-anti-spoof-check:
+        type: boolean
+        description: This option ensures anti VLAN spoof checks are done at the VF level to comply with security. The disable check will also be honored per the VNF needs for trusted VMs.
+      vf-mac-anti-spoof-check:
+        type: boolean
+        description: This option ensures anti MAC spoof checks are done at the VF level to comply with security. The disable check will also be honored per the VNF needs for trusted VMs.
+      vf-mirrors:
+        type: string
+        description: This option defines the set of Mirror objects which essentially mirrors the traffic from source to set of collector VNF Ports.
+      vf-broadcast-allow:
+        type: boolean
+        description: This option, if set to true, sets the VF in promiscuous mode and allows all broadcast traffic to reach the VM
+      vf-unknown-multicast-allow:
+        type: boolean
+        description: This option, if set to true, sets the VF in promiscuous mode and allows unknown multicast traffic to reach the VM
+      vf-unknown-unicast-allow:
+        type: boolean
+        description: This option, if set to true, sets the VF in promiscuous mode and allows unknown unicast traffic to reach the VM
+      vf-insert-stag:
+        type: boolean
+        description: This option, if set to true, instructs to insert outer tag after traffic comes out of VM.
+      vf-link-status:
+        type: string
+        description: This option is used to set the link status.  Valid values as of 1607 are on, off, and auto.
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      neutron-network-id:
+        type: string
+        description: Neutron network id of the interface
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+  sriov-vfs:
+    description: |
+      Collection of SR-IOV Virtual Functions.
+    properties:
+      sriov-vf:
+        type: array
+        items:          
+          $ref: "#/definitions/sriov-vf"
+  start-node-filter:
+    properties:
+      property-name:
+        type: string
+      property-value:
+        type: string
+  subnet:
+    description: |
+      ###### Related Nodes
+      - TO l3-network( subnet org.onap.relationships.inventory.BelongsTo l3-network, MANY2ONE)
+      - FROM l3-interface-ipv4-address-list( l3-interface-ipv4-address-list org.onap.relationships.inventory.network.MemberOf subnet, MANY2MANY)
+      - FROM l3-interface-ipv6-address-list( l3-interface-ipv6-address-list org.onap.relationships.inventory.network.MemberOf subnet, MANY2MANY)
+      - FROM host-route( host-route org.onap.relationships.inventory.BelongsTo subnet, MANY2ONE)
+      - FROM vip-ipv4-address-list( vip-ipv4-address-list org.onap.relationships.inventory.MemberOf subnet, MANY2MANY)
+      - FROM vip-ipv6-address-list( vip-ipv6-address-list org.onap.relationships.inventory.MemberOf subnet, MANY2MANY)
+      - SUBNET cannot be deleted if linked to L3-INTERFACE-IPV4-ADDRESS-LIST,L3-INTERFACE-IPV6-ADDRESS-LIST,VIP-IPV4-ADDRESS-LIST,VIP-IPV6-ADDRESS-LIST
+      - SUBNET is DELETED when these are DELETED HOST-ROUTE
+    required:
+    - subnet-id
+    - dhcp-enabled
+    properties:
+      subnet-id:
+        type: string
+        description: Subnet ID, should be UUID.
+      subnet-name:
+        type: string
+        description: Name associated with the subnet.
+      neutron-subnet-id:
+        type: string
+        description: Neutron id of this subnet
+      gateway-address:
+        type: string
+        description: gateway ip address
+      network-start-address:
+        type: string
+        description: network start address
+      cidr-mask:
+        type: string
+        description: cidr mask
+      ip-version:
+        type: string
+        description: ip version
+      orchestration-status:
+        type: string
+        description: Orchestration status of this VNF, mastered by MSO
+      dhcp-enabled:
+        type: boolean
+      dhcp-start:
+        type: string
+        description: the start address reserved for use by dhcp
+      dhcp-end:
+        type: string
+        description: the last address reserved for use by dhcp
+      subnet-role:
+        type: string
+        description: role of the subnet, referenced when assigning IPs
+      ip-assignment-direction:
+        type: string
+        description: ip address assignment direction of the subnet
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      subnet-sequence:
+        type: integer
+        format: int32
+        description: sequence of the subnet
+      host-routes:
+        type: array
+        items:
+          $ref: "#/definitions/host-route"
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+  subnets:
+    properties:
+      subnet:
+        type: array
+        items:          
+          $ref: "#/definitions/subnet"
+  tagged-inventory-item-list:
+    properties:
+      inventory-item:
+        type: array
+        items:          
+          $ref: "#/definitions/inventory-item"
+  tenant:
+    description: |
+      Openstack tenant
+      ###### Related Nodes
+      - TO cloud-region( tenant org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE)
+      - TO group-assignment( tenant org.onap.relationships.inventory.MemberOf group-assignment, MANY2MANY)
+      - TO l3-network( tenant org.onap.relationships.inventory.Uses l3-network, MANY2MANY)
+      - TO volume-group( tenant org.onap.relationships.inventory.DependsOn volume-group, ONE2MANY)
+      - FROM service-subscription( service-subscription org.onap.relationships.inventory.Uses tenant, MANY2MANY)
+      - FROM vserver( vserver org.onap.relationships.inventory.BelongsTo tenant, MANY2ONE)
+      - TENANT cannot be deleted if linked to VSERVER
+    required:
+    - tenant-id
+    - tenant-name
+    properties:
+      tenant-id:
+        type: string
+        description: Unique id relative to the cloud-region.
+      tenant-name:
+        type: string
+        description: Readable name of tenant
+      tenant-context:
+        type: string
+        description: This field will store the tenant context.
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      vservers:
+        type: array
+        items:
+          $ref: "#/definitions/vserver"
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+  tenants:
+    description: |
+      Collection of openstack tenants.
+    properties:
+      tenant:
+        type: array
+        items:          
+          $ref: "#/definitions/tenant"
+  tunnel-xconnect:
+    description: |
+      Represents the specifics of a tunnel cross connect piece of a resource that gets separately allotted
+      ###### Related Nodes
+      - TO allotted-resource( tunnel-xconnect org.onap.relationships.inventory.BelongsTo allotted-resource, ONE2ONE)
+    required:
+    - id
+    - bandwidth-up-wan1
+    - bandwidth-down-wan1
+    - bandwidth-up-wan2
+    - bandwidth-down-wan2
+    properties:
+      id:
+        type: string
+        description: Allotted Resource id UUID assigned to this instance.
+      bandwidth-up-wan1:
+        type: string
+        description: The WAN uplink bandwidth for WAN1
+      bandwidth-down-wan1:
+        type: string
+        description: The WAN downlink bandwidth for WAN1
+      bandwidth-up-wan2:
+        type: string
+        description: The WAN uplink bandwidth for WAN2
+      bandwidth-down-wan2:
+        type: string
+        description: The WAN downlink bandwidth for WAN2
+      resource-version:
+        type: string
+        description: Concurrency value
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+  tunnel-xconnects:
+    description: |
+      This object is used to store the specific tunnel cross connect aspects of an allotted resource
+    properties:
+      tunnel-xconnect:
+        type: array
+        items:          
+          $ref: "#/definitions/tunnel-xconnect"
+  update:
+    description: |
+      Serves a PATCH like function.  Does not enforce concurrency control.  Clear each usage with AAI team.
+    required:
+    - update-node-type
+    properties:
+      update-node-type:
+        type: string
+      update-node-key:
+        type: array
+        items:          
+          $ref: "#/definitions/update-node-key"
+      update-node-uri:
+        type: string
+      action:
+        type: array
+        items:          
+          $ref: "#/definitions/action"
+  update-node-key:
+    properties:
+      key-name:
+        type: string
+      key-value:
+        type: string
+  vce:
+    description: |
+      Virtual Customer Edge Router, used specifically for Gamma.  This object is deprecated.
+      ###### Related Nodes
+      - TO availability-zone( vce org.onap.relationships.inventory.Uses availability-zone, MANY2MANY)
+      - TO complex( vce org.onap.relationships.inventory.LocatedIn complex, MANY2MANY)
+      - TO vserver( vce tosca.relationships.HostedOn vserver, ONE2MANY)
+      - FROM entitlement( entitlement org.onap.relationships.inventory.BelongsTo vce, MANY2ONE)
+      - FROM license( license org.onap.relationships.inventory.BelongsTo vce, MANY2ONE)
+      - FROM port-group( port-group org.onap.relationships.inventory.BelongsTo vce, MANY2ONE)
+      - FROM service-instance( service-instance org.onap.relationships.inventory.ComposedOf vce, ONE2MANY)
+      - VCE is DELETED when these are DELETED ENTITLEMENT,LICENSE,PORT-GROUP
+    required:
+    - vnf-id
+    - vnf-name
+    - vnf-type
+    properties:
+      vnf-id:
+        type: string
+        description: Unique id of VNF.  This is unique across the graph.
+      vnf-name:
+        type: string
+        description: Name of VNF.
+      vnf-name2:
+        type: string
+        description: Alternate name of VNF.
+      vnf-type:
+        type: string
+        description: String capturing type of vnf, that was intended to identify the ASDC resource.  This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures.
+      service-id:
+        type: string
+        description: Unique identifier of service, does not strictly map to ASDC services, SOON TO BE DEPRECATED.
+      regional-resource-zone:
+        type: string
+        description: Regional way of organizing pservers, source of truth should define values
+      prov-status:
+        type: string
+        description: Trigger for operational monitoring of this resource by Service Assurance systems.
+      operational-status:
+        type: string
+        description: Indicator for whether the resource is considered operational
+      license-key:
+        type: string
+        description: OBSOLETE -  do not use
+      equipment-role:
+        type: string
+        description: Network role being played by this VNF
+      orchestration-status:
+        type: string
+        description: Orchestration status of this VNF, mastered by MSO
+      heat-stack-id:
+        type: string
+        description: Heat stack id corresponding to this instance, managed by MSO
+      mso-catalog-key:
+        type: string
+        description: Corresponds to the SDN-C catalog id used to configure this VCE
+      vpe-id:
+        type: string
+        description: Unique ID of VPE connected to this VCE.
+      v6-vce-wan-address:
+        type: string
+        description: Valid v6 IP address for the WAN Link on this router.  Implied length of /64.
+      ipv4-oam-address:
+        type: string
+        description: Address tail-f uses to configure vce, also used for troubleshooting and is IP used for traps generated by VCE.
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      ipv4-loopback0-address:
+        type: string
+        description: Loopback0 address
+      entitlement-resource-uuid:
+        type: string
+        description: OBSOLETE -  see child relationships
+      port-groups:
+        type: array
+        items:
+          $ref: "#/definitions/port-group"
+      licenses:
+        type: array
+        items:
+          $ref: "#/definitions/license"
+      entitlements:
+        type: array
+        items:
+          $ref: "#/definitions/entitlement"
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+  vces:
+    description: |
+      Collection of Virtual Customer Edge Routers, used specifically for Gamma.  This object is deprecated.
+    properties:
+      vce:
+        type: array
+        items:          
+          $ref: "#/definitions/vce"
+  vf-module:
+    description: |
+      a deployment unit of VNFCs
+      ###### Related Nodes
+      - TO generic-vnf( vf-module org.onap.relationships.inventory.BelongsTo generic-vnf, MANY2ONE)
+      - TO l3-network( vf-module org.onap.relationships.inventory.DependsOn l3-network, MANY2MANY)
+      - TO vnfc( vf-module org.onap.relationships.inventory.Uses vnfc, ONE2MANY)
+      - TO volume-group( vf-module org.onap.relationships.inventory.Uses volume-group, ONE2ONE)
+      - TO vserver( vf-module org.onap.relationships.inventory.Uses vserver, ONE2MANY)
+      - VF-MODULE cannot be deleted if linked to VNFC
+    required:
+    - vf-module-id
+    - is-base-vf-module
+    properties:
+      vf-module-id:
+        type: string
+        description: Unique ID of vf-module.
+      vf-module-name:
+        type: string
+        description: Name of vf-module
+      heat-stack-id:
+        type: string
+        description: Heat stack id corresponding to this instance.
+      orchestration-status:
+        type: string
+        description: orchestration status of this vf-module, mastered by MSO
+      is-base-vf-module:
+        type: boolean
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      model-invariant-id:
+        type: string
+        description: the ASDC model id for this resource or service model.
+      model-version-id:
+        type: string
+        description: the ASDC model version for this resource or service model.
+      persona-model-version:
+        type: string
+        description: the ASDC model version for this resource or service model.
+      model-customization-id:
+        type: string
+        description: captures the id of all the configuration used to customize the resource for the service.
+      widget-model-id:
+        type: string
+        description: the ASDC data dictionary widget model. This maps directly to the A&AI widget.
+      widget-model-version:
+        type: string
+        description: the ASDC data dictionary version of the widget model.This maps directly to the A&AI version of the widget.
+      contrail-service-instance-fqdn:
+        type: string
+        description: the Contrail unique ID for a service-instance
+      module-index:
+        type: integer
+        format: int32
+        description: the index will track the number of modules of a given type that have been deployed in a VNF, starting with 0, and always choosing the lowest available digit
+      selflink:
+        type: string
+        description: Path to the controller object.
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+  vf-modules:
+    description: |
+      Collection of vf-modules, a deployment unit of VNFCs
+    properties:
+      vf-module:
+        type: array
+        items:          
+          $ref: "#/definitions/vf-module"
+  vig-server:
+    description: |
+      vig-server contains information about a vig server used for IPSec-configuration. Populated by SDN-C from 1607
+      ###### Related Nodes
+      - TO ipsec-configuration( vig-server org.onap.relationships.inventory.BelongsTo ipsec-configuration, MANY2ONE)
+    required:
+    - vig-address-type
+    properties:
+      vig-address-type:
+        type: string
+        description: indicates whether the VIG is for AVPN or INTERNET
+      ipaddress-v4-vig:
+        type: string
+        description: v4 IP of the vig server
+      ipaddress-v6-vig:
+        type: string
+        description: v6 IP of the vig server
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+  vig-servers:
+    properties:
+      vig-server:
+        type: array
+        items:          
+          $ref: "#/definitions/vig-server"
+  vip-ipv4-address-list:
+    description: |
+      IPv4 Address Range
+      ###### Related Nodes
+      - TO cloud-region( vip-ipv4-address-list org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE)
+      - TO instance-group( vip-ipv4-address-list org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY)
+      - TO subnet( vip-ipv4-address-list org.onap.relationships.inventory.MemberOf subnet, MANY2MANY)
+      - FROM vnfc( vnfc org.onap.relationships.inventory.Uses vip-ipv4-address-list, MANY2MANY)
+    required:
+    - vip-ipv4-address
+    properties:
+      vip-ipv4-address:
+        type: string
+        description: IP address
+      vip-ipv4-prefix-length:
+        type: integer
+        format: int64
+        description: Prefix length, 32 for single address
+      vlan-id-inner:
+        type: integer
+        format: int64
+        description: Inner VLAN tag
+      vlan-id-outer:
+        type: integer
+        format: int64
+        description: Outer VLAN tag
+      is-floating:
+        type: boolean
+        description: Indicator of fixed or floating address
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      neutron-network-id:
+        type: string
+        description: Neutron network id of the interface that address belongs to
+      neutron-subnet-id:
+        type: string
+        description: Neutron id of subnet that address belongs to
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+  vip-ipv6-address-list:
+    description: |
+      IPv6 Address Range
+      ###### Related Nodes
+      - TO cloud-region( vip-ipv6-address-list org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE)
+      - TO instance-group( vip-ipv6-address-list org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY)
+      - TO subnet( vip-ipv6-address-list org.onap.relationships.inventory.MemberOf subnet, MANY2MANY)
+      - FROM vnfc( vnfc org.onap.relationships.inventory.Uses vip-ipv6-address-list, MANY2MANY)
+    required:
+    - vip-ipv6-address
+    properties:
+      vip-ipv6-address:
+        type: string
+        description: IP address
+      vip-ipv6-prefix-length:
+        type: integer
+        format: int64
+        description: Prefix length, 128 for single address
+      vlan-id-inner:
+        type: integer
+        format: int64
+        description: Inner VLAN tag
+      vlan-id-outer:
+        type: integer
+        format: int64
+        description: Outer VLAN tag
+      is-floating:
+        type: boolean
+        description: Indicator of fixed or floating address
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      neutron-network-id:
+        type: string
+        description: Neutron network id of the interface that address belongs to
+      neutron-subnet-id:
+        type: string
+        description: Neutron id of subnet that address belongs to
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+  virtual-data-center:
+    description: |
+      Virtual organization of cloud infrastructure elements in a data center context
+      ###### Related Nodes
+      - FROM connector( connector org.onap.relationships.inventory.LocatedIn virtual-data-center, MANY2MANY)
+      - FROM generic-vnf( generic-vnf org.onap.relationships.inventory.LocatedIn virtual-data-center, MANY2MANY)
+      - FROM logical-link( logical-link org.onap.relationships.inventory.LocatedIn virtual-data-center, MANY2MANY)
+    required:
+    - vdc-id
+    - vdc-name
+    properties:
+      vdc-id:
+        type: string
+        description: Unique ID of the vdc
+      vdc-name:
+        type: string
+        description: Name of the virtual data center
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+  virtual-data-centers:
+    description: |
+      Virtual organization of cloud infrastructure elements in a data center context
+    properties:
+      virtual-data-center:
+        type: array
+        items:          
+          $ref: "#/definitions/virtual-data-center"
+  vlan:
+    description: |
+      Definition of vlan
+      ###### Related Nodes
+      - TO l-interface( vlan tosca.relationships.network.LinksTo l-interface, MANY2ONE)
+      - TO logical-link( vlan org.onap.relationships.inventory.Uses logical-link, MANY2MANY)
+      - TO multicast-configuration( vlan org.onap.relationships.inventory.Uses multicast-configuration, MANY2MANY)
+      - FROM allotted-resource( allotted-resource org.onap.relationships.inventory.PartOf vlan, MANY2MANY)
+      - FROM service-instance( service-instance org.onap.relationships.inventory.ComposedOf vlan, ONE2MANY)
+      - FROM l3-interface-ipv4-address-list( l3-interface-ipv4-address-list org.onap.relationships.inventory.BelongsTo vlan, MANY2ONE)
+      - FROM l3-interface-ipv6-address-list( l3-interface-ipv6-address-list org.onap.relationships.inventory.BelongsTo vlan, MANY2ONE)
+      - VLAN is DELETED when these are DELETED L3-INTERFACE-IPV4-ADDRESS-LIST,L3-INTERFACE-IPV6-ADDRESS-LIST
+      - VLAN deletion means associated objects of these types are also DELETED:LOGICAL-LINK
+    required:
+    - vlan-interface
+    - in-maint
+    - is-ip-unnumbered
+    properties:
+      vlan-interface:
+        type: string
+        description: String that identifies the interface
+      vlan-id-inner:
+        type: integer
+        format: int64
+        description: Inner VLAN tag
+      vlan-id-outer:
+        type: integer
+        format: int64
+        description: Outer VLAN tag
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      speed-value:
+        type: string
+        description: Captures the numeric part of the speed
+      speed-units:
+        type: string
+        description: Captures the units corresponding to the speed
+      vlan-description:
+        type: string
+        description: Used to describe (the service associated with) the vlan
+      backdoor-connection:
+        type: string
+        description: Whether customer is going to use this VLAN for backdoor connection to another customer premise device.
+      vpn-key:
+        type: string
+        description: This indicates the customers VPN ID associated with this vlan
+      orchestration-status:
+        type: string
+        description: Status of a vnf's vlan interface, on which the customer circuit resides, mastered by SDN-C.
+      in-maint:
+        type: boolean
+      prov-status:
+        type: string
+        description: Prov Status of the VLAN configuration related to a logical interface. Valid values [PREPROV/NVTPROV/PROV].
+      is-ip-unnumbered:
+        type: boolean
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+      l3-interface-ipv4-address-list:
+        type: array
+        items:          
+          $ref: "#/definitions/l3-interface-ipv4-address-list"
+      l3-interface-ipv6-address-list:
+        type: array
+        items:          
+          $ref: "#/definitions/l3-interface-ipv6-address-list"
+  vlans:
+    properties:
+      vlan:
+        type: array
+        items:          
+          $ref: "#/definitions/vlan"
+  vnf:
+    description: |
+      Abstract vnf class
+    required:
+    - vnf-id
+    properties:
+      vnf-id:
+        type: string
+        description: Unique id of VNF.  This is unique across the graph.
+  vnf-image:
+    description: |
+      Image object that pertain to a VNF that doesn't have associated vservers.  This is a kludge.
+      ###### Related Nodes
+      - FROM generic-vnf( generic-vnf org.onap.relationships.inventory.Uses vnf-image, MANY2ONE)
+      - VNF-IMAGE cannot be deleted if linked to GENERIC-VNF
+    required:
+    - vnf-image-uuid
+    - application
+    - application-vendor
+    properties:
+      vnf-image-uuid:
+        type: string
+        description: Unique ID of this asset
+      application:
+        type: string
+        description: The application that the image instantiates.
+      application-vendor:
+        type: string
+        description: The vendor of the application.
+      application-version:
+        type: string
+        description: The version of the application.
+      selflink:
+        type: string
+        description: URL to endpoint where AAI can get more details
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+  vnf-images:
+    description: |
+      Collection of image objects that pertain to a VNF that doesn't have associated vservers.  This is a kludge.
+    properties:
+      vnf-image:
+        type: array
+        items:          
+          $ref: "#/definitions/vnf-image"
+  vnfc:
+    description: |
+      ###### Related Nodes
+      - TO generic-vnf( vnfc org.onap.relationships.inventory.BelongsTo generic-vnf, MANY2ONE)
+      - TO instance-group( vnfc org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY)
+      - TO vip-ipv4-address-list( vnfc org.onap.relationships.inventory.Uses vip-ipv4-address-list, MANY2MANY)
+      - TO vip-ipv6-address-list( vnfc org.onap.relationships.inventory.Uses vip-ipv6-address-list, MANY2MANY)
+      - TO vserver( vnfc tosca.relationships.HostedOn vserver, ONE2MANY)
+      - FROM vf-module( vf-module org.onap.relationships.inventory.Uses vnfc, ONE2MANY)
+      - FROM l3-interface-ipv4-address-list( l3-interface-ipv4-address-list org.onap.relationships.inventory.BelongsTo vnfc, MANY2ONE)
+      - FROM l3-interface-ipv6-address-list( l3-interface-ipv6-address-list org.onap.relationships.inventory.BelongsTo vnfc, MANY2ONE)
+      - VNFC is DELETED when these are DELETED L3-INTERFACE-IPV4-ADDRESS-LIST,L3-INTERFACE-IPV6-ADDRESS-LIST
+    required:
+    - vnfc-name
+    - nfc-naming-code
+    - nfc-function
+    - in-maint
+    - is-closed-loop-disabled
+    properties:
+      vnfc-name:
+        type: string
+        description: Unique ID of vnfc.
+      nfc-naming-code:
+        type: string
+        description: Short code that is used in naming instances of the item being modeled
+      nfc-function:
+        type: string
+        description: English description of function that the specific resource deployment is providing. Assigned as part of the customization of a resource in a service
+      prov-status:
+        type: string
+        description: prov status of this vnfc
+      orchestration-status:
+        type: string
+        description: Orchestration status of this VNF, mastered by APP-C
+      ipaddress-v4-oam-vip:
+        type: string
+        description: Oam V4 vip address of this vnfc
+      in-maint:
+        type: boolean
+      is-closed-loop-disabled:
+        type: boolean
+      group-notation:
+        type: string
+        description: Group notation of VNFC
+      model-invariant-id:
+        type: string
+        description: the ASDC model id for this resource or service model.
+      model-version-id:
+        type: string
+        description: the ASDC model version for this resource or service model.
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+      l3-interface-ipv4-address-list:
+        type: array
+        items:          
+          $ref: "#/definitions/l3-interface-ipv4-address-list"
+      l3-interface-ipv6-address-list:
+        type: array
+        items:          
+          $ref: "#/definitions/l3-interface-ipv6-address-list"
+  vnfcs:
+    description: |
+      virtual network components associated with a vserver from application controller.
+    properties:
+      vnfc:
+        type: array
+        items:          
+          $ref: "#/definitions/vnfc"
+  volume:
+    description: |
+      Ephemeral Block storage volume.
+      ###### Related Nodes
+      - FROM vserver (PARENT of volume, vserver tosca.relationships.AttachesTo volume)
+    required:
+    - volume-id
+    - volume-selflink
+    properties:
+      volume-id:
+        type: string
+        description: Unique ID of block storage volume relative to the vserver.
+      volume-selflink:
+        type: string
+        description: URL to endpoint where AAI can get more details
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+  volume-group:
+    description: |
+      Persistent block-level storage.
+      ###### Related Nodes
+      - TO cloud-region( volume-group org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE)
+      - TO complex( volume-group org.onap.relationships.inventory.LocatedIn complex, MANY2ONE)
+      - FROM generic-vnf( generic-vnf org.onap.relationships.inventory.DependsOn volume-group, ONE2MANY)
+      - FROM vf-module( vf-module org.onap.relationships.inventory.Uses volume-group, ONE2ONE)
+      - FROM tenant( tenant org.onap.relationships.inventory.DependsOn volume-group, ONE2MANY)
+    required:
+    - volume-group-id
+    - volume-group-name
+    - vnf-type
+    properties:
+      volume-group-id:
+        type: string
+        description: Unique ID of volume-group.
+      volume-group-name:
+        type: string
+        description: Name of the volume group.
+      heat-stack-id:
+        type: string
+        description: Heat stack id corresponding to this volume-group
+      vnf-type:
+        type: string
+        description: String capturing type of vnf, that was intended to identify the ASDC resource.  This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures.
+      orchestration-status:
+        type: string
+        description: Orchestration status of this volume-group
+      model-customization-id:
+        type: string
+        description: captures the id of all the configuration used to customize the resource for the service.
+      vf-module-model-customization-id:
+        type: string
+        description: helps relate the volume group to the vf-module whose components will require the volume group
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+  volume-groups:
+    description: |
+      Collection of persistent block-level storage.
+    properties:
+      volume-group:
+        type: array
+        items:          
+          $ref: "#/definitions/volume-group"
+  volumes:
+    description: |
+      Collection of ephemeral Block storage volumes.
+    properties:
+      volume:
+        type: array
+        items:          
+          $ref: "#/definitions/volume"
+  vpls-pe:
+    description: |
+      VPLS Provider Edge routers.
+      ###### Related Nodes
+      - TO complex( vpls-pe org.onap.relationships.inventory.LocatedIn complex, MANY2ONE)
+      - TO ctag-pool( vpls-pe org.onap.relationships.inventory.Uses ctag-pool, MANY2MANY)
+      - FROM lag-interface( lag-interface tosca.relationships.network.BindsTo vpls-pe, MANY2ONE)
+      - FROM p-interface( p-interface tosca.relationships.network.BindsTo vpls-pe, MANY2ONE)
+      - VPLS-PE is DELETED when these are DELETED LAG-INTERFACE,P-INTERFACE
+    required:
+    - equipment-name
+    properties:
+      equipment-name:
+        type: string
+      prov-status:
+        type: string
+        description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems.
+      ipv4-oam-address:
+        type: string
+        description: Address tail-f uses to configure generic-vnf, also used for troubleshooting and is IP used for traps generated by GenericVnf (v4-loopback0-ip-address).
+      equipment-role:
+        type: string
+        description: Client should send valid enumerated value, e.g., VPLS-PE.
+      vlan-id-outer:
+        type: integer
+        format: int64
+        description: Temporary location for stag to get to VCE
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+      p-interfaces:
+        type: array
+        items:
+          $ref: "#/definitions/p-interface"
+      lag-interfaces:
+        type: array
+        items:
+          $ref: "#/definitions/lag-interface"
+  vpls-pes:
+    description: |
+      Collection of VPLS Provider Edge routers
+    properties:
+      vpls-pe:
+        type: array
+        items:          
+          $ref: "#/definitions/vpls-pe"
+  vpn-binding:
+    description: |
+      VPN binding
+      ###### Related Nodes
+      - FROM allotted-resource( allotted-resource org.onap.relationships.inventory.BelongsTo vpn-binding, MANY2MANY)
+      - FROM l3-network( l3-network org.onap.relationships.inventory.Uses vpn-binding, MANY2MANY)
+      - FROM logical-link( logical-link org.onap.relationships.inventory.Uses vpn-binding, MANY2MANY)
+      - FROM route-target( route-target org.onap.relationships.inventory.BelongsTo vpn-binding, MANY2ONE)
+      - VPN-BINDING cannot be deleted if linked to ALLOTTED-RESOURCE,L3-NETWORK,LOGICAL-LINK
+      - VPN-BINDING is DELETED when these are DELETED ROUTE-TARGET
+    required:
+    - vpn-id
+    - vpn-name
+    properties:
+      vpn-id:
+        type: string
+        description: VPN ID, globally unique within A&AI
+      vpn-name:
+        type: string
+        description: VPN Name
+      vpn-platform:
+        type: string
+        description: the platform associated with the VPN example AVPN, Mobility
+      vpn-type:
+        type: string
+        description: Type of the vpn, should be taken from enumerated/valid values
+      vpn-region:
+        type: string
+        description: region of customer vpn
+      customer-vpn-id:
+        type: string
+        description: id for this customer vpn
+      route-distinguisher:
+        type: string
+        description: Used to distinguish the distinct VPN routes of separate customers who connect to the provider in an MPLS network.
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      route-targets:
+        type: array
+        items:
+          $ref: "#/definitions/route-target"
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+        description: l3-networks relate to vpn-bindings
+  vpn-bindings:
+    properties:
+      vpn-binding:
+        type: array
+        items:          
+          $ref: "#/definitions/vpn-binding"
+  vserver:
+    description: |
+      Virtual Servers, aka virtual machine or VM.
+      ###### Related Nodes
+      - TO tenant( vserver org.onap.relationships.inventory.BelongsTo tenant, MANY2ONE)
+      - TO flavor( vserver org.onap.relationships.inventory.Uses flavor, MANY2ONE)
+      - TO image( vserver org.onap.relationships.inventory.Uses image, MANY2ONE)
+      - TO pserver( vserver tosca.relationships.HostedOn pserver, MANY2ONE)
+      - TO snapshot( vserver org.onap.relationships.inventory.Uses snapshot, ONE2ONE)
+      - TO volume (CHILD of vserver, vserver tosca.relationships.AttachesTo volume, ONE2MANY)
+      - FROM generic-vnf( generic-vnf tosca.relationships.HostedOn vserver, ONE2MANY)
+      - FROM vce( vce tosca.relationships.HostedOn vserver, ONE2MANY)
+      - FROM l-interface( l-interface tosca.relationships.network.BindsTo vserver, MANY2ONE)
+      - FROM vf-module( vf-module org.onap.relationships.inventory.Uses vserver, ONE2MANY)
+      - FROM vnfc( vnfc tosca.relationships.HostedOn vserver, ONE2MANY)
+      - VSERVER is DELETED when these are DELETED L-INTERFACE
+      - VSERVER deletion means associated objects of these types are also DELETED:VOLUME
+    required:
+    - vserver-id
+    - vserver-name
+    - vserver-selflink
+    - in-maint
+    - is-closed-loop-disabled
+    properties:
+      vserver-id:
+        type: string
+        description: Unique identifier for this vserver relative to its tenant
+      vserver-name:
+        type: string
+        description: Name of vserver
+      vserver-name2:
+        type: string
+        description: Alternative name of vserver
+      prov-status:
+        type: string
+        description: Trigger for operational monitoring of this resource by Service Assurance systems.
+      vserver-selflink:
+        type: string
+        description: URL to endpoint where AAI can get more details
+      in-maint:
+        type: boolean
+      is-closed-loop-disabled:
+        type: boolean
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      volumes:
+        type: array
+        items:
+          $ref: "#/definitions/volume"
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+      l-interfaces:
+        type: array
+        items:
+          $ref: "#/definitions/l-interface"
+  vservers:
+    description: |
+      Collection of virtual Servers, aka virtual machines or VMs.
+    properties:
+      vserver:
+        type: array
+        items:          
+          $ref: "#/definitions/vserver"
+  zone:
+    description: |
+      A zone is a grouping of assets in a location homing to the same connections into the CBB
+      ###### Related Nodes
+      - TO complex( zone org.onap.relationships.inventory.LocatedIn complex, MANY2ONE)
+      - FROM cloud-region( cloud-region org.onap.relationships.inventory.LocatedIn zone, MANY2ONE)
+      - FROM pnf( pnf org.onap.relationships.inventory.LocatedIn zone, MANY2ONE)
+      - FROM pserver( pserver org.onap.relationships.inventory.LocatedIn zone, MANY2ONE)
+      - FROM service-instance( service-instance org.onap.relationships.inventory.LocatedIn zone, MANY2ONE)
+    required:
+    - zone-id
+    - zone-name
+    - design-type
+    - zone-context
+    properties:
+      zone-id:
+        type: string
+        description: Code assigned by AIC to the zone
+      zone-name:
+        type: string
+        description: English name associated with the zone
+      design-type:
+        type: string
+        description: Design of zone [Medium/Large?]
+      zone-context:
+        type: string
+        description: Context of zone [production/test]
+      status:
+        type: string
+        description: Status of a zone.
+      resource-version:
+        type: string
+        description: Concurrency value
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/definitions/relationship"
+  zones:
+    description: |
+      Collection of zones
+    properties:
+      zone:
+        type: array
+        items:          
+          $ref: "#/definitions/zone"
+patchDefinitions:
+  aai-internal:
+    properties:
+      property-name:
+        type: string
+      property-value:
+        type: string
+  action:
+    properties:
+      action-type:
+        type: string
+      action-data:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/action-data"
+  action-data:
+    properties:
+      property-name:
+        type: string
+      property-value:
+        type: string
+  actions:
+    description: |
+      APIs that are more action related than REST (e.g., notify, update).
+    properties:
+      update:
+        type: object
+        $ref: "#/patchDefinitions/update"
+      notify:
+        type: object
+        $ref: "#/patchDefinitions/notify"
+  allotted-resource:
+    description: |
+      Represents a slice or partial piece of a resource that gets separately allotted
+      ###### Related Nodes
+      - TO allotted-resource( allotted-resource tosca.relationships.network.BindsTo allotted-resource, ONE2ONE)
+      - TO generic-vnf( allotted-resource org.onap.relationships.inventory.PartOf generic-vnf, MANY2MANY)
+      - TO instance-group( allotted-resource org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY)
+      - TO l3-network( allotted-resource org.onap.relationships.inventory.PartOf l3-network, MANY2MANY)
+      - TO l-interface( allotted-resource org.onap.relationships.inventory.Uses l-interface, ONE2MANY)
+      - TO network-policy( allotted-resource org.onap.relationships.inventory.Uses network-policy, ONE2ONE)
+      - TO vlan( allotted-resource org.onap.relationships.inventory.PartOf vlan, MANY2MANY)
+      - TO vpn-binding( allotted-resource org.onap.relationships.inventory.BelongsTo vpn-binding, MANY2MANY)
+      - TO service-instance( allotted-resource org.onap.relationships.inventory.BelongsTo service-instance, MANY2ONE)
+      - FROM tunnel-xconnect( tunnel-xconnect org.onap.relationships.inventory.BelongsTo allotted-resource, ONE2ONE)
+      - FROM configuration( configuration org.onap.relationships.inventory.Uses allotted-resource, ONE2ONE)
+      - FROM service-instance( service-instance org.onap.relationships.inventory.Uses allotted-resource, MANY2MANY)
+      - FROM allotted-resource( allotted-resource tosca.relationships.network.BindsTo allotted-resource, ONE2ONE)
+      - ALLOTTED-RESOURCE is DELETED when these are DELETED TUNNEL-XCONNECT
+    required:
+    - id
+    properties:
+      id:
+        type: string
+        description: Allotted Resource id UUID assigned to this instance.
+      description:
+        type: string
+        description: The descriptive information assigned to this allotted resource instance
+      selflink:
+        type: string
+        description: Link back to more information in the controller
+      model-invariant-id:
+        type: string
+        description: the ASDC model id for this resource or service model.
+      model-version-id:
+        type: string
+        description: the ASDC model version for this resource or service model.
+      persona-model-version:
+        type: string
+        description: the ASDC model version for this resource or service model.
+  allotted-resources:
+    description: |
+      This object is used to store slices of services being offered
+    properties:
+      allotted-resource:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/allotted-resource"
+  availability-zone:
+    description: |
+      Availability zone, a collection of compute hosts/pservers
+      ###### Related Nodes
+      - TO complex( availability-zone org.onap.relationships.inventory.LocatedIn complex, MANY2ONE)
+      - TO service-capability( availability-zone org.onap.relationships.inventory.AppliesTo service-capability, MANY2MANY)
+      - TO cloud-region( availability-zone org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE)
+      - FROM ctag-pool( ctag-pool org.onap.relationships.inventory.AppliesTo availability-zone, MANY2MANY)
+      - FROM dvs-switch( dvs-switch org.onap.relationships.inventory.AppliesTo availability-zone, MANY2MANY)
+      - FROM generic-vnf( generic-vnf org.onap.relationships.inventory.Uses availability-zone, MANY2MANY)
+      - FROM pserver( pserver org.onap.relationships.inventory.MemberOf availability-zone, MANY2ONE)
+      - FROM vce( vce org.onap.relationships.inventory.Uses availability-zone, MANY2MANY)
+      - AVAILABILITY-ZONE cannot be deleted if linked to CTAG-POOL,DVS-SWITCH,GENERIC-VNF,PSERVER,VCE
+    required:
+    - availability-zone-name
+    - hypervisor-type
+    properties:
+      availability-zone-name:
+        type: string
+        description: Name of the availability zone.  Unique across a cloud region
+      hypervisor-type:
+        type: string
+        description: Type of hypervisor.  Source of truth should define valid values.
+      operational-status:
+        type: string
+        description: State that indicates whether the availability zone should be used, etc.  Source of truth should define valid values.
+  availability-zones:
+    description: |
+      Collection of availability zones
+    properties:
+      availability-zone:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/availability-zone"
+  az-and-dvs-switches:
+    properties:
+      dvs-switches:
+        type: object
+        $ref: "#/patchDefinitions/dvs-switches"
+      availability-zone:
+        type: object
+        $ref: "#/patchDefinitions/availability-zone"
+  business:
+    description: |
+      Namespace for business related constructs
+    properties:
+      connectors:
+        type: array
+        items:
+          $ref: "#/patchDefinitions/connector"
+      customers:
+        type: array
+        items:
+          $ref: "#/patchDefinitions/customer"
+      lines-of-business:
+        type: array
+        items:
+          $ref: "#/patchDefinitions/line-of-business"
+      owning-entities:
+        type: array
+        items:
+          $ref: "#/patchDefinitions/owning-entity"
+      platforms:
+        type: array
+        items:
+          $ref: "#/patchDefinitions/platform"
+      projects:
+        type: array
+        items:
+          $ref: "#/patchDefinitions/project"
+  class-of-service:
+    description: |
+      ###### Related Nodes
+      - TO site-pair( class-of-service org.onap.relationships.inventory.BelongsTo site-pair, MANY2ONE)
+    required:
+    - cos
+    properties:
+      cos:
+        type: string
+        description: unique identifier of probe
+      probe-id:
+        type: string
+        description: identifier of probe
+      probe-type:
+        type: string
+        description: type of probe
+  classes-of-service:
+    description: |
+      class-of-service of probe
+    properties:
+      class-of-service:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/class-of-service"
+  cloud-infrastructure:
+    description: |
+      Namespace for cloud infrastructure.
+    properties:
+      complexes:
+        type: array
+        items:
+          $ref: "#/patchDefinitions/complex"
+      cloud-regions:
+        type: array
+        items:
+          $ref: "#/patchDefinitions/cloud-region"
+      network-profiles:
+        type: array
+        items:
+          $ref: "#/patchDefinitions/network-profile"
+      pservers:
+        type: array
+        items:
+          $ref: "#/patchDefinitions/pserver"
+      virtual-data-centers:
+        type: array
+        items:
+          $ref: "#/patchDefinitions/virtual-data-center"
+  cloud-region:
+    description: |
+      cloud-region designates an installation of a cloud cluster or region or instantiation.
+      ###### Related Nodes
+      - TO esr-system-info (CHILD of cloud-region, cloud-region has esr-system-info, One2Many)
+      - TO complex( cloud-region org.onap.relationships.inventory.LocatedIn complex, MANY2ONE)
+      - TO l3-network( cloud-region org.onap.relationships.inventory.Uses l3-network, MANY2MANY)
+      - TO zone( cloud-region org.onap.relationships.inventory.LocatedIn zone, MANY2ONE)
+      - FROM availability-zone( availability-zone org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE)
+      - FROM dvs-switch( dvs-switch org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE)
+      - FROM flavor( flavor org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE)
+      - FROM group-assignment( group-assignment org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE)
+      - FROM image( image org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE)
+      - FROM oam-network( oam-network org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE)
+      - FROM snapshot( snapshot org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE)
+      - FROM tenant( tenant org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE)
+      - FROM vip-ipv4-address-list( vip-ipv4-address-list org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE)
+      - FROM vip-ipv6-address-list( vip-ipv6-address-list org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE)
+      - FROM volume-group( volume-group org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE)
+      - FROM logical-link( logical-link org.onap.relationships.inventory.LocatedIn cloud-region, MANY2MANY)
+      - FROM pserver( pserver org.onap.relationships.inventory.LocatedIn cloud-region, MANY2ONE)
+      - CLOUD-REGION cannot be deleted if linked to DVS-SWITCH,FLAVOR,GROUP-ASSIGNMENT,IMAGE,OAM-NETWORK,SNAPSHOT,TENANT,VIP-IPV4-ADDRESS-LIST,VIP-IPV6-ADDRESS-LIST,VOLUME-GROUP
+      - CLOUD-REGION is DELETED when these are DELETED AVAILABILITY-ZONE
+      - CLOUD-REGION deletion means associated objects of these types are also DELETED:ESR-SYSTEM-INFO
+    required:
+    - cloud-owner
+    - cloud-region-id
+    - sriov-automation
+    properties:
+      cloud-owner:
+        type: string
+        description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
+      cloud-region-id:
+        type: string
+        description: Identifier used by the vendor for the region. Second part of composite key
+      cloud-type:
+        type: string
+        description: Type of the cloud (e.g., openstack)
+      owner-defined-type:
+        type: string
+        description: Cloud-owner defined type indicator (e.g., dcp, lcp)
+      cloud-region-version:
+        type: string
+        description: Software version employed at the site.  NOTE - THIS FIELD IS NOT KEPT UP TO DATE.
+      identity-url:
+        type: string
+        description: URL of the keystone identity service
+      cloud-zone:
+        type: string
+        description: Zone where the cloud is homed.  NOTE - THIS FIELD IS NOT CORRECTLY POPULATED.
+      complex-name:
+        type: string
+        description: complex name for cloud-region instance.  NOTE - THIS FIELD IS NOT CORRECTLY POPULATED.
+      sriov-automation:
+        type: boolean
+      cloud-extra-info:
+        type: string
+        description: ESR inputs extra information about the VIM or Cloud which will be decoded by MultiVIM.
+      cloud-epa-caps:
+        type: string
+        description: MultiVIM will discover and expose EPA capabilities.
+  cloud-regions:
+    properties:
+      cloud-region:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/cloud-region"
+  complex:
+    description: |
+      Collection of physical locations that can house cloud-regions.
+      ###### Related Nodes
+      - TO l3-network( complex org.onap.relationships.inventory.Uses l3-network, MANY2MANY)
+      - FROM availability-zone( availability-zone org.onap.relationships.inventory.LocatedIn complex, MANY2ONE)
+      - FROM cloud-region( cloud-region org.onap.relationships.inventory.LocatedIn complex, MANY2ONE)
+      - FROM ctag-pool( ctag-pool org.onap.relationships.inventory.BelongsTo complex, MANY2ONE)
+      - FROM generic-vnf( generic-vnf org.onap.relationships.inventory.LocatedIn complex, MANY2MANY)
+      - FROM oam-network( oam-network org.onap.relationships.inventory.AppliesTo complex, MANY2MANY)
+      - FROM pnf( pnf org.onap.relationships.inventory.LocatedIn complex, MANY2ONE)
+      - FROM pserver( pserver org.onap.relationships.inventory.LocatedIn complex, MANY2ONE)
+      - FROM vce( vce org.onap.relationships.inventory.LocatedIn complex, MANY2MANY)
+      - FROM volume-group( volume-group org.onap.relationships.inventory.LocatedIn complex, MANY2ONE)
+      - FROM vpls-pe( vpls-pe org.onap.relationships.inventory.LocatedIn complex, MANY2ONE)
+      - FROM zone( zone org.onap.relationships.inventory.LocatedIn complex, MANY2ONE)
+      - COMPLEX cannot be deleted if linked to AVAILABILITY-ZONE,CLOUD-REGION,GENERIC-VNF,OAM-NETWORK,PNF,PSERVER,VCE,VOLUME-GROUP,VPLS-PE,ZONE
+      - COMPLEX is DELETED when these are DELETED CTAG-POOL
+    required:
+    - physical-location-id
+    - physical-location-type
+    - street1
+    - city
+    - postal-code
+    - country
+    - region
+    properties:
+      physical-location-id:
+        type: string
+        description: Unique identifier for physical location, e.g., CLLI
+      data-center-code:
+        type: string
+        description: Data center code which can be an alternate way to identify a complex
+      complex-name:
+        type: string
+        description: Gamma complex name for LCP instance.
+      identity-url:
+        type: string
+        description: URL of the keystone identity service
+  complexes:
+    description: |
+      Collection of physical locations that can house cloud-regions.
+    properties:
+      complex:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/complex"
+  configuration:
+    description: |
+      Port Mirror Configuration.
+      ###### Related Nodes
+      - TO allotted-resource( configuration org.onap.relationships.inventory.Uses allotted-resource, ONE2ONE)
+      - TO logical-link( configuration org.onap.relationships.inventory.Uses logical-link, ONE2MANY)
+      - FROM metadatum( metadatum org.onap.relationships.inventory.BelongsTo configuration, MANY2ONE)
+      - FROM generic-vnf( generic-vnf org.onap.relationships.inventory.Uses configuration, ONE2MANY)
+      - FROM service-instance( service-instance org.onap.relationships.inventory.Uses configuration, ONE2MANY)
+      - CONFIGURATION is DELETED when these are DELETED METADATUM
+      - CONFIGURATION deletion means associated objects of these types are also DELETED:ALLOTTED-RESOURCE,LOGICAL-LINK
+    required:
+    - configuration-id
+    - configuration-type
+    - configuration-sub-type
+    - orchestration-status
+    - operational-status
+    - configuration-selflink
+    - model-customization-id
+    properties:
+      configuration-id:
+        type: string
+        description: UUID assigned to configuration.
+      management-option:
+        type: string
+        description: Indicates the entity that will manage this feature. Could be an organization or the name of the application as well.
+      configuration-name:
+        type: string
+        description: Name of the configuration.
+      configuration-type:
+        type: string
+        description: port-mirroring-configuration.
+      configuration-sub-type:
+        type: string
+        description: vprobe, pprobe.
+      model-invariant-id:
+        type: string
+        description: the ASDC model id for this resource or service model.
+      model-version-id:
+        type: string
+        description: the ASDC model version for this resource or service model.
+      orchestration-status:
+        type: string
+        description: Orchestration status of the configuration.
+      operational-status:
+        type: string
+        description: Indicator for whether the resource is considered operational.
+      configuration-selflink:
+        type: string
+        description: URL to endpoint where AAI can get more details from SDN-GC.
+      model-customization-id:
+        type: string
+        description: id of  the configuration used to customize the resource
+  configurations:
+    description: |
+      Collection of configurations
+    properties:
+      configuration:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/configuration"
+  connector:
+    description: |
+      Collection of resource instances used to connect a variety of disparate inventory widgets
+      ###### Related Nodes
+      - TO virtual-data-center( connector org.onap.relationships.inventory.LocatedIn virtual-data-center, MANY2MANY)
+      - FROM metadatum( metadatum org.onap.relationships.inventory.BelongsTo connector, MANY2ONE)
+      - FROM service-instance( service-instance org.onap.relationships.inventory.Uses connector, MANY2MANY)
+      - CONNECTOR is DELETED when these are DELETED METADATUM
+    required:
+    - resource-instance-id
+    properties:
+      resource-instance-id:
+        type: string
+        description: Unique id of resource instance.
+  connectors:
+    description: |
+      Collection of resource instances used to connect a variety of disparate inventory widgets
+    properties:
+      connector:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/connector"
+  constrained-element-set:
+    description: |
+      This is how we would capture constraints defining allowed sets of elements.
+      ###### Related Nodes
+      - TO model-constraint( constrained-element-set org.onap.relationships.inventory.BelongsTo model-constraint, MANY2ONE)
+      - TO model-element( constrained-element-set org.onap.relationships.inventory.BelongsTo model-element, MANY2ONE)
+      - FROM element-choice-set( element-choice-set org.onap.relationships.inventory.BelongsTo constrained-element-set, MANY2ONE)
+      - CONSTRAINED-ELEMENT-SET is DELETED when these are DELETED ELEMENT-CHOICE-SET
+    required:
+    - constrained-element-set-uuid
+    - constraint-type
+    - check-type
+    properties:
+      constrained-element-set-uuid:
+        type: string
+      constraint-type:
+        type: string
+      check-type:
+        type: string
+  constrained-element-sets:
+    properties:
+      constrained-element-set:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/constrained-element-set"
+  ctag-assignment:
+    description: |
+      ###### Related Nodes
+      - TO l3-network( ctag-assignment org.onap.relationships.inventory.BelongsTo l3-network, MANY2ONE)
+      - FROM service-instance( service-instance org.onap.relationships.inventory.Uses ctag-assignment, ONE2MANY)
+    required:
+    - vlan-id-inner
+    properties:
+      vlan-id-inner:
+        type: integer
+        format: int64
+        description: id.
+  ctag-assignments:
+    properties:
+      ctag-assignment:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/ctag-assignment"
+  ctag-pool:
+    description: |
+      A collection of C tags (vlan tags) grouped for a specific purpose.
+      ###### Related Nodes
+      - TO complex( ctag-pool org.onap.relationships.inventory.BelongsTo complex, MANY2ONE)
+      - TO availability-zone( ctag-pool org.onap.relationships.inventory.AppliesTo availability-zone, MANY2MANY)
+      - FROM generic-vnf( generic-vnf org.onap.relationships.inventory.Uses ctag-pool, MANY2MANY)
+      - FROM vpls-pe( vpls-pe org.onap.relationships.inventory.Uses ctag-pool, MANY2MANY)
+    required:
+    - target-pe
+    - availability-zone-name
+    - ctag-pool-purpose
+    properties:
+      target-pe:
+        type: string
+        description: The Target provider edge router
+      availability-zone-name:
+        type: string
+        description: Name of the availability zone
+      ctag-pool-purpose:
+        type: string
+        description: Describes what the intended purpose of this pool is.
+      ctag-values:
+        type: string
+        description: Comma separated list of ctags
+  ctag-pools:
+    properties:
+      ctag-pool:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/ctag-pool"
+  customer:
+    description: |
+      customer identifiers to provide linkage back to BSS information.
+      ###### Related Nodes
+      - FROM service-subscription( service-subscription org.onap.relationships.inventory.BelongsTo customer, MANY2ONE)
+      - CUSTOMER is DELETED when these are DELETED SERVICE-SUBSCRIPTION
+    required:
+    - global-customer-id
+    - subscriber-name
+    - subscriber-type
+    properties:
+      global-customer-id:
+        type: string
+        description: Global customer id used across ECOMP to uniquely identify customer.
+      subscriber-name:
+        type: string
+        description: Subscriber name, an alternate way to retrieve a customer.
+      subscriber-type:
+        type: string
+        description: Subscriber type, a way to provide VID with only the INFRA customers.
+  customers:
+    description: |
+      Collection of customer identifiers to provide linkage back to BSS information.
+    properties:
+      customer:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/customer"
+  cvlan-tag-entry:
+    required:
+    - cvlan-tag
+    properties:
+      cvlan-tag:
+        type: integer
+        format: int64
+        description: See mis-na-virtualization-platform.yang
+  cvlan-tags:
+    properties:
+      cvlan-tag-entry:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/cvlan-tag-entry"
+  dvs-switch:
+    description: |
+      Digital virtual switch metadata, used by SDN-C to configure VCEs.  A&AI needs to receive this data from the PO deployment team and administer it using the provisioningTool.sh into A&AI. 
+      ###### Related Nodes
+      - TO cloud-region( dvs-switch org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE)
+      - TO availability-zone( dvs-switch org.onap.relationships.inventory.AppliesTo availability-zone, MANY2MANY)
+    required:
+    - switch-name
+    - vcenter-url
+    properties:
+      switch-name:
+        type: string
+        description: DVS switch name
+      vcenter-url:
+        type: string
+        description: URL used to reach the vcenter
+  dvs-switches:
+    description: |
+      Collection of digital virtual switch metadata used for vmWare VCEs and GenericVnfs.
+    properties:
+      dvs-switch:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/dvs-switch"
+  edge-prop-names:
+    description: |
+      Internal map to define the properties of an edge and interpret the map EdgeRules
+    properties:
+      edgeLabel:
+        type: string
+      direction:
+        type: string
+      multiplicityRule:
+        type: string
+      contains-other-v:
+        type: string
+      delete-other-v:
+        type: string
+      SVC-INFRA:
+        type: string
+      prevent-delete:
+        type: string
+  edge-tag-query-request:
+    properties:
+      edge-tag:
+        type: string
+      result-detail:
+        type: string
+      start-node-type:
+        type: string
+      start-node-filter:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/start-node-filter"
+      include-node-filter:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/include-node-filter"
+      secondary-filter:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/secondary-filter"
+  edge-tag-query-result:
+    properties:
+      tagged-inventory-item-list:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/tagged-inventory-item-list"
+  element-choice-set:
+    description: |
+      This is how we would capture constraints defining allowed sets of elements.
+      ###### Related Nodes
+      - TO constrained-element-set( element-choice-set org.onap.relationships.inventory.BelongsTo constrained-element-set, MANY2ONE)
+      - FROM model-element( model-element org.onap.relationships.inventory.BelongsTo element-choice-set, MANY2ONE)
+      - ELEMENT-CHOICE-SET is DELETED when these are DELETED MODEL-ELEMENT
+    required:
+    - element-choice-set-uuid
+    - element-choice-set-name
+    properties:
+      element-choice-set-uuid:
+        type: string
+      element-choice-set-name:
+        type: string
+      cardinality:
+        type: string
+  element-choice-sets:
+    properties:
+      element-choice-set:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/element-choice-set"
+  entitlement:
+    description: |
+      Metadata for entitlement group.
+      ###### Related Nodes
+      - TO generic-vnf( entitlement org.onap.relationships.inventory.BelongsTo generic-vnf, MANY2ONE)
+      - TO vce( entitlement org.onap.relationships.inventory.BelongsTo vce, MANY2ONE)
+    required:
+    - group-uuid
+    - resource-uuid
+    properties:
+      group-uuid:
+        type: string
+        description: Unique ID for the entitlement group the resource comes from, should be uuid.
+      resource-uuid:
+        type: string
+        description: Unique ID of an entitlement resource. 
+  entitlements:
+    description: |
+      Entitlements, keyed by group-uuid and resource-uuid, related to license management
+    properties:
+      entitlement:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/entitlement"
+  esr-ems:
+    description: |
+      Persist EMS address information used by EMS driver.
+      ###### Related Nodes
+      - TO esr-system-info (CHILD of esr-ems, esr-ems has esr-system-info, One2Many)
+      - ESR-EMS deletion means associated objects of these types are also DELETED:ESR-SYSTEM-INFO
+    required:
+    - ems-id
+    properties:
+      ems-id:
+        type: string
+        description: Unique ID of EMS.
+  esr-ems-list:
+    properties:
+      esr-ems:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/esr-ems"
+  esr-system-info:
+    description: |
+      Persist common address information of external systems.
+      ###### Related Nodes
+      - FROM esr-ems (PARENT of esr-system-info, esr-ems has esr-system-info)
+      - FROM esr-vnfm (PARENT of esr-system-info, esr-vnfm has esr-system-info)
+      - FROM esr-thirdparty-sdnc (PARENT of esr-system-info, esr-thirdparty-sdnc has esr-system-info)
+      - FROM cloud-region (PARENT of esr-system-info, cloud-region has esr-system-info)
+    required:
+    - esr-system-info-id
+    - user-name
+    - password
+    - system-type
+    properties:
+      esr-system-info-id:
+        type: string
+        description: Unique ID of esr system info.
+      system-name:
+        type: string
+        description: name of external system.
+      type:
+        type: string
+        description: type of external systems.
+      vendor:
+        type: string
+        description: vendor of external systems.
+      version:
+        type: string
+        description: version of external systems.
+      service-url:
+        type: string
+        description: url used to access external systems.
+      user-name:
+        type: string
+        description: username used to access external systems.
+      password:
+        type: string
+        description: password used to access external systems.
+      system-type:
+        type: string
+        description: it could be vim/vnfm/thirdparty-sdnc/ems-resource/ems-performance/ems-alarm.
+      protocol:
+        type: string
+        description: protocol of third party SDNC, for example netconf/snmp.
+      ssl-cacert:
+        type: string
+        description: ca file content if enabled ssl on auth-url.
+      ssl-insecure:
+        type: boolean
+        description: Whether to verify VIM's certificate.
+      ip-address:
+        type: string
+        description: service IP of ftp server.
+      port:
+        type: string
+        description: service port of ftp server.
+      cloud-domain:
+        type: string
+        description: domain info for authentication.
+      default-tenant:
+        type: string
+        description: default tenant of VIM.
+      passive:
+        type: boolean
+        description: ftp passive mode or not.
+      remote-path:
+        type: string
+        description: resource or performance data file path.
+      system-status:
+        type: string
+        description: the status of external system.
+  esr-system-info-list:
+    description: |
+      Collection of persistent block-level external system auth info.
+    properties:
+      esr-system-info:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/esr-system-info"
+  esr-thirdparty-sdnc:
+    description: |
+      Persist SDNC address information used by ONAP SDNC.
+      ###### Related Nodes
+      - TO esr-system-info (CHILD of esr-thirdparty-sdnc, esr-thirdparty-sdnc has esr-system-info, One2One)
+      - TO pnf( esr-thirdparty-sdnc has pnf, One2Many)
+      - ESR-THIRDPARTY-SDNC deletion means associated objects of these types are also DELETED:ESR-SYSTEM-INFO
+    required:
+    - thirdparty-sdnc-id
+    properties:
+      thirdparty-sdnc-id:
+        type: string
+        description: Unique ID of SDNC.
+      location:
+        type: string
+        description: used for DC type to indicate the location of SDNC, such as Core or Edge.
+      product-name:
+        type: string
+        description: password used to access SDNC server.
+  esr-thirdparty-sdnc-list:
+    properties:
+      esr-thirdparty-sdnc:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/esr-thirdparty-sdnc"
+  esr-vnfm:
+    description: |
+      Persist VNFM address information used by VF-C.
+      ###### Related Nodes
+      - TO esr-system-info (CHILD of esr-vnfm, esr-vnfm has esr-system-info, One2One)
+      - ESR-VNFM deletion means associated objects of these types are also DELETED:ESR-SYSTEM-INFO
+    required:
+    - vnfm-id
+    properties:
+      vnfm-id:
+        type: string
+        description: Unique ID of VNFM.
+      vim-id:
+        type: string
+        description: indecate the VIM to deploy VNF.
+      certificate-url:
+        type: string
+        description: certificate url of VNFM.
+  esr-vnfm-list:
+    properties:
+      esr-vnfm:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/esr-vnfm"
+  evc:
+    description: |
+      evc object is an optional child object of the Configuration object.
+      ###### Related Nodes
+      - TO configuration( evc org.onap.relationships.inventory.BelongsTo configuration, ONE2ONE)
+    required:
+    - evc-id
+    properties:
+      evc-id:
+        type: string
+        description: Unique/key field for the evc object
+      forwarding-path-topology:
+        type: string
+        description: Point-to-Point, Multi-Point
+      cir-value:
+        type: string
+        description: Commited Information Rate
+      cir-units:
+        type: string
+        description: CIR units
+      connection-diversity-group-id:
+        type: string
+        description: Diversity Group ID
+      service-hours:
+        type: string
+        description: formerly Performance Group
+      esp-evc-circuit-id:
+        type: string
+        description: EVC Circuit ID of ESP EVC
+      esp-evc-cir-value:
+        type: string
+        description: Committed Information Rate (For ESP)
+      esp-evc-cir-units:
+        type: string
+        description: CIR units (For ESP)
+      esp-itu-code:
+        type: string
+        description: Identifies ESP
+      collector-pop-clli:
+        type: string
+        description: Collector POP CLLI (from the hostname of the access pnf)
+      inter-connect-type-ingress:
+        type: string
+        description: Interconnect type on ingress side of EVC.
+      tagmode-access-ingress:
+        type: string
+        description: tagode for collector side of EVC
+      tagmode-access-egress:
+        type: string
+        description: tagMode for network side of EVC
+  evcs:
+    properties:
+      evc:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/evc"
+  external-system:
+    description: |
+      Namespace for external system.
+    properties:
+      esr-ems-list:
+        type: object
+        $ref: "#/patchDefinitions/esr-ems-list"
+      esr-vnfm-list:
+        type: object
+        $ref: "#/patchDefinitions/esr-vnfm-list"
+      esr-thirdparty-sdnc-list:
+        type: object
+        $ref: "#/patchDefinitions/esr-thirdparty-sdnc-list"
+  extra-properties:
+    description: |
+      Extra properties for inventory item for response list
+    properties:
+      extra-property:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/extra-property"
+  extra-property:
+    properties:
+      property-name:
+        type: string
+      property-value:
+        type: string
+  flavor:
+    description: |
+      Openstack flavor.
+      ###### Related Nodes
+      - TO cloud-region( flavor org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE)
+      - FROM vserver( vserver org.onap.relationships.inventory.Uses flavor, MANY2ONE)
+      - FLAVOR cannot be deleted if linked to VSERVER
+    required:
+    - flavor-id
+    - flavor-name
+    - flavor-selflink
+    properties:
+      flavor-id:
+        type: string
+        description: Flavor id, expected to be unique across cloud-region.
+      flavor-name:
+        type: string
+        description: Flavor name
+      flavor-vcpus:
+        type: integer
+        format: int32
+        description: Number of CPUs
+      flavor-ram:
+        type: integer
+        format: int32
+        description: Amount of memory
+      flavor-disk:
+        type: integer
+        format: int32
+        description: Disk space
+      flavor-ephemeral:
+        type: integer
+        format: int32
+        description: Amount of ephemeral disk space
+      flavor-swap:
+        type: string
+        description: amount of swap space allocation
+      flavor-is-public:
+        type: boolean
+        description: whether flavor is available to all users or private to the tenant it was created in.
+      flavor-selflink:
+        type: string
+        description: URL to endpoint where AAI can get more details
+      flavor-disabled:
+        type: boolean
+        description: Boolean as to whether this flavor is no longer enabled
+  flavors:
+    description: |
+      Collection of openstack flavors.
+    properties:
+      flavor:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/flavor"
+  forwarder:
+    description: |
+      Entity describing a sequenced segment of forwarding path
+      ###### Related Nodes
+      - TO forwarding-path( forwarder org.onap.relationships.inventory.BelongsTo forwarding-path, MANY2ONE)
+      - TO l-interface( forwarder org.onap.relationships.inventory.ForwardsTo l-interface, MANY2ONE)
+      - TO configuration( forwarder org.onap.relationships.inventory.Uses configuration, ONE2ONE)
+      - TO lag-interface( forwarder org.onap.relationships.inventory.ForwardsTo lag-interface, MANY2ONE)
+      - TO p-interface( forwarder org.onap.relationships.inventory.ForwardsTo p-interface, MANY2ONE)
+      - FORWARDER deletion means associated objects of these types are also DELETED:CONFIGURATION
+    required:
+    - sequence
+    properties:
+      sequence:
+        type: integer
+        format: int32
+        description: Unique ID of this segmentation
+      forwarder-role:
+        type: string
+        description: ingress, intermediate, egress
+  forwarder-evc:
+    description: |
+      forwarder object is an optional child object of the Configuration object.
+      ###### Related Nodes
+      - TO configuration( forwarder-evc org.onap.relationships.inventory.BelongsTo configuration, ONE2ONE)
+    required:
+    - forwarder-evc-id
+    properties:
+      forwarder-evc-id:
+        type: string
+        description: Key for forwarder-evc object
+      circuit-id:
+        type: string
+        description: Circuit ID from customer/ESP/ingress end of EVC, or reference to beater circuit on gateway/network/egress end of EVC
+      ivlan:
+        type: string
+        description: Internal VLAN.
+      svlan:
+        type: string
+        description: SVLAN value for ingress of egress forwarder.
+      cvlan:
+        type: string
+        description: CVLAN value for ingress of egress forwarder.
+  forwarder-evcs:
+    properties:
+      forwarder-evc:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/forwarder-evc"
+  forwarders:
+    properties:
+      forwarder:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/forwarder"
+  forwarding-path:
+    description: |
+      Entity that describes the sequenced forwarding path between interfaces of services or resources
+      ###### Related Nodes
+      - TO service-instance( forwarding-path org.onap.relationships.inventory.AppliesTo service-instance, MANY2ONE)
+      - TO configuration( forwarding-path org.onap.relationships.inventory.Uses configuration, ONE2ONE)
+      - FROM forwarder( forwarder org.onap.relationships.inventory.BelongsTo forwarding-path, MANY2ONE)
+      - FORWARDING-PATH is DELETED when these are DELETED FORWARDER
+      - FORWARDING-PATH deletion means associated objects of these types are also DELETED:CONFIGURATION
+    required:
+    - forwarding-path-id
+    - forwarding-path-name
+    properties:
+      forwarding-path-id:
+        type: string
+        description: Unique ID of this FP
+      forwarding-path-name:
+        type: string
+        description: Name of the FP
+  forwarding-paths:
+    properties:
+      forwarding-path:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/forwarding-path"
+  generic-vnf:
+    description: |
+      General purpose VNF
+      ###### Related Nodes
+      - TO availability-zone( generic-vnf org.onap.relationships.inventory.Uses availability-zone, MANY2MANY)
+      - TO complex( generic-vnf org.onap.relationships.inventory.LocatedIn complex, MANY2MANY)
+      - TO configuration( generic-vnf org.onap.relationships.inventory.Uses configuration, ONE2MANY)
+      - TO ctag-pool( generic-vnf org.onap.relationships.inventory.Uses ctag-pool, MANY2MANY)
+      - TO instance-group( generic-vnf org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY)
+      - TO ipsec-configuration( generic-vnf org.onap.relationships.inventory.Uses ipsec-configuration, MANY2ONE)
+      - TO l3-network( generic-vnf org.onap.relationships.inventory.Uses l3-network, MANY2MANY)
+      - TO license-key-resource( generic-vnf org.onap.relationships.inventory.Uses license-key-resource, MANY2MANY)
+      - TO pnf( generic-vnf tosca.relationships.HostedOn pnf, MANY2MANY)
+      - TO pserver( generic-vnf tosca.relationships.HostedOn pserver, MANY2MANY)
+      - TO vnf-image( generic-vnf org.onap.relationships.inventory.Uses vnf-image, MANY2ONE)
+      - TO volume-group( generic-vnf org.onap.relationships.inventory.DependsOn volume-group, ONE2MANY)
+      - TO vserver( generic-vnf tosca.relationships.HostedOn vserver, ONE2MANY)
+      - TO virtual-data-center( generic-vnf org.onap.relationships.inventory.LocatedIn virtual-data-center, MANY2MANY)
+      - FROM allotted-resource( allotted-resource org.onap.relationships.inventory.PartOf generic-vnf, MANY2MANY)
+      - FROM entitlement( entitlement org.onap.relationships.inventory.BelongsTo generic-vnf, MANY2ONE)
+      - FROM vnfc( vnfc org.onap.relationships.inventory.BelongsTo generic-vnf, MANY2ONE)
+      - FROM lag-interface( lag-interface org.onap.relationships.inventory.BelongsTo generic-vnf, MANY2ONE)
+      - FROM license( license org.onap.relationships.inventory.BelongsTo generic-vnf, MANY2ONE)
+      - FROM l-interface( l-interface org.onap.relationships.inventory.BelongsTo generic-vnf, MANY2ONE)
+      - FROM network-profile( network-profile org.onap.relationships.inventory.AppliesTo generic-vnf, MANY2MANY)
+      - FROM service-instance( service-instance org.onap.relationships.inventory.ComposedOf generic-vnf, ONE2MANY)
+      - FROM site-pair-set( site-pair-set org.onap.relationships.inventory.AppliesTo generic-vnf, MANY2MANY)
+      - FROM vf-module( vf-module org.onap.relationships.inventory.BelongsTo generic-vnf, MANY2ONE)
+      - FROM line-of-business( line-of-business org.onap.relationships.inventory.Uses generic-vnf, MANY2MANY)
+      - FROM logical-link( logical-link org.onap.relationships.inventory.BridgedTo generic-vnf, MANY2MANY)
+      - FROM platform( platform org.onap.relationships.inventory.Uses generic-vnf, MANY2MANY)
+      - GENERIC-VNF is DELETED when these are DELETED ENTITLEMENT,VNFC,LAG-INTERFACE,LICENSE,L-INTERFACE,VF-MODULE
+      - GENERIC-VNF deletion means associated objects of these types are also DELETED:CONFIGURATION
+    required:
+    - vnf-id
+    - vnf-instance-id
+    - vnf-name
+    - vnf-type
+    - vnf-package-name
+    - vnf-discriptor-name
+    - job-id
+    - in-maint
+    - is-closed-loop-disabled
+    properties:
+      vnf-id:
+        type: string
+        description: Unique id of VNF.  This is unique across the graph.
+      vnf-instance-id:
+        type: string
+        description: vnf instance id.
+      vnf-name:
+        type: string
+        description: Name of VNF.
+      vnf-name2:
+        type: string
+        description: Alternate name of VNF.
+      vnf-type:
+        type: string
+        description: String capturing type of vnf, that was intended to identify the ASDC resource.  This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures.
+      service-id:
+        type: string
+        description: Unique identifier of service, does not necessarily map to ASDC service models.  SOON TO BE DEPRECATED
+      regional-resource-zone:
+        type: string
+        description: Regional way of organizing pservers, source of truth should define values
+      prov-status:
+        type: string
+        description: Trigger for operational monitoring of this resource by Service Assurance systems.
+      operational-status:
+        type: string
+        description: Indicator for whether the resource is considered operational.  Valid values are in-service-path and out-of-service-path.
+      license-key:
+        type: string
+        description: OBSOLETE -  do not use
+      equipment-role:
+        type: string
+        description: Client should send valid enumerated value
+      orchestration-status:
+        type: string
+        description: Orchestration status of this VNF, used by MSO.
+      vnf-package-name:
+        type: string
+      vnf-discriptor-name:
+        type: string
+        description: vnf discriptor name
+      job-id:
+        type: string
+        description: job id corresponding to vnf
+      heat-stack-id:
+        type: string
+        description: Heat stack id corresponding to this instance, managed by MSO
+      mso-catalog-key:
+        type: string
+        description: Corresponds to the SDN-C catalog id used to configure this VCE
+      management-option:
+        type: string
+        description: identifier of managed by ATT or customer
+      ipv4-oam-address:
+        type: string
+        description: Address tail-f uses to configure generic-vnf, also used for troubleshooting and is IP used for traps generated by generic-vnf.
+      ipv4-loopback0-address:
+        type: string
+        description: v4 Loopback0 address
+      nm-lan-v6-address:
+        type: string
+        description: v6 Loopback address
+      management-v6-address:
+        type: string
+        description: v6 management address
+      vcpu:
+        type: integer
+        format: int64
+        description: number of vcpus ordered for this instance of VNF, used for VNFs with no vservers/flavors, to be used only by uCPE
+      vcpu-units:
+        type: string
+        description: units associated with vcpu, used for VNFs with no vservers/flavors, to be used only by uCPE
+      vmemory:
+        type: integer
+        format: int64
+        description: number of GB of memory ordered for this instance of VNF, used for VNFs with no vservers/flavors, to be used only by uCPE
+      vmemory-units:
+        type: string
+        description: units associated with vmemory, used for VNFs with no vservers/flavors, to be used only by uCPE
+      vdisk:
+        type: integer
+        format: int64
+        description: number of vdisks ordered for this instance of VNF, used for VNFs with no vservers/flavors, to be used only uCPE
+      vdisk-units:
+        type: string
+        description: units associated with vdisk, used for VNFs with no vservers/flavors, to be used only by uCPE
+      nshd:
+        type: integer
+        format: int64
+        description: number of associated SHD in vnf.
+      nvm:
+        type: integer
+        format: int64
+        description: number of vms in vnf.
+      nnet:
+        type: integer
+        format: int64
+        description: number of network in vnf.
+      in-maint:
+        type: boolean
+      is-closed-loop-disabled:
+        type: boolean
+  generic-vnfs:
+    description: |
+      Collection of VNFs
+    properties:
+      generic-vnf:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/generic-vnf"
+  group-assignment:
+    description: |
+      Openstack group-assignment used to store exclusivity groups (EG).
+      ###### Related Nodes
+      - TO cloud-region( group-assignment org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE)
+      - FROM pserver( pserver org.onap.relationships.inventory.MemberOf group-assignment, MANY2ONE)
+      - FROM tenant( tenant org.onap.relationships.inventory.MemberOf group-assignment, MANY2MANY)
+    required:
+    - group-id
+    - group-type
+    - group-name
+    properties:
+      group-id:
+        type: string
+        description: Group id, expected to be unique across cloud-region.
+      group-type:
+        type: string
+        description: Group type - the type of group this instance refers to
+      group-name:
+        type: string
+        description: Group name - name assigned to the group
+      group-description:
+        type: string
+        description: Group description - description of the group
+  group-assignments:
+    description: |
+      Collection of openstack group assignments
+    properties:
+      group-assignment:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/group-assignment"
+  host-route:
+    description: |
+      ###### Related Nodes
+      - TO subnet( host-route org.onap.relationships.inventory.BelongsTo subnet, MANY2ONE)
+    required:
+    - host-route-id
+    - route-prefix
+    - next-hop
+    properties:
+      host-route-id:
+        type: string
+        description: host-route id
+      route-prefix:
+        type: string
+        description: subnet prefix
+      next-hop:
+        type: string
+        description: Could be ip-address, hostname, or service-instance
+      next-hop-type:
+        type: string
+        description: Should be ip-address, hostname, or service-instance to match next-hop
+  host-routes:
+    properties:
+      host-route:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/host-route"
+  hpa-capabilities:
+    description: |
+      Collection of HPA Capabilities
+    properties:
+      hpa-capability:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/hpa-capability"
+  hpa-capability:
+    description: |
+      Represents a HPA capability
+      ###### Related Nodes
+      - TO flavor( hpa-capability org.onap.relationships.inventory.BelongsTo flavor, MANY2ONE)
+      - TO cloud-region( hpa-capability org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE)
+      - FROM hpa-feature-attributes( hpa-feature-attributes org.onap.relationships.inventory.BelongsTo hpa-capability, MANY2ONE)
+      - HPA-CAPABILITY is DELETED when these are DELETED HPA-FEATURE-ATTRIBUTES
+    required:
+    - hpa-capability-id
+    - hpa-feature
+    properties:
+      hpa-capability-id:
+        type: string
+        description: UUID to uniquely identify a HPA capability
+      hpa-feature:
+        type: string
+        description: Name of the HPACapability
+      hpa-version:
+        type: string
+        description: HPA schema version
+      hpa-hw-arch:
+        type: string
+        description: Hardware architecture
+  hpa-feature-attributes:
+    description: |
+      HPA Capability Feature attributes
+      ###### Related Nodes
+      - TO hpa-capability( hpa-feature-attributes org.onap.relationships.inventory.BelongsTo hpa-capability, MANY2ONE)
+    properties:
+      hpa-attr-key:
+        type: string
+        description: name of the specific HPA attribute
+      hpa-attr-value:
+        type: string
+        description: JSON string specifying the value, unit and type of the specific HPA attribute
+  image:
+    description: |
+      Openstack image.
+      ###### Related Nodes
+      - TO cloud-region( image org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE)
+      - FROM metadatum( metadatum org.onap.relationships.inventory.BelongsTo image, MANY2ONE)
+      - FROM vserver( vserver org.onap.relationships.inventory.Uses image, MANY2ONE)
+      - IMAGE cannot be deleted if linked to VSERVER
+      - IMAGE is DELETED when these are DELETED METADATUM
+    required:
+    - image-id
+    - image-name
+    - image-os-distro
+    - image-os-version
+    - image-selflink
+    properties:
+      image-id:
+        type: string
+        description: Image id, expected to be unique across cloud region
+      image-name:
+        type: string
+        description: Image name
+      image-architecture:
+        type: string
+        description: Operating system architecture.
+      image-os-distro:
+        type: string
+        description: The common name of the operating system distribution in lowercase
+      image-os-version:
+        type: string
+        description: The operating system version as specified by the distributor.
+      application:
+        type: string
+        description: The application that the image instantiates.
+      application-vendor:
+        type: string
+        description: The vendor of the application.
+      application-version:
+        type: string
+        description: The version of the application.
+      image-selflink:
+        type: string
+        description: URL to endpoint where AAI can get more details
+  images:
+    description: |
+      Collectio of Openstack images.
+    properties:
+      image:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/image"
+  include-node-filter:
+    properties:
+      include-node-type:
+        type: string
+  instance-filter:
+    description: |
+      InstanceFilter for performing a named-query or model query
+  instance-filters:
+    description: |
+      InstanceFilters for performing a named-query or model query
+    properties:
+      instance-filter:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/instance-filter"
+  instance-group:
+    description: |
+      General mechanism for grouping instances
+      ###### Related Nodes
+      - TO model( instance-group org.onap.relationships.inventory.Targets model, MANY2MANY)
+      - FROM allotted-resource( allotted-resource org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY)
+      - FROM generic-vnf( generic-vnf org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY)
+      - FROM l3-interface-ipv4-address-list( l3-interface-ipv4-address-list org.onap.relationships.inventory.network.MemberOf instance-group, MANY2MANY)
+      - FROM l3-interface-ipv6-address-list( l3-interface-ipv6-address-list org.onap.relationships.inventory.network.MemberOf instance-group, MANY2MANY)
+      - FROM l3-network( l3-network org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY)
+      - FROM l-interface( l-interface org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY)
+      - FROM pnf( pnf org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY)
+      - FROM service-instance( service-instance org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY)
+      - FROM vip-ipv4-address-list( vip-ipv4-address-list org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY)
+      - FROM vip-ipv6-address-list( vip-ipv6-address-list org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY)
+      - FROM vnfc( vnfc org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY)
+    required:
+    - instance-group-role
+    - model-invariant-id
+    - model-version-id
+    - id
+    - description
+    - type
+    properties:
+      instance-group-role:
+        type: string
+        description: role of the instance group.
+      model-invariant-id:
+        type: string
+        description: ASDC model id for this resource or service model.
+      model-version-id:
+        type: string
+        description: ASDC model version uid for this resource model.
+      id:
+        type: string
+        description: Instance Group ID, UUID assigned to this instance.
+      description:
+        type: string
+        description: Descriptive text to help identify the usage of this instance-group
+      type:
+        type: string
+        description: Only valid value today is lower case ha for high availability
+      sub-type:
+        type: string
+        description: Valid values for ha type are [geo-activeactive, geo-activestandby, local-activeactive, local-activestandby]
+  instance-groups:
+    description: |
+      Collection of openstack route table references
+    properties:
+      instance-group:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/instance-group"
+  inventory:
+    properties:
+      search:
+        type: object
+        $ref: "#/patchDefinitions/search"
+      actions:
+        type: object
+        $ref: "#/patchDefinitions/actions"
+      cloud-infrastructure:
+        type: object
+        $ref: "#/patchDefinitions/cloud-infrastructure"
+      external-system:
+        type: object
+        $ref: "#/patchDefinitions/external-system"
+      business:
+        type: object
+        $ref: "#/patchDefinitions/business"
+      service-design-and-creation:
+        type: object
+        $ref: "#/patchDefinitions/service-design-and-creation"
+      network:
+        type: object
+        $ref: "#/patchDefinitions/network"
+      aai-internal:
+        type: object
+        $ref: "#/patchDefinitions/aai-internal"
+      nodes:
+        type: array
+        items:
+          $ref: "#/patchDefinitions/aai-internal"
+  inventory-item:
+    properties:
+      inventory-item-type:
+        type: string
+      inventory-item-link:
+        type: string
+      inventory-item-data:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/inventory-item-data"
+      tagged-inventory-item-list:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/tagged-inventory-item-list"
+  inventory-item-data:
+    properties:
+      property-name:
+        type: string
+      property-value:
+        type: string
+  inventory-response-item:
+    description: |
+      Inventory item for response list
+    properties:
+      model-name:
+        type: string
+      extra-properties:
+        type: object
+        $ref: "#/patchDefinitions/extra-properties"
+      inventory-response-items:
+        type: object
+        $ref: "#/patchDefinitions/inventory-response-items"
+  inventory-response-items:
+    description: |
+      Container for inventory items in response list
+    properties:
+      inventory-response-item:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/inventory-response-item"
+  ipsec-configuration:
+    description: |
+      IPSec configuration node will contain various configuration data for the NMTE VNF. This node will have an edge to the generic-vnf (vnf type = TE). Starting 1607, this data will be populated by SDN-C
+      ###### Related Nodes
+      - FROM generic-vnf( generic-vnf org.onap.relationships.inventory.Uses ipsec-configuration, MANY2ONE)
+      - FROM vig-server( vig-server org.onap.relationships.inventory.BelongsTo ipsec-configuration, MANY2ONE)
+      - IPSEC-CONFIGURATION is DELETED when these are DELETED VIG-SERVER
+    required:
+    - ipsec-configuration-id
+    properties:
+      ipsec-configuration-id:
+        type: string
+        description: UUID of this configuration
+      requested-vig-address-type:
+        type: string
+        description: Indicate the type of VIG server like AVPN, INTERNET, BOTH
+      requested-encryption-strength:
+        type: string
+        description: Encryption values like 3des-cbc, des-cbc, aes-128-cbc, aes-192-cbc, aes-265-cbc
+      requested-dmz-type:
+        type: string
+        description: ATT can offer a shared DMZ or a DMZ specific to a customer
+      shared-dmz-network-address:
+        type: string
+        description: Network address of shared DMZ
+      requested-customer-name:
+        type: string
+        description: If the DMZ is a custom DMZ, this field will indicate the customer information
+      ike-version:
+        type: string
+        description: can be 1 or 2
+      ikev1-authentication:
+        type: string
+        description: Contains values like md5, sha1, sha256, sha384
+      ikev1-encryption:
+        type: string
+        description: Encyption values like 3des-cbc, des-cbc, aes-128-cbc,?aes-192-cbc, aes-265-cbc
+      ikev1-dh-group:
+        type: string
+        description: Diffie-Hellman group like DH-GROUP2, DH-GROUP5, DH-GROUP14
+      ikev1-am-group-id:
+        type: string
+        description: Group name defined in VIG for clients using aggressive mode
+      ikev1-am-password:
+        type: string
+        description: pre-shared key for the above group name 
+      ikev1-sa-lifetime:
+        type: string
+        description: Lifetime for IKEv1 SA
+      ipsec-authentication:
+        type: string
+        description: md5, sha1, sha256, sha384
+      ipsec-encryption:
+        type: string
+        description: 3des-cbc, des-cbc, aes-128-cbc,?aes-192-cbc, aes-265-cbc
+      ipsec-sa-lifetime:
+        type: string
+        description: Life time for IPSec SA
+      ipsec-pfs:
+        type: string
+        description: enable PFS or not
+      xauth-userid:
+        type: string
+        description: user ID for xAuth, sm-user,ucpeHostName,nmteHostName
+      xauth-user-password:
+        type: string
+        description: Encrypted using the Juniper $9$ algorithm
+      dpd-interval:
+        type: string
+        description: The time between DPD probe
+      dpd-frequency:
+        type: string
+        description: Maximum number of DPD before claiming the tunnel is down
+  ipsec-configurations:
+    properties:
+      ipsec-configuration:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/ipsec-configuration"
+  key-data:
+    properties:
+      key-name:
+        type: string
+      key-value:
+        type: string
+  l-interface:
+    description: |
+      Logical interfaces, e.g., a vnic.
+      ###### Related Nodes
+      - TO generic-vnf( l-interface org.onap.relationships.inventory.BelongsTo generic-vnf, MANY2ONE)
+      - TO lag-interface( l-interface org.onap.relationships.inventory.BelongsTo lag-interface, MANY2ONE)
+      - TO instance-group( l-interface org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY)
+      - TO l-interface( l-interface org.onap.relationships.inventory.BelongsTo l-interface, MANY2ONE)
+      - TO logical-link( l-interface tosca.relationships.network.LinksTo logical-link, MANY2MANY)
+      - TO newvce( l-interface org.onap.relationships.inventory.BelongsTo newvce, MANY2ONE)
+      - TO p-interface( l-interface tosca.relationships.network.BindsTo p-interface, MANY2ONE)
+      - TO vserver( l-interface tosca.relationships.network.BindsTo vserver, MANY2ONE)
+      - FROM allotted-resource( allotted-resource org.onap.relationships.inventory.Uses l-interface, ONE2MANY)
+      - FROM l3-interface-ipv4-address-list( l3-interface-ipv4-address-list org.onap.relationships.inventory.BelongsTo l-interface, MANY2ONE)
+      - FROM l3-interface-ipv6-address-list( l3-interface-ipv6-address-list org.onap.relationships.inventory.BelongsTo l-interface, MANY2ONE)
+      - FROM sriov-vf( sriov-vf org.onap.relationships.inventory.BelongsTo l-interface, ONE2ONE)
+      - FROM vlan( vlan tosca.relationships.network.LinksTo l-interface, MANY2ONE)
+      - FROM l-interface( l-interface org.onap.relationships.inventory.BelongsTo l-interface, MANY2ONE)
+      - L-INTERFACE is DELETED when these are DELETED L3-INTERFACE-IPV4-ADDRESS-LIST,L3-INTERFACE-IPV6-ADDRESS-LIST,SRIOV-VF,VLAN
+      - L-INTERFACE deletion means associated objects of these types are also DELETED:LOGICAL-LINK
+    required:
+    - interface-name
+    - is-port-mirrored
+    - in-maint
+    - is-ip-unnumbered
+    properties:
+      interface-name:
+        type: string
+        description: Name given to the interface
+      interface-role:
+        type: string
+        description: E.g., CUSTOMER, UPLINK, etc.
+      v6-wan-link-ip:
+        type: string
+        description: Questionably placed - v6 ip addr of this interface (is in vr-lan-interface from Mary B.
+      selflink:
+        type: string
+        description: URL to endpoint where AAI can get more details
+      interface-id:
+        type: string
+        description: ID of interface
+      macaddr:
+        type: string
+        description: MAC address for the interface
+      network-name:
+        type: string
+        description: Name of the network
+      management-option:
+        type: string
+        description: Whether A&AI should be managing this interface of not. Could have value like CUSTOMER
+      interface-description:
+        type: string
+        description: Human friendly text regarding this interface.
+      is-port-mirrored:
+        type: boolean
+  l-interfaces:
+    description: |
+      Collection of logical interfaces.
+    properties:
+      l-interface:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/l-interface"
+  l3-interface-ipv4-address-list:
+    description: |
+      IPv4 Address Range
+      ###### Related Nodes
+      - TO instance-group( l3-interface-ipv4-address-list org.onap.relationships.inventory.network.MemberOf instance-group, MANY2MANY)
+      - TO l3-network( l3-interface-ipv4-address-list org.onap.relationships.inventory.network.MemberOf l3-network, MANY2MANY)
+      - TO subnet( l3-interface-ipv4-address-list org.onap.relationships.inventory.network.MemberOf subnet, MANY2MANY)
+      - TO l-interface( l3-interface-ipv4-address-list org.onap.relationships.inventory.BelongsTo l-interface, MANY2ONE)
+      - TO vlan( l3-interface-ipv4-address-list org.onap.relationships.inventory.BelongsTo vlan, MANY2ONE)
+      - TO vnfc( l3-interface-ipv4-address-list org.onap.relationships.inventory.BelongsTo vnfc, MANY2ONE)
+    required:
+    - l3-interface-ipv4-address
+    properties:
+      l3-interface-ipv4-address:
+        type: string
+        description: IP address
+      l3-interface-ipv4-prefix-length:
+        type: integer
+        format: int64
+        description: Prefix length, 32 for single address
+      vlan-id-inner:
+        type: integer
+        format: int64
+        description: Inner VLAN tag
+      vlan-id-outer:
+        type: integer
+        format: int64
+        description: Outer VLAN tag
+      is-floating:
+        type: boolean
+        description: Indicator of fixed or floating address
+  l3-interface-ipv6-address-list:
+    description: |
+      IPv6 Address Range
+      ###### Related Nodes
+      - TO instance-group( l3-interface-ipv6-address-list org.onap.relationships.inventory.network.MemberOf instance-group, MANY2MANY)
+      - TO l3-network( l3-interface-ipv6-address-list org.onap.relationships.inventory.network.MemberOf l3-network, MANY2MANY)
+      - TO subnet( l3-interface-ipv6-address-list org.onap.relationships.inventory.network.MemberOf subnet, MANY2MANY)
+      - TO l-interface( l3-interface-ipv6-address-list org.onap.relationships.inventory.BelongsTo l-interface, MANY2ONE)
+      - TO vlan( l3-interface-ipv6-address-list org.onap.relationships.inventory.BelongsTo vlan, MANY2ONE)
+      - TO vnfc( l3-interface-ipv6-address-list org.onap.relationships.inventory.BelongsTo vnfc, MANY2ONE)
+    required:
+    - l3-interface-ipv6-address
+    properties:
+      l3-interface-ipv6-address:
+        type: string
+        description: IP address
+      l3-interface-ipv6-prefix-length:
+        type: integer
+        format: int64
+        description: Prefix length, 128 for single address
+      vlan-id-inner:
+        type: integer
+        format: int64
+        description: Inner VLAN tag
+      vlan-id-outer:
+        type: integer
+        format: int64
+        description: Outer VLAN tag
+      is-floating:
+        type: boolean
+        description: Indicator of fixed or floating address
+  l3-network:
+    description: |
+      Generic network definition
+      ###### Related Nodes
+      - TO instance-group( l3-network org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY)
+      - TO network-policy( l3-network org.onap.relationships.inventory.Uses network-policy, MANY2MANY)
+      - TO route-table-reference( l3-network org.onap.relationships.inventory.Uses route-table-reference, MANY2MANY)
+      - TO vpn-binding( l3-network org.onap.relationships.inventory.Uses vpn-binding, MANY2MANY)
+      - FROM allotted-resource( allotted-resource org.onap.relationships.inventory.PartOf l3-network, MANY2MANY)
+      - FROM cloud-region( cloud-region org.onap.relationships.inventory.Uses l3-network, MANY2MANY)
+      - FROM complex( complex org.onap.relationships.inventory.Uses l3-network, MANY2MANY)
+      - FROM generic-vnf( generic-vnf org.onap.relationships.inventory.Uses l3-network, MANY2MANY)
+      - FROM l3-interface-ipv4-address-list( l3-interface-ipv4-address-list org.onap.relationships.inventory.network.MemberOf l3-network, MANY2MANY)
+      - FROM l3-interface-ipv6-address-list( l3-interface-ipv6-address-list org.onap.relationships.inventory.network.MemberOf l3-network, MANY2MANY)
+      - FROM ctag-assignment( ctag-assignment org.onap.relationships.inventory.BelongsTo l3-network, MANY2ONE)
+      - FROM segmentation-assignment( segmentation-assignment org.onap.relationships.inventory.BelongsTo l3-network, MANY2ONE)
+      - FROM service-instance( service-instance org.onap.relationships.inventory.ComposedOf l3-network, ONE2MANY)
+      - FROM subnet( subnet org.onap.relationships.inventory.BelongsTo l3-network, MANY2ONE)
+      - FROM tenant( tenant org.onap.relationships.inventory.Uses l3-network, MANY2MANY)
+      - FROM vf-module( vf-module org.onap.relationships.inventory.DependsOn l3-network, MANY2MANY)
+      - L3-NETWORK is DELETED when these are DELETED CTAG-ASSIGNMENT,SEGMENTATION-ASSIGNMENT,SUBNET
+    required:
+    - network-id
+    - network-name
+    - is-bound-to-vpn
+    - is-provider-network
+    - is-shared-network
+    - is-external-network
+    properties:
+      network-id:
+        type: string
+        description: Network ID, should be uuid. Unique across A&AI.
+      network-name:
+        type: string
+        description: Name of the network, governed by some naming convention..
+      network-type:
+        type: string
+        description: Type of the network - who defines these values?
+      network-role:
+        type: string
+        description: Role the network plans - who defines these values?
+      network-technology:
+        type: string
+        description: Network technology - who defines these values?
+      neutron-network-id:
+        type: string
+        description: Neutron network id of this Interface
+      is-bound-to-vpn:
+        type: boolean
+      service-id:
+        type: string
+        description: Unique identifier of service from ASDC.  Does not strictly map to ASDC services.  SOON TO BE DEPRECATED
+      network-role-instance:
+        type: integer
+        format: int64
+        description: network role instance
+  l3-networks:
+    properties:
+      l3-network:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/l3-network"
+  lag-interface:
+    description: |
+      Link aggregate interface
+      ###### Related Nodes
+      - TO generic-vnf( lag-interface org.onap.relationships.inventory.BelongsTo generic-vnf, MANY2ONE)
+      - TO lag-link( lag-interface tosca.relationships.network.LinksTo lag-link, MANY2MANY)
+      - TO logical-link( lag-interface org.onap.relationships.inventory.Uses logical-link, MANY2MANY)
+      - TO p-interface( lag-interface org.onap.relationships.inventory.Uses p-interface, MANY2MANY)
+      - TO pnf( lag-interface tosca.relationships.network.BindsTo pnf, MANY2ONE)
+      - TO pserver( lag-interface tosca.relationships.network.BindsTo pserver, MANY2ONE)
+      - TO vpls-pe( lag-interface tosca.relationships.network.BindsTo vpls-pe, MANY2ONE)
+      - FROM l-interface( l-interface org.onap.relationships.inventory.BelongsTo lag-interface, MANY2ONE)
+      - LAG-INTERFACE is DELETED when these are DELETED L-INTERFACE
+      - LAG-INTERFACE deletion means associated objects of these types are also DELETED:LAG-LINK,LOGICAL-LINK
+    required:
+    - interface-name
+    - in-maint
+    properties:
+      interface-name:
+        type: string
+        description: Name that identifies the link aggregate interface
+      interface-description:
+        type: string
+        description: Human friendly text regarding this interface.
+  lag-interfaces:
+    description: |
+      Collection of link aggregate interfaces.
+    properties:
+      lag-interface:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/lag-interface"
+  lag-link:
+    description: |
+      LAG links can connect lag-interfaces
+      ###### Related Nodes
+      - FROM lag-interface( lag-interface tosca.relationships.network.LinksTo lag-link, MANY2MANY)
+      - FROM logical-link( logical-link org.onap.relationships.inventory.Uses lag-link, MANY2MANY)
+    required:
+    - link-name
+    properties:
+      link-name:
+        type: string
+        description: Alphabetical concatenation of lag-interface names
+  lag-links:
+    description: |
+      Collection of link aggregation connections
+    properties:
+      lag-link:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/lag-link"
+  license:
+    description: |
+      Metadata for license group.
+      ###### Related Nodes
+      - TO generic-vnf( license org.onap.relationships.inventory.BelongsTo generic-vnf, MANY2ONE)
+      - TO vce( license org.onap.relationships.inventory.BelongsTo vce, MANY2ONE)
+    required:
+    - group-uuid
+    - resource-uuid
+    properties:
+      group-uuid:
+        type: string
+        description: Unique ID for the license group the resource belongs to, should be uuid.
+      resource-uuid:
+        type: string
+        description: Unique ID of a license resource. 
+  licenses:
+    description: |
+      Licenses to be allocated across resources, keyed by group-uuid and resource-uuid, related to license management
+    properties:
+      license:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/license"
+  line-of-business:
+    description: |
+      describes a line-of-business
+      ###### Related Nodes
+      - TO generic-vnf( line-of-business org.onap.relationships.inventory.Uses generic-vnf, MANY2MANY)
+    required:
+    - line-of-business-name
+    properties:
+      line-of-business-name:
+        type: string
+        description: Name of the line-of-business (product)
+  lines-of-business:
+    description: |
+      Collection of lines-of-business
+    properties:
+      line-of-business:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/line-of-business"
+  logical-link:
+    description: |
+      Logical links generally connect l-interfaces but are used to express logical connectivity between two points
+      ###### Related Nodes
+      - TO cloud-region( logical-link org.onap.relationships.inventory.LocatedIn cloud-region, MANY2MANY)
+      - TO generic-vnf( logical-link org.onap.relationships.inventory.BridgedTo generic-vnf, MANY2MANY)
+      - TO lag-link( logical-link org.onap.relationships.inventory.Uses lag-link, MANY2MANY)
+      - TO logical-link( logical-link org.onap.relationships.inventory.Uses logical-link, MANY2MANY)
+      - TO pnf( logical-link org.onap.relationships.inventory.BridgedTo pnf, MANY2MANY)
+      - TO pserver( logical-link org.onap.relationships.inventory.BridgedTo pserver, MANY2MANY)
+      - TO vpn-binding( logical-link org.onap.relationships.inventory.Uses vpn-binding, MANY2MANY)
+      - TO virtual-data-center( logical-link org.onap.relationships.inventory.LocatedIn virtual-data-center, MANY2MANY)
+      - FROM configuration( configuration org.onap.relationships.inventory.Uses logical-link, ONE2MANY)
+      - FROM lag-interface( lag-interface org.onap.relationships.inventory.Uses logical-link, MANY2MANY)
+      - FROM l-interface( l-interface tosca.relationships.network.LinksTo logical-link, MANY2MANY)
+      - FROM p-interface( p-interface tosca.relationships.network.LinksTo logical-link, MANY2ONE)
+      - FROM service-instance( service-instance org.onap.relationships.inventory.Uses logical-link, ONE2MANY)
+      - FROM vlan( vlan org.onap.relationships.inventory.Uses logical-link, MANY2MANY)
+      - FROM logical-link( logical-link org.onap.relationships.inventory.Uses logical-link, MANY2MANY)
+    required:
+    - link-name
+    - in-maint
+    - link-type
+    properties:
+      link-name:
+        type: string
+        description: e.g., evc-name, or vnf-nameA_interface-nameA_vnf-nameZ_interface-nameZ
+      in-maint:
+        type: boolean
+      link-type:
+        type: string
+        description: Type of logical link, e.g., evc
+      speed-value:
+        type: string
+        description: Captures the numeric part of the speed
+      speed-units:
+        type: string
+        description: Captures the units corresponding to the speed
+      ip-version:
+        type: string
+        description: v4, v6, or ds for dual stack
+      routing-protocol:
+        type: string
+        description: For example, static or BGP
+  logical-links:
+    description: |
+      Collection of logical connections
+    properties:
+      logical-link:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/logical-link"
+  metadata:
+    description: |
+      Collection of metadatum (key/value pairs)
+    properties:
+      metadatum:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/metadatum"
+  metadatum:
+    description: |
+      Key/value pairs
+      ###### Related Nodes
+      - TO configuration( metadatum org.onap.relationships.inventory.BelongsTo configuration, MANY2ONE)
+      - TO connector( metadatum org.onap.relationships.inventory.BelongsTo connector, MANY2ONE)
+      - TO image( metadatum org.onap.relationships.inventory.BelongsTo image, MANY2ONE)
+      - TO service-instance( metadatum org.onap.relationships.inventory.BelongsTo service-instance, MANY2ONE)
+      - TO model-ver( metadatum org.onap.relationships.inventory.BelongsTo model-ver, MANY2ONE)
+    required:
+    - metaname
+    - metaval
+    properties:
+      metaname:
+        type: string
+      metaval:
+        type: string
+  model:
+    description: |
+      Subgraph definition provided by ASDC to describe an inventory asset and its connections related to ASDC models, independent of version
+      ###### Related Nodes
+      - TO model( model-ver org.onap.relationships.inventory.BelongsTo model, MANY2ONE)
+      - FROM instance-group( instance-group org.onap.relationships.inventory.Targets model, MANY2MANY)
+      - FROM model-ver( model-ver org.onap.relationships.inventory.BelongsTo model, MANY2ONE)
+      - FROM named-query( named-query org.onap.relationships.inventory.AppliesTo model, ONE2MANY)
+      - FROM named-query-element( named-query-element org.onap.relationships.inventory.IsA model, MANY2ONE)
+      - MODEL cannot be deleted if linked to INSTANCE-GROUP,NAMED-QUERY,NAMED-QUERY-ELEMENT
+      - MODEL is DELETED when these are DELETED MODEL-VER
+    required:
+    - model-invariant-id
+    - model-type
+    properties:
+      model-invariant-id:
+        type: string
+        description: Unique identifier corresponding to the main definition of a model in ASDC
+      model-type:
+        type: string
+        description: Type of the model, e.g., service, resource, widget, etc.
+  model-and-named-query-search:
+    description: |
+      ModelAndNamedQuerySearch holds query-parameters and instance-properties for performing a named-query or model query
+    properties:
+      query-parameters:
+        type: object
+        $ref: "#/patchDefinitions/query-parameters"
+      instance-filters:
+        type: object
+        $ref: "#/patchDefinitions/instance-filters"
+      secondary-filts:
+        type: object
+        $ref: "#/patchDefinitions/secondary-filts"
+      top-node-type:
+        type: string
+      secondary-filter-cut-point:
+        type: string
+  model-constraint:
+    description: |
+      This is how we would capture constraints defining allowed sets of elements.
+      ###### Related Nodes
+      - TO model-element( model-constraint org.onap.relationships.inventory.BelongsTo model-element, MANY2ONE)
+      - FROM constrained-element-set( constrained-element-set org.onap.relationships.inventory.BelongsTo model-constraint, MANY2ONE)
+      - MODEL-CONSTRAINT is DELETED when these are DELETED CONSTRAINED-ELEMENT-SET
+    required:
+    - model-constraint-uuid
+    - constrained-element-set-uuid-to-replace
+    properties:
+      model-constraint-uuid:
+        type: string
+      constrained-element-set-uuid-to-replace:
+        type: string
+      constrained-element-sets:
+        type: array
+        items:
+          $ref: "#/patchDefinitions/constrained-element-set"
+  model-constraints:
+    properties:
+      model-constraint:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/model-constraint"
+  model-element:
+    description: |
+      Defines how other models combine to make up a higher-level model.
+      ###### Related Nodes
+      - TO element-choice-set( model-element org.onap.relationships.inventory.BelongsTo element-choice-set, MANY2ONE)
+      - TO model-element( model-element org.onap.relationships.inventory.BelongsTo model-element, MANY2ONE)
+      - TO model-ver( model-element org.onap.relationships.inventory.IsA model-ver, MANY2ONE)
+      - TO model-ver( model-element org.onap.relationships.inventory.BelongsTo model-ver, MANY2ONE)
+      - FROM constrained-element-set( constrained-element-set org.onap.relationships.inventory.BelongsTo model-element, MANY2ONE)
+      - FROM model-constraint( model-constraint org.onap.relationships.inventory.BelongsTo model-element, MANY2ONE)
+      - FROM model-element( model-element org.onap.relationships.inventory.BelongsTo model-element, MANY2ONE)
+      - MODEL-ELEMENT is DELETED when these are DELETED CONSTRAINED-ELEMENT-SET,MODEL-CONSTRAINT
+    required:
+    - model-element-uuid
+    - new-data-del-flag
+    - cardinality
+    properties:
+      model-element-uuid:
+        type: string
+      new-data-del-flag:
+        type: string
+        description: Indicates whether this element was created as part of instantiation from this model
+      cardinality:
+        type: string
+        description: How many of this type of element are required/allowed
+      linkage-points:
+        type: string
+  model-elements:
+    properties:
+      model-element:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/model-element"
+  model-ver:
+    description: |
+      Subgraph definition provided by ASDC to describe a specific version of an inventory asset and its connections related to ASDC models
+      ###### Related Nodes
+      - TO model( model-ver org.onap.relationships.inventory.BelongsTo model, MANY2ONE)
+      - FROM model-element( model-element org.onap.relationships.inventory.IsA model-ver, MANY2ONE)
+      - FROM model-element( model-element org.onap.relationships.inventory.BelongsTo model-ver, MANY2ONE)
+      - FROM metadatum( metadatum org.onap.relationships.inventory.BelongsTo model-ver, MANY2ONE)
+      - MODEL-VER cannot be deleted if linked to MODEL-ELEMENT
+      - MODEL-VER is DELETED when these are DELETED MODEL-ELEMENT,METADATUM
+    required:
+    - model-version-id
+    - model-name
+    - model-version
+    properties:
+      model-version-id:
+        type: string
+        description: Unique identifier corresponding to one version of a model in ASDC
+      model-name:
+        type: string
+        description: Name of the model, which can change from version to version.
+      model-version:
+        type: string
+        description: Version
+      model-description:
+        type: string
+        description: Description
+  model-vers:
+    properties:
+      model-ver:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/model-ver"
+  models:
+    description: |
+      Collection of subgraph definitions provided by ASDC to describe the inventory assets and their connections related to ASDC models
+    properties:
+      model:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/model"
+  multicast-configuration:
+    description: |
+      ###### Related Nodes
+      - FROM vlan( vlan org.onap.relationships.inventory.Uses multicast-configuration, MANY2MANY)
+    required:
+    - multicast-configuration-id
+    - multicast-protocol
+    - rp-type
+    properties:
+      multicast-configuration-id:
+        type: string
+        description: Unique id of multicast configuration.
+      multicast-protocol:
+        type: string
+        description: protocol of multicast configuration
+      rp-type:
+        type: string
+        description: rp type of multicast configuration
+  multicast-configurations:
+    description: |
+      multicast configuration of generic-vnf ip-address
+    properties:
+      multicast-configuration:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/multicast-configuration"
+  named-queries:
+    properties:
+      named-query:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/named-query"
+  named-query:
+    description: |
+      TBD
+      ###### Related Nodes
+      - TO named-query( named-query-element org.onap.relationships.inventory.BelongsTo named-query, ONE2ONE)
+      - TO model( named-query org.onap.relationships.inventory.AppliesTo model, ONE2MANY)
+      - FROM named-query-element( named-query-element org.onap.relationships.inventory.BelongsTo named-query, ONE2ONE)
+      - NAMED-QUERY is DELETED when these are DELETED NAMED-QUERY-ELEMENT
+    required:
+    - named-query-uuid
+    - named-query-name
+    - named-query-version
+    properties:
+      named-query-uuid:
+        type: string
+      named-query-name:
+        type: string
+      named-query-version:
+        type: string
+      required-input-param:
+        type: string
+      description:
+        type: string
+  named-query-element:
+    description: |
+      TBD
+      ###### Related Nodes
+      - TO named-query( named-query-element org.onap.relationships.inventory.BelongsTo named-query, ONE2ONE)
+      - TO model( named-query-element org.onap.relationships.inventory.IsA model, MANY2ONE)
+      - TO named-query-element( named-query-element org.onap.relationships.inventory.BelongsTo named-query-element, MANY2ONE)
+      - FROM property-constraint( property-constraint org.onap.relationships.inventory.BelongsTo named-query-element, MANY2ONE)
+      - FROM related-lookup( related-lookup org.onap.relationships.inventory.BelongsTo named-query-element, MANY2ONE)
+      - FROM named-query-element( named-query-element org.onap.relationships.inventory.BelongsTo named-query-element, MANY2ONE)
+      - NAMED-QUERY-ELEMENT is DELETED when these are DELETED PROPERTY-CONSTRAINT,RELATED-LOOKUP
+    required:
+    - named-query-element-uuid
+    properties:
+      named-query-element-uuid:
+        type: string
+      property-collect-list:
+        type: string
+  named-query-elements:
+    properties:
+      named-query-element:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/named-query-element"
+  network:
+    description: |
+      Namespace for network inventory resources.
+    properties:
+      logical-links:
+        type: array
+        items:
+          $ref: "#/patchDefinitions/logical-link"
+      site-pair-sets:
+        type: array
+        items:
+          $ref: "#/patchDefinitions/site-pair-set"
+      vpn-bindings:
+        type: array
+        items:
+          $ref: "#/patchDefinitions/vpn-binding"
+      vpls-pes:
+        type: array
+        items:
+          $ref: "#/patchDefinitions/vpls-pe"
+      multicast-configurations:
+        type: array
+        items:
+          $ref: "#/patchDefinitions/multicast-configuration"
+      vces:
+        type: array
+        items:
+          $ref: "#/patchDefinitions/vce"
+      vnfcs:
+        type: array
+        items:
+          $ref: "#/patchDefinitions/vnfc"
+      l3-networks:
+        type: array
+        items:
+          $ref: "#/patchDefinitions/l3-network"
+      network-policies:
+        type: array
+        items:
+          $ref: "#/patchDefinitions/network-policy"
+      generic-vnfs:
+        type: array
+        items:
+          $ref: "#/patchDefinitions/generic-vnf"
+      lag-links:
+        type: array
+        items:
+          $ref: "#/patchDefinitions/lag-link"
+      newvces:
+        type: array
+        items:
+          $ref: "#/patchDefinitions/newvce"
+      pnfs:
+        type: array
+        items:
+          $ref: "#/patchDefinitions/pnf"
+      physical-links:
+        type: array
+        items:
+          $ref: "#/patchDefinitions/physical-link"
+      ipsec-configurations:
+        type: array
+        items:
+          $ref: "#/patchDefinitions/ipsec-configuration"
+      route-table-references:
+        type: array
+        items:
+          $ref: "#/patchDefinitions/route-table-reference"
+      instance-groups:
+        type: array
+        items:
+          $ref: "#/patchDefinitions/instance-group"
+      zones:
+        type: array
+        items:
+          $ref: "#/patchDefinitions/zone"
+      configurations:
+        type: array
+        items:
+          $ref: "#/patchDefinitions/configurations"
+  network-policies:
+    properties:
+      network-policy:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/network-policy"
+  network-policy:
+    description: |
+      ###### Related Nodes
+      - FROM allotted-resource( allotted-resource org.onap.relationships.inventory.Uses network-policy, ONE2ONE)
+      - FROM l3-network( l3-network org.onap.relationships.inventory.Uses network-policy, MANY2MANY)
+    required:
+    - network-policy-id
+    properties:
+      network-policy-id:
+        type: string
+        description: UUID representing unique key to this instance
+      network-policy-fqdn:
+        type: string
+        description: Contrail FQDN for the policy
+      heat-stack-id:
+        type: string
+        description: ID for the openStack Heat instance
+  network-profile:
+    description: |
+      Network profile populated by SDN-GP for SNMP
+      ###### Related Nodes
+      - TO generic-vnf( network-profile org.onap.relationships.inventory.AppliesTo generic-vnf, MANY2MANY)
+    required:
+    - nm-profile-name
+    properties:
+      nm-profile-name:
+        type: string
+        description: Unique name of network profile.
+      community-string:
+        type: string
+        description: Encrypted SNMP community string
+  network-profiles:
+    description: |
+      Collection of network profiles
+    properties:
+      network-profile:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/network-profile"
+  newvce:
+    description: |
+      This object fills in the gaps from vce that were incorporated into generic-vnf.  This object will be retired with vce.
+      ###### Related Nodes
+      - FROM l-interface( l-interface org.onap.relationships.inventory.BelongsTo newvce, MANY2ONE)
+      - NEWVCE is DELETED when these are DELETED L-INTERFACE
+    required:
+    - vnf-id2
+    - vnf-name
+    - vnf-type
+    properties:
+      vnf-id2:
+        type: string
+        description: Unique id of VNF, can't use same attribute name right now until we promote this new object
+      vnf-name:
+        type: string
+        description: Name of VNF.
+      vnf-name2:
+        type: string
+        description: Alternate name of VNF.
+      vnf-type:
+        type: string
+        description: String capturing type of vnf, that was intended to identify the ASDC resource.  This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures.
+      prov-status:
+        type: string
+        description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems.
+      operational-status:
+        type: string
+        description: Indicator for whether the resource is considered operational
+      license-key:
+        type: string
+        description: OBSOLETE -  do not use
+      ipv4-oam-address:
+        type: string
+        description: Address tail-f uses to configure generic-vnf, also used for troubleshooting and is IP used for traps generated by GenericVnf (v4-loopback0-ip-address).
+      equipment-role:
+        type: string
+        description: Client should send valid enumerated value.
+  newvces:
+    description: |
+      This object fills in the gaps from vce that were incorporated into generic-vnf.  This object will be retired with vce.
+    properties:
+      newvce:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/newvce"
+  notification-event:
+    properties:
+      cambria.partition:
+        type: string
+      notification-event-header:
+        type: object
+        $ref: "#/patchDefinitions/notification-event-header"
+  notification-event-header:
+    properties:
+      id:
+        type: string
+      timestamp:
+        type: string
+      source-name:
+        type: string
+      domain:
+        type: string
+      sequence-number:
+        type: string
+      severity:
+        type: string
+      event-type:
+        type: string
+      version:
+        type: string
+      action:
+        type: string
+      entity-type:
+        type: string
+      top-entity-type:
+        type: string
+      entity-link:
+        type: string
+      status:
+        type: string
+  notify:
+    required:
+    - event-id
+    properties:
+      event-id:
+        type: string
+      node-type:
+        type: string
+      event-trigger:
+        type: string
+      key-data:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/key-data"
+      selflink:
+        type: string
+  oam-network:
+    description: |
+      OAM network, to be deprecated shortly.  Do not use for new purposes. 
+      ###### Related Nodes
+      - TO cloud-region( oam-network org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE)
+      - TO complex( oam-network org.onap.relationships.inventory.AppliesTo complex, MANY2MANY)
+      - TO service-capability( oam-network org.onap.relationships.inventory.AppliesTo service-capability, MANY2MANY)
+    required:
+    - network-uuid
+    - network-name
+    - cvlan-tag
+    properties:
+      network-uuid:
+        type: string
+        description: UUID of the network. Unique across a cloud-region
+      network-name:
+        type: string
+        description: Name of the network.
+      cvlan-tag:
+        type: integer
+        format: int64
+        description: cvlan-id
+      ipv4-oam-gateway-address:
+        type: string
+        description: Used for VNF firewall rule so customer cannot send customer traffic over this oam network
+      ipv4-oam-gateway-address-prefix-length:
+        type: integer
+        format: int32
+        description: Used for VNF firewall rule so customer cannot send customer traffic over this oam network
+  oam-networks:
+    description: |
+      Collection of OAM networks, to be deprecated shortly.  Do not use for new purposes. 
+    properties:
+      oam-network:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/oam-network"
+  operational-environment:
+    description: |
+      It is a logical partition of the cloud which allows to have multiple environments in the production AIC.
+      ###### Related Nodes
+      - TO operational-environment( operational-environment org.onap.relationships.inventory.Uses operational-environment, ONE2ONE)
+      - FROM operational-environment( operational-environment org.onap.relationships.inventory.Uses operational-environment, ONE2ONE)
+    required:
+    - operational-environment-id
+    - operational-environment-name
+    - operational-environment-type
+    - operational-environment-status
+    - tenant-context
+    - workload-context
+    properties:
+      operational-environment-id:
+        type: string
+        description: UUID of an operational environment
+      operational-environment-name:
+        type: string
+        description: Operational Environment name
+      operational-environment-type:
+        type: string
+        description: Operational Environment Type.
+      operational-environment-status:
+        type: string
+        description: Status
+      tenant-context:
+        type: string
+        description: Tenant Context.
+      workload-context:
+        type: string
+        description: Workload Context.
+  operational-environments:
+    description: |
+      a logical partition of the cloud which allows to have multiple environments in the production AIC.
+    properties:
+      operational-environment:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/operational-environment"
+  overloaded-model:
+    description: |
+      Allows for legacy POST of old-style and new-style models
+    required:
+    - model-invariant-id
+    - model-name-version-id
+    - model-type
+    - model-name
+    - model-id
+    - model-version
+    properties:
+      model-invariant-id:
+        type: string
+        description: Unique identifier corresponding to the main definition of a model in ASDC
+      model-name-version-id:
+        type: string
+        description: Unique identifier corresponding to one version of a model in ASDC
+      model-type:
+        type: string
+        description: Type of the model, e.g., service, resource, widget, etc.
+      model-name:
+        type: string
+        description: Name of the model, which can change from version to version.
+      model-id:
+        type: string
+        description: Invariant unique ID which does not change from version to version
+      model-version:
+        type: string
+        description: Version
+      model-description:
+        type: string
+        description: Description
+  owning-entities:
+    description: |
+      Collection of owning-entities
+    properties:
+      owning-entity:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/owning-entity"
+  owning-entity:
+    description: |
+      describes an owning-entity
+      ###### Related Nodes
+      - FROM service-instance( service-instance org.onap.relationships.inventory.BelongsTo owning-entity, MANY2ONE)
+    required:
+    - owning-entity-id
+    - owning-entity-name
+    properties:
+      owning-entity-id:
+        type: string
+        description: UUID of an owning entity
+      owning-entity-name:
+        type: string
+        description: Owning entity name
+  p-interface:
+    description: |
+      Physical interface (e.g., nic)
+      ###### Related Nodes
+      - TO logical-link( p-interface tosca.relationships.network.LinksTo logical-link, MANY2ONE)
+      - TO physical-link( p-interface tosca.relationships.network.LinksTo physical-link, MANY2ONE)
+      - TO pnf( p-interface tosca.relationships.network.BindsTo pnf, MANY2ONE)
+      - TO pserver( p-interface tosca.relationships.network.BindsTo pserver, MANY2ONE)
+      - TO vpls-pe( p-interface tosca.relationships.network.BindsTo vpls-pe, MANY2ONE)
+      - FROM lag-interface( lag-interface org.onap.relationships.inventory.Uses p-interface, MANY2MANY)
+      - FROM l-interface( l-interface tosca.relationships.network.BindsTo p-interface, MANY2ONE)
+      - FROM sriov-pf( sriov-pf org.onap.relationships.inventory.BelongsTo p-interface, ONE2ONE)
+      - P-INTERFACE is DELETED when these are DELETED L-INTERFACE,SRIOV-PF
+      - P-INTERFACE deletion means associated objects of these types are also DELETED:PHYSICAL-LINK
+    required:
+    - interface-name
+    - in-maint
+    properties:
+      interface-name:
+        type: string
+        description: Name that identifies the physical interface
+      speed-value:
+        type: string
+        description: Captures the numeric part of the speed
+      speed-units:
+        type: string
+        description: Captures the units corresponding to the speed
+      port-description:
+        type: string
+        description: Nature of the services and connectivity on this port.
+      equipment-identifier:
+        type: string
+        description: CLEI or other specification for p-interface hardware.
+      interface-role:
+        type: string
+        description: Role specification for p-interface hardware.
+      interface-type:
+        type: string
+        description: Indicates the physical properties of the interface.
+      prov-status:
+        type: string
+        description: Trigger for operational monitoring of this resource by Service Assurance systems.
+      mac-addresss:
+        type: string
+        description: MAC Address of the p-interface.
+  p-interfaces:
+    description: |
+      Collection of physical interfaces.
+    properties:
+      p-interface:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/p-interface"
+  physical-link:
+    description: |
+      Collection of physical connections, typically between p-interfaces
+      ###### Related Nodes
+      - FROM p-interface( p-interface tosca.relationships.network.LinksTo physical-link, MANY2ONE)
+    required:
+    - link-name
+    properties:
+      link-name:
+        type: string
+        description: e.g., hostnameA_p-connection_nameA_hostnameZ+p_connection-nameZ
+      speed-value:
+        type: string
+        description: Captures the numeric part of the speed
+      speed-units:
+        type: string
+        description: Captures the units corresponding to the speed
+      circuit-id:
+        type: string
+        description: Circuit it
+      dual-mode:
+        type: string
+        description: Dual access mode (e.g., primary, secondary
+      management-option:
+        type: string
+        description: To provide information on who manages this circuit. A&AI or 3rd party transport provider
+      service-provider-name:
+        type: string
+        description: Name of the service Provider on this link.
+      service-provider-bandwidth-up-value:
+        type: integer
+        format: int32
+        description: Upstream Bandwidth value agreed with the service provider
+      service-provider-bandwidth-up-units:
+        type: string
+        description: Units for the upstream BW value
+      service-provider-bandwidth-down-value:
+        type: integer
+        format: int32
+        description: Downstream Bandwidth value agreed with the service provider
+      service-provider-bandwidth-down-units:
+        type: string
+        description: Units for downstream BW value
+  physical-links:
+    description: |
+      Collection of physical connections, typically between p-interfaces
+    properties:
+      physical-link:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/physical-link"
+  platform:
+    description: |
+      describes a platform
+      ###### Related Nodes
+      - TO generic-vnf( platform org.onap.relationships.inventory.Uses generic-vnf, MANY2MANY)
+    required:
+    - platform-name
+    properties:
+      platform-name:
+        type: string
+        description: Name of the platform
+  platforms:
+    description: |
+      Collection of platforms
+    properties:
+      platform:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/platform"
+  pnf:
+    description: |
+      PNF represents a physical network function. typically equipment used in the D1 world. in 1607, this will be populated by SDN-C to represent a premises router that a uCPE connects to. But this can be used to represent any physical device that is not an AIC node or uCPE.
+      ###### Related Nodes
+      - TO complex( pnf org.onap.relationships.inventory.LocatedIn complex, MANY2ONE)
+      - TO instance-group( pnf org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY)
+      - TO zone( pnf org.onap.relationships.inventory.LocatedIn zone, MANY2ONE)
+      - FROM esr-thirdparty-sdnc( esr-thirdparty-sdnc has pnf, One2Many)
+      - FROM generic-vnf( generic-vnf tosca.relationships.HostedOn pnf, MANY2MANY)
+      - FROM logical-link( logical-link org.onap.relationships.inventory.BridgedTo pnf, MANY2MANY)
+      - FROM lag-interface( lag-interface tosca.relationships.network.BindsTo pnf, MANY2ONE)
+      - FROM p-interface( p-interface tosca.relationships.network.BindsTo pnf, MANY2ONE)
+      - FROM service-instance( service-instance org.onap.relationships.inventory.ComposedOf pnf, ONE2MANY)
+      - PNF is DELETED when these are DELETED LAG-INTERFACE,P-INTERFACE
+    required:
+    - pnf-name
+    - in-maint
+    properties:
+      pnf-name:
+        type: string
+        description: unique name of Physical Network Function.
+      pnf-name2:
+        type: string
+        description: name of Physical Network Function.
+      pnf-name2-source:
+        type: string
+        description: source of name2
+      pnf-id:
+        type: string
+        description: id of pnf
+      equip-type:
+        type: string
+        description: Equipment type.  Source of truth should define valid values.
+      equip-vendor:
+        type: string
+        description: Equipment vendor.  Source of truth should define valid values.
+      equip-model:
+        type: string
+        description: Equipment model.  Source of truth should define valid values.
+      management-option:
+        type: string
+        description: identifier of managed by ATT or customer
+      ipaddress-v4-oam:
+        type: string
+        description: ipv4-oam-address with new naming convention for IP addresses
+      sw-version:
+        type: string
+        description: sw-version is the version of SW for the hosted application on the PNF.
+      in-maint:
+        type: boolean
+      frame-id:
+        type: string
+        description: ID of the physical frame (relay rack) where pnf is installed.
+      serial-number:
+        type: string
+        description: Serial number of the device
+      ipaddress-v4-loopback-0:
+        type: string
+        description: IPV4 Loopback 0 address
+      ipaddress-v6-loopback-0:
+        type: string
+        description: IPV6 Loopback 0 address
+      ipaddress-v4-aim:
+        type: string
+        description: IPV4 AIM address
+      ipaddress-v6-aim:
+        type: string
+        description: IPV6 AIM address
+      ipaddress-v6-oam:
+        type: string
+        description: IPV6 OAM address
+      inv-status:
+        type: string
+        description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
+  pnfs:
+    description: |
+      Collection of Physical Network Functions.
+    properties:
+      pnf:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/pnf"
+  port-group:
+    description: |
+      Used to capture the network interfaces of this VCE
+      ###### Related Nodes
+      - TO vce( port-group org.onap.relationships.inventory.BelongsTo vce, MANY2ONE)
+      - FROM cvlan-tag( cvlan-tag org.onap.relationships.inventory.BelongsTo port-group, MANY2ONE)
+      - PORT-GROUP is DELETED when these are DELETED CVLAN-TAG
+    required:
+    - interface-id
+    - orchestration-status
+    properties:
+      interface-id:
+        type: string
+        description: Unique ID of the interface
+      neutron-network-id:
+        type: string
+        description: Neutron network id of this Interface
+      neutron-network-name:
+        type: string
+        description: Neutron network name of this Interface
+      interface-role:
+        type: string
+        description: Role assigned to this Interface, should use values as defined in ECOMP Yang models.
+  port-groups:
+    properties:
+      port-group:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/port-group"
+  project:
+    description: |
+      describes the project
+      ###### Related Nodes
+      - TO service-instance( project org.onap.relationships.inventory.Uses service-instance, ONE2MANY)
+    required:
+    - project-name
+    properties:
+      project-name:
+        type: string
+        description: Name of the project deploying a service
+  projects:
+    description: |
+      Collection of projects
+    properties:
+      project:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/project"
+  properties:
+    description: |
+      Property holder for query properties or instance properties
+    properties:
+      property-name:
+        type: string
+      property-value:
+        type: string
+  property-constraint:
+    description: |
+      TBD
+      ###### Related Nodes
+      - TO named-query-element( property-constraint org.onap.relationships.inventory.BelongsTo named-query-element, MANY2ONE)
+    required:
+    - property-constraint-uuid
+    - constraint-type
+    - property-name
+    - property-value
+    properties:
+      property-constraint-uuid:
+        type: string
+      constraint-type:
+        type: string
+      property-name:
+        type: string
+      property-value:
+        type: string
+  property-constraints:
+    properties:
+      property-constraint:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/property-constraint"
+  pserver:
+    description: |
+      Compute host whose hostname must be unique and must exactly match what is sent as a relationship to a vserver.
+      ###### Related Nodes
+      - TO group-assignment( pserver org.onap.relationships.inventory.MemberOf group-assignment, MANY2ONE)
+      - TO availability-zone( pserver org.onap.relationships.inventory.MemberOf availability-zone, MANY2ONE)
+      - TO cloud-region( pserver org.onap.relationships.inventory.LocatedIn cloud-region, MANY2ONE)
+      - TO complex( pserver org.onap.relationships.inventory.LocatedIn complex, MANY2ONE)
+      - TO zone( pserver org.onap.relationships.inventory.LocatedIn zone, MANY2ONE)
+      - FROM generic-vnf( generic-vnf tosca.relationships.HostedOn pserver, MANY2MANY)
+      - FROM logical-link( logical-link org.onap.relationships.inventory.BridgedTo pserver, MANY2MANY)
+      - FROM lag-interface( lag-interface tosca.relationships.network.BindsTo pserver, MANY2ONE)
+      - FROM p-interface( p-interface tosca.relationships.network.BindsTo pserver, MANY2ONE)
+      - FROM vserver( vserver tosca.relationships.HostedOn pserver, MANY2ONE)
+      - PSERVER cannot be deleted if linked to GENERIC-VNF,LOGICAL-LINK,VSERVER
+      - PSERVER is DELETED when these are DELETED LAG-INTERFACE,P-INTERFACE
+      - PSERVER cannot be deleted if linked to GROUP-ASSIGNMENT
+    required:
+    - hostname
+    - in-maint
+    properties:
+      hostname:
+        type: string
+        description: Value from executing hostname on the compute node.
+      ptnii-equip-name:
+        type: string
+        description: PTNII name
+      number-of-cpus:
+        type: integer
+        format: int32
+        description: Number of cpus
+      disk-in-gigabytes:
+        type: integer
+        format: int32
+        description: Disk size, in GBs
+      ram-in-megabytes:
+        type: integer
+        format: int32
+        description: RAM size, in MBs
+      equip-type:
+        type: string
+        description: Equipment type.  Source of truth should define valid values.
+      equip-vendor:
+        type: string
+        description: Equipment vendor.  Source of truth should define valid values.
+      equip-model:
+        type: string
+        description: Equipment model.  Source of truth should define valid values.
+      fqdn:
+        type: string
+        description: Fully-qualified domain name
+      pserver-selflink:
+        type: string
+        description: URL to endpoint where AAI can get more details
+      ipv4-oam-address:
+        type: string
+        description: Used to configure device, also used for troubleshooting and is IP used for traps generated by device.
+      serial-number:
+        type: string
+        description: Serial number, may be queried
+      ipaddress-v4-loopback-0:
+        type: string
+        description: IPV4 Loopback 0 address
+      ipaddress-v6-loopback-0:
+        type: string
+        description: IPV6 Loopback 0 address
+      ipaddress-v4-aim:
+        type: string
+        description: IPV4 AIM address
+      ipaddress-v6-aim:
+        type: string
+        description: IPV6 AIM address
+      ipaddress-v6-oam:
+        type: string
+        description: IPV6 OAM address
+      inv-status:
+        type: string
+        description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
+      pserver-id:
+        type: string
+        description: ID of Pserver
+      internet-topology:
+        type: string
+        description: internet topology of Pserver
+      in-maint:
+        type: boolean
+  pservers:
+    description: |
+      Collection of compute hosts.
+    properties:
+      pserver:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/pserver"
+  query-parameters:
+    description: |
+      QueryParameters for performing a named-query or model query
+    properties:
+      named-query:
+        type: object
+        $ref: "#/patchDefinitions/named-query"
+      overloaded-model:
+        type: object
+        $ref: "#/patchDefinitions/overloaded-model"
+  related-lookup:
+    description: |
+      TBD
+      ###### Related Nodes
+      - TO named-query-element( related-lookup org.onap.relationships.inventory.BelongsTo named-query-element, MANY2ONE)
+    required:
+    - related-lookup-uuid
+    - source-node-type
+    - source-node-property
+    - target-node-type
+    - target-node-property
+    properties:
+      related-lookup-uuid:
+        type: string
+      source-node-type:
+        type: string
+      source-node-property:
+        type: string
+      target-node-type:
+        type: string
+      target-node-property:
+        type: string
+      property-collect-list:
+        type: string
+  related-lookups:
+    properties:
+      related-lookup:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/related-lookup"
+  related-to-property:
+    properties:
+      property-key:
+        type: string
+        description: Key part of a key/value pair
+      property-value:
+        type: string
+        description: Value part of a key/value pair
+  relationship:
+    properties:
+      related-to:
+        type: string
+        description: A keyword provided by A&AI to indicate type of node.
+      related-link:
+        type: string
+        description: URL to the object in A&AI.
+      relationship-data:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/relationship-data"
+      related-to-property:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/related-to-property"
+  relationship-data:
+    required:
+    - relationship-key
+    - relationship-value
+    properties:
+      relationship-key:
+        type: string
+        description: A keyword provided by A&AI to indicate an attribute.
+      relationship-value:
+        type: string
+        description: Value of the attribute.
+  reserved-prop-names:
+    description: |
+      Internal map to define some reserved properties of a vertex
+    properties:
+      last-mod-source-of-truth:
+        type: string
+      aai-node-type:
+        type: string
+      aai-created-ts:
+        type: integer
+        format: int64
+      aai-unique-key:
+        type: string
+      aai-last-mod-ts:
+        type: integer
+        format: int64
+      source-of-truth:
+        type: string
+      aai-uri:
+        type: string
+  response-list:
+    description: |
+      Response container for the results of a named-query or model query
+    properties:
+      inventory-response-items:
+        type: object
+        $ref: "#/patchDefinitions/inventory-response-items"
+  result-data:
+    properties:
+      resource-type:
+        type: string
+        description: The specific type of node in the A&AI graph
+      resource-link:
+        type: string
+        description: The URL to the specific resource
+  route-table-reference:
+    description: |
+      Openstack route table reference.
+      ###### Related Nodes
+      - FROM l3-network( l3-network org.onap.relationships.inventory.Uses route-table-reference, MANY2MANY)
+    required:
+    - route-table-reference-id
+    - route-table-reference-fqdn
+    properties:
+      route-table-reference-id:
+        type: string
+        description: Route Table Reference id, UUID assigned to this instance.
+      route-table-reference-fqdn:
+        type: string
+        description: FQDN entry in the route table.
+  route-table-references:
+    description: |
+      Collection of openstack route table references
+    properties:
+      route-table-reference:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/route-table-reference"
+  route-target:
+    description: |
+      Route target information
+      ###### Related Nodes
+      - TO vpn-binding( route-target org.onap.relationships.inventory.BelongsTo vpn-binding, MANY2ONE)
+    required:
+    - global-route-target
+    - route-target-role
+    properties:
+      global-route-target:
+        type: string
+        description: Number used to identify an RT, globally unique in the network
+      route-target-role:
+        type: string
+        description: Role assigned to this route target
+  route-targets:
+    description: |
+      Collection of route target information
+    properties:
+      route-target:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/route-target"
+  routing-instance:
+    description: |
+      ###### Related Nodes
+      - TO site-pair-set( routing-instance org.onap.relationships.inventory.BelongsTo site-pair-set, MANY2ONE)
+      - FROM site-pair( site-pair org.onap.relationships.inventory.BelongsTo routing-instance, MANY2ONE)
+      - ROUTING-INSTANCE is DELETED when these are DELETED SITE-PAIR
+    required:
+    - routing-instance-id
+    properties:
+      routing-instance-id:
+        type: string
+        description: Unique id of routing instance
+      rpm-owner:
+        type: string
+        description: rpm owner
+  routing-instances:
+    description: |
+      set of probes related to generic-vnf routing instance
+    properties:
+      routing-instance:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/routing-instance"
+  sdn-zone-response:
+    properties:
+      oam-networks:
+        type: object
+        $ref: "#/patchDefinitions/oam-networks"
+      az-and-dvs-switches:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/az-and-dvs-switches"
+  search:
+    properties:
+      edge-tag-query-result:
+        type: object
+        $ref: "#/patchDefinitions/edge-tag-query-result"
+      edge-tag-query-request:
+        type: object
+        $ref: "#/patchDefinitions/edge-tag-query-request"
+      search-results:
+        type: object
+        $ref: "#/patchDefinitions/search-results"
+      sdn-zone-response:
+        type: object
+        $ref: "#/patchDefinitions/sdn-zone-response"
+  search-results:
+    properties:
+      result-data:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/result-data"
+  secondary-filt:
+    description: |
+      SecondaryFilt for performing a named-query or model query
+  secondary-filter:
+    properties:
+      property-name:
+        type: string
+      filter-type:
+        type: string
+      property-value:
+        type: string
+  secondary-filts:
+    description: |
+      SecondaryFilts for performing a named-query or model query
+    properties:
+      secondary-filt:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/secondary-filt"
+  segmentation-assignment:
+    description: |
+      Openstack segmentation assignment.
+      ###### Related Nodes
+      - TO l3-network( segmentation-assignment org.onap.relationships.inventory.BelongsTo l3-network, MANY2ONE)
+    required:
+    - segmentation-id
+    properties:
+      segmentation-id:
+        type: string
+        description: Route Table Reference id, UUID assigned to this instance.
+  segmentation-assignments:
+    description: |
+      Collection of openstack segmentation assignments
+    properties:
+      segmentation-assignment:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/segmentation-assignment"
+  service:
+    description: |
+      Stand-in for service model definitions.  Likely to be deprecated in favor of models from ASDC.  Does not strictly map to ASDC services.
+    required:
+    - service-id
+    - service-description
+    properties:
+      service-id:
+        type: string
+        description: This gets defined by others to provide a unique ID for the service, we accept what is sent.
+      service-description:
+        type: string
+        description: Description of the service
+      service-selflink:
+        type: string
+        description: URL to endpoint where AAI can get more details
+  service-capabilities:
+    description: |
+      Collection of service capabilities.
+    properties:
+      service-capability:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/service-capability"
+  service-capability:
+    description: |
+      Early definition of server/resource pairings, likely to be replaced by models.  No new use should be made of this.
+      ###### Related Nodes
+      - FROM availability-zone( availability-zone org.onap.relationships.inventory.AppliesTo service-capability, MANY2MANY)
+      - FROM oam-network( oam-network org.onap.relationships.inventory.AppliesTo service-capability, MANY2MANY)
+      - SERVICE-CAPABILITY cannot be deleted if linked to AVAILABILITY-ZONE,OAM-NETWORK
+    required:
+    - service-type
+    - vnf-type
+    properties:
+      service-type:
+        type: string
+        description: This gets defined by others to provide a unique ID for the service, we accept what is sent.
+      vnf-type:
+        type: string
+        description: String capturing type of vnf, that was intended to identify the ASDC resource.  This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures.
+  service-design-and-creation:
+    description: |
+      Namespace for objects managed by ASDC
+    properties:
+      vnf-images:
+        type: array
+        items:
+          $ref: "#/patchDefinitions/vnf-image"
+      services:
+        type: array
+        items:
+          $ref: "#/patchDefinitions/service"
+      service-capabilities:
+        type: array
+        items:
+          $ref: "#/patchDefinitions/service-capability"
+      models:
+        type: array
+        items:
+          $ref: "#/patchDefinitions/model"
+      named-queries:
+        type: array
+        items:
+          $ref: "#/patchDefinitions/named-query"
+  service-instance:
+    description: |
+      Instance of a service
+      ###### Related Nodes
+      - TO generic-vnf( service-instance org.onap.relationships.inventory.ComposedOf generic-vnf, ONE2MANY)
+      - TO l3-network( service-instance org.onap.relationships.inventory.ComposedOf l3-network, ONE2MANY)
+      - TO owning-entity( service-instance org.onap.relationships.inventory.BelongsTo owning-entity, MANY2ONE)
+      - TO allotted-resource( service-instance org.onap.relationships.inventory.Uses allotted-resource, MANY2MANY)
+      - TO configuration( service-instance org.onap.relationships.inventory.Uses configuration, ONE2MANY)
+      - TO connector( service-instance org.onap.relationships.inventory.Uses connector, MANY2MANY)
+      - TO ctag-assignment( service-instance org.onap.relationships.inventory.Uses ctag-assignment, ONE2MANY)
+      - TO cvlan-tag( service-instance org.onap.relationships.inventory.ComposedOf cvlan-tag, MANY2MANY)
+      - TO instance-group( service-instance org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY)
+      - TO logical-link( service-instance org.onap.relationships.inventory.Uses logical-link, ONE2MANY)
+      - TO pnf( service-instance org.onap.relationships.inventory.ComposedOf pnf, ONE2MANY)
+      - TO service-instance( service-instance org.onap.relationships.inventory.ComposedOf service-instance, ONE2MANY)
+      - TO vlan( service-instance org.onap.relationships.inventory.ComposedOf vlan, ONE2MANY)
+      - TO zone( service-instance org.onap.relationships.inventory.LocatedIn zone, MANY2ONE)
+      - TO service-subscription( service-instance org.onap.relationships.inventory.BelongsTo service-subscription, MANY2ONE)
+      - TO vce( service-instance org.onap.relationships.inventory.ComposedOf vce, ONE2MANY)
+      - FROM project( project org.onap.relationships.inventory.Uses service-instance, ONE2MANY)
+      - FROM allotted-resource( allotted-resource org.onap.relationships.inventory.BelongsTo service-instance, MANY2ONE)
+      - FROM metadatum( metadatum org.onap.relationships.inventory.BelongsTo service-instance, MANY2ONE)
+      - FROM service-instance( service-instance org.onap.relationships.inventory.ComposedOf service-instance, ONE2MANY)
+      - SERVICE-INSTANCE is DELETED when these are DELETED ALLOTTED-RESOURCE,METADATUM
+      - SERVICE-INSTANCE deletion means associated objects of these types are also DELETED:LOGICAL-LINK
+    required:
+    - service-instance-id
+    - service-type
+    - service-role
+    - created-at
+    - updated-at
+    - description
+    properties:
+      service-instance-id:
+        type: string
+        description: Uniquely identifies this instance of a service
+      service-instance-name:
+        type: string
+        description: This field will store a name assigned to the service-instance.
+      service-type:
+        type: string
+        description: String capturing type of service.
+      service-role:
+        type: string
+        description: String capturing the service role.
+      environment-context:
+        type: string
+        description: This field will store the environment context assigned to the service-instance.
+      workload-context:
+        type: string
+        description: This field will store the workload context assigned to the service-instance.
+      created-at:
+        type: string
+        description: create time of Network Service.
+      updated-at:
+        type: string
+        description: last update of Network Service.
+      description:
+        type: string
+        description: short description for service-instance.
+      model-invariant-id:
+        type: string
+        description: the ASDC model id for this resource or service model.
+      model-version-id:
+        type: string
+        description: the ASDC model version for this resource or service model.
+      persona-model-version:
+        type: string
+        description: the ASDC model version for this resource or service model.
+      widget-model-id:
+        type: string
+        description: the ASDC data dictionary widget model. This maps directly to the A&AI widget.
+      widget-model-version:
+        type: string
+        description: the ASDC data dictionary version of the widget model.This maps directly to the A&AI version of the widget.
+      bandwidth-total:
+        type: string
+        description: Indicates the total bandwidth to be used for this service.
+      bandwidth-up-wan1:
+        type: string
+        description: indicates the upstream bandwidth this service will use on the WAN1 port of the physical device.
+      bandwidth-down-wan1:
+        type: string
+        description: indicates the downstream bandwidth this service will use on the WAN1 port of the physical device.
+      bandwidth-up-wan2:
+        type: string
+        description: indicates the upstream bandwidth this service will use on the WAN2 port of the physical device.
+      bandwidth-down-wan2:
+        type: string
+        description: indicates the downstream bandwidth this service will use on the WAN2 port of the physical device.
+      vhn-portal-url:
+        type: string
+        description: URL customers will use to access the vHN Portal.
+      service-instance-location-id:
+        type: string
+        description: An identifier that customers assign to the location where this service is being used.
+  service-instances:
+    description: |
+      Collection of service instances
+    properties:
+      service-instance:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/service-instance"
+  service-subscription:
+    description: |
+      Object that group service instances.
+      ###### Related Nodes
+      - TO customer( service-subscription org.onap.relationships.inventory.BelongsTo customer, MANY2ONE)
+      - TO tenant( service-subscription org.onap.relationships.inventory.Uses tenant, MANY2MANY)
+      - FROM service-instance( service-instance org.onap.relationships.inventory.BelongsTo service-subscription, MANY2ONE)
+      - SERVICE-SUBSCRIPTION is DELETED when these are DELETED SERVICE-INSTANCE
+    required:
+    - service-type
+    properties:
+      service-type:
+        type: string
+        description: Value defined by orchestration to identify this service across ECOMP.
+      temp-ub-sub-account-id:
+        type: string
+        description: This property will be deleted from A&AI in the near future. Only stop gap solution.
+  service-subscriptions:
+    description: |
+      Collection of objects that group service instances.
+    properties:
+      service-subscription:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/service-subscription"
+  services:
+    description: |
+      Collection of service model definitions.  Likely to be deprecated in favor of models from ASDC.
+    properties:
+      service:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/service"
+  site-pair:
+    description: |
+      ###### Related Nodes
+      - TO routing-instance( site-pair org.onap.relationships.inventory.BelongsTo routing-instance, MANY2ONE)
+      - FROM class-of-service( class-of-service org.onap.relationships.inventory.BelongsTo site-pair, MANY2ONE)
+      - SITE-PAIR is DELETED when these are DELETED CLASS-OF-SERVICE
+    required:
+    - site-pair-id
+    properties:
+      site-pair-id:
+        type: string
+        description: unique identifier of probe
+      source-ip:
+        type: string
+        description: Prefix address
+      destination-ip:
+        type: string
+        description: Prefix address
+      ip-version:
+        type: string
+        description: ip version, v4, v6
+      destination-hostname:
+        type: string
+        description: Hostname of the destination equipment to which SLAs are measured against.
+      destination-equip-type:
+        type: string
+        description: The type of destinatination equipment. Could be Router, UCPE, etc.
+  site-pair-set:
+    description: |
+      Set of instances for probes used to measure service level agreements
+      ###### Related Nodes
+      - TO generic-vnf( site-pair-set org.onap.relationships.inventory.AppliesTo generic-vnf, MANY2MANY)
+      - FROM routing-instance( routing-instance org.onap.relationships.inventory.BelongsTo site-pair-set, MANY2ONE)
+      - SITE-PAIR-SET is DELETED when these are DELETED ROUTING-INSTANCE
+    required:
+    - site-pair-set-id
+    properties:
+      site-pair-set-id:
+        type: string
+        description: Unique id of site pair set.
+  site-pair-sets:
+    description: |
+      Collection of sets of instances for probes related to generic-vnf
+    properties:
+      site-pair-set:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/site-pair-set"
+  site-pairs:
+    description: |
+      probe within a set
+    properties:
+      site-pair:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/site-pair"
+  snapshot:
+    description: |
+      Openstack snapshot
+      ###### Related Nodes
+      - TO cloud-region( snapshot org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE)
+      - FROM vserver( vserver org.onap.relationships.inventory.Uses snapshot, ONE2ONE)
+    required:
+    - snapshot-id
+    properties:
+      snapshot-id:
+        type: string
+        description: Snapshot id, this is the key UUID assoc associated in glance with the snapshots.
+      snapshot-name:
+        type: string
+        description: Snapshot name
+      snapshot-architecture:
+        type: string
+        description: Operating system architecture
+      snapshot-os-distro:
+        type: string
+        description: The common name of the operating system distribution in lowercase
+      snapshot-os-version:
+        type: string
+        description: The operating system version as specified by the distributor.
+      application:
+        type: string
+        description: The application that the image instantiates.
+      application-vendor:
+        type: string
+        description: The vendor of the application.
+      application-version:
+        type: string
+        description: The version of the application.
+      snapshot-selflink:
+        type: string
+        description: URL to endpoint where AAI can get more details
+      prev-snapshot-id:
+        type: string
+        description: This field contains the UUID of the previous snapshot (if any).
+  snapshots:
+    description: |
+      Collection of openstack snapshots
+    properties:
+      snapshot:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/snapshot"
+  sriov-pf:
+    description: |
+      SR-IOV Physical Function
+      ###### Related Nodes
+      - TO p-interface( sriov-pf org.onap.relationships.inventory.BelongsTo p-interface, ONE2ONE)
+      - FROM sriov-vf( sriov-vf org.onap.relationships.inventory.Uses sriov-pf, MANY2ONE)
+    required:
+    - pf-pci-id
+    properties:
+      pf-pci-id:
+        type: string
+        description: Identifier for the sriov-pf
+  sriov-pfs:
+    description: |
+      Collection of SR-IOV Physical Functions.
+    properties:
+      sriov-pf:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/sriov-pf"
+  sriov-vf:
+    description: |
+      SR-IOV Virtual Function (not to be confused with virtual network function)
+      ###### Related Nodes
+      - TO l-interface( sriov-vf org.onap.relationships.inventory.BelongsTo l-interface, ONE2ONE)
+      - TO sriov-pf( sriov-vf org.onap.relationships.inventory.Uses sriov-pf, MANY2ONE)
+    required:
+    - pci-id
+    properties:
+      pci-id:
+        type: string
+        description: PCI ID used to identify the sriov-vf
+      vf-vlan-filter:
+        type: string
+        description: This metadata provides option to specify list of VLAN filters applied on VF to pass the traffic to VM.
+      vf-mac-filter:
+        type: string
+        description: When MAC filters are specified, VF-agent service configures VFs to do MAC level filtering before the traffic is passed to VM.
+      vf-vlan-strip:
+        type: boolean
+        description: When this field is set to true, VF will configured to strip the outer TAG before the traffic is passed to VM.
+      vf-vlan-anti-spoof-check:
+        type: boolean
+        description: This option ensures anti VLAN spoof checks are done at the VF level to comply with security. The disable check will also be honored per the VNF needs for trusted VMs.
+      vf-mac-anti-spoof-check:
+        type: boolean
+        description: This option ensures anti MAC spoof checks are done at the VF level to comply with security. The disable check will also be honored per the VNF needs for trusted VMs.
+      vf-mirrors:
+        type: string
+        description: This option defines the set of Mirror objects which essentially mirrors the traffic from source to set of collector VNF Ports.
+      vf-broadcast-allow:
+        type: boolean
+        description: This option, if set to true, sets the VF in promiscuous mode and allows all broadcast traffic to reach the VM
+      vf-unknown-multicast-allow:
+        type: boolean
+        description: This option, if set to true, sets the VF in promiscuous mode and allows unknown multicast traffic to reach the VM
+      vf-unknown-unicast-allow:
+        type: boolean
+        description: This option, if set to true, sets the VF in promiscuous mode and allows unknown unicast traffic to reach the VM
+      vf-insert-stag:
+        type: boolean
+        description: This option, if set to true, instructs to insert outer tag after traffic comes out of VM.
+      vf-link-status:
+        type: string
+        description: This option is used to set the link status.  Valid values as of 1607 are on, off, and auto.
+  sriov-vfs:
+    description: |
+      Collection of SR-IOV Virtual Functions.
+    properties:
+      sriov-vf:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/sriov-vf"
+  start-node-filter:
+    properties:
+      property-name:
+        type: string
+      property-value:
+        type: string
+  subnet:
+    description: |
+      ###### Related Nodes
+      - TO l3-network( subnet org.onap.relationships.inventory.BelongsTo l3-network, MANY2ONE)
+      - FROM l3-interface-ipv4-address-list( l3-interface-ipv4-address-list org.onap.relationships.inventory.network.MemberOf subnet, MANY2MANY)
+      - FROM l3-interface-ipv6-address-list( l3-interface-ipv6-address-list org.onap.relationships.inventory.network.MemberOf subnet, MANY2MANY)
+      - FROM host-route( host-route org.onap.relationships.inventory.BelongsTo subnet, MANY2ONE)
+      - FROM vip-ipv4-address-list( vip-ipv4-address-list org.onap.relationships.inventory.MemberOf subnet, MANY2MANY)
+      - FROM vip-ipv6-address-list( vip-ipv6-address-list org.onap.relationships.inventory.MemberOf subnet, MANY2MANY)
+      - SUBNET cannot be deleted if linked to L3-INTERFACE-IPV4-ADDRESS-LIST,L3-INTERFACE-IPV6-ADDRESS-LIST,VIP-IPV4-ADDRESS-LIST,VIP-IPV6-ADDRESS-LIST
+      - SUBNET is DELETED when these are DELETED HOST-ROUTE
+    required:
+    - subnet-id
+    - dhcp-enabled
+    properties:
+      subnet-id:
+        type: string
+        description: Subnet ID, should be UUID.
+      subnet-name:
+        type: string
+        description: Name associated with the subnet.
+      neutron-subnet-id:
+        type: string
+        description: Neutron id of this subnet
+      gateway-address:
+        type: string
+        description: gateway ip address
+      network-start-address:
+        type: string
+        description: network start address
+      cidr-mask:
+        type: string
+        description: cidr mask
+      ip-version:
+        type: string
+        description: ip version
+      orchestration-status:
+        type: string
+        description: Orchestration status of this VNF, mastered by MSO
+      dhcp-enabled:
+        type: boolean
+      dhcp-start:
+        type: string
+        description: the start address reserved for use by dhcp
+      dhcp-end:
+        type: string
+        description: the last address reserved for use by dhcp
+      subnet-role:
+        type: string
+        description: role of the subnet, referenced when assigning IPs
+      ip-assignment-direction:
+        type: string
+        description: ip address assignment direction of the subnet
+  subnets:
+    properties:
+      subnet:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/subnet"
+  tagged-inventory-item-list:
+    properties:
+      inventory-item:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/inventory-item"
+  tenant:
+    description: |
+      Openstack tenant
+      ###### Related Nodes
+      - TO cloud-region( tenant org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE)
+      - TO group-assignment( tenant org.onap.relationships.inventory.MemberOf group-assignment, MANY2MANY)
+      - TO l3-network( tenant org.onap.relationships.inventory.Uses l3-network, MANY2MANY)
+      - TO volume-group( tenant org.onap.relationships.inventory.DependsOn volume-group, ONE2MANY)
+      - FROM service-subscription( service-subscription org.onap.relationships.inventory.Uses tenant, MANY2MANY)
+      - FROM vserver( vserver org.onap.relationships.inventory.BelongsTo tenant, MANY2ONE)
+      - TENANT cannot be deleted if linked to VSERVER
+    required:
+    - tenant-id
+    - tenant-name
+    properties:
+      tenant-id:
+        type: string
+        description: Unique id relative to the cloud-region.
+      tenant-name:
+        type: string
+        description: Readable name of tenant
+      tenant-context:
+        type: string
+        description: This field will store the tenant context.
+  tenants:
+    description: |
+      Collection of openstack tenants.
+    properties:
+      tenant:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/tenant"
+  tunnel-xconnect:
+    description: |
+      Represents the specifics of a tunnel cross connect piece of a resource that gets separately allotted
+      ###### Related Nodes
+      - TO allotted-resource( tunnel-xconnect org.onap.relationships.inventory.BelongsTo allotted-resource, ONE2ONE)
+    required:
+    - id
+    - bandwidth-up-wan1
+    - bandwidth-down-wan1
+    - bandwidth-up-wan2
+    - bandwidth-down-wan2
+    properties:
+      id:
+        type: string
+        description: Allotted Resource id UUID assigned to this instance.
+      bandwidth-up-wan1:
+        type: string
+        description: The WAN uplink bandwidth for WAN1
+      bandwidth-down-wan1:
+        type: string
+        description: The WAN downlink bandwidth for WAN1
+      bandwidth-up-wan2:
+        type: string
+        description: The WAN uplink bandwidth for WAN2
+      bandwidth-down-wan2:
+        type: string
+        description: The WAN downlink bandwidth for WAN2
+  tunnel-xconnects:
+    description: |
+      This object is used to store the specific tunnel cross connect aspects of an allotted resource
+    properties:
+      tunnel-xconnect:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/tunnel-xconnect"
+  update:
+    description: |
+      Serves a PATCH like function.  Does not enforce concurrency control.  Clear each usage with AAI team.
+    required:
+    - update-node-type
+    properties:
+      update-node-type:
+        type: string
+      update-node-key:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/update-node-key"
+      update-node-uri:
+        type: string
+      action:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/action"
+  update-node-key:
+    properties:
+      key-name:
+        type: string
+      key-value:
+        type: string
+  vce:
+    description: |
+      Virtual Customer Edge Router, used specifically for Gamma.  This object is deprecated.
+      ###### Related Nodes
+      - TO availability-zone( vce org.onap.relationships.inventory.Uses availability-zone, MANY2MANY)
+      - TO complex( vce org.onap.relationships.inventory.LocatedIn complex, MANY2MANY)
+      - TO vserver( vce tosca.relationships.HostedOn vserver, ONE2MANY)
+      - FROM entitlement( entitlement org.onap.relationships.inventory.BelongsTo vce, MANY2ONE)
+      - FROM license( license org.onap.relationships.inventory.BelongsTo vce, MANY2ONE)
+      - FROM port-group( port-group org.onap.relationships.inventory.BelongsTo vce, MANY2ONE)
+      - FROM service-instance( service-instance org.onap.relationships.inventory.ComposedOf vce, ONE2MANY)
+      - VCE is DELETED when these are DELETED ENTITLEMENT,LICENSE,PORT-GROUP
+    required:
+    - vnf-id
+    - vnf-name
+    - vnf-type
+    properties:
+      vnf-id:
+        type: string
+        description: Unique id of VNF.  This is unique across the graph.
+      vnf-name:
+        type: string
+        description: Name of VNF.
+      vnf-name2:
+        type: string
+        description: Alternate name of VNF.
+      vnf-type:
+        type: string
+        description: String capturing type of vnf, that was intended to identify the ASDC resource.  This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures.
+      service-id:
+        type: string
+        description: Unique identifier of service, does not strictly map to ASDC services, SOON TO BE DEPRECATED.
+      regional-resource-zone:
+        type: string
+        description: Regional way of organizing pservers, source of truth should define values
+      prov-status:
+        type: string
+        description: Trigger for operational monitoring of this resource by Service Assurance systems.
+      operational-status:
+        type: string
+        description: Indicator for whether the resource is considered operational
+      license-key:
+        type: string
+        description: OBSOLETE -  do not use
+      equipment-role:
+        type: string
+        description: Network role being played by this VNF
+      orchestration-status:
+        type: string
+        description: Orchestration status of this VNF, mastered by MSO
+      heat-stack-id:
+        type: string
+        description: Heat stack id corresponding to this instance, managed by MSO
+      mso-catalog-key:
+        type: string
+        description: Corresponds to the SDN-C catalog id used to configure this VCE
+      vpe-id:
+        type: string
+        description: Unique ID of VPE connected to this VCE.
+      v6-vce-wan-address:
+        type: string
+        description: Valid v6 IP address for the WAN Link on this router.  Implied length of /64.
+      ipv4-oam-address:
+        type: string
+        description: Address tail-f uses to configure vce, also used for troubleshooting and is IP used for traps generated by VCE.
+  vces:
+    description: |
+      Collection of Virtual Customer Edge Routers, used specifically for Gamma.  This object is deprecated.
+    properties:
+      vce:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/vce"
+  vf-module:
+    description: |
+      a deployment unit of VNFCs
+      ###### Related Nodes
+      - TO generic-vnf( vf-module org.onap.relationships.inventory.BelongsTo generic-vnf, MANY2ONE)
+      - TO l3-network( vf-module org.onap.relationships.inventory.DependsOn l3-network, MANY2MANY)
+      - TO vnfc( vf-module org.onap.relationships.inventory.Uses vnfc, ONE2MANY)
+      - TO volume-group( vf-module org.onap.relationships.inventory.Uses volume-group, ONE2ONE)
+      - TO vserver( vf-module org.onap.relationships.inventory.Uses vserver, ONE2MANY)
+      - VF-MODULE cannot be deleted if linked to VNFC
+    required:
+    - vf-module-id
+    - is-base-vf-module
+    properties:
+      vf-module-id:
+        type: string
+        description: Unique ID of vf-module.
+      vf-module-name:
+        type: string
+        description: Name of vf-module
+      heat-stack-id:
+        type: string
+        description: Heat stack id corresponding to this instance.
+      orchestration-status:
+        type: string
+        description: orchestration status of this vf-module, mastered by MSO
+      is-base-vf-module:
+        type: boolean
+  vf-modules:
+    description: |
+      Collection of vf-modules, a deployment unit of VNFCs
+    properties:
+      vf-module:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/vf-module"
+  vig-server:
+    description: |
+      vig-server contains information about a vig server used for IPSec-configuration. Populated by SDN-C from 1607
+      ###### Related Nodes
+      - TO ipsec-configuration( vig-server org.onap.relationships.inventory.BelongsTo ipsec-configuration, MANY2ONE)
+    required:
+    - vig-address-type
+    properties:
+      vig-address-type:
+        type: string
+        description: indicates whether the VIG is for AVPN or INTERNET
+      ipaddress-v4-vig:
+        type: string
+        description: v4 IP of the vig server
+      ipaddress-v6-vig:
+        type: string
+        description: v6 IP of the vig server
+  vig-servers:
+    properties:
+      vig-server:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/vig-server"
+  vip-ipv4-address-list:
+    description: |
+      IPv4 Address Range
+      ###### Related Nodes
+      - TO cloud-region( vip-ipv4-address-list org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE)
+      - TO instance-group( vip-ipv4-address-list org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY)
+      - TO subnet( vip-ipv4-address-list org.onap.relationships.inventory.MemberOf subnet, MANY2MANY)
+      - FROM vnfc( vnfc org.onap.relationships.inventory.Uses vip-ipv4-address-list, MANY2MANY)
+    required:
+    - vip-ipv4-address
+    properties:
+      vip-ipv4-address:
+        type: string
+        description: IP address
+      vip-ipv4-prefix-length:
+        type: integer
+        format: int64
+        description: Prefix length, 32 for single address
+      vlan-id-inner:
+        type: integer
+        format: int64
+        description: Inner VLAN tag
+      vlan-id-outer:
+        type: integer
+        format: int64
+        description: Outer VLAN tag
+      is-floating:
+        type: boolean
+        description: Indicator of fixed or floating address
+  vip-ipv6-address-list:
+    description: |
+      IPv6 Address Range
+      ###### Related Nodes
+      - TO cloud-region( vip-ipv6-address-list org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE)
+      - TO instance-group( vip-ipv6-address-list org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY)
+      - TO subnet( vip-ipv6-address-list org.onap.relationships.inventory.MemberOf subnet, MANY2MANY)
+      - FROM vnfc( vnfc org.onap.relationships.inventory.Uses vip-ipv6-address-list, MANY2MANY)
+    required:
+    - vip-ipv6-address
+    properties:
+      vip-ipv6-address:
+        type: string
+        description: IP address
+      vip-ipv6-prefix-length:
+        type: integer
+        format: int64
+        description: Prefix length, 128 for single address
+      vlan-id-inner:
+        type: integer
+        format: int64
+        description: Inner VLAN tag
+      vlan-id-outer:
+        type: integer
+        format: int64
+        description: Outer VLAN tag
+      is-floating:
+        type: boolean
+        description: Indicator of fixed or floating address
+  virtual-data-center:
+    description: |
+      Virtual organization of cloud infrastructure elements in a data center context
+      ###### Related Nodes
+      - FROM connector( connector org.onap.relationships.inventory.LocatedIn virtual-data-center, MANY2MANY)
+      - FROM generic-vnf( generic-vnf org.onap.relationships.inventory.LocatedIn virtual-data-center, MANY2MANY)
+      - FROM logical-link( logical-link org.onap.relationships.inventory.LocatedIn virtual-data-center, MANY2MANY)
+    required:
+    - vdc-id
+    - vdc-name
+    properties:
+      vdc-id:
+        type: string
+        description: Unique ID of the vdc
+      vdc-name:
+        type: string
+        description: Name of the virtual data center
+  virtual-data-centers:
+    description: |
+      Virtual organization of cloud infrastructure elements in a data center context
+    properties:
+      virtual-data-center:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/virtual-data-center"
+  vlan:
+    description: |
+      Definition of vlan
+      ###### Related Nodes
+      - TO l-interface( vlan tosca.relationships.network.LinksTo l-interface, MANY2ONE)
+      - TO logical-link( vlan org.onap.relationships.inventory.Uses logical-link, MANY2MANY)
+      - TO multicast-configuration( vlan org.onap.relationships.inventory.Uses multicast-configuration, MANY2MANY)
+      - FROM allotted-resource( allotted-resource org.onap.relationships.inventory.PartOf vlan, MANY2MANY)
+      - FROM service-instance( service-instance org.onap.relationships.inventory.ComposedOf vlan, ONE2MANY)
+      - FROM l3-interface-ipv4-address-list( l3-interface-ipv4-address-list org.onap.relationships.inventory.BelongsTo vlan, MANY2ONE)
+      - FROM l3-interface-ipv6-address-list( l3-interface-ipv6-address-list org.onap.relationships.inventory.BelongsTo vlan, MANY2ONE)
+      - VLAN is DELETED when these are DELETED L3-INTERFACE-IPV4-ADDRESS-LIST,L3-INTERFACE-IPV6-ADDRESS-LIST
+      - VLAN deletion means associated objects of these types are also DELETED:LOGICAL-LINK
+    required:
+    - vlan-interface
+    - in-maint
+    - is-ip-unnumbered
+    properties:
+      vlan-interface:
+        type: string
+        description: String that identifies the interface
+      vlan-id-inner:
+        type: integer
+        format: int64
+        description: Inner VLAN tag
+      vlan-id-outer:
+        type: integer
+        format: int64
+        description: Outer VLAN tag
+  vlans:
+    properties:
+      vlan:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/vlan"
+  vnf:
+    description: |
+      Abstract vnf class
+    required:
+    - vnf-id
+    properties:
+      vnf-id:
+        type: string
+        description: Unique id of VNF.  This is unique across the graph.
+  vnf-image:
+    description: |
+      Image object that pertain to a VNF that doesn't have associated vservers.  This is a kludge.
+      ###### Related Nodes
+      - FROM generic-vnf( generic-vnf org.onap.relationships.inventory.Uses vnf-image, MANY2ONE)
+      - VNF-IMAGE cannot be deleted if linked to GENERIC-VNF
+    required:
+    - vnf-image-uuid
+    - application
+    - application-vendor
+    properties:
+      vnf-image-uuid:
+        type: string
+        description: Unique ID of this asset
+      application:
+        type: string
+        description: The application that the image instantiates.
+      application-vendor:
+        type: string
+        description: The vendor of the application.
+      application-version:
+        type: string
+        description: The version of the application.
+      selflink:
+        type: string
+        description: URL to endpoint where AAI can get more details
+  vnf-images:
+    description: |
+      Collection of image objects that pertain to a VNF that doesn't have associated vservers.  This is a kludge.
+    properties:
+      vnf-image:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/vnf-image"
+  vnfc:
+    description: |
+      ###### Related Nodes
+      - TO generic-vnf( vnfc org.onap.relationships.inventory.BelongsTo generic-vnf, MANY2ONE)
+      - TO instance-group( vnfc org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY)
+      - TO vip-ipv4-address-list( vnfc org.onap.relationships.inventory.Uses vip-ipv4-address-list, MANY2MANY)
+      - TO vip-ipv6-address-list( vnfc org.onap.relationships.inventory.Uses vip-ipv6-address-list, MANY2MANY)
+      - TO vserver( vnfc tosca.relationships.HostedOn vserver, ONE2MANY)
+      - FROM vf-module( vf-module org.onap.relationships.inventory.Uses vnfc, ONE2MANY)
+      - FROM l3-interface-ipv4-address-list( l3-interface-ipv4-address-list org.onap.relationships.inventory.BelongsTo vnfc, MANY2ONE)
+      - FROM l3-interface-ipv6-address-list( l3-interface-ipv6-address-list org.onap.relationships.inventory.BelongsTo vnfc, MANY2ONE)
+      - VNFC is DELETED when these are DELETED L3-INTERFACE-IPV4-ADDRESS-LIST,L3-INTERFACE-IPV6-ADDRESS-LIST
+    required:
+    - vnfc-name
+    - nfc-naming-code
+    - nfc-function
+    - in-maint
+    - is-closed-loop-disabled
+    properties:
+      vnfc-name:
+        type: string
+        description: Unique ID of vnfc.
+      nfc-naming-code:
+        type: string
+        description: Short code that is used in naming instances of the item being modeled
+      nfc-function:
+        type: string
+        description: English description of function that the specific resource deployment is providing. Assigned as part of the customization of a resource in a service
+      prov-status:
+        type: string
+        description: prov status of this vnfc
+      orchestration-status:
+        type: string
+        description: Orchestration status of this VNF, mastered by APP-C
+      ipaddress-v4-oam-vip:
+        type: string
+        description: Oam V4 vip address of this vnfc
+      in-maint:
+        type: boolean
+      is-closed-loop-disabled:
+        type: boolean
+      group-notation:
+        type: string
+        description: Group notation of VNFC
+      model-invariant-id:
+        type: string
+        description: the ASDC model id for this resource or service model.
+      model-version-id:
+        type: string
+        description: the ASDC model version for this resource or service model.
+  vnfcs:
+    description: |
+      virtual network components associated with a vserver from application controller.
+    properties:
+      vnfc:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/vnfc"
+  volume:
+    description: |
+      Ephemeral Block storage volume.
+      ###### Related Nodes
+      - FROM vserver (PARENT of volume, vserver tosca.relationships.AttachesTo volume)
+    required:
+    - volume-id
+    - volume-selflink
+    properties:
+      volume-id:
+        type: string
+        description: Unique ID of block storage volume relative to the vserver.
+      volume-selflink:
+        type: string
+        description: URL to endpoint where AAI can get more details
+  volume-group:
+    description: |
+      Persistent block-level storage.
+      ###### Related Nodes
+      - TO cloud-region( volume-group org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE)
+      - TO complex( volume-group org.onap.relationships.inventory.LocatedIn complex, MANY2ONE)
+      - FROM generic-vnf( generic-vnf org.onap.relationships.inventory.DependsOn volume-group, ONE2MANY)
+      - FROM vf-module( vf-module org.onap.relationships.inventory.Uses volume-group, ONE2ONE)
+      - FROM tenant( tenant org.onap.relationships.inventory.DependsOn volume-group, ONE2MANY)
+    required:
+    - volume-group-id
+    - volume-group-name
+    - vnf-type
+    properties:
+      volume-group-id:
+        type: string
+        description: Unique ID of volume-group.
+      volume-group-name:
+        type: string
+        description: Name of the volume group.
+      heat-stack-id:
+        type: string
+        description: Heat stack id corresponding to this volume-group
+      vnf-type:
+        type: string
+        description: String capturing type of vnf, that was intended to identify the ASDC resource.  This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures.
+      orchestration-status:
+        type: string
+        description: Orchestration status of this volume-group
+      model-customization-id:
+        type: string
+        description: captures the id of all the configuration used to customize the resource for the service.
+      vf-module-model-customization-id:
+        type: string
+        description: helps relate the volume group to the vf-module whose components will require the volume group
+  volume-groups:
+    description: |
+      Collection of persistent block-level storage.
+    properties:
+      volume-group:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/volume-group"
+  volumes:
+    description: |
+      Collection of ephemeral Block storage volumes.
+    properties:
+      volume:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/volume"
+  vpls-pe:
+    description: |
+      VPLS Provider Edge routers.
+      ###### Related Nodes
+      - TO complex( vpls-pe org.onap.relationships.inventory.LocatedIn complex, MANY2ONE)
+      - TO ctag-pool( vpls-pe org.onap.relationships.inventory.Uses ctag-pool, MANY2MANY)
+      - FROM lag-interface( lag-interface tosca.relationships.network.BindsTo vpls-pe, MANY2ONE)
+      - FROM p-interface( p-interface tosca.relationships.network.BindsTo vpls-pe, MANY2ONE)
+      - VPLS-PE is DELETED when these are DELETED LAG-INTERFACE,P-INTERFACE
+    required:
+    - equipment-name
+    properties:
+      equipment-name:
+        type: string
+      prov-status:
+        type: string
+        description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems.
+      ipv4-oam-address:
+        type: string
+        description: Address tail-f uses to configure generic-vnf, also used for troubleshooting and is IP used for traps generated by GenericVnf (v4-loopback0-ip-address).
+      equipment-role:
+        type: string
+        description: Client should send valid enumerated value, e.g., VPLS-PE.
+      vlan-id-outer:
+        type: integer
+        format: int64
+        description: Temporary location for stag to get to VCE
+  vpls-pes:
+    description: |
+      Collection of VPLS Provider Edge routers
+    properties:
+      vpls-pe:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/vpls-pe"
+  vpn-binding:
+    description: |
+      VPN binding
+      ###### Related Nodes
+      - FROM allotted-resource( allotted-resource org.onap.relationships.inventory.BelongsTo vpn-binding, MANY2MANY)
+      - FROM l3-network( l3-network org.onap.relationships.inventory.Uses vpn-binding, MANY2MANY)
+      - FROM logical-link( logical-link org.onap.relationships.inventory.Uses vpn-binding, MANY2MANY)
+      - FROM route-target( route-target org.onap.relationships.inventory.BelongsTo vpn-binding, MANY2ONE)
+      - VPN-BINDING cannot be deleted if linked to ALLOTTED-RESOURCE,L3-NETWORK,LOGICAL-LINK
+      - VPN-BINDING is DELETED when these are DELETED ROUTE-TARGET
+    required:
+    - vpn-id
+    - vpn-name
+    properties:
+      vpn-id:
+        type: string
+        description: VPN ID, globally unique within A&AI
+      vpn-name:
+        type: string
+        description: VPN Name
+      vpn-platform:
+        type: string
+        description: the platform associated with the VPN example AVPN, Mobility
+      vpn-type:
+        type: string
+        description: Type of the vpn, should be taken from enumerated/valid values
+      vpn-region:
+        type: string
+        description: region of customer vpn
+      customer-vpn-id:
+        type: string
+        description: id for this customer vpn
+      route-distinguisher:
+        type: string
+        description: Used to distinguish the distinct VPN routes of separate customers who connect to the provider in an MPLS network.
+  vpn-bindings:
+    properties:
+      vpn-binding:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/vpn-binding"
+  vserver:
+    description: |
+      Virtual Servers, aka virtual machine or VM.
+      ###### Related Nodes
+      - TO tenant( vserver org.onap.relationships.inventory.BelongsTo tenant, MANY2ONE)
+      - TO flavor( vserver org.onap.relationships.inventory.Uses flavor, MANY2ONE)
+      - TO image( vserver org.onap.relationships.inventory.Uses image, MANY2ONE)
+      - TO pserver( vserver tosca.relationships.HostedOn pserver, MANY2ONE)
+      - TO snapshot( vserver org.onap.relationships.inventory.Uses snapshot, ONE2ONE)
+      - TO volume (CHILD of vserver, vserver tosca.relationships.AttachesTo volume, ONE2MANY)
+      - FROM generic-vnf( generic-vnf tosca.relationships.HostedOn vserver, ONE2MANY)
+      - FROM vce( vce tosca.relationships.HostedOn vserver, ONE2MANY)
+      - FROM l-interface( l-interface tosca.relationships.network.BindsTo vserver, MANY2ONE)
+      - FROM vf-module( vf-module org.onap.relationships.inventory.Uses vserver, ONE2MANY)
+      - FROM vnfc( vnfc tosca.relationships.HostedOn vserver, ONE2MANY)
+      - VSERVER is DELETED when these are DELETED L-INTERFACE
+      - VSERVER deletion means associated objects of these types are also DELETED:VOLUME
+    required:
+    - vserver-id
+    - vserver-name
+    - vserver-selflink
+    - in-maint
+    - is-closed-loop-disabled
+    properties:
+      vserver-id:
+        type: string
+        description: Unique identifier for this vserver relative to its tenant
+      vserver-name:
+        type: string
+        description: Name of vserver
+      vserver-name2:
+        type: string
+        description: Alternative name of vserver
+      prov-status:
+        type: string
+        description: Trigger for operational monitoring of this resource by Service Assurance systems.
+      vserver-selflink:
+        type: string
+        description: URL to endpoint where AAI can get more details
+      in-maint:
+        type: boolean
+      is-closed-loop-disabled:
+        type: boolean
+  vservers:
+    description: |
+      Collection of virtual Servers, aka virtual machines or VMs.
+    properties:
+      vserver:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/vserver"
+  zone:
+    description: |
+      A zone is a grouping of assets in a location homing to the same connections into the CBB
+      ###### Related Nodes
+      - TO complex( zone org.onap.relationships.inventory.LocatedIn complex, MANY2ONE)
+      - FROM cloud-region( cloud-region org.onap.relationships.inventory.LocatedIn zone, MANY2ONE)
+      - FROM pnf( pnf org.onap.relationships.inventory.LocatedIn zone, MANY2ONE)
+      - FROM pserver( pserver org.onap.relationships.inventory.LocatedIn zone, MANY2ONE)
+      - FROM service-instance( service-instance org.onap.relationships.inventory.LocatedIn zone, MANY2ONE)
+    required:
+    - zone-id
+    - zone-name
+    - design-type
+    - zone-context
+    properties:
+      zone-id:
+        type: string
+        description: Code assigned by AIC to the zone
+      zone-name:
+        type: string
+        description: English name associated with the zone
+      design-type:
+        type: string
+        description: Design of zone [Medium/Large?]
+      zone-context:
+        type: string
+        description: Context of zone [production/test]
+      status:
+        type: string
+        description: Status of a zone.
+  zones:
+    description: |
+      Collection of zones
+    properties:
+      zone:
+        type: array
+        items:          
+          $ref: "#/patchDefinitions/zone"
+getDefinitions:
+  aai-internal:
+    properties:
+      property-name:
+        type: string
+      property-value:
+        type: string
+  action:
+    properties:
+      action-type:
+        type: string
+      action-data:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/action-data"
+  action-data:
+    properties:
+      property-name:
+        type: string
+      property-value:
+        type: string
+  actions:
+    description: |
+      APIs that are more action related than REST (e.g., notify, update).
+    properties:
+      update:
+        type: object
+        $ref: "#/getDefinitions/update"
+      notify:
+        type: object
+        $ref: "#/getDefinitions/notify"
+  allotted-resource:
+    description: |
+      Represents a slice or partial piece of a resource that gets separately allotted
+      ###### Related Nodes
+      - TO allotted-resource( allotted-resource tosca.relationships.network.BindsTo allotted-resource, ONE2ONE)
+      - TO generic-vnf( allotted-resource org.onap.relationships.inventory.PartOf generic-vnf, MANY2MANY)
+      - TO instance-group( allotted-resource org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY)
+      - TO l3-network( allotted-resource org.onap.relationships.inventory.PartOf l3-network, MANY2MANY)
+      - TO l-interface( allotted-resource org.onap.relationships.inventory.Uses l-interface, ONE2MANY)
+      - TO network-policy( allotted-resource org.onap.relationships.inventory.Uses network-policy, ONE2ONE)
+      - TO vlan( allotted-resource org.onap.relationships.inventory.PartOf vlan, MANY2MANY)
+      - TO vpn-binding( allotted-resource org.onap.relationships.inventory.BelongsTo vpn-binding, MANY2MANY)
+      - TO service-instance( allotted-resource org.onap.relationships.inventory.BelongsTo service-instance, MANY2ONE)
+      - FROM tunnel-xconnect( tunnel-xconnect org.onap.relationships.inventory.BelongsTo allotted-resource, ONE2ONE)
+      - FROM configuration( configuration org.onap.relationships.inventory.Uses allotted-resource, ONE2ONE)
+      - FROM service-instance( service-instance org.onap.relationships.inventory.Uses allotted-resource, MANY2MANY)
+      - FROM allotted-resource( allotted-resource tosca.relationships.network.BindsTo allotted-resource, ONE2ONE)
+      - ALLOTTED-RESOURCE is DELETED when these are DELETED TUNNEL-XCONNECT
+    required:
+    - id
+    properties:
+      id:
+        type: string
+        description: Allotted Resource id UUID assigned to this instance.
+      description:
+        type: string
+        description: The descriptive information assigned to this allotted resource instance
+      selflink:
+        type: string
+        description: Link back to more information in the controller
+      model-invariant-id:
+        type: string
+        description: the ASDC model id for this resource or service model.
+      model-version-id:
+        type: string
+        description: the ASDC model version for this resource or service model.
+      persona-model-version:
+        type: string
+        description: the ASDC model version for this resource or service model.
+      resource-version:
+        type: string
+        description: Concurrency value
+      orchestration-status:
+        type: string
+        description: Orchestration status
+      operational-status:
+        type: string
+        description: Indicator for whether the resource is considered operational
+      type:
+        type: string
+        description: Generic description of the type of allotted resource.
+      role:
+        type: string
+        description: role in the network that this resource will be providing.
+      tunnel-xconnects:
+        type: array
+        items:
+          $ref: "#/getDefinitions/tunnel-xconnect"
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/getDefinitions/relationship"
+  allotted-resources:
+    description: |
+      This object is used to store slices of services being offered
+    properties:
+      allotted-resource:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/allotted-resource"
+  availability-zone:
+    description: |
+      Availability zone, a collection of compute hosts/pservers
+      ###### Related Nodes
+      - TO complex( availability-zone org.onap.relationships.inventory.LocatedIn complex, MANY2ONE)
+      - TO service-capability( availability-zone org.onap.relationships.inventory.AppliesTo service-capability, MANY2MANY)
+      - TO cloud-region( availability-zone org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE)
+      - FROM ctag-pool( ctag-pool org.onap.relationships.inventory.AppliesTo availability-zone, MANY2MANY)
+      - FROM dvs-switch( dvs-switch org.onap.relationships.inventory.AppliesTo availability-zone, MANY2MANY)
+      - FROM generic-vnf( generic-vnf org.onap.relationships.inventory.Uses availability-zone, MANY2MANY)
+      - FROM pserver( pserver org.onap.relationships.inventory.MemberOf availability-zone, MANY2ONE)
+      - FROM vce( vce org.onap.relationships.inventory.Uses availability-zone, MANY2MANY)
+      - AVAILABILITY-ZONE cannot be deleted if linked to CTAG-POOL,DVS-SWITCH,GENERIC-VNF,PSERVER,VCE
+    required:
+    - availability-zone-name
+    - hypervisor-type
+    properties:
+      availability-zone-name:
+        type: string
+        description: Name of the availability zone.  Unique across a cloud region
+      hypervisor-type:
+        type: string
+        description: Type of hypervisor.  Source of truth should define valid values.
+      operational-status:
+        type: string
+        description: State that indicates whether the availability zone should be used, etc.  Source of truth should define valid values.
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/getDefinitions/relationship"
+  availability-zones:
+    description: |
+      Collection of availability zones
+    properties:
+      availability-zone:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/availability-zone"
+  az-and-dvs-switches:
+    properties:
+      dvs-switches:
+        type: object
+        $ref: "#/getDefinitions/dvs-switches"
+      availability-zone:
+        type: object
+        $ref: "#/getDefinitions/availability-zone"
+  business:
+    description: |
+      Namespace for business related constructs
+    properties:
+      connectors:
+        type: array
+        items:
+          $ref: "#/getDefinitions/connector"
+      customers:
+        type: array
+        items:
+          $ref: "#/getDefinitions/customer"
+      lines-of-business:
+        type: array
+        items:
+          $ref: "#/getDefinitions/line-of-business"
+      owning-entities:
+        type: array
+        items:
+          $ref: "#/getDefinitions/owning-entity"
+      platforms:
+        type: array
+        items:
+          $ref: "#/getDefinitions/platform"
+      projects:
+        type: array
+        items:
+          $ref: "#/getDefinitions/project"
+  class-of-service:
+    description: |
+      ###### Related Nodes
+      - TO site-pair( class-of-service org.onap.relationships.inventory.BelongsTo site-pair, MANY2ONE)
+    required:
+    - cos
+    properties:
+      cos:
+        type: string
+        description: unique identifier of probe
+      probe-id:
+        type: string
+        description: identifier of probe
+      probe-type:
+        type: string
+        description: type of probe
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/getDefinitions/relationship"
+  classes-of-service:
+    description: |
+      class-of-service of probe
+    properties:
+      class-of-service:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/class-of-service"
+  cloud-infrastructure:
+    description: |
+      Namespace for cloud infrastructure.
+    properties:
+      complexes:
+        type: array
+        items:
+          $ref: "#/getDefinitions/complex"
+      cloud-regions:
+        type: array
+        items:
+          $ref: "#/getDefinitions/cloud-region"
+      network-profiles:
+        type: array
+        items:
+          $ref: "#/getDefinitions/network-profile"
+      pservers:
+        type: array
+        items:
+          $ref: "#/getDefinitions/pserver"
+      virtual-data-centers:
+        type: array
+        items:
+          $ref: "#/getDefinitions/virtual-data-center"
+  cloud-region:
+    description: |
+      cloud-region designates an installation of a cloud cluster or region or instantiation.
+      ###### Related Nodes
+      - TO esr-system-info (CHILD of cloud-region, cloud-region has esr-system-info, One2Many)
+      - TO complex( cloud-region org.onap.relationships.inventory.LocatedIn complex, MANY2ONE)
+      - TO l3-network( cloud-region org.onap.relationships.inventory.Uses l3-network, MANY2MANY)
+      - TO zone( cloud-region org.onap.relationships.inventory.LocatedIn zone, MANY2ONE)
+      - FROM availability-zone( availability-zone org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE)
+      - FROM dvs-switch( dvs-switch org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE)
+      - FROM flavor( flavor org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE)
+      - FROM group-assignment( group-assignment org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE)
+      - FROM image( image org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE)
+      - FROM oam-network( oam-network org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE)
+      - FROM snapshot( snapshot org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE)
+      - FROM tenant( tenant org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE)
+      - FROM vip-ipv4-address-list( vip-ipv4-address-list org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE)
+      - FROM vip-ipv6-address-list( vip-ipv6-address-list org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE)
+      - FROM volume-group( volume-group org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE)
+      - FROM logical-link( logical-link org.onap.relationships.inventory.LocatedIn cloud-region, MANY2MANY)
+      - FROM pserver( pserver org.onap.relationships.inventory.LocatedIn cloud-region, MANY2ONE)
+      - CLOUD-REGION cannot be deleted if linked to DVS-SWITCH,FLAVOR,GROUP-ASSIGNMENT,IMAGE,OAM-NETWORK,SNAPSHOT,TENANT,VIP-IPV4-ADDRESS-LIST,VIP-IPV6-ADDRESS-LIST,VOLUME-GROUP
+      - CLOUD-REGION is DELETED when these are DELETED AVAILABILITY-ZONE
+      - CLOUD-REGION deletion means associated objects of these types are also DELETED:ESR-SYSTEM-INFO
+    required:
+    - cloud-owner
+    - cloud-region-id
+    - sriov-automation
+    properties:
+      cloud-owner:
+        type: string
+        description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
+      cloud-region-id:
+        type: string
+        description: Identifier used by the vendor for the region. Second part of composite key
+      cloud-type:
+        type: string
+        description: Type of the cloud (e.g., openstack)
+      owner-defined-type:
+        type: string
+        description: Cloud-owner defined type indicator (e.g., dcp, lcp)
+      cloud-region-version:
+        type: string
+        description: Software version employed at the site.  NOTE - THIS FIELD IS NOT KEPT UP TO DATE.
+      identity-url:
+        type: string
+        description: URL of the keystone identity service
+      cloud-zone:
+        type: string
+        description: Zone where the cloud is homed.  NOTE - THIS FIELD IS NOT CORRECTLY POPULATED.
+      complex-name:
+        type: string
+        description: complex name for cloud-region instance.  NOTE - THIS FIELD IS NOT CORRECTLY POPULATED.
+      sriov-automation:
+        type: boolean
+      cloud-extra-info:
+        type: string
+        description: ESR inputs extra information about the VIM or Cloud which will be decoded by MultiVIM.
+      cloud-epa-caps:
+        type: string
+        description: MultiVIM will discover and expose EPA capabilities.
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      volume-groups:
+        type: array
+        items:
+          $ref: "#/getDefinitions/volume-group"
+      tenants:
+        type: array
+        items:
+          $ref: "#/getDefinitions/tenant"
+      flavors:
+        type: array
+        items:
+          $ref: "#/getDefinitions/flavor"
+      group-assignments:
+        type: array
+        items:
+          $ref: "#/getDefinitions/group-assignment"
+      snapshots:
+        type: array
+        items:
+          $ref: "#/getDefinitions/snapshot"
+      images:
+        type: array
+        items:
+          $ref: "#/getDefinitions/image"
+      dvs-switches:
+        type: array
+        items:
+          $ref: "#/getDefinitions/dvs-switch"
+      oam-networks:
+        type: array
+        items:
+          $ref: "#/getDefinitions/oam-network"
+      availability-zones:
+        type: array
+        items:
+          $ref: "#/getDefinitions/availability-zone"
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/getDefinitions/relationship"
+      esr-system-info-list:
+        type: array
+        items:
+          $ref: "#/getDefinitions/esr-system-info"
+      vip-ipv4-address-list:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/vip-ipv4-address-list"
+      vip-ipv6-address-list:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/vip-ipv6-address-list"
+  cloud-regions:
+    properties:
+      cloud-region:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/cloud-region"
+  complex:
+    description: |
+      Collection of physical locations that can house cloud-regions.
+      ###### Related Nodes
+      - TO l3-network( complex org.onap.relationships.inventory.Uses l3-network, MANY2MANY)
+      - FROM availability-zone( availability-zone org.onap.relationships.inventory.LocatedIn complex, MANY2ONE)
+      - FROM cloud-region( cloud-region org.onap.relationships.inventory.LocatedIn complex, MANY2ONE)
+      - FROM ctag-pool( ctag-pool org.onap.relationships.inventory.BelongsTo complex, MANY2ONE)
+      - FROM generic-vnf( generic-vnf org.onap.relationships.inventory.LocatedIn complex, MANY2MANY)
+      - FROM oam-network( oam-network org.onap.relationships.inventory.AppliesTo complex, MANY2MANY)
+      - FROM pnf( pnf org.onap.relationships.inventory.LocatedIn complex, MANY2ONE)
+      - FROM pserver( pserver org.onap.relationships.inventory.LocatedIn complex, MANY2ONE)
+      - FROM vce( vce org.onap.relationships.inventory.LocatedIn complex, MANY2MANY)
+      - FROM volume-group( volume-group org.onap.relationships.inventory.LocatedIn complex, MANY2ONE)
+      - FROM vpls-pe( vpls-pe org.onap.relationships.inventory.LocatedIn complex, MANY2ONE)
+      - FROM zone( zone org.onap.relationships.inventory.LocatedIn complex, MANY2ONE)
+      - COMPLEX cannot be deleted if linked to AVAILABILITY-ZONE,CLOUD-REGION,GENERIC-VNF,OAM-NETWORK,PNF,PSERVER,VCE,VOLUME-GROUP,VPLS-PE,ZONE
+      - COMPLEX is DELETED when these are DELETED CTAG-POOL
+    required:
+    - physical-location-id
+    - physical-location-type
+    - street1
+    - city
+    - postal-code
+    - country
+    - region
+    properties:
+      physical-location-id:
+        type: string
+        description: Unique identifier for physical location, e.g., CLLI
+      data-center-code:
+        type: string
+        description: Data center code which can be an alternate way to identify a complex
+      complex-name:
+        type: string
+        description: Gamma complex name for LCP instance.
+      identity-url:
+        type: string
+        description: URL of the keystone identity service
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      physical-location-type:
+        type: string
+        description: Type, e.g., central office, data center.
+      street1:
+        type: string
+      street2:
+        type: string
+      city:
+        type: string
+      state:
+        type: string
+      postal-code:
+        type: string
+      country:
+        type: string
+      region:
+        type: string
+      latitude:
+        type: string
+      longitude:
+        type: string
+      elevation:
+        type: string
+      lata:
+        type: string
+      ctag-pools:
+        type: array
+        items:
+          $ref: "#/getDefinitions/ctag-pool"
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/getDefinitions/relationship"
+  complexes:
+    description: |
+      Collection of physical locations that can house cloud-regions.
+    properties:
+      complex:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/complex"
+  configuration:
+    description: |
+      Port Mirror Configuration.
+      ###### Related Nodes
+      - TO allotted-resource( configuration org.onap.relationships.inventory.Uses allotted-resource, ONE2ONE)
+      - TO logical-link( configuration org.onap.relationships.inventory.Uses logical-link, ONE2MANY)
+      - FROM metadatum( metadatum org.onap.relationships.inventory.BelongsTo configuration, MANY2ONE)
+      - FROM generic-vnf( generic-vnf org.onap.relationships.inventory.Uses configuration, ONE2MANY)
+      - FROM service-instance( service-instance org.onap.relationships.inventory.Uses configuration, ONE2MANY)
+      - CONFIGURATION is DELETED when these are DELETED METADATUM
+      - CONFIGURATION deletion means associated objects of these types are also DELETED:ALLOTTED-RESOURCE,LOGICAL-LINK
+    required:
+    - configuration-id
+    - configuration-type
+    - configuration-sub-type
+    - orchestration-status
+    - operational-status
+    - configuration-selflink
+    - model-customization-id
+    properties:
+      configuration-id:
+        type: string
+        description: UUID assigned to configuration.
+      management-option:
+        type: string
+        description: Indicates the entity that will manage this feature. Could be an organization or the name of the application as well.
+      configuration-name:
+        type: string
+        description: Name of the configuration.
+      configuration-type:
+        type: string
+        description: port-mirroring-configuration.
+      configuration-sub-type:
+        type: string
+        description: vprobe, pprobe.
+      model-invariant-id:
+        type: string
+        description: the ASDC model id for this resource or service model.
+      model-version-id:
+        type: string
+        description: the ASDC model version for this resource or service model.
+      orchestration-status:
+        type: string
+        description: Orchestration status of the configuration.
+      operational-status:
+        type: string
+        description: Indicator for whether the resource is considered operational.
+      configuration-selflink:
+        type: string
+        description: URL to endpoint where AAI can get more details from SDN-GC.
+      model-customization-id:
+        type: string
+        description: id of  the configuration used to customize the resource
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/getDefinitions/relationship"
+      metadata:
+        type: array
+        items:
+          $ref: "#/getDefinitions/metadatum"
+  configurations:
+    description: |
+      Collection of configurations
+    properties:
+      configuration:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/configuration"
+  connector:
+    description: |
+      Collection of resource instances used to connect a variety of disparate inventory widgets
+      ###### Related Nodes
+      - TO virtual-data-center( connector org.onap.relationships.inventory.LocatedIn virtual-data-center, MANY2MANY)
+      - FROM metadatum( metadatum org.onap.relationships.inventory.BelongsTo connector, MANY2ONE)
+      - FROM service-instance( service-instance org.onap.relationships.inventory.Uses connector, MANY2MANY)
+      - CONNECTOR is DELETED when these are DELETED METADATUM
+    required:
+    - resource-instance-id
+    properties:
+      resource-instance-id:
+        type: string
+        description: Unique id of resource instance.
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      model-invariant-id:
+        type: string
+        description: the ASDC model id for this resource or service model.
+      model-version-id:
+        type: string
+        description: the ASDC model version for this resource or service model.
+      persona-model-version:
+        type: string
+        description: the ASDC model version for this resource or service model.
+      widget-model-id:
+        type: string
+        description: the ASDC data dictionary widget model. This maps directly to the A&AI widget.
+      widget-model-version:
+        type: string
+        description: the ASDC data dictionary version of the widget model.This maps directly to the A&AI version of the widget.
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/getDefinitions/relationship"
+      metadata:
+        type: array
+        items:
+          $ref: "#/getDefinitions/metadatum"
+  connectors:
+    description: |
+      Collection of resource instances used to connect a variety of disparate inventory widgets
+    properties:
+      connector:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/connector"
+  constrained-element-set:
+    description: |
+      This is how we would capture constraints defining allowed sets of elements.
+      ###### Related Nodes
+      - TO model-constraint( constrained-element-set org.onap.relationships.inventory.BelongsTo model-constraint, MANY2ONE)
+      - TO model-element( constrained-element-set org.onap.relationships.inventory.BelongsTo model-element, MANY2ONE)
+      - FROM element-choice-set( element-choice-set org.onap.relationships.inventory.BelongsTo constrained-element-set, MANY2ONE)
+      - CONSTRAINED-ELEMENT-SET is DELETED when these are DELETED ELEMENT-CHOICE-SET
+    required:
+    - constrained-element-set-uuid
+    - constraint-type
+    - check-type
+    properties:
+      constrained-element-set-uuid:
+        type: string
+      constraint-type:
+        type: string
+      check-type:
+        type: string
+      resource-version:
+        type: string
+      element-choice-sets:
+        type: array
+        items:
+          $ref: "#/getDefinitions/element-choice-set"
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/getDefinitions/relationship"
+  constrained-element-sets:
+    properties:
+      constrained-element-set:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/constrained-element-set"
+  ctag-assignment:
+    description: |
+      ###### Related Nodes
+      - TO l3-network( ctag-assignment org.onap.relationships.inventory.BelongsTo l3-network, MANY2ONE)
+      - FROM service-instance( service-instance org.onap.relationships.inventory.Uses ctag-assignment, ONE2MANY)
+    required:
+    - vlan-id-inner
+    properties:
+      vlan-id-inner:
+        type: integer
+        format: int64
+        description: id.
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/getDefinitions/relationship"
+  ctag-assignments:
+    properties:
+      ctag-assignment:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/ctag-assignment"
+  ctag-pool:
+    description: |
+      A collection of C tags (vlan tags) grouped for a specific purpose.
+      ###### Related Nodes
+      - TO complex( ctag-pool org.onap.relationships.inventory.BelongsTo complex, MANY2ONE)
+      - TO availability-zone( ctag-pool org.onap.relationships.inventory.AppliesTo availability-zone, MANY2MANY)
+      - FROM generic-vnf( generic-vnf org.onap.relationships.inventory.Uses ctag-pool, MANY2MANY)
+      - FROM vpls-pe( vpls-pe org.onap.relationships.inventory.Uses ctag-pool, MANY2MANY)
+    required:
+    - target-pe
+    - availability-zone-name
+    - ctag-pool-purpose
+    properties:
+      target-pe:
+        type: string
+        description: The Target provider edge router
+      availability-zone-name:
+        type: string
+        description: Name of the availability zone
+      ctag-pool-purpose:
+        type: string
+        description: Describes what the intended purpose of this pool is.
+      ctag-values:
+        type: string
+        description: Comma separated list of ctags
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/getDefinitions/relationship"
+  ctag-pools:
+    properties:
+      ctag-pool:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/ctag-pool"
+  customer:
+    description: |
+      customer identifiers to provide linkage back to BSS information.
+      ###### Related Nodes
+      - FROM service-subscription( service-subscription org.onap.relationships.inventory.BelongsTo customer, MANY2ONE)
+      - CUSTOMER is DELETED when these are DELETED SERVICE-SUBSCRIPTION
+    required:
+    - global-customer-id
+    - subscriber-name
+    - subscriber-type
+    properties:
+      global-customer-id:
+        type: string
+        description: Global customer id used across ECOMP to uniquely identify customer.
+      subscriber-name:
+        type: string
+        description: Subscriber name, an alternate way to retrieve a customer.
+      subscriber-type:
+        type: string
+        description: Subscriber type, a way to provide VID with only the INFRA customers.
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      service-subscriptions:
+        type: array
+        items:
+          $ref: "#/getDefinitions/service-subscription"
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/getDefinitions/relationship"
+  customers:
+    description: |
+      Collection of customer identifiers to provide linkage back to BSS information.
+    properties:
+      customer:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/customer"
+  cvlan-tag-entry:
+    required:
+    - cvlan-tag
+    properties:
+      cvlan-tag:
+        type: integer
+        format: int64
+        description: See mis-na-virtualization-platform.yang
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/getDefinitions/relationship"
+  cvlan-tags:
+    properties:
+      cvlan-tag-entry:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/cvlan-tag-entry"
+  dvs-switch:
+    description: |
+      Digital virtual switch metadata, used by SDN-C to configure VCEs.  A&AI needs to receive this data from the PO deployment team and administer it using the provisioningTool.sh into A&AI. 
+      ###### Related Nodes
+      - TO cloud-region( dvs-switch org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE)
+      - TO availability-zone( dvs-switch org.onap.relationships.inventory.AppliesTo availability-zone, MANY2MANY)
+    required:
+    - switch-name
+    - vcenter-url
+    properties:
+      switch-name:
+        type: string
+        description: DVS switch name
+      vcenter-url:
+        type: string
+        description: URL used to reach the vcenter
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/getDefinitions/relationship"
+  dvs-switches:
+    description: |
+      Collection of digital virtual switch metadata used for vmWare VCEs and GenericVnfs.
+    properties:
+      dvs-switch:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/dvs-switch"
+  edge-prop-names:
+    description: |
+      Internal map to define the properties of an edge and interpret the map EdgeRules
+    properties:
+      edgeLabel:
+        type: string
+      direction:
+        type: string
+      multiplicityRule:
+        type: string
+      contains-other-v:
+        type: string
+      delete-other-v:
+        type: string
+      SVC-INFRA:
+        type: string
+      prevent-delete:
+        type: string
+  edge-tag-query-request:
+    properties:
+      edge-tag:
+        type: string
+      result-detail:
+        type: string
+      start-node-type:
+        type: string
+      start-node-filter:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/start-node-filter"
+      include-node-filter:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/include-node-filter"
+      secondary-filter:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/secondary-filter"
+  edge-tag-query-result:
+    properties:
+      tagged-inventory-item-list:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/tagged-inventory-item-list"
+  element-choice-set:
+    description: |
+      This is how we would capture constraints defining allowed sets of elements.
+      ###### Related Nodes
+      - TO constrained-element-set( element-choice-set org.onap.relationships.inventory.BelongsTo constrained-element-set, MANY2ONE)
+      - FROM model-element( model-element org.onap.relationships.inventory.BelongsTo element-choice-set, MANY2ONE)
+      - ELEMENT-CHOICE-SET is DELETED when these are DELETED MODEL-ELEMENT
+    required:
+    - element-choice-set-uuid
+    - element-choice-set-name
+    properties:
+      element-choice-set-uuid:
+        type: string
+      element-choice-set-name:
+        type: string
+      cardinality:
+        type: string
+      resource-version:
+        type: string
+      model-elements:
+        type: array
+        items:
+          $ref: "#/getDefinitions/model-element"
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/getDefinitions/relationship"
+  element-choice-sets:
+    properties:
+      element-choice-set:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/element-choice-set"
+  entitlement:
+    description: |
+      Metadata for entitlement group.
+      ###### Related Nodes
+      - TO generic-vnf( entitlement org.onap.relationships.inventory.BelongsTo generic-vnf, MANY2ONE)
+      - TO vce( entitlement org.onap.relationships.inventory.BelongsTo vce, MANY2ONE)
+    required:
+    - group-uuid
+    - resource-uuid
+    properties:
+      group-uuid:
+        type: string
+        description: Unique ID for the entitlement group the resource comes from, should be uuid.
+      resource-uuid:
+        type: string
+        description: Unique ID of an entitlement resource. 
+      resource-version:
+        type: string
+        description: Concurrency value
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/getDefinitions/relationship"
+  entitlements:
+    description: |
+      Entitlements, keyed by group-uuid and resource-uuid, related to license management
+    properties:
+      entitlement:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/entitlement"
+  esr-ems:
+    description: |
+      Persist EMS address information used by EMS driver.
+      ###### Related Nodes
+      - TO esr-system-info (CHILD of esr-ems, esr-ems has esr-system-info, One2Many)
+      - ESR-EMS deletion means associated objects of these types are also DELETED:ESR-SYSTEM-INFO
+    required:
+    - ems-id
+    properties:
+      ems-id:
+        type: string
+        description: Unique ID of EMS.
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      esr-system-info-list:
+        type: object
+        $ref: "#/getDefinitions/esr-system-info-list"
+      relationship-list:
+        type: object
+        $ref: "#/getDefinitions/relationship-list"
+  esr-ems-list:
     properties:
-      physical-location-id:
+      esr-ems:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/esr-ems"
+  esr-system-info:
+    description: |
+      Persist common address information of external systems.
+      ###### Related Nodes
+      - FROM esr-ems (PARENT of esr-system-info, esr-ems has esr-system-info)
+      - FROM esr-vnfm (PARENT of esr-system-info, esr-vnfm has esr-system-info)
+      - FROM esr-thirdparty-sdnc (PARENT of esr-system-info, esr-thirdparty-sdnc has esr-system-info)
+      - FROM cloud-region (PARENT of esr-system-info, cloud-region has esr-system-info)
+    required:
+    - esr-system-info-id
+    - user-name
+    - password
+    - system-type
+    properties:
+      esr-system-info-id:
         type: string
-        description: Unique identifier for physical location, e.g., CLLI
-      data-center-code:
+        description: Unique ID of esr system info.
+      system-name:
         type: string
-        description: Data center code which can be an alternate way to identify a complex
-      complex-name:
+        description: name of external system.
+      type:
         type: string
-        description: Gamma complex name for LCP instance.
-      identity-url:
+        description: type of external systems.
+      vendor:
         type: string
-        description: URL of the keystone identity service
-      resource-version:
+        description: vendor of external systems.
+      version:
         type: string
-        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
-      physical-location-type:
+        description: version of external systems.
+      service-url:
         type: string
-        description: Type, e.g., central office, data center.
-      street1:
+        description: url used to access external systems.
+      user-name:
         type: string
-      street2:
+        description: username used to access external systems.
+      password:
         type: string
-      city:
+        description: password used to access external systems.
+      system-type:
         type: string
-      state:
+        description: it could be vim/vnfm/thirdparty-sdnc/ems-resource/ems-performance/ems-alarm.
+      protocol:
         type: string
-      postal-code:
+        description: protocol of third party SDNC, for example netconf/snmp.
+      ssl-cacert:
         type: string
-      country:
+        description: ca file content if enabled ssl on auth-url.
+      ssl-insecure:
+        type: boolean
+        description: Whether to verify VIM's certificate.
+      ip-address:
         type: string
-      region:
+        description: service IP of ftp server.
+      port:
         type: string
-      latitude:
+        description: service port of ftp server.
+      cloud-domain:
         type: string
-      longitude:
+        description: domain info for authentication.
+      default-tenant:
         type: string
-      elevation:
+        description: default tenant of VIM.
+      passive:
+        type: boolean
+        description: ftp passive mode or not.
+      remote-path:
         type: string
-      lata:
+        description: resource or performance data file path.
+      system-status:
         type: string
-      ctag-pools:
-        type: array
-        items:
-          $ref: "#/definitions/ctag-pool"
+        description: the status of external system.
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
       relationship-list:
         type: array
         items:
-          $ref: "#/definitions/relationship"
-  complexes:
+          $ref: "#/getDefinitions/relationship"
+  esr-system-info-list:
     description: |
-      Collection of physical locations that can house cloud-regions.
+      Collection of persistent block-level external system auth info.
     properties:
-      complex:
+      esr-system-info:
         type: array
         items:          
-          $ref: "#/definitions/complex"
-  volume-group:
+          $ref: "#/getDefinitions/esr-system-info"
+  esr-thirdparty-sdnc:
     description: |
-      Persistent block-level storage.
-      ###### Default Delete Scope
-      THIS_NODE_ONLY
+      Persist SDNC address information used by ONAP SDNC.
       ###### Related Nodes
-      - TO complex (Many2Many)
-      - TO tenant (Many2Many)
-      - FROM cloud-region (is composed of volume-group)
-      - FROM vf-module
-      - FROM generic-vnf
+      - TO esr-system-info (CHILD of esr-thirdparty-sdnc, esr-thirdparty-sdnc has esr-system-info, One2One)
+      - TO pnf( esr-thirdparty-sdnc has pnf, One2Many)
+      - ESR-THIRDPARTY-SDNC deletion means associated objects of these types are also DELETED:ESR-SYSTEM-INFO
     required:
-    - volume-group-id
-    - volume-group-name
-    - vnf-type
+    - thirdparty-sdnc-id
     properties:
-      volume-group-id:
-        type: string
-        description: Unique ID of volume-group.
-      volume-group-name:
-        type: string
-        description: Name of the volume group.
-      heat-stack-id:
-        type: string
-        description: Heat stack id corresponding to this volume-group
-      vnf-type:
+      thirdparty-sdnc-id:
         type: string
-        description: String capturing type of vnf, that was intended to identify the ASDC resource.  This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures.
-      orchestration-status:
-        type: string
-        description: Orchestration status of this volume-group
-      model-customization-id:
+        description: Unique ID of SDNC.
+      location:
         type: string
-        description: captures the id of all the configuration used to customize the resource for the service.
-      vf-module-model-customization-id:
+        description: used for DC type to indicate the location of SDNC, such as Core or Edge.
+      product-name:
         type: string
-        description: helps relate the volume group to the vf-module whose components will require the volume group
+        description: password used to access SDNC server.
       resource-version:
         type: string
         description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      esr-system-info-list:
+        type: object
+        $ref: "#/getDefinitions/esr-system-info-list"
       relationship-list:
-        type: array
-        items:
-          $ref: "#/definitions/relationship"
-  volume-groups:
-    description: |
-      Collection of persistent block-level storage.
+        type: object
+        $ref: "#/getDefinitions/relationship-list"
+  esr-thirdparty-sdnc-list:
     properties:
-      volume-group:
+      esr-thirdparty-sdnc:
         type: array
         items:          
-          $ref: "#/definitions/volume-group"
-  volume:
+          $ref: "#/getDefinitions/esr-thirdparty-sdnc"
+  esr-vnfm:
     description: |
-      Ephemeral Block storage volume.
-      ###### Default Delete Scope
-      THIS_NODE_ONLY
+      Persist VNFM address information used by VF-C.
       ###### Related Nodes
-      - FROM vserver (is composed of volume)
+      - TO esr-system-info (CHILD of esr-vnfm, esr-vnfm has esr-system-info, One2One)
+      - ESR-VNFM deletion means associated objects of these types are also DELETED:ESR-SYSTEM-INFO
     required:
-    - volume-id
-    - volume-selflink
+    - vnfm-id
     properties:
-      volume-id:
+      vnfm-id:
         type: string
-        description: Unique ID of block storage volume relative to the vserver.
-      volume-selflink:
+        description: Unique ID of VNFM.
+      vim-id:
         type: string
-        description: URL to endpoint where AAI can get more details
+        description: indecate the VIM to deploy VNF.
+      certificate-url:
+        type: string
+        description: certificate url of VNFM.
       resource-version:
         type: string
         description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      esr-system-info-list:
+        type: object
+        $ref: "#/getDefinitions/esr-system-info-list"
       relationship-list:
-        type: array
-        items:
-          $ref: "#/definitions/relationship"
-  volumes:
-    description: |
-      Collection of ephemeral Block storage volumes.
+        type: object
+        $ref: "#/getDefinitions/relationship-list"
+  esr-vnfm-list:
     properties:
-      volume:
+      esr-vnfm:
         type: array
         items:          
-          $ref: "#/definitions/volume"
-  l3-interface-ipv4-address-list:
+          $ref: "#/getDefinitions/esr-vnfm"
+  evc:
     description: |
-      IPv4 Address Range
-      ###### Default Delete Scope
-      THIS_NODE_ONLY
+      evc object is an optional child object of the Configuration object.
       ###### Related Nodes
-      - TO instance-group (Many2Many)
-      - TO l3-network (Many2Many)
-      - TO subnet (Many2Many)
-      - FROM l-interface (is composed of l3-interface-ipv4-address-list)
-      - FROM vlan (is composed of l3-interface-ipv4-address-list)
+      - TO configuration( evc org.onap.relationships.inventory.BelongsTo configuration, ONE2ONE)
     required:
-    - l3-interface-ipv4-address
+    - evc-id
     properties:
-      l3-interface-ipv4-address:
+      evc-id:
         type: string
-        description: IP address
-      l3-interface-ipv4-prefix-length:
-        type: integer
-        format: int64
-        description: Prefix length, 32 for single address
-      vlan-id-inner:
-        type: integer
-        format: int64
-        description: Inner VLAN tag
-      vlan-id-outer:
-        type: integer
-        format: int64
-        description: Outer VLAN tag
-      is-floating:
-        type: boolean
-        description: Indicator of fixed or floating address
-      resource-version:
+        description: Unique/key field for the evc object
+      forwarding-path-topology:
         type: string
-        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
-      neutron-network-id:
+        description: Point-to-Point, Multi-Point
+      cir-value:
         type: string
-        description: Neutron network id of the interface that address belongs to
-      neutron-subnet-id:
+        description: Commited Information Rate
+      cir-units:
         type: string
-        description: Neutron id of subnet that address belongs to
+        description: CIR units
+      connection-diversity-group-id:
+        type: string
+        description: Diversity Group ID
+      service-hours:
+        type: string
+        description: formerly Performance Group
+      esp-evc-circuit-id:
+        type: string
+        description: EVC Circuit ID of ESP EVC
+      esp-evc-cir-value:
+        type: string
+        description: Committed Information Rate (For ESP)
+      esp-evc-cir-units:
+        type: string
+        description: CIR units (For ESP)
+      esp-itu-code:
+        type: string
+        description: Identifies ESP
+      collector-pop-clli:
+        type: string
+        description: Collector POP CLLI (from the hostname of the access pnf)
+      inter-connect-type-ingress:
+        type: string
+        description: Interconnect type on ingress side of EVC.
+      tagmode-access-ingress:
+        type: string
+        description: tagode for collector side of EVC
+      tagmode-access-egress:
+        type: string
+        description: tagMode for network side of EVC
       relationship-list:
         type: array
         items:
-          $ref: "#/definitions/relationship"
-  l3-interface-ipv6-address-list:
+          $ref: "#/getDefinitions/relationship"
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency. Must be empty on create, valid on update and delete.
+  evcs:
+    properties:
+      evc:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/evc"
+  external-system:
     description: |
-      IPv6 Address Range
-      ###### Default Delete Scope
-      THIS_NODE_ONLY
+      Namespace for external system.
+    properties:
+      esr-ems-list:
+        type: object
+        $ref: "#/getDefinitions/esr-ems-list"
+      esr-vnfm-list:
+        type: object
+        $ref: "#/getDefinitions/esr-vnfm-list"
+      esr-thirdparty-sdnc-list:
+        type: object
+        $ref: "#/getDefinitions/esr-thirdparty-sdnc-list"
+  extra-properties:
+    description: |
+      Extra properties for inventory item for response list
+    properties:
+      extra-property:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/extra-property"
+  extra-property:
+    properties:
+      property-name:
+        type: string
+      property-value:
+        type: string
+  flavor:
+    description: |
+      Openstack flavor.
       ###### Related Nodes
-      - TO instance-group (Many2Many)
-      - TO l3-network (Many2Many)
-      - TO subnet (Many2Many)
-      - FROM l-interface (is composed of l3-interface-ipv6-address-list)
-      - FROM vlan (is composed of l3-interface-ipv6-address-list)
+      - TO cloud-region( flavor org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE)
+      - FROM vserver( vserver org.onap.relationships.inventory.Uses flavor, MANY2ONE)
+      - FLAVOR cannot be deleted if linked to VSERVER
     required:
-    - l3-interface-ipv6-address
+    - flavor-id
+    - flavor-name
+    - flavor-selflink
     properties:
-      l3-interface-ipv6-address:
+      flavor-id:
         type: string
-        description: IP address
-      l3-interface-ipv6-prefix-length:
+        description: Flavor id, expected to be unique across cloud-region.
+      flavor-name:
+        type: string
+        description: Flavor name
+      flavor-vcpus:
         type: integer
-        format: int64
-        description: Prefix length, 128 for single address
-      vlan-id-inner:
+        format: int32
+        description: Number of CPUs
+      flavor-ram:
         type: integer
-        format: int64
-        description: Inner VLAN tag
-      vlan-id-outer:
+        format: int32
+        description: Amount of memory
+      flavor-disk:
         type: integer
-        format: int64
-        description: Outer VLAN tag
-      is-floating:
+        format: int32
+        description: Disk space
+      flavor-ephemeral:
+        type: integer
+        format: int32
+        description: Amount of ephemeral disk space
+      flavor-swap:
+        type: string
+        description: amount of swap space allocation
+      flavor-is-public:
         type: boolean
-        description: Indicator of fixed or floating address
+        description: whether flavor is available to all users or private to the tenant it was created in.
+      flavor-selflink:
+        type: string
+        description: URL to endpoint where AAI can get more details
+      flavor-disabled:
+        type: boolean
+        description: Boolean as to whether this flavor is no longer enabled
       resource-version:
         type: string
         description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
-      neutron-network-id:
-        type: string
-        description: Neutron network id of the interface that address belongs to
-      neutron-subnet-id:
-        type: string
-        description: Neutron id of subnet that address belongs to
       relationship-list:
         type: array
         items:
-          $ref: "#/definitions/relationship"
-  vlan:
+          $ref: "#/getDefinitions/relationship"
+  flavors:
     description: |
-      Definition of vlan
-      ###### Default Delete Scope
-      CASCADE_TO_CHILDREN
+      Collection of openstack flavors.
+    properties:
+      flavor:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/flavor"
+  forwarder:
+    description: |
+      Entity describing a sequenced segment of forwarding path
       ###### Related Nodes
-      - TO l3-interface-ipv4-address-list (comprises vlan, Many2Many)
-      - TO l3-interface-ipv6-address-list (comprises vlan, Many2Many)
-      - TO multicast-configuration (Many2Many)
-      - TO logical-link (Many2Many)
-      - FROM l-interface (is composed of vlan)
-      - FROM service-instance
-      - FROM allotted-resource
+      - TO forwarding-path( forwarder org.onap.relationships.inventory.BelongsTo forwarding-path, MANY2ONE)
+      - TO l-interface( forwarder org.onap.relationships.inventory.ForwardsTo l-interface, MANY2ONE)
+      - TO configuration( forwarder org.onap.relationships.inventory.Uses configuration, ONE2ONE)
+      - TO lag-interface( forwarder org.onap.relationships.inventory.ForwardsTo lag-interface, MANY2ONE)
+      - TO p-interface( forwarder org.onap.relationships.inventory.ForwardsTo p-interface, MANY2ONE)
+      - FORWARDER deletion means associated objects of these types are also DELETED:CONFIGURATION
     required:
-    - vlan-interface
-    - in-maint
-    - is-ip-unnumbered
+    - sequence
     properties:
-      vlan-interface:
-        type: string
-        description: String that identifies the interface
-      vlan-id-inner:
-        type: integer
-        format: int64
-        description: Inner VLAN tag
-      vlan-id-outer:
+      sequence:
         type: integer
-        format: int64
-        description: Outer VLAN tag
-      resource-version:
-        type: string
-        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
-      speed-value:
+        format: int32
+        description: Unique ID of this segmentation
+      forwarder-role:
         type: string
-        description: Captures the numeric part of the speed
-      speed-units:
+        description: ingress, intermediate, egress
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/getDefinitions/relationship"
+      resource-version:
         type: string
-        description: Captures the units corresponding to the speed
-      vlan-description:
+        description: Used for optimistic concurrency. Must be empty on create, valid on update and delete.
+  forwarder-evc:
+    description: |
+      forwarder object is an optional child object of the Configuration object.
+      ###### Related Nodes
+      - TO configuration( forwarder-evc org.onap.relationships.inventory.BelongsTo configuration, ONE2ONE)
+    required:
+    - forwarder-evc-id
+    properties:
+      forwarder-evc-id:
         type: string
-        description: Used to describe (the service associated with) the vlan
-      backdoor-connection:
+        description: Key for forwarder-evc object
+      circuit-id:
         type: string
-        description: Whether customer is going to use this VLAN for backdoor connection to another customer premise device.
-      vpn-key:
+        description: Circuit ID from customer/ESP/ingress end of EVC, or reference to beater circuit on gateway/network/egress end of EVC
+      ivlan:
         type: string
-        description: This indicates the customers VPN ID associated with this vlan
-      orchestration-status:
+        description: Internal VLAN.
+      svlan:
         type: string
-        description: Status of a vnf's vlan interface, on which the customer circuit resides, mastered by SDN-C.
-      in-maint:
-        type: boolean
-      prov-status:
+        description: SVLAN value for ingress of egress forwarder.
+      cvlan:
         type: string
-        description: Prov Status of the VLAN configuration related to a logical interface. Valid values [PREPROV/NVTPROV/PROV].
-      is-ip-unnumbered:
-        type: boolean
+        description: CVLAN value for ingress of egress forwarder.
       relationship-list:
         type: array
         items:
-          $ref: "#/definitions/relationship"
-      l3-interface-ipv4-address-list:
-        type: array
-        items:          
-          $ref: "#/definitions/l3-interface-ipv4-address-list"
-      l3-interface-ipv6-address-list:
+          $ref: "#/getDefinitions/relationship"
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency. Must be empty on create, valid on update and delete.
+  forwarder-evcs:
+    properties:
+      forwarder-evc:
         type: array
         items:          
-          $ref: "#/definitions/l3-interface-ipv6-address-list"
-  vlans:
+          $ref: "#/getDefinitions/forwarder-evc"
+  forwarders:
     properties:
-      vlan:
+      forwarder:
         type: array
         items:          
-          $ref: "#/definitions/vlan"
-  sriov-vf:
+          $ref: "#/getDefinitions/forwarder"
+  forwarding-path:
     description: |
-      SR-IOV Virtual Function (not to be confused with virtual network function)
-      ###### Default Delete Scope
-      THIS_NODE_ONLY
+      Entity that describes the sequenced forwarding path between interfaces of services or resources
       ###### Related Nodes
-      - TO sriov-pf (Many2One)
-      - FROM l-interface (is composed of sriov-vf)
+      - TO service-instance( forwarding-path org.onap.relationships.inventory.AppliesTo service-instance, MANY2ONE)
+      - TO configuration( forwarding-path org.onap.relationships.inventory.Uses configuration, ONE2ONE)
+      - FROM forwarder( forwarder org.onap.relationships.inventory.BelongsTo forwarding-path, MANY2ONE)
+      - FORWARDING-PATH is DELETED when these are DELETED FORWARDER
+      - FORWARDING-PATH deletion means associated objects of these types are also DELETED:CONFIGURATION
     required:
-    - pci-id
+    - forwarding-path-id
+    - forwarding-path-name
     properties:
-      pci-id:
-        type: string
-        description: PCI ID used to identify the sriov-vf
-      vf-vlan-filter:
-        type: string
-        description: This metadata provides option to specify list of VLAN filters applied on VF to pass the traffic to VM.
-      vf-mac-filter:
-        type: string
-        description: When MAC filters are specified, VF-agent service configures VFs to do MAC level filtering before the traffic is passed to VM.
-      vf-vlan-strip:
-        type: boolean
-        description: When this field is set to true, VF will configured to strip the outer TAG before the traffic is passed to VM.
-      vf-vlan-anti-spoof-check:
-        type: boolean
-        description: This option ensures anti VLAN spoof checks are done at the VF level to comply with security. The disable check will also be honored per the VNF needs for trusted VMs.
-      vf-mac-anti-spoof-check:
-        type: boolean
-        description: This option ensures anti MAC spoof checks are done at the VF level to comply with security. The disable check will also be honored per the VNF needs for trusted VMs.
-      vf-mirrors:
+      forwarding-path-id:
         type: string
-        description: This option defines the set of Mirror objects which essentially mirrors the traffic from source to set of collector VNF Ports.
-      vf-broadcast-allow:
-        type: boolean
-        description: This option, if set to true, sets the VF in promiscuous mode and allows all broadcast traffic to reach the VM
-      vf-unknown-multicast-allow:
-        type: boolean
-        description: This option, if set to true, sets the VF in promiscuous mode and allows unknown multicast traffic to reach the VM
-      vf-unknown-unicast-allow:
-        type: boolean
-        description: This option, if set to true, sets the VF in promiscuous mode and allows unknown unicast traffic to reach the VM
-      vf-insert-stag:
-        type: boolean
-        description: This option, if set to true, instructs to insert outer tag after traffic comes out of VM.
-      vf-link-status:
+        description: Unique ID of this FP
+      forwarding-path-name:
         type: string
-        description: This option is used to set the link status.  Valid values as of 1607 are on, off, and auto.
+        description: Name of the FP
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/getDefinitions/relationship"
       resource-version:
         type: string
-        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
-      neutron-network-id:
+        description: Used for optimistic concurrency. Must be empty on create, valid on update and delete.
+      selflink:
         type: string
-        description: Neutron network id of the interface
-      relationship-list:
+        description: the self link for this FP
+      forwarders:
         type: array
         items:
-          $ref: "#/definitions/relationship"
-  sriov-vfs:
-    description: |
-      Collection of SR-IOV Virtual Functions.
+          $ref: "#/getDefinitions/forwarder"
+  forwarding-paths:
     properties:
-      sriov-vf:
+      forwarding-path:
         type: array
         items:          
-          $ref: "#/definitions/sriov-vf"
-  l-interface:
+          $ref: "#/getDefinitions/forwarding-path"
+  generic-vnf:
     description: |
-      Logical interfaces, e.g., a vnic.
-      ###### Default Delete Scope
-      CASCADE_TO_CHILDREN
-      ###### Related Nodes
-      - TO instance-group (Many2Many)
-      - TO l3-interface-ipv4-address-list (comprises l-interface, Many2Many)
-      - TO l3-interface-ipv6-address-list (comprises l-interface, Many2Many)
-      - TO l-interface (comprises l-interface, One2Many)
-      - TO logical-link (Many2Many)
-      - TO vlan (comprises l-interface, Many2Many)
-      - TO sriov-vf (comprises l-interface, One2One)
-      - FROM generic-vnf (is composed of l-interface)
-      - FROM lag-interface (is composed of l-interface)
-      - FROM newvce (is composed of l-interface)
-      - FROM p-interface (is composed of l-interface)
-      - FROM vserver (is composed of l-interface)
-      - FROM allotted-resource
-      - FROM l-interface (is composed of l-interface)
+      General purpose VNF
+      ###### Related Nodes
+      - TO availability-zone( generic-vnf org.onap.relationships.inventory.Uses availability-zone, MANY2MANY)
+      - TO complex( generic-vnf org.onap.relationships.inventory.LocatedIn complex, MANY2MANY)
+      - TO configuration( generic-vnf org.onap.relationships.inventory.Uses configuration, ONE2MANY)
+      - TO ctag-pool( generic-vnf org.onap.relationships.inventory.Uses ctag-pool, MANY2MANY)
+      - TO instance-group( generic-vnf org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY)
+      - TO ipsec-configuration( generic-vnf org.onap.relationships.inventory.Uses ipsec-configuration, MANY2ONE)
+      - TO l3-network( generic-vnf org.onap.relationships.inventory.Uses l3-network, MANY2MANY)
+      - TO license-key-resource( generic-vnf org.onap.relationships.inventory.Uses license-key-resource, MANY2MANY)
+      - TO pnf( generic-vnf tosca.relationships.HostedOn pnf, MANY2MANY)
+      - TO pserver( generic-vnf tosca.relationships.HostedOn pserver, MANY2MANY)
+      - TO vnf-image( generic-vnf org.onap.relationships.inventory.Uses vnf-image, MANY2ONE)
+      - TO volume-group( generic-vnf org.onap.relationships.inventory.DependsOn volume-group, ONE2MANY)
+      - TO vserver( generic-vnf tosca.relationships.HostedOn vserver, ONE2MANY)
+      - TO virtual-data-center( generic-vnf org.onap.relationships.inventory.LocatedIn virtual-data-center, MANY2MANY)
+      - FROM allotted-resource( allotted-resource org.onap.relationships.inventory.PartOf generic-vnf, MANY2MANY)
+      - FROM entitlement( entitlement org.onap.relationships.inventory.BelongsTo generic-vnf, MANY2ONE)
+      - FROM vnfc( vnfc org.onap.relationships.inventory.BelongsTo generic-vnf, MANY2ONE)
+      - FROM lag-interface( lag-interface org.onap.relationships.inventory.BelongsTo generic-vnf, MANY2ONE)
+      - FROM license( license org.onap.relationships.inventory.BelongsTo generic-vnf, MANY2ONE)
+      - FROM l-interface( l-interface org.onap.relationships.inventory.BelongsTo generic-vnf, MANY2ONE)
+      - FROM network-profile( network-profile org.onap.relationships.inventory.AppliesTo generic-vnf, MANY2MANY)
+      - FROM service-instance( service-instance org.onap.relationships.inventory.ComposedOf generic-vnf, ONE2MANY)
+      - FROM site-pair-set( site-pair-set org.onap.relationships.inventory.AppliesTo generic-vnf, MANY2MANY)
+      - FROM vf-module( vf-module org.onap.relationships.inventory.BelongsTo generic-vnf, MANY2ONE)
+      - FROM line-of-business( line-of-business org.onap.relationships.inventory.Uses generic-vnf, MANY2MANY)
+      - FROM logical-link( logical-link org.onap.relationships.inventory.BridgedTo generic-vnf, MANY2MANY)
+      - FROM platform( platform org.onap.relationships.inventory.Uses generic-vnf, MANY2MANY)
+      - GENERIC-VNF is DELETED when these are DELETED ENTITLEMENT,VNFC,LAG-INTERFACE,LICENSE,L-INTERFACE,VF-MODULE
+      - GENERIC-VNF deletion means associated objects of these types are also DELETED:CONFIGURATION
     required:
-    - interface-name
-    - is-port-mirrored
+    - vnf-id
+    - vnf-instance-id
+    - vnf-name
+    - vnf-type
+    - vnf-package-name
+    - vnf-discriptor-name
+    - job-id
     - in-maint
-    - is-ip-unnumbered
+    - is-closed-loop-disabled
     properties:
-      interface-name:
+      vnf-id:
         type: string
-        description: Name given to the interface
-      interface-role:
+        description: Unique id of VNF.  This is unique across the graph.
+      vnf-instance-id:
         type: string
-        description: E.g., CUSTOMER, UPLINK, etc.
-      v6-wan-link-ip:
+        description: vnf instance id.
+      vnf-name:
         type: string
-        description: Questionably placed - v6 ip addr of this interface (is in vr-lan-interface from Mary B.
-      selflink:
+        description: Name of VNF.
+      vnf-name2:
         type: string
-        description: URL to endpoint where AAI can get more details
-      interface-id:
+        description: Alternate name of VNF.
+      vnf-type:
         type: string
-        description: ID of interface
-      macaddr:
+        description: String capturing type of vnf, that was intended to identify the ASDC resource.  This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures.
+      service-id:
         type: string
-        description: MAC address for the interface
-      network-name:
+        description: Unique identifier of service, does not necessarily map to ASDC service models.  SOON TO BE DEPRECATED
+      regional-resource-zone:
         type: string
-        description: Name of the network
+        description: Regional way of organizing pservers, source of truth should define values
+      prov-status:
+        type: string
+        description: Trigger for operational monitoring of this resource by Service Assurance systems.
+      operational-status:
+        type: string
+        description: Indicator for whether the resource is considered operational.  Valid values are in-service-path and out-of-service-path.
+      license-key:
+        type: string
+        description: OBSOLETE -  do not use
+      equipment-role:
+        type: string
+        description: Client should send valid enumerated value
+      orchestration-status:
+        type: string
+        description: Orchestration status of this VNF, used by MSO.
+      vnf-package-name:
+        type: string
+      vnf-discriptor-name:
+        type: string
+        description: vnf discriptor name
+      job-id:
+        type: string
+        description: job id corresponding to vnf
+      heat-stack-id:
+        type: string
+        description: Heat stack id corresponding to this instance, managed by MSO
+      mso-catalog-key:
+        type: string
+        description: Corresponds to the SDN-C catalog id used to configure this VCE
       management-option:
         type: string
-        description: Whether A&AI should be managing this interface of not. Could have value like CUSTOMER
-      interface-description:
+        description: identifier of managed by ATT or customer
+      ipv4-oam-address:
         type: string
-        description: Human friendly text regarding this interface.
-      is-port-mirrored:
+        description: Address tail-f uses to configure generic-vnf, also used for troubleshooting and is IP used for traps generated by generic-vnf.
+      ipv4-loopback0-address:
+        type: string
+        description: v4 Loopback0 address
+      nm-lan-v6-address:
+        type: string
+        description: v6 Loopback address
+      management-v6-address:
+        type: string
+        description: v6 management address
+      vcpu:
+        type: integer
+        format: int64
+        description: number of vcpus ordered for this instance of VNF, used for VNFs with no vservers/flavors, to be used only by uCPE
+      vcpu-units:
+        type: string
+        description: units associated with vcpu, used for VNFs with no vservers/flavors, to be used only by uCPE
+      vmemory:
+        type: integer
+        format: int64
+        description: number of GB of memory ordered for this instance of VNF, used for VNFs with no vservers/flavors, to be used only by uCPE
+      vmemory-units:
+        type: string
+        description: units associated with vmemory, used for VNFs with no vservers/flavors, to be used only by uCPE
+      vdisk:
+        type: integer
+        format: int64
+        description: number of vdisks ordered for this instance of VNF, used for VNFs with no vservers/flavors, to be used only uCPE
+      vdisk-units:
+        type: string
+        description: units associated with vdisk, used for VNFs with no vservers/flavors, to be used only by uCPE
+      nshd:
+        type: integer
+        format: int64
+        description: number of associated SHD in vnf.
+      nvm:
+        type: integer
+        format: int64
+        description: number of vms in vnf.
+      nnet:
+        type: integer
+        format: int64
+        description: number of network in vnf.
+      in-maint:
+        type: boolean
+      is-closed-loop-disabled:
         type: boolean
       resource-version:
         type: string
         description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
-      in-maint:
-        type: boolean
-      prov-status:
+      summary-status:
         type: string
-        description: Prov Status of the logical interface. Valid values [PREPROV/NVTPROV/PROV].
-      is-ip-unnumbered:
+        description: details regarding the generic-vnf operation, PLEASE DISCONTINUE USE OF THIS FIELD.
+      encrypted-access-flag:
         type: boolean
-      vlans:
-        type: array
-        items:
-          $ref: "#/definitions/vlan"
-      sriov-vfs:
-        type: array
-        items:
-          $ref: "#/definitions/sriov-vf"
-      l-interfaces:
-        type: array
-        items:
-          $ref: "#/definitions/l-interface"
-      relationship-list:
-        type: array
-        items:
-          $ref: "#/definitions/relationship"
-      l3-interface-ipv4-address-list:
-        type: array
-        items:          
-          $ref: "#/definitions/l3-interface-ipv4-address-list"
-      l3-interface-ipv6-address-list:
-        type: array
-        items:          
-          $ref: "#/definitions/l3-interface-ipv6-address-list"
-  l-interfaces:
-    description: |
-      Collection of logical interfaces.
-    properties:
-      l-interface:
-        type: array
-        items:          
-          $ref: "#/definitions/l-interface"
-  vserver:
-    description: |
-      Virtual Servers, aka virtual machine or VM.
-      ###### Default Delete Scope
-      CASCADE_TO_CHILDREN
-      ###### Related Nodes
-      - TO flavor (Many2One)
-      - TO image (Many2One)
-      - TO l-interface (comprises vserver, Many2Many)
-      - TO pserver (Many2One)
-      - TO volume (comprises vserver, Many2Many)
-      - TO vnfc (Many2Many)
-      - TO snapshot (One2One)
-      - TO vf-module (Many2One)
-      - FROM generic-vnf
-      - FROM tenant (is composed of vserver)
-      - FROM vce
-    required:
-    - vserver-id
-    - vserver-name
-    - vserver-selflink
-    - in-maint
-    - is-closed-loop-disabled
-    properties:
-      vserver-id:
+        description: indicates whether generic-vnf access uses SSH
+      entitlement-assignment-group-uuid:
+        type: string
+        description: UUID of the Entitlement group used for licensing VNFs, OBSOLETE -  See child relationships.
+      entitlement-resource-uuid:
+        type: string
+        description: UUID of the specific entitlement resource.  OBSOLETE -  See child relationships.
+      license-assignment-group-uuid:
+        type: string
+        description: UUID of the license assignment group.  OBSOLETE -  See child relationships.
+      license-key-uuid:
+        type: string
+        description: UUID of the actual license resource.  OBSOLETE -  See child relationships.
+      model-invariant-id:
         type: string
-        description: Unique identifier for this vserver relative to its tenant
-      vserver-name:
+        description: the ASDC model id for this resource or service model.
+      model-version-id:
         type: string
-        description: Name of vserver
-      vserver-name2:
+        description: the ASDC model version for this resource or service model.
+      persona-model-version:
         type: string
-        description: Alternative name of vserver
-      prov-status:
+        description: the ASDC model version for this resource or service model.
+      model-customization-id:
         type: string
-        description: Trigger for operational monitoring of this resource by Service Assurance systems.
-      vserver-selflink:
+        description: captures the id of all the configuration used to customize the resource for the service.
+      widget-model-id:
         type: string
-        description: URL to endpoint where AAI can get more details
-      in-maint:
-        type: boolean
-      is-closed-loop-disabled:
-        type: boolean
-      resource-version:
+        description: the ASDC data dictionary widget model. This maps directly to the A&AI widget.
+      widget-model-version:
         type: string
-        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
-      volumes:
-        type: array
-        items:
-          $ref: "#/definitions/volume"
-      relationship-list:
-        type: array
-        items:
-          $ref: "#/definitions/relationship"
-      l-interfaces:
-        type: array
-        items:
-          $ref: "#/definitions/l-interface"
-  vservers:
-    description: |
-      Collection of virtual Servers, aka virtual machines or VMs.
-    properties:
-      vserver:
-        type: array
-        items:          
-          $ref: "#/definitions/vserver"
-  tenant:
-    description: |
-      Openstack tenant
-      ###### Default Delete Scope
-      THIS_NODE_ONLY
-      ###### Related Nodes
-      - TO l3-network (Many2Many)
-      - TO service-subscription (Many2Many)
-      - TO vserver (comprises tenant, One2Many)
-      - FROM auth-info-item
-      - FROM cloud-region (is composed of tenant)
-      - FROM group-assignment
-      - FROM volume-group
-    required:
-    - tenant-id
-    - tenant-name
-    properties:
-      tenant-id:
+        description: the ASDC data dictionary version of the widget model.This maps directly to the A&AI version of the widget.
+      as-number:
         type: string
-        description: Unique id relative to the cloud-region.
-      tenant-name:
+        description: as-number of the VNF
+      regional-resource-subzone:
         type: string
-        description: Readable name of tenant
-      tenant-context:
+        description: represents sub zone of the rr plane
+      nf-type:
         type: string
-        description: This field will store the tenant context.
-      resource-version:
+        description: Generic description of the type of NF
+      nf-function:
         type: string
-        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
-      vservers:
-        type: array
-        items:
-          $ref: "#/definitions/vserver"
-      relationship-list:
-        type: array
-        items:
-          $ref: "#/definitions/relationship"
-  tenants:
-    description: |
-      Collection of openstack tenants.
-    properties:
-      tenant:
-        type: array
-        items:          
-          $ref: "#/definitions/tenant"
-  flavor:
-    description: |
-      Openstack flavor.
-      ###### Default Delete Scope
-      ERROR_IF_ANY_IN_EDGES
-      ###### Related Nodes
-      - FROM cloud-region (is composed of flavor)
-      - FROM vserver
-    required:
-    - flavor-id
-    - flavor-name
-    - flavor-selflink
-    properties:
-      flavor-id:
+        description: English description of Network function that the specific VNF deployment is providing
+      nf-role:
         type: string
-        description: Flavor id, expected to be unique across cloud-region.
-      flavor-name:
+        description: role in the network that this model will be providing
+      nf-naming-code:
         type: string
-        description: Flavor name
-      flavor-vcpus:
-        type: integer
-        format: int32
-        description: Number of CPUs
-      flavor-ram:
-        type: integer
-        format: int32
-        description: Amount of memory
-      flavor-disk:
+        description: string assigned to this model used for naming purposes
+      selflink:
+        type: string
+        description: Path to the controller object.
+      ipv4-oam-gateway-address:
+        type: string
+        description: Gateway address
+      ipv4-oam-gateway-address-prefix-length:
         type: integer
         format: int32
-        description: Disk space
-      flavor-ephemeral:
+        description: Prefix length for oam-address
+      vlan-id-outer:
         type: integer
-        format: int32
-        description: Amount of ephemeral disk space
-      flavor-swap:
-        type: string
-        description: amount of swap space allocation
-      flavor-is-public:
-        type: boolean
-        description: whether flavor is available to all users or private to the tenant it was created in.
-      flavor-selflink:
-        type: string
-        description: URL to endpoint where AAI can get more details
-      flavor-disabled:
-        type: boolean
-        description: Boolean as to whether this flavor is no longer enabled
-      resource-version:
+        format: int64
+        description: Temporary location for S-TAG to get to VCE
+      nm-profile-name:
         type: string
-        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+        description: Network Management profile of this VNF
       relationship-list:
         type: array
         items:
-          $ref: "#/definitions/relationship"
-  flavors:
+          $ref: "#/getDefinitions/relationship"
+      l-interfaces:
+        type: array
+        items:
+          $ref: "#/getDefinitions/l-interface"
+      lag-interfaces:
+        type: array
+        items:
+          $ref: "#/getDefinitions/lag-interface"
+      vf-modules:
+        type: array
+        items:
+          $ref: "#/getDefinitions/vf-module"
+      licenses:
+        type: array
+        items:
+          $ref: "#/getDefinitions/license"
+      entitlements:
+        type: array
+        items:
+          $ref: "#/getDefinitions/entitlement"
+  generic-vnfs:
     description: |
-      Collection of openstack flavors.
+      Collection of VNFs
     properties:
-      flavor:
+      generic-vnf:
         type: array
         items:          
-          $ref: "#/definitions/flavor"
+          $ref: "#/getDefinitions/generic-vnf"
   group-assignment:
     description: |
       Openstack group-assignment used to store exclusivity groups (EG).
-      ###### Default Delete Scope
-      THIS_NODE_ONLY
       ###### Related Nodes
-      - TO tenant (Many2Many)
-      - TO pserver (One2Many)
-      - FROM cloud-region (is composed of group-assignment)
+      - TO cloud-region( group-assignment org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE)
+      - FROM pserver( pserver org.onap.relationships.inventory.MemberOf group-assignment, MANY2ONE)
+      - FROM tenant( tenant org.onap.relationships.inventory.MemberOf group-assignment, MANY2MANY)
     required:
     - group-id
     - group-type
@@ -39707,7 +63743,7 @@ definitions:
       relationship-list:
         type: array
         items:
-          $ref: "#/definitions/relationship"
+          $ref: "#/getDefinitions/relationship"
   group-assignments:
     description: |
       Collection of openstack group assignments
@@ -39715,103 +63751,112 @@ definitions:
       group-assignment:
         type: array
         items:          
-          $ref: "#/definitions/group-assignment"
-  snapshot:
+          $ref: "#/getDefinitions/group-assignment"
+  host-route:
     description: |
-      Openstack snapshot
-      ###### Default Delete Scope
-      THIS_NODE_ONLY
       ###### Related Nodes
-      - FROM cloud-region (is composed of snapshot)
-      - FROM vserver
+      - TO subnet( host-route org.onap.relationships.inventory.BelongsTo subnet, MANY2ONE)
     required:
-    - snapshot-id
+    - host-route-id
+    - route-prefix
+    - next-hop
     properties:
-      snapshot-id:
-        type: string
-        description: Snapshot id, this is the key UUID assoc associated in glance with the snapshots.
-      snapshot-name:
-        type: string
-        description: Snapshot name
-      snapshot-architecture:
-        type: string
-        description: Operating system architecture
-      snapshot-os-distro:
-        type: string
-        description: The common name of the operating system distribution in lowercase
-      snapshot-os-version:
+      host-route-id:
         type: string
-        description: The operating system version as specified by the distributor.
-      application:
-        type: string
-        description: The application that the image instantiates.
-      application-vendor:
-        type: string
-        description: The vendor of the application.
-      application-version:
+        description: host-route id
+      route-prefix:
         type: string
-        description: The version of the application.
-      snapshot-selflink:
+        description: subnet prefix
+      next-hop:
         type: string
-        description: URL to endpoint where AAI can get more details
-      prev-snapshot-id:
+        description: Could be ip-address, hostname, or service-instance
+      next-hop-type:
         type: string
-        description: This field contains the UUID of the previous snapshot (if any).
+        description: Should be ip-address, hostname, or service-instance to match next-hop
       resource-version:
         type: string
         description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
       relationship-list:
         type: array
         items:
-          $ref: "#/definitions/relationship"
-  snapshots:
+          $ref: "#/getDefinitions/relationship"
+  host-routes:
+    properties:
+      host-route:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/host-route"
+  hpa-capabilities:
     description: |
-      Collection of openstack snapshots
+      Collection of HPA Capabilities
     properties:
-      snapshot:
+      hpa-capability:
         type: array
         items:          
-          $ref: "#/definitions/snapshot"
-  metadatum:
+          $ref: "#/getDefinitions/hpa-capability"
+  hpa-capability:
     description: |
-      Key/value pairs
-      ###### Default Delete Scope
-      THIS_NODE_ONLY
+      Represents a HPA capability
       ###### Related Nodes
-      - FROM image (is composed of metadatum)
-      - FROM model-ver (is composed of metadatum)
-      - FROM service-instance (is composed of metadatum)
-      - FROM connector (is composed of metadatum)
+      - TO flavor( hpa-capability org.onap.relationships.inventory.BelongsTo flavor, MANY2ONE)
+      - TO cloud-region( hpa-capability org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE)
+      - FROM hpa-feature-attributes( hpa-feature-attributes org.onap.relationships.inventory.BelongsTo hpa-capability, MANY2ONE)
+      - HPA-CAPABILITY is DELETED when these are DELETED HPA-FEATURE-ATTRIBUTES
     required:
-    - metaname
-    - metaval
+    - hpa-capability-id
+    - hpa-feature
     properties:
-      metaname:
+      hpa-capability-id:
         type: string
-      metaval:
+        description: UUID to uniquely identify a HPA capability
+      hpa-feature:
+        type: string
+        description: Name of the HPACapability
+      hpa-version:
         type: string
+        description: HPA schema version
+      hpa-hw-arch:
+        type: string
+        description: Hardware architecture
       resource-version:
         type: string
         description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
-  metadata:
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/getDefinitions/relationship"
+      hpa-feature-attributes:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/hpa-feature-attributes"
+  hpa-feature-attributes:
     description: |
-      Collection of metadatum (key/value pairs)
-      ###### Default Delete Scope
-      THIS_NODE_ONLY
+      HPA Capability Feature attributes
+      ###### Related Nodes
+      - TO hpa-capability( hpa-feature-attributes org.onap.relationships.inventory.BelongsTo hpa-capability, MANY2ONE)
     properties:
-      metadatum:
+      hpa-attr-key:
+        type: string
+        description: name of the specific HPA attribute
+      hpa-attr-value:
+        type: string
+        description: JSON string specifying the value, unit and type of the specific HPA attribute
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      relationship-list:
         type: array
-        items:          
-          $ref: "#/definitions/metadatum"
+        items:
+          $ref: "#/getDefinitions/relationship"
   image:
     description: |
       Openstack image.
-      ###### Default Delete Scope
-      ERROR_4_IN_EDGES_OR_CASCADE
       ###### Related Nodes
-      - TO metadatum (comprises image, Many2Many)
-      - FROM cloud-region (is composed of image)
-      - FROM vserver
+      - TO cloud-region( image org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE)
+      - FROM metadatum( metadatum org.onap.relationships.inventory.BelongsTo image, MANY2ONE)
+      - FROM vserver( vserver org.onap.relationships.inventory.Uses image, MANY2ONE)
+      - IMAGE cannot be deleted if linked to VSERVER
+      - IMAGE is DELETED when these are DELETED METADATUM
     required:
     - image-id
     - image-name
@@ -39852,11 +63897,11 @@ definitions:
       relationship-list:
         type: array
         items:
-          $ref: "#/definitions/relationship"
+          $ref: "#/getDefinitions/relationship"
       metadata:
         type: array
         items:
-          $ref: "#/definitions/metadatum"
+          $ref: "#/getDefinitions/metadatum"
   images:
     description: |
       Collectio of Openstack images.
@@ -39864,425 +63909,577 @@ definitions:
       image:
         type: array
         items:          
-          $ref: "#/definitions/image"
-  dvs-switch:
-    description: |
-      Digital virtual switch metadata, used by SDN-C to configure VCEs.  A&AI needs to receive this data from the PO deployment team and administer it using the provisioningTool.sh into A&AI. 
-      ###### Default Delete Scope
-      THIS_NODE_ONLY
-      ###### Related Nodes
-      - TO availability-zone (Many2Many)
-      - FROM cloud-region (is composed of dvs-switch)
-    required:
-    - switch-name
-    - vcenter-url
+          $ref: "#/getDefinitions/image"
+  include-node-filter:
     properties:
-      switch-name:
-        type: string
-        description: DVS switch name
-      vcenter-url:
-        type: string
-        description: URL used to reach the vcenter
-      resource-version:
+      include-node-type:
         type: string
-        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
-      relationship-list:
-        type: array
-        items:
-          $ref: "#/definitions/relationship"
-  dvs-switches:
+  instance-filter:
     description: |
-      Collection of digital virtual switch metadata used for vmWare VCEs and GenericVnfs.
+      InstanceFilter for performing a named-query or model query
+  instance-filters:
+    description: |
+      InstanceFilters for performing a named-query or model query
     properties:
-      dvs-switch:
+      instance-filter:
         type: array
         items:          
-          $ref: "#/definitions/dvs-switch"
-  oam-network:
+          $ref: "#/getDefinitions/instance-filter"
+  instance-group:
     description: |
-      OAM network, to be deprecated shortly.  Do not use for new purposes. 
-      ###### Default Delete Scope
-      ERROR_IF_ANY_IN_EDGES
+      General mechanism for grouping instances
       ###### Related Nodes
-      - TO complex (Many2Many)
-      - TO service-capability (Many2Many)
-      - FROM cloud-region (is composed of oam-network)
+      - TO model( instance-group org.onap.relationships.inventory.Targets model, MANY2MANY)
+      - FROM allotted-resource( allotted-resource org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY)
+      - FROM generic-vnf( generic-vnf org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY)
+      - FROM l3-interface-ipv4-address-list( l3-interface-ipv4-address-list org.onap.relationships.inventory.network.MemberOf instance-group, MANY2MANY)
+      - FROM l3-interface-ipv6-address-list( l3-interface-ipv6-address-list org.onap.relationships.inventory.network.MemberOf instance-group, MANY2MANY)
+      - FROM l3-network( l3-network org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY)
+      - FROM l-interface( l-interface org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY)
+      - FROM pnf( pnf org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY)
+      - FROM service-instance( service-instance org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY)
+      - FROM vip-ipv4-address-list( vip-ipv4-address-list org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY)
+      - FROM vip-ipv6-address-list( vip-ipv6-address-list org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY)
+      - FROM vnfc( vnfc org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY)
     required:
-    - network-uuid
-    - network-name
-    - cvlan-tag
+    - instance-group-role
+    - model-invariant-id
+    - model-version-id
+    - id
+    - description
+    - type
     properties:
-      network-uuid:
+      instance-group-role:
         type: string
-        description: UUID of the network. Unique across a cloud-region
-      network-name:
+        description: role of the instance group.
+      model-invariant-id:
         type: string
-        description: Name of the network.
-      cvlan-tag:
-        type: integer
-        format: int64
-        description: cvlan-id
-      ipv4-oam-gateway-address:
+        description: ASDC model id for this resource or service model.
+      model-version-id:
         type: string
-        description: Used for VNF firewall rule so customer cannot send customer traffic over this oam network
-      ipv4-oam-gateway-address-prefix-length:
-        type: integer
-        format: int32
-        description: Used for VNF firewall rule so customer cannot send customer traffic over this oam network
+        description: ASDC model version uid for this resource model.
+      id:
+        type: string
+        description: Instance Group ID, UUID assigned to this instance.
+      description:
+        type: string
+        description: Descriptive text to help identify the usage of this instance-group
+      type:
+        type: string
+        description: Only valid value today is lower case ha for high availability
+      sub-type:
+        type: string
+        description: Valid values for ha type are [geo-activeactive, geo-activestandby, local-activeactive, local-activestandby]
       resource-version:
         type: string
-        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+        description: Concurrency value
       relationship-list:
         type: array
         items:
-          $ref: "#/definitions/relationship"
-  oam-networks:
+          $ref: "#/getDefinitions/relationship"
+  instance-groups:
     description: |
-      Collection of OAM networks, to be deprecated shortly.  Do not use for new purposes. 
+      Collection of openstack route table references
     properties:
-      oam-network:
+      instance-group:
         type: array
         items:          
-          $ref: "#/definitions/oam-network"
-  availability-zone:
-    description: |
-      Availability zone, a collection of compute hosts/pservers
-      ###### Default Delete Scope
-      ERROR_IF_ANY_IN_EDGES
-      ###### Related Nodes
-      - TO complex (Many2Many)
-      - TO service-capability (Many2Many)
-      - FROM cloud-region (is composed of availability-zone)
-      - FROM ctag-pool
-      - FROM dvs-switch
-      - FROM generic-vnf
-      - FROM pserver
-      - FROM vce
-    required:
-    - availability-zone-name
-    - hypervisor-type
+          $ref: "#/getDefinitions/instance-group"
+  inventory:
     properties:
-      availability-zone-name:
+      search:
+        type: object
+        $ref: "#/getDefinitions/search"
+      actions:
+        type: object
+        $ref: "#/getDefinitions/actions"
+      cloud-infrastructure:
+        type: object
+        $ref: "#/getDefinitions/cloud-infrastructure"
+      external-system:
+        type: object
+        $ref: "#/getDefinitions/external-system"
+      business:
+        type: object
+        $ref: "#/getDefinitions/business"
+      service-design-and-creation:
+        type: object
+        $ref: "#/getDefinitions/service-design-and-creation"
+      network:
+        type: object
+        $ref: "#/getDefinitions/network"
+      aai-internal:
+        type: object
+        $ref: "#/getDefinitions/aai-internal"
+      nodes:
+        type: array
+        items:
+          $ref: "#/getDefinitions/aai-internal"
+  inventory-item:
+    properties:
+      inventory-item-type:
         type: string
-        description: Name of the availability zone.  Unique across a cloud region
-      hypervisor-type:
+      inventory-item-link:
         type: string
-        description: Type of hypervisor.  Source of truth should define valid values.
-      operational-status:
+      inventory-item-data:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/inventory-item-data"
+      tagged-inventory-item-list:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/tagged-inventory-item-list"
+  inventory-item-data:
+    properties:
+      property-name:
         type: string
-        description: State that indicates whether the availability zone should be used, etc.  Source of truth should define valid values.
-      resource-version:
+      property-value:
         type: string
-        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
-      relationship-list:
-        type: array
-        items:
-          $ref: "#/definitions/relationship"
-  availability-zones:
+  inventory-response-item:
     description: |
-      Collection of availability zones
+      Inventory item for response list
     properties:
-      availability-zone:
+      model-name:
+        type: string
+      extra-properties:
+        type: object
+        $ref: "#/getDefinitions/extra-properties"
+      inventory-response-items:
+        type: object
+        $ref: "#/getDefinitions/inventory-response-items"
+  inventory-response-items:
+    description: |
+      Container for inventory items in response list
+    properties:
+      inventory-response-item:
         type: array
         items:          
-          $ref: "#/definitions/availability-zone"
-  auth-info-item:
+          $ref: "#/getDefinitions/inventory-response-item"
+  ipsec-configuration:
     description: |
-      Persistent auth info.
+      IPSec configuration node will contain various configuration data for the NMTE VNF. This node will have an edge to the generic-vnf (vnf type = TE). Starting 1607, this data will be populated by SDN-C
       ###### Related Nodes
-      - TO tenant (One2One)
-      - FROM cloud-region (is composed of auth-info-item)
+      - FROM generic-vnf( generic-vnf org.onap.relationships.inventory.Uses ipsec-configuration, MANY2ONE)
+      - FROM vig-server( vig-server org.onap.relationships.inventory.BelongsTo ipsec-configuration, MANY2ONE)
+      - IPSEC-CONFIGURATION is DELETED when these are DELETED VIG-SERVER
     required:
-    - auth-info-item-id
-    - cloud-domain
-    - username
-    - password
-    - auth-url
-    - ssl-cacert
-    - ssl-insecure
+    - ipsec-configuration-id
     properties:
-      auth-info-item-id:
+      ipsec-configuration-id:
         type: string
-        description: Unique ID of auth-info-item.
-      cloud-domain:
+        description: UUID of this configuration
+      requested-vig-address-type:
         type: string
-        description: domain info for authentication.
-      username:
+        description: Indicate the type of VIG server like AVPN, INTERNET, BOTH
+      requested-encryption-strength:
         type: string
-        description: user name of auth infomation to access VIM.
-      password:
+        description: Encryption values like 3des-cbc, des-cbc, aes-128-cbc, aes-192-cbc, aes-265-cbc
+      requested-dmz-type:
         type: string
-        description: password of auth infomation to access VIM.
-      auth-url:
+        description: ATT can offer a shared DMZ or a DMZ specific to a customer
+      shared-dmz-network-address:
         type: string
-        description: authentication url of the cloud.
-      ssl-cacert:
+        description: Network address of shared DMZ
+      requested-customer-name:
         type: string
-        description: ca file content if enabled ssl on auth-url.
-      ssl-insecure:
-        type: boolean
-        description: Whether to verify VIM's certificate.
+        description: If the DMZ is a custom DMZ, this field will indicate the customer information
+      ike-version:
+        type: string
+        description: can be 1 or 2
+      ikev1-authentication:
+        type: string
+        description: Contains values like md5, sha1, sha256, sha384
+      ikev1-encryption:
+        type: string
+        description: Encyption values like 3des-cbc, des-cbc, aes-128-cbc,?aes-192-cbc, aes-265-cbc
+      ikev1-dh-group:
+        type: string
+        description: Diffie-Hellman group like DH-GROUP2, DH-GROUP5, DH-GROUP14
+      ikev1-am-group-id:
+        type: string
+        description: Group name defined in VIG for clients using aggressive mode
+      ikev1-am-password:
+        type: string
+        description: pre-shared key for the above group name 
+      ikev1-sa-lifetime:
+        type: string
+        description: Lifetime for IKEv1 SA
+      ipsec-authentication:
+        type: string
+        description: md5, sha1, sha256, sha384
+      ipsec-encryption:
+        type: string
+        description: 3des-cbc, des-cbc, aes-128-cbc,?aes-192-cbc, aes-265-cbc
+      ipsec-sa-lifetime:
+        type: string
+        description: Life time for IPSec SA
+      ipsec-pfs:
+        type: string
+        description: enable PFS or not
+      xauth-userid:
+        type: string
+        description: user ID for xAuth, sm-user,ucpeHostName,nmteHostName
+      xauth-user-password:
+        type: string
+        description: Encrypted using the Juniper $9$ algorithm
+      dpd-interval:
+        type: string
+        description: The time between DPD probe
+      dpd-frequency:
+        type: string
+        description: Maximum number of DPD before claiming the tunnel is down
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
       relationship-list:
         type: array
         items:
-          $ref: "#/definitions/relationship"
-  auth-info-items:
-    description: |
-      Collection of persistent auth information to access to VIM.
+          $ref: "#/getDefinitions/relationship"
+      vig-servers:
+        type: array
+        items:
+          $ref: "#/getDefinitions/vig-server"
+  ipsec-configurations:
     properties:
-      auth-info-item:
+      ipsec-configuration:
         type: array
         items:          
-          $ref: "#/definitions/auth-info-item"
-  cloud-region:
+          $ref: "#/getDefinitions/ipsec-configuration"
+  key-data:
+    properties:
+      key-name:
+        type: string
+      key-value:
+        type: string
+  l-interface:
     description: |
-      cloud-region designates an installation of a cloud cluster or region or instantiation.
-      ###### Default Delete Scope
-      THIS_NODE_ONLY
-      ###### Related Nodes
-      - TO complex (Many2One)
-      - TO l3-network (Many2Many)
-      - TO tenant (comprises cloud-region, One2Many)
-      - TO auth-info-item (comprises cloud-region, One2Many)
-      - TO image (comprises cloud-region, One2Many)
-      - TO flavor (comprises cloud-region, One2Many)
-      - TO availability-zone (comprises cloud-region, One2Many)
-      - TO oam-network (comprises cloud-region, One2Many)
-      - TO dvs-switch (comprises cloud-region, One2Many)
-      - TO volume-group (comprises cloud-region, One2Many)
-      - TO group-assignment (comprises cloud-region, One2Many)
-      - TO snapshot (comprises cloud-region, One2Many)
-      - TO zone (Many2One)
-      - FROM pserver
-      - FROM logical-link
+      Logical interfaces, e.g., a vnic.
+      ###### Related Nodes
+      - TO generic-vnf( l-interface org.onap.relationships.inventory.BelongsTo generic-vnf, MANY2ONE)
+      - TO lag-interface( l-interface org.onap.relationships.inventory.BelongsTo lag-interface, MANY2ONE)
+      - TO instance-group( l-interface org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY)
+      - TO l-interface( l-interface org.onap.relationships.inventory.BelongsTo l-interface, MANY2ONE)
+      - TO logical-link( l-interface tosca.relationships.network.LinksTo logical-link, MANY2MANY)
+      - TO newvce( l-interface org.onap.relationships.inventory.BelongsTo newvce, MANY2ONE)
+      - TO p-interface( l-interface tosca.relationships.network.BindsTo p-interface, MANY2ONE)
+      - TO vserver( l-interface tosca.relationships.network.BindsTo vserver, MANY2ONE)
+      - FROM allotted-resource( allotted-resource org.onap.relationships.inventory.Uses l-interface, ONE2MANY)
+      - FROM l3-interface-ipv4-address-list( l3-interface-ipv4-address-list org.onap.relationships.inventory.BelongsTo l-interface, MANY2ONE)
+      - FROM l3-interface-ipv6-address-list( l3-interface-ipv6-address-list org.onap.relationships.inventory.BelongsTo l-interface, MANY2ONE)
+      - FROM sriov-vf( sriov-vf org.onap.relationships.inventory.BelongsTo l-interface, ONE2ONE)
+      - FROM vlan( vlan tosca.relationships.network.LinksTo l-interface, MANY2ONE)
+      - FROM l-interface( l-interface org.onap.relationships.inventory.BelongsTo l-interface, MANY2ONE)
+      - L-INTERFACE is DELETED when these are DELETED L3-INTERFACE-IPV4-ADDRESS-LIST,L3-INTERFACE-IPV6-ADDRESS-LIST,SRIOV-VF,VLAN
+      - L-INTERFACE deletion means associated objects of these types are also DELETED:LOGICAL-LINK
     required:
-    - cloud-owner
-    - cloud-region-id
-    - sriov-automation
+    - interface-name
+    - is-port-mirrored
+    - in-maint
+    - is-ip-unnumbered
     properties:
-      cloud-owner:
+      interface-name:
         type: string
-        description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
-      cloud-region-id:
+        description: Name given to the interface
+      interface-role:
         type: string
-        description: Identifier used by the vendor for the region. Second part of composite key
-      cloud-type:
+        description: E.g., CUSTOMER, UPLINK, etc.
+      v6-wan-link-ip:
         type: string
-        description: Type of the cloud (e.g., openstack)
-      owner-defined-type:
+        description: Questionably placed - v6 ip addr of this interface (is in vr-lan-interface from Mary B.
+      selflink:
         type: string
-        description: Cloud-owner defined type indicator (e.g., dcp, lcp)
-      cloud-region-version:
+        description: URL to endpoint where AAI can get more details
+      interface-id:
         type: string
-        description: Software version employed at the site.  NOTE - THIS FIELD IS NOT KEPT UP TO DATE.
-      identity-url:
+        description: ID of interface
+      macaddr:
         type: string
-        description: URL of the keystone identity service
-      cloud-zone:
+        description: MAC address for the interface
+      network-name:
+        type: string
+        description: Name of the network
+      management-option:
         type: string
-        description: Zone where the cloud is homed.  NOTE - THIS FIELD IS NOT CORRECTLY POPULATED.
-      complex-name:
+        description: Whether A&AI should be managing this interface of not. Could have value like CUSTOMER
+      interface-description:
         type: string
-        description: complex name for cloud-region instance.  NOTE - THIS FIELD IS NOT CORRECTLY POPULATED.
-      sriov-automation:
+        description: Human friendly text regarding this interface.
+      is-port-mirrored:
         type: boolean
       resource-version:
         type: string
         description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
-      volume-groups:
-        type: array
-        items:
-          $ref: "#/definitions/volume-group"
-      tenants:
-        type: array
-        items:
-          $ref: "#/definitions/tenant"
-      flavors:
-        type: array
-        items:
-          $ref: "#/definitions/flavor"
-      group-assignments:
-        type: array
-        items:
-          $ref: "#/definitions/group-assignment"
-      snapshots:
-        type: array
-        items:
-          $ref: "#/definitions/snapshot"
-      images:
-        type: array
-        items:
-          $ref: "#/definitions/image"
-      dvs-switches:
+      in-maint:
+        type: boolean
+      prov-status:
+        type: string
+        description: Prov Status of the logical interface. Valid values [PREPROV/NVTPROV/PROV].
+      is-ip-unnumbered:
+        type: boolean
+      allowed-address-pairs:
+        type: string
+        description: Freeform field for storing an ip address, list of ip addresses or a subnet block.
+      vlans:
         type: array
         items:
-          $ref: "#/definitions/dvs-switch"
-      oam-networks:
+          $ref: "#/getDefinitions/vlan"
+      sriov-vfs:
         type: array
         items:
-          $ref: "#/definitions/oam-network"
-      availability-zones:
+          $ref: "#/getDefinitions/sriov-vf"
+      l-interfaces:
         type: array
         items:
-          $ref: "#/definitions/availability-zone"
+          $ref: "#/getDefinitions/l-interface"
       relationship-list:
         type: array
         items:
-          $ref: "#/definitions/relationship"
-      auth-info-items:
+          $ref: "#/getDefinitions/relationship"
+      l3-interface-ipv4-address-list:
         type: array
-        items:
-          $ref: "#/definitions/auth-info-item"
-  cloud-regions:
+        items:          
+          $ref: "#/getDefinitions/l3-interface-ipv4-address-list"
+      l3-interface-ipv6-address-list:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/l3-interface-ipv6-address-list"
+  l-interfaces:
+    description: |
+      Collection of logical interfaces.
     properties:
-      cloud-region:
+      l-interface:
         type: array
         items:          
-          $ref: "#/definitions/cloud-region"
-  network-profile:
+          $ref: "#/getDefinitions/l-interface"
+  l3-interface-ipv4-address-list:
     description: |
-      Network profile populated by SDN-GP for SNMP
-      ###### Default Delete Scope
-      THIS_NODE_ONLY
+      IPv4 Address Range
       ###### Related Nodes
-      - FROM generic-vnf
+      - TO instance-group( l3-interface-ipv4-address-list org.onap.relationships.inventory.network.MemberOf instance-group, MANY2MANY)
+      - TO l3-network( l3-interface-ipv4-address-list org.onap.relationships.inventory.network.MemberOf l3-network, MANY2MANY)
+      - TO subnet( l3-interface-ipv4-address-list org.onap.relationships.inventory.network.MemberOf subnet, MANY2MANY)
+      - TO l-interface( l3-interface-ipv4-address-list org.onap.relationships.inventory.BelongsTo l-interface, MANY2ONE)
+      - TO vlan( l3-interface-ipv4-address-list org.onap.relationships.inventory.BelongsTo vlan, MANY2ONE)
+      - TO vnfc( l3-interface-ipv4-address-list org.onap.relationships.inventory.BelongsTo vnfc, MANY2ONE)
     required:
-    - nm-profile-name
+    - l3-interface-ipv4-address
     properties:
-      nm-profile-name:
-        type: string
-        description: Unique name of network profile.
-      community-string:
+      l3-interface-ipv4-address:
         type: string
-        description: Encrypted SNMP community string
+        description: IP address
+      l3-interface-ipv4-prefix-length:
+        type: integer
+        format: int64
+        description: Prefix length, 32 for single address
+      vlan-id-inner:
+        type: integer
+        format: int64
+        description: Inner VLAN tag
+      vlan-id-outer:
+        type: integer
+        format: int64
+        description: Outer VLAN tag
+      is-floating:
+        type: boolean
+        description: Indicator of fixed or floating address
       resource-version:
         type: string
         description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      neutron-network-id:
+        type: string
+        description: Neutron network id of the interface that address belongs to
+      neutron-subnet-id:
+        type: string
+        description: Neutron id of subnet that address belongs to
       relationship-list:
         type: array
         items:
-          $ref: "#/definitions/relationship"
-  network-profiles:
-    description: |
-      Collection of network profiles
-    properties:
-      network-profile:
-        type: array
-        items:          
-          $ref: "#/definitions/network-profile"
-  sriov-pf:
+          $ref: "#/getDefinitions/relationship"
+  l3-interface-ipv6-address-list:
     description: |
-      SR-IOV Physical Function
-      ###### Default Delete Scope
-      THIS_NODE_ONLY
+      IPv6 Address Range
       ###### Related Nodes
-      - FROM p-interface (is composed of sriov-pf)
-      - FROM sriov-vf
+      - TO instance-group( l3-interface-ipv6-address-list org.onap.relationships.inventory.network.MemberOf instance-group, MANY2MANY)
+      - TO l3-network( l3-interface-ipv6-address-list org.onap.relationships.inventory.network.MemberOf l3-network, MANY2MANY)
+      - TO subnet( l3-interface-ipv6-address-list org.onap.relationships.inventory.network.MemberOf subnet, MANY2MANY)
+      - TO l-interface( l3-interface-ipv6-address-list org.onap.relationships.inventory.BelongsTo l-interface, MANY2ONE)
+      - TO vlan( l3-interface-ipv6-address-list org.onap.relationships.inventory.BelongsTo vlan, MANY2ONE)
+      - TO vnfc( l3-interface-ipv6-address-list org.onap.relationships.inventory.BelongsTo vnfc, MANY2ONE)
     required:
-    - pf-pci-id
+    - l3-interface-ipv6-address
     properties:
-      pf-pci-id:
+      l3-interface-ipv6-address:
         type: string
-        description: Identifier for the sriov-pf
+        description: IP address
+      l3-interface-ipv6-prefix-length:
+        type: integer
+        format: int64
+        description: Prefix length, 128 for single address
+      vlan-id-inner:
+        type: integer
+        format: int64
+        description: Inner VLAN tag
+      vlan-id-outer:
+        type: integer
+        format: int64
+        description: Outer VLAN tag
+      is-floating:
+        type: boolean
+        description: Indicator of fixed or floating address
       resource-version:
         type: string
         description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      neutron-network-id:
+        type: string
+        description: Neutron network id of the interface that address belongs to
+      neutron-subnet-id:
+        type: string
+        description: Neutron id of subnet that address belongs to
       relationship-list:
         type: array
         items:
-          $ref: "#/definitions/relationship"
-  sriov-pfs:
-    description: |
-      Collection of SR-IOV Physical Functions.
-    properties:
-      sriov-pf:
-        type: array
-        items:          
-          $ref: "#/definitions/sriov-pf"
-  p-interface:
+          $ref: "#/getDefinitions/relationship"
+  l3-network:
     description: |
-      Physical interface (e.g., nic)
-      ###### Default Delete Scope
-      CASCADE_TO_CHILDREN
-      ###### Related Nodes
-      - TO l-interface (comprises p-interface, Many2Many)
-      - TO physical-link (Many2Many)
-      - TO logical-link (Many2One)
-      - TO sriov-pf (comprises p-interface, One2One)
-      - FROM lag-interface
-      - FROM pserver (is composed of p-interface)
-      - FROM pnf (is composed of p-interface)
-      - FROM vpls-pe (is composed of p-interface)
+      Generic network definition
+      ###### Related Nodes
+      - TO instance-group( l3-network org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY)
+      - TO network-policy( l3-network org.onap.relationships.inventory.Uses network-policy, MANY2MANY)
+      - TO route-table-reference( l3-network org.onap.relationships.inventory.Uses route-table-reference, MANY2MANY)
+      - TO vpn-binding( l3-network org.onap.relationships.inventory.Uses vpn-binding, MANY2MANY)
+      - FROM allotted-resource( allotted-resource org.onap.relationships.inventory.PartOf l3-network, MANY2MANY)
+      - FROM cloud-region( cloud-region org.onap.relationships.inventory.Uses l3-network, MANY2MANY)
+      - FROM complex( complex org.onap.relationships.inventory.Uses l3-network, MANY2MANY)
+      - FROM generic-vnf( generic-vnf org.onap.relationships.inventory.Uses l3-network, MANY2MANY)
+      - FROM l3-interface-ipv4-address-list( l3-interface-ipv4-address-list org.onap.relationships.inventory.network.MemberOf l3-network, MANY2MANY)
+      - FROM l3-interface-ipv6-address-list( l3-interface-ipv6-address-list org.onap.relationships.inventory.network.MemberOf l3-network, MANY2MANY)
+      - FROM ctag-assignment( ctag-assignment org.onap.relationships.inventory.BelongsTo l3-network, MANY2ONE)
+      - FROM segmentation-assignment( segmentation-assignment org.onap.relationships.inventory.BelongsTo l3-network, MANY2ONE)
+      - FROM service-instance( service-instance org.onap.relationships.inventory.ComposedOf l3-network, ONE2MANY)
+      - FROM subnet( subnet org.onap.relationships.inventory.BelongsTo l3-network, MANY2ONE)
+      - FROM tenant( tenant org.onap.relationships.inventory.Uses l3-network, MANY2MANY)
+      - FROM vf-module( vf-module org.onap.relationships.inventory.DependsOn l3-network, MANY2MANY)
+      - L3-NETWORK is DELETED when these are DELETED CTAG-ASSIGNMENT,SEGMENTATION-ASSIGNMENT,SUBNET
     required:
-    - interface-name
-    - in-maint
+    - network-id
+    - network-name
+    - is-bound-to-vpn
+    - is-provider-network
+    - is-shared-network
+    - is-external-network
     properties:
-      interface-name:
-        type: string
-        description: Name that identifies the physical interface
-      speed-value:
+      network-id:
         type: string
-        description: Captures the numeric part of the speed
-      speed-units:
+        description: Network ID, should be uuid. Unique across A&AI.
+      network-name:
         type: string
-        description: Captures the units corresponding to the speed
-      port-description:
+        description: Name of the network, governed by some naming convention..
+      network-type:
         type: string
-        description: Nature of the services and connectivity on this port.
-      equipment-identifier:
+        description: Type of the network - who defines these values?
+      network-role:
         type: string
-        description: CLEI or other specification for p-interface hardware.
-      interface-role:
+        description: Role the network plans - who defines these values?
+      network-technology:
         type: string
-        description: Role specification for p-interface hardware.
-      interface-type:
+        description: Network technology - who defines these values?
+      neutron-network-id:
         type: string
-        description: Indicates the physical properties of the interface.
-      prov-status:
+        description: Neutron network id of this Interface
+      is-bound-to-vpn:
+        type: boolean
+      service-id:
         type: string
-        description: Trigger for operational monitoring of this resource by Service Assurance systems.
+        description: Unique identifier of service from ASDC.  Does not strictly map to ASDC services.  SOON TO BE DEPRECATED
+      network-role-instance:
+        type: integer
+        format: int64
+        description: network role instance
       resource-version:
         type: string
         description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
-      in-maint:
+      orchestration-status:
+        type: string
+        description: Orchestration status of this VNF, mastered by MSO
+      heat-stack-id:
+        type: string
+        description: Heat stack id corresponding to this instance, managed by MSO
+      mso-catalog-key:
+        type: string
+        description: Corresponds to the SDN-C catalog id used to configure this VCE
+      contrail-network-fqdn:
+        type: string
+        description: Contrail FQDN for the network
+      model-invariant-id:
+        type: string
+        description: the ASDC model id for this resource or service model.
+      model-version-id:
+        type: string
+        description: the ASDC model version for this resource or service model.
+      persona-model-version:
+        type: string
+        description: the ASDC model version for this resource or service model.
+      model-customization-id:
+        type: string
+        description: captures the id of all the configuration used to customize the resource for the service.
+      widget-model-id:
+        type: string
+        description: the ASDC data dictionary widget model. This maps directly to the A&AI widget.
+      widget-model-version:
+        type: string
+        description: the ASDC data dictionary version of the widget model.This maps directly to the A&AI version of the widget.
+      physical-network-name:
+        type: string
+        description: Name associated with the physical network.
+      is-provider-network:
         type: boolean
-      inv-status:
+      is-shared-network:
+        type: boolean
+      is-external-network:
+        type: boolean
+      selflink:
         type: string
-        description: inventory status
-      relationship-list:
+        description: Path to the controller object.
+      operational-status:
+        type: string
+        description: Indicator for whether the resource is considered operational.
+      subnets:
         type: array
         items:
-          $ref: "#/definitions/relationship"
-      sriov-pfs:
+          $ref: "#/getDefinitions/subnet"
+      ctag-assignments:
         type: array
         items:
-          $ref: "#/definitions/sriov-pf"
-      l-interfaces:
+          $ref: "#/getDefinitions/ctag-assignment"
+      segmentation-assignments:
         type: array
         items:
-          $ref: "#/definitions/l-interface"
-  p-interfaces:
-    description: |
-      Collection of physical interfaces.
+          $ref: "#/getDefinitions/segmentation-assignment"
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/getDefinitions/relationship"
+        description: Relates to tenant (or is it a child of tenant), complex, service, vpn-binding
+  l3-networks:
     properties:
-      p-interface:
+      l3-network:
         type: array
         items:          
-          $ref: "#/definitions/p-interface"
+          $ref: "#/getDefinitions/l3-network"
   lag-interface:
     description: |
       Link aggregate interface
-      ###### Default Delete Scope
-      CASCADE_TO_CHILDREN
-      ###### Related Nodes
-      - TO logical-link (Many2Many)
-      - TO lag-link (Many2Many)
-      - TO p-interface (Many2Many)
-      - TO l-interface (comprises lag-interface, Many2Many)
-      - FROM generic-vnf (is composed of lag-interface)
-      - FROM pserver (is composed of lag-interface)
-      - FROM pnf (is composed of lag-interface)
-      - FROM vpls-pe (is composed of lag-interface)
+      ###### Related Nodes
+      - TO generic-vnf( lag-interface org.onap.relationships.inventory.BelongsTo generic-vnf, MANY2ONE)
+      - TO lag-link( lag-interface tosca.relationships.network.LinksTo lag-link, MANY2MANY)
+      - TO logical-link( lag-interface org.onap.relationships.inventory.Uses logical-link, MANY2MANY)
+      - TO p-interface( lag-interface org.onap.relationships.inventory.Uses p-interface, MANY2MANY)
+      - TO pnf( lag-interface tosca.relationships.network.BindsTo pnf, MANY2ONE)
+      - TO pserver( lag-interface tosca.relationships.network.BindsTo pserver, MANY2ONE)
+      - TO vpls-pe( lag-interface tosca.relationships.network.BindsTo vpls-pe, MANY2ONE)
+      - FROM l-interface( l-interface org.onap.relationships.inventory.BelongsTo lag-interface, MANY2ONE)
+      - LAG-INTERFACE is DELETED when these are DELETED L-INTERFACE
+      - LAG-INTERFACE deletion means associated objects of these types are also DELETED:LAG-LINK,LOGICAL-LINK
     required:
     - interface-name
     - in-maint
@@ -40316,11 +64513,11 @@ definitions:
       relationship-list:
         type: array
         items:
-          $ref: "#/definitions/relationship"
+          $ref: "#/getDefinitions/relationship"
       l-interfaces:
         type: array
         items:
-          $ref: "#/definitions/l-interface"
+          $ref: "#/getDefinitions/l-interface"
   lag-interfaces:
     description: |
       Collection of link aggregate interfaces.
@@ -40328,1327 +64525,1596 @@ definitions:
       lag-interface:
         type: array
         items:          
-          $ref: "#/definitions/lag-interface"
-  pserver:
+          $ref: "#/getDefinitions/lag-interface"
+  lag-link:
     description: |
-      Compute host whose hostname must be unique and must exactly match what is sent as a relationship to a vserver.
-      ###### Default Delete Scope
-      ERROR_4_IN_EDGES_OR_CASCADE
-      ###### Related Nodes
-      - TO complex (Many2One)
-      - TO cloud-region (Many2One)
-      - TO availability-zone (Many2One)
-      - TO lag-interface (comprises pserver, Many2Many)
-      - TO p-interface (comprises pserver, Many2Many)
-      - TO zone (Many2One)
-      - FROM generic-vnf
-      - FROM group-assignment
-      - FROM vserver
-      - FROM logical-link
+      LAG links can connect lag-interfaces
+      ###### Related Nodes
+      - FROM lag-interface( lag-interface tosca.relationships.network.LinksTo lag-link, MANY2MANY)
+      - FROM logical-link( logical-link org.onap.relationships.inventory.Uses lag-link, MANY2MANY)
     required:
-    - hostname
+    - link-name
+    properties:
+      link-name:
+        type: string
+        description: Alphabetical concatenation of lag-interface names
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/getDefinitions/relationship"
+  lag-links:
+    description: |
+      Collection of link aggregation connections
+    properties:
+      lag-link:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/lag-link"
+  license:
+    description: |
+      Metadata for license group.
+      ###### Related Nodes
+      - TO generic-vnf( license org.onap.relationships.inventory.BelongsTo generic-vnf, MANY2ONE)
+      - TO vce( license org.onap.relationships.inventory.BelongsTo vce, MANY2ONE)
+    required:
+    - group-uuid
+    - resource-uuid
+    properties:
+      group-uuid:
+        type: string
+        description: Unique ID for the license group the resource belongs to, should be uuid.
+      resource-uuid:
+        type: string
+        description: Unique ID of a license resource. 
+      resource-version:
+        type: string
+        description: Concurrency value
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/getDefinitions/relationship"
+  licenses:
+    description: |
+      Licenses to be allocated across resources, keyed by group-uuid and resource-uuid, related to license management
+    properties:
+      license:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/license"
+  line-of-business:
+    description: |
+      describes a line-of-business
+      ###### Related Nodes
+      - TO generic-vnf( line-of-business org.onap.relationships.inventory.Uses generic-vnf, MANY2MANY)
+    required:
+    - line-of-business-name
+    properties:
+      line-of-business-name:
+        type: string
+        description: Name of the line-of-business (product)
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/getDefinitions/relationship"
+  lines-of-business:
+    description: |
+      Collection of lines-of-business
+    properties:
+      line-of-business:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/line-of-business"
+  logical-link:
+    description: |
+      Logical links generally connect l-interfaces but are used to express logical connectivity between two points
+      ###### Related Nodes
+      - TO cloud-region( logical-link org.onap.relationships.inventory.LocatedIn cloud-region, MANY2MANY)
+      - TO generic-vnf( logical-link org.onap.relationships.inventory.BridgedTo generic-vnf, MANY2MANY)
+      - TO lag-link( logical-link org.onap.relationships.inventory.Uses lag-link, MANY2MANY)
+      - TO logical-link( logical-link org.onap.relationships.inventory.Uses logical-link, MANY2MANY)
+      - TO pnf( logical-link org.onap.relationships.inventory.BridgedTo pnf, MANY2MANY)
+      - TO pserver( logical-link org.onap.relationships.inventory.BridgedTo pserver, MANY2MANY)
+      - TO vpn-binding( logical-link org.onap.relationships.inventory.Uses vpn-binding, MANY2MANY)
+      - TO virtual-data-center( logical-link org.onap.relationships.inventory.LocatedIn virtual-data-center, MANY2MANY)
+      - FROM configuration( configuration org.onap.relationships.inventory.Uses logical-link, ONE2MANY)
+      - FROM lag-interface( lag-interface org.onap.relationships.inventory.Uses logical-link, MANY2MANY)
+      - FROM l-interface( l-interface tosca.relationships.network.LinksTo logical-link, MANY2MANY)
+      - FROM p-interface( p-interface tosca.relationships.network.LinksTo logical-link, MANY2ONE)
+      - FROM service-instance( service-instance org.onap.relationships.inventory.Uses logical-link, ONE2MANY)
+      - FROM vlan( vlan org.onap.relationships.inventory.Uses logical-link, MANY2MANY)
+      - FROM logical-link( logical-link org.onap.relationships.inventory.Uses logical-link, MANY2MANY)
+    required:
+    - link-name
     - in-maint
+    - link-type
     properties:
-      hostname:
+      link-name:
         type: string
-        description: Value from executing hostname on the compute node.
-      ptnii-equip-name:
+        description: e.g., evc-name, or vnf-nameA_interface-nameA_vnf-nameZ_interface-nameZ
+      in-maint:
+        type: boolean
+      link-type:
         type: string
-        description: PTNII name
-      number-of-cpus:
-        type: integer
-        format: int32
-        description: Number of cpus
-      disk-in-gigabytes:
-        type: integer
-        format: int32
-        description: Disk size, in GBs
-      ram-in-megabytes:
-        type: integer
-        format: int32
-        description: RAM size, in MBs
-      equip-type:
+        description: Type of logical link, e.g., evc
+      speed-value:
         type: string
-        description: Equipment type.  Source of truth should define valid values.
-      equip-vendor:
+        description: Captures the numeric part of the speed
+      speed-units:
         type: string
-        description: Equipment vendor.  Source of truth should define valid values.
-      equip-model:
+        description: Captures the units corresponding to the speed
+      ip-version:
         type: string
-        description: Equipment model.  Source of truth should define valid values.
-      fqdn:
+        description: v4, v6, or ds for dual stack
+      routing-protocol:
         type: string
-        description: Fully-qualified domain name
-      pserver-selflink:
+        description: For example, static or BGP
+      resource-version:
         type: string
-        description: URL to endpoint where AAI can get more details
-      ipv4-oam-address:
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      model-invariant-id:
         type: string
-        description: Used to configure device, also used for troubleshooting and is IP used for traps generated by device.
-      serial-number:
+        description: the ASDC model id for this resource or service model.
+      model-version-id:
         type: string
-        description: Serial number, may be queried
-      ipaddress-v4-loopback-0:
+        description: the ASDC model version for this resource or service model.
+      persona-model-version:
         type: string
-        description: IPV4 Loopback 0 address
-      ipaddress-v6-loopback-0:
+        description: the ASDC model version for this resource or service model.
+      widget-model-id:
         type: string
-        description: IPV6 Loopback 0 address
-      ipaddress-v4-aim:
+        description: the ASDC data dictionary widget model. This maps directly to the A&AI widget.
+      widget-model-version:
         type: string
-        description: IPV4 AIM address
-      ipaddress-v6-aim:
+        description: the ASDC data dictionary version of the widget model.This maps directly to the A&AI version of the widget.
+      operational-status:
         type: string
-        description: IPV6 AIM address
-      ipaddress-v6-oam:
+        description: Indication of operational status of the logical link.
+      prov-status:
         type: string
-        description: IPV6 OAM address
-      inv-status:
+        description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems.
+      link-role:
         type: string
-        description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
-      pserver-id:
+        description: Indication of the network use of the logical link.
+      link-name2:
         type: string
-        description: ID of Pserver
-      internet-topology:
+        description: Alias or alternate name (CLCI or D1 name).
+      link-id:
+        type: string
+        description: UUID of the logical-link, SDNC generates this.
+      circuit-id:
+        type: string
+        description: Circuit id
+      purpose:
+        type: string
+        description: Reason for this entity, role it is playing
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/getDefinitions/relationship"
+  logical-links:
+    description: |
+      Collection of logical connections
+    properties:
+      logical-link:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/logical-link"
+  metadata:
+    description: |
+      Collection of metadatum (key/value pairs)
+    properties:
+      metadatum:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/metadatum"
+  metadatum:
+    description: |
+      Key/value pairs
+      ###### Related Nodes
+      - TO configuration( metadatum org.onap.relationships.inventory.BelongsTo configuration, MANY2ONE)
+      - TO connector( metadatum org.onap.relationships.inventory.BelongsTo connector, MANY2ONE)
+      - TO image( metadatum org.onap.relationships.inventory.BelongsTo image, MANY2ONE)
+      - TO service-instance( metadatum org.onap.relationships.inventory.BelongsTo service-instance, MANY2ONE)
+      - TO model-ver( metadatum org.onap.relationships.inventory.BelongsTo model-ver, MANY2ONE)
+    required:
+    - metaname
+    - metaval
+    properties:
+      metaname:
+        type: string
+      metaval:
         type: string
-        description: internet topology of Pserver
-      in-maint:
-        type: boolean
       resource-version:
         type: string
         description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
-      pserver-name2:
+  model:
+    description: |
+      Subgraph definition provided by ASDC to describe an inventory asset and its connections related to ASDC models, independent of version
+      ###### Related Nodes
+      - TO model( model-ver org.onap.relationships.inventory.BelongsTo model, MANY2ONE)
+      - FROM instance-group( instance-group org.onap.relationships.inventory.Targets model, MANY2MANY)
+      - FROM model-ver( model-ver org.onap.relationships.inventory.BelongsTo model, MANY2ONE)
+      - FROM named-query( named-query org.onap.relationships.inventory.AppliesTo model, ONE2MANY)
+      - FROM named-query-element( named-query-element org.onap.relationships.inventory.IsA model, MANY2ONE)
+      - MODEL cannot be deleted if linked to INSTANCE-GROUP,NAMED-QUERY,NAMED-QUERY-ELEMENT
+      - MODEL is DELETED when these are DELETED MODEL-VER
+    required:
+    - model-invariant-id
+    - model-type
+    properties:
+      model-invariant-id:
         type: string
-        description: alternative pserver name
-      purpose:
+        description: Unique identifier corresponding to the main definition of a model in ASDC
+      model-type:
         type: string
-        description: purpose of pserver
-      prov-status:
+        description: Type of the model, e.g., service, resource, widget, etc.
+      resource-version:
         type: string
-        description: Prov Status of this device (not under canopi control) Valid values [PREPROV/NVTPROV/PROV]
-      management-option:
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      model-vers:
+        type: array
+        items:
+          $ref: "#/getDefinitions/model-ver"
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/getDefinitions/relationship"
+  model-and-named-query-search:
+    description: |
+      ModelAndNamedQuerySearch holds query-parameters and instance-properties for performing a named-query or model query
+    properties:
+      query-parameters:
+        type: object
+        $ref: "#/getDefinitions/query-parameters"
+      instance-filters:
+        type: object
+        $ref: "#/getDefinitions/instance-filters"
+      secondary-filts:
+        type: object
+        $ref: "#/getDefinitions/secondary-filts"
+      top-node-type:
         type: string
-        description: Indicates who owns and or manages the device.
-      host-profile:
+      secondary-filter-cut-point:
+        type: string
+  model-constraint:
+    description: |
+      This is how we would capture constraints defining allowed sets of elements.
+      ###### Related Nodes
+      - TO model-element( model-constraint org.onap.relationships.inventory.BelongsTo model-element, MANY2ONE)
+      - FROM constrained-element-set( constrained-element-set org.onap.relationships.inventory.BelongsTo model-constraint, MANY2ONE)
+      - MODEL-CONSTRAINT is DELETED when these are DELETED CONSTRAINED-ELEMENT-SET
+    required:
+    - model-constraint-uuid
+    - constrained-element-set-uuid-to-replace
+    properties:
+      model-constraint-uuid:
+        type: string
+      constrained-element-set-uuid-to-replace:
         type: string
-        description: The host profile that defines the configuration of the pserver.
-      relationship-list:
-        type: array
-        items:
-          $ref: "#/definitions/relationship"
-      p-interfaces:
-        type: array
-        items:
-          $ref: "#/definitions/p-interface"
-      lag-interfaces:
+      constrained-element-sets:
         type: array
         items:
-          $ref: "#/definitions/lag-interface"
-  pservers:
-    description: |
-      Collection of compute hosts.
+          $ref: "#/getDefinitions/constrained-element-set"
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+  model-constraints:
     properties:
-      pserver:
+      model-constraint:
         type: array
         items:          
-          $ref: "#/definitions/pserver"
-  virtual-data-center:
+          $ref: "#/getDefinitions/model-constraint"
+  model-element:
     description: |
-      Virtual organization of cloud infrastructure elements in a data center context
-      ###### Default Delete Scope
-      CASCADE_TO_CHILDREN
+      Defines how other models combine to make up a higher-level model.
       ###### Related Nodes
-      - TO generic-vnf (Many2Many)
-      - TO logical-link (Many2Many)
-      - FROM connector
+      - TO element-choice-set( model-element org.onap.relationships.inventory.BelongsTo element-choice-set, MANY2ONE)
+      - TO model-element( model-element org.onap.relationships.inventory.BelongsTo model-element, MANY2ONE)
+      - TO model-ver( model-element org.onap.relationships.inventory.IsA model-ver, MANY2ONE)
+      - TO model-ver( model-element org.onap.relationships.inventory.BelongsTo model-ver, MANY2ONE)
+      - FROM constrained-element-set( constrained-element-set org.onap.relationships.inventory.BelongsTo model-element, MANY2ONE)
+      - FROM model-constraint( model-constraint org.onap.relationships.inventory.BelongsTo model-element, MANY2ONE)
+      - FROM model-element( model-element org.onap.relationships.inventory.BelongsTo model-element, MANY2ONE)
+      - MODEL-ELEMENT is DELETED when these are DELETED CONSTRAINED-ELEMENT-SET,MODEL-CONSTRAINT
     required:
-    - vdc-id
-    - vdc-name
+    - model-element-uuid
+    - new-data-del-flag
+    - cardinality
     properties:
-      vdc-id:
+      model-element-uuid:
         type: string
-        description: Unique ID of the vdc
-      vdc-name:
+      new-data-del-flag:
+        type: string
+        description: Indicates whether this element was created as part of instantiation from this model
+      cardinality:
+        type: string
+        description: How many of this type of element are required/allowed
+      linkage-points:
         type: string
-        description: Name of the virtual data center
       resource-version:
         type: string
         description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
-      relationship-list:
-        type: array
-        items:
-          $ref: "#/definitions/relationship"
-  virtual-data-centers:
-    description: |
-      Virtual organization of cloud infrastructure elements in a data center context
-    properties:
-      virtual-data-center:
-        type: array
-        items:          
-          $ref: "#/definitions/virtual-data-center"
-  cloud-infrastructure:
-    description: |
-      Namespace for cloud infrastructure.
-    properties:
-      complexes:
-        type: array
-        items:
-          $ref: "#/definitions/complex"
-      cloud-regions:
+      model-elements:
         type: array
         items:
-          $ref: "#/definitions/cloud-region"
-      network-profiles:
+          $ref: "#/getDefinitions/model-element"
+        description: Defines how other models combine to make up a higher-level model
+      model-constraints:
         type: array
         items:
-          $ref: "#/definitions/network-profile"
-      pservers:
+          $ref: "#/getDefinitions/model-constraint"
+        description: Describes new constraints on this model element that are not part of that model's definition
+      relationship-list:
         type: array
         items:
-          $ref: "#/definitions/pserver"
-      virtual-data-centers:
+          $ref: "#/getDefinitions/relationship"
+  model-elements:
+    properties:
+      model-element:
         type: array
-        items:
-          $ref: "#/definitions/virtual-data-center"
-  connector:
+        items:          
+          $ref: "#/getDefinitions/model-element"
+  model-ver:
     description: |
-      Collection of resource instances used to connect a variety of disparate inventory widgets
-      ###### Default Delete Scope
-      CASCADE_TO_CHILDREN
+      Subgraph definition provided by ASDC to describe a specific version of an inventory asset and its connections related to ASDC models
       ###### Related Nodes
-      - TO virtual-data-center (Many2Many)
-      - TO metadatum (comprises connector, Many2Many)
-      - FROM service-instance
+      - TO model( model-ver org.onap.relationships.inventory.BelongsTo model, MANY2ONE)
+      - FROM model-element( model-element org.onap.relationships.inventory.IsA model-ver, MANY2ONE)
+      - FROM model-element( model-element org.onap.relationships.inventory.BelongsTo model-ver, MANY2ONE)
+      - FROM metadatum( metadatum org.onap.relationships.inventory.BelongsTo model-ver, MANY2ONE)
+      - MODEL-VER cannot be deleted if linked to MODEL-ELEMENT
+      - MODEL-VER is DELETED when these are DELETED MODEL-ELEMENT,METADATUM
     required:
-    - resource-instance-id
+    - model-version-id
+    - model-name
+    - model-version
     properties:
-      resource-instance-id:
-        type: string
-        description: Unique id of resource instance.
-      resource-version:
-        type: string
-        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
-      model-invariant-id:
-        type: string
-        description: the ASDC model id for this resource or service model.
       model-version-id:
         type: string
-        description: the ASDC model version for this resource or service model.
-      persona-model-version:
+        description: Unique identifier corresponding to one version of a model in ASDC
+      model-name:
         type: string
-        description: the ASDC model version for this resource or service model.
-      widget-model-id:
+        description: Name of the model, which can change from version to version.
+      model-version:
         type: string
-        description: the ASDC data dictionary widget model. This maps directly to the A&AI widget.
-      widget-model-version:
+        description: Version
+      model-description:
         type: string
-        description: the ASDC data dictionary version of the widget model.This maps directly to the A&AI version of the widget.
-      relationship-list:
+        description: Description
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      model-elements:
         type: array
         items:
-          $ref: "#/definitions/relationship"
+          $ref: "#/getDefinitions/model-element"
       metadata:
         type: array
         items:
-          $ref: "#/definitions/metadatum"
-  connectors:
+          $ref: "#/getDefinitions/metadatum"
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/getDefinitions/relationship"
+  model-vers:
+    properties:
+      model-ver:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/model-ver"
+  models:
     description: |
-      Collection of resource instances used to connect a variety of disparate inventory widgets
+      Collection of subgraph definitions provided by ASDC to describe the inventory assets and their connections related to ASDC models
     properties:
-      connector:
+      model:
         type: array
         items:          
-          $ref: "#/definitions/connector"
-  tunnel-xconnect:
+          $ref: "#/getDefinitions/model"
+  multicast-configuration:
     description: |
-      Represents the specifics of a tunnel cross connect piece of a resource that gets separately allotted
-      ###### Default Delete Scope
-      THIS_NODE_ONLY
       ###### Related Nodes
-      - FROM allotted-resource (is composed of tunnel-xconnect)
+      - FROM vlan( vlan org.onap.relationships.inventory.Uses multicast-configuration, MANY2MANY)
     required:
-    - id
-    - bandwidth-up-wan1
-    - bandwidth-down-wan1
-    - bandwidth-up-wan2
-    - bandwidth-down-wan2
+    - multicast-configuration-id
+    - multicast-protocol
+    - rp-type
     properties:
-      id:
-        type: string
-        description: Allotted Resource id UUID assigned to this instance.
-      bandwidth-up-wan1:
-        type: string
-        description: The WAN uplink bandwidth for WAN1
-      bandwidth-down-wan1:
+      multicast-configuration-id:
         type: string
-        description: The WAN downlink bandwidth for WAN1
-      bandwidth-up-wan2:
+        description: Unique id of multicast configuration.
+      multicast-protocol:
         type: string
-        description: The WAN uplink bandwidth for WAN2
-      bandwidth-down-wan2:
+        description: protocol of multicast configuration
+      rp-type:
         type: string
-        description: The WAN downlink bandwidth for WAN2
+        description: rp type of multicast configuration
       resource-version:
         type: string
-        description: Concurrency value
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
       relationship-list:
         type: array
         items:
-          $ref: "#/definitions/relationship"
-  tunnel-xconnects:
+          $ref: "#/getDefinitions/relationship"
+  multicast-configurations:
     description: |
-      This object is used to store the specific tunnel cross connect aspects of an allotted resource
+      multicast configuration of generic-vnf ip-address
     properties:
-      tunnel-xconnect:
+      multicast-configuration:
         type: array
         items:          
-          $ref: "#/definitions/tunnel-xconnect"
-  allotted-resource:
+          $ref: "#/getDefinitions/multicast-configuration"
+  named-queries:
+    properties:
+      named-query:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/named-query"
+  named-query:
     description: |
-      Represents a slice or partial piece of a resource that gets separately allotted
-      ###### Default Delete Scope
-      CASCADE_TO_CHILDREN
-      ###### Related Nodes
-      - TO generic-vnf (Many2Many)
-      - TO l3-network (Many2Many)
-      - TO instance-group (Many2Many)
-      - TO network-policy (One2One)
-      - TO vlan (Many2Many)
-      - TO l-interface (One2Many)
-      - TO tunnel-xconnect (comprises allotted-resource, One2One)
-      - TO vpn-binding (Many2Many)
-      - TO allotted-resource (One2One)
-      - FROM service-instance (is composed of allotted-resource)
-      - FROM service-instance
-      - FROM allotted-resource
+      TBD
+      ###### Related Nodes
+      - TO named-query( named-query-element org.onap.relationships.inventory.BelongsTo named-query, ONE2ONE)
+      - TO model( named-query org.onap.relationships.inventory.AppliesTo model, ONE2MANY)
+      - FROM named-query-element( named-query-element org.onap.relationships.inventory.BelongsTo named-query, ONE2ONE)
+      - NAMED-QUERY is DELETED when these are DELETED NAMED-QUERY-ELEMENT
     required:
-    - id
+    - named-query-uuid
+    - named-query-name
+    - named-query-version
     properties:
-      id:
-        type: string
-        description: Allotted Resource id UUID assigned to this instance.
-      description:
+      named-query-uuid:
         type: string
-        description: The descriptive information assigned to this allotted resource instance
-      selflink:
+      named-query-name:
         type: string
-        description: Link back to more information in the controller
-      model-invariant-id:
+      named-query-version:
         type: string
-        description: the ASDC model id for this resource or service model.
-      model-version-id:
+      required-input-param:
         type: string
-        description: the ASDC model version for this resource or service model.
-      persona-model-version:
+      description:
         type: string
-        description: the ASDC model version for this resource or service model.
       resource-version:
         type: string
-        description: Concurrency value
-      orchestration-status:
-        type: string
-        description: Orchestration status
-      operational-status:
-        type: string
-        description: Indicator for whether the resource is considered operational
-      type:
-        type: string
-        description: Generic description of the type of allotted resource.
-      role:
-        type: string
-        description: role in the network that this resource will be providing.
-      tunnel-xconnects:
+      named-query-elements:
         type: array
         items:
-          $ref: "#/definitions/tunnel-xconnect"
+          $ref: "#/getDefinitions/named-query-element"
       relationship-list:
         type: array
         items:
-          $ref: "#/definitions/relationship"
-  allotted-resources:
-    description: |
-      This object is used to store slices of services being offered
-    properties:
-      allotted-resource:
-        type: array
-        items:          
-          $ref: "#/definitions/allotted-resource"
-  service-instance:
+          $ref: "#/getDefinitions/relationship"
+  named-query-element:
     description: |
-      Instance of a service
-      ###### Default Delete Scope
-      CASCADE_TO_CHILDREN
-      ###### Related Nodes
-      - TO zone (Many2One)
-      - TO cvlan-tag (Many2Many)
-      - TO pnf (One2Many)
-      - TO connector (Many2Many)
-      - TO metadatum (comprises service-instance, Many2Many)
-      - TO logical-link (Many2Many)
-      - TO vlan (One2Many)
-      - TO service-instance (One2Many)
-      - TO ctag-assignment (One2Many)
-      - TO instance-group (Many2Many)
-      - TO allotted-resource (comprises service-instance, Many2Many)
-      - TO allotted-resource (Many2Many)
-      - FROM generic-vnf
-      - FROM l3-network
-      - FROM service-subscription (is composed of service-instance)
-      - FROM vce
-      - FROM service-instance
+      TBD
+      ###### Related Nodes
+      - TO named-query( named-query-element org.onap.relationships.inventory.BelongsTo named-query, ONE2ONE)
+      - TO model( named-query-element org.onap.relationships.inventory.IsA model, MANY2ONE)
+      - TO named-query-element( named-query-element org.onap.relationships.inventory.BelongsTo named-query-element, MANY2ONE)
+      - FROM property-constraint( property-constraint org.onap.relationships.inventory.BelongsTo named-query-element, MANY2ONE)
+      - FROM related-lookup( related-lookup org.onap.relationships.inventory.BelongsTo named-query-element, MANY2ONE)
+      - FROM named-query-element( named-query-element org.onap.relationships.inventory.BelongsTo named-query-element, MANY2ONE)
+      - NAMED-QUERY-ELEMENT is DELETED when these are DELETED PROPERTY-CONSTRAINT,RELATED-LOOKUP
     required:
-    - service-instance-id
-    - service-type
-    - service-role
+    - named-query-element-uuid
     properties:
-      service-instance-id:
-        type: string
-        description: Uniquely identifies this instance of a service
-      service-instance-name:
-        type: string
-        description: This field will store a name assigned to the service-instance.
-      service-type:
-        type: string
-        description: String capturing type of service.
-      service-role:
-        type: string
-        description: String capturing the service role.
-      environment-context:
-        type: string
-        description: This field will store the environment context assigned to the service-instance.
-      workload-context:
-        type: string
-        description: This field will store the workload context assigned to the service-instance.
-      model-invariant-id:
-        type: string
-        description: the ASDC model id for this resource or service model.
-      model-version-id:
-        type: string
-        description: the ASDC model version for this resource or service model.
-      persona-model-version:
-        type: string
-        description: the ASDC model version for this resource or service model.
-      widget-model-id:
-        type: string
-        description: the ASDC data dictionary widget model. This maps directly to the A&AI widget.
-      widget-model-version:
-        type: string
-        description: the ASDC data dictionary version of the widget model.This maps directly to the A&AI version of the widget.
-      bandwidth-total:
-        type: string
-        description: Indicates the total bandwidth to be used for this service.
-      bandwidth-up-wan1:
-        type: string
-        description: indicates the upstream bandwidth this service will use on the WAN1 port of the physical device.
-      bandwidth-down-wan1:
-        type: string
-        description: indicates the downstream bandwidth this service will use on the WAN1 port of the physical device.
-      bandwidth-up-wan2:
-        type: string
-        description: indicates the upstream bandwidth this service will use on the WAN2 port of the physical device.
-      bandwidth-down-wan2:
-        type: string
-        description: indicates the downstream bandwidth this service will use on the WAN2 port of the physical device.
-      vhn-portal-url:
+      named-query-element-uuid:
         type: string
-        description: URL customers will use to access the vHN Portal.
-      service-instance-location-id:
+      property-collect-list:
         type: string
-        description: An identifier that customers assign to the location where this service is being used.
       resource-version:
         type: string
-        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
-      selflink:
+      property-limit-desc:
         type: string
-        description: Path to the controller object.
-      orchestration-status:
+      do-not-output:
         type: string
-        description: Orchestration status of this service.
-      relationship-list:
+      named-query-elements:
         type: array
         items:
-          $ref: "#/definitions/relationship"
-      metadata:
+          $ref: "#/getDefinitions/named-query-element"
+      related-lookups:
         type: array
         items:
-          $ref: "#/definitions/metadatum"
-      allotted-resources:
+          $ref: "#/getDefinitions/related-lookup"
+      property-constraints:
         type: array
         items:
-          $ref: "#/definitions/allotted-resource"
-  service-instances:
+          $ref: "#/getDefinitions/property-constraint"
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/getDefinitions/relationship"
+  named-query-elements:
+    properties:
+      named-query-element:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/named-query-element"
+  network:
     description: |
-      Collection of service instances
+      Namespace for network inventory resources.
     properties:
-      service-instance:
+      logical-links:
+        type: array
+        items:
+          $ref: "#/getDefinitions/logical-link"
+      site-pair-sets:
+        type: array
+        items:
+          $ref: "#/getDefinitions/site-pair-set"
+      vpn-bindings:
+        type: array
+        items:
+          $ref: "#/getDefinitions/vpn-binding"
+      vpls-pes:
+        type: array
+        items:
+          $ref: "#/getDefinitions/vpls-pe"
+      multicast-configurations:
+        type: array
+        items:
+          $ref: "#/getDefinitions/multicast-configuration"
+      vces:
+        type: array
+        items:
+          $ref: "#/getDefinitions/vce"
+      vnfcs:
+        type: array
+        items:
+          $ref: "#/getDefinitions/vnfc"
+      l3-networks:
+        type: array
+        items:
+          $ref: "#/getDefinitions/l3-network"
+      network-policies:
+        type: array
+        items:
+          $ref: "#/getDefinitions/network-policy"
+      generic-vnfs:
+        type: array
+        items:
+          $ref: "#/getDefinitions/generic-vnf"
+      lag-links:
+        type: array
+        items:
+          $ref: "#/getDefinitions/lag-link"
+      newvces:
+        type: array
+        items:
+          $ref: "#/getDefinitions/newvce"
+      pnfs:
+        type: array
+        items:
+          $ref: "#/getDefinitions/pnf"
+      physical-links:
+        type: array
+        items:
+          $ref: "#/getDefinitions/physical-link"
+      ipsec-configurations:
+        type: array
+        items:
+          $ref: "#/getDefinitions/ipsec-configuration"
+      route-table-references:
+        type: array
+        items:
+          $ref: "#/getDefinitions/route-table-reference"
+      instance-groups:
+        type: array
+        items:
+          $ref: "#/getDefinitions/instance-group"
+      zones:
+        type: array
+        items:
+          $ref: "#/getDefinitions/zone"
+      configurations:
+        type: array
+        items:
+          $ref: "#/getDefinitions/configurations"
+  network-policies:
+    properties:
+      network-policy:
         type: array
         items:          
-          $ref: "#/definitions/service-instance"
-  service-subscription:
+          $ref: "#/getDefinitions/network-policy"
+  network-policy:
     description: |
-      Object that group service instances.
-      ###### Default Delete Scope
-      CASCADE_TO_CHILDREN
       ###### Related Nodes
-      - TO service-instance (comprises service-subscription, Many2Many)
-      - FROM customer (is composed of service-subscription)
-      - FROM tenant
+      - FROM allotted-resource( allotted-resource org.onap.relationships.inventory.Uses network-policy, ONE2ONE)
+      - FROM l3-network( l3-network org.onap.relationships.inventory.Uses network-policy, MANY2MANY)
     required:
-    - service-type
+    - network-policy-id
     properties:
-      service-type:
+      network-policy-id:
         type: string
-        description: Value defined by orchestration to identify this service across ECOMP.
-      temp-ub-sub-account-id:
+        description: UUID representing unique key to this instance
+      network-policy-fqdn:
         type: string
-        description: This property will be deleted from A&AI in the near future. Only stop gap solution.
+        description: Contrail FQDN for the policy
+      heat-stack-id:
+        type: string
+        description: ID for the openStack Heat instance
       resource-version:
         type: string
         description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
-      service-instances:
-        type: array
-        items:
-          $ref: "#/definitions/service-instance"
       relationship-list:
         type: array
         items:
-          $ref: "#/definitions/relationship"
-  service-subscriptions:
-    description: |
-      Collection of objects that group service instances.
-    properties:
-      service-subscription:
-        type: array
-        items:          
-          $ref: "#/definitions/service-subscription"
-  customer:
+          $ref: "#/getDefinitions/relationship"
+  network-profile:
     description: |
-      customer identifiers to provide linkage back to BSS information.
-      ###### Default Delete Scope
-      CASCADE_TO_CHILDREN
+      Network profile populated by SDN-GP for SNMP
       ###### Related Nodes
-      - TO service-subscription (comprises customer, Many2Many)
+      - TO generic-vnf( network-profile org.onap.relationships.inventory.AppliesTo generic-vnf, MANY2MANY)
     required:
-    - global-customer-id
-    - subscriber-name
-    - subscriber-type
+    - nm-profile-name
     properties:
-      global-customer-id:
-        type: string
-        description: Global customer id used across ECOMP to uniquely identify customer.
-      subscriber-name:
+      nm-profile-name:
         type: string
-        description: Subscriber name, an alternate way to retrieve a customer.
-      subscriber-type:
+        description: Unique name of network profile.
+      community-string:
         type: string
-        description: Subscriber type, a way to provide VID with only the INFRA customers.
+        description: Encrypted SNMP community string
       resource-version:
         type: string
         description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
-      service-subscriptions:
-        type: array
-        items:
-          $ref: "#/definitions/service-subscription"
       relationship-list:
         type: array
         items:
-          $ref: "#/definitions/relationship"
-  customers:
+          $ref: "#/getDefinitions/relationship"
+  network-profiles:
     description: |
-      Collection of customer identifiers to provide linkage back to BSS information.
+      Collection of network profiles
     properties:
-      customer:
+      network-profile:
         type: array
         items:          
-          $ref: "#/definitions/customer"
-  business:
-    description: |
-      Namespace for business related constructs
-    properties:
-      connectors:
-        type: array
-        items:
-          $ref: "#/definitions/connector"
-      customers:
-        type: array
-        items:
-          $ref: "#/definitions/customer"
-  vnf-image:
+          $ref: "#/getDefinitions/network-profile"
+  newvce:
     description: |
-      Image object that pertain to a VNF that doesn't have associated vservers.  This is a kludge.
-      ###### Default Delete Scope
-      ERROR_IF_ANY_IN_EDGES
+      This object fills in the gaps from vce that were incorporated into generic-vnf.  This object will be retired with vce.
       ###### Related Nodes
-      - FROM generic-vnf
+      - FROM l-interface( l-interface org.onap.relationships.inventory.BelongsTo newvce, MANY2ONE)
+      - NEWVCE is DELETED when these are DELETED L-INTERFACE
     required:
-    - vnf-image-uuid
-    - application
-    - application-vendor
+    - vnf-id2
+    - vnf-name
+    - vnf-type
     properties:
-      vnf-image-uuid:
+      vnf-id2:
         type: string
-        description: Unique ID of this asset
-      application:
+        description: Unique id of VNF, can't use same attribute name right now until we promote this new object
+      vnf-name:
         type: string
-        description: The application that the image instantiates.
-      application-vendor:
+        description: Name of VNF.
+      vnf-name2:
         type: string
-        description: The vendor of the application.
-      application-version:
+        description: Alternate name of VNF.
+      vnf-type:
         type: string
-        description: The version of the application.
-      selflink:
+        description: String capturing type of vnf, that was intended to identify the ASDC resource.  This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures.
+      prov-status:
         type: string
-        description: URL to endpoint where AAI can get more details
+        description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems.
+      operational-status:
+        type: string
+        description: Indicator for whether the resource is considered operational
+      license-key:
+        type: string
+        description: OBSOLETE -  do not use
+      ipv4-oam-address:
+        type: string
+        description: Address tail-f uses to configure generic-vnf, also used for troubleshooting and is IP used for traps generated by GenericVnf (v4-loopback0-ip-address).
+      equipment-role:
+        type: string
+        description: Client should send valid enumerated value.
       resource-version:
         type: string
         description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      ipv4-loopback0-address:
+        type: string
+        description: v4 Loopback0 address
+      orchestration-status:
+        type: string
+        description: Orchestration status of this VNF, mastered by MSO.
+      heat-stack-id:
+        type: string
+        description: Heat stack id corresponding to this instance, managed by MSO
+      mso-catalog-key:
+        type: string
+        description: Corresponds to the SDN-C catalog id used to configure this VCE
       relationship-list:
         type: array
         items:
-          $ref: "#/definitions/relationship"
-  vnf-images:
+          $ref: "#/getDefinitions/relationship"
+      l-interfaces:
+        type: array
+        items:
+          $ref: "#/getDefinitions/l-interface"
+  newvces:
     description: |
-      Collection of image objects that pertain to a VNF that doesn't have associated vservers.  This is a kludge.
+      This object fills in the gaps from vce that were incorporated into generic-vnf.  This object will be retired with vce.
     properties:
-      vnf-image:
+      newvce:
         type: array
         items:          
-          $ref: "#/definitions/vnf-image"
-  service:
-    description: |
-      Stand-in for service model definitions.  Likely to be deprecated in favor of models from ASDC.  Does not strictly map to ASDC services.
-      ###### Default Delete Scope
-      ERROR_IF_ANY_IN_EDGES
-    required:
-    - service-id
-    - service-description
+          $ref: "#/getDefinitions/newvce"
+  notification-event:
     properties:
-      service-id:
+      cambria.partition:
         type: string
-        description: This gets defined by others to provide a unique ID for the service, we accept what is sent.
-      service-description:
+      notification-event-header:
+        type: object
+        $ref: "#/getDefinitions/notification-event-header"
+  notification-event-header:
+    properties:
+      id:
         type: string
-        description: Description of the service
-      service-selflink:
+      timestamp:
         type: string
-        description: URL to endpoint where AAI can get more details
-      resource-version:
+      source-name:
         type: string
-        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
-      service-version:
+      domain:
         type: string
-        description: service version
-      relationship-list:
-        type: array
-        items:
-          $ref: "#/definitions/relationship"
-  services:
-    description: |
-      Collection of service model definitions.  Likely to be deprecated in favor of models from ASDC.
+      sequence-number:
+        type: string
+      severity:
+        type: string
+      event-type:
+        type: string
+      version:
+        type: string
+      action:
+        type: string
+      entity-type:
+        type: string
+      top-entity-type:
+        type: string
+      entity-link:
+        type: string
+      status:
+        type: string
+  notify:
+    required:
+    - event-id
     properties:
-      service:
+      event-id:
+        type: string
+      node-type:
+        type: string
+      event-trigger:
+        type: string
+      key-data:
         type: array
         items:          
-          $ref: "#/definitions/service"
-  service-capability:
+          $ref: "#/getDefinitions/key-data"
+      selflink:
+        type: string
+  oam-network:
     description: |
-      Early definition of server/resource pairings, likely to be replaced by models.  No new use should be made of this.
-      ###### Default Delete Scope
-      ERROR_IF_ANY_IN_EDGES
+      OAM network, to be deprecated shortly.  Do not use for new purposes. 
       ###### Related Nodes
-      - FROM availability-zone
-      - FROM oam-network
+      - TO cloud-region( oam-network org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE)
+      - TO complex( oam-network org.onap.relationships.inventory.AppliesTo complex, MANY2MANY)
+      - TO service-capability( oam-network org.onap.relationships.inventory.AppliesTo service-capability, MANY2MANY)
     required:
-    - service-type
-    - vnf-type
+    - network-uuid
+    - network-name
+    - cvlan-tag
     properties:
-      service-type:
+      network-uuid:
         type: string
-        description: This gets defined by others to provide a unique ID for the service, we accept what is sent.
-      vnf-type:
+        description: UUID of the network. Unique across a cloud-region
+      network-name:
         type: string
-        description: String capturing type of vnf, that was intended to identify the ASDC resource.  This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures.
+        description: Name of the network.
+      cvlan-tag:
+        type: integer
+        format: int64
+        description: cvlan-id
+      ipv4-oam-gateway-address:
+        type: string
+        description: Used for VNF firewall rule so customer cannot send customer traffic over this oam network
+      ipv4-oam-gateway-address-prefix-length:
+        type: integer
+        format: int32
+        description: Used for VNF firewall rule so customer cannot send customer traffic over this oam network
       resource-version:
         type: string
         description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
       relationship-list:
         type: array
         items:
-          $ref: "#/definitions/relationship"
-  service-capabilities:
+          $ref: "#/getDefinitions/relationship"
+  oam-networks:
     description: |
-      Collection of service capabilities.
+      Collection of OAM networks, to be deprecated shortly.  Do not use for new purposes. 
     properties:
-      service-capability:
+      oam-network:
         type: array
         items:          
-          $ref: "#/definitions/service-capability"
-  element-choice-set:
+          $ref: "#/getDefinitions/oam-network"
+  operational-environment:
     description: |
-      This is how we would capture constraints defining allowed sets of elements.
-      ###### Default Delete Scope
-      CASCADE_TO_CHILDREN
+      It is a logical partition of the cloud which allows to have multiple environments in the production AIC.
       ###### Related Nodes
-      - TO model-element (comprises element-choice-set, One2Many)
-      - FROM constrained-element-set (is composed of element-choice-set)
+      - TO operational-environment( operational-environment org.onap.relationships.inventory.Uses operational-environment, ONE2ONE)
+      - FROM operational-environment( operational-environment org.onap.relationships.inventory.Uses operational-environment, ONE2ONE)
     required:
-    - element-choice-set-uuid
-    - element-choice-set-name
+    - operational-environment-id
+    - operational-environment-name
+    - operational-environment-type
+    - operational-environment-status
+    - tenant-context
+    - workload-context
     properties:
-      element-choice-set-uuid:
+      operational-environment-id:
         type: string
-      element-choice-set-name:
+        description: UUID of an operational environment
+      operational-environment-name:
         type: string
-      cardinality:
+        description: Operational Environment name
+      operational-environment-type:
+        type: string
+        description: Operational Environment Type.
+      operational-environment-status:
+        type: string
+        description: Status
+      tenant-context:
+        type: string
+        description: Tenant Context.
+      workload-context:
         type: string
+        description: Workload Context.
       resource-version:
         type: string
-      model-elements:
-        type: array
-        items:
-          $ref: "#/definitions/model-element"
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
       relationship-list:
         type: array
         items:
-          $ref: "#/definitions/relationship"
-  element-choice-sets:
+          $ref: "#/getDefinitions/relationship"
+  operational-environments:
+    description: |
+      a logical partition of the cloud which allows to have multiple environments in the production AIC.
     properties:
-      element-choice-set:
+      operational-environment:
         type: array
         items:          
-          $ref: "#/definitions/element-choice-set"
-  constrained-element-set:
+          $ref: "#/getDefinitions/operational-environment"
+  overloaded-model:
     description: |
-      This is how we would capture constraints defining allowed sets of elements.
-      ###### Default Delete Scope
-      CASCADE_TO_CHILDREN
-      ###### Related Nodes
-      - TO element-choice-set (comprises constrained-element-set, One2Many)
-      - FROM model-element (is composed of constrained-element-set)
-      - FROM model-constraint (is composed of constrained-element-set)
+      Allows for legacy POST of old-style and new-style models
     required:
-    - constrained-element-set-uuid
-    - constraint-type
-    - check-type
+    - model-invariant-id
+    - model-name-version-id
+    - model-type
+    - model-name
+    - model-id
+    - model-version
     properties:
-      constrained-element-set-uuid:
+      model-invariant-id:
         type: string
-      constraint-type:
+        description: Unique identifier corresponding to the main definition of a model in ASDC
+      model-name-version-id:
         type: string
-      check-type:
+        description: Unique identifier corresponding to one version of a model in ASDC
+      model-type:
+        type: string
+        description: Type of the model, e.g., service, resource, widget, etc.
+      model-name:
+        type: string
+        description: Name of the model, which can change from version to version.
+      model-id:
+        type: string
+        description: Invariant unique ID which does not change from version to version
+      model-version:
+        type: string
+        description: Version
+      model-description:
         type: string
+        description: Description
       resource-version:
         type: string
-      element-choice-sets:
-        type: array
-        items:
-          $ref: "#/definitions/element-choice-set"
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      model-vers:
+        type: object
+        $ref: "#/getDefinitions/model-vers"
       relationship-list:
-        type: array
-        items:
-          $ref: "#/definitions/relationship"
-  constrained-element-sets:
+        type: object
+        $ref: "#/getDefinitions/relationship-list"
+  owning-entities:
+    description: |
+      Collection of owning-entities
     properties:
-      constrained-element-set:
+      owning-entity:
         type: array
         items:          
-          $ref: "#/definitions/constrained-element-set"
-  model-constraint:
+          $ref: "#/getDefinitions/owning-entity"
+  owning-entity:
     description: |
-      This is how we would capture constraints defining allowed sets of elements.
-      ###### Default Delete Scope
-      CASCADE_TO_CHILDREN
+      describes an owning-entity
       ###### Related Nodes
-      - TO constrained-element-set (comprises model-constraint, One2Many)
-      - FROM model-element (is composed of model-constraint)
+      - FROM service-instance( service-instance org.onap.relationships.inventory.BelongsTo owning-entity, MANY2ONE)
     required:
-    - model-constraint-uuid
-    - constrained-element-set-uuid-to-replace
+    - owning-entity-id
+    - owning-entity-name
     properties:
-      model-constraint-uuid:
+      owning-entity-id:
         type: string
-      constrained-element-set-uuid-to-replace:
+        description: UUID of an owning entity
+      owning-entity-name:
         type: string
-      constrained-element-sets:
-        type: array
-        items:
-          $ref: "#/definitions/constrained-element-set"
+        description: Owning entity name
       resource-version:
         type: string
         description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
-  model-constraints:
-    properties:
-      model-constraint:
+      relationship-list:
         type: array
-        items:          
-          $ref: "#/definitions/model-constraint"
-  model-element:
+        items:
+          $ref: "#/getDefinitions/relationship"
+  p-interface:
     description: |
-      Defines how other models combine to make up a higher-level model.
-      ###### Default Delete Scope
-      CASCADE_TO_CHILDREN
+      Physical interface (e.g., nic)
       ###### Related Nodes
-      - TO model-ver (Many2One)
-      - TO model-element (comprises model-element, One2Many)
-      - TO model-constraint (comprises model-element, One2Many)
-      - TO constrained-element-set (comprises model-element, One2Many)
-      - FROM model-ver (is composed of model-element)
-      - FROM element-choice-set (is composed of model-element)
-      - FROM model-element (is composed of model-element)
+      - TO logical-link( p-interface tosca.relationships.network.LinksTo logical-link, MANY2ONE)
+      - TO physical-link( p-interface tosca.relationships.network.LinksTo physical-link, MANY2ONE)
+      - TO pnf( p-interface tosca.relationships.network.BindsTo pnf, MANY2ONE)
+      - TO pserver( p-interface tosca.relationships.network.BindsTo pserver, MANY2ONE)
+      - TO vpls-pe( p-interface tosca.relationships.network.BindsTo vpls-pe, MANY2ONE)
+      - FROM lag-interface( lag-interface org.onap.relationships.inventory.Uses p-interface, MANY2MANY)
+      - FROM l-interface( l-interface tosca.relationships.network.BindsTo p-interface, MANY2ONE)
+      - FROM sriov-pf( sriov-pf org.onap.relationships.inventory.BelongsTo p-interface, ONE2ONE)
+      - P-INTERFACE is DELETED when these are DELETED L-INTERFACE,SRIOV-PF
+      - P-INTERFACE deletion means associated objects of these types are also DELETED:PHYSICAL-LINK
     required:
-    - model-element-uuid
-    - new-data-del-flag
-    - cardinality
+    - interface-name
+    - in-maint
     properties:
-      model-element-uuid:
+      interface-name:
         type: string
-      new-data-del-flag:
+        description: Name that identifies the physical interface
+      speed-value:
         type: string
-        description: Indicates whether this element was created as part of instantiation from this model
-      cardinality:
+        description: Captures the numeric part of the speed
+      speed-units:
         type: string
-        description: How many of this type of element are required/allowed
-      linkage-points:
+        description: Captures the units corresponding to the speed
+      port-description:
+        type: string
+        description: Nature of the services and connectivity on this port.
+      equipment-identifier:
+        type: string
+        description: CLEI or other specification for p-interface hardware.
+      interface-role:
+        type: string
+        description: Role specification for p-interface hardware.
+      interface-type:
+        type: string
+        description: Indicates the physical properties of the interface.
+      prov-status:
         type: string
+        description: Trigger for operational monitoring of this resource by Service Assurance systems.
+      mac-addresss:
+        type: string
+        description: MAC Address of the p-interface.
       resource-version:
         type: string
         description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
-      model-elements:
+      in-maint:
+        type: boolean
+      inv-status:
+        type: string
+        description: inventory status
+      relationship-list:
         type: array
         items:
-          $ref: "#/definitions/model-element"
-        description: Defines how other models combine to make up a higher-level model
-      model-constraints:
+          $ref: "#/getDefinitions/relationship"
+      sriov-pfs:
         type: array
         items:
-          $ref: "#/definitions/model-constraint"
-        description: Describes new constraints on this model element that are not part of that model's definition
-      relationship-list:
+          $ref: "#/getDefinitions/sriov-pf"
+      l-interfaces:
         type: array
         items:
-          $ref: "#/definitions/relationship"
-  model-elements:
+          $ref: "#/getDefinitions/l-interface"
+  p-interfaces:
+    description: |
+      Collection of physical interfaces.
     properties:
-      model-element:
+      p-interface:
         type: array
         items:          
-          $ref: "#/definitions/model-element"
-  model-ver:
+          $ref: "#/getDefinitions/p-interface"
+  physical-link:
     description: |
-      Subgraph definition provided by ASDC to describe a specific version of an inventory asset and its connections related to ASDC models
-      ###### Default Delete Scope
-      ERROR_4_IN_EDGES_OR_CASCADE
+      Collection of physical connections, typically between p-interfaces
       ###### Related Nodes
-      - TO model-element (comprises model-ver, One2Many)
-      - TO metadatum (comprises model-ver, One2Many)
-      - FROM model (is composed of model-ver)
-      - FROM model-element
+      - FROM p-interface( p-interface tosca.relationships.network.LinksTo physical-link, MANY2ONE)
     required:
-    - model-version-id
-    - model-name
-    - model-version
+    - link-name
     properties:
-      model-version-id:
+      link-name:
         type: string
-        description: Unique identifier corresponding to one version of a model in ASDC
-      model-name:
+        description: e.g., hostnameA_p-connection_nameA_hostnameZ+p_connection-nameZ
+      speed-value:
         type: string
-        description: Name of the model, which can change from version to version.
-      model-version:
+        description: Captures the numeric part of the speed
+      speed-units:
         type: string
-        description: Version
-      model-description:
+        description: Captures the units corresponding to the speed
+      circuit-id:
         type: string
-        description: Description
+        description: Circuit it
+      dual-mode:
+        type: string
+        description: Dual access mode (e.g., primary, secondary
+      management-option:
+        type: string
+        description: To provide information on who manages this circuit. A&AI or 3rd party transport provider
+      service-provider-name:
+        type: string
+        description: Name of the service Provider on this link.
+      service-provider-bandwidth-up-value:
+        type: integer
+        format: int32
+        description: Upstream Bandwidth value agreed with the service provider
+      service-provider-bandwidth-up-units:
+        type: string
+        description: Units for the upstream BW value
+      service-provider-bandwidth-down-value:
+        type: integer
+        format: int32
+        description: Downstream Bandwidth value agreed with the service provider
+      service-provider-bandwidth-down-units:
+        type: string
+        description: Units for downstream BW value
       resource-version:
         type: string
         description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
-      model-elements:
-        type: array
-        items:
-          $ref: "#/definitions/model-element"
-      metadata:
-        type: array
-        items:
-          $ref: "#/definitions/metadatum"
       relationship-list:
         type: array
         items:
-          $ref: "#/definitions/relationship"
-  model-vers:
+          $ref: "#/getDefinitions/relationship"
+  physical-links:
+    description: |
+      Collection of physical connections, typically between p-interfaces
     properties:
-      model-ver:
+      physical-link:
         type: array
         items:          
-          $ref: "#/definitions/model-ver"
-  model:
+          $ref: "#/getDefinitions/physical-link"
+  platform:
     description: |
-      Subgraph definition provided by ASDC to describe an inventory asset and its connections related to ASDC models, independent of version
-      ###### Default Delete Scope
-      ERROR_4_IN_EDGES_OR_CASCADE
+      describes a platform
       ###### Related Nodes
-      - TO model-ver (comprises model, One2Many)
-      - FROM named-query
-      - FROM named-query-element
-      - FROM instance-group
+      - TO generic-vnf( platform org.onap.relationships.inventory.Uses generic-vnf, MANY2MANY)
     required:
-    - model-invariant-id
-    - model-type
+    - platform-name
     properties:
-      model-invariant-id:
-        type: string
-        description: Unique identifier corresponding to the main definition of a model in ASDC
-      model-type:
+      platform-name:
         type: string
-        description: Type of the model, e.g., service, resource, widget, etc.
+        description: Name of the platform
       resource-version:
         type: string
         description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
-      model-vers:
-        type: array
-        items:
-          $ref: "#/definitions/model-ver"
       relationship-list:
         type: array
         items:
-          $ref: "#/definitions/relationship"
-  models:
+          $ref: "#/getDefinitions/relationship"
+  platforms:
     description: |
-      Collection of subgraph definitions provided by ASDC to describe the inventory assets and their connections related to ASDC models
+      Collection of platforms
     properties:
-      model:
+      platform:
         type: array
         items:          
-          $ref: "#/definitions/model"
-  related-lookup:
+          $ref: "#/getDefinitions/platform"
+  pnf:
     description: |
-      TBD
-      ###### Default Delete Scope
-      CASCADE_TO_CHILDREN
+      PNF represents a physical network function. typically equipment used in the D1 world. in 1607, this will be populated by SDN-C to represent a premises router that a uCPE connects to. But this can be used to represent any physical device that is not an AIC node or uCPE.
       ###### Related Nodes
-      - FROM named-query-element (is composed of related-lookup)
+      - TO complex( pnf org.onap.relationships.inventory.LocatedIn complex, MANY2ONE)
+      - TO instance-group( pnf org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY)
+      - TO zone( pnf org.onap.relationships.inventory.LocatedIn zone, MANY2ONE)
+      - FROM esr-thirdparty-sdnc( esr-thirdparty-sdnc has pnf, One2Many)
+      - FROM generic-vnf( generic-vnf tosca.relationships.HostedOn pnf, MANY2MANY)
+      - FROM logical-link( logical-link org.onap.relationships.inventory.BridgedTo pnf, MANY2MANY)
+      - FROM lag-interface( lag-interface tosca.relationships.network.BindsTo pnf, MANY2ONE)
+      - FROM p-interface( p-interface tosca.relationships.network.BindsTo pnf, MANY2ONE)
+      - FROM service-instance( service-instance org.onap.relationships.inventory.ComposedOf pnf, ONE2MANY)
+      - PNF is DELETED when these are DELETED LAG-INTERFACE,P-INTERFACE
     required:
-    - related-lookup-uuid
-    - source-node-type
-    - source-node-property
-    - target-node-type
-    - target-node-property
+    - pnf-name
+    - in-maint
     properties:
-      related-lookup-uuid:
+      pnf-name:
         type: string
-      source-node-type:
+        description: unique name of Physical Network Function.
+      pnf-name2:
         type: string
-      source-node-property:
+        description: name of Physical Network Function.
+      pnf-name2-source:
         type: string
-      target-node-type:
+        description: source of name2
+      pnf-id:
         type: string
-      target-node-property:
+        description: id of pnf
+      equip-type:
         type: string
-      property-collect-list:
+        description: Equipment type.  Source of truth should define valid values.
+      equip-vendor:
+        type: string
+        description: Equipment vendor.  Source of truth should define valid values.
+      equip-model:
+        type: string
+        description: Equipment model.  Source of truth should define valid values.
+      management-option:
+        type: string
+        description: identifier of managed by ATT or customer
+      ipaddress-v4-oam:
+        type: string
+        description: ipv4-oam-address with new naming convention for IP addresses
+      sw-version:
+        type: string
+        description: sw-version is the version of SW for the hosted application on the PNF.
+      in-maint:
+        type: boolean
+      frame-id:
+        type: string
+        description: ID of the physical frame (relay rack) where pnf is installed.
+      serial-number:
+        type: string
+        description: Serial number of the device
+      ipaddress-v4-loopback-0:
+        type: string
+        description: IPV4 Loopback 0 address
+      ipaddress-v6-loopback-0:
+        type: string
+        description: IPV6 Loopback 0 address
+      ipaddress-v4-aim:
+        type: string
+        description: IPV4 AIM address
+      ipaddress-v6-aim:
+        type: string
+        description: IPV6 AIM address
+      ipaddress-v6-oam:
+        type: string
+        description: IPV6 OAM address
+      inv-status:
         type: string
+        description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
       resource-version:
         type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      prov-status:
+        type: string
+        description: Prov Status of this device (not under canopi control) Valid values [PREPROV/NVTPROV/PROV]
+      nf-role:
+        type: string
+        description: Nf Role is the role performed by this instance in the network.
       relationship-list:
         type: array
         items:
-          $ref: "#/definitions/relationship"
-  related-lookups:
+          $ref: "#/getDefinitions/relationship"
+      p-interfaces:
+        type: array
+        items:
+          $ref: "#/getDefinitions/p-interface"
+      lag-interfaces:
+        type: array
+        items:
+          $ref: "#/getDefinitions/lag-interface"
+  pnfs:
+    description: |
+      Collection of Physical Network Functions.
     properties:
-      related-lookup:
+      pnf:
         type: array
         items:          
-          $ref: "#/definitions/related-lookup"
-  property-constraint:
+          $ref: "#/getDefinitions/pnf"
+  port-group:
     description: |
-      TBD
-      ###### Default Delete Scope
-      CASCADE_TO_CHILDREN
+      Used to capture the network interfaces of this VCE
       ###### Related Nodes
-      - FROM named-query-element (is composed of property-constraint)
+      - TO vce( port-group org.onap.relationships.inventory.BelongsTo vce, MANY2ONE)
+      - FROM cvlan-tag( cvlan-tag org.onap.relationships.inventory.BelongsTo port-group, MANY2ONE)
+      - PORT-GROUP is DELETED when these are DELETED CVLAN-TAG
     required:
-    - property-constraint-uuid
-    - constraint-type
-    - property-name
-    - property-value
+    - interface-id
+    - orchestration-status
     properties:
-      property-constraint-uuid:
+      interface-id:
         type: string
-      constraint-type:
+        description: Unique ID of the interface
+      neutron-network-id:
         type: string
-      property-name:
+        description: Neutron network id of this Interface
+      neutron-network-name:
         type: string
-      property-value:
+        description: Neutron network name of this Interface
+      interface-role:
         type: string
+        description: Role assigned to this Interface, should use values as defined in ECOMP Yang models.
       resource-version:
         type: string
-  property-constraints:
-    properties:
-      property-constraint:
-        type: array
-        items:          
-          $ref: "#/definitions/property-constraint"
-  named-query-element:
-    description: |
-      TBD
-      ###### Default Delete Scope
-      CASCADE_TO_CHILDREN
-      ###### Related Nodes
-      - TO named-query-element (comprises named-query-element, Many2Many)
-      - TO model (Many2One)
-      - TO property-constraint (comprises named-query-element, One2Many)
-      - TO related-lookup (comprises named-query-element, One2Many)
-      - FROM named-query (is composed of named-query-element)
-      - FROM named-query-element (is composed of named-query-element)
-    required:
-    - named-query-element-uuid
-    properties:
-      named-query-element-uuid:
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      port-group-id:
         type: string
-      property-collect-list:
+        description: Unique ID for port group in vmware
+      port-group-name:
         type: string
-      resource-version:
+        description: Likely to duplicate value of neutron network name
+      switch-name:
         type: string
-      property-limit-desc:
+        description: DVS or standard switch name (should be non-null for port groups associated with DVS)
+      orchestration-status:
         type: string
-      do-not-output:
+        description: Orchestration status of this VNF, mastered by MSO
+      heat-stack-id:
         type: string
-      named-query-elements:
+        description: Heat stack id corresponding to this instance, managed by MSO
+      mso-catalog-key:
+        type: string
+        description: Corresponds to the SDN-C catalog id used to configure this VCE
+      cvlan-tags:
         type: array
         items:
-          $ref: "#/definitions/named-query-element"
-      related-lookups:
+          $ref: "#/getDefinitions/cvlan-tag-entry"
+      relationship-list:
         type: array
         items:
-          $ref: "#/definitions/related-lookup"
-      property-constraints:
+          $ref: "#/getDefinitions/relationship"
+  port-groups:
+    properties:
+      port-group:
         type: array
-        items:
-          $ref: "#/definitions/property-constraint"
+        items:          
+          $ref: "#/getDefinitions/port-group"
+  project:
+    description: |
+      describes the project
+      ###### Related Nodes
+      - TO service-instance( project org.onap.relationships.inventory.Uses service-instance, ONE2MANY)
+    required:
+    - project-name
+    properties:
+      project-name:
+        type: string
+        description: Name of the project deploying a service
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
       relationship-list:
         type: array
         items:
-          $ref: "#/definitions/relationship"
-  named-query-elements:
+          $ref: "#/getDefinitions/relationship"
+  projects:
+    description: |
+      Collection of projects
     properties:
-      named-query-element:
+      project:
         type: array
         items:          
-          $ref: "#/definitions/named-query-element"
-  named-query:
+          $ref: "#/getDefinitions/project"
+  properties:
+    description: |
+      Property holder for query properties or instance properties
+    properties:
+      property-name:
+        type: string
+      property-value:
+        type: string
+  property-constraint:
     description: |
       TBD
-      ###### Default Delete Scope
-      CASCADE_TO_CHILDREN
       ###### Related Nodes
-      - TO model (One2Many)
-      - TO named-query-element (comprises named-query, One2One)
+      - TO named-query-element( property-constraint org.onap.relationships.inventory.BelongsTo named-query-element, MANY2ONE)
     required:
-    - named-query-uuid
-    - named-query-name
-    - named-query-version
+    - property-constraint-uuid
+    - constraint-type
+    - property-name
+    - property-value
     properties:
-      named-query-uuid:
-        type: string
-      named-query-name:
+      property-constraint-uuid:
         type: string
-      named-query-version:
+      constraint-type:
         type: string
-      required-input-param:
+      property-name:
         type: string
-      description:
+      property-value:
         type: string
       resource-version:
         type: string
-      named-query-elements:
-        type: array
-        items:
-          $ref: "#/definitions/named-query-element"
-      relationship-list:
-        type: array
-        items:
-          $ref: "#/definitions/relationship"
-  named-queries:
+  property-constraints:
     properties:
-      named-query:
+      property-constraint:
         type: array
         items:          
-          $ref: "#/definitions/named-query"
-  service-design-and-creation:
-    description: |
-      Namespace for objects managed by ASDC
-    properties:
-      vnf-images:
-        type: array
-        items:
-          $ref: "#/definitions/vnf-image"
-      services:
-        type: array
-        items:
-          $ref: "#/definitions/service"
-      service-capabilities:
-        type: array
-        items:
-          $ref: "#/definitions/service-capability"
-      models:
-        type: array
-        items:
-          $ref: "#/definitions/model"
-      named-queries:
-        type: array
-        items:
-          $ref: "#/definitions/named-query"
-  logical-link:
+          $ref: "#/getDefinitions/property-constraint"
+  pserver:
     description: |
-      Logical links generally connect l-interfaces but are used to express logical connectivity between two points
-      ###### Default Delete Scope
-      THIS_NODE_ONLY
-      ###### Related Nodes
-      - TO lag-link (Many2Many)
-      - TO pnf (Many2Many)
-      - TO logical-link (One2Many)
-      - TO generic-vnf (Many2Many)
-      - TO pserver (Many2Many)
-      - TO cloud-region (Many2Many)
-      - TO vpn-binding (Many2Many)
-      - FROM l-interface
-      - FROM lag-interface
-      - FROM p-interface
-      - FROM service-instance
-      - FROM virtual-data-center
-      - FROM vlan
-      - FROM logical-link
+      Compute host whose hostname must be unique and must exactly match what is sent as a relationship to a vserver.
+      ###### Related Nodes
+      - TO group-assignment( pserver org.onap.relationships.inventory.MemberOf group-assignment, MANY2ONE)
+      - TO availability-zone( pserver org.onap.relationships.inventory.MemberOf availability-zone, MANY2ONE)
+      - TO cloud-region( pserver org.onap.relationships.inventory.LocatedIn cloud-region, MANY2ONE)
+      - TO complex( pserver org.onap.relationships.inventory.LocatedIn complex, MANY2ONE)
+      - TO zone( pserver org.onap.relationships.inventory.LocatedIn zone, MANY2ONE)
+      - FROM generic-vnf( generic-vnf tosca.relationships.HostedOn pserver, MANY2MANY)
+      - FROM logical-link( logical-link org.onap.relationships.inventory.BridgedTo pserver, MANY2MANY)
+      - FROM lag-interface( lag-interface tosca.relationships.network.BindsTo pserver, MANY2ONE)
+      - FROM p-interface( p-interface tosca.relationships.network.BindsTo pserver, MANY2ONE)
+      - FROM vserver( vserver tosca.relationships.HostedOn pserver, MANY2ONE)
+      - PSERVER cannot be deleted if linked to GENERIC-VNF,LOGICAL-LINK,VSERVER
+      - PSERVER is DELETED when these are DELETED LAG-INTERFACE,P-INTERFACE
+      - PSERVER cannot be deleted if linked to GROUP-ASSIGNMENT
     required:
-    - link-name
+    - hostname
     - in-maint
-    - link-type
     properties:
-      link-name:
+      hostname:
         type: string
-        description: e.g., evc-name, or vnf-nameA_interface-nameA_vnf-nameZ_interface-nameZ
-      in-maint:
-        type: boolean
-      link-type:
+        description: Value from executing hostname on the compute node.
+      ptnii-equip-name:
         type: string
-        description: Type of logical link, e.g., evc
-      speed-value:
+        description: PTNII name
+      number-of-cpus:
+        type: integer
+        format: int32
+        description: Number of cpus
+      disk-in-gigabytes:
+        type: integer
+        format: int32
+        description: Disk size, in GBs
+      ram-in-megabytes:
+        type: integer
+        format: int32
+        description: RAM size, in MBs
+      equip-type:
         type: string
-        description: Captures the numeric part of the speed
-      speed-units:
+        description: Equipment type.  Source of truth should define valid values.
+      equip-vendor:
         type: string
-        description: Captures the units corresponding to the speed
-      ip-version:
+        description: Equipment vendor.  Source of truth should define valid values.
+      equip-model:
         type: string
-        description: v4, v6, or ds for dual stack
-      routing-protocol:
+        description: Equipment model.  Source of truth should define valid values.
+      fqdn:
         type: string
-        description: For example, static or BGP
-      resource-version:
+        description: Fully-qualified domain name
+      pserver-selflink:
         type: string
-        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
-      model-invariant-id:
+        description: URL to endpoint where AAI can get more details
+      ipv4-oam-address:
         type: string
-        description: the ASDC model id for this resource or service model.
-      model-version-id:
+        description: Used to configure device, also used for troubleshooting and is IP used for traps generated by device.
+      serial-number:
         type: string
-        description: the ASDC model version for this resource or service model.
-      persona-model-version:
+        description: Serial number, may be queried
+      ipaddress-v4-loopback-0:
         type: string
-        description: the ASDC model version for this resource or service model.
-      widget-model-id:
+        description: IPV4 Loopback 0 address
+      ipaddress-v6-loopback-0:
         type: string
-        description: the ASDC data dictionary widget model. This maps directly to the A&AI widget.
-      widget-model-version:
+        description: IPV6 Loopback 0 address
+      ipaddress-v4-aim:
         type: string
-        description: the ASDC data dictionary version of the widget model.This maps directly to the A&AI version of the widget.
-      operational-status:
+        description: IPV4 AIM address
+      ipaddress-v6-aim:
         type: string
-        description: Indication of operational status of the logical link.
-      prov-status:
+        description: IPV6 AIM address
+      ipaddress-v6-oam:
         type: string
-        description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems.
-      link-role:
+        description: IPV6 OAM address
+      inv-status:
         type: string
-        description: Indication of the network use of the logical link.
-      link-name2:
+        description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
+      pserver-id:
         type: string
-        description: Alias or alternate name (CLCI or D1 name).
-      link-id:
+        description: ID of Pserver
+      internet-topology:
         type: string
-        description: UUID of the logical-link, SDNC generates this.
-      circuit-id:
+        description: internet topology of Pserver
+      in-maint:
+        type: boolean
+      resource-version:
         type: string
-        description: Circuit id
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      pserver-name2:
+        type: string
+        description: alternative pserver name
       purpose:
         type: string
-        description: Reason for this entity, role it is playing
+        description: purpose of pserver
+      prov-status:
+        type: string
+        description: Prov Status of this device (not under canopi control) Valid values [PREPROV/NVTPROV/PROV]
+      management-option:
+        type: string
+        description: Indicates who owns and or manages the device.
+      host-profile:
+        type: string
+        description: The host profile that defines the configuration of the pserver.
       relationship-list:
         type: array
         items:
-          $ref: "#/definitions/relationship"
-  logical-links:
+          $ref: "#/getDefinitions/relationship"
+      p-interfaces:
+        type: array
+        items:
+          $ref: "#/getDefinitions/p-interface"
+      lag-interfaces:
+        type: array
+        items:
+          $ref: "#/getDefinitions/lag-interface"
+  pservers:
     description: |
-      Collection of logical connections
+      Collection of compute hosts.
     properties:
-      logical-link:
+      pserver:
         type: array
         items:          
-          $ref: "#/definitions/logical-link"
-  class-of-service:
+          $ref: "#/getDefinitions/pserver"
+  query-parameters:
+    description: |
+      QueryParameters for performing a named-query or model query
+    properties:
+      named-query:
+        type: object
+        $ref: "#/getDefinitions/named-query"
+      overloaded-model:
+        type: object
+        $ref: "#/getDefinitions/overloaded-model"
+  related-lookup:
     description: |
-      ###### Default Delete Scope
-      THIS_NODE_ONLY
+      TBD
       ###### Related Nodes
-      - FROM site-pair (is composed of class-of-service)
+      - TO named-query-element( related-lookup org.onap.relationships.inventory.BelongsTo named-query-element, MANY2ONE)
     required:
-    - cos
+    - related-lookup-uuid
+    - source-node-type
+    - source-node-property
+    - target-node-type
+    - target-node-property
     properties:
-      cos:
+      related-lookup-uuid:
         type: string
-        description: unique identifier of probe
-      probe-id:
+      source-node-type:
         type: string
-        description: identifier of probe
-      probe-type:
+      source-node-property:
+        type: string
+      target-node-type:
+        type: string
+      target-node-property:
+        type: string
+      property-collect-list:
         type: string
-        description: type of probe
       resource-version:
         type: string
-        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
       relationship-list:
         type: array
         items:
-          $ref: "#/definitions/relationship"
-  classes-of-service:
-    description: |
-      class-of-service of probe
+          $ref: "#/getDefinitions/relationship"
+  related-lookups:
     properties:
-      class-of-service:
+      related-lookup:
         type: array
         items:          
-          $ref: "#/definitions/class-of-service"
-  site-pair:
-    description: |
-      ###### Default Delete Scope
-      CASCADE_TO_CHILDREN
-      ###### Related Nodes
-      - TO class-of-service (comprises site-pair, Many2Many)
-      - FROM routing-instance (is composed of site-pair)
-    required:
-    - site-pair-id
+          $ref: "#/getDefinitions/related-lookup"
+  related-to-property:
     properties:
-      site-pair-id:
-        type: string
-        description: unique identifier of probe
-      source-ip:
-        type: string
-        description: Prefix address
-      destination-ip:
-        type: string
-        description: Prefix address
-      ip-version:
+      property-key:
         type: string
-        description: ip version, v4, v6
-      destination-hostname:
+        description: Key part of a key/value pair
+      property-value:
         type: string
-        description: Hostname of the destination equipment to which SLAs are measured against.
-      destination-equip-type:
+        description: Value part of a key/value pair
+  relationship:
+    properties:
+      related-to:
         type: string
-        description: The type of destinatination equipment. Could be Router, UCPE, etc.
-      resource-version:
+        description: A keyword provided by A&AI to indicate type of node.
+      related-link:
         type: string
-        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
-      classes-of-service:
+        description: URL to the object in A&AI.
+      relationship-data:
         type: array
-        items:
-          $ref: "#/definitions/class-of-service"
-      relationship-list:
+        items:          
+          $ref: "#/getDefinitions/relationship-data"
+      related-to-property:
         type: array
-        items:
-          $ref: "#/definitions/relationship"
-  site-pairs:
-    description: |
-      probe within a set
+        items:          
+          $ref: "#/getDefinitions/related-to-property"
+  relationship-data:
+    required:
+    - relationship-key
+    - relationship-value
     properties:
-      site-pair:
+      relationship-key:
+        type: string
+        description: A keyword provided by A&AI to indicate an attribute.
+      relationship-value:
+        type: string
+        description: Value of the attribute.
+  relationship-list:
+    properties:
+      relationship:
         type: array
         items:          
-          $ref: "#/definitions/site-pair"
-  routing-instance:
+          $ref: "#/getDefinitions/relationship"
+  reserved-prop-names:
     description: |
-      ###### Default Delete Scope
-      CASCADE_TO_CHILDREN
-      ###### Related Nodes
-      - TO site-pair (comprises routing-instance, Many2Many)
-      - FROM site-pair-set (is composed of routing-instance)
-    required:
-    - routing-instance-id
+      Internal map to define some reserved properties of a vertex
     properties:
-      routing-instance-id:
+      last-mod-source-of-truth:
         type: string
-        description: Unique id of routing instance
-      rpm-owner:
+      aai-node-type:
         type: string
-        description: rpm owner
-      resource-version:
+      aai-created-ts:
+        type: integer
+        format: int64
+      aai-unique-key:
         type: string
-        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
-      site-pairs:
-        type: array
-        items:
-          $ref: "#/definitions/site-pair"
-      relationship-list:
-        type: array
-        items:
-          $ref: "#/definitions/relationship"
-  routing-instances:
+      aai-last-mod-ts:
+        type: integer
+        format: int64
+      source-of-truth:
+        type: string
+      aai-uri:
+        type: string
+  response-list:
     description: |
-      set of probes related to generic-vnf routing instance
+      Response container for the results of a named-query or model query
     properties:
-      routing-instance:
-        type: array
-        items:          
-          $ref: "#/definitions/routing-instance"
-  site-pair-set:
+      inventory-response-items:
+        type: object
+        $ref: "#/getDefinitions/inventory-response-items"
+  result-data:
+    properties:
+      resource-type:
+        type: string
+        description: The specific type of node in the A&AI graph
+      resource-link:
+        type: string
+        description: The URL to the specific resource
+  route-table-reference:
     description: |
-      Set of instances for probes used to measure service level agreements
-      ###### Default Delete Scope
-      CASCADE_TO_CHILDREN
+      Openstack route table reference.
       ###### Related Nodes
-      - TO routing-instance (comprises site-pair-set, Many2Many)
-      - FROM generic-vnf
+      - FROM l3-network( l3-network org.onap.relationships.inventory.Uses route-table-reference, MANY2MANY)
     required:
-    - site-pair-set-id
+    - route-table-reference-id
+    - route-table-reference-fqdn
     properties:
-      site-pair-set-id:
+      route-table-reference-id:
         type: string
-        description: Unique id of site pair set.
+        description: Route Table Reference id, UUID assigned to this instance.
+      route-table-reference-fqdn:
+        type: string
+        description: FQDN entry in the route table.
       resource-version:
         type: string
-        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
-      routing-instances:
-        type: array
-        items:
-          $ref: "#/definitions/routing-instance"
+        description: Concurrency value
       relationship-list:
         type: array
         items:
-          $ref: "#/definitions/relationship"
-  site-pair-sets:
+          $ref: "#/getDefinitions/relationship"
+  route-table-references:
     description: |
-      Collection of sets of instances for probes related to generic-vnf
+      Collection of openstack route table references
     properties:
-      site-pair-set:
+      route-table-reference:
         type: array
         items:          
-          $ref: "#/definitions/site-pair-set"
+          $ref: "#/getDefinitions/route-table-reference"
   route-target:
     description: |
       Route target information
-      ###### Default Delete Scope
-      CASCADE_TO_CHILDREN
       ###### Related Nodes
-      - FROM vpn-binding (is composed of route-target)
+      - TO vpn-binding( route-target org.onap.relationships.inventory.BelongsTo vpn-binding, MANY2ONE)
     required:
     - global-route-target
     - route-target-role
@@ -41665,7 +66131,7 @@ definitions:
       relationship-list:
         type: array
         items:
-          $ref: "#/definitions/relationship"
+          $ref: "#/getDefinitions/relationship"
   route-targets:
     description: |
       Collection of route target information
@@ -41673,1066 +66139,804 @@ definitions:
       route-target:
         type: array
         items:          
-          $ref: "#/definitions/route-target"
-  vpn-binding:
+          $ref: "#/getDefinitions/route-target"
+  routing-instance:
     description: |
-      VPN binding
-      ###### Default Delete Scope
-      ERROR_4_IN_EDGES_OR_CASCADE
       ###### Related Nodes
-      - TO route-target (comprises vpn-binding, One2Many)
-      - FROM l3-network
-      - FROM logical-link
-      - FROM allotted-resource
+      - TO site-pair-set( routing-instance org.onap.relationships.inventory.BelongsTo site-pair-set, MANY2ONE)
+      - FROM site-pair( site-pair org.onap.relationships.inventory.BelongsTo routing-instance, MANY2ONE)
+      - ROUTING-INSTANCE is DELETED when these are DELETED SITE-PAIR
     required:
-    - vpn-id
-    - vpn-name
+    - routing-instance-id
     properties:
-      vpn-id:
-        type: string
-        description: VPN ID, globally unique within A&AI
-      vpn-name:
-        type: string
-        description: VPN Name
-      vpn-platform:
-        type: string
-        description: the platform associated with the VPN example AVPN, Mobility
-      vpn-type:
-        type: string
-        description: Type of the vpn, should be taken from enumerated/valid values
-      vpn-region:
-        type: string
-        description: region of customer vpn
-      customer-vpn-id:
+      routing-instance-id:
         type: string
-        description: id for this customer vpn
-      route-distinguisher:
+        description: Unique id of routing instance
+      rpm-owner:
         type: string
-        description: Used to distinguish the distinct VPN routes of separate customers who connect to the provider in an MPLS network.
+        description: rpm owner
       resource-version:
         type: string
         description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
-      route-targets:
+      site-pairs:
         type: array
         items:
-          $ref: "#/definitions/route-target"
+          $ref: "#/getDefinitions/site-pair"
       relationship-list:
         type: array
         items:
-          $ref: "#/definitions/relationship"
-        description: l3-networks relate to vpn-bindings
-  vpn-bindings:
+          $ref: "#/getDefinitions/relationship"
+  routing-instances:
+    description: |
+      set of probes related to generic-vnf routing instance
     properties:
-      vpn-binding:
+      routing-instance:
         type: array
         items:          
-          $ref: "#/definitions/vpn-binding"
-  vpls-pe:
-    description: |
-      VPLS Provider Edge routers.
-      ###### Default Delete Scope
-      CASCADE_TO_CHILDREN
-      ###### Related Nodes
-      - TO complex (Many2Many)
-      - TO ctag-pool (Many2Many)
-      - TO p-interface (comprises vpls-pe, Many2Many)
-      - TO lag-interface (comprises vpls-pe, Many2Many)
-    required:
-    - equipment-name
+          $ref: "#/getDefinitions/routing-instance"
+  sdn-zone-response:
     properties:
-      equipment-name:
-        type: string
-      prov-status:
-        type: string
-        description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems.
-      ipv4-oam-address:
-        type: string
-        description: Address tail-f uses to configure generic-vnf, also used for troubleshooting and is IP used for traps generated by GenericVnf (v4-loopback0-ip-address).
-      equipment-role:
-        type: string
-        description: Client should send valid enumerated value, e.g., VPLS-PE.
-      vlan-id-outer:
-        type: integer
-        format: int64
-        description: Temporary location for stag to get to VCE
-      resource-version:
-        type: string
-        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
-      relationship-list:
-        type: array
-        items:
-          $ref: "#/definitions/relationship"
-      p-interfaces:
-        type: array
-        items:
-          $ref: "#/definitions/p-interface"
-      lag-interfaces:
+      oam-networks:
+        type: object
+        $ref: "#/getDefinitions/oam-networks"
+      az-and-dvs-switches:
         type: array
-        items:
-          $ref: "#/definitions/lag-interface"
-  vpls-pes:
-    description: |
-      Collection of VPLS Provider Edge routers
+        items:          
+          $ref: "#/getDefinitions/az-and-dvs-switches"
+  search:
     properties:
-      vpls-pe:
+      edge-tag-query-result:
+        type: object
+        $ref: "#/getDefinitions/edge-tag-query-result"
+      edge-tag-query-request:
+        type: object
+        $ref: "#/getDefinitions/edge-tag-query-request"
+      search-results:
+        type: object
+        $ref: "#/getDefinitions/search-results"
+      sdn-zone-response:
+        type: object
+        $ref: "#/getDefinitions/sdn-zone-response"
+  search-results:
+    properties:
+      result-data:
         type: array
         items:          
-          $ref: "#/definitions/vpls-pe"
-  multicast-configuration:
+          $ref: "#/getDefinitions/result-data"
+  secondary-filt:
     description: |
-      ###### Default Delete Scope
-      THIS_NODE_ONLY
-      ###### Related Nodes
-      - FROM vlan
-    required:
-    - multicast-configuration-id
-    - multicast-protocol
-    - rp-type
+      SecondaryFilt for performing a named-query or model query
+  secondary-filter:
     properties:
-      multicast-configuration-id:
-        type: string
-        description: Unique id of multicast configuration.
-      multicast-protocol:
+      property-name:
         type: string
-        description: protocol of multicast configuration
-      rp-type:
+      filter-type:
         type: string
-        description: rp type of multicast configuration
-      resource-version:
+      property-value:
         type: string
-        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
-      relationship-list:
-        type: array
-        items:
-          $ref: "#/definitions/relationship"
-  multicast-configurations:
+  secondary-filts:
     description: |
-      multicast configuration of generic-vnf ip-address
-    properties:
-      multicast-configuration:
-        type: array
-        items:          
-          $ref: "#/definitions/multicast-configuration"
-  cvlan-tag-entry:
-    required:
-    - cvlan-tag
-    properties:
-      cvlan-tag:
-        type: integer
-        format: int64
-        description: See mis-na-virtualization-platform.yang
-      resource-version:
-        type: string
-        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
-      relationship-list:
-        type: array
-        items:
-          $ref: "#/definitions/relationship"
-  cvlan-tags:
+      SecondaryFilts for performing a named-query or model query
     properties:
-      cvlan-tag-entry:
+      secondary-filt:
         type: array
         items:          
-          $ref: "#/definitions/cvlan-tag-entry"
-  port-group:
+          $ref: "#/getDefinitions/secondary-filt"
+  segmentation-assignment:
     description: |
-      Used to capture the network interfaces of this VCE
-      ###### Default Delete Scope
-      CASCADE_TO_CHILDREN
+      Openstack segmentation assignment.
       ###### Related Nodes
-      - TO cvlan-tag (comprises port-group, Many2Many)
-      - FROM vce (is composed of port-group)
+      - TO l3-network( segmentation-assignment org.onap.relationships.inventory.BelongsTo l3-network, MANY2ONE)
     required:
-    - interface-id
-    - orchestration-status
+    - segmentation-id
     properties:
-      interface-id:
-        type: string
-        description: Unique ID of the interface
-      neutron-network-id:
-        type: string
-        description: Neutron network id of this Interface
-      neutron-network-name:
-        type: string
-        description: Neutron network name of this Interface
-      interface-role:
+      segmentation-id:
         type: string
-        description: Role assigned to this Interface, should use values as defined in ECOMP Yang models.
+        description: Route Table Reference id, UUID assigned to this instance.
       resource-version:
         type: string
-        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
-      port-group-id:
-        type: string
-        description: Unique ID for port group in vmware
-      port-group-name:
-        type: string
-        description: Likely to duplicate value of neutron network name
-      switch-name:
-        type: string
-        description: DVS or standard switch name (should be non-null for port groups associated with DVS)
-      orchestration-status:
-        type: string
-        description: Orchestration status of this VNF, mastered by MSO
-      heat-stack-id:
-        type: string
-        description: Heat stack id corresponding to this instance, managed by MSO
-      mso-catalog-key:
-        type: string
-        description: Corresponds to the SDN-C catalog id used to configure this VCE
-      cvlan-tags:
-        type: array
-        items:
-          $ref: "#/definitions/cvlan-tag-entry"
+        description: Concurrency value
       relationship-list:
         type: array
         items:
-          $ref: "#/definitions/relationship"
-  port-groups:
+          $ref: "#/getDefinitions/relationship"
+  segmentation-assignments:
+    description: |
+      Collection of openstack segmentation assignments
     properties:
-      port-group:
+      segmentation-assignment:
         type: array
         items:          
-          $ref: "#/definitions/port-group"
-  license:
+          $ref: "#/getDefinitions/segmentation-assignment"
+  service:
     description: |
-      Metadata for license group.
-      ###### Default Delete Scope
-      THIS_NODE_ONLY
-      ###### Related Nodes
-      - FROM generic-vnf (is composed of license)
-      - FROM vce (is composed of license)
+      Stand-in for service model definitions.  Likely to be deprecated in favor of models from ASDC.  Does not strictly map to ASDC services.
     required:
-    - group-uuid
-    - resource-uuid
+    - service-id
+    - service-description
     properties:
-      group-uuid:
+      service-id:
         type: string
-        description: Unique ID for the license group the resource belongs to, should be uuid.
-      resource-uuid:
+        description: This gets defined by others to provide a unique ID for the service, we accept what is sent.
+      service-description:
         type: string
-        description: Unique ID of a license resource. 
+        description: Description of the service
+      service-selflink:
+        type: string
+        description: URL to endpoint where AAI can get more details
       resource-version:
         type: string
-        description: Concurrency value
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      service-version:
+        type: string
+        description: service version
       relationship-list:
         type: array
         items:
-          $ref: "#/definitions/relationship"
-  licenses:
+          $ref: "#/getDefinitions/relationship"
+  service-capabilities:
     description: |
-      Licenses to be allocated across resources, keyed by group-uuid and resource-uuid, related to license management
+      Collection of service capabilities.
     properties:
-      license:
+      service-capability:
         type: array
         items:          
-          $ref: "#/definitions/license"
-  entitlement:
+          $ref: "#/getDefinitions/service-capability"
+  service-capability:
     description: |
-      Metadata for entitlement group.
-      ###### Default Delete Scope
-      THIS_NODE_ONLY
+      Early definition of server/resource pairings, likely to be replaced by models.  No new use should be made of this.
       ###### Related Nodes
-      - FROM generic-vnf (is composed of entitlement)
-      - FROM vce (is composed of entitlement)
+      - FROM availability-zone( availability-zone org.onap.relationships.inventory.AppliesTo service-capability, MANY2MANY)
+      - FROM oam-network( oam-network org.onap.relationships.inventory.AppliesTo service-capability, MANY2MANY)
+      - SERVICE-CAPABILITY cannot be deleted if linked to AVAILABILITY-ZONE,OAM-NETWORK
     required:
-    - group-uuid
-    - resource-uuid
+    - service-type
+    - vnf-type
     properties:
-      group-uuid:
+      service-type:
         type: string
-        description: Unique ID for the entitlement group the resource comes from, should be uuid.
-      resource-uuid:
+        description: This gets defined by others to provide a unique ID for the service, we accept what is sent.
+      vnf-type:
         type: string
-        description: Unique ID of an entitlement resource. 
+        description: String capturing type of vnf, that was intended to identify the ASDC resource.  This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures.
       resource-version:
         type: string
-        description: Concurrency value
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
       relationship-list:
         type: array
         items:
-          $ref: "#/definitions/relationship"
-  entitlements:
+          $ref: "#/getDefinitions/relationship"
+  service-design-and-creation:
     description: |
-      Entitlements, keyed by group-uuid and resource-uuid, related to license management
+      Namespace for objects managed by ASDC
     properties:
-      entitlement:
+      vnf-images:
         type: array
-        items:          
-          $ref: "#/definitions/entitlement"
-  vce:
+        items:
+          $ref: "#/getDefinitions/vnf-image"
+      services:
+        type: array
+        items:
+          $ref: "#/getDefinitions/service"
+      service-capabilities:
+        type: array
+        items:
+          $ref: "#/getDefinitions/service-capability"
+      models:
+        type: array
+        items:
+          $ref: "#/getDefinitions/model"
+      named-queries:
+        type: array
+        items:
+          $ref: "#/getDefinitions/named-query"
+  service-instance:
     description: |
-      Virtual Customer Edge Router, used specifically for Gamma.  This object is deprecated.
-      ###### Default Delete Scope
-      CASCADE_TO_CHILDREN
+      Instance of a service
       ###### Related Nodes
-      - TO availability-zone (Many2Many)
-      - TO complex (Many2Many)
-      - TO port-group (comprises vce, Many2Many)
-      - TO vserver (Many2Many)
-      - TO service-instance (Many2Many)
-      - TO entitlement (comprises vce, One2Many)
-      - TO license (comprises vce, One2Many)
+      - TO generic-vnf( service-instance org.onap.relationships.inventory.ComposedOf generic-vnf, ONE2MANY)
+      - TO l3-network( service-instance org.onap.relationships.inventory.ComposedOf l3-network, ONE2MANY)
+      - TO owning-entity( service-instance org.onap.relationships.inventory.BelongsTo owning-entity, MANY2ONE)
+      - TO allotted-resource( service-instance org.onap.relationships.inventory.Uses allotted-resource, MANY2MANY)
+      - TO configuration( service-instance org.onap.relationships.inventory.Uses configuration, ONE2MANY)
+      - TO connector( service-instance org.onap.relationships.inventory.Uses connector, MANY2MANY)
+      - TO ctag-assignment( service-instance org.onap.relationships.inventory.Uses ctag-assignment, ONE2MANY)
+      - TO cvlan-tag( service-instance org.onap.relationships.inventory.ComposedOf cvlan-tag, MANY2MANY)
+      - TO instance-group( service-instance org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY)
+      - TO logical-link( service-instance org.onap.relationships.inventory.Uses logical-link, ONE2MANY)
+      - TO pnf( service-instance org.onap.relationships.inventory.ComposedOf pnf, ONE2MANY)
+      - TO service-instance( service-instance org.onap.relationships.inventory.ComposedOf service-instance, ONE2MANY)
+      - TO vlan( service-instance org.onap.relationships.inventory.ComposedOf vlan, ONE2MANY)
+      - TO zone( service-instance org.onap.relationships.inventory.LocatedIn zone, MANY2ONE)
+      - TO service-subscription( service-instance org.onap.relationships.inventory.BelongsTo service-subscription, MANY2ONE)
+      - TO vce( service-instance org.onap.relationships.inventory.ComposedOf vce, ONE2MANY)
+      - FROM project( project org.onap.relationships.inventory.Uses service-instance, ONE2MANY)
+      - FROM allotted-resource( allotted-resource org.onap.relationships.inventory.BelongsTo service-instance, MANY2ONE)
+      - FROM metadatum( metadatum org.onap.relationships.inventory.BelongsTo service-instance, MANY2ONE)
+      - FROM service-instance( service-instance org.onap.relationships.inventory.ComposedOf service-instance, ONE2MANY)
+      - SERVICE-INSTANCE is DELETED when these are DELETED ALLOTTED-RESOURCE,METADATUM
+      - SERVICE-INSTANCE deletion means associated objects of these types are also DELETED:LOGICAL-LINK
     required:
-    - vnf-id
-    - vnf-name
-    - vnf-type
+    - service-instance-id
+    - service-type
+    - service-role
+    - created-at
+    - updated-at
+    - description
     properties:
-      vnf-id:
+      service-instance-id:
         type: string
-        description: Unique id of VNF.  This is unique across the graph.
-      vnf-name:
+        description: Uniquely identifies this instance of a service
+      service-instance-name:
         type: string
-        description: Name of VNF.
-      vnf-name2:
+        description: This field will store a name assigned to the service-instance.
+      service-type:
         type: string
-        description: Alternate name of VNF.
-      vnf-type:
+        description: String capturing type of service.
+      service-role:
         type: string
-        description: String capturing type of vnf, that was intended to identify the ASDC resource.  This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures.
-      service-id:
+        description: String capturing the service role.
+      environment-context:
         type: string
-        description: Unique identifier of service, does not strictly map to ASDC services, SOON TO BE DEPRECATED.
-      regional-resource-zone:
+        description: This field will store the environment context assigned to the service-instance.
+      workload-context:
         type: string
-        description: Regional way of organizing pservers, source of truth should define values
-      prov-status:
+        description: This field will store the workload context assigned to the service-instance.
+      created-at:
         type: string
-        description: Trigger for operational monitoring of this resource by Service Assurance systems.
-      operational-status:
+        description: create time of Network Service.
+      updated-at:
         type: string
-        description: Indicator for whether the resource is considered operational
-      license-key:
+        description: last update of Network Service.
+      description:
         type: string
-        description: OBSOLETE -  do not use
-      equipment-role:
+        description: short description for service-instance.
+      model-invariant-id:
         type: string
-        description: Network role being played by this VNF
-      orchestration-status:
+        description: the ASDC model id for this resource or service model.
+      model-version-id:
         type: string
-        description: Orchestration status of this VNF, mastered by MSO
-      heat-stack-id:
+        description: the ASDC model version for this resource or service model.
+      persona-model-version:
         type: string
-        description: Heat stack id corresponding to this instance, managed by MSO
-      mso-catalog-key:
+        description: the ASDC model version for this resource or service model.
+      widget-model-id:
         type: string
-        description: Corresponds to the SDN-C catalog id used to configure this VCE
-      vpe-id:
+        description: the ASDC data dictionary widget model. This maps directly to the A&AI widget.
+      widget-model-version:
         type: string
-        description: Unique ID of VPE connected to this VCE.
-      v6-vce-wan-address:
+        description: the ASDC data dictionary version of the widget model.This maps directly to the A&AI version of the widget.
+      bandwidth-total:
         type: string
-        description: Valid v6 IP address for the WAN Link on this router.  Implied length of /64.
-      ipv4-oam-address:
+        description: Indicates the total bandwidth to be used for this service.
+      bandwidth-up-wan1:
         type: string
-        description: Address tail-f uses to configure vce, also used for troubleshooting and is IP used for traps generated by VCE.
+        description: indicates the upstream bandwidth this service will use on the WAN1 port of the physical device.
+      bandwidth-down-wan1:
+        type: string
+        description: indicates the downstream bandwidth this service will use on the WAN1 port of the physical device.
+      bandwidth-up-wan2:
+        type: string
+        description: indicates the upstream bandwidth this service will use on the WAN2 port of the physical device.
+      bandwidth-down-wan2:
+        type: string
+        description: indicates the downstream bandwidth this service will use on the WAN2 port of the physical device.
+      vhn-portal-url:
+        type: string
+        description: URL customers will use to access the vHN Portal.
+      service-instance-location-id:
+        type: string
+        description: An identifier that customers assign to the location where this service is being used.
       resource-version:
         type: string
         description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
-      ipv4-loopback0-address:
+      selflink:
         type: string
-        description: Loopback0 address
-      entitlement-resource-uuid:
+        description: Path to the controller object.
+      orchestration-status:
         type: string
-        description: OBSOLETE -  see child relationships
-      port-groups:
-        type: array
-        items:
-          $ref: "#/definitions/port-group"
-      licenses:
+        description: Orchestration status of this service.
+      relationship-list:
         type: array
         items:
-          $ref: "#/definitions/license"
-      entitlements:
+          $ref: "#/getDefinitions/relationship"
+      metadata:
         type: array
         items:
-          $ref: "#/definitions/entitlement"
-      relationship-list:
+          $ref: "#/getDefinitions/metadatum"
+      allotted-resources:
         type: array
         items:
-          $ref: "#/definitions/relationship"
-  vces:
+          $ref: "#/getDefinitions/allotted-resource"
+  service-instances:
     description: |
-      Collection of Virtual Customer Edge Routers, used specifically for Gamma.  This object is deprecated.
+      Collection of service instances
     properties:
-      vce:
+      service-instance:
         type: array
         items:          
-          $ref: "#/definitions/vce"
-  vnfc:
+          $ref: "#/getDefinitions/service-instance"
+  service-subscription:
     description: |
-      ###### Default Delete Scope
-      THIS_NODE_ONLY
+      Object that group service instances.
       ###### Related Nodes
-      - TO instance-group (Many2Many)
-      - FROM vserver
-      - FROM vf-module
-      - FROM generic-vnf
+      - TO customer( service-subscription org.onap.relationships.inventory.BelongsTo customer, MANY2ONE)
+      - TO tenant( service-subscription org.onap.relationships.inventory.Uses tenant, MANY2MANY)
+      - FROM service-instance( service-instance org.onap.relationships.inventory.BelongsTo service-subscription, MANY2ONE)
+      - SERVICE-SUBSCRIPTION is DELETED when these are DELETED SERVICE-INSTANCE
     required:
-    - vnfc-name
-    - nfc-naming-code
-    - nfc-function
-    - in-maint
-    - is-closed-loop-disabled
+    - service-type
     properties:
-      vnfc-name:
-        type: string
-        description: Unique ID of vnfc.
-      nfc-naming-code:
-        type: string
-        description: Short code that is used in naming instances of the item being modeled
-      nfc-function:
-        type: string
-        description: English description of function that the specific resource deployment is providing. Assigned as part of the customization of a resource in a service
-      prov-status:
-        type: string
-        description: prov status of this vnfc
-      orchestration-status:
-        type: string
-        description: Orchestration status of this VNF, mastered by APP-C
-      ipaddress-v4-oam-vip:
-        type: string
-        description: Oam V4 vip address of this vnfc
-      in-maint:
-        type: boolean
-      is-closed-loop-disabled:
-        type: boolean
-      group-notation:
-        type: string
-        description: Group notation of VNFC
-      model-invariant-id:
+      service-type:
         type: string
-        description: the ASDC model id for this resource or service model.
-      model-version-id:
+        description: Value defined by orchestration to identify this service across ECOMP.
+      temp-ub-sub-account-id:
         type: string
-        description: the ASDC model version for this resource or service model.
+        description: This property will be deleted from A&AI in the near future. Only stop gap solution.
       resource-version:
         type: string
         description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      service-instances:
+        type: array
+        items:
+          $ref: "#/getDefinitions/service-instance"
       relationship-list:
         type: array
         items:
-          $ref: "#/definitions/relationship"
-  vnfcs:
+          $ref: "#/getDefinitions/relationship"
+  service-subscriptions:
     description: |
-      virtual network components associated with a vserver from application controller.
+      Collection of objects that group service instances.
     properties:
-      vnfc:
+      service-subscription:
         type: array
         items:          
-          $ref: "#/definitions/vnfc"
-  subnet:
+          $ref: "#/getDefinitions/service-subscription"
+  services:
+    description: |
+      Collection of service model definitions.  Likely to be deprecated in favor of models from ASDC.
+    properties:
+      service:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/service"
+  site-pair:
     description: |
-      ###### Default Delete Scope
-      ERROR_IF_ANY_IN_EDGES
       ###### Related Nodes
-      - FROM l3-interface-ipv4-address-list
-      - FROM l3-interface-ipv6-address-list
-      - FROM l3-network (is composed of subnet)
+      - TO routing-instance( site-pair org.onap.relationships.inventory.BelongsTo routing-instance, MANY2ONE)
+      - FROM class-of-service( class-of-service org.onap.relationships.inventory.BelongsTo site-pair, MANY2ONE)
+      - SITE-PAIR is DELETED when these are DELETED CLASS-OF-SERVICE
     required:
-    - subnet-id
-    - dhcp-enabled
+    - site-pair-id
     properties:
-      subnet-id:
-        type: string
-        description: Subnet ID, should be UUID.
-      subnet-name:
-        type: string
-        description: Name associated with the subnet.
-      neutron-subnet-id:
-        type: string
-        description: Neutron id of this subnet
-      gateway-address:
+      site-pair-id:
         type: string
-        description: gateway ip address
-      network-start-address:
+        description: unique identifier of probe
+      source-ip:
         type: string
-        description: network start address
-      cidr-mask:
+        description: Prefix address
+      destination-ip:
         type: string
-        description: cidr mask
+        description: Prefix address
       ip-version:
         type: string
-        description: ip version
-      orchestration-status:
-        type: string
-        description: Orchestration status of this VNF, mastered by MSO
-      dhcp-enabled:
-        type: boolean
-      dhcp-start:
-        type: string
-        description: the start address reserved for use by dhcp
-      dhcp-end:
+        description: ip version, v4, v6
+      destination-hostname:
         type: string
-        description: the last address reserved for use by dhcp
-      subnet-role:
+        description: Hostname of the destination equipment to which SLAs are measured against.
+      destination-equip-type:
         type: string
-        description: role of the subnet, referenced when assigning IPs
+        description: The type of destinatination equipment. Could be Router, UCPE, etc.
       resource-version:
         type: string
         description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
-      relationship-list:
+      classes-of-service:
         type: array
         items:
-          $ref: "#/definitions/relationship"
-  subnets:
-    properties:
-      subnet:
+          $ref: "#/getDefinitions/class-of-service"
+      relationship-list:
         type: array
-        items:          
-          $ref: "#/definitions/subnet"
-  ctag-assignment:
+        items:
+          $ref: "#/getDefinitions/relationship"
+  site-pair-set:
     description: |
-      ###### Default Delete Scope
-      THIS_NODE_ONLY
+      Set of instances for probes used to measure service level agreements
       ###### Related Nodes
-      - FROM l3-network (is composed of ctag-assignment)
-      - FROM service-instance
+      - TO generic-vnf( site-pair-set org.onap.relationships.inventory.AppliesTo generic-vnf, MANY2MANY)
+      - FROM routing-instance( routing-instance org.onap.relationships.inventory.BelongsTo site-pair-set, MANY2ONE)
+      - SITE-PAIR-SET is DELETED when these are DELETED ROUTING-INSTANCE
     required:
-    - vlan-id-inner
+    - site-pair-set-id
     properties:
-      vlan-id-inner:
-        type: integer
-        format: int64
-        description: id.
+      site-pair-set-id:
+        type: string
+        description: Unique id of site pair set.
       resource-version:
         type: string
         description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
-      relationship-list:
+      routing-instances:
         type: array
         items:
-          $ref: "#/definitions/relationship"
-  ctag-assignments:
-    properties:
-      ctag-assignment:
+          $ref: "#/getDefinitions/routing-instance"
+      relationship-list:
         type: array
-        items:          
-          $ref: "#/definitions/ctag-assignment"
-  segmentation-assignment:
+        items:
+          $ref: "#/getDefinitions/relationship"
+  site-pair-sets:
     description: |
-      Openstack segmentation assignment.
-      ###### Default Delete Scope
-      THIS_NODE_ONLY
-      ###### Related Nodes
-      - FROM l3-network (is composed of segmentation-assignment)
-    required:
-    - segmentation-id
+      Collection of sets of instances for probes related to generic-vnf
     properties:
-      segmentation-id:
-        type: string
-        description: Route Table Reference id, UUID assigned to this instance.
-      resource-version:
-        type: string
-        description: Concurrency value
-      relationship-list:
+      site-pair-set:
         type: array
-        items:
-          $ref: "#/definitions/relationship"
-  segmentation-assignments:
+        items:          
+          $ref: "#/getDefinitions/site-pair-set"
+  site-pairs:
     description: |
-      Collection of openstack segmentation assignments
+      probe within a set
     properties:
-      segmentation-assignment:
+      site-pair:
         type: array
         items:          
-          $ref: "#/definitions/segmentation-assignment"
-  l3-network:
+          $ref: "#/getDefinitions/site-pair"
+  snapshot:
     description: |
-      Generic network definition
-      ###### Default Delete Scope
-      CASCADE_TO_CHILDREN
-      ###### Related Nodes
-      - TO vpn-binding (Many2Many)
-      - TO instance-group (Many2Many)
-      - TO subnet (comprises l3-network, Many2Many)
-      - TO service-instance (Many2Many)
-      - TO ctag-assignment (comprises l3-network, Many2Many)
-      - TO network-policy (Many2Many)
-      - TO segmentation-assignment (comprises l3-network, One2Many)
-      - TO route-table-reference (Many2Many)
-      - FROM cloud-region
-      - FROM complex
-      - FROM generic-vnf
-      - FROM l3-interface-ipv4-address-list
-      - FROM l3-interface-ipv6-address-list
-      - FROM tenant
-      - FROM vf-module
-      - FROM allotted-resource
+      Openstack snapshot
+      ###### Related Nodes
+      - TO cloud-region( snapshot org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE)
+      - FROM vserver( vserver org.onap.relationships.inventory.Uses snapshot, ONE2ONE)
     required:
-    - network-id
-    - network-name
-    - is-bound-to-vpn
-    - is-provider-network
-    - is-shared-network
-    - is-external-network
+    - snapshot-id
     properties:
-      network-id:
-        type: string
-        description: Network ID, should be uuid. Unique across A&AI.
-      network-name:
-        type: string
-        description: Name of the network, governed by some naming convention..
-      network-type:
-        type: string
-        description: Type of the network - who defines these values?
-      network-role:
-        type: string
-        description: Role the network plans - who defines these values?
-      network-technology:
-        type: string
-        description: Network technology - who defines these values?
-      neutron-network-id:
-        type: string
-        description: Neutron network id of this Interface
-      is-bound-to-vpn:
-        type: boolean
-      service-id:
-        type: string
-        description: Unique identifier of service from ASDC.  Does not strictly map to ASDC services.  SOON TO BE DEPRECATED
-      network-role-instance:
-        type: integer
-        format: int64
-        description: network role instance
-      resource-version:
-        type: string
-        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
-      orchestration-status:
-        type: string
-        description: Orchestration status of this VNF, mastered by MSO
-      heat-stack-id:
-        type: string
-        description: Heat stack id corresponding to this instance, managed by MSO
-      mso-catalog-key:
-        type: string
-        description: Corresponds to the SDN-C catalog id used to configure this VCE
-      contrail-network-fqdn:
-        type: string
-        description: Contrail FQDN for the network
-      model-invariant-id:
+      snapshot-id:
         type: string
-        description: the ASDC model id for this resource or service model.
-      model-version-id:
+        description: Snapshot id, this is the key UUID assoc associated in glance with the snapshots.
+      snapshot-name:
         type: string
-        description: the ASDC model version for this resource or service model.
-      persona-model-version:
+        description: Snapshot name
+      snapshot-architecture:
         type: string
-        description: the ASDC model version for this resource or service model.
-      model-customization-id:
+        description: Operating system architecture
+      snapshot-os-distro:
         type: string
-        description: captures the id of all the configuration used to customize the resource for the service.
-      widget-model-id:
+        description: The common name of the operating system distribution in lowercase
+      snapshot-os-version:
         type: string
-        description: the ASDC data dictionary widget model. This maps directly to the A&AI widget.
-      widget-model-version:
+        description: The operating system version as specified by the distributor.
+      application:
         type: string
-        description: the ASDC data dictionary version of the widget model.This maps directly to the A&AI version of the widget.
-      physical-network-name:
+        description: The application that the image instantiates.
+      application-vendor:
         type: string
-        description: Name associated with the physical network.
-      is-provider-network:
-        type: boolean
-      is-shared-network:
-        type: boolean
-      is-external-network:
-        type: boolean
-      selflink:
+        description: The vendor of the application.
+      application-version:
         type: string
-        description: Path to the controller object.
-      operational-status:
+        description: The version of the application.
+      snapshot-selflink:
         type: string
-        description: Indicator for whether the resource is considered operational.
-      subnets:
-        type: array
-        items:
-          $ref: "#/definitions/subnet"
-      ctag-assignments:
-        type: array
-        items:
-          $ref: "#/definitions/ctag-assignment"
-      segmentation-assignments:
-        type: array
-        items:
-          $ref: "#/definitions/segmentation-assignment"
+        description: URL to endpoint where AAI can get more details
+      prev-snapshot-id:
+        type: string
+        description: This field contains the UUID of the previous snapshot (if any).
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
       relationship-list:
         type: array
         items:
-          $ref: "#/definitions/relationship"
-        description: Relates to tenant (or is it a child of tenant), complex, service, vpn-binding
-  l3-networks:
+          $ref: "#/getDefinitions/relationship"
+  snapshots:
+    description: |
+      Collection of openstack snapshots
     properties:
-      l3-network:
+      snapshot:
         type: array
         items:          
-          $ref: "#/definitions/l3-network"
-  network-policy:
+          $ref: "#/getDefinitions/snapshot"
+  sriov-pf:
     description: |
-      ###### Default Delete Scope
-      THIS_NODE_ONLY
+      SR-IOV Physical Function
       ###### Related Nodes
-      - FROM l3-network
-      - FROM allotted-resource
+      - TO p-interface( sriov-pf org.onap.relationships.inventory.BelongsTo p-interface, ONE2ONE)
+      - FROM sriov-vf( sriov-vf org.onap.relationships.inventory.Uses sriov-pf, MANY2ONE)
     required:
-    - network-policy-id
+    - pf-pci-id
     properties:
-      network-policy-id:
-        type: string
-        description: UUID representing unique key to this instance
-      network-policy-fqdn:
-        type: string
-        description: Contrail FQDN for the policy
-      heat-stack-id:
+      pf-pci-id:
         type: string
-        description: ID for the openStack Heat instance
+        description: Identifier for the sriov-pf
       resource-version:
         type: string
         description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
       relationship-list:
         type: array
         items:
-          $ref: "#/definitions/relationship"
-  network-policies:
+          $ref: "#/getDefinitions/relationship"
+  sriov-pfs:
+    description: |
+      Collection of SR-IOV Physical Functions.
     properties:
-      network-policy:
+      sriov-pf:
         type: array
         items:          
-          $ref: "#/definitions/network-policy"
-  vf-module:
+          $ref: "#/getDefinitions/sriov-pf"
+  sriov-vf:
     description: |
-      a deployment unit of VNFCs
-      ###### Default Delete Scope
-      THIS_NODE_ONLY
+      SR-IOV Virtual Function (not to be confused with virtual network function)
       ###### Related Nodes
-      - TO volume-group (One2One)
-      - TO l3-network (Many2Many)
-      - TO vnfc (One2Many)
-      - FROM vserver
-      - FROM generic-vnf (is composed of vf-module)
+      - TO l-interface( sriov-vf org.onap.relationships.inventory.BelongsTo l-interface, ONE2ONE)
+      - TO sriov-pf( sriov-vf org.onap.relationships.inventory.Uses sriov-pf, MANY2ONE)
     required:
-    - vf-module-id
-    - is-base-vf-module
+    - pci-id
     properties:
-      vf-module-id:
+      pci-id:
         type: string
-        description: Unique ID of vf-module.
-      vf-module-name:
+        description: PCI ID used to identify the sriov-vf
+      vf-vlan-filter:
         type: string
-        description: Name of vf-module
-      heat-stack-id:
+        description: This metadata provides option to specify list of VLAN filters applied on VF to pass the traffic to VM.
+      vf-mac-filter:
         type: string
-        description: Heat stack id corresponding to this instance.
-      orchestration-status:
+        description: When MAC filters are specified, VF-agent service configures VFs to do MAC level filtering before the traffic is passed to VM.
+      vf-vlan-strip:
+        type: boolean
+        description: When this field is set to true, VF will configured to strip the outer TAG before the traffic is passed to VM.
+      vf-vlan-anti-spoof-check:
+        type: boolean
+        description: This option ensures anti VLAN spoof checks are done at the VF level to comply with security. The disable check will also be honored per the VNF needs for trusted VMs.
+      vf-mac-anti-spoof-check:
+        type: boolean
+        description: This option ensures anti MAC spoof checks are done at the VF level to comply with security. The disable check will also be honored per the VNF needs for trusted VMs.
+      vf-mirrors:
         type: string
-        description: orchestration status of this vf-module, mastered by MSO
-      is-base-vf-module:
+        description: This option defines the set of Mirror objects which essentially mirrors the traffic from source to set of collector VNF Ports.
+      vf-broadcast-allow:
+        type: boolean
+        description: This option, if set to true, sets the VF in promiscuous mode and allows all broadcast traffic to reach the VM
+      vf-unknown-multicast-allow:
+        type: boolean
+        description: This option, if set to true, sets the VF in promiscuous mode and allows unknown multicast traffic to reach the VM
+      vf-unknown-unicast-allow:
+        type: boolean
+        description: This option, if set to true, sets the VF in promiscuous mode and allows unknown unicast traffic to reach the VM
+      vf-insert-stag:
         type: boolean
+        description: This option, if set to true, instructs to insert outer tag after traffic comes out of VM.
+      vf-link-status:
+        type: string
+        description: This option is used to set the link status.  Valid values as of 1607 are on, off, and auto.
       resource-version:
         type: string
         description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
-      model-invariant-id:
-        type: string
-        description: the ASDC model id for this resource or service model.
-      model-version-id:
-        type: string
-        description: the ASDC model version for this resource or service model.
-      persona-model-version:
-        type: string
-        description: the ASDC model version for this resource or service model.
-      model-customization-id:
-        type: string
-        description: captures the id of all the configuration used to customize the resource for the service.
-      widget-model-id:
-        type: string
-        description: the ASDC data dictionary widget model. This maps directly to the A&AI widget.
-      widget-model-version:
-        type: string
-        description: the ASDC data dictionary version of the widget model.This maps directly to the A&AI version of the widget.
-      contrail-service-instance-fqdn:
-        type: string
-        description: the Contrail unique ID for a service-instance
-      module-index:
-        type: integer
-        format: int32
-        description: the index will track the number of modules of a given type that have been deployed in a VNF, starting with 0, and always choosing the lowest available digit
-      selflink:
+      neutron-network-id:
         type: string
-        description: Path to the controller object.
+        description: Neutron network id of the interface
       relationship-list:
         type: array
         items:
-          $ref: "#/definitions/relationship"
-  vf-modules:
+          $ref: "#/getDefinitions/relationship"
+  sriov-vfs:
     description: |
-      Collection of vf-modules, a deployment unit of VNFCs
+      Collection of SR-IOV Virtual Functions.
     properties:
-      vf-module:
+      sriov-vf:
         type: array
         items:          
-          $ref: "#/definitions/vf-module"
-  generic-vnf:
-    description: |
-      General purpose VNF
-      ###### Default Delete Scope
-      CASCADE_TO_CHILDREN
-      ###### Related Nodes
-      - TO license-key-resource (Many2Many)
-      - TO l-interface (comprises generic-vnf, Many2Many)
-      - TO availability-zone (Many2Many)
-      - TO lag-interface (comprises generic-vnf, Many2Many)
-      - TO l3-network (Many2Many)
-      - TO pserver (Many2Many)
-      - TO vnf-image (Many2One)
-      - TO vserver (One2Many)
-      - TO service-instance (Many2Many)
-      - TO site-pair-set (Many2Many)
-      - TO network-profile (Many2Many)
-      - TO pnf (Many2Many)
-      - TO ipsec-configuration (Many2One)
-      - TO vf-module (comprises generic-vnf, One2Many)
-      - TO volume-group (One2Many)
-      - TO vnfc (One2Many)
-      - TO instance-group (Many2Many)
-      - TO entitlement (comprises generic-vnf, One2Many)
-      - TO license (comprises generic-vnf, One2Many)
-      - TO complex (Many2Many)
-      - TO ctag-pool (Many2Many)
-      - FROM virtual-data-center
-      - FROM logical-link
-      - FROM allotted-resource
-    required:
-    - vnf-id
-    - vnf-name
-    - vnf-type
-    - in-maint
-    - is-closed-loop-disabled
+          $ref: "#/getDefinitions/sriov-vf"
+  start-node-filter:
     properties:
-      vnf-id:
-        type: string
-        description: Unique id of VNF.  This is unique across the graph.
-      vnf-name:
+      property-name:
         type: string
-        description: Name of VNF.
-      vnf-name2:
+      property-value:
         type: string
-        description: Alternate name of VNF.
-      vnf-type:
+  subnet:
+    description: |
+      ###### Related Nodes
+      - TO l3-network( subnet org.onap.relationships.inventory.BelongsTo l3-network, MANY2ONE)
+      - FROM l3-interface-ipv4-address-list( l3-interface-ipv4-address-list org.onap.relationships.inventory.network.MemberOf subnet, MANY2MANY)
+      - FROM l3-interface-ipv6-address-list( l3-interface-ipv6-address-list org.onap.relationships.inventory.network.MemberOf subnet, MANY2MANY)
+      - FROM host-route( host-route org.onap.relationships.inventory.BelongsTo subnet, MANY2ONE)
+      - FROM vip-ipv4-address-list( vip-ipv4-address-list org.onap.relationships.inventory.MemberOf subnet, MANY2MANY)
+      - FROM vip-ipv6-address-list( vip-ipv6-address-list org.onap.relationships.inventory.MemberOf subnet, MANY2MANY)
+      - SUBNET cannot be deleted if linked to L3-INTERFACE-IPV4-ADDRESS-LIST,L3-INTERFACE-IPV6-ADDRESS-LIST,VIP-IPV4-ADDRESS-LIST,VIP-IPV6-ADDRESS-LIST
+      - SUBNET is DELETED when these are DELETED HOST-ROUTE
+    required:
+    - subnet-id
+    - dhcp-enabled
+    properties:
+      subnet-id:
         type: string
-        description: String capturing type of vnf, that was intended to identify the ASDC resource.  This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures.
-      service-id:
+        description: Subnet ID, should be UUID.
+      subnet-name:
         type: string
-        description: Unique identifier of service, does not necessarily map to ASDC service models.  SOON TO BE DEPRECATED
-      regional-resource-zone:
+        description: Name associated with the subnet.
+      neutron-subnet-id:
         type: string
-        description: Regional way of organizing pservers, source of truth should define values
-      prov-status:
+        description: Neutron id of this subnet
+      gateway-address:
         type: string
-        description: Trigger for operational monitoring of this resource by Service Assurance systems.
-      operational-status:
+        description: gateway ip address
+      network-start-address:
         type: string
-        description: Indicator for whether the resource is considered operational.  Valid values are in-service-path and out-of-service-path.
-      license-key:
+        description: network start address
+      cidr-mask:
         type: string
-        description: OBSOLETE -  do not use
-      equipment-role:
+        description: cidr mask
+      ip-version:
         type: string
-        description: Client should send valid enumerated value
+        description: ip version
       orchestration-status:
         type: string
-        description: Orchestration status of this VNF, used by MSO.
-      heat-stack-id:
-        type: string
-        description: Heat stack id corresponding to this instance, managed by MSO
-      mso-catalog-key:
-        type: string
-        description: Corresponds to the SDN-C catalog id used to configure this VCE
-      management-option:
-        type: string
-        description: identifier of managed by ATT or customer
-      ipv4-oam-address:
-        type: string
-        description: Address tail-f uses to configure generic-vnf, also used for troubleshooting and is IP used for traps generated by generic-vnf.
-      ipv4-loopback0-address:
-        type: string
-        description: v4 Loopback0 address
-      nm-lan-v6-address:
-        type: string
-        description: v6 Loopback address
-      management-v6-address:
+        description: Orchestration status of this VNF, mastered by MSO
+      dhcp-enabled:
+        type: boolean
+      dhcp-start:
         type: string
-        description: v6 management address
-      vcpu:
-        type: integer
-        format: int64
-        description: number of vcpus ordered for this instance of VNF, used for VNFs with no vservers/flavors, to be used only by uCPE
-      vcpu-units:
+        description: the start address reserved for use by dhcp
+      dhcp-end:
         type: string
-        description: units associated with vcpu, used for VNFs with no vservers/flavors, to be used only by uCPE
-      vmemory:
-        type: integer
-        format: int64
-        description: number of GB of memory ordered for this instance of VNF, used for VNFs with no vservers/flavors, to be used only by uCPE
-      vmemory-units:
+        description: the last address reserved for use by dhcp
+      subnet-role:
         type: string
-        description: units associated with vmemory, used for VNFs with no vservers/flavors, to be used only by uCPE
-      vdisk:
-        type: integer
-        format: int64
-        description: number of vdisks ordered for this instance of VNF, used for VNFs with no vservers/flavors, to be used only uCPE
-      vdisk-units:
+        description: role of the subnet, referenced when assigning IPs
+      ip-assignment-direction:
         type: string
-        description: units associated with vdisk, used for VNFs with no vservers/flavors, to be used only by uCPE
-      in-maint:
-        type: boolean
-      is-closed-loop-disabled:
-        type: boolean
+        description: ip address assignment direction of the subnet
       resource-version:
         type: string
         description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
-      summary-status:
-        type: string
-        description: details regarding the generic-vnf operation, PLEASE DISCONTINUE USE OF THIS FIELD.
-      encrypted-access-flag:
-        type: boolean
-        description: indicates whether generic-vnf access uses SSH
-      entitlement-assignment-group-uuid:
-        type: string
-        description: UUID of the Entitlement group used for licensing VNFs, OBSOLETE -  See child relationships.
-      entitlement-resource-uuid:
-        type: string
-        description: UUID of the specific entitlement resource.  OBSOLETE -  See child relationships.
-      license-assignment-group-uuid:
-        type: string
-        description: UUID of the license assignment group.  OBSOLETE -  See child relationships.
-      license-key-uuid:
-        type: string
-        description: UUID of the actual license resource.  OBSOLETE -  See child relationships.
-      model-invariant-id:
-        type: string
-        description: the ASDC model id for this resource or service model.
-      model-version-id:
-        type: string
-        description: the ASDC model version for this resource or service model.
-      persona-model-version:
-        type: string
-        description: the ASDC model version for this resource or service model.
-      model-customization-id:
-        type: string
-        description: captures the id of all the configuration used to customize the resource for the service.
-      widget-model-id:
-        type: string
-        description: the ASDC data dictionary widget model. This maps directly to the A&AI widget.
-      widget-model-version:
-        type: string
-        description: the ASDC data dictionary version of the widget model.This maps directly to the A&AI version of the widget.
-      as-number:
-        type: string
-        description: as-number of the VNF
-      regional-resource-subzone:
-        type: string
-        description: represents sub zone of the rr plane
-      nf-type:
-        type: string
-        description: Generic description of the type of NF
-      nf-function:
-        type: string
-        description: English description of Network function that the specific VNF deployment is providing
-      nf-role:
-        type: string
-        description: role in the network that this model will be providing
-      nf-naming-code:
-        type: string
-        description: string assigned to this model used for naming purposes
-      selflink:
-        type: string
-        description: Path to the controller object.
-      ipv4-oam-gateway-address:
-        type: string
-        description: Gateway address
-      ipv4-oam-gateway-address-prefix-length:
+      subnet-sequence:
         type: integer
         format: int32
-        description: Prefix length for oam-address
-      vlan-id-outer:
-        type: integer
-        format: int64
-        description: Temporary location for S-TAG to get to VCE
-      nm-profile-name:
-        type: string
-        description: Network Management profile of this VNF
-      relationship-list:
+        description: sequence of the subnet
+      host-routes:
         type: array
         items:
-          $ref: "#/definitions/relationship"
-      l-interfaces:
+          $ref: "#/getDefinitions/host-route"
+      relationship-list:
         type: array
         items:
-          $ref: "#/definitions/l-interface"
-      lag-interfaces:
+          $ref: "#/getDefinitions/relationship"
+  subnets:
+    properties:
+      subnet:
         type: array
-        items:
-          $ref: "#/definitions/lag-interface"
-      vf-modules:
+        items:          
+          $ref: "#/getDefinitions/subnet"
+  tagged-inventory-item-list:
+    properties:
+      inventory-item:
         type: array
-        items:
-          $ref: "#/definitions/vf-module"
-      licenses:
+        items:          
+          $ref: "#/getDefinitions/inventory-item"
+  tenant:
+    description: |
+      Openstack tenant
+      ###### Related Nodes
+      - TO cloud-region( tenant org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE)
+      - TO group-assignment( tenant org.onap.relationships.inventory.MemberOf group-assignment, MANY2MANY)
+      - TO l3-network( tenant org.onap.relationships.inventory.Uses l3-network, MANY2MANY)
+      - TO volume-group( tenant org.onap.relationships.inventory.DependsOn volume-group, ONE2MANY)
+      - FROM service-subscription( service-subscription org.onap.relationships.inventory.Uses tenant, MANY2MANY)
+      - FROM vserver( vserver org.onap.relationships.inventory.BelongsTo tenant, MANY2ONE)
+      - TENANT cannot be deleted if linked to VSERVER
+    required:
+    - tenant-id
+    - tenant-name
+    properties:
+      tenant-id:
+        type: string
+        description: Unique id relative to the cloud-region.
+      tenant-name:
+        type: string
+        description: Readable name of tenant
+      tenant-context:
+        type: string
+        description: This field will store the tenant context.
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      vservers:
         type: array
         items:
-          $ref: "#/definitions/license"
-      entitlements:
+          $ref: "#/getDefinitions/vserver"
+      relationship-list:
         type: array
         items:
-          $ref: "#/definitions/entitlement"
-  generic-vnfs:
+          $ref: "#/getDefinitions/relationship"
+  tenants:
     description: |
-      Collection of VNFs
+      Collection of openstack tenants.
     properties:
-      generic-vnf:
+      tenant:
         type: array
         items:          
-          $ref: "#/definitions/generic-vnf"
-  lag-link:
+          $ref: "#/getDefinitions/tenant"
+  tunnel-xconnect:
     description: |
-      LAG links can connect lag-interfaces
-      ###### Default Delete Scope
-      THIS_NODE_ONLY
+      Represents the specifics of a tunnel cross connect piece of a resource that gets separately allotted
       ###### Related Nodes
-      - FROM lag-interface
-      - FROM logical-link
+      - TO allotted-resource( tunnel-xconnect org.onap.relationships.inventory.BelongsTo allotted-resource, ONE2ONE)
     required:
-    - link-name
+    - id
+    - bandwidth-up-wan1
+    - bandwidth-down-wan1
+    - bandwidth-up-wan2
+    - bandwidth-down-wan2
     properties:
-      link-name:
+      id:
         type: string
-        description: Alphabetical concatenation of lag-interface names
+        description: Allotted Resource id UUID assigned to this instance.
+      bandwidth-up-wan1:
+        type: string
+        description: The WAN uplink bandwidth for WAN1
+      bandwidth-down-wan1:
+        type: string
+        description: The WAN downlink bandwidth for WAN1
+      bandwidth-up-wan2:
+        type: string
+        description: The WAN uplink bandwidth for WAN2
+      bandwidth-down-wan2:
+        type: string
+        description: The WAN downlink bandwidth for WAN2
       resource-version:
         type: string
-        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+        description: Concurrency value
       relationship-list:
         type: array
         items:
-          $ref: "#/definitions/relationship"
-  lag-links:
+          $ref: "#/getDefinitions/relationship"
+  tunnel-xconnects:
     description: |
-      Collection of link aggregation connections
+      This object is used to store the specific tunnel cross connect aspects of an allotted resource
     properties:
-      lag-link:
+      tunnel-xconnect:
         type: array
         items:          
-          $ref: "#/definitions/lag-link"
-  newvce:
+          $ref: "#/getDefinitions/tunnel-xconnect"
+  update:
     description: |
-      This object fills in the gaps from vce that were incorporated into generic-vnf.  This object will be retired with vce.
-      ###### Default Delete Scope
-      CASCADE_TO_CHILDREN
+      Serves a PATCH like function.  Does not enforce concurrency control.  Clear each usage with AAI team.
+    required:
+    - update-node-type
+    properties:
+      update-node-type:
+        type: string
+      update-node-key:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/update-node-key"
+      update-node-uri:
+        type: string
+      action:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/action"
+  update-node-key:
+    properties:
+      key-name:
+        type: string
+      key-value:
+        type: string
+  vce:
+    description: |
+      Virtual Customer Edge Router, used specifically for Gamma.  This object is deprecated.
       ###### Related Nodes
-      - TO l-interface (comprises newvce, Many2Many)
+      - TO availability-zone( vce org.onap.relationships.inventory.Uses availability-zone, MANY2MANY)
+      - TO complex( vce org.onap.relationships.inventory.LocatedIn complex, MANY2MANY)
+      - TO vserver( vce tosca.relationships.HostedOn vserver, ONE2MANY)
+      - FROM entitlement( entitlement org.onap.relationships.inventory.BelongsTo vce, MANY2ONE)
+      - FROM license( license org.onap.relationships.inventory.BelongsTo vce, MANY2ONE)
+      - FROM port-group( port-group org.onap.relationships.inventory.BelongsTo vce, MANY2ONE)
+      - FROM service-instance( service-instance org.onap.relationships.inventory.ComposedOf vce, ONE2MANY)
+      - VCE is DELETED when these are DELETED ENTITLEMENT,LICENSE,PORT-GROUP
     required:
-    - vnf-id2
+    - vnf-id
     - vnf-name
     - vnf-type
     properties:
-      vnf-id2:
+      vnf-id:
         type: string
-        description: Unique id of VNF, can't use same attribute name right now until we promote this new object
+        description: Unique id of VNF.  This is unique across the graph.
       vnf-name:
         type: string
         description: Name of VNF.
@@ -42742,222 +66946,151 @@ definitions:
       vnf-type:
         type: string
         description: String capturing type of vnf, that was intended to identify the ASDC resource.  This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures.
+      service-id:
+        type: string
+        description: Unique identifier of service, does not strictly map to ASDC services, SOON TO BE DEPRECATED.
+      regional-resource-zone:
+        type: string
+        description: Regional way of organizing pservers, source of truth should define values
       prov-status:
         type: string
-        description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems.
+        description: Trigger for operational monitoring of this resource by Service Assurance systems.
       operational-status:
         type: string
         description: Indicator for whether the resource is considered operational
       license-key:
         type: string
         description: OBSOLETE -  do not use
-      ipv4-oam-address:
-        type: string
-        description: Address tail-f uses to configure generic-vnf, also used for troubleshooting and is IP used for traps generated by GenericVnf (v4-loopback0-ip-address).
       equipment-role:
         type: string
-        description: Client should send valid enumerated value.
-      resource-version:
-        type: string
-        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
-      ipv4-loopback0-address:
-        type: string
-        description: v4 Loopback0 address
+        description: Network role being played by this VNF
       orchestration-status:
         type: string
-        description: Orchestration status of this VNF, mastered by MSO.
+        description: Orchestration status of this VNF, mastered by MSO
       heat-stack-id:
         type: string
         description: Heat stack id corresponding to this instance, managed by MSO
       mso-catalog-key:
         type: string
         description: Corresponds to the SDN-C catalog id used to configure this VCE
-      relationship-list:
-        type: array
-        items:
-          $ref: "#/definitions/relationship"
-      l-interfaces:
-        type: array
-        items:
-          $ref: "#/definitions/l-interface"
-  newvces:
-    description: |
-      This object fills in the gaps from vce that were incorporated into generic-vnf.  This object will be retired with vce.
-    properties:
-      newvce:
-        type: array
-        items:          
-          $ref: "#/definitions/newvce"
-  pnf:
-    description: |
-      PNF represents a physical network function. typically equipment used in the D1 world. in 1607, this will be populated by SDN-C to represent a premises router that a uCPE connects to. But this can be used to represent any physical device that is not an AIC node or uCPE.
-      ###### Default Delete Scope
-      CASCADE_TO_CHILDREN
-      ###### Related Nodes
-      - TO p-interface (comprises pnf, Many2Many)
-      - TO lag-interface (comprises pnf, One2Many)
-      - TO complex (Many2One)
-      - TO instance-group (Many2Many)
-      - TO zone (Many2One)
-      - FROM generic-vnf
-      - FROM logical-link
-      - FROM service-instance
-    required:
-    - pnf-name
-    - in-maint
-    properties:
-      pnf-name:
-        type: string
-        description: unique name of Physical Network Function.
-      pnf-name2:
-        type: string
-        description: name of Physical Network Function.
-      pnf-name2-source:
-        type: string
-        description: source of name2
-      pnf-id:
-        type: string
-        description: id of pnf
-      equip-type:
-        type: string
-        description: Equipment type.  Source of truth should define valid values.
-      equip-vendor:
-        type: string
-        description: Equipment vendor.  Source of truth should define valid values.
-      equip-model:
-        type: string
-        description: Equipment model.  Source of truth should define valid values.
-      management-option:
-        type: string
-        description: identifier of managed by ATT or customer
-      ipaddress-v4-oam:
-        type: string
-        description: ipv4-oam-address with new naming convention for IP addresses
-      sw-version:
-        type: string
-        description: sw-version is the version of SW for the hosted application on the PNF.
-      in-maint:
-        type: boolean
-      frame-id:
-        type: string
-        description: ID of the physical frame (relay rack) where pnf is installed.
-      serial-number:
-        type: string
-        description: Serial number of the device
-      ipaddress-v4-loopback-0:
-        type: string
-        description: IPV4 Loopback 0 address
-      ipaddress-v6-loopback-0:
-        type: string
-        description: IPV6 Loopback 0 address
-      ipaddress-v4-aim:
-        type: string
-        description: IPV4 AIM address
-      ipaddress-v6-aim:
-        type: string
-        description: IPV6 AIM address
-      ipaddress-v6-oam:
+      vpe-id:
         type: string
-        description: IPV6 OAM address
-      inv-status:
+        description: Unique ID of VPE connected to this VCE.
+      v6-vce-wan-address:
         type: string
-        description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
+        description: Valid v6 IP address for the WAN Link on this router.  Implied length of /64.
+      ipv4-oam-address:
+        type: string
+        description: Address tail-f uses to configure vce, also used for troubleshooting and is IP used for traps generated by VCE.
       resource-version:
         type: string
         description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
-      prov-status:
+      ipv4-loopback0-address:
         type: string
-        description: Prov Status of this device (not under canopi control) Valid values [PREPROV/NVTPROV/PROV]
-      nf-role:
+        description: Loopback0 address
+      entitlement-resource-uuid:
         type: string
-        description: Nf Role is the role performed by this instance in the network.
-      relationship-list:
+        description: OBSOLETE -  see child relationships
+      port-groups:
         type: array
         items:
-          $ref: "#/definitions/relationship"
-      p-interfaces:
+          $ref: "#/getDefinitions/port-group"
+      licenses:
         type: array
         items:
-          $ref: "#/definitions/p-interface"
-      lag-interfaces:
+          $ref: "#/getDefinitions/license"
+      entitlements:
         type: array
         items:
-          $ref: "#/definitions/lag-interface"
-  pnfs:
+          $ref: "#/getDefinitions/entitlement"
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/getDefinitions/relationship"
+  vces:
     description: |
-      Collection of Physical Network Functions.
+      Collection of Virtual Customer Edge Routers, used specifically for Gamma.  This object is deprecated.
     properties:
-      pnf:
+      vce:
         type: array
         items:          
-          $ref: "#/definitions/pnf"
-  physical-link:
+          $ref: "#/getDefinitions/vce"
+  vf-module:
     description: |
-      Collection of physical connections, typically between p-interfaces
-      ###### Default Delete Scope
-      THIS_NODE_ONLY
+      a deployment unit of VNFCs
       ###### Related Nodes
-      - FROM p-interface
+      - TO generic-vnf( vf-module org.onap.relationships.inventory.BelongsTo generic-vnf, MANY2ONE)
+      - TO l3-network( vf-module org.onap.relationships.inventory.DependsOn l3-network, MANY2MANY)
+      - TO vnfc( vf-module org.onap.relationships.inventory.Uses vnfc, ONE2MANY)
+      - TO volume-group( vf-module org.onap.relationships.inventory.Uses volume-group, ONE2ONE)
+      - TO vserver( vf-module org.onap.relationships.inventory.Uses vserver, ONE2MANY)
+      - VF-MODULE cannot be deleted if linked to VNFC
     required:
-    - link-name
+    - vf-module-id
+    - is-base-vf-module
     properties:
-      link-name:
+      vf-module-id:
         type: string
-        description: e.g., hostnameA_p-connection_nameA_hostnameZ+p_connection-nameZ
-      speed-value:
+        description: Unique ID of vf-module.
+      vf-module-name:
         type: string
-        description: Captures the numeric part of the speed
-      speed-units:
+        description: Name of vf-module
+      heat-stack-id:
         type: string
-        description: Captures the units corresponding to the speed
-      circuit-id:
+        description: Heat stack id corresponding to this instance.
+      orchestration-status:
         type: string
-        description: Circuit it
-      dual-mode:
+        description: orchestration status of this vf-module, mastered by MSO
+      is-base-vf-module:
+        type: boolean
+      resource-version:
         type: string
-        description: Dual access mode (e.g., primary, secondary
-      management-option:
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      model-invariant-id:
         type: string
-        description: To provide information on who manages this circuit. A&AI or 3rd party transport provider
-      service-provider-name:
+        description: the ASDC model id for this resource or service model.
+      model-version-id:
         type: string
-        description: Name of the service Provider on this link.
-      service-provider-bandwidth-up-value:
-        type: integer
-        format: int32
-        description: Upstream Bandwidth value agreed with the service provider
-      service-provider-bandwidth-up-units:
+        description: the ASDC model version for this resource or service model.
+      persona-model-version:
         type: string
-        description: Units for the upstream BW value
-      service-provider-bandwidth-down-value:
+        description: the ASDC model version for this resource or service model.
+      model-customization-id:
+        type: string
+        description: captures the id of all the configuration used to customize the resource for the service.
+      widget-model-id:
+        type: string
+        description: the ASDC data dictionary widget model. This maps directly to the A&AI widget.
+      widget-model-version:
+        type: string
+        description: the ASDC data dictionary version of the widget model.This maps directly to the A&AI version of the widget.
+      contrail-service-instance-fqdn:
+        type: string
+        description: the Contrail unique ID for a service-instance
+      module-index:
         type: integer
         format: int32
-        description: Downstream Bandwidth value agreed with the service provider
-      service-provider-bandwidth-down-units:
-        type: string
-        description: Units for downstream BW value
-      resource-version:
+        description: the index will track the number of modules of a given type that have been deployed in a VNF, starting with 0, and always choosing the lowest available digit
+      selflink:
         type: string
-        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+        description: Path to the controller object.
       relationship-list:
         type: array
         items:
-          $ref: "#/definitions/relationship"
-  physical-links:
+          $ref: "#/getDefinitions/relationship"
+  vf-modules:
     description: |
-      Collection of physical connections, typically between p-interfaces
+      Collection of vf-modules, a deployment unit of VNFCs
     properties:
-      physical-link:
+      vf-module:
         type: array
         items:          
-          $ref: "#/definitions/physical-link"
+          $ref: "#/getDefinitions/vf-module"
   vig-server:
     description: |
       vig-server contains information about a vig server used for IPSec-configuration. Populated by SDN-C from 1607
-      ###### Default Delete Scope
-      THIS_NODE_ONLY
       ###### Related Nodes
-      - FROM ipsec-configuration (is composed of vig-server)
+      - TO ipsec-configuration( vig-server org.onap.relationships.inventory.BelongsTo ipsec-configuration, MANY2ONE)
     required:
     - vig-address-type
     properties:
@@ -42976,725 +67109,618 @@ definitions:
       relationship-list:
         type: array
         items:
-          $ref: "#/definitions/relationship"
+          $ref: "#/getDefinitions/relationship"
   vig-servers:
     properties:
       vig-server:
         type: array
         items:          
-          $ref: "#/definitions/vig-server"
-  ipsec-configuration:
+          $ref: "#/getDefinitions/vig-server"
+  vip-ipv4-address-list:
     description: |
-      IPSec configuration node will contain various configuration data for the NMTE VNF. This node will have an edge to the generic-vnf (vnf type = TE). Starting 1607, this data will be populated by SDN-C
-      ###### Default Delete Scope
-      CASCADE_TO_CHILDREN
+      IPv4 Address Range
       ###### Related Nodes
-      - TO vig-server (comprises ipsec-configuration, One2Many)
-      - FROM generic-vnf
+      - TO cloud-region( vip-ipv4-address-list org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE)
+      - TO instance-group( vip-ipv4-address-list org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY)
+      - TO subnet( vip-ipv4-address-list org.onap.relationships.inventory.MemberOf subnet, MANY2MANY)
+      - FROM vnfc( vnfc org.onap.relationships.inventory.Uses vip-ipv4-address-list, MANY2MANY)
     required:
-    - ipsec-configuration-id
+    - vip-ipv4-address
     properties:
-      ipsec-configuration-id:
-        type: string
-        description: UUID of this configuration
-      requested-vig-address-type:
-        type: string
-        description: Indicate the type of VIG server like AVPN, INTERNET, BOTH
-      requested-encryption-strength:
-        type: string
-        description: Encryption values like 3des-cbc, des-cbc, aes-128-cbc, aes-192-cbc, aes-265-cbc
-      requested-dmz-type:
+      vip-ipv4-address:
         type: string
-        description: ATT can offer a shared DMZ or a DMZ specific to a customer
-      shared-dmz-network-address:
-        type: string
-        description: Network address of shared DMZ
-      requested-customer-name:
-        type: string
-        description: If the DMZ is a custom DMZ, this field will indicate the customer information
-      ike-version:
-        type: string
-        description: can be 1 or 2
-      ikev1-authentication:
-        type: string
-        description: Contains values like md5, sha1, sha256, sha384
-      ikev1-encryption:
-        type: string
-        description: Encyption values like 3des-cbc, des-cbc, aes-128-cbc,?aes-192-cbc, aes-265-cbc
-      ikev1-dh-group:
-        type: string
-        description: Diffie-Hellman group like DH-GROUP2, DH-GROUP5, DH-GROUP14
-      ikev1-am-group-id:
-        type: string
-        description: Group name defined in VIG for clients using aggressive mode
-      ikev1-am-password:
-        type: string
-        description: pre-shared key for the above group name 
-      ikev1-sa-lifetime:
-        type: string
-        description: Lifetime for IKEv1 SA
-      ipsec-authentication:
-        type: string
-        description: md5, sha1, sha256, sha384
-      ipsec-encryption:
-        type: string
-        description: 3des-cbc, des-cbc, aes-128-cbc,?aes-192-cbc, aes-265-cbc
-      ipsec-sa-lifetime:
-        type: string
-        description: Life time for IPSec SA
-      ipsec-pfs:
-        type: string
-        description: enable PFS or not
-      xauth-userid:
-        type: string
-        description: user ID for xAuth, sm-user,ucpeHostName,nmteHostName
-      xauth-user-password:
-        type: string
-        description: Encrypted using the Juniper $9$ algorithm
-      dpd-interval:
-        type: string
-        description: The time between DPD probe
-      dpd-frequency:
-        type: string
-        description: Maximum number of DPD before claiming the tunnel is down
+        description: IP address
+      vip-ipv4-prefix-length:
+        type: integer
+        format: int64
+        description: Prefix length, 32 for single address
+      vlan-id-inner:
+        type: integer
+        format: int64
+        description: Inner VLAN tag
+      vlan-id-outer:
+        type: integer
+        format: int64
+        description: Outer VLAN tag
+      is-floating:
+        type: boolean
+        description: Indicator of fixed or floating address
       resource-version:
         type: string
         description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      neutron-network-id:
+        type: string
+        description: Neutron network id of the interface that address belongs to
+      neutron-subnet-id:
+        type: string
+        description: Neutron id of subnet that address belongs to
       relationship-list:
         type: array
         items:
-          $ref: "#/definitions/relationship"
-      vig-servers:
-        type: array
-        items:
-          $ref: "#/definitions/vig-server"
-  ipsec-configurations:
-    properties:
-      ipsec-configuration:
-        type: array
-        items:          
-          $ref: "#/definitions/ipsec-configuration"
-  route-table-reference:
+          $ref: "#/getDefinitions/relationship"
+  vip-ipv6-address-list:
     description: |
-      Openstack route table reference.
-      ###### Default Delete Scope
-      THIS_NODE_ONLY
+      IPv6 Address Range
       ###### Related Nodes
-      - FROM l3-network
+      - TO cloud-region( vip-ipv6-address-list org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE)
+      - TO instance-group( vip-ipv6-address-list org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY)
+      - TO subnet( vip-ipv6-address-list org.onap.relationships.inventory.MemberOf subnet, MANY2MANY)
+      - FROM vnfc( vnfc org.onap.relationships.inventory.Uses vip-ipv6-address-list, MANY2MANY)
     required:
-    - route-table-reference-id
-    - route-table-reference-fqdn
+    - vip-ipv6-address
     properties:
-      route-table-reference-id:
-        type: string
-        description: Route Table Reference id, UUID assigned to this instance.
-      route-table-reference-fqdn:
+      vip-ipv6-address:
         type: string
-        description: FQDN entry in the route table.
+        description: IP address
+      vip-ipv6-prefix-length:
+        type: integer
+        format: int64
+        description: Prefix length, 128 for single address
+      vlan-id-inner:
+        type: integer
+        format: int64
+        description: Inner VLAN tag
+      vlan-id-outer:
+        type: integer
+        format: int64
+        description: Outer VLAN tag
+      is-floating:
+        type: boolean
+        description: Indicator of fixed or floating address
       resource-version:
         type: string
-        description: Concurrency value
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      neutron-network-id:
+        type: string
+        description: Neutron network id of the interface that address belongs to
+      neutron-subnet-id:
+        type: string
+        description: Neutron id of subnet that address belongs to
       relationship-list:
         type: array
         items:
-          $ref: "#/definitions/relationship"
-  route-table-references:
-    description: |
-      Collection of openstack route table references
-    properties:
-      route-table-reference:
-        type: array
-        items:          
-          $ref: "#/definitions/route-table-reference"
-  instance-group:
+          $ref: "#/getDefinitions/relationship"
+  virtual-data-center:
     description: |
-      General mechanism for grouping instances
-      ###### Default Delete Scope
-      THIS_NODE_ONLY
-      ###### Related Nodes
-      - TO model (Many2Many)
-      - FROM l-interface
-      - FROM vnfc
-      - FROM l3-interface-ipv4-address-list
-      - FROM l3-interface-ipv6-address-list
-      - FROM l3-network
-      - FROM pnf
-      - FROM allotted-resource
-      - FROM generic-vnf
-      - FROM service-instance
+      Virtual organization of cloud infrastructure elements in a data center context
+      ###### Related Nodes
+      - FROM connector( connector org.onap.relationships.inventory.LocatedIn virtual-data-center, MANY2MANY)
+      - FROM generic-vnf( generic-vnf org.onap.relationships.inventory.LocatedIn virtual-data-center, MANY2MANY)
+      - FROM logical-link( logical-link org.onap.relationships.inventory.LocatedIn virtual-data-center, MANY2MANY)
     required:
-    - instance-group-role
-    - model-invariant-id
-    - model-version-id
-    - id
-    - description
-    - type
+    - vdc-id
+    - vdc-name
     properties:
-      instance-group-role:
-        type: string
-        description: role of the instance group.
-      model-invariant-id:
-        type: string
-        description: ASDC model id for this resource or service model.
-      model-version-id:
-        type: string
-        description: ASDC model version uid for this resource model.
-      id:
-        type: string
-        description: Instance Group ID, UUID assigned to this instance.
-      description:
-        type: string
-        description: Descriptive text to help identify the usage of this instance-group
-      type:
+      vdc-id:
         type: string
-        description: Only valid value today is lower case ha for high availability
-      sub-type:
+        description: Unique ID of the vdc
+      vdc-name:
         type: string
-        description: Valid values for ha type are [geo-activeactive, geo-activestandby, local-activeactive, local-activestandby]
+        description: Name of the virtual data center
       resource-version:
         type: string
-        description: Concurrency value
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
       relationship-list:
         type: array
         items:
-          $ref: "#/definitions/relationship"
-  instance-groups:
+          $ref: "#/getDefinitions/relationship"
+  virtual-data-centers:
     description: |
-      Collection of openstack route table references
+      Virtual organization of cloud infrastructure elements in a data center context
     properties:
-      instance-group:
+      virtual-data-center:
         type: array
         items:          
-          $ref: "#/definitions/instance-group"
-  zone:
+          $ref: "#/getDefinitions/virtual-data-center"
+  vlan:
     description: |
-      A zone is a grouping of assets in a location homing to the same connections into the CBB
-      ###### Default Delete Scope
-      THIS_NODE_ONLY
+      Definition of vlan
       ###### Related Nodes
-      - TO complex (Many2One)
-      - FROM cloud-region
-      - FROM pserver
-      - FROM pnf
-      - FROM service-instance
+      - TO l-interface( vlan tosca.relationships.network.LinksTo l-interface, MANY2ONE)
+      - TO logical-link( vlan org.onap.relationships.inventory.Uses logical-link, MANY2MANY)
+      - TO multicast-configuration( vlan org.onap.relationships.inventory.Uses multicast-configuration, MANY2MANY)
+      - FROM allotted-resource( allotted-resource org.onap.relationships.inventory.PartOf vlan, MANY2MANY)
+      - FROM service-instance( service-instance org.onap.relationships.inventory.ComposedOf vlan, ONE2MANY)
+      - FROM l3-interface-ipv4-address-list( l3-interface-ipv4-address-list org.onap.relationships.inventory.BelongsTo vlan, MANY2ONE)
+      - FROM l3-interface-ipv6-address-list( l3-interface-ipv6-address-list org.onap.relationships.inventory.BelongsTo vlan, MANY2ONE)
+      - VLAN is DELETED when these are DELETED L3-INTERFACE-IPV4-ADDRESS-LIST,L3-INTERFACE-IPV6-ADDRESS-LIST
+      - VLAN deletion means associated objects of these types are also DELETED:LOGICAL-LINK
     required:
-    - zone-id
-    - zone-name
-    - design-type
-    - zone-context
+    - vlan-interface
+    - in-maint
+    - is-ip-unnumbered
     properties:
-      zone-id:
-        type: string
-        description: Code assigned by AIC to the zone
-      zone-name:
-        type: string
-        description: English name associated with the zone
-      design-type:
-        type: string
-        description: Design of zone [Medium/Large?]
-      zone-context:
-        type: string
-        description: Context of zone [production/test]
-      status:
+      vlan-interface:
         type: string
-        description: Status of a zone.
+        description: String that identifies the interface
+      vlan-id-inner:
+        type: integer
+        format: int64
+        description: Inner VLAN tag
+      vlan-id-outer:
+        type: integer
+        format: int64
+        description: Outer VLAN tag
       resource-version:
         type: string
-        description: Concurrency value
-      relationship-list:
-        type: array
-        items:
-          $ref: "#/definitions/relationship"
-  zones:
-    description: |
-      Collection of zones
-    properties:
-      zone:
-        type: array
-        items:          
-          $ref: "#/definitions/zone"
-  network:
-    description: |
-      Namespace for network inventory resources.
-    properties:
-      logical-links:
-        type: array
-        items:
-          $ref: "#/definitions/logical-link"
-      site-pair-sets:
-        type: array
-        items:
-          $ref: "#/definitions/site-pair-set"
-      vpn-bindings:
-        type: array
-        items:
-          $ref: "#/definitions/vpn-binding"
-      vpls-pes:
-        type: array
-        items:
-          $ref: "#/definitions/vpls-pe"
-      multicast-configurations:
-        type: array
-        items:
-          $ref: "#/definitions/multicast-configuration"
-      vces:
-        type: array
-        items:
-          $ref: "#/definitions/vce"
-      vnfcs:
-        type: array
-        items:
-          $ref: "#/definitions/vnfc"
-      l3-networks:
-        type: array
-        items:
-          $ref: "#/definitions/l3-network"
-      network-policies:
-        type: array
-        items:
-          $ref: "#/definitions/network-policy"
-      generic-vnfs:
-        type: array
-        items:
-          $ref: "#/definitions/generic-vnf"
-      lag-links:
-        type: array
-        items:
-          $ref: "#/definitions/lag-link"
-      newvces:
-        type: array
-        items:
-          $ref: "#/definitions/newvce"
-      pnfs:
-        type: array
-        items:
-          $ref: "#/definitions/pnf"
-      physical-links:
-        type: array
-        items:
-          $ref: "#/definitions/physical-link"
-      ipsec-configurations:
-        type: array
-        items:
-          $ref: "#/definitions/ipsec-configuration"
-      route-table-references:
-        type: array
-        items:
-          $ref: "#/definitions/route-table-reference"
-      instance-groups:
-        type: array
-        items:
-          $ref: "#/definitions/instance-group"
-      zones:
-        type: array
-        items:
-          $ref: "#/definitions/zone"
-  inventory:
-    properties:
-      search:
-        type: object
-        $ref: "#/definitions/search"
-      actions:
-        type: object
-        $ref: "#/definitions/actions"
-      cloud-infrastructure:
-        type: object
-        $ref: "#/definitions/cloud-infrastructure"
-      business:
-        type: object
-        $ref: "#/definitions/business"
-      service-design-and-creation:
-        type: object
-        $ref: "#/definitions/service-design-and-creation"
-      network:
-        type: object
-        $ref: "#/definitions/network"
-      aai-internal:
-        type: object
-        $ref: "#/definitions/aai-internal"
-      nodes:
-        type: array
-        items:
-          $ref: "#/definitions/"
-  edge-tag-query-result:
-    properties:
-      tagged-inventory-item-list:
-        type: array
-        items:          
-          $ref: "#/definitions/tagged-inventory-item-list"
-  tagged-inventory-item-list:
-    properties:
-      inventory-item:
-        type: array
-        items:          
-          $ref: "#/definitions/inventory-item"
-  inventory-item:
-    properties:
-      inventory-item-type:
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      speed-value:
         type: string
-      inventory-item-link:
+        description: Captures the numeric part of the speed
+      speed-units:
         type: string
-      inventory-item-data:
-        type: array
-        items:          
-          $ref: "#/definitions/inventory-item-data"
-      tagged-inventory-item-list:
-        type: array
-        items:          
-          $ref: "#/definitions/tagged-inventory-item-list"
-  inventory-item-data:
-    properties:
-      property-name:
+        description: Captures the units corresponding to the speed
+      vlan-description:
         type: string
-      property-value:
+        description: Used to describe (the service associated with) the vlan
+      backdoor-connection:
         type: string
-  edge-tag-query-request:
-    properties:
-      edge-tag:
+        description: Whether customer is going to use this VLAN for backdoor connection to another customer premise device.
+      vpn-key:
         type: string
-      result-detail:
+        description: This indicates the customers VPN ID associated with this vlan
+      orchestration-status:
         type: string
-      start-node-type:
+        description: Status of a vnf's vlan interface, on which the customer circuit resides, mastered by SDN-C.
+      in-maint:
+        type: boolean
+      prov-status:
         type: string
-      start-node-filter:
+        description: Prov Status of the VLAN configuration related to a logical interface. Valid values [PREPROV/NVTPROV/PROV].
+      is-ip-unnumbered:
+        type: boolean
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/getDefinitions/relationship"
+      l3-interface-ipv4-address-list:
         type: array
         items:          
-          $ref: "#/definitions/start-node-filter"
-      include-node-filter:
+          $ref: "#/getDefinitions/l3-interface-ipv4-address-list"
+      l3-interface-ipv6-address-list:
         type: array
         items:          
-          $ref: "#/definitions/include-node-filter"
-      secondary-filter:
+          $ref: "#/getDefinitions/l3-interface-ipv6-address-list"
+  vlans:
+    properties:
+      vlan:
         type: array
         items:          
-          $ref: "#/definitions/secondary-filter"
-  start-node-filter:
+          $ref: "#/getDefinitions/vlan"
+  vnf:
+    description: |
+      Abstract vnf class
+    required:
+    - vnf-id
     properties:
-      property-name:
-        type: string
-      property-value:
+      vnf-id:
         type: string
-  include-node-filter:
+        description: Unique id of VNF.  This is unique across the graph.
+  vnf-image:
+    description: |
+      Image object that pertain to a VNF that doesn't have associated vservers.  This is a kludge.
+      ###### Related Nodes
+      - FROM generic-vnf( generic-vnf org.onap.relationships.inventory.Uses vnf-image, MANY2ONE)
+      - VNF-IMAGE cannot be deleted if linked to GENERIC-VNF
+    required:
+    - vnf-image-uuid
+    - application
+    - application-vendor
     properties:
-      include-node-type:
+      vnf-image-uuid:
         type: string
-  secondary-filter:
-    properties:
-      property-name:
+        description: Unique ID of this asset
+      application:
         type: string
-      filter-type:
+        description: The application that the image instantiates.
+      application-vendor:
         type: string
-      property-value:
+        description: The vendor of the application.
+      application-version:
         type: string
-  search-results:
-    properties:
-      result-data:
-        type: array
-        items:          
-          $ref: "#/definitions/result-data"
-  result-data:
-    properties:
-      resource-type:
+        description: The version of the application.
+      selflink:
         type: string
-        description: The specific type of node in the A&AI graph
-      resource-link:
+        description: URL to endpoint where AAI can get more details
+      resource-version:
         type: string
-        description: The URL to the specific resource
-  sdn-zone-response:
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/getDefinitions/relationship"
+  vnf-images:
+    description: |
+      Collection of image objects that pertain to a VNF that doesn't have associated vservers.  This is a kludge.
     properties:
-      oam-networks:
-        type: object
-        $ref: "#/definitions/oam-networks"
-      az-and-dvs-switches:
+      vnf-image:
         type: array
         items:          
-          $ref: "#/definitions/az-and-dvs-switches"
-  az-and-dvs-switches:
-    properties:
-      dvs-switches:
-        type: object
-        $ref: "#/definitions/dvs-switches"
-      availability-zone:
-        type: object
-        $ref: "#/definitions/availability-zone"
-  update:
+          $ref: "#/getDefinitions/vnf-image"
+  vnfc:
     description: |
-      Serves a PATCH like function.  Does not enforce concurrency control.  Clear each usage with AAI team.
+      ###### Related Nodes
+      - TO generic-vnf( vnfc org.onap.relationships.inventory.BelongsTo generic-vnf, MANY2ONE)
+      - TO instance-group( vnfc org.onap.relationships.inventory.MemberOf instance-group, MANY2MANY)
+      - TO vip-ipv4-address-list( vnfc org.onap.relationships.inventory.Uses vip-ipv4-address-list, MANY2MANY)
+      - TO vip-ipv6-address-list( vnfc org.onap.relationships.inventory.Uses vip-ipv6-address-list, MANY2MANY)
+      - TO vserver( vnfc tosca.relationships.HostedOn vserver, ONE2MANY)
+      - FROM vf-module( vf-module org.onap.relationships.inventory.Uses vnfc, ONE2MANY)
+      - FROM l3-interface-ipv4-address-list( l3-interface-ipv4-address-list org.onap.relationships.inventory.BelongsTo vnfc, MANY2ONE)
+      - FROM l3-interface-ipv6-address-list( l3-interface-ipv6-address-list org.onap.relationships.inventory.BelongsTo vnfc, MANY2ONE)
+      - VNFC is DELETED when these are DELETED L3-INTERFACE-IPV4-ADDRESS-LIST,L3-INTERFACE-IPV6-ADDRESS-LIST
     required:
-    - update-node-type
+    - vnfc-name
+    - nfc-naming-code
+    - nfc-function
+    - in-maint
+    - is-closed-loop-disabled
     properties:
-      update-node-type:
+      vnfc-name:
         type: string
-      update-node-key:
-        type: array
-        items:          
-          $ref: "#/definitions/update-node-key"
-      update-node-uri:
+        description: Unique ID of vnfc.
+      nfc-naming-code:
         type: string
-      action:
-        type: array
-        items:          
-          $ref: "#/definitions/action"
-  action:
-    properties:
-      action-type:
+        description: Short code that is used in naming instances of the item being modeled
+      nfc-function:
         type: string
-      action-data:
-        type: array
-        items:          
-          $ref: "#/definitions/action-data"
-  action-data:
-    properties:
-      property-name:
+        description: English description of function that the specific resource deployment is providing. Assigned as part of the customization of a resource in a service
+      prov-status:
         type: string
-      property-value:
+        description: prov status of this vnfc
+      orchestration-status:
         type: string
-  update-node-key:
-    properties:
-      key-name:
+        description: Orchestration status of this VNF, mastered by APP-C
+      ipaddress-v4-oam-vip:
         type: string
-      key-value:
+        description: Oam V4 vip address of this vnfc
+      in-maint:
+        type: boolean
+      is-closed-loop-disabled:
+        type: boolean
+      group-notation:
         type: string
-  notify:
-    required:
-    - event-id
-    properties:
-      event-id:
+        description: Group notation of VNFC
+      model-invariant-id:
         type: string
-      node-type:
+        description: the ASDC model id for this resource or service model.
+      model-version-id:
         type: string
-      event-trigger:
+        description: the ASDC model version for this resource or service model.
+      resource-version:
         type: string
-      key-data:
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/getDefinitions/relationship"
+      l3-interface-ipv4-address-list:
         type: array
         items:          
-          $ref: "#/definitions/key-data"
-      selflink:
-        type: string
-  key-data:
-    properties:
-      key-name:
-        type: string
-      key-value:
-        type: string
-  notification-event:
+          $ref: "#/getDefinitions/l3-interface-ipv4-address-list"
+      l3-interface-ipv6-address-list:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/l3-interface-ipv6-address-list"
+  vnfcs:
+    description: |
+      virtual network components associated with a vserver from application controller.
     properties:
-      cambria.partition:
-        type: string
-      notification-event-header:
-        type: object
-        $ref: "#/definitions/notification-event-header"
-  notification-event-header:
+      vnfc:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/vnfc"
+  volume:
+    description: |
+      Ephemeral Block storage volume.
+      ###### Related Nodes
+      - FROM vserver (PARENT of volume, vserver tosca.relationships.AttachesTo volume)
+    required:
+    - volume-id
+    - volume-selflink
     properties:
-      id:
-        type: string
-      timestamp:
-        type: string
-      source-name:
+      volume-id:
         type: string
-      domain:
+        description: Unique ID of block storage volume relative to the vserver.
+      volume-selflink:
         type: string
-      sequence-number:
+        description: URL to endpoint where AAI can get more details
+      resource-version:
         type: string
-      severity:
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/getDefinitions/relationship"
+  volume-group:
+    description: |
+      Persistent block-level storage.
+      ###### Related Nodes
+      - TO cloud-region( volume-group org.onap.relationships.inventory.BelongsTo cloud-region, MANY2ONE)
+      - TO complex( volume-group org.onap.relationships.inventory.LocatedIn complex, MANY2ONE)
+      - FROM generic-vnf( generic-vnf org.onap.relationships.inventory.DependsOn volume-group, ONE2MANY)
+      - FROM vf-module( vf-module org.onap.relationships.inventory.Uses volume-group, ONE2ONE)
+      - FROM tenant( tenant org.onap.relationships.inventory.DependsOn volume-group, ONE2MANY)
+    required:
+    - volume-group-id
+    - volume-group-name
+    - vnf-type
+    properties:
+      volume-group-id:
         type: string
-      event-type:
+        description: Unique ID of volume-group.
+      volume-group-name:
         type: string
-      version:
+        description: Name of the volume group.
+      heat-stack-id:
         type: string
-      action:
+        description: Heat stack id corresponding to this volume-group
+      vnf-type:
         type: string
-      entity-type:
+        description: String capturing type of vnf, that was intended to identify the ASDC resource.  This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures.
+      orchestration-status:
         type: string
-      top-entity-type:
+        description: Orchestration status of this volume-group
+      model-customization-id:
         type: string
-      entity-link:
+        description: captures the id of all the configuration used to customize the resource for the service.
+      vf-module-model-customization-id:
         type: string
-      status:
+        description: helps relate the volume group to the vf-module whose components will require the volume group
+      resource-version:
         type: string
-  reserved-prop-names:
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/getDefinitions/relationship"
+  volume-groups:
     description: |
-      Internal map to define some reserved properties of a vertex
+      Collection of persistent block-level storage.
     properties:
-      last-mod-source-of-truth:
+      volume-group:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/volume-group"
+  volumes:
+    description: |
+      Collection of ephemeral Block storage volumes.
+    properties:
+      volume:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/volume"
+  vpls-pe:
+    description: |
+      VPLS Provider Edge routers.
+      ###### Related Nodes
+      - TO complex( vpls-pe org.onap.relationships.inventory.LocatedIn complex, MANY2ONE)
+      - TO ctag-pool( vpls-pe org.onap.relationships.inventory.Uses ctag-pool, MANY2MANY)
+      - FROM lag-interface( lag-interface tosca.relationships.network.BindsTo vpls-pe, MANY2ONE)
+      - FROM p-interface( p-interface tosca.relationships.network.BindsTo vpls-pe, MANY2ONE)
+      - VPLS-PE is DELETED when these are DELETED LAG-INTERFACE,P-INTERFACE
+    required:
+    - equipment-name
+    properties:
+      equipment-name:
         type: string
-      aai-node-type:
+      prov-status:
         type: string
-      aai-created-ts:
-        type: integer
-        format: int64
-      aai-unique-key:
+        description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems.
+      ipv4-oam-address:
         type: string
-      aai-last-mod-ts:
+        description: Address tail-f uses to configure generic-vnf, also used for troubleshooting and is IP used for traps generated by GenericVnf (v4-loopback0-ip-address).
+      equipment-role:
+        type: string
+        description: Client should send valid enumerated value, e.g., VPLS-PE.
+      vlan-id-outer:
         type: integer
         format: int64
-      source-of-truth:
-        type: string
-      aai-uri:
+        description: Temporary location for stag to get to VCE
+      resource-version:
         type: string
-  edge-prop-names:
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/getDefinitions/relationship"
+      p-interfaces:
+        type: array
+        items:
+          $ref: "#/getDefinitions/p-interface"
+      lag-interfaces:
+        type: array
+        items:
+          $ref: "#/getDefinitions/lag-interface"
+  vpls-pes:
     description: |
-      Internal map to define the properties of an edge and interpret the map EdgeRules
+      Collection of VPLS Provider Edge routers
     properties:
-      edgeLabel:
-        type: string
-      direction:
+      vpls-pe:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/vpls-pe"
+  vpn-binding:
+    description: |
+      VPN binding
+      ###### Related Nodes
+      - FROM allotted-resource( allotted-resource org.onap.relationships.inventory.BelongsTo vpn-binding, MANY2MANY)
+      - FROM l3-network( l3-network org.onap.relationships.inventory.Uses vpn-binding, MANY2MANY)
+      - FROM logical-link( logical-link org.onap.relationships.inventory.Uses vpn-binding, MANY2MANY)
+      - FROM route-target( route-target org.onap.relationships.inventory.BelongsTo vpn-binding, MANY2ONE)
+      - VPN-BINDING cannot be deleted if linked to ALLOTTED-RESOURCE,L3-NETWORK,LOGICAL-LINK
+      - VPN-BINDING is DELETED when these are DELETED ROUTE-TARGET
+    required:
+    - vpn-id
+    - vpn-name
+    properties:
+      vpn-id:
         type: string
-      multiplicityRule:
+        description: VPN ID, globally unique within A&AI
+      vpn-name:
         type: string
-      contains-other-v:
+        description: VPN Name
+      vpn-platform:
         type: string
-      delete-other-v:
+        description: the platform associated with the VPN example AVPN, Mobility
+      vpn-type:
         type: string
-      SVC-INFRA:
+        description: Type of the vpn, should be taken from enumerated/valid values
+      vpn-region:
         type: string
-      prevent-delete:
+        description: region of customer vpn
+      customer-vpn-id:
         type: string
-  model-and-named-query-search:
-    description: |
-      ModelAndNamedQuerySearch holds query-parameters and instance-properties for performing a named-query or model query
-    properties:
-      query-parameters:
-        type: object
-        $ref: "#/definitions/query-parameters"
-      instance-filters:
-        type: object
-        $ref: "#/definitions/instance-filters"
-      secondary-filts:
-        type: object
-        $ref: "#/definitions/secondary-filts"
-      top-node-type:
+        description: id for this customer vpn
+      route-distinguisher:
         type: string
-      secondary-filter-cut-point:
+        description: Used to distinguish the distinct VPN routes of separate customers who connect to the provider in an MPLS network.
+      resource-version:
         type: string
-  query-parameters:
-    description: |
-      QueryParameters for performing a named-query or model query
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      route-targets:
+        type: array
+        items:
+          $ref: "#/getDefinitions/route-target"
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/getDefinitions/relationship"
+        description: l3-networks relate to vpn-bindings
+  vpn-bindings:
     properties:
-      named-query:
-        type: object
-        $ref: "#/definitions/named-query"
-      overloaded-model:
-        type: object
-        $ref: "#/definitions/overloaded-model"
-  overloaded-model:
+      vpn-binding:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/vpn-binding"
+  vserver:
     description: |
-      Allows for legacy POST of old-style and new-style models
+      Virtual Servers, aka virtual machine or VM.
+      ###### Related Nodes
+      - TO tenant( vserver org.onap.relationships.inventory.BelongsTo tenant, MANY2ONE)
+      - TO flavor( vserver org.onap.relationships.inventory.Uses flavor, MANY2ONE)
+      - TO image( vserver org.onap.relationships.inventory.Uses image, MANY2ONE)
+      - TO pserver( vserver tosca.relationships.HostedOn pserver, MANY2ONE)
+      - TO snapshot( vserver org.onap.relationships.inventory.Uses snapshot, ONE2ONE)
+      - TO volume (CHILD of vserver, vserver tosca.relationships.AttachesTo volume, ONE2MANY)
+      - FROM generic-vnf( generic-vnf tosca.relationships.HostedOn vserver, ONE2MANY)
+      - FROM vce( vce tosca.relationships.HostedOn vserver, ONE2MANY)
+      - FROM l-interface( l-interface tosca.relationships.network.BindsTo vserver, MANY2ONE)
+      - FROM vf-module( vf-module org.onap.relationships.inventory.Uses vserver, ONE2MANY)
+      - FROM vnfc( vnfc tosca.relationships.HostedOn vserver, ONE2MANY)
+      - VSERVER is DELETED when these are DELETED L-INTERFACE
+      - VSERVER deletion means associated objects of these types are also DELETED:VOLUME
     required:
-    - model-invariant-id
-    - model-name-version-id
-    - model-type
-    - model-name
-    - model-id
-    - model-version
+    - vserver-id
+    - vserver-name
+    - vserver-selflink
+    - in-maint
+    - is-closed-loop-disabled
     properties:
-      model-invariant-id:
-        type: string
-        description: Unique identifier corresponding to the main definition of a model in ASDC
-      model-name-version-id:
-        type: string
-        description: Unique identifier corresponding to one version of a model in ASDC
-      model-type:
+      vserver-id:
         type: string
-        description: Type of the model, e.g., service, resource, widget, etc.
-      model-name:
+        description: Unique identifier for this vserver relative to its tenant
+      vserver-name:
         type: string
-        description: Name of the model, which can change from version to version.
-      model-id:
+        description: Name of vserver
+      vserver-name2:
         type: string
-        description: Invariant unique ID which does not change from version to version
-      model-version:
+        description: Alternative name of vserver
+      prov-status:
         type: string
-        description: Version
-      model-description:
+        description: Trigger for operational monitoring of this resource by Service Assurance systems.
+      vserver-selflink:
         type: string
-        description: Description
+        description: URL to endpoint where AAI can get more details
+      in-maint:
+        type: boolean
+      is-closed-loop-disabled:
+        type: boolean
       resource-version:
         type: string
         description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
-      model-vers:
-        type: object
-        $ref: "#/definitions/model-vers"
+      volumes:
+        type: array
+        items:
+          $ref: "#/getDefinitions/volume"
       relationship-list:
-        type: object
-        $ref: "#/definitions/relationship-list"
-  instance-filters:
-    description: |
-      InstanceFilters for performing a named-query or model query
-    properties:
-      instance-filter:
         type: array
-        items:          
-          $ref: "#/definitions/instance-filter"
-  instance-filter:
-    description: |
-      InstanceFilter for performing a named-query or model query
-  secondary-filts:
+        items:
+          $ref: "#/getDefinitions/relationship"
+      l-interfaces:
+        type: array
+        items:
+          $ref: "#/getDefinitions/l-interface"
+  vservers:
     description: |
-      SecondaryFilts for performing a named-query or model query
+      Collection of virtual Servers, aka virtual machines or VMs.
     properties:
-      secondary-filt:
+      vserver:
         type: array
         items:          
-          $ref: "#/definitions/secondary-filt"
-  secondary-filt:
-    description: |
-      SecondaryFilt for performing a named-query or model query
-  properties:
+          $ref: "#/getDefinitions/vserver"
+  zone:
     description: |
-      Property holder for query properties or instance properties
+      A zone is a grouping of assets in a location homing to the same connections into the CBB
+      ###### Related Nodes
+      - TO complex( zone org.onap.relationships.inventory.LocatedIn complex, MANY2ONE)
+      - FROM cloud-region( cloud-region org.onap.relationships.inventory.LocatedIn zone, MANY2ONE)
+      - FROM pnf( pnf org.onap.relationships.inventory.LocatedIn zone, MANY2ONE)
+      - FROM pserver( pserver org.onap.relationships.inventory.LocatedIn zone, MANY2ONE)
+      - FROM service-instance( service-instance org.onap.relationships.inventory.LocatedIn zone, MANY2ONE)
+    required:
+    - zone-id
+    - zone-name
+    - design-type
+    - zone-context
     properties:
-      property-name:
+      zone-id:
         type: string
-      property-value:
+        description: Code assigned by AIC to the zone
+      zone-name:
         type: string
-  response-list:
-    description: |
-      Response container for the results of a named-query or model query
-    properties:
-      inventory-response-items:
-        type: object
-        $ref: "#/definitions/inventory-response-items"
-  inventory-response-items:
-    description: |
-      Container for inventory items in response list
-    properties:
-      inventory-response-item:
-        type: array
-        items:          
-          $ref: "#/definitions/inventory-response-item"
-  inventory-response-item:
-    description: |
-      Inventory item for response list
-    properties:
-      model-name:
+        description: English name associated with the zone
+      design-type:
         type: string
-      extra-properties:
-        type: object
-        $ref: "#/definitions/extra-properties"
-      inventory-response-items:
-        type: object
-        $ref: "#/definitions/inventory-response-items"
-  extra-properties:
-    description: |
-      Extra properties for inventory item for response list
-    properties:
-      extra-property:
-        type: array
-        items:          
-          $ref: "#/definitions/extra-property"
-  extra-property:
-    properties:
-      property-name:
+        description: Design of zone [Medium/Large?]
+      zone-context:
         type: string
-      property-value:
+        description: Context of zone [production/test]
+      status:
         type: string
-  vnf:
+        description: Status of a zone.
+      resource-version:
+        type: string
+        description: Concurrency value
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/getDefinitions/relationship"
+  zones:
     description: |
-      Abstract vnf class
-    required:
-    - vnf-id
+      Collection of zones
     properties:
-      vnf-id:
-        type: string
-        description: Unique id of VNF.  This is unique across the graph.
+      zone:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/zone"