Merge "Fix sonar issues in SchemaGenerator"
[aai/aai-common.git] / aai-schema / src / main / resources / aai_swagger_yaml / aai_swagger_v11.yaml
index 3f250f6..629ae58 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,36 +128,27 @@ 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
-        - name: data-center-code
-          in: query
-          description: Data center code which can be an alternate way to identify a complex
-          required: false
-          type: string
-        - name: complex-name
-          in: query
-          description: Gamma complex name for LCP instance.
-          required: false
-          type: string
-        - name: identity-url
-          in: query
-          description: URL of the keystone identity service
-          required: false
-          type: string
+          example: __AVAILABILITY-ZONE-NAME__
     put:
       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 +165,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 updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/ctag-pool"
     delete:
       tags:
         - CloudInfrastructure
@@ -202,16 +256,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 +288,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,19 +297,10 @@ paths:
           description: Unique identifier for physical location, e.g., CLLI
           required: true
           type: string
-        - name: data-center-code
-          in: query
-          description: Data center code which can be an alternate way to identify a complex
-          required: false
-          type: string
-        - name: complex-name
-          in: query
-          description: Gamma complex name for LCP instance.
-          required: false
-          type: string
-        - name: identity-url
+          example: __PHYSICAL-LOCATION-ID__
+        - name: availability-zone-name
           in: query
-          description: URL of the keystone identity service
+          description:
           required: false
           type: string
   /cloud-infrastructure/complexes/complex/{physical-location-id}/relationship-list/relationship:
@@ -276,9 +324,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 +352,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 +367,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,26 +376,15 @@ paths:
           description: Unique identifier for physical location, e.g., CLLI
           required: true
           type: string
-        - name: data-center-code
-          in: query
-          description: Data center code which can be an alternate way to identify a complex
-          required: false
-          type: string
-        - name: complex-name
-          in: query
-          description: Gamma complex name for LCP instance.
-          required: false
-          type: string
-        - name: identity-url
-          in: query
-          description: URL of the keystone identity service
-          required: false
-          type: string
+          example: __PHYSICAL-LOCATION-ID__
     put:
       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 +401,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 updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/complex"
     delete:
       tags:
         - CloudInfrastructure
@@ -389,6 +468,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,9 +488,30 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/complexes"
+              $ref: "#/getDefinitions/complexes"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: physical-location-id
+          in: query
+          description:
+          required: false
+          type: string
+        - name: data-center-code
+          in: query
+          description:
+          required: false
+          type: string
+        - name: complex-name
+          in: query
+          description:
+          required: false
+          type: string
+        - name: identity-url
+          in: query
+          description:
+          required: false
+          type: string
   /cloud-infrastructure/cloud-regions/cloud-region/{cloud-owner}/{cloud-region-id}/volume-groups/volume-group/{volume-group-id}/relationship-list/relationship:
     put:
       tags:
@@ -432,19 +533,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 +573,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 +600,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,46 +609,27 @@ 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
-        - 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: volume-group-name
-          in: query
-          description: Name of the volume group.
-          required: false
-          type: string
-        - name: heat-stack-id
-          in: query
-          description: Heat stack id corresponding to this volume-group
-          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
+          example: __VOLUME-GROUP-ID__
     put:
       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 +646,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 updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/volume-group"
     delete:
       tags:
         - CloudInfrastructure
@@ -595,16 +737,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 +769,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,19 +778,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
+          example: __CLOUD-REGION-ID__
+        - name: volume-group-id
           in: query
-          description: Type of the cloud (e.g., openstack)
+          description:
           required: false
           type: string
-        - name: owner-defined-type
+        - name: volume-group-name
           in: query
-          description: Cloud-owner defined type indicator (e.g., dcp, lcp)
+          description:
+          required: false
+          type: string
+        - name: heat-stack-id
+          in: query
+          description:
+          required: false
+          type: string
+        - name: vnf-type
+          in: query
+          description:
           required: false
           type: string
   /cloud-infrastructure/cloud-regions/cloud-region/{cloud-owner}/{cloud-region-id}/tenants/tenant/{tenant-id}/vservers/vserver/{vserver-id}/volumes/volume/{volume-id}/relationship-list/relationship:
@@ -669,29 +826,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 +878,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 +917,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,75 +926,103 @@ 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
-        - 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
+          example: __VOLUME-ID__
+    put:
+      tags:
+        - CloudInfrastructure
+      summary: 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
+        - 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: tenant-context
-          in: query
-          description: This field will store the tenant context.
-          required: false
+          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: vserver-name
-          in: query
-          description: Name of vserver
-          required: false
+          example: __CLOUD-REGION-ID__
+        - name: tenant-id
+          in: path
+          description: Unique id relative to the cloud-region.
+          required: true
           type: string
-        - name: vserver-name2
-          in: query
-          description: Alternative name of vserver
-          required: false
+          example: __TENANT-ID__
+        - name: vserver-id
+          in: path
+          description: Unique identifier for this vserver relative to its tenant
+          required: true
           type: string
-        - name: prov-status
-          in: query
-          description: Trigger for operational monitoring of this resource by Service Assurance systems.
-          required: false
+          example: __VSERVER-ID__
+        - name: volume-id
+          in: path
+          description: Unique ID of block storage volume relative to the vserver.
+          required: true
           type: string
-        - name: in-maint
-          in: query
-          required: false
-          type: boolean
-        - name: is-closed-loop-disabled
-          in: query
-          required: false
-          type: boolean
-    put:
+          example: __VOLUME-ID__
+        - name: body
+          in: body
+          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: create or update an existing volume
-      description: create or update an existing volume
-      operationId: createOrUpdateCloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverVolumesVolume
+      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
@@ -843,32 +1038,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: 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 updated.
           required: true
           schema:
-            $ref: "#/definitions/volume"
+            $ref: "#/patchDefinitions/volume"
     delete:
       tags:
         - CloudInfrastructure
@@ -890,26 +1090,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 +1134,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,64 +1143,30 @@ 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
-        - 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
+          example: __VSERVER-ID__
+        - name: volume-id
           in: query
-          description: Trigger for operational monitoring of this resource by Service Assurance systems.
+          description:
           required: false
           type: string
-        - name: in-maint
-          in: query
-          required: false
-          type: boolean
-        - name: is-closed-loop-disabled
-          in: query
-          required: false
-          type: boolean
   /cloud-infrastructure/cloud-regions/cloud-region/{cloud-owner}/{cloud-region-id}/tenants/tenant/{tenant-id}/vservers/vserver/{vserver-id}/relationship-list/relationship:
     put:
       tags:
@@ -1017,24 +1188,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 +1234,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 +1274,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 +1332,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 +1384,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 +1448,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 +1499,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,127 +1508,127 @@ 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
-        - 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
+          example: __L3-INTERFACE-IPV4-ADDRESS__
+    put:
+      tags:
+        - CloudInfrastructure
+      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: createOrUpdateCloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList
+      consumes:
+        - 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: 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
+          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: macaddr
-          in: query
-          description: MAC address for the interface
-          required: false
+          example: __CLOUD-REGION-ID__
+        - name: tenant-id
+          in: path
+          description: Unique id relative to the cloud-region.
+          required: true
           type: string
-        - name: network-name
-          in: query
-          description: Name of the network
-          required: false
+          example: __TENANT-ID__
+        - name: vserver-id
+          in: path
+          description: Unique identifier for this vserver relative to its tenant
+          required: true
           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
+          example: __VSERVER-ID__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
           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
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
           type: string
-        - name: neutron-subnet-id
-          in: query
-          description: Neutron id of subnet that address belongs to
-          required: false
+          example: __VLAN-INTERFACE__
+        - name: l3-interface-ipv4-address
+          in: path
+          description: IP address
+          required: true
           type: string
-    put:
+          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/CloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList.json)
+          required: true
+          schema:
+            $ref: "#/definitions/l3-interface-ipv4-address-list"
+    patch:
       tags:
         - CloudInfrastructure
-      summary: create or update an existing l3-interface-ipv4-address-list
-      description: create or update an existing l3-interface-ipv4-address-list
-      operationId: createOrUpdateCloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList
+      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
@@ -1439,42 +1644,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: 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 updated.
           required: true
           schema:
-            $ref: "#/definitions/l3-interface-ipv4-address-list"
+            $ref: "#/patchDefinitions/l3-interface-ipv4-address-list"
     delete:
       tags:
         - CloudInfrastructure
@@ -1496,36 +1708,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 +1771,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 +1835,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 +1886,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,127 +1895,127 @@ 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
-        - 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
+          example: __L3-INTERFACE-IPV6-ADDRESS__
+    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: createOrUpdateCloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList
+      consumes:
+        - 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: 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
+          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: macaddr
-          in: query
-          description: MAC address for the interface
-          required: false
+          example: __CLOUD-REGION-ID__
+        - name: tenant-id
+          in: path
+          description: Unique id relative to the cloud-region.
+          required: true
           type: string
-        - name: network-name
-          in: query
-          description: Name of the network
-          required: false
+          example: __TENANT-ID__
+        - name: vserver-id
+          in: path
+          description: Unique identifier for this vserver relative to its tenant
+          required: true
           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
+          example: __VSERVER-ID__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
           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
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
           type: string
-        - name: neutron-subnet-id
-          in: query
-          description: Neutron id of subnet that address belongs to
-          required: false
+          example: __VLAN-INTERFACE__
+        - 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/CloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList.json)
+          required: true
+          schema:
+            $ref: "#/definitions/l3-interface-ipv6-address-list"
+    patch:
       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: createOrUpdateCloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList
+      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
@@ -1798,42 +2031,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: 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 updated.
           required: true
           schema:
-            $ref: "#/definitions/l3-interface-ipv6-address-list"
+            $ref: "#/patchDefinitions/l3-interface-ipv6-address-list"
     delete:
       tags:
         - CloudInfrastructure
@@ -1855,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: resource-version
           in: query
           description: resource-version for concurrency
@@ -1904,7 +2151,62 @@ 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: 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__
+    put:
+      tags:
+        - CloudInfrastructure
+      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: createOrUpdateCloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterfaceVlansVlan
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -1913,106 +2215,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: vlan-interface
           in: path
           description: String that identifies the interface
           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: vpn-key
-          in: query
-          description: This indicates the customers VPN ID associated with this vlan
-          required: false
-          type: string
-    put:
+          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/CloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterfaceVlansVlan.json)
+          required: true
+          schema:
+            $ref: "#/definitions/vlan"
+    patch:
       tags:
         - CloudInfrastructure
-      summary: create or update an existing vlan
-      description: create or update an existing vlan
-      operationId: createOrUpdateCloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterfaceVlansVlan
+      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
@@ -2028,37 +2284,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: body
           in: body
-          description: vlan object that needs to be created or updated
+          description: vlan object that needs to be updated.
           required: true
           schema:
-            $ref: "#/definitions/vlan"
+            $ref: "#/patchDefinitions/vlan"
     delete:
       tags:
         - CloudInfrastructure
@@ -2080,31 +2342,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 +2392,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,82 +2401,45 @@ 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: 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
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
           in: query
-          description: ID of interface
+          description:
           required: false
           type: string
-        - name: macaddr
+        - name: vlan-id-inner
           in: query
-          description: MAC address for the interface
+          description:
           required: false
-          type: string
-        - name: network-name
+          type: integer
+          format: int64
+        - name: vpn-key
           in: query
-          description: Name of the network
+          description:
           required: false
           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}/sriov-vfs/sriov-vf/{pci-id}/relationship-list/relationship:
@@ -2232,34 +2463,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 +2521,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 +2566,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,115 +2575,115 @@ 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
-        - 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
+          example: __PCI-ID__
+    put:
+      tags:
+        - CloudInfrastructure
+      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: createOrUpdateCloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterfaceSriovVfsSriovVf
+      consumes:
+        - 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: macaddr
-          in: query
-          description: MAC address for the interface
-          required: false
+          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-name
-          in: query
-          description: Name of the network
-          required: false
+          example: __CLOUD-REGION-ID__
+        - name: tenant-id
+          in: path
+          description: Unique id relative to the cloud-region.
+          required: true
           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
+          example: __TENANT-ID__
+        - name: vserver-id
+          in: path
+          description: Unique identifier for this vserver relative to its tenant
+          required: true
           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
+          example: __VSERVER-ID__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
           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
+          example: __INTERFACE-NAME__
+        - name: pci-id
+          in: path
+          description: PCI ID used to identify the sriov-vf
+          required: true
           type: string
-    put:
+          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/CloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterfaceSriovVfsSriovVf.json)
+          required: true
+          schema:
+            $ref: "#/definitions/sriov-vf"
+    patch:
       tags:
         - CloudInfrastructure
-      summary: create or update an existing sriov-vf
-      description: create or update an existing sriov-vf
-      operationId: createOrUpdateCloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterfaceSriovVfsSriovVf
+      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
@@ -2456,37 +2699,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: 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 updated.
           required: true
           schema:
-            $ref: "#/definitions/sriov-vf"
+            $ref: "#/patchDefinitions/sriov-vf"
     delete:
       tags:
         - CloudInfrastructure
@@ -2508,31 +2757,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 +2807,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,82 +2816,54 @@ 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: 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
+          example: __INTERFACE-NAME__
+        - name: pci-id
           in: query
-          description: Name of vserver
+          description:
           required: false
           type: string
-        - name: vserver-name2
+        - name: vf-vlan-filter
           in: query
-          description: Alternative name of vserver
+          description:
           required: false
           type: string
-        - name: prov-status
+        - name: vf-mac-filter
           in: query
-          description: Trigger for operational monitoring of this resource by Service Assurance systems.
+          description:
           required: false
           type: string
-        - name: in-maint
-          in: query
-          required: false
-          type: boolean
-        - name: is-closed-loop-disabled
+        - name: vf-vlan-strip
           in: query
+          description:
           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
+        - name: neutron-network-id
           in: query
-          description: Name of the network
+          description:
           required: false
           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}/relationship-list/relationship:
@@ -2660,29 +2887,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 +2939,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 +2985,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 +3043,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 +3088,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,110 +3097,45 @@ 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: 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
+          example: __L3-INTERFACE-IPV4-ADDRESS__
     put:
       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,37 +3152,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: 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"
+    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: UpdateCloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterfaceL3InterfaceIpv4AddressList
+      consumes:
+        - 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-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 updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/l3-interface-ipv4-address-list"
     delete:
       tags:
         - CloudInfrastructure
@@ -3020,31 +3279,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: resource-version
           in: query
           description: resource-version for concurrency
@@ -3071,34 +3336,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-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/CloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterfaceL3InterfaceIpv6AddressList.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -3123,31 +3394,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-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}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}:
     get:
       tags:
@@ -3162,7 +3439,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:
@@ -3171,111 +3448,115 @@ 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: 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
+          example: __L3-INTERFACE-IPV6-ADDRESS__
+    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
-        - 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
+          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: macaddr
-          in: query
-          description: MAC address for the interface
-          required: false
+          example: __CLOUD-REGION-ID__
+        - name: tenant-id
+          in: path
+          description: Unique id relative to the cloud-region.
+          required: true
           type: string
-        - name: network-name
-          in: query
-          description: Name of the network
-          required: false
+          example: __TENANT-ID__
+        - name: vserver-id
+          in: path
+          description: Unique identifier for this vserver relative to its tenant
+          required: true
           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
+          example: __VSERVER-ID__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
           type: string
-        - name: neutron-subnet-id
-          in: query
-          description: Neutron id of subnet that address belongs to
-          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/CloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterfaceL3InterfaceIpv6AddressList.json)
+          required: true
+          schema:
+            $ref: "#/definitions/l3-interface-ipv6-address-list"
+    patch:
       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: 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
@@ -3291,37 +3572,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: 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 updated.
           required: true
           schema:
-            $ref: "#/definitions/l3-interface-ipv6-address-list"
+            $ref: "#/patchDefinitions/l3-interface-ipv6-address-list"
     delete:
       tags:
         - CloudInfrastructure
@@ -3343,31 +3630,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-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
@@ -3387,7 +3680,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:
@@ -3396,90 +3689,103 @@ 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: 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
+          example: __INTERFACE-NAME__
+    put:
+      tags:
+        - CloudInfrastructure
+      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: createOrUpdateCloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterface
+      consumes:
+        - 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: prov-status
-          in: query
-          description: Trigger for operational monitoring of this resource by Service Assurance systems.
-          required: false
+          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: 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
+          example: __CLOUD-REGION-ID__
+        - name: tenant-id
+          in: path
+          description: Unique id relative to the cloud-region.
+          required: true
           type: string
-        - name: macaddr
-          in: query
-          description: MAC address for the interface
-          required: false
+          example: __TENANT-ID__
+        - name: vserver-id
+          in: path
+          description: Unique identifier for this vserver relative to its tenant
+          required: true
           type: string
-        - name: network-name
-          in: query
-          description: Name of the network
-          required: false
+          example: __VSERVER-ID__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
           type: string
-    put:
+          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/CloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterface.json)
+          required: true
+          schema:
+            $ref: "#/definitions/l-interface"
+    patch:
       tags:
         - CloudInfrastructure
-      summary: create or update an existing l-interface
-      description: create or update an existing l-interface
-      operationId: createOrUpdateCloudInfrastructureCloudRegionsCloudRegionTenantsTenantVserversVserverLInterfacesLInterface
+      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
@@ -3495,32 +3801,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: body
           in: body
-          description: l-interface object that needs to be created or updated
+          description: l-interface object that needs to be updated.
           required: true
           schema:
-            $ref: "#/definitions/l-interface"
+            $ref: "#/patchDefinitions/l-interface"
     delete:
       tags:
         - CloudInfrastructure
@@ -3542,26 +3853,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 +3897,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,64 +3906,45 @@ 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
-        - 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
+          example: __VSERVER-ID__
+        - name: interface-name
           in: query
-          description: This field will store the tenant context.
+          description:
           required: false
           type: string
-        - name: vserver-name
+        - name: interface-id
           in: query
-          description: Name of vserver
+          description:
           required: false
           type: string
-        - name: vserver-name2
+        - name: macaddr
           in: query
-          description: Alternative name of vserver
+          description:
           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:
           required: false
           type: string
-        - name: in-maint
-          in: query
-          required: false
-          type: boolean
-        - name: is-closed-loop-disabled
-          in: query
-          required: false
-          type: boolean
   /cloud-infrastructure/cloud-regions/cloud-region/{cloud-owner}/{cloud-region-id}/tenants/tenant/{tenant-id}/vservers/vserver/{vserver-id}:
     get:
       tags:
@@ -3662,7 +3959,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,69 +3968,33 @@ 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
-        - 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
+          example: __VSERVER-ID__
     put:
       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 +4011,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 updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/vserver"
     delete:
       tags:
         - CloudInfrastructure
@@ -3792,21 +4114,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 +4152,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,36 +4161,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
-        - name: cloud-type
+          example: __TENANT-ID__
+        - name: vserver-id
           in: query
-          description: Type of the cloud (e.g., openstack)
+          description:
           required: false
           type: string
-        - name: owner-defined-type
+        - name: vserver-name
           in: query
-          description: Cloud-owner defined type indicator (e.g., dcp, lcp)
+          description:
           required: false
           type: string
-        - name: tenant-name
+        - name: vserver-name2
           in: query
-          description: Readable name of tenant
+          description:
           required: false
           type: string
-        - name: tenant-context
+        - name: prov-status
           in: query
-          description: This field will store the tenant context.
+          description:
           required: false
           type: string
+        - name: in-maint
+          in: query
+          description:
+          required: false
+          type: boolean
+        - name: is-closed-loop-disabled
+          in: query
+          description:
+          required: false
+          type: boolean
   /cloud-infrastructure/cloud-regions/cloud-region/{cloud-owner}/{cloud-region-id}/tenants/tenant/{tenant-id}/relationship-list/relationship:
     put:
       tags:
@@ -3886,19 +4225,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 +4265,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 +4292,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,41 +4301,27 @@ 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
-        - 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
+          example: __TENANT-ID__
     put:
       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 +4338,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 updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/tenant"
     delete:
       tags:
         - CloudInfrastructure
@@ -4044,16 +4429,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 +4461,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,19 +4470,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: cloud-type
+          example: __CLOUD-REGION-ID__
+        - name: tenant-id
           in: query
-          description: Type of the cloud (e.g., openstack)
+          description:
           required: false
           type: string
-        - name: owner-defined-type
+        - name: tenant-name
           in: query
-          description: Cloud-owner defined type indicator (e.g., dcp, lcp)
+          description:
+          required: false
+          type: string
+        - name: tenant-context
+          in: query
+          description:
           required: false
           type: string
   /cloud-infrastructure/cloud-regions/cloud-region/{cloud-owner}/{cloud-region-id}/flavors/flavor/{flavor-id}/relationship-list/relationship:
@@ -4118,19 +4513,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 +4553,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 +4580,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,36 +4589,27 @@ 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
-        - 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: flavor-name
-          in: query
-          description: Flavor name
-          required: false
-          type: string
+          example: __FLAVOR-ID__
     put:
       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 +4626,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 updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/flavor"
     delete:
       tags:
         - CloudInfrastructure
@@ -4271,16 +4717,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 +4749,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,19 +4758,21 @@ 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
+          example: __CLOUD-REGION-ID__
+        - name: flavor-id
           in: query
-          description: Type of the cloud (e.g., openstack)
+          description:
           required: false
           type: string
-        - name: owner-defined-type
+        - name: flavor-name
           in: query
-          description: Cloud-owner defined type indicator (e.g., dcp, lcp)
+          description:
           required: false
           type: string
   /cloud-infrastructure/cloud-regions/cloud-region/{cloud-owner}/{cloud-region-id}/group-assignments/group-assignment/{group-id}/relationship-list/relationship:
@@ -4345,19 +4796,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 +4836,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 +4863,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,79 +4872,119 @@ 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
-        - name: cloud-type
-          in: query
-          description: Type of the cloud (e.g., openstack)
-          required: false
+          example: __GROUP-ID__
+    put:
+      tags:
+        - CloudInfrastructure
+      summary: 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
+        - 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: owner-defined-type
-          in: query
-          description: Cloud-owner defined type indicator (e.g., dcp, lcp)
-          required: false
+          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: group-type
-          in: query
-          description: Group type - the type of group this instance refers to
-          required: false
+          example: __CLOUD-REGION-ID__
+        - name: group-id
+          in: path
+          description: Group id, expected to be unique across cloud-region.
+          required: true
           type: string
-        - name: group-name
-          in: query
-          description: Group name - name assigned to the group
-          required: false
+          example: __GROUP-ID__
+        - name: body
+          in: body
+          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
-    put:
+          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 updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/group-assignment"
+    delete:
       tags:
         - CloudInfrastructure
-      summary: create or update an existing group-assignment
-      description: create or update an existing group-assignment
-      operationId: createOrUpdateCloudInfrastructureCloudRegionsCloudRegionGroupAssignmentsGroupAssignment
-      consumes:
-        - 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: group-id
-          in: path
-          description: Group id, expected to be unique across cloud-region.
-          required: true
-          type: string
-        - name: body
-          in: body
-          description: group-assignment object that needs to be created or updated
-          required: true
-          schema:
-            $ref: "#/definitions/group-assignment"
-    delete:
-      tags:
-        - CloudInfrastructure
-      summary: delete an existing group-assignment
-      description: delete an existing group-assignment
-      operationId: deleteCloudInfrastructureCloudRegionsCloudRegionGroupAssignmentsGroupAssignment
+      summary: delete an existing group-assignment
+      description: delete an existing group-assignment
+      operationId: deleteCloudInfrastructureCloudRegionsCloudRegionGroupAssignmentsGroupAssignment
       consumes:
         - application/json
         - application/xml
@@ -4503,16 +5000,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 +5032,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,19 +5041,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: cloud-type
+          example: __CLOUD-REGION-ID__
+        - name: group-id
           in: query
-          description: Type of the cloud (e.g., openstack)
+          description:
           required: false
           type: string
-        - name: owner-defined-type
+        - name: group-type
+          in: query
+          description:
+          required: false
+          type: string
+        - name: group-name
           in: query
-          description: Cloud-owner defined type indicator (e.g., dcp, lcp)
+          description:
           required: false
           type: string
   /cloud-infrastructure/cloud-regions/cloud-region/{cloud-owner}/{cloud-region-id}/snapshots/snapshot/{snapshot-id}/relationship-list/relationship:
@@ -4577,19 +5084,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 +5124,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 +5151,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,56 +5160,27 @@ 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
-        - 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: snapshot-name
-          in: query
-          description: Snapshot name
-          required: false
-          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
-        - name: prev-snapshot-id
-          in: query
-          description: This field contains the UUID of the previous snapshot (if any).
-          required: false
-          type: string
+          example: __SNAPSHOT-ID__
     put:
       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 +5197,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 updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/snapshot"
     delete:
       tags:
         - CloudInfrastructure
@@ -4750,16 +5288,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 +5320,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,19 +5329,41 @@ 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
+          example: __CLOUD-REGION-ID__
+        - name: snapshot-id
           in: query
-          description: Type of the cloud (e.g., openstack)
+          description:
           required: false
           type: string
-        - name: owner-defined-type
+        - name: snapshot-name
+          in: query
+          description:
+          required: false
+          type: string
+        - name: application
+          in: query
+          description:
+          required: false
+          type: string
+        - name: application-vendor
+          in: query
+          description:
+          required: false
+          type: string
+        - name: application-version
+          in: query
+          description:
+          required: false
+          type: string
+        - name: prev-snapshot-id
           in: query
-          description: Cloud-owner defined type indicator (e.g., dcp, lcp)
+          description:
           required: false
           type: string
   /cloud-infrastructure/cloud-regions/cloud-region/{cloud-owner}/{cloud-region-id}/images/image/{image-id}/relationship-list/relationship:
@@ -4824,19 +5387,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 +5427,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 +5454,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,55 +5463,32 @@ 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
-        - 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: image-name
-          in: query
-          description: Image name
-          required: false
-          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: __METANAME__
     put:
       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 +5505,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 updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/metadatum"
     delete:
       tags:
         - CloudInfrastructure
@@ -5000,20 +5606,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 +5643,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,44 +5652,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
-        - 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: image-name
-          in: query
-          description: Image name
-          required: false
-          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
+          example: __IMAGE-ID__
+        - name: metaname
           in: query
-          description: The version of the application.
+          description:
           required: false
           type: string
   /cloud-infrastructure/cloud-regions/cloud-region/{cloud-owner}/{cloud-region-id}/images/image/{image-id}:
@@ -5096,7 +5684,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,51 +5693,27 @@ 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
-        - 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: image-name
-          in: query
-          description: Image name
-          required: false
-          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: __IMAGE-ID__
     put:
       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 +5730,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 updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/image"
     delete:
       tags:
         - CloudInfrastructure
@@ -5203,16 +5821,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 +5853,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,19 +5862,36 @@ 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
+          example: __CLOUD-REGION-ID__
+        - name: image-id
           in: query
-          description: Type of the cloud (e.g., openstack)
+          description:
           required: false
           type: string
-        - name: owner-defined-type
+        - name: image-name
+          in: query
+          description:
+          required: false
+          type: string
+        - name: application
+          in: query
+          description:
+          required: false
+          type: string
+        - name: application-vendor
+          in: query
+          description:
+          required: false
+          type: string
+        - name: application-version
           in: query
-          description: Cloud-owner defined type indicator (e.g., dcp, lcp)
+          description:
           required: false
           type: string
   /cloud-infrastructure/cloud-regions/cloud-region/{cloud-owner}/{cloud-region-id}/dvs-switches/dvs-switch/{switch-name}/relationship-list/relationship:
@@ -5277,19 +5915,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 +5955,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 +5982,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,36 +5991,27 @@ 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: 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: vcenter-url
-          in: query
-          description: URL used to reach the vcenter
-          required: false
-          type: string
+          example: __SWITCH-NAME__
     put:
       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,22 +6028,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: 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"
+    patch:
+      tags:
+        - CloudInfrastructure
+      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
+      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: 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 updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/dvs-switch"
     delete:
       tags:
         - CloudInfrastructure
@@ -5430,16 +6119,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: resource-version
           in: query
           description: resource-version for concurrency
@@ -5459,7 +6151,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/dvs-switches"
+              $ref: "#/getDefinitions/dvs-switches"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -5468,19 +6160,21 @@ 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
+          example: __CLOUD-REGION-ID__
+        - name: switch-name
           in: query
-          description: Type of the cloud (e.g., openstack)
+          description:
           required: false
           type: string
-        - name: owner-defined-type
+        - name: vcenter-url
           in: query
-          description: Cloud-owner defined type indicator (e.g., dcp, lcp)
+          description:
           required: false
           type: string
   /cloud-infrastructure/cloud-regions/cloud-region/{cloud-owner}/{cloud-region-id}/oam-networks/oam-network/{network-uuid}/relationship-list/relationship:
@@ -5504,19 +6198,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: 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
+          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"
@@ -5541,16 +6238,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__
   /cloud-infrastructure/cloud-regions/cloud-region/{cloud-owner}/{cloud-region-id}/oam-networks/oam-network/{network-uuid}:
     get:
       tags:
@@ -5565,7 +6265,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/oam-network"
+              $ref: "#/getDefinitions/oam-network"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -5574,42 +6274,27 @@ 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
-        - 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: network-name
-          in: query
-          description: Name of the network.
-          required: false
-          type: string
-        - name: cvlan-tag
-          in: query
-          description: cvlan-id
-          required: false
-          type: integer
-          format: int64
+          example: __NETWORK-UUID__
     put:
       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 +6311,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 updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/oam-network"
     delete:
       tags:
         - CloudInfrastructure
@@ -5663,16 +6402,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 +6434,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,21 +6443,29 @@ 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
+          example: __CLOUD-REGION-ID__
+        - name: network-uuid
           in: query
-          description: Type of the cloud (e.g., openstack)
+          description:
           required: false
           type: string
-        - name: owner-defined-type
+        - name: network-name
           in: query
-          description: Cloud-owner defined type indicator (e.g., dcp, lcp)
+          description:
           required: false
           type: string
+        - name: cvlan-tag
+          in: query
+          description:
+          required: false
+          type: integer
+          format: int64
   /cloud-infrastructure/cloud-regions/cloud-region/{cloud-owner}/{cloud-region-id}/availability-zones/availability-zone/{availability-zone-name}/relationship-list/relationship:
     put:
       tags:
@@ -5737,19 +6487,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 +6527,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 +6554,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,31 +6563,27 @@ 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
-        - 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
+          example: __AVAILABILITY-ZONE-NAME__
     put:
       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 +6600,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 updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/availability-zone"
     delete:
       tags:
         - CloudInfrastructure
@@ -5885,16 +6691,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 +6723,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,19 +6732,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
-        - name: cloud-type
-          in: query
-          description: Type of the cloud (e.g., openstack)
-          required: false
-          type: string
-        - name: owner-defined-type
+          example: __CLOUD-REGION-ID__
+        - name: availability-zone-name
           in: query
-          description: Cloud-owner defined type indicator (e.g., dcp, lcp)
+          description:
           required: false
           type: string
   /cloud-infrastructure/cloud-regions/cloud-region/{cloud-owner}/{cloud-region-id}/relationship-list/relationship:
@@ -5959,14 +6765,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,11 +6799,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__
   /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:
@@ -6017,19 +6827,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: esr-system-info-id
           in: path
           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"
@@ -6054,16 +6867,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: esr-system-info-id
           in: path
           description: Unique ID of esr system info.
           required: true
           type: string
+          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:
@@ -6078,7 +6894,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/esr-system-info"
+              $ref: "#/getDefinitions/esr-system-info"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -6087,41 +6903,27 @@ 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: esr-system-info-id
           in: path
           description: Unique ID of esr system info.
           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: system-name
-          in: query
-          description: name of external system.
-          required: false
-          type: string
-        - name: system-type
-          in: query
-          description: it could be vim/vnfm/thirdparty-sdnc/ems-resource/ems-performance/ems-alarm.
-          required: false
-          type: string
+          example: __ESR-SYSTEM-INFO-ID__
     put:
       tags:
         - CloudInfrastructure
       summary: create or update an existing esr-system-info
-      description: 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
@@ -6138,28 +6940,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: esr-system-info-id
           in: path
           description: Unique ID of esr system info.
           required: true
           type: string
+          example: __ESR-SYSTEM-INFO-ID__
         - name: body
           in: body
-          description: esr-system-info 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/esr-system-info"
-    delete:
+    patch:
       tags:
         - CloudInfrastructure
-      summary: delete an existing esr-system-info
-      description: delete an existing esr-system-info
-      operationId: deleteCloudInfrastructureCloudRegionsCloudRegionEsrSystemInfoListEsrSystemInfo
+      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 +6991,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
+          example: __CLOUD-REGION-ID__
         - name: esr-system-info-id
           in: path
           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 updated.
           required: true
-          type: string
-  /cloud-infrastructure/cloud-regions/cloud-region/{cloud-owner}/{cloud-region-id}/esr-system-info-list:
-    get:
+          schema:
+            $ref: "#/patchDefinitions/esr-system-info"
+    delete:
       tags:
         - CloudInfrastructure
-      summary: returns esr-system-info-list
-      description: returns esr-system-info-list
-      operationId: getCloudInfrastructureCloudRegionsCloudRegionEsrSystemInfoList
+      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/esr-system-info-list"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -6213,28 +7031,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 +7063,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,27 +7072,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
-        - name: cloud-type
+          example: __CLOUD-REGION-ID__
+        - name: esr-system-info-id
           in: query
-          description: Type of the cloud (e.g., openstack)
+          description:
           required: false
           type: string
-        - name: owner-defined-type
+        - name: system-name
+          in: query
+          description:
+          required: false
+          type: string
+        - name: system-type
           in: query
-          description: Cloud-owner defined type indicator (e.g., dcp, lcp)
+          description:
           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 +7115,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: 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
@@ -6319,23 +7155,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: resource-version
-          in: query
-          description: resource-version for concurrency
+          example: __CLOUD-REGION-ID__
+        - name: vip-ipv4-address
+          in: path
+          description: IP address
           required: true
           type: string
-  /cloud-infrastructure/cloud-regions:
+          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 cloud-regions
-      description: returns cloud-regions
-      operationId: getCloudInfrastructureCloudRegions
+      summary: returns vip-ipv4-address-list
+      description: returns vip-ipv4-address-list
+      operationId: getCloudInfrastructureCloudRegionsCloudRegionVipIpv4AddressList
       produces:
         - application/json
         - application/xml
@@ -6343,15 +7182,37 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/cloud-regions"
+              $ref: "#/getDefinitions/vip-ipv4-address-list"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
-  /cloud-infrastructure/network-profiles/network-profile/{nm-profile-name}/relationship-list/relationship:
+      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__
     put:
       tags:
         - CloudInfrastructure
-      summary: see node definition for valid relationships
-      operationId: createOrUpdateCloudInfrastructureNetworkProfilesNetworkProfileRelationshipListRelationship
+      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
@@ -6362,23 +7223,47 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: nm-profile-name
+        - name: cloud-owner
           in: path
-          description: Unique name of network profile.
+          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: relationship object that needs to be created or updated
+          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/relationship"
-    delete:
+            $ref: "#/definitions/vip-ipv4-address-list"
+    patch:
       tags:
         - CloudInfrastructure
-      summary: delete an existing relationship
-      description: delete an existing relationship
-      operationId: deleteCloudInfrastructureNetworkProfilesNetworkProfileRelationshipListRelationship
+      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
@@ -6389,67 +7274,36 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: nm-profile-name
+        - name: cloud-owner
           in: path
-          description: Unique name of network profile.
+          description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
-  /cloud-infrastructure/network-profiles/network-profile/{nm-profile-name}:
-    get:
-      tags:
-        - CloudInfrastructure
-      summary: returns network-profile
-      description: returns network-profile
-      operationId: getCloudInfrastructureNetworkProfilesNetworkProfile
-      produces:
-        - application/json
-        - application/xml
-      responses:
-        "200":
-          description: successful operation
-          schema:
-              $ref: "#/definitions/network-profile"
-        "default":
-          description: Response codes found in [response codes](https://wiki.onap.org/).
-      parameters:
-        - name: nm-profile-name
+          example: __CLOUD-OWNER__
+        - name: cloud-region-id
           in: path
-          description: Unique name of network profile.
+          description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
-    put:
-      tags:
-        - CloudInfrastructure
-      summary: create or update an existing network-profile
-      description: create or update an existing network-profile
-      operationId: createOrUpdateCloudInfrastructureNetworkProfilesNetworkProfile
-      consumes:
-        - 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
+          example: __CLOUD-REGION-ID__
+        - name: vip-ipv4-address
           in: path
-          description: Unique name of network profile.
+          description: IP address
           required: true
           type: string
+          example: __VIP-IPV4-ADDRESS__
         - name: body
           in: body
-          description: network-profile object that needs to be created or updated
+          description: vip-ipv4-address-list object that needs to be updated.
           required: true
           schema:
-            $ref: "#/definitions/network-profile"
+            $ref: "#/patchDefinitions/vip-ipv4-address-list"
     delete:
       tags:
         - CloudInfrastructure
-      summary: delete an existing network-profile
-      description: delete an existing network-profile
-      operationId: deleteCloudInfrastructureNetworkProfilesNetworkProfile
+      summary: delete an existing vip-ipv4-address-list
+      description: delete an existing vip-ipv4-address-list
+      operationId: deleteCloudInfrastructureCloudRegionsCloudRegionVipIpv4AddressList
       consumes:
         - application/json
         - application/xml
@@ -6460,39 +7314,35 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: nm-profile-name
+        - name: cloud-owner
           in: path
-          description: Unique name of network profile.
+          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/network-profiles:
-    get:
-      tags:
-        - CloudInfrastructure
-      summary: returns network-profiles
-      description: returns network-profiles
-      operationId: getCloudInfrastructureNetworkProfiles
-      produces:
-        - application/json
-        - application/xml
-      responses:
-        "200":
-          description: successful operation
-          schema:
-              $ref: "#/definitions/network-profiles"
-        "default":
-          description: Response codes found in [response codes](https://wiki.onap.org/).
-  /cloud-infrastructure/pservers/pserver/{hostname}/relationship-list/relationship:
+  /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: createOrUpdateCloudInfrastructurePserversPserverRelationshipListRelationship
+      operationId: createOrUpdateCloudInfrastructureCloudRegionsCloudRegionVipIpv6AddressListRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -6503,14 +7353,27 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: hostname
+        - name: cloud-owner
           in: path
-          description: Value from executing hostname on the compute node.
+          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
+          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"
@@ -6519,7 +7382,7 @@ paths:
         - CloudInfrastructure
       summary: delete an existing relationship
       description: delete an existing relationship
-      operationId: deleteCloudInfrastructurePserversPserverRelationshipListRelationship
+      operationId: deleteCloudInfrastructureCloudRegionsCloudRegionVipIpv6AddressListRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -6530,49 +7393,69 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: hostname
+        - name: cloud-owner
           in: path
-          description: Value from executing hostname on the compute node.
+          description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
-  /cloud-infrastructure/pservers/pserver/{hostname}/p-interfaces/p-interface/{interface-name}/relationship-list/relationship:
-    put:
+          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: see node definition for valid relationships
-      operationId: createOrUpdateCloudInfrastructurePserversPserverPInterfacesPInterfaceRelationshipListRelationship
-      consumes:
-        - application/json
-        - application/xml
+      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: hostname
+        - name: cloud-owner
           in: path
-          description: Value from executing hostname on the compute node.
+          description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
-        - name: interface-name
+          example: __CLOUD-OWNER__
+        - name: cloud-region-id
           in: path
-          description: Name that identifies the physical interface
+          description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
-        - name: body
-          in: body
-          description: relationship object that needs to be created or updated
+          example: __CLOUD-REGION-ID__
+        - name: vip-ipv6-address
+          in: path
+          description: IP address
           required: true
-          schema:
-            $ref: "#/definitions/relationship"
-    delete:
+          type: string
+          example: __VIP-IPV6-ADDRESS__
+    put:
       tags:
         - CloudInfrastructure
-      summary: delete an existing relationship
-      description: delete an existing relationship
-      operationId: deleteCloudInfrastructurePserversPserverPInterfacesPInterfaceRelationshipListRelationship
+      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
@@ -6583,22 +7466,47 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: hostname
+        - name: cloud-owner
           in: path
-          description: Value from executing hostname on the compute node.
+          description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
-        - name: interface-name
+          example: __CLOUD-OWNER__
+        - name: cloud-region-id
           in: path
-          description: Name that identifies the physical interface
+          description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
-  /cloud-infrastructure/pservers/pserver/{hostname}/p-interfaces/p-interface/{interface-name}/sriov-pfs/sriov-pf/{pf-pci-id}/relationship-list/relationship:
-    put:
+          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: see node definition for valid relationships
-      operationId: createOrUpdateCloudInfrastructurePserversPserverPInterfacesPInterfaceSriovPfsSriovPfRelationshipListRelationship
+      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
@@ -6609,33 +7517,36 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: hostname
+        - name: cloud-owner
           in: path
-          description: Value from executing hostname on the compute node.
+          description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
-        - name: interface-name
+          example: __CLOUD-OWNER__
+        - name: cloud-region-id
           in: path
-          description: Name that identifies the physical interface
+          description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
-        - name: pf-pci-id
+          example: __CLOUD-REGION-ID__
+        - name: vip-ipv6-address
           in: path
-          description: Identifier for the sriov-pf
+          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
+          description: vip-ipv6-address-list object that needs to be updated.
           required: true
           schema:
-            $ref: "#/definitions/relationship"
+            $ref: "#/patchDefinitions/vip-ipv6-address-list"
     delete:
       tags:
         - CloudInfrastructure
-      summary: delete an existing relationship
-      description: delete an existing relationship
-      operationId: deleteCloudInfrastructurePserversPserverPInterfacesPInterfaceSriovPfsSriovPfRelationshipListRelationship
+      summary: delete an existing vip-ipv6-address-list
+      description: delete an existing vip-ipv6-address-list
+      operationId: deleteCloudInfrastructureCloudRegionsCloudRegionVipIpv6AddressList
       consumes:
         - application/json
         - application/xml
@@ -6646,84 +7557,68 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: hostname
+        - name: cloud-owner
           in: path
-          description: Value from executing hostname on the compute node.
+          description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
-        - name: interface-name
+          example: __CLOUD-OWNER__
+        - name: cloud-region-id
           in: path
-          description: Name that identifies the physical interface
+          description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
-        - name: pf-pci-id
+          example: __CLOUD-REGION-ID__
+        - name: vip-ipv6-address
           in: path
-          description: Identifier for the sriov-pf
+          description: IP address
           required: true
           type: string
-  /cloud-infrastructure/pservers/pserver/{hostname}/p-interfaces/p-interface/{interface-name}/sriov-pfs/sriov-pf/{pf-pci-id}:
+          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 sriov-pf
-      description: returns sriov-pf
-      operationId: getCloudInfrastructurePserversPserverPInterfacesPInterfaceSriovPfsSriovPf
-      produces:
-        - application/json
+      summary: returns cloud-region
+      description: returns cloud-region
+      operationId: getCloudInfrastructureCloudRegionsCloudRegion
+      produces:
+        - application/json
         - application/xml
       responses:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/sriov-pf"
+              $ref: "#/getDefinitions/cloud-region"
         "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
-        - name: interface-name
+        - name: cloud-owner
           in: path
-          description: Name that identifies the physical interface
+          description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
-        - name: pf-pci-id
+          example: __CLOUD-OWNER__
+        - name: cloud-region-id
           in: path
-          description: Identifier for the sriov-pf
+          description: Identifier used by the vendor for the region. Second part of composite key
           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: pserver-id
-          in: query
-          description: ID of Pserver
-          required: false
-          type: string
-        - name: in-maint
-          in: query
-          required: false
-          type: boolean
-        - name: pserver-name2
-          in: query
-          description: alternative pserver name
-          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: __CLOUD-REGION-ID__
     put:
       tags:
         - CloudInfrastructure
-      summary: create or update an existing sriov-pf
-      description: create or update an existing sriov-pf
-      operationId: createOrUpdateCloudInfrastructurePserversPserverPInterfacesPInterfaceSriovPfsSriovPf
+      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
@@ -6734,33 +7629,75 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: hostname
+        - name: cloud-owner
           in: path
-          description: Value from executing hostname on the compute node.
+          description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
-        - name: interface-name
+          example: __CLOUD-OWNER__
+        - name: cloud-region-id
           in: path
-          description: Name that identifies the physical interface
+          description: Identifier used by the vendor for the region. Second part of composite key
           required: true
           type: string
-        - name: pf-pci-id
+          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: Identifier for the sriov-pf
+          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: sriov-pf object that needs to be created or updated
+          description: cloud-region object that needs to be updated.
           required: true
           schema:
-            $ref: "#/definitions/sriov-pf"
+            $ref: "#/patchDefinitions/cloud-region"
     delete:
       tags:
         - CloudInfrastructure
-      summary: delete an existing sriov-pf
-      description: delete an existing sriov-pf
-      operationId: deleteCloudInfrastructurePserversPserverPInterfacesPInterfaceSriovPfsSriovPf
+      summary: delete an existing cloud-region
+      description: delete an existing cloud-region
+      operationId: deleteCloudInfrastructureCloudRegionsCloudRegion
       consumes:
         - application/json
         - application/xml
@@ -6771,33 +7708,30 @@ paths:
         "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
-        - name: interface-name
+        - name: cloud-owner
           in: path
-          description: Name that identifies the physical interface
+          description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
           required: true
           type: string
-        - name: pf-pci-id
+          example: __CLOUD-OWNER__
+        - name: cloud-region-id
           in: path
-          description: Identifier for the sriov-pf
+          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
           required: true
           type: string
-  /cloud-infrastructure/pservers/pserver/{hostname}/p-interfaces/p-interface/{interface-name}/sriov-pfs:
+  /cloud-infrastructure/cloud-regions:
     get:
       tags:
         - CloudInfrastructure
-      summary: returns sriov-pfs
-      description: returns sriov-pfs
-      operationId: getCloudInfrastructurePserversPserverPInterfacesPInterfaceSriovPfs
+      summary: returns cloud-regions
+      description: returns cloud-regions
+      operationId: getCloudInfrastructureCloudRegions
       produces:
         - application/json
         - application/xml
@@ -6805,50 +7739,36 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/sriov-pfs"
+              $ref: "#/getDefinitions/cloud-regions"
         "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
-        - name: interface-name
-          in: path
-          description: Name that identifies the physical interface
-          required: true
-          type: string
-        - name: inv-status
+        - name: cloud-owner
           in: query
-          description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
+          description:
           required: false
           type: string
-        - name: pserver-id
+        - name: cloud-region-id
           in: query
-          description: ID of Pserver
+          description:
           required: false
           type: string
-        - name: in-maint
-          in: query
-          required: false
-          type: boolean
-        - name: pserver-name2
+        - name: cloud-type
           in: query
-          description: alternative pserver name
+          description:
           required: false
           type: string
-        - name: prov-status
+        - name: owner-defined-type
           in: query
-          description: Trigger for operational monitoring of this resource by Service Assurance systems.
+          description:
           required: false
           type: string
-  /cloud-infrastructure/pservers/pserver/{hostname}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/relationship-list/relationship:
+  /cloud-infrastructure/network-profiles/network-profile/{nm-profile-name}/relationship-list/relationship:
     put:
       tags:
         - CloudInfrastructure
       summary: see node definition for valid relationships
-      operationId: createOrUpdateCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceVlansVlanRelationshipListRelationship
+      operationId: createOrUpdateCloudInfrastructureNetworkProfilesNetworkProfileRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -6859,29 +7779,15 @@ paths:
         "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
-        - 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: nm-profile-name
           in: path
-          description: String that identifies the interface
+          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"
@@ -6890,7 +7796,7 @@ paths:
         - CloudInfrastructure
       summary: delete an existing relationship
       description: delete an existing relationship
-      operationId: deleteCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceVlansVlanRelationshipListRelationship
+      operationId: deleteCloudInfrastructureNetworkProfilesNetworkProfileRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -6901,32 +7807,45 @@ paths:
         "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
-        - name: interface-name
-          in: path
-          description: Name that identifies the physical interface
-          required: true
-          type: string
-        - name: interface-name
+        - name: nm-profile-name
           in: path
-          description: Name given to the interface
+          description: Unique name of network profile.
           required: true
           type: string
-        - name: vlan-interface
+          example: __NM-PROFILE-NAME__
+  /cloud-infrastructure/network-profiles/network-profile/{nm-profile-name}:
+    get:
+      tags:
+        - CloudInfrastructure
+      summary: returns network-profile
+      description: returns network-profile
+      operationId: getCloudInfrastructureNetworkProfilesNetworkProfile
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "200":
+          description: successful operation
+          schema:
+              $ref: "#/getDefinitions/network-profile"
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: nm-profile-name
           in: path
-          description: String that identifies the interface
+          description: Unique name of network profile.
           required: true
           type: string
-  /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:
+          example: __NM-PROFILE-NAME__
     put:
       tags:
         - CloudInfrastructure
-      summary: see node definition for valid relationships
-      operationId: createOrUpdateCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressListRelationshipListRelationship
+      summary: 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
         - application/xml
@@ -6937,43 +7856,63 @@ paths:
         "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
-        - name: interface-name
-          in: path
-          description: Name that identifies the physical interface
-          required: true
-          type: string
-        - name: interface-name
+        - name: nm-profile-name
           in: path
-          description: Name given to the interface
+          description: Unique name of network profile.
           required: true
           type: string
-        - name: vlan-interface
-          in: path
-          description: String that identifies the interface
+          example: __NM-PROFILE-NAME__
+        - name: body
+          in: body
+          description: network-profile object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructureNetworkProfilesNetworkProfile.json)
           required: true
-          type: string
-        - name: l3-interface-ipv4-address
+          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: IP address
+          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: network-profile object that needs to be updated.
           required: true
           schema:
-            $ref: "#/definitions/relationship"
+            $ref: "#/patchDefinitions/network-profile"
     delete:
       tags:
         - CloudInfrastructure
-      summary: delete an existing relationship
-      description: delete an existing relationship
-      operationId: deleteCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressListRelationshipListRelationship
+      summary: delete an existing network-profile
+      description: delete an existing network-profile
+      operationId: deleteCloudInfrastructureNetworkProfilesNetworkProfile
       consumes:
         - application/json
         - application/xml
@@ -6984,38 +7923,24 @@ paths:
         "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
-        - 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: nm-profile-name
           in: path
-          description: String that identifies the interface
+          description: Unique name of network profile.
           required: true
           type: string
-        - name: l3-interface-ipv4-address
-          in: path
-          description: IP address
+          example: __NM-PROFILE-NAME__
+        - name: resource-version
+          in: query
+          description: resource-version for concurrency
           required: true
           type: string
-  /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}:
+  /cloud-infrastructure/network-profiles:
     get:
       tags:
         - CloudInfrastructure
-      summary: returns l3-interface-ipv4-address-list
-      description: returns l3-interface-ipv4-address-list
-      operationId: getCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList
+      summary: returns network-profiles
+      description: returns network-profiles
+      operationId: getCloudInfrastructureNetworkProfiles
       produces:
         - application/json
         - application/xml
@@ -7023,7 +7948,28 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/l3-interface-ipv4-address-list"
+              $ref: "#/getDefinitions/network-profiles"
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: nm-profile-name
+          in: query
+          description:
+          required: false
+          type: string
+  /cloud-infrastructure/pservers/pserver/{hostname}/relationship-list/relationship:
+    put:
+      tags:
+        - CloudInfrastructure
+      summary: see node definition for valid relationships
+      operationId: createOrUpdateCloudInfrastructurePserversPserverRelationshipListRelationship
+      consumes:
+        - application/json
+        - application/xml
+      produces:
+        - application/json
+        - application/xml
+      responses:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -7032,98 +7978,41 @@ paths:
           description: Value from executing hostname on the compute node.
           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
+          example: __HOSTNAME__
+        - name: body
+          in: body
+          description: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructurePserversPserver.json)
           required: true
-          type: string
-        - name: l3-interface-ipv4-address
+          schema:
+            $ref: "#/definitions/relationship"
+    delete:
+      tags:
+        - CloudInfrastructure
+      summary: delete an existing relationship
+      description: delete an existing relationship
+      operationId: deleteCloudInfrastructurePserversPserverRelationshipListRelationship
+      consumes:
+        - 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: IP address
+          description: Value from executing hostname on the compute node.
           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: pserver-id
-          in: query
-          description: ID of Pserver
-          required: false
-          type: string
-        - name: in-maint
-          in: query
-          required: false
-          type: boolean
-        - name: pserver-name2
-          in: query
-          description: alternative pserver name
-          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
-          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: __HOSTNAME__
+  /cloud-infrastructure/pservers/pserver/{hostname}/p-interfaces/p-interface/{interface-name}/relationship-list/relationship:
     put:
       tags:
         - CloudInfrastructure
-      summary: create or update an existing l3-interface-ipv4-address-list
-      description: create or update an existing l3-interface-ipv4-address-list
-      operationId: createOrUpdateCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList
+      summary: see node definition for valid relationships
+      operationId: createOrUpdateCloudInfrastructurePserversPserverPInterfacesPInterfaceRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -7139,38 +8028,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
-        - 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
+          example: __INTERFACE-NAME__
         - name: body
           in: body
-          description: l3-interface-ipv4-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/CloudInfrastructurePserversPserverPInterfacesPInterface.json)
           required: true
           schema:
-            $ref: "#/definitions/l3-interface-ipv4-address-list"
+            $ref: "#/definitions/relationship"
     delete:
       tags:
         - CloudInfrastructure
-      summary: delete an existing l3-interface-ipv4-address-list
-      description: delete an existing l3-interface-ipv4-address-list
-      operationId: deleteCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList
+      summary: delete an existing relationship
+      description: delete an existing relationship
+      operationId: deleteCloudInfrastructurePserversPserverPInterfacesPInterfaceRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -7186,37 +8062,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
-        - 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
-  /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}/relationship-list/relationship:
+          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:
         - CloudInfrastructure
       summary: see node definition for valid relationships
-      operationId: createOrUpdateCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressListRelationshipListRelationship
+      operationId: createOrUpdateCloudInfrastructurePserversPserverPInterfacesPInterfaceSriovPfsSriovPfRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -7232,29 +8090,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
-        - 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
+          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/CloudInfrastructurePserversPserverPInterfacesPInterfaceSriovPfsSriovPf.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -7263,7 +8114,7 @@ paths:
         - CloudInfrastructure
       summary: delete an existing relationship
       description: delete an existing relationship
-      operationId: deleteCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressListRelationshipListRelationship
+      operationId: deleteCloudInfrastructurePserversPserverPInterfacesPInterfaceSriovPfsSriovPfRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -7279,33 +8130,26 @@ 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
-        - 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
+          example: __INTERFACE-NAME__
+        - name: pf-pci-id
           in: path
-          description: IP address
+          description: Identifier for the sriov-pf
           required: true
           type: string
-  /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}:
+          example: __PF-PCI-ID__
+  /cloud-infrastructure/pservers/pserver/{hostname}/p-interfaces/p-interface/{interface-name}/sriov-pfs/sriov-pf/{pf-pci-id}:
     get:
       tags:
         - CloudInfrastructure
-      summary: returns l3-interface-ipv6-address-list
-      description: returns l3-interface-ipv6-address-list
-      operationId: getCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList
+      summary: returns sriov-pf
+      description: returns sriov-pf
+      operationId: getCloudInfrastructurePserversPserverPInterfacesPInterfaceSriovPfsSriovPf
       produces:
         - application/json
         - application/xml
@@ -7313,7 +8157,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/l3-interface-ipv6-address-list"
+              $ref: "#/getDefinitions/sriov-pf"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -7322,98 +8166,79 @@ 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
-        - name: interface-name
+          example: __INTERFACE-NAME__
+        - name: pf-pci-id
           in: path
-          description: Name given to the interface
+          description: Identifier for the sriov-pf
           required: true
           type: string
-        - name: vlan-interface
+          example: __PF-PCI-ID__
+    put:
+      tags:
+        - CloudInfrastructure
+      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: createOrUpdateCloudInfrastructurePserversPserverPInterfacesPInterfaceSriovPfsSriovPf
+      consumes:
+        - 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: String that identifies the interface
+          description: Value from executing hostname on the compute node.
           required: true
           type: string
-        - name: l3-interface-ipv6-address
+          example: __HOSTNAME__
+        - name: interface-name
           in: path
-          description: IP address
+          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: pserver-id
-          in: query
-          description: ID of Pserver
-          required: false
+          example: __INTERFACE-NAME__
+        - name: pf-pci-id
+          in: path
+          description: Identifier for the sriov-pf
+          required: true
           type: string
-        - name: in-maint
-          in: query
-          required: false
-          type: boolean
-        - name: pserver-name2
-          in: query
-          description: alternative pserver name
-          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
-          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:
+          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/CloudInfrastructurePserversPserverPInterfacesPInterfaceSriovPfsSriovPf.json)
+          required: true
+          schema:
+            $ref: "#/definitions/sriov-pf"
+    patch:
       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: createOrUpdateCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList
+      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
@@ -7429,38 +8254,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
-        - 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
+          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-ipv6-address-list object that needs to be created or updated
+          description: sriov-pf object that needs to be updated.
           required: true
           schema:
-            $ref: "#/definitions/l3-interface-ipv6-address-list"
+            $ref: "#/patchDefinitions/sriov-pf"
     delete:
       tags:
         - CloudInfrastructure
-      summary: delete an existing l3-interface-ipv6-address-list
-      description: delete an existing l3-interface-ipv6-address-list
-      operationId: deleteCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList
+      summary: delete an existing sriov-pf
+      description: delete an existing sriov-pf
+      operationId: deleteCloudInfrastructurePserversPserverPInterfacesPInterfaceSriovPfsSriovPf
       consumes:
         - application/json
         - application/xml
@@ -7476,38 +8294,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
-        - 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
+          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: resource-version
           in: query
           description: resource-version for concurrency
           required: true
           type: string
-  /cloud-infrastructure/pservers/pserver/{hostname}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}:
+  /cloud-infrastructure/pservers/pserver/{hostname}/p-interfaces/p-interface/{interface-name}/sriov-pfs:
     get:
       tags:
         - CloudInfrastructure
-      summary: returns vlan
-      description: returns vlan
-      operationId: getCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceVlansVlan
+      summary: returns sriov-pfs
+      description: returns sriov-pfs
+      operationId: getCloudInfrastructurePserversPserverPInterfacesPInterfaceSriovPfs
       produces:
         - application/json
         - application/xml
@@ -7515,7 +8326,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/vlan"
+              $ref: "#/getDefinitions/sriov-pfs"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -7524,77 +8335,24 @@ 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
-        - 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: inv-status
-          in: query
-          description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
-          required: false
-          type: string
-        - name: pserver-id
-          in: query
-          description: ID of Pserver
-          required: false
-          type: string
-        - name: in-maint
-          in: query
-          required: false
-          type: boolean
-        - name: pserver-name2
-          in: query
-          description: alternative pserver name
-          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
+          example: __INTERFACE-NAME__
+        - name: pf-pci-id
           in: query
-          description: This indicates the customers VPN ID associated with this vlan
+          description:
           required: false
           type: string
+  /cloud-infrastructure/pservers/pserver/{hostname}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/relationship-list/relationship:
     put:
       tags:
         - CloudInfrastructure
-      summary: create or update an existing vlan
-      description: create or update an existing vlan
-      operationId: createOrUpdateCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceVlansVlan
+      summary: see node definition for valid relationships
+      operationId: createOrUpdateCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceVlansVlanRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -7610,33 +8368,37 @@ 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: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceVlansVlan.json)
           required: true
           schema:
-            $ref: "#/definitions/vlan"
+            $ref: "#/definitions/relationship"
     delete:
       tags:
         - CloudInfrastructure
-      summary: delete an existing vlan
-      description: delete an existing vlan
-      operationId: deleteCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceVlansVlan
+      summary: delete an existing relationship
+      description: delete an existing relationship
+      operationId: deleteCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceVlansVlanRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -7652,104 +8414,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
-        - name: resource-version
-          in: query
-          description: resource-version for concurrency
-          required: true
-          type: string
-  /cloud-infrastructure/pservers/pserver/{hostname}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans:
-    get:
-      tags:
-        - CloudInfrastructure
-      summary: returns vlans
-      description: returns vlans
-      operationId: getCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceVlans
-      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: hostname
-          in: path
-          description: Value from executing hostname on the compute node.
-          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: inv-status
-          in: query
-          description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
-          required: false
-          type: string
-        - name: pserver-id
-          in: query
-          description: ID of Pserver
-          required: false
-          type: string
-        - name: in-maint
-          in: query
-          required: false
-          type: boolean
-        - name: pserver-name2
-          in: query
-          description: alternative pserver name
-          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
-  /cloud-infrastructure/pservers/pserver/{hostname}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/sriov-vfs/sriov-vf/{pci-id}/relationship-list/relationship:
+          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:
         - CloudInfrastructure
       summary: see node definition for valid relationships
-      operationId: createOrUpdateCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceSriovVfsSriovVfRelationshipListRelationship
+      operationId: createOrUpdateCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressListRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -7765,24 +8454,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
-        - 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-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"
@@ -7791,7 +8490,7 @@ paths:
         - CloudInfrastructure
       summary: delete an existing relationship
       description: delete an existing relationship
-      operationId: deleteCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceSriovVfsSriovVfRelationshipListRelationship
+      operationId: deleteCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressListRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -7807,28 +8506,38 @@ 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
-        - 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
-  /cloud-infrastructure/pservers/pserver/{hostname}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/sriov-vfs/sriov-vf/{pci-id}:
+          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:
         - CloudInfrastructure
-      summary: returns sriov-vf
-      description: returns sriov-vf
-      operationId: getCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceSriovVfsSriovVf
+      summary: returns l3-interface-ipv4-address-list
+      description: returns l3-interface-ipv4-address-list
+      operationId: getCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList
       produces:
         - application/json
         - application/xml
@@ -7836,7 +8545,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/sriov-vf"
+              $ref: "#/getDefinitions/l3-interface-ipv4-address-list"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -7845,86 +8554,40 @@ 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
-        - 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
-        - name: inv-status
-          in: query
-          description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
-          required: false
-          type: string
-        - name: pserver-id
-          in: query
-          description: ID of Pserver
-          required: false
-          type: string
-        - name: in-maint
-          in: query
-          required: false
-          type: boolean
-        - name: pserver-name2
-          in: query
-          description: alternative pserver name
-          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: 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
+          example: __VLAN-INTERFACE__
+        - name: l3-interface-ipv4-address
+          in: path
+          description: IP address
+          required: true
           type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
     put:
       tags:
         - CloudInfrastructure
-      summary: create or update an existing sriov-vf
-      description: create or update an existing sriov-vf
-      operationId: createOrUpdateCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceSriovVfsSriovVf
+      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: createOrUpdateCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList
       consumes:
         - application/json
         - application/xml
@@ -7940,33 +8603,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 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-ipv4-address
+          in: path
+          description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
         - name: body
           in: body
-          description: sriov-vf 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/sriov-vf"
-    delete:
+            $ref: "#/definitions/l3-interface-ipv4-address-list"
+    patch:
       tags:
         - CloudInfrastructure
-      summary: delete an existing sriov-vf
-      description: delete an existing sriov-vf
-      operationId: deleteCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceSriovVfsSriovVf
+      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
@@ -7982,41 +8666,50 @@ 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
-        - 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
-        - 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
-  /cloud-infrastructure/pservers/pserver/{hostname}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/sriov-vfs:
-    get:
+          example: __L3-INTERFACE-IPV4-ADDRESS__
+        - name: body
+          in: body
+          description: l3-interface-ipv4-address-list object that needs to be updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/l3-interface-ipv4-address-list"
+    delete:
       tags:
         - CloudInfrastructure
-      summary: returns sriov-vfs
-      description: returns sriov-vfs
-      operationId: getCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceSriovVfs
+      summary: delete an existing l3-interface-ipv4-address-list
+      description: delete an existing l3-interface-ipv4-address-list
+      operationId: deleteCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList
+      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:
@@ -8025,61 +8718,42 @@ 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
-        - name: inv-status
-          in: query
-          description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
-          required: false
-          type: string
-        - name: pserver-id
-          in: query
-          description: ID of Pserver
-          required: false
-          type: string
-        - name: in-maint
-          in: query
-          required: false
-          type: boolean
-        - name: pserver-name2
-          in: query
-          description: alternative pserver name
-          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
+          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
-  /cloud-infrastructure/pservers/pserver/{hostname}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/relationship-list/relationship:
+  /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}/relationship-list/relationship:
     put:
       tags:
         - CloudInfrastructure
       summary: see node definition for valid relationships
-      operationId: createOrUpdateCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceRelationshipListRelationship
+      operationId: createOrUpdateCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressListRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -8095,19 +8769,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"
@@ -8116,7 +8805,7 @@ paths:
         - CloudInfrastructure
       summary: delete an existing relationship
       description: delete an existing relationship
-      operationId: deleteCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceRelationshipListRelationship
+      operationId: deleteCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressListRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -8132,22 +8821,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
-  /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:
+          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:
+        - CloudInfrastructure
+      summary: returns l3-interface-ipv6-address-list
+      description: returns l3-interface-ipv6-address-list
+      operationId: getCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList
+      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: 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__
     put:
       tags:
         - CloudInfrastructure
-      summary: see node definition for valid relationships
-      operationId: createOrUpdateCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressListRelationshipListRelationship
+      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: createOrUpdateCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList
       consumes:
         - application/json
         - application/xml
@@ -8163,33 +8918,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 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: 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/CloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList.json)
           required: true
           schema:
-            $ref: "#/definitions/relationship"
-    delete:
+            $ref: "#/definitions/l3-interface-ipv6-address-list"
+    patch:
       tags:
         - CloudInfrastructure
-      summary: delete an existing relationship
-      description: delete an existing relationship
-      operationId: deleteCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressListRelationshipListRelationship
+      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
@@ -8205,36 +8981,50 @@ 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
-        - name: l3-interface-ipv4-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
-  /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:
+          example: __L3-INTERFACE-IPV6-ADDRESS__
+        - name: body
+          in: body
+          description: l3-interface-ipv6-address-list object that needs to be updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/l3-interface-ipv6-address-list"
+    delete:
       tags:
         - CloudInfrastructure
-      summary: returns l3-interface-ipv4-address-list
-      description: returns l3-interface-ipv4-address-list
-      operationId: getCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList
+      summary: delete an existing l3-interface-ipv6-address-list
+      description: delete an existing l3-interface-ipv6-address-list
+      operationId: deleteCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList
+      consumes:
+        - application/json
+        - application/xml
       produces:
         - application/json
         - application/xml
       responses:
-        "200":
-          description: successful operation
-          schema:
-              $ref: "#/definitions/l3-interface-ipv4-address-list"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -8243,89 +9033,51 @@ 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
-        - 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: inv-status
-          in: query
-          description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
-          required: false
-          type: string
-        - name: pserver-id
-          in: query
-          description: ID of Pserver
-          required: false
-          type: string
-        - name: in-maint
-          in: query
-          required: false
-          type: boolean
-        - name: pserver-name2
-          in: query
-          description: alternative pserver name
-          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: neutron-network-id
-          in: query
-          description: Neutron network id of the interface that address belongs to
-          required: false
+          example: __VLAN-INTERFACE__
+        - name: l3-interface-ipv6-address
+          in: path
+          description: IP address
+          required: true
           type: string
-        - name: neutron-subnet-id
+          example: __L3-INTERFACE-IPV6-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
-    put:
+  /cloud-infrastructure/pservers/pserver/{hostname}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}:
+    get:
       tags:
         - CloudInfrastructure
-      summary: create or update an existing l3-interface-ipv4-address-list
-      description: create or update an existing l3-interface-ipv4-address-list
-      operationId: createOrUpdateCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList
-      consumes:
-        - application/json
-        - application/xml
+      summary: returns vlan
+      description: returns vlan
+      operationId: getCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceVlansVlan
       produces:
         - application/json
         - application/xml
       responses:
+        "200":
+          description: successful operation
+          schema:
+              $ref: "#/getDefinitions/vlan"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -8334,33 +9086,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
-        - 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: l3-interface-ipv4-address-list object that needs to be created or updated
-          required: true
-          schema:
-            $ref: "#/definitions/l3-interface-ipv4-address-list"
-    delete:
+          example: __VLAN-INTERFACE__
+    put:
       tags:
         - CloudInfrastructure
-      summary: delete an existing l3-interface-ipv4-address-list
-      description: delete an existing l3-interface-ipv4-address-list
-      operationId: deleteCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList
+      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: createOrUpdateCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceVlansVlan
       consumes:
         - application/json
         - application/xml
@@ -8376,32 +9129,48 @@ 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
-        - 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: 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. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceVlansVlan.json)
           required: true
-          type: string
-  /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}/relationship-list/relationship:
-    put:
+          schema:
+            $ref: "#/definitions/vlan"
+    patch:
       tags:
         - CloudInfrastructure
-      summary: see node definition for valid relationships
-      operationId: createOrUpdateCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressListRelationshipListRelationship
+      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
@@ -8417,33 +9186,37 @@ 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
-        - name: l3-interface-ipv6-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: vlan object that needs to be updated.
           required: true
           schema:
-            $ref: "#/definitions/relationship"
+            $ref: "#/patchDefinitions/vlan"
     delete:
       tags:
         - CloudInfrastructure
-      summary: delete an existing relationship
-      description: delete an existing relationship
-      operationId: deleteCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressListRelationshipListRelationship
+      summary: delete an existing vlan
+      description: delete an existing vlan
+      operationId: deleteCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceVlansVlan
       consumes:
         - application/json
         - application/xml
@@ -8459,28 +9232,37 @@ 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
-        - name: l3-interface-ipv6-address
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
           in: path
-          description: IP address
+          description: String that identifies the interface
           required: true
           type: string
-  /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}:
+          example: __VLAN-INTERFACE__
+        - name: resource-version
+          in: query
+          description: resource-version for concurrency
+          required: true
+          type: string
+  /cloud-infrastructure/pservers/pserver/{hostname}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans:
     get:
       tags:
         - CloudInfrastructure
-      summary: returns l3-interface-ipv6-address-list
-      description: returns l3-interface-ipv6-address-list
-      operationId: getCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList
+      summary: returns vlans
+      description: returns vlans
+      operationId: getCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceVlans
       produces:
         - application/json
         - application/xml
@@ -8488,7 +9270,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/l3-interface-ipv6-address-list"
+              $ref: "#/getDefinitions/vlans"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -8497,82 +9279,41 @@ 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
-        - 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: pserver-id
-          in: query
-          description: ID of Pserver
-          required: false
-          type: string
-        - name: in-maint
-          in: query
-          required: false
-          type: boolean
-        - name: pserver-name2
-          in: query
-          description: alternative pserver name
-          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
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
           in: query
-          description: Name of the network
+          description:
           required: false
           type: string
         - name: vlan-id-inner
           in: query
-          description: Inner VLAN tag
+          description:
           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: vpn-key
           in: query
-          description: Neutron id of subnet that address belongs to
+          description:
           required: false
           type: string
+  /cloud-infrastructure/pservers/pserver/{hostname}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/sriov-vfs/sriov-vf/{pci-id}/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: createOrUpdateCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList
+      summary: see node definition for valid relationships
+      operationId: createOrUpdateCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceSriovVfsSriovVfRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -8588,33 +9329,37 @@ 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
-        - name: l3-interface-ipv6-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-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/CloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceSriovVfsSriovVf.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: deleteCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList
+      summary: delete an existing relationship
+      description: delete an existing relationship
+      operationId: deleteCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceSriovVfsSriovVfRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -8630,33 +9375,32 @@ 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
-        - name: l3-interface-ipv6-address
+          example: __INTERFACE-NAME__
+        - name: pci-id
           in: path
-          description: IP address
-          required: true
-          type: string
-        - name: resource-version
-          in: query
-          description: resource-version for concurrency
+          description: PCI ID used to identify the sriov-vf
           required: true
           type: string
-  /cloud-infrastructure/pservers/pserver/{hostname}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}:
+          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:
         - CloudInfrastructure
-      summary: returns l-interface
-      description: returns l-interface
-      operationId: getCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterface
+      summary: returns sriov-vf
+      description: returns sriov-vf
+      operationId: getCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceSriovVfsSriovVf
       produces:
         - application/json
         - application/xml
@@ -8664,7 +9408,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/l-interface"
+              $ref: "#/getDefinitions/sriov-vf"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -8673,61 +9417,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
-        - name: inv-status
-          in: query
-          description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
-          required: false
-          type: string
-        - name: pserver-id
-          in: query
-          description: ID of Pserver
-          required: false
-          type: string
-        - name: in-maint
-          in: query
-          required: false
-          type: boolean
-        - name: pserver-name2
-          in: query
-          description: alternative pserver name
-          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
+          example: __INTERFACE-NAME__
+        - name: pci-id
+          in: path
+          description: PCI ID used to identify the sriov-vf
+          required: true
           type: string
+          example: __PCI-ID__
     put:
       tags:
         - CloudInfrastructure
-      summary: create or update an existing l-interface
-      description: create or update an existing l-interface
-      operationId: createOrUpdateCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterface
+      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: createOrUpdateCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceSriovVfsSriovVf
       consumes:
         - application/json
         - application/xml
@@ -8743,28 +9460,48 @@ 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: l-interface 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/l-interface"
-    delete:
+            $ref: "#/definitions/sriov-vf"
+    patch:
       tags:
         - CloudInfrastructure
-      summary: delete an existing l-interface
-      description: delete an existing l-interface
-      operationId: deleteCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterface
+      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
@@ -8780,36 +9517,44 @@ 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
-        - 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
-  /cloud-infrastructure/pservers/pserver/{hostname}/p-interfaces/p-interface/{interface-name}/l-interfaces:
-    get:
+          example: __PCI-ID__
+        - name: body
+          in: body
+          description: sriov-vf object that needs to be updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/sriov-vf"
+    delete:
       tags:
         - CloudInfrastructure
-      summary: returns l-interfaces
-      description: returns l-interfaces
-      operationId: getCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfaces
+      summary: delete an existing sriov-vf
+      description: delete an existing sriov-vf
+      operationId: deleteCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceSriovVfsSriovVf
+      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:
@@ -8818,42 +9563,37 @@ 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
-        - name: inv-status
-          in: query
-          description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
-          required: false
-          type: string
-        - name: pserver-id
-          in: query
-          description: ID of Pserver
-          required: false
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
           type: string
-        - name: in-maint
-          in: query
-          required: false
-          type: boolean
-        - name: pserver-name2
-          in: query
-          description: alternative pserver name
-          required: false
+          example: __INTERFACE-NAME__
+        - name: pci-id
+          in: path
+          description: PCI ID used to identify the sriov-vf
+          required: true
           type: string
-        - name: prov-status
+          example: __PCI-ID__
+        - 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
-  /cloud-infrastructure/pservers/pserver/{hostname}/p-interfaces/p-interface/{interface-name}:
+  /cloud-infrastructure/pservers/pserver/{hostname}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/sriov-vfs:
     get:
       tags:
         - CloudInfrastructure
-      summary: returns p-interface
-      description: returns p-interface
-      operationId: getCloudInfrastructurePserversPserverPInterfacesPInterface
+      summary: returns sriov-vfs
+      description: returns sriov-vfs
+      operationId: getCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceSriovVfs
       produces:
         - application/json
         - application/xml
@@ -8861,7 +9601,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/p-interface"
+              $ref: "#/getDefinitions/sriov-vfs"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -8870,41 +9610,50 @@ 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
-        - name: inv-status
+          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: query
-          description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
+          description:
           required: false
           type: string
-        - name: pserver-id
+        - name: vf-vlan-filter
           in: query
-          description: ID of Pserver
+          description:
           required: false
           type: string
-        - name: in-maint
+        - name: vf-mac-filter
           in: query
+          description:
           required: false
-          type: boolean
-        - name: pserver-name2
+          type: string
+        - name: vf-vlan-strip
           in: query
-          description: alternative pserver name
+          description:
           required: false
-          type: string
-        - name: prov-status
+          type: boolean
+        - name: neutron-network-id
           in: query
-          description: Trigger for operational monitoring of this resource by Service Assurance systems.
+          description:
           required: false
           type: string
+  /cloud-infrastructure/pservers/pserver/{hostname}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/relationship-list/relationship:
     put:
       tags:
         - CloudInfrastructure
-      summary: create or update an existing p-interface
-      description: create or update an existing p-interface
-      operationId: createOrUpdateCloudInfrastructurePserversPserverPInterfacesPInterface
+      summary: see node definition for valid relationships
+      operationId: createOrUpdateCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -8920,23 +9669,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: 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/CloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterface.json)
           required: true
           schema:
-            $ref: "#/definitions/p-interface"
+            $ref: "#/definitions/relationship"
     delete:
       tags:
         - CloudInfrastructure
-      summary: delete an existing p-interface
-      description: delete an existing p-interface
-      operationId: deleteCloudInfrastructurePserversPserverPInterfacesPInterface
+      summary: delete an existing relationship
+      description: delete an existing relationship
+      operationId: deleteCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -8952,64 +9709,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
-        - name: resource-version
-          in: query
-          description: resource-version for concurrency
-          required: true
-          type: string
-  /cloud-infrastructure/pservers/pserver/{hostname}/p-interfaces:
-    get:
-      tags:
-        - CloudInfrastructure
-      summary: returns p-interfaces
-      description: returns p-interfaces
-      operationId: getCloudInfrastructurePserversPserverPInterfaces
-      produces:
-        - application/json
-        - application/xml
-      responses:
-        "200":
-          description: successful operation
-          schema:
-              $ref: "#/definitions/p-interfaces"
-        "default":
-          description: Response codes found in [response codes](https://wiki.onap.org/).
-      parameters:
-        - name: hostname
+          example: __INTERFACE-NAME__
+        - name: interface-name
           in: path
-          description: Value from executing hostname on the compute node.
+          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: pserver-id
-          in: query
-          description: ID of Pserver
-          required: false
-          type: string
-        - name: in-maint
-          in: query
-          required: false
-          type: boolean
-        - name: pserver-name2
-          in: query
-          description: alternative pserver name
-          required: false
-          type: string
-  /cloud-infrastructure/pservers/pserver/{hostname}/lag-interfaces/lag-interface/{interface-name}/relationship-list/relationship:
+          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:
         - CloudInfrastructure
       summary: see node definition for valid relationships
-      operationId: createOrUpdateCloudInfrastructurePserversPserverLagInterfacesLagInterfaceRelationshipListRelationship
+      operationId: createOrUpdateCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressListRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -9025,14 +9743,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
+          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"
@@ -9041,7 +9773,7 @@ paths:
         - CloudInfrastructure
       summary: delete an existing relationship
       description: delete an existing relationship
-      operationId: deleteCloudInfrastructurePserversPserverLagInterfacesLagInterfaceRelationshipListRelationship
+      operationId: deleteCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressListRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -9057,24 +9789,40 @@ 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
+          description: Name that identifies the physical interface
           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}/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: 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:
         - CloudInfrastructure
-      summary: see node definition for valid relationships
-      operationId: createOrUpdateCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanRelationshipListRelationship
-      consumes:
-        - application/json
-        - application/xml
+      summary: returns l3-interface-ipv4-address-list
+      description: returns l3-interface-ipv4-address-list
+      operationId: getCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList
       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:
@@ -9083,33 +9831,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
+          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
-        - name: body
-          in: body
-          description: relationship object that needs to be created or updated
-          required: true
-          schema:
-            $ref: "#/definitions/relationship"
-    delete:
+          example: __L3-INTERFACE-IPV4-ADDRESS__
+    put:
       tags:
         - CloudInfrastructure
-      summary: delete an existing relationship
-      description: delete an existing relationship
-      operationId: deleteCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanRelationshipListRelationship
+      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: createOrUpdateCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList
       consumes:
         - application/json
         - application/xml
@@ -9125,27 +9874,48 @@ 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
+          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
-  /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:
+          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/CloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList.json)
+          required: true
+          schema:
+            $ref: "#/definitions/l3-interface-ipv4-address-list"
+    patch:
       tags:
         - CloudInfrastructure
-      summary: see node definition for valid relationships
-      operationId: createOrUpdateCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressListRelationshipListRelationship
+      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
@@ -9161,38 +9931,37 @@ 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
+          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: l3-interface-ipv4-address-list object that needs to be 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: deleteCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressListRelationshipListRelationship
+      summary: delete an existing l3-interface-ipv4-address-list
+      description: delete an existing l3-interface-ipv4-address-list
+      operationId: deleteCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList
       consumes:
         - application/json
         - application/xml
@@ -9208,41 +9977,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
+          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
-  /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:
+          example: __L3-INTERFACE-IPV4-ADDRESS__
+        - name: resource-version
+          in: query
+          description: resource-version for concurrency
+          required: true
+          type: string
+  /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}/relationship-list/relationship:
+    put:
       tags:
         - CloudInfrastructure
-      summary: returns l3-interface-ipv4-address-list
-      description: returns l3-interface-ipv4-address-list
-      operationId: getCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList
+      summary: see node definition for valid relationships
+      operationId: createOrUpdateCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressListRelationshipListRelationship
+      consumes:
+        - application/json
+        - application/xml
       produces:
         - application/json
         - application/xml
       responses:
-        "200":
-          description: successful operation
-          schema:
-              $ref: "#/definitions/l3-interface-ipv4-address-list"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -9251,103 +10022,37 @@ 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
+          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
-        - name: l3-interface-ipv4-address
-          in: path
-          description: IP address
+          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/CloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList.json)
           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: pserver-id
-          in: query
-          description: ID of Pserver
-          required: false
-          type: string
-        - name: in-maint
-          in: query
-          required: false
-          type: boolean
-        - name: pserver-name2
-          in: query
-          description: alternative pserver name
-          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
-    put:
+          schema:
+            $ref: "#/definitions/relationship"
+    delete:
       tags:
         - CloudInfrastructure
-      summary: create or update an existing l3-interface-ipv4-address-list
-      description: create or update an existing l3-interface-ipv4-address-list
-      operationId: createOrUpdateCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList
+      summary: delete an existing relationship
+      description: delete an existing relationship
+      operationId: deleteCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressListRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -9363,38 +10068,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
+          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
-        - name: l3-interface-ipv4-address
+          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:
+        - CloudInfrastructure
+      summary: returns l3-interface-ipv6-address-list
+      description: returns l3-interface-ipv6-address-list
+      operationId: getCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList
+      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: hostname
           in: path
-          description: IP address
+          description: Value from executing hostname on the compute node.
           required: true
           type: string
-        - name: body
-          in: body
-          description: l3-interface-ipv4-address-list object that needs to be created or updated
+          example: __HOSTNAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the physical interface
           required: true
-          schema:
-            $ref: "#/definitions/l3-interface-ipv4-address-list"
-    delete:
+          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__
+    put:
       tags:
         - CloudInfrastructure
-      summary: delete an existing l3-interface-ipv4-address-list
-      description: delete an existing l3-interface-ipv4-address-list
-      operationId: deleteCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList
+      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: createOrUpdateCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList
       consumes:
         - application/json
         - application/xml
@@ -9410,37 +10153,48 @@ 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
+          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: l3-interface-ipv4-address
+          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
+          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/CloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList.json)
           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: "#/definitions/l3-interface-ipv6-address-list"
+    patch:
       tags:
         - CloudInfrastructure
-      summary: see node definition for valid relationships
-      operationId: createOrUpdateCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressListRelationshipListRelationship
+      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
@@ -9456,38 +10210,37 @@ 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
+          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: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: l3-interface-ipv6-address-list object that needs to be updated.
           required: true
           schema:
-            $ref: "#/definitions/relationship"
+            $ref: "#/patchDefinitions/l3-interface-ipv6-address-list"
     delete:
       tags:
         - CloudInfrastructure
-      summary: delete an existing relationship
-      description: delete an existing relationship
-      operationId: deleteCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressListRelationshipListRelationship
+      summary: delete an existing l3-interface-ipv6-address-list
+      description: delete an existing l3-interface-ipv6-address-list
+      operationId: deleteCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList
       consumes:
         - application/json
         - application/xml
@@ -9503,33 +10256,37 @@ 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
+          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
-  /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}:
+          example: __L3-INTERFACE-IPV6-ADDRESS__
+        - name: resource-version
+          in: query
+          description: resource-version for concurrency
+          required: true
+          type: string
+  /cloud-infrastructure/pservers/pserver/{hostname}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}:
     get:
       tags:
         - CloudInfrastructure
-      summary: returns l3-interface-ipv6-address-list
-      description: returns l3-interface-ipv6-address-list
-      operationId: getCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList
+      summary: returns l-interface
+      description: returns l-interface
+      operationId: getCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterface
       produces:
         - application/json
         - application/xml
@@ -9537,7 +10294,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/l3-interface-ipv6-address-list"
+              $ref: "#/getDefinitions/l-interface"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -9546,103 +10303,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
+          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: 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: pserver-id
-          in: query
-          description: ID of Pserver
-          required: false
-          type: string
-        - name: in-maint
-          in: query
-          required: false
-          type: boolean
-        - name: pserver-name2
-          in: query
-          description: alternative pserver name
-          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: __INTERFACE-NAME__
     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: createOrUpdateCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList
+      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: createOrUpdateCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterface
       consumes:
         - application/json
         - application/xml
@@ -9658,38 +10340,82 @@ 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
+          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: body
+          in: body
+          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: String that identifies the interface
+          description: Value from executing hostname on the compute node.
           required: true
           type: string
-        - name: l3-interface-ipv6-address
+          example: __HOSTNAME__
+        - name: interface-name
           in: path
-          description: IP address
+          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: l3-interface-ipv6-address-list object that needs to be created or updated
+          description: l-interface object that needs to be updated.
           required: true
           schema:
-            $ref: "#/definitions/l3-interface-ipv6-address-list"
+            $ref: "#/patchDefinitions/l-interface"
     delete:
       tags:
         - CloudInfrastructure
-      summary: delete an existing l3-interface-ipv6-address-list
-      description: delete an existing l3-interface-ipv6-address-list
-      operationId: deleteCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList
+      summary: delete an existing l-interface
+      description: delete an existing l-interface
+      operationId: deleteCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfacesLInterface
       consumes:
         - application/json
         - application/xml
@@ -9705,38 +10431,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
+          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: l3-interface-ipv6-address
-          in: path
-          description: IP address
-          required: true
-          type: string
+          example: __INTERFACE-NAME__
         - 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}:
+  /cloud-infrastructure/pservers/pserver/{hostname}/p-interfaces/p-interface/{interface-name}/l-interfaces:
     get:
       tags:
         - CloudInfrastructure
-      summary: returns vlan
-      description: returns vlan
-      operationId: getCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlan
+      summary: returns l-interfaces
+      description: returns l-interfaces
+      operationId: getCloudInfrastructurePserversPserverPInterfacesPInterfaceLInterfaces
       produces:
         - application/json
         - application/xml
@@ -9744,7 +10463,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/vlan"
+              $ref: "#/getDefinitions/l-interfaces"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -9753,89 +10472,48 @@ 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
+          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: inv-status
-          in: query
-          description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
-          required: false
-          type: string
-        - name: pserver-id
-          in: query
-          description: ID of Pserver
-          required: false
-          type: string
-        - name: in-maint
-          in: query
-          required: false
-          type: boolean
-        - name: pserver-name2
-          in: query
-          description: alternative pserver name
-          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.
+          description:
           required: false
           type: string
         - name: interface-id
           in: query
-          description: ID of interface
+          description:
           required: false
           type: string
         - name: macaddr
           in: query
-          description: MAC address for the interface
+          description:
           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
+          description:
           required: false
           type: string
-    put:
+  /cloud-infrastructure/pservers/pserver/{hostname}/p-interfaces/p-interface/{interface-name}:
+    get:
       tags:
         - CloudInfrastructure
-      summary: create or update an existing vlan
-      description: create or update an existing vlan
-      operationId: createOrUpdateCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlan
-      consumes:
-        - application/json
-        - application/xml
+      summary: returns p-interface
+      description: returns p-interface
+      operationId: getCloudInfrastructurePserversPserverPInterfacesPInterface
       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:
@@ -9844,33 +10522,67 @@ 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
+          description: Name that identifies the physical interface
           required: true
           type: string
-        - name: interface-name
+          example: __INTERFACE-NAME__
+    put:
+      tags:
+        - CloudInfrastructure
+      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: createOrUpdateCloudInfrastructurePserversPserverPInterfacesPInterface
+      consumes:
+        - 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: Name given to the interface
+          description: Value from executing hostname on the compute node.
           required: true
           type: string
-        - name: vlan-interface
+          example: __HOSTNAME__
+        - name: interface-name
           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: vlan 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/vlan"
-    delete:
+            $ref: "#/definitions/p-interface"
+    patch:
       tags:
         - CloudInfrastructure
-      summary: delete an existing vlan
-      description: delete an existing vlan
-      operationId: deleteCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlan
+      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
@@ -9886,33 +10598,59 @@ 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
+          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 updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/p-interface"
+    delete:
+      tags:
+        - CloudInfrastructure
+      summary: delete an existing p-interface
+      description: delete an existing p-interface
+      operationId: deleteCloudInfrastructurePserversPserverPInterfacesPInterface
+      consumes:
+        - 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: Name given to the interface
+          description: Value from executing hostname on the compute node.
           required: true
           type: string
-        - name: vlan-interface
+          example: __HOSTNAME__
+        - name: interface-name
           in: path
-          description: String that identifies the interface
+          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
-  /cloud-infrastructure/pservers/pserver/{hostname}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans:
+  /cloud-infrastructure/pservers/pserver/{hostname}/p-interfaces:
     get:
       tags:
         - CloudInfrastructure
-      summary: returns vlans
-      description: returns vlans
-      operationId: getCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceVlans
+      summary: returns p-interfaces
+      description: returns p-interfaces
+      operationId: getCloudInfrastructurePserversPserverPInterfaces
       produces:
         - application/json
         - application/xml
@@ -9920,7 +10658,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/vlans"
+              $ref: "#/getDefinitions/p-interfaces"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -9929,66 +10667,23 @@ 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
-        - 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: pserver-id
           in: query
-          description: ID of Pserver
+          description:
           required: false
           type: string
-        - name: in-maint
-          in: query
-          required: false
-          type: boolean
-        - name: pserver-name2
-          in: query
-          description: alternative pserver name
-          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
+        - name: prov-status
           in: query
-          description: Name of the network
+          description:
           required: false
           type: string
-  /cloud-infrastructure/pservers/pserver/{hostname}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/sriov-vfs/sriov-vf/{pci-id}/relationship-list/relationship:
+  /cloud-infrastructure/pservers/pserver/{hostname}/lag-interfaces/lag-interface/{interface-name}/relationship-list/relationship:
     put:
       tags:
         - CloudInfrastructure
       summary: see node definition for valid relationships
-      operationId: createOrUpdateCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfsSriovVfRelationshipListRelationship
+      operationId: createOrUpdateCloudInfrastructurePserversPserverLagInterfacesLagInterfaceRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -10004,24 +10699,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
-        - 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
-          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"
@@ -10030,7 +10717,7 @@ paths:
         - CloudInfrastructure
       summary: delete an existing relationship
       description: delete an existing relationship
-      operationId: deleteCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfsSriovVfRelationshipListRelationship
+      operationId: deleteCloudInfrastructurePserversPserverLagInterfacesLagInterfaceRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -10046,36 +10733,26 @@ 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
-        - 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
-          required: true
-          type: string
-  /cloud-infrastructure/pservers/pserver/{hostname}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/sriov-vfs/sriov-vf/{pci-id}:
-    get:
+          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:
         - CloudInfrastructure
-      summary: returns sriov-vf
-      description: returns sriov-vf
-      operationId: getCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfsSriovVf
+      summary: see node definition for valid relationships
+      operationId: createOrUpdateCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanRelationshipListRelationship
+      consumes:
+        - application/json
+        - application/xml
       produces:
         - application/json
         - application/xml
       responses:
-        "200":
-          description: successful operation
-          schema:
-              $ref: "#/definitions/sriov-vf"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -10084,91 +10761,77 @@ 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
-        - 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
-        - name: inv-status
-          in: query
-          description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
-          required: false
-          type: string
-        - name: pserver-id
-          in: query
-          description: ID of Pserver
-          required: false
-          type: string
-        - name: in-maint
-          in: query
-          required: false
-          type: boolean
-        - name: pserver-name2
-          in: query
-          description: alternative pserver name
-          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
+          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/CloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlan.json)
+          required: true
+          schema:
+            $ref: "#/definitions/relationship"
+    delete:
+      tags:
+        - CloudInfrastructure
+      summary: delete an existing relationship
+      description: delete an existing relationship
+      operationId: deleteCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanRelationshipListRelationship
+      consumes:
+        - 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
-        - 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
+          example: __HOSTNAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
+          required: true
           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
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
           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
+          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:
         - CloudInfrastructure
-      summary: create or update an existing sriov-vf
-      description: create or update an existing sriov-vf
-      operationId: createOrUpdateCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfsSriovVf
+      summary: see node definition for valid relationships
+      operationId: createOrUpdateCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressListRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -10184,33 +10847,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
-        - 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-ipv4-address
+          in: path
+          description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
         - name: body
           in: body
-          description: sriov-vf 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/sriov-vf"
+            $ref: "#/definitions/relationship"
     delete:
       tags:
         - CloudInfrastructure
-      summary: delete an existing sriov-vf
-      description: delete an existing sriov-vf
-      operationId: deleteCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfsSriovVf
+      summary: delete an existing relationship
+      description: delete an existing relationship
+      operationId: deleteCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressListRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -10226,33 +10899,38 @@ 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
-        - 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
-        - 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
-  /cloud-infrastructure/pservers/pserver/{hostname}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/sriov-vfs:
+          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:
         - CloudInfrastructure
-      summary: returns sriov-vfs
-      description: returns sriov-vfs
-      operationId: getCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfs
+      summary: returns l3-interface-ipv4-address-list
+      description: returns l3-interface-ipv4-address-list
+      operationId: getCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList
       produces:
         - application/json
         - application/xml
@@ -10260,7 +10938,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/sriov-vfs"
+              $ref: "#/getDefinitions/l3-interface-ipv4-address-list"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -10269,66 +10947,103 @@ 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
-        - name: inv-status
-          in: query
-          description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
-          required: false
-          type: string
-        - name: pserver-id
-          in: query
-          description: ID of Pserver
-          required: false
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
           type: string
-        - name: in-maint
-          in: query
-          required: false
-          type: boolean
-        - name: pserver-name2
-          in: query
-          description: alternative pserver name
-          required: false
+          example: __VLAN-INTERFACE__
+        - name: l3-interface-ipv4-address
+          in: path
+          description: IP address
+          required: true
           type: string
-        - name: interface-id
-          in: query
-          description: ID of interface
-          required: false
+          example: __L3-INTERFACE-IPV4-ADDRESS__
+    put:
+      tags:
+        - CloudInfrastructure
+      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: createOrUpdateCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList
+      consumes:
+        - 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
-        - name: interface-role
-          in: query
-          description: Role assigned to this Interface, should use values as defined in ECOMP Yang models.
-          required: false
+          example: __HOSTNAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
+          required: true
           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: macaddr
-          in: query
-          description: MAC address for the interface
-          required: false
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
           type: string
-        - name: network-name
-          in: query
-          description: Name of the network
-          required: false
+          example: __VLAN-INTERFACE__
+        - name: l3-interface-ipv4-address
+          in: path
+          description: IP address
+          required: true
           type: string
-  /cloud-infrastructure/pservers/pserver/{hostname}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/relationship-list/relationship:
-    put:
+          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/CloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList.json)
+          required: true
+          schema:
+            $ref: "#/definitions/l3-interface-ipv4-address-list"
+    patch:
       tags:
         - CloudInfrastructure
-      summary: see node definition for valid relationships
-      operationId: createOrUpdateCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceRelationshipListRelationship
+      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
@@ -10344,28 +11059,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
+          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 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: deleteCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceRelationshipListRelationship
+      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
@@ -10381,22 +11111,42 @@ 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
-  /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:
+          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: createOrUpdateCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressListRelationshipListRelationship
+      operationId: createOrUpdateCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressListRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -10412,24 +11162,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
-        - name: l3-interface-ipv4-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: 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"
@@ -10438,7 +11198,7 @@ paths:
         - CloudInfrastructure
       summary: delete an existing relationship
       description: delete an existing relationship
-      operationId: deleteCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressListRelationshipListRelationship
+      operationId: deleteCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressListRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -10454,28 +11214,38 @@ 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
-        - name: l3-interface-ipv4-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
-  /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}:
+          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:
         - CloudInfrastructure
-      summary: returns l3-interface-ipv4-address-list
-      description: returns l3-interface-ipv4-address-list
-      operationId: getCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList
+      summary: returns l3-interface-ipv6-address-list
+      description: returns l3-interface-ipv6-address-list
+      operationId: getCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList
       produces:
         - application/json
         - application/xml
@@ -10483,7 +11253,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/l3-interface-ipv4-address-list"
+              $ref: "#/getDefinitions/l3-interface-ipv6-address-list"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -10492,87 +11262,40 @@ 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
-        - 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: inv-status
-          in: query
-          description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
-          required: false
-          type: string
-        - name: pserver-id
-          in: query
-          description: ID of Pserver
-          required: false
-          type: string
-        - name: in-maint
-          in: query
-          required: false
-          type: boolean
-        - name: pserver-name2
-          in: query
-          description: alternative pserver name
-          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
+          example: __VLAN-INTERFACE__
+        - name: l3-interface-ipv6-address
+          in: path
+          description: IP address
+          required: true
           type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
     put:
       tags:
         - CloudInfrastructure
-      summary: create or update an existing l3-interface-ipv4-address-list
-      description: create or update an existing l3-interface-ipv4-address-list
-      operationId: createOrUpdateCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList
+      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: createOrUpdateCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList
       consumes:
         - application/json
         - application/xml
@@ -10588,33 +11311,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
-        - name: l3-interface-ipv4-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: body
           in: body
-          description: l3-interface-ipv4-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-ipv4-address-list"
-    delete:
+            $ref: "#/definitions/l3-interface-ipv6-address-list"
+    patch:
       tags:
         - CloudInfrastructure
-      summary: delete an existing l3-interface-ipv4-address-list
-      description: delete an existing l3-interface-ipv4-address-list
-      operationId: deleteCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList
+      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
@@ -10630,32 +11374,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
-        - 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: resource-version
-          in: query
-          description: resource-version for concurrency
+          example: __VLAN-INTERFACE__
+        - name: l3-interface-ipv6-address
+          in: path
+          description: IP address
           required: true
           type: string
-  /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}/relationship-list/relationship:
-    put:
+          example: __L3-INTERFACE-IPV6-ADDRESS__
+        - name: body
+          in: body
+          description: l3-interface-ipv6-address-list object that needs to be updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/l3-interface-ipv6-address-list"
+    delete:
       tags:
         - CloudInfrastructure
-      summary: see node definition for valid relationships
-      operationId: createOrUpdateCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressListRelationshipListRelationship
+      summary: delete an existing l3-interface-ipv6-address-list
+      description: delete an existing l3-interface-ipv6-address-list
+      operationId: deleteCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList
       consumes:
         - application/json
         - application/xml
@@ -10671,40 +11426,51 @@ 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
-        - name: body
-          in: body
-          description: relationship object that needs to be created or updated
+          example: __L3-INTERFACE-IPV6-ADDRESS__
+        - name: resource-version
+          in: query
+          description: resource-version for concurrency
           required: true
-          schema:
-            $ref: "#/definitions/relationship"
-    delete:
+          type: string
+  /cloud-infrastructure/pservers/pserver/{hostname}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}:
+    get:
       tags:
         - CloudInfrastructure
-      summary: delete an existing relationship
-      description: delete an existing relationship
-      operationId: deleteCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressListRelationshipListRelationship
-      consumes:
-        - application/json
-        - application/xml
+      summary: returns vlan
+      description: returns vlan
+      operationId: getCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlan
       produces:
         - application/json
         - application/xml
       responses:
+        "200":
+          description: successful operation
+          schema:
+              $ref: "#/getDefinitions/vlan"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -10713,36 +11479,41 @@ 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
-        - name: l3-interface-ipv6-address
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
           in: path
-          description: IP address
+          description: String that identifies the interface
           required: true
           type: string
-  /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:
+          example: __VLAN-INTERFACE__
+    put:
       tags:
         - CloudInfrastructure
-      summary: returns l3-interface-ipv6-address-list
-      description: returns l3-interface-ipv6-address-list
-      operationId: getCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList
+      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: createOrUpdateCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlan
+      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:
@@ -10751,87 +11522,48 @@ 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
-        - name: l3-interface-ipv6-address
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
           in: path
-          description: IP address
+          description: String that identifies 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: pserver-id
-          in: query
-          description: ID of Pserver
-          required: false
-          type: string
-        - name: in-maint
-          in: query
-          required: false
-          type: boolean
-        - name: pserver-name2
-          in: query
-          description: alternative pserver name
-          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:
+          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/CloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlan.json)
+          required: true
+          schema:
+            $ref: "#/definitions/vlan"
+    patch:
       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: createOrUpdateCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList
+      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
@@ -10847,33 +11579,37 @@ 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
-        - name: l3-interface-ipv6-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: l3-interface-ipv6-address-list object that needs to be created or updated
+          description: vlan object that needs to be updated.
           required: true
           schema:
-            $ref: "#/definitions/l3-interface-ipv6-address-list"
+            $ref: "#/patchDefinitions/vlan"
     delete:
       tags:
         - CloudInfrastructure
-      summary: delete an existing l3-interface-ipv6-address-list
-      description: delete an existing l3-interface-ipv6-address-list
-      operationId: deleteCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList
+      summary: delete an existing vlan
+      description: delete an existing vlan
+      operationId: deleteCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlan
       consumes:
         - application/json
         - application/xml
@@ -10889,33 +11625,37 @@ 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
-        - name: l3-interface-ipv6-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: 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}:
+  /cloud-infrastructure/pservers/pserver/{hostname}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/vlans:
     get:
       tags:
         - CloudInfrastructure
-      summary: returns l-interface
-      description: returns l-interface
-      operationId: getCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterface
+      summary: returns vlans
+      description: returns vlans
+      operationId: getCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceVlans
       produces:
         - application/json
         - application/xml
@@ -10923,7 +11663,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/l-interface"
+              $ref: "#/getDefinitions/vlans"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -10932,66 +11672,41 @@ 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
-        - name: inv-status
-          in: query
-          description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
-          required: false
-          type: string
-        - name: pserver-id
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
           in: query
-          description: ID of Pserver
+          description:
           required: false
           type: string
-        - name: in-maint
+        - name: vlan-id-inner
           in: query
+          description:
           required: false
-          type: boolean
-        - name: pserver-name2
+          type: integer
+          format: int64
+        - name: vpn-key
           in: query
-          description: alternative pserver name
-          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
+          description:
           required: false
           type: string
+  /cloud-infrastructure/pservers/pserver/{hostname}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/sriov-vfs/sriov-vf/{pci-id}/relationship-list/relationship:
     put:
       tags:
         - CloudInfrastructure
-      summary: create or update an existing l-interface
-      description: create or update an existing l-interface
-      operationId: createOrUpdateCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterface
+      summary: see node definition for valid relationships
+      operationId: createOrUpdateCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfsSriovVfRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -11007,28 +11722,37 @@ 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: 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/CloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfsSriovVf.json)
           required: true
           schema:
-            $ref: "#/definitions/l-interface"
+            $ref: "#/definitions/relationship"
     delete:
       tags:
         - CloudInfrastructure
-      summary: delete an existing l-interface
-      description: delete an existing l-interface
-      operationId: deleteCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterface
+      summary: delete an existing relationship
+      description: delete an existing relationship
+      operationId: deleteCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfsSriovVfRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -11044,28 +11768,32 @@ 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
-        - 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
-  /cloud-infrastructure/pservers/pserver/{hostname}/lag-interfaces/lag-interface/{interface-name}/l-interfaces:
+          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:
         - CloudInfrastructure
-      summary: returns l-interfaces
-      description: returns l-interfaces
-      operationId: getCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfaces
+      summary: returns sriov-vf
+      description: returns sriov-vf
+      operationId: getCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfsSriovVf
       produces:
         - application/json
         - application/xml
@@ -11073,7 +11801,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/l-interfaces"
+              $ref: "#/getDefinitions/sriov-vf"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -11082,55 +11810,41 @@ 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
-        - name: inv-status
-          in: query
-          description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
-          required: false
-          type: string
-        - name: pserver-id
-          in: query
-          description: ID of Pserver
-          required: false
-          type: string
-        - name: in-maint
-          in: query
-          required: false
-          type: boolean
-        - name: pserver-name2
-          in: query
-          description: alternative pserver name
-          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: pci-id
+          in: path
+          description: PCI ID used to identify the sriov-vf
+          required: true
           type: string
-  /cloud-infrastructure/pservers/pserver/{hostname}/lag-interfaces/lag-interface/{interface-name}:
-    get:
+          example: __PCI-ID__
+    put:
       tags:
         - CloudInfrastructure
-      summary: returns lag-interface
-      description: returns lag-interface
-      operationId: getCloudInfrastructurePserversPserverLagInterfacesLagInterface
+      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: createOrUpdateCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfsSriovVf
+      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:
@@ -11139,46 +11853,48 @@ 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
-        - name: inv-status
-          in: query
-          description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
-          required: false
-          type: string
-        - name: pserver-id
-          in: query
-          description: ID of Pserver
-          required: false
-          type: string
-        - name: in-maint
-          in: query
-          required: false
-          type: boolean
-        - name: pserver-name2
-          in: query
-          description: alternative pserver name
-          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: pci-id
+          in: path
+          description: PCI ID used to identify the sriov-vf
+          required: true
           type: string
-    put:
+          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/CloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfsSriovVf.json)
+          required: true
+          schema:
+            $ref: "#/definitions/sriov-vf"
+    patch:
       tags:
         - CloudInfrastructure
-      summary: create or update an existing lag-interface
-      description: create or update an existing lag-interface
-      operationId: createOrUpdateCloudInfrastructurePserversPserverLagInterfacesLagInterface
+      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
@@ -11194,23 +11910,37 @@ 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: lag-interface object that needs to be created or updated
+          description: sriov-vf object that needs to be updated.
           required: true
           schema:
-            $ref: "#/definitions/lag-interface"
+            $ref: "#/patchDefinitions/sriov-vf"
     delete:
       tags:
         - CloudInfrastructure
-      summary: delete an existing lag-interface
-      description: delete an existing lag-interface
-      operationId: deleteCloudInfrastructurePserversPserverLagInterfacesLagInterface
+      summary: delete an existing sriov-vf
+      description: delete an existing sriov-vf
+      operationId: deleteCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfsSriovVf
       consumes:
         - application/json
         - application/xml
@@ -11226,23 +11956,37 @@ 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
           required: true
           type: string
-  /cloud-infrastructure/pservers/pserver/{hostname}/lag-interfaces:
+  /cloud-infrastructure/pservers/pserver/{hostname}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/sriov-vfs:
     get:
       tags:
         - CloudInfrastructure
-      summary: returns lag-interfaces
-      description: returns lag-interfaces
-      operationId: getCloudInfrastructurePserversPserverLagInterfaces
+      summary: returns sriov-vfs
+      description: returns sriov-vfs
+      operationId: getCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfs
       produces:
         - application/json
         - application/xml
@@ -11250,7 +11994,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/lag-interfaces"
+              $ref: "#/getDefinitions/sriov-vfs"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -11259,73 +12003,50 @@ paths:
           description: Value from executing hostname on the compute node.
           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: __HOSTNAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
+          required: true
           type: string
-        - name: pserver-id
-          in: query
-          description: ID of Pserver
-          required: false
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
           type: string
-        - name: in-maint
-          in: query
-          required: false
-          type: boolean
-        - name: pserver-name2
+          example: __INTERFACE-NAME__
+        - name: pci-id
           in: query
-          description: alternative pserver name
+          description:
           required: false
           type: string
-  /cloud-infrastructure/pservers/pserver/{hostname}:
-    get:
-      tags:
-        - CloudInfrastructure
-      summary: returns pserver
-      description: returns pserver
-      operationId: getCloudInfrastructurePserversPserver
-      produces:
-        - application/json
-        - application/xml
-      responses:
-        "200":
-          description: successful operation
-          schema:
-              $ref: "#/definitions/pserver"
-        "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
-        - name: inv-status
+        - name: vf-vlan-filter
           in: query
-          description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
+          description:
           required: false
           type: string
-        - name: pserver-id
+        - name: vf-mac-filter
           in: query
-          description: ID of Pserver
+          description:
           required: false
           type: string
-        - name: in-maint
+        - name: vf-vlan-strip
           in: query
+          description:
           required: false
           type: boolean
-        - name: pserver-name2
+        - name: neutron-network-id
           in: query
-          description: alternative pserver name
+          description:
           required: false
           type: string
+  /cloud-infrastructure/pservers/pserver/{hostname}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/relationship-list/relationship:
     put:
       tags:
         - CloudInfrastructure
-      summary: create or update an existing pserver
-      description: create or update an existing pserver
-      operationId: createOrUpdateCloudInfrastructurePserversPserver
+      summary: see node definition for valid relationships
+      operationId: createOrUpdateCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -11341,18 +12062,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: body
           in: body
-          description: pserver 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/pserver"
+            $ref: "#/definitions/relationship"
     delete:
       tags:
         - CloudInfrastructure
-      summary: delete an existing pserver
-      description: delete an existing pserver
-      operationId: deleteCloudInfrastructurePserversPserver
+      summary: delete an existing relationship
+      description: delete an existing relationship
+      operationId: deleteCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -11368,34 +12102,25 @@ paths:
           description: Value from executing hostname on the compute node.
           required: true
           type: string
-        - name: resource-version
-          in: query
-          description: resource-version for concurrency
+          example: __HOSTNAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
           required: true
           type: string
-  /cloud-infrastructure/pservers:
-    get:
-      tags:
-        - CloudInfrastructure
-      summary: returns pservers
-      description: returns pservers
-      operationId: getCloudInfrastructurePservers
-      produces:
-        - application/json
-        - application/xml
-      responses:
-        "200":
-          description: successful operation
-          schema:
-              $ref: "#/definitions/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:
+          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:
         - CloudInfrastructure
       summary: see node definition for valid relationships
-      operationId: createOrUpdateCloudInfrastructureVirtualDataCentersVirtualDataCenterRelationshipListRelationship
+      operationId: createOrUpdateCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressListRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -11406,14 +12131,33 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vdc-id
+        - name: hostname
           in: path
-          description: Unique ID of the vdc
+          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"
@@ -11422,7 +12166,7 @@ paths:
         - CloudInfrastructure
       summary: delete an existing relationship
       description: delete an existing relationship
-      operationId: deleteCloudInfrastructureVirtualDataCentersVirtualDataCenterRelationshipListRelationship
+      operationId: deleteCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressListRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -11433,18 +12177,37 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vdc-id
+        - name: hostname
           in: path
-          description: Unique ID of the vdc
+          description: Value from executing hostname on the compute node.
           required: true
           type: string
-  /cloud-infrastructure/virtual-data-centers/virtual-data-center/{vdc-id}:
+          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:
         - CloudInfrastructure
-      summary: returns virtual-data-center
-      description: returns virtual-data-center
-      operationId: getCloudInfrastructureVirtualDataCentersVirtualDataCenter
+      summary: returns l3-interface-ipv4-address-list
+      description: returns l3-interface-ipv4-address-list
+      operationId: getCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList
       produces:
         - application/json
         - application/xml
@@ -11452,26 +12215,43 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/virtual-data-center"
+              $ref: "#/getDefinitions/l3-interface-ipv4-address-list"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vdc-id
+        - name: hostname
           in: path
-          description: Unique ID of the vdc
+          description: Value from executing hostname on the compute node.
           required: true
           type: string
-        - name: vdc-name
-          in: query
-          description: Name of the virtual data center
-          required: false
+          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__
     put:
       tags:
         - CloudInfrastructure
-      summary: create or update an existing virtual-data-center
-      description: create or update an existing virtual-data-center
-      operationId: createOrUpdateCloudInfrastructureVirtualDataCentersVirtualDataCenter
+      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: createOrUpdateCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList
       consumes:
         - application/json
         - application/xml
@@ -11482,23 +12262,53 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vdc-id
+        - name: hostname
           in: path
-          description: Unique ID of the vdc
+          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: virtual-data-center 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/virtual-data-center"
-    delete:
+            $ref: "#/definitions/l3-interface-ipv4-address-list"
+    patch:
       tags:
         - CloudInfrastructure
-      summary: delete an existing virtual-data-center
-      description: delete an existing virtual-data-center
-      operationId: deleteCloudInfrastructureVirtualDataCentersVirtualDataCenter
+      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
@@ -11509,71 +12319,42 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vdc-id
+        - name: hostname
           in: path
-          description: Unique ID of the vdc
+          description: Value from executing hostname on the compute node.
           required: true
           type: string
-        - name: resource-version
-          in: query
-          description: resource-version for concurrency
+          example: __HOSTNAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
           required: true
           type: string
-  /cloud-infrastructure/virtual-data-centers:
-    get:
-      tags:
-        - CloudInfrastructure
-      summary: returns virtual-data-centers
-      description: returns virtual-data-centers
-      operationId: getCloudInfrastructureVirtualDataCenters
-      produces:
-        - application/json
-        - application/xml
-      responses:
-        "200":
-          description: successful operation
-          schema:
-              $ref: "#/definitions/virtual-data-centers"
-        "default":
-          description: Response codes found in [response codes](https://wiki.onap.org/).
-  /external-system/esr-ems-list/esr-ems/{ems-id}/esr-system-info-list/esr-system-info/{esr-system-info-id}/relationship-list/relationship:
-    put:
-      tags:
-        - ExternalSystem
-      summary: see node definition for valid relationships
-      operationId: createOrUpdateExternalSystemEsrEmsListEsrEmsEsrSystemInfoListEsrSystemInfoRelationshipListRelationship
-      consumes:
-        - application/json
-        - application/xml
-      produces:
-        - application/json
-        - application/xml
-      responses:
-        "default":
-          description: Response codes found in [response codes](https://wiki.onap.org/).
-      parameters:
-        - name: ems-id
+          example: __INTERFACE-NAME__
+        - name: interface-name
           in: path
-          description: Unique ID of EMS.
+          description: Name given to the interface
           required: true
           type: string
-        - name: esr-system-info-id
+          example: __INTERFACE-NAME__
+        - name: l3-interface-ipv4-address
           in: path
-          description: Unique ID of esr system info.
+          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 updated.
           required: true
           schema:
-            $ref: "#/definitions/relationship"
+            $ref: "#/patchDefinitions/l3-interface-ipv4-address-list"
     delete:
       tags:
-        - ExternalSystem
-      summary: delete an existing relationship
-      description: delete an existing relationship
-      operationId: deleteExternalSystemEsrEmsListEsrEmsEsrSystemInfoListEsrSystemInfoRelationshipListRelationship
+        - CloudInfrastructure
+      summary: delete an existing l3-interface-ipv4-address-list
+      description: delete an existing l3-interface-ipv4-address-list
+      operationId: deleteCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList
       consumes:
         - application/json
         - application/xml
@@ -11584,60 +12365,41 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: ems-id
+        - name: hostname
           in: path
-          description: Unique ID of EMS.
+          description: Value from executing hostname on the compute node.
           required: true
           type: string
-        - name: esr-system-info-id
+          example: __HOSTNAME__
+        - name: interface-name
           in: path
-          description: Unique ID of esr system info.
+          description: Name that identifies the link aggregate interface
           required: true
           type: string
-  /external-system/esr-ems-list/esr-ems/{ems-id}/esr-system-info-list/esr-system-info/{esr-system-info-id}:
-    get:
-      tags:
-        - ExternalSystem
-      summary: returns esr-system-info
-      description: returns esr-system-info
-      operationId: getExternalSystemEsrEmsListEsrEmsEsrSystemInfoListEsrSystemInfo
-      produces:
-        - application/json
-        - application/xml
-      responses:
-        "200":
-          description: successful operation
-          schema:
-              $ref: "#/definitions/esr-system-info"
-        "default":
-          description: Response codes found in [response codes](https://wiki.onap.org/).
-      parameters:
-        - name: ems-id
+          example: __INTERFACE-NAME__
+        - name: interface-name
           in: path
-          description: Unique ID of EMS.
+          description: Name given to the interface
           required: true
           type: string
-        - name: esr-system-info-id
+          example: __INTERFACE-NAME__
+        - name: l3-interface-ipv4-address
           in: path
-          description: Unique ID of esr system info.
+          description: IP address
           required: true
           type: string
-        - name: system-name
-          in: query
-          description: name of external system.
-          required: false
-          type: string
-        - name: system-type
+          example: __L3-INTERFACE-IPV4-ADDRESS__
+        - name: resource-version
           in: query
-          description: it could be vim/vnfm/thirdparty-sdnc/ems-resource/ems-performance/ems-alarm.
-          required: false
+          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}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}/relationship-list/relationship:
     put:
       tags:
-        - ExternalSystem
-      summary: create or update an existing esr-system-info
-      description: create or update an existing esr-system-info
-      operationId: createOrUpdateExternalSystemEsrEmsListEsrEmsEsrSystemInfoListEsrSystemInfo
+        - CloudInfrastructure
+      summary: see node definition for valid relationships
+      operationId: createOrUpdateCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressListRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -11648,28 +12410,42 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: ems-id
+        - name: hostname
           in: path
-          description: Unique ID of EMS.
+          description: Value from executing hostname on the compute node.
           required: true
           type: string
-        - name: esr-system-info-id
+          example: __HOSTNAME__
+        - name: interface-name
           in: path
-          description: Unique ID of esr system info.
+          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: esr-system-info 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/esr-system-info"
+            $ref: "#/definitions/relationship"
     delete:
       tags:
-        - ExternalSystem
-      summary: delete an existing esr-system-info
-      description: delete an existing esr-system-info
-      operationId: deleteExternalSystemEsrEmsListEsrEmsEsrSystemInfoListEsrSystemInfo
+        - CloudInfrastructure
+      summary: delete an existing relationship
+      description: delete an existing relationship
+      operationId: deleteCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressListRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -11680,28 +12456,37 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: ems-id
+        - name: hostname
           in: path
-          description: Unique ID of EMS.
+          description: Value from executing hostname on the compute node.
           required: true
           type: string
-        - name: esr-system-info-id
+          example: __HOSTNAME__
+        - name: interface-name
           in: path
-          description: Unique ID of esr system info.
+          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
-  /external-system/esr-ems-list/esr-ems/{ems-id}/esr-system-info-list:
+          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:
-        - ExternalSystem
-      summary: returns esr-system-info-list
-      description: returns esr-system-info-list
-      operationId: getExternalSystemEsrEmsListEsrEmsEsrSystemInfoList
+        - CloudInfrastructure
+      summary: returns l3-interface-ipv6-address-list
+      description: returns l3-interface-ipv6-address-list
+      operationId: getCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList
       produces:
         - application/json
         - application/xml
@@ -11709,21 +12494,43 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/esr-system-info-list"
+              $ref: "#/getDefinitions/l3-interface-ipv6-address-list"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: ems-id
+        - name: hostname
           in: path
-          description: Unique ID of EMS.
+          description: Value from executing hostname on the compute node.
           required: true
           type: string
-  /external-system/esr-ems-list/esr-ems/{ems-id}/relationship-list/relationship:
-    put:
-      tags:
-        - ExternalSystem
-      summary: see node definition for valid relationships
-      operationId: createOrUpdateExternalSystemEsrEmsListEsrEmsRelationshipListRelationship
+          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__
+    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: createOrUpdateCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList
       consumes:
         - application/json
         - application/xml
@@ -11734,23 +12541,53 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: ems-id
+        - 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: Unique ID of EMS.
+          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: 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/relationship"
-    delete:
+            $ref: "#/definitions/l3-interface-ipv6-address-list"
+    patch:
       tags:
-        - ExternalSystem
-      summary: delete an existing relationship
-      description: delete an existing relationship
-      operationId: deleteExternalSystemEsrEmsListEsrEmsRelationshipListRelationship
+        - 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
@@ -11761,67 +12598,42 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: ems-id
+        - name: hostname
           in: path
-          description: Unique ID of EMS.
+          description: Value from executing hostname on the compute node.
           required: true
           type: string
-  /external-system/esr-ems-list/esr-ems/{ems-id}:
-    get:
-      tags:
-        - ExternalSystem
-      summary: returns esr-ems
-      description: returns esr-ems
-      operationId: getExternalSystemEsrEmsListEsrEms
-      produces:
-        - application/json
-        - application/xml
-      responses:
-        "200":
-          description: successful operation
-          schema:
-              $ref: "#/definitions/esr-ems"
-        "default":
-          description: Response codes found in [response codes](https://wiki.onap.org/).
-      parameters:
-        - name: ems-id
+          example: __HOSTNAME__
+        - name: interface-name
           in: path
-          description: Unique ID of EMS.
+          description: Name that identifies the link aggregate interface
           required: true
           type: string
-    put:
-      tags:
-        - ExternalSystem
-      summary: create or update an existing esr-ems
-      description: create or update an existing esr-ems
-      operationId: createOrUpdateExternalSystemEsrEmsListEsrEms
-      consumes:
-        - application/json
-        - application/xml
-      produces:
-        - application/json
-        - application/xml
-      responses:
-        "default":
-          description: Response codes found in [response codes](https://wiki.onap.org/).
-      parameters:
-        - name: ems-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: Unique ID of EMS.
+          description: IP address
           required: true
           type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
         - name: body
           in: body
-          description: esr-ems object that needs to be created or updated
+          description: l3-interface-ipv6-address-list object that needs to be updated.
           required: true
           schema:
-            $ref: "#/definitions/esr-ems"
+            $ref: "#/patchDefinitions/l3-interface-ipv6-address-list"
     delete:
       tags:
-        - ExternalSystem
-      summary: delete an existing esr-ems
-      description: delete an existing esr-ems
-      operationId: deleteExternalSystemEsrEmsListEsrEms
+        - CloudInfrastructure
+      summary: delete an existing l3-interface-ipv6-address-list
+      description: delete an existing l3-interface-ipv6-address-list
+      operationId: deleteCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList
       consumes:
         - application/json
         - application/xml
@@ -11832,23 +12644,42 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: ems-id
+        - 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: Unique ID of EMS.
+          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
-  /external-system/esr-ems-list:
+  /cloud-infrastructure/pservers/pserver/{hostname}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}:
     get:
       tags:
-        - ExternalSystem
-      summary: returns esr-ems-list
-      description: returns esr-ems-list
-      operationId: getExternalSystemEsrEmsList
+        - CloudInfrastructure
+      summary: returns l-interface
+      description: returns l-interface
+      operationId: getCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterface
       produces:
         - application/json
         - application/xml
@@ -11856,15 +12687,37 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/esr-ems-list"
+              $ref: "#/getDefinitions/l-interface"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
-  /external-system/esr-vnfm-list/esr-vnfm/{vnfm-id}/esr-system-info-list/esr-system-info/{esr-system-info-id}/relationship-list/relationship:
+      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__
     put:
       tags:
-        - ExternalSystem
-      summary: see node definition for valid relationships
-      operationId: createOrUpdateExternalSystemEsrVnfmListEsrVnfmEsrSystemInfoListEsrSystemInfoRelationshipListRelationship
+        - CloudInfrastructure
+      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: createOrUpdateCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterface
       consumes:
         - application/json
         - application/xml
@@ -11875,28 +12728,87 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnfm-id
+        - name: hostname
           in: path
-          description: Unique ID of VNFM.
+          description: Value from executing hostname on the compute node.
           required: true
           type: string
-        - name: esr-system-info-id
+          example: __HOSTNAME__
+        - name: interface-name
           in: path
-          description: Unique ID of esr system info.
+          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. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterface.json)
           required: true
           schema:
-            $ref: "#/definitions/relationship"
+            $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 updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/l-interface"
     delete:
       tags:
-        - ExternalSystem
-      summary: delete an existing relationship
-      description: delete an existing relationship
-      operationId: deleteExternalSystemEsrVnfmListEsrVnfmEsrSystemInfoListEsrSystemInfoRelationshipListRelationship
+        - CloudInfrastructure
+      summary: delete an existing l-interface
+      description: delete an existing l-interface
+      operationId: deleteCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfacesLInterface
       consumes:
         - application/json
         - application/xml
@@ -11907,23 +12819,36 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnfm-id
+        - name: hostname
           in: path
-          description: Unique ID of VNFM.
+          description: Value from executing hostname on the compute node.
           required: true
           type: string
-        - name: esr-system-info-id
+          example: __HOSTNAME__
+        - name: interface-name
           in: path
-          description: Unique ID of esr system info.
+          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
-  /external-system/esr-vnfm-list/esr-vnfm/{vnfm-id}/esr-system-info-list/esr-system-info/{esr-system-info-id}:
+  /cloud-infrastructure/pservers/pserver/{hostname}/lag-interfaces/lag-interface/{interface-name}/l-interfaces:
     get:
       tags:
-        - ExternalSystem
-      summary: returns esr-system-info
-      description: returns esr-system-info
-      operationId: getExternalSystemEsrVnfmListEsrVnfmEsrSystemInfoListEsrSystemInfo
+        - CloudInfrastructure
+      summary: returns l-interfaces
+      description: returns l-interfaces
+      operationId: getCloudInfrastructurePserversPserverLagInterfacesLagInterfaceLInterfaces
       produces:
         - application/json
         - application/xml
@@ -11931,36 +12856,81 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/esr-system-info"
+              $ref: "#/getDefinitions/l-interfaces"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnfm-id
+        - name: hostname
           in: path
-          description: Unique ID of VNFM.
+          description: Value from executing hostname on the compute node.
           required: true
           type: string
-        - name: esr-system-info-id
+          example: __HOSTNAME__
+        - name: interface-name
           in: path
-          description: Unique ID of esr system info.
+          description: Name that identifies the link aggregate interface
           required: true
           type: string
-        - name: system-name
+          example: __INTERFACE-NAME__
+        - name: interface-name
           in: query
-          description: name of external system.
+          description:
           required: false
           type: string
-        - name: system-type
+        - name: interface-id
           in: query
-          description: it could be vim/vnfm/thirdparty-sdnc/ems-resource/ems-performance/ems-alarm.
+          description:
           required: false
           type: string
+        - name: macaddr
+          in: query
+          description:
+          required: false
+          type: string
+        - name: network-name
+          in: query
+          description:
+          required: false
+          type: string
+  /cloud-infrastructure/pservers/pserver/{hostname}/lag-interfaces/lag-interface/{interface-name}:
+    get:
+      tags:
+        - CloudInfrastructure
+      summary: returns lag-interface
+      description: returns lag-interface
+      operationId: getCloudInfrastructurePserversPserverLagInterfacesLagInterface
+      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: 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__
     put:
       tags:
-        - ExternalSystem
-      summary: create or update an existing esr-system-info
-      description: create or update an existing esr-system-info
-      operationId: createOrUpdateExternalSystemEsrVnfmListEsrVnfmEsrSystemInfoListEsrSystemInfo
+        - CloudInfrastructure
+      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: createOrUpdateCloudInfrastructurePserversPserverLagInterfacesLagInterface
       consumes:
         - application/json
         - application/xml
@@ -11971,28 +12941,75 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnfm-id
+        - name: hostname
           in: path
-          description: Unique ID of VNFM.
+          description: Value from executing hostname on the compute node.
           required: true
           type: string
-        - name: esr-system-info-id
+          example: __HOSTNAME__
+        - name: interface-name
           in: path
-          description: Unique ID of esr system info.
+          description: Name that identifies the link aggregate interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: body
           in: body
-          description: esr-system-info 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/esr-system-info"
+            $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 updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/lag-interface"
     delete:
       tags:
-        - ExternalSystem
-      summary: delete an existing esr-system-info
-      description: delete an existing esr-system-info
-      operationId: deleteExternalSystemEsrVnfmListEsrVnfmEsrSystemInfoListEsrSystemInfo
+        - CloudInfrastructure
+      summary: delete an existing lag-interface
+      description: delete an existing lag-interface
+      operationId: deleteCloudInfrastructurePserversPserverLagInterfacesLagInterface
       consumes:
         - application/json
         - application/xml
@@ -12003,28 +13020,30 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnfm-id
+        - name: hostname
           in: path
-          description: Unique ID of VNFM.
+          description: Value from executing hostname on the compute node.
           required: true
           type: string
-        - name: esr-system-info-id
+          example: __HOSTNAME__
+        - name: interface-name
           in: path
-          description: Unique ID of esr system info.
+          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
-  /external-system/esr-vnfm-list/esr-vnfm/{vnfm-id}/esr-system-info-list:
+  /cloud-infrastructure/pservers/pserver/{hostname}/lag-interfaces:
     get:
       tags:
-        - ExternalSystem
-      summary: returns esr-system-info-list
-      description: returns esr-system-info-list
-      operationId: getExternalSystemEsrVnfmListEsrVnfmEsrSystemInfoList
+        - CloudInfrastructure
+      summary: returns lag-interfaces
+      description: returns lag-interfaces
+      operationId: getCloudInfrastructurePserversPserverLagInterfaces
       produces:
         - application/json
         - application/xml
@@ -12032,48 +13051,64 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/esr-system-info-list"
+              $ref: "#/getDefinitions/lag-interfaces"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnfm-id
+        - name: hostname
           in: path
-          description: Unique ID of VNFM.
+          description: Value from executing hostname on the compute node.
           required: true
           type: string
-  /external-system/esr-vnfm-list/esr-vnfm/{vnfm-id}/relationship-list/relationship:
-    put:
+          example: __HOSTNAME__
+        - name: interface-name
+          in: query
+          description:
+          required: false
+          type: string
+        - name: interface-id
+          in: query
+          description:
+          required: false
+          type: string
+        - name: interface-role
+          in: query
+          description:
+          required: false
+          type: string
+  /cloud-infrastructure/pservers/pserver/{hostname}:
+    get:
       tags:
-        - ExternalSystem
-      summary: see node definition for valid relationships
-      operationId: createOrUpdateExternalSystemEsrVnfmListEsrVnfmRelationshipListRelationship
-      consumes:
-        - application/json
-        - application/xml
+        - CloudInfrastructure
+      summary: returns pserver
+      description: returns pserver
+      operationId: getCloudInfrastructurePserversPserver
       produces:
         - application/json
         - application/xml
       responses:
+        "200":
+          description: successful operation
+          schema:
+              $ref: "#/getDefinitions/pserver"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnfm-id
+        - name: hostname
           in: path
-          description: Unique ID of VNFM.
+          description: Value from executing hostname on the compute node.
           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: __HOSTNAME__
+    put:
       tags:
-        - ExternalSystem
-      summary: delete an existing relationship
-      description: delete an existing relationship
-      operationId: deleteExternalSystemEsrVnfmListEsrVnfmRelationshipListRelationship
+        - CloudInfrastructure
+      summary: 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
         - application/xml
@@ -12084,40 +13119,35 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnfm-id
+        - name: hostname
           in: path
-          description: Unique ID of VNFM.
+          description: Value from executing hostname on the compute node.
           required: true
           type: string
-  /external-system/esr-vnfm-list/esr-vnfm/{vnfm-id}:
-    get:
-      tags:
-        - ExternalSystem
-      summary: returns esr-vnfm
-      description: returns esr-vnfm
-      operationId: getExternalSystemEsrVnfmListEsrVnfm
-      produces:
-        - application/json
-        - application/xml
-      responses:
-        "200":
-          description: successful operation
-          schema:
-              $ref: "#/definitions/esr-vnfm"
-        "default":
-          description: Response codes found in [response codes](https://wiki.onap.org/).
-      parameters:
-        - name: vnfm-id
-          in: path
-          description: Unique ID of VNFM.
+          example: __HOSTNAME__
+        - name: body
+          in: body
+          description: pserver object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/CloudInfrastructurePserversPserver.json)
           required: true
-          type: string
-    put:
+          schema:
+            $ref: "#/definitions/pserver"
+    patch:
       tags:
-        - ExternalSystem
-      summary: create or update an existing esr-vnfm
-      description: create or update an existing esr-vnfm
-      operationId: createOrUpdateExternalSystemEsrVnfmListEsrVnfm
+        - 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
@@ -12128,23 +13158,24 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnfm-id
+        - name: hostname
           in: path
-          description: Unique ID of VNFM.
+          description: Value from executing hostname on the compute node.
           required: true
           type: string
+          example: __HOSTNAME__
         - name: body
           in: body
-          description: esr-vnfm object that needs to be created or updated
+          description: pserver object that needs to be updated.
           required: true
           schema:
-            $ref: "#/definitions/esr-vnfm"
+            $ref: "#/patchDefinitions/pserver"
     delete:
       tags:
-        - ExternalSystem
-      summary: delete an existing esr-vnfm
-      description: delete an existing esr-vnfm
-      operationId: deleteExternalSystemEsrVnfmListEsrVnfm
+        - CloudInfrastructure
+      summary: delete an existing pserver
+      description: delete an existing pserver
+      operationId: deleteCloudInfrastructurePserversPserver
       consumes:
         - application/json
         - application/xml
@@ -12155,23 +13186,24 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vnfm-id
+        - name: hostname
           in: path
-          description: Unique ID of VNFM.
+          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
           required: true
           type: string
-  /external-system/esr-vnfm-list:
+  /cloud-infrastructure/pservers:
     get:
       tags:
-        - ExternalSystem
-      summary: returns esr-vnfm-list
-      description: returns esr-vnfm-list
-      operationId: getExternalSystemEsrVnfmList
+        - CloudInfrastructure
+      summary: returns pservers
+      description: returns pservers
+      operationId: getCloudInfrastructurePservers
       produces:
         - application/json
         - application/xml
@@ -12179,15 +13211,41 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/esr-vnfm-list"
+              $ref: "#/getDefinitions/pservers"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
-  /external-system/esr-thirdparty-sdnc-list/esr-thirdparty-sdnc/{thirdparty-sdnc-id}/esr-system-info-list/esr-system-info/{esr-system-info-id}/relationship-list/relationship:
+      parameters:
+        - name: hostname
+          in: query
+          description:
+          required: false
+          type: string
+        - name: inv-status
+          in: query
+          description:
+          required: false
+          type: string
+        - name: pserver-id
+          in: query
+          description:
+          required: false
+          type: string
+        - name: in-maint
+          in: query
+          description:
+          required: false
+          type: boolean
+        - name: pserver-name2
+          in: query
+          description:
+          required: false
+          type: string
+  /cloud-infrastructure/virtual-data-centers/virtual-data-center/{vdc-id}/relationship-list/relationship:
     put:
       tags:
-        - ExternalSystem
+        - CloudInfrastructure
       summary: see node definition for valid relationships
-      operationId: createOrUpdateExternalSystemEsrThirdpartySdncListEsrThirdpartySdncEsrSystemInfoListEsrSystemInfoRelationshipListRelationship
+      operationId: createOrUpdateCloudInfrastructureVirtualDataCentersVirtualDataCenterRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -12198,28 +13256,24 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: thirdparty-sdnc-id
-          in: path
-          description: Unique ID of SDNC.
-          required: true
-          type: string
-        - name: esr-system-info-id
+        - name: vdc-id
           in: path
-          description: Unique ID of esr system info.
+          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"
     delete:
       tags:
-        - ExternalSystem
+        - CloudInfrastructure
       summary: delete an existing relationship
       description: delete an existing relationship
-      operationId: deleteExternalSystemEsrThirdpartySdncListEsrThirdpartySdncEsrSystemInfoListEsrSystemInfoRelationshipListRelationship
+      operationId: deleteCloudInfrastructureVirtualDataCentersVirtualDataCenterRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -12230,23 +13284,19 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: thirdparty-sdnc-id
-          in: path
-          description: Unique ID of SDNC.
-          required: true
-          type: string
-        - name: esr-system-info-id
+        - name: vdc-id
           in: path
-          description: Unique ID of esr system info.
+          description: Unique ID of the vdc
           required: true
           type: string
-  /external-system/esr-thirdparty-sdnc-list/esr-thirdparty-sdnc/{thirdparty-sdnc-id}/esr-system-info-list/esr-system-info/{esr-system-info-id}:
+          example: __VDC-ID__
+  /cloud-infrastructure/virtual-data-centers/virtual-data-center/{vdc-id}:
     get:
       tags:
-        - ExternalSystem
-      summary: returns esr-system-info
-      description: returns esr-system-info
-      operationId: getExternalSystemEsrThirdpartySdncListEsrThirdpartySdncEsrSystemInfoListEsrSystemInfo
+        - CloudInfrastructure
+      summary: returns virtual-data-center
+      description: returns virtual-data-center
+      operationId: getCloudInfrastructureVirtualDataCentersVirtualDataCenter
       produces:
         - application/json
         - application/xml
@@ -12254,36 +13304,25 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/esr-system-info"
+              $ref: "#/getDefinitions/virtual-data-center"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: thirdparty-sdnc-id
-          in: path
-          description: Unique ID of SDNC.
-          required: true
-          type: string
-        - name: esr-system-info-id
+        - name: vdc-id
           in: path
-          description: Unique ID of esr system info.
+          description: Unique ID of the vdc
           required: true
           type: string
-        - name: system-name
-          in: query
-          description: name of external system.
-          required: false
-          type: string
-        - name: system-type
-          in: query
-          description: it could be vim/vnfm/thirdparty-sdnc/ems-resource/ems-performance/ems-alarm.
-          required: false
-          type: string
+          example: __VDC-ID__
     put:
       tags:
-        - ExternalSystem
-      summary: create or update an existing esr-system-info
-      description: create or update an existing esr-system-info
-      operationId: createOrUpdateExternalSystemEsrThirdpartySdncListEsrThirdpartySdncEsrSystemInfoListEsrSystemInfo
+        - CloudInfrastructure
+      summary: 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
         - application/xml
@@ -12294,28 +13333,63 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: thirdparty-sdnc-id
+        - name: vdc-id
           in: path
-          description: Unique ID of SDNC.
+          description: Unique ID of the vdc
           required: true
           type: string
-        - name: esr-system-info-id
+          example: __VDC-ID__
+        - name: body
+          in: body
+          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 esr system info.
+          description: Unique ID of the vdc
           required: true
           type: string
+          example: __VDC-ID__
         - name: body
           in: body
-          description: esr-system-info object that needs to be created or updated
+          description: virtual-data-center object that needs to be updated.
           required: true
           schema:
-            $ref: "#/definitions/esr-system-info"
+            $ref: "#/patchDefinitions/virtual-data-center"
     delete:
       tags:
-        - ExternalSystem
-      summary: delete an existing esr-system-info
-      description: delete an existing esr-system-info
-      operationId: deleteExternalSystemEsrThirdpartySdncListEsrThirdpartySdncEsrSystemInfoListEsrSystemInfo
+        - CloudInfrastructure
+      summary: delete an existing virtual-data-center
+      description: delete an existing virtual-data-center
+      operationId: deleteCloudInfrastructureVirtualDataCentersVirtualDataCenter
       consumes:
         - application/json
         - application/xml
@@ -12326,28 +13400,24 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: thirdparty-sdnc-id
-          in: path
-          description: Unique ID of SDNC.
-          required: true
-          type: string
-        - name: esr-system-info-id
+        - name: vdc-id
           in: path
-          description: Unique ID of esr system info.
+          description: Unique ID of the vdc
           required: true
           type: string
+          example: __VDC-ID__
         - name: resource-version
           in: query
           description: resource-version for concurrency
           required: true
           type: string
-  /external-system/esr-thirdparty-sdnc-list/esr-thirdparty-sdnc/{thirdparty-sdnc-id}/esr-system-info-list:
+  /cloud-infrastructure/virtual-data-centers:
     get:
       tags:
-        - ExternalSystem
-      summary: returns esr-system-info-list
-      description: returns esr-system-info-list
-      operationId: getExternalSystemEsrThirdpartySdncListEsrThirdpartySdncEsrSystemInfoList
+        - CloudInfrastructure
+      summary: returns virtual-data-centers
+      description: returns virtual-data-centers
+      operationId: getCloudInfrastructureVirtualDataCenters
       produces:
         - application/json
         - application/xml
@@ -12355,21 +13425,26 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/esr-system-info-list"
+              $ref: "#/getDefinitions/virtual-data-centers"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: thirdparty-sdnc-id
-          in: path
-          description: Unique ID of SDNC.
-          required: true
+        - name: vdc-id
+          in: query
+          description:
+          required: false
+          type: string
+        - name: vdc-name
+          in: query
+          description:
+          required: false
           type: string
-  /external-system/esr-thirdparty-sdnc-list/esr-thirdparty-sdnc/{thirdparty-sdnc-id}/relationship-list/relationship:
+  /business/connectors/connector/{resource-instance-id}/relationship-list/relationship:
     put:
       tags:
-        - ExternalSystem
+        - Business
       summary: see node definition for valid relationships
-      operationId: createOrUpdateExternalSystemEsrThirdpartySdncListEsrThirdpartySdncRelationshipListRelationship
+      operationId: createOrUpdateBusinessConnectorsConnectorRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -12380,23 +13455,24 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: thirdparty-sdnc-id
+        - name: resource-instance-id
           in: path
-          description: Unique ID of SDNC.
+          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"
     delete:
       tags:
-        - ExternalSystem
+        - Business
       summary: delete an existing relationship
       description: delete an existing relationship
-      operationId: deleteExternalSystemEsrThirdpartySdncListEsrThirdpartySdncRelationshipListRelationship
+      operationId: deleteBusinessConnectorsConnectorRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -12407,18 +13483,19 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: thirdparty-sdnc-id
+        - name: resource-instance-id
           in: path
-          description: Unique ID of SDNC.
+          description: Unique id of resource instance.
           required: true
           type: string
-  /external-system/esr-thirdparty-sdnc-list/esr-thirdparty-sdnc/{thirdparty-sdnc-id}:
+          example: __RESOURCE-INSTANCE-ID__
+  /business/connectors/connector/{resource-instance-id}/metadata/metadatum/{metaname}:
     get:
       tags:
-        - ExternalSystem
-      summary: returns esr-thirdparty-sdnc
-      description: returns esr-thirdparty-sdnc
-      operationId: getExternalSystemEsrThirdpartySdncListEsrThirdpartySdnc
+        - Business
+      summary: returns metadatum
+      description: returns metadatum
+      operationId: getBusinessConnectorsConnectorMetadataMetadatum
       produces:
         - application/json
         - application/xml
@@ -12426,118 +13503,30 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/esr-thirdparty-sdnc"
+              $ref: "#/getDefinitions/metadatum"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: thirdparty-sdnc-id
+        - name: resource-instance-id
           in: path
-          description: Unique ID of SDNC.
+          description: Unique id of resource instance.
           required: true
           type: string
-    put:
-      tags:
-        - ExternalSystem
-      summary: create or update an existing esr-thirdparty-sdnc
-      description: create or update an existing esr-thirdparty-sdnc
-      operationId: createOrUpdateExternalSystemEsrThirdpartySdncListEsrThirdpartySdnc
-      consumes:
-        - application/json
-        - application/xml
-      produces:
-        - application/json
-        - application/xml
-      responses:
-        "default":
-          description: Response codes found in [response codes](https://wiki.onap.org/).
-      parameters:
-        - name: thirdparty-sdnc-id
-          in: path
-          description: Unique ID of SDNC.
-          required: true
-          type: string
-        - name: body
-          in: body
-          description: esr-thirdparty-sdnc object that needs to be created or updated
-          required: true
-          schema:
-            $ref: "#/definitions/esr-thirdparty-sdnc"
-    delete:
-      tags:
-        - ExternalSystem
-      summary: delete an existing esr-thirdparty-sdnc
-      description: delete an existing esr-thirdparty-sdnc
-      operationId: deleteExternalSystemEsrThirdpartySdncListEsrThirdpartySdnc
-      consumes:
-        - application/json
-        - application/xml
-      produces:
-        - application/json
-        - application/xml
-      responses:
-        "default":
-          description: Response codes found in [response codes](https://wiki.onap.org/).
-      parameters:
-        - name: thirdparty-sdnc-id
+          example: __RESOURCE-INSTANCE-ID__
+        - name: metaname
           in: path
-          description: Unique ID of SDNC.
           required: true
           type: string
-        - name: resource-version
-          in: query
-          description: resource-version for concurrency
-          required: true
-          type: string
-  /external-system/esr-thirdparty-sdnc-list:
-    get:
-      tags:
-        - ExternalSystem
-      summary: returns esr-thirdparty-sdnc-list
-      description: returns esr-thirdparty-sdnc-list
-      operationId: getExternalSystemEsrThirdpartySdncList
-      produces:
-        - application/json
-        - application/xml
-      responses:
-        "200":
-          description: successful operation
-          schema:
-              $ref: "#/definitions/esr-thirdparty-sdnc-list"
-        "default":
-          description: Response codes found in [response codes](https://wiki.onap.org/).
-  /business/connectors/connector/{resource-instance-id}/relationship-list/relationship:
+          example: __METANAME__
     put:
       tags:
         - Business
-      summary: see node definition for valid relationships
-      operationId: createOrUpdateBusinessConnectorsConnectorRelationshipListRelationship
-      consumes:
-        - 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
-        - name: body
-          in: body
-          description: relationship object that needs to be created or updated
-          required: true
-          schema:
-            $ref: "#/definitions/relationship"
-    delete:
-      tags:
-        - Business
-      summary: delete an existing relationship
-      description: delete an existing relationship
-      operationId: deleteBusinessConnectorsConnectorRelationshipListRelationship
+      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: createOrUpdateBusinessConnectorsConnectorMetadataMetadatum
       consumes:
         - application/json
         - application/xml
@@ -12553,59 +13542,35 @@ paths:
           description: Unique id of resource instance.
           required: true
           type: string
-  /business/connectors/connector/{resource-instance-id}/metadata/metadatum/{metaname}:
-    get:
-      tags:
-        - Business
-      summary: returns metadatum
-      description: returns metadatum
-      operationId: getBusinessConnectorsConnectorMetadataMetadatum
-      produces:
-        - application/json
-        - application/xml
-      responses:
-        "200":
-          description: successful operation
-          schema:
-              $ref: "#/definitions/metadatum"
-        "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
-        - 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:
+          example: __METANAME__
+        - name: body
+          in: body
+          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: create or update an existing metadatum
-      description: create or update an existing metadatum
-      operationId: createOrUpdateBusinessConnectorsConnectorMetadataMetadatum
+      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
@@ -12621,16 +13586,18 @@ 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 updated.
           required: true
           schema:
-            $ref: "#/definitions/metadatum"
+            $ref: "#/patchDefinitions/metadatum"
     delete:
       tags:
         - Business
@@ -12652,10 +13619,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
@@ -12675,7 +13644,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:
@@ -12684,24 +13653,10 @@ paths:
           description: Unique id of resource instance.
           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
+          example: __RESOURCE-INSTANCE-ID__
+        - name: metaname
           in: query
-          description: the ASDC data dictionary version of the widget model.This maps directly to the A&AI version of the widget.
+          description:
           required: false
           type: string
   /business/connectors/connector/{resource-instance-id}:
@@ -12718,7 +13673,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:
@@ -12727,31 +13682,15 @@ paths:
           description: Unique id of resource instance.
           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
+          example: __RESOURCE-INSTANCE-ID__
     put:
       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
@@ -12768,12 +13707,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 updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/connector"
     delete:
       tags:
         - Business
@@ -12795,6 +13774,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
@@ -12814,9 +13794,35 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/connectors"
+              $ref: "#/getDefinitions/connectors"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: resource-instance-id
+          in: query
+          description:
+          required: false
+          type: string
+        - name: model-invariant-id
+          in: query
+          description:
+          required: false
+          type: string
+        - name: model-version-id
+          in: query
+          description:
+          required: false
+          type: string
+        - name: widget-model-id
+          in: query
+          description:
+          required: false
+          type: string
+        - name: widget-model-version
+          in: query
+          description:
+          required: false
+          type: string
   /business/customers/customer/{global-customer-id}/service-subscriptions/service-subscription/{service-type}/service-instances/service-instance/{service-instance-id}/relationship-list/relationship:
     put:
       tags:
@@ -12838,19 +13844,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"
@@ -12875,16 +13884,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:
@@ -12899,7 +13911,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:
@@ -12908,80 +13920,32 @@ 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
-        - name: subscriber-name
-          in: query
-          description: Subscriber name, an alternate way to retrieve a customer.
-          required: false
-          type: string
-        - name: subscriber-type
-          in: query
-          description: Subscriber type, a way to provide VID with only the INFRA customers.
-          required: false
-          type: string
-        - name: service-instance-name
-          in: query
-          description: This field will store a name assigned to the service-instance.
-          required: false
-          type: string
-        - name: environment-context
-          in: query
-          description: This field will store the environment context assigned to the service-instance.
-          required: false
-          type: string
-        - name: workload-context
-          in: query
-          description: This field will store the workload context assigned to the service-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: service-instance-location-id
-          in: query
-          description: An identifier that customers assign to the location where this service is being used.
-          required: false
-          type: string
-        - name: orchestration-status
-          in: query
-          description: Orchestration status of this service.
-          required: false
-          type: string
+          example: __METANAME__
     put:
       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
@@ -12998,26 +13962,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 updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/metadatum"
     delete:
       tags:
         - Business
@@ -13039,20 +14063,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
@@ -13072,7 +14100,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:
@@ -13081,69 +14109,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
-        - name: subscriber-name
-          in: query
-          description: Subscriber name, an alternate way to retrieve a customer.
-          required: false
-          type: string
-        - name: subscriber-type
-          in: query
-          description: Subscriber type, a way to provide VID with only the INFRA customers.
-          required: false
-          type: string
-        - name: service-instance-name
-          in: query
-          description: This field will store a name assigned to the service-instance.
-          required: false
-          type: string
-        - name: environment-context
-          in: query
-          description: This field will store the environment context assigned to the service-instance.
-          required: false
-          type: string
-        - name: workload-context
-          in: query
-          description: This field will store the workload context assigned to the service-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: service-instance-location-id
-          in: query
-          description: An identifier that customers assign to the location where this service is being used.
-          required: false
-          type: string
-        - name: orchestration-status
+          example: __SERVICE-INSTANCE-ID__
+        - name: metaname
           in: query
-          description: Orchestration status of this service.
+          description:
           required: false
           type: string
   /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}/relationship-list/relationship:
@@ -13167,29 +14148,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"
@@ -13214,26 +14200,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:
@@ -13248,7 +14239,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:
@@ -13257,107 +14248,103 @@ 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
-        - name: subscriber-name
-          in: query
-          description: Subscriber name, an alternate way to retrieve a customer.
-          required: false
-          type: string
-        - name: subscriber-type
-          in: query
-          description: Subscriber type, a way to provide VID with only the INFRA customers.
-          required: false
-          type: string
-        - name: service-instance-name
-          in: query
-          description: This field will store a name assigned to the service-instance.
-          required: false
-          type: string
-        - name: environment-context
-          in: query
-          description: This field will store the environment context assigned to the service-instance.
-          required: false
-          type: string
-        - name: workload-context
-          in: query
-          description: This field will store the workload context assigned to the service-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: service-instance-location-id
-          in: query
-          description: An identifier that customers assign to the location where this service is being used.
-          required: false
-          type: string
-        - name: orchestration-status
-          in: query
-          description: Orchestration status of this service.
-          required: false
+          example: __ID__
+    put:
+      tags:
+        - Business
+      summary: 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
+        - 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
-        - name: model-invariant-id
-          in: query
-          description: the ASDC model id for this resource or service model.
-          required: false
+          example: __GLOBAL-CUSTOMER-ID__
+        - name: service-type
+          in: path
+          description: Value defined by orchestration to identify this service across ECOMP.
+          required: true
           type: string
-        - name: model-version-id
-          in: query
-          description: the ASDC model version for this resource or service model.
-          required: false
+          example: __SERVICE-TYPE__
+        - name: service-instance-id
+          in: path
+          description: Uniquely identifies this instance of a service
+          required: true
           type: string
-        - name: type
-          in: query
-          description: Generic description of the type of allotted resource.
-          required: false
+          example: __SERVICE-INSTANCE-ID__
+        - name: id
+          in: path
+          description: Allotted Resource id UUID assigned to this instance.
+          required: true
           type: string
-        - name: role
-          in: query
-          description: role in the network that this resource will be providing.
-          required: false
+          example: __ID__
+        - name: id
+          in: path
+          description: Allotted Resource id UUID assigned to this instance.
+          required: true
           type: string
-    put:
+          example: __ID__
+        - name: body
+          in: body
+          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: create or update an existing tunnel-xconnect
-      description: create or update an existing tunnel-xconnect
-      operationId: createOrUpdateBusinessCustomersCustomerServiceSubscriptionsServiceSubscriptionServiceInstancesServiceInstanceAllottedResourcesAllottedResourceTunnelXconnectsTunnelXconnect
+      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
@@ -13373,32 +14360,37 @@ 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 updated.
           required: true
           schema:
-            $ref: "#/definitions/tunnel-xconnect"
+            $ref: "#/patchDefinitions/tunnel-xconnect"
     delete:
       tags:
         - Business
@@ -13420,26 +14412,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
@@ -13459,7 +14456,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:
@@ -13468,94 +14465,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
-        - name: subscriber-name
-          in: query
-          description: Subscriber name, an alternate way to retrieve a customer.
-          required: false
-          type: string
-        - name: subscriber-type
-          in: query
-          description: Subscriber type, a way to provide VID with only the INFRA customers.
-          required: false
-          type: string
-        - name: service-instance-name
-          in: query
-          description: This field will store a name assigned to the service-instance.
-          required: false
-          type: string
-        - name: environment-context
-          in: query
-          description: This field will store the environment context assigned to the service-instance.
-          required: false
-          type: string
-        - name: workload-context
-          in: query
-          description: This field will store the workload context assigned to the service-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: service-instance-location-id
-          in: query
-          description: An identifier that customers assign to the location where this service is being used.
-          required: false
-          type: string
-        - name: orchestration-status
-          in: query
-          description: Orchestration status of this service.
-          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: type
-          in: query
-          description: Generic description of the type of allotted resource.
-          required: false
-          type: string
-        - name: role
+          example: __ID__
+        - name: id
           in: query
-          description: role in the network that this resource will be providing.
+          description:
           required: false
           type: string
   /business/customers/customer/{global-customer-id}/service-subscriptions/service-subscription/{service-type}/service-instances/service-instance/{service-instance-id}/allotted-resources/allotted-resource/{id}/relationship-list/relationship:
@@ -13579,24 +14510,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"
@@ -13621,21 +14556,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:
@@ -13650,7 +14589,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:
@@ -13659,102 +14598,91 @@ 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
-        - name: subscriber-name
-          in: query
-          description: Subscriber name, an alternate way to retrieve a customer.
-          required: false
+          example: __ID__
+    put:
+      tags:
+        - Business
+      summary: 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
+        - 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
-        - name: subscriber-type
-          in: query
-          description: Subscriber type, a way to provide VID with only the INFRA customers.
-          required: false
+          example: __GLOBAL-CUSTOMER-ID__
+        - name: service-type
+          in: path
+          description: Value defined by orchestration to identify this service across ECOMP.
+          required: true
           type: string
-        - name: service-instance-name
-          in: query
-          description: This field will store a name assigned to the service-instance.
-          required: false
+          example: __SERVICE-TYPE__
+        - name: service-instance-id
+          in: path
+          description: Uniquely identifies this instance of a service
+          required: true
           type: string
-        - name: environment-context
-          in: query
-          description: This field will store the environment context assigned to the service-instance.
-          required: false
-          type: string
-        - name: workload-context
-          in: query
-          description: This field will store the workload context assigned to the service-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: service-instance-location-id
-          in: query
-          description: An identifier that customers assign to the location where this service is being used.
-          required: false
-          type: string
-        - name: orchestration-status
-          in: query
-          description: Orchestration status of this service.
-          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: type
-          in: query
-          description: Generic description of the type of allotted resource.
-          required: false
-          type: string
-        - name: role
-          in: query
-          description: role in the network that this resource will be providing.
-          required: false
+          example: __SERVICE-INSTANCE-ID__
+        - name: id
+          in: path
+          description: Allotted Resource id UUID assigned to this instance.
+          required: true
           type: string
-    put:
+          example: __ID__
+        - name: body
+          in: body
+          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: create or update an existing allotted-resource
-      description: create or update an existing allotted-resource
-      operationId: createOrUpdateBusinessCustomersCustomerServiceSubscriptionsServiceSubscriptionServiceInstancesServiceInstanceAllottedResourcesAllottedResource
+      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
@@ -13770,27 +14698,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: body
           in: body
-          description: allotted-resource object that needs to be created or updated
+          description: allotted-resource object that needs to be updated.
           required: true
           schema:
-            $ref: "#/definitions/allotted-resource"
+            $ref: "#/patchDefinitions/allotted-resource"
     delete:
       tags:
         - Business
@@ -13812,21 +14744,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
@@ -13846,7 +14782,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:
@@ -13855,69 +14791,42 @@ 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
-        - name: subscriber-name
-          in: query
-          description: Subscriber name, an alternate way to retrieve a customer.
-          required: false
-          type: string
-        - name: subscriber-type
-          in: query
-          description: Subscriber type, a way to provide VID with only the INFRA customers.
-          required: false
-          type: string
-        - name: service-instance-name
-          in: query
-          description: This field will store a name assigned to the service-instance.
-          required: false
-          type: string
-        - name: environment-context
-          in: query
-          description: This field will store the environment context assigned to the service-instance.
-          required: false
-          type: string
-        - name: workload-context
+          example: __SERVICE-INSTANCE-ID__
+        - name: id
           in: query
-          description: This field will store the workload context assigned to the service-instance.
+          description:
           required: false
           type: string
         - name: model-invariant-id
           in: query
-          description: the ASDC model id for this resource or service model.
+          description:
           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.
+          description:
           required: false
           type: string
-        - name: service-instance-location-id
+        - name: type
           in: query
-          description: An identifier that customers assign to the location where this service is being used.
+          description:
           required: false
           type: string
-        - name: orchestration-status
+        - name: role
           in: query
-          description: Orchestration status of this service.
+          description:
           required: false
           type: string
   /business/customers/customer/{global-customer-id}/service-subscriptions/service-subscription/{service-type}/service-instances/service-instance/{service-instance-id}:
@@ -13934,7 +14843,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:
@@ -13943,76 +14852,27 @@ 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
-        - name: subscriber-name
-          in: query
-          description: Subscriber name, an alternate way to retrieve a customer.
-          required: false
-          type: string
-        - name: subscriber-type
-          in: query
-          description: Subscriber type, a way to provide VID with only the INFRA customers.
-          required: false
-          type: string
-        - name: service-instance-name
-          in: query
-          description: This field will store a name assigned to the service-instance.
-          required: false
-          type: string
-        - name: environment-context
-          in: query
-          description: This field will store the environment context assigned to the service-instance.
-          required: false
-          type: string
-        - name: workload-context
-          in: query
-          description: This field will store the workload context assigned to the service-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: service-instance-location-id
-          in: query
-          description: An identifier that customers assign to the location where this service is being used.
-          required: false
-          type: string
-        - name: orchestration-status
-          in: query
-          description: Orchestration status of this service.
-          required: false
-          type: string
+          example: __SERVICE-INSTANCE-ID__
     put:
       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
@@ -14029,22 +14889,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 updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/service-instance"
     delete:
       tags:
         - Business
@@ -14066,16 +14980,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
@@ -14095,7 +15012,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:
@@ -14104,19 +15021,61 @@ 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
-        - name: subscriber-name
+          example: __SERVICE-TYPE__
+        - name: service-instance-id
           in: query
-          description: Subscriber name, an alternate way to retrieve a customer.
+          description:
           required: false
           type: string
-        - name: subscriber-type
+        - name: service-instance-name
           in: query
-          description: Subscriber type, a way to provide VID with only the INFRA customers.
+          description:
+          required: false
+          type: string
+        - name: environment-context
+          in: query
+          description:
+          required: false
+          type: string
+        - name: workload-context
+          in: query
+          description:
+          required: false
+          type: string
+        - name: model-invariant-id
+          in: query
+          description:
+          required: false
+          type: string
+        - name: model-version-id
+          in: query
+          description:
+          required: false
+          type: string
+        - name: widget-model-id
+          in: query
+          description:
+          required: false
+          type: string
+        - name: widget-model-version
+          in: query
+          description:
+          required: false
+          type: string
+        - name: service-instance-location-id
+          in: query
+          description:
+          required: false
+          type: string
+        - name: orchestration-status
+          in: query
+          description:
           required: false
           type: string
   /business/customers/customer/{global-customer-id}/service-subscriptions/service-subscription/{service-type}/relationship-list/relationship:
@@ -14140,14 +15099,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"
@@ -14172,11 +15133,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:
@@ -14191,7 +15154,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:
@@ -14200,26 +15163,21 @@ 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
-        - name: subscriber-name
-          in: query
-          description: Subscriber name, an alternate way to retrieve a customer.
-          required: false
-          type: string
-        - name: subscriber-type
-          in: query
-          description: Subscriber type, a way to provide VID with only the INFRA customers.
-          required: false
-          type: string
+          example: __SERVICE-TYPE__
     put:
       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
@@ -14236,17 +15194,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 updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/service-subscription"
     delete:
       tags:
         - Business
@@ -14268,11 +15273,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
@@ -14292,7 +15299,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:
@@ -14301,14 +15308,10 @@ paths:
           description: Global customer id used across ECOMP to uniquely identify customer.
           required: true
           type: string
-        - name: subscriber-name
-          in: query
-          description: Subscriber name, an alternate way to retrieve a customer.
-          required: false
-          type: string
-        - name: subscriber-type
+          example: __GLOBAL-CUSTOMER-ID__
+        - name: service-type
           in: query
-          description: Subscriber type, a way to provide VID with only the INFRA customers.
+          description:
           required: false
           type: string
   /business/customers/customer/{global-customer-id}/relationship-list/relationship:
@@ -14332,9 +15335,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"
@@ -14359,6 +15363,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:
@@ -14373,7 +15378,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:
@@ -14382,21 +15387,15 @@ paths:
           description: Global customer id used across ECOMP to uniquely identify customer.
           required: true
           type: string
-        - name: subscriber-name
-          in: query
-          description: Subscriber name, an alternate way to retrieve a customer.
-          required: false
-          type: string
-        - name: subscriber-type
-          in: query
-          description: Subscriber type, a way to provide VID with only the INFRA customers.
-          required: false
-          type: string
+          example: __GLOBAL-CUSTOMER-ID__
     put:
       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
@@ -14413,12 +15412,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 updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/customer"
     delete:
       tags:
         - Business
@@ -14440,6 +15479,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
@@ -14459,9 +15499,25 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/customers"
+              $ref: "#/getDefinitions/customers"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: global-customer-id
+          in: query
+          description:
+          required: false
+          type: string
+        - name: subscriber-name
+          in: query
+          description:
+          required: false
+          type: string
+        - name: subscriber-type
+          in: query
+          description:
+          required: false
+          type: string
   /business/lines-of-business/line-of-business/{line-of-business-name}/relationship-list/relationship:
     put:
       tags:
@@ -14483,9 +15539,10 @@ paths:
           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"
@@ -14510,6 +15567,7 @@ paths:
           description: Name of the line-of-business (product)
           required: true
           type: string
+          example: __LINE-OF-BUSINESS-NAME__
   /business/lines-of-business/line-of-business/{line-of-business-name}:
     get:
       tags:
@@ -14524,7 +15582,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/line-of-business"
+              $ref: "#/getDefinitions/line-of-business"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -14533,11 +15591,15 @@ paths:
           description: Name of the line-of-business (product)
           required: true
           type: string
+          example: __LINE-OF-BUSINESS-NAME__
     put:
       tags:
         - Business
       summary: create or update an existing line-of-business
-      description: 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
@@ -14554,12 +15616,52 @@ paths:
           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
+          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/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 updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/line-of-business"
     delete:
       tags:
         - Business
@@ -14581,6 +15683,7 @@ paths:
           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
@@ -14600,9 +15703,15 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/lines-of-business"
+              $ref: "#/getDefinitions/lines-of-business"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: line-of-business-name
+          in: query
+          description:
+          required: false
+          type: string
   /business/owning-entities/owning-entity/{owning-entity-id}/relationship-list/relationship:
     put:
       tags:
@@ -14624,9 +15733,10 @@ paths:
           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"
@@ -14651,6 +15761,7 @@ paths:
           description: UUID of an owning entity
           required: true
           type: string
+          example: __OWNING-ENTITY-ID__
   /business/owning-entities/owning-entity/{owning-entity-id}:
     get:
       tags:
@@ -14665,7 +15776,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/owning-entity"
+              $ref: "#/getDefinitions/owning-entity"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -14674,11 +15785,15 @@ paths:
           description: UUID of an owning entity
           required: true
           type: string
+          example: __OWNING-ENTITY-ID__
     put:
       tags:
         - Business
       summary: create or update an existing owning-entity
-      description: 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
@@ -14695,12 +15810,52 @@ paths:
           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
+          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/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 updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/owning-entity"
     delete:
       tags:
         - Business
@@ -14722,6 +15877,7 @@ paths:
           description: UUID of an owning entity
           required: true
           type: string
+          example: __OWNING-ENTITY-ID__
         - name: resource-version
           in: query
           description: resource-version for concurrency
@@ -14741,9 +15897,15 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/owning-entities"
+              $ref: "#/getDefinitions/owning-entities"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: owning-entity-id
+          in: query
+          description:
+          required: false
+          type: string
   /business/platforms/platform/{platform-name}/relationship-list/relationship:
     put:
       tags:
@@ -14765,9 +15927,10 @@ paths:
           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"
@@ -14792,6 +15955,7 @@ paths:
           description: Name of the platform
           required: true
           type: string
+          example: __PLATFORM-NAME__
   /business/platforms/platform/{platform-name}:
     get:
       tags:
@@ -14806,7 +15970,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/platform"
+              $ref: "#/getDefinitions/platform"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -14815,11 +15979,15 @@ paths:
           description: Name of the platform
           required: true
           type: string
+          example: __PLATFORM-NAME__
     put:
       tags:
         - Business
       summary: create or update an existing platform
-      description: 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
@@ -14836,12 +16004,52 @@ paths:
           description: Name of the platform
           required: true
           type: string
+          example: __PLATFORM-NAME__
         - name: body
           in: body
-          description: platform object that needs to be created or updated
+          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: Name of the platform
+          required: true
+          type: string
+          example: __PLATFORM-NAME__
+        - name: body
+          in: body
+          description: platform object that needs to be updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/platform"
     delete:
       tags:
         - Business
@@ -14863,6 +16071,7 @@ paths:
           description: Name of the platform
           required: true
           type: string
+          example: __PLATFORM-NAME__
         - name: resource-version
           in: query
           description: resource-version for concurrency
@@ -14882,9 +16091,15 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/platforms"
+              $ref: "#/getDefinitions/platforms"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: platform-name
+          in: query
+          description:
+          required: false
+          type: string
   /business/projects/project/{project-name}/relationship-list/relationship:
     put:
       tags:
@@ -14906,9 +16121,10 @@ paths:
           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"
@@ -14933,6 +16149,7 @@ paths:
           description: Name of the project deploying a service
           required: true
           type: string
+          example: __PROJECT-NAME__
   /business/projects/project/{project-name}:
     get:
       tags:
@@ -14947,7 +16164,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/project"
+              $ref: "#/getDefinitions/project"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -14956,11 +16173,15 @@ paths:
           description: Name of the project deploying a service
           required: true
           type: string
+          example: __PROJECT-NAME__
     put:
       tags:
         - Business
       summary: create or update an existing project
-      description: 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
@@ -14977,12 +16198,52 @@ paths:
           description: Name of the project deploying a service
           required: true
           type: string
+          example: __PROJECT-NAME__
         - name: body
           in: body
-          description: project object that needs to be created or updated
+          description: project object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/BusinessProjectsProject.json)
           required: true
           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: project object that needs to be updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/project"
     delete:
       tags:
         - Business
@@ -15004,6 +16265,7 @@ paths:
           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
@@ -15023,9 +16285,15 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/projects"
+              $ref: "#/getDefinitions/projects"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: project-name
+          in: query
+          description:
+          required: false
+          type: string
   /service-design-and-creation/vnf-images/vnf-image/{vnf-image-uuid}/relationship-list/relationship:
     put:
       tags:
@@ -15047,9 +16315,10 @@ paths:
           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"
@@ -15074,6 +16343,7 @@ paths:
           description: Unique ID of this asset
           required: true
           type: string
+          example: __VNF-IMAGE-UUID__
   /service-design-and-creation/vnf-images/vnf-image/{vnf-image-uuid}:
     get:
       tags:
@@ -15088,7 +16358,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/vnf-image"
+              $ref: "#/getDefinitions/vnf-image"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -15097,26 +16367,15 @@ paths:
           description: Unique ID of this asset
           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: __VNF-IMAGE-UUID__
     put:
       tags:
         - ServiceDesignAndCreation
       summary: create or update an existing vnf-image
-      description: 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
@@ -15133,12 +16392,52 @@ paths:
           description: Unique ID of this asset
           required: true
           type: string
+          example: __VNF-IMAGE-UUID__
         - name: body
           in: body
-          description: vnf-image object that needs to be created or updated
+          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 ID of this asset
+          required: true
+          type: string
+          example: __VNF-IMAGE-UUID__
+        - name: body
+          in: body
+          description: vnf-image object that needs to be updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/vnf-image"
     delete:
       tags:
         - ServiceDesignAndCreation
@@ -15160,6 +16459,7 @@ paths:
           description: Unique ID of this asset
           required: true
           type: string
+          example: __VNF-IMAGE-UUID__
         - name: resource-version
           in: query
           description: resource-version for concurrency
@@ -15179,9 +16479,30 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/vnf-images"
+              $ref: "#/getDefinitions/vnf-images"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: vnf-image-uuid
+          in: query
+          description:
+          required: false
+          type: string
+        - name: application
+          in: query
+          description:
+          required: false
+          type: string
+        - name: application-vendor
+          in: query
+          description:
+          required: false
+          type: string
+        - name: application-version
+          in: query
+          description:
+          required: false
+          type: string
   /service-design-and-creation/services/service/{service-id}/relationship-list/relationship:
     put:
       tags:
@@ -15203,9 +16524,10 @@ paths:
           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: 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/ServiceDesignAndCreationServicesService.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -15230,6 +16552,7 @@ paths:
           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__
   /service-design-and-creation/services/service/{service-id}:
     get:
       tags:
@@ -15244,7 +16567,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/service"
+              $ref: "#/getDefinitions/service"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -15253,16 +16576,15 @@ paths:
           description: This gets defined by others to provide a unique ID for the service, we accept what is sent.
           required: true
           type: string
-        - name: service-description
-          in: query
-          description: Description of the service
-          required: false
-          type: string
+          example: __SERVICE-ID__
     put:
       tags:
         - ServiceDesignAndCreation
       summary: create or update an existing service
-      description: 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
@@ -15279,18 +16601,30 @@ paths:
           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: service object that needs to be created or updated
+          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"
-    delete:
+    patch:
       tags:
         - ServiceDesignAndCreation
-      summary: delete an existing service
-      description: delete an existing service
-      operationId: deleteServiceDesignAndCreationServicesService
+      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
@@ -15306,66 +16640,19 @@ paths:
           description: This gets defined by others to provide a unique ID for the service, we accept what is sent.
           required: true
           type: string
-        - name: resource-version
-          in: query
-          description: resource-version for concurrency
-          required: true
-          type: string
-  /service-design-and-creation/services:
-    get:
-      tags:
-        - ServiceDesignAndCreation
-      summary: returns services
-      description: returns services
-      operationId: getServiceDesignAndCreationServices
-      produces:
-        - application/json
-        - application/xml
-      responses:
-        "200":
-          description: successful operation
-          schema:
-              $ref: "#/definitions/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: 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
-          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: __SERVICE-ID__
         - name: body
           in: body
-          description: relationship object that needs to be created or updated
+          description: service object that needs to be updated.
           required: true
           schema:
-            $ref: "#/definitions/relationship"
+            $ref: "#/patchDefinitions/service"
     delete:
       tags:
         - ServiceDesignAndCreation
-      summary: delete an existing relationship
-      description: delete an existing relationship
-      operationId: deleteServiceDesignAndCreationServiceCapabilitiesServiceCapabilityRelationshipListRelationship
+      summary: delete an existing service
+      description: delete an existing service
+      operationId: deleteServiceDesignAndCreationServicesService
       consumes:
         - application/json
         - application/xml
@@ -15376,23 +16663,24 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: service-type
+        - 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: 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.
+          example: __SERVICE-ID__
+        - name: resource-version
+          in: query
+          description: resource-version for concurrency
           required: true
           type: string
-  /service-design-and-creation/service-capabilities/service-capability/{service-type}/{vnf-type}:
+  /service-design-and-creation/services:
     get:
       tags:
         - ServiceDesignAndCreation
-      summary: returns service-capability
-      description: returns service-capability
-      operationId: getServiceDesignAndCreationServiceCapabilitiesServiceCapability
+      summary: returns services
+      description: returns services
+      operationId: getServiceDesignAndCreationServices
       produces:
         - application/json
         - application/xml
@@ -15400,26 +16688,26 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/service-capability"
+              $ref: "#/getDefinitions/services"
         "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
+        - name: service-id
+          in: query
+          description:
+          required: false
           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.
-          required: true
+        - name: service-description
+          in: query
+          description:
+          required: false
           type: string
+  /service-design-and-creation/service-capabilities/service-capability/{service-type}/{vnf-type}/relationship-list/relationship:
     put:
       tags:
         - ServiceDesignAndCreation
-      summary: create or update an existing service-capability
-      description: create or update an existing service-capability
-      operationId: createOrUpdateServiceDesignAndCreationServiceCapabilitiesServiceCapability
+      summary: see node definition for valid relationships
+      operationId: createOrUpdateServiceDesignAndCreationServiceCapabilitiesServiceCapabilityRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -15435,17 +16723,159 @@ paths:
           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-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: service-capability 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/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
+          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__
+  /service-design-and-creation/service-capabilities/service-capability/{service-type}/{vnf-type}:
+    get:
+      tags:
+        - ServiceDesignAndCreation
+      summary: returns service-capability
+      description: returns service-capability
+      operationId: getServiceDesignAndCreationServiceCapabilitiesServiceCapability
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "200":
+          description: successful operation
+          schema:
+              $ref: "#/getDefinitions/service-capability"
+        "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
+          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__
+    put:
+      tags:
+        - ServiceDesignAndCreation
+      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
+      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
+          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: 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
+          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: service-capability object that needs to be updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/service-capability"
     delete:
       tags:
         - ServiceDesignAndCreation
@@ -15467,11 +16897,13 @@ paths:
           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-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
@@ -15491,9 +16923,20 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/service-capabilities"
+              $ref: "#/getDefinitions/service-capabilities"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: service-type
+          in: query
+          description:
+          required: false
+          type: string
+        - name: vnf-type
+          in: query
+          description:
+          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}/element-choice-sets/element-choice-set/{element-choice-set-uuid}/relationship-list/relationship:
     put:
       tags:
@@ -15515,30 +16958,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"
@@ -15563,27 +17012,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__
   /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:
@@ -15598,7 +17053,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/element-choice-set"
+              $ref: "#/getDefinitions/element-choice-set"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -15607,47 +17062,41 @@ 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
-        - 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: __ELEMENT-CHOICE-SET-UUID__
     put:
       tags:
         - ServiceDesignAndCreation
       summary: create or update an existing element-choice-set
-      description: 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
@@ -15664,33 +17113,104 @@ 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: element-choice-set 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/element-choice-set"
+    patch:
+      tags:
+        - ServiceDesignAndCreation
+      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
+      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: 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: element-choice-set object that needs to be updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/element-choice-set"
     delete:
       tags:
         - ServiceDesignAndCreation
@@ -15712,27 +17232,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: resource-version
           in: query
           description: resource-version for concurrency
@@ -15752,7 +17278,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/element-choice-sets"
+              $ref: "#/getDefinitions/element-choice-sets"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -15761,36 +17287,31 @@ 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
-        - 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
+          example: __CONSTRAINED-ELEMENT-SET-UUID__
+        - name: element-choice-set-uuid
           in: query
-          description: Version
+          description:
           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:
@@ -15814,26 +17335,31 @@ 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: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/ServiceDesignAndCreationModelsModelModelVersModelVerModelElementsModelElementModelConstraintsModelConstraintConstrainedElementSetsConstrainedElementSet.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -15858,23 +17384,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__
   /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:
@@ -15889,7 +17420,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/constrained-element-set"
+              $ref: "#/getDefinitions/constrained-element-set"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -15898,43 +17429,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
-        - 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: __CONSTRAINED-ELEMENT-SET-UUID__
     put:
       tags:
         - ServiceDesignAndCreation
       summary: create or update an existing constrained-element-set
-      description: 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
@@ -15951,29 +17475,94 @@ 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: constrained-element-set 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/constrained-element-set"
+    patch:
+      tags:
+        - ServiceDesignAndCreation
+      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
+      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: 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: constrained-element-set object that needs to be updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/constrained-element-set"
     delete:
       tags:
         - ServiceDesignAndCreation
@@ -15995,23 +17584,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: resource-version
           in: query
           description: resource-version for concurrency
@@ -16031,7 +17625,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/constrained-element-sets"
+              $ref: "#/getDefinitions/constrained-element-sets"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -16040,32 +17634,26 @@ 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
-        - 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
+          example: __MODEL-CONSTRAINT-UUID__
+        - name: constrained-element-set-uuid
           in: query
-          description: Version
+          description:
           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}:
@@ -16082,7 +17670,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/model-constraint"
+              $ref: "#/getDefinitions/model-constraint"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -16091,39 +17679,31 @@ 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
-        - 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: __MODEL-CONSTRAINT-UUID__
     put:
       tags:
         - ServiceDesignAndCreation
       summary: create or update an existing model-constraint
-      description: 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
@@ -16140,31 +17720,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: model-constraint 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/model-constraint"
-    delete:
+    patch:
       tags:
         - ServiceDesignAndCreation
-      summary: delete an existing model-constraint
-      description: delete an existing model-constraint
-      operationId: deleteServiceDesignAndCreationModelsModelModelVersModelVerModelElementsModelElementModelConstraintsModelConstraint
+      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
@@ -16180,19 +17775,67 @@ 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: model-constraint object that needs to be updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/model-constraint"
+    delete:
+      tags:
+        - ServiceDesignAndCreation
+      summary: delete an existing model-constraint
+      description: delete an existing model-constraint
+      operationId: deleteServiceDesignAndCreationModelsModelModelVersModelVerModelElementsModelElementModelConstraintsModelConstraint
+      consumes:
+        - 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: model-constraint-uuid
+          in: path
+          required: true
+          type: string
+          example: __MODEL-CONSTRAINT-UUID__
         - name: resource-version
           in: query
           description: resource-version for concurrency
@@ -16212,7 +17855,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/model-constraints"
+              $ref: "#/getDefinitions/model-constraints"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -16221,28 +17864,21 @@ 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: 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
+          example: __MODEL-ELEMENT-UUID__
+        - name: model-constraint-uuid
           in: query
-          description: Version
+          description:
           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:
@@ -16266,18 +17902,21 @@ 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: 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"
@@ -16302,15 +17941,18 @@ 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__
   /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:
@@ -16325,7 +17967,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/model-element"
+              $ref: "#/getDefinitions/model-element"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -16334,35 +17976,26 @@ 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: 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: __MODEL-ELEMENT-UUID__
     put:
       tags:
         - ServiceDesignAndCreation
       summary: create or update an existing model-element
-      description: 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
@@ -16379,21 +18012,74 @@ 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: body
           in: body
-          description: model-element 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/model-element"
+    patch:
+      tags:
+        - ServiceDesignAndCreation
+      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
+      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: body
+          in: body
+          description: model-element object that needs to be updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/model-element"
     delete:
       tags:
         - ServiceDesignAndCreation
@@ -16415,15 +18101,18 @@ 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: resource-version
           in: query
           description: resource-version for concurrency
@@ -16443,7 +18132,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/model-elements"
+              $ref: "#/getDefinitions/model-elements"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -16452,24 +18141,16 @@ 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
-          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
+          example: __MODEL-VERSION-ID__
+        - name: model-element-uuid
           in: query
-          description: Version
+          description:
           required: false
           type: string
   /service-design-and-creation/models/model/{model-invariant-id}/model-vers/model-ver/{model-version-id}/metadata/metadatum/{metaname}:
@@ -16486,7 +18167,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:
@@ -16495,35 +18176,26 @@ 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: metaname
           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
+          example: __METANAME__
     put:
       tags:
         - ServiceDesignAndCreation
       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: createOrUpdateServiceDesignAndCreationModelsModelModelVersModelVerMetadataMetadatum
       consumes:
         - application/json
@@ -16540,21 +18212,74 @@ 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: 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/ServiceDesignAndCreationModelsModelModelVersModelVerMetadataMetadatum.json)
           required: true
           schema:
             $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 updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/metadatum"
     delete:
       tags:
         - ServiceDesignAndCreation
@@ -16576,15 +18301,18 @@ 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: metaname
           in: path
           required: true
           type: string
+          example: __METANAME__
         - name: resource-version
           in: query
           description: resource-version for concurrency
@@ -16604,7 +18332,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:
@@ -16613,24 +18341,16 @@ 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
-          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
+          example: __MODEL-VERSION-ID__
+        - name: metaname
           in: query
-          description: Version
+          description:
           required: false
           type: string
   /service-design-and-creation/models/model/{model-invariant-id}/model-vers/model-ver/{model-version-id}/relationship-list/relationship:
@@ -16654,14 +18374,16 @@ 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: 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"
@@ -16686,11 +18408,13 @@ 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__
   /service-design-and-creation/models/model/{model-invariant-id}/model-vers/model-ver/{model-version-id}:
     get:
       tags:
@@ -16705,7 +18429,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/model-ver"
+              $ref: "#/getDefinitions/model-ver"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -16714,31 +18438,21 @@ 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
-          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: __MODEL-VERSION-ID__
     put:
       tags:
         - ServiceDesignAndCreation
       summary: create or update an existing model-ver
-      description: 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
@@ -16755,17 +18469,64 @@ 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: body
           in: body
-          description: model-ver 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/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 updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/model-ver"
     delete:
       tags:
         - ServiceDesignAndCreation
@@ -16787,11 +18548,13 @@ 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: resource-version
           in: query
           description: resource-version for concurrency
@@ -16811,7 +18574,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/model-vers"
+              $ref: "#/getDefinitions/model-vers"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -16820,9 +18583,20 @@ paths:
           description: Unique identifier corresponding to the main definition of a model in ASDC
           required: true
           type: string
-        - name: model-type
+          example: __MODEL-INVARIANT-ID__
+        - name: model-version-id
+          in: query
+          description:
+          required: false
+          type: string
+        - name: model-name
+          in: query
+          description:
+          required: false
+          type: string
+        - name: model-version
           in: query
-          description: Type of the model, e.g., service, resource, widget, etc.
+          description:
           required: false
           type: string
   /service-design-and-creation/models/model/{model-invariant-id}/relationship-list/relationship:
@@ -16846,9 +18620,10 @@ paths:
           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"
@@ -16873,6 +18648,7 @@ paths:
           description: Unique identifier corresponding to the main definition of a model in ASDC
           required: true
           type: string
+          example: __MODEL-INVARIANT-ID__
   /service-design-and-creation/models/model/{model-invariant-id}:
     get:
       tags:
@@ -16887,7 +18663,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/model"
+              $ref: "#/getDefinitions/model"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -16896,16 +18672,15 @@ paths:
           description: Unique identifier corresponding to the main definition 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
+          example: __MODEL-INVARIANT-ID__
     put:
       tags:
         - ServiceDesignAndCreation
       summary: create or update an existing model
-      description: 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
@@ -16922,12 +18697,52 @@ paths:
           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
+          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/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 updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/model"
     delete:
       tags:
         - ServiceDesignAndCreation
@@ -16949,6 +18764,7 @@ paths:
           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
@@ -16968,9 +18784,20 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/models"
+              $ref: "#/getDefinitions/models"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: model-invariant-id
+          in: query
+          description:
+          required: false
+          type: string
+        - name: model-type
+          in: query
+          description:
+          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}/related-lookups/related-lookup/{related-lookup-uuid}/relationship-list/relationship:
     put:
       tags:
@@ -16991,17 +18818,20 @@ paths:
           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
           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"
@@ -17025,14 +18855,17 @@ paths:
           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
           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:
@@ -17047,7 +18880,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/related-lookup"
+              $ref: "#/getDefinitions/related-lookup"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -17055,23 +18888,25 @@ paths:
           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
           required: true
           type: string
-        - name: named-query-name
-          in: query
-          required: false
-          type: string
+          example: __RELATED-LOOKUP-UUID__
     put:
       tags:
         - ServiceDesignAndCreation
       summary: create or update an existing related-lookup
-      description: 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
@@ -17087,20 +18922,71 @@ paths:
           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
           required: true
           type: string
+          example: __RELATED-LOOKUP-UUID__
         - name: body
           in: body
-          description: related-lookup 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/related-lookup"
+    patch:
+      tags:
+        - 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
+      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: 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 updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/related-lookup"
     delete:
       tags:
         - ServiceDesignAndCreation
@@ -17121,14 +19007,17 @@ paths:
           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
           required: true
           type: string
+          example: __RELATED-LOOKUP-UUID__
         - name: resource-version
           in: query
           description: resource-version for concurrency
@@ -17148,7 +19037,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/related-lookups"
+              $ref: "#/getDefinitions/related-lookups"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -17156,12 +19045,15 @@ paths:
           in: path
           required: true
           type: string
+          example: __NAMED-QUERY-UUID__
         - name: named-query-element-uuid
           in: path
           required: true
           type: string
-        - name: named-query-name
+          example: __NAMED-QUERY-ELEMENT-UUID__
+        - name: related-lookup-uuid
           in: query
+          description:
           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}:
@@ -17178,7 +19070,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/property-constraint"
+              $ref: "#/getDefinitions/property-constraint"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -17186,23 +19078,25 @@ paths:
           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
           required: true
           type: string
-        - name: named-query-name
-          in: query
-          required: false
-          type: string
+          example: __PROPERTY-CONSTRAINT-UUID__
     put:
       tags:
         - ServiceDesignAndCreation
       summary: create or update an existing property-constraint
-      description: 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
@@ -17218,20 +19112,71 @@ paths:
           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
           required: true
           type: string
+          example: __PROPERTY-CONSTRAINT-UUID__
         - name: body
           in: body
-          description: property-constraint object that needs to be created or updated
+          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
+          required: true
+          type: string
+          example: __PROPERTY-CONSTRAINT-UUID__
+        - name: body
+          in: body
+          description: property-constraint object that needs to be updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/property-constraint"
     delete:
       tags:
         - ServiceDesignAndCreation
@@ -17252,14 +19197,17 @@ paths:
           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
           required: true
           type: string
+          example: __PROPERTY-CONSTRAINT-UUID__
         - name: resource-version
           in: query
           description: resource-version for concurrency
@@ -17279,7 +19227,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/property-constraints"
+              $ref: "#/getDefinitions/property-constraints"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -17287,12 +19235,15 @@ paths:
           in: path
           required: true
           type: string
+          example: __NAMED-QUERY-UUID__
         - name: named-query-element-uuid
           in: path
           required: true
           type: string
-        - name: named-query-name
+          example: __NAMED-QUERY-ELEMENT-UUID__
+        - name: property-constraint-uuid
           in: query
+          description:
           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:
@@ -17315,13 +19266,15 @@ paths:
           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: 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"
@@ -17345,10 +19298,12 @@ paths:
           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__
   /service-design-and-creation/named-queries/named-query/{named-query-uuid}/named-query-elements/named-query-element/{named-query-element-uuid}:
     get:
       tags:
@@ -17363,7 +19318,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/named-query-element"
+              $ref: "#/getDefinitions/named-query-element"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -17371,19 +19326,20 @@ paths:
           in: path
           required: true
           type: string
+          example: __NAMED-QUERY-UUID__
         - name: named-query-element-uuid
           in: path
           required: true
           type: string
-        - name: named-query-name
-          in: query
-          required: false
-          type: string
+          example: __NAMED-QUERY-ELEMENT-UUID__
     put:
       tags:
         - ServiceDesignAndCreation
       summary: create or update an existing named-query-element
-      description: 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
@@ -17399,16 +19355,61 @@ paths:
           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: body
           in: body
-          description: named-query-element object that needs to be created or updated
+          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
+          required: true
+          type: string
+          example: __NAMED-QUERY-ELEMENT-UUID__
+        - name: body
+          in: body
+          description: named-query-element object that needs to be updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/named-query-element"
     delete:
       tags:
         - ServiceDesignAndCreation
@@ -17429,10 +19430,12 @@ paths:
           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: resource-version
           in: query
           description: resource-version for concurrency
@@ -17452,7 +19455,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/named-query-elements"
+              $ref: "#/getDefinitions/named-query-elements"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -17460,8 +19463,10 @@ paths:
           in: path
           required: true
           type: string
-        - name: named-query-name
+          example: __NAMED-QUERY-UUID__
+        - name: named-query-element-uuid
           in: query
+          description:
           required: false
           type: string
   /service-design-and-creation/named-queries/named-query/{named-query-uuid}/relationship-list/relationship:
@@ -17484,9 +19489,10 @@ paths:
           in: path
           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"
@@ -17510,6 +19516,7 @@ paths:
           in: path
           required: true
           type: string
+          example: __NAMED-QUERY-UUID__
   /service-design-and-creation/named-queries/named-query/{named-query-uuid}:
     get:
       tags:
@@ -17524,7 +19531,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/named-query"
+              $ref: "#/getDefinitions/named-query"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -17532,15 +19539,15 @@ paths:
           in: path
           required: true
           type: string
-        - name: named-query-name
-          in: query
-          required: false
-          type: string
+          example: __NAMED-QUERY-UUID__
     put:
       tags:
         - ServiceDesignAndCreation
       summary: create or update an existing named-query
-      description: 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
@@ -17556,12 +19563,51 @@ paths:
           in: path
           required: true
           type: string
+          example: __NAMED-QUERY-UUID__
         - name: body
           in: body
-          description: named-query object that needs to be created or updated
+          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
+          required: true
+          type: string
+          example: __NAMED-QUERY-UUID__
+        - name: body
+          in: body
+          description: named-query object that needs to be updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/named-query"
     delete:
       tags:
         - ServiceDesignAndCreation
@@ -17582,6 +19628,7 @@ paths:
           in: path
           required: true
           type: string
+          example: __NAMED-QUERY-UUID__
         - name: resource-version
           in: query
           description: resource-version for concurrency
@@ -17601,9 +19648,20 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/named-queries"
+              $ref: "#/getDefinitions/named-queries"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: named-query-uuid
+          in: query
+          description:
+          required: false
+          type: string
+        - name: named-query-name
+          in: query
+          description:
+          required: false
+          type: string
   /network/logical-links/logical-link/{link-name}/relationship-list/relationship:
     put:
       tags:
@@ -17625,9 +19683,10 @@ paths:
           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"
@@ -17652,6 +19711,7 @@ paths:
           description: e.g., evc-name, or vnf-nameA_interface-nameA_vnf-nameZ_interface-nameZ
           required: true
           type: string
+          example: __LINK-NAME__
   /network/logical-links/logical-link/{link-name}:
     get:
       tags:
@@ -17666,7 +19726,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/logical-link"
+              $ref: "#/getDefinitions/logical-link"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -17675,51 +19735,15 @@ paths:
           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
-          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
+          example: __LINK-NAME__
     put:
       tags:
         - Network
       summary: create or update an existing logical-link
-      description: 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
@@ -17736,12 +19760,52 @@ paths:
           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: logical-link 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/logical-link"
+    patch:
+      tags:
+        - Network
+      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
+      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., evc-name, or vnf-nameA_interface-nameA_vnf-nameZ_interface-nameZ
+          required: true
+          type: string
+          example: __LINK-NAME__
+        - name: body
+          in: body
+          description: logical-link object that needs to be updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/logical-link"
     delete:
       tags:
         - Network
@@ -17763,6 +19827,7 @@ paths:
           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
@@ -17782,9 +19847,55 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/logical-links"
+              $ref: "#/getDefinitions/logical-links"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: link-name
+          in: query
+          description:
+          required: false
+          type: string
+        - name: model-invariant-id
+          in: query
+          description:
+          required: false
+          type: string
+        - name: model-version-id
+          in: query
+          description:
+          required: false
+          type: string
+        - name: widget-model-id
+          in: query
+          description:
+          required: false
+          type: string
+        - name: widget-model-version
+          in: query
+          description:
+          required: false
+          type: string
+        - name: prov-status
+          in: query
+          description:
+          required: false
+          type: string
+        - name: link-id
+          in: query
+          description:
+          required: false
+          type: string
+        - name: circuit-id
+          in: query
+          description:
+          required: false
+          type: string
+        - name: purpose
+          in: query
+          description:
+          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}/relationship-list/relationship:
     put:
       tags:
@@ -17806,24 +19917,28 @@ paths:
           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: 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"
@@ -17848,21 +19963,25 @@ paths:
           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__
   /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:
@@ -17877,7 +19996,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/class-of-service"
+              $ref: "#/getDefinitions/class-of-service"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -17886,26 +20005,33 @@ paths:
           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__
     put:
       tags:
         - Network
       summary: create or update an existing class-of-service
-      description: 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
@@ -17922,33 +20048,48 @@ paths:
           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
+          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/class-of-service"
-    delete:
+    patch:
       tags:
         - Network
-      summary: delete an existing class-of-service
-      description: delete an existing class-of-service
-      operationId: deleteNetworkSitePairSetsSitePairSetRoutingInstancesRoutingInstanceSitePairsSitePairClassesOfServiceClassOfService
+      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
@@ -17964,41 +20105,44 @@ paths:
           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
-        - name: resource-version
-          in: query
-          description: resource-version for concurrency
+          example: __COS__
+        - name: body
+          in: body
+          description: class-of-service object that needs to be updated.
           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:
-    get:
+          schema:
+            $ref: "#/patchDefinitions/class-of-service"
+    delete:
       tags:
         - Network
-      summary: returns classes-of-service
-      description: returns classes-of-service
-      operationId: getNetworkSitePairSetsSitePairSetRoutingInstancesRoutingInstanceSitePairsSitePairClassesOfService
+      summary: delete an existing class-of-service
+      description: delete an existing class-of-service
+      operationId: deleteNetworkSitePairSetsSitePairSetRoutingInstancesRoutingInstanceSitePairsSitePairClassesOfServiceClassOfService
+      consumes:
+        - application/json
+        - application/xml
       produces:
         - application/json
         - application/xml
       responses:
-        "200":
-          description: successful operation
-          schema:
-              $ref: "#/definitions/classes-of-service"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -18007,29 +20151,45 @@ paths:
           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
-  /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:
+          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/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: see node definition for valid relationships
-      operationId: createOrUpdateNetworkSitePairSetsSitePairSetRoutingInstancesRoutingInstanceSitePairsSitePairRelationshipListRelationship
-      consumes:
-        - application/json
-        - application/xml
+      summary: returns classes-of-service
+      description: returns classes-of-service
+      operationId: getNetworkSitePairSetsSitePairSetRoutingInstancesRoutingInstanceSitePairsSitePairClassesOfService
       produces:
         - application/json
         - application/xml
       responses:
+        "200":
+          description: successful operation
+          schema:
+              $ref: "#/getDefinitions/classes-of-service"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -18038,28 +20198,30 @@ paths:
           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
-        - name: body
-          in: body
-          description: relationship object that needs to be created or updated
-          required: true
-          schema:
-            $ref: "#/definitions/relationship"
-    delete:
+          example: __SITE-PAIR-ID__
+        - name: cos
+          in: query
+          description:
+          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:
+    put:
       tags:
         - Network
-      summary: delete an existing relationship
-      description: delete an existing relationship
-      operationId: deleteNetworkSitePairSetsSitePairSetRoutingInstancesRoutingInstanceSitePairsSitePairRelationshipListRelationship
+      summary: see node definition for valid relationships
+      operationId: createOrUpdateNetworkSitePairSetsSitePairSetRoutingInstancesRoutingInstanceSitePairsSitePairRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -18075,16 +20237,59 @@ paths:
           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. [Valid relationship examples shown here](apidocs/relations/v11/NetworkSitePairSetsSitePairSetRoutingInstancesRoutingInstanceSitePairsSitePair.json)
+          required: true
+          schema:
+            $ref: "#/definitions/relationship"
+    delete:
+      tags:
+        - Network
+      summary: delete an existing relationship
+      description: delete an existing relationship
+      operationId: deleteNetworkSitePairSetsSitePairSetRoutingInstancesRoutingInstanceSitePairsSitePairRelationshipListRelationship
+      consumes:
+        - 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__
   /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:
@@ -18099,7 +20304,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/site-pair"
+              $ref: "#/getDefinitions/site-pair"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -18108,21 +20313,27 @@ paths:
           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__
     put:
       tags:
         - Network
       summary: create or update an existing site-pair
-      description: 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
@@ -18139,22 +20350,76 @@ paths:
           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
+          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/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 updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/site-pair"
     delete:
       tags:
         - Network
@@ -18176,16 +20441,19 @@ paths:
           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
@@ -18205,7 +20473,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/site-pairs"
+              $ref: "#/getDefinitions/site-pairs"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -18214,11 +20482,18 @@ paths:
           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: query
+          description:
+          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:
     put:
       tags:
@@ -18240,14 +20515,16 @@ paths:
           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"
@@ -18272,11 +20549,13 @@ paths:
           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}:
     get:
       tags:
@@ -18291,7 +20570,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/routing-instance"
+              $ref: "#/getDefinitions/routing-instance"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -18300,16 +20579,21 @@ paths:
           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__
     put:
       tags:
         - Network
       summary: create or update an existing routing-instance
-      description: 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
@@ -18326,17 +20610,64 @@ paths:
           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: routing-instance object that needs to be created or updated
+          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: 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
+      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: body
+          in: body
+          description: routing-instance object that needs to be updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/routing-instance"
     delete:
       tags:
         - Network
@@ -18358,11 +20689,13 @@ paths:
           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: resource-version
           in: query
           description: resource-version for concurrency
@@ -18382,7 +20715,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/routing-instances"
+              $ref: "#/getDefinitions/routing-instances"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -18391,6 +20724,12 @@ paths:
           description: Unique id of site pair set.
           required: true
           type: string
+          example: __SITE-PAIR-SET-ID__
+        - name: routing-instance-id
+          in: query
+          description:
+          required: false
+          type: string
   /network/site-pair-sets/site-pair-set/{site-pair-set-id}/relationship-list/relationship:
     put:
       tags:
@@ -18412,9 +20751,10 @@ paths:
           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: relationship object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkSitePairSetsSitePairSet.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -18439,6 +20779,7 @@ paths:
           description: Unique id of site pair set.
           required: true
           type: string
+          example: __SITE-PAIR-SET-ID__
   /network/site-pair-sets/site-pair-set/{site-pair-set-id}:
     get:
       tags:
@@ -18453,7 +20794,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/site-pair-set"
+              $ref: "#/getDefinitions/site-pair-set"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -18462,11 +20803,15 @@ paths:
           description: Unique id of site pair set.
           required: true
           type: string
+          example: __SITE-PAIR-SET-ID__
     put:
       tags:
         - Network
       summary: create or update an existing site-pair-set
-      description: 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
@@ -18483,12 +20828,52 @@ paths:
           description: Unique id of site pair set.
           required: true
           type: string
+          example: __SITE-PAIR-SET-ID__
         - name: body
           in: body
-          description: site-pair-set object that needs to be created or updated
+          description: site-pair-set object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkSitePairSetsSitePairSet.json)
           required: true
           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: Unique id of site pair set.
+          required: true
+          type: string
+          example: __SITE-PAIR-SET-ID__
+        - name: body
+          in: body
+          description: site-pair-set object that needs to be updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/site-pair-set"
     delete:
       tags:
         - Network
@@ -18510,6 +20895,7 @@ paths:
           description: Unique id of site pair set.
           required: true
           type: string
+          example: __SITE-PAIR-SET-ID__
         - name: resource-version
           in: query
           description: resource-version for concurrency
@@ -18529,9 +20915,15 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/site-pair-sets"
+              $ref: "#/getDefinitions/site-pair-sets"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: site-pair-set-id
+          in: query
+          description:
+          required: false
+          type: string
   /network/vpn-bindings/vpn-binding/{vpn-id}/route-targets/route-target/{global-route-target}/{route-target-role}/relationship-list/relationship:
     put:
       tags:
@@ -18553,19 +20945,22 @@ paths:
           description: VPN ID, globally unique within A&AI
           required: true
           type: string
+          example: __VPN-ID__
         - name: global-route-target
           in: path
           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: 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"
@@ -18590,16 +20985,19 @@ paths:
           description: VPN ID, globally unique within A&AI
           required: true
           type: string
+          example: __VPN-ID__
         - name: global-route-target
           in: path
           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__
   /network/vpn-bindings/vpn-binding/{vpn-id}/route-targets/route-target/{global-route-target}/{route-target-role}:
     get:
       tags:
@@ -18614,7 +21012,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/route-target"
+              $ref: "#/getDefinitions/route-target"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -18623,31 +21021,27 @@ paths:
           description: VPN ID, globally unique within A&AI
           required: true
           type: string
+          example: __VPN-ID__
         - name: global-route-target
           in: path
           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
-        - 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
-          type: string
+          example: __ROUTE-TARGET-ROLE__
     put:
       tags:
         - Network
       summary: create or update an existing route-target
-      description: 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
@@ -18664,22 +21058,76 @@ paths:
           description: VPN ID, globally unique within A&AI
           required: true
           type: string
+          example: __VPN-ID__
         - name: global-route-target
           in: path
           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: route-target object that needs to be created or updated
+          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: VPN ID, globally unique within A&AI
+          required: true
+          type: string
+          example: __VPN-ID__
+        - name: global-route-target
+          in: path
+          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: route-target object that needs to be updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/route-target"
     delete:
       tags:
         - Network
@@ -18701,16 +21149,19 @@ paths:
           description: VPN ID, globally unique within A&AI
           required: true
           type: string
+          example: __VPN-ID__
         - name: global-route-target
           in: path
           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: resource-version
           in: query
           description: resource-version for concurrency
@@ -18730,7 +21181,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/route-targets"
+              $ref: "#/getDefinitions/route-targets"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -18739,16 +21190,7 @@ paths:
           description: VPN ID, globally unique within A&AI
           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
-          type: string
+          example: __VPN-ID__
   /network/vpn-bindings/vpn-binding/{vpn-id}/relationship-list/relationship:
     put:
       tags:
@@ -18770,9 +21212,10 @@ paths:
           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"
@@ -18797,6 +21240,7 @@ paths:
           description: VPN ID, globally unique within A&AI
           required: true
           type: string
+          example: __VPN-ID__
   /network/vpn-bindings/vpn-binding/{vpn-id}:
     get:
       tags:
@@ -18811,7 +21255,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/vpn-binding"
+              $ref: "#/getDefinitions/vpn-binding"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -18820,21 +21264,15 @@ paths:
           description: VPN ID, globally unique within A&AI
           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
-          type: string
+          example: __VPN-ID__
     put:
       tags:
         - Network
       summary: create or update an existing vpn-binding
-      description: 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
@@ -18851,12 +21289,52 @@ paths:
           description: VPN ID, globally unique within A&AI
           required: true
           type: string
+          example: __VPN-ID__
         - name: body
           in: body
-          description: vpn-binding object that needs to be created or updated
+          description: vpn-binding object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVpnBindingsVpnBinding.json)
           required: true
           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: VPN ID, globally unique within A&AI
+          required: true
+          type: string
+          example: __VPN-ID__
+        - name: body
+          in: body
+          description: vpn-binding object that needs to be updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/vpn-binding"
     delete:
       tags:
         - Network
@@ -18878,6 +21356,7 @@ paths:
           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
@@ -18897,9 +21376,25 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/vpn-bindings"
+              $ref: "#/getDefinitions/vpn-bindings"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: vpn-id
+          in: query
+          description:
+          required: false
+          type: string
+        - name: vpn-name
+          in: query
+          description:
+          required: false
+          type: string
+        - name: vpn-type
+          in: query
+          description:
+          required: false
+          type: string
   /network/vpls-pes/vpls-pe/{equipment-name}/relationship-list/relationship:
     put:
       tags:
@@ -18920,9 +21415,10 @@ paths:
           in: path
           required: true
           type: string
+          example: __EQUIPMENT-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/NetworkVplsPesVplsPe.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -18946,6 +21442,7 @@ paths:
           in: path
           required: true
           type: string
+          example: __EQUIPMENT-NAME__
   /network/vpls-pes/vpls-pe/{equipment-name}/p-interfaces/p-interface/{interface-name}/relationship-list/relationship:
     put:
       tags:
@@ -18966,14 +21463,16 @@ 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: 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/NetworkVplsPesVplsPePInterfacesPInterface.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -18997,11 +21496,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
+          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:
@@ -19022,19 +21523,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
+          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/NetworkVplsPesVplsPePInterfacesPInterfaceSriovPfsSriovPf.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -19058,16 +21562,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: pf-pci-id
           in: path
           description: Identifier for the sriov-pf
           required: true
           type: string
+          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:
@@ -19082,7 +21589,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:
@@ -19090,31 +21597,27 @@ 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
-        - 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: __PF-PCI-ID__
     put:
       tags:
         - Network
       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: createOrUpdateNetworkVplsPesVplsPePInterfacesPInterfaceSriovPfsSriovPf
       consumes:
         - application/json
@@ -19130,22 +21633,75 @@ 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
+          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 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 updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/sriov-pf"
     delete:
       tags:
         - Network
@@ -19166,16 +21722,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: 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
@@ -19195,7 +21754,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:
@@ -19203,19 +21762,16 @@ 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
-          type: string
-        - name: prov-status
+          example: __INTERFACE-NAME__
+        - name: pf-pci-id
           in: query
-          description: Trigger for operational monitoring of this resource by Service Assurance systems.
+          description:
           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:
@@ -19238,24 +21794,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"
@@ -19279,21 +21839,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__
   /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:
@@ -19314,29 +21878,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"
@@ -19360,26 +21929,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__
   /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:
@@ -19394,7 +21968,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:
@@ -19402,84 +21976,102 @@ 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
-        - 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
+          example: __L3-INTERFACE-IPV4-ADDRESS__
+    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: createOrUpdateNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList
+      consumes:
+        - 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: network-name
-          in: query
-          description: Name of the network
-          required: false
+          example: __EQUIPMENT-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the physical interface
+          required: true
           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
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
           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
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
           type: string
-        - name: neutron-subnet-id
-          in: query
-          description: Neutron id of subnet that address belongs to
-          required: false
+          example: __VLAN-INTERFACE__
+        - name: l3-interface-ipv4-address
+          in: path
+          description: IP address
+          required: true
           type: string
-    put:
+          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/NetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList.json)
+          required: true
+          schema:
+            $ref: "#/definitions/l3-interface-ipv4-address-list"
+    patch:
       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: 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
@@ -19494,32 +22086,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: 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 updated.
           required: true
           schema:
-            $ref: "#/definitions/l3-interface-ipv4-address-list"
+            $ref: "#/patchDefinitions/l3-interface-ipv4-address-list"
     delete:
       tags:
         - Network
@@ -19540,26 +22137,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: resource-version
           in: query
           description: resource-version for concurrency
@@ -19585,29 +22187,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"
@@ -19631,26 +22238,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-ipv6-address
           in: path
           description: IP address
           required: true
           type: string
+          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:
@@ -19665,7 +22277,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:
@@ -19673,84 +22285,102 @@ 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
-        - 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
+          example: __L3-INTERFACE-IPV6-ADDRESS__
+    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: createOrUpdateNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList
+      consumes:
+        - 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: network-name
-          in: query
-          description: Name of the network
-          required: false
+          example: __EQUIPMENT-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the physical interface
+          required: true
           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
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
           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
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
           type: string
-        - name: neutron-subnet-id
-          in: query
-          description: Neutron id of subnet that address belongs to
-          required: false
+          example: __VLAN-INTERFACE__
+        - 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/NetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList.json)
+          required: true
+          schema:
+            $ref: "#/definitions/l3-interface-ipv6-address-list"
+    patch:
       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: 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
@@ -19765,32 +22395,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: 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 updated.
           required: true
           schema:
-            $ref: "#/definitions/l3-interface-ipv6-address-list"
+            $ref: "#/patchDefinitions/l3-interface-ipv6-address-list"
     delete:
       tags:
         - Network
@@ -19811,26 +22446,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-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
@@ -19850,7 +22490,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:
@@ -19858,62 +22498,33 @@ 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
-        - 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
+          example: __VLAN-INTERFACE__
     put:
       tags:
         - Network
       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: createOrUpdateNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceVlansVlan
       consumes:
         - application/json
@@ -19929,27 +22540,87 @@ 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: 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/NetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceVlansVlan.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: UpdateNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceVlansVlan
+      consumes:
+        - 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: body
+          in: body
+          description: vlan object that needs to be updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/vlan"
     delete:
       tags:
         - Network
@@ -19970,21 +22641,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: resource-version
           in: query
           description: resource-version for concurrency
@@ -20004,7 +22679,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:
@@ -20012,39 +22687,33 @@ 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: 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
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
           in: query
-          description: ID of interface
+          description:
           required: false
           type: string
-        - name: macaddr
+        - name: vlan-id-inner
           in: query
-          description: MAC address for the interface
+          description:
           required: false
-          type: string
-        - name: network-name
+          type: integer
+          format: int64
+        - name: vpn-key
           in: query
-          description: Name of the network
+          description:
           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:
@@ -20067,24 +22736,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: 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/NetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceSriovVfsSriovVf.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -20108,21 +22781,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: 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:
@@ -20137,7 +22814,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:
@@ -20145,71 +22822,33 @@ 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
-        - 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: 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
+          example: __PCI-ID__
     put:
       tags:
         - Network
       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: createOrUpdateNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceSriovVfsSriovVf
       consumes:
         - application/json
@@ -20225,27 +22864,87 @@ 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: 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/NetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceSriovVfsSriovVf.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: UpdateNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceSriovVfsSriovVf
+      consumes:
+        - 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: 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 updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/sriov-vf"
     delete:
       tags:
         - Network
@@ -20266,21 +22965,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: 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
@@ -20300,7 +23003,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:
@@ -20308,39 +23011,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
-        - name: prov-status
+          example: __INTERFACE-NAME__
+        - name: pci-id
           in: query
-          description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems.
+          description:
           required: false
           type: string
-        - name: prov-status
+        - name: vf-vlan-filter
           in: query
-          description: Trigger for operational monitoring of this resource by Service Assurance systems.
+          description:
           required: false
           type: string
-        - name: interface-id
+        - name: vf-mac-filter
           in: query
-          description: ID of interface
+          description:
           required: false
           type: string
-        - name: macaddr
+        - name: vf-vlan-strip
           in: query
-          description: MAC address for the interface
+          description:
           required: false
-          type: string
-        - name: network-name
+          type: boolean
+        - name: neutron-network-id
           in: query
-          description: Name of the network
+          description:
           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:
@@ -20363,19 +23069,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
+          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"
@@ -20399,16 +23108,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__
   /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:
@@ -20429,24 +23141,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: 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"
@@ -20470,21 +23186,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: 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}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}:
     get:
       tags:
@@ -20499,7 +23219,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:
@@ -20507,67 +23227,33 @@ 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: l3-interface-ipv4-address
           in: path
           description: IP address
           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: 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: __L3-INTERFACE-IPV4-ADDRESS__
     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
+      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
@@ -20583,27 +23269,87 @@ 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: 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"
+    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: UpdateNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList
+      consumes:
+        - 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-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 updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/l3-interface-ipv4-address-list"
     delete:
       tags:
         - Network
@@ -20624,21 +23370,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: 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
@@ -20664,24 +23414,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: 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"
@@ -20705,21 +23459,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: 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}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}:
     get:
       tags:
@@ -20734,7 +23492,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:
@@ -20742,67 +23500,33 @@ 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: l3-interface-ipv6-address
           in: path
           description: IP address
           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: 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: __L3-INTERFACE-IPV6-ADDRESS__
     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
+      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
@@ -20818,27 +23542,87 @@ 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: 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/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 updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/l3-interface-ipv6-address-list"
     delete:
       tags:
         - Network
@@ -20859,21 +23643,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: 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
@@ -20893,7 +23681,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:
@@ -20901,83 +23689,117 @@ 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: prov-status
-          in: query
-          description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems.
-          required: false
+          example: __INTERFACE-NAME__
+    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: createOrUpdateNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterface
+      consumes:
+        - 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: prov-status
-          in: query
-          description: Trigger for operational monitoring of this resource by Service Assurance systems.
-          required: false
+          example: __EQUIPMENT-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the physical interface
+          required: true
           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: macaddr
-          in: query
-          description: MAC address for the interface
-          required: false
+          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/NetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterface.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: UpdateNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterface
+      consumes:
+        - 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: network-name
-          in: query
-          description: Name of the network
-          required: false
+          example: __EQUIPMENT-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 updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/l-interface"
+    delete:
       tags:
         - Network
-      summary: create or update an existing l-interface
-      description: create or update an existing l-interface
-      operationId: createOrUpdateNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterface
-      consumes:
-        - 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: 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: body
-          in: body
-          description: l-interface object that needs to be created or updated
-          required: true
-          schema:
-            $ref: "#/definitions/l-interface"
-    delete:
-      tags:
-        - Network
-      summary: delete an existing l-interface
-      description: delete an existing l-interface
-      operationId: deleteNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterface
+      summary: delete an existing l-interface
+      description: delete an existing l-interface
+      operationId: deleteNetworkVplsPesVplsPePInterfacesPInterfaceLInterfacesLInterface
       consumes:
         - application/json
         - application/xml
@@ -20992,16 +23814,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: resource-version
           in: query
           description: resource-version for concurrency
@@ -21021,7 +23846,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:
@@ -21029,19 +23854,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: prov-status
+          example: __INTERFACE-NAME__
+        - name: interface-name
           in: query
-          description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems.
+          description:
           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:
+          required: false
+          type: string
+        - name: macaddr
+          in: query
+          description:
+          required: false
+          type: string
+        - name: network-name
+          in: query
+          description:
           required: false
           type: string
   /network/vpls-pes/vpls-pe/{equipment-name}/p-interfaces/p-interface/{interface-name}:
@@ -21058,7 +23895,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:
@@ -21066,26 +23903,21 @@ 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
-          type: string
-        - name: prov-status
-          in: query
-          description: Trigger for operational monitoring of this resource by Service Assurance systems.
-          required: false
-          type: string
+          example: __INTERFACE-NAME__
     put:
       tags:
         - Network
       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: createOrUpdateNetworkVplsPesVplsPePInterfacesPInterface
       consumes:
         - application/json
@@ -21101,17 +23933,63 @@ 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: 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/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
+          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: body
+          in: body
+          description: p-interface object that needs to be updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/p-interface"
     delete:
       tags:
         - Network
@@ -21132,11 +24010,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
+          example: __INTERFACE-NAME__
         - name: resource-version
           in: query
           description: resource-version for concurrency
@@ -21156,7 +24036,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:
@@ -21164,9 +24044,15 @@ paths:
           in: path
           required: true
           type: string
+          example: __EQUIPMENT-NAME__
+        - name: interface-name
+          in: query
+          description:
+          required: false
+          type: string
         - name: prov-status
           in: query
-          description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems.
+          description:
           required: false
           type: string
   /network/vpls-pes/vpls-pe/{equipment-name}/lag-interfaces/lag-interface/{interface-name}/relationship-list/relationship:
@@ -21189,14 +24075,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
+          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"
@@ -21220,11 +24108,13 @@ 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__
   /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:
@@ -21245,24 +24135,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
+          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/NetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlan.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -21286,21 +24180,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__
   /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:
@@ -21321,29 +24219,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-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/NetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -21367,26 +24270,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__
   /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:
@@ -21401,7 +24309,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:
@@ -21409,88 +24317,39 @@ 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
-        - 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: 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: __L3-INTERFACE-IPV4-ADDRESS__
     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
+      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
@@ -21506,38 +24365,54 @@ 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"
-    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: UpdateNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList
       consumes:
         - application/json
         - application/xml
@@ -21552,37 +24427,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-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 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: deleteNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList
       consumes:
         - application/json
         - application/xml
@@ -21597,38 +24478,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
-        - name: l3-interface-ipv6-address
+          example: __VLAN-INTERFACE__
+        - name: l3-interface-ipv4-address
           in: path
           description: IP address
           required: true
           type: string
-        - name: body
-          in: body
-          description: relationship object that needs to be created or updated
+          example: __L3-INTERFACE-IPV4-ADDRESS__
+        - name: resource-version
+          in: query
+          description: resource-version for concurrency
           required: true
-          schema:
-            $ref: "#/definitions/relationship"
-    delete:
+          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:
       tags:
         - Network
-      summary: delete an existing relationship
-      description: delete an existing relationship
-      operationId: deleteNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressListRelationshipListRelationship
+      summary: see node definition for valid relationships
+      operationId: createOrUpdateNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressListRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -21643,131 +24528,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
-  /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: getNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList
-      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: 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: 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: __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/NetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList.json)
           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
-        - 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:
+          schema:
+            $ref: "#/definitions/relationship"
+    delete:
       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
+      summary: delete an existing relationship
+      description: delete an existing relationship
+      operationId: deleteNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressListRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -21782,32 +24579,194 @@ 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__
+  /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: getNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList
+      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: 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__
+    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: createOrUpdateNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList
+      consumes:
+        - 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
+          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 updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/l3-interface-ipv6-address-list"
     delete:
       tags:
         - Network
@@ -21828,26 +24787,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: resource-version
           in: query
           description: resource-version for concurrency
@@ -21867,7 +24831,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:
@@ -21875,67 +24839,33 @@ 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
-        - 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: 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
+          example: __VLAN-INTERFACE__
     put:
       tags:
         - Network
       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: createOrUpdateNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlan
       consumes:
         - application/json
@@ -21951,27 +24881,87 @@ 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: 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/NetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlan.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: UpdateNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlan
+      consumes:
+        - 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: body
+          in: body
+          description: vlan object that needs to be updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/vlan"
     delete:
       tags:
         - Network
@@ -21992,21 +24982,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: resource-version
           in: query
           description: resource-version for concurrency
@@ -22026,7 +25020,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:
@@ -22034,44 +25028,33 @@ 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: 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
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
           in: query
-          description: ID of interface
+          description:
           required: false
           type: string
-        - name: macaddr
+        - name: vlan-id-inner
           in: query
-          description: MAC address for the interface
+          description:
           required: false
-          type: string
-        - name: network-name
+          type: integer
+          format: int64
+        - name: vpn-key
           in: query
-          description: Name of the network
+          description:
           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:
@@ -22094,24 +25077,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
+          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/NetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfsSriovVf.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -22135,21 +25122,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: 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:
@@ -22164,7 +25155,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:
@@ -22172,76 +25163,33 @@ 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
-        - 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
+          example: __PCI-ID__
     put:
       tags:
         - Network
       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: createOrUpdateNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfsSriovVf
       consumes:
         - application/json
@@ -22257,27 +25205,87 @@ 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: 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/NetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfsSriovVf.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: UpdateNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfsSriovVf
+      consumes:
+        - 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: 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 updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/sriov-vf"
     delete:
       tags:
         - Network
@@ -22298,21 +25306,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: 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
@@ -22332,7 +25344,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:
@@ -22340,44 +25352,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
-        - 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
+          example: __INTERFACE-NAME__
+        - name: pci-id
           in: query
-          description: ID of interface
+          description:
           required: false
           type: string
-        - name: interface-role
+        - name: vf-vlan-filter
           in: query
-          description: Role assigned to this Interface, should use values as defined in ECOMP Yang models.
+          description:
           required: false
           type: string
-        - name: interface-id
+        - name: vf-mac-filter
           in: query
-          description: ID of interface
+          description:
           required: false
           type: string
-        - name: macaddr
+        - name: vf-vlan-strip
           in: query
-          description: MAC address for the interface
+          description:
           required: false
-          type: string
-        - name: network-name
+          type: boolean
+        - name: neutron-network-id
           in: query
-          description: Name of the network
+          description:
           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:
@@ -22400,19 +25410,22 @@ 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: 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/NetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterface.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -22436,16 +25449,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__
   /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:
@@ -22466,24 +25482,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
+          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"
@@ -22507,21 +25527,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: 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:
@@ -22536,7 +25560,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:
@@ -22544,72 +25568,33 @@ 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: l3-interface-ipv4-address
           in: path
           description: IP address
           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
-        - 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: __L3-INTERFACE-IPV4-ADDRESS__
     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
+      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
@@ -22625,27 +25610,87 @@ 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: 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/NetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList.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: UpdateNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList
+      consumes:
+        - 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: 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 updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/l3-interface-ipv4-address-list"
     delete:
       tags:
         - Network
@@ -22666,21 +25711,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: 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
@@ -22706,24 +25755,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
+          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"
@@ -22747,21 +25800,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: 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:
@@ -22776,7 +25833,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:
@@ -22784,72 +25841,33 @@ 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: l3-interface-ipv6-address
           in: path
           description: IP address
           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
-        - 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: __L3-INTERFACE-IPV6-ADDRESS__
     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
+      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
@@ -22865,27 +25883,87 @@ 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: 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/NetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList.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: UpdateNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList
+      consumes:
+        - 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: 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 updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/l3-interface-ipv6-address-list"
     delete:
       tags:
         - Network
@@ -22906,21 +25984,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: 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
@@ -22940,7 +26022,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:
@@ -22948,51 +26030,27 @@ 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: 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
+          example: __INTERFACE-NAME__
     put:
       tags:
         - Network
       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: createOrUpdateNetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterface
       consumes:
         - application/json
@@ -23008,22 +26066,75 @@ 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: 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/NetworkVplsPesVplsPeLagInterfacesLagInterfaceLInterfacesLInterface.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: 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 updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/l-interface"
     delete:
       tags:
         - Network
@@ -23044,16 +26155,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: resource-version
           in: query
           description: resource-version for concurrency
@@ -23073,7 +26187,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:
@@ -23081,24 +26195,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
-        - name: prov-status
+          example: __INTERFACE-NAME__
+        - name: interface-name
           in: query
-          description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems.
+          description:
           required: false
           type: string
         - name: interface-id
           in: query
-          description: ID of interface
+          description:
           required: false
           type: string
-        - name: interface-role
+        - name: macaddr
+          in: query
+          description:
+          required: false
+          type: string
+        - name: network-name
           in: query
-          description: Role assigned to this Interface, should use values as defined in ECOMP Yang models.
+          description:
           required: false
           type: string
   /network/vpls-pes/vpls-pe/{equipment-name}/lag-interfaces/lag-interface/{interface-name}:
@@ -23115,7 +26236,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:
@@ -23123,31 +26244,21 @@ 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
-          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
+          example: __INTERFACE-NAME__
     put:
       tags:
         - Network
       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: createOrUpdateNetworkVplsPesVplsPeLagInterfacesLagInterface
       consumes:
         - application/json
@@ -23163,17 +26274,63 @@ 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: 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/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
+          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: lag-interface object that needs to be updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/lag-interface"
     delete:
       tags:
         - Network
@@ -23194,11 +26351,13 @@ 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: resource-version
           in: query
           description: resource-version for concurrency
@@ -23218,7 +26377,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:
@@ -23226,9 +26385,20 @@ paths:
           in: path
           required: true
           type: string
-        - name: prov-status
+          example: __EQUIPMENT-NAME__
+        - name: interface-name
           in: query
-          description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems.
+          description:
+          required: false
+          type: string
+        - name: interface-id
+          in: query
+          description:
+          required: false
+          type: string
+        - name: interface-role
+          in: query
+          description:
           required: false
           type: string
   /network/vpls-pes/vpls-pe/{equipment-name}:
@@ -23245,7 +26415,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/vpls-pe"
+              $ref: "#/getDefinitions/vpls-pe"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -23253,16 +26423,15 @@ 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
-          type: string
+          example: __EQUIPMENT-NAME__
     put:
       tags:
         - Network
       summary: create or update an existing vpls-pe
-      description: 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
@@ -23278,12 +26447,51 @@ paths:
           in: path
           required: true
           type: string
+          example: __EQUIPMENT-NAME__
         - name: body
           in: body
-          description: vpls-pe object that needs to be created or updated
+          description: vpls-pe object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVplsPesVplsPe.json)
           required: true
           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
+          required: true
+          type: string
+          example: __EQUIPMENT-NAME__
+        - name: body
+          in: body
+          description: vpls-pe object that needs to be updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/vpls-pe"
     delete:
       tags:
         - Network
@@ -23304,6 +26512,7 @@ paths:
           in: path
           required: true
           type: string
+          example: __EQUIPMENT-NAME__
         - name: resource-version
           in: query
           description: resource-version for concurrency
@@ -23323,9 +26532,20 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/vpls-pes"
+              $ref: "#/getDefinitions/vpls-pes"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: equipment-name
+          in: query
+          description:
+          required: false
+          type: string
+        - name: prov-status
+          in: query
+          description:
+          required: false
+          type: string
   /network/multicast-configurations/multicast-configuration/{multicast-configuration-id}/relationship-list/relationship:
     put:
       tags:
@@ -23347,9 +26567,10 @@ paths:
           description: Unique id of multicast configuration.
           required: true
           type: string
+          example: __MULTICAST-CONFIGURATION-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/NetworkMulticastConfigurationsMulticastConfiguration.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -23374,6 +26595,7 @@ paths:
           description: Unique id of multicast configuration.
           required: true
           type: string
+          example: __MULTICAST-CONFIGURATION-ID__
   /network/multicast-configurations/multicast-configuration/{multicast-configuration-id}:
     get:
       tags:
@@ -23388,7 +26610,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/multicast-configuration"
+              $ref: "#/getDefinitions/multicast-configuration"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -23397,11 +26619,15 @@ paths:
           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
+      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
@@ -23418,12 +26644,52 @@ paths:
           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
+          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 updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/multicast-configuration"
     delete:
       tags:
         - Network
@@ -23445,6 +26711,7 @@ paths:
           description: Unique id of multicast configuration.
           required: true
           type: string
+          example: __MULTICAST-CONFIGURATION-ID__
         - name: resource-version
           in: query
           description: resource-version for concurrency
@@ -23464,9 +26731,15 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/multicast-configurations"
+              $ref: "#/getDefinitions/multicast-configurations"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: multicast-configuration-id
+          in: query
+          description:
+          required: false
+          type: string
   /network/vces/vce/{vnf-id}/port-groups/port-group/{interface-id}/cvlan-tags/cvlan-tag-entry/{cvlan-tag}/relationship-list/relationship:
     put:
       tags:
@@ -23488,20 +26761,23 @@ 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: 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
+          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"
@@ -23526,17 +26802,20 @@ 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: 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:
@@ -23551,7 +26830,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/cvlan-tag-entry"
+              $ref: "#/getDefinitions/cvlan-tag-entry"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -23560,77 +26839,28 @@ 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: cvlan-tag
           in: path
           description: See mis-na-virtualization-platform.yang
           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
-          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
-          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
+          example: __CVLAN-TAG__
     put:
       tags:
         - Network
       summary: create or update an existing cvlan-tag-entry
-      description: 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
@@ -23647,23 +26877,78 @@ 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: 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: cvlan-tag-entry object that needs to be created or updated
+          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: cvlan-tag-entry object that needs to be updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/cvlan-tag-entry"
     delete:
       tags:
         - Network
@@ -23685,17 +26970,20 @@ 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: cvlan-tag
           in: path
           description: See mis-na-virtualization-platform.yang
           required: true
           type: integer
           format: int64
+          example: __CVLAN-TAG__
         - name: resource-version
           in: query
           description: resource-version for concurrency
@@ -23715,7 +27003,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/cvlan-tags"
+              $ref: "#/getDefinitions/cvlan-tags"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -23724,66 +27012,19 @@ 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
-        - 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
-          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
+          example: __INTERFACE-ID__
+        - name: cvlan-tag
           in: query
-          description: Heat stack id corresponding to this instance, managed by MSO
+          description:
           required: false
-          type: string
+          type: integer
+          format: int64
   /network/vces/vce/{vnf-id}/port-groups/port-group/{interface-id}/relationship-list/relationship:
     put:
       tags:
@@ -23805,14 +27046,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"
@@ -23837,11 +27080,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__
   /network/vces/vce/{vnf-id}/port-groups/port-group/{interface-id}:
     get:
       tags:
@@ -23856,7 +27101,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/port-group"
+              $ref: "#/getDefinitions/port-group"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -23865,71 +27110,21 @@ 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
-        - 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
-          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
+          example: __INTERFACE-ID__
     put:
       tags:
         - Network
       summary: create or update an existing port-group
-      description: 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
@@ -23946,17 +27141,64 @@ 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: port-group 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/port-group"
+    patch:
+      tags:
+        - Network
+      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
+      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: body
+          in: body
+          description: port-group object that needs to be updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/port-group"
     delete:
       tags:
         - Network
@@ -23978,11 +27220,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: resource-version
           in: query
           description: resource-version for concurrency
@@ -24002,7 +27246,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/port-groups"
+              $ref: "#/getDefinitions/port-groups"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -24011,44 +27255,25 @@ 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
+          example: __VNF-ID__
+        - name: interface-id
           in: query
-          description: Unique identifier of service, does not strictly map to ASDC services, SOON TO BE DEPRECATED.
+          description:
           required: false
           type: string
-        - name: regional-resource-zone
+        - name: port-group-id
           in: query
-          description: Regional way of organizing pservers, source of truth should define values
+          description:
           required: false
           type: string
-        - name: prov-status
+        - name: switch-name
           in: query
-          description: Trigger for operational monitoring of this resource by Service Assurance systems.
+          description:
           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.
+          description:
           required: false
           type: string
   /network/vces/vce/{vnf-id}/licenses/license/{group-uuid}/{resource-uuid}/relationship-list/relationship:
@@ -24072,19 +27297,22 @@ paths:
           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: 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"
@@ -24109,16 +27337,19 @@ paths:
           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__
   /network/vces/vce/{vnf-id}/licenses/license/{group-uuid}/{resource-uuid}:
     get:
       tags:
@@ -24133,7 +27364,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/license"
+              $ref: "#/getDefinitions/license"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -24142,61 +27373,27 @@ paths:
           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
-        - 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
+          example: __RESOURCE-UUID__
     put:
       tags:
         - Network
       summary: create or update an existing license
-      description: 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
@@ -24213,22 +27410,76 @@ paths:
           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
+          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/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 updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/license"
     delete:
       tags:
         - Network
@@ -24250,16 +27501,19 @@ paths:
           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
@@ -24279,7 +27533,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/licenses"
+              $ref: "#/getDefinitions/licenses"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -24288,44 +27542,15 @@ 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 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
+          example: __VNF-ID__
+        - name: group-uuid
           in: query
-          description: Heat stack id corresponding to this instance, managed by MSO
+          description:
           required: false
           type: string
-        - name: vpe-id
+        - name: resource-uuid
           in: query
-          description: Unique ID of VPE connected to this VCE.
+          description:
           required: false
           type: string
   /network/vces/vce/{vnf-id}/entitlements/entitlement/{group-uuid}/{resource-uuid}/relationship-list/relationship:
@@ -24349,19 +27574,22 @@ paths:
           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/NetworkVcesVceEntitlementsEntitlement.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -24386,16 +27614,19 @@ paths:
           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__
   /network/vces/vce/{vnf-id}/entitlements/entitlement/{group-uuid}/{resource-uuid}:
     get:
       tags:
@@ -24410,7 +27641,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/entitlement"
+              $ref: "#/getDefinitions/entitlement"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -24419,61 +27650,27 @@ paths:
           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
-        - 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
+          example: __RESOURCE-UUID__
     put:
       tags:
         - Network
       summary: create or update an existing entitlement
-      description: 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
@@ -24490,22 +27687,76 @@ paths:
           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
+          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/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 updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/entitlement"
     delete:
       tags:
         - Network
@@ -24527,16 +27778,19 @@ paths:
           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: resource-version
           in: query
           description: resource-version for concurrency
@@ -24556,7 +27810,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/entitlements"
+              $ref: "#/getDefinitions/entitlements"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -24565,44 +27819,15 @@ 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 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
+          example: __VNF-ID__
+        - name: group-uuid
           in: query
-          description: Heat stack id corresponding to this instance, managed by MSO
+          description:
           required: false
           type: string
-        - name: vpe-id
+        - name: resource-uuid
           in: query
-          description: Unique ID of VPE connected to this VCE.
+          description:
           required: false
           type: string
   /network/vces/vce/{vnf-id}/relationship-list/relationship:
@@ -24626,9 +27851,10 @@ paths:
           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"
@@ -24653,6 +27879,7 @@ paths:
           description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
+          example: __VNF-ID__
   /network/vces/vce/{vnf-id}:
     get:
       tags:
@@ -24667,7 +27894,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/vce"
+              $ref: "#/getDefinitions/vce"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -24676,51 +27903,15 @@ 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 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
+          example: __VNF-ID__
     put:
       tags:
         - Network
       summary: create or update an existing vce
-      description: 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
@@ -24737,12 +27928,52 @@ paths:
           description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
+          example: __VNF-ID__
         - name: body
           in: body
-          description: vce object that needs to be created or updated
+          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: Unique id of VNF.  This is unique across the graph.
+          required: true
+          type: string
+          example: __VNF-ID__
+        - name: body
+          in: body
+          description: vce object that needs to be updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/vce"
     delete:
       tags:
         - Network
@@ -24764,6 +27995,7 @@ paths:
           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
@@ -24783,9 +28015,55 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/vces"
+              $ref: "#/getDefinitions/vces"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: vnf-id
+          in: query
+          description:
+          required: false
+          type: string
+        - name: vnf-name
+          in: query
+          description:
+          required: false
+          type: string
+        - name: vnf-name2
+          in: query
+          description:
+          required: false
+          type: string
+        - name: vnf-type
+          in: query
+          description:
+          required: false
+          type: string
+        - name: service-id
+          in: query
+          description:
+          required: false
+          type: string
+        - name: regional-resource-zone
+          in: query
+          description:
+          required: false
+          type: string
+        - name: prov-status
+          in: query
+          description:
+          required: false
+          type: string
+        - name: heat-stack-id
+          in: query
+          description:
+          required: false
+          type: string
+        - name: vpe-id
+          in: query
+          description:
+          required: false
+          type: string
   /network/vnfcs/vnfc/{vnfc-name}/relationship-list/relationship:
     put:
       tags:
@@ -24807,9 +28085,10 @@ paths:
           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: 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"
@@ -24834,6 +28113,7 @@ paths:
           description: Unique ID of vnfc.
           required: true
           type: string
+          example: __VNFC-NAME__
   /network/vnfcs/vnfc/{vnfc-name}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}/relationship-list/relationship:
     put:
       tags:
@@ -24855,14 +28135,16 @@ paths:
           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"
@@ -24887,11 +28169,13 @@ paths:
           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__
   /network/vnfcs/vnfc/{vnfc-name}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}:
     get:
       tags:
@@ -24906,7 +28190,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:
@@ -24915,75 +28199,21 @@ paths:
           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
-        - 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
-        - 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: __L3-INTERFACE-IPV4-ADDRESS__
     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
+      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
@@ -25000,17 +28230,64 @@ paths:
           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-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/NetworkVnfcsVnfcL3InterfaceIpv4AddressList.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: UpdateNetworkVnfcsVnfcL3InterfaceIpv4AddressList
+      consumes:
+        - 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
+          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-interface-ipv4-address-list object that needs to be updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/l3-interface-ipv4-address-list"
     delete:
       tags:
         - Network
@@ -25032,11 +28309,13 @@ paths:
           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
@@ -25063,14 +28342,16 @@ paths:
           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"
@@ -25095,11 +28376,13 @@ paths:
           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__
   /network/vnfcs/vnfc/{vnfc-name}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}:
     get:
       tags:
@@ -25114,7 +28397,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:
@@ -25123,75 +28406,21 @@ paths:
           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
-        - 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
-        - 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: __L3-INTERFACE-IPV6-ADDRESS__
     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
+      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
@@ -25208,17 +28437,64 @@ paths:
           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: 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/NetworkVnfcsVnfcL3InterfaceIpv6AddressList.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: UpdateNetworkVnfcsVnfcL3InterfaceIpv6AddressList
+      consumes:
+        - 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
+          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: l3-interface-ipv6-address-list object that needs to be updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/l3-interface-ipv6-address-list"
     delete:
       tags:
         - Network
@@ -25240,11 +28516,13 @@ paths:
           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: resource-version
           in: query
           description: resource-version for concurrency
@@ -25264,7 +28542,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/vnfc"
+              $ref: "#/getDefinitions/vnfc"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -25273,54 +28551,15 @@ paths:
           description: Unique ID of vnfc.
           required: true
           type: string
-        - 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
+          example: __VNFC-NAME__
     put:
       tags:
         - Network
       summary: create or update an existing vnfc
-      description: 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
@@ -25337,12 +28576,52 @@ paths:
           description: Unique ID of vnfc.
           required: true
           type: string
+          example: __VNFC-NAME__
         - name: body
           in: body
-          description: vnfc object that needs to be created or updated
+          description: vnfc object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkVnfcsVnfc.json)
           required: true
           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: Unique ID of vnfc.
+          required: true
+          type: string
+          example: __VNFC-NAME__
+        - name: body
+          in: body
+          description: vnfc object that needs to be updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/vnfc"
     delete:
       tags:
         - Network
@@ -25364,6 +28643,7 @@ paths:
           description: Unique ID of vnfc.
           required: true
           type: string
+          example: __VNFC-NAME__
         - name: resource-version
           in: query
           description: resource-version for concurrency
@@ -25383,9 +28663,60 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/vnfcs"
+              $ref: "#/getDefinitions/vnfcs"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: vnfc-name
+          in: query
+          description:
+          required: false
+          type: string
+        - name: nfc-naming-code
+          in: query
+          description:
+          required: false
+          type: string
+        - name: nfc-function
+          in: query
+          description:
+          required: false
+          type: string
+        - name: prov-status
+          in: query
+          description:
+          required: false
+          type: string
+        - name: ipaddress-v4-oam-vip
+          in: query
+          description:
+          required: false
+          type: string
+        - name: in-maint
+          in: query
+          description:
+          required: false
+          type: boolean
+        - name: is-closed-loop-disabled
+          in: query
+          description:
+          required: false
+          type: boolean
+        - name: group-notation
+          in: query
+          description:
+          required: false
+          type: string
+        - name: model-invariant-id
+          in: query
+          description:
+          required: false
+          type: string
+        - name: model-version-id
+          in: query
+          description:
+          required: false
+          type: string
   /network/l3-networks/l3-network/{network-id}/subnets/subnet/{subnet-id}/host-routes/host-route/{host-route-id}/relationship-list/relationship:
     put:
       tags:
@@ -25407,19 +28738,22 @@ paths:
           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: host-route-id
           in: path
           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"
@@ -25444,16 +28778,19 @@ paths:
           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: host-route-id
           in: path
           description: host-route id
           required: true
           type: string
+          example: __HOST-ROUTE-ID__
   /network/l3-networks/l3-network/{network-id}/subnets/subnet/{subnet-id}/host-routes/host-route/{host-route-id}:
     get:
       tags:
@@ -25468,7 +28805,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/host-route"
+              $ref: "#/getDefinitions/host-route"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -25477,71 +28814,27 @@ paths:
           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: host-route-id
           in: path
           description: host-route id
           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
-          type: string
-        - name: subnet-name
-          in: query
-          description: Name associated with the subnet.
-          required: false
-          type: string
+          example: __HOST-ROUTE-ID__
     put:
       tags:
         - Network
       summary: create or update an existing host-route
-      description: 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
@@ -25558,22 +28851,76 @@ paths:
           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: host-route-id
           in: path
           description: host-route id
           required: true
           type: string
+          example: __HOST-ROUTE-ID__
         - name: body
           in: body
-          description: host-route 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/host-route"
+    patch:
+      tags:
+        - Network
+      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
+      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__
+        - name: subnet-id
+          in: path
+          description: Subnet ID, should be UUID.
+          required: true
+          type: string
+          example: __SUBNET-ID__
+        - name: host-route-id
+          in: path
+          description: host-route id
+          required: true
+          type: string
+          example: __HOST-ROUTE-ID__
+        - name: body
+          in: body
+          description: host-route object that needs to be updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/host-route"
     delete:
       tags:
         - Network
@@ -25595,16 +28942,19 @@ paths:
           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: host-route-id
           in: path
           description: host-route id
           required: true
           type: string
+          example: __HOST-ROUTE-ID__
         - name: resource-version
           in: query
           description: resource-version for concurrency
@@ -25624,7 +28974,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/host-routes"
+              $ref: "#/getDefinitions/host-routes"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -25633,59 +28983,16 @@ paths:
           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
-        - 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
-        - name: subnet-name
+          example: __SUBNET-ID__
+        - name: host-route-id
           in: query
-          description: Name associated with the subnet.
+          description:
           required: false
           type: string
   /network/l3-networks/l3-network/{network-id}/subnets/subnet/{subnet-id}/relationship-list/relationship:
@@ -25709,14 +29016,16 @@ paths:
           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: 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/NetworkL3NetworksL3NetworkSubnetsSubnet.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -25741,11 +29050,13 @@ paths:
           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__
   /network/l3-networks/l3-network/{network-id}/subnets/subnet/{subnet-id}:
     get:
       tags:
@@ -25760,7 +29071,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/subnet"
+              $ref: "#/getDefinitions/subnet"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -25769,66 +29080,21 @@ paths:
           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
-        - 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
-        - name: subnet-name
-          in: query
-          description: Name associated with the subnet.
-          required: false
-          type: string
+          example: __SUBNET-ID__
     put:
       tags:
         - Network
       summary: create or update an existing subnet
-      description: 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
@@ -25845,17 +29111,64 @@ paths:
           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: subnet object that needs to be created or updated
+          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: 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: subnet object that needs to be updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/subnet"
     delete:
       tags:
         - Network
@@ -25877,11 +29190,13 @@ paths:
           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: resource-version
           in: query
           description: resource-version for concurrency
@@ -25901,7 +29216,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/subnets"
+              $ref: "#/getDefinitions/subnets"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -25910,49 +29225,15 @@ paths:
           description: Network ID, should be uuid. Unique across A&AI.
           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
+          example: __NETWORK-ID__
+        - name: subnet-id
           in: query
-          description: the ASDC data dictionary widget model. This maps directly to the A&AI widget.
+          description:
           required: false
           type: string
-        - name: widget-model-version
+        - name: subnet-name
           in: query
-          description: the ASDC data dictionary version of the widget model.This maps directly to the A&AI version of the widget.
+          description:
           required: false
           type: string
   /network/l3-networks/l3-network/{network-id}/ctag-assignments/ctag-assignment/{vlan-id-inner}/relationship-list/relationship:
@@ -25976,15 +29257,17 @@ paths:
           description: Network ID, should be uuid. Unique across A&AI.
           required: true
           type: string
+          example: __NETWORK-ID__
         - name: vlan-id-inner
           in: path
           description: id.
           required: true
           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"
@@ -26009,12 +29292,14 @@ paths:
           description: Network ID, should be uuid. Unique across A&AI.
           required: true
           type: string
+          example: __NETWORK-ID__
         - name: vlan-id-inner
           in: path
           description: id.
           required: true
           type: integer
           format: int64
+          example: __VLAN-ID-INNER__
   /network/l3-networks/l3-network/{network-id}/ctag-assignments/ctag-assignment/{vlan-id-inner}:
     get:
       tags:
@@ -26029,7 +29314,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/ctag-assignment"
+              $ref: "#/getDefinitions/ctag-assignment"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -26038,62 +29323,22 @@ paths:
           description: Network ID, should be uuid. Unique across A&AI.
           required: true
           type: string
+          example: __NETWORK-ID__
         - name: vlan-id-inner
           in: path
           description: id.
           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
-          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
+          example: __VLAN-ID-INNER__
     put:
       tags:
         - Network
       summary: create or update an existing ctag-assignment
-      description: 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
@@ -26110,18 +29355,66 @@ paths:
           description: Network ID, should be uuid. Unique across A&AI.
           required: true
           type: string
+          example: __NETWORK-ID__
         - name: vlan-id-inner
           in: path
           description: id.
           required: true
           type: integer
           format: int64
+          example: __VLAN-ID-INNER__
         - name: body
           in: body
-          description: ctag-assignment 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/ctag-assignment"
+    patch:
+      tags:
+        - Network
+      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
+      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__
+        - name: vlan-id-inner
+          in: path
+          description: id.
+          required: true
+          type: integer
+          format: int64
+          example: __VLAN-ID-INNER__
+        - name: body
+          in: body
+          description: ctag-assignment object that needs to be updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/ctag-assignment"
     delete:
       tags:
         - Network
@@ -26143,12 +29436,14 @@ paths:
           description: Network ID, should be uuid. Unique across A&AI.
           required: true
           type: string
+          example: __NETWORK-ID__
         - name: vlan-id-inner
           in: path
           description: id.
           required: true
           type: integer
           format: int64
+          example: __VLAN-ID-INNER__
         - name: resource-version
           in: query
           description: resource-version for concurrency
@@ -26168,7 +29463,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/ctag-assignments"
+              $ref: "#/getDefinitions/ctag-assignments"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -26177,51 +29472,13 @@ paths:
           description: Network ID, should be uuid. Unique across A&AI.
           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
+          example: __NETWORK-ID__
+        - 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:
           required: false
-          type: string
+          type: integer
+          format: int64
   /network/l3-networks/l3-network/{network-id}/segmentation-assignments/segmentation-assignment/{segmentation-id}/relationship-list/relationship:
     put:
       tags:
@@ -26243,14 +29500,16 @@ paths:
           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: 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"
@@ -26275,11 +29534,13 @@ paths:
           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__
   /network/l3-networks/l3-network/{network-id}/segmentation-assignments/segmentation-assignment/{segmentation-id}:
     get:
       tags:
@@ -26294,7 +29555,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/segmentation-assignment"
+              $ref: "#/getDefinitions/segmentation-assignment"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -26303,61 +29564,21 @@ paths:
           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
-        - 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
+          example: __SEGMENTATION-ID__
     put:
       tags:
         - Network
       summary: create or update an existing segmentation-assignment
-      description: 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
@@ -26374,17 +29595,64 @@ paths:
           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: segmentation-assignment object that needs to be created or updated
+          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: 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: segmentation-assignment object that needs to be updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/segmentation-assignment"
     delete:
       tags:
         - Network
@@ -26406,11 +29674,13 @@ paths:
           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: resource-version
           in: query
           description: resource-version for concurrency
@@ -26430,7 +29700,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/segmentation-assignments"
+              $ref: "#/getDefinitions/segmentation-assignments"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -26439,49 +29709,10 @@ paths:
           description: Network ID, should be uuid. Unique across A&AI.
           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
+          example: __NETWORK-ID__
+        - name: segmentation-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:
           required: false
           type: string
   /network/l3-networks/l3-network/{network-id}/relationship-list/relationship:
@@ -26505,9 +29736,10 @@ paths:
           description: Network ID, should be uuid. Unique across A&AI.
           required: true
           type: string
+          example: __NETWORK-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/NetworkL3NetworksL3Network.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -26532,6 +29764,7 @@ paths:
           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:
@@ -26546,7 +29779,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/l3-network"
+              $ref: "#/getDefinitions/l3-network"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -26555,56 +29788,15 @@ paths:
           description: Network ID, should be uuid. Unique across A&AI.
           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
-          type: string
+          example: __NETWORK-ID__
     put:
       tags:
         - Network
       summary: create or update an existing l3-network
-      description: 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
@@ -26621,12 +29813,52 @@ paths:
           description: Network ID, should be uuid. Unique across A&AI.
           required: true
           type: string
+          example: __NETWORK-ID__
         - name: body
           in: body
-          description: l3-network object that needs to be created or updated
+          description: l3-network object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkL3NetworksL3Network.json)
           required: true
           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: Network ID, should be uuid. Unique across A&AI.
+          required: true
+          type: string
+          example: __NETWORK-ID__
+        - name: body
+          in: body
+          description: l3-network object that needs to be updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/l3-network"
     delete:
       tags:
         - Network
@@ -26648,6 +29880,7 @@ paths:
           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
@@ -26667,9 +29900,60 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/l3-networks"
+              $ref: "#/getDefinitions/l3-networks"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: network-id
+          in: query
+          description:
+          required: false
+          type: string
+        - name: network-name
+          in: query
+          description:
+          required: false
+          type: string
+        - name: network-role
+          in: query
+          description:
+          required: false
+          type: string
+        - name: service-id
+          in: query
+          description:
+          required: false
+          type: string
+        - name: heat-stack-id
+          in: query
+          description:
+          required: false
+          type: string
+        - name: contrail-network-fqdn
+          in: query
+          description:
+          required: false
+          type: string
+        - name: model-invariant-id
+          in: query
+          description:
+          required: false
+          type: string
+        - name: model-version-id
+          in: query
+          description:
+          required: false
+          type: string
+        - name: widget-model-id
+          in: query
+          description:
+          required: false
+          type: string
+        - name: widget-model-version
+          in: query
+          description:
+          required: false
+          type: string
   /network/network-policies/network-policy/{network-policy-id}/relationship-list/relationship:
     put:
       tags:
@@ -26691,9 +29975,10 @@ paths:
           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"
@@ -26718,6 +30003,7 @@ paths:
           description: UUID representing unique key to this instance
           required: true
           type: string
+          example: __NETWORK-POLICY-ID__
   /network/network-policies/network-policy/{network-policy-id}:
     get:
       tags:
@@ -26732,7 +30018,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/network-policy"
+              $ref: "#/getDefinitions/network-policy"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -26741,16 +30027,15 @@ paths:
           description: UUID representing unique key to this instance
           required: true
           type: string
-        - name: network-policy-fqdn
-          in: query
-          description: Contrail FQDN for the policy
-          required: false
-          type: string
+          example: __NETWORK-POLICY-ID__
     put:
       tags:
         - Network
       summary: create or update an existing network-policy
-      description: 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
@@ -26767,12 +30052,52 @@ paths:
           description: UUID representing unique key to this instance
           required: true
           type: string
+          example: __NETWORK-POLICY-ID__
         - name: body
           in: body
-          description: network-policy object that needs to be created or updated
+          description: network-policy object that needs to be created or updated. [Valid relationship examples shown here](apidocs/relations/v11/NetworkNetworkPoliciesNetworkPolicy.json)
           required: true
           schema:
             $ref: "#/definitions/network-policy"
+    patch:
+      tags:
+        - Network
+      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
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: network-policy-id
+          in: path
+          description: UUID representing unique key to this instance
+          required: true
+          type: string
+          example: __NETWORK-POLICY-ID__
+        - name: body
+          in: body
+          description: network-policy object that needs to be updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/network-policy"
     delete:
       tags:
         - Network
@@ -26794,6 +30119,7 @@ paths:
           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
@@ -26813,9 +30139,20 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/network-policies"
+              $ref: "#/getDefinitions/network-policies"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: network-policy-id
+          in: query
+          description:
+          required: false
+          type: string
+        - name: network-policy-fqdn
+          in: query
+          description:
+          required: false
+          type: string
   /network/generic-vnfs/generic-vnf/{vnf-id}/relationship-list/relationship:
     put:
       tags:
@@ -26837,9 +30174,10 @@ paths:
           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/NetworkGenericVnfsGenericVnf.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -26864,6 +30202,7 @@ paths:
           description: Unique id of VNF.  This is unique across the graph.
           required: true
           type: string
+          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:
@@ -26885,19 +30224,22 @@ 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 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"
@@ -26922,16 +30264,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 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/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:
@@ -26953,24 +30298,28 @@ 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 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"
@@ -26995,21 +30344,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 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}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}:
     get:
       tags:
@@ -27024,7 +30377,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:
@@ -27033,151 +30386,33 @@ 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 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: 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: 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: __L3-INTERFACE-IPV4-ADDRESS__
     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
+      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
@@ -27194,27 +30429,88 @@ 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 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/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 updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/l3-interface-ipv4-address-list"
     delete:
       tags:
         - Network
@@ -27236,21 +30532,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 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
@@ -27277,24 +30577,28 @@ 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 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"
@@ -27319,21 +30623,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 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}/l-interfaces/l-interface/{interface-name}/vlans/vlan/{vlan-interface}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}:
     get:
       tags:
@@ -27348,7 +30656,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:
@@ -27357,151 +30665,33 @@ 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 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: 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: 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: __L3-INTERFACE-IPV6-ADDRESS__
     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
+      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
@@ -27518,27 +30708,88 @@ 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 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/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 updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/l3-interface-ipv6-address-list"
     delete:
       tags:
         - Network
@@ -27560,21 +30811,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 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
@@ -27594,7 +30849,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:
@@ -27603,130 +30858,27 @@ 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 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: 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: vpn-key
-          in: query
-          description: This indicates the customers VPN ID associated with this vlan
-          required: false
-          type: string
+          example: __VLAN-INTERFACE__
     put:
       tags:
         - Network
       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: createOrUpdateNetworkGenericVnfsGenericVnfLInterfacesLInterfaceVlansVlan
       consumes:
         - application/json
@@ -27743,22 +30895,76 @@ 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 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/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 updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/vlan"
     delete:
       tags:
         - Network
@@ -27780,16 +30986,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 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
@@ -27809,7 +31018,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:
@@ -27818,107 +31027,27 @@ 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 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
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
           in: query
-          description: ID of interface
+          description:
           required: false
           type: string
-        - name: macaddr
+        - name: vlan-id-inner
           in: query
-          description: MAC address for the interface
+          description:
           required: false
-          type: string
-        - name: network-name
+          type: integer
+          format: int64
+        - name: vpn-key
           in: query
-          description: Name of the network
+          description:
           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:
@@ -27942,19 +31071,22 @@ 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 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"
@@ -27979,16 +31111,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 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/generic-vnfs/generic-vnf/{vnf-id}/l-interfaces/l-interface/{interface-name}/sriov-vfs/sriov-vf/{pci-id}:
     get:
       tags:
@@ -28003,7 +31138,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:
@@ -28012,139 +31147,27 @@ 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 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: 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: 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
+          example: __PCI-ID__
     put:
       tags:
         - Network
       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: createOrUpdateNetworkGenericVnfsGenericVnfLInterfacesLInterfaceSriovVfsSriovVf
       consumes:
         - application/json
@@ -28161,22 +31184,76 @@ 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 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/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 updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/sriov-vf"
     delete:
       tags:
         - Network
@@ -28198,16 +31275,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 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
@@ -28227,7 +31307,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:
@@ -28236,107 +31316,36 @@ 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 given to the interface
           required: true
           type: string
-        - name: vnf-name
+          example: __INTERFACE-NAME__
+        - name: pci-id
           in: query
-          description: Name of VNF.
+          description:
           required: false
           type: string
-        - name: vnf-name2
+        - name: vf-vlan-filter
           in: query
-          description: Alternate name of VNF.
+          description:
           required: false
           type: string
-        - name: vnf-type
+        - name: vf-mac-filter
           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:
           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
+        - name: vf-vlan-strip
           in: query
+          description:
           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
+        - name: neutron-network-id
           in: query
-          description: Name of the network
+          description:
           required: false
           type: string
   /network/generic-vnfs/generic-vnf/{vnf-id}/l-interfaces/l-interface/{interface-name}/relationship-list/relationship:
@@ -28360,14 +31369,16 @@ 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 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"
@@ -28392,11 +31403,13 @@ 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 given to the interface
           required: true
           type: string
+          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:
@@ -28418,19 +31431,22 @@ 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 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"
@@ -28455,16 +31471,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 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/generic-vnfs/generic-vnf/{vnf-id}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}:
     get:
       tags:
@@ -28479,7 +31498,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:
@@ -28488,135 +31507,27 @@ 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 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: 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
-          in: query
-          description: Neutron id of subnet that address belongs to
-          required: false
-          type: string
+          example: __L3-INTERFACE-IPV4-ADDRESS__
     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
+      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
@@ -28633,22 +31544,76 @@ 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 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/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 updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/l3-interface-ipv4-address-list"
     delete:
       tags:
         - Network
@@ -28670,16 +31635,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 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
@@ -28706,19 +31674,22 @@ 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 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"
@@ -28743,16 +31714,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 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/generic-vnfs/generic-vnf/{vnf-id}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}:
     get:
       tags:
@@ -28767,7 +31741,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:
@@ -28776,135 +31750,27 @@ 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 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: 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
-          in: query
-          description: Neutron id of subnet that address belongs to
-          required: false
-          type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
     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
+      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
@@ -28921,22 +31787,76 @@ 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 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/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 updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/l3-interface-ipv6-address-list"
     delete:
       tags:
         - Network
@@ -28958,16 +31878,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 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
@@ -28987,7 +31910,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:
@@ -28996,114 +31919,21 @@ 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 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
+          example: __INTERFACE-NAME__
     put:
       tags:
         - Network
       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: createOrUpdateNetworkGenericVnfsGenericVnfLInterfacesLInterface
       consumes:
         - application/json
@@ -29120,17 +31950,64 @@ 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 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"
+    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: UpdateNetworkGenericVnfsGenericVnfLInterfacesLInterface
+      consumes:
+        - 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: body
+          in: body
+          description: l-interface object that needs to be updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/l-interface"
     delete:
       tags:
         - Network
@@ -29152,11 +32029,13 @@ 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 given to the interface
           required: true
           type: string
+          example: __INTERFACE-NAME__
         - name: resource-version
           in: query
           description: resource-version for concurrency
@@ -29176,7 +32055,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:
@@ -29185,87 +32064,25 @@ 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
-          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
+          example: __VNF-ID__
+        - name: interface-name
           in: query
-          description: Generic description of the type of NF
+          description:
           required: false
           type: string
-        - name: nf-function
+        - name: interface-id
           in: query
-          description: English description of Network function that the specific VNF deployment is providing
+          description:
           required: false
           type: string
-        - name: nf-role
+        - name: macaddr
           in: query
-          description: role in the network that this model will be providing
+          description:
           required: false
           type: string
-        - name: nf-naming-code
+        - name: network-name
           in: query
-          description: string assigned to this model used for naming purposes
+          description:
           required: false
           type: string
   /network/generic-vnfs/generic-vnf/{vnf-id}/lag-interfaces/lag-interface/{interface-name}/relationship-list/relationship:
@@ -29289,14 +32106,16 @@ 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: 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/NetworkGenericVnfsGenericVnfLagInterfacesLagInterface.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -29321,11 +32140,13 @@ 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__
   /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:
@@ -29347,24 +32168,28 @@ 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: 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/NetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlan.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -29389,21 +32214,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: 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/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:
@@ -29425,29 +32254,34 @@ 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-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"
@@ -29472,26 +32306,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-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:
@@ -29506,7 +32345,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:
@@ -29515,167 +32354,103 @@ 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-ipv4-address
           in: path
           description: IP address
           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
+          example: __L3-INTERFACE-IPV4-ADDRESS__
+    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: createOrUpdateNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList
+      consumes:
+        - 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: 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
+          example: __VNF-ID__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
+          required: true
           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
-          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
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
           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
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
           type: string
-        - name: neutron-subnet-id
-          in: query
-          description: Neutron id of subnet that address belongs to
-          required: false
+          example: __VLAN-INTERFACE__
+        - name: l3-interface-ipv4-address
+          in: path
+          description: IP address
+          required: true
           type: string
-    put:
+          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/NetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList.json)
+          required: true
+          schema:
+            $ref: "#/definitions/l3-interface-ipv4-address-list"
+    patch:
       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
+      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
@@ -29691,32 +32466,37 @@ 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-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 updated.
           required: true
           schema:
-            $ref: "#/definitions/l3-interface-ipv4-address-list"
+            $ref: "#/patchDefinitions/l3-interface-ipv4-address-list"
     delete:
       tags:
         - Network
@@ -29738,26 +32518,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-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
@@ -29784,29 +32569,34 @@ 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: 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/NetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -29831,26 +32621,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__
   /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:
@@ -29865,7 +32660,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:
@@ -29874,167 +32669,103 @@ 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
-        - 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
-          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: __L3-INTERFACE-IPV6-ADDRESS__
+    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 of VNF.  This is unique across the graph.
+          required: true
           type: string
-        - name: network-name
-          in: query
-          description: Name of the network
-          required: false
+          example: __VNF-ID__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
+          required: true
           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
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
           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
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
           type: string
-        - name: neutron-subnet-id
-          in: query
-          description: Neutron id of subnet that address belongs to
-          required: false
+          example: __VLAN-INTERFACE__
+        - 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/NetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList.json)
+          required: true
+          schema:
+            $ref: "#/definitions/l3-interface-ipv6-address-list"
+    patch:
       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
+      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
@@ -30050,32 +32781,37 @@ 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: 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 updated.
           required: true
           schema:
-            $ref: "#/definitions/l3-interface-ipv6-address-list"
+            $ref: "#/patchDefinitions/l3-interface-ipv6-address-list"
     delete:
       tags:
         - Network
@@ -30097,26 +32833,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: resource-version
           in: query
           description: resource-version for concurrency
@@ -30136,7 +32877,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:
@@ -30145,145 +32886,33 @@ 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
-        - 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
-          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
+          example: __VLAN-INTERFACE__
     put:
       tags:
         - Network
       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: createOrUpdateNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlan
       consumes:
         - application/json
@@ -30300,27 +32929,88 @@ 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: 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/NetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlan.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: 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 updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/vlan"
     delete:
       tags:
         - Network
@@ -30342,21 +33032,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: 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
@@ -30376,7 +33070,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:
@@ -30385,122 +33079,33 @@ 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
-        - 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
-          in: query
-          description: Role assigned to this Interface, should use values as defined in ECOMP Yang models.
-          required: false
-          type: string
-        - name: interface-id
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
           in: query
-          description: ID of interface
+          description:
           required: false
           type: string
-        - name: macaddr
+        - name: vlan-id-inner
           in: query
-          description: MAC address for the interface
+          description:
           required: false
-          type: string
-        - name: network-name
+          type: integer
+          format: int64
+        - name: vpn-key
           in: query
-          description: Name of the network
+          description:
           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:
@@ -30524,24 +33129,28 @@ 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: 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"
@@ -30566,21 +33175,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: 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/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:
@@ -30595,7 +33208,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:
@@ -30604,155 +33217,91 @@ 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: pci-id
           in: path
           description: PCI ID used to identify the sriov-vf
           required: true
           type: string
-        - name: vnf-name
-          in: query
-          description: Name of VNF.
-          required: false
+          example: __PCI-ID__
+    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: createOrUpdateNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfsSriovVf
+      consumes:
+        - 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: vnf-name2
-          in: query
-          description: Alternate 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-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
-          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
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
           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
+          example: __INTERFACE-NAME__
+        - name: pci-id
+          in: path
+          description: PCI ID used to identify the sriov-vf
+          required: true
           type: string
-    put:
+          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/NetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfsSriovVf.json)
+          required: true
+          schema:
+            $ref: "#/definitions/sriov-vf"
+    patch:
       tags:
         - Network
-      summary: create or update an existing sriov-vf
-      description: create or update an existing sriov-vf
-      operationId: createOrUpdateNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfsSriovVf
+      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
@@ -30768,27 +33317,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: 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 updated.
           required: true
           schema:
-            $ref: "#/definitions/sriov-vf"
+            $ref: "#/patchDefinitions/sriov-vf"
     delete:
       tags:
         - Network
@@ -30810,21 +33363,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: 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
@@ -30844,7 +33401,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:
@@ -30853,122 +33410,42 @@ 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
-        - 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
+          example: __INTERFACE-NAME__
+        - name: pci-id
           in: query
-          description: Regional way of organizing pservers, source of truth should define values
+          description:
           required: false
           type: string
-        - name: prov-status
+        - name: vf-vlan-filter
           in: query
-          description: Trigger for operational monitoring of this resource by Service Assurance systems.
+          description:
           required: false
           type: string
-        - name: heat-stack-id
+        - name: vf-mac-filter
           in: query
-          description: Heat stack id corresponding to this instance, managed by MSO
+          description:
           required: false
           type: string
-        - name: in-maint
-          in: query
-          required: false
-          type: boolean
-        - name: is-closed-loop-disabled
+        - name: vf-vlan-strip
           in: query
+          description:
           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
-          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
+        - name: neutron-network-id
           in: query
-          description: Name of the network
+          description:
           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:
@@ -30992,19 +33469,22 @@ 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: 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"
@@ -31029,16 +33509,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__
   /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:
@@ -31060,24 +33543,28 @@ 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: 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"
@@ -31102,21 +33589,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: 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/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:
@@ -31131,7 +33622,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:
@@ -31140,150 +33631,33 @@ 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: l3-interface-ipv4-address
           in: path
           description: IP address
           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
-          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
+          example: __L3-INTERFACE-IPV4-ADDRESS__
     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
+      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
@@ -31300,27 +33674,88 @@ 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: 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"
+    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: UpdateNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList
+      consumes:
+        - 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: body
+          in: body
+          description: l3-interface-ipv4-address-list object that needs to be updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/l3-interface-ipv4-address-list"
     delete:
       tags:
         - Network
@@ -31342,21 +33777,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: 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
@@ -31383,24 +33822,28 @@ 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: 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"
@@ -31425,21 +33868,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: 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/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:
@@ -31454,7 +33901,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:
@@ -31463,150 +33910,33 @@ 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: l3-interface-ipv6-address
           in: path
           description: IP address
           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
-          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
+          example: __L3-INTERFACE-IPV6-ADDRESS__
     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
+      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
@@ -31623,27 +33953,88 @@ 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: 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 updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/l3-interface-ipv6-address-list"
     delete:
       tags:
         - Network
@@ -31665,21 +34056,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: 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
@@ -31699,7 +34094,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:
@@ -31708,130 +34103,79 @@ 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
-        - 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
+          example: __INTERFACE-NAME__
+    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: createOrUpdateNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterface
+      consumes:
+        - 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: service-id
-          in: query
-          description: Unique identifier of service, does not necessarily map to ASDC service models.  SOON TO BE DEPRECATED
-          required: false
+          example: __VNF-ID__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
+          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: __INTERFACE-NAME__
+        - 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 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
-          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:
+          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: create or update an existing l-interface
-      description: create or update an existing l-interface
-      operationId: createOrUpdateNetworkGenericVnfsGenericVnfLagInterfacesLagInterfaceLInterfacesLInterface
+      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
@@ -31847,22 +34191,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: 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 updated.
           required: true
           schema:
-            $ref: "#/definitions/l-interface"
+            $ref: "#/patchDefinitions/l-interface"
     delete:
       tags:
         - Network
@@ -31884,16 +34231,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: resource-version
           in: query
           description: resource-version for concurrency
@@ -31913,7 +34263,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:
@@ -31922,102 +34272,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
-        - 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
+          example: __INTERFACE-NAME__
+        - name: interface-name
           in: query
-          description: role in the network that this model will be providing
+          description:
           required: false
           type: string
-        - name: nf-naming-code
+        - name: interface-id
           in: query
-          description: string assigned to this model used for naming purposes
+          description:
           required: false
           type: string
-        - name: interface-id
+        - name: macaddr
           in: query
-          description: ID of interface
+          description:
           required: false
           type: string
-        - name: interface-role
+        - name: network-name
           in: query
-          description: Role assigned to this Interface, should use values as defined in ECOMP Yang models.
+          description:
           required: false
           type: string
   /network/generic-vnfs/generic-vnf/{vnf-id}/lag-interfaces/lag-interface/{interface-name}:
@@ -32034,7 +34313,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:
@@ -32043,109 +34322,21 @@ 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: 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
-          in: query
-          description: Role assigned to this Interface, should use values as defined in ECOMP Yang models.
-          required: false
-          type: string
+          example: __INTERFACE-NAME__
     put:
       tags:
         - Network
       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: createOrUpdateNetworkGenericVnfsGenericVnfLagInterfacesLagInterface
       consumes:
         - application/json
@@ -32162,17 +34353,64 @@ 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: 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/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: UpdateNetworkGenericVnfsGenericVnfLagInterfacesLagInterface
+      consumes:
+        - 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: body
+          in: body
+          description: lag-interface object that needs to be updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/lag-interface"
     delete:
       tags:
         - Network
@@ -32194,11 +34432,13 @@ 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: resource-version
           in: query
           description: resource-version for concurrency
@@ -32218,7 +34458,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:
@@ -32227,87 +34467,20 @@ 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
-          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
+          example: __VNF-ID__
+        - name: interface-name
           in: query
-          description: English description of Network function that the specific VNF deployment is providing
+          description:
           required: false
           type: string
-        - name: nf-role
+        - name: interface-id
           in: query
-          description: role in the network that this model will be providing
+          description:
           required: false
           type: string
-        - name: nf-naming-code
+        - name: interface-role
           in: query
-          description: string assigned to this model used for naming purposes
+          description:
           required: false
           type: string
   /network/generic-vnfs/generic-vnf/{vnf-id}/vf-modules/vf-module/{vf-module-id}/relationship-list/relationship:
@@ -32331,14 +34504,16 @@ paths:
           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: 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"
@@ -32363,11 +34538,13 @@ paths:
           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__
   /network/generic-vnfs/generic-vnf/{vnf-id}/vf-modules/vf-module/{vf-module-id}:
     get:
       tags:
@@ -32382,7 +34559,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/vf-module"
+              $ref: "#/getDefinitions/vf-module"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -32391,134 +34568,21 @@ paths:
           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
-        - 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: 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
+          example: __VF-MODULE-ID__
     put:
       tags:
         - Network
       summary: create or update an existing vf-module
-      description: 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
@@ -32535,17 +34599,64 @@ paths:
           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: vf-module object that needs to be created or updated
+          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: 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: vf-module object that needs to be updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/vf-module"
     delete:
       tags:
         - Network
@@ -32567,11 +34678,13 @@ paths:
           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: resource-version
           in: query
           description: resource-version for concurrency
@@ -32591,7 +34704,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/vf-modules"
+              $ref: "#/getDefinitions/vf-modules"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -32600,87 +34713,45 @@ 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
+          example: __VNF-ID__
+        - name: vf-module-id
           in: query
-          description: Regional way of organizing pservers, source of truth should define values
+          description:
           required: false
           type: string
-        - name: prov-status
+        - name: vf-module-name
           in: query
-          description: Trigger for operational monitoring of this resource by Service Assurance systems.
+          description:
           required: false
           type: string
         - name: heat-stack-id
           in: query
-          description: Heat stack id corresponding to this instance, managed by MSO
+          description:
           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.
+          description:
           required: false
           type: string
         - name: model-version-id
           in: query
-          description: the ASDC model version for this resource or service model.
+          description:
           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.
+          description:
           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
+          description:
           required: false
           type: string
-        - name: nf-naming-code
+        - name: contrail-service-instance-fqdn
           in: query
-          description: string assigned to this model used for naming purposes
+          description:
           required: false
           type: string
   /network/generic-vnfs/generic-vnf/{vnf-id}/licenses/license/{group-uuid}/{resource-uuid}/relationship-list/relationship:
@@ -32704,19 +34775,22 @@ paths:
           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: 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/NetworkGenericVnfsGenericVnfLicensesLicense.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -32741,16 +34815,19 @@ paths:
           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__
   /network/generic-vnfs/generic-vnf/{vnf-id}/licenses/license/{group-uuid}/{resource-uuid}:
     get:
       tags:
@@ -32765,7 +34842,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/license"
+              $ref: "#/getDefinitions/license"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -32774,105 +34851,79 @@ paths:
           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
-        - name: vnf-name
-          in: query
-          description: Name of VNF.
-          required: false
+          example: __RESOURCE-UUID__
+    put:
+      tags:
+        - Network
+      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
+      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: vnf-name2
-          in: query
-          description: Alternate name of VNF.
-          required: false
+          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
-        - 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
+          example: __GROUP-UUID__
+        - name: resource-uuid
+          in: path
+          description: Unique ID of a license resource. 
+          required: true
           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:
+          example: __RESOURCE-UUID__
+        - name: body
+          in: body
+          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/license"
+    patch:
       tags:
         - Network
-      summary: create or update an existing license
-      description: create or update an existing license
-      operationId: createOrUpdateNetworkGenericVnfsGenericVnfLicensesLicense
+      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
@@ -32888,22 +34939,25 @@ paths:
           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
+          description: license object that needs to be updated.
           required: true
           schema:
-            $ref: "#/definitions/license"
+            $ref: "#/patchDefinitions/license"
     delete:
       tags:
         - Network
@@ -32925,16 +34979,19 @@ paths:
           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
@@ -32954,7 +35011,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/licenses"
+              $ref: "#/getDefinitions/licenses"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -32963,87 +35020,15 @@ 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
-          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
+          example: __VNF-ID__
+        - name: group-uuid
           in: query
-          description: role in the network that this model will be providing
+          description:
           required: false
           type: string
-        - name: nf-naming-code
+        - name: resource-uuid
           in: query
-          description: string assigned to this model used for naming purposes
+          description:
           required: false
           type: string
   /network/generic-vnfs/generic-vnf/{vnf-id}/entitlements/entitlement/{group-uuid}/{resource-uuid}/relationship-list/relationship:
@@ -33067,19 +35052,22 @@ paths:
           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"
@@ -33104,16 +35092,19 @@ paths:
           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__
   /network/generic-vnfs/generic-vnf/{vnf-id}/entitlements/entitlement/{group-uuid}/{resource-uuid}:
     get:
       tags:
@@ -33128,7 +35119,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/entitlement"
+              $ref: "#/getDefinitions/entitlement"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -33137,104 +35128,27 @@ paths:
           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
-        - 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
+          example: __RESOURCE-UUID__
     put:
       tags:
         - Network
       summary: create or update an existing entitlement
-      description: 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
@@ -33251,22 +35165,76 @@ paths:
           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
+          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: 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
+      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 updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/entitlement"
     delete:
       tags:
         - Network
@@ -33288,16 +35256,19 @@ paths:
           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: resource-version
           in: query
           description: resource-version for concurrency
@@ -33317,7 +35288,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/entitlements"
+              $ref: "#/getDefinitions/entitlements"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -33326,87 +35297,15 @@ 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
-          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
+          example: __VNF-ID__
+        - name: group-uuid
           in: query
-          description: role in the network that this model will be providing
+          description:
           required: false
           type: string
-        - name: nf-naming-code
+        - name: resource-uuid
           in: query
-          description: string assigned to this model used for naming purposes
+          description:
           required: false
           type: string
   /network/generic-vnfs/generic-vnf/{vnf-id}:
@@ -33423,7 +35322,99 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/generic-vnf"
+              $ref: "#/getDefinitions/generic-vnf"
+        "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__
+    put:
+      tags:
+        - Network
+      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
+      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: 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
+          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: Unique id of VNF.  This is unique across the graph.
+          required: true
+          type: string
+          example: __VNF-ID__
+        - name: body
+          in: body
+          description: generic-vnf object that needs to be updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/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:
@@ -33432,159 +35423,120 @@ paths:
           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/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: "#/getDefinitions/generic-vnfs"
+        "default":
+          description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: vnf-id
+          in: query
+          description:
+          required: false
+          type: string
         - name: vnf-name
           in: query
-          description: Name of VNF.
+          description:
           required: false
           type: string
         - name: vnf-name2
           in: query
-          description: Alternate name of VNF.
+          description:
           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.
+          description:
           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
+          description:
           required: false
           type: string
         - name: regional-resource-zone
           in: query
-          description: Regional way of organizing pservers, source of truth should define values
+          description:
           required: false
           type: string
         - name: prov-status
           in: query
-          description: Trigger for operational monitoring of this resource by Service Assurance systems.
+          description:
           required: false
           type: string
         - name: heat-stack-id
           in: query
-          description: Heat stack id corresponding to this instance, managed by MSO
+          description:
           required: false
           type: string
         - name: in-maint
           in: query
+          description:
           required: false
           type: boolean
         - name: is-closed-loop-disabled
           in: query
+          description:
           required: false
           type: boolean
         - name: model-invariant-id
           in: query
-          description: the ASDC model id for this resource or service model.
+          description:
           required: false
           type: string
         - name: model-version-id
           in: query
-          description: the ASDC model version for this resource or service model.
+          description:
           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.
+          description:
           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.
+          description:
           required: false
           type: string
         - name: nf-type
           in: query
-          description: Generic description of the type of NF
+          description:
           required: false
           type: string
         - name: nf-function
           in: query
-          description: English description of Network function that the specific VNF deployment is providing
+          description:
           required: false
           type: string
         - name: nf-role
           in: query
-          description: role in the network that this model will be providing
+          description:
           required: false
           type: string
         - name: nf-naming-code
           in: query
-          description: string assigned to this model used for naming purposes
+          description:
           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
-          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:
@@ -33606,9 +35558,10 @@ paths:
           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"
@@ -33633,6 +35586,7 @@ paths:
           description: Alphabetical concatenation of lag-interface names
           required: true
           type: string
+          example: __LINK-NAME__
   /network/lag-links/lag-link/{link-name}:
     get:
       tags:
@@ -33647,7 +35601,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/lag-link"
+              $ref: "#/getDefinitions/lag-link"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -33656,11 +35610,15 @@ paths:
           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
+      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
@@ -33677,12 +35635,52 @@ paths:
           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
+          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 updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/lag-link"
     delete:
       tags:
         - Network
@@ -33704,6 +35702,7 @@ paths:
           description: Alphabetical concatenation of lag-interface names
           required: true
           type: string
+          example: __LINK-NAME__
         - name: resource-version
           in: query
           description: resource-version for concurrency
@@ -33723,9 +35722,15 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/lag-links"
+              $ref: "#/getDefinitions/lag-links"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: link-name
+          in: query
+          description:
+          required: false
+          type: string
   /network/newvces/newvce/{vnf-id2}/relationship-list/relationship:
     put:
       tags:
@@ -33747,9 +35752,10 @@ paths:
           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
+          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"
@@ -33774,6 +35780,7 @@ paths:
           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:
@@ -33795,19 +35802,22 @@ paths:
           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: 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/NetworkNewvcesNewvceLInterfacesLInterfaceVlansVlan.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -33832,16 +35842,19 @@ paths:
           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:
@@ -33863,24 +35876,28 @@ paths:
           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"
@@ -33905,21 +35922,25 @@ paths:
           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__
   /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:
@@ -33934,7 +35955,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:
@@ -33943,94 +35964,91 @@ paths:
           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: vnf-name
-          in: query
-          description: Name of VNF.
-          required: false
+          example: __L3-INTERFACE-IPV4-ADDRESS__
+    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: createOrUpdateNetworkNewvcesNewvceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList
+      consumes:
+        - 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: vnf-name2
-          in: query
-          description: Alternate name of VNF.
-          required: false
+          example: __VNF-ID2__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          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
-          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: heat-stack-id
-          in: query
-          description: Heat stack id corresponding to this instance, managed by MSO
-          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
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
           type: string
-        - name: neutron-subnet-id
-          in: query
-          description: Neutron id of subnet that address belongs to
-          required: false
+          example: __VLAN-INTERFACE__
+        - name: l3-interface-ipv4-address
+          in: path
+          description: IP address
+          required: true
           type: string
-    put:
+          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: create or update an existing l3-interface-ipv4-address-list
-      description: create or update an existing l3-interface-ipv4-address-list
-      operationId: createOrUpdateNetworkNewvcesNewvceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList
+      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
@@ -34046,27 +36064,31 @@ paths:
           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 updated.
           required: true
           schema:
-            $ref: "#/definitions/l3-interface-ipv4-address-list"
+            $ref: "#/patchDefinitions/l3-interface-ipv4-address-list"
     delete:
       tags:
         - Network
@@ -34088,21 +36110,25 @@ paths:
           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
@@ -34129,24 +36155,28 @@ paths:
           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"
@@ -34171,21 +36201,25 @@ paths:
           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__
   /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:
@@ -34200,7 +36234,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:
@@ -34209,93 +36243,33 @@ paths:
           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: 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: prov-status
-          in: query
-          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
-          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: __L3-INTERFACE-IPV6-ADDRESS__
     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
+      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
@@ -34312,27 +36286,88 @@ paths:
           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. [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 updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/l3-interface-ipv6-address-list"
     delete:
       tags:
         - Network
@@ -34354,21 +36389,25 @@ paths:
           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
@@ -34388,7 +36427,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:
@@ -34397,72 +36436,27 @@ paths:
           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: 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: prov-status
-          in: query
-          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
-          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
+          example: __VLAN-INTERFACE__
     put:
       tags:
         - Network
       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: createOrUpdateNetworkNewvcesNewvceLInterfacesLInterfaceVlansVlan
       consumes:
         - application/json
@@ -34479,22 +36473,76 @@ paths:
           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"
+    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: UpdateNetworkNewvcesNewvceLInterfacesLInterfaceVlansVlan
+      consumes:
+        - 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: body
+          in: body
+          description: vlan object that needs to be updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/vlan"
     delete:
       tags:
         - Network
@@ -34516,16 +36564,19 @@ paths:
           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: resource-version
           in: query
           description: resource-version for concurrency
@@ -34545,7 +36596,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:
@@ -34554,49 +36605,27 @@ paths:
           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: 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: prov-status
-          in: query
-          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
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
           in: query
-          description: ID of interface
+          description:
           required: false
           type: string
-        - name: macaddr
+        - name: vlan-id-inner
           in: query
-          description: MAC address for the interface
+          description:
           required: false
-          type: string
-        - name: network-name
+          type: integer
+          format: int64
+        - name: vpn-key
           in: query
-          description: Name of the network
+          description:
           required: false
           type: string
   /network/newvces/newvce/{vnf-id2}/l-interfaces/l-interface/{interface-name}/sriov-vfs/sriov-vf/{pci-id}/relationship-list/relationship:
@@ -34620,19 +36649,22 @@ paths:
           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"
@@ -34657,16 +36689,19 @@ paths:
           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__
   /network/newvces/newvce/{vnf-id2}/l-interfaces/l-interface/{interface-name}/sriov-vfs/sriov-vf/{pci-id}:
     get:
       tags:
@@ -34681,7 +36716,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:
@@ -34690,81 +36725,27 @@ paths:
           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: 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: prov-status
-          in: query
-          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
-          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
+          example: __PCI-ID__
     put:
       tags:
         - Network
       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: createOrUpdateNetworkNewvcesNewvceLInterfacesLInterfaceSriovVfsSriovVf
       consumes:
         - application/json
@@ -34781,22 +36762,76 @@ paths:
           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. [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 updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/sriov-vf"
     delete:
       tags:
         - Network
@@ -34818,16 +36853,19 @@ paths:
           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
@@ -34847,7 +36885,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:
@@ -34856,49 +36894,36 @@ paths:
           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: 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: prov-status
+          example: __INTERFACE-NAME__
+        - name: pci-id
           in: query
-          description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems.
+          description:
           required: false
           type: string
-        - name: heat-stack-id
+        - name: vf-vlan-filter
           in: query
-          description: Heat stack id corresponding to this instance, managed by MSO
+          description:
           required: false
           type: string
-        - name: interface-id
+        - name: vf-mac-filter
           in: query
-          description: ID of interface
+          description:
           required: false
           type: string
-        - name: macaddr
+        - name: vf-vlan-strip
           in: query
-          description: MAC address for the interface
+          description:
           required: false
-          type: string
-        - name: network-name
+          type: boolean
+        - name: neutron-network-id
           in: query
-          description: Name of the network
+          description:
           required: false
           type: string
   /network/newvces/newvce/{vnf-id2}/l-interfaces/l-interface/{interface-name}/relationship-list/relationship:
@@ -34922,14 +36947,16 @@ paths:
           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"
@@ -34954,11 +36981,13 @@ paths:
           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__
   /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:
@@ -34980,19 +37009,22 @@ paths:
           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"
@@ -35017,16 +37049,19 @@ paths:
           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__
   /network/newvces/newvce/{vnf-id2}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv4-address-list/{l3-interface-ipv4-address}:
     get:
       tags:
@@ -35041,7 +37076,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:
@@ -35050,77 +37085,27 @@ paths:
           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: 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: prov-status
-          in: query
-          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
-          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
+          example: __L3-INTERFACE-IPV4-ADDRESS__
     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
+      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
@@ -35137,22 +37122,76 @@ paths:
           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. [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 updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/l3-interface-ipv4-address-list"
     delete:
       tags:
         - Network
@@ -35174,16 +37213,19 @@ paths:
           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
@@ -35210,19 +37252,22 @@ paths:
           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"
@@ -35247,16 +37292,19 @@ paths:
           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__
   /network/newvces/newvce/{vnf-id2}/l-interfaces/l-interface/{interface-name}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}:
     get:
       tags:
@@ -35271,7 +37319,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:
@@ -35280,77 +37328,27 @@ paths:
           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: 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: prov-status
-          in: query
-          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
-          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
+          example: __L3-INTERFACE-IPV6-ADDRESS__
     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
+      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
@@ -35367,22 +37365,76 @@ paths:
           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. [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 updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/l3-interface-ipv6-address-list"
     delete:
       tags:
         - Network
@@ -35404,16 +37456,19 @@ paths:
           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
@@ -35433,7 +37488,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:
@@ -35442,56 +37497,21 @@ paths:
           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: 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: prov-status
-          in: query
-          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
-          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
+          example: __INTERFACE-NAME__
     put:
       tags:
         - Network
       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: createOrUpdateNetworkNewvcesNewvceLInterfacesLInterface
       consumes:
         - application/json
@@ -35508,17 +37528,64 @@ paths:
           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. [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 updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/l-interface"
     delete:
       tags:
         - Network
@@ -35540,11 +37607,13 @@ paths:
           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
@@ -35564,7 +37633,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:
@@ -35573,29 +37642,25 @@ paths:
           description: Unique id of VNF, can't use same attribute name right now until we promote this new object
           required: true
           type: string
-        - name: vnf-name
-          in: query
-          description: Name of VNF.
-          required: false
-          type: string
-        - name: vnf-name2
+          example: __VNF-ID2__
+        - name: interface-name
           in: query
-          description: Alternate name of VNF.
+          description:
           required: false
           type: string
-        - name: vnf-type
+        - name: interface-id
           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:
           required: false
           type: string
-        - name: prov-status
+        - name: macaddr
           in: query
-          description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems.
+          description:
           required: false
           type: string
-        - name: heat-stack-id
+        - name: network-name
           in: query
-          description: Heat stack id corresponding to this instance, managed by MSO
+          description:
           required: false
           type: string
   /network/newvces/newvce/{vnf-id2}:
@@ -35612,7 +37677,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/newvce"
+              $ref: "#/getDefinitions/newvce"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -35621,36 +37686,15 @@ paths:
           description: Unique id of VNF, can't use same attribute name right now until we promote this new object
           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: prov-status
-          in: query
-          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
+          example: __VNF-ID2__
     put:
       tags:
         - Network
       summary: create or update an existing newvce
-      description: 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
@@ -35667,12 +37711,52 @@ paths:
           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: newvce object that needs to be created or updated
+          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: 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: newvce object that needs to be updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/newvce"
     delete:
       tags:
         - Network
@@ -35694,6 +37778,7 @@ paths:
           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
@@ -35713,9 +37798,40 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/newvces"
+              $ref: "#/getDefinitions/newvces"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: vnf-id2
+          in: query
+          description:
+          required: false
+          type: string
+        - name: vnf-name
+          in: query
+          description:
+          required: false
+          type: string
+        - name: vnf-name2
+          in: query
+          description:
+          required: false
+          type: string
+        - name: vnf-type
+          in: query
+          description:
+          required: false
+          type: string
+        - name: prov-status
+          in: query
+          description:
+          required: false
+          type: string
+        - name: heat-stack-id
+          in: query
+          description:
+          required: false
+          type: string
   /network/pnfs/pnf/{pnf-name}/relationship-list/relationship:
     put:
       tags:
@@ -35737,9 +37853,10 @@ paths:
           description: unique name of Physical Network Function.
           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"
@@ -35764,6 +37881,7 @@ paths:
           description: unique name of Physical Network Function.
           required: true
           type: string
+          example: __PNF-NAME__
   /network/pnfs/pnf/{pnf-name}/p-interfaces/p-interface/{interface-name}/relationship-list/relationship:
     put:
       tags:
@@ -35785,14 +37903,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 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"
@@ -35817,11 +37937,13 @@ 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__
   /network/pnfs/pnf/{pnf-name}/p-interfaces/p-interface/{interface-name}/sriov-pfs/sriov-pf/{pf-pci-id}/relationship-list/relationship:
     put:
       tags:
@@ -35843,19 +37965,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 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/NetworkPnfsPnfPInterfacesPInterfaceSriovPfsSriovPf.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -35880,16 +38005,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 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__
   /network/pnfs/pnf/{pnf-name}/p-interfaces/p-interface/{interface-name}/sriov-pfs/sriov-pf/{pf-pci-id}:
     get:
       tags:
@@ -35904,7 +38032,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:
@@ -35913,31 +38041,27 @@ 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: pf-pci-id
           in: path
           description: Identifier for the sriov-pf
           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
+          example: __PF-PCI-ID__
     put:
       tags:
         - Network
       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: createOrUpdateNetworkPnfsPnfPInterfacesPInterfaceSriovPfsSriovPf
       consumes:
         - application/json
@@ -35954,22 +38078,76 @@ 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: 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/NetworkPnfsPnfPInterfacesPInterfaceSriovPfsSriovPf.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: UpdateNetworkPnfsPnfPInterfacesPInterfaceSriovPfsSriovPf
+      consumes:
+        - 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: 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 updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/sriov-pf"
     delete:
       tags:
         - Network
@@ -35991,16 +38169,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 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
@@ -36020,7 +38201,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:
@@ -36029,19 +38210,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 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
+          example: __INTERFACE-NAME__
+        - name: pf-pci-id
           in: query
-          description: Trigger for operational monitoring of this resource by Service Assurance systems.
+          description:
           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:
@@ -36065,24 +38243,28 @@ 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: 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/NetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceVlansVlan.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -36107,21 +38289,25 @@ 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: vlan-interface
           in: path
           description: String that identifies the interface
           required: true
           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:
@@ -36143,29 +38329,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 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/NetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -36190,26 +38381,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: 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}/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:
@@ -36224,7 +38420,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:
@@ -36233,84 +38429,103 @@ 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: 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
-          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
+          example: __L3-INTERFACE-IPV4-ADDRESS__
+    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: createOrUpdateNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList
+      consumes:
+        - 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
-        - name: network-name
-          in: query
-          description: Name of the network
-          required: false
+          example: __PNF-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the physical interface
+          required: true
           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
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
           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
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
           type: string
-        - name: neutron-subnet-id
-          in: query
-          description: Neutron id of subnet that address belongs to
-          required: false
+          example: __VLAN-INTERFACE__
+        - name: l3-interface-ipv4-address
+          in: path
+          description: IP address
+          required: true
           type: string
-    put:
+          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/NetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList.json)
+          required: true
+          schema:
+            $ref: "#/definitions/l3-interface-ipv4-address-list"
+    patch:
       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
+      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
@@ -36326,32 +38541,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 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 updated.
           required: true
           schema:
-            $ref: "#/definitions/l3-interface-ipv4-address-list"
+            $ref: "#/patchDefinitions/l3-interface-ipv4-address-list"
     delete:
       tags:
         - Network
@@ -36373,26 +38593,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: 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
@@ -36419,29 +38644,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 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/NetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -36466,26 +38696,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: 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}/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:
@@ -36500,7 +38735,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:
@@ -36509,83 +38744,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 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
-        - 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
-        - 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: __L3-INTERFACE-IPV6-ADDRESS__
     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
+      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
@@ -36602,38 +38793,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 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/NetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList.json)
           required: true
           schema:
             $ref: "#/definitions/l3-interface-ipv6-address-list"
-    delete:
+    patch:
       tags:
         - Network
-      summary: delete an existing l3-interface-ipv6-address-list
-      description: delete an existing l3-interface-ipv6-address-list
-      operationId: deleteNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList
+      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
@@ -36649,46 +38856,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 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
-        - name: resource-version
-          in: query
-          description: resource-version for concurrency
+          example: __L3-INTERFACE-IPV6-ADDRESS__
+        - name: body
+          in: body
+          description: l3-interface-ipv6-address-list object that needs to be updated.
           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}:
-    get:
+          schema:
+            $ref: "#/patchDefinitions/l3-interface-ipv6-address-list"
+    delete:
       tags:
         - Network
-      summary: returns vlan
-      description: returns vlan
-      operationId: getNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceVlansVlan
+      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
       produces:
         - application/json
         - application/xml
       responses:
-        "200":
-          description: successful operation
-          schema:
-              $ref: "#/definitions/vlan"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -36697,62 +38908,86 @@ 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: vlan-interface
           in: path
           description: String that identifies 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
+          example: __VLAN-INTERFACE__
+        - name: l3-interface-ipv6-address
+          in: path
+          description: IP address
+          required: true
           type: string
-        - name: prov-status
+          example: __L3-INTERFACE-IPV6-ADDRESS__
+        - 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
-        - name: interface-id
-          in: query
-          description: ID of interface
-          required: false
+  /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 vlan
+      description: returns vlan
+      operationId: getNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceVlansVlan
+      produces:
+        - application/json
+        - application/xml
+      responses:
+        "200":
+          description: successful operation
+          schema:
+              $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: macaddr
-          in: query
-          description: MAC address for the interface
-          required: false
+          example: __PNF-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the physical interface
+          required: true
           type: string
-        - name: network-name
-          in: query
-          description: Name of the network
-          required: false
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
           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
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
           type: string
+          example: __VLAN-INTERFACE__
     put:
       tags:
         - Network
       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: createOrUpdateNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceVlansVlan
       consumes:
         - application/json
@@ -36769,27 +39004,88 @@ 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: 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/NetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceVlansVlan.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: UpdateNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceVlansVlan
+      consumes:
+        - 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: body
+          in: body
+          description: vlan object that needs to be updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/vlan"
     delete:
       tags:
         - Network
@@ -36811,21 +39107,25 @@ 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: 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
@@ -36845,7 +39145,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:
@@ -36854,39 +39154,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 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: prov-status
-          in: query
-          description: Trigger for operational monitoring of this resource by Service Assurance systems.
-          required: false
-          type: string
-        - name: interface-id
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
           in: query
-          description: ID of interface
+          description:
           required: false
           type: string
-        - name: macaddr
+        - name: vlan-id-inner
           in: query
-          description: MAC address for the interface
+          description:
           required: false
-          type: string
-        - name: network-name
+          type: integer
+          format: int64
+        - name: vpn-key
           in: query
-          description: Name of the network
+          description:
           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:
@@ -36910,24 +39204,28 @@ 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: 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/NetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceSriovVfsSriovVf.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -36952,21 +39250,25 @@ 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: 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}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/sriov-vfs/sriov-vf/{pci-id}:
     get:
       tags:
@@ -36981,7 +39283,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:
@@ -36990,71 +39292,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 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
-        - 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
-        - 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
+          example: __PCI-ID__
     put:
       tags:
         - Network
       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: createOrUpdateNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceSriovVfsSriovVf
       consumes:
         - application/json
@@ -37071,27 +39335,88 @@ 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: 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/NetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceSriovVfsSriovVf.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: 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 updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/sriov-vf"
     delete:
       tags:
         - Network
@@ -37113,21 +39438,25 @@ 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: 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
@@ -37147,7 +39476,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:
@@ -37156,39 +39485,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 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
+          example: __INTERFACE-NAME__
+        - name: pci-id
           in: query
-          description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
+          description:
           required: false
           type: string
-        - name: prov-status
+        - name: vf-vlan-filter
           in: query
-          description: Trigger for operational monitoring of this resource by Service Assurance systems.
+          description:
           required: false
           type: string
-        - name: interface-id
+        - name: vf-mac-filter
           in: query
-          description: ID of interface
+          description:
           required: false
           type: string
-        - name: macaddr
+        - name: vf-vlan-strip
           in: query
-          description: MAC address for the interface
+          description:
           required: false
-          type: string
-        - name: network-name
+          type: boolean
+        - name: neutron-network-id
           in: query
-          description: Name of the network
+          description:
           required: false
           type: string
   /network/pnfs/pnf/{pnf-name}/p-interfaces/p-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/relationship-list/relationship:
@@ -37212,19 +39544,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 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/NetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterface.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -37249,16 +39584,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 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:
@@ -37280,24 +39618,28 @@ 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: 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"
@@ -37322,21 +39664,25 @@ 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: l3-interface-ipv4-address
           in: path
           description: IP address
           required: true
           type: string
+          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:
@@ -37351,7 +39697,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:
@@ -37360,68 +39706,91 @@ 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: l3-interface-ipv4-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: 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
+          example: __L3-INTERFACE-IPV4-ADDRESS__
+    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: createOrUpdateNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList
+      consumes:
+        - 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
-        - name: network-name
-          in: query
-          description: Name of the network
-          required: false
+          example: __PNF-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the physical interface
+          required: true
           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
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
           type: string
-        - name: neutron-subnet-id
-          in: query
-          description: Neutron id of subnet that address belongs to
-          required: false
+          example: __INTERFACE-NAME__
+        - name: l3-interface-ipv4-address
+          in: path
+          description: IP address
+          required: true
           type: string
-    put:
+          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/NetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList.json)
+          required: true
+          schema:
+            $ref: "#/definitions/l3-interface-ipv4-address-list"
+    patch:
       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
+      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
@@ -37437,27 +39806,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: 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 updated.
           required: true
           schema:
-            $ref: "#/definitions/l3-interface-ipv4-address-list"
+            $ref: "#/patchDefinitions/l3-interface-ipv4-address-list"
     delete:
       tags:
         - Network
@@ -37479,21 +39852,25 @@ 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: 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
@@ -37520,24 +39897,28 @@ 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: 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/NetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -37562,21 +39943,25 @@ 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: 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}/l3-interface-ipv6-address-list/{l3-interface-ipv6-address}:
     get:
       tags:
@@ -37591,7 +39976,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:
@@ -37600,67 +39985,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 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
-        - 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
-        - 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: __L3-INTERFACE-IPV6-ADDRESS__
     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
+      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
@@ -37677,27 +40028,88 @@ 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: 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/NetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList.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: UpdateNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList
+      consumes:
+        - 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-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 updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/l3-interface-ipv6-address-list"
     delete:
       tags:
         - Network
@@ -37719,21 +40131,25 @@ 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: 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
@@ -37753,7 +40169,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:
@@ -37762,46 +40178,27 @@ 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
-        - 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
+          example: __INTERFACE-NAME__
     put:
       tags:
         - Network
       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: createOrUpdateNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterface
       consumes:
         - application/json
@@ -37818,22 +40215,76 @@ 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: 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/NetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterface.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: UpdateNetworkPnfsPnfPInterfacesPInterfaceLInterfacesLInterface
+      consumes:
+        - 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: body
+          in: body
+          description: l-interface object that needs to be updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/l-interface"
     delete:
       tags:
         - Network
@@ -37855,16 +40306,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 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
@@ -37884,7 +40338,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:
@@ -37893,19 +40347,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
-        - name: inv-status
+          example: __INTERFACE-NAME__
+        - name: interface-name
           in: query
-          description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
+          description:
           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:
+          required: false
+          type: string
+        - name: macaddr
+          in: query
+          description:
+          required: false
+          type: string
+        - name: network-name
+          in: query
+          description:
           required: false
           type: string
   /network/pnfs/pnf/{pnf-name}/p-interfaces/p-interface/{interface-name}:
@@ -37922,7 +40388,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:
@@ -37931,26 +40397,21 @@ 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
-        - 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
+          example: __INTERFACE-NAME__
     put:
       tags:
         - Network
       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: createOrUpdateNetworkPnfsPnfPInterfacesPInterface
       consumes:
         - application/json
@@ -37967,17 +40428,64 @@ 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: 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/NetworkPnfsPnfPInterfacesPInterface.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: UpdateNetworkPnfsPnfPInterfacesPInterface
+      consumes:
+        - 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: body
+          in: body
+          description: p-interface object that needs to be updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/p-interface"
     delete:
       tags:
         - Network
@@ -37999,11 +40507,13 @@ 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: resource-version
           in: query
           description: resource-version for concurrency
@@ -38023,7 +40533,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:
@@ -38032,9 +40542,15 @@ paths:
           description: unique name of Physical Network Function.
           required: true
           type: string
-        - name: inv-status
+          example: __PNF-NAME__
+        - name: interface-name
+          in: query
+          description:
+          required: false
+          type: string
+        - name: prov-status
           in: query
-          description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
+          description:
           required: false
           type: string
   /network/pnfs/pnf/{pnf-name}/lag-interfaces/lag-interface/{interface-name}/relationship-list/relationship:
@@ -38058,14 +40574,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
+          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"
@@ -38090,11 +40608,13 @@ 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
+          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:
@@ -38116,24 +40636,28 @@ 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
+          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"
@@ -38158,21 +40682,25 @@ 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
+          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__
   /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:
@@ -38194,29 +40722,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
           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/NetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -38241,26 +40774,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
+          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/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:
@@ -38275,7 +40813,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:
@@ -38284,88 +40822,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
+          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: 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: __L3-INTERFACE-IPV4-ADDRESS__
     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
+      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
@@ -38382,38 +40871,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
           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/NetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList.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: deleteNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv4AddressList
+      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
@@ -38429,37 +40934,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
           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 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/l3-interface-ipv4-address-list"
+    delete:
       tags:
         - Network
-      summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressListRelationshipListRelationship
+      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
@@ -38475,38 +40986,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
+          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: body
-          in: body
-          description: relationship object that needs to be created or updated
+          example: __L3-INTERFACE-IPV4-ADDRESS__
+        - name: resource-version
+          in: query
+          description: resource-version for concurrency
           required: true
-          schema:
-            $ref: "#/definitions/relationship"
-    delete:
+          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:
       tags:
         - Network
-      summary: delete an existing relationship
-      description: delete an existing relationship
-      operationId: deleteNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressListRelationshipListRelationship
+      summary: see node definition for valid relationships
+      operationId: createOrUpdateNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressListRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -38522,41 +41037,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
           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/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:
+          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/NetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList.json)
+          required: true
+          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: deleteNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressListRelationshipListRelationship
+      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:
@@ -38565,88 +41089,87 @@ 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
+          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
-        - 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: __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 l3-interface-ipv6-address-list
+      description: returns l3-interface-ipv6-address-list
+      operationId: getNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList
+      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
-        - name: network-name
-          in: query
-          description: Name of the network
-          required: false
+          example: __PNF-NAME__
+        - name: interface-name
+          in: path
+          description: Name that identifies the link aggregate interface
+          required: true
           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
+          example: __INTERFACE-NAME__
+        - name: interface-name
+          in: path
+          description: Name given to the interface
+          required: true
           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
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
+          in: path
+          description: String that identifies the interface
+          required: true
           type: string
-        - name: neutron-subnet-id
-          in: query
-          description: Neutron id of subnet that address belongs to
-          required: false
+          example: __VLAN-INTERFACE__
+        - name: l3-interface-ipv6-address
+          in: path
+          description: IP address
+          required: true
           type: string
+          example: __L3-INTERFACE-IPV6-ADDRESS__
     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
+      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
@@ -38663,32 +41186,100 @@ 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
+          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/NetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList.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: UpdateNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlanL3InterfaceIpv6AddressList
+      consumes:
+        - 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: 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 updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/l3-interface-ipv6-address-list"
     delete:
       tags:
         - Network
@@ -38710,26 +41301,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
+          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
@@ -38749,7 +41345,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:
@@ -38758,67 +41354,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
           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: 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
+          example: __VLAN-INTERFACE__
     put:
       tags:
         - Network
       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: createOrUpdateNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlan
       consumes:
         - application/json
@@ -38835,27 +41397,88 @@ 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
+          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/NetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceVlansVlan.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: 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 updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/vlan"
     delete:
       tags:
         - Network
@@ -38877,21 +41500,25 @@ 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
+          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
@@ -38911,7 +41538,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:
@@ -38920,44 +41547,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
           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
+          example: __INTERFACE-NAME__
+        - name: vlan-interface
           in: query
-          description: ID of interface
+          description:
           required: false
           type: string
-        - name: macaddr
+        - name: vlan-id-inner
           in: query
-          description: MAC address for the interface
+          description:
           required: false
-          type: string
-        - name: network-name
+          type: integer
+          format: int64
+        - name: vpn-key
           in: query
-          description: Name of the network
+          description:
           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:
@@ -38981,24 +41597,28 @@ 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
+          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/NetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfsSriovVf.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -39023,21 +41643,25 @@ 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
+          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:
@@ -39052,7 +41676,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:
@@ -39061,76 +41685,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
           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
-        - 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
+          example: __PCI-ID__
     put:
       tags:
         - Network
       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: createOrUpdateNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceSriovVfsSriovVf
       consumes:
         - application/json
@@ -39147,27 +41728,88 @@ 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
+          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/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 updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/sriov-vf"
     delete:
       tags:
         - Network
@@ -39189,21 +41831,25 @@ 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
+          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
@@ -39223,7 +41869,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:
@@ -39232,44 +41878,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
+          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
+          example: __INTERFACE-NAME__
+        - name: pci-id
           in: query
-          description: ID of interface
+          description:
           required: false
           type: string
-        - name: interface-role
+        - name: vf-vlan-filter
           in: query
-          description: Role assigned to this Interface, should use values as defined in ECOMP Yang models.
+          description:
           required: false
           type: string
-        - name: interface-id
+        - name: vf-mac-filter
           in: query
-          description: ID of interface
+          description:
           required: false
           type: string
-        - name: macaddr
+        - name: vf-vlan-strip
           in: query
-          description: MAC address for the interface
+          description:
           required: false
-          type: string
-        - name: network-name
+          type: boolean
+        - name: neutron-network-id
           in: query
-          description: Name of the network
+          description:
           required: false
           type: string
   /network/pnfs/pnf/{pnf-name}/lag-interfaces/lag-interface/{interface-name}/l-interfaces/l-interface/{interface-name}/relationship-list/relationship:
@@ -39293,19 +41937,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
+          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/NetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterface.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -39330,16 +41977,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
+          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:
@@ -39361,24 +42011,28 @@ 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
+          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/NetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv4AddressList.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -39403,21 +42057,25 @@ 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
+          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:
@@ -39432,7 +42090,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:
@@ -39441,72 +42099,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
           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
-        - 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
+          example: __L3-INTERFACE-IPV4-ADDRESS__
     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
+      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
@@ -39523,27 +42142,88 @@ 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
+          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/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 updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/l3-interface-ipv4-address-list"
     delete:
       tags:
         - Network
@@ -39565,21 +42245,25 @@ 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
+          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
@@ -39606,24 +42290,28 @@ 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
+          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/NetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterfaceL3InterfaceIpv6AddressList.json)
           required: true
           schema:
             $ref: "#/definitions/relationship"
@@ -39648,21 +42336,25 @@ 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
+          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:
@@ -39677,7 +42369,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:
@@ -39686,72 +42378,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
           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
-        - 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
+          example: __L3-INTERFACE-IPV6-ADDRESS__
     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
+      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
@@ -39768,27 +42421,88 @@ 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
+          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/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 updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/l3-interface-ipv6-address-list"
     delete:
       tags:
         - Network
@@ -39810,21 +42524,25 @@ 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
+          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
@@ -39844,7 +42562,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:
@@ -39853,51 +42571,27 @@ 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
+          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
-          type: string
-        - name: network-name
-          in: query
-          description: Name of the network
-          required: false
-          type: string
+          example: __INTERFACE-NAME__
     put:
       tags:
         - Network
       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: createOrUpdateNetworkPnfsPnfLagInterfacesLagInterfaceLInterfacesLInterface
       consumes:
         - application/json
@@ -39914,22 +42608,76 @@ 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
+          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/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 updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/l-interface"
     delete:
       tags:
         - Network
@@ -39951,16 +42699,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
+          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
@@ -39980,7 +42731,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:
@@ -39989,24 +42740,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: inv-status
+          example: __INTERFACE-NAME__
+        - name: interface-name
           in: query
-          description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
+          description:
           required: false
           type: string
         - name: interface-id
           in: query
-          description: ID of interface
+          description:
           required: false
           type: string
-        - name: interface-role
+        - name: macaddr
+          in: query
+          description:
+          required: false
+          type: string
+        - name: network-name
           in: query
-          description: Role assigned to this Interface, should use values as defined in ECOMP Yang models.
+          description:
           required: false
           type: string
   /network/pnfs/pnf/{pnf-name}/lag-interfaces/lag-interface/{interface-name}:
@@ -40023,7 +42781,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:
@@ -40032,31 +42790,21 @@ 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: 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
+          example: __INTERFACE-NAME__
     put:
       tags:
         - Network
       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: createOrUpdateNetworkPnfsPnfLagInterfacesLagInterface
       consumes:
         - application/json
@@ -40073,17 +42821,64 @@ 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
+          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/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 updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/lag-interface"
     delete:
       tags:
         - Network
@@ -40105,11 +42900,13 @@ 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
+          example: __INTERFACE-NAME__
         - name: resource-version
           in: query
           description: resource-version for concurrency
@@ -40129,7 +42926,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:
@@ -40138,9 +42935,20 @@ paths:
           description: unique name of Physical Network Function.
           required: true
           type: string
-        - name: inv-status
+          example: __PNF-NAME__
+        - name: interface-name
           in: query
-          description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
+          description:
+          required: false
+          type: string
+        - name: interface-id
+          in: query
+          description:
+          required: false
+          type: string
+        - name: interface-role
+          in: query
+          description:
           required: false
           type: string
   /network/pnfs/pnf/{pnf-name}:
@@ -40157,7 +42965,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/pnf"
+              $ref: "#/getDefinitions/pnf"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -40166,16 +42974,15 @@ 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
-          type: string
+          example: __PNF-NAME__
     put:
       tags:
         - Network
       summary: create or update an existing pnf
-      description: 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
@@ -40192,12 +42999,52 @@ paths:
           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
+          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 updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/pnf"
     delete:
       tags:
         - Network
@@ -40219,6 +43066,7 @@ paths:
           description: unique name of Physical Network Function.
           required: true
           type: string
+          example: __PNF-NAME__
         - name: resource-version
           in: query
           description: resource-version for concurrency
@@ -40238,9 +43086,20 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/pnfs"
+              $ref: "#/getDefinitions/pnfs"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: pnf-name
+          in: query
+          description:
+          required: false
+          type: string
+        - name: inv-status
+          in: query
+          description:
+          required: false
+          type: string
   /network/physical-links/physical-link/{link-name}/relationship-list/relationship:
     put:
       tags:
@@ -40262,9 +43121,10 @@ paths:
           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
+          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"
@@ -40289,6 +43149,7 @@ paths:
           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:
@@ -40303,7 +43164,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/physical-link"
+              $ref: "#/getDefinitions/physical-link"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -40312,16 +43173,15 @@ paths:
           description: e.g., hostnameA_p-connection_nameA_hostnameZ+p_connection-nameZ
           required: true
           type: string
-        - name: circuit-id
-          in: query
-          description: Circuit it
-          required: false
-          type: string
+          example: __LINK-NAME__
     put:
       tags:
         - Network
       summary: create or update an existing physical-link
-      description: 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
@@ -40338,12 +43198,52 @@ paths:
           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
+          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 updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/physical-link"
     delete:
       tags:
         - Network
@@ -40365,6 +43265,7 @@ paths:
           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
@@ -40384,9 +43285,20 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/physical-links"
+              $ref: "#/getDefinitions/physical-links"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: link-name
+          in: query
+          description:
+          required: false
+          type: string
+        - name: circuit-id
+          in: query
+          description:
+          required: false
+          type: string
   /network/ipsec-configurations/ipsec-configuration/{ipsec-configuration-id}/relationship-list/relationship:
     put:
       tags:
@@ -40408,9 +43320,10 @@ paths:
           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
+          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"
@@ -40435,6 +43348,7 @@ paths:
           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:
@@ -40456,14 +43370,16 @@ paths:
           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
+          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"
@@ -40488,11 +43404,13 @@ paths:
           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:
@@ -40507,7 +43425,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/vig-server"
+              $ref: "#/getDefinitions/vig-server"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -40516,16 +43434,21 @@ paths:
           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
+      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
@@ -40542,17 +43465,64 @@ paths:
           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
+          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 updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/vig-server"
     delete:
       tags:
         - Network
@@ -40574,11 +43544,13 @@ paths:
           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
@@ -40598,7 +43570,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/vig-servers"
+              $ref: "#/getDefinitions/vig-servers"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -40607,6 +43579,12 @@ paths:
           description: UUID of this configuration
           required: true
           type: string
+          example: __IPSEC-CONFIGURATION-ID__
+        - name: vig-address-type
+          in: query
+          description:
+          required: false
+          type: string
   /network/ipsec-configurations/ipsec-configuration/{ipsec-configuration-id}:
     get:
       tags:
@@ -40621,7 +43599,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/ipsec-configuration"
+              $ref: "#/getDefinitions/ipsec-configuration"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -40630,11 +43608,15 @@ paths:
           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
+      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
@@ -40651,12 +43633,52 @@ paths:
           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
+          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 updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/ipsec-configuration"
     delete:
       tags:
         - Network
@@ -40678,6 +43700,7 @@ paths:
           description: UUID of this configuration
           required: true
           type: string
+          example: __IPSEC-CONFIGURATION-ID__
         - name: resource-version
           in: query
           description: resource-version for concurrency
@@ -40697,9 +43720,15 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/ipsec-configurations"
+              $ref: "#/getDefinitions/ipsec-configurations"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: ipsec-configuration-id
+          in: query
+          description:
+          required: false
+          type: string
   /network/route-table-references/route-table-reference/{route-table-reference-id}/relationship-list/relationship:
     put:
       tags:
@@ -40721,9 +43750,10 @@ paths:
           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
+          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"
@@ -40748,6 +43778,7 @@ paths:
           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:
@@ -40762,7 +43793,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/route-table-reference"
+              $ref: "#/getDefinitions/route-table-reference"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -40771,16 +43802,15 @@ paths:
           description: Route Table Reference id, UUID assigned to this instance.
           required: true
           type: string
-        - name: route-table-reference-fqdn
-          in: query
-          description: FQDN entry in the route table.
-          required: false
-          type: string
+          example: __ROUTE-TABLE-REFERENCE-ID__
     put:
       tags:
         - Network
       summary: create or update an existing route-table-reference
-      description: 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
@@ -40797,12 +43827,52 @@ paths:
           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
+          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 updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/route-table-reference"
     delete:
       tags:
         - Network
@@ -40824,6 +43894,7 @@ paths:
           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
@@ -40843,9 +43914,20 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/route-table-references"
+              $ref: "#/getDefinitions/route-table-references"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: route-table-reference-id
+          in: query
+          description:
+          required: false
+          type: string
+        - name: route-table-reference-fqdn
+          in: query
+          description:
+          required: false
+          type: string
   /network/instance-groups/instance-group/{id}/relationship-list/relationship:
     put:
       tags:
@@ -40867,9 +43949,10 @@ paths:
           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
+          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"
@@ -40894,6 +43977,7 @@ paths:
           description: Instance Group ID, UUID assigned to this instance.
           required: true
           type: string
+          example: __ID__
   /network/instance-groups/instance-group/{id}:
     get:
       tags:
@@ -40908,7 +43992,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/instance-group"
+              $ref: "#/getDefinitions/instance-group"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -40917,26 +44001,15 @@ paths:
           description: Instance Group ID, UUID assigned to this instance.
           required: true
           type: string
-        - 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
+          example: __ID__
     put:
       tags:
         - Network
       summary: create or update an existing instance-group
-      description: 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
@@ -40953,12 +44026,52 @@ paths:
           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
+          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 updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/instance-group"
     delete:
       tags:
         - Network
@@ -40980,6 +44093,7 @@ paths:
           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
@@ -40999,9 +44113,30 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/instance-groups"
+              $ref: "#/getDefinitions/instance-groups"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
+      parameters:
+        - name: id
+          in: query
+          description:
+          required: false
+          type: string
+        - name: description
+          in: query
+          description:
+          required: false
+          type: string
+        - name: type
+          in: query
+          description:
+          required: false
+          type: string
+        - name: sub-type
+          in: query
+          description:
+          required: false
+          type: string
   /network/zones/zone/{zone-id}/relationship-list/relationship:
     put:
       tags:
@@ -41023,9 +44158,10 @@ paths:
           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
+          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"
@@ -41050,6 +44186,7 @@ paths:
           description: Code assigned by AIC to the zone
           required: true
           type: string
+          example: __ZONE-ID__
   /network/zones/zone/{zone-id}:
     get:
       tags:
@@ -41064,7 +44201,7 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/zone"
+              $ref: "#/getDefinitions/zone"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
@@ -41073,21 +44210,15 @@ paths:
           description: Code assigned by AIC to the zone
           required: true
           type: string
-        - 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
+          example: __ZONE-ID__
     put:
       tags:
         - Network
       summary: create or update an existing zone
-      description: 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
@@ -41104,12 +44235,52 @@ paths:
           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
+          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 updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/zone"
     delete:
       tags:
         - Network
@@ -41131,6 +44302,7 @@ paths:
           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
@@ -41150,15 +44322,31 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/zones"
+              $ref: "#/getDefinitions/zones"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
-  /network/vip-ipv4-address-list/{vip-ipv4-address}/relationship-list/relationship:
+      parameters:
+        - name: zone-id
+          in: query
+          description:
+          required: false
+          type: string
+        - name: design-type
+          in: query
+          description:
+          required: false
+          type: string
+        - name: zone-context
+          in: query
+          description:
+          required: false
+          type: string
+  /network/configurations/configuration/{configuration-id}/relationship-list/relationship:
     put:
       tags:
         - Network
       summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkVipIpv4AddressListRelationshipListRelationship
+      operationId: createOrUpdateNetworkConfigurationsConfigurationRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -41169,14 +44357,15 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vip-ipv4-address
+        - name: configuration-id
           in: path
-          description: IP address
+          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
+          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"
@@ -41185,7 +44374,7 @@ paths:
         - Network
       summary: delete an existing relationship
       description: delete an existing relationship
-      operationId: deleteNetworkVipIpv4AddressListRelationshipListRelationship
+      operationId: deleteNetworkConfigurationsConfigurationRelationshipListRelationship
       consumes:
         - application/json
         - application/xml
@@ -41196,18 +44385,19 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vip-ipv4-address
+        - name: configuration-id
           in: path
-          description: IP address
+          description: UUID assigned to configuration.
           required: true
           type: string
-  /network/vip-ipv4-address-list/{vip-ipv4-address}:
+          example: __CONFIGURATION-ID__
+  /network/configurations/configuration/{configuration-id}/metadata/metadatum/{metaname}:
     get:
       tags:
         - Network
-      summary: returns vip-ipv4-address-list
-      description: returns vip-ipv4-address-list
-      operationId: getNetworkVipIpv4AddressList
+      summary: returns metadatum
+      description: returns metadatum
+      operationId: getNetworkConfigurationsConfigurationMetadataMetadatum
       produces:
         - application/json
         - application/xml
@@ -41215,37 +44405,30 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/vip-ipv4-address-list"
+              $ref: "#/getDefinitions/metadatum"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vip-ipv4-address
+        - name: configuration-id
           in: path
-          description: IP address
+          description: UUID assigned to configuration.
           required: true
           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
+          example: __CONFIGURATION-ID__
+        - name: metaname
+          in: path
+          required: true
           type: string
+          example: __METANAME__
     put:
       tags:
         - Network
-      summary: create or update an existing vip-ipv4-address-list
-      description: create or update an existing vip-ipv4-address-list
-      operationId: createOrUpdateNetworkVipIpv4AddressList
+      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
@@ -41256,23 +44439,40 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vip-ipv4-address
+        - name: configuration-id
+          in: path
+          description: UUID assigned to configuration.
+          required: true
+          type: string
+          example: __CONFIGURATION-ID__
+        - name: metaname
           in: path
-          description: IP address
           required: true
           type: string
+          example: __METANAME__
         - name: body
           in: body
-          description: vip-ipv4-address-list 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/NetworkConfigurationsConfigurationMetadataMetadatum.json)
           required: true
           schema:
-            $ref: "#/definitions/vip-ipv4-address-list"
-    delete:
+            $ref: "#/definitions/metadatum"
+    patch:
       tags:
         - Network
-      summary: delete an existing vip-ipv4-address-list
-      description: delete an existing vip-ipv4-address-list
-      operationId: deleteNetworkVipIpv4AddressList
+      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
@@ -41283,22 +44483,29 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vip-ipv4-address
+        - name: configuration-id
           in: path
-          description: IP address
+          description: UUID assigned to configuration.
           required: true
           type: string
-        - name: resource-version
-          in: query
-          description: resource-version for concurrency
+          example: __CONFIGURATION-ID__
+        - name: metaname
+          in: path
           required: true
           type: string
-  /network/vip-ipv6-address-list/{vip-ipv6-address}/relationship-list/relationship:
-    put:
+          example: __METANAME__
+        - name: body
+          in: body
+          description: metadatum object that needs to be updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/metadatum"
+    delete:
       tags:
         - Network
-      summary: see node definition for valid relationships
-      operationId: createOrUpdateNetworkVipIpv6AddressListRelationshipListRelationship
+      summary: delete an existing metadatum
+      description: delete an existing metadatum
+      operationId: deleteNetworkConfigurationsConfigurationMetadataMetadatum
       consumes:
         - application/json
         - application/xml
@@ -41309,45 +44516,58 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vip-ipv6-address
+        - name: configuration-id
           in: path
-          description: IP address
+          description: UUID assigned to configuration.
           required: true
           type: string
-        - name: body
-          in: body
-          description: relationship object that needs to be created or updated
+          example: __CONFIGURATION-ID__
+        - name: metaname
+          in: path
           required: true
-          schema:
-            $ref: "#/definitions/relationship"
-    delete:
+          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: delete an existing relationship
-      description: delete an existing relationship
-      operationId: deleteNetworkVipIpv6AddressListRelationshipListRelationship
-      consumes:
-        - application/json
-        - application/xml
+      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: vip-ipv6-address
+        - name: configuration-id
           in: path
-          description: IP address
+          description: UUID assigned to configuration.
           required: true
           type: string
-  /network/vip-ipv6-address-list/{vip-ipv6-address}:
+          example: __CONFIGURATION-ID__
+        - name: metaname
+          in: query
+          description:
+          required: false
+          type: string
+  /network/configurations/configuration/{configuration-id}:
     get:
       tags:
         - Network
-      summary: returns vip-ipv6-address-list
-      description: returns vip-ipv6-address-list
-      operationId: getNetworkVipIpv6AddressList
+      summary: returns configuration
+      description: returns configuration
+      operationId: getNetworkConfigurationsConfiguration
       produces:
         - application/json
         - application/xml
@@ -41355,37 +44575,25 @@ paths:
         "200":
           description: successful operation
           schema:
-              $ref: "#/definitions/vip-ipv6-address-list"
+              $ref: "#/getDefinitions/configuration"
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vip-ipv6-address
+        - name: configuration-id
           in: path
-          description: IP address
+          description: UUID assigned to configuration.
           required: true
           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: __CONFIGURATION-ID__
     put:
       tags:
         - Network
-      summary: create or update an existing vip-ipv6-address-list
-      description: create or update an existing vip-ipv6-address-list
-      operationId: createOrUpdateNetworkVipIpv6AddressList
+      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
@@ -41396,23 +44604,63 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vip-ipv6-address
+        - name: configuration-id
           in: path
-          description: IP address
+          description: UUID assigned to configuration.
           required: true
           type: string
+          example: __CONFIGURATION-ID__
         - name: body
           in: body
-          description: vip-ipv6-address-list object that needs to be created or updated
+          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/vip-ipv6-address-list"
+            $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 updated.
+          required: true
+          schema:
+            $ref: "#/patchDefinitions/configuration"
     delete:
       tags:
         - Network
-      summary: delete an existing vip-ipv6-address-list
-      description: delete an existing vip-ipv6-address-list
-      operationId: deleteNetworkVipIpv6AddressList
+      summary: delete an existing configuration
+      description: delete an existing configuration
+      operationId: deleteNetworkConfigurationsConfiguration
       consumes:
         - application/json
         - application/xml
@@ -41423,31 +44671,65 @@ paths:
         "default":
           description: Response codes found in [response codes](https://wiki.onap.org/).
       parameters:
-        - name: vip-ipv6-address
+        - name: configuration-id
           in: path
-          description: IP address
+          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/).
+      parameters:
+        - name: configuration-id
+          in: query
+          description:
+          required: false
+          type: string
+        - name: model-invariant-id
+          in: query
+          description:
+          required: false
+          type: string
+        - name: model-version-id
+          in: query
+          description:
+          required: false
+          type: string
 definitions:
-  search:
+  action:
     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"
+      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).
@@ -41458,101 +44740,360 @@ definitions:
       notify:
         type: object
         $ref: "#/definitions/notify"
-  relationship-data:
+  allotted-resource:
+    description: |
+      Represents a slice or partial piece of a resource that gets separately allotted
+      ###### Related Nodes
+      - TO allotted-resource( allotted-resource BindsTo allotted-resource, ONE2ONE)
+      - TO generic-vnf( allotted-resource PartOf generic-vnf, MANY2MANY)
+      - TO instance-group( allotted-resource MemberOf instance-group, MANY2MANY)
+      - TO l3-network( allotted-resource PartOf l3-network, MANY2MANY)
+      - TO l-interface( allotted-resource Uses l-interface, ONE2MANY)
+      - TO network-policy( allotted-resource Uses network-policy, ONE2ONE)
+      - TO vlan( allotted-resource PartOf vlan, MANY2MANY)
+      - TO vpn-binding( allotted-resource BelongsTo vpn-binding, MANY2MANY)
+      - TO service-instance( allotted-resource BelongsTo service-instance, MANY2ONE)(4)
+      - FROM tunnel-xconnect( tunnel-xconnect BelongsTo allotted-resource, ONE2ONE)(1)
+      - FROM configuration( configuration Uses allotted-resource, ONE2ONE)(3)
+      - FROM service-instance( service-instance Uses allotted-resource, MANY2MANY)
+      - FROM allotted-resource( allotted-resource BindsTo allotted-resource, ONE2ONE)
+
+      -(1) IF this ALLOTTED-RESOURCE node is deleted, this FROM node is DELETED also
+      -(3) IF this FROM node is deleted, this ALLOTTED-RESOURCE is DELETED also
+      -(4) IF this TO node is deleted, this ALLOTTED-RESOURCE is DELETED also
     required:
-    - relationship-key
-    - relationship-value
+    - id
     properties:
-      relationship-key:
+      id:
         type: string
-        description: A keyword provided by A&AI to indicate an attribute.
-      relationship-value:
+        description: Allotted Resource id UUID assigned to this instance.
+      description:
         type: string
-        description: Value of the attribute.
-  related-to-property:
-    properties:
-      property-key:
+        description: The descriptive information assigned to this allotted resource instance
+      selflink:
         type: string
-        description: Key part of a key/value pair
-      property-value:
+        description: Link back to more information in the controller
+      model-invariant-id:
         type: string
-        description: Value part of a key/value pair
-  relationship:
-    properties:
-      related-to:
+        description: the ASDC model id for this resource or service model.
+      model-version-id:
         type: string
-        description: A keyword provided by A&AI to indicate type of node.
-      related-link:
+        description: the ASDC model version for this resource or service model.
+      persona-model-version:
         type: string
-        description: URL to the object in A&AI.
-      relationship-data:
+        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/relationship-data"
-      related-to-property:
+        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/related-to-property"
-  relationship-list:
+          $ref: "#/definitions/allotted-resource"
+  availability-zone:
+    description: |
+      Availability zone, a collection of compute hosts/pservers
+      ###### Related Nodes
+      - TO complex( availability-zone LocatedIn complex, MANY2ONE)
+      - TO service-capability( availability-zone AppliesTo service-capability, MANY2MANY)
+      - TO cloud-region( availability-zone BelongsTo cloud-region, MANY2ONE)(4)
+      - FROM ctag-pool( ctag-pool AppliesTo availability-zone, MANY2MANY)
+      - FROM dvs-switch( dvs-switch AppliesTo availability-zone, MANY2MANY)
+      - FROM generic-vnf( generic-vnf Uses availability-zone, MANY2MANY)
+      - FROM pserver( pserver MemberOf availability-zone, MANY2ONE)
+      - FROM vce( vce Uses availability-zone, MANY2MANY)
+
+      -(4) IF this TO node is deleted, this AVAILABILITY-ZONE is DELETED also
+      -AVAILABILITY-ZONE cannot be deleted if related to CTAG-POOL,DVS-SWITCH,GENERIC-VNF,PSERVER,VCE
+
+    required:
+    - availability-zone-name
+    - hypervisor-type
     properties:
-      relationship:
+      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 BelongsTo site-pair, MANY2ONE)(4)
+
+      -(4) IF this TO node is deleted, this CLASS-OF-SERVICE is DELETED also
+    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"
-  ctag-pool:
+  classes-of-service:
     description: |
-      A collection of C tags (vlan tags) grouped for a specific purpose.
+      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 availability-zone (Many2Many)
-      - FROM complex (is composed of ctag-pool)
-      - FROM vpls-pe
-      - FROM generic-vnf
+      - TO complex( cloud-region LocatedIn complex, MANY2ONE)
+      - TO l3-network( cloud-region Uses l3-network, MANY2MANY)
+      - TO zone( cloud-region LocatedIn zone, MANY2ONE)
+      - FROM esr-system-info( esr-system-info BelongsTo cloud-region, MANY2ONE)(1)
+      - FROM availability-zone( availability-zone BelongsTo cloud-region, MANY2ONE)(1)
+      - FROM dvs-switch( dvs-switch BelongsTo cloud-region, MANY2ONE)
+      - FROM flavor( flavor BelongsTo cloud-region, MANY2ONE)
+      - FROM group-assignment( group-assignment BelongsTo cloud-region, MANY2ONE)
+      - FROM image( image BelongsTo cloud-region, MANY2ONE)
+      - FROM oam-network( oam-network BelongsTo cloud-region, MANY2ONE)
+      - FROM snapshot( snapshot BelongsTo cloud-region, MANY2ONE)
+      - FROM tenant( tenant BelongsTo cloud-region, MANY2ONE)
+      - FROM vip-ipv4-address-list( vip-ipv4-address-list BelongsTo cloud-region, MANY2ONE)
+      - FROM vip-ipv6-address-list( vip-ipv6-address-list BelongsTo cloud-region, MANY2ONE)
+      - FROM volume-group( volume-group BelongsTo cloud-region, MANY2ONE)
+      - FROM logical-link( logical-link LocatedIn cloud-region, MANY2MANY)
+      - FROM pserver( pserver LocatedIn cloud-region, MANY2ONE)
+
+      -(1) IF this CLOUD-REGION node is deleted, this FROM node is DELETED also
+      -CLOUD-REGION cannot be deleted if related to DVS-SWITCH,FLAVOR,GROUP-ASSIGNMENT,IMAGE,OAM-NETWORK,SNAPSHOT,TENANT,VIP-IPV4-ADDRESS-LIST,VIP-IPV6-ADDRESS-LIST,VOLUME-GROUP
+
     required:
-    - target-pe
-    - availability-zone-name
-    - ctag-pool-purpose
+    - cloud-owner
+    - cloud-region-id
+    - sriov-automation
     properties:
-      target-pe:
+      cloud-owner:
         type: string
-        description: The Target provider edge router
-      availability-zone-name:
+        description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
+      cloud-region-id:
         type: string
-        description: Name of the availability zone
-      ctag-pool-purpose:
+        description: Identifier used by the vendor for the region. Second part of composite key
+      cloud-type:
         type: string
-        description: Describes what the intended purpose of this pool is.
-      ctag-values:
+        description: Type of the cloud (e.g., openstack)
+      owner-defined-type:
         type: string
-        description: Comma separated list of ctags
+        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
+        description: Whether the cloud region supports (true) or does not support (false) SR-IOV automation.
+      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"
-  ctag-pools:
+      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:
-      ctag-pool:
+      cloud-region:
         type: array
         items:          
-          $ref: "#/definitions/ctag-pool"
+          $ref: "#/definitions/cloud-region"
   complex:
     description: |
       Collection of physical locations that can house cloud-regions.
       ###### 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
+      - TO l3-network( complex Uses l3-network, MANY2MANY)
+      - FROM availability-zone( availability-zone LocatedIn complex, MANY2ONE)
+      - FROM cloud-region( cloud-region LocatedIn complex, MANY2ONE)
+      - FROM ctag-pool( ctag-pool BelongsTo complex, MANY2ONE)(1)
+      - FROM generic-vnf( generic-vnf LocatedIn complex, MANY2MANY)
+      - FROM oam-network( oam-network AppliesTo complex, MANY2MANY)
+      - FROM pnf( pnf LocatedIn complex, MANY2ONE)
+      - FROM pserver( pserver LocatedIn complex, MANY2ONE)
+      - FROM vce( vce LocatedIn complex, MANY2MANY)
+      - FROM volume-group( volume-group LocatedIn complex, MANY2ONE)
+      - FROM vpls-pe( vpls-pe LocatedIn complex, MANY2ONE)
+      - FROM zone( zone LocatedIn complex, MANY2ONE)
+
+      -(1) IF this COMPLEX node is deleted, this FROM node is DELETED also
+      -COMPLEX cannot be deleted if related to AVAILABILITY-ZONE,CLOUD-REGION,GENERIC-VNF,OAM-NETWORK,PNF,PSERVER,VCE,VOLUME-GROUP,VPLS-PE,ZONE
+
     required:
     - physical-location-id
     - physical-location-type
@@ -41618,41 +45159,61 @@ definitions:
         type: array
         items:          
           $ref: "#/definitions/complex"
-  volume-group:
+  configuration:
     description: |
-      Persistent block-level storage.
+      Port Mirror Configuration.
       ###### Related Nodes
-      - TO complex (Many2Many)
-      - TO tenant (Many2Many)
-      - FROM cloud-region (is composed of volume-group)
-      - FROM vf-module
-      - FROM generic-vnf
+      - TO allotted-resource( configuration Uses allotted-resource, ONE2ONE)(2)
+      - TO logical-link( configuration Uses logical-link, ONE2MANY)(2)
+      - FROM metadatum( metadatum BelongsTo configuration, MANY2ONE)(1)
+      - FROM generic-vnf( generic-vnf Uses configuration, ONE2MANY)(3)
+      - FROM service-instance( service-instance Uses configuration, ONE2MANY)
+
+      -(1) IF this CONFIGURATION node is deleted, this FROM node is DELETED also
+      -(2) IF this CONFIGURATION node is deleted, this TO node is DELETED also
+      -(3) IF this FROM node is deleted, this CONFIGURATION is DELETED also
     required:
-    - volume-group-id
-    - volume-group-name
-    - vnf-type
+    - configuration-id
+    - configuration-type
+    - configuration-sub-type
+    - orchestration-status
+    - operational-status
+    - configuration-selflink
+    - model-customization-id
     properties:
-      volume-group-id:
+      configuration-id:
         type: string
-        description: Unique ID of volume-group.
-      volume-group-name:
+        description: UUID assigned to configuration.
+      management-option:
         type: string
-        description: Name of the volume group.
-      heat-stack-id:
+        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: Heat stack id corresponding to this volume-group
-      vnf-type:
+        description: Name of the configuration.
+      configuration-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:
+        description: port-mirroring-configuration.
+      configuration-sub-type:
         type: string
-        description: Orchestration status of this volume-group
-      model-customization-id:
+        description: vprobe, pprobe.
+      model-invariant-id:
         type: string
-        description: captures the id of all the configuration used to customize the resource for the service.
-      vf-module-model-customization-id:
+        description: the ASDC model id for this resource or service model.
+      model-version-id:
         type: string
-        description: helps relate the volume group to the vf-module whose components will require the volume group
+        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.
@@ -41660,556 +45221,477 @@ definitions:
         type: array
         items:
           $ref: "#/definitions/relationship"
-  volume-groups:
+      metadata:
+        type: array
+        items:
+          $ref: "#/definitions/metadatum"
+  configurations:
     description: |
-      Collection of persistent block-level storage.
+      Collection of configurations
     properties:
-      volume-group:
+      configuration:
         type: array
         items:          
-          $ref: "#/definitions/volume-group"
-  volume:
+          $ref: "#/definitions/configuration"
+  connector:
     description: |
-      Ephemeral Block storage volume.
+      Collection of resource instances used to connect a variety of disparate inventory widgets
       ###### Related Nodes
-      - FROM vserver (is composed of volume)
+      - TO virtual-data-center( connector LocatedIn virtual-data-center, MANY2MANY)
+      - FROM metadatum( metadatum BelongsTo connector, MANY2ONE)(1)
+      - FROM service-instance( service-instance Uses connector, MANY2MANY)
+
+      -(1) IF this CONNECTOR node is deleted, this FROM node is DELETED also
     required:
-    - volume-id
-    - volume-selflink
+    - resource-instance-id
     properties:
-      volume-id:
-        type: string
-        description: Unique ID of block storage volume relative to the vserver.
-      volume-selflink:
+      resource-instance-id:
         type: string
-        description: URL to endpoint where AAI can get more details
+        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"
-  volumes:
+      metadata:
+        type: array
+        items:
+          $ref: "#/definitions/metadatum"
+  connectors:
     description: |
-      Collection of ephemeral Block storage volumes.
+      Collection of resource instances used to connect a variety of disparate inventory widgets
     properties:
-      volume:
+      connector:
         type: array
         items:          
-          $ref: "#/definitions/volume"
-  l3-interface-ipv4-address-list:
+          $ref: "#/definitions/connector"
+  constrained-element-set:
     description: |
-      IPv4 Address Range
+      This is how we would capture constraints defining allowed sets of elements.
       ###### Related Nodes
-      - TO instance-group (Many2Many)
-      - TO l3-network (Many2Many)
-      - TO subnet (Many2Many)
-      - TO vnfc (is composed of l3-interface-ipv4-address-list, Many2One)
-      - FROM l-interface (is composed of l3-interface-ipv4-address-list)
-      - FROM vlan (is composed of l3-interface-ipv4-address-list)
+      - TO model-constraint( constrained-element-set BelongsTo model-constraint, MANY2ONE)(4)
+      - TO model-element( constrained-element-set BelongsTo model-element, MANY2ONE)(4)
+      - FROM element-choice-set( element-choice-set BelongsTo constrained-element-set, MANY2ONE)(1)
+
+      -(1) IF this CONSTRAINED-ELEMENT-SET node is deleted, this FROM node is DELETED also
+      -(4) IF this TO node is deleted, this CONSTRAINED-ELEMENT-SET is DELETED also
     required:
-    - l3-interface-ipv4-address
+    - constrained-element-set-uuid
+    - constraint-type
+    - check-type
     properties:
-      l3-interface-ipv4-address:
+      constrained-element-set-uuid:
         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:
+      constraint-type:
         type: string
-        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
-      neutron-network-id:
+      check-type:
         type: string
-        description: Neutron network id of the interface that address belongs to
-      neutron-subnet-id:
+      resource-version:
         type: string
-        description: Neutron id of subnet that address belongs to
+      element-choice-sets:
+        type: array
+        items:
+          $ref: "#/definitions/element-choice-set"
       relationship-list:
         type: array
         items:
           $ref: "#/definitions/relationship"
-  l3-interface-ipv6-address-list:
+  constrained-element-sets:
+    properties:
+      constrained-element-set:
+        type: array
+        items:          
+          $ref: "#/definitions/constrained-element-set"
+  ctag-assignment:
     description: |
-      IPv6 Address Range
       ###### Related Nodes
-      - TO instance-group (Many2Many)
-      - TO l3-network (Many2Many)
-      - TO subnet (Many2Many)
-      - TO vnfc (is composed of l3-interface-ipv6-address-list, Many2One)
-      - FROM l-interface (is composed of l3-interface-ipv6-address-list)
-      - FROM vlan (is composed of l3-interface-ipv6-address-list)
+      - TO l3-network( ctag-assignment BelongsTo l3-network, MANY2ONE)(4)
+      - FROM service-instance( service-instance Uses ctag-assignment, ONE2MANY)
+
+      -(4) IF this TO node is deleted, this CTAG-ASSIGNMENT is DELETED also
     required:
-    - l3-interface-ipv6-address
+    - vlan-id-inner
     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
+        description: id.
       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:
+  ctag-assignments:
+    properties:
+      ctag-assignment:
+        type: array
+        items:          
+          $ref: "#/definitions/ctag-assignment"
+  ctag-pool:
     description: |
-      Definition of vlan
+      A collection of C tags (vlan tags) grouped for a specific purpose.
       ###### 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 complex( ctag-pool BelongsTo complex, MANY2ONE)(4)
+      - TO availability-zone( ctag-pool AppliesTo availability-zone, MANY2MANY)
+      - FROM generic-vnf( generic-vnf Uses ctag-pool, MANY2MANY)
+      - FROM vpls-pe( vpls-pe Uses ctag-pool, MANY2MANY)
+
+      -(4) IF this TO node is deleted, this CTAG-POOL is DELETED also
     required:
-    - vlan-interface
-    - in-maint
-    - is-ip-unnumbered
+    - target-pe
+    - availability-zone-name
+    - ctag-pool-purpose
     properties:
-      vlan-interface:
+      target-pe:
         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:
+        description: The Target provider edge router
+      availability-zone-name:
         type: string
-        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
-      speed-value:
+        description: Name of the availability zone
+      ctag-pool-purpose:
         type: string
-        description: Captures the numeric part of the speed
-      speed-units:
+        description: Describes what the intended purpose of this pool is.
+      ctag-values:
         type: string
-        description: Captures the units corresponding to the speed
-      vlan-description:
+        description: Comma separated list of ctags
+      resource-version:
         type: string
-        description: Used to describe (the service associated with) the vlan
-      backdoor-connection:
+        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 BelongsTo customer, MANY2ONE)(1)
+
+      -(1) IF this CUSTOMER node is deleted, this FROM node is DELETED also
+    required:
+    - global-customer-id
+    - subscriber-name
+    - subscriber-type
+    properties:
+      global-customer-id:
         type: string
-        description: Whether customer is going to use this VLAN for backdoor connection to another customer premise device.
-      vpn-key:
+        description: Global customer id used across ECOMP to uniquely identify customer.
+      subscriber-name:
         type: string
-        description: This indicates the customers VPN ID associated with this vlan
-      orchestration-status:
+        description: Subscriber name, an alternate way to retrieve a customer.
+      subscriber-type:
         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: Subscriber type, a way to provide VID with only the INFRA customers.
+      resource-version:
         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: 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"
-      l3-interface-ipv4-address-list:
+  customers:
+    description: |
+      Collection of customer identifiers to provide linkage back to BSS information.
+    properties:
+      customer:
         type: array
         items:          
-          $ref: "#/definitions/l3-interface-ipv4-address-list"
-      l3-interface-ipv6-address-list:
+          $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/l3-interface-ipv6-address-list"
-  vlans:
+        items:
+          $ref: "#/definitions/relationship"
+  cvlan-tags:
     properties:
-      vlan:
+      cvlan-tag-entry:
         type: array
         items:          
-          $ref: "#/definitions/vlan"
-  sriov-vf:
+          $ref: "#/definitions/cvlan-tag-entry"
+  dvs-switch:
     description: |
-      SR-IOV Virtual Function (not to be confused with virtual network function)
+      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 sriov-pf (Many2One)
-      - FROM l-interface (is composed of sriov-vf)
+      - TO cloud-region( dvs-switch BelongsTo cloud-region, MANY2ONE)
+      - TO availability-zone( dvs-switch AppliesTo availability-zone, MANY2MANY)
+
     required:
-    - pci-id
+    - switch-name
+    - vcenter-url
     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:
+      switch-name:
         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: DVS switch name
+      vcenter-url:
         type: string
-        description: This option is used to set the link status.  Valid values as of 1607 are on, off, and auto.
+        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.
-      neutron-network-id:
-        type: string
-        description: Neutron network id of the interface
       relationship-list:
         type: array
         items:
           $ref: "#/definitions/relationship"
-  sriov-vfs:
+  dvs-switches:
     description: |
-      Collection of SR-IOV Virtual Functions.
+      Collection of digital virtual switch metadata used for vmWare VCEs and GenericVnfs.
     properties:
-      sriov-vf:
+      dvs-switch:
         type: array
         items:          
-          $ref: "#/definitions/sriov-vf"
-  l-interface:
+          $ref: "#/definitions/dvs-switch"
+  edge-prop-names:
     description: |
-      Logical interfaces, e.g., a vnic.
-      ###### 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)
-    required:
-    - interface-name
-    - is-port-mirrored
-    - in-maint
-    - is-ip-unnumbered
+      Internal map to define the properties of an edge and interpret the map EdgeRules
     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:
+      edgeLabel:
         type: string
-        description: Questionably placed - v6 ip addr of this interface (is in vr-lan-interface from Mary B.
-      selflink:
+      direction:
         type: string
-        description: URL to endpoint where AAI can get more details
-      interface-id:
+      multiplicityRule:
         type: string
-        description: ID of interface
-      macaddr:
+      contains-other-v:
         type: string
-        description: MAC address for the interface
-      network-name:
+      delete-other-v:
         type: string
-        description: Name of the network
-      management-option:
+      SVC-INFRA:
         type: string
-        description: Whether A&AI should be managing this interface of not. Could have value like CUSTOMER
-      interface-description:
+      prevent-delete:
         type: string
-        description: Human friendly text regarding this interface.
-      is-port-mirrored:
-        type: boolean
-      resource-version:
+  edge-tag-query-request:
+    properties:
+      edge-tag:
         type: string
-        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
-      in-maint:
-        type: boolean
-      prov-status:
+      result-detail:
         type: string
-        description: Prov Status of the logical interface. Valid values [PREPROV/NVTPROV/PROV].
-      is-ip-unnumbered:
-        type: boolean
-      allowed-address-pairs:
+      start-node-type:
         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:
+      start-node-filter:
         type: array
-        items:
-          $ref: "#/definitions/relationship"
-      l3-interface-ipv4-address-list:
+        items:          
+          $ref: "#/definitions/start-node-filter"
+      include-node-filter:
         type: array
         items:          
-          $ref: "#/definitions/l3-interface-ipv4-address-list"
-      l3-interface-ipv6-address-list:
+          $ref: "#/definitions/include-node-filter"
+      secondary-filter:
         type: array
         items:          
-          $ref: "#/definitions/l3-interface-ipv6-address-list"
-  l-interfaces:
-    description: |
-      Collection of logical interfaces.
+          $ref: "#/definitions/secondary-filter"
+  edge-tag-query-result:
     properties:
-      l-interface:
+      tagged-inventory-item-list:
         type: array
         items:          
-          $ref: "#/definitions/l-interface"
-  vserver:
+          $ref: "#/definitions/tagged-inventory-item-list"
+  element-choice-set:
     description: |
-      Virtual Servers, aka virtual machine or VM.
+      This is how we would capture constraints defining allowed sets of elements.
       ###### 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
+      - TO constrained-element-set( element-choice-set BelongsTo constrained-element-set, MANY2ONE)(4)
+      - FROM model-element( model-element BelongsTo element-choice-set, MANY2ONE)(1)
+
+      -(1) IF this ELEMENT-CHOICE-SET node is deleted, this FROM node is DELETED also
+      -(4) IF this TO node is deleted, this ELEMENT-CHOICE-SET is DELETED also
     required:
-    - vserver-id
-    - vserver-name
-    - vserver-selflink
-    - in-maint
-    - is-closed-loop-disabled
+    - element-choice-set-uuid
+    - element-choice-set-name
     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:
+      element-choice-set-uuid:
         type: string
-        description: Alternative name of vserver
-      prov-status:
+      element-choice-set-name:
         type: string
-        description: Trigger for operational monitoring of this resource by Service Assurance systems.
-      vserver-selflink:
+      cardinality:
         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:
+      model-elements:
         type: array
         items:
-          $ref: "#/definitions/volume"
+          $ref: "#/definitions/model-element"
       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.
+  element-choice-sets:
     properties:
-      vserver:
+      element-choice-set:
         type: array
         items:          
-          $ref: "#/definitions/vserver"
-  tenant:
+          $ref: "#/definitions/element-choice-set"
+  entitlement:
     description: |
-      Openstack tenant
+      Metadata for entitlement group.
       ###### Related Nodes
-      - TO l3-network (Many2Many)
-      - TO service-subscription (Many2Many)
-      - TO vserver (comprises tenant, One2Many)
-      - FROM cloud-region (is composed of tenant)
-      - FROM group-assignment
-      - FROM volume-group
+      - TO generic-vnf( entitlement BelongsTo generic-vnf, MANY2ONE)(4)
+      - TO vce( entitlement BelongsTo vce, MANY2ONE)(4)
+
+      -(4) IF this TO node is deleted, this ENTITLEMENT is DELETED also
     required:
-    - tenant-id
-    - tenant-name
+    - group-uuid
+    - resource-uuid
     properties:
-      tenant-id:
-        type: string
-        description: Unique id relative to the cloud-region.
-      tenant-name:
+      group-uuid:
         type: string
-        description: Readable name of tenant
-      tenant-context:
+        description: Unique ID for the entitlement group the resource comes from, should be uuid.
+      resource-uuid:
         type: string
-        description: This field will store the tenant context.
+        description: Unique ID of an entitlement resource. 
       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"
+        description: Concurrency value
       relationship-list:
         type: array
         items:
           $ref: "#/definitions/relationship"
-  tenants:
+  entitlements:
     description: |
-      Collection of openstack tenants.
+      Entitlements, keyed by group-uuid and resource-uuid, related to license management
     properties:
-      tenant:
+      entitlement:
         type: array
         items:          
-          $ref: "#/definitions/tenant"
-  flavor:
+          $ref: "#/definitions/entitlement"
+  esr-ems:
     description: |
-      Openstack flavor.
+      Persist EMS address information used by EMS driver.
       ###### Related Nodes
-      - FROM cloud-region (is composed of flavor)
-      - FROM vserver
+      - FROM esr-system-info( esr-system-info BelongsTo esr-ems, MANY2ONE)(1)
+
+      -(1) IF this ESR-EMS node is deleted, this FROM node is DELETED also
     required:
-    - flavor-id
-    - flavor-name
-    - flavor-selflink
+    - ems-id
     properties:
-      flavor-id:
+      ems-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:
+        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: array
-        items:
-          $ref: "#/definitions/relationship"
-  flavors:
-    description: |
-      Collection of openstack flavors.
+        type: object
+        $ref: "#/definitions/relationship-list"
+  esr-ems-list:
     properties:
-      flavor:
+      esr-ems:
         type: array
         items:          
-          $ref: "#/definitions/flavor"
-  group-assignment:
+          $ref: "#/definitions/esr-ems"
+  esr-system-info:
     description: |
-      Openstack group-assignment used to store exclusivity groups (EG).
+      Persist common address information of external systems.
       ###### Related Nodes
-      - TO tenant (Many2Many)
-      - TO pserver (One2Many)
-      - FROM cloud-region (is composed of group-assignment)
+      - TO esr-ems( esr-system-info BelongsTo esr-ems, MANY2ONE)(4)
+      - TO esr-vnfm( esr-system-info BelongsTo esr-vnfm, ONE2ONE)(4)
+      - TO esr-thirdparty-sdnc( esr-system-info BelongsTo esr-thirdparty-sdnc, ONE2ONE)(4)
+      - TO cloud-region( esr-system-info BelongsTo cloud-region, MANY2ONE)(4)
+
+      -(4) IF this TO node is deleted, this ESR-SYSTEM-INFO is DELETED also
     required:
-    - group-id
-    - group-type
-    - group-name
+    - esr-system-info-id
+    - user-name
+    - password
+    - system-type
     properties:
-      group-id:
+      esr-system-info-id:
         type: string
-        description: Group id, expected to be unique across cloud-region.
-      group-type:
+        description: Unique ID of esr system info.
+      system-name:
         type: string
-        description: Group type - the type of group this instance refers to
-      group-name:
+        description: name of external system.
+      type:
         type: string
-        description: Group name - name assigned to the group
-      group-description:
+        description: type of external systems.
+      vendor:
         type: string
-        description: Group description - description of the group
+        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.
@@ -42217,172 +45699,223 @@ definitions:
         type: array
         items:
           $ref: "#/definitions/relationship"
-  group-assignments:
+  esr-system-info-list:
     description: |
-      Collection of openstack group assignments
+      Collection of persistent block-level external system auth info.
     properties:
-      group-assignment:
+      esr-system-info:
         type: array
         items:          
-          $ref: "#/definitions/group-assignment"
-  snapshot:
+          $ref: "#/definitions/esr-system-info"
+  esr-thirdparty-sdnc:
     description: |
-      Openstack snapshot
+      Persist SDNC address information used by ONAP SDNC.
       ###### Related Nodes
-      - FROM cloud-region (is composed of snapshot)
-      - FROM vserver
+      - TO pnf( esr-thirdparty-sdnc AppliesTo pnf, ONE2MANY)
+      - FROM esr-system-info( esr-system-info BelongsTo esr-thirdparty-sdnc, ONE2ONE)(1)
+
+      -(1) IF this ESR-THIRDPARTY-SDNC node is deleted, this FROM node is DELETED also
     required:
-    - snapshot-id
+    - thirdparty-sdnc-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:
+      thirdparty-sdnc-id:
         type: string
-        description: The version of the application.
-      snapshot-selflink:
+        description: Unique ID of SDNC.
+      location:
         type: string
-        description: URL to endpoint where AAI can get more details
-      prev-snapshot-id:
+        description: used for DC type to indicate the location of SDNC, such as Core or Edge.
+      product-name:
         type: string
-        description: This field contains the UUID of the previous snapshot (if any).
+        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: array
-        items:
-          $ref: "#/definitions/relationship"
-  snapshots:
-    description: |
-      Collection of openstack snapshots
+        type: object
+        $ref: "#/definitions/relationship-list"
+  esr-thirdparty-sdnc-list:
     properties:
-      snapshot:
+      esr-thirdparty-sdnc:
         type: array
         items:          
-          $ref: "#/definitions/snapshot"
-  metadatum:
+          $ref: "#/definitions/esr-thirdparty-sdnc"
+  esr-vnfm:
     description: |
-      Key/value pairs
+      Persist VNFM address information used by VF-C.
       ###### Related Nodes
-      - FROM configuration (is composed of metadatum)
-      - 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)
+      - FROM esr-system-info( esr-system-info BelongsTo esr-vnfm, ONE2ONE)(1)
+
+      -(1) IF this ESR-VNFM node is deleted, this FROM node is DELETED also
     required:
-    - metaname
-    - metaval
+    - vnfm-id
     properties:
-      metaname:
+      vnfm-id:
         type: string
-      metaval:
+        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.
-  metadata:
-    description: |
-      Collection of metadatum (key/value pairs)
+      esr-system-info-list:
+        type: object
+        $ref: "#/definitions/esr-system-info-list"
+      relationship-list:
+        type: object
+        $ref: "#/definitions/relationship-list"
+  esr-vnfm-list:
     properties:
-      metadatum:
+      esr-vnfm:
         type: array
         items:          
-          $ref: "#/definitions/metadatum"
-  image:
+          $ref: "#/definitions/esr-vnfm"
+  evc:
     description: |
-      Openstack image.
+      evc object is an optional child object of the Configuration object.
       ###### Related Nodes
-      - TO metadatum (comprises image, Many2Many)
-      - FROM cloud-region (is composed of image)
-      - FROM vserver
+      - TO configuration( evc BelongsTo configuration, ONE2ONE)(4)
+
+      -(4) IF this TO node is deleted, this EVC is DELETED also
     required:
-    - image-id
-    - image-name
-    - image-os-distro
-    - image-os-version
-    - image-selflink
+    - evc-id
     properties:
-      image-id:
+      evc-id:
         type: string
-        description: Image id, expected to be unique across cloud region
-      image-name:
+        description: Unique/key field for the evc object
+      forwarding-path-topology:
         type: string
-        description: Image name
-      image-architecture:
+        description: Point-to-Point, Multi-Point
+      cir-value:
         type: string
-        description: Operating system architecture.
-      image-os-distro:
+        description: Commited Information Rate
+      cir-units:
         type: string
-        description: The common name of the operating system distribution in lowercase
-      image-os-version:
+        description: CIR units
+      connection-diversity-group-id:
         type: string
-        description: The operating system version as specified by the distributor.
-      application:
+        description: Diversity Group ID
+      service-hours:
         type: string
-        description: The application that the image instantiates.
-      application-vendor:
+        description: formerly Performance Group
+      esp-evc-circuit-id:
         type: string
-        description: The vendor of the application.
-      application-version:
+        description: EVC Circuit ID of ESP EVC
+      esp-evc-cir-value:
         type: string
-        description: The version of the application.
-      image-selflink:
+        description: Committed Information Rate (For ESP)
+      esp-evc-cir-units:
         type: string
-        description: URL to endpoint where AAI can get more details
-      resource-version:
+        description: CIR units (For ESP)
+      esp-itu-code:
         type: string
-        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+        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"
-      metadata:
+      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/metadatum"
-  images:
+        items:          
+          $ref: "#/definitions/evc"
+  external-system:
     description: |
-      Collectio of Openstack images.
+      Namespace for external system.
     properties:
-      image:
+      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/image"
-  dvs-switch:
+          $ref: "#/definitions/extra-property"
+  extra-property:
+    properties:
+      property-name:
+        type: string
+      property-value:
+        type: string
+  flavor:
     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. 
+      Openstack flavor.
       ###### Related Nodes
-      - TO availability-zone (Many2Many)
-      - FROM cloud-region (is composed of dvs-switch)
+      - TO cloud-region( flavor BelongsTo cloud-region, MANY2ONE)
+      - FROM vserver( vserver Uses flavor, MANY2ONE)
+
+      -FLAVOR cannot be deleted if related to VSERVER
+
     required:
-    - switch-name
-    - vcenter-url
+    - flavor-id
+    - flavor-name
+    - flavor-selflink
     properties:
-      switch-name:
+      flavor-id:
         type: string
-        description: DVS switch name
-      vcenter-url:
+        description: Flavor id, expected to be unique across cloud-region.
+      flavor-name:
         type: string
-        description: URL used to reach the vcenter
+        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.
@@ -42390,307 +45923,404 @@ definitions:
         type: array
         items:
           $ref: "#/definitions/relationship"
-  dvs-switches:
+  flavors:
     description: |
-      Collection of digital virtual switch metadata used for vmWare VCEs and GenericVnfs.
+      Collection of openstack flavors.
     properties:
-      dvs-switch:
+      flavor:
         type: array
         items:          
-          $ref: "#/definitions/dvs-switch"
-  oam-network:
+          $ref: "#/definitions/flavor"
+  forwarder:
     description: |
-      OAM network, to be deprecated shortly.  Do not use for new purposes. 
+      Entity describing a sequenced segment of forwarding path
       ###### Related Nodes
-      - TO complex (Many2Many)
-      - TO service-capability (Many2Many)
-      - FROM cloud-region (is composed of oam-network)
+      - TO forwarding-path( forwarder BelongsTo forwarding-path, MANY2ONE)(4)
+      - TO l-interface( forwarder ForwardsTo l-interface, MANY2ONE)
+      - TO configuration( forwarder Uses configuration, ONE2ONE)(2)
+      - TO lag-interface( forwarder ForwardsTo lag-interface, MANY2ONE)
+      - TO p-interface( forwarder ForwardsTo p-interface, MANY2ONE)
+
+      -(2) IF this FORWARDER node is deleted, this TO node is DELETED also
+      -(4) IF this TO node is deleted, this FORWARDER is DELETED also
     required:
-    - network-uuid
-    - network-name
-    - cvlan-tag
+    - sequence
     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:
+      sequence:
         type: integer
         format: int32
-        description: Used for VNF firewall rule so customer cannot send customer traffic over this oam network
-      resource-version:
+        description: Unique ID of this segmentation
+      forwarder-role:
         type: string
-        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+        description: ingress, intermediate, egress
       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"
-  availability-zone:
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency. Must be empty on create, valid on update and delete.
+  forwarder-evc:
     description: |
-      Availability zone, a collection of compute hosts/pservers
+      forwarder object is an optional child object of the Configuration object.
       ###### 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
+      - TO configuration( forwarder-evc BelongsTo configuration, ONE2ONE)(4)
+
+      -(4) IF this TO node is deleted, this FORWARDER-EVC is DELETED also
     required:
-    - availability-zone-name
-    - hypervisor-type
+    - forwarder-evc-id
     properties:
-      availability-zone-name:
+      forwarder-evc-id:
         type: string
-        description: Name of the availability zone.  Unique across a cloud region
-      hypervisor-type:
+        description: Key for forwarder-evc object
+      circuit-id:
         type: string
-        description: Type of hypervisor.  Source of truth should define valid values.
-      operational-status:
+        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: State that indicates whether the availability zone should be used, etc.  Source of truth should define valid values.
-      resource-version:
+        description: Internal VLAN.
+      svlan:
         type: string
-        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+        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"
-  availability-zones:
-    description: |
-      Collection of availability zones
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency. Must be empty on create, valid on update and delete.
+  forwarder-evcs:
     properties:
-      availability-zone:
+      forwarder-evc:
         type: array
         items:          
-          $ref: "#/definitions/availability-zone"
-  esr-system-info:
+          $ref: "#/definitions/forwarder-evc"
+  forwarders:
+    properties:
+      forwarder:
+        type: array
+        items:          
+          $ref: "#/definitions/forwarder"
+  forwarding-path:
     description: |
-      Persist common address information of external systems.
+      Entity that describes the sequenced forwarding path between interfaces of services or resources
       ###### Related Nodes
-      - FROM esr-ems (is composed of esr-system-info)
-      - FROM esr-vnfm (is composed of esr-system-info)
-      - FROM esr-thirdparty-sdnc (is composed of esr-system-info)
-      - FROM cloud-region (is composed of esr-system-info)
+      - TO service-instance( forwarding-path AppliesTo service-instance, MANY2ONE)(4)
+      - TO configuration( forwarding-path Uses configuration, ONE2ONE)(2)
+      - FROM forwarder( forwarder BelongsTo forwarding-path, MANY2ONE)(1)
+
+      -(1) IF this FORWARDING-PATH node is deleted, this FROM node is DELETED also
+      -(2) IF this FORWARDING-PATH node is deleted, this TO node is DELETED also
+      -(4) IF this TO node is deleted, this FORWARDING-PATH is DELETED also
     required:
-    - esr-system-info-id
-    - user-name
-    - password
-    - system-type
+    - forwarding-path-id
+    - forwarding-path-name
     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:
+      forwarding-path-id:
         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:
+        description: Unique ID of this FP
+      forwarding-path-name:
         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.
+        description: Name of the FP
       relationship-list:
         type: array
         items:
           $ref: "#/definitions/relationship"
-  esr-system-info-list:
-    description: |
-      Collection of persistent block-level external system auth info.
+      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:
-      esr-system-info:
+      forwarding-path:
         type: array
         items:          
-          $ref: "#/definitions/esr-system-info"
-  cloud-region:
+          $ref: "#/definitions/forwarding-path"
+  generic-vnf:
     description: |
-      cloud-region designates an installation of a cloud cluster or region or instantiation.
+      General purpose VNF
       ###### Related Nodes
-      - TO esr-system-info (comprises cloud-region, One2Many)
-      - TO complex (Many2One)
-      - TO l3-network (Many2Many)
-      - TO tenant (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
+      - TO availability-zone( generic-vnf Uses availability-zone, MANY2MANY)
+      - TO complex( generic-vnf LocatedIn complex, MANY2MANY)
+      - TO configuration( generic-vnf Uses configuration, ONE2MANY)(2)
+      - TO ctag-pool( generic-vnf Uses ctag-pool, MANY2MANY)
+      - TO instance-group( generic-vnf MemberOf instance-group, MANY2MANY)
+      - TO ipsec-configuration( generic-vnf Uses ipsec-configuration, MANY2ONE)
+      - TO l3-network( generic-vnf Uses l3-network, MANY2MANY)
+      - TO license-key-resource( generic-vnf Uses license-key-resource, MANY2MANY)
+      - TO pnf( generic-vnf HostedOn pnf, MANY2MANY)
+      - TO pserver( generic-vnf HostedOn pserver, MANY2MANY)
+      - TO vnf-image( generic-vnf Uses vnf-image, MANY2ONE)
+      - TO volume-group( generic-vnf DependsOn volume-group, ONE2MANY)
+      - TO vserver( generic-vnf HostedOn vserver, ONE2MANY)
+      - TO virtual-data-center( generic-vnf LocatedIn virtual-data-center, MANY2MANY)
+      - FROM allotted-resource( allotted-resource PartOf generic-vnf, MANY2MANY)
+      - FROM entitlement( entitlement BelongsTo generic-vnf, MANY2ONE)(1)
+      - FROM vnfc( vnfc BelongsTo generic-vnf, MANY2ONE)(1)
+      - FROM lag-interface( lag-interface BelongsTo generic-vnf, MANY2ONE)(1)
+      - FROM license( license BelongsTo generic-vnf, MANY2ONE)(1)
+      - FROM l-interface( l-interface BelongsTo generic-vnf, MANY2ONE)(1)
+      - FROM network-profile( network-profile AppliesTo generic-vnf, MANY2MANY)
+      - FROM service-instance( service-instance ComposedOf generic-vnf, ONE2MANY)
+      - FROM site-pair-set( site-pair-set AppliesTo generic-vnf, MANY2MANY)
+      - FROM vf-module( vf-module BelongsTo generic-vnf, MANY2ONE)(1)
+      - FROM line-of-business( line-of-business Uses generic-vnf, MANY2MANY)
+      - FROM logical-link( logical-link BridgedTo generic-vnf, MANY2MANY)
+      - FROM platform( platform Uses generic-vnf, MANY2MANY)
+
+      -(1) IF this GENERIC-VNF node is deleted, this FROM node is DELETED also
+      -(2) IF this GENERIC-VNF node is deleted, this TO node is DELETED also
     required:
-    - cloud-owner
-    - cloud-region-id
-    - sriov-automation
+    - vnf-id
+    - vnf-name
+    - vnf-type
+    - in-maint
+    - is-closed-loop-disabled
     properties:
-      cloud-owner:
+      vnf-id:
         type: string
-        description: Identifies the vendor and cloud name. First part of composite key should be formatted as vendor-cloudname
-      cloud-region-id:
+        description: Unique id of VNF.  This is unique across the graph.
+      vnf-instance-id:
         type: string
-        description: Identifier used by the vendor for the region. Second part of composite key
-      cloud-type:
+        description: vnf instance id.
+      vnf-name:
         type: string
-        description: Type of the cloud (e.g., openstack)
-      owner-defined-type:
+        description: Name of VNF.
+      vnf-name2:
         type: string
-        description: Cloud-owner defined type indicator (e.g., dcp, lcp)
-      cloud-region-version:
+        description: Alternate name of VNF.
+      vnf-type:
         type: string
-        description: Software version employed at the site.  NOTE - THIS FIELD IS NOT KEPT UP TO DATE.
-      identity-url:
+        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: URL of the keystone identity service
-      cloud-zone:
+        description: Unique identifier of service, does not necessarily map to ASDC service models.  SOON TO BE DEPRECATED
+      regional-resource-zone:
         type: string
-        description: Zone where the cloud is homed.  NOTE - THIS FIELD IS NOT CORRECTLY POPULATED.
-      complex-name:
+        description: Regional way of organizing pservers, source of truth should define values
+      prov-status:
         type: string
-        description: complex name for cloud-region instance.  NOTE - THIS FIELD IS NOT CORRECTLY POPULATED.
-      sriov-automation:
-        type: boolean
-      cloud-extra-info:
+        description: Trigger for operational monitoring of this resource by Service Assurance systems.
+      operational-status:
         type: string
-        description: ESR inputs extra information about the VIM or Cloud which will be decoded by MultiVIM.
-      cloud-epa-caps:
+        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: MultiVIM will discover and expose EPA capabilities.
-      resource-version:
+        description: OBSOLETE -  do not use
+      equipment-role:
         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:
+        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
+        description: used to indicate whether or not this object is in maintenance mode (maintenance mode = true). This field (in conjunction with prov-status) is used to suppress alarms and vSCL on VNFs/VMs.
+      is-closed-loop-disabled:
+        type: boolean
+        description: used to indicate whether closed loop function is enabled on this node
+      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/image"
-      dvs-switches:
+          $ref: "#/definitions/relationship"
+      l-interfaces:
         type: array
         items:
-          $ref: "#/definitions/dvs-switch"
-      oam-networks:
+          $ref: "#/definitions/l-interface"
+      lag-interfaces:
         type: array
         items:
-          $ref: "#/definitions/oam-network"
-      availability-zones:
+          $ref: "#/definitions/lag-interface"
+      vf-modules:
         type: array
         items:
-          $ref: "#/definitions/availability-zone"
-      relationship-list:
+          $ref: "#/definitions/vf-module"
+      licenses:
         type: array
         items:
-          $ref: "#/definitions/relationship"
-      esr-system-info-list:
+          $ref: "#/definitions/license"
+      entitlements:
         type: array
         items:
-          $ref: "#/definitions/esr-system-info"
-  cloud-regions:
+          $ref: "#/definitions/entitlement"
+  generic-vnfs:
+    description: |
+      Collection of VNFs
     properties:
-      cloud-region:
+      generic-vnf:
         type: array
         items:          
-          $ref: "#/definitions/cloud-region"
-  network-profile:
+          $ref: "#/definitions/generic-vnf"
+  group-assignment:
     description: |
-      Network profile populated by SDN-GP for SNMP
+      Openstack group-assignment used to store exclusivity groups (EG).
       ###### Related Nodes
-      - FROM generic-vnf
+      - TO cloud-region( group-assignment BelongsTo cloud-region, MANY2ONE)
+      - FROM pserver( pserver MemberOf group-assignment, MANY2ONE)
+      - FROM tenant( tenant MemberOf group-assignment, MANY2MANY)
+
     required:
-    - nm-profile-name
+    - group-id
+    - group-type
+    - group-name
     properties:
-      nm-profile-name:
+      group-id:
         type: string
-        description: Unique name of network profile.
-      community-string:
+        description: Group id, expected to be unique across cloud-region.
+      group-type:
         type: string
-        description: Encrypted SNMP community 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.
@@ -42698,26 +46328,37 @@ definitions:
         type: array
         items:
           $ref: "#/definitions/relationship"
-  network-profiles:
+  group-assignments:
     description: |
-      Collection of network profiles
+      Collection of openstack group assignments
     properties:
-      network-profile:
+      group-assignment:
         type: array
         items:          
-          $ref: "#/definitions/network-profile"
-  sriov-pf:
+          $ref: "#/definitions/group-assignment"
+  host-route:
     description: |
-      SR-IOV Physical Function
       ###### Related Nodes
-      - FROM p-interface (is composed of sriov-pf)
-      - FROM sriov-vf
+      - TO subnet( host-route BelongsTo subnet, MANY2ONE)(4)
+
+      -(4) IF this TO node is deleted, this HOST-ROUTE is DELETED also
     required:
-    - pf-pci-id
+    - host-route-id
+    - route-prefix
+    - next-hop
     properties:
-      pf-pci-id:
+      host-route-id:
         type: string
-        description: Identifier for the sriov-pf
+        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.
@@ -42725,551 +46366,649 @@ definitions:
         type: array
         items:
           $ref: "#/definitions/relationship"
-  sriov-pfs:
+  host-routes:
+    properties:
+      host-route:
+        type: array
+        items:          
+          $ref: "#/definitions/host-route"
+  hpa-capabilities:
     description: |
-      Collection of SR-IOV Physical Functions.
+      Collection of HPA Capabilities
     properties:
-      sriov-pf:
+      hpa-capability:
         type: array
         items:          
-          $ref: "#/definitions/sriov-pf"
-  p-interface:
+          $ref: "#/definitions/hpa-capability"
+  hpa-capability:
     description: |
-      Physical interface (e.g., nic)
+      Represents a HPA capability
       ###### 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)
+      - TO flavor( hpa-capability BelongsTo flavor, MANY2ONE)
+      - TO cloud-region( hpa-capability BelongsTo cloud-region, MANY2ONE)
+      - FROM hpa-feature-attributes( hpa-feature-attributes BelongsTo hpa-capability, MANY2ONE)(1)
+
+      -(1) IF this HPA-CAPABILITY node is deleted, this FROM node is DELETED also
     required:
-    - interface-name
-    - in-maint
+    - hpa-capability-id
+    - hpa-feature
     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:
+      hpa-capability-id:
         type: string
-        description: CLEI or other specification for p-interface hardware.
-      interface-role:
-        type: string
-        description: Role specification for p-interface hardware.
-      interface-type:
+        description: UUID to uniquely identify a HPA capability
+      hpa-feature:
         type: string
-        description: Indicates the physical properties of the interface.
-      prov-status:
+        description: Name of the HPACapability
+      hpa-version:
         type: string
-        description: Trigger for operational monitoring of this resource by Service Assurance systems.
-      mac-addresss:
+        description: HPA schema version
+      architecture:
         type: string
-        description: MAC Address of the p-interface.
+        description: Hardware architecture
       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:
+      hpa-feature-attributes:
         type: array
         items:          
-          $ref: "#/definitions/p-interface"
-  lag-interface:
+          $ref: "#/definitions/hpa-feature-attributes"
+  hpa-feature-attributes:
     description: |
-      Link aggregate interface
+      HPA Capability Feature attributes
       ###### 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)
+      - TO hpa-capability( hpa-feature-attributes BelongsTo hpa-capability, MANY2ONE)(4)
+
+      -(4) IF this TO node is deleted, this HPA-FEATURE-ATTRIBUTES is DELETED also
     required:
-    - interface-name
-    - in-maint
+    - hpa-attribute-key
     properties:
-      interface-name:
+      hpa-attribute-key:
         type: string
-        description: Name that identifies the link aggregate interface
-      interface-description:
+        description: name of the specific HPA attribute
+      hpa-attribute-value:
         type: string
-        description: Human friendly text regarding this interface.
+        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.
-      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"
-  pserver:
+  image:
     description: |
-      Compute host whose hostname must be unique and must exactly match what is sent as a relationship to a vserver.
+      Openstack image.
       ###### 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
+      - TO cloud-region( image BelongsTo cloud-region, MANY2ONE)
+      - FROM metadatum( metadatum BelongsTo image, MANY2ONE)(1)
+      - FROM vserver( vserver Uses image, MANY2ONE)
+
+      -(1) IF this IMAGE node is deleted, this FROM node is DELETED also
+      -IMAGE cannot be deleted if related to VSERVER
+
     required:
-    - hostname
-    - in-maint
+    - image-id
+    - image-name
+    - image-os-distro
+    - image-os-version
+    - image-selflink
     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:
+      image-id:
         type: string
-        description: Serial number, may be queried
-      ipaddress-v4-loopback-0:
+        description: Image id, expected to be unique across cloud region
+      image-name:
         type: string
-        description: IPV4 Loopback 0 address
-      ipaddress-v6-loopback-0:
+        description: Image name
+      image-architecture:
         type: string
-        description: IPV6 Loopback 0 address
-      ipaddress-v4-aim:
+        description: Operating system architecture.
+      image-os-distro:
         type: string
-        description: IPV4 AIM address
-      ipaddress-v6-aim:
+        description: The common name of the operating system distribution in lowercase
+      image-os-version:
         type: string
-        description: IPV6 AIM address
-      ipaddress-v6-oam:
+        description: The operating system version as specified by the distributor.
+      application:
         type: string
-        description: IPV6 OAM address
-      inv-status:
+        description: The application that the image instantiates.
+      application-vendor:
         type: string
-        description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
-      pserver-id:
+        description: The vendor of the application.
+      application-version:
         type: string
-        description: ID of Pserver
-      internet-topology:
+        description: The version of the application.
+      image-selflink:
         type: string
-        description: internet topology of Pserver
-      in-maint:
-        type: boolean
+        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.
-      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:
+      metadata:
         type: array
         items:
-          $ref: "#/definitions/p-interface"
-      lag-interfaces:
+          $ref: "#/definitions/metadatum"
+  images:
+    description: |
+      Collectio of Openstack images.
+    properties:
+      image:
         type: array
-        items:
-          $ref: "#/definitions/lag-interface"
-  pservers:
+        items:          
+          $ref: "#/definitions/image"
+  include-node-filter:
+    properties:
+      include-node-type:
+        type: string
+  instance-filter:
     description: |
-      Collection of compute hosts.
+      InstanceFilter for performing a named-query or model query
+  instance-filters:
+    description: |
+      InstanceFilters for performing a named-query or model query
     properties:
-      pserver:
+      instance-filter:
         type: array
         items:          
-          $ref: "#/definitions/pserver"
-  virtual-data-center:
+          $ref: "#/definitions/instance-filter"
+  instance-group:
     description: |
-      Virtual organization of cloud infrastructure elements in a data center context
+      General mechanism for grouping instances
       ###### Related Nodes
-      - TO generic-vnf (Many2Many)
-      - TO logical-link (Many2Many)
-      - FROM connector
+      - TO model( instance-group Targets model, MANY2MANY)
+      - FROM allotted-resource( allotted-resource MemberOf instance-group, MANY2MANY)
+      - FROM generic-vnf( generic-vnf MemberOf instance-group, MANY2MANY)
+      - FROM l3-interface-ipv4-address-list( l3-interface-ipv4-address-list MemberOf instance-group, MANY2MANY)
+      - FROM l3-interface-ipv6-address-list( l3-interface-ipv6-address-list MemberOf instance-group, MANY2MANY)
+      - FROM l3-network( l3-network MemberOf instance-group, MANY2MANY)
+      - FROM l-interface( l-interface MemberOf instance-group, MANY2MANY)
+      - FROM pnf( pnf MemberOf instance-group, MANY2MANY)
+      - FROM service-instance( service-instance MemberOf instance-group, MANY2MANY)
+      - FROM vip-ipv4-address-list( vip-ipv4-address-list MemberOf instance-group, MANY2MANY)
+      - FROM vip-ipv6-address-list( vip-ipv6-address-list MemberOf instance-group, MANY2MANY)
+      - FROM vnfc( vnfc MemberOf instance-group, MANY2MANY)
+
     required:
-    - vdc-id
-    - vdc-name
+    - id
+    - description
+    - type
     properties:
-      vdc-id:
+      instance-group-role:
         type: string
-        description: Unique ID of the vdc
-      vdc-name:
+        description: role of the instance group.
+      model-invariant-id:
         type: string
-        description: Name of the virtual data center
+        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: 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"
-  virtual-data-centers:
+  instance-groups:
     description: |
-      Virtual organization of cloud infrastructure elements in a data center context
+      Collection of openstack route table references
     properties:
-      virtual-data-center:
+      instance-group:
         type: array
         items:          
-          $ref: "#/definitions/virtual-data-center"
-  cloud-infrastructure:
-    description: |
-      Namespace for cloud infrastructure.
+          $ref: "#/definitions/instance-group"
+  inventory:
     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"
-  esr-ems:
-    description: |
-      Persist EMS address information used by EMS driver.
-      ###### Related Nodes
-      - TO esr-system-info (comprises esr-ems, One2Many)
-    required:
-    - ems-id
+      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"
+      nodes:
+        type: object
+        $ref: "#/definitions/nodes"
+  inventory-item:
     properties:
-      ems-id:
+      inventory-item-type:
         type: string
-        description: Unique ID of EMS.
-      resource-version:
+      inventory-item-link:
         type: string
-        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
-      esr-system-info-list:
+      inventory-item-data:
         type: array
-        items:
-          $ref: "#/definitions/esr-system-info"
-      relationship-list:
+        items:          
+          $ref: "#/definitions/inventory-item-data"
+      tagged-inventory-item-list:
         type: array
-        items:
-          $ref: "#/definitions/relationship"
-  esr-ems-list:
+        items:          
+          $ref: "#/definitions/tagged-inventory-item-list"
+  inventory-item-data:
     properties:
-      esr-ems:
+      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/esr-ems"
-  esr-vnfm:
+          $ref: "#/definitions/inventory-response-item"
+  ipsec-configuration:
     description: |
-      Persist VNFM address information used by VF-C.
+      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 esr-system-info (comprises esr-vnfm, One2One)
+      - FROM generic-vnf( generic-vnf Uses ipsec-configuration, MANY2ONE)
+      - FROM vig-server( vig-server BelongsTo ipsec-configuration, MANY2ONE)(1)
+
+      -(1) IF this IPSEC-CONFIGURATION node is deleted, this FROM node is DELETED also
     required:
-    - vnfm-id
+    - ipsec-configuration-id
     properties:
-      vnfm-id:
+      ipsec-configuration-id:
         type: string
-        description: Unique ID of VNFM.
-      vim-id:
+        description: UUID of this configuration
+      requested-vig-address-type:
         type: string
-        description: indecate the VIM to deploy VNF.
-      certificate-url:
+        description: Indicate the type of VIG server like AVPN, INTERNET, BOTH
+      requested-encryption-strength:
         type: string
-        description: certificate url of VNFM.
+        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.
-      esr-system-info-list:
-        type: array
-        items:
-          $ref: "#/definitions/esr-system-info"
       relationship-list:
         type: array
         items:
           $ref: "#/definitions/relationship"
-  esr-vnfm-list:
+      vig-servers:
+        type: array
+        items:
+          $ref: "#/definitions/vig-server"
+  ipsec-configurations:
     properties:
-      esr-vnfm:
+      ipsec-configuration:
         type: array
         items:          
-          $ref: "#/definitions/esr-vnfm"
-  esr-thirdparty-sdnc:
+          $ref: "#/definitions/ipsec-configuration"
+  key-data:
+    properties:
+      key-name:
+        type: string
+      key-value:
+        type: string
+  l-interface:
     description: |
-      Persist SDNC address information used by ONAP SDNC.
+      Logical interfaces, e.g., a vnic.
       ###### Related Nodes
-      - TO esr-system-info (comprises esr-thirdparty-sdnc, One2One)
-      - TO pnf (One2Many)
+      - TO generic-vnf( l-interface BelongsTo generic-vnf, MANY2ONE)(4)
+      - TO lag-interface( l-interface BelongsTo lag-interface, MANY2ONE)(4)
+      - TO instance-group( l-interface MemberOf instance-group, MANY2MANY)
+      - TO l-interface( l-interface BelongsTo l-interface, MANY2ONE)(4)
+      - TO logical-link( l-interface LinksTo logical-link, MANY2MANY)(2)
+      - TO newvce( l-interface BelongsTo newvce, MANY2ONE)(4)
+      - TO p-interface( l-interface BindsTo p-interface, MANY2ONE)(4)
+      - TO vserver( l-interface BindsTo vserver, MANY2ONE)(4)
+      - FROM allotted-resource( allotted-resource Uses l-interface, ONE2MANY)
+      - FROM l3-interface-ipv4-address-list( l3-interface-ipv4-address-list BelongsTo l-interface, MANY2ONE)(1)
+      - FROM l3-interface-ipv6-address-list( l3-interface-ipv6-address-list BelongsTo l-interface, MANY2ONE)(1)
+      - FROM sriov-vf( sriov-vf BelongsTo l-interface, ONE2ONE)(1)
+      - FROM vlan( vlan LinksTo l-interface, MANY2ONE)(1)
+      - FROM l-interface( l-interface BelongsTo l-interface, MANY2ONE)(4)
+
+      -(1) IF this L-INTERFACE node is deleted, this FROM node is DELETED also
+      -(2) IF this L-INTERFACE node is deleted, this TO node is DELETED also
+      -(4) IF this TO node is deleted, this L-INTERFACE is DELETED also
     required:
-    - thirdparty-sdnc-id
+    - interface-name
+    - is-port-mirrored
+    - in-maint
+    - is-ip-unnumbered
     properties:
-      thirdparty-sdnc-id:
+      interface-name:
         type: string
-        description: Unique ID of SDNC.
-      location:
+        description: Name given to the interface
+      interface-role:
         type: string
-        description: used for DC type to indicate the location of SDNC, such as Core or Edge.
-      product-name:
+        description: E.g., CUSTOMER, UPLINK, etc.
+      v6-wan-link-ip:
         type: string
-        description: password used to access SDNC server.
+        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
+        description: boolean indicatating whether or not port is a mirrored.
       resource-version:
         type: string
         description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
-      esr-system-info-list:
+      in-maint:
+        type: boolean
+        description: used to indicate whether or not this object is in maintenance mode (maintenance mode = true)
+      prov-status:
+        type: string
+        description: Prov Status of the logical interface. Valid values [PREPROV/NVTPROV/PROV].
+      is-ip-unnumbered:
+        type: boolean
+        description: Flag indicating the interface uses the IP Unnumbered configuration.
+      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/esr-system-info"
+          $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"
-  esr-thirdparty-sdnc-list:
-    properties:
-      esr-thirdparty-sdnc:
+      l3-interface-ipv4-address-list:
         type: array
         items:          
-          $ref: "#/definitions/esr-thirdparty-sdnc"
-  external-system:
+          $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: |
-      Namespace for external system.
+      Collection of logical interfaces.
     properties:
-      esr-ems-list:
-        type: array
-        items:
-          $ref: "#/definitions/esr-ems"
-      esr-vnfm-list:
-        type: array
-        items:
-          $ref: "#/definitions/esr-vnfm"
-      esr-thirdparty-sdnc-list:
+      l-interface:
         type: array
-        items:
-          $ref: "#/definitions/esr-thirdparty-sdnc"
-  connector:
+        items:          
+          $ref: "#/definitions/l-interface"
+  l3-interface-ipv4-address-list:
     description: |
-      Collection of resource instances used to connect a variety of disparate inventory widgets
+      IPv4 Address Range
       ###### Related Nodes
-      - TO virtual-data-center (Many2Many)
-      - TO metadatum (comprises connector, Many2Many)
-      - FROM service-instance
+      - TO instance-group( l3-interface-ipv4-address-list MemberOf instance-group, MANY2MANY)
+      - TO l3-network( l3-interface-ipv4-address-list MemberOf l3-network, MANY2MANY)
+      - TO subnet( l3-interface-ipv4-address-list MemberOf subnet, MANY2MANY)
+      - TO l-interface( l3-interface-ipv4-address-list BelongsTo l-interface, MANY2ONE)(4)
+      - TO vlan( l3-interface-ipv4-address-list BelongsTo vlan, MANY2ONE)(4)
+      - TO vnfc( l3-interface-ipv4-address-list BelongsTo vnfc, MANY2ONE)(4)
+
+      -(4) IF this TO node is deleted, this L3-INTERFACE-IPV4-ADDRESS-LIST is DELETED also
     required:
-    - resource-instance-id
+    - l3-interface-ipv4-address
     properties:
-      resource-instance-id:
+      l3-interface-ipv4-address:
         type: string
-        description: Unique id of resource instance.
+        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.
-      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:
+      neutron-network-id:
         type: string
-        description: the ASDC data dictionary widget model. This maps directly to the A&AI widget.
-      widget-model-version:
+        description: Neutron network id of the interface that address belongs to
+      neutron-subnet-id:
         type: string
-        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
       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"
-  tunnel-xconnect:
+  l3-interface-ipv6-address-list:
     description: |
-      Represents the specifics of a tunnel cross connect piece of a resource that gets separately allotted
+      IPv6 Address Range
       ###### Related Nodes
-      - FROM allotted-resource (is composed of tunnel-xconnect)
+      - TO instance-group( l3-interface-ipv6-address-list MemberOf instance-group, MANY2MANY)
+      - TO l3-network( l3-interface-ipv6-address-list MemberOf l3-network, MANY2MANY)
+      - TO subnet( l3-interface-ipv6-address-list MemberOf subnet, MANY2MANY)
+      - TO l-interface( l3-interface-ipv6-address-list BelongsTo l-interface, MANY2ONE)(4)
+      - TO vlan( l3-interface-ipv6-address-list BelongsTo vlan, MANY2ONE)(4)
+      - TO vnfc( l3-interface-ipv6-address-list BelongsTo vnfc, MANY2ONE)(4)
+
+      -(4) IF this TO node is deleted, this L3-INTERFACE-IPV6-ADDRESS-LIST is DELETED also
     required:
-    - id
-    - bandwidth-up-wan1
-    - bandwidth-down-wan1
-    - bandwidth-up-wan2
-    - bandwidth-down-wan2
+    - l3-interface-ipv6-address
     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:
+      l3-interface-ipv6-address:
         type: string
-        description: The WAN downlink bandwidth for WAN1
-      bandwidth-up-wan2:
+        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: The WAN uplink bandwidth for WAN2
-      bandwidth-down-wan2:
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      neutron-network-id:
         type: string
-        description: The WAN downlink bandwidth for WAN2
-      resource-version:
+        description: Neutron network id of the interface that address belongs to
+      neutron-subnet-id:
         type: string
-        description: Concurrency value
+        description: Neutron id of subnet that address belongs to
       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"
-  allotted-resource:
+  l3-network:
     description: |
-      Represents a slice or partial piece of a resource that gets separately allotted
+      Generic network definition
       ###### 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 configuration
-      - FROM service-instance (is composed of allotted-resource)
-      - FROM service-instance
-      - FROM allotted-resource
+      - TO instance-group( l3-network MemberOf instance-group, MANY2MANY)
+      - TO network-policy( l3-network Uses network-policy, MANY2MANY)
+      - TO route-table-reference( l3-network Uses route-table-reference, MANY2MANY)
+      - TO vpn-binding( l3-network Uses vpn-binding, MANY2MANY)
+      - FROM allotted-resource( allotted-resource PartOf l3-network, MANY2MANY)
+      - FROM cloud-region( cloud-region Uses l3-network, MANY2MANY)
+      - FROM complex( complex Uses l3-network, MANY2MANY)
+      - FROM generic-vnf( generic-vnf Uses l3-network, MANY2MANY)
+      - FROM l3-interface-ipv4-address-list( l3-interface-ipv4-address-list MemberOf l3-network, MANY2MANY)
+      - FROM l3-interface-ipv6-address-list( l3-interface-ipv6-address-list MemberOf l3-network, MANY2MANY)
+      - FROM ctag-assignment( ctag-assignment BelongsTo l3-network, MANY2ONE)(1)
+      - FROM segmentation-assignment( segmentation-assignment BelongsTo l3-network, MANY2ONE)(1)
+      - FROM service-instance( service-instance ComposedOf l3-network, ONE2MANY)
+      - FROM subnet( subnet BelongsTo l3-network, MANY2ONE)(1)
+      - FROM tenant( tenant Uses l3-network, MANY2MANY)
+      - FROM vf-module( vf-module DependsOn l3-network, MANY2MANY)
+
+      -(1) IF this L3-NETWORK node is deleted, this FROM node is DELETED also
     required:
-    - id
+    - network-id
+    - network-name
+    - is-bound-to-vpn
+    - is-provider-network
+    - is-shared-network
+    - is-external-network
     properties:
-      id:
+      network-id:
         type: string
-        description: Allotted Resource id UUID assigned to this instance.
-      description:
+        description: Network ID, should be uuid. Unique across A&AI.
+      network-name:
         type: string
-        description: The descriptive information assigned to this allotted resource instance
-      selflink:
+        description: Name of the network, governed by some naming convention..
+      network-type:
         type: string
-        description: Link back to more information in the controller
+        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
+        description: Set to true if bound to VPN
+      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.
@@ -43279,227 +47018,187 @@ definitions:
       persona-model-version:
         type: string
         description: the ASDC model version for this resource or service model.
-      resource-version:
+      model-customization-id:
         type: string
-        description: Concurrency value
-      orchestration-status:
+        description: captures the id of all the configuration used to customize the resource for the service.
+      widget-model-id:
         type: string
-        description: Orchestration status
-      operational-status:
+        description: the ASDC data dictionary widget model. This maps directly to the A&AI widget.
+      widget-model-version:
         type: string
-        description: Indicator for whether the resource is considered operational
-      type:
+        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: Generic description of the type of allotted resource.
-      role:
+        description: Name associated with the physical network.
+      is-provider-network:
+        type: boolean
+        description: boolean indicatating whether or not network is a provider network.
+      is-shared-network:
+        type: boolean
+        description: boolean indicatating whether or not network is a shared network.
+      is-external-network:
+        type: boolean
+        description: boolean indicatating whether or not network is an external network.
+      selflink:
         type: string
-        description: role in the network that this resource will be providing.
-      tunnel-xconnects:
+        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/tunnel-xconnect"
+          $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"
-  allotted-resources:
-    description: |
-      This object is used to store slices of services being offered
+        description: Relates to tenant (or is it a child of tenant), complex, service, vpn-binding
+  l3-networks:
     properties:
-      allotted-resource:
+      l3-network:
         type: array
         items:          
-          $ref: "#/definitions/allotted-resource"
-  service-instance:
+          $ref: "#/definitions/l3-network"
+  lag-interface:
     description: |
-      Instance of a service
+      Link aggregate interface
       ###### Related Nodes
-      - TO configuration (One2Many)
-      - 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 owning-entity
-      - FROM project
-      - FROM service-subscription (is composed of service-instance)
-      - FROM vce
-      - FROM service-instance
+      - TO generic-vnf( lag-interface BelongsTo generic-vnf, MANY2ONE)(4)
+      - TO lag-link( lag-interface LinksTo lag-link, MANY2MANY)(2)
+      - TO logical-link( lag-interface Uses logical-link, MANY2MANY)(2)
+      - TO p-interface( lag-interface Uses p-interface, MANY2MANY)
+      - TO pnf( lag-interface BindsTo pnf, MANY2ONE)(4)
+      - TO pserver( lag-interface BindsTo pserver, MANY2ONE)(4)
+      - TO vpls-pe( lag-interface BindsTo vpls-pe, MANY2ONE)(4)
+      - FROM l-interface( l-interface BelongsTo lag-interface, MANY2ONE)(1)
+
+      -(1) IF this LAG-INTERFACE node is deleted, this FROM node is DELETED also
+      -(2) IF this LAG-INTERFACE node is deleted, this TO node is DELETED also
+      -(4) IF this TO node is deleted, this LAG-INTERFACE is DELETED also
     required:
-    - service-instance-id
-    - service-type
-    - service-role
+    - interface-name
+    - in-maint
     properties:
-      service-instance-id:
-        type: string
-        description: Uniquely identifies this instance of a service
-      service-instance-name:
+      interface-name:
         type: string
-        description: This field will store a name assigned to the service-instance.
-      service-type:
+        description: Name that identifies the link aggregate interface
+      interface-description:
         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:
+        description: Human friendly text regarding this interface.
+      resource-version:
         type: string
-        description: indicates the downstream bandwidth this service will use on the WAN2 port of the physical device.
-      vhn-portal-url:
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      speed-value:
         type: string
-        description: URL customers will use to access the vHN Portal.
-      service-instance-location-id:
+        description: Captures the numeric part of the speed
+      speed-units:
         type: string
-        description: An identifier that customers assign to the location where this service is being used.
-      resource-version:
+        description: Captures the units corresponding to the speed
+      interface-id:
         type: string
-        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
-      selflink:
+        description: ID of interface
+      interface-role:
         type: string
-        description: Path to the controller object.
-      orchestration-status:
+        description: Role assigned to this Interface, should use values as defined in ECOMP Yang models.
+      prov-status:
         type: string
-        description: Orchestration status of this service.
+        description: Trigger for operational monitoring of this resource by Service Assurance systems.
+      in-maint:
+        type: boolean
+        description: used to indicate whether or not this object is in maintenance mode (maintenance mode = true)
       relationship-list:
         type: array
         items:
           $ref: "#/definitions/relationship"
-      metadata:
-        type: array
-        items:
-          $ref: "#/definitions/metadatum"
-      allotted-resources:
+      l-interfaces:
         type: array
         items:
-          $ref: "#/definitions/allotted-resource"
-  service-instances:
+          $ref: "#/definitions/l-interface"
+  lag-interfaces:
     description: |
-      Collection of service instances
+      Collection of link aggregate interfaces.
     properties:
-      service-instance:
+      lag-interface:
         type: array
         items:          
-          $ref: "#/definitions/service-instance"
-  service-subscription:
+          $ref: "#/definitions/lag-interface"
+  lag-link:
     description: |
-      Object that group service instances.
+      LAG links can connect lag-interfaces
       ###### Related Nodes
-      - TO service-instance (comprises service-subscription, Many2Many)
-      - FROM customer (is composed of service-subscription)
-      - FROM tenant
+      - FROM lag-interface( lag-interface LinksTo lag-link, MANY2MANY)(3)
+      - FROM logical-link( logical-link Uses lag-link, MANY2MANY)
+
+      -(3) IF this FROM node is deleted, this LAG-LINK is DELETED also
     required:
-    - service-type
+    - link-name
     properties:
-      service-type:
-        type: string
-        description: Value defined by orchestration to identify this service across ECOMP.
-      temp-ub-sub-account-id:
+      link-name:
         type: string
-        description: This property will be deleted from A&AI in the near future. Only stop gap solution.
+        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.
-      service-instances:
-        type: array
-        items:
-          $ref: "#/definitions/service-instance"
       relationship-list:
         type: array
         items:
           $ref: "#/definitions/relationship"
-  service-subscriptions:
+  lag-links:
     description: |
-      Collection of objects that group service instances.
+      Collection of link aggregation connections
     properties:
-      service-subscription:
+      lag-link:
         type: array
         items:          
-          $ref: "#/definitions/service-subscription"
-  customer:
+          $ref: "#/definitions/lag-link"
+  license:
     description: |
-      customer identifiers to provide linkage back to BSS information.
+      Metadata for license group.
       ###### Related Nodes
-      - TO service-subscription (comprises customer, Many2Many)
+      - TO generic-vnf( license BelongsTo generic-vnf, MANY2ONE)(4)
+      - TO vce( license BelongsTo vce, MANY2ONE)(4)
+
+      -(4) IF this TO node is deleted, this LICENSE is DELETED also
     required:
-    - global-customer-id
-    - subscriber-name
-    - subscriber-type
+    - group-uuid
+    - resource-uuid
     properties:
-      global-customer-id:
-        type: string
-        description: Global customer id used across ECOMP to uniquely identify customer.
-      subscriber-name:
+      group-uuid:
         type: string
-        description: Subscriber name, an alternate way to retrieve a customer.
-      subscriber-type:
+        description: Unique ID for the license group the resource belongs to, should be uuid.
+      resource-uuid:
         type: string
-        description: Subscriber type, a way to provide VID with only the INFRA customers.
+        description: Unique ID of a license resource. 
       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"
+        description: Concurrency value
       relationship-list:
         type: array
         items:
           $ref: "#/definitions/relationship"
-  customers:
+  licenses:
     description: |
-      Collection of customer identifiers to provide linkage back to BSS information.
+      Licenses to be allocated across resources, keyed by group-uuid and resource-uuid, related to license management
     properties:
-      customer:
+      license:
         type: array
         items:          
-          $ref: "#/definitions/customer"
+          $ref: "#/definitions/license"
   line-of-business:
     description: |
       describes a line-of-business
       ###### Related Nodes
-      - TO generic-vnf (Many2Many)
+      - TO generic-vnf( line-of-business Uses generic-vnf, MANY2MANY)
+
     required:
     - line-of-business-name
     properties:
@@ -43521,293 +47220,194 @@ definitions:
         type: array
         items:          
           $ref: "#/definitions/line-of-business"
-  owning-entity:
+  logical-link:
     description: |
-      describes an owning-entity
+      Logical links generally connect l-interfaces but are used to express logical connectivity between two points
       ###### Related Nodes
-      - TO service-instance (One2Many)
+      - TO cloud-region( logical-link LocatedIn cloud-region, MANY2MANY)
+      - TO generic-vnf( logical-link BridgedTo generic-vnf, MANY2MANY)
+      - TO lag-link( logical-link Uses lag-link, MANY2MANY)
+      - TO logical-link( logical-link Uses logical-link, MANY2MANY)
+      - TO pnf( logical-link BridgedTo pnf, MANY2MANY)
+      - TO pserver( logical-link BridgedTo pserver, MANY2MANY)
+      - TO vpn-binding( logical-link Uses vpn-binding, MANY2MANY)
+      - TO virtual-data-center( logical-link LocatedIn virtual-data-center, MANY2MANY)
+      - FROM configuration( configuration Uses logical-link, ONE2MANY)(3)
+      - FROM lag-interface( lag-interface Uses logical-link, MANY2MANY)(3)
+      - FROM l-interface( l-interface LinksTo logical-link, MANY2MANY)(3)
+      - FROM p-interface( p-interface LinksTo logical-link, MANY2ONE)
+      - FROM service-instance( service-instance Uses logical-link, ONE2MANY)(3)
+      - FROM vlan( vlan Uses logical-link, MANY2MANY)(3)
+      - FROM logical-link( logical-link Uses logical-link, MANY2MANY)
+
+      -(3) IF this FROM node is deleted, this LOGICAL-LINK is DELETED also
     required:
-    - owning-entity-id
-    - owning-entity-name
+    - link-name
+    - in-maint
+    - link-type
     properties:
-      owning-entity-id:
+      link-name:
         type: string
-        description: UUID of an owning entity
-      owning-entity-name:
+        description: e.g., evc-name, or vnf-nameA_interface-nameA_vnf-nameZ_interface-nameZ
+      in-maint:
+        type: boolean
+        description: used to indicate whether or not this object is in maintenance mode (maintenance mode = true). This field (in conjunction with prov-status) is used to suppress alarms and vSCL on VNFs/VMs.
+      link-type:
         type: string
-        description: Owning entity name
-      resource-version:
+        description: Type of logical link, e.g., evc
+      speed-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"
-  owning-entities:
-    description: |
-      Collection of owning-entities
-    properties:
-      owning-entity:
-        type: array
-        items:          
-          $ref: "#/definitions/owning-entity"
-  platform:
-    description: |
-      describes a platform
-      ###### Related Nodes
-      - TO generic-vnf (Many2Many)
-    required:
-    - platform-name
-    properties:
-      platform-name:
+        description: Captures the numeric part of the speed
+      speed-units:
         type: string
-        description: Name of the platform
-      resource-version:
+        description: Captures the units corresponding to the speed
+      ip-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"
-  project:
-    description: |
-      describes the project
-      ###### Related Nodes
-      - TO service-instance (One2Many)
-    required:
-    - project-name
-    properties:
-      project-name:
+        description: v4, v6, or ds for dual stack
+      routing-protocol:
         type: string
-        description: Name of the project deploying a service
+        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.
-      relationship-list:
-        type: array
-        items:
-          $ref: "#/definitions/relationship"
-  projects:
-    description: |
-      Collection of projects
-    properties:
-      project:
-        type: array
-        items:          
-          $ref: "#/definitions/project"
-  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"
-  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
-    required:
-    - vnf-image-uuid
-    - application
-    - application-vendor
-    properties:
-      vnf-image-uuid:
+      model-invariant-id:
         type: string
-        description: Unique ID of this asset
-      application:
+        description: the ASDC model id for this resource or service model.
+      model-version-id:
         type: string
-        description: The application that the image instantiates.
-      application-vendor:
+        description: the ASDC model version for this resource or service model.
+      persona-model-version:
         type: string
-        description: The vendor of the application.
-      application-version:
+        description: the ASDC model version for this resource or service model.
+      widget-model-id:
         type: string
-        description: The version of the application.
-      selflink:
+        description: the ASDC data dictionary widget model. This maps directly to the A&AI widget.
+      widget-model-version:
         type: string
-        description: URL to endpoint where AAI can get more details
-      resource-version:
+        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: 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"
-  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:
+        description: Indication of operational status of the logical link.
+      prov-status:
         type: string
-        description: This gets defined by others to provide a unique ID for the service, we accept what is sent.
-      service-description:
+        description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems.
+      link-role:
         type: string
-        description: Description of the service
-      service-selflink:
+        description: Indication of the network use of the logical link.
+      link-name2:
         type: string
-        description: URL to endpoint where AAI can get more details
-      resource-version:
+        description: Alias or alternate name (CLCI or D1 name).
+      link-id:
         type: string
-        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
-      service-version:
+        description: UUID of the logical-link, SDNC generates this.
+      circuit-id:
         type: string
-        description: service version
+        description: Circuit id
+      purpose:
+        type: string
+        description: Reason for this entity, role it is playing
       relationship-list:
         type: array
         items:
           $ref: "#/definitions/relationship"
-  services:
+  logical-links:
     description: |
-      Collection of service model definitions.  Likely to be deprecated in favor of models from ASDC.
+      Collection of logical connections
     properties:
-      service:
+      logical-link:
         type: array
         items:          
-          $ref: "#/definitions/service"
-  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
-      - FROM 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-capabilities:
+          $ref: "#/definitions/logical-link"
+  metadata:
     description: |
-      Collection of service capabilities.
+      Collection of metadatum (key/value pairs)
     properties:
-      service-capability:
+      metadatum:
         type: array
         items:          
-          $ref: "#/definitions/service-capability"
-  element-choice-set:
+          $ref: "#/definitions/metadatum"
+  metadatum:
     description: |
-      This is how we would capture constraints defining allowed sets of elements.
+      Key/value pairs
       ###### Related Nodes
-      - TO model-element (comprises element-choice-set, One2Many)
-      - FROM constrained-element-set (is composed of element-choice-set)
+      - TO configuration( metadatum BelongsTo configuration, MANY2ONE)(4)
+      - TO connector( metadatum BelongsTo connector, MANY2ONE)(4)
+      - TO image( metadatum BelongsTo image, MANY2ONE)(4)
+      - TO service-instance( metadatum BelongsTo service-instance, MANY2ONE)(4)
+      - TO model-ver( metadatum BelongsTo model-ver, MANY2ONE)(4)
+
+      -(4) IF this TO node is deleted, this METADATUM is DELETED also
     required:
-    - element-choice-set-uuid
-    - element-choice-set-name
+    - metaname
+    - metaval
     properties:
-      element-choice-set-uuid:
-        type: string
-      element-choice-set-name:
+      metaname:
         type: string
-      cardinality:
+      metaval:
         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"
-  constrained-element-set:
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+  model:
     description: |
-      This is how we would capture constraints defining allowed sets of elements.
+      Subgraph definition provided by ASDC to describe an inventory asset and its connections related to ASDC models, independent of version
       ###### 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)
+      - TO model( model-ver BelongsTo model, MANY2ONE)(1)
+      - FROM instance-group( instance-group Targets model, MANY2MANY)
+      - FROM model-ver( model-ver BelongsTo model, MANY2ONE)(1)
+      - FROM named-query( named-query AppliesTo model, ONE2MANY)
+      - FROM named-query-element( named-query-element IsA model, MANY2ONE)
+
+      -(1) IF this MODEL node is deleted, this FROM node is DELETED also
+      -MODEL cannot be deleted if related to INSTANCE-GROUP,NAMED-QUERY,NAMED-QUERY-ELEMENT
+
     required:
-    - constrained-element-set-uuid
-    - constraint-type
-    - check-type
+    - model-invariant-id
+    - model-type
     properties:
-      constrained-element-set-uuid:
-        type: string
-      constraint-type:
+      model-invariant-id:
         type: string
-      check-type:
+        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
-      element-choice-sets:
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      model-vers:
         type: array
         items:
-          $ref: "#/definitions/element-choice-set"
+          $ref: "#/definitions/model-ver"
       relationship-list:
         type: array
         items:
           $ref: "#/definitions/relationship"
-  constrained-element-sets:
+  model-and-named-query-search:
+    description: |
+      ModelAndNamedQuerySearch holds query-parameters and instance-properties for performing a named-query or model query
     properties:
-      constrained-element-set:
-        type: array
-        items:          
-          $ref: "#/definitions/constrained-element-set"
+      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 constrained-element-set (comprises model-constraint, One2Many)
-      - FROM model-element (is composed of model-constraint)
+      - TO model-element( model-constraint BelongsTo model-element, MANY2ONE)(4)
+      - FROM constrained-element-set( constrained-element-set BelongsTo model-constraint, MANY2ONE)(1)
+
+      -(1) IF this MODEL-CONSTRAINT node is deleted, this FROM node is DELETED also
+      -(4) IF this TO node is deleted, this MODEL-CONSTRAINT is DELETED also
     required:
     - model-constraint-uuid
     - constrained-element-set-uuid-to-replace
@@ -43833,13 +47433,16 @@ definitions:
     description: |
       Defines how other models combine to make up a higher-level model.
       ###### 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 element-choice-set( model-element BelongsTo element-choice-set, MANY2ONE)(4)
+      - TO model-element( model-element BelongsTo model-element, MANY2ONE)(4)
+      - TO model-ver( model-element IsA model-ver, MANY2ONE)
+      - TO model-ver( model-element BelongsTo model-ver, MANY2ONE)(4)
+      - FROM constrained-element-set( constrained-element-set BelongsTo model-element, MANY2ONE)(1)
+      - FROM model-constraint( model-constraint BelongsTo model-element, MANY2ONE)(1)
+      - FROM model-element( model-element BelongsTo model-element, MANY2ONE)(4)
+
+      -(1) IF this MODEL-ELEMENT node is deleted, this FROM node is DELETED also
+      -(4) IF this TO node is deleted, this MODEL-ELEMENT is DELETED also
     required:
     - model-element-uuid
     - new-data-del-flag
@@ -43882,10 +47485,15 @@ definitions:
     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-element (comprises model-ver, One2Many)
-      - TO metadatum (comprises model-ver, One2Many)
-      - FROM model (is composed of model-ver)
-      - FROM model-element
+      - TO model( model-ver BelongsTo model, MANY2ONE)(4)
+      - FROM model-element( model-element IsA model-ver, MANY2ONE)
+      - FROM model-element( model-element BelongsTo model-ver, MANY2ONE)(1)
+      - FROM metadatum( metadatum BelongsTo model-ver, MANY2ONE)(1)
+
+      -(1) IF this MODEL-VER node is deleted, this FROM node is DELETED also
+      -(4) IF this TO node is deleted, this MODEL-VER is DELETED also
+      -MODEL-VER cannot be deleted if related to MODEL-ELEMENT
+
     required:
     - model-version-id
     - model-name
@@ -43924,116 +47532,101 @@ definitions:
         type: array
         items:          
           $ref: "#/definitions/model-ver"
-  model:
+  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: |
-      Subgraph definition provided by ASDC to describe an inventory asset and its connections related to ASDC models, independent of version
       ###### Related Nodes
-      - TO model-ver (comprises model, One2Many)
-      - FROM named-query
-      - FROM named-query-element
-      - FROM instance-group
+      - FROM vlan( vlan Uses multicast-configuration, MANY2MANY)
+
     required:
-    - model-invariant-id
-    - model-type
+    - multicast-configuration-id
+    - multicast-protocol
+    - rp-type
     properties:
-      model-invariant-id:
+      multicast-configuration-id:
         type: string
-        description: Unique identifier corresponding to the main definition of a model in ASDC
-      model-type:
+        description: Unique id of multicast configuration.
+      multicast-protocol:
         type: string
-        description: Type of the model, e.g., service, resource, widget, etc.
+        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.
-      model-vers:
-        type: array
-        items:
-          $ref: "#/definitions/model-ver"
       relationship-list:
         type: array
         items:
           $ref: "#/definitions/relationship"
-  models:
+  multicast-configurations:
     description: |
-      Collection of subgraph definitions provided by ASDC to describe the inventory assets and their connections related to ASDC models
+      multicast configuration of generic-vnf ip-address
     properties:
-      model:
+      multicast-configuration:
         type: array
         items:          
-          $ref: "#/definitions/model"
-  related-lookup:
+          $ref: "#/definitions/multicast-configuration"
+  named-queries:
+    properties:
+      named-query:
+        type: array
+        items:          
+          $ref: "#/definitions/named-query"
+  named-query:
     description: |
       TBD
       ###### Related Nodes
-      - FROM named-query-element (is composed of related-lookup)
+      - TO named-query( named-query-element BelongsTo named-query, ONE2ONE)(1)
+      - TO model( named-query AppliesTo model, ONE2MANY)
+      - FROM named-query-element( named-query-element BelongsTo named-query, ONE2ONE)(1)
+
+      -(1) IF this NAMED-QUERY node is deleted, this FROM node is DELETED also
     required:
-    - related-lookup-uuid
-    - source-node-type
-    - source-node-property
-    - target-node-type
-    - target-node-property
+    - named-query-uuid
+    - named-query-name
+    - named-query-version
     properties:
-      related-lookup-uuid:
+      named-query-uuid:
         type: string
-      source-node-type:
+      named-query-name:
         type: string
-      source-node-property:
+      named-query-version:
         type: string
-      target-node-type:
+      required-input-param:
         type: string
-      target-node-property:
-        type: string
-      property-collect-list:
+      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"
-  related-lookups:
-    properties:
-      related-lookup:
-        type: array
-        items:          
-          $ref: "#/definitions/related-lookup"
-  property-constraint:
-    description: |
-      TBD
-      ###### Related Nodes
-      - FROM named-query-element (is composed of property-constraint)
-    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"
   named-query-element:
     description: |
       TBD
       ###### 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)
+      - TO named-query( named-query-element BelongsTo named-query, ONE2ONE)(4)
+      - TO model( named-query-element IsA model, MANY2ONE)
+      - TO named-query-element( named-query-element BelongsTo named-query-element, MANY2ONE)(4)
+      - FROM property-constraint( property-constraint BelongsTo named-query-element, MANY2ONE)(1)
+      - FROM related-lookup( related-lookup BelongsTo named-query-element, MANY2ONE)(1)
+      - FROM named-query-element( named-query-element BelongsTo named-query-element, MANY2ONE)(4)
+
+      -(1) IF this NAMED-QUERY-ELEMENT node is deleted, this FROM node is DELETED also
+      -(4) IF this TO node is deleted, this NAMED-QUERY-ELEMENT is DELETED also
     required:
     - named-query-element-uuid
     properties:
@@ -44069,178 +47662,132 @@ definitions:
         type: array
         items:          
           $ref: "#/definitions/named-query-element"
-  named-query:
+  network:
     description: |
-      TBD
-      ###### Related Nodes
-      - TO model (One2Many)
-      - TO named-query-element (comprises named-query, One2One)
-    required:
-    - named-query-uuid
-    - named-query-name
-    - named-query-version
+      Namespace for network inventory resources.
     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:
+      logical-links:
         type: array
         items:
-          $ref: "#/definitions/named-query-element"
-      relationship-list:
+          $ref: "#/definitions/logical-link"
+      site-pair-sets:
         type: array
         items:
-          $ref: "#/definitions/relationship"
-  named-queries:
-    properties:
-      named-query:
+          $ref: "#/definitions/site-pair-set"
+      vpn-bindings:
         type: array
-        items:          
-          $ref: "#/definitions/named-query"
-  service-design-and-creation:
-    description: |
-      Namespace for objects managed by ASDC
-    properties:
-      vnf-images:
+        items:
+          $ref: "#/definitions/vpn-binding"
+      vpls-pes:
         type: array
         items:
-          $ref: "#/definitions/vnf-image"
-      services:
+          $ref: "#/definitions/vpls-pe"
+      multicast-configurations:
         type: array
         items:
-          $ref: "#/definitions/service"
-      service-capabilities:
+          $ref: "#/definitions/multicast-configuration"
+      vces:
         type: array
         items:
-          $ref: "#/definitions/service-capability"
-      models:
+          $ref: "#/definitions/vce"
+      vnfcs:
         type: array
         items:
-          $ref: "#/definitions/model"
-      named-queries:
+          $ref: "#/definitions/vnfc"
+      l3-networks:
         type: array
         items:
-          $ref: "#/definitions/named-query"
-  logical-link:
+          $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: |
-      Logical links generally connect l-interfaces but are used to express logical connectivity between two points
       ###### 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 configuration
-      - FROM l-interface
-      - FROM lag-interface
-      - FROM p-interface
-      - FROM service-instance
-      - FROM virtual-data-center
-      - FROM vlan
-      - FROM logical-link
+      - FROM allotted-resource( allotted-resource Uses network-policy, ONE2ONE)
+      - FROM l3-network( l3-network Uses network-policy, MANY2MANY)
+
     required:
-    - link-name
-    - in-maint
-    - link-type
+    - network-policy-id
     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:
+      network-policy-id:
         type: string
-        description: Captures the units corresponding to the speed
-      ip-version:
+        description: UUID representing unique key to this instance
+      network-policy-fqdn:
         type: string
-        description: v4, v6, or ds for dual stack
-      routing-protocol:
+        description: Contrail FQDN for the policy
+      heat-stack-id:
         type: string
-        description: For example, static or BGP
+        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.
-      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"
-  class-of-service:
+  network-profile:
     description: |
+      Network profile populated by SDN-GP for SNMP
       ###### Related Nodes
-      - FROM site-pair (is composed of class-of-service)
+      - TO generic-vnf( network-profile AppliesTo generic-vnf, MANY2MANY)
+
     required:
-    - cos
+    - nm-profile-name
     properties:
-      cos:
-        type: string
-        description: unique identifier of probe
-      probe-id:
+      nm-profile-name:
         type: string
-        description: identifier of probe
-      probe-type:
+        description: Unique name of network profile.
+      community-string:
         type: string
-        description: type of probe
+        description: Encrypted SNMP community string
       resource-version:
         type: string
         description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
@@ -44248,138 +47795,219 @@ definitions:
         type: array
         items:
           $ref: "#/definitions/relationship"
-  classes-of-service:
+  network-profiles:
     description: |
-      class-of-service of probe
+      Collection of network profiles
     properties:
-      class-of-service:
+      network-profile:
         type: array
         items:          
-          $ref: "#/definitions/class-of-service"
-  site-pair:
+          $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
-      - TO class-of-service (comprises site-pair, Many2Many)
-      - FROM routing-instance (is composed of site-pair)
+      - FROM l-interface( l-interface BelongsTo newvce, MANY2ONE)(1)
+
+      -(1) IF this NEWVCE node is deleted, this FROM node is DELETED also
     required:
-    - site-pair-id
+    - vnf-id2
+    - vnf-name
+    - vnf-type
     properties:
-      site-pair-id:
+      vnf-id2:
         type: string
-        description: unique identifier of probe
-      source-ip:
+        description: Unique id of VNF, can't use same attribute name right now until we promote this new object
+      vnf-name:
         type: string
-        description: Prefix address
-      destination-ip:
+        description: Name of VNF.
+      vnf-name2:
         type: string
-        description: Prefix address
-      ip-version:
+        description: Alternate name of VNF.
+      vnf-type:
         type: string
-        description: ip version, v4, v6
-      destination-hostname:
+        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: Hostname of the destination equipment to which SLAs are measured against.
-      destination-equip-type:
+        description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems.
+      operational-status:
         type: string
-        description: The type of destinatination equipment. Could be Router, UCPE, etc.
+        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.
-      classes-of-service:
-        type: array
-        items:
-          $ref: "#/definitions/class-of-service"
+      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"
-  site-pairs:
+      l-interfaces:
+        type: array
+        items:
+          $ref: "#/definitions/l-interface"
+  newvces:
     description: |
-      probe within a set
+      This object fills in the gaps from vce that were incorporated into generic-vnf.  This object will be retired with vce.
     properties:
-      site-pair:
+      newvce:
         type: array
         items:          
-          $ref: "#/definitions/site-pair"
-  routing-instance:
-    description: |
-      ###### Related Nodes
-      - TO site-pair (comprises routing-instance, Many2Many)
-      - FROM site-pair-set (is composed of routing-instance)
-    required:
-    - routing-instance-id
+          $ref: "#/definitions/newvce"
+  nodes:
     properties:
-      routing-instance-id:
+      inventory-item-data:
+        type: array
+        items:
+          $ref: "#/definitions/inventory-item-data"
+  notification-event:
+    properties:
+      cambria.partition:
         type: string
-        description: Unique id of routing instance
-      rpm-owner:
+      notification-event-header:
+        type: object
+        $ref: "#/definitions/notification-event-header"
+  notification-event-header:
+    properties:
+      id:
         type: string
-        description: rpm owner
-      resource-version:
+      timestamp:
         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
+      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:
-      routing-instance:
+      event-id:
+        type: string
+      node-type:
+        type: string
+      event-trigger:
+        type: string
+      key-data:
         type: array
         items:          
-          $ref: "#/definitions/routing-instance"
-  site-pair-set:
+          $ref: "#/definitions/key-data"
+      selflink:
+        type: string
+  oam-network:
     description: |
-      Set of instances for probes used to measure service level agreements
+      OAM network, to be deprecated shortly.  Do not use for new purposes. 
       ###### Related Nodes
-      - TO routing-instance (comprises site-pair-set, Many2Many)
-      - FROM generic-vnf
+      - TO cloud-region( oam-network BelongsTo cloud-region, MANY2ONE)
+      - TO complex( oam-network AppliesTo complex, MANY2MANY)
+      - TO service-capability( oam-network AppliesTo service-capability, MANY2MANY)
+
     required:
-    - site-pair-set-id
+    - network-uuid
+    - network-name
+    - cvlan-tag
     properties:
-      site-pair-set-id:
+      network-uuid:
         type: string
-        description: Unique id of site pair set.
+        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.
-      routing-instances:
-        type: array
-        items:
-          $ref: "#/definitions/routing-instance"
       relationship-list:
         type: array
         items:
           $ref: "#/definitions/relationship"
-  site-pair-sets:
+  oam-networks:
     description: |
-      Collection of sets of instances for probes related to generic-vnf
+      Collection of OAM networks, to be deprecated shortly.  Do not use for new purposes. 
     properties:
-      site-pair-set:
+      oam-network:
         type: array
         items:          
-          $ref: "#/definitions/site-pair-set"
-  route-target:
+          $ref: "#/definitions/oam-network"
+  operational-environment:
     description: |
-      Route target information
+      It is a logical partition of the cloud which allows to have multiple environments in the production AIC.
       ###### Related Nodes
-      - FROM vpn-binding (is composed of route-target)
+      - TO operational-environment( operational-environment Uses operational-environment, ONE2ONE)
+      - FROM operational-environment( operational-environment Uses operational-environment, ONE2ONE)
+
     required:
-    - global-route-target
-    - route-target-role
+    - operational-environment-id
+    - operational-environment-name
+    - operational-environment-type
+    - operational-environment-status
+    - tenant-context
+    - workload-context
     properties:
-      global-route-target:
+      operational-environment-id:
         type: string
-        description: Number used to identify an RT, globally unique in the network
-      route-target-role:
+        description: UUID of an operational environment
+      operational-environment-name:
         type: string
-        description: Role assigned to this route target
+        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.
@@ -44387,132 +48015,207 @@ definitions:
         type: array
         items:
           $ref: "#/definitions/relationship"
-  route-targets:
+  operational-environments:
     description: |
-      Collection of route target information
+      a logical partition of the cloud which allows to have multiple environments in the production AIC.
     properties:
-      route-target:
+      operational-environment:
         type: array
         items:          
-          $ref: "#/definitions/route-target"
-  vpn-binding:
+          $ref: "#/definitions/operational-environment"
+  overloaded-model:
     description: |
-      VPN binding
-      ###### Related Nodes
-      - TO route-target (comprises vpn-binding, One2Many)
-      - FROM l3-network
-      - FROM logical-link
-      - FROM allotted-resource
+      Allows for legacy POST of old-style and new-style models
     required:
-    - vpn-id
-    - vpn-name
+    - model-invariant-id
+    - model-name-version-id
+    - model-type
+    - model-name
+    - model-id
+    - model-version
     properties:
-      vpn-id:
+      model-invariant-id:
         type: string
-        description: VPN ID, globally unique within A&AI
-      vpn-name:
+        description: Unique identifier corresponding to the main definition of a model in ASDC
+      model-name-version-id:
         type: string
-        description: VPN Name
-      vpn-platform:
+        description: Unique identifier corresponding to one version of a model in ASDC
+      model-type:
         type: string
-        description: the platform associated with the VPN example AVPN, Mobility
-      vpn-type:
+        description: Type of the model, e.g., service, resource, widget, etc.
+      model-name:
         type: string
-        description: Type of the vpn, should be taken from enumerated/valid values
-      vpn-region:
+        description: Name of the model, which can change from version to version.
+      model-id:
         type: string
-        description: region of customer vpn
-      customer-vpn-id:
+        description: Invariant unique ID which does not change from version to version
+      model-version:
         type: string
-        description: id for this customer vpn
-      route-distinguisher:
+        description: Version
+      model-description:
         type: string
-        description: Used to distinguish the distinct VPN routes of separate customers who connect to the provider in an MPLS network.
+        description: Description
       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"
+      model-vers:
+        type: object
+        $ref: "#/definitions/model-vers"
       relationship-list:
-        type: array
-        items:
-          $ref: "#/definitions/relationship"
-        description: l3-networks relate to vpn-bindings
-  vpn-bindings:
+        type: object
+        $ref: "#/definitions/relationship-list"
+  owning-entities:
+    description: |
+      Collection of owning-entities
     properties:
-      vpn-binding:
+      owning-entity:
         type: array
         items:          
-          $ref: "#/definitions/vpn-binding"
-  vpls-pe:
+          $ref: "#/definitions/owning-entity"
+  owning-entity:
     description: |
-      VPLS Provider Edge routers.
+      describes an owning-entity
       ###### Related Nodes
-      - TO complex (Many2Many)
-      - TO ctag-pool (Many2Many)
-      - TO p-interface (comprises vpls-pe, Many2Many)
-      - TO lag-interface (comprises vpls-pe, Many2Many)
+      - FROM service-instance( service-instance BelongsTo owning-entity, MANY2ONE)
+
     required:
-    - equipment-name
+    - owning-entity-id
+    - owning-entity-name
     properties:
-      equipment-name:
+      owning-entity-id:
         type: string
-      prov-status:
+        description: UUID of an owning entity
+      owning-entity-name:
         type: string
-        description: Trigger for operational monitoring of this VNF by BAU Service Assurance systems.
-      ipv4-oam-address:
+        description: Owning entity name
+      resource-version:
         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:
+        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 LinksTo logical-link, MANY2ONE)
+      - TO physical-link( p-interface LinksTo physical-link, MANY2ONE)(2)
+      - TO pnf( p-interface BindsTo pnf, MANY2ONE)(4)
+      - TO pserver( p-interface BindsTo pserver, MANY2ONE)(4)
+      - TO vpls-pe( p-interface BindsTo vpls-pe, MANY2ONE)(4)
+      - FROM lag-interface( lag-interface Uses p-interface, MANY2MANY)
+      - FROM l-interface( l-interface BindsTo p-interface, MANY2ONE)(1)
+      - FROM sriov-pf( sriov-pf BelongsTo p-interface, ONE2ONE)(1)
+
+      -(1) IF this P-INTERFACE node is deleted, this FROM node is DELETED also
+      -(2) IF this P-INTERFACE node is deleted, this TO node is DELETED also
+      -(4) IF this TO node is deleted, this P-INTERFACE is DELETED also
+    required:
+    - interface-name
+    - in-maint
+    properties:
+      interface-name:
         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
+        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
+        description: used to indicate whether or not this object is in maintenance mode (maintenance mode = true)
+      inv-status:
+        type: string
+        description: inventory status
       relationship-list:
         type: array
         items:
           $ref: "#/definitions/relationship"
-      p-interfaces:
+      sriov-pfs:
         type: array
         items:
-          $ref: "#/definitions/p-interface"
-      lag-interfaces:
+          $ref: "#/definitions/sriov-pf"
+      l-interfaces:
         type: array
         items:
-          $ref: "#/definitions/lag-interface"
-  vpls-pes:
+          $ref: "#/definitions/l-interface"
+  p-interfaces:
     description: |
-      Collection of VPLS Provider Edge routers
+      Collection of physical interfaces.
     properties:
-      vpls-pe:
+      p-interface:
         type: array
         items:          
-          $ref: "#/definitions/vpls-pe"
-  multicast-configuration:
+          $ref: "#/definitions/p-interface"
+  physical-link:
     description: |
+      Collection of physical connections, typically between p-interfaces
       ###### Related Nodes
-      - FROM vlan
+      - FROM p-interface( p-interface LinksTo physical-link, MANY2ONE)(3)
+
+      -(3) IF this FROM node is deleted, this PHYSICAL-LINK is DELETED also
     required:
-    - multicast-configuration-id
-    - multicast-protocol
-    - rp-type
+    - link-name
     properties:
-      multicast-configuration-id:
+      link-name:
         type: string
-        description: Unique id of multicast configuration.
-      multicast-protocol:
+        description: e.g., hostnameA_p-connection_nameA_hostnameZ+p_connection-nameZ
+      speed-value:
         type: string
-        description: protocol of multicast configuration
-      rp-type:
+        description: Captures the numeric part of the speed
+      speed-units:
         type: string
-        description: rp type of multicast configuration
+        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.
@@ -44520,22 +48223,26 @@ definitions:
         type: array
         items:
           $ref: "#/definitions/relationship"
-  multicast-configurations:
+  physical-links:
     description: |
-      multicast configuration of generic-vnf ip-address
+      Collection of physical connections, typically between p-interfaces
     properties:
-      multicast-configuration:
+      physical-link:
         type: array
         items:          
-          $ref: "#/definitions/multicast-configuration"
-  cvlan-tag-entry:
+          $ref: "#/definitions/physical-link"
+  platform:
+    description: |
+      describes a platform
+      ###### Related Nodes
+      - TO generic-vnf( platform Uses generic-vnf, MANY2MANY)
+
     required:
-    - cvlan-tag
+    - platform-name
     properties:
-      cvlan-tag:
-        type: integer
-        format: int64
-        description: See mis-na-virtualization-platform.yang
+      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.
@@ -44543,18 +48250,128 @@ definitions:
         type: array
         items:
           $ref: "#/definitions/relationship"
-  cvlan-tags:
+  platforms:
+    description: |
+      Collection of platforms
     properties:
-      cvlan-tag-entry:
+      platform:
         type: array
         items:          
-          $ref: "#/definitions/cvlan-tag-entry"
+          $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 LocatedIn complex, MANY2ONE)
+      - TO instance-group( pnf MemberOf instance-group, MANY2MANY)
+      - TO zone( pnf LocatedIn zone, MANY2ONE)
+      - FROM esr-thirdparty-sdnc( esr-thirdparty-sdnc AppliesTo pnf, ONE2MANY)
+      - FROM generic-vnf( generic-vnf HostedOn pnf, MANY2MANY)
+      - FROM logical-link( logical-link BridgedTo pnf, MANY2MANY)
+      - FROM lag-interface( lag-interface BindsTo pnf, MANY2ONE)(1)
+      - FROM p-interface( p-interface BindsTo pnf, MANY2ONE)(1)
+      - FROM service-instance( service-instance ComposedOf pnf, ONE2MANY)
+
+      -(1) IF this PNF node is deleted, this FROM node is DELETED also
+    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
+        description: Used to indicate whether or not this object is in maintenance mode (maintenance mode = true). This field (in conjunction with prov-status) is used to suppress alarms and vSCL on VNFs/VMs.
+      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 cvlan-tag (comprises port-group, Many2Many)
-      - FROM vce (is composed of port-group)
+      - TO vce( port-group BelongsTo vce, MANY2ONE)(4)
+      - FROM cvlan-tag( cvlan-tag BelongsTo port-group, MANY2ONE)(1)
+
+      -(1) IF this PORT-GROUP node is deleted, this FROM node is DELETED also
+      -(4) IF this TO node is deleted, this PORT-GROUP is DELETED also
     required:
     - interface-id
     - orchestration-status
@@ -44606,371 +48423,470 @@ definitions:
         type: array
         items:          
           $ref: "#/definitions/port-group"
-  license:
+  project:
     description: |
-      Metadata for license group.
+      describes the project
       ###### Related Nodes
-      - FROM generic-vnf (is composed of license)
-      - FROM vce (is composed of license)
+      - TO service-instance( project Uses service-instance, ONE2MANY)
+
     required:
-    - group-uuid
-    - resource-uuid
+    - project-name
     properties:
-      group-uuid:
-        type: string
-        description: Unique ID for the license group the resource belongs to, should be uuid.
-      resource-uuid:
+      project-name:
         type: string
-        description: Unique ID of a license resource. 
+        description: Name of the project deploying a service
       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"
-  licenses:
+  projects:
     description: |
-      Licenses to be allocated across resources, keyed by group-uuid and resource-uuid, related to license management
+      Collection of projects
     properties:
-      license:
+      project:
         type: array
         items:          
-          $ref: "#/definitions/license"
-  entitlement:
+          $ref: "#/definitions/project"
+  properties:
     description: |
-      Metadata for entitlement group.
+      Property holder for query properties or instance properties
+    properties:
+      property-name:
+        type: string
+      property-value:
+        type: string
+  property-constraint:
+    description: |
+      TBD
       ###### Related Nodes
-      - FROM generic-vnf (is composed of entitlement)
-      - FROM vce (is composed of entitlement)
+      - TO named-query-element( property-constraint BelongsTo named-query-element, MANY2ONE)(4)
+
+      -(4) IF this TO node is deleted, this PROPERTY-CONSTRAINT is DELETED also
     required:
-    - group-uuid
-    - resource-uuid
+    - property-constraint-uuid
+    - constraint-type
+    - property-name
+    - property-value
     properties:
-      group-uuid:
+      property-constraint-uuid:
         type: string
-        description: Unique ID for the entitlement group the resource comes from, should be uuid.
-      resource-uuid:
+      constraint-type:
+        type: string
+      property-name:
+        type: string
+      property-value:
         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
+  property-constraints:
     properties:
-      entitlement:
+      property-constraint:
         type: array
         items:          
-          $ref: "#/definitions/entitlement"
-  vce:
+          $ref: "#/definitions/property-constraint"
+  pserver:
     description: |
-      Virtual Customer Edge Router, used specifically for Gamma.  This object is deprecated.
+      Compute host whose hostname must be unique and must exactly match what is sent as a relationship to a vserver.
       ###### 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 group-assignment( pserver MemberOf group-assignment, MANY2ONE)
+      - TO availability-zone( pserver MemberOf availability-zone, MANY2ONE)
+      - TO cloud-region( pserver LocatedIn cloud-region, MANY2ONE)
+      - TO complex( pserver LocatedIn complex, MANY2ONE)
+      - TO zone( pserver LocatedIn zone, MANY2ONE)
+      - FROM generic-vnf( generic-vnf HostedOn pserver, MANY2MANY)
+      - FROM logical-link( logical-link BridgedTo pserver, MANY2MANY)
+      - FROM lag-interface( lag-interface BindsTo pserver, MANY2ONE)(1)
+      - FROM p-interface( p-interface BindsTo pserver, MANY2ONE)(1)
+      - FROM vserver( vserver HostedOn pserver, MANY2ONE)
+
+      -(1) IF this PSERVER node is deleted, this FROM node is DELETED also
+      -PSERVER cannot be deleted if related to GENERIC-VNF,LOGICAL-LINK,VSERVER,GROUP-ASSIGNMENT
+
     required:
-    - vnf-id
-    - vnf-name
-    - vnf-type
+    - hostname
+    - in-maint
     properties:
-      vnf-id:
+      hostname:
         type: string
-        description: Unique id of VNF.  This is unique across the graph.
-      vnf-name:
+        description: Value from executing hostname on the compute node.
+      ptnii-equip-name:
         type: string
-        description: Name of VNF.
-      vnf-name2:
+        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: Alternate name of VNF.
-      vnf-type:
+        description: Equipment type.  Source of truth should define valid values.
+      equip-vendor:
         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: Equipment vendor.  Source of truth should define valid values.
+      equip-model:
         type: string
-        description: Unique identifier of service, does not strictly map to ASDC services, SOON TO BE DEPRECATED.
-      regional-resource-zone:
+        description: Equipment model.  Source of truth should define valid values.
+      fqdn:
         type: string
-        description: Regional way of organizing pservers, source of truth should define values
-      prov-status:
+        description: Fully-qualified domain name
+      pserver-selflink:
         type: string
-        description: Trigger for operational monitoring of this resource by Service Assurance systems.
-      operational-status:
+        description: URL to endpoint where AAI can get more details
+      ipv4-oam-address:
         type: string
-        description: Indicator for whether the resource is considered operational
-      license-key:
+        description: Used to configure device, also used for troubleshooting and is IP used for traps generated by device.
+      serial-number:
         type: string
-        description: OBSOLETE -  do not use
-      equipment-role:
+        description: Serial number, may be queried
+      ipaddress-v4-loopback-0:
         type: string
-        description: Network role being played by this VNF
-      orchestration-status:
+        description: IPV4 Loopback 0 address
+      ipaddress-v6-loopback-0:
         type: string
-        description: Orchestration status of this VNF, mastered by MSO
-      heat-stack-id:
+        description: IPV6 Loopback 0 address
+      ipaddress-v4-aim:
         type: string
-        description: Heat stack id corresponding to this instance, managed by MSO
-      mso-catalog-key:
+        description: IPV4 AIM address
+      ipaddress-v6-aim:
         type: string
-        description: Corresponds to the SDN-C catalog id used to configure this VCE
-      vpe-id:
+        description: IPV6 AIM address
+      ipaddress-v6-oam:
         type: string
-        description: Unique ID of VPE connected to this VCE.
-      v6-vce-wan-address:
+        description: IPV6 OAM address
+      inv-status:
         type: string
-        description: Valid v6 IP address for the WAN Link on this router.  Implied length of /64.
-      ipv4-oam-address:
+        description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
+      pserver-id:
         type: string
-        description: Address tail-f uses to configure vce, also used for troubleshooting and is IP used for traps generated by VCE.
+        description: ID of Pserver
+      internet-topology:
+        type: string
+        description: internet topology of Pserver
+      in-maint:
+        type: boolean
+        description: used to indicate whether or not this object is in maintenance mode (maintenance mode = true). This field (in conjunction with prov-status) is used to suppress alarms and vSCL on VNFs/VMs.
       resource-version:
         type: string
         description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
-      ipv4-loopback0-address:
+      pserver-name2:
         type: string
-        description: Loopback0 address
-      entitlement-resource-uuid:
+        description: alternative pserver name
+      purpose:
         type: string
-        description: OBSOLETE -  see child relationships
-      port-groups:
-        type: array
-        items:
-          $ref: "#/definitions/port-group"
-      licenses:
+        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/license"
-      entitlements:
+          $ref: "#/definitions/relationship"
+      p-interfaces:
         type: array
         items:
-          $ref: "#/definitions/entitlement"
-      relationship-list:
+          $ref: "#/definitions/p-interface"
+      lag-interfaces:
         type: array
         items:
-          $ref: "#/definitions/relationship"
-  vces:
+          $ref: "#/definitions/lag-interface"
+  pservers:
     description: |
-      Collection of Virtual Customer Edge Routers, used specifically for Gamma.  This object is deprecated.
+      Collection of compute hosts.
     properties:
-      vce:
+      pserver:
         type: array
         items:          
-          $ref: "#/definitions/vce"
-  vnfc:
+          $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 instance-group (Many2Many)
-      - TO vip-ipv4-address-list (Many2Many)
-      - TO vip-ipv6-address-list (Many2Many)
-      - FROM vserver
-      - FROM vf-module
-      - FROM generic-vnf
-      - FROM l3-interface-ipv4-address-list (comprises vnfc)
-      - FROM l3-interface-ipv6-address-list (comprises vnfc)
+      - TO named-query-element( related-lookup BelongsTo named-query-element, MANY2ONE)(4)
+
+      -(4) IF this TO node is deleted, this RELATED-LOOKUP is DELETED also
     required:
-    - vnfc-name
-    - nfc-naming-code
-    - nfc-function
-    - in-maint
-    - is-closed-loop-disabled
+    - related-lookup-uuid
+    - source-node-type
+    - source-node-property
+    - target-node-type
+    - target-node-property
     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:
+      related-lookup-uuid:
         type: string
-        description: prov status of this vnfc
-      orchestration-status:
+      source-node-type:
         type: string
-        description: Orchestration status of this VNF, mastered by APP-C
-      ipaddress-v4-oam-vip:
+      source-node-property:
         type: string
-        description: Oam V4 vip address of this vnfc
-      in-maint:
-        type: boolean
-      is-closed-loop-disabled:
-        type: boolean
-      group-notation:
+      target-node-type:
         type: string
-        description: Group notation of VNFC
-      model-invariant-id:
+      target-node-property:
         type: string
-        description: the ASDC model id for this resource or service model.
-      model-version-id:
+      property-collect-list:
         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:
+  related-lookups:
+    properties:
+      related-lookup:
         type: array
         items:          
-          $ref: "#/definitions/l3-interface-ipv4-address-list"
-      l3-interface-ipv6-address-list:
+          $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/l3-interface-ipv6-address-list"
-  vnfcs:
-    description: |
-      virtual network components associated with a vserver from application controller.
+          $ref: "#/definitions/relationship-data"
+  relationship-data:
+    required:
+    - relationship-key
+    - relationship-value
     properties:
-      vnfc:
+      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/vnfc"
-  host-route:
+          $ref: "#/definitions/relationship"
+  reserved-prop-names:
     description: |
-      ###### Related Nodes
-      - FROM subnet (is composed of host-route)
-    required:
-    - host-route-id
-    - route-prefix
-    - next-hop
+      Internal map to define some reserved properties of a vertex
     properties:
-      host-route-id:
+      last-mod-source-of-truth:
         type: string
-        description: host-route id
-      route-prefix:
+      aai-node-type:
         type: string
-        description: subnet prefix
-      next-hop:
+      aai-created-ts:
+        type: integer
+        format: int64
+      aai-unique-key:
         type: string
-        description: Could be ip-address, hostname, or service-instance
-      next-hop-type:
+      aai-last-mod-ts:
+        type: integer
+        format: int64
+      source-of-truth:
         type: string
-        description: Should be ip-address, hostname, or service-instance to match next-hop
+      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 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: 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"
-  host-routes:
+  route-table-references:
+    description: |
+      Collection of openstack route table references
     properties:
-      host-route:
+      route-table-reference:
         type: array
         items:          
-          $ref: "#/definitions/host-route"
-  subnet:
+          $ref: "#/definitions/route-table-reference"
+  route-target:
     description: |
+      Route target information
       ###### Related Nodes
-      - TO host-route (comprises subnet, One2Many)
-      - FROM l3-interface-ipv4-address-list
-      - FROM l3-interface-ipv6-address-list
-      - FROM l3-network (is composed of subnet)
+      - TO vpn-binding( route-target BelongsTo vpn-binding, MANY2ONE)(4)
+
+      -(4) IF this TO node is deleted, this ROUTE-TARGET is DELETED also
     required:
-    - subnet-id
-    - dhcp-enabled
+    - global-route-target
+    - route-target-role
     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:
+      global-route-target:
         type: string
-        description: role of the subnet, referenced when assigning IPs
-      ip-assignment-direction:
+        description: Number used to identify an RT, globally unique in the network
+      route-target-role:
         type: string
-        description: ip address assignment direction of the subnet
+        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.
-      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:
+  route-targets:
+    description: |
+      Collection of route target information
     properties:
-      subnet:
+      route-target:
         type: array
         items:          
-          $ref: "#/definitions/subnet"
-  ctag-assignment:
+          $ref: "#/definitions/route-target"
+  routing-instance:
     description: |
       ###### Related Nodes
-      - FROM l3-network (is composed of ctag-assignment)
-      - FROM service-instance
+      - TO site-pair-set( routing-instance BelongsTo site-pair-set, MANY2ONE)(4)
+      - FROM site-pair( site-pair BelongsTo routing-instance, MANY2ONE)(1)
+
+      -(1) IF this ROUTING-INSTANCE node is deleted, this FROM node is DELETED also
+      -(4) IF this TO node is deleted, this ROUTING-INSTANCE is DELETED also
     required:
-    - vlan-id-inner
+    - routing-instance-id
     properties:
-      vlan-id-inner:
-        type: integer
-        format: int64
-        description: id.
+      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"
-  ctag-assignments:
+  routing-instances:
+    description: |
+      set of probes related to generic-vnf routing instance
     properties:
-      ctag-assignment:
+      routing-instance:
         type: array
         items:          
-          $ref: "#/definitions/ctag-assignment"
+          $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
-      - FROM l3-network (is composed of segmentation-assignment)
+      - TO l3-network( segmentation-assignment BelongsTo l3-network, MANY2ONE)(4)
+
+      -(4) IF this TO node is deleted, this SEGMENTATION-ASSIGNMENT is DELETED also
     required:
     - segmentation-id
     properties:
@@ -44992,149 +48908,59 @@ definitions:
         type: array
         items:          
           $ref: "#/definitions/segmentation-assignment"
-  l3-network:
+  service:
     description: |
-      Generic network definition
-      ###### 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
+      Stand-in for service model definitions.  Likely to be deprecated in favor of models from ASDC.  Does not strictly map to ASDC services.
     required:
-    - network-id
-    - network-name
-    - is-bound-to-vpn
-    - is-provider-network
-    - is-shared-network
-    - is-external-network
+    - service-id
+    - service-description
     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:
+      service-id:
         type: string
-        description: Network technology - who defines these values?
-      neutron-network-id:
+        description: This gets defined by others to provide a unique ID for the service, we accept what is sent.
+      service-description:
         type: string
-        description: Neutron network id of this Interface
-      is-bound-to-vpn:
-        type: boolean
-      service-id:
+        description: Description of the service
+      service-selflink:
         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
+        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.
-      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:
+      service-version:
         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: service version
       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:
+  service-capabilities:
+    description: |
+      Collection of service capabilities.
     properties:
-      l3-network:
+      service-capability:
         type: array
         items:          
-          $ref: "#/definitions/l3-network"
-  network-policy:
+          $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 l3-network
-      - FROM allotted-resource
+      - FROM availability-zone( availability-zone AppliesTo service-capability, MANY2MANY)
+      - FROM oam-network( oam-network AppliesTo service-capability, MANY2MANY)
+
+      -SERVICE-CAPABILITY cannot be deleted if related to AVAILABILITY-ZONE,OAM-NETWORK
+
     required:
-    - network-policy-id
+    - service-type
+    - vnf-type
     properties:
-      network-policy-id:
-        type: string
-        description: UUID representing unique key to this instance
-      network-policy-fqdn:
+      service-type:
         type: string
-        description: Contrail FQDN for the policy
-      heat-stack-id:
+        description: This gets defined by others to provide a unique ID for the service, we accept what is sent.
+      vnf-type:
         type: string
-        description: ID for the openStack Heat instance
+        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.
@@ -45142,42 +48968,88 @@ definitions:
         type: array
         items:
           $ref: "#/definitions/relationship"
-  network-policies:
+  service-design-and-creation:
+    description: |
+      Namespace for objects managed by ASDC
     properties:
-      network-policy:
+      vnf-images:
         type: array
-        items:          
-          $ref: "#/definitions/network-policy"
-  vf-module:
+        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: |
-      a deployment unit of VNFCs
+      Instance of a service
       ###### Related Nodes
-      - TO volume-group (One2One)
-      - TO l3-network (Many2Many)
-      - TO vnfc (One2Many)
-      - FROM vserver
-      - FROM generic-vnf (is composed of vf-module)
+      - TO generic-vnf( service-instance ComposedOf generic-vnf, ONE2MANY)
+      - TO l3-network( service-instance ComposedOf l3-network, ONE2MANY)
+      - TO owning-entity( service-instance BelongsTo owning-entity, MANY2ONE)
+      - TO allotted-resource( service-instance Uses allotted-resource, MANY2MANY)
+      - TO configuration( service-instance Uses configuration, ONE2MANY)
+      - TO connector( service-instance Uses connector, MANY2MANY)
+      - TO ctag-assignment( service-instance Uses ctag-assignment, ONE2MANY)
+      - TO cvlan-tag( service-instance ComposedOf cvlan-tag, MANY2MANY)
+      - TO instance-group( service-instance MemberOf instance-group, MANY2MANY)
+      - TO logical-link( service-instance Uses logical-link, ONE2MANY)(2)
+      - TO pnf( service-instance ComposedOf pnf, ONE2MANY)
+      - TO service-instance( service-instance ComposedOf service-instance, ONE2MANY)
+      - TO vlan( service-instance ComposedOf vlan, ONE2MANY)
+      - TO zone( service-instance LocatedIn zone, MANY2ONE)
+      - TO service-subscription( service-instance BelongsTo service-subscription, MANY2ONE)(4)
+      - TO vce( service-instance ComposedOf vce, ONE2MANY)
+      - FROM project( project Uses service-instance, ONE2MANY)
+      - FROM allotted-resource( allotted-resource BelongsTo service-instance, MANY2ONE)(1)
+      - FROM metadatum( metadatum BelongsTo service-instance, MANY2ONE)(1)
+      - FROM service-instance( service-instance ComposedOf service-instance, ONE2MANY)
+
+      -(1) IF this SERVICE-INSTANCE node is deleted, this FROM node is DELETED also
+      -(2) IF this SERVICE-INSTANCE node is deleted, this TO node is DELETED also
+      -(4) IF this TO node is deleted, this SERVICE-INSTANCE is DELETED also
     required:
-    - vf-module-id
-    - is-base-vf-module
+    - service-instance-id
     properties:
-      vf-module-id:
+      service-instance-id:
         type: string
-        description: Unique ID of vf-module.
-      vf-module-name:
+        description: Uniquely identifies this instance of a service
+      service-instance-name:
         type: string
-        description: Name of vf-module
-      heat-stack-id:
+        description: This field will store a name assigned to the service-instance.
+      service-type:
         type: string
-        description: Heat stack id corresponding to this instance.
-      orchestration-status:
+        description: String capturing type of service.
+      service-role:
         type: string
-        description: orchestration status of this vf-module, mastered by MSO
-      is-base-vf-module:
-        type: boolean
-      resource-version:
+        description: String capturing the service role.
+      environment-context:
         type: string
-        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+        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.
@@ -45187,500 +49059,258 @@ definitions:
       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:
+      bandwidth-total:
         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
+        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"
-  vf-modules:
+      metadata:
+        type: array
+        items:
+          $ref: "#/definitions/metadatum"
+      allotted-resources:
+        type: array
+        items:
+          $ref: "#/definitions/allotted-resource"
+  service-instances:
     description: |
-      Collection of vf-modules, a deployment unit of VNFCs
+      Collection of service instances
     properties:
-      vf-module:
+      service-instance:
         type: array
         items:          
-          $ref: "#/definitions/vf-module"
-  generic-vnf:
+          $ref: "#/definitions/service-instance"
+  service-subscription:
     description: |
-      General purpose VNF
+      Object that group service instances.
       ###### 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 configuration (One2Many)
-      - 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 line-of-business
-      - FROM platform
-      - FROM virtual-data-center
-      - FROM logical-link
-      - FROM allotted-resource
+      - TO customer( service-subscription BelongsTo customer, MANY2ONE)(4)
+      - TO tenant( service-subscription Uses tenant, MANY2MANY)
+      - FROM service-instance( service-instance BelongsTo service-subscription, MANY2ONE)(1)
+
+      -(1) IF this SERVICE-SUBSCRIPTION node is deleted, this FROM node is DELETED also
+      -(4) IF this TO node is deleted, this SERVICE-SUBSCRIPTION is DELETED also
     required:
-    - vnf-id
-    - vnf-name
-    - vnf-type
-    - in-maint
-    - is-closed-loop-disabled
+    - service-type
     properties:
-      vnf-id:
+      service-type:
         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 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.
-      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:
+        description: Value defined by orchestration to identify this service across ECOMP.
+      temp-ub-sub-account-id:
         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: 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.
-      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:
+      service-instances:
         type: array
         items:
-          $ref: "#/definitions/vf-module"
-      licenses:
+          $ref: "#/definitions/service-instance"
+      relationship-list:
         type: array
         items:
-          $ref: "#/definitions/license"
-      entitlements:
+          $ref: "#/definitions/relationship"
+  service-subscriptions:
+    description: |
+      Collection of objects that group service instances.
+    properties:
+      service-subscription:
         type: array
-        items:
-          $ref: "#/definitions/entitlement"
-  generic-vnfs:
+        items:          
+          $ref: "#/definitions/service-subscription"
+  services:
     description: |
-      Collection of VNFs
+      Collection of service model definitions.  Likely to be deprecated in favor of models from ASDC.
     properties:
-      generic-vnf:
+      service:
         type: array
         items:          
-          $ref: "#/definitions/generic-vnf"
-  lag-link:
+          $ref: "#/definitions/service"
+  site-pair:
     description: |
-      LAG links can connect lag-interfaces
       ###### Related Nodes
-      - FROM lag-interface
-      - FROM logical-link
+      - TO routing-instance( site-pair BelongsTo routing-instance, MANY2ONE)(4)
+      - FROM class-of-service( class-of-service BelongsTo site-pair, MANY2ONE)(1)
+
+      -(1) IF this SITE-PAIR node is deleted, this FROM node is DELETED also
+      -(4) IF this TO node is deleted, this SITE-PAIR is DELETED also
     required:
-    - link-name
+    - site-pair-id
     properties:
-      link-name:
+      site-pair-id:
         type: string
-        description: Alphabetical concatenation of lag-interface names
+        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"
-  lag-links:
-    description: |
-      Collection of link aggregation connections
-    properties:
-      lag-link:
-        type: array
-        items:          
-          $ref: "#/definitions/lag-link"
-  newvce:
+  site-pair-set:
     description: |
-      This object fills in the gaps from vce that were incorporated into generic-vnf.  This object will be retired with vce.
+      Set of instances for probes used to measure service level agreements
       ###### Related Nodes
-      - TO l-interface (comprises newvce, Many2Many)
+      - TO generic-vnf( site-pair-set AppliesTo generic-vnf, MANY2MANY)
+      - FROM routing-instance( routing-instance BelongsTo site-pair-set, MANY2ONE)(1)
+
+      -(1) IF this SITE-PAIR-SET node is deleted, this FROM node is DELETED also
     required:
-    - vnf-id2
-    - vnf-name
-    - vnf-type
+    - site-pair-set-id
     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:
+      site-pair-set-id:
         type: string
-        description: Client should send valid enumerated value.
+        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.
-      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
+      routing-instances:
+        type: array
+        items:
+          $ref: "#/definitions/routing-instance"
       relationship-list:
         type: array
         items:
           $ref: "#/definitions/relationship"
-      l-interfaces:
+  site-pair-sets:
+    description: |
+      Collection of sets of instances for probes related to generic-vnf
+    properties:
+      site-pair-set:
         type: array
-        items:
-          $ref: "#/definitions/l-interface"
-  newvces:
+        items:          
+          $ref: "#/definitions/site-pair-set"
+  site-pairs:
     description: |
-      This object fills in the gaps from vce that were incorporated into generic-vnf.  This object will be retired with vce.
+      probe within a set
     properties:
-      newvce:
+      site-pair:
         type: array
         items:          
-          $ref: "#/definitions/newvce"
-  pnf:
+          $ref: "#/definitions/site-pair"
+  snapshot:
     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.
+      Openstack snapshot
       ###### 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 esr-thirdparty-sdnc
-      - FROM generic-vnf
-      - FROM logical-link
-      - FROM service-instance
+      - TO cloud-region( snapshot BelongsTo cloud-region, MANY2ONE)
+      - FROM vserver( vserver Uses snapshot, ONE2ONE)
+
     required:
-    - pnf-name
-    - in-maint
+    - snapshot-id
     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:
+      snapshot-id:
         type: string
-        description: ipv4-oam-address with new naming convention for IP addresses
-      sw-version:
+        description: Snapshot id, this is the key UUID assoc associated in glance with the snapshots.
+      snapshot-name:
         type: string
-        description: sw-version is the version of SW for the hosted application on the PNF.
-      in-maint:
-        type: boolean
-      frame-id:
+        description: Snapshot name
+      snapshot-architecture:
         type: string
-        description: ID of the physical frame (relay rack) where pnf is installed.
-      serial-number:
+        description: Operating system architecture
+      snapshot-os-distro:
         type: string
-        description: Serial number of the device
-      ipaddress-v4-loopback-0:
+        description: The common name of the operating system distribution in lowercase
+      snapshot-os-version:
         type: string
-        description: IPV4 Loopback 0 address
-      ipaddress-v6-loopback-0:
+        description: The operating system version as specified by the distributor.
+      application:
         type: string
-        description: IPV6 Loopback 0 address
-      ipaddress-v4-aim:
+        description: The application that the image instantiates.
+      application-vendor:
         type: string
-        description: IPV4 AIM address
-      ipaddress-v6-aim:
+        description: The vendor of the application.
+      application-version:
         type: string
-        description: IPV6 AIM address
-      ipaddress-v6-oam:
+        description: The version of the application.
+      snapshot-selflink:
         type: string
-        description: IPV6 OAM address
-      inv-status:
+        description: URL to endpoint where AAI can get more details
+      prev-snapshot-id:
         type: string
-        description: CANOPI's inventory status.  Only set with values exactly as defined by CANOPI.
+        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.
-      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:
+  snapshots:
     description: |
-      Collection of Physical Network Functions.
+      Collection of openstack snapshots
     properties:
-      pnf:
+      snapshot:
         type: array
         items:          
-          $ref: "#/definitions/pnf"
-  physical-link:
+          $ref: "#/definitions/snapshot"
+  sriov-pf:
     description: |
-      Collection of physical connections, typically between p-interfaces
+      SR-IOV Physical Function
       ###### Related Nodes
-      - FROM p-interface
+      - TO p-interface( sriov-pf BelongsTo p-interface, ONE2ONE)(4)
+      - FROM sriov-vf( sriov-vf Uses sriov-pf, MANY2ONE)
+
+      -(4) IF this TO node is deleted, this SRIOV-PF is DELETED also
     required:
-    - link-name
+    - pf-pci-id
     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:
+      pf-pci-id:
         type: string
-        description: Units for downstream BW value
+        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.
@@ -45688,271 +49318,497 @@ definitions:
         type: array
         items:
           $ref: "#/definitions/relationship"
-  physical-links:
+  sriov-pfs:
     description: |
-      Collection of physical connections, typically between p-interfaces
+      Collection of SR-IOV Physical Functions.
     properties:
-      physical-link:
+      sriov-pf:
         type: array
         items:          
-          $ref: "#/definitions/physical-link"
-  vig-server:
+          $ref: "#/definitions/sriov-pf"
+  sriov-vf:
     description: |
-      vig-server contains information about a vig server used for IPSec-configuration. Populated by SDN-C from 1607
+      SR-IOV Virtual Function (not to be confused with virtual network function)
       ###### Related Nodes
-      - FROM ipsec-configuration (is composed of vig-server)
+      - TO l-interface( sriov-vf BelongsTo l-interface, ONE2ONE)(4)
+      - TO sriov-pf( sriov-vf Uses sriov-pf, MANY2ONE)
+
+      -(4) IF this TO node is deleted, this SRIOV-VF is DELETED also
     required:
-    - vig-address-type
+    - pci-id
     properties:
-      vig-address-type:
+      pci-id:
         type: string
-        description: indicates whether the VIG is for AVPN or INTERNET
-      ipaddress-v4-vig:
+        description: PCI ID used to identify the sriov-vf
+      vf-vlan-filter:
         type: string
-        description: v4 IP of the vig server
-      ipaddress-v6-vig:
+        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: v6 IP of the vig server
+        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"
-  vig-servers:
+  sriov-vfs:
+    description: |
+      Collection of SR-IOV Virtual Functions.
     properties:
-      vig-server:
+      sriov-vf:
         type: array
         items:          
-          $ref: "#/definitions/vig-server"
-  ipsec-configuration:
+          $ref: "#/definitions/sriov-vf"
+  start-node-filter:
+    properties:
+      property-name:
+        type: string
+      property-value:
+        type: string
+  subnet:
     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
-      - TO vig-server (comprises ipsec-configuration, One2Many)
-      - FROM generic-vnf
+      - TO l3-network( subnet BelongsTo l3-network, MANY2ONE)(4)
+      - FROM l3-interface-ipv4-address-list( l3-interface-ipv4-address-list MemberOf subnet, MANY2MANY)
+      - FROM l3-interface-ipv6-address-list( l3-interface-ipv6-address-list MemberOf subnet, MANY2MANY)
+      - FROM host-route( host-route BelongsTo subnet, MANY2ONE)(1)
+      - FROM vip-ipv4-address-list( vip-ipv4-address-list MemberOf subnet, MANY2MANY)
+      - FROM vip-ipv6-address-list( vip-ipv6-address-list MemberOf subnet, MANY2MANY)
+
+      -(1) IF this SUBNET node is deleted, this FROM node is DELETED also
+      -(4) IF this TO node is deleted, this SUBNET is DELETED also
+      -SUBNET cannot be deleted if related to L3-INTERFACE-IPV4-ADDRESS-LIST,L3-INTERFACE-IPV6-ADDRESS-LIST,VIP-IPV4-ADDRESS-LIST,VIP-IPV6-ADDRESS-LIST
+
     required:
-    - ipsec-configuration-id
+    - subnet-id
+    - dhcp-enabled
     properties:
-      ipsec-configuration-id:
+      subnet-id:
         type: string
-        description: UUID of this configuration
-      requested-vig-address-type:
+        description: Subnet ID, should be UUID.
+      subnet-name:
         type: string
-        description: Indicate the type of VIG server like AVPN, INTERNET, BOTH
-      requested-encryption-strength:
+        description: Name associated with the subnet.
+      neutron-subnet-id:
         type: string
-        description: Encryption values like 3des-cbc, des-cbc, aes-128-cbc, aes-192-cbc, aes-265-cbc
-      requested-dmz-type:
+        description: Neutron id of this subnet
+      gateway-address:
         type: string
-        description: ATT can offer a shared DMZ or a DMZ specific to a customer
-      shared-dmz-network-address:
+        description: gateway ip address
+      network-start-address:
         type: string
-        description: Network address of shared DMZ
-      requested-customer-name:
+        description: network start address
+      cidr-mask:
         type: string
-        description: If the DMZ is a custom DMZ, this field will indicate the customer information
-      ike-version:
+        description: cidr mask
+      ip-version:
         type: string
-        description: can be 1 or 2
-      ikev1-authentication:
+        description: ip version
+      orchestration-status:
         type: string
-        description: Contains values like md5, sha1, sha256, sha384
-      ikev1-encryption:
+        description: Orchestration status of this VNF, mastered by MSO
+      dhcp-enabled:
+        type: boolean
+        description: dhcp enabled
+      dhcp-start:
         type: string
-        description: Encyption values like 3des-cbc, des-cbc, aes-128-cbc,?aes-192-cbc, aes-265-cbc
-      ikev1-dh-group:
+        description: the start address reserved for use by dhcp
+      dhcp-end:
         type: string
-        description: Diffie-Hellman group like DH-GROUP2, DH-GROUP5, DH-GROUP14
-      ikev1-am-group-id:
+        description: the last address reserved for use by dhcp
+      subnet-role:
         type: string
-        description: Group name defined in VIG for clients using aggressive mode
-      ikev1-am-password:
+        description: role of the subnet, referenced when assigning IPs
+      ip-assignment-direction:
         type: string
-        description: pre-shared key for the above group name 
-      ikev1-sa-lifetime:
+        description: ip address assignment direction of the subnet
+      resource-version:
         type: string
-        description: Lifetime for IKEv1 SA
-      ipsec-authentication:
+        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 BelongsTo cloud-region, MANY2ONE)
+      - TO group-assignment( tenant MemberOf group-assignment, MANY2MANY)
+      - TO l3-network( tenant Uses l3-network, MANY2MANY)
+      - TO volume-group( tenant DependsOn volume-group, ONE2MANY)
+      - FROM service-subscription( service-subscription Uses tenant, MANY2MANY)
+      - FROM vserver( vserver BelongsTo tenant, MANY2ONE)
+
+      -TENANT cannot be deleted if related to VSERVER
+
+    required:
+    - tenant-id
+    - tenant-name
+    properties:
+      tenant-id:
         type: string
-        description: md5, sha1, sha256, sha384
-      ipsec-encryption:
+        description: Unique id relative to the cloud-region.
+      tenant-name:
         type: string
-        description: 3des-cbc, des-cbc, aes-128-cbc,?aes-192-cbc, aes-265-cbc
-      ipsec-sa-lifetime:
+        description: Readable name of tenant
+      tenant-context:
         type: string
-        description: Life time for IPSec SA
-      ipsec-pfs:
+        description: This field will store the tenant context.
+      resource-version:
         type: string
-        description: enable PFS or not
-      xauth-userid:
+        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 BelongsTo allotted-resource, ONE2ONE)(4)
+
+      -(4) IF this TO node is deleted, this TUNNEL-XCONNECT is DELETED also
+    required:
+    - id
+    - bandwidth-up-wan1
+    - bandwidth-down-wan1
+    - bandwidth-up-wan2
+    - bandwidth-down-wan2
+    properties:
+      id:
         type: string
-        description: user ID for xAuth, sm-user,ucpeHostName,nmteHostName
-      xauth-user-password:
+        description: Allotted Resource id UUID assigned to this instance.
+      bandwidth-up-wan1:
         type: string
-        description: Encrypted using the Juniper $9$ algorithm
-      dpd-interval:
+        description: The WAN uplink bandwidth for WAN1
+      bandwidth-down-wan1:
         type: string
-        description: The time between DPD probe
-      dpd-frequency:
+        description: The WAN downlink bandwidth for WAN1
+      bandwidth-up-wan2:
         type: string
-        description: Maximum number of DPD before claiming the tunnel is down
+        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"
-      vig-servers:
+  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/vig-server"
-  ipsec-configurations:
+        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:
-      ipsec-configuration:
+      update-node-type:
+        type: string
+      update-node-key:
         type: array
         items:          
-          $ref: "#/definitions/ipsec-configuration"
-  route-table-reference:
+          $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: |
-      Openstack route table reference.
+      Virtual Customer Edge Router, used specifically for Gamma.  This object is deprecated.
       ###### Related Nodes
-      - FROM l3-network
+      - TO availability-zone( vce Uses availability-zone, MANY2MANY)
+      - TO complex( vce LocatedIn complex, MANY2MANY)
+      - TO vserver( vce HostedOn vserver, ONE2MANY)
+      - FROM entitlement( entitlement BelongsTo vce, MANY2ONE)(1)
+      - FROM license( license BelongsTo vce, MANY2ONE)(1)
+      - FROM port-group( port-group BelongsTo vce, MANY2ONE)(1)
+      - FROM service-instance( service-instance ComposedOf vce, ONE2MANY)
+
+      -(1) IF this VCE node is deleted, this FROM node is DELETED also
     required:
-    - route-table-reference-id
-    - route-table-reference-fqdn
+    - vnf-id
+    - vnf-name
+    - vnf-type
     properties:
-      route-table-reference-id:
+      vnf-id:
         type: string
-        description: Route Table Reference id, UUID assigned to this instance.
-      route-table-reference-fqdn:
+        description: Unique id of VNF.  This is unique across the graph.
+      vnf-name:
         type: string
-        description: FQDN entry in the route table.
+        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: Concurrency value
+        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"
-  route-table-references:
+  vces:
     description: |
-      Collection of openstack route table references
+      Collection of Virtual Customer Edge Routers, used specifically for Gamma.  This object is deprecated.
     properties:
-      route-table-reference:
+      vce:
         type: array
         items:          
-          $ref: "#/definitions/route-table-reference"
-  instance-group:
+          $ref: "#/definitions/vce"
+  vf-module:
     description: |
-      General mechanism for grouping instances
+      a deployment unit of VNFCs
       ###### 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
-    required:
-    - instance-group-role
-    - model-invariant-id
-    - model-version-id
-    - id
-    - description
-    - type
+      - TO generic-vnf( vf-module BelongsTo generic-vnf, MANY2ONE)(4)
+      - TO l3-network( vf-module DependsOn l3-network, MANY2MANY)
+      - TO vnfc( vf-module Uses vnfc, ONE2MANY)
+      - TO volume-group( vf-module Uses volume-group, ONE2ONE)
+      - TO vserver( vf-module Uses vserver, ONE2MANY)
+
+      -(4) IF this TO node is deleted, this VF-MODULE is DELETED also
+      -VF-MODULE cannot be deleted if related to VNFC
+
+    required:
+    - vf-module-id
+    - is-base-vf-module
     properties:
-      instance-group-role:
+      vf-module-id:
         type: string
-        description: role of the instance group.
+        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
+        description: used to indicate whether or not this object is base vf module
+      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: ASDC model id for this resource or service model.
+        description: the ASDC model id for this resource or service model.
       model-version-id:
         type: string
-        description: ASDC model version uid for this resource model.
-      id:
+        description: the ASDC model version for this resource or service model.
+      persona-model-version:
         type: string
-        description: Instance Group ID, UUID assigned to this instance.
-      description:
+        description: the ASDC model version for this resource or service model.
+      model-customization-id:
         type: string
-        description: Descriptive text to help identify the usage of this instance-group
-      type:
+        description: captures the id of all the configuration used to customize the resource for the service.
+      widget-model-id:
         type: string
-        description: Only valid value today is lower case ha for high availability
-      sub-type:
+        description: the ASDC data dictionary widget model. This maps directly to the A&AI widget.
+      widget-model-version:
         type: string
-        description: Valid values for ha type are [geo-activeactive, geo-activestandby, local-activeactive, local-activestandby]
-      resource-version:
+        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: Concurrency value
+        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"
-  instance-groups:
+  vf-modules:
     description: |
-      Collection of openstack route table references
+      Collection of vf-modules, a deployment unit of VNFCs
     properties:
-      instance-group:
+      vf-module:
         type: array
         items:          
-          $ref: "#/definitions/instance-group"
-  zone:
+          $ref: "#/definitions/vf-module"
+  vig-server:
     description: |
-      A zone is a grouping of assets in a location homing to the same connections into the CBB
+      vig-server contains information about a vig server used for IPSec-configuration. Populated by SDN-C from 1607
       ###### Related Nodes
-      - TO complex (Many2One)
-      - FROM cloud-region
-      - FROM pserver
-      - FROM pnf
-      - FROM service-instance
+      - TO ipsec-configuration( vig-server BelongsTo ipsec-configuration, MANY2ONE)(4)
+
+      -(4) IF this TO node is deleted, this VIG-SERVER is DELETED also
     required:
-    - zone-id
-    - zone-name
-    - design-type
-    - zone-context
+    - vig-address-type
     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:
+      vig-address-type:
         type: string
-        description: Design of zone [Medium/Large?]
-      zone-context:
+        description: indicates whether the VIG is for AVPN or INTERNET
+      ipaddress-v4-vig:
         type: string
-        description: Context of zone [production/test]
-      status:
+        description: v4 IP of the vig server
+      ipaddress-v6-vig:
         type: string
-        description: Status of a zone.
+        description: v6 IP of the vig server
       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"
-  zones:
-    description: |
-      Collection of zones
+  vig-servers:
     properties:
-      zone:
+      vig-server:
         type: array
         items:          
-          $ref: "#/definitions/zone"
+          $ref: "#/definitions/vig-server"
   vip-ipv4-address-list:
     description: |
       IPv4 Address Range
       ###### Related Nodes
-      - FROM vnfc
+      - TO cloud-region( vip-ipv4-address-list BelongsTo cloud-region, MANY2ONE)
+      - TO instance-group( vip-ipv4-address-list MemberOf instance-group, MANY2MANY)
+      - TO subnet( vip-ipv4-address-list MemberOf subnet, MANY2MANY)
+      - FROM vnfc( vnfc Uses vip-ipv4-address-list, MANY2MANY)
+
     required:
     - vip-ipv4-address
     properties:
@@ -45991,7 +49847,11 @@ definitions:
     description: |
       IPv6 Address Range
       ###### Related Nodes
-      - FROM vnfc
+      - TO cloud-region( vip-ipv6-address-list BelongsTo cloud-region, MANY2ONE)
+      - TO instance-group( vip-ipv6-address-list MemberOf instance-group, MANY2MANY)
+      - TO subnet( vip-ipv6-address-list MemberOf subnet, MANY2MANY)
+      - FROM vnfc( vnfc Uses vip-ipv6-address-list, MANY2MANY)
+
     required:
     - vip-ipv6-address
     properties:
@@ -46026,565 +49886,10618 @@ definitions:
         type: array
         items:
           $ref: "#/definitions/relationship"
-  network:
+  virtual-data-center:
     description: |
-      Namespace for network inventory resources.
+      Virtual organization of cloud infrastructure elements in a data center context
+      ###### Related Nodes
+      - FROM connector( connector LocatedIn virtual-data-center, MANY2MANY)
+      - FROM generic-vnf( generic-vnf LocatedIn virtual-data-center, MANY2MANY)
+      - FROM logical-link( logical-link LocatedIn virtual-data-center, MANY2MANY)
+
+    required:
+    - vdc-id
+    - vdc-name
     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:
+      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/vnfc"
-      l3-networks:
+          $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/l3-network"
-      network-policies:
+        items:          
+          $ref: "#/definitions/virtual-data-center"
+  vlan:
+    description: |
+      Definition of vlan
+      ###### Related Nodes
+      - TO l-interface( vlan LinksTo l-interface, MANY2ONE)(4)
+      - TO logical-link( vlan Uses logical-link, MANY2MANY)(2)
+      - TO multicast-configuration( vlan Uses multicast-configuration, MANY2MANY)
+      - FROM allotted-resource( allotted-resource PartOf vlan, MANY2MANY)
+      - FROM service-instance( service-instance ComposedOf vlan, ONE2MANY)
+      - FROM l3-interface-ipv4-address-list( l3-interface-ipv4-address-list BelongsTo vlan, MANY2ONE)(1)
+      - FROM l3-interface-ipv6-address-list( l3-interface-ipv6-address-list BelongsTo vlan, MANY2ONE)(1)
+
+      -(1) IF this VLAN node is deleted, this FROM node is DELETED also
+      -(2) IF this VLAN node is deleted, this TO node is DELETED also
+      -(4) IF this TO node is deleted, this VLAN is DELETED also
+    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
+        description: used to indicate whether or not this object is in maintenance mode (maintenance mode = true)
+      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
+        description: Flag indicating the interface uses the IP Unnumbered configuration.
+      relationship-list:
         type: array
         items:
-          $ref: "#/definitions/network-policy"
-      generic-vnfs:
+          $ref: "#/definitions/relationship"
+      l3-interface-ipv4-address-list:
         type: array
-        items:
-          $ref: "#/definitions/generic-vnf"
-      lag-links:
+        items:          
+          $ref: "#/definitions/l3-interface-ipv4-address-list"
+      l3-interface-ipv6-address-list:
         type: array
-        items:
-          $ref: "#/definitions/lag-link"
-      newvces:
+        items:          
+          $ref: "#/definitions/l3-interface-ipv6-address-list"
+  vlans:
+    properties:
+      vlan:
         type: array
-        items:
-          $ref: "#/definitions/newvce"
-      pnfs:
+        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 Uses vnf-image, MANY2ONE)
+
+      -VNF-IMAGE cannot be deleted if related 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/pnf"
-      physical-links:
+          $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/physical-link"
-      ipsec-configurations:
+        items:          
+          $ref: "#/definitions/vnf-image"
+  vnfc:
+    description: |
+      ###### Related Nodes
+      - TO generic-vnf( vnfc BelongsTo generic-vnf, MANY2ONE)(4)
+      - TO instance-group( vnfc MemberOf instance-group, MANY2MANY)
+      - TO vip-ipv4-address-list( vnfc Uses vip-ipv4-address-list, MANY2MANY)
+      - TO vip-ipv6-address-list( vnfc Uses vip-ipv6-address-list, MANY2MANY)
+      - TO vserver( vnfc HostedOn vserver, ONE2MANY)
+      - FROM vf-module( vf-module Uses vnfc, ONE2MANY)
+      - FROM l3-interface-ipv4-address-list( l3-interface-ipv4-address-list BelongsTo vnfc, MANY2ONE)(1)
+      - FROM l3-interface-ipv6-address-list( l3-interface-ipv6-address-list BelongsTo vnfc, MANY2ONE)(1)
+
+      -(1) IF this VNFC node is deleted, this FROM node is DELETED also
+      -(4) IF this TO node is deleted, this VNFC is DELETED also
+    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
+        description: used to indicate whether or not this object is in maintenance mode (maintenance mode = true)
+      is-closed-loop-disabled:
+        type: boolean
+        description: used to indicate whether closed loop function is enabled on this node
+      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/ipsec-configuration"
-      route-table-references:
+          $ref: "#/definitions/relationship"
+      l3-interface-ipv4-address-list:
         type: array
-        items:
-          $ref: "#/definitions/route-table-reference"
-      instance-groups:
+        items:          
+          $ref: "#/definitions/l3-interface-ipv4-address-list"
+      l3-interface-ipv6-address-list:
         type: array
-        items:
-          $ref: "#/definitions/instance-group"
-      zones:
+        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 AttachesTo volume)(3)
+
+      -(3) IF this FROM node is deleted, this VOLUME is DELETED also
+    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/zone"
-      vip-ipv4-address-list:
-        type: object
-        $ref: "#/definitions/vip-ipv4-address-list"
-      vip-ipv6-address-list:
-        type: object
-        $ref: "#/definitions/vip-ipv6-address-list"
-  inventory:
+          $ref: "#/definitions/relationship"
+  volume-group:
+    description: |
+      Persistent block-level storage.
+      ###### Related Nodes
+      - TO cloud-region( volume-group BelongsTo cloud-region, MANY2ONE)
+      - TO complex( volume-group LocatedIn complex, MANY2ONE)
+      - FROM generic-vnf( generic-vnf DependsOn volume-group, ONE2MANY)
+      - FROM vf-module( vf-module Uses volume-group, ONE2ONE)
+      - FROM tenant( tenant DependsOn volume-group, ONE2MANY)
+
+    required:
+    - volume-group-id
+    - volume-group-name
+    - vnf-type
     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:
+      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/"
-  edge-tag-query-result:
+          $ref: "#/definitions/relationship"
+  volume-groups:
+    description: |
+      Collection of persistent block-level storage.
     properties:
-      tagged-inventory-item-list:
+      volume-group:
         type: array
         items:          
-          $ref: "#/definitions/tagged-inventory-item-list"
-  tagged-inventory-item-list:
+          $ref: "#/definitions/volume-group"
+  volumes:
+    description: |
+      Collection of ephemeral Block storage volumes.
     properties:
-      inventory-item:
+      volume:
         type: array
         items:          
-          $ref: "#/definitions/inventory-item"
-  inventory-item:
+          $ref: "#/definitions/volume"
+  vpls-pe:
+    description: |
+      VPLS Provider Edge routers.
+      ###### Related Nodes
+      - TO complex( vpls-pe LocatedIn complex, MANY2ONE)
+      - TO ctag-pool( vpls-pe Uses ctag-pool, MANY2MANY)
+      - FROM lag-interface( lag-interface BindsTo vpls-pe, MANY2ONE)(1)
+      - FROM p-interface( p-interface BindsTo vpls-pe, MANY2ONE)(1)
+
+      -(1) IF this VPLS-PE node is deleted, this FROM node is DELETED also
+    required:
+    - equipment-name
     properties:
-      inventory-item-type:
+      equipment-name:
         type: string
-      inventory-item-link:
+      prov-status:
         type: string
-      inventory-item-data:
+        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/inventory-item-data"
-      tagged-inventory-item-list:
+        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/tagged-inventory-item-list"
-  inventory-item-data:
+          $ref: "#/definitions/vpls-pe"
+  vpn-binding:
+    description: |
+      VPN binding
+      ###### Related Nodes
+      - FROM allotted-resource( allotted-resource BelongsTo vpn-binding, MANY2MANY)
+      - FROM l3-network( l3-network Uses vpn-binding, MANY2MANY)
+      - FROM logical-link( logical-link Uses vpn-binding, MANY2MANY)
+      - FROM route-target( route-target BelongsTo vpn-binding, MANY2ONE)(1)
+
+      -(1) IF this VPN-BINDING node is deleted, this FROM node is DELETED also
+      -VPN-BINDING cannot be deleted if related to ALLOTTED-RESOURCE,L3-NETWORK,LOGICAL-LINK
+
+    required:
+    - vpn-id
+    - vpn-name
     properties:
-      property-name:
+      vpn-id:
         type: string
-      property-value:
+        description: VPN ID, globally unique within A&AI
+      vpn-name:
         type: string
-  edge-tag-query-request:
+        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:
-      edge-tag:
+      vpn-binding:
+        type: array
+        items:          
+          $ref: "#/definitions/vpn-binding"
+  vserver:
+    description: |
+      Virtual Servers, aka virtual machine or VM.
+      ###### Related Nodes
+      - TO tenant( vserver BelongsTo tenant, MANY2ONE)
+      - TO flavor( vserver Uses flavor, MANY2ONE)
+      - TO image( vserver Uses image, MANY2ONE)
+      - TO pserver( vserver HostedOn pserver, MANY2ONE)
+      - TO snapshot( vserver Uses snapshot, ONE2ONE)
+      - TO volume (CHILD of vserver, vserver AttachesTo volume, ONE2MANY)(2)
+      - FROM generic-vnf( generic-vnf HostedOn vserver, ONE2MANY)
+      - FROM vce( vce HostedOn vserver, ONE2MANY)
+      - FROM l-interface( l-interface BindsTo vserver, MANY2ONE)(1)
+      - FROM vf-module( vf-module Uses vserver, ONE2MANY)
+      - FROM vnfc( vnfc HostedOn vserver, ONE2MANY)
+
+      -(1) IF this VSERVER node is deleted, this FROM node is DELETED also
+      -(2) IF this VSERVER node is deleted, this TO node is DELETED also
+    required:
+    - vserver-id
+    - vserver-name
+    - vserver-selflink
+    - in-maint
+    - is-closed-loop-disabled
+    properties:
+      vserver-id:
         type: string
-      result-detail:
+        description: Unique identifier for this vserver relative to its tenant
+      vserver-name:
         type: string
-      start-node-type:
+        description: Name of vserver
+      vserver-name2:
         type: string
-      start-node-filter:
+        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
+        description: Used to indicate whether or not this object is in maintenance mode (maintenance mode = true). This field (in conjunction with prov-status) is used to suppress alarms and vSCL on VNFs/VMs.
+      is-closed-loop-disabled:
+        type: boolean
+        description: Used to indicate whether closed loop function is enabled on this node
+      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/start-node-filter"
-      include-node-filter:
+          $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 LocatedIn complex, MANY2ONE)
+      - FROM cloud-region( cloud-region LocatedIn zone, MANY2ONE)
+      - FROM pnf( pnf LocatedIn zone, MANY2ONE)
+      - FROM pserver( pserver LocatedIn zone, MANY2ONE)
+      - FROM service-instance( service-instance 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/include-node-filter"
-      secondary-filter:
+          $ref: "#/definitions/zone"
+patchDefinitions:
+  action:
+    properties:
+      action-type:
+        type: string
+      action-data:
         type: array
         items:          
-          $ref: "#/definitions/secondary-filter"
-  start-node-filter:
+          $ref: "#/patchDefinitions/action-data"
+  action-data:
     properties:
       property-name:
         type: string
       property-value:
         type: string
-  include-node-filter:
+  actions:
+    description: |
+      APIs that are more action related than REST (e.g., notify, update).
     properties:
-      include-node-type:
-        type: string
-  secondary-filter:
+      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 BindsTo allotted-resource, ONE2ONE)
+      - TO generic-vnf( allotted-resource PartOf generic-vnf, MANY2MANY)
+      - TO instance-group( allotted-resource MemberOf instance-group, MANY2MANY)
+      - TO l3-network( allotted-resource PartOf l3-network, MANY2MANY)
+      - TO l-interface( allotted-resource Uses l-interface, ONE2MANY)
+      - TO network-policy( allotted-resource Uses network-policy, ONE2ONE)
+      - TO vlan( allotted-resource PartOf vlan, MANY2MANY)
+      - TO vpn-binding( allotted-resource BelongsTo vpn-binding, MANY2MANY)
+      - TO service-instance( allotted-resource BelongsTo service-instance, MANY2ONE)(4)
+      - FROM tunnel-xconnect( tunnel-xconnect BelongsTo allotted-resource, ONE2ONE)(1)
+      - FROM configuration( configuration Uses allotted-resource, ONE2ONE)(3)
+      - FROM service-instance( service-instance Uses allotted-resource, MANY2MANY)
+      - FROM allotted-resource( allotted-resource BindsTo allotted-resource, ONE2ONE)
+
+      -(1) IF this ALLOTTED-RESOURCE node is deleted, this FROM node is DELETED also
+      -(3) IF this FROM node is deleted, this ALLOTTED-RESOURCE is DELETED also
+      -(4) IF this TO node is deleted, this ALLOTTED-RESOURCE is DELETED also
+    required:
+    - id
     properties:
-      property-name:
+      id:
         type: string
-      filter-type:
+        description: Allotted Resource id UUID assigned to this instance.
+      description:
         type: string
-      property-value:
+        description: The descriptive information assigned to this allotted resource instance
+      selflink:
         type: string
-  search-results:
+        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:
-      result-data:
+      allotted-resource:
         type: array
         items:          
-          $ref: "#/definitions/result-data"
-  result-data:
+          $ref: "#/patchDefinitions/allotted-resource"
+  availability-zone:
+    description: |
+      Availability zone, a collection of compute hosts/pservers
+      ###### Related Nodes
+      - TO complex( availability-zone LocatedIn complex, MANY2ONE)
+      - TO service-capability( availability-zone AppliesTo service-capability, MANY2MANY)
+      - TO cloud-region( availability-zone BelongsTo cloud-region, MANY2ONE)(4)
+      - FROM ctag-pool( ctag-pool AppliesTo availability-zone, MANY2MANY)
+      - FROM dvs-switch( dvs-switch AppliesTo availability-zone, MANY2MANY)
+      - FROM generic-vnf( generic-vnf Uses availability-zone, MANY2MANY)
+      - FROM pserver( pserver MemberOf availability-zone, MANY2ONE)
+      - FROM vce( vce Uses availability-zone, MANY2MANY)
+
+      -(4) IF this TO node is deleted, this AVAILABILITY-ZONE is DELETED also
+      -AVAILABILITY-ZONE cannot be deleted if related to CTAG-POOL,DVS-SWITCH,GENERIC-VNF,PSERVER,VCE
+
+    required:
+    - availability-zone-name
+    - hypervisor-type
     properties:
-      resource-type:
+      availability-zone-name:
         type: string
-        description: The specific type of node in the A&AI graph
-      resource-link:
+        description: Name of the availability zone.  Unique across a cloud region
+      hypervisor-type:
         type: string
-        description: The URL to the specific resource
-  sdn-zone-response:
+        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:
-      oam-networks:
-        type: object
-        $ref: "#/definitions/oam-networks"
-      az-and-dvs-switches:
+      availability-zone:
         type: array
         items:          
-          $ref: "#/definitions/az-and-dvs-switches"
+          $ref: "#/patchDefinitions/availability-zone"
   az-and-dvs-switches:
     properties:
       dvs-switches:
         type: object
-        $ref: "#/definitions/dvs-switches"
+        $ref: "#/patchDefinitions/dvs-switches"
       availability-zone:
         type: object
-        $ref: "#/definitions/availability-zone"
-  update:
+        $ref: "#/patchDefinitions/availability-zone"
+  business:
     description: |
-      Serves a PATCH like function.  Does not enforce concurrency control.  Clear each usage with AAI team.
-    required:
-    - update-node-type
+      Namespace for business related constructs
     properties:
-      update-node-type:
-        type: string
-      update-node-key:
+      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 BelongsTo site-pair, MANY2ONE)(4)
+
+      -(4) IF this TO node is deleted, this CLASS-OF-SERVICE is DELETED also
+    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 complex( cloud-region LocatedIn complex, MANY2ONE)
+      - TO l3-network( cloud-region Uses l3-network, MANY2MANY)
+      - TO zone( cloud-region LocatedIn zone, MANY2ONE)
+      - FROM esr-system-info( esr-system-info BelongsTo cloud-region, MANY2ONE)(1)
+      - FROM availability-zone( availability-zone BelongsTo cloud-region, MANY2ONE)(1)
+      - FROM dvs-switch( dvs-switch BelongsTo cloud-region, MANY2ONE)
+      - FROM flavor( flavor BelongsTo cloud-region, MANY2ONE)
+      - FROM group-assignment( group-assignment BelongsTo cloud-region, MANY2ONE)
+      - FROM image( image BelongsTo cloud-region, MANY2ONE)
+      - FROM oam-network( oam-network BelongsTo cloud-region, MANY2ONE)
+      - FROM snapshot( snapshot BelongsTo cloud-region, MANY2ONE)
+      - FROM tenant( tenant BelongsTo cloud-region, MANY2ONE)
+      - FROM vip-ipv4-address-list( vip-ipv4-address-list BelongsTo cloud-region, MANY2ONE)
+      - FROM vip-ipv6-address-list( vip-ipv6-address-list BelongsTo cloud-region, MANY2ONE)
+      - FROM volume-group( volume-group BelongsTo cloud-region, MANY2ONE)
+      - FROM logical-link( logical-link LocatedIn cloud-region, MANY2MANY)
+      - FROM pserver( pserver LocatedIn cloud-region, MANY2ONE)
+
+      -(1) IF this CLOUD-REGION node is deleted, this FROM node is DELETED also
+      -CLOUD-REGION cannot be deleted if related to DVS-SWITCH,FLAVOR,GROUP-ASSIGNMENT,IMAGE,OAM-NETWORK,SNAPSHOT,TENANT,VIP-IPV4-ADDRESS-LIST,VIP-IPV6-ADDRESS-LIST,VOLUME-GROUP
+
+    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
+        description: Whether the cloud region supports (true) or does not support (false) SR-IOV automation.
+      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 Uses l3-network, MANY2MANY)
+      - FROM availability-zone( availability-zone LocatedIn complex, MANY2ONE)
+      - FROM cloud-region( cloud-region LocatedIn complex, MANY2ONE)
+      - FROM ctag-pool( ctag-pool BelongsTo complex, MANY2ONE)(1)
+      - FROM generic-vnf( generic-vnf LocatedIn complex, MANY2MANY)
+      - FROM oam-network( oam-network AppliesTo complex, MANY2MANY)
+      - FROM pnf( pnf LocatedIn complex, MANY2ONE)
+      - FROM pserver( pserver LocatedIn complex, MANY2ONE)
+      - FROM vce( vce LocatedIn complex, MANY2MANY)
+      - FROM volume-group( volume-group LocatedIn complex, MANY2ONE)
+      - FROM vpls-pe( vpls-pe LocatedIn complex, MANY2ONE)
+      - FROM zone( zone LocatedIn complex, MANY2ONE)
+
+      -(1) IF this COMPLEX node is deleted, this FROM node is DELETED also
+      -COMPLEX cannot be deleted if related to AVAILABILITY-ZONE,CLOUD-REGION,GENERIC-VNF,OAM-NETWORK,PNF,PSERVER,VCE,VOLUME-GROUP,VPLS-PE,ZONE
+
+    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 Uses allotted-resource, ONE2ONE)(2)
+      - TO logical-link( configuration Uses logical-link, ONE2MANY)(2)
+      - FROM metadatum( metadatum BelongsTo configuration, MANY2ONE)(1)
+      - FROM generic-vnf( generic-vnf Uses configuration, ONE2MANY)(3)
+      - FROM service-instance( service-instance Uses configuration, ONE2MANY)
+
+      -(1) IF this CONFIGURATION node is deleted, this FROM node is DELETED also
+      -(2) IF this CONFIGURATION node is deleted, this TO node is DELETED also
+      -(3) IF this FROM node is deleted, this CONFIGURATION is DELETED also
+    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 LocatedIn virtual-data-center, MANY2MANY)
+      - FROM metadatum( metadatum BelongsTo connector, MANY2ONE)(1)
+      - FROM service-instance( service-instance Uses connector, MANY2MANY)
+
+      -(1) IF this CONNECTOR node is deleted, this FROM node is DELETED also
+    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 BelongsTo model-constraint, MANY2ONE)(4)
+      - TO model-element( constrained-element-set BelongsTo model-element, MANY2ONE)(4)
+      - FROM element-choice-set( element-choice-set BelongsTo constrained-element-set, MANY2ONE)(1)
+
+      -(1) IF this CONSTRAINED-ELEMENT-SET node is deleted, this FROM node is DELETED also
+      -(4) IF this TO node is deleted, this CONSTRAINED-ELEMENT-SET is DELETED also
+    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 BelongsTo l3-network, MANY2ONE)(4)
+      - FROM service-instance( service-instance Uses ctag-assignment, ONE2MANY)
+
+      -(4) IF this TO node is deleted, this CTAG-ASSIGNMENT is DELETED also
+    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 BelongsTo complex, MANY2ONE)(4)
+      - TO availability-zone( ctag-pool AppliesTo availability-zone, MANY2MANY)
+      - FROM generic-vnf( generic-vnf Uses ctag-pool, MANY2MANY)
+      - FROM vpls-pe( vpls-pe Uses ctag-pool, MANY2MANY)
+
+      -(4) IF this TO node is deleted, this CTAG-POOL is DELETED also
+    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 BelongsTo customer, MANY2ONE)(1)
+
+      -(1) IF this CUSTOMER node is deleted, this FROM node is DELETED also
+    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 BelongsTo cloud-region, MANY2ONE)
+      - TO availability-zone( dvs-switch 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 BelongsTo constrained-element-set, MANY2ONE)(4)
+      - FROM model-element( model-element BelongsTo element-choice-set, MANY2ONE)(1)
+
+      -(1) IF this ELEMENT-CHOICE-SET node is deleted, this FROM node is DELETED also
+      -(4) IF this TO node is deleted, this ELEMENT-CHOICE-SET is DELETED also
+    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 BelongsTo generic-vnf, MANY2ONE)(4)
+      - TO vce( entitlement BelongsTo vce, MANY2ONE)(4)
+
+      -(4) IF this TO node is deleted, this ENTITLEMENT is DELETED also
+    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
+      - FROM esr-system-info( esr-system-info BelongsTo esr-ems, MANY2ONE)(1)
+
+      -(1) IF this ESR-EMS node is deleted, this FROM node is DELETED also
+    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
+      - TO esr-ems( esr-system-info BelongsTo esr-ems, MANY2ONE)(4)
+      - TO esr-vnfm( esr-system-info BelongsTo esr-vnfm, ONE2ONE)(4)
+      - TO esr-thirdparty-sdnc( esr-system-info BelongsTo esr-thirdparty-sdnc, ONE2ONE)(4)
+      - TO cloud-region( esr-system-info BelongsTo cloud-region, MANY2ONE)(4)
+
+      -(4) IF this TO node is deleted, this ESR-SYSTEM-INFO is DELETED also
+    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 pnf( esr-thirdparty-sdnc AppliesTo pnf, ONE2MANY)
+      - FROM esr-system-info( esr-system-info BelongsTo esr-thirdparty-sdnc, ONE2ONE)(1)
+
+      -(1) IF this ESR-THIRDPARTY-SDNC node is deleted, this FROM node is DELETED also
+    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
+      - FROM esr-system-info( esr-system-info BelongsTo esr-vnfm, ONE2ONE)(1)
+
+      -(1) IF this ESR-VNFM node is deleted, this FROM node is DELETED also
+    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 BelongsTo configuration, ONE2ONE)(4)
+
+      -(4) IF this TO node is deleted, this EVC is DELETED also
+    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 BelongsTo cloud-region, MANY2ONE)
+      - FROM vserver( vserver Uses flavor, MANY2ONE)
+
+      -FLAVOR cannot be deleted if related 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 BelongsTo forwarding-path, MANY2ONE)(4)
+      - TO l-interface( forwarder ForwardsTo l-interface, MANY2ONE)
+      - TO configuration( forwarder Uses configuration, ONE2ONE)(2)
+      - TO lag-interface( forwarder ForwardsTo lag-interface, MANY2ONE)
+      - TO p-interface( forwarder ForwardsTo p-interface, MANY2ONE)
+
+      -(2) IF this FORWARDER node is deleted, this TO node is DELETED also
+      -(4) IF this TO node is deleted, this FORWARDER is DELETED also
+    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 BelongsTo configuration, ONE2ONE)(4)
+
+      -(4) IF this TO node is deleted, this FORWARDER-EVC is DELETED also
+    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 AppliesTo service-instance, MANY2ONE)(4)
+      - TO configuration( forwarding-path Uses configuration, ONE2ONE)(2)
+      - FROM forwarder( forwarder BelongsTo forwarding-path, MANY2ONE)(1)
+
+      -(1) IF this FORWARDING-PATH node is deleted, this FROM node is DELETED also
+      -(2) IF this FORWARDING-PATH node is deleted, this TO node is DELETED also
+      -(4) IF this TO node is deleted, this FORWARDING-PATH is DELETED also
+    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 Uses availability-zone, MANY2MANY)
+      - TO complex( generic-vnf LocatedIn complex, MANY2MANY)
+      - TO configuration( generic-vnf Uses configuration, ONE2MANY)(2)
+      - TO ctag-pool( generic-vnf Uses ctag-pool, MANY2MANY)
+      - TO instance-group( generic-vnf MemberOf instance-group, MANY2MANY)
+      - TO ipsec-configuration( generic-vnf Uses ipsec-configuration, MANY2ONE)
+      - TO l3-network( generic-vnf Uses l3-network, MANY2MANY)
+      - TO license-key-resource( generic-vnf Uses license-key-resource, MANY2MANY)
+      - TO pnf( generic-vnf HostedOn pnf, MANY2MANY)
+      - TO pserver( generic-vnf HostedOn pserver, MANY2MANY)
+      - TO vnf-image( generic-vnf Uses vnf-image, MANY2ONE)
+      - TO volume-group( generic-vnf DependsOn volume-group, ONE2MANY)
+      - TO vserver( generic-vnf HostedOn vserver, ONE2MANY)
+      - TO virtual-data-center( generic-vnf LocatedIn virtual-data-center, MANY2MANY)
+      - FROM allotted-resource( allotted-resource PartOf generic-vnf, MANY2MANY)
+      - FROM entitlement( entitlement BelongsTo generic-vnf, MANY2ONE)(1)
+      - FROM vnfc( vnfc BelongsTo generic-vnf, MANY2ONE)(1)
+      - FROM lag-interface( lag-interface BelongsTo generic-vnf, MANY2ONE)(1)
+      - FROM license( license BelongsTo generic-vnf, MANY2ONE)(1)
+      - FROM l-interface( l-interface BelongsTo generic-vnf, MANY2ONE)(1)
+      - FROM network-profile( network-profile AppliesTo generic-vnf, MANY2MANY)
+      - FROM service-instance( service-instance ComposedOf generic-vnf, ONE2MANY)
+      - FROM site-pair-set( site-pair-set AppliesTo generic-vnf, MANY2MANY)
+      - FROM vf-module( vf-module BelongsTo generic-vnf, MANY2ONE)(1)
+      - FROM line-of-business( line-of-business Uses generic-vnf, MANY2MANY)
+      - FROM logical-link( logical-link BridgedTo generic-vnf, MANY2MANY)
+      - FROM platform( platform Uses generic-vnf, MANY2MANY)
+
+      -(1) IF this GENERIC-VNF node is deleted, this FROM node is DELETED also
+      -(2) IF this GENERIC-VNF node is deleted, this TO node is DELETED also
+    required:
+    - vnf-id
+    - vnf-name
+    - vnf-type
+    - 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
+        description: used to indicate whether or not this object is in maintenance mode (maintenance mode = true). This field (in conjunction with prov-status) is used to suppress alarms and vSCL on VNFs/VMs.
+      is-closed-loop-disabled:
+        type: boolean
+        description: used to indicate whether closed loop function is enabled on this node
+  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 BelongsTo cloud-region, MANY2ONE)
+      - FROM pserver( pserver MemberOf group-assignment, MANY2ONE)
+      - FROM tenant( tenant 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 BelongsTo subnet, MANY2ONE)(4)
+
+      -(4) IF this TO node is deleted, this HOST-ROUTE is DELETED also
+    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 BelongsTo flavor, MANY2ONE)
+      - TO cloud-region( hpa-capability BelongsTo cloud-region, MANY2ONE)
+      - FROM hpa-feature-attributes( hpa-feature-attributes BelongsTo hpa-capability, MANY2ONE)(1)
+
+      -(1) IF this HPA-CAPABILITY node is deleted, this FROM node is DELETED also
+    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
+      architecture:
+        type: string
+        description: Hardware architecture
+  hpa-feature-attributes:
+    description: |
+      HPA Capability Feature attributes
+      ###### Related Nodes
+      - TO hpa-capability( hpa-feature-attributes BelongsTo hpa-capability, MANY2ONE)(4)
+
+      -(4) IF this TO node is deleted, this HPA-FEATURE-ATTRIBUTES is DELETED also
+    required:
+    - hpa-attribute-key
+    properties:
+      hpa-attribute-key:
+        type: string
+        description: name of the specific HPA attribute
+      hpa-attribute-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 BelongsTo cloud-region, MANY2ONE)
+      - FROM metadatum( metadatum BelongsTo image, MANY2ONE)(1)
+      - FROM vserver( vserver Uses image, MANY2ONE)
+
+      -(1) IF this IMAGE node is deleted, this FROM node is DELETED also
+      -IMAGE cannot be deleted if related to VSERVER
+
+    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 Targets model, MANY2MANY)
+      - FROM allotted-resource( allotted-resource MemberOf instance-group, MANY2MANY)
+      - FROM generic-vnf( generic-vnf MemberOf instance-group, MANY2MANY)
+      - FROM l3-interface-ipv4-address-list( l3-interface-ipv4-address-list MemberOf instance-group, MANY2MANY)
+      - FROM l3-interface-ipv6-address-list( l3-interface-ipv6-address-list MemberOf instance-group, MANY2MANY)
+      - FROM l3-network( l3-network MemberOf instance-group, MANY2MANY)
+      - FROM l-interface( l-interface MemberOf instance-group, MANY2MANY)
+      - FROM pnf( pnf MemberOf instance-group, MANY2MANY)
+      - FROM service-instance( service-instance MemberOf instance-group, MANY2MANY)
+      - FROM vip-ipv4-address-list( vip-ipv4-address-list MemberOf instance-group, MANY2MANY)
+      - FROM vip-ipv6-address-list( vip-ipv6-address-list MemberOf instance-group, MANY2MANY)
+      - FROM vnfc( vnfc MemberOf instance-group, MANY2MANY)
+
+    required:
+    - 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"
+      nodes:
+        type: object
+        $ref: "#/patchDefinitions/nodes"
+  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 Uses ipsec-configuration, MANY2ONE)
+      - FROM vig-server( vig-server BelongsTo ipsec-configuration, MANY2ONE)(1)
+
+      -(1) IF this IPSEC-CONFIGURATION node is deleted, this FROM node is DELETED also
+    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 BelongsTo generic-vnf, MANY2ONE)(4)
+      - TO lag-interface( l-interface BelongsTo lag-interface, MANY2ONE)(4)
+      - TO instance-group( l-interface MemberOf instance-group, MANY2MANY)
+      - TO l-interface( l-interface BelongsTo l-interface, MANY2ONE)(4)
+      - TO logical-link( l-interface LinksTo logical-link, MANY2MANY)(2)
+      - TO newvce( l-interface BelongsTo newvce, MANY2ONE)(4)
+      - TO p-interface( l-interface BindsTo p-interface, MANY2ONE)(4)
+      - TO vserver( l-interface BindsTo vserver, MANY2ONE)(4)
+      - FROM allotted-resource( allotted-resource Uses l-interface, ONE2MANY)
+      - FROM l3-interface-ipv4-address-list( l3-interface-ipv4-address-list BelongsTo l-interface, MANY2ONE)(1)
+      - FROM l3-interface-ipv6-address-list( l3-interface-ipv6-address-list BelongsTo l-interface, MANY2ONE)(1)
+      - FROM sriov-vf( sriov-vf BelongsTo l-interface, ONE2ONE)(1)
+      - FROM vlan( vlan LinksTo l-interface, MANY2ONE)(1)
+      - FROM l-interface( l-interface BelongsTo l-interface, MANY2ONE)(4)
+
+      -(1) IF this L-INTERFACE node is deleted, this FROM node is DELETED also
+      -(2) IF this L-INTERFACE node is deleted, this TO node is DELETED also
+      -(4) IF this TO node is deleted, this L-INTERFACE is DELETED also
+    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
+        description: boolean indicatating whether or not port is a mirrored.
+  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 MemberOf instance-group, MANY2MANY)
+      - TO l3-network( l3-interface-ipv4-address-list MemberOf l3-network, MANY2MANY)
+      - TO subnet( l3-interface-ipv4-address-list MemberOf subnet, MANY2MANY)
+      - TO l-interface( l3-interface-ipv4-address-list BelongsTo l-interface, MANY2ONE)(4)
+      - TO vlan( l3-interface-ipv4-address-list BelongsTo vlan, MANY2ONE)(4)
+      - TO vnfc( l3-interface-ipv4-address-list BelongsTo vnfc, MANY2ONE)(4)
+
+      -(4) IF this TO node is deleted, this L3-INTERFACE-IPV4-ADDRESS-LIST is DELETED also
+    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 MemberOf instance-group, MANY2MANY)
+      - TO l3-network( l3-interface-ipv6-address-list MemberOf l3-network, MANY2MANY)
+      - TO subnet( l3-interface-ipv6-address-list MemberOf subnet, MANY2MANY)
+      - TO l-interface( l3-interface-ipv6-address-list BelongsTo l-interface, MANY2ONE)(4)
+      - TO vlan( l3-interface-ipv6-address-list BelongsTo vlan, MANY2ONE)(4)
+      - TO vnfc( l3-interface-ipv6-address-list BelongsTo vnfc, MANY2ONE)(4)
+
+      -(4) IF this TO node is deleted, this L3-INTERFACE-IPV6-ADDRESS-LIST is DELETED also
+    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 MemberOf instance-group, MANY2MANY)
+      - TO network-policy( l3-network Uses network-policy, MANY2MANY)
+      - TO route-table-reference( l3-network Uses route-table-reference, MANY2MANY)
+      - TO vpn-binding( l3-network Uses vpn-binding, MANY2MANY)
+      - FROM allotted-resource( allotted-resource PartOf l3-network, MANY2MANY)
+      - FROM cloud-region( cloud-region Uses l3-network, MANY2MANY)
+      - FROM complex( complex Uses l3-network, MANY2MANY)
+      - FROM generic-vnf( generic-vnf Uses l3-network, MANY2MANY)
+      - FROM l3-interface-ipv4-address-list( l3-interface-ipv4-address-list MemberOf l3-network, MANY2MANY)
+      - FROM l3-interface-ipv6-address-list( l3-interface-ipv6-address-list MemberOf l3-network, MANY2MANY)
+      - FROM ctag-assignment( ctag-assignment BelongsTo l3-network, MANY2ONE)(1)
+      - FROM segmentation-assignment( segmentation-assignment BelongsTo l3-network, MANY2ONE)(1)
+      - FROM service-instance( service-instance ComposedOf l3-network, ONE2MANY)
+      - FROM subnet( subnet BelongsTo l3-network, MANY2ONE)(1)
+      - FROM tenant( tenant Uses l3-network, MANY2MANY)
+      - FROM vf-module( vf-module DependsOn l3-network, MANY2MANY)
+
+      -(1) IF this L3-NETWORK node is deleted, this FROM node is DELETED also
+    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
+        description: Set to true if bound to VPN
+      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 BelongsTo generic-vnf, MANY2ONE)(4)
+      - TO lag-link( lag-interface LinksTo lag-link, MANY2MANY)(2)
+      - TO logical-link( lag-interface Uses logical-link, MANY2MANY)(2)
+      - TO p-interface( lag-interface Uses p-interface, MANY2MANY)
+      - TO pnf( lag-interface BindsTo pnf, MANY2ONE)(4)
+      - TO pserver( lag-interface BindsTo pserver, MANY2ONE)(4)
+      - TO vpls-pe( lag-interface BindsTo vpls-pe, MANY2ONE)(4)
+      - FROM l-interface( l-interface BelongsTo lag-interface, MANY2ONE)(1)
+
+      -(1) IF this LAG-INTERFACE node is deleted, this FROM node is DELETED also
+      -(2) IF this LAG-INTERFACE node is deleted, this TO node is DELETED also
+      -(4) IF this TO node is deleted, this LAG-INTERFACE is DELETED also
+    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 LinksTo lag-link, MANY2MANY)(3)
+      - FROM logical-link( logical-link Uses lag-link, MANY2MANY)
+
+      -(3) IF this FROM node is deleted, this LAG-LINK is DELETED also
+    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 BelongsTo generic-vnf, MANY2ONE)(4)
+      - TO vce( license BelongsTo vce, MANY2ONE)(4)
+
+      -(4) IF this TO node is deleted, this LICENSE is DELETED also
+    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 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 LocatedIn cloud-region, MANY2MANY)
+      - TO generic-vnf( logical-link BridgedTo generic-vnf, MANY2MANY)
+      - TO lag-link( logical-link Uses lag-link, MANY2MANY)
+      - TO logical-link( logical-link Uses logical-link, MANY2MANY)
+      - TO pnf( logical-link BridgedTo pnf, MANY2MANY)
+      - TO pserver( logical-link BridgedTo pserver, MANY2MANY)
+      - TO vpn-binding( logical-link Uses vpn-binding, MANY2MANY)
+      - TO virtual-data-center( logical-link LocatedIn virtual-data-center, MANY2MANY)
+      - FROM configuration( configuration Uses logical-link, ONE2MANY)(3)
+      - FROM lag-interface( lag-interface Uses logical-link, MANY2MANY)(3)
+      - FROM l-interface( l-interface LinksTo logical-link, MANY2MANY)(3)
+      - FROM p-interface( p-interface LinksTo logical-link, MANY2ONE)
+      - FROM service-instance( service-instance Uses logical-link, ONE2MANY)(3)
+      - FROM vlan( vlan Uses logical-link, MANY2MANY)(3)
+      - FROM logical-link( logical-link Uses logical-link, MANY2MANY)
+
+      -(3) IF this FROM node is deleted, this LOGICAL-LINK is DELETED also
+    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
+        description: used to indicate whether or not this object is in maintenance mode (maintenance mode = true). This field (in conjunction with prov-status) is used to suppress alarms and vSCL on VNFs/VMs.
+      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 BelongsTo configuration, MANY2ONE)(4)
+      - TO connector( metadatum BelongsTo connector, MANY2ONE)(4)
+      - TO image( metadatum BelongsTo image, MANY2ONE)(4)
+      - TO service-instance( metadatum BelongsTo service-instance, MANY2ONE)(4)
+      - TO model-ver( metadatum BelongsTo model-ver, MANY2ONE)(4)
+
+      -(4) IF this TO node is deleted, this METADATUM is DELETED also
+    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 BelongsTo model, MANY2ONE)(1)
+      - FROM instance-group( instance-group Targets model, MANY2MANY)
+      - FROM model-ver( model-ver BelongsTo model, MANY2ONE)(1)
+      - FROM named-query( named-query AppliesTo model, ONE2MANY)
+      - FROM named-query-element( named-query-element IsA model, MANY2ONE)
+
+      -(1) IF this MODEL node is deleted, this FROM node is DELETED also
+      -MODEL cannot be deleted if related to INSTANCE-GROUP,NAMED-QUERY,NAMED-QUERY-ELEMENT
+
+    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 BelongsTo model-element, MANY2ONE)(4)
+      - FROM constrained-element-set( constrained-element-set BelongsTo model-constraint, MANY2ONE)(1)
+
+      -(1) IF this MODEL-CONSTRAINT node is deleted, this FROM node is DELETED also
+      -(4) IF this TO node is deleted, this MODEL-CONSTRAINT is DELETED also
+    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 BelongsTo element-choice-set, MANY2ONE)(4)
+      - TO model-element( model-element BelongsTo model-element, MANY2ONE)(4)
+      - TO model-ver( model-element IsA model-ver, MANY2ONE)
+      - TO model-ver( model-element BelongsTo model-ver, MANY2ONE)(4)
+      - FROM constrained-element-set( constrained-element-set BelongsTo model-element, MANY2ONE)(1)
+      - FROM model-constraint( model-constraint BelongsTo model-element, MANY2ONE)(1)
+      - FROM model-element( model-element BelongsTo model-element, MANY2ONE)(4)
+
+      -(1) IF this MODEL-ELEMENT node is deleted, this FROM node is DELETED also
+      -(4) IF this TO node is deleted, this MODEL-ELEMENT is DELETED also
+    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 BelongsTo model, MANY2ONE)(4)
+      - FROM model-element( model-element IsA model-ver, MANY2ONE)
+      - FROM model-element( model-element BelongsTo model-ver, MANY2ONE)(1)
+      - FROM metadatum( metadatum BelongsTo model-ver, MANY2ONE)(1)
+
+      -(1) IF this MODEL-VER node is deleted, this FROM node is DELETED also
+      -(4) IF this TO node is deleted, this MODEL-VER is DELETED also
+      -MODEL-VER cannot be deleted if related to MODEL-ELEMENT
+
+    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 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 BelongsTo named-query, ONE2ONE)(1)
+      - TO model( named-query AppliesTo model, ONE2MANY)
+      - FROM named-query-element( named-query-element BelongsTo named-query, ONE2ONE)(1)
+
+      -(1) IF this NAMED-QUERY node is deleted, this FROM node is DELETED also
+    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 BelongsTo named-query, ONE2ONE)(4)
+      - TO model( named-query-element IsA model, MANY2ONE)
+      - TO named-query-element( named-query-element BelongsTo named-query-element, MANY2ONE)(4)
+      - FROM property-constraint( property-constraint BelongsTo named-query-element, MANY2ONE)(1)
+      - FROM related-lookup( related-lookup BelongsTo named-query-element, MANY2ONE)(1)
+      - FROM named-query-element( named-query-element BelongsTo named-query-element, MANY2ONE)(4)
+
+      -(1) IF this NAMED-QUERY-ELEMENT node is deleted, this FROM node is DELETED also
+      -(4) IF this TO node is deleted, this NAMED-QUERY-ELEMENT is DELETED also
+    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 Uses network-policy, ONE2ONE)
+      - FROM l3-network( l3-network 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 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 BelongsTo newvce, MANY2ONE)(1)
+
+      -(1) IF this NEWVCE node is deleted, this FROM node is DELETED also
+    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"
+  nodes:
+    properties:
+      inventory-item-data:
+        type: array
+        items:
+          $ref: "#/patchDefinitions/inventory-item-data"
+  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 BelongsTo cloud-region, MANY2ONE)
+      - TO complex( oam-network AppliesTo complex, MANY2MANY)
+      - TO service-capability( oam-network 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 Uses operational-environment, ONE2ONE)
+      - FROM operational-environment( operational-environment 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 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 LinksTo logical-link, MANY2ONE)
+      - TO physical-link( p-interface LinksTo physical-link, MANY2ONE)(2)
+      - TO pnf( p-interface BindsTo pnf, MANY2ONE)(4)
+      - TO pserver( p-interface BindsTo pserver, MANY2ONE)(4)
+      - TO vpls-pe( p-interface BindsTo vpls-pe, MANY2ONE)(4)
+      - FROM lag-interface( lag-interface Uses p-interface, MANY2MANY)
+      - FROM l-interface( l-interface BindsTo p-interface, MANY2ONE)(1)
+      - FROM sriov-pf( sriov-pf BelongsTo p-interface, ONE2ONE)(1)
+
+      -(1) IF this P-INTERFACE node is deleted, this FROM node is DELETED also
+      -(2) IF this P-INTERFACE node is deleted, this TO node is DELETED also
+      -(4) IF this TO node is deleted, this P-INTERFACE is DELETED also
+    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 LinksTo physical-link, MANY2ONE)(3)
+
+      -(3) IF this FROM node is deleted, this PHYSICAL-LINK is DELETED also
+    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 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 LocatedIn complex, MANY2ONE)
+      - TO instance-group( pnf MemberOf instance-group, MANY2MANY)
+      - TO zone( pnf LocatedIn zone, MANY2ONE)
+      - FROM esr-thirdparty-sdnc( esr-thirdparty-sdnc AppliesTo pnf, ONE2MANY)
+      - FROM generic-vnf( generic-vnf HostedOn pnf, MANY2MANY)
+      - FROM logical-link( logical-link BridgedTo pnf, MANY2MANY)
+      - FROM lag-interface( lag-interface BindsTo pnf, MANY2ONE)(1)
+      - FROM p-interface( p-interface BindsTo pnf, MANY2ONE)(1)
+      - FROM service-instance( service-instance ComposedOf pnf, ONE2MANY)
+
+      -(1) IF this PNF node is deleted, this FROM node is DELETED also
+    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
+        description: Used to indicate whether or not this object is in maintenance mode (maintenance mode = true). This field (in conjunction with prov-status) is used to suppress alarms and vSCL on VNFs/VMs.
+      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 BelongsTo vce, MANY2ONE)(4)
+      - FROM cvlan-tag( cvlan-tag BelongsTo port-group, MANY2ONE)(1)
+
+      -(1) IF this PORT-GROUP node is deleted, this FROM node is DELETED also
+      -(4) IF this TO node is deleted, this PORT-GROUP is DELETED also
+    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 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 BelongsTo named-query-element, MANY2ONE)(4)
+
+      -(4) IF this TO node is deleted, this PROPERTY-CONSTRAINT is DELETED also
+    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 MemberOf group-assignment, MANY2ONE)
+      - TO availability-zone( pserver MemberOf availability-zone, MANY2ONE)
+      - TO cloud-region( pserver LocatedIn cloud-region, MANY2ONE)
+      - TO complex( pserver LocatedIn complex, MANY2ONE)
+      - TO zone( pserver LocatedIn zone, MANY2ONE)
+      - FROM generic-vnf( generic-vnf HostedOn pserver, MANY2MANY)
+      - FROM logical-link( logical-link BridgedTo pserver, MANY2MANY)
+      - FROM lag-interface( lag-interface BindsTo pserver, MANY2ONE)(1)
+      - FROM p-interface( p-interface BindsTo pserver, MANY2ONE)(1)
+      - FROM vserver( vserver HostedOn pserver, MANY2ONE)
+
+      -(1) IF this PSERVER node is deleted, this FROM node is DELETED also
+      -PSERVER cannot be deleted if related to GENERIC-VNF,LOGICAL-LINK,VSERVER,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
+        description: used to indicate whether or not this object is in maintenance mode (maintenance mode = true). This field (in conjunction with prov-status) is used to suppress alarms and vSCL on VNFs/VMs.
+  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 BelongsTo named-query-element, MANY2ONE)(4)
+
+      -(4) IF this TO node is deleted, this RELATED-LOOKUP is DELETED also
+    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 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 BelongsTo vpn-binding, MANY2ONE)(4)
+
+      -(4) IF this TO node is deleted, this ROUTE-TARGET is DELETED also
+    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 BelongsTo site-pair-set, MANY2ONE)(4)
+      - FROM site-pair( site-pair BelongsTo routing-instance, MANY2ONE)(1)
+
+      -(1) IF this ROUTING-INSTANCE node is deleted, this FROM node is DELETED also
+      -(4) IF this TO node is deleted, this ROUTING-INSTANCE is DELETED also
+    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 BelongsTo l3-network, MANY2ONE)(4)
+
+      -(4) IF this TO node is deleted, this SEGMENTATION-ASSIGNMENT is DELETED also
+    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 AppliesTo service-capability, MANY2MANY)
+      - FROM oam-network( oam-network AppliesTo service-capability, MANY2MANY)
+
+      -SERVICE-CAPABILITY cannot be deleted if related 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 ComposedOf generic-vnf, ONE2MANY)
+      - TO l3-network( service-instance ComposedOf l3-network, ONE2MANY)
+      - TO owning-entity( service-instance BelongsTo owning-entity, MANY2ONE)
+      - TO allotted-resource( service-instance Uses allotted-resource, MANY2MANY)
+      - TO configuration( service-instance Uses configuration, ONE2MANY)
+      - TO connector( service-instance Uses connector, MANY2MANY)
+      - TO ctag-assignment( service-instance Uses ctag-assignment, ONE2MANY)
+      - TO cvlan-tag( service-instance ComposedOf cvlan-tag, MANY2MANY)
+      - TO instance-group( service-instance MemberOf instance-group, MANY2MANY)
+      - TO logical-link( service-instance Uses logical-link, ONE2MANY)(2)
+      - TO pnf( service-instance ComposedOf pnf, ONE2MANY)
+      - TO service-instance( service-instance ComposedOf service-instance, ONE2MANY)
+      - TO vlan( service-instance ComposedOf vlan, ONE2MANY)
+      - TO zone( service-instance LocatedIn zone, MANY2ONE)
+      - TO service-subscription( service-instance BelongsTo service-subscription, MANY2ONE)(4)
+      - TO vce( service-instance ComposedOf vce, ONE2MANY)
+      - FROM project( project Uses service-instance, ONE2MANY)
+      - FROM allotted-resource( allotted-resource BelongsTo service-instance, MANY2ONE)(1)
+      - FROM metadatum( metadatum BelongsTo service-instance, MANY2ONE)(1)
+      - FROM service-instance( service-instance ComposedOf service-instance, ONE2MANY)
+
+      -(1) IF this SERVICE-INSTANCE node is deleted, this FROM node is DELETED also
+      -(2) IF this SERVICE-INSTANCE node is deleted, this TO node is DELETED also
+      -(4) IF this TO node is deleted, this SERVICE-INSTANCE is DELETED also
+    required:
+    - service-instance-id
+    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 BelongsTo customer, MANY2ONE)(4)
+      - TO tenant( service-subscription Uses tenant, MANY2MANY)
+      - FROM service-instance( service-instance BelongsTo service-subscription, MANY2ONE)(1)
+
+      -(1) IF this SERVICE-SUBSCRIPTION node is deleted, this FROM node is DELETED also
+      -(4) IF this TO node is deleted, this SERVICE-SUBSCRIPTION is DELETED also
+    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 BelongsTo routing-instance, MANY2ONE)(4)
+      - FROM class-of-service( class-of-service BelongsTo site-pair, MANY2ONE)(1)
+
+      -(1) IF this SITE-PAIR node is deleted, this FROM node is DELETED also
+      -(4) IF this TO node is deleted, this SITE-PAIR is DELETED also
+    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 AppliesTo generic-vnf, MANY2MANY)
+      - FROM routing-instance( routing-instance BelongsTo site-pair-set, MANY2ONE)(1)
+
+      -(1) IF this SITE-PAIR-SET node is deleted, this FROM node is DELETED also
+    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 BelongsTo cloud-region, MANY2ONE)
+      - FROM vserver( vserver 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 BelongsTo p-interface, ONE2ONE)(4)
+      - FROM sriov-vf( sriov-vf Uses sriov-pf, MANY2ONE)
+
+      -(4) IF this TO node is deleted, this SRIOV-PF is DELETED also
+    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 BelongsTo l-interface, ONE2ONE)(4)
+      - TO sriov-pf( sriov-vf Uses sriov-pf, MANY2ONE)
+
+      -(4) IF this TO node is deleted, this SRIOV-VF is DELETED also
+    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 BelongsTo l3-network, MANY2ONE)(4)
+      - FROM l3-interface-ipv4-address-list( l3-interface-ipv4-address-list MemberOf subnet, MANY2MANY)
+      - FROM l3-interface-ipv6-address-list( l3-interface-ipv6-address-list MemberOf subnet, MANY2MANY)
+      - FROM host-route( host-route BelongsTo subnet, MANY2ONE)(1)
+      - FROM vip-ipv4-address-list( vip-ipv4-address-list MemberOf subnet, MANY2MANY)
+      - FROM vip-ipv6-address-list( vip-ipv6-address-list MemberOf subnet, MANY2MANY)
+
+      -(1) IF this SUBNET node is deleted, this FROM node is DELETED also
+      -(4) IF this TO node is deleted, this SUBNET is DELETED also
+      -SUBNET cannot be deleted if related to L3-INTERFACE-IPV4-ADDRESS-LIST,L3-INTERFACE-IPV6-ADDRESS-LIST,VIP-IPV4-ADDRESS-LIST,VIP-IPV6-ADDRESS-LIST
+
+    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
+        description: dhcp enabled
+      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 BelongsTo cloud-region, MANY2ONE)
+      - TO group-assignment( tenant MemberOf group-assignment, MANY2MANY)
+      - TO l3-network( tenant Uses l3-network, MANY2MANY)
+      - TO volume-group( tenant DependsOn volume-group, ONE2MANY)
+      - FROM service-subscription( service-subscription Uses tenant, MANY2MANY)
+      - FROM vserver( vserver BelongsTo tenant, MANY2ONE)
+
+      -TENANT cannot be deleted if related 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 BelongsTo allotted-resource, ONE2ONE)(4)
+
+      -(4) IF this TO node is deleted, this TUNNEL-XCONNECT is DELETED also
+    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 Uses availability-zone, MANY2MANY)
+      - TO complex( vce LocatedIn complex, MANY2MANY)
+      - TO vserver( vce HostedOn vserver, ONE2MANY)
+      - FROM entitlement( entitlement BelongsTo vce, MANY2ONE)(1)
+      - FROM license( license BelongsTo vce, MANY2ONE)(1)
+      - FROM port-group( port-group BelongsTo vce, MANY2ONE)(1)
+      - FROM service-instance( service-instance ComposedOf vce, ONE2MANY)
+
+      -(1) IF this VCE node is deleted, this FROM node is DELETED also
+    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 BelongsTo generic-vnf, MANY2ONE)(4)
+      - TO l3-network( vf-module DependsOn l3-network, MANY2MANY)
+      - TO vnfc( vf-module Uses vnfc, ONE2MANY)
+      - TO volume-group( vf-module Uses volume-group, ONE2ONE)
+      - TO vserver( vf-module Uses vserver, ONE2MANY)
+
+      -(4) IF this TO node is deleted, this VF-MODULE is DELETED also
+      -VF-MODULE cannot be deleted if related 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
+        description: used to indicate whether or not this object is base vf module
+  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 BelongsTo ipsec-configuration, MANY2ONE)(4)
+
+      -(4) IF this TO node is deleted, this VIG-SERVER is DELETED also
+    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 BelongsTo cloud-region, MANY2ONE)
+      - TO instance-group( vip-ipv4-address-list MemberOf instance-group, MANY2MANY)
+      - TO subnet( vip-ipv4-address-list MemberOf subnet, MANY2MANY)
+      - FROM vnfc( vnfc 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 BelongsTo cloud-region, MANY2ONE)
+      - TO instance-group( vip-ipv6-address-list MemberOf instance-group, MANY2MANY)
+      - TO subnet( vip-ipv6-address-list MemberOf subnet, MANY2MANY)
+      - FROM vnfc( vnfc 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 LocatedIn virtual-data-center, MANY2MANY)
+      - FROM generic-vnf( generic-vnf LocatedIn virtual-data-center, MANY2MANY)
+      - FROM logical-link( logical-link 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 LinksTo l-interface, MANY2ONE)(4)
+      - TO logical-link( vlan Uses logical-link, MANY2MANY)(2)
+      - TO multicast-configuration( vlan Uses multicast-configuration, MANY2MANY)
+      - FROM allotted-resource( allotted-resource PartOf vlan, MANY2MANY)
+      - FROM service-instance( service-instance ComposedOf vlan, ONE2MANY)
+      - FROM l3-interface-ipv4-address-list( l3-interface-ipv4-address-list BelongsTo vlan, MANY2ONE)(1)
+      - FROM l3-interface-ipv6-address-list( l3-interface-ipv6-address-list BelongsTo vlan, MANY2ONE)(1)
+
+      -(1) IF this VLAN node is deleted, this FROM node is DELETED also
+      -(2) IF this VLAN node is deleted, this TO node is DELETED also
+      -(4) IF this TO node is deleted, this VLAN is DELETED also
+    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 Uses vnf-image, MANY2ONE)
+
+      -VNF-IMAGE cannot be deleted if related 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 BelongsTo generic-vnf, MANY2ONE)(4)
+      - TO instance-group( vnfc MemberOf instance-group, MANY2MANY)
+      - TO vip-ipv4-address-list( vnfc Uses vip-ipv4-address-list, MANY2MANY)
+      - TO vip-ipv6-address-list( vnfc Uses vip-ipv6-address-list, MANY2MANY)
+      - TO vserver( vnfc HostedOn vserver, ONE2MANY)
+      - FROM vf-module( vf-module Uses vnfc, ONE2MANY)
+      - FROM l3-interface-ipv4-address-list( l3-interface-ipv4-address-list BelongsTo vnfc, MANY2ONE)(1)
+      - FROM l3-interface-ipv6-address-list( l3-interface-ipv6-address-list BelongsTo vnfc, MANY2ONE)(1)
+
+      -(1) IF this VNFC node is deleted, this FROM node is DELETED also
+      -(4) IF this TO node is deleted, this VNFC is DELETED also
+    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
+        description: used to indicate whether or not this object is in maintenance mode (maintenance mode = true)
+      is-closed-loop-disabled:
+        type: boolean
+        description: used to indicate whether closed loop function is enabled on this node
+      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 AttachesTo volume)(3)
+
+      -(3) IF this FROM node is deleted, this VOLUME is DELETED also
+    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 BelongsTo cloud-region, MANY2ONE)
+      - TO complex( volume-group LocatedIn complex, MANY2ONE)
+      - FROM generic-vnf( generic-vnf DependsOn volume-group, ONE2MANY)
+      - FROM vf-module( vf-module Uses volume-group, ONE2ONE)
+      - FROM tenant( tenant 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 LocatedIn complex, MANY2ONE)
+      - TO ctag-pool( vpls-pe Uses ctag-pool, MANY2MANY)
+      - FROM lag-interface( lag-interface BindsTo vpls-pe, MANY2ONE)(1)
+      - FROM p-interface( p-interface BindsTo vpls-pe, MANY2ONE)(1)
+
+      -(1) IF this VPLS-PE node is deleted, this FROM node is DELETED also
+    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 BelongsTo vpn-binding, MANY2MANY)
+      - FROM l3-network( l3-network Uses vpn-binding, MANY2MANY)
+      - FROM logical-link( logical-link Uses vpn-binding, MANY2MANY)
+      - FROM route-target( route-target BelongsTo vpn-binding, MANY2ONE)(1)
+
+      -(1) IF this VPN-BINDING node is deleted, this FROM node is DELETED also
+      -VPN-BINDING cannot be deleted if related to ALLOTTED-RESOURCE,L3-NETWORK,LOGICAL-LINK
+
+    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 BelongsTo tenant, MANY2ONE)
+      - TO flavor( vserver Uses flavor, MANY2ONE)
+      - TO image( vserver Uses image, MANY2ONE)
+      - TO pserver( vserver HostedOn pserver, MANY2ONE)
+      - TO snapshot( vserver Uses snapshot, ONE2ONE)
+      - TO volume (CHILD of vserver, vserver AttachesTo volume, ONE2MANY)(2)
+      - FROM generic-vnf( generic-vnf HostedOn vserver, ONE2MANY)
+      - FROM vce( vce HostedOn vserver, ONE2MANY)
+      - FROM l-interface( l-interface BindsTo vserver, MANY2ONE)(1)
+      - FROM vf-module( vf-module Uses vserver, ONE2MANY)
+      - FROM vnfc( vnfc HostedOn vserver, ONE2MANY)
+
+      -(1) IF this VSERVER node is deleted, this FROM node is DELETED also
+      -(2) IF this VSERVER node is deleted, this TO node is DELETED also
+    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
+        description: Used to indicate whether or not this object is in maintenance mode (maintenance mode = true). This field (in conjunction with prov-status) is used to suppress alarms and vSCL on VNFs/VMs.
+      is-closed-loop-disabled:
+        type: boolean
+        description: Used to indicate whether closed loop function is enabled on this node
+  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 LocatedIn complex, MANY2ONE)
+      - FROM cloud-region( cloud-region LocatedIn zone, MANY2ONE)
+      - FROM pnf( pnf LocatedIn zone, MANY2ONE)
+      - FROM pserver( pserver LocatedIn zone, MANY2ONE)
+      - FROM service-instance( service-instance 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:
+  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 BindsTo allotted-resource, ONE2ONE)
+      - TO generic-vnf( allotted-resource PartOf generic-vnf, MANY2MANY)
+      - TO instance-group( allotted-resource MemberOf instance-group, MANY2MANY)
+      - TO l3-network( allotted-resource PartOf l3-network, MANY2MANY)
+      - TO l-interface( allotted-resource Uses l-interface, ONE2MANY)
+      - TO network-policy( allotted-resource Uses network-policy, ONE2ONE)
+      - TO vlan( allotted-resource PartOf vlan, MANY2MANY)
+      - TO vpn-binding( allotted-resource BelongsTo vpn-binding, MANY2MANY)
+      - TO service-instance( allotted-resource BelongsTo service-instance, MANY2ONE)(4)
+      - FROM tunnel-xconnect( tunnel-xconnect BelongsTo allotted-resource, ONE2ONE)(1)
+      - FROM configuration( configuration Uses allotted-resource, ONE2ONE)(3)
+      - FROM service-instance( service-instance Uses allotted-resource, MANY2MANY)
+      - FROM allotted-resource( allotted-resource BindsTo allotted-resource, ONE2ONE)
+
+      -(1) IF this ALLOTTED-RESOURCE node is deleted, this FROM node is DELETED also
+      -(3) IF this FROM node is deleted, this ALLOTTED-RESOURCE is DELETED also
+      -(4) IF this TO node is deleted, this ALLOTTED-RESOURCE is DELETED also
+    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 LocatedIn complex, MANY2ONE)
+      - TO service-capability( availability-zone AppliesTo service-capability, MANY2MANY)
+      - TO cloud-region( availability-zone BelongsTo cloud-region, MANY2ONE)(4)
+      - FROM ctag-pool( ctag-pool AppliesTo availability-zone, MANY2MANY)
+      - FROM dvs-switch( dvs-switch AppliesTo availability-zone, MANY2MANY)
+      - FROM generic-vnf( generic-vnf Uses availability-zone, MANY2MANY)
+      - FROM pserver( pserver MemberOf availability-zone, MANY2ONE)
+      - FROM vce( vce Uses availability-zone, MANY2MANY)
+
+      -(4) IF this TO node is deleted, this AVAILABILITY-ZONE is DELETED also
+      -AVAILABILITY-ZONE cannot be deleted if related 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 BelongsTo site-pair, MANY2ONE)(4)
+
+      -(4) IF this TO node is deleted, this CLASS-OF-SERVICE is DELETED also
+    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 complex( cloud-region LocatedIn complex, MANY2ONE)
+      - TO l3-network( cloud-region Uses l3-network, MANY2MANY)
+      - TO zone( cloud-region LocatedIn zone, MANY2ONE)
+      - FROM esr-system-info( esr-system-info BelongsTo cloud-region, MANY2ONE)(1)
+      - FROM availability-zone( availability-zone BelongsTo cloud-region, MANY2ONE)(1)
+      - FROM dvs-switch( dvs-switch BelongsTo cloud-region, MANY2ONE)
+      - FROM flavor( flavor BelongsTo cloud-region, MANY2ONE)
+      - FROM group-assignment( group-assignment BelongsTo cloud-region, MANY2ONE)
+      - FROM image( image BelongsTo cloud-region, MANY2ONE)
+      - FROM oam-network( oam-network BelongsTo cloud-region, MANY2ONE)
+      - FROM snapshot( snapshot BelongsTo cloud-region, MANY2ONE)
+      - FROM tenant( tenant BelongsTo cloud-region, MANY2ONE)
+      - FROM vip-ipv4-address-list( vip-ipv4-address-list BelongsTo cloud-region, MANY2ONE)
+      - FROM vip-ipv6-address-list( vip-ipv6-address-list BelongsTo cloud-region, MANY2ONE)
+      - FROM volume-group( volume-group BelongsTo cloud-region, MANY2ONE)
+      - FROM logical-link( logical-link LocatedIn cloud-region, MANY2MANY)
+      - FROM pserver( pserver LocatedIn cloud-region, MANY2ONE)
+
+      -(1) IF this CLOUD-REGION node is deleted, this FROM node is DELETED also
+      -CLOUD-REGION cannot be deleted if related to DVS-SWITCH,FLAVOR,GROUP-ASSIGNMENT,IMAGE,OAM-NETWORK,SNAPSHOT,TENANT,VIP-IPV4-ADDRESS-LIST,VIP-IPV6-ADDRESS-LIST,VOLUME-GROUP
+
+    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
+        description: Whether the cloud region supports (true) or does not support (false) SR-IOV automation.
+      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 Uses l3-network, MANY2MANY)
+      - FROM availability-zone( availability-zone LocatedIn complex, MANY2ONE)
+      - FROM cloud-region( cloud-region LocatedIn complex, MANY2ONE)
+      - FROM ctag-pool( ctag-pool BelongsTo complex, MANY2ONE)(1)
+      - FROM generic-vnf( generic-vnf LocatedIn complex, MANY2MANY)
+      - FROM oam-network( oam-network AppliesTo complex, MANY2MANY)
+      - FROM pnf( pnf LocatedIn complex, MANY2ONE)
+      - FROM pserver( pserver LocatedIn complex, MANY2ONE)
+      - FROM vce( vce LocatedIn complex, MANY2MANY)
+      - FROM volume-group( volume-group LocatedIn complex, MANY2ONE)
+      - FROM vpls-pe( vpls-pe LocatedIn complex, MANY2ONE)
+      - FROM zone( zone LocatedIn complex, MANY2ONE)
+
+      -(1) IF this COMPLEX node is deleted, this FROM node is DELETED also
+      -COMPLEX cannot be deleted if related to AVAILABILITY-ZONE,CLOUD-REGION,GENERIC-VNF,OAM-NETWORK,PNF,PSERVER,VCE,VOLUME-GROUP,VPLS-PE,ZONE
+
+    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 Uses allotted-resource, ONE2ONE)(2)
+      - TO logical-link( configuration Uses logical-link, ONE2MANY)(2)
+      - FROM metadatum( metadatum BelongsTo configuration, MANY2ONE)(1)
+      - FROM generic-vnf( generic-vnf Uses configuration, ONE2MANY)(3)
+      - FROM service-instance( service-instance Uses configuration, ONE2MANY)
+
+      -(1) IF this CONFIGURATION node is deleted, this FROM node is DELETED also
+      -(2) IF this CONFIGURATION node is deleted, this TO node is DELETED also
+      -(3) IF this FROM node is deleted, this CONFIGURATION is DELETED also
+    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 LocatedIn virtual-data-center, MANY2MANY)
+      - FROM metadatum( metadatum BelongsTo connector, MANY2ONE)(1)
+      - FROM service-instance( service-instance Uses connector, MANY2MANY)
+
+      -(1) IF this CONNECTOR node is deleted, this FROM node is DELETED also
+    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 BelongsTo model-constraint, MANY2ONE)(4)
+      - TO model-element( constrained-element-set BelongsTo model-element, MANY2ONE)(4)
+      - FROM element-choice-set( element-choice-set BelongsTo constrained-element-set, MANY2ONE)(1)
+
+      -(1) IF this CONSTRAINED-ELEMENT-SET node is deleted, this FROM node is DELETED also
+      -(4) IF this TO node is deleted, this CONSTRAINED-ELEMENT-SET is DELETED also
+    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 BelongsTo l3-network, MANY2ONE)(4)
+      - FROM service-instance( service-instance Uses ctag-assignment, ONE2MANY)
+
+      -(4) IF this TO node is deleted, this CTAG-ASSIGNMENT is DELETED also
+    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 BelongsTo complex, MANY2ONE)(4)
+      - TO availability-zone( ctag-pool AppliesTo availability-zone, MANY2MANY)
+      - FROM generic-vnf( generic-vnf Uses ctag-pool, MANY2MANY)
+      - FROM vpls-pe( vpls-pe Uses ctag-pool, MANY2MANY)
+
+      -(4) IF this TO node is deleted, this CTAG-POOL is DELETED also
+    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 BelongsTo customer, MANY2ONE)(1)
+
+      -(1) IF this CUSTOMER node is deleted, this FROM node is DELETED also
+    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 BelongsTo cloud-region, MANY2ONE)
+      - TO availability-zone( dvs-switch 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 BelongsTo constrained-element-set, MANY2ONE)(4)
+      - FROM model-element( model-element BelongsTo element-choice-set, MANY2ONE)(1)
+
+      -(1) IF this ELEMENT-CHOICE-SET node is deleted, this FROM node is DELETED also
+      -(4) IF this TO node is deleted, this ELEMENT-CHOICE-SET is DELETED also
+    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 BelongsTo generic-vnf, MANY2ONE)(4)
+      - TO vce( entitlement BelongsTo vce, MANY2ONE)(4)
+
+      -(4) IF this TO node is deleted, this ENTITLEMENT is DELETED also
+    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
+      - FROM esr-system-info( esr-system-info BelongsTo esr-ems, MANY2ONE)(1)
+
+      -(1) IF this ESR-EMS node is deleted, this FROM node is DELETED also
+    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:
+      esr-ems:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/esr-ems"
+  esr-system-info:
+    description: |
+      Persist common address information of external systems.
+      ###### Related Nodes
+      - TO esr-ems( esr-system-info BelongsTo esr-ems, MANY2ONE)(4)
+      - TO esr-vnfm( esr-system-info BelongsTo esr-vnfm, ONE2ONE)(4)
+      - TO esr-thirdparty-sdnc( esr-system-info BelongsTo esr-thirdparty-sdnc, ONE2ONE)(4)
+      - TO cloud-region( esr-system-info BelongsTo cloud-region, MANY2ONE)(4)
+
+      -(4) IF this TO node is deleted, this ESR-SYSTEM-INFO is DELETED also
+    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: "#/getDefinitions/relationship"
+  esr-system-info-list:
+    description: |
+      Collection of persistent block-level external system auth info.
+    properties:
+      esr-system-info:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/esr-system-info"
+  esr-thirdparty-sdnc:
+    description: |
+      Persist SDNC address information used by ONAP SDNC.
+      ###### Related Nodes
+      - TO pnf( esr-thirdparty-sdnc AppliesTo pnf, ONE2MANY)
+      - FROM esr-system-info( esr-system-info BelongsTo esr-thirdparty-sdnc, ONE2ONE)(1)
+
+      -(1) IF this ESR-THIRDPARTY-SDNC node is deleted, this FROM node is DELETED also
+    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: "#/getDefinitions/esr-system-info-list"
+      relationship-list:
+        type: object
+        $ref: "#/getDefinitions/relationship-list"
+  esr-thirdparty-sdnc-list:
+    properties:
+      esr-thirdparty-sdnc:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/esr-thirdparty-sdnc"
+  esr-vnfm:
+    description: |
+      Persist VNFM address information used by VF-C.
+      ###### Related Nodes
+      - FROM esr-system-info( esr-system-info BelongsTo esr-vnfm, ONE2ONE)(1)
+
+      -(1) IF this ESR-VNFM node is deleted, this FROM node is DELETED also
+    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: "#/getDefinitions/esr-system-info-list"
+      relationship-list:
+        type: object
+        $ref: "#/getDefinitions/relationship-list"
+  esr-vnfm-list:
+    properties:
+      esr-vnfm:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/esr-vnfm"
+  evc:
+    description: |
+      evc object is an optional child object of the Configuration object.
+      ###### Related Nodes
+      - TO configuration( evc BelongsTo configuration, ONE2ONE)(4)
+
+      -(4) IF this TO node is deleted, this EVC is DELETED also
+    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: "#/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: |
+      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 cloud-region( flavor BelongsTo cloud-region, MANY2ONE)
+      - FROM vserver( vserver Uses flavor, MANY2ONE)
+
+      -FLAVOR cannot be deleted if related 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: "#/getDefinitions/relationship"
+  flavors:
+    description: |
+      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 forwarding-path( forwarder BelongsTo forwarding-path, MANY2ONE)(4)
+      - TO l-interface( forwarder ForwardsTo l-interface, MANY2ONE)
+      - TO configuration( forwarder Uses configuration, ONE2ONE)(2)
+      - TO lag-interface( forwarder ForwardsTo lag-interface, MANY2ONE)
+      - TO p-interface( forwarder ForwardsTo p-interface, MANY2ONE)
+
+      -(2) IF this FORWARDER node is deleted, this TO node is DELETED also
+      -(4) IF this TO node is deleted, this FORWARDER is DELETED also
+    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: "#/getDefinitions/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 BelongsTo configuration, ONE2ONE)(4)
+
+      -(4) IF this TO node is deleted, this FORWARDER-EVC is DELETED also
+    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: "#/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: "#/getDefinitions/forwarder-evc"
+  forwarders:
+    properties:
+      forwarder:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/forwarder"
+  forwarding-path:
+    description: |
+      Entity that describes the sequenced forwarding path between interfaces of services or resources
+      ###### Related Nodes
+      - TO service-instance( forwarding-path AppliesTo service-instance, MANY2ONE)(4)
+      - TO configuration( forwarding-path Uses configuration, ONE2ONE)(2)
+      - FROM forwarder( forwarder BelongsTo forwarding-path, MANY2ONE)(1)
+
+      -(1) IF this FORWARDING-PATH node is deleted, this FROM node is DELETED also
+      -(2) IF this FORWARDING-PATH node is deleted, this TO node is DELETED also
+      -(4) IF this TO node is deleted, this FORWARDING-PATH is DELETED also
+    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: "#/getDefinitions/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: "#/getDefinitions/forwarder"
+  forwarding-paths:
+    properties:
+      forwarding-path:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/forwarding-path"
+  generic-vnf:
+    description: |
+      General purpose VNF
+      ###### Related Nodes
+      - TO availability-zone( generic-vnf Uses availability-zone, MANY2MANY)
+      - TO complex( generic-vnf LocatedIn complex, MANY2MANY)
+      - TO configuration( generic-vnf Uses configuration, ONE2MANY)(2)
+      - TO ctag-pool( generic-vnf Uses ctag-pool, MANY2MANY)
+      - TO instance-group( generic-vnf MemberOf instance-group, MANY2MANY)
+      - TO ipsec-configuration( generic-vnf Uses ipsec-configuration, MANY2ONE)
+      - TO l3-network( generic-vnf Uses l3-network, MANY2MANY)
+      - TO license-key-resource( generic-vnf Uses license-key-resource, MANY2MANY)
+      - TO pnf( generic-vnf HostedOn pnf, MANY2MANY)
+      - TO pserver( generic-vnf HostedOn pserver, MANY2MANY)
+      - TO vnf-image( generic-vnf Uses vnf-image, MANY2ONE)
+      - TO volume-group( generic-vnf DependsOn volume-group, ONE2MANY)
+      - TO vserver( generic-vnf HostedOn vserver, ONE2MANY)
+      - TO virtual-data-center( generic-vnf LocatedIn virtual-data-center, MANY2MANY)
+      - FROM allotted-resource( allotted-resource PartOf generic-vnf, MANY2MANY)
+      - FROM entitlement( entitlement BelongsTo generic-vnf, MANY2ONE)(1)
+      - FROM vnfc( vnfc BelongsTo generic-vnf, MANY2ONE)(1)
+      - FROM lag-interface( lag-interface BelongsTo generic-vnf, MANY2ONE)(1)
+      - FROM license( license BelongsTo generic-vnf, MANY2ONE)(1)
+      - FROM l-interface( l-interface BelongsTo generic-vnf, MANY2ONE)(1)
+      - FROM network-profile( network-profile AppliesTo generic-vnf, MANY2MANY)
+      - FROM service-instance( service-instance ComposedOf generic-vnf, ONE2MANY)
+      - FROM site-pair-set( site-pair-set AppliesTo generic-vnf, MANY2MANY)
+      - FROM vf-module( vf-module BelongsTo generic-vnf, MANY2ONE)(1)
+      - FROM line-of-business( line-of-business Uses generic-vnf, MANY2MANY)
+      - FROM logical-link( logical-link BridgedTo generic-vnf, MANY2MANY)
+      - FROM platform( platform Uses generic-vnf, MANY2MANY)
+
+      -(1) IF this GENERIC-VNF node is deleted, this FROM node is DELETED also
+      -(2) IF this GENERIC-VNF node is deleted, this TO node is DELETED also
+    required:
+    - vnf-id
+    - vnf-name
+    - vnf-type
+    - 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
+        description: used to indicate whether or not this object is in maintenance mode (maintenance mode = true). This field (in conjunction with prov-status) is used to suppress alarms and vSCL on VNFs/VMs.
+      is-closed-loop-disabled:
+        type: boolean
+        description: used to indicate whether closed loop function is enabled on this node
+      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: "#/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 VNFs
+    properties:
+      generic-vnf:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/generic-vnf"
+  group-assignment:
+    description: |
+      Openstack group-assignment used to store exclusivity groups (EG).
+      ###### Related Nodes
+      - TO cloud-region( group-assignment BelongsTo cloud-region, MANY2ONE)
+      - FROM pserver( pserver MemberOf group-assignment, MANY2ONE)
+      - FROM tenant( tenant 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: "#/getDefinitions/relationship"
+  group-assignments:
+    description: |
+      Collection of openstack group assignments
+    properties:
+      group-assignment:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/group-assignment"
+  host-route:
+    description: |
+      ###### Related Nodes
+      - TO subnet( host-route BelongsTo subnet, MANY2ONE)(4)
+
+      -(4) IF this TO node is deleted, this HOST-ROUTE is DELETED also
+    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: "#/getDefinitions/relationship"
+  host-routes:
+    properties:
+      host-route:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/host-route"
+  hpa-capabilities:
+    description: |
+      Collection of HPA Capabilities
+    properties:
+      hpa-capability:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/hpa-capability"
+  hpa-capability:
+    description: |
+      Represents a HPA capability
+      ###### Related Nodes
+      - TO flavor( hpa-capability BelongsTo flavor, MANY2ONE)
+      - TO cloud-region( hpa-capability BelongsTo cloud-region, MANY2ONE)
+      - FROM hpa-feature-attributes( hpa-feature-attributes BelongsTo hpa-capability, MANY2ONE)(1)
+
+      -(1) IF this HPA-CAPABILITY node is deleted, this FROM node is DELETED also
+    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
+      architecture:
+        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: "#/getDefinitions/relationship"
+      hpa-feature-attributes:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/hpa-feature-attributes"
+  hpa-feature-attributes:
+    description: |
+      HPA Capability Feature attributes
+      ###### Related Nodes
+      - TO hpa-capability( hpa-feature-attributes BelongsTo hpa-capability, MANY2ONE)(4)
+
+      -(4) IF this TO node is deleted, this HPA-FEATURE-ATTRIBUTES is DELETED also
+    required:
+    - hpa-attribute-key
+    properties:
+      hpa-attribute-key:
+        type: string
+        description: name of the specific HPA attribute
+      hpa-attribute-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: "#/getDefinitions/relationship"
+  image:
+    description: |
+      Openstack image.
+      ###### Related Nodes
+      - TO cloud-region( image BelongsTo cloud-region, MANY2ONE)
+      - FROM metadatum( metadatum BelongsTo image, MANY2ONE)(1)
+      - FROM vserver( vserver Uses image, MANY2ONE)
+
+      -(1) IF this IMAGE node is deleted, this FROM node is DELETED also
+      -IMAGE cannot be deleted if related to VSERVER
+
+    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: "#/getDefinitions/relationship"
+      metadata:
+        type: array
+        items:
+          $ref: "#/getDefinitions/metadatum"
+  images:
+    description: |
+      Collectio of Openstack images.
+    properties:
+      image:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/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: "#/getDefinitions/instance-filter"
+  instance-group:
+    description: |
+      General mechanism for grouping instances
+      ###### Related Nodes
+      - TO model( instance-group Targets model, MANY2MANY)
+      - FROM allotted-resource( allotted-resource MemberOf instance-group, MANY2MANY)
+      - FROM generic-vnf( generic-vnf MemberOf instance-group, MANY2MANY)
+      - FROM l3-interface-ipv4-address-list( l3-interface-ipv4-address-list MemberOf instance-group, MANY2MANY)
+      - FROM l3-interface-ipv6-address-list( l3-interface-ipv6-address-list MemberOf instance-group, MANY2MANY)
+      - FROM l3-network( l3-network MemberOf instance-group, MANY2MANY)
+      - FROM l-interface( l-interface MemberOf instance-group, MANY2MANY)
+      - FROM pnf( pnf MemberOf instance-group, MANY2MANY)
+      - FROM service-instance( service-instance MemberOf instance-group, MANY2MANY)
+      - FROM vip-ipv4-address-list( vip-ipv4-address-list MemberOf instance-group, MANY2MANY)
+      - FROM vip-ipv6-address-list( vip-ipv6-address-list MemberOf instance-group, MANY2MANY)
+      - FROM vnfc( vnfc MemberOf instance-group, MANY2MANY)
+
+    required:
+    - 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: "#/getDefinitions/relationship"
+  instance-groups:
+    description: |
+      Collection of openstack route table references
+    properties:
+      instance-group:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/instance-group"
+  inventory:
+    properties:
+      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"
+      nodes:
+        type: object
+        $ref: "#/getDefinitions/nodes"
+  inventory-item:
+    properties:
+      inventory-item-type:
+        type: string
+      inventory-item-link:
+        type: string
+      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
+      property-value:
+        type: string
+  inventory-response-item:
+    description: |
+      Inventory item for response list
+    properties:
+      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: "#/getDefinitions/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 Uses ipsec-configuration, MANY2ONE)
+      - FROM vig-server( vig-server BelongsTo ipsec-configuration, MANY2ONE)(1)
+
+      -(1) IF this IPSEC-CONFIGURATION node is deleted, this FROM node is DELETED also
+    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: "#/getDefinitions/relationship"
+      vig-servers:
+        type: array
+        items:
+          $ref: "#/getDefinitions/vig-server"
+  ipsec-configurations:
+    properties:
+      ipsec-configuration:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/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 BelongsTo generic-vnf, MANY2ONE)(4)
+      - TO lag-interface( l-interface BelongsTo lag-interface, MANY2ONE)(4)
+      - TO instance-group( l-interface MemberOf instance-group, MANY2MANY)
+      - TO l-interface( l-interface BelongsTo l-interface, MANY2ONE)(4)
+      - TO logical-link( l-interface LinksTo logical-link, MANY2MANY)(2)
+      - TO newvce( l-interface BelongsTo newvce, MANY2ONE)(4)
+      - TO p-interface( l-interface BindsTo p-interface, MANY2ONE)(4)
+      - TO vserver( l-interface BindsTo vserver, MANY2ONE)(4)
+      - FROM allotted-resource( allotted-resource Uses l-interface, ONE2MANY)
+      - FROM l3-interface-ipv4-address-list( l3-interface-ipv4-address-list BelongsTo l-interface, MANY2ONE)(1)
+      - FROM l3-interface-ipv6-address-list( l3-interface-ipv6-address-list BelongsTo l-interface, MANY2ONE)(1)
+      - FROM sriov-vf( sriov-vf BelongsTo l-interface, ONE2ONE)(1)
+      - FROM vlan( vlan LinksTo l-interface, MANY2ONE)(1)
+      - FROM l-interface( l-interface BelongsTo l-interface, MANY2ONE)(4)
+
+      -(1) IF this L-INTERFACE node is deleted, this FROM node is DELETED also
+      -(2) IF this L-INTERFACE node is deleted, this TO node is DELETED also
+      -(4) IF this TO node is deleted, this L-INTERFACE is DELETED also
+    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
+        description: boolean indicatating whether or not port is a mirrored.
+      resource-version:
+        type: string
+        description: Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
+      in-maint:
+        type: boolean
+        description: used to indicate whether or not this object is in maintenance mode (maintenance mode = true)
+      prov-status:
+        type: string
+        description: Prov Status of the logical interface. Valid values [PREPROV/NVTPROV/PROV].
+      is-ip-unnumbered:
+        type: boolean
+        description: Flag indicating the interface uses the IP Unnumbered configuration.
+      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: "#/getDefinitions/vlan"
+      sriov-vfs:
+        type: array
+        items:
+          $ref: "#/getDefinitions/sriov-vf"
+      l-interfaces:
+        type: array
+        items:
+          $ref: "#/getDefinitions/l-interface"
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/getDefinitions/relationship"
+      l3-interface-ipv4-address-list:
+        type: array
+        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:
+      l-interface:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/l-interface"
+  l3-interface-ipv4-address-list:
+    description: |
+      IPv4 Address Range
+      ###### Related Nodes
+      - TO instance-group( l3-interface-ipv4-address-list MemberOf instance-group, MANY2MANY)
+      - TO l3-network( l3-interface-ipv4-address-list MemberOf l3-network, MANY2MANY)
+      - TO subnet( l3-interface-ipv4-address-list MemberOf subnet, MANY2MANY)
+      - TO l-interface( l3-interface-ipv4-address-list BelongsTo l-interface, MANY2ONE)(4)
+      - TO vlan( l3-interface-ipv4-address-list BelongsTo vlan, MANY2ONE)(4)
+      - TO vnfc( l3-interface-ipv4-address-list BelongsTo vnfc, MANY2ONE)(4)
+
+      -(4) IF this TO node is deleted, this L3-INTERFACE-IPV4-ADDRESS-LIST is DELETED also
+    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: "#/getDefinitions/relationship"
+  l3-interface-ipv6-address-list:
+    description: |
+      IPv6 Address Range
+      ###### Related Nodes
+      - TO instance-group( l3-interface-ipv6-address-list MemberOf instance-group, MANY2MANY)
+      - TO l3-network( l3-interface-ipv6-address-list MemberOf l3-network, MANY2MANY)
+      - TO subnet( l3-interface-ipv6-address-list MemberOf subnet, MANY2MANY)
+      - TO l-interface( l3-interface-ipv6-address-list BelongsTo l-interface, MANY2ONE)(4)
+      - TO vlan( l3-interface-ipv6-address-list BelongsTo vlan, MANY2ONE)(4)
+      - TO vnfc( l3-interface-ipv6-address-list BelongsTo vnfc, MANY2ONE)(4)
+
+      -(4) IF this TO node is deleted, this L3-INTERFACE-IPV6-ADDRESS-LIST is DELETED also
+    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: "#/getDefinitions/relationship"
+  l3-network:
+    description: |
+      Generic network definition
+      ###### Related Nodes
+      - TO instance-group( l3-network MemberOf instance-group, MANY2MANY)
+      - TO network-policy( l3-network Uses network-policy, MANY2MANY)
+      - TO route-table-reference( l3-network Uses route-table-reference, MANY2MANY)
+      - TO vpn-binding( l3-network Uses vpn-binding, MANY2MANY)
+      - FROM allotted-resource( allotted-resource PartOf l3-network, MANY2MANY)
+      - FROM cloud-region( cloud-region Uses l3-network, MANY2MANY)
+      - FROM complex( complex Uses l3-network, MANY2MANY)
+      - FROM generic-vnf( generic-vnf Uses l3-network, MANY2MANY)
+      - FROM l3-interface-ipv4-address-list( l3-interface-ipv4-address-list MemberOf l3-network, MANY2MANY)
+      - FROM l3-interface-ipv6-address-list( l3-interface-ipv6-address-list MemberOf l3-network, MANY2MANY)
+      - FROM ctag-assignment( ctag-assignment BelongsTo l3-network, MANY2ONE)(1)
+      - FROM segmentation-assignment( segmentation-assignment BelongsTo l3-network, MANY2ONE)(1)
+      - FROM service-instance( service-instance ComposedOf l3-network, ONE2MANY)
+      - FROM subnet( subnet BelongsTo l3-network, MANY2ONE)(1)
+      - FROM tenant( tenant Uses l3-network, MANY2MANY)
+      - FROM vf-module( vf-module DependsOn l3-network, MANY2MANY)
+
+      -(1) IF this L3-NETWORK node is deleted, this FROM node is DELETED also
+    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
+        description: Set to true if bound to VPN
+      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
+        description: boolean indicatating whether or not network is a provider network.
+      is-shared-network:
+        type: boolean
+        description: boolean indicatating whether or not network is a shared network.
+      is-external-network:
+        type: boolean
+        description: boolean indicatating whether or not network is an external network.
+      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: "#/getDefinitions/subnet"
+      ctag-assignments:
+        type: array
+        items:
+          $ref: "#/getDefinitions/ctag-assignment"
+      segmentation-assignments:
+        type: array
+        items:
+          $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:
+      l3-network:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/l3-network"
+  lag-interface:
+    description: |
+      Link aggregate interface
+      ###### Related Nodes
+      - TO generic-vnf( lag-interface BelongsTo generic-vnf, MANY2ONE)(4)
+      - TO lag-link( lag-interface LinksTo lag-link, MANY2MANY)(2)
+      - TO logical-link( lag-interface Uses logical-link, MANY2MANY)(2)
+      - TO p-interface( lag-interface Uses p-interface, MANY2MANY)
+      - TO pnf( lag-interface BindsTo pnf, MANY2ONE)(4)
+      - TO pserver( lag-interface BindsTo pserver, MANY2ONE)(4)
+      - TO vpls-pe( lag-interface BindsTo vpls-pe, MANY2ONE)(4)
+      - FROM l-interface( l-interface BelongsTo lag-interface, MANY2ONE)(1)
+
+      -(1) IF this LAG-INTERFACE node is deleted, this FROM node is DELETED also
+      -(2) IF this LAG-INTERFACE node is deleted, this TO node is DELETED also
+      -(4) IF this TO node is deleted, this LAG-INTERFACE is DELETED also
+    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
+        description: used to indicate whether or not this object is in maintenance mode (maintenance mode = true)
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/getDefinitions/relationship"
+      l-interfaces:
+        type: array
+        items:
+          $ref: "#/getDefinitions/l-interface"
+  lag-interfaces:
+    description: |
+      Collection of link aggregate interfaces.
+    properties:
+      lag-interface:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/lag-interface"
+  lag-link:
+    description: |
+      LAG links can connect lag-interfaces
+      ###### Related Nodes
+      - FROM lag-interface( lag-interface LinksTo lag-link, MANY2MANY)(3)
+      - FROM logical-link( logical-link Uses lag-link, MANY2MANY)
+
+      -(3) IF this FROM node is deleted, this LAG-LINK is DELETED also
+    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: "#/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 BelongsTo generic-vnf, MANY2ONE)(4)
+      - TO vce( license BelongsTo vce, MANY2ONE)(4)
+
+      -(4) IF this TO node is deleted, this LICENSE is DELETED also
+    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 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 LocatedIn cloud-region, MANY2MANY)
+      - TO generic-vnf( logical-link BridgedTo generic-vnf, MANY2MANY)
+      - TO lag-link( logical-link Uses lag-link, MANY2MANY)
+      - TO logical-link( logical-link Uses logical-link, MANY2MANY)
+      - TO pnf( logical-link BridgedTo pnf, MANY2MANY)
+      - TO pserver( logical-link BridgedTo pserver, MANY2MANY)
+      - TO vpn-binding( logical-link Uses vpn-binding, MANY2MANY)
+      - TO virtual-data-center( logical-link LocatedIn virtual-data-center, MANY2MANY)
+      - FROM configuration( configuration Uses logical-link, ONE2MANY)(3)
+      - FROM lag-interface( lag-interface Uses logical-link, MANY2MANY)(3)
+      - FROM l-interface( l-interface LinksTo logical-link, MANY2MANY)(3)
+      - FROM p-interface( p-interface LinksTo logical-link, MANY2ONE)
+      - FROM service-instance( service-instance Uses logical-link, ONE2MANY)(3)
+      - FROM vlan( vlan Uses logical-link, MANY2MANY)(3)
+      - FROM logical-link( logical-link Uses logical-link, MANY2MANY)
+
+      -(3) IF this FROM node is deleted, this LOGICAL-LINK is DELETED also
+    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
+        description: used to indicate whether or not this object is in maintenance mode (maintenance mode = true). This field (in conjunction with prov-status) is used to suppress alarms and vSCL on VNFs/VMs.
+      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: "#/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 BelongsTo configuration, MANY2ONE)(4)
+      - TO connector( metadatum BelongsTo connector, MANY2ONE)(4)
+      - TO image( metadatum BelongsTo image, MANY2ONE)(4)
+      - TO service-instance( metadatum BelongsTo service-instance, MANY2ONE)(4)
+      - TO model-ver( metadatum BelongsTo model-ver, MANY2ONE)(4)
+
+      -(4) IF this TO node is deleted, this METADATUM is DELETED also
+    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 BelongsTo model, MANY2ONE)(1)
+      - FROM instance-group( instance-group Targets model, MANY2MANY)
+      - FROM model-ver( model-ver BelongsTo model, MANY2ONE)(1)
+      - FROM named-query( named-query AppliesTo model, ONE2MANY)
+      - FROM named-query-element( named-query-element IsA model, MANY2ONE)
+
+      -(1) IF this MODEL node is deleted, this FROM node is DELETED also
+      -MODEL cannot be deleted if related to INSTANCE-GROUP,NAMED-QUERY,NAMED-QUERY-ELEMENT
+
+    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: "#/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
+      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 BelongsTo model-element, MANY2ONE)(4)
+      - FROM constrained-element-set( constrained-element-set BelongsTo model-constraint, MANY2ONE)(1)
+
+      -(1) IF this MODEL-CONSTRAINT node is deleted, this FROM node is DELETED also
+      -(4) IF this TO node is deleted, this MODEL-CONSTRAINT is DELETED also
+    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: "#/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:
+      model-constraint:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/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 BelongsTo element-choice-set, MANY2ONE)(4)
+      - TO model-element( model-element BelongsTo model-element, MANY2ONE)(4)
+      - TO model-ver( model-element IsA model-ver, MANY2ONE)
+      - TO model-ver( model-element BelongsTo model-ver, MANY2ONE)(4)
+      - FROM constrained-element-set( constrained-element-set BelongsTo model-element, MANY2ONE)(1)
+      - FROM model-constraint( model-constraint BelongsTo model-element, MANY2ONE)(1)
+      - FROM model-element( model-element BelongsTo model-element, MANY2ONE)(4)
+
+      -(1) IF this MODEL-ELEMENT node is deleted, this FROM node is DELETED also
+      -(4) IF this TO node is deleted, this MODEL-ELEMENT is DELETED also
+    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: "#/getDefinitions/model-element"
+        description: Defines how other models combine to make up a higher-level model
+      model-constraints:
+        type: array
+        items:
+          $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: "#/getDefinitions/relationship"
+  model-elements:
+    properties:
+      model-element:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/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 BelongsTo model, MANY2ONE)(4)
+      - FROM model-element( model-element IsA model-ver, MANY2ONE)
+      - FROM model-element( model-element BelongsTo model-ver, MANY2ONE)(1)
+      - FROM metadatum( metadatum BelongsTo model-ver, MANY2ONE)(1)
+
+      -(1) IF this MODEL-VER node is deleted, this FROM node is DELETED also
+      -(4) IF this TO node is deleted, this MODEL-VER is DELETED also
+      -MODEL-VER cannot be deleted if related to MODEL-ELEMENT
+
+    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: "#/getDefinitions/model-element"
+      metadata:
+        type: array
+        items:
+          $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 subgraph definitions provided by ASDC to describe the inventory assets and their connections related to ASDC models
+    properties:
+      model:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/model"
+  multicast-configuration:
+    description: |
+      ###### Related Nodes
+      - FROM vlan( vlan 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: "#/getDefinitions/relationship"
+  multicast-configurations:
+    description: |
+      multicast configuration of generic-vnf ip-address
+    properties:
+      multicast-configuration:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/multicast-configuration"
+  named-queries:
+    properties:
+      named-query:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/named-query"
+  named-query:
+    description: |
+      TBD
+      ###### Related Nodes
+      - TO named-query( named-query-element BelongsTo named-query, ONE2ONE)(1)
+      - TO model( named-query AppliesTo model, ONE2MANY)
+      - FROM named-query-element( named-query-element BelongsTo named-query, ONE2ONE)(1)
+
+      -(1) IF this NAMED-QUERY node is deleted, this FROM node is DELETED also
+    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: "#/getDefinitions/named-query-element"
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/getDefinitions/relationship"
+  named-query-element:
+    description: |
+      TBD
+      ###### Related Nodes
+      - TO named-query( named-query-element BelongsTo named-query, ONE2ONE)(4)
+      - TO model( named-query-element IsA model, MANY2ONE)
+      - TO named-query-element( named-query-element BelongsTo named-query-element, MANY2ONE)(4)
+      - FROM property-constraint( property-constraint BelongsTo named-query-element, MANY2ONE)(1)
+      - FROM related-lookup( related-lookup BelongsTo named-query-element, MANY2ONE)(1)
+      - FROM named-query-element( named-query-element BelongsTo named-query-element, MANY2ONE)(4)
+
+      -(1) IF this NAMED-QUERY-ELEMENT node is deleted, this FROM node is DELETED also
+      -(4) IF this TO node is deleted, this NAMED-QUERY-ELEMENT is DELETED also
+    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: "#/getDefinitions/named-query-element"
+      related-lookups:
+        type: array
+        items:
+          $ref: "#/getDefinitions/related-lookup"
+      property-constraints:
+        type: array
+        items:
+          $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: |
+      Namespace for network inventory resources.
+    properties:
+      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: "#/getDefinitions/network-policy"
+  network-policy:
+    description: |
+      ###### Related Nodes
+      - FROM allotted-resource( allotted-resource Uses network-policy, ONE2ONE)
+      - FROM l3-network( l3-network 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: "#/getDefinitions/relationship"
+  network-profile:
+    description: |
+      Network profile populated by SDN-GP for SNMP
+      ###### Related Nodes
+      - TO generic-vnf( network-profile 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: "#/getDefinitions/relationship"
+  network-profiles:
+    description: |
+      Collection of network profiles
+    properties:
+      network-profile:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/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 BelongsTo newvce, MANY2ONE)(1)
+
+      -(1) IF this NEWVCE node is deleted, this FROM node is DELETED also
+    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: "#/getDefinitions/relationship"
+      l-interfaces:
+        type: array
+        items:
+          $ref: "#/getDefinitions/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: "#/getDefinitions/newvce"
+  nodes:
+    properties:
+      inventory-item-data:
+        type: array
+        items:
+          $ref: "#/getDefinitions/inventory-item-data"
+  notification-event:
+    properties:
+      cambria.partition:
+        type: string
+      notification-event-header:
+        type: object
+        $ref: "#/getDefinitions/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: "#/getDefinitions/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 BelongsTo cloud-region, MANY2ONE)
+      - TO complex( oam-network AppliesTo complex, MANY2MANY)
+      - TO service-capability( oam-network 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: "#/getDefinitions/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: "#/getDefinitions/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 Uses operational-environment, ONE2ONE)
+      - FROM operational-environment( operational-environment 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: "#/getDefinitions/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: "#/getDefinitions/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: "#/getDefinitions/model-vers"
+      relationship-list:
+        type: object
+        $ref: "#/getDefinitions/relationship-list"
+  owning-entities:
+    description: |
+      Collection of owning-entities
+    properties:
+      owning-entity:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/owning-entity"
+  owning-entity:
+    description: |
+      describes an owning-entity
+      ###### Related Nodes
+      - FROM service-instance( service-instance 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: "#/getDefinitions/relationship"
+  p-interface:
+    description: |
+      Physical interface (e.g., nic)
+      ###### Related Nodes
+      - TO logical-link( p-interface LinksTo logical-link, MANY2ONE)
+      - TO physical-link( p-interface LinksTo physical-link, MANY2ONE)(2)
+      - TO pnf( p-interface BindsTo pnf, MANY2ONE)(4)
+      - TO pserver( p-interface BindsTo pserver, MANY2ONE)(4)
+      - TO vpls-pe( p-interface BindsTo vpls-pe, MANY2ONE)(4)
+      - FROM lag-interface( lag-interface Uses p-interface, MANY2MANY)
+      - FROM l-interface( l-interface BindsTo p-interface, MANY2ONE)(1)
+      - FROM sriov-pf( sriov-pf BelongsTo p-interface, ONE2ONE)(1)
+
+      -(1) IF this P-INTERFACE node is deleted, this FROM node is DELETED also
+      -(2) IF this P-INTERFACE node is deleted, this TO node is DELETED also
+      -(4) IF this TO node is deleted, this P-INTERFACE is DELETED also
+    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
+        description: used to indicate whether or not this object is in maintenance mode (maintenance mode = true)
+      inv-status:
+        type: string
+        description: inventory status
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/getDefinitions/relationship"
+      sriov-pfs:
+        type: array
+        items:
+          $ref: "#/getDefinitions/sriov-pf"
+      l-interfaces:
+        type: array
+        items:
+          $ref: "#/getDefinitions/l-interface"
+  p-interfaces:
+    description: |
+      Collection of physical interfaces.
+    properties:
+      p-interface:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/p-interface"
+  physical-link:
+    description: |
+      Collection of physical connections, typically between p-interfaces
+      ###### Related Nodes
+      - FROM p-interface( p-interface LinksTo physical-link, MANY2ONE)(3)
+
+      -(3) IF this FROM node is deleted, this PHYSICAL-LINK is DELETED also
+    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: "#/getDefinitions/relationship"
+  physical-links:
+    description: |
+      Collection of physical connections, typically between p-interfaces
+    properties:
+      physical-link:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/physical-link"
+  platform:
+    description: |
+      describes a platform
+      ###### Related Nodes
+      - TO generic-vnf( platform 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: "#/getDefinitions/relationship"
+  platforms:
+    description: |
+      Collection of platforms
+    properties:
+      platform:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/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 LocatedIn complex, MANY2ONE)
+      - TO instance-group( pnf MemberOf instance-group, MANY2MANY)
+      - TO zone( pnf LocatedIn zone, MANY2ONE)
+      - FROM esr-thirdparty-sdnc( esr-thirdparty-sdnc AppliesTo pnf, ONE2MANY)
+      - FROM generic-vnf( generic-vnf HostedOn pnf, MANY2MANY)
+      - FROM logical-link( logical-link BridgedTo pnf, MANY2MANY)
+      - FROM lag-interface( lag-interface BindsTo pnf, MANY2ONE)(1)
+      - FROM p-interface( p-interface BindsTo pnf, MANY2ONE)(1)
+      - FROM service-instance( service-instance ComposedOf pnf, ONE2MANY)
+
+      -(1) IF this PNF node is deleted, this FROM node is DELETED also
+    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
+        description: Used to indicate whether or not this object is in maintenance mode (maintenance mode = true). This field (in conjunction with prov-status) is used to suppress alarms and vSCL on VNFs/VMs.
+      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: "#/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:
+      pnf:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/pnf"
+  port-group:
+    description: |
+      Used to capture the network interfaces of this VCE
+      ###### Related Nodes
+      - TO vce( port-group BelongsTo vce, MANY2ONE)(4)
+      - FROM cvlan-tag( cvlan-tag BelongsTo port-group, MANY2ONE)(1)
+
+      -(1) IF this PORT-GROUP node is deleted, this FROM node is DELETED also
+      -(4) IF this TO node is deleted, this PORT-GROUP is DELETED also
+    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: "#/getDefinitions/cvlan-tag-entry"
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/getDefinitions/relationship"
+  port-groups:
+    properties:
+      port-group:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/port-group"
+  project:
+    description: |
+      describes the project
+      ###### Related Nodes
+      - TO service-instance( project 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: "#/getDefinitions/relationship"
+  projects:
+    description: |
+      Collection of projects
+    properties:
+      project:
+        type: array
+        items:          
+          $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
+      ###### Related Nodes
+      - TO named-query-element( property-constraint BelongsTo named-query-element, MANY2ONE)(4)
+
+      -(4) IF this TO node is deleted, this PROPERTY-CONSTRAINT is DELETED also
+    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: "#/getDefinitions/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 MemberOf group-assignment, MANY2ONE)
+      - TO availability-zone( pserver MemberOf availability-zone, MANY2ONE)
+      - TO cloud-region( pserver LocatedIn cloud-region, MANY2ONE)
+      - TO complex( pserver LocatedIn complex, MANY2ONE)
+      - TO zone( pserver LocatedIn zone, MANY2ONE)
+      - FROM generic-vnf( generic-vnf HostedOn pserver, MANY2MANY)
+      - FROM logical-link( logical-link BridgedTo pserver, MANY2MANY)
+      - FROM lag-interface( lag-interface BindsTo pserver, MANY2ONE)(1)
+      - FROM p-interface( p-interface BindsTo pserver, MANY2ONE)(1)
+      - FROM vserver( vserver HostedOn pserver, MANY2ONE)
+
+      -(1) IF this PSERVER node is deleted, this FROM node is DELETED also
+      -PSERVER cannot be deleted if related to GENERIC-VNF,LOGICAL-LINK,VSERVER,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
+        description: used to indicate whether or not this object is in maintenance mode (maintenance mode = true). This field (in conjunction with prov-status) is used to suppress alarms and vSCL on VNFs/VMs.
+      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: "#/getDefinitions/relationship"
+      p-interfaces:
+        type: array
+        items:
+          $ref: "#/getDefinitions/p-interface"
+      lag-interfaces:
+        type: array
+        items:
+          $ref: "#/getDefinitions/lag-interface"
+  pservers:
+    description: |
+      Collection of compute hosts.
+    properties:
+      pserver:
+        type: array
+        items:          
+          $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: |
+      TBD
+      ###### Related Nodes
+      - TO named-query-element( related-lookup BelongsTo named-query-element, MANY2ONE)(4)
+
+      -(4) IF this TO node is deleted, this RELATED-LOOKUP is DELETED also
+    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: "#/getDefinitions/relationship"
+  related-lookups:
+    properties:
+      related-lookup:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/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: "#/getDefinitions/relationship-data"
+      related-to-property:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/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.
+  relationship-list:
+    properties:
+      relationship:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/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: "#/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: |
+      Openstack route table reference.
+      ###### Related Nodes
+      - FROM l3-network( l3-network 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: "#/getDefinitions/relationship"
+  route-table-references:
+    description: |
+      Collection of openstack route table references
+    properties:
+      route-table-reference:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/route-table-reference"
+  route-target:
+    description: |
+      Route target information
+      ###### Related Nodes
+      - TO vpn-binding( route-target BelongsTo vpn-binding, MANY2ONE)(4)
+
+      -(4) IF this TO node is deleted, this ROUTE-TARGET is DELETED also
+    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: "#/getDefinitions/relationship"
+  route-targets:
+    description: |
+      Collection of route target information
+    properties:
+      route-target:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/route-target"
+  routing-instance:
+    description: |
+      ###### Related Nodes
+      - TO site-pair-set( routing-instance BelongsTo site-pair-set, MANY2ONE)(4)
+      - FROM site-pair( site-pair BelongsTo routing-instance, MANY2ONE)(1)
+
+      -(1) IF this ROUTING-INSTANCE node is deleted, this FROM node is DELETED also
+      -(4) IF this TO node is deleted, this ROUTING-INSTANCE is DELETED also
+    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: "#/getDefinitions/site-pair"
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/getDefinitions/relationship"
+  routing-instances:
+    description: |
+      set of probes related to generic-vnf routing instance
+    properties:
+      routing-instance:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/routing-instance"
+  sdn-zone-response:
+    properties:
+      oam-networks:
+        type: object
+        $ref: "#/getDefinitions/oam-networks"
+      az-and-dvs-switches:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/az-and-dvs-switches"
+  search:
+    properties:
+      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: "#/getDefinitions/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: "#/getDefinitions/secondary-filt"
+  segmentation-assignment:
+    description: |
+      Openstack segmentation assignment.
+      ###### Related Nodes
+      - TO l3-network( segmentation-assignment BelongsTo l3-network, MANY2ONE)(4)
+
+      -(4) IF this TO node is deleted, this SEGMENTATION-ASSIGNMENT is DELETED also
+    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: "#/getDefinitions/relationship"
+  segmentation-assignments:
+    description: |
+      Collection of openstack segmentation assignments
+    properties:
+      segmentation-assignment:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/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: "#/getDefinitions/relationship"
+  service-capabilities:
+    description: |
+      Collection of service capabilities.
+    properties:
+      service-capability:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/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 AppliesTo service-capability, MANY2MANY)
+      - FROM oam-network( oam-network AppliesTo service-capability, MANY2MANY)
+
+      -SERVICE-CAPABILITY cannot be deleted if related 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: "#/getDefinitions/relationship"
+  service-design-and-creation:
+    description: |
+      Namespace for objects managed by ASDC
+    properties:
+      vnf-images:
+        type: array
+        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: |
+      Instance of a service
+      ###### Related Nodes
+      - TO generic-vnf( service-instance ComposedOf generic-vnf, ONE2MANY)
+      - TO l3-network( service-instance ComposedOf l3-network, ONE2MANY)
+      - TO owning-entity( service-instance BelongsTo owning-entity, MANY2ONE)
+      - TO allotted-resource( service-instance Uses allotted-resource, MANY2MANY)
+      - TO configuration( service-instance Uses configuration, ONE2MANY)
+      - TO connector( service-instance Uses connector, MANY2MANY)
+      - TO ctag-assignment( service-instance Uses ctag-assignment, ONE2MANY)
+      - TO cvlan-tag( service-instance ComposedOf cvlan-tag, MANY2MANY)
+      - TO instance-group( service-instance MemberOf instance-group, MANY2MANY)
+      - TO logical-link( service-instance Uses logical-link, ONE2MANY)(2)
+      - TO pnf( service-instance ComposedOf pnf, ONE2MANY)
+      - TO service-instance( service-instance ComposedOf service-instance, ONE2MANY)
+      - TO vlan( service-instance ComposedOf vlan, ONE2MANY)
+      - TO zone( service-instance LocatedIn zone, MANY2ONE)
+      - TO service-subscription( service-instance BelongsTo service-subscription, MANY2ONE)(4)
+      - TO vce( service-instance ComposedOf vce, ONE2MANY)
+      - FROM project( project Uses service-instance, ONE2MANY)
+      - FROM allotted-resource( allotted-resource BelongsTo service-instance, MANY2ONE)(1)
+      - FROM metadatum( metadatum BelongsTo service-instance, MANY2ONE)(1)
+      - FROM service-instance( service-instance ComposedOf service-instance, ONE2MANY)
+
+      -(1) IF this SERVICE-INSTANCE node is deleted, this FROM node is DELETED also
+      -(2) IF this SERVICE-INSTANCE node is deleted, this TO node is DELETED also
+      -(4) IF this TO node is deleted, this SERVICE-INSTANCE is DELETED also
+    required:
+    - service-instance-id
+    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: "#/getDefinitions/relationship"
+      metadata:
+        type: array
+        items:
+          $ref: "#/getDefinitions/metadatum"
+      allotted-resources:
+        type: array
+        items:
+          $ref: "#/getDefinitions/allotted-resource"
+  service-instances:
+    description: |
+      Collection of service instances
+    properties:
+      service-instance:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/service-instance"
+  service-subscription:
+    description: |
+      Object that group service instances.
+      ###### Related Nodes
+      - TO customer( service-subscription BelongsTo customer, MANY2ONE)(4)
+      - TO tenant( service-subscription Uses tenant, MANY2MANY)
+      - FROM service-instance( service-instance BelongsTo service-subscription, MANY2ONE)(1)
+
+      -(1) IF this SERVICE-SUBSCRIPTION node is deleted, this FROM node is DELETED also
+      -(4) IF this TO node is deleted, this SERVICE-SUBSCRIPTION is DELETED also
+    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: "#/getDefinitions/service-instance"
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/getDefinitions/relationship"
+  service-subscriptions:
+    description: |
+      Collection of objects that group service instances.
+    properties:
+      service-subscription:
+        type: array
+        items:          
+          $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: |
+      ###### Related Nodes
+      - TO routing-instance( site-pair BelongsTo routing-instance, MANY2ONE)(4)
+      - FROM class-of-service( class-of-service BelongsTo site-pair, MANY2ONE)(1)
+
+      -(1) IF this SITE-PAIR node is deleted, this FROM node is DELETED also
+      -(4) IF this TO node is deleted, this SITE-PAIR is DELETED also
+    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: "#/getDefinitions/class-of-service"
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/getDefinitions/relationship"
+  site-pair-set:
+    description: |
+      Set of instances for probes used to measure service level agreements
+      ###### Related Nodes
+      - TO generic-vnf( site-pair-set AppliesTo generic-vnf, MANY2MANY)
+      - FROM routing-instance( routing-instance BelongsTo site-pair-set, MANY2ONE)(1)
+
+      -(1) IF this SITE-PAIR-SET node is deleted, this FROM node is DELETED also
+    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: "#/getDefinitions/routing-instance"
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/getDefinitions/relationship"
+  site-pair-sets:
+    description: |
+      Collection of sets of instances for probes related to generic-vnf
+    properties:
+      site-pair-set:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/site-pair-set"
+  site-pairs:
+    description: |
+      probe within a set
+    properties:
+      site-pair:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/site-pair"
+  snapshot:
+    description: |
+      Openstack snapshot
+      ###### Related Nodes
+      - TO cloud-region( snapshot BelongsTo cloud-region, MANY2ONE)
+      - FROM vserver( vserver 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: "#/getDefinitions/relationship"
+  snapshots:
+    description: |
+      Collection of openstack snapshots
+    properties:
+      snapshot:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/snapshot"
+  sriov-pf:
+    description: |
+      SR-IOV Physical Function
+      ###### Related Nodes
+      - TO p-interface( sriov-pf BelongsTo p-interface, ONE2ONE)(4)
+      - FROM sriov-vf( sriov-vf Uses sriov-pf, MANY2ONE)
+
+      -(4) IF this TO node is deleted, this SRIOV-PF is DELETED also
+    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: "#/getDefinitions/relationship"
+  sriov-pfs:
+    description: |
+      Collection of SR-IOV Physical Functions.
+    properties:
+      sriov-pf:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/sriov-pf"
+  sriov-vf:
+    description: |
+      SR-IOV Virtual Function (not to be confused with virtual network function)
+      ###### Related Nodes
+      - TO l-interface( sriov-vf BelongsTo l-interface, ONE2ONE)(4)
+      - TO sriov-pf( sriov-vf Uses sriov-pf, MANY2ONE)
+
+      -(4) IF this TO node is deleted, this SRIOV-VF is DELETED also
+    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: "#/getDefinitions/relationship"
+  sriov-vfs:
+    description: |
+      Collection of SR-IOV Virtual Functions.
+    properties:
+      sriov-vf:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/sriov-vf"
+  start-node-filter:
+    properties:
+      property-name:
+        type: string
+      property-value:
+        type: string
+  subnet:
+    description: |
+      ###### Related Nodes
+      - TO l3-network( subnet BelongsTo l3-network, MANY2ONE)(4)
+      - FROM l3-interface-ipv4-address-list( l3-interface-ipv4-address-list MemberOf subnet, MANY2MANY)
+      - FROM l3-interface-ipv6-address-list( l3-interface-ipv6-address-list MemberOf subnet, MANY2MANY)
+      - FROM host-route( host-route BelongsTo subnet, MANY2ONE)(1)
+      - FROM vip-ipv4-address-list( vip-ipv4-address-list MemberOf subnet, MANY2MANY)
+      - FROM vip-ipv6-address-list( vip-ipv6-address-list MemberOf subnet, MANY2MANY)
+
+      -(1) IF this SUBNET node is deleted, this FROM node is DELETED also
+      -(4) IF this TO node is deleted, this SUBNET is DELETED also
+      -SUBNET cannot be deleted if related to L3-INTERFACE-IPV4-ADDRESS-LIST,L3-INTERFACE-IPV6-ADDRESS-LIST,VIP-IPV4-ADDRESS-LIST,VIP-IPV6-ADDRESS-LIST
+
+    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
+        description: dhcp enabled
+      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: "#/getDefinitions/host-route"
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/getDefinitions/relationship"
+  subnets:
+    properties:
+      subnet:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/subnet"
+  tagged-inventory-item-list:
+    properties:
+      inventory-item:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/inventory-item"
+  tenant:
+    description: |
+      Openstack tenant
+      ###### Related Nodes
+      - TO cloud-region( tenant BelongsTo cloud-region, MANY2ONE)
+      - TO group-assignment( tenant MemberOf group-assignment, MANY2MANY)
+      - TO l3-network( tenant Uses l3-network, MANY2MANY)
+      - TO volume-group( tenant DependsOn volume-group, ONE2MANY)
+      - FROM service-subscription( service-subscription Uses tenant, MANY2MANY)
+      - FROM vserver( vserver BelongsTo tenant, MANY2ONE)
+
+      -TENANT cannot be deleted if related 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: "#/getDefinitions/vserver"
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/getDefinitions/relationship"
+  tenants:
+    description: |
+      Collection of openstack tenants.
+    properties:
+      tenant:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/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 BelongsTo allotted-resource, ONE2ONE)(4)
+
+      -(4) IF this TO node is deleted, this TUNNEL-XCONNECT is DELETED also
+    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: "#/getDefinitions/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: "#/getDefinitions/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: "#/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 availability-zone( vce Uses availability-zone, MANY2MANY)
+      - TO complex( vce LocatedIn complex, MANY2MANY)
+      - TO vserver( vce HostedOn vserver, ONE2MANY)
+      - FROM entitlement( entitlement BelongsTo vce, MANY2ONE)(1)
+      - FROM license( license BelongsTo vce, MANY2ONE)(1)
+      - FROM port-group( port-group BelongsTo vce, MANY2ONE)(1)
+      - FROM service-instance( service-instance ComposedOf vce, ONE2MANY)
+
+      -(1) IF this VCE node is deleted, this FROM node is DELETED also
+    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: "#/getDefinitions/port-group"
+      licenses:
+        type: array
+        items:
+          $ref: "#/getDefinitions/license"
+      entitlements:
+        type: array
+        items:
+          $ref: "#/getDefinitions/entitlement"
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/getDefinitions/relationship"
+  vces:
+    description: |
+      Collection of Virtual Customer Edge Routers, used specifically for Gamma.  This object is deprecated.
+    properties:
+      vce:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/vce"
+  vf-module:
+    description: |
+      a deployment unit of VNFCs
+      ###### Related Nodes
+      - TO generic-vnf( vf-module BelongsTo generic-vnf, MANY2ONE)(4)
+      - TO l3-network( vf-module DependsOn l3-network, MANY2MANY)
+      - TO vnfc( vf-module Uses vnfc, ONE2MANY)
+      - TO volume-group( vf-module Uses volume-group, ONE2ONE)
+      - TO vserver( vf-module Uses vserver, ONE2MANY)
+
+      -(4) IF this TO node is deleted, this VF-MODULE is DELETED also
+      -VF-MODULE cannot be deleted if related 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
+        description: used to indicate whether or not this object is base vf module
+      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: "#/getDefinitions/relationship"
+  vf-modules:
+    description: |
+      Collection of vf-modules, a deployment unit of VNFCs
+    properties:
+      vf-module:
+        type: array
+        items:          
+          $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
+      ###### Related Nodes
+      - TO ipsec-configuration( vig-server BelongsTo ipsec-configuration, MANY2ONE)(4)
+
+      -(4) IF this TO node is deleted, this VIG-SERVER is DELETED also
+    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: "#/getDefinitions/relationship"
+  vig-servers:
+    properties:
+      vig-server:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/vig-server"
+  vip-ipv4-address-list:
+    description: |
+      IPv4 Address Range
+      ###### Related Nodes
+      - TO cloud-region( vip-ipv4-address-list BelongsTo cloud-region, MANY2ONE)
+      - TO instance-group( vip-ipv4-address-list MemberOf instance-group, MANY2MANY)
+      - TO subnet( vip-ipv4-address-list MemberOf subnet, MANY2MANY)
+      - FROM vnfc( vnfc 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: "#/getDefinitions/relationship"
+  vip-ipv6-address-list:
+    description: |
+      IPv6 Address Range
+      ###### Related Nodes
+      - TO cloud-region( vip-ipv6-address-list BelongsTo cloud-region, MANY2ONE)
+      - TO instance-group( vip-ipv6-address-list MemberOf instance-group, MANY2MANY)
+      - TO subnet( vip-ipv6-address-list MemberOf subnet, MANY2MANY)
+      - FROM vnfc( vnfc 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: "#/getDefinitions/relationship"
+  virtual-data-center:
+    description: |
+      Virtual organization of cloud infrastructure elements in a data center context
+      ###### Related Nodes
+      - FROM connector( connector LocatedIn virtual-data-center, MANY2MANY)
+      - FROM generic-vnf( generic-vnf LocatedIn virtual-data-center, MANY2MANY)
+      - FROM logical-link( logical-link 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: "#/getDefinitions/relationship"
+  virtual-data-centers:
+    description: |
+      Virtual organization of cloud infrastructure elements in a data center context
+    properties:
+      virtual-data-center:
+        type: array
+        items:          
+          $ref: "#/getDefinitions/virtual-data-center"
+  vlan:
+    description: |
+      Definition of vlan
+      ###### Related Nodes
+      - TO l-interface( vlan LinksTo l-interface, MANY2ONE)(4)
+      - TO logical-link( vlan Uses logical-link, MANY2MANY)(2)
+      - TO multicast-configuration( vlan Uses multicast-configuration, MANY2MANY)
+      - FROM allotted-resource( allotted-resource PartOf vlan, MANY2MANY)
+      - FROM service-instance( service-instance ComposedOf vlan, ONE2MANY)
+      - FROM l3-interface-ipv4-address-list( l3-interface-ipv4-address-list BelongsTo vlan, MANY2ONE)(1)
+      - FROM l3-interface-ipv6-address-list( l3-interface-ipv6-address-list BelongsTo vlan, MANY2ONE)(1)
+
+      -(1) IF this VLAN node is deleted, this FROM node is DELETED also
+      -(2) IF this VLAN node is deleted, this TO node is DELETED also
+      -(4) IF this TO node is deleted, this VLAN is DELETED also
+    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
+        description: used to indicate whether or not this object is in maintenance mode (maintenance mode = true)
+      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
+        description: Flag indicating the interface uses the IP Unnumbered configuration.
+      relationship-list:
+        type: array
+        items:
+          $ref: "#/getDefinitions/relationship"
+      l3-interface-ipv4-address-list:
         type: array
         items:          
-          $ref: "#/definitions/update-node-key"
-      update-node-uri:
-        type: string
-      action:
+          $ref: "#/getDefinitions/l3-interface-ipv4-address-list"
+      l3-interface-ipv6-address-list:
         type: array
         items:          
-          $ref: "#/definitions/action"
-  action:
+          $ref: "#/getDefinitions/l3-interface-ipv6-address-list"
+  vlans:
     properties:
-      action-type:
-        type: string
-      action-data:
+      vlan:
         type: array
         items:          
-          $ref: "#/definitions/action-data"
-  action-data:
-    properties:
-      property-name:
-        type: string
-      property-value:
-        type: string
-  update-node-key:
+          $ref: "#/getDefinitions/vlan"
+  vnf:
+    description: |
+      Abstract vnf class
+    required:
+    - vnf-id
     properties:
-      key-name:
-        type: string
-      key-value:
+      vnf-id:
         type: string
-  notify:
+        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 Uses vnf-image, MANY2ONE)
+
+      -VNF-IMAGE cannot be deleted if related to GENERIC-VNF
+
     required:
-    - event-id
+    - vnf-image-uuid
+    - application
+    - application-vendor
     properties:
-      event-id:
+      vnf-image-uuid:
         type: string
-      node-type:
+        description: Unique ID of this asset
+      application:
         type: string
-      event-trigger:
+        description: The application that the image instantiates.
+      application-vendor:
         type: string
-      key-data:
-        type: array
-        items:          
-          $ref: "#/definitions/key-data"
-      selflink:
+        description: The vendor of the application.
+      application-version:
         type: string
-  key-data:
-    properties:
-      key-name:
+        description: The version of the application.
+      selflink:
         type: string
-      key-value:
+        description: URL to endpoint where AAI can get more details
+      resource-version:
         type: string
-  configurations:
+        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 configurations
+      Collection of image objects that pertain to a VNF that doesn't have associated vservers.  This is a kludge.
     properties:
-      configuration:
+      vnf-image:
         type: array
         items:          
-          $ref: "#/definitions/configuration"
-  configuration:
+          $ref: "#/getDefinitions/vnf-image"
+  vnfc:
     description: |
-      Port Mirror Configuration.
       ###### Related Nodes
-      - TO logical-link (One2Many)
-      - TO metadatum (comprises configuration, One2Many)
-      - TO allotted-resource (One2One)
-      - FROM service-instance
-      - FROM generic-vnf
+      - TO generic-vnf( vnfc BelongsTo generic-vnf, MANY2ONE)(4)
+      - TO instance-group( vnfc MemberOf instance-group, MANY2MANY)
+      - TO vip-ipv4-address-list( vnfc Uses vip-ipv4-address-list, MANY2MANY)
+      - TO vip-ipv6-address-list( vnfc Uses vip-ipv6-address-list, MANY2MANY)
+      - TO vserver( vnfc HostedOn vserver, ONE2MANY)
+      - FROM vf-module( vf-module Uses vnfc, ONE2MANY)
+      - FROM l3-interface-ipv4-address-list( l3-interface-ipv4-address-list BelongsTo vnfc, MANY2ONE)(1)
+      - FROM l3-interface-ipv6-address-list( l3-interface-ipv6-address-list BelongsTo vnfc, MANY2ONE)(1)
+
+      -(1) IF this VNFC node is deleted, this FROM node is DELETED also
+      -(4) IF this TO node is deleted, this VNFC is DELETED also
     required:
-    - configuration-id
-    - configuration-type
-    - configuration-sub-type
-    - orchestration-status
-    - operational-status
-    - configuration-selflink
-    - model-customization-id
+    - vnfc-name
+    - nfc-naming-code
+    - nfc-function
+    - in-maint
+    - is-closed-loop-disabled
     properties:
-      management-option:
+      vnfc-name:
         type: string
-        description: Indicates the entity that will manage this feature. Could be an organization or the name of the application as well.
-      configuration-id:
+        description: Unique ID of vnfc.
+      nfc-naming-code:
         type: string
-        description: UUID assigned to configuration.
-      configuration-name:
+        description: Short code that is used in naming instances of the item being modeled
+      nfc-function:
         type: string
-        description: Name of the configuration.
-      configuration-type:
+        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: port-mirroring-configuration.
-      configuration-sub-type:
+        description: prov status of this vnfc
+      orchestration-status:
         type: string
-        description: vprobe, pprobe.
+        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
+        description: used to indicate whether or not this object is in maintenance mode (maintenance mode = true)
+      is-closed-loop-disabled:
+        type: boolean
+        description: used to indicate whether closed loop function is enabled on this node
+      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.
-      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: object
-        $ref: "#/definitions/relationship-list"
-      metadata:
-        type: object
-        $ref: "#/definitions/metadata"
-  notification-event:
+        type: array
+        items:
+          $ref: "#/getDefinitions/relationship"
+      l3-interface-ipv4-address-list:
+        type: array
+        items:          
+          $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 AttachesTo volume)(3)
+
+      -(3) IF this FROM node is deleted, this VOLUME is DELETED also
+    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 BelongsTo cloud-region, MANY2ONE)
+      - TO complex( volume-group LocatedIn complex, MANY2ONE)
+      - FROM generic-vnf( generic-vnf DependsOn volume-group, ONE2MANY)
+      - FROM vf-module( vf-module Uses volume-group, ONE2ONE)
+      - FROM tenant( tenant 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 LocatedIn complex, MANY2ONE)
+      - TO ctag-pool( vpls-pe Uses ctag-pool, MANY2MANY)
+      - FROM lag-interface( lag-interface BindsTo vpls-pe, MANY2ONE)(1)
+      - FROM p-interface( p-interface BindsTo vpls-pe, MANY2ONE)(1)
+
+      -(1) IF this VPLS-PE node is deleted, this FROM node is DELETED also
+    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 BelongsTo vpn-binding, MANY2MANY)
+      - FROM l3-network( l3-network Uses vpn-binding, MANY2MANY)
+      - FROM logical-link( logical-link Uses vpn-binding, MANY2MANY)
+      - FROM route-target( route-target BelongsTo vpn-binding, MANY2ONE)(1)
+
+      -(1) IF this VPN-BINDING node is deleted, this FROM node is DELETED also
+      -VPN-BINDING cannot be deleted if related to ALLOTTED-RESOURCE,L3-NETWORK,LOGICAL-LINK
+
+    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 BelongsTo tenant, MANY2ONE)
+      - TO flavor( vserver Uses flavor, MANY2ONE)
+      - TO image( vserver Uses image, MANY2ONE)
+      - TO pserver( vserver HostedOn pserver, MANY2ONE)
+      - TO snapshot( vserver Uses snapshot, ONE2ONE)
+      - TO volume (CHILD of vserver, vserver AttachesTo volume, ONE2MANY)(2)
+      - FROM generic-vnf( generic-vnf HostedOn vserver, ONE2MANY)
+      - FROM vce( vce HostedOn vserver, ONE2MANY)
+      - FROM l-interface( l-interface BindsTo vserver, MANY2ONE)(1)
+      - FROM vf-module( vf-module Uses vserver, ONE2MANY)
+      - FROM vnfc( vnfc HostedOn vserver, ONE2MANY)
+
+      -(1) IF this VSERVER node is deleted, this FROM node is DELETED also
+      -(2) IF this VSERVER node is deleted, this TO node is DELETED also
     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
+        description: Used to indicate whether or not this object is in maintenance mode (maintenance mode = true). This field (in conjunction with prov-status) is used to suppress alarms and vSCL on VNFs/VMs.
+      is-closed-loop-disabled:
+        type: boolean
+        description: Used to indicate whether closed loop function is enabled on this node
       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 LocatedIn complex, MANY2ONE)
+      - FROM cloud-region( cloud-region LocatedIn zone, MANY2ONE)
+      - FROM pnf( pnf LocatedIn zone, MANY2ONE)
+      - FROM pserver( pserver LocatedIn zone, MANY2ONE)
+      - FROM service-instance( service-instance 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"