Added notes and references

67d0662e · Sana Zulfiqar · 99474203 · 67d0662e · 67d0662e · 67d0662e
Commit 67d0662e authored May 06, 2021 by Sana Zulfiqar
--- a/src/SOL002/APIVersion/APIVersion.yaml
+++ b/src/SOL002/APIVersion/APIVersion.yaml
@@ -12,11 +12,11 @@ info:
  license:
    name: ETSI Forge copyright notice
    url: https://forge.etsi.org/etsi-forge-copyright-notice.txt
-  version: 1.0.0-impl:etsi.org:ETSI_NFV_OpenAPI:1
+  version: 1.3.0-impl:etsi.org:ETSI_NFV_OpenAPI:1

 externalDocs:
-  description: ETSI GS NFV-SOL 002 V3.3.1
-  url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/002/03.03.01_60/gs_NFV-SOL002v030301p.pdf
+  description: ETSI GS NFV-SOL 002 V3.5.1
+  url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/002/03.05.01_60/gs_NFV-SOL002v030501p.pdf

 paths:
  /vnfconfig/api_versions:
@@ -28,4 +28,6 @@ paths:
  /vnflcm/api_versions:
    $ref: ../../endpoints/SOL002SOL003_endpoints.yaml#/endpoints/api-versions
  /vnfpm/api_versions:
+    $ref: ../../endpoints/SOL002SOL003_endpoints.yaml#/endpoints/api-versions
+  /lcmcoord/api_versions:
    $ref: ../../endpoints/SOL002SOL003_endpoints.yaml#/endpoints/api-versions
\ No newline at end of file
--- a/src/SOL002/VNFConfiguration/VNFConfiguration.yaml
+++ b/src/SOL002/VNFConfiguration/VNFConfiguration.yaml
@@ -12,11 +12,11 @@ info:
  license:
    name: ETSI Forge copyright notice
    url: https://forge.etsi.org/etsi-forge-copyright-notice.txt
-  version: 1.2.0-impl:etsi.org:ETSI_NFV_OpenAPI:1
+  version: 1.3.0-impl:etsi.org:ETSI_NFV_OpenAPI:1

 externalDocs:
-  description: ETSI GS NFV-SOL 002 V3.3.1
-  url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/002/03.03.01_60/gs_NFV-SOL002v030301p.pdf
+  description: ETSI GS NFV-SOL 002 V3.5.1
+  url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/002/03.05.01_60/gs_NFV-SOL002v030501p.pdf

 servers:
  - url: http://127.0.0.1/vnfconfig/v1

--- a/src/SOL002/VNFConfiguration/definitions/SOL002VNFConfiguration_def.yaml
+++ b/src/SOL002/VNFConfiguration/definitions/SOL002VNFConfiguration_def.yaml
@@ -76,6 +76,8 @@ definitions:
  VnfConfigurationData:
    description: >
      This type represents configuration parameters of a VNF instance.
+      *   NOTE:	ETSI GS NFV-SOL 001 specifies the structure and format of
+                the VNFD based on TOSCA specifications.
    type: object
    properties:
      extCpConfig:
@@ -92,12 +94,14 @@ definitions:
      vnfSpecificData:
        description: >
          Additional configurable properties of the VNF instance declared in the
-          VNFD as "VnfConfigurableProperties".
+          VNFD as "VnfConfigurableProperties". see note.
        $ref: '../../../definitions/SOL002SOL003_def.yaml#/definitions/KeyValuePairs'

  VnfcConfigurationData:
    description: >
      This type represents configuration parameters of a VNFC instance.
+      *   NOTE:	ETSI GS NFV-SOL 001 specifies the structure and format
+                of the VNFD based on TOSCA specifications.
    type: object
    required:
      - vnfcInstanceId
@@ -121,7 +125,7 @@ definitions:
      vnfcSpecificData:
        description: >
          Additional configurable properties of the VNFC instance declared in the
-          VNFD as "VnfcConfigurableProperties".
+          VNFD as "VnfcConfigurableProperties". See note.
        $ref: '../../../definitions/SOL002SOL003_def.yaml#/definitions/KeyValuePairs'

  CpConfiguration:

--- a/src/SOL002/VNFFaultManagement/VNFFaultManagement.yaml
+++ b/src/SOL002/VNFFaultManagement/VNFFaultManagement.yaml
@@ -15,8 +15,8 @@ info:
  version: 1.3.0-impl:etsi.org:ETSI_NFV_OpenAPI:1

 externalDocs:
-  description: ETSI GS NFV-SOL 002 V3.3.1
-  url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/002/03.03.01_60/gs_NFV-SOL002v030301p.pdf
+  description: ETSI GS NFV-SOL 002 V3.5.1
+  url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/002/03.05.01_60/gs_NFV-SOL002v030501p.pdf

 servers:
  - url: http://127.0.0.1/vnffm/v1
@@ -592,7 +592,8 @@ components:
    IndividualSubscription.Get:
      description: |
        200 OK
-        Shall be returned when information about an individual subscription  has been read successfully. The response body shall contain a representation of the "Individual  subscription" resource.
+        Shall be returned when information about an individual subscription  has been read successfully.
+        The response body shall contain a representation of the "Individual  subscription" resource.
      headers:
        Version:
          description: The used API version.
@@ -602,7 +603,8 @@ components:
            type: string
        WWW-Authenticate:
          description: |
-            Challenge if the corresponding HTTP request has not provided authorization, or error details if the corresponding HTTP request has provided an invalid authorization token.
+            Challenge if the corresponding HTTP request has not provided authorization, or error
+            details if the corresponding HTTP request has provided an invalid authorization token.
          style: simple
          explode: false
          schema:

--- a/src/SOL002/VNFFaultManagementNotification/VNFFaultManagementNotification.yaml
+++ b/src/SOL002/VNFFaultManagementNotification/VNFFaultManagementNotification.yaml
@@ -15,8 +15,8 @@ info:
  version: 1.3.0-impl:etsi.org:ETSI_NFV_OpenAPI:1

 externalDocs:
-  description: ETSI GS NFV-SOL 002 V3.3.1
-  url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/002/03.03.01_60/gs_NFV-SOL002v030301p.pdf
+  description: ETSI GS NFV-SOL 002 V3.5.1
+  url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/002/03.05.01_60/gs_NFV-SOL002v030501p.pdf

 servers:
  - url: http://127.0.0.1/callback/v1

--- a/src/SOL002/VNFIndicator/VNFIndicator.yaml
+++ b/src/SOL002/VNFIndicator/VNFIndicator.yaml
@@ -18,8 +18,8 @@ info:
  version: 1.3.0-impl:etsi.org:ETSI_NFV_OpenAPI:1

 externalDocs:
-  description: ETSI GS NFV-SOL 002 V3.3.1
-  url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/002/03.03.01_60/gs_NFV-SOL002v030301p.pdf
+  description: ETSI GS NFV-SOL 002 V3.5.1
+  url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/002/03.05.01_60/gs_NFV-SOL002v030501p.pdf

 servers:
  - url: http://127.0.0.1/vnfind/v1
@@ -520,7 +520,8 @@ components:
    VnfIndicatorSubscription.Get:
      description: |
        200 OK
-        Shall be returned when information about an individual subscription  has been read successfully.  The response body shall contain the representation of the  "Individual subscription" resource.
+        Shall be returned when information about an individual subscription has been read successfully.
+        The response body shall contain the representation of the "Individual subscription" resource.
      headers:
        Version:
          description: The used API version.

--- a/src/SOL002/VNFIndicatorNotification/VNFIndicatorNotification.yaml
+++ b/src/SOL002/VNFIndicatorNotification/VNFIndicatorNotification.yaml
@@ -18,8 +18,8 @@ info:
  version: 1.3.0-impl:etsi.org:ETSI_NFV_OpenAPI:1

 externalDocs:
-  description: ETSI GS NFV-SOL 002 V3.3.1
-  url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/002/03.03.01_60/gs_NFV-SOL002v030301p.pdf
+  description: ETSI GS NFV-SOL 002 V3.5.1
+  url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/002/03.05.01_60/gs_NFV-SOL002v030501p.pdf

 servers:
  - url: http://127.0.0.1/callback/v1

--- a/src/SOL002/VNFIndicatorNotification/definitions/SOL002VNFIndicatorNotification_def.yaml
+++ b/src/SOL002/VNFIndicatorNotification/definitions/SOL002VNFIndicatorNotification_def.yaml
@@ -5,6 +5,8 @@ definitions:
  VnfIndicatorValueChangeNotification:
    description: >
      This type represents a VNF indicator value change notification.
+      *   NOTE:	ETSI GS NFV-SOL 001 specifies the structure and
+                format of the VNFD based on TOSCA specifications.
    type: object
    required:
      - id
@@ -45,7 +47,8 @@ definitions:
        type: string
      value:
        description: >
-          Provides the value of the VNF indicator. The value format is defined in the VNFD. 
+          Provides the value of the VNF indicator. The value format is defined in the VNFD.
+          See note.
        type: object
      vnfInstanceId:
        description: >
@@ -71,8 +74,10 @@ definitions:

  SupportedIndicatorsChangeNotification:
    description: |
-      This type represents a notification to inform the receiver that the set of indicators supported by a VNF instance
-      has changed.
+      This type represents a notification to inform the receiver that the set of indicators
+      supported by a VNF instance has changed.
+      *   NOTE:	ETSI GS NFV-SOL 001 specifies the structure and
+                format of the VNFD based on TOSCA specifications.
    type: object
    required:
      - id
@@ -120,7 +125,7 @@ definitions:
            name:
              description: |
                Human readable name of the VNF indicator. Shall be present if defined in the VNFD.
-                ETSI GS NFV-SOL 001 specifies the structure and format of the VNFD based on TOSCA specifications.
+                See note.
              type: string
      _links:
        description: |

--- a/src/SOL002/VNFLifecycleCoordination/VNFLifecycleCoordination.yaml
+++ b/src/SOL002/VNFLifecycleCoordination/VNFLifecycleCoordination.yaml
@@ -12,11 +12,11 @@ info:
  license:
    name: ETSI Forge copyright notice
    url: https://forge.etsi.org/etsi-forge-copyright-notice.txt
-  version: 1.2.0-impl:etsi.org:ETSI_NFV_OpenAPI:1
+  version: 1.3.0-impl:etsi.org:ETSI_NFV_OpenAPI:1

 externalDocs:
  description: ETSI GS NFV-SOL 002 V3.5.1
-  url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/002/03.03.01_60/gs_NFV-SOL002v030301p.pdf
+  url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/002/03.05.01_60/gs_NFV-SOL002v030501p.pdf

 servers:
  - url: http://127.0.0.1/lcmcoord/v1
@@ -33,7 +33,7 @@ paths:
    post:
      description: |
        This POST method requests the coordination of an LCM operation occurrence with
-        a management operation executed in the API producer.
+        a management operation executed in the API producer. See clause 10.4.2.3.1.
      parameters:
        - $ref: ../../components/SOL002SOL003_params.yaml#/components/parameters/Accept
        - $ref: ../../components/SOL002SOL003_params.yaml#/components/parameters/ContentType
@@ -74,7 +74,7 @@ paths:
      - $ref: ../../components/SOL002SOL003_params.yaml#/components/parameters/Authorization
    get:
      description: |
-        The GET method reads a coordination result.
+        The GET method reads a coordination result. See clause 10.4.3.3.2.
      responses:
        "200":
          $ref: '#/components/responses/IndividualLcmCoord.Get'
@@ -111,6 +111,7 @@ paths:
    post:
      description: |
        The POST method initiates the cancellation of an ongoing coordination action.
+        See clause 10.4.4.3.1.
      responses:
        "202":
          $ref: '#/components/responses/coordinationCancel.Post'
@@ -169,7 +170,6 @@ components:
  responses:
    Coordination.Post:
      description: |
-        201 CREATED
        Shall be returned when the API producer has chosen the synchronous mode,
        which may be chosen for coordination actions that finish within the time
        frame in which an HTTP response is expected.
@@ -216,7 +216,6 @@ components:

    Coordination_async.Post:
      description: |
-        202 Accepted
        Shall be returned when the API producer has chosen the asynchronous mode and the
        request has been accepted for processing.
        The response body shall be empty.
@@ -260,7 +259,6 @@ components:

    IndividualLcmCoord.Get:
      description: |
-        200 OK
        Shall be returned when the coordination is finished and the coordination result has been read successfully.
        A representation of the "Individual coordination action" resource shall be returned in the response body.
      headers:
@@ -291,7 +289,6 @@ components:

    coordinationCancel.Post:
      description: |
-        202 Accepted
        Shall be returned when the cancellation request has been accepted for processing.
        The response shall have an empty payload body.
      headers:

--- a/src/SOL002/VNFLifecycleCoordination/definitions/SOL002VNFLifecycleCoordination_def.yaml
+++ b/src/SOL002/VNFLifecycleCoordination/definitions/SOL002VNFLifecycleCoordination_def.yaml
@@ -132,3 +132,13 @@ definitions:
            description: >
              Related VNF instance.
            $ref: "../../../definitions/SOL002SOL003_def.yaml#/definitions/Link"
+
+  inputParams:
+    type: object
+    required:
+      - vnfcInstanceIds
+    properties:
+      vnfcInstanceIds:
+        description: >
+          Identifier of the VNF instance which this coordination request is related to.
+        $ref: "../../../definitions/SOL002SOL003_def.yaml#/definitions/Identifier"
--- a/src/SOL002/VNFLifecycleManagement/VNFLifecycleManagement.yaml
+++ b/src/SOL002/VNFLifecycleManagement/VNFLifecycleManagement.yaml
@@ -15,8 +15,8 @@ info:
  version: 2.0.0-impl:etsi.org:ETSI_NFV_OpenAPI:1

 externalDocs:
-  description: ETSI GS NFV-SOL 002 V3.3.1
-  url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/002/03.03.01_60/gs_NFV-SOL002v030301p.pdf
+  description: ETSI GS NFV-SOL 002 V3.5.1
+  url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/002/03.05.01_60/gs_NFV-SOL002v030501p.pdf

 servers:
  - url: http://127.0.0.1/vnflcm/v1
@@ -32,7 +32,7 @@ paths:
      - $ref: ../../components/SOL002SOL003_params.yaml#/components/parameters/Authorization
    get:
      description: |
-        The GET method queries information about multiple VNF instances.
+        The GET method queries information about multiple VNF instances. See clause 5.4.2.3.2.
      parameters:
        - $ref: ../../components/SOL002SOL003_params.yaml#/components/parameters/Accept
        - $ref: ../../components/SOL002SOL003_params.yaml#/components/parameters/filter
@@ -72,6 +72,7 @@ paths:
    post:
      description: |
        The POST method creates a new VNF instance resource based on a VNF package that is onboarded and in "ENABLED" state.
+        See clause 5.4.2.3.1.
      parameters:
        - $ref: ../../components/SOL002SOL003_params.yaml#/components/parameters/Accept
        - $ref: ../../components/SOL002SOL003_params.yaml#/components/parameters/ContentType
@@ -112,7 +113,7 @@ paths:
      - $ref: ../../components/SOL002SOL003_params.yaml#/components/parameters/Authorization
    get:
      description: |
-        Information about a VNF instance by reading an "Individual VNF instance".
+        Information about a VNF instance by reading an "Individual VNF instance". See clause 5.4.3.3.2.
      responses:
        "200":
          $ref: '#/components/responses/IndividualVnfInstance.Get'
@@ -143,7 +144,7 @@ paths:

    delete:
      description: |
-        This method deletes an "Individual VNF instance" resource.
+        This method deletes an "Individual VNF instance" resource. See clause 5.4.3.3.5.
      responses:
        "204":
          $ref: '#/components/responses/IndividualVnfInstance.Delete'
@@ -176,10 +177,7 @@ paths:

    patch:
      description: |
-        This method modifies an "Individual VNF instance" resource. Changes to the VNF configurable properties are
-        applied to the configuration in the VNF instance, and are reflected in the representation of this resource.
-        Other changes are applied to the VNF instance information managed by the VNFM, and are reflected in the
-        representation of this resource.
+        This method modifies an "Individual VNF instance" resource. See clause 5.4.3.3.4.
      requestBody:
        $ref: '#/components/requestBodies/VnfInstanceModificationRequest'
      responses:
@@ -221,7 +219,7 @@ paths:
      - $ref: ../../components/SOL002SOL003_params.yaml#/components/parameters/Authorization
    post:
      description: |
-        The POST method instantiates a VNF instance.
+        The POST method instantiates a VNF instance. See clause 5.4.4.3.1.
      requestBody:
        $ref: '#/components/requestBodies/VnfInstanceInstantiationRequest'
      responses:
@@ -261,7 +259,7 @@ paths:
      - $ref: ../../components/SOL002SOL003_params.yaml#/components/parameters/Authorization
    post:
      description: |
-        The POST method requests to scale a VNF instance resource incrementally.
+        The POST method requests to scale a VNF instance resource incrementally. See clause 5.4.5.3.1.
      requestBody:
        $ref: '#/components/requestBodies/VnfInstanceScaleRequest'
      responses:
@@ -301,7 +299,7 @@ paths:
      - $ref: ../../components/SOL002SOL003_params.yaml#/components/parameters/Authorization
    post:
      description: |
-        The POST method requests to scale a VNF instance resource to a target level.
+        The POST method requests to scale a VNF instance resource to a target level. See clause 5.4.6.3.1.
      requestBody:
        $ref: '#/components/requestBodies/VnfInstanceScaleToLevelRequest'
      responses:
@@ -341,7 +339,7 @@ paths:
      - $ref: ../../components/SOL002SOL003_params.yaml#/components/parameters/Authorization
    post:
      description: |
-        The POST method changes the deployment flavour of a VNF instance.
+        The POST method changes the deployment flavour of a VNF instance. See clause 5.4.7.3.1.
      requestBody:
        $ref: '#/components/requestBodies/VnfInstanceChangeFlavourRequest'
      responses:
@@ -382,7 +380,7 @@ paths:
    post:
      description: |
        The POST method triggers the VNFM to terminate a VNF  instance and to request to the VIM the release of its
-        used virtualised resources.
+        used virtualised resources. See clause 5.4.8.3.1.
      requestBody:
        $ref: '#/components/requestBodies/VnfInstanceTerminationRequest'
      responses:
@@ -422,7 +420,7 @@ paths:
      - $ref: ../../components/SOL002SOL003_params.yaml#/components/parameters/Authorization
    post:
      description: |
-        The POST method requests to heal a VNF instance.
+        The POST method requests to heal a VNF instance. See clause 5.4.9.3.1.
      requestBody:
        $ref: '#/components/requestBodies/VnfInstanceHealRequest'
      responses:
@@ -462,7 +460,7 @@ paths:
      - $ref: ../../components/SOL002SOL003_params.yaml#/components/parameters/Authorization
    post:
      description: |
-        The POST method changes the operational state of a VNF instance.
+        The POST method changes the operational state of a VNF instance. See clause 5.4.10.3.1.
      requestBody:
        $ref: '#/components/requestBodies/VnfInstanceOperateRequest'
      responses:
@@ -502,7 +500,7 @@ paths:
      - $ref: ../../components/SOL002SOL003_params.yaml#/components/parameters/Authorization
    post:
      description: |
-        The POST method changes the external connectivity of a VNF instance.
+        The POST method changes the external connectivity of a VNF instance. See clause 5.4.11.3.1.
      requestBody:
        $ref: '#/components/requestBodies/VnfInstanceChangeExtConnRequest'
      responses:
@@ -543,6 +541,7 @@ paths:
    post:
      description: |
        The POST method changes the current VNF package on which the VNF instance is based.
+        See clause 5.4.11a.3.1.
      requestBody:
        $ref: '#/components/requestBodies/VnfInstanceChangeVnfPkgRequest'
      responses:
@@ -581,7 +580,8 @@ paths:
      - $ref: ../../components/SOL002SOL003_params.yaml#/components/parameters/Authorization
    get:
      description: |
-        The client can use this method to query status information about multiple VNF lifecycle management operation occurrences.
+        The client can use this method to query status information about multiple VNF lifecycle
+        management operation occurrences. See clause 5.4.12.3.2.
      parameters:
        - $ref: ../../components/SOL002SOL003_params.yaml#/components/parameters/filter
        - $ref: ../../components/SOL002SOL003_params.yaml#/components/parameters/all_fields
@@ -625,7 +625,7 @@ paths:
    get:
      description: |
        The client can use this method to retrieve status information about a VNF lifecycle management operation occurrence
-        by reading an "Individual VNF LCM operation occurrence" resource.
+        by reading an "Individual VNF LCM operation occurrence" resource. See clause 5.4.13.3.2.
      responses:
        "200":
          $ref: '#/components/responses/IndividualVnfLcmOpOcc.Get'
@@ -663,6 +663,7 @@ paths:
      description: |
        The POST method initiates retrying a VNF lifecycle operation if that operation has experienced a temporary
        failure, i.e. the related "Individual VNF LCM operation occurrence" resource is in "FAILED_TEMP"  state.
+        See clause 5.4.14.3.1.
      responses:
        "202":
          $ref: '#/components/responses/VnfLcmOpOccRetry.Post'
@@ -702,6 +703,7 @@ paths:
      description: |
        The POST method initiates rolling back a VNF lifecycle operation if that operation has experienced a temporary
        failure, i.e. the related "Individual VNF LCM operation occurrence" resource is in "FAILED_TEMP"  state.
+        See clause 5.4.15.3.1.
      responses:
        "202":
          $ref: '#/components/responses/VnfLcmOpOccRollback.Post'
@@ -740,7 +742,7 @@ paths:
    post:
      description: |
        The POST method marks a VNF lifecycle management operation occurrence as "finally failed" if that operation
-        occurrence is in "FAILED_TEMP" state.
+        occurrence is in "FAILED_TEMP" state. See clause 5.4.16.3.1.
      responses:
        "200":
          $ref: '#/components/responses/VnfLcmOpOccFail.Post'
@@ -780,6 +782,7 @@ paths:
      description: |
        The POST method initiates cancelling an ongoing VNF lifecycle operation while it is being executed or rolled
        back, i.e. the related "Individual VNF LCM operation occurrence" is either in "PROCESSING" or "ROLLING_BACK" state.
+        See clause 5.4.17.3.1.
      responses:
        "202":
          $ref: '#/components/responses/VnfLcmOpOccCancel.Post'
@@ -817,7 +820,7 @@ paths:
    get:
      description: |
        The GET method queries the list of active subscriptions of the functional block that invokes the method. It can
-        be used e.g. for resynchronization after error situations.
+        be used e.g. for resynchronization after error situations. See clause 5.4.18.3.2.
      parameters:
        - $ref: ../../components/SOL002SOL003_params.yaml#/components/parameters/filter
        - $ref: ../../components/SOL002SOL003_params.yaml#/components/parameters/nextpage_opaque_marker
@@ -851,7 +854,7 @@ paths:

    post:
      description: |
-        The POST method creates a new subscription.
+        The POST method creates a new subscription. See clause 5.4.18.3.1.
      requestBody:
        $ref: '#/components/requestBodies/VnfLcmSubscriptionRequest'
      responses:
@@ -892,6 +895,7 @@ paths:
    get:
      description: |
        The GET method retrieves information about a subscription by reading an "Individual subscription" resource.
+        See clause 5.4.19.3.2.
      responses:
        "200":
          $ref: '#/components/responses/IndividualSubscription.Get'
@@ -922,7 +926,7 @@ paths:

    delete:
      description: |
-        The DELETE method terminates an individual subscription.
+        The DELETE method terminates an individual subscription. See clause 5.4.19.3.5.
      responses:
        "204":
          $ref: '#/components/responses/IndividualSubscription.Delete'
@@ -959,7 +963,7 @@ paths:
    post:
      description: |
        The POST method requests tacking a VNF instance snapshot and populating a previously created VNF snapshot resource
-        (refer to clause 5.4.23.3.1) with the snapshot content.
+        (refer to clause 5.4.23.3.1) with the snapshot content. See clause 5.4.21.3.1.
      requestBody:
        $ref: '#/components/requestBodies/VnfInstanceCreateSnapshotRequest'
      responses:
@@ -999,7 +1003,7 @@ paths:
      - $ref: ../../components/SOL002SOL003_params.yaml#/components/parameters/Authorization
    post:
      description: |
-        The POST method requests reverting a VNF/VNFC instance to a VNF/VNFC snapshot.
+        The POST method requests reverting a VNF/VNFC instance to a VNF/VNFC snapshot. See clause 5.4.22.3.1.
      requestBody:
        $ref: '#/components/requestBodies/VnfInstanceRevertToSnapshotRequest'
      responses:
@@ -1038,7 +1042,7 @@ paths:
      - $ref: ../../components/SOL002SOL003_params.yaml#/components/parameters/Authorization
    post:
      description: |
-        The POST method creates a new individual VNF snapshot resource.
+        The POST method creates a new individual VNF snapshot resource. See clause 5.4.23.3.1.
      requestBody:
        $ref: '#/components/requestBodies/VnfSnapshotsRequest'
      responses:
@@ -1073,7 +1077,7 @@ paths:

    get:
      description: |
-        The GET method queries information about multiple VNF/VNFC snapshots.
+        The GET method queries information about multiple VNF/VNFC snapshots. See clause 5.4.23.3.2.
      parameters:
        - $ref: ../../components/SOL002SOL003_params.yaml#/components/parameters/Accept
        - $ref: ../../components/SOL002SOL003_params.yaml#/components/parameters/filter
@@ -1118,6 +1122,7 @@ paths:
    get:
      description: |
        The GET method retrieves information about a VNF /VNFC snapshot by reading an individual VNF snapshot resource.
+        See clause 5.4.24.3.2.
      responses:
        "200":
          $ref: '#/components/responses/IndividualVnfSnapshot.Get'
@@ -1149,7 +1154,7 @@ paths:
    delete:
      description: |
        This method deletes an individual VNF snapshot resource and the associated VNF snapshot information managed by
-        the VNFM, and any resource associated to the VNF/VNFC snapshot managed by the VIM.
+        the VNFM, and any resource associated to the VNF/VNFC snapshot managed by the VIM. See clause 5.4.24.3.5.
      responses:
        "200":
          $ref: '#/components/responses/IndividualVnfSnapshot.Delete'

--- a/src/SOL002/VNFLifecycleManagement/definitions/SOL002VNFLifecycleManagement_def.yaml
+++ b/src/SOL002/VNFLifecycleManagement/definitions/SOL002VNFLifecycleManagement_def.yaml
--- a/src/SOL002/VNFLifecycleManagementNotification/VNFLifecycleManagementNotification.yaml
+++ b/src/SOL002/VNFLifecycleManagementNotification/VNFLifecycleManagementNotification.yaml
@@ -16,8 +16,8 @@ info:
  version: 2.0.0-impl:etsi.org:ETSI_NFV_OpenAPI:1

 externalDocs:
-  description: ETSI GS NFV-SOL 002 V3.3.1
-  url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/002/03.03.01_60/gs_NFV-SOL002v030301p.pdf
+  description: ETSI GS NFV-SOL 002 V3.5.1
+  url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/002/03.05.01_60/gs_NFV-SOL002v030501p.pdf

 servers:
  - url: http://127.0.0.1/callback/v1
@@ -31,7 +31,7 @@ paths:
    get:
      description: |
        The GET method allows the server to test the notification endpoint that is provided by the API consumer,
-        e.g. during subscription.
+        e.g. during subscription. See clause 5.4.20.3.2.
      responses:
        "204":
          $ref: '#/components/responses/VNFLCMNotification.Get'
@@ -52,9 +52,8 @@ paths:

    post:
      description: |
-        Notify
        The POST method delivers a notification from the API producer to an API consumer. The API consumer shall have
-        previously created an "Individual subscription" resource with a matching filter.
+        previously created an "Individual subscription" resource with a matching filter. See clause 5.4.20.3.1.
      parameters:
        - $ref: ../../components/SOL002SOL003_params.yaml#/components/parameters/ContentType
      requestBody:
@@ -84,7 +83,7 @@ paths:
    get:
      description: |
        The GET method allows the server to test the notification endpoint that is provided by the API consumer,
-        e.g. during subscription.
+        e.g. during subscription. See clause 5.4.20.3.2.
      responses:
        "204":
          $ref: '#/components/responses/VNFLCMNotification.Get'
@@ -105,9 +104,8 @@ paths:

    post:
      description: |
-        Notify
        The POST method delivers a notification from the API producer to an API consumer. The API consumer shall have
-        previously created an "Individual subscription" resource with a matching filter.
+        previously created an "Individual subscription" resource with a matching filter. See clause 5.4.20.3.1.
      parameters:
        - $ref: ../../components/SOL002SOL003_params.yaml#/components/parameters/ContentType
      requestBody:
@@ -137,7 +135,7 @@ paths:
    get:
      description: |
        The GET method allows the server to test the notification endpoint that is provided by the API consumer,
-        e.g. during subscription.
+        e.g. during subscription. See clause 5.4.20.3.2.
      responses:
        "204":
          $ref: '#/components/responses/VNFLCMNotification.Get'
@@ -158,9 +156,8 @@ paths:

    post:
      description: |
-        Notify
        The POST method delivers a notification from the API producer to an API consumer. The API consumer shall have
-        previously created an "Individual subscription" resource with a matching filter.
+        previously created an "Individual subscription" resource with a matching filter. See clause 5.4.20.3.1.
      parameters:
        - $ref: ../../components/SOL002SOL003_params.yaml#/components/parameters/ContentType
      requestBody:

--- a/src/SOL002/VNFLifecycleManagementNotification/definitions/SOL002VNFLifecycleManagementNotification_def.yaml
+++ b/src/SOL002/VNFLifecycleManagementNotification/definitions/SOL002VNFLifecycleManagementNotification_def.yaml
@@ -34,6 +34,18 @@ definitions:
      been executed.