diff --git a/README.md b/README.md index a9a16ace24c6f8d4bb78a177bd6fd7380feee055..cfa8f7ead8cfe45f383c152ab3dc6e71cece9da7 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,6 @@ # NFV SOL009 - OpenAPIs for the management of NFV-MANO -This repository contains OpenAPIs for ETSI GS NFV-SOL 009 v4.3.1, RESTful protocols +This repository contains OpenAPIs for ETSI GS NFV-SOL 009 v4.4.1, RESTful protocols specification for the management of NFV-MANO functional entities. **IMPORTANT: In case of discrepancies the published ETSI Group Specification takes precedence.** diff --git a/src/SOL009/APIVersion/APIVersion.yaml b/src/SOL009/APIVersion/APIVersion.yaml index 494645286ec0dfe436059d674f80402914e03ba8..68f4216950bc7fc16aed7fc5168ced108b705c53 100644 --- a/src/SOL009/APIVersion/APIVersion.yaml +++ b/src/SOL009/APIVersion/APIVersion.yaml @@ -19,8 +19,8 @@ info: version: 1.1.0-impl:etsi.org:ETSI_NFV_OpenAPI:1 externalDocs: - description: ETSI GS NFV-SOL 009 V3.6.1 - url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/009/03.05.01_60/gs_NFV-SOL009v030501p.pdf + description: ETSI GS NFV-SOL 009 V4.4.1 + url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/009/04.04.01_60/gs_NFV-SOL009v040401p.pdf paths: /nfvmanocim/api_versions: diff --git a/src/SOL009/NFVManoConfigurationAndInformationManagement/NFVManoConfigurationAndInformationManagement.yaml b/src/SOL009/NFVManoConfigurationAndInformationManagement/NFVManoConfigurationAndInformationManagement.yaml index 604ba0db2c8435b9fcc32c3c2b3468ae7d628d37..f0a9657820b7e6ee2fdb993c4a4d9fc2874e84e9 100644 --- a/src/SOL009/NFVManoConfigurationAndInformationManagement/NFVManoConfigurationAndInformationManagement.yaml +++ b/src/SOL009/NFVManoConfigurationAndInformationManagement/NFVManoConfigurationAndInformationManagement.yaml @@ -16,11 +16,11 @@ info: license: name: ETSI Forge copyright notice url: https://forge.etsi.org/etsi-forge-copyright-notice.txt - version: 2.1.0-impl:etsi.org:ETSI_NFV_OpenAPI:1 + version: 2.11.0-impl:etsi.org:ETSI_NFV_OpenAPI:1 externalDocs: - description: ETSI GS NFV-SOL 009 V4.3.1 - url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/009/04.03.01_60/gs_NFV-SOL009v040301p.pdf + description: ETSI GS NFV-SOL 009 V4.4.1 + url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/009/04.04.01_60/gs_NFV-SOL009v040401p.pdf servers: - url: http://127.0.0.1/nfvmanocim/v2 @@ -358,10 +358,12 @@ paths: /subscriptions/{subscriptionId}: parameters: - $ref: "#/components/parameters/subscriptionId" + get: description: > The GET method retrieves information about a subscription by reading an "Individual subscription" resource. See clause 5.5.5.3.2. + parameters: - $ref: "../components/SOL009_params.yaml#/components/parameters/Version" - $ref: "../components/SOL009_params.yaml#/components/parameters/Accept" @@ -1413,10 +1415,10 @@ components: maximum: 1 Subscriptions.Post.422: description: > - 422 Unprocessable Entity + 422 Unprocessable Content Shall be returned upon the following error: The content type - of the payload body is supported and the payload body of a request + of the message content is supported and the message content of a request contains syntactically correct data but the data cannot be processed. The general cause for this error and its handling is specified in diff --git a/src/SOL009/NFVManoConfigurationAndInformationManagement/definitions/NFVManoConfigurationAndInformationManagement_def.yaml b/src/SOL009/NFVManoConfigurationAndInformationManagement/definitions/NFVManoConfigurationAndInformationManagement_def.yaml index 467ec108c78a51af5efa008d2fd0a1c78ffd91b2..60e730671e56440c652df20c9bae83ebacd0e203 100644 --- a/src/SOL009/NFVManoConfigurationAndInformationManagement/definitions/NFVManoConfigurationAndInformationManagement_def.yaml +++ b/src/SOL009/NFVManoConfigurationAndInformationManagement/definitions/NFVManoConfigurationAndInformationManagement_def.yaml @@ -11,6 +11,8 @@ definitions: * NOTE 5: It is optional for the API producer to support the "manoEntityComponents" attribute. * NOTE 6: It shall be present when "type" attribute is "WIM", and it shall be absent in any other case. * NOTE 7: It shall be present when "type" attribute is "CISM", and it shall be absent in any other case. + * NOTE 8: It shall be present when "type" attribute is "CIR", and it shall be absent in any other case. + * NOTE 9: It shall be present when "type" attribute is "CCM", and it shall be absent in any other case. type: object required: - id @@ -123,8 +125,16 @@ definitions: $ref: "#/definitions/schemas/WimSpecificInfo" cismSpecificInfo: description: > - The information specific to a CISM entity, See notes 4 and 7. + The information specific to a CISM entity. See notes 4 and 7. $ref: "#/definitions/schemas/CismSpecificInfo" + cirSpecificInfo: + description: > + The information specific to a CIR entity. See notes 4 and 8. + $ref: "#/definitions/schemas/CirSpecificInfo" + ccmSpecificInfo: + description: > + The information specific to a CCM entity. See notes 4 and 9. + $ref: "#/definitions/schemas/CcmSpecificInfo" _links: description: > @@ -761,10 +771,10 @@ definitions: description: > This type represents an individual peer entity. * NOTE 1: The value of the "peerEntityId" attribute is the same as the value of the "id" attribute in the - "ManoEntity" of the corresponding NFV-MANO functional entity that acts as peer entity, and shall - follow the uniqueness requirements set out in clause 5.6.2.2 for the "id" attribute. - * NOTE 2: ETSI GS NFV-IFA 031 [1] defines an additional attribute named "apiDiscoveryEndpoint" in the - PeerManoEntity. The modelling of this attribute is not specified in the present document version. + "ManoEntity" of the corresponding NFV-MANO functional entity that acts as peer entity, and shall + follow the uniqueness requirements set out in clause 5.6.2.2 for the "id" attribute. + * NOTE 2: With this information, the NFVO has available information about the set of VIMs and associated VIM + connection information that have been configured into the VNFM. type: object required: - id @@ -809,6 +819,30 @@ definitions: consumed NFV-MANO interface, are managed by the API consumer and referenced from other data structures via the "consumedManoInterfaceIds" attribute. type: object + vimConnectionInfos: + description: > + Map of VIM connection information. The VimConnectionInfo is specified in clause + 4.4.1.6 of ETSI GS NFV-SOL 003. This attribute can be modified with the + PATCH method. May be present only if the "type" attribute in the "PeerEntity” is either a + "VIM", a "CISM" or a "CIR", and the NFV-MANO entity being configured is a + "VNFM" or "NFVO" as indicated by the "type" attribute in the "ManoEntity". + In case it is present, the value of the "vimId" in the "VimConnectionInfo" shall + be equal to the value of "peerEntityId". In addition, the content of "interfaceInfo", + "accessInfo” and "extra" (if applicable) of the “VimConnectionInfo" shall be + provided by means in scope of the present document. + type: array + items: + type: object + vnfmConfiguredVimConnectionInfoIds: + description: > + List of VIM connection information identifiers that identify the set of VIMs + and associated VIM connection information that have been configured + into the VNFM whose identifier is equal to the “peerEntityId“. See note 2. + Only applicable if the "type” attribute in the "ManoEntity" is "NFVO" and the + "type” attribute in the "PeerEntity" is a "VNFM". + type: array + items: + $ref: "../../definitions/SOL009_def.yaml#/definitions/schemas/Identifier" additionalProperties: $ref: "#/definitions/schemas/ConsumedManoInterfaceInfo" peerEntityState: @@ -833,11 +867,11 @@ definitions: description: > This type represents attribute modifications for configuration parameters of a peer entity. * NOTE: Due to the security sensitive information contained within the attribute (refer to "securityInfo" - within the "ConsumedManoInterfaceInfo"), based on access control policies, the API consumer might have - read only, write only, read/write, or no access at all to the attribute's value. In case the - API consumer is not allowed to modify the value of the security sensitive attribute, and the - modification request includes new attribute values, the whole modification request shall be rejected, - and proper error information returned. + within the "ConsumedManoInterfaceInfo" " and "accessInfo" within the "VimConnectionInfo"), + based on access control policies, the API consumer might have read only, write only, read/write, + or no access at all to the attribute's value. In case the API consumer is not allowed to modify + the value of the security sensitive attribute, and the modification request includes new attribute + values, the whole modification request shall be rejected, and proper error information returned. type: object properties: name: @@ -857,6 +891,14 @@ definitions: If present, these modifications shall be applied according to the rules of JSON Merge PATCH (see IETF RFC 7396). See note. type: object + vimConnectionInfos: + description: > + Modification of the "vimConnectionInfos” attribute in + the "PeerEntity". If present, these modifications shall be applied + according to the rules of JSON Merge PATCH (see IETF RFC 7396). See note. + type: array + items: + type: object additionalProperties: $ref: "#/definitions/schemas/ConsumedManoInterfaceInfo" operationalState: @@ -872,17 +914,17 @@ definitions: PeerEntityConfigModifications: description: > - This type represents attribute modifications that were performed on an - "Individual peer entity" resource. The attributes that can be included - consist of those requested to be modified explicitly in the - "PeerEntityConfigModificationRequest" data structure. If applicable, - additional attributes of the "PeerEntity" data structure that were + This type represents attribute modifications that were performed on an "Individual peer + entity" resource. The attributes that can be included consist of those requested to be + modified explicitly in the "PeerEntityConfigModificationRequest" data structure. + If applicable, additional attributes of the "PeerEntity" data structure that were modified implicitly shall also be provided. * NOTE: Due to the security sensitive information contained within the attribute (refer to "securityInfo" - within the "ConsumedManoInterfaceInfo"), based on access control policies, the API consumer might have - read only, write only, read/write, or no access at all to the attribute's value. In case the - API consumer is not allowed to read the value of the security sensitive attribute, the attribute shall - be omitted when the information is to be provided in a response message. + within the "ConsumedManoInterfaceInfo" " and "accessInfo" within the "VimConnectionInfo"), based + on access control policies, the API consumer might have read only, write only, read/write, or no + access at all to the attribute's value. In case the API consumer is not allowed to read the value + of the security sensitive attribute, the attribute shall be omitted when the information is to be + provided in a response message. type: object properties: name: @@ -901,6 +943,14 @@ definitions: "consumedManoInterfaces" attribute in "PeerEntity", as defined in clause 5.6.2.15. See note. type: object + vimConnectionInfos: + description: > + If present, this attribute signals modifications of the "vimConnectionInfos" attribute in + "PeerEntity", as defined in clause 5.6.2.15. See note. + type: array + items: + type: object + additionalProperties: $ref: "#/definitions/schemas/ConsumedManoInterfaceInfo" operationalState: @@ -1502,6 +1552,7 @@ definitions: Permitted values: - TLS_TUNNEL: Using TLS tunnel, as defined by TLS 1.2 in IETF RFC 5246. + - TLS_TUNNEL_13: Using TLS tunnel, as defined by TLS 1.3 in IETF RFC 8446. - OAUTH2: Using access token, as defined by the OAuth 2.0 specification in IETF RFC 6749. type: array @@ -1509,6 +1560,7 @@ definitions: type: string enum: - TLS_TUNNEL + - TLS_TUNNEL_13 - OAUTH2 minItems: 1 oauthServerInfo: @@ -1593,6 +1645,7 @@ definitions: Permitted values: - TLS_TUNNEL: Using TLS tunnel, as defined by TLS 1.2 in IETF RFC 5246. + - TLS_TUNNEL_13: Using TLS tunnel, as defined by TLS 1.3 in IETF RFC 8446. - OAUTH2: Using access token, as defined by the OAuth 2.0 specification in IETF RFC 6749. type: array @@ -1600,6 +1653,7 @@ definitions: type: string enum: - TLS_TUNNEL + - TLS_TUNNEL_13 - OAUTH2 minItems: 1 oauthServerInfo: @@ -1659,6 +1713,123 @@ definitions: type: string minItems: 1 + CirSpecificInfo: + description: > + This type represents information attributes specific to a CIR entity, and that can be relevant to more than one NFV- + MANO service offered by a CIR entity. It shall comply with the provisions defined in table 5.6.3.15-1. + NOTE: Recommendations on appropriate algorithms and key lengths are given e.g. in NIST Special Publication 800-57 + Part 3 Revision 1 or in documents related to local legislation. + type: object + required: + - osContainerImageFormats + - imageSignatureVerification + - imageDigestAlgorithms + properties: + osContainerImageFormats: + description: > + List of supported OS container image + formats. Valid values are all values for "container_format" as defined in ETSI + GS NFV-SOL 001 and all values for "container-format" as defined in ETSI GS NFV-SOL 006. + type: array + minItems: 1 + items: + type: string + imageSignatureVerification: + $ref: "#/definitions/schemas/CirSpecificInfo.imageSignatureVerification" + imageDigestAlgorithms: + type: array + items: + $ref: "#/definitions/schemas/CirSpecificInfo.imageDigestAlgorithms" + CirSpecificInfo.imageDigestAlgorithms: + description: > + List of supported digest algorithms that can be used for digital signatures. + type: object + required: + - algorithm + - keyLengths + properties: + algorithm: + description: > + The name of the algorithm. Permitted values are: "SHA2", "SHA3". + type: string + enum: + - SHA2 + - SHA3 + keyLengths: + description: > + List of supported key lengths of the algorithm. The key length indicates the + number of bits, such as "256", "512", etc. See note. + type: array + items: + type: string + CirSpecificInfo.imageSignatureVerification: + description: > + Information about the supported mechanisms, algorithms, and protocols for verifying the of software images. + type: object + required: + - signatureVerificationAlgorithms + properties: + signatureVerificationAlgorithms: + description: > + List of algorithms for verifying the signature of software images + that are supported by the CIR. + type: array + items: + $ref: "#/definitions/schemas/CirSpecificInfo.imageSignatureVerification.signatureVerificationAlgorithms" + CirSpecificInfo.imageSignatureVerification.signatureVerificationAlgorithms: + description: > + List of algorithms for verifying the signature of software images that are supported by the CIR. + type: object + required: + - algorithm + - keyLengths + properties: + algorithm: + description: > + The name of the algorithm. Permitted values are: "RSA", "DSA", "ECDSA". + type: string + keyLengths: + description: > + List of supported key lengths of the algorithm. The key length + indicates the number of bits, such as "256", "512", etc. See note + type: array + minItems: 1 + items: + type: string + additionalAlgParams: + $ref: "../../definitions/SOL009_def.yaml#/definitions/schemas/KeyValuePairs" + + + CcmSpecificInfo: + description: > + The supported cluster resource management modes. Available modes include: virtual and bare-metal resources, + and for both types, on-demand (i.e., CCM requests to corresponding infrastructure managers to build + necessary pools of resources) or pooled (i.e., CCM manages resources from pre-allocated resource pools). + Multiple values can be specified. See note. + Permitted values: + - VIRTUAL-ON-DEMAND: virtual resourceson demand. + - VIRTUAL-POOLED: virtual resources from a pre-allocated resource pool. + - BARE-METAL-ON-DEMAND: bare-metal resources on demand. + - BARE-METAL-POOLED: bare-metal resources from a pre-allocated resource pool. + + NOTE: Hybrid CIS clusters include both physical and virtual CIS cluster nodes and can be supported by a + combination of relevant "clusterResourceMgmtModes". + type: object + required: + - clusterResourceMgmtModes + properties: + clusterResourceMgmtModes: + type: array + minItems: 1 + items: + type: string + enum: + - VIRTUAL-ON-DEMAND + - VIRTUAL-POOLED + - BARE-METAL-ON-DEMAND + - BARE-METAL-POOLED + + #referenced simple data types ManoServiceInterfaceTypeShortName: description: > @@ -1672,20 +1843,20 @@ definitions: once the interfaces are specified as a RESTful NFV-MANO API. Acronym string value Description - "sim" Represents the "Software Image Management" interface produced by a VIM (refer to IFA005 and IFA006). + "sim" Represents the "Software Image Management" interface produced by a VIM (refer to IFA005 and IFA006). "vcrm" Represents the "Virtualised Compute Resources Management" interface produced by a VIM (refer to IFA005 and IFA006). "vcrim" Represents the "Virtualised Compute Resources Information Management" interface produced by a VIM (refer to IFA005 and IFA006). - "vcrcam" Represents the "Virtualised Compute Resources Capacity Management" interface produced by a VIM (refer to IFA005). + "vcrcam" Represents the "Virtualised Compute Resources Capacity Management" interface produced by a VIM (refer to IFA005). "vcrcn" Represents the "Virtualised Compute Resources Change Notification" interface produced by a VIM (refer to IFA005 and IFA006). "vcfm" Represents the "Virtualised Compute Flavour Management" interface produced by a VIM (refer to IFA005 and IFA006). "vnrm" Represents the "Virtualised Network Resources Management" interface produced by a VIM (refer to IFA005 and IFA006). "vnrim" Represents the "Virtualised Network Resources Information Management" interface produced by a VIM (refer to IFA005 and IFA006). - "vnrcam" Represents the "Virtualised Network Resources Capacity Management" interface produced by a VIM (refer to IFA005). + "vnrcam" Represents the "Virtualised Network Resources Capacity Management" interface produced by a VIM (refer to IFA005). "vnrcn" Represents the "Virtualised Network Resources Change Notification" interface produced by a VIM (refer to IFA005 and IFA006). "nfpm" Represents the "Network Forwarding Path Management" interface produced by a VIM (refer to IFA005). "vsrm" Represents the "Virtualised Storage Resources Management" interface produced by a VIM (refer to IFA005 and IFA006). "vsrim" Represents the "Virtualised Storage Resources Information Management" interface produced by a VIM (refer to IFA005 and IFA006). - "vsrcam" Represents the "Virtualised Storage Resources Capacity Management" interface produced by a VIM (refer to IFA005). + "vsrcam" Represents the "Virtualised Storage Resources Capacity Management" interface produced by a VIM (refer to IFA005). "vsrcn" Represents the "Virtualised Storage Resources Change Notification" interface produced by a VIM (refer to IFA005 and IFA006). "vrpm" Represents the "Virtualised Resources Performance Management" interface produced by a VIM (refer to IFA005 and IFA006). "vrfm" Represents the "Virtualised Resources Fault Management" interface produced by a VIM (refer to IFA005 and IFA006). @@ -1722,19 +1893,25 @@ definitions: "lcmcoord" Represents the "LCM Coordination" interface produced by an EM and OSS (refer to IFA008 and IFA013). "mscsm" Represents the "MSCS Management" interface produced by a WIM (refer to IFA032). "mscscapm" Represents the "(MSCS) Capacity Management" interface produced by a WIM (refer to IFA032). - "mscsfm" Represents the "(MSCS) Fault Management" interface produced by a WIM (refer to IFA032). - "mscspm" Represents the "(MSCS) Performance Management" interface produced by a WIM (refer to IFA032). + "mscsfm" Represents the "(MSCS) Fault Management" interface produced by a WIM (refer to IFA032). + "mscspm" Represents the "(MSCS) Performance Management" interface produced by a WIM (refer to IFA032). "cismwkldm" Represents the "OS container workload management" service interface produced by a CISM (refer to IFA040). "cismcompm" Represents the "OS container compute management" service interface produced by a CISM (refer to IFA040). "cismstrgm" Represents the "OS container storage management" service interface produced by a CISM (refer to IFA040). "cismnetwm" Represents the "OS container network management" service interface produced by a CISM (refer to IFA040). "cismcfgm" Represents the "OS container configuration management" service interface produced by a CISM (refer to IFA040). + "cismcisim" Represents the "CIS instance management" service interface produced by a CISM (refer to IFA036). + "cismcismccom" Represents the "CIS MCCO management" service interface produced by a CISM (refer to IFA036). + "cirimgm" Represents the "OS container image management" service interface produced by a CIR (refer to IFA040). + "ccmcisclcm" Represents the "CIS cluster lifecycle management" service interface produced by a CCM (refer to IFA036). + "ccmciscfm" Represents the "CIS cluster fault management" service interface produced by a CCM (refer to IFA036). + "ccmciscpm" Represents the "CIS cluster performance management" service interface produced by a CCM (refer to IFA036). + "ccmcisccm" Represents the "CIS cluster configuration management" service interface produced by a CCM (refer to IFA036). + "ccmciscsm" Represents the "CIS cluster security management" service interface produced by a CCM (refer to IFA036). NOTE: "IFA005", "IFA006", "IFA007", "IFA008", "IFA013", "IFA032", "IFA040" are used as a shorthand for the - specifications ETSI GS NFV-IFA 005 [i.5], ETSI GS NFV-IFA 006 [i.6], ETSI GS NFV-IFA 007 [i.7], - ETSI GS NFV IFA 008 [i.8], ETSI GS NFV-IFA 013 [i.9], ETSI GS NFV-IFA 032 [i.18] and - ETSI GS NFV-IFA 040 [i.27], respectively. - + specifications ETSI GS NFV-IFA 005, ETSI GS NFV-IFA 006, ETSI GS NFV-IFA 007, ETSI GS NFV IFA 008, ETSI GS NFV-IFA 013, + ETSI GS NFV-IFA 032 and ETSI GS NFV-IFA 040, and ETSI GS NFV-IFA 036 respectively. type: string UsageStateEnumType: @@ -1809,9 +1986,11 @@ definitions: the provisions : - NFVO The NFV-MANO functional entity is an NFVO. - VNFM The NFV-MANO functional entity is a VNFM. - - VIM The NFV-MANO functional entity is a VIM. - - WIM The NFV-MANO functional entity is a WIM. + - VIM The NFV-MANO functional entity is a VIM. + - WIM The NFV-MANO functional entity is a WIM. - CISM The NFV-MANO functional entity is a CISM. + - CIR The NFV-MANO functional entity is a CIR. + - CCM The NFV-MANO functional entity is a CCM. type: string enum: - NFVO @@ -1819,6 +1998,8 @@ definitions: - VIM - WIM - CISM + - CIR + - CCM PeerEntityEnumType: description: > @@ -1830,6 +2011,8 @@ definitions: - VIM The peer functional entity is a VIM. - WIM The peer functional entity is a WIM. - CISM The peer functional entity is a CISM. + - CIR The NFV-MANO functional entity is a CIR. + - CCM The NFV-MANO functional entity is a CCM. - EM The peer functional entity is an EM. - OSS The peer functional entity is an OSS/BSS. type: string @@ -1839,6 +2022,8 @@ definitions: - VIM - WIM - CISM + - CIR + - CCM - EM - OSS diff --git a/src/SOL009/NFVManoConfigurationAndInformationManagementNotification/NFVManoConfigurationAndInformationManagementNotification.yaml b/src/SOL009/NFVManoConfigurationAndInformationManagementNotification/NFVManoConfigurationAndInformationManagementNotification.yaml index cb9c62b972f5e53a9908bc87f384b7bf5bfaf3ff..b3354960050febd8a8f0a95aed479fcbc328acbb 100644 --- a/src/SOL009/NFVManoConfigurationAndInformationManagementNotification/NFVManoConfigurationAndInformationManagementNotification.yaml +++ b/src/SOL009/NFVManoConfigurationAndInformationManagementNotification/NFVManoConfigurationAndInformationManagementNotification.yaml @@ -19,8 +19,8 @@ info: version: 2.1.0-impl:etsi.org:ETSI_NFV_OpenAPI:1 externalDocs: - description: ETSI GS NFV-SOL 009 V4.3.1 - url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/009/04.03.01_60/gs_NFV-SOL009v040301p.pdf + description: ETSI GS NFV-SOL 009 V4.4.1 + url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/009/04.04.01_60/gs_NFV-SOL009v040401p.pdf servers: - url: http://127.0.0.1/callback/v2 diff --git a/src/SOL009/NFVManoFaultManagement/NFVManoFaultManagement.yaml b/src/SOL009/NFVManoFaultManagement/NFVManoFaultManagement.yaml index c09bff389733d2119fdb18acd46f792b8bb72030..d26dcc094d276282b3fb2e809d1bf12ae5a6504c 100644 --- a/src/SOL009/NFVManoFaultManagement/NFVManoFaultManagement.yaml +++ b/src/SOL009/NFVManoFaultManagement/NFVManoFaultManagement.yaml @@ -19,8 +19,8 @@ info: version: 1.0.1-impl:etsi.org:ETSI_NFV_OpenAPI:1 externalDocs: - description: ETSI GS NFV-SOL 009 V4.3.1 - url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/009/04.03.01_60/gs_NFV-SOL009v040301p.pdf + description: ETSI GS NFV-SOL 009 V4.4.1 + url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/009/04.04.01_60/gs_NFV-SOL009v040401p.pdf servers: - url: http://127.0.0.1/nfvmanofm/v1 @@ -162,7 +162,7 @@ paths: "406": $ref: ../responses/SOL009_resp.yaml#/responses/406 "422": - $ref: ../responses/SOL009_resp.yaml#/responses/422 + $ref: '#/components/responses/Subscriptions.Post.422' "500": $ref: ../responses/SOL009_resp.yaml#/responses/500 "503": @@ -511,10 +511,10 @@ components: maximum: 1 Subscriptions.Post.422: description: > - 422 Unprocessable Entity + 422 Unprocessable Content Shall be returned upon the following error: The content type - of the payload body is supported and the payload body of a request + of the message content is supported and the message content of a request contains syntactically correct data but the data cannot be processed. The general cause for this error and its handling is specified in diff --git a/src/SOL009/NFVManoFaultManagementNotification/NFVManoFaultManagementNotification.yaml b/src/SOL009/NFVManoFaultManagementNotification/NFVManoFaultManagementNotification.yaml index ca89483d0d76bad16e2cc21f17343342328f333b..7953dde15dfef193ca1c579b0af661f40cf6c2fd 100644 --- a/src/SOL009/NFVManoFaultManagementNotification/NFVManoFaultManagementNotification.yaml +++ b/src/SOL009/NFVManoFaultManagementNotification/NFVManoFaultManagementNotification.yaml @@ -19,8 +19,8 @@ info: version: 1.0.1-impl:etsi.org:ETSI_NFV_OpenAPI:1 externalDocs: - description: ETSI GS NFV-SOL 009 V4.3.1 - url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/009/04.03.01_60/gs_NFV-SOL009v040301p.pdf + description: ETSI GS NFV-SOL 009 V4.4.1 + url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/009/04.04.01_60/gs_NFV-SOL009v040401p.pdf servers: - url: http://127.0.0.1/callback/v1 diff --git a/src/SOL009/NFVManoLogManagement/NFVManoLogManagement.yaml b/src/SOL009/NFVManoLogManagement/NFVManoLogManagement.yaml index 0bea4125c3a88bac4c3e492e1a943b69719f0dd3..0b1ef075c3838ca702c524fa4e3bcd329a4b0165 100644 --- a/src/SOL009/NFVManoLogManagement/NFVManoLogManagement.yaml +++ b/src/SOL009/NFVManoLogManagement/NFVManoLogManagement.yaml @@ -19,8 +19,8 @@ info: version: 1.0.1-impl:etsi.org:ETSI_NFV_OpenAPI:1 externalDocs: - description: ETSI GS NFV-SOL 009 V4.3.1 - url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/009/04.03.01_60/gs_NFV-SOL009v040301p.pdf + description: ETSI GS NFV-SOL 009 V4.4.1 + url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/009/04.04.01_60/gs_NFV-SOL009v040401p.pdf servers: - url: http://127.0.0.1/nfvmanologm/v1 @@ -285,7 +285,7 @@ paths: "303": $ref: '#/components/responses/Subscriptions.Post.303' "422": - $ref: '../responses/SOL009_resp.yaml#/responses/422' + $ref: '#/components/responses/Subscriptions.Post.422' "400": $ref: '../responses/SOL009_resp.yaml#/responses/400' "401": @@ -706,12 +706,12 @@ components: schema: $ref: "./definitions/NFVManoLogManagement_def.yaml#/definitions/schemas/LogReport" - subscriptions.post.422: + Subscriptions.Post.422: description: > - 422 UNPROCESSABLE ENTITY + 422 Unprocessable content Shall be returned upon the following error: The content type - of the payload body is supported and the payload body of a request + of the message content is supported and the message content of a request contains syntactically correct data but the data cannot be processed. The general cause for this error and its handling is specified in @@ -810,12 +810,12 @@ components: LogReportCompiled.Post.422: description: > - 422 UNPROCESSABLE ENTITY + 422 Unprocessable Content The general cause for this error and its handling is specified in clause 6.4 of ETSI GS NFV-SOL 013, including rules for the presence of the response body. Specifically, in case of this task resource, the response code 422 shall also be returned if the - "objectInstanceId" value provided in the payload body of the request does not correspond to an object + "objectInstanceId" value provided in the message content of the request does not correspond to an object instance for which log data is being collected by the logging job represented by this resource. The response body shall contain a ProblemDetails structure, in which the "detail" attribute should convey more information about the error. diff --git a/src/SOL009/NFVManoLogManagement/definitions/NFVManoLogManagement_def.yaml b/src/SOL009/NFVManoLogManagement/definitions/NFVManoLogManagement_def.yaml index 61edc66582dcada8dd4e31051f6b2e0049ad27c5..4387468123f2dcf5eda146f9161f6937f2a4bb6d 100644 --- a/src/SOL009/NFVManoLogManagement/definitions/NFVManoLogManagement_def.yaml +++ b/src/SOL009/NFVManoLogManagement/definitions/NFVManoLogManagement_def.yaml @@ -487,8 +487,8 @@ definitions: requestMethod: description: >- HTTP request method to be matched. To match, the HTTP request method of the message shall be the - same as the value of this attribute. Valid values are specified in IETF RFC 7231. The API producer - shall support this attribute. + same as the value of this attribute. Valid values are specified in IETF RFC 9110 and IETF RFC 5789. + The API producer shall support this attribute. type: string requestUriPattern: description: >- diff --git a/src/SOL009/NFVManoLogManagementNotification/NFVManoLogManagementNotification.yaml b/src/SOL009/NFVManoLogManagementNotification/NFVManoLogManagementNotification.yaml index 3236d3d678c216e902d79ec8a95daf43c24d524a..95fb83126a0b793f5522bc98da31e50d65c94837 100644 --- a/src/SOL009/NFVManoLogManagementNotification/NFVManoLogManagementNotification.yaml +++ b/src/SOL009/NFVManoLogManagementNotification/NFVManoLogManagementNotification.yaml @@ -19,8 +19,8 @@ info: version: 1.0.1-impl:etsi.org:ETSI_NFV_OpenAPI:1 externalDocs: - description: ETSI GS NFV-SOL 009 V4.3.1 - url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/009/04.03.01_60/gs_NFV-SOL009v040301p.pdf + description: ETSI GS NFV-SOL 009 V4.4.1 + url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/009/04.04.01_60/gs_NFV-SOL009v040401p.pdf servers: - url: http://127.0.0.1/callback/v1 diff --git a/src/SOL009/NFVManoPerformanceManagement/NFVManoPerformanceManagement.yaml b/src/SOL009/NFVManoPerformanceManagement/NFVManoPerformanceManagement.yaml index 1af6c7edec4ae896b15338fc319c237d4b6262d7..45f6687703c75b6070231fa10e973c45d1b1035f 100644 --- a/src/SOL009/NFVManoPerformanceManagement/NFVManoPerformanceManagement.yaml +++ b/src/SOL009/NFVManoPerformanceManagement/NFVManoPerformanceManagement.yaml @@ -20,8 +20,8 @@ info: version: 2.0.0-impl:etsi.org:ETSI_NFV_OpenAPI:1 externalDocs: - description: ETSI GS NFV-SOL 009 V4.3.1 - url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/009/04.03.01_60/gs_NFV-SOL009v040301p.pdf + description: ETSI GS NFV-SOL 009 V4.4.1 + url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/009/04.04.01_60/gs_NFV-SOL009v040401p.pdf servers: - url: http://127.0.0.1/nfvmanopm/v2 @@ -43,7 +43,7 @@ paths: $ref: "#/components/requestBodies/CreatePMJobRequest" responses: "201": - $ref: "#/components/responses/pm_jobs.Post.201" + $ref: "#/components/responses/pmJobs.Post.201" "400": $ref: ../responses/SOL009_resp.yaml#/responses/400 "401": @@ -57,7 +57,7 @@ paths: "406": $ref: ../responses/SOL009_resp.yaml#/responses/406 "422": - $ref: ../responses/SOL009_resp.yaml#/responses/422 + $ref: "#/components/responses/pmJobs.Post.422" "500": $ref: ../responses/SOL009_resp.yaml#/responses/500 "503": @@ -404,7 +404,7 @@ paths: components: responses: - pm_jobs.Post.201: + pmJobs.Post.201: description: > 201 CREATED @@ -432,12 +432,12 @@ components: application/json: schema: $ref: "./definitions/NFVManoPerformanceManagement_def.yaml#/definitions/schemas/PmJob" - pm_jobs.Post.422: + pmJobs.Post.422: description: > - 422 Unprocessable Entity + 422 Unprocessable Content Shall be returned upon the following error: The content type - of the payload body is supported and the payload body of a request + of the message content is supported and the message content of a request contains syntactically correct data but the data cannot be processed. The general cause for this error and its handling is specified in @@ -630,10 +630,10 @@ components: $ref: "../definitions/SOL009_def.yaml#/definitions/schemas/ProblemDetails" IndividualPmJob.Patch.422: description: > - 422 Unprocessable Entity + 422 Unprocessable Content Shall be returned upon the following error: The content type - of the payload body is supported and the payload body of a request + of the message content is supported and the message content of a request contains syntactically correct data but the data cannot be processed. The general cause for this error and its handling is specified in @@ -683,7 +683,6 @@ components: Version of the API used in the response. schema: type: string - IndividualPerformanceReport.Get.200: description: > 200 OK @@ -752,10 +751,10 @@ components: $ref: "./definitions/NFVManoPerformanceManagement_def.yaml#/definitions/schemas/Threshold" Thresholds.Post.422: description: > - 422 Unprocessable Entity + 422 Unprocessable Content Shall be returned upon the following error: The content type - of the payload body is supported and the payload body of a request + of the message content is supported and the message content of a request contains syntactically correct data but the data cannot be processed. The general cause for this error and its handling is specified in @@ -936,10 +935,10 @@ components: $ref: "../definitions/SOL009_def.yaml#/definitions/schemas/ProblemDetails" Threshold.Patch.422: description: > - 422 Unprocessable Entity + 422 Unprocessable Content Shall be returned upon the following error: The content type - of the payload body is supported and the payload body of a request + of the message content is supported and the message content of a request contains syntactically correct data but the data cannot be processed. The general cause for this error and its handling is specified in diff --git a/src/SOL009/NFVManoPerformanceManagementNotification/NFVManoPerformanceManagementNotification.yaml b/src/SOL009/NFVManoPerformanceManagementNotification/NFVManoPerformanceManagementNotification.yaml index 7fd30cf2aa45e40cba980ffc1e54b19d4c1bca71..5d8faba07b7021f4a80807a262d2afdb812e926b 100644 --- a/src/SOL009/NFVManoPerformanceManagementNotification/NFVManoPerformanceManagementNotification.yaml +++ b/src/SOL009/NFVManoPerformanceManagementNotification/NFVManoPerformanceManagementNotification.yaml @@ -19,8 +19,8 @@ info: version: 2.0.0-impl:etsi.org:ETSI_NFV_OpenAPI:1 externalDocs: - description: ETSI GS NFV-SOL 009 V4.3.1 - url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/009/04.03.01_60/gs_NFV-SOL009v040301p.pdf + description: ETSI GS NFV-SOL 009 V4.4.1 + url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/009/04.04.01_60/gs_NFV-SOL009v040401p.pdf servers: - url: http://127.0.0.1/callback/v2 - url: https://127.0.0.1/callback/v2