From a960fdf4cfa75c54d01dde46e24503c518870d37 Mon Sep 17 00:00:00 2001 From: Bertrand Souville Date: Mon, 14 Apr 2025 18:35:58 +0200 Subject: [PATCH 01/12] Address Feedback from ETSI EditHelp --- .../NFVICapacityInformation.yaml | 6 ++--- src/SOL005/NSDManagement/NSDManagement.yaml | 26 +++++++++---------- .../NSFaultManagement/NSFaultManagement.yaml | 2 +- .../NSLifecycleManagement.yaml | 12 +++------ .../SOL005NSLifecycleManagement_def.yaml | 23 ++++++++-------- .../NSLifecycleManagementNotification.yaml | 6 ++--- .../NSPerformanceManagement.yaml | 12 ++++----- .../VNFPackageManagement.yaml | 11 +++----- 8 files changed, 44 insertions(+), 54 deletions(-) diff --git a/src/SOL005/NFVICapacityInformation/NFVICapacityInformation.yaml b/src/SOL005/NFVICapacityInformation/NFVICapacityInformation.yaml index 1471ad5..e64f5e2 100644 --- a/src/SOL005/NFVICapacityInformation/NFVICapacityInformation.yaml +++ b/src/SOL005/NFVICapacityInformation/NFVICapacityInformation.yaml @@ -152,11 +152,9 @@ paths: - $ref: ../components/SOL005_params.yaml#/components/parameters/Authorization get: description: | - This method shall follow the provisions specified in the tables 10.4.3a.3.2-1 and 10.4.3a.3.2-2 for - URI query parameters, request and response data structures, and response codes. + The API consumer can use this method for reading an individual CCM's NFVI capacity information. + See clause 10.4.3a.3.2. - NOTE: This identifier can be retrieved from the "ccmId" attribute in the CapacityShortageNotification. - It can also be retrieved from the "ccmId" attribute in the message content of the response. parameters: - in: query name: filter diff --git a/src/SOL005/NSDManagement/NSDManagement.yaml b/src/SOL005/NSDManagement/NSDManagement.yaml index 6878e1b..38a3b57 100644 --- a/src/SOL005/NSDManagement/NSDManagement.yaml +++ b/src/SOL005/NSDManagement/NSDManagement.yaml @@ -37,7 +37,7 @@ paths: # NS Descriptors # ############################################################################### /ns_descriptors: - #ETSI GS NFV-SOL 005 V2.4.1 location: 5.4.2 + #ETSI GS NFV-SOL 005 V5.2.1 location: 5.4.2 parameters: - $ref: ../components/SOL005_params.yaml#/components/parameters/Authorization - $ref: ../components/SOL005_params.yaml#/components/parameters/Version @@ -128,7 +128,7 @@ paths: # Individual NS Descriptor # ############################################################################### /ns_descriptors/{nsdInfoId}: - #ETSI GS NFV-SOL 005 V2.4.1 location: 5.4.3 + #ETSI GS NFV-SOL 005 V5.2.1 location: 5.4.3 parameters: - $ref: '#/components/parameters/NsdInfoId' - $ref: ../components/SOL005_params.yaml#/components/parameters/Authorization @@ -229,7 +229,7 @@ paths: # NSD Archive Content # ############################################################################### /ns_descriptors/{nsdInfoId}/nsd_content: - #ETSI GS NFV-SOL 005 V2.4.1 location: 5.4.4 + #ETSI GS NFV-SOL 005 V5.2.1 location: 5.4.4 parameters: - $ref: '#/components/parameters/NsdInfoId' - $ref: ../components/SOL005_params.yaml#/components/parameters/Authorization @@ -323,7 +323,7 @@ paths: # NSD # ############################################################################### /ns_descriptors/{nsdInfoId}/nsd: - #ETSI GS NFV-SOL 005 V2.4.1 location: 5.4.4a + #ETSI GS NFV-SOL 005 V5.2.1 location: 5.4.4a parameters: - $ref: '#/components/parameters/NsdInfoId' - $ref: ../components/SOL005_params.yaml#/components/parameters/Authorization @@ -363,7 +363,7 @@ paths: # NSD Archive Manifest # ############################################################################### /ns_descriptors/{nsdInfoId}/manifest: - #ETSI GS NFV-SOL 005 V2.4.1 location: 5.4.4b + #ETSI GS NFV-SOL 005 V5.2.1 location: 5.4.4b parameters: - $ref: '#/components/parameters/NsdInfoId' - $ref: ../components/SOL005_params.yaml#/components/parameters/Authorization @@ -371,7 +371,7 @@ paths: get: description: | - The GET method reads the content of the manifest file within an NSD archive. See clasue 5.4.4b.3.2. + The GET method reads the content of the manifest file within an NSD archive. See clause 5.4.4b.3.2. parameters: - $ref: '#/components/parameters/AcceptTextOrZip' - in: query @@ -413,7 +413,7 @@ paths: # Individual NSD Archive Artifact # ############################################################################### /ns_descriptors/{nsdInfoId}/artifacts/{artifactPath}: - #ETSI GS NFV-SOL 005 V3.5.1 location: 5.4.4c + #ETSI GS NFV-SOL 005 V5.2.1 location: 5.4.4c parameters: - $ref: '#/components/parameters/NsdInfoId' - $ref: '#/components/parameters/ArtifactPathInNSD' @@ -465,7 +465,7 @@ paths: # PNF Descriptors # ############################################################################### /pnf_descriptors: - #ETSI GS NFV-SOL 005 V2.4.1 location: 5.4.5 + #ETSI GS NFV-SOL 005 V5.2.1 location: 5.4.5 parameters: - $ref: ../components/SOL005_params.yaml#/components/parameters/Authorization - $ref: ../components/SOL005_params.yaml#/components/parameters/Version @@ -556,7 +556,7 @@ paths: # Individual PNF Descriptor # ############################################################################### /pnf_descriptors/{pnfdInfoId}: - #ETSI GS NFV-SOL 005 V2.4.1 location: 5.4.6 + #ETSI GS NFV-SOL 005 V5.2.1 location: 5.4.6 parameters: - $ref: '#/components/parameters/PnfdInfoId' @@ -653,7 +653,7 @@ paths: # PNFD Archive Content # ############################################################################### /pnf_descriptors/{pnfdInfoId}/pnfd_content: - #ETSI GS NFV-SOL 005 V2.4.1 location: 5.4.7 + #ETSI GS NFV-SOL 005 V5.2.1 location: 5.4.7 parameters: - $ref: '#/components/parameters/PnfdInfoId' - $ref: ../components/SOL005_params.yaml#/components/parameters/Authorization @@ -736,7 +736,7 @@ paths: # PNFD # ############################################################################### /pnf_descriptors/{pnfdInfoId}/pnfd: - #ETSI GS NFV-SOL 005 V2.4.1 location: 5.4.7a + #ETSI GS NFV-SOL 005 V5.2.1 location: 5.4.7a parameters: - $ref: '#/components/parameters/PnfdInfoId' - $ref: ../components/SOL005_params.yaml#/components/parameters/Authorization @@ -777,7 +777,7 @@ paths: # PNFD Archive Manifest # ############################################################################### /pnf_descriptors/{pnfdInfoId}/manifest: - #ETSI GS NFV-SOL 005 V2.4.1 location: 5.4.7b + #ETSI GS NFV-SOL 005 V5.2.1 location: 5.4.7b parameters: - $ref: '#/components/parameters/PnfdInfoId' - $ref: ../components/SOL005_params.yaml#/components/parameters/Authorization @@ -829,7 +829,7 @@ paths: # Individual PNFD Archive Artifact # ############################################################################### /pnf_descriptors/{pnfdInfoId}/artifacts/{artifactPath}: - #ETSI GS NFV-SOL 005 V3.5.1 location: 5.4.7c + #ETSI GS NFV-SOL 005 V5.2.1 location: 5.4.7c parameters: - $ref: '#/components/parameters/PnfdInfoId' - $ref: '#/components/parameters/ArtifactPathInPNFD' diff --git a/src/SOL005/NSFaultManagement/NSFaultManagement.yaml b/src/SOL005/NSFaultManagement/NSFaultManagement.yaml index be57538..b1c8f5c 100644 --- a/src/SOL005/NSFaultManagement/NSFaultManagement.yaml +++ b/src/SOL005/NSFaultManagement/NSFaultManagement.yaml @@ -743,4 +743,4 @@ components: explode: false schema: type: string - content: {} \ No newline at end of file + content: {} diff --git a/src/SOL005/NSLifecycleManagement/NSLifecycleManagement.yaml b/src/SOL005/NSLifecycleManagement/NSLifecycleManagement.yaml index fdf6991..d8865a6 100644 --- a/src/SOL005/NSLifecycleManagement/NSLifecycleManagement.yaml +++ b/src/SOL005/NSLifecycleManagement/NSLifecycleManagement.yaml @@ -203,14 +203,11 @@ paths: - $ref: ../components/SOL005_params.yaml#/components/parameters/Authorization post: description: | - The POST method instantiates an NS instance. + The POST method instantiates an NS instance. See clause 6.4.4.3.1. In case of the "feasibilityCheckReserve" attribute is present, the method runs the feasibility check procedure for an NS instantiation scheduled operation or runs the feasibility checking procedure followed by the execution of the subsequent (actual) NS instantiation operation. - This method shall follow the provisions specified in the tables 6.4.4.3.1-1 - and 6.4.4.3.1-2 for URI query parameters, request and response data - structures, and response codes. The steps and conditions that apply as the result of successfully executing this method are specified in clause 6.4.1.2. Before the NFVO initiates the "Instantiate NS" operation it shall verify @@ -298,15 +295,12 @@ paths: - $ref: ../components/SOL005_params.yaml#/components/parameters/Authorization post: description: | - The POST method updates an NS instance. + The POST method updates an NS instance. See clause 6.4.6.3.1. In case of the "feasibilityCheckReserve" attribute is present, the NFVO runs the feasibility check procedure for an NS updating scheduled operation or runs the feasibility checking procedure followed by the execution of the subsequent (actual) NS updating operation. - This method shall follow the provisions specified in the tables - 6.4.6.3.1-1 and 6.4.6.3.1-2 for URI query parameters, request - and response data structures, and response codes. The steps and conditions that apply as the result of successfully executing this method are specified in clause 6.4.1.2. If the "Update NS" operation involves adding a VNF instance, a @@ -2711,4 +2705,4 @@ components: style: simple explode: false schema: - type: string \ No newline at end of file + type: string diff --git a/src/SOL005/NSLifecycleManagement/definitions/SOL005NSLifecycleManagement_def.yaml b/src/SOL005/NSLifecycleManagement/definitions/SOL005NSLifecycleManagement_def.yaml index 34a3352..da7dc6f 100644 --- a/src/SOL005/NSLifecycleManagement/definitions/SOL005NSLifecycleManagement_def.yaml +++ b/src/SOL005/NSLifecycleManagement/definitions/SOL005NSLifecycleManagement_def.yaml @@ -1342,16 +1342,16 @@ definitions: type: boolean McioInfo: - description: - 'This type provides information about an MCIO representing the set of VNFC instances realized by one or a set of + description: > + This type provides information about an MCIO representing the set of VNFC instances realized by one or a set of OS containers which have been created based on the same VDU. - NOTE 1 The type of MCIO as specified in the declarative descriptor of the MCIO, and that can be read from the CISM. - EXAMPLE: In case of MCIOs managed by Kubernetes, the type of MCIO corresponds to the “kind” property of the declarative descriptor. - NOTE 2 If the attribute additionalInfo is present, it may contain runtime information on the actual and desired state of the MCIO(s). - NOTE 3 When the container infrastructure service is a Kubernetes® instance, the mcioId is the combined values from the kind - and name fields of the Kubernetes® resource object, separated by a slash. Example: "Deployment/abcd". - NOTE 4 When the container infrastructure service is a Kubernetes® instance, the mcioName is the name field of the resource object.' + NOTE 1: The type of MCIO as specified in the declarative descriptor of the MCIO, and that can be read from the CISM. + EXAMPLE 1: In case of MCIOs managed by Kubernetes, the type of MCIO corresponds to the “kind” property of the declarative descriptor. + NOTE 2: If the attribute additionalInfo is present, it may contain runtime information on the actual and desired state of the MCIO(s). + NOTE 3: When the container infrastructure service is a Kubernetes® instance, the mcioId is the combined values from the kind and name fields of the Kubernetes® resource object, separated by a slash. + EXAMPLE 2: "Deployment/abcd". + NOTE 4: When the container infrastructure service is a Kubernetes® instance, the mcioName is the name field of the resource object. type: object required: - mcioId @@ -3405,6 +3405,7 @@ definitions: type: object required: - vnfProfileId + - locationConstraints properties: vnfProfileId: description: > @@ -3416,7 +3417,7 @@ definitions: Defines the location constraints for the VNF instance to be created based on the VNF profile. - See note 1 and 2. + See notes 1 and 2. $ref: "#/definitions/LocationConstraints" vnfConstituentLocationConstraints: description: > @@ -7574,8 +7575,8 @@ definitions: ChangeVnfPackageData: description: | - This type specifies the information needed to change the current VNF package for a VNF instance. Clause B.3 of the - ETSI GS NFV-IFA 007 illustrates the variants of changes to the current VNF Package and information flow procedures. + This type specifies the information needed to change the current VNF package for a VNF instance. + Clause B.3 of ETSI GS NFV-IFA 007 illustrates the variants of changes to the current VNF Package and information flow procedures. This operation encompasses the following scenarios: * Changes of the VNF virtualised resources, such as requirements, composition and structure between the VNF versions, without changing the VNF software version. diff --git a/src/SOL005/NSLifecycleManagementNotification/NSLifecycleManagementNotification.yaml b/src/SOL005/NSLifecycleManagementNotification/NSLifecycleManagementNotification.yaml index e03ca97..a42dbe0 100644 --- a/src/SOL005/NSLifecycleManagementNotification/NSLifecycleManagementNotification.yaml +++ b/src/SOL005/NSLifecycleManagementNotification/NSLifecycleManagementNotification.yaml @@ -29,7 +29,7 @@ paths: parameters: - $ref: ../components/SOL005_params.yaml#/components/parameters/Version - $ref: ../components/SOL005_params.yaml#/components/parameters/Authorization - get: + post: description: | 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. @@ -54,7 +54,7 @@ paths: "503": $ref: ../responses/SOL005_resp.yaml#/components/responses/503 - post: + get: description: | The GET method allows the API producer to test the notification endpoint that is provided by the API consumer, e.g. during subscription. See clause 6.4.18.3.2. @@ -574,4 +574,4 @@ components: explode: false schema: type: string - content: {} \ No newline at end of file + content: {} diff --git a/src/SOL005/NSPerformanceManagement/NSPerformanceManagement.yaml b/src/SOL005/NSPerformanceManagement/NSPerformanceManagement.yaml index 80177e5..9381719 100644 --- a/src/SOL005/NSPerformanceManagement/NSPerformanceManagement.yaml +++ b/src/SOL005/NSPerformanceManagement/NSPerformanceManagement.yaml @@ -37,7 +37,7 @@ paths: # PM Jobs # ############################################################################### /pm_jobs: - #ETSI GS NFV-SOL 005 V2.4.1 location: 7.4.2 + #ETSI GS NFV-SOL 005 V5.2.1 location: 7.4.2 parameters: - $ref: ../components/SOL005_params.yaml#/components/parameters/Authorization - $ref: ../components/SOL005_params.yaml#/components/parameters/Version @@ -124,7 +124,7 @@ paths: # Individual PM job # ############################################################################### /pm_jobs/{pmJobId}: - #ETSI GS NFV-SOL 005 V2.4.1 location: 7.4.3 + #ETSI GS NFV-SOL 005 V5.2.1 location: 7.4.3 parameters: - $ref: '#/components/parameters/PmJobId' - $ref: ../components/SOL005_params.yaml#/components/parameters/Authorization @@ -213,7 +213,7 @@ paths: # Individual performance report # ############################################################################### /pm_jobs/{pmJobId}/reports/{reportId}: - #ETSI GS NFV-SOL 005 V2.4.1 location: 7.4.4 + #ETSI GS NFV-SOL 005 V5.2.1 location: 7.4.4 parameters: - $ref: '#/components/parameters/PmJobId' - $ref: '#/components/parameters/ReportId' @@ -250,7 +250,7 @@ paths: # Thresholds # ############################################################################### /thresholds: - #ETSI GS NFV-SOL 005 V2.4.1 location: 7.4.5 + #ETSI GS NFV-SOL 005 V5.2.1 location: 7.4.5 parameters: - $ref: ../components/SOL005_params.yaml#/components/parameters/Authorization - $ref: ../components/SOL005_params.yaml#/components/parameters/Version @@ -325,7 +325,7 @@ paths: # Individual threshold # ############################################################################### /thresholds/{thresholdId}: - #ETSI GS NFV-SOL 005 V2.4.1 location: 7.4.6 + #ETSI GS NFV-SOL 005 V5.2.1 location: 7.4.6 parameters: - $ref: '#/components/parameters/ThresholdId' - $ref: ../components/SOL005_params.yaml#/components/parameters/Authorization @@ -1502,4 +1502,4 @@ components: style: simple explode: false schema: - type: string \ No newline at end of file + type: string diff --git a/src/SOL005/VNFPackageManagement/VNFPackageManagement.yaml b/src/SOL005/VNFPackageManagement/VNFPackageManagement.yaml index 5f87af1..12aa3ea 100644 --- a/src/SOL005/VNFPackageManagement/VNFPackageManagement.yaml +++ b/src/SOL005/VNFPackageManagement/VNFPackageManagement.yaml @@ -300,7 +300,7 @@ paths: put: description: | The PUT method provides the access configuration information for the NFVO to download the content of external - VNF package artifacts. See clause 9.4.4a.3.4. + VNF package artifacts. See clause 9.4.4a.3.3. parameters: - $ref: ../components/SOL005_params.yaml#/components/parameters/ContentType requestBody: @@ -417,10 +417,7 @@ paths: put: description: | - The PUT method uploads the content of a VNF package. - This method shall follow the provisions specified in the tables 9.4.5.3.3-1 - and 9.4.5.3.3-2 for URI query parameters, request and response data structures, - and response codes. + The PUT method uploads the content of a VNF package. See clause 9.4.5.3.3. Upon start of the upload of the package, the NFVO shall set the "onboardingState" attribute in the "VnfPkgInfo" structure to "UPLOADING". Upon successful upload of the package, if the package references external artifacts, the NFVO shall obtain @@ -619,7 +616,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. See clause 9.4.7.3.2. + It can be used e.g. for resynchronization after error situations. See clause 9.4.8.3.2. parameters: - $ref: ../components/SOL005_params.yaml#/components/parameters/Accept - in: query @@ -2195,4 +2192,4 @@ components: explode: false schema: type: string - content: {} \ No newline at end of file + content: {} -- GitLab From 0532a6af1947a95b8b9cc43a7369f8b16d7a6af2 Mon Sep 17 00:00:00 2001 From: Bertrand Souville Date: Wed, 16 Apr 2025 08:13:57 +0200 Subject: [PATCH 02/12] Incorporate approved CR SOL(25)088r1 --- .../SOL005NSLifecycleManagement_def.yaml | 49 +++++++++++++++++-- 1 file changed, 46 insertions(+), 3 deletions(-) diff --git a/src/SOL005/NSLifecycleManagement/definitions/SOL005NSLifecycleManagement_def.yaml b/src/SOL005/NSLifecycleManagement/definitions/SOL005NSLifecycleManagement_def.yaml index 34a3352..5c9041f 100644 --- a/src/SOL005/NSLifecycleManagement/definitions/SOL005NSLifecycleManagement_def.yaml +++ b/src/SOL005/NSLifecycleManagement/definitions/SOL005NSLifecycleManagement_def.yaml @@ -656,11 +656,10 @@ definitions: NsInstance: description: > - This type represents a response for Query NS operation. + This type represents an NS instance. It shall comply with the provisions defined in Table 6.5.2.10-1. NOTE 1: Void. - "vnfInstance" attribute or one "nestedNsInstanceId" attribute shall be present. NOTE 2: The “priority” attribute of the NS instance is configured in the NSD in the NsDf structure. The mapping from application-specific priority values to a value in the NsDf is under OSS/BSS responsibility. The "zero" value expresses the highest priority and the fact that the NS instance based on this DF cannot be @@ -669,6 +668,16 @@ definitions: NOTE 4: Information about PaaS Services assigned to VNF instances shall only be included in the corresponding VnfInstance (see clause 6.5.3.57) + NOTE 5: The recentNsLsmOperationLinks attribute does not provide a complete historical record of LCM changes that + a NS instance experienced during its lifecycle. The information in this attribute should not be used to + create a chronological order of events that cannot be inferred by looking only at the most recent operation + occurrences due to potential gaps in timeline. This is because there can be many possible combination of LCM + changes that a NS instance may have gone through between two operation occurrences recorded in the + recentNsLcmOperationLinks attribute. For example, there can be many scaling related LCM changes since an + individual NS instance has been instantiated until the most recent scaling operation occurrence linked in the + attribute. In another example, the most recent LCM operation occurrence related to instantiate NS operation + may be more recent than the one that caused the NS instance to be terminated last time, which prevents the + possibility to create a meaningful chronological timeline of NS LCM events. type: object required: - id @@ -883,7 +892,41 @@ definitions: instance resource (i.e. NS instance is in INSTANTIATED state). $ref: "../../definitions/SOL005_def.yaml#/definitions/Link" - + recentNsLcmOperationLinks: + description: > + Links to the most recent LCM operation occurrences related to this resource. See note 5. + type: object + properties: + recentNsLcmOperation: + description: > + Link to the most recent LCM operation occurrence of any type that has been triggered + on this NS instance, such as Instantiate, Scale, or Heal. + $ref: "../../definitions/SOL005_def.yaml#/definitions/Link" + recentNsLcmInstantiation: + description: > + Link to the most recent LCM operation occurrence of type "INSTANTIATE" that has been + triggered on this NS instance. + $ref: "../../definitions/SOL005_def.yaml#/definitions/Link" + recentNsLcmTerminate: + description: > + Link to the most recent LCM operation occurrence of type "TERMINATE" that has been + triggered on this NS instance. + $ref: "../../definitions/SOL005_def.yaml#/definitions/Link" + recentNsLcmUpdate: + description: > + Link to the most recent LCM operation occurrence of type "UPDATE" that has been + triggered on this NS instance. + $ref: "../../definitions/SOL005_def.yaml#/definitions/Link" + recentNsLcmScale: + description: > + Link to the most recent LCM operation occurrence of type "SCALE" that has been + triggered on this NS instance. + $ref: "../../definitions/SOL005_def.yaml#/definitions/Link" + recentNsLcmHeal: + description: > + Link to the most recent LCM operation occurrence of type "HEAL" that has been + triggered on this NS instance. + $ref: "../../definitions/SOL005_def.yaml#/definitions/Link" McioTypeName: description: -- GitLab From a89fa056375b49e39e508d4e8510f31bab93d1e4 Mon Sep 17 00:00:00 2001 From: Bertrand Souville Date: Wed, 21 May 2025 12:11:25 +0200 Subject: [PATCH 03/12] Align with SOL(25)171 --- .../SOL005NSLifecycleManagement_def.yaml | 88 ++++++++++++------- 1 file changed, 54 insertions(+), 34 deletions(-) diff --git a/src/SOL005/NSLifecycleManagement/definitions/SOL005NSLifecycleManagement_def.yaml b/src/SOL005/NSLifecycleManagement/definitions/SOL005NSLifecycleManagement_def.yaml index 34a3352..4795206 100644 --- a/src/SOL005/NSLifecycleManagement/definitions/SOL005NSLifecycleManagement_def.yaml +++ b/src/SOL005/NSLifecycleManagement/definitions/SOL005NSLifecycleManagement_def.yaml @@ -1848,15 +1848,16 @@ definitions: description: > This type represents information about an external CP of a VNF. It shall comply with the provisions defined in Table 6.5.3.70-1. - NOTE 1: The attributes attributes "associatedVnfcCpId", "associatedVipCpId", "associatedVirtualCpId" and - "associatedVnfVirtualLinkId" are mutually exclusive. Exactly one shall be present. - NOTE 2: An external CP instance is not associated to a link - port in the cases indicated for the “extLinkPorts” attribute in clause 6.5.3.26. - NOTE 3: Cardinality greater than 1 is only applicable for specific cases where more than one network - attachment definition resource is needed to fulfil the connectivity requirements of the external CP, - e.g. to build a link redundant mated pair in SR-IOV cases. - NOTE 4: When more than one "netAttDefResourceId" is indicated, all shall belong to the same namespace. - + * NOTE 1: The attributes attributes "associatedVnfcCpId", "associatedVipCpId", "associatedVirtualCpId" and + "associatedVnfVirtualLinkId" are mutually exclusive. Exactly one shall be present. + * NOTE 2: An external CP instance is not associated to a link + port in the cases indicated for the “extLinkPorts” attribute in clause 6.5.3.26. + * NOTE 3: Cardinality greater than 1 is only applicable for specific cases where more than one network + attachment definition resource is needed to fulfil the connectivity requirements of the external CP, + e.g. to build a link redundant mated pair in SR-IOV cases. + * NOTE 4: When more than one "netAttDefResourceId" is indicated, all shall belong to the same namespace. + * Editor's Note: Specification of CpSecurityGroupInfo data type is FFS due to dependency on SOL001/ + descriptor work. type: object required: - id @@ -1955,6 +1956,10 @@ definitions: type: array items: $ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier" + cpSecurityGroupInfo: + description: > + List of active security group rules applied to this external CP instance. The attribute identifies which + "SecurityGroupRule" specified in the VNFD are activated and the values of its attributes. CpGroupInfo: description: > @@ -7203,32 +7208,35 @@ definitions: shall use the network attachment definition resource of secondary container cluster network when connecting the CP to the external VL. - NOTE 1: The following conditions apply to the attributes "linkPortId" and "cpProtocolData" - for an external CP instance connected or to be connected to a virtual network not - categorized as secondary container cluster network: - - At least one of the "linkPortId" and "cpProtocolData" attributes shall be present for - an external CP instance representing a subport that is to be created, or an external CP instance - that is to be created by creating the corresponding VNFC or VNF instance during the current or - a subsequent LCM operation, or for an existing external CP instance that is to be re-configured - or added to a particular external virtual link. - - If the "cpProtocolData" attribute is absent, the "linkPortId" attribute shall be provided - referencing a pre-created link port with pre-configured address information. - - If both "cpProtocolData" and "linkportId" are provided, the API consumer shall ensure that + * NOTE 1: The following conditions apply to the attributes "linkPortId" and "cpProtocolData" + for an external CP instance connected or to be connected to a virtual network not + categorized as secondary container cluster network: + - At least one of the "linkPortId" and "cpProtocolData" attributes shall be present for + an external CP instance representing a subport that is to be created, or an external CP instance + that is to be created by creating the corresponding VNFC or VNF instance during the current or + a subsequent LCM operation, or for an existing external CP instance that is to be re-configured + or added to a particular external virtual link. + - If the "cpProtocolData" attribute is absent, the "linkPortId" attribute shall be provided + referencing a pre-created link port with pre-configured address information. + - If both "cpProtocolData" and "linkportId" are provided, the API consumer shall ensure that the cpProtocolData can be used with the pre-created link port referenced by "linkPortId". - NOTE 2: In case the NFVO manages its own identifier space, the NFVO may remap this identifier - when communicating with the VNFM. If the NFVO knows that there can be an identifier collision - when communicating with the VNFM by using the identifier from the OSS/BSS, the NFVO shall remap it. - NOTE 3: The following conditions apply to the attributes "netAttDefResourceId" and "cpProtocolData" for an external CP - instance connected or to be connected to a secondary container cluster network: - − Void. - − At least one of these attributes shall be present for a to-be-created external CP instance or an existing - external CP instance. - NOTE 4: Cardinality greater than 1 is only applicable for specific cases where more than one network - attachment definition resource is needed to fulfil the connectivity requirements of the external CP, - e.g. to build a link redundant mated pair in SR-IOV cases. When more than one "netAttDefResourceId" - is indicated, all shall belong to the same namespace as defined by the corresponding - "containerNamespace" attribute in the "resourceHandle" attribute in the "NetAttDefResourceData". - NOTE 5: Either "linkPortId" or "netAttDefResourceId" may be included, but not both. + * NOTE 2: In case the NFVO manages its own identifier space, the NFVO may remap this identifier + when communicating with the VNFM. If the NFVO knows that there can be an identifier collision + when communicating with the VNFM by using the identifier from the OSS/BSS, the NFVO shall remap it. + * NOTE 3: The following conditions apply to the attributes "netAttDefResourceId" and "cpProtocolData" for an external CP + instance connected or to be connected to a secondary container cluster network: + − Void. + − At least one of these attributes shall be present for a to-be-created external CP instance or an existing + external CP instance. + * NOTE 4: Cardinality greater than 1 is only applicable for specific cases where more than one network + attachment definition resource is needed to fulfil the connectivity requirements of the external CP, + e.g. to build a link redundant mated pair in SR-IOV cases. When more than one "netAttDefResourceId" + is indicated, all shall belong to the same namespace as defined by the corresponding + "containerNamespace" attribute in the "resourceHandle" attribute in the "NetAttDefResourceData". + * NOTE 5: Either "linkPortId" or "netAttDefResourceId" may be included, but not both. + * Editor's Note: Specification of CpSecurityGroupData data type is FFS + due to dependency on SOL001/descriptor work. + type: object oneOf: - required: @@ -7277,6 +7285,18 @@ definitions: type: array items: $ref: "#/definitions/IdentifierInVnf" + cpSecurityGroupData: + description: > + Parameters for modifying and overriding security groups + information bound to this CP. The parameters identify + which "SecurityGroupRule" specified in the VNFD is + activated/deactivated and for an activated security group + rule the values of attributes defined in the VNFD that can + be overridden such as "portRangeMin" and "portRangeMax". + If no security group configuration is provided for a given + "SecurityGroupRule" specified in the VNFD as part of this + attribute, the VNFM will use the configuration as specified + in the VNFD. IdentifierInNs: description: > -- GitLab From 3d147cbbf5760f05e20f54258458a99334278938 Mon Sep 17 00:00:00 2001 From: Bertrand Souville Date: Wed, 21 May 2025 21:24:36 +0200 Subject: [PATCH 04/12] Need to create openAPI representation for FEAT29 CR related to VNF power management --- .../SOL005NSLifecycleManagement_def.yaml | 61 ++++++++++++++++--- 1 file changed, 53 insertions(+), 8 deletions(-) diff --git a/src/SOL005/NSLifecycleManagement/definitions/SOL005NSLifecycleManagement_def.yaml b/src/SOL005/NSLifecycleManagement/definitions/SOL005NSLifecycleManagement_def.yaml index 34a3352..a24b4c5 100644 --- a/src/SOL005/NSLifecycleManagement/definitions/SOL005NSLifecycleManagement_def.yaml +++ b/src/SOL005/NSLifecycleManagement/definitions/SOL005NSLifecycleManagement_def.yaml @@ -1061,6 +1061,12 @@ definitions: description: > State of the VNF instance. $ref: "#/definitions/VnfOperationalStateType" + vnfPowerState: + description: > + The power state of the VNF instance. Only present if the VNF instance is in a power + state or a scale status (refer to attribute "scaLeStatus" that has an associated + power profile, as defined in the VNFD. + $ref: "#/definitions/VnfPowerStateInfo" scaleStatus: description: > Scale status of the VNF, one entry per aspect. Represents for every scaling aspect how "big" @@ -1439,6 +1445,31 @@ definitions: enum: - STARTED - STOPPED + VnfPowerStateInfo: + description: > + This type represents information about the power state of a VNF instance. + Editor's Note: Specification of VnfPowerConsumptionInfo data type is FFS pending + on PowerProfile work in SOL001. + type: object + required: + - powerProfileId + - name + properties: + powerProfileId: + description: > + Identifier of the power profile, as defined in the VNFD, applied to the VNF instance. + $ref: "../../definitions/SOL005_def.yaml#/definitions/IdentifierInVnfd" + name: + description: > + Name of the power profile as provided in the VNFD + type: string + powerConsumptionInfo: + description: > + Estimated power consumption information of the resources associated + with this power profile, as provided in the VNFD. VNFM exposes and + can use this information to control the VNF instance to operate according + to the power profile and selected power state, e.g., monitoring actual energy + or power consumption of the VNF instance and compare against the estimated one. VnfScaleInfo: required: @@ -3643,7 +3674,8 @@ definitions: $ref: "#/definitions/ScaleNsData" scaleVnfData: description: > - The necessary information to scale the referenced NS instance. + The necessary information to scale or to change to a power profile + a given VNF instance that is part of the referenced NS instance. It shall be present when scaleType = SCALE_VNF. See note. type: array @@ -6153,20 +6185,27 @@ definitions: description: > This type describes the information used to scale a VNF instance to a target size. The target size is either expressed as an instantiation level of that DF as defined in the VNFD, or given as a list of scale levels, one per scaling aspect of that - DF. Instantiation levels and scaling aspects are declared in the VNFD. The NFVO shall then invoke the - ScaleVnfToLevel operation towards the appropriate VNFM. + DF. Instantiation levels and scaling aspects are declared in the VNFD. + This type also describes the information needed to scale an instantiated VNF of a particular DF to a power profile for + the VNF instance. This can be done either by referring to a defined instantiation level or list of scale levels defined in + the VNFD (see above) that have an associated power profile or to a specified power profile in the VNFD. + The NFVO shall then invoke the ScaleVnfToLevel operation towards the appropriate VNFM. - NOTE 1: Either the vnfInstantiationLevelId attribute or the vnfScaleInfo attribute shall be included. - NOTE 2: If the referenced instantiationLevel or the scaleInfo attribute contain information related to VNFCs that are not - going to be instantiated due to the selection of deployable modules, when passed to the VNFM, the information - is stored in the VNFM for later use and included in the instantiatedVnfInfo, as described in clause 5.5.2.6 of - ETSI GS NFV-SOL 003. + NOTE 1: Either the vnfInstantiationLevelId attribute or the vnfScaleInfo or the vnfPowerProfileId attribute shall be + included, but not multiple of them. + NOTE 2: If the referenced instantiationLevel, the scaleInfo or the vnfPowerProfileId attribute contain information related + to VNFCs that are not going to be instantiated due to the selection of deployable modules, when passed to the VNFM, + the information is stored in the VNFM for later use and included in the instantiatedVnfInfo, as described in + clause 5.5.2.6 of ETSI GS NFV-SOL 003. + Editor's Note: Pending on PowerProfile work in SOL001. type: object anyOf: - required: - vnfInstantiationLevelId - required: - vnfScaleInfo + - required: + - vnfPowerProfileId properties: vnfInstantiationLevelId: description: > @@ -6181,6 +6220,12 @@ definitions: type: array items: $ref: "#/definitions/VnfScaleInfo" + vnfPowerProfileId: + description: > + Identifier of the target power profile in the current DF, as defined in the VNFD, + from which the target power state can be selected and be switched to. + See notes 1 and 2. + $ref: "../../definitions/SOL005_def.yaml#/definitions/IdentifierInVnfd" additionalParams: description: > Additional parameters passed by the NFVO as input to -- GitLab From cadd883b6fb0212c927d7f0a1e9e8934d2c46eb8 Mon Sep 17 00:00:00 2001 From: Bertrand Souville Date: Wed, 25 Jun 2025 15:33:30 +0200 Subject: [PATCH 05/12] Need to align with SOL(25)199 --- src/SOL005/APIVersion/APIVersion.yaml | 4 ++-- .../NFVICapacityInformation/NFVICapacityInformation.yaml | 4 ++-- .../NFVICapacityInformationNotification.yaml | 4 ++-- src/SOL005/NSDManagement/NSDManagement.yaml | 4 ++-- .../NSDManagementNotification.yaml | 4 ++-- src/SOL005/NSFaultManagement/NSFaultManagement.yaml | 4 ++-- .../NSFaultManagementNotification.yaml | 4 ++-- src/SOL005/NSLCMCoordination/NSLCMCoordination.yaml | 4 ++-- src/SOL005/NSLifecycleManagement/NSLifecycleManagement.yaml | 6 +++--- .../NSLifecycleManagementNotification.yaml | 6 +++--- .../NSPerformanceManagement/NSPerformanceManagement.yaml | 4 ++-- .../NSPerformanceManagementNotification.yaml | 4 ++-- src/SOL005/VNFPackageManagement/VNFPackageManagement.yaml | 4 ++-- .../VNFPackageManagementNotification.yaml | 4 ++-- .../VNFSnapshotPackageManagement.yaml | 4 ++-- 15 files changed, 32 insertions(+), 32 deletions(-) diff --git a/src/SOL005/APIVersion/APIVersion.yaml b/src/SOL005/APIVersion/APIVersion.yaml index 9475b1e..6818779 100644 --- a/src/SOL005/APIVersion/APIVersion.yaml +++ b/src/SOL005/APIVersion/APIVersion.yaml @@ -19,8 +19,8 @@ info: version: 1.10.0-impl:etsi.org:ETSI_NFV_OpenAPI:1 externalDocs: - description: ETSI GS NFV-SOL 005 V5.2.1 - url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/005/05.02.01_60/gs_nfv-sol005v050201p.pdf + description: ETSI GS NFV-SOL 005 V5.3.1 + url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/005/05.03.01_60/gs_nfv-sol005v050301p.pdf servers: - url: http://127.0.0.1/ diff --git a/src/SOL005/NFVICapacityInformation/NFVICapacityInformation.yaml b/src/SOL005/NFVICapacityInformation/NFVICapacityInformation.yaml index e64f5e2..359b79f 100644 --- a/src/SOL005/NFVICapacityInformation/NFVICapacityInformation.yaml +++ b/src/SOL005/NFVICapacityInformation/NFVICapacityInformation.yaml @@ -19,8 +19,8 @@ info: version: 1.13.0-impl:etsi.org:ETSI_NFV_OpenAPI:1 externalDocs: - description: ETSI GS NFV-SOL 005 V5.2.1 - url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/005/05.02.01_60/gs_nfv-sol005v050201p.pdf + description: ETSI GS NFV-SOL 005 V5.3.1 + url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/005/05.03.01_60/gs_nfv-sol005v050301p.pdf servers: - url: http://127.0.0.1/nfvici/v1 diff --git a/src/SOL005/NFVICapacityInformationNotification/NFVICapacityInformationNotification.yaml b/src/SOL005/NFVICapacityInformationNotification/NFVICapacityInformationNotification.yaml index 1b55e6c..72927ca 100644 --- a/src/SOL005/NFVICapacityInformationNotification/NFVICapacityInformationNotification.yaml +++ b/src/SOL005/NFVICapacityInformationNotification/NFVICapacityInformationNotification.yaml @@ -19,8 +19,8 @@ info: version: 1.13.0-impl:etsi.org:ETSI_NFV_OpenAPI:1 externalDocs: - description: ETSI GS NFV-SOL 005 V5.2.1 - url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/005/05.02.01_60/gs_nfv-sol005v050201p.pdf + description: ETSI GS NFV-SOL 005 V5.3.1 + url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/005/05.03.01_60/gs_nfv-sol005v050301p.pdf servers: - url: http://127.0.0.1/callback/v1 diff --git a/src/SOL005/NSDManagement/NSDManagement.yaml b/src/SOL005/NSDManagement/NSDManagement.yaml index 38a3b57..735aff1 100644 --- a/src/SOL005/NSDManagement/NSDManagement.yaml +++ b/src/SOL005/NSDManagement/NSDManagement.yaml @@ -19,8 +19,8 @@ info: version: 2.12.0-impl:etsi.org:ETSI_NFV_OpenAPI:1 externalDocs: - description: ETSI GS NFV-SOL 005 V5.2.1 - url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/005/05.02.01_60/gs_nfv-sol005v050201p.pdf + description: ETSI GS NFV-SOL 005 V5.3.1 + url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/005/05.03.01_60/gs_nfv-sol005v050301p.pdf servers: - url: http://127.0.0.1/nsd/v2 diff --git a/src/SOL005/NSDManagementNotification/NSDManagementNotification.yaml b/src/SOL005/NSDManagementNotification/NSDManagementNotification.yaml index 16d7462..0e1219e 100644 --- a/src/SOL005/NSDManagementNotification/NSDManagementNotification.yaml +++ b/src/SOL005/NSDManagementNotification/NSDManagementNotification.yaml @@ -19,8 +19,8 @@ info: version: 2.12.0-impl:etsi.org:ETSI_NFV_OpenAPI:1 externalDocs: - description: ETSI GS NFV-SOL 005 V5.2.1 - url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/005/05.02.01_60/gs_nfv-sol005v050201p.pdf + description: ETSI GS NFV-SOL 005 V5.3.1 + url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/005/05.03.01_60/gs_nfv-sol005v050301p.pdf servers: - url: http://127.0.0.1/callback/v2 diff --git a/src/SOL005/NSFaultManagement/NSFaultManagement.yaml b/src/SOL005/NSFaultManagement/NSFaultManagement.yaml index b1c8f5c..8bd24f2 100644 --- a/src/SOL005/NSFaultManagement/NSFaultManagement.yaml +++ b/src/SOL005/NSFaultManagement/NSFaultManagement.yaml @@ -19,8 +19,8 @@ info: version: 1.14.0-impl:etsi.org:ETSI_NFV_OpenAPI:1 externalDocs: - description: ETSI GS NFV-SOL 005 V5.2.1 - url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/005/05.02.01_60/gs_nfv-sol005v050201p.pdf + description: ETSI GS NFV-SOL 005 V5.3.1 + url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/005/05.03.01_60/gs_nfv-sol005v050301p.pdf servers: - url: http://127.0.0.1/nsfm/v1 diff --git a/src/SOL005/NSFaultManagementNotification/NSFaultManagementNotification.yaml b/src/SOL005/NSFaultManagementNotification/NSFaultManagementNotification.yaml index 6e14849..b498460 100644 --- a/src/SOL005/NSFaultManagementNotification/NSFaultManagementNotification.yaml +++ b/src/SOL005/NSFaultManagementNotification/NSFaultManagementNotification.yaml @@ -19,8 +19,8 @@ info: version: 1.14.0-impl:etsi.org:ETSI_NFV_OpenAPI:1 externalDocs: - description: ETSI GS NFV-SOL 005 V5.2.1 - url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/005/05.02.01_60/gs_nfv-sol005v050201p.pdf + description: ETSI GS NFV-SOL 005 V5.3.1 + url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/005/05.03.01_60/gs_nfv-sol005v050301p.pdf servers: - url: http://127.0.0.1/callback/v1 diff --git a/src/SOL005/NSLCMCoordination/NSLCMCoordination.yaml b/src/SOL005/NSLCMCoordination/NSLCMCoordination.yaml index 222428c..6116756 100644 --- a/src/SOL005/NSLCMCoordination/NSLCMCoordination.yaml +++ b/src/SOL005/NSLCMCoordination/NSLCMCoordination.yaml @@ -19,8 +19,8 @@ info: version: 1.12.0-impl:etsi.org:ETSI_NFV_OpenAPI:1 externalDocs: - description: ETSI GS NFV-SOL 005 V5.2.1 - url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/005/05.02.01_60/gs_nfv-sol005v050201p.pdf + description: ETSI GS NFV-SOL 005 V5.3.1 + url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/005/05.03.01_60/gs_nfv-sol005v050301p.pdf servers: - url: http://127.0.0.1/lcmcoord/v1 diff --git a/src/SOL005/NSLifecycleManagement/NSLifecycleManagement.yaml b/src/SOL005/NSLifecycleManagement/NSLifecycleManagement.yaml index d8865a6..c85dd9f 100644 --- a/src/SOL005/NSLifecycleManagement/NSLifecycleManagement.yaml +++ b/src/SOL005/NSLifecycleManagement/NSLifecycleManagement.yaml @@ -16,11 +16,11 @@ info: license: name: ETSI Forge copyright notice url: https://forge.etsi.org/etsi-forge-copyright-notice.txt - version: 2.15.0-impl:etsi.org:ETSI_NFV_OpenAPI:1 + version: 2.16.0-impl:etsi.org:ETSI_NFV_OpenAPI:1 externalDocs: - description: ETSI GS NFV-SOL 005 V5.2.1 - url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/005/05.02.01_60/gs_nfv-sol005v050201p.pdf + description: ETSI GS NFV-SOL 005 V5.3.1 + url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/005/05.03.01_60/gs_nfv-sol005v050301p.pdf servers: - url: http://127.0.0.1/nslcm/v2 diff --git a/src/SOL005/NSLifecycleManagementNotification/NSLifecycleManagementNotification.yaml b/src/SOL005/NSLifecycleManagementNotification/NSLifecycleManagementNotification.yaml index a42dbe0..b3a7284 100644 --- a/src/SOL005/NSLifecycleManagementNotification/NSLifecycleManagementNotification.yaml +++ b/src/SOL005/NSLifecycleManagementNotification/NSLifecycleManagementNotification.yaml @@ -14,11 +14,11 @@ info: license: name: ETSI Forge copyright notice url: https://forge.etsi.org/etsi-forge-copyright-notice.txt - version: 2.15.0-impl:etsi.org:ETSI_NFV_OpenAPI:1 + version: 2.16.0-impl:etsi.org:ETSI_NFV_OpenAPI:1 externalDocs: - description: ETSI GS NFV-SOL 005 V5.2.1 - url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/005/05.02.01_60/gs_nfv-sol005v050201p.pdf + description: ETSI GS NFV-SOL 005 V5.3.1 + url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/005/05.03.01_60/gs_nfv-sol005v050301p.pdf servers: - url: http://127.0.0.1/callback/v2 diff --git a/src/SOL005/NSPerformanceManagement/NSPerformanceManagement.yaml b/src/SOL005/NSPerformanceManagement/NSPerformanceManagement.yaml index 9381719..548b812 100644 --- a/src/SOL005/NSPerformanceManagement/NSPerformanceManagement.yaml +++ b/src/SOL005/NSPerformanceManagement/NSPerformanceManagement.yaml @@ -19,8 +19,8 @@ info: version: 2.13.0-impl:etsi.org:ETSI_NFV_OpenAPI:1 externalDocs: - description: ETSI GS NFV-SOL 005 V5.2.1 - url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/005/05.02.01_60/gs_nfv-sol005v050201p.pdf + description: ETSI GS NFV-SOL 005 V5.3.1 + url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/005/05.03.01_60/gs_nfv-sol005v050301p.pdf servers: - url: http://127.0.0.1/nspm/v2 diff --git a/src/SOL005/NSPerformanceManagementNotification/NSPerformanceManagementNotification.yaml b/src/SOL005/NSPerformanceManagementNotification/NSPerformanceManagementNotification.yaml index 5168566..919bfb1 100644 --- a/src/SOL005/NSPerformanceManagementNotification/NSPerformanceManagementNotification.yaml +++ b/src/SOL005/NSPerformanceManagementNotification/NSPerformanceManagementNotification.yaml @@ -19,8 +19,8 @@ info: version: 2.13.0-impl:etsi.org:ETSI_NFV_OpenAPI:1 externalDocs: - description: ETSI GS NFV-SOL 005 V5.2.1 - url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/005/05.02.01_60/gs_nfv-sol005v050201p.pdf + description: ETSI GS NFV-SOL 005 V5.3.1 + url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/005/05.03.01_60/gs_nfv-sol005v050301p.pdf servers: - url: http://127.0.0.1/callback/v2 diff --git a/src/SOL005/VNFPackageManagement/VNFPackageManagement.yaml b/src/SOL005/VNFPackageManagement/VNFPackageManagement.yaml index 12aa3ea..a70dbbb 100644 --- a/src/SOL005/VNFPackageManagement/VNFPackageManagement.yaml +++ b/src/SOL005/VNFPackageManagement/VNFPackageManagement.yaml @@ -19,8 +19,8 @@ info: version: 2.12.0-impl:etsi.org:ETSI_NFV_OpenAPI:1 externalDocs: - description: ETSI GS NFV-SOL 005 V5.2.1 - url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/005/05.02.01_60/gs_nfv-sol005v050201p.pdf + description: ETSI GS NFV-SOL 005 V5.3.1 + url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/005/05.03.01_60/gs_nfv-sol005v050301p.pdf servers: - url: http://127.0.0.1/vnfpkgm/v2 diff --git a/src/SOL005/VNFPackageManagementNotification/VNFPackageManagementNotification.yaml b/src/SOL005/VNFPackageManagementNotification/VNFPackageManagementNotification.yaml index 2124003..fb537d9 100644 --- a/src/SOL005/VNFPackageManagementNotification/VNFPackageManagementNotification.yaml +++ b/src/SOL005/VNFPackageManagementNotification/VNFPackageManagementNotification.yaml @@ -19,8 +19,8 @@ info: version: 2.12.0-impl:etsi.org:ETSI_NFV_OpenAPI:1 externalDocs: - description: ETSI GS NFV-SOL 005 V5.2.1 - url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/005/05.02.01_60/gs_nfv-sol005v050201p.pdf + description: ETSI GS NFV-SOL 005 V5.3.1 + url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/005/05.03.01_60/gs_nfv-sol005v050301p.pdf servers: - url: http://127.0.0.1/callback/v2 diff --git a/src/SOL005/VNFSnapshotPackageManagement/VNFSnapshotPackageManagement.yaml b/src/SOL005/VNFSnapshotPackageManagement/VNFSnapshotPackageManagement.yaml index 73394ec..fa44977 100644 --- a/src/SOL005/VNFSnapshotPackageManagement/VNFSnapshotPackageManagement.yaml +++ b/src/SOL005/VNFSnapshotPackageManagement/VNFSnapshotPackageManagement.yaml @@ -19,8 +19,8 @@ info: version: 1.12.0-impl:etsi.org:ETSI_NFV_OpenAPI:1 externalDocs: - description: ETSI GS NFV-SOL 005 V5.2.1 - url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/005/05.02.01_60/gs_nfv-sol005v050201p.pdf + description: ETSI GS NFV-SOL 005 V5.3.1 + url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/005/05.03.01_60/gs_nfv-sol005v050301p.pdf servers: - url: http://127.0.0.1/vnfsnapshotpkgm/v1 -- GitLab From 61ead453499ee7724f193f4c101e3389e3a0d56c Mon Sep 17 00:00:00 2001 From: Bertrand Souville Date: Mon, 30 Jun 2025 17:58:47 +0200 Subject: [PATCH 06/12] Need to align with SOL(2%)234r1 --- .../SOL005NSLifecycleManagement_def.yaml | 108 ++++++++++++++++-- 1 file changed, 101 insertions(+), 7 deletions(-) diff --git a/src/SOL005/NSLifecycleManagement/definitions/SOL005NSLifecycleManagement_def.yaml b/src/SOL005/NSLifecycleManagement/definitions/SOL005NSLifecycleManagement_def.yaml index 3062d49..9ff9340 100644 --- a/src/SOL005/NSLifecycleManagement/definitions/SOL005NSLifecycleManagement_def.yaml +++ b/src/SOL005/NSLifecycleManagement/definitions/SOL005NSLifecycleManagement_def.yaml @@ -1491,8 +1491,6 @@ definitions: VnfPowerStateInfo: description: > This type represents information about the power state of a VNF instance. - Editor's Note: Specification of VnfPowerConsumptionInfo data type is FFS pending - on PowerProfile work in SOL001. type: object required: - powerProfileId @@ -1513,6 +1511,30 @@ definitions: can use this information to control the VNF instance to operate according to the power profile and selected power state, e.g., monitoring actual energy or power consumption of the VNF instance and compare against the estimated one. + $ref: "#/definitions/VnfPowerConsumptionInfo" + + VnfPowerConsumptionInfo: + description: > + This type represents information about estimated power consumption of the resources + associated with the power profile, as provided in the VNFD. + type: object + required: + - minPowerConsumption + - maxPowerConsumption + - averagePowerConsumption + properties: + minPowerConsumption: + description: > + Minimum power consumption of this power profile. Unit is KW/h. + type: integer + maxPowerConsumption: + description: > + Maximum power consumption of this power profile. Unit is KW/h. + type: integer + averagePowerConsumption: + description: > + Average power consumption of this power profile. Unit is KW/h. + type: integer VnfScaleInfo: required: @@ -1930,8 +1952,6 @@ definitions: attachment definition resource is needed to fulfil the connectivity requirements of the external CP, e.g. to build a link redundant mated pair in SR-IOV cases. * NOTE 4: When more than one "netAttDefResourceId" is indicated, all shall belong to the same namespace. - * Editor's Note: Specification of CpSecurityGroupInfo data type is FFS due to dependency on SOL001/ - descriptor work. type: object required: - id @@ -2034,6 +2054,52 @@ definitions: description: > List of active security group rules applied to this external CP instance. The attribute identifies which "SecurityGroupRule" specified in the VNFD are activated and the values of its attributes. + $ref: "#/definitions/CpSecurityGroupInfo" + + CpSecurityGroupInfo: + description: > + This type provides the list of active security group rules applied to an external CP instance. + The type identifies which "SecurityGroupRule" specified in the VNFD are activated and the values + of its attributes. + type: object + required: + - securityGroupRuleId + - etherType + - protocol + - portRangeMin + - portRangeMax + properties: + securityGroupRuleId: + description: > + Identifier of the security group rule policy in the VNFD. + $ref: "../../definitions/SOL005_def.yaml#/definitions/IdentifierInVnfd" + description: + description: > + Human readable description of the security group rule. + type: string + etherType: + description: > + Indicates the protocol carried over the Ethernet layer. + Permitted values: IPV4, IPV6. + type: string + enum: + - IPV4 + - IPV6 + protocol: + description: > + Indicates the protocol carried over the IP layer. + Permitted values: any protocol defined in the IANA protocol + registry (refer to clause 9.10.1.2 ofd ETSI GS NFV-SOL 001 for further information). + type: string + portRangeMin: + description: > + Value for the minimum port number in the range that is matched by the security group rule. + type: integer + portRangeMax: + description: > + Value for the maximum port number in the range that is matched by the security group rule. + type: integer + CpGroupInfo: description: > @@ -6246,7 +6312,6 @@ definitions: to VNFCs that are not going to be instantiated due to the selection of deployable modules, when passed to the VNFM, the information is stored in the VNFM for later use and included in the instantiatedVnfInfo, as described in clause 5.5.2.6 of ETSI GS NFV-SOL 003. - Editor's Note: Pending on PowerProfile work in SOL001. type: object anyOf: - required: @@ -7323,8 +7388,6 @@ definitions: is indicated, all shall belong to the same namespace as defined by the corresponding "containerNamespace" attribute in the "resourceHandle" attribute in the "NetAttDefResourceData". * NOTE 5: Either "linkPortId" or "netAttDefResourceId" may be included, but not both. - * Editor's Note: Specification of CpSecurityGroupData data type is FFS - due to dependency on SOL001/descriptor work. type: object oneOf: @@ -7386,6 +7449,37 @@ definitions: "SecurityGroupRule" specified in the VNFD as part of this attribute, the VNFM will use the configuration as specified in the VNFD. + $ref: "#/definitions/CpSecurityGroupData" + + CpSecurityGroupData: + description: > + This type provides input parameters for modifying and overriding security groups. + The parameters identify which "SecurityGroupRule" specified in the VNFD is activated/deactivated + and for an activated security group rule the values of attributes defined in the VNFD that can be + overriden such as "portRangeMin" and "portRangeMax". + type: object + required: + - securityGroupRuleId + properties: + securityGroupRuleId: + description: > + Identifier of the security group rule policy in the VNFD. + $ref: "../../definitions/SOL005_def.yaml#/definitions/IdentifierInVnfd" + isActivated: + description: > + Indicates whether the rule is to be active (true) or inactive (false). If no attribute value + is provided, the Security Group Rule is activated by default. + type: boolean + portRangeMin: + description: > + Value for the minimum port number in the range that is matched by the security group rule. + The value shall be within the range "0 - 65535". + type: integer + portRangeMax: + description: > + Value for the maximum port number in the range that is matched by the security group rule. + The value shall be within the range "0 - 65535". + type: integer IdentifierInNs: description: > -- GitLab From 7d69bea569593cc715a571266244ab89e52988ae Mon Sep 17 00:00:00 2001 From: Bertrand Souville Date: Thu, 3 Jul 2025 09:33:39 +0200 Subject: [PATCH 07/12] Fix externalDocs info --- src/SOL005/APIVersion/APIVersion.yaml | 4 ++-- .../NFVICapacityInformation/NFVICapacityInformation.yaml | 4 ++-- .../NFVICapacityInformationNotification.yaml | 4 ++-- src/SOL005/NSDManagement/NSDManagement.yaml | 4 ++-- .../NSDManagementNotification/NSDManagementNotification.yaml | 4 ++-- src/SOL005/NSFaultManagement/NSFaultManagement.yaml | 4 ++-- .../NSFaultManagementNotification.yaml | 4 ++-- src/SOL005/NSLCMCoordination/NSLCMCoordination.yaml | 4 ++-- src/SOL005/NSLifecycleManagement/NSLifecycleManagement.yaml | 4 ++-- .../NSLifecycleManagementNotification.yaml | 4 ++-- .../NSPerformanceManagement/NSPerformanceManagement.yaml | 4 ++-- .../NSPerformanceManagementNotification.yaml | 4 ++-- src/SOL005/VNFPackageManagement/VNFPackageManagement.yaml | 4 ++-- .../VNFPackageManagementNotification.yaml | 4 ++-- .../VNFSnapshotPackageManagement.yaml | 4 ++-- 15 files changed, 30 insertions(+), 30 deletions(-) diff --git a/src/SOL005/APIVersion/APIVersion.yaml b/src/SOL005/APIVersion/APIVersion.yaml index 6818779..bbcd3c9 100644 --- a/src/SOL005/APIVersion/APIVersion.yaml +++ b/src/SOL005/APIVersion/APIVersion.yaml @@ -19,8 +19,8 @@ info: version: 1.10.0-impl:etsi.org:ETSI_NFV_OpenAPI:1 externalDocs: - description: ETSI GS NFV-SOL 005 V5.3.1 - url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/005/05.03.01_60/gs_nfv-sol005v050301p.pdf + description: ETSI GS NFV-SOL 005 Final Draft V5.2.4 + url: https://docbox.etsi.org/ISG/NFV/Open/Drafts/SOL005ed531/NFV-SOL005ed531v524.zip servers: - url: http://127.0.0.1/ diff --git a/src/SOL005/NFVICapacityInformation/NFVICapacityInformation.yaml b/src/SOL005/NFVICapacityInformation/NFVICapacityInformation.yaml index 359b79f..4e31548 100644 --- a/src/SOL005/NFVICapacityInformation/NFVICapacityInformation.yaml +++ b/src/SOL005/NFVICapacityInformation/NFVICapacityInformation.yaml @@ -19,8 +19,8 @@ info: version: 1.13.0-impl:etsi.org:ETSI_NFV_OpenAPI:1 externalDocs: - description: ETSI GS NFV-SOL 005 V5.3.1 - url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/005/05.03.01_60/gs_nfv-sol005v050301p.pdf + description: ETSI GS NFV-SOL 005 Final Draft V5.2.4 + url: https://docbox.etsi.org/ISG/NFV/Open/Drafts/SOL005ed531/NFV-SOL005ed531v524.zip servers: - url: http://127.0.0.1/nfvici/v1 diff --git a/src/SOL005/NFVICapacityInformationNotification/NFVICapacityInformationNotification.yaml b/src/SOL005/NFVICapacityInformationNotification/NFVICapacityInformationNotification.yaml index 72927ca..1035dbf 100644 --- a/src/SOL005/NFVICapacityInformationNotification/NFVICapacityInformationNotification.yaml +++ b/src/SOL005/NFVICapacityInformationNotification/NFVICapacityInformationNotification.yaml @@ -19,8 +19,8 @@ info: version: 1.13.0-impl:etsi.org:ETSI_NFV_OpenAPI:1 externalDocs: - description: ETSI GS NFV-SOL 005 V5.3.1 - url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/005/05.03.01_60/gs_nfv-sol005v050301p.pdf + description: ETSI GS NFV-SOL 005 Final Draft V5.2.4 + url: https://docbox.etsi.org/ISG/NFV/Open/Drafts/SOL005ed531/NFV-SOL005ed531v524.zip servers: - url: http://127.0.0.1/callback/v1 diff --git a/src/SOL005/NSDManagement/NSDManagement.yaml b/src/SOL005/NSDManagement/NSDManagement.yaml index 735aff1..d2eb82a 100644 --- a/src/SOL005/NSDManagement/NSDManagement.yaml +++ b/src/SOL005/NSDManagement/NSDManagement.yaml @@ -19,8 +19,8 @@ info: version: 2.12.0-impl:etsi.org:ETSI_NFV_OpenAPI:1 externalDocs: - description: ETSI GS NFV-SOL 005 V5.3.1 - url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/005/05.03.01_60/gs_nfv-sol005v050301p.pdf + description: ETSI GS NFV-SOL 005 Final Draft V5.2.4 + url: https://docbox.etsi.org/ISG/NFV/Open/Drafts/SOL005ed531/NFV-SOL005ed531v524.zip servers: - url: http://127.0.0.1/nsd/v2 diff --git a/src/SOL005/NSDManagementNotification/NSDManagementNotification.yaml b/src/SOL005/NSDManagementNotification/NSDManagementNotification.yaml index 0e1219e..29d2717 100644 --- a/src/SOL005/NSDManagementNotification/NSDManagementNotification.yaml +++ b/src/SOL005/NSDManagementNotification/NSDManagementNotification.yaml @@ -19,8 +19,8 @@ info: version: 2.12.0-impl:etsi.org:ETSI_NFV_OpenAPI:1 externalDocs: - description: ETSI GS NFV-SOL 005 V5.3.1 - url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/005/05.03.01_60/gs_nfv-sol005v050301p.pdf + description: ETSI GS NFV-SOL 005 Final Draft V5.2.4 + url: https://docbox.etsi.org/ISG/NFV/Open/Drafts/SOL005ed531/NFV-SOL005ed531v524.zip servers: - url: http://127.0.0.1/callback/v2 diff --git a/src/SOL005/NSFaultManagement/NSFaultManagement.yaml b/src/SOL005/NSFaultManagement/NSFaultManagement.yaml index 8bd24f2..f4f62b5 100644 --- a/src/SOL005/NSFaultManagement/NSFaultManagement.yaml +++ b/src/SOL005/NSFaultManagement/NSFaultManagement.yaml @@ -19,8 +19,8 @@ info: version: 1.14.0-impl:etsi.org:ETSI_NFV_OpenAPI:1 externalDocs: - description: ETSI GS NFV-SOL 005 V5.3.1 - url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/005/05.03.01_60/gs_nfv-sol005v050301p.pdf + description: ETSI GS NFV-SOL 005 Final Draft V5.2.4 + url: https://docbox.etsi.org/ISG/NFV/Open/Drafts/SOL005ed531/NFV-SOL005ed531v524.zip servers: - url: http://127.0.0.1/nsfm/v1 diff --git a/src/SOL005/NSFaultManagementNotification/NSFaultManagementNotification.yaml b/src/SOL005/NSFaultManagementNotification/NSFaultManagementNotification.yaml index b498460..15f5d2a 100644 --- a/src/SOL005/NSFaultManagementNotification/NSFaultManagementNotification.yaml +++ b/src/SOL005/NSFaultManagementNotification/NSFaultManagementNotification.yaml @@ -19,8 +19,8 @@ info: version: 1.14.0-impl:etsi.org:ETSI_NFV_OpenAPI:1 externalDocs: - description: ETSI GS NFV-SOL 005 V5.3.1 - url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/005/05.03.01_60/gs_nfv-sol005v050301p.pdf + description: ETSI GS NFV-SOL 005 Final Draft V5.2.4 + url: https://docbox.etsi.org/ISG/NFV/Open/Drafts/SOL005ed531/NFV-SOL005ed531v524.zip servers: - url: http://127.0.0.1/callback/v1 diff --git a/src/SOL005/NSLCMCoordination/NSLCMCoordination.yaml b/src/SOL005/NSLCMCoordination/NSLCMCoordination.yaml index 6116756..9b42aaa 100644 --- a/src/SOL005/NSLCMCoordination/NSLCMCoordination.yaml +++ b/src/SOL005/NSLCMCoordination/NSLCMCoordination.yaml @@ -19,8 +19,8 @@ info: version: 1.12.0-impl:etsi.org:ETSI_NFV_OpenAPI:1 externalDocs: - description: ETSI GS NFV-SOL 005 V5.3.1 - url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/005/05.03.01_60/gs_nfv-sol005v050301p.pdf + description: ETSI GS NFV-SOL 005 Final Draft V5.2.4 + url: https://docbox.etsi.org/ISG/NFV/Open/Drafts/SOL005ed531/NFV-SOL005ed531v524.zip servers: - url: http://127.0.0.1/lcmcoord/v1 diff --git a/src/SOL005/NSLifecycleManagement/NSLifecycleManagement.yaml b/src/SOL005/NSLifecycleManagement/NSLifecycleManagement.yaml index c85dd9f..096b8bf 100644 --- a/src/SOL005/NSLifecycleManagement/NSLifecycleManagement.yaml +++ b/src/SOL005/NSLifecycleManagement/NSLifecycleManagement.yaml @@ -19,8 +19,8 @@ info: version: 2.16.0-impl:etsi.org:ETSI_NFV_OpenAPI:1 externalDocs: - description: ETSI GS NFV-SOL 005 V5.3.1 - url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/005/05.03.01_60/gs_nfv-sol005v050301p.pdf + description: ETSI GS NFV-SOL 005 Final Draft V5.2.4 + url: https://docbox.etsi.org/ISG/NFV/Open/Drafts/SOL005ed531/NFV-SOL005ed531v524.zip servers: - url: http://127.0.0.1/nslcm/v2 diff --git a/src/SOL005/NSLifecycleManagementNotification/NSLifecycleManagementNotification.yaml b/src/SOL005/NSLifecycleManagementNotification/NSLifecycleManagementNotification.yaml index b3a7284..e3b1cde 100644 --- a/src/SOL005/NSLifecycleManagementNotification/NSLifecycleManagementNotification.yaml +++ b/src/SOL005/NSLifecycleManagementNotification/NSLifecycleManagementNotification.yaml @@ -17,8 +17,8 @@ info: version: 2.16.0-impl:etsi.org:ETSI_NFV_OpenAPI:1 externalDocs: - description: ETSI GS NFV-SOL 005 V5.3.1 - url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/005/05.03.01_60/gs_nfv-sol005v050301p.pdf + description: ETSI GS NFV-SOL 005 Final Draft V5.2.4 + url: https://docbox.etsi.org/ISG/NFV/Open/Drafts/SOL005ed531/NFV-SOL005ed531v524.zip servers: - url: http://127.0.0.1/callback/v2 diff --git a/src/SOL005/NSPerformanceManagement/NSPerformanceManagement.yaml b/src/SOL005/NSPerformanceManagement/NSPerformanceManagement.yaml index 548b812..d7b0217 100644 --- a/src/SOL005/NSPerformanceManagement/NSPerformanceManagement.yaml +++ b/src/SOL005/NSPerformanceManagement/NSPerformanceManagement.yaml @@ -19,8 +19,8 @@ info: version: 2.13.0-impl:etsi.org:ETSI_NFV_OpenAPI:1 externalDocs: - description: ETSI GS NFV-SOL 005 V5.3.1 - url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/005/05.03.01_60/gs_nfv-sol005v050301p.pdf + description: ETSI GS NFV-SOL 005 Final Draft V5.2.4 + url: https://docbox.etsi.org/ISG/NFV/Open/Drafts/SOL005ed531/NFV-SOL005ed531v524.zip servers: - url: http://127.0.0.1/nspm/v2 diff --git a/src/SOL005/NSPerformanceManagementNotification/NSPerformanceManagementNotification.yaml b/src/SOL005/NSPerformanceManagementNotification/NSPerformanceManagementNotification.yaml index 919bfb1..e25ea0a 100644 --- a/src/SOL005/NSPerformanceManagementNotification/NSPerformanceManagementNotification.yaml +++ b/src/SOL005/NSPerformanceManagementNotification/NSPerformanceManagementNotification.yaml @@ -19,8 +19,8 @@ info: version: 2.13.0-impl:etsi.org:ETSI_NFV_OpenAPI:1 externalDocs: - description: ETSI GS NFV-SOL 005 V5.3.1 - url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/005/05.03.01_60/gs_nfv-sol005v050301p.pdf + description: ETSI GS NFV-SOL 005 Final Draft V5.2.4 + url: https://docbox.etsi.org/ISG/NFV/Open/Drafts/SOL005ed531/NFV-SOL005ed531v524.zip servers: - url: http://127.0.0.1/callback/v2 diff --git a/src/SOL005/VNFPackageManagement/VNFPackageManagement.yaml b/src/SOL005/VNFPackageManagement/VNFPackageManagement.yaml index a70dbbb..41dc931 100644 --- a/src/SOL005/VNFPackageManagement/VNFPackageManagement.yaml +++ b/src/SOL005/VNFPackageManagement/VNFPackageManagement.yaml @@ -19,8 +19,8 @@ info: version: 2.12.0-impl:etsi.org:ETSI_NFV_OpenAPI:1 externalDocs: - description: ETSI GS NFV-SOL 005 V5.3.1 - url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/005/05.03.01_60/gs_nfv-sol005v050301p.pdf + description: ETSI GS NFV-SOL 005 Final Draft V5.2.4 + url: https://docbox.etsi.org/ISG/NFV/Open/Drafts/SOL005ed531/NFV-SOL005ed531v524.zip servers: - url: http://127.0.0.1/vnfpkgm/v2 diff --git a/src/SOL005/VNFPackageManagementNotification/VNFPackageManagementNotification.yaml b/src/SOL005/VNFPackageManagementNotification/VNFPackageManagementNotification.yaml index fb537d9..0454d59 100644 --- a/src/SOL005/VNFPackageManagementNotification/VNFPackageManagementNotification.yaml +++ b/src/SOL005/VNFPackageManagementNotification/VNFPackageManagementNotification.yaml @@ -19,8 +19,8 @@ info: version: 2.12.0-impl:etsi.org:ETSI_NFV_OpenAPI:1 externalDocs: - description: ETSI GS NFV-SOL 005 V5.3.1 - url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/005/05.03.01_60/gs_nfv-sol005v050301p.pdf + description: ETSI GS NFV-SOL 005 Final Draft V5.2.4 + url: https://docbox.etsi.org/ISG/NFV/Open/Drafts/SOL005ed531/NFV-SOL005ed531v524.zip servers: - url: http://127.0.0.1/callback/v2 diff --git a/src/SOL005/VNFSnapshotPackageManagement/VNFSnapshotPackageManagement.yaml b/src/SOL005/VNFSnapshotPackageManagement/VNFSnapshotPackageManagement.yaml index fa44977..f45d2bd 100644 --- a/src/SOL005/VNFSnapshotPackageManagement/VNFSnapshotPackageManagement.yaml +++ b/src/SOL005/VNFSnapshotPackageManagement/VNFSnapshotPackageManagement.yaml @@ -19,8 +19,8 @@ info: version: 1.12.0-impl:etsi.org:ETSI_NFV_OpenAPI:1 externalDocs: - description: ETSI GS NFV-SOL 005 V5.3.1 - url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/005/05.03.01_60/gs_nfv-sol005v050301p.pdf + description: ETSI GS NFV-SOL 005 Final Draft V5.2.4 + url: https://docbox.etsi.org/ISG/NFV/Open/Drafts/SOL005ed531/NFV-SOL005ed531v524.zip servers: - url: http://127.0.0.1/vnfsnapshotpkgm/v1 -- GitLab From 8e561d9cf1f38eae3abe433e0d0412eda551260b Mon Sep 17 00:00:00 2001 From: Muhammad Hamza Date: Wed, 9 Jul 2025 15:49:02 +0200 Subject: [PATCH 08/12] fix issue #40: fix description of href attribute in Link definition in v5.3.1 --- src/SOL005/definitions/SOL005_def.yaml | 6 ++---- 1 file changed, 2 insertions(+), 4 deletions(-) diff --git a/src/SOL005/definitions/SOL005_def.yaml b/src/SOL005/definitions/SOL005_def.yaml index 0e15042..20381b3 100644 --- a/src/SOL005/definitions/SOL005_def.yaml +++ b/src/SOL005/definitions/SOL005_def.yaml @@ -139,10 +139,8 @@ definitions: properties: href: description: > - URI of a resource referenced from a notification. - Should be an absolute URI (i.e. a URI that contains {apiRoot}), - however, may be a relative URI (i.e. a URI where the {apiRoot} part is omitted) - if the {apiRoot} information is not available. + URI of another resource referenced from a resource. Shall be an absolute URI (i.e. a URI that + contains {apiRoot}). type: string format: url -- GitLab From fac832d03bb0dab4acf4259217db6595ba3c6ea5 Mon Sep 17 00:00:00 2001 From: Muhammad Hamza Date: Wed, 9 Jul 2025 16:13:20 +0200 Subject: [PATCH 09/12] fix SubscriptionAuthentication data model in SOL005_def.yaml in v5.3.1 --- src/SOL005/definitions/SOL005_def.yaml | 125 +++++++++++++++++-------- 1 file changed, 85 insertions(+), 40 deletions(-) diff --git a/src/SOL005/definitions/SOL005_def.yaml b/src/SOL005/definitions/SOL005_def.yaml index 20381b3..9a23688 100644 --- a/src/SOL005/definitions/SOL005_def.yaml +++ b/src/SOL005/definitions/SOL005_def.yaml @@ -410,6 +410,19 @@ definitions: $ref: "#/definitions/DateTime" SubscriptionAuthentication: + description: > + * NOTE 1 : The clientId and clientPassword passed in a subscription shall not be the same as the clientId and + clientPassword that are used to obtain authorization for API requests. Client credentials may differ between + subscriptions. The value of clientPassword should be generated by a random process. + * NOTE 2: As a less secure alternative to OAUTH2_CLIENT_CERT which uses mutual authentication based on X.509 + certificates, this mode which uses client password to authenticate may be used in the access token request + toward the authorization server (as defined by IETF RFC 6749 [7]), only to support legacy implementations + (version 3.4.1 or earlier version of the present document). See clause 8.1 for more details. + * NOTE 3: The following values that were included up to version 3.4.1 of the present document have been removed: + "BASIC" (to signal the use of the basic HTTP authentication) has been removed because it is insecure. + "TLS_CERT" to signal an alternative non-token based authorization method using TLS certificates has been + removed because the method is no longer supported. + * NOTE 4: The client certificate is established by means outside the scope of the present document. type: object required: - authType @@ -418,71 +431,103 @@ definitions: description: > Defines the types of Authentication / Authorization which the API consumer is willing to accept when receiving a notification. - Permitted values: - - BASIC: In every HTTP request to the notification endpoint, use - HTTP Basic authentication with the client credentials. - - OAUTH2_CLIENT_CREDENTIALS: In every HTTP request to the - notification endpoint, use an OAuth 2.0 Bearer token, obtained - using the client credentials grant type. - - TLS_CERT: Every HTTP request to the notification endpoint is sent - over a mutually authenticated TLS session, i.e. not only the - server is authenticated, but also the client is authenticated - during the TLS tunnel setup. + Permitted values (see note 3): + * OAUTH2_CLIENT_CREDENTIALS: In every + HTTP request to the notification endpoint, use + an OAuth 2.0 token, obtained using the client + credentials grant type after authenticating + using client identifier and client password + towards the token endpoint. + * OAUTH2_CLIENT_CERT: In every HTTP + request to the notification endpoint, use an + OAuth 2.0 token, obtained using the client + credentials grant type after mutually + authenticating using client identifier and X.509 + certificates towards the token endpoint. type: array items: type: string enum: - - BASIC - OAUTH2_CLIENT_CREDENTIALS - - TLS_CERT - paramsBasic: + - OAUTH2_CLIENT_CERT + paramsOauth2ClientCert: description: > - Parameters for authentication/authorization using BASIC. - Shall be present if authType is "BASIC" and the contained - information has not been provisioned out of band. + Parameters for authentication/authorization using + OAUTH2_CLIENT_CERT. + + Shall be present if authType is "OAUTH2_CLIENT_CERT" and the contained + information has not been provisioned out of band. + Shall be absent otherwise. type: object + required: + - clientId + - certificateRef + - tokenEndpoint properties: - userName: + clientId: description: > - Username to be used in HTTP Basic authentication. Shall be - present if it has not been provisioned out of band. + Client identifier to be used in the access token request + of the OAuth 2.0 client credentials grant type. The client + identifier is unique in the scope of the tokenEndpoint. type: string - password: + certificateRef: description: > - Password to be used in HTTP Basic authentication. Shall be - present if it has not been provisioned out of band. + Fingerprint of the client certificate. The hash function + shall use SHA256 or higher. See note 4. type: string + required: + - type + - value + properties: + type: + description: > + The type of the fingerprint. + Permitted values: + - x5t#S256: The SHA-256 thumbprint of the + X.509 certificate as defined in section 4.1.8 of + IETF RFC 7515 [23]. + $ref: "#/definitions/String" + enum: + - x5t#S256 + value: + description: > + The fingerprint value as defined by the type. + $ref: "#/definitions/String" + tokenEndpoint: + description: > + The token endpoint from which the access token can be + obtained. + $ref: "#/definitions/Uri" paramsOauth2ClientCredentials: description: > Parameters for authentication/authorization using OAUTH2_CLIENT_CREDENTIALS. - Shall be present if authType is "OAUTH2_CLIENT_CREDENTIALS" and the - contained information has not been provisioned out of band. + + Shall be present if authType is + "OAUTH2_CLIENT_CREDENTIALS" and the contained + information has not been provisioned out of band. + Shall be absent otherwise. + + See note 2. type: object properties: clientId: description: > - Client identifier to be used in the access token request of the - OAuth 2.0 client credentials grant type. - Shall be present if it has not been provisioned out of band. - The clientId and clientPassword passed in a subscription shall - not be the same as the clientId and clientPassword that are used - to obtain authorization for API requests. Client credentials may - differ between subscriptions. The value of clientPassword should - be generated by a random process. + Client identifier to be used in the access token request + of the OAuth 2.0 client credentials grant type. The client + identifier is unique in the scope of the tokenEndpoint. + Shall be present if it has not been provisioned out of + band. + See note 1. type: string clientPassword: description: > - Client password to be used in the access token request of the - OAuth 2.0 client credentials grant type. - Shall be present if it has not been provisioned out of band. - The clientId and clientPassword passed in a subscription shall - not be the same as the clientId and clientPassword that are used - to obtain authorization for API requests. Client credentials may - differ between subscriptions. The value of clientPassword should - be generated by a random process. + Client password to be used in the access token request + of the OAuth 2.0 client credentials grant type. Shall be + present if it has not been provisioned out of band. See + note 1. type: string tokenEndpoint: description: > -- GitLab From 625169180b9d0378d41f5c7f8c0738341686ee1a Mon Sep 17 00:00:00 2001 From: Bertrand Souville Date: Fri, 11 Jul 2025 11:33:36 +0200 Subject: [PATCH 10/12] Fix issue #41 for Release 5 drop 3. --- .../definitions/SOL005NSLifecycleManagement_def.yaml | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/src/SOL005/NSLifecycleManagement/definitions/SOL005NSLifecycleManagement_def.yaml b/src/SOL005/NSLifecycleManagement/definitions/SOL005NSLifecycleManagement_def.yaml index 9ff9340..594cc1f 100644 --- a/src/SOL005/NSLifecycleManagement/definitions/SOL005NSLifecycleManagement_def.yaml +++ b/src/SOL005/NSLifecycleManagement/definitions/SOL005NSLifecycleManagement_def.yaml @@ -1956,6 +1956,7 @@ definitions: required: - id - cpdId + - cpConfigId - cpProtocolInfo oneOf: - required: @@ -1979,7 +1980,7 @@ definitions: description: > Identifier that references the applied "VnfExtCpConfig" entry in the "cpConfig" map of the "currentVnfExtCpData" in the "ExtVirtualLinkInfo" structure. - $ref: "../../definitions/SOL005_def.yaml#/definitions/IdentifierInVnfd" + $ref: "#/definitions/IdentifierInVnf" vnfdId: description: > Identifier of the VNFD. -- GitLab From f861bac354b16807f6db9f574413a17f0f63c435 Mon Sep 17 00:00:00 2001 From: Muhammad Hamza Date: Mon, 4 Aug 2025 14:30:21 +0200 Subject: [PATCH 11/12] remove error code 416 from SOL005 5.3.1 --- .../NSFaultManagement/NSFaultManagement.yaml | 6 ---- .../NSLCMCoordination/NSLCMCoordination.yaml | 6 ---- .../NSLifecycleManagement.yaml | 30 ------------------- .../VNFPackageManagement.yaml | 6 ---- .../VNFSnapshotPackageManagement.yaml | 24 --------------- src/SOL005/endpoints/SOL005_endpoints.yaml | 2 -- 6 files changed, 74 deletions(-) diff --git a/src/SOL005/NSFaultManagement/NSFaultManagement.yaml b/src/SOL005/NSFaultManagement/NSFaultManagement.yaml index f4f62b5..a72e062 100644 --- a/src/SOL005/NSFaultManagement/NSFaultManagement.yaml +++ b/src/SOL005/NSFaultManagement/NSFaultManagement.yaml @@ -73,8 +73,6 @@ paths: $ref: ../responses/SOL005_resp.yaml#/components/responses/405 "406": $ref: ../responses/SOL005_resp.yaml#/components/responses/406 - "416": - $ref: ../responses/SOL005_resp.yaml#/components/responses/416 "500": $ref: ../responses/SOL005_resp.yaml#/components/responses/500 "503": @@ -107,8 +105,6 @@ paths: $ref: ../responses/SOL005_resp.yaml#/components/responses/405 "406": $ref: ../responses/SOL005_resp.yaml#/components/responses/406 - "416": - $ref: ../responses/SOL005_resp.yaml#/components/responses/416 "500": $ref: ../responses/SOL005_resp.yaml#/components/responses/500 "503": @@ -143,8 +139,6 @@ paths: $ref: '#/components/responses/IndividualAlarm.Patch.409' "412": $ref: '#/components/responses/IndividualAlarm.Patch.412' - "416": - $ref: ../responses/SOL005_resp.yaml#/components/responses/416 "500": $ref: ../responses/SOL005_resp.yaml#/components/responses/500 "503": diff --git a/src/SOL005/NSLCMCoordination/NSLCMCoordination.yaml b/src/SOL005/NSLCMCoordination/NSLCMCoordination.yaml index 9b42aaa..c14a98c 100644 --- a/src/SOL005/NSLCMCoordination/NSLCMCoordination.yaml +++ b/src/SOL005/NSLCMCoordination/NSLCMCoordination.yaml @@ -63,8 +63,6 @@ paths: $ref: ../responses/SOL005_resp.yaml#/components/responses/406 409: $ref: ../responses/SOL005_resp.yaml#/components/responses/409 - 416: - $ref: ../responses/SOL005_resp.yaml#/components/responses/416 500: $ref: ../responses/SOL005_resp.yaml#/components/responses/500 503: @@ -96,8 +94,6 @@ paths: $ref: ../responses/SOL005_resp.yaml#/components/responses/405 406: $ref: ../responses/SOL005_resp.yaml#/components/responses/406 - 416: - $ref: ../responses/SOL005_resp.yaml#/components/responses/416 500: $ref: ../responses/SOL005_resp.yaml#/components/responses/500 503: @@ -131,8 +127,6 @@ paths: $ref: ../responses/SOL005_resp.yaml#/components/responses/406 409: $ref: ../responses/SOL005_resp.yaml#/components/responses/409 - 416: - $ref: ../responses/SOL005_resp.yaml#/components/responses/416 500: $ref: ../responses/SOL005_resp.yaml#/components/responses/500 503: diff --git a/src/SOL005/NSLifecycleManagement/NSLifecycleManagement.yaml b/src/SOL005/NSLifecycleManagement/NSLifecycleManagement.yaml index 096b8bf..1ad3745 100644 --- a/src/SOL005/NSLifecycleManagement/NSLifecycleManagement.yaml +++ b/src/SOL005/NSLifecycleManagement/NSLifecycleManagement.yaml @@ -88,8 +88,6 @@ paths: $ref: ../responses/SOL005_resp.yaml#/components/responses/406 "409": $ref: ../responses/SOL005_resp.yaml#/components/responses/409 - "416": - $ref: ../responses/SOL005_resp.yaml#/components/responses/416 "500": $ref: ../responses/SOL005_resp.yaml#/components/responses/500 "503": @@ -122,8 +120,6 @@ paths: $ref: ../responses/SOL005_resp.yaml#/components/responses/406 "409": $ref: ../responses/SOL005_resp.yaml#/components/responses/409 - "416": - $ref: ../responses/SOL005_resp.yaml#/components/responses/416 "500": $ref: ../responses/SOL005_resp.yaml#/components/responses/500 "503": @@ -158,8 +154,6 @@ paths: $ref: ../responses/SOL005_resp.yaml#/components/responses/405 "406": $ref: ../responses/SOL005_resp.yaml#/components/responses/406 - "416": - $ref: ../responses/SOL005_resp.yaml#/components/responses/416 "500": $ref: ../responses/SOL005_resp.yaml#/components/responses/500 "503": @@ -240,8 +234,6 @@ paths: $ref: ../responses/SOL005_resp.yaml#/components/responses/406 "409": $ref: '#/components/responses/InstantiateNsInstance.Post.409' - "416": - $ref: ../responses/SOL005_resp.yaml#/components/responses/416 "500": $ref: ../responses/SOL005_resp.yaml#/components/responses/500 "503": @@ -279,8 +271,6 @@ paths: $ref: ../responses/SOL005_resp.yaml#/components/responses/406 "409": $ref: '#/components/responses/ScaleNsInstance.Post.409' - "416": - $ref: ../responses/SOL005_resp.yaml#/components/responses/416 "500": $ref: ../responses/SOL005_resp.yaml#/components/responses/500 "503": @@ -338,8 +328,6 @@ paths: $ref: ../responses/SOL005_resp.yaml#/components/responses/406 "409": $ref: '#/components/responses/UpdateNsInstance.Post.409' - "416": - $ref: ../responses/SOL005_resp.yaml#/components/responses/416 "500": $ref: ../responses/SOL005_resp.yaml#/components/responses/500 "503": @@ -377,8 +365,6 @@ paths: $ref: ../responses/SOL005_resp.yaml#/components/responses/406 "409": $ref: '#/components/responses/HealNsInstance.Post.409' - "416": - $ref: ../responses/SOL005_resp.yaml#/components/responses/416 "500": $ref: ../responses/SOL005_resp.yaml#/components/responses/500 "503": @@ -416,8 +402,6 @@ paths: $ref: ../responses/SOL005_resp.yaml#/components/responses/406 "409": $ref: '#/components/responses/TerminateNsInstance.Post.409' - "416": - $ref: ../responses/SOL005_resp.yaml#/components/responses/416 "500": $ref: ../responses/SOL005_resp.yaml#/components/responses/500 "503": @@ -512,8 +496,6 @@ paths: $ref: ../responses/SOL005_resp.yaml#/components/responses/405 "406": $ref: ../responses/SOL005_resp.yaml#/components/responses/406 - "416": - $ref: ../responses/SOL005_resp.yaml#/components/responses/416 "500": $ref: ../responses/SOL005_resp.yaml#/components/responses/500 "503": @@ -547,8 +529,6 @@ paths: "412": $ref: ../responses/SOL005_resp.yaml#/components/responses/412 description: Shall be returned upon the following error A precondition given in an HTTP request header is not fulfilled. - "416": - $ref: ../responses/SOL005_resp.yaml#/components/responses/416 "500": $ref: ../responses/SOL005_resp.yaml#/components/responses/500 "503": @@ -583,8 +563,6 @@ paths: $ref: ../responses/SOL005_resp.yaml#/components/responses/406 "409": $ref: '#/components/responses/NsLcmOpOccRetry.Post.409' - "416": - $ref: ../responses/SOL005_resp.yaml#/components/responses/416 "500": $ref: ../responses/SOL005_resp.yaml#/components/responses/500 "503": @@ -618,8 +596,6 @@ paths: $ref: ../responses/SOL005_resp.yaml#/components/responses/406 "409": $ref: '#/components/responses/NsLcmOpOccRollback.Post.409' - "416": - $ref: ../responses/SOL005_resp.yaml#/components/responses/416 "500": $ref: ../responses/SOL005_resp.yaml#/components/responses/500 "503": @@ -653,8 +629,6 @@ paths: $ref: ../responses/SOL005_resp.yaml#/components/responses/406 "409": $ref: '#/components/responses/NsLcmOpOccContinue.Post.409' - "416": - $ref: ../responses/SOL005_resp.yaml#/components/responses/416 "500": $ref: ../responses/SOL005_resp.yaml#/components/responses/500 "503": @@ -690,8 +664,6 @@ paths: $ref: ../responses/SOL005_resp.yaml#/components/responses/406 "409": $ref: '#/components/responses/NsLcmOpOccFail.Post.409' - "416": - $ref: ../responses/SOL005_resp.yaml#/components/responses/416 "500": $ref: ../responses/SOL005_resp.yaml#/components/responses/500 "503": @@ -731,8 +703,6 @@ paths: $ref: ../responses/SOL005_resp.yaml#/components/responses/406 "409": $ref: '#/components/responses/NsLcmOpOccCancel.Post.409' - "416": - $ref: ../responses/SOL005_resp.yaml#/components/responses/416 "500": $ref: ../responses/SOL005_resp.yaml#/components/responses/500 "503": diff --git a/src/SOL005/VNFPackageManagement/VNFPackageManagement.yaml b/src/SOL005/VNFPackageManagement/VNFPackageManagement.yaml index 41dc931..365a6ab 100644 --- a/src/SOL005/VNFPackageManagement/VNFPackageManagement.yaml +++ b/src/SOL005/VNFPackageManagement/VNFPackageManagement.yaml @@ -115,8 +115,6 @@ paths: $ref: ../responses/SOL005_resp.yaml#/components/responses/406 "409": $ref: ../responses/SOL005_resp.yaml#/components/responses/409 - "416": - $ref: ../responses/SOL005_resp.yaml#/components/responses/416 "500": $ref: ../responses/SOL005_resp.yaml#/components/responses/500 "503": @@ -455,8 +453,6 @@ paths: $ref: ../responses/SOL005_resp.yaml#/components/responses/406 "409": $ref: '#/components/responses/IndividualVnfPackageContent.Put.409' - "416": - $ref: ../responses/SOL005_resp.yaml#/components/responses/416 "500": $ref: ../responses/SOL005_resp.yaml#/components/responses/500 "503": @@ -549,8 +545,6 @@ paths: $ref: ../responses/SOL005_resp.yaml#/components/responses/406 "409": $ref: '#/components/responses/IndividualVnfPackageUploadFromUri.Post.409' - "416": - $ref: ../responses/SOL005_resp.yaml#/components/responses/416 "500": $ref: ../responses/SOL005_resp.yaml#/components/responses/500 "503": diff --git a/src/SOL005/VNFSnapshotPackageManagement/VNFSnapshotPackageManagement.yaml b/src/SOL005/VNFSnapshotPackageManagement/VNFSnapshotPackageManagement.yaml index f45d2bd..f2ff9bc 100644 --- a/src/SOL005/VNFSnapshotPackageManagement/VNFSnapshotPackageManagement.yaml +++ b/src/SOL005/VNFSnapshotPackageManagement/VNFSnapshotPackageManagement.yaml @@ -62,8 +62,6 @@ paths: $ref: ../responses/SOL005_resp.yaml#/components/responses/406 409: $ref: ../responses/SOL005_resp.yaml#/components/responses/409 - 416: - $ref: ../responses/SOL005_resp.yaml#/components/responses/416 500: $ref: ../responses/SOL005_resp.yaml#/components/responses/500 503: @@ -118,8 +116,6 @@ paths: $ref: ../responses/SOL005_resp.yaml#/components/responses/405 406: $ref: ../responses/SOL005_resp.yaml#/components/responses/406 - 416: - $ref: ../responses/SOL005_resp.yaml#/components/responses/416 422: $ref: ../responses/SOL005_resp.yaml#/components/responses/422 429: @@ -157,8 +153,6 @@ paths: $ref: ../responses/SOL005_resp.yaml#/components/responses/405 406: $ref: ../responses/SOL005_resp.yaml#/components/responses/406 - 416: - $ref: ../responses/SOL005_resp.yaml#/components/responses/416 422: $ref: ../responses/SOL005_resp.yaml#/components/responses/422 429: @@ -195,8 +189,6 @@ paths: $ref: ../responses/SOL005_resp.yaml#/components/responses/406 409: $ref: '#/components/responses/IndividualVNFSnapshotPackage.Patch.409' - 416: - $ref: ../responses/SOL005_resp.yaml#/components/responses/416 500: $ref: ../responses/SOL005_resp.yaml#/components/responses/500 503: @@ -224,8 +216,6 @@ paths: $ref: ../responses/SOL005_resp.yaml#/components/responses/406 409: $ref: '#/components/responses/IndividualVNFSnapshotPackage.Delete.409' - 416: - $ref: ../responses/SOL005_resp.yaml#/components/responses/416 500: $ref: ../responses/SOL005_resp.yaml#/components/responses/500 503: @@ -298,8 +288,6 @@ paths: $ref: ../responses/SOL005_resp.yaml#/components/responses/406 409: $ref: '#/components/responses/VnfSnapshotPackageContent.Put.409' - 416: - $ref: ../responses/SOL005_resp.yaml#/components/responses/416 422: $ref: ../responses/SOL005_resp.yaml#/components/responses/422 429: @@ -341,8 +329,6 @@ paths: $ref: ../responses/SOL005_resp.yaml#/components/responses/406 409: $ref: '#/components/responses/UploadFromUri.Post.409' - 416: - $ref: ../responses/SOL005_resp.yaml#/components/responses/416 500: $ref: ../responses/SOL005_resp.yaml#/components/responses/500 503: @@ -380,8 +366,6 @@ paths: $ref: ../responses/SOL005_resp.yaml#/components/responses/406 409: $ref: '#/components/responses/BuildVnfSnapshotPkg.Post.409' - 416: - $ref: ../responses/SOL005_resp.yaml#/components/responses/416 500: $ref: ../responses/SOL005_resp.yaml#/components/responses/500 503: @@ -419,8 +403,6 @@ paths: $ref: ../responses/SOL005_resp.yaml#/components/responses/406 409: $ref: '#/components/responses/ExtractVnfSnapshotPkg.Post.409' - 416: - $ref: ../responses/SOL005_resp.yaml#/components/responses/416 500: $ref: ../responses/SOL005_resp.yaml#/components/responses/500 503: @@ -458,8 +440,6 @@ paths: $ref: ../responses/SOL005_resp.yaml#/components/responses/406 409: $ref: '#/components/responses/CancelVnfSnapshotPkg.Post.409' - 416: - $ref: ../responses/SOL005_resp.yaml#/components/responses/416 500: $ref: ../responses/SOL005_resp.yaml#/components/responses/500 503: @@ -495,8 +475,6 @@ paths: $ref: ../responses/SOL005_resp.yaml#/components/responses/406 409: $ref: ../responses/SOL005_resp.yaml#/components/responses/409 - 416: - $ref: ../responses/SOL005_resp.yaml#/components/responses/416 422: $ref: ../responses/SOL005_resp.yaml#/components/responses/422 429: @@ -533,8 +511,6 @@ paths: $ref: ../responses/SOL005_resp.yaml#/components/responses/406 409: $ref: '#/components/responses/ExternalArtifactsAccess.Put.409' - 416: - $ref: ../responses/SOL005_resp.yaml#/components/responses/416 422: $ref: ../responses/SOL005_resp.yaml#/components/responses/422 429: diff --git a/src/SOL005/endpoints/SOL005_endpoints.yaml b/src/SOL005/endpoints/SOL005_endpoints.yaml index 7ae8dce..b1fda63 100644 --- a/src/SOL005/endpoints/SOL005_endpoints.yaml +++ b/src/SOL005/endpoints/SOL005_endpoints.yaml @@ -25,8 +25,6 @@ endpoints: $ref: ../responses/SOL005_resp.yaml#/components/responses/413 "414": $ref: ../responses/SOL005_resp.yaml#/components/responses/414 - "416": - $ref: ../responses/SOL005_resp.yaml#/components/responses/416 "422": $ref: ../responses/SOL005_resp.yaml#/components/responses/422 "429": -- GitLab From 150ce0609a0f506fe58c7b6ce84e916e3971bb5e Mon Sep 17 00:00:00 2001 From: Bertrand Souville Date: Mon, 25 Aug 2025 10:25:20 +0200 Subject: [PATCH 12/12] Need to update Readme and refs to v5.3.1 --- Readme.md | 2 +- src/SOL005/APIVersion/APIVersion.yaml | 4 ++-- .../NFVICapacityInformation/NFVICapacityInformation.yaml | 4 ++-- .../NFVICapacityInformationNotification.yaml | 4 ++-- src/SOL005/NSDManagement/NSDManagement.yaml | 4 ++-- .../NSDManagementNotification/NSDManagementNotification.yaml | 4 ++-- src/SOL005/NSFaultManagement/NSFaultManagement.yaml | 5 ++--- .../NSFaultManagementNotification.yaml | 4 ++-- src/SOL005/NSLCMCoordination/NSLCMCoordination.yaml | 4 ++-- src/SOL005/NSLifecycleManagement/NSLifecycleManagement.yaml | 4 ++-- .../NSLifecycleManagementNotification.yaml | 4 ++-- .../NSPerformanceManagement/NSPerformanceManagement.yaml | 4 ++-- .../NSPerformanceManagementNotification.yaml | 4 ++-- src/SOL005/VNFPackageManagement/VNFPackageManagement.yaml | 4 ++-- .../VNFPackageManagementNotification.yaml | 4 ++-- .../VNFSnapshotPackageManagement.yaml | 4 ++-- 16 files changed, 31 insertions(+), 32 deletions(-) diff --git a/Readme.md b/Readme.md index ab2f149..bfad97c 100644 --- a/Readme.md +++ b/Readme.md @@ -1,7 +1,7 @@ # NFV SOL005 APIs This repository hosts the [OpenAPI](https://www.openapis.org/) specificatons and other documentation -for the APIs defined in ETSI NFV GSs SOL005 v5.2.1. +for the APIs defined in ETSI NFV GSs SOL005 v5.3.1. The APIs described in this repository are defined for the `Os-Ma-nfvo` reference point. diff --git a/src/SOL005/APIVersion/APIVersion.yaml b/src/SOL005/APIVersion/APIVersion.yaml index bbcd3c9..5b36938 100644 --- a/src/SOL005/APIVersion/APIVersion.yaml +++ b/src/SOL005/APIVersion/APIVersion.yaml @@ -19,8 +19,8 @@ info: version: 1.10.0-impl:etsi.org:ETSI_NFV_OpenAPI:1 externalDocs: - description: ETSI GS NFV-SOL 005 Final Draft V5.2.4 - url: https://docbox.etsi.org/ISG/NFV/Open/Drafts/SOL005ed531/NFV-SOL005ed531v524.zip + description: ETSI GS NFV-SOL 005 V5.3.1 + url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/005/05.03.01_60/gs_NFV-SOL005v050301p.pdf servers: - url: http://127.0.0.1/ diff --git a/src/SOL005/NFVICapacityInformation/NFVICapacityInformation.yaml b/src/SOL005/NFVICapacityInformation/NFVICapacityInformation.yaml index 4e31548..581b6c2 100644 --- a/src/SOL005/NFVICapacityInformation/NFVICapacityInformation.yaml +++ b/src/SOL005/NFVICapacityInformation/NFVICapacityInformation.yaml @@ -19,8 +19,8 @@ info: version: 1.13.0-impl:etsi.org:ETSI_NFV_OpenAPI:1 externalDocs: - description: ETSI GS NFV-SOL 005 Final Draft V5.2.4 - url: https://docbox.etsi.org/ISG/NFV/Open/Drafts/SOL005ed531/NFV-SOL005ed531v524.zip + description: ETSI GS NFV-SOL 005 V5.3.1 + url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/005/05.03.01_60/gs_NFV-SOL005v050301p.pdf servers: - url: http://127.0.0.1/nfvici/v1 diff --git a/src/SOL005/NFVICapacityInformationNotification/NFVICapacityInformationNotification.yaml b/src/SOL005/NFVICapacityInformationNotification/NFVICapacityInformationNotification.yaml index 1035dbf..47a9cc3 100644 --- a/src/SOL005/NFVICapacityInformationNotification/NFVICapacityInformationNotification.yaml +++ b/src/SOL005/NFVICapacityInformationNotification/NFVICapacityInformationNotification.yaml @@ -19,8 +19,8 @@ info: version: 1.13.0-impl:etsi.org:ETSI_NFV_OpenAPI:1 externalDocs: - description: ETSI GS NFV-SOL 005 Final Draft V5.2.4 - url: https://docbox.etsi.org/ISG/NFV/Open/Drafts/SOL005ed531/NFV-SOL005ed531v524.zip + description: ETSI GS NFV-SOL 005 V5.3.1 + url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/005/05.03.01_60/gs_NFV-SOL005v050301p.pdf servers: - url: http://127.0.0.1/callback/v1 diff --git a/src/SOL005/NSDManagement/NSDManagement.yaml b/src/SOL005/NSDManagement/NSDManagement.yaml index d2eb82a..ef084c9 100644 --- a/src/SOL005/NSDManagement/NSDManagement.yaml +++ b/src/SOL005/NSDManagement/NSDManagement.yaml @@ -19,8 +19,8 @@ info: version: 2.12.0-impl:etsi.org:ETSI_NFV_OpenAPI:1 externalDocs: - description: ETSI GS NFV-SOL 005 Final Draft V5.2.4 - url: https://docbox.etsi.org/ISG/NFV/Open/Drafts/SOL005ed531/NFV-SOL005ed531v524.zip + description: ETSI GS NFV-SOL 005 V5.3.1 + url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/005/05.03.01_60/gs_NFV-SOL005v050301p.pdf servers: - url: http://127.0.0.1/nsd/v2 diff --git a/src/SOL005/NSDManagementNotification/NSDManagementNotification.yaml b/src/SOL005/NSDManagementNotification/NSDManagementNotification.yaml index 29d2717..1f5bfc9 100644 --- a/src/SOL005/NSDManagementNotification/NSDManagementNotification.yaml +++ b/src/SOL005/NSDManagementNotification/NSDManagementNotification.yaml @@ -19,8 +19,8 @@ info: version: 2.12.0-impl:etsi.org:ETSI_NFV_OpenAPI:1 externalDocs: - description: ETSI GS NFV-SOL 005 Final Draft V5.2.4 - url: https://docbox.etsi.org/ISG/NFV/Open/Drafts/SOL005ed531/NFV-SOL005ed531v524.zip + description: ETSI GS NFV-SOL 005 V5.3.1 + url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/005/05.03.01_60/gs_NFV-SOL005v050301p.pdf servers: - url: http://127.0.0.1/callback/v2 diff --git a/src/SOL005/NSFaultManagement/NSFaultManagement.yaml b/src/SOL005/NSFaultManagement/NSFaultManagement.yaml index f4f62b5..8edeb01 100644 --- a/src/SOL005/NSFaultManagement/NSFaultManagement.yaml +++ b/src/SOL005/NSFaultManagement/NSFaultManagement.yaml @@ -19,9 +19,8 @@ info: version: 1.14.0-impl:etsi.org:ETSI_NFV_OpenAPI:1 externalDocs: - description: ETSI GS NFV-SOL 005 Final Draft V5.2.4 - url: https://docbox.etsi.org/ISG/NFV/Open/Drafts/SOL005ed531/NFV-SOL005ed531v524.zip - + description: ETSI GS NFV-SOL 005 V5.3.1 + url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/005/05.03.01_60/gs_NFV-SOL005v050301p.pdf servers: - url: http://127.0.0.1/nsfm/v1 - url: https://127.0.0.1/nsfm/v1 diff --git a/src/SOL005/NSFaultManagementNotification/NSFaultManagementNotification.yaml b/src/SOL005/NSFaultManagementNotification/NSFaultManagementNotification.yaml index 15f5d2a..6652c4c 100644 --- a/src/SOL005/NSFaultManagementNotification/NSFaultManagementNotification.yaml +++ b/src/SOL005/NSFaultManagementNotification/NSFaultManagementNotification.yaml @@ -19,8 +19,8 @@ info: version: 1.14.0-impl:etsi.org:ETSI_NFV_OpenAPI:1 externalDocs: - description: ETSI GS NFV-SOL 005 Final Draft V5.2.4 - url: https://docbox.etsi.org/ISG/NFV/Open/Drafts/SOL005ed531/NFV-SOL005ed531v524.zip + description: ETSI GS NFV-SOL 005 V5.3.1 + url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/005/05.03.01_60/gs_NFV-SOL005v050301p.pdf servers: - url: http://127.0.0.1/callback/v1 diff --git a/src/SOL005/NSLCMCoordination/NSLCMCoordination.yaml b/src/SOL005/NSLCMCoordination/NSLCMCoordination.yaml index 9b42aaa..94c4e90 100644 --- a/src/SOL005/NSLCMCoordination/NSLCMCoordination.yaml +++ b/src/SOL005/NSLCMCoordination/NSLCMCoordination.yaml @@ -19,8 +19,8 @@ info: version: 1.12.0-impl:etsi.org:ETSI_NFV_OpenAPI:1 externalDocs: - description: ETSI GS NFV-SOL 005 Final Draft V5.2.4 - url: https://docbox.etsi.org/ISG/NFV/Open/Drafts/SOL005ed531/NFV-SOL005ed531v524.zip + description: ETSI GS NFV-SOL 005 V5.3.1 + url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/005/05.03.01_60/gs_NFV-SOL005v050301p.pdf servers: - url: http://127.0.0.1/lcmcoord/v1 diff --git a/src/SOL005/NSLifecycleManagement/NSLifecycleManagement.yaml b/src/SOL005/NSLifecycleManagement/NSLifecycleManagement.yaml index 096b8bf..55b8155 100644 --- a/src/SOL005/NSLifecycleManagement/NSLifecycleManagement.yaml +++ b/src/SOL005/NSLifecycleManagement/NSLifecycleManagement.yaml @@ -19,8 +19,8 @@ info: version: 2.16.0-impl:etsi.org:ETSI_NFV_OpenAPI:1 externalDocs: - description: ETSI GS NFV-SOL 005 Final Draft V5.2.4 - url: https://docbox.etsi.org/ISG/NFV/Open/Drafts/SOL005ed531/NFV-SOL005ed531v524.zip + description: ETSI GS NFV-SOL 005 V5.3.1 + url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/005/05.03.01_60/gs_NFV-SOL005v050301p.pdf servers: - url: http://127.0.0.1/nslcm/v2 diff --git a/src/SOL005/NSLifecycleManagementNotification/NSLifecycleManagementNotification.yaml b/src/SOL005/NSLifecycleManagementNotification/NSLifecycleManagementNotification.yaml index e3b1cde..2b222a5 100644 --- a/src/SOL005/NSLifecycleManagementNotification/NSLifecycleManagementNotification.yaml +++ b/src/SOL005/NSLifecycleManagementNotification/NSLifecycleManagementNotification.yaml @@ -17,8 +17,8 @@ info: version: 2.16.0-impl:etsi.org:ETSI_NFV_OpenAPI:1 externalDocs: - description: ETSI GS NFV-SOL 005 Final Draft V5.2.4 - url: https://docbox.etsi.org/ISG/NFV/Open/Drafts/SOL005ed531/NFV-SOL005ed531v524.zip + description: ETSI GS NFV-SOL 005 V5.3.1 + url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/005/05.03.01_60/gs_NFV-SOL005v050301p.pdf servers: - url: http://127.0.0.1/callback/v2 diff --git a/src/SOL005/NSPerformanceManagement/NSPerformanceManagement.yaml b/src/SOL005/NSPerformanceManagement/NSPerformanceManagement.yaml index d7b0217..db8cf84 100644 --- a/src/SOL005/NSPerformanceManagement/NSPerformanceManagement.yaml +++ b/src/SOL005/NSPerformanceManagement/NSPerformanceManagement.yaml @@ -19,8 +19,8 @@ info: version: 2.13.0-impl:etsi.org:ETSI_NFV_OpenAPI:1 externalDocs: - description: ETSI GS NFV-SOL 005 Final Draft V5.2.4 - url: https://docbox.etsi.org/ISG/NFV/Open/Drafts/SOL005ed531/NFV-SOL005ed531v524.zip + description: ETSI GS NFV-SOL 005 V5.3.1 + url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/005/05.03.01_60/gs_NFV-SOL005v050301p.pdf servers: - url: http://127.0.0.1/nspm/v2 diff --git a/src/SOL005/NSPerformanceManagementNotification/NSPerformanceManagementNotification.yaml b/src/SOL005/NSPerformanceManagementNotification/NSPerformanceManagementNotification.yaml index e25ea0a..2aacef1 100644 --- a/src/SOL005/NSPerformanceManagementNotification/NSPerformanceManagementNotification.yaml +++ b/src/SOL005/NSPerformanceManagementNotification/NSPerformanceManagementNotification.yaml @@ -19,8 +19,8 @@ info: version: 2.13.0-impl:etsi.org:ETSI_NFV_OpenAPI:1 externalDocs: - description: ETSI GS NFV-SOL 005 Final Draft V5.2.4 - url: https://docbox.etsi.org/ISG/NFV/Open/Drafts/SOL005ed531/NFV-SOL005ed531v524.zip + description: ETSI GS NFV-SOL 005 V5.3.1 + url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/005/05.03.01_60/gs_NFV-SOL005v050301p.pdf servers: - url: http://127.0.0.1/callback/v2 diff --git a/src/SOL005/VNFPackageManagement/VNFPackageManagement.yaml b/src/SOL005/VNFPackageManagement/VNFPackageManagement.yaml index 41dc931..3fc8234 100644 --- a/src/SOL005/VNFPackageManagement/VNFPackageManagement.yaml +++ b/src/SOL005/VNFPackageManagement/VNFPackageManagement.yaml @@ -19,8 +19,8 @@ info: version: 2.12.0-impl:etsi.org:ETSI_NFV_OpenAPI:1 externalDocs: - description: ETSI GS NFV-SOL 005 Final Draft V5.2.4 - url: https://docbox.etsi.org/ISG/NFV/Open/Drafts/SOL005ed531/NFV-SOL005ed531v524.zip + description: ETSI GS NFV-SOL 005 V5.3.1 + url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/005/05.03.01_60/gs_NFV-SOL005v050301p.pdf servers: - url: http://127.0.0.1/vnfpkgm/v2 diff --git a/src/SOL005/VNFPackageManagementNotification/VNFPackageManagementNotification.yaml b/src/SOL005/VNFPackageManagementNotification/VNFPackageManagementNotification.yaml index 0454d59..9d5a92d 100644 --- a/src/SOL005/VNFPackageManagementNotification/VNFPackageManagementNotification.yaml +++ b/src/SOL005/VNFPackageManagementNotification/VNFPackageManagementNotification.yaml @@ -19,8 +19,8 @@ info: version: 2.12.0-impl:etsi.org:ETSI_NFV_OpenAPI:1 externalDocs: - description: ETSI GS NFV-SOL 005 Final Draft V5.2.4 - url: https://docbox.etsi.org/ISG/NFV/Open/Drafts/SOL005ed531/NFV-SOL005ed531v524.zip + description: ETSI GS NFV-SOL 005 V5.3.1 + url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/005/05.03.01_60/gs_NFV-SOL005v050301p.pdf servers: - url: http://127.0.0.1/callback/v2 diff --git a/src/SOL005/VNFSnapshotPackageManagement/VNFSnapshotPackageManagement.yaml b/src/SOL005/VNFSnapshotPackageManagement/VNFSnapshotPackageManagement.yaml index f45d2bd..59e6f63 100644 --- a/src/SOL005/VNFSnapshotPackageManagement/VNFSnapshotPackageManagement.yaml +++ b/src/SOL005/VNFSnapshotPackageManagement/VNFSnapshotPackageManagement.yaml @@ -19,8 +19,8 @@ info: version: 1.12.0-impl:etsi.org:ETSI_NFV_OpenAPI:1 externalDocs: - description: ETSI GS NFV-SOL 005 Final Draft V5.2.4 - url: https://docbox.etsi.org/ISG/NFV/Open/Drafts/SOL005ed531/NFV-SOL005ed531v524.zip + description: ETSI GS NFV-SOL 005 V5.3.1 + url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/005/05.03.01_60/gs_NFV-SOL005v050301p.pdf servers: - url: http://127.0.0.1/vnfsnapshotpkgm/v1 -- GitLab