ETSI GS NFV-SOL 003-2018 Network Functions Virtualisation (NFV) Release 2 Protocols and Data Models RESTful protocols specification for the Or-Vnfm Reference Point (V2 4 1).pdf

1、 ETSI GS NFV-SOL 003 V2.4.1 (2018-02) Network Functions Virtualisation (NFV) Release 2; Protocols and Data Models; RESTful protocols specification for the Or-Vnfm Reference Point Disclaimer The present document has been produced and approved by the Network Functions Virtualisation (NFV) ETSI Industr

2、y Specification Group (ISG) and represents the views of those members who participated in this ISG. It does not necessarily represent the views of the entire ETSI membership. GROUP SPECIFICATION ETSI ETSI GS NFV-SOL 003 V2.4.1 (2018-02)2 Reference RGS/NFV-SOL003ed241 Keywords API, NFV, protocol ETSI

3、 650 Route des Lucioles F-06921 Sophia Antipolis Cedex - FRANCE Tel.: +33 4 92 94 42 00 Fax: +33 4 93 65 47 16 Siret N 348 623 562 00017 - NAF 742 C Association but non lucratif enregistre la Sous-Prfecture de Grasse (06) N 7803/88 Important notice The present document can be downloaded from: http:/

4、www.etsi.org/standards-search The present document may be made available in electronic versions and/or in print. The content of any electronic and/or print versions of the present document shall not be modified without the prior written authorization of ETSI. In case of any existing or perceived dif

5、ference in contents between such versions and/or in print, the only prevailing document is the print of the Portable Document Format (PDF) version kept on a specific network drive within ETSI Secretariat. Users of the present document should be aware that the document may be subject to revision or c

6、hange of status. Information on the current status of this and other ETSI documents is available at https:/portal.etsi.org/TB/ETSIDeliverableStatus.aspx If you find errors in the present document, please send your comment to one of the following services: https:/portal.etsi.org/People/CommiteeSuppor

7、tStaff.aspx Copyright Notification No part may be reproduced or utilized in any form or by any means, electronic or mechanical, including photocopying and microfilm except as authorized by written permission of ETSI. The content of the PDF version shall not be modified without the written authorizat

8、ion of ETSI. The copyright and the foregoing restriction extend to reproduction in all media. ETSI 2018. All rights reserved. DECTTM, PLUGTESTSTM, UMTSTMand the ETSI logo are trademarks of ETSI registered for the benefit of its Members. 3GPPTM and LTETMare trademarks of ETSI registered for the benef

9、it of its Members and of the 3GPP Organizational Partners. oneM2M logo is protected for the benefit of its Members. GSMand the GSM logo are trademarks registered and owned by the GSM Association. ETSI ETSI GS NFV-SOL 003 V2.4.1 (2018-02)3 Contents Intellectual Property Rights 17g3Foreword . 17g3Moda

10、l verbs terminology 17g31 Scope 18g32 References 18g32.1 Normative references . 18g32.2 Informative references 19g33 Definitions and abbreviations . 20g33.1 Definitions 20g33.2 Abbreviations . 20g34 General aspects . 21g34.1 Overview 21g34.2 URI structure and supported content formats . 21g34.3 Comm

11、on procedures. 22g34.3.1 Introduction. 22g34.3.2 Attribute-based filtering 22g34.3.2.1 Overview and example (informative) 22g34.3.2.2 Specification 23g34.3.3 Attribute selectors . 24g34.3.3.1 Overview and example (informative) 24g34.3.3.2 Specification 24g34.3.3.2.1 GET request . 24g34.3.3.2.2 GET r

12、esponse 25g34.3.4 Usage of HTTP header fields 26g34.3.4.1 Introduction . 26g34.3.4.2 Request header fields 26g34.3.4.3 Response header fields 27g34.3.5 Error reporting 27g34.3.5.1 Introduction . 27g34.3.5.2 General mechanism . 27g34.3.5.3 Type: ProblemDetails 28g34.3.5.4 Common error situations . 28

13、g34.3.5.5 Overview of HTTP error status codes . 29g34.4 Common data types 30g34.4.1 Structured data types . 30g34.4.1.1 Introduction . 30g34.4.1.2 Type: Object 30g34.4.1.3 Type: Link . 30g34.4.1.4 Type: KeyValuePairs 31g34.4.1.5 Type: VnfInstanceSubscriptionFilter 31g34.4.1.6 Type: VimConnectionInfo

14、 32g34.4.1.7 Type: ResourceHandle 33g34.4.1.8 void . 33g34.4.1.9 void . 33g34.4.1.10 Type: VnfExtCpData 33g34.4.1.10a Type: VnfExtCpConfig . 33g34.4.1.10b Type: CpProtocolData . 34g34.4.1.10c Type: IpOverEthernetAddressData . 34g34.4.1.11 Type: ExtVirtualLinkData 35g34.4.1.12 Type: ExtManagedVirtual

15、LinkData 36g34.4.2 Simple data types and enumerations . 36g34.4.2.1 Introduction . 36g34.4.2.2 Simple data types 37g34.4.2.3 Enumeration: LcmOperationType . 37g3ETSI ETSI GS NFV-SOL 003 V2.4.1 (2018-02)4 4.5 Authorization of API requests and notifications 37g34.5.1 Introduction. 37g34.5.2 Flows (inf

16、ormative) 38g34.5.2.0 General 38g34.5.2.1 Authorization of API requests using OAuth 2.0 access tokens . 38g34.5.2.1a Authorization of API requests using TLS certificates . 40g34.5.2.2 Authorization of notifications using the HTTP Basic authentication scheme . 41g34.5.2.3 Authorization of notificatio

17、ns using OAuth 2.0 access tokens 42g34.5.2.4 Authorization of notifications using TLS certificates . 44g34.5.3 Specification . 46g34.5.3.1 Introduction . 46g34.5.3.2 General mechanism . 46g34.5.3.3 Authorizing API requests 46g34.5.3.4 Authorizing the sending of notifications . 47g34.5.3.5 Client rol

18、es 49g34.5.3.6 Negotiation of the authorization method . 49g34.5.3.6.1 Authorization of API requests . 49g34.5.3.6.2 Authorization of notification requests . 51g35 VNF Lifecycle Management interface . 51g35.1 Description . 51g35.2 Resource structure and methods . 52g35.3 Sequence diagrams (informati

19、ve) . 54g35.3.1 Flow of the creation of a VNF instance resource 54g35.3.2 Flow of the deletion of a VNF instance resource 56g35.3.3 Flow of VNF lifecycle management operations triggered by task resources 56g35.3.4 Flow of automatic invocation of VNF scaling and VNF healing 59g35.3.5 Flow of the Quer

20、y VNF operation 61g35.3.6 Flow of the Modify VNF Information operation 62g35.3.7 Flow of the Get Operation Status operation 64g35.3.8 Flow of managing subscriptions . 65g35.3.9 Flow of sending notifications 66g35.3.10 Flow of retrying a VNF lifecycle management operation . 67g35.3.11 Flow of rolling

21、 back a VNF lifecycle management operation 68g35.3.12 Flow of failing a VNF lifecycle management operation . 69g35.3.13 Flow of cancelling a VNF lifecycle management operation . 70g35.4 Resources . 72g35.4.1 Introduction. 72g35.4.2 Resource: VNF instances 72g35.4.2.1 Description 72g35.4.2.2 Resource

22、 definition . 73g35.4.2.3 Resource methods . 73g35.4.2.3.1 POST . 73g35.4.2.3.2 GET . 73g35.4.2.3.3 PUT . 74g35.4.2.3.4 PATCH 74g35.4.2.3.5 DELETE 75g35.4.3 Resource: Individual VNF instance 75g35.4.3.1 Description 75g35.4.3.2 Resource definition . 75g35.4.3.3 Resource methods . 75g35.4.3.3.1 POST .

23、 75g35.4.3.3.2 GET . 75g35.4.3.3.3 PUT . 76g35.4.3.3.4 PATCH 76g35.4.3.3.5 DELETE 77g35.4.4 Resource: Instantiate VNF task 78g35.4.4.1 Description 78g35.4.4.2 Resource definition . 78g35.4.4.3 Resource methods . 78g35.4.4.3.1 POST . 78g35.4.4.3.2 GET . 79g3ETSI ETSI GS NFV-SOL 003 V2.4.1 (2018-02)5

24、5.4.4.3.3 PUT . 79g35.4.4.3.4 PATCH 79g35.4.4.3.5 DELETE 79g35.4.5 Resource: Scale VNF task 79g35.4.5.1 Description 79g35.4.5.2 Resource definition . 80g35.4.5.3 Resource methods . 80g35.4.5.3.1 POST . 80g35.4.5.3.2 GET . 81g35.4.5.3.3 PUT . 81g35.4.5.3.4 PATCH 81g35.4.5.3.5 DELETE 82g35.4.6 Resourc

25、e: Scale VNF to Level task 82g35.4.6.1 Description 82g35.4.6.2 Resource definition . 82g35.4.6.3 Resource methods . 82g35.4.6.3.1 POST . 82g35.4.6.3.2 GET . 83g35.4.6.3.3 PUT . 83g35.4.6.3.4 PATCH 83g35.4.6.3.5 DELETE 84g35.4.7 Resource: Change VNF Flavour task . 84g35.4.7.1 Description 84g35.4.7.2

26、Resource definition . 84g35.4.7.3 Resource methods . 84g35.4.7.3.1 POST . 84g35.4.7.3.2 GET . 85g35.4.7.3.3 PUT . 85g35.4.7.3.4 PATCH 85g35.4.7.3.5 DELETE 86g35.4.8 Resource: Terminate VNF task . 86g35.4.8.1 Description 86g35.4.8.2 Resource definition . 86g35.4.8.3 Resource methods . 86g35.4.8.3.1 P

27、OST . 86g35.4.8.3.2 GET . 87g35.4.8.3.3 PUT . 87g35.4.8.3.4 PATCH 87g35.4.8.3.5 DELETE 87g35.4.9 Resource: Heal VNF task . 87g35.4.9.1 Description 87g35.4.9.2 Resource definition . 88g35.4.9.3 Resource methods . 88g35.4.9.3.1 POST . 88g35.4.9.3.2 GET . 89g35.4.9.3.3 PUT . 89g35.4.9.3.4 PATCH 89g35.4

28、.9.3.5 DELETE 90g35.4.10 Resource: Operate VNF task 90g35.4.10.1 Description 90g35.4.10.2 Resource definition . 90g35.4.10.3 Resource methods . 90g35.4.10.3.1 POST . 90g35.4.10.3.2 GET . 91g35.4.10.3.3 PUT . 92g35.4.10.3.4 PATCH 92g35.4.10.3.5 DELETE 92g35.4.11 Resource: Change external VNF connecti

29、vity task 92g35.4.11.1 Description 92g35.4.11.2 Resource definition . 92g35.4.11.3 Resource methods . 92g35.4.11.3.1 POST . 92g3ETSI ETSI GS NFV-SOL 003 V2.4.1 (2018-02)6 5.4.11.3.2 GET . 93g35.4.11.3.3 PUT . 93g35.4.11.3.4 PATCH 93g35.4.11.3.5 DELETE 93g35.4.12 Resource: VNF LCM operation occurrenc

30、es 94g35.4.12.1 Description 94g35.4.12.2 Resource definition . 94g35.4.12.3 Resource methods . 94g35.4.12.3.1 POST . 94g35.4.12.3.2 GET . 94g35.4.12.3.3 PUT . 95g35.4.12.3.4 PATCH 96g35.4.12.3.5 DELETE 96g35.4.13 Resource: Individual VNF LCM operation occurrence 96g35.4.13.1 Description 96g35.4.13.2

31、 Resource definition . 96g35.4.13.3 Resource methods . 96g35.4.13.3.1 POST . 96g35.4.13.3.2 GET . 96g35.4.13.3.3 PUT . 97g35.4.13.3.4 PATCH 97g35.4.13.3.5 DELETE 97g35.4.14 Resource: Retry operation task . 97g35.4.14.1 Description 97g35.4.14.2 Resource definition . 97g35.4.14.3 Resource methods . 98

32、g35.4.14.3.1 POST . 98g35.4.14.3.2 GET . 99g35.4.14.3.3 PUT . 99g35.4.14.3.4 PATCH 99g35.4.14.3.5 DELETE 99g35.4.15 Resource: Rollback operation task 99g35.4.15.1 Description 99g35.4.15.2 Resource definition . 99g35.4.15.3 Resource methods . 99g35.4.15.3.1 POST . 99g35.4.15.3.2 GET . 100g35.4.15.3.3

33、 PUT . 100g35.4.15.3.4 PATCH 100g35.4.15.3.5 DELETE 100g35.4.16 Resource: Fail operation task 101g35.4.16.1 Description 101g35.4.16.2 Resource definition . 101g35.4.16.3 Resource methods . 101g35.4.16.3.1 POST . 101g35.4.16.3.2 GET . 102g35.4.16.3.3 PUT . 102g35.4.16.3.4 PATCH 102g35.4.16.3.5 DELETE

34、 103g35.4.17 Resource: Cancel operation task . 103g35.4.17.1 Description 103g35.4.17.2 Resource definition . 103g35.4.17.3 Resource methods . 103g35.4.17.3.1 POST . 103g35.4.17.3.2 GET . 104g35.4.17.3.3 PUT . 104g35.4.17.3.4 PATCH 104g35.4.17.3.5 DELETE 105g35.4.18 Resource: Subscriptions 105g35.4.1

35、8.1 Description 105g35.4.18.2 Resource definition . 105g35.4.18.3 Resource methods . 105g3ETSI ETSI GS NFV-SOL 003 V2.4.1 (2018-02)7 5.4.18.3.1 POST . 105g35.4.18.3.2 GET . 106g35.4.18.3.3 PUT . 107g35.4.18.3.4 PATCH 107g35.4.18.3.5 DELETE 107g35.4.19 Resource: Individual subscription . 107g35.4.19.

36、1 Description 107g35.4.19.2 Resource definition . 107g35.4.19.3 Resource methods . 108g35.4.19.3.1 POST . 108g35.4.19.3.2 GET . 108g35.4.19.3.3 PUT . 108g35.4.19.3.4 PATCH 108g35.4.19.3.5 DELETE 108g35.4.20 Resource: Notification endpoint . 109g35.4.20.1 Description 109g35.4.20.2 Resource definition

37、 . 109g35.4.20.3 Resource methods . 109g35.4.20.3.1 POST . 109g35.4.20.3.2 GET . 110g35.4.20.3.3 PUT . 110g35.4.20.3.4 PATCH 110g35.4.20.3.5 DELETE 111g35.5 Data model . 111g35.5.1 Introduction. 111g35.5.2 Resource and notification data types 111g35.5.2.1 Introduction . 111g35.5.2.2 Type: VnfInstanc

38、e . 111g35.5.2.3 Type: CreateVnfRequest . 114g35.5.2.4 Type: InstantiateVnfRequest . 115g35.5.2.5 Type: ScaleVnfRequest . 115g35.5.2.6 Type: ScaleVnfToLevelRequest . 116g35.5.2.7 Type: ChangeVnfFlavourRequest. 116g35.5.2.8 Type: TerminateVnfRequest . 117g35.5.2.9 Type: HealVnfRequest 117g35.5.2.10 T

39、ype: OperateVnfRequest. 118g35.5.2.11 Type: ChangeExtVnfConnectivityRequest . 118g35.5.2.12 Type: VnfInfoModificationRequest 119g35.5.2.12a Type: VnfInfoModifications . 119g35.5.2.13 Type: VnfLcmOpOcc 120g35.5.2.14 Type: CancelMode 122g35.5.2.15 Type: LccnSubscriptionRequest . 122g35.5.2.16 Type: Lc

40、cnSubscription 122g35.5.2.17 Type: VnfLcmOperationOccurrenceNotification . 122g35.5.2.18 Type: VnfIdentifierCreationNotification 125g35.5.2.19 Type: VnfIdentifierDeletionNotification 125g35.5.3 Referenced structured data types 125g35.5.3.1 Introduction . 125g35.5.3.2 Type: ExtVirtualLinkInfo . 126g3

41、5.5.3.3 Type: ExtManagedVirtualLinkInfo . 126g35.5.3.4 Type: ScaleInfo . 126g35.5.3.5 Type: VnfcResourceInfo . 127g35.5.3.6 Type: VnfVirtualLinkResourceInfo 127g35.5.3.7 Type: VirtualStorageResourceInfo . 128g35.5.3.8 Type: VnfLinkPortInfo . 128g35.5.3.9 Type: ExtLinkPortInfo 129g35.5.3.9a Type: Ext

42、LinkPortData . 129g35.5.3.9b Type: CpProtocolInfo 129g35.5.3.10 Type: IpOverEthernetAddressInfo 129g35.5.3.11 Type: MonitoringParameter 130g35.5.3.12 Type: LifecycleChangeNotificationsFilter 130g35.5.3.13 Type: AffectedVnfc 132g3ETSI ETSI GS NFV-SOL 003 V2.4.1 (2018-02)8 5.5.3.14 Type: AffectedVirtu

43、alLink 133g35.5.3.15 Type: AffectedVirtualStorage . 133g35.5.3.16 Type: LccnLinks . 134g35.5.4 Referenced simple data types and enumerations 134g35.5.4.1 Introduction . 134g35.5.4.2 Simple data types 134g35.5.4.3 Enumeration: VnfOperationalStateType . 134g35.5.4.4 Enumeration: StopType 135g35.5.4.5

44、Enumeration: LcmOperationStateType . 135g35.5.4.6 Enumeration: CancelModeType . 135g35.6 Handling of errors during VNF lifecycle management operations . 136g35.6.1 Basic concepts (informative) 136g35.6.1.1 Motivation . 136g35.6.1.2 Failure resolution strategies: Retry and Rollback . 136g35.6.1.3 Err

45、or handling at VNFM and NFVO 137g35.6.2 States and state transitions of a VNF lifecycle management operation occurrence 138g35.6.2.1 General 138g35.6.2.2 States of a VNF lifecycle management operation occurrence . 138g35.6.2.3 Error handling operations that change the state of a VNF lifecycle manage

46、ment operation occurrence . 141g35.6.3 Detailed flows . 142g35.6.3.1 Immediate failure 142g35.6.3.2 Failure in “STARTING“ state . 142g35.6.3.3 Failure during actual LCM operation execution . 143g35.6.3.4 LCM operation cancellation 145g36 VNF Performance Management interface 145g36.1 Description . 14

47、5g36.2 Resource structure and methods . 145g36.3 Sequence diagrams (informative) . 147g36.3.1 Flow of creating a PM job 147g36.3.2 Flow of querying/reading PM jobs . 147g36.3.3 Flow of deleting a PM job 148g36.3.4 Flow of obtaining performance reports . 149g36.3.5 Flow of creating a threshold . 150g

48、36.3.6 Flow of querying/reading thresholds 150g36.3.7 Flow of deleting thresholds . 151g36.3.8 Flow of managing subscriptions . 152g36.3.9 Flow of sending notifications 153g36.4 Resources . 154g36.4.1 Introduction. 154g36.4.2 Resource: PM jobs 154g36.4.2.1 Description 154g36.4.2.2 Resource definitio

49、n . 154g36.4.2.3 Resource methods . 154g36.4.2.3.1 POST . 154g36.4.2.3.2 GET . 155g36.4.2.3.3 PUT . 156g36.4.2.3.4 PATCH 156g36.4.2.3.5 DELETE 156g36.4.3 Resource: Individual PM job 156g36.4.3.1 Description 156g36.4.3.2 Resource definition . 156g36.4.3.3 Resource methods . 157g36.4.3.3.1 POST . 157g36.4.3.3.2 GET . 157g36.4.3.3.3 PUT . 157g36.4.3.3.4 PATCH 157g36.4.3.3.5 DELETE 157g36.4.4 Resource: Individual performance report . 158g36.4.4.1 Description 158g36.4.4.2 Resource definition . 158g3ETSI ETSI GS NFV-SOL 003 V2.4.1 (2018-02)9 6.4.4.3 Resource methods . 158g36.4.4.3.1 P