Skip to content

[v5.2.1] Typo error in the description of error code, parameters etc of SOL003 OpenAPI VNFLCM operations based on the SOL003 specification

a. Typo error in the description of error code 422 for "POST Create a new vnfInstance" as defined in 5.4.2.3.1.

File: https://forge.etsi.org/rep/nfv/SOL002-SOL003/-/blob/v5.2.1/src/SOL003/VNFLifecycleManagement/VNFLifecycleManagement.yaml?ref_type=tags#L1694

    VNFInstances.Post.422:
      description: |
        422 Unprocessable Content

        Shall be returned upon the following error: The content
        type of the message content is supported and the message
        content of a request contains syntactically correct data
        but the data cannot be processed.
        The general cause for this error and its handling is
        specified in clause 6.4 of ETSI GS NFV-SOL 013 [8],
        including rules for the presence of the response body.
        Specifically in case of this resource, the response
        code 422 shall also be returned if the VNF package
        referenced by the "vnfdId" attribute in the
        "CreateVnfRequest" structure is not in the "ENABLED"
        state or does not exist. In this case, the "detail"
        attribute in the "ProblemDetails" structure shall convey
        more information about the **erro**

As per the SOL003 specification document, the error code 422 description should contain "error" in place of "erro" as per the definition. https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/003/05.02.01_60/gs_NFV-SOL003v050201p.pdf

b. Typo error in the description of instantiationLevelId, extManagedVirtualLinks parameters for the VNF instantiation (InstantiateVnfRequest), as defined in clause 5.5.2.4.

File: https://forge.etsi.org/rep/nfv/SOL002-SOL003/-/blob/v5.2.1/src/SOL003/VNFLifecycleManagement/definitions/SOL003VNFLifecycleManagement_def.yaml?ref_type=tags#L45

      instantiationLevelId:
        description: >
          Identifier of the instantiation level of the deployment
          flavour to be instantiated. **See note** 3 and 5.

File: https://forge.etsi.org/rep/nfv/SOL002-SOL003/-/blob/v5.2.1/src/SOL003/VNFLifecycleManagement/definitions/SOL003VNFLifecycleManagement_def.yaml?ref_type=tags#L77

      extManagedVirtualLinks:
        description: >
          Information about internal VLs that are managed by the NFVO. **See note** 1 and note 2.
        type: array

As per the SOL003 specification document, the parameter description should contain "See notes" in place of "See note" as per the definition. https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/003/05.02.01_60/gs_NFV-SOL003v050201p.pdf

c. Typo error in the description of error code 200 for "POST Fail operation task" as defined in 5.4.16.3.1.

File: https://forge.etsi.org/rep/nfv/SOL002-SOL003/-/blob/v5.2.1/src/SOL003/VNFLifecycleManagement/VNFLifecycleManagement.yaml?ref_type=tags#L3269

  FailVnfLcmOpOcc.Post.200:
     description: |
       200 OK

       Shall be returned when the state of the VNF lifecycle management operation occurrence
       has been changed successfully.
       The response **bofyshall** include a representation of the "Individual VNF lifecycle operation occurrence" 
       resource.

As per the SOL003 specification document, the error code 200 description should contain "body shall" in place of "bofyshall" as per the definition.
https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/003/05.02.01_60/gs_NFV-SOL003v050201p.pdf

To upload designs, you'll need to enable LFS and have an admin enable hashed storage. More information