ETSI TS 129 519-2018 5G 5G System Usage of the Unified Data Repository Service for Policy Data Application Data and Structured Data for Exposure Stage 3 (V15 0 0 3GPP TS 29 519 ver.pdf

1、 ETSI TS 129 519 V15.0.0 (2018-07) 5G; 5G System; Usage of the Unified Data Repository Service for Policy Data, Application Data and Structured Data for Exposure; Stage 3 (3GPP TS 29.519 version 15.0.0 Release 15) TECHNICAL SPECIFICATION ETSI ETSI TS 129 519 V15.0.0 (2018-07)13GPP TS 29.519 version

2、15.0.0 Release 15Reference DTS/TSGC-0329519vf00 Keywords 5G ETSI 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 Impo

3、rtant notice The present document can be downloaded from: http:/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

4、 authorization of ETSI. In case of any existing or perceived difference 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 s

5、hould be aware that the document may be subject to revision or change 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

6、following services: https:/portal.etsi.org/People/CommiteeSupportStaff.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

7、PDF version shall not be modified without the written authorization 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.

8、 3GPPTM and LTETMare trademarks of ETSI registered for the benefit 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 TS 129 519 V15.0.0 (2018-07)23

9、GPP TS 29.519 version 15.0.0 Release 15Intellectual Property Rights Essential patents IPRs essential or potentially essential to normative deliverables may have been declared to ETSI. The information pertaining to these essential IPRs, if any, is publicly available for ETSI members and non-members,

10、and can be found in ETSI SR 000 314: “Intellectual Property Rights (IPRs); Essential, or potentially Essential, IPRs notified to ETSI in respect of ETSI standards“, which is available from the ETSI Secretariat. Latest updates are available on the ETSI Web server (https:/ipr.etsi.org/). Pursuant to t

11、he ETSI IPR Policy, no investigation, including IPR searches, has been carried out by ETSI. No guarantee can be given as to the existence of other IPRs not referenced in ETSI SR 000 314 (or the updates on the ETSI Web server) which are, or may be, or may become, essential to the present document. Tr

12、ademarks The present document may include trademarks and/or tradenames which are asserted and/or registered by their owners. ETSI claims no ownership of these except for any which are indicated as being the property of ETSI, and conveys no right to use or reproduce any trademark and/or tradename. Me

13、ntion of those trademarks in the present document does not constitute an endorsement by ETSI of products, services or organizations associated with those trademarks. Foreword This Technical Specification (TS) has been produced by ETSI 3rd Generation Partnership Project (3GPP). The present document m

14、ay refer to technical specifications or reports using their 3GPP identities, UMTS identities or GSM identities. These should be interpreted as being references to the corresponding ETSI deliverables. The cross reference between GSM, UMTS, 3GPP and ETSI identities can be found under http:/webapp.etsi

15、.org/key/queryform.asp. Modal verbs terminology In the present document “shall“, “shall not“, “should“, “should not“, “may“, “need not“, “will“, “will not“, “can“ and “cannot“ are to be interpreted as described in clause 3.2 of the ETSI Drafting Rules (Verbal forms for the expression of provisions).

16、 “must“ and “must not“ are NOT allowed in ETSI deliverables except when used in direct citation. ETSI ETSI TS 129 519 V15.0.0 (2018-07)33GPP TS 29.519 version 15.0.0 Release 15Contents Intellectual Property Rights 2g3Foreword . 2g3Modal verbs terminology 2g3Foreword . 6g31 Scope 7g32 References 7g33

17、 Definitions and abbreviations . 7g33.1 Definitions 7g33.2 Abbreviations . 7g34 Overview 8g35 Usage of Nudr_DataRepository Service API for Policy Data 8g35.1 Introduction 8g35.2 Resources . 8g35.2.1 Overview 8g35.2.2 Resource Structure 8g35.2.3 Resource: AccessAndMobilityPolicies . 9g35.2.3.1 Descri

18、ption 9g35.2.3.2 Resource definition . 9g35.2.3.3 Resource Standard Methods 9g35.2.3.3.1 GET . 9g35.2.4 Resource: SessionManagementPolicies 9g35.2.4.1 Description 9g35.2.4.2 Resource definition . 9g35.2.4.3 Resource Standard Methods 10g35.2.4.3.1 GET . 10g35.2.5 Resource: UsageMonitoringInformation

19、10g35.2.5.1 Description 10g35.2.5.2 Resource definition . 10g35.2.5.3 Resource Standard Methods 10g35.2.5.3.1 PUT . 10g35.3 Notifications . 11g35.4 Data Model . 11g35.4.1 General 11g35.4.2 Structured data types . 12g35.4.2.1 Introduction . 12g35.4.2.2 Type 13g35.5 Error handling 14g35.6 Feature nego

20、tiation . 14g36 Usage of Nudr_DataRepository Service API for Application Data . 14g36.1 Introduction 14g36.2 Resources . 15g36.2.1 Overview 15g36.2.2 Resource Structure 15g36.2.3 Resource: PFD Data 16g36.2.3.1 Description 16g36.2.3.2 Resource definition . 16g36.2.3.3 Resource Standard Methods 17g36.

21、2.3.3.1 GET . 17g36.2.4 Resource: Individual PFD Data 17g36.2.4.1 Description 17g36.2.4.2 Resource definition . 17g36.2.4.3 Resource Standard Methods 17g36.2.4.3.1 GET . 17g3ETSI ETSI TS 129 519 V15.0.0 (2018-07)43GPP TS 29.519 version 15.0.0 Release 156.2.4.3.2 DELETE 18g36.2.4.3.3 PUT . 18g36.2.5

22、Resource: Influence Data 19g36.2.5.1 Description 19g36.2.5.2 Resource definition . 19g36.2.5.3 Resource Standard Methods 19g36.2.5.3.1 GET . 19g36.2.6 Resource: Individual Influence Data. 20g36.2.6.1 Description 20g36.2.6.2 Resource definition . 20g36.2.6.3 Resource Standard Methods 20g36.2.6.3.1 PU

23、T . 20g36.2.6.3.2 PATCH 20g36.2.6.3.3 DELETE 21g36.2.7 Resource: Influence Data Subscription . 21g36.2.7.1 Description 21g36.2.7.2 Resource definition . 21g36.2.7.3 Resource Standard Methods 22g36.2.7.3.1 POST . 22g36.2.7.3.2 GET . 22g36.2.8 Resource: Individual Influence Data Subscription . 23g36.2

24、.8.1 Description 23g36.2.8.2 Resource definition . 23g36.2.8.3 Resource Standard Methods 23g36.2.8.3.1 GET . 23g36.2.8.3.2 PUT . 23g36.2.8.3.3 DELETE 24g36.3 Notifications . 24g36.3.1 General 24g36.3.2 PFDs Update Notification . 25g36.3.3.2 Operation Definition . 25g36.4 Data Model . 26g36.4.1 Gener

25、al 26g36.4.2 Structured data types . 26g36.4.2.1 Introduction . 26g36.4.2.2 Type TrafficInfluData . 27g36.5 Error handling 28g36.6 Feature negotiation . 29g37 Usage of Nudr_DataRepository Service API for Structured Data for Exposure 29g37.1 Introduction 29g37.2 Resources . 29g37.2.1 Overview 29g37.2

26、.2 Resource Structure 29g37.2.3 Resource: AccessAndMobilityData 30g37.2.3.1 Description 30g37.2.3.2 Resource definition . 30g37.2.3.3 Resource Standard Methods 30g37.2.3.3.1 PUT . 30g37.2.3.3.2 GET . 31g37.2.3.3.3 DELETE 31g37.2.4 Resource: SessionManagementData . 32g37.2.4.1 Description 32g37.2.4.2

27、 Resource Definition 32g37.2.5 Resource: PduSessionManagementData . 32g37.2.5.1 Description 32g37.2.5.2 Resource definition . 32g37.2.5.3 Resource Standard Methods 32g37.2.5.3.1 PUT . 32g37.2.5.3.2 GET . 33g37.2.5.3.3 DELETE 33g37.3 Data Model . 34g3ETSI ETSI TS 129 519 V15.0.0 (2018-07)53GPP TS 29.

28、519 version 15.0.0 Release 157.3.1 General 34g37.3.2 Structured data types . 34g37.3.2.1 Introduction . 34g37.3.2.2 Type AccessAndMobilityData 35g37.3.2.3 Type PduSessionManagementData . 35g37.3.3 Simple data types and enumerations . 35g37.3.3.1 Introduction . 35g37.3.3.2 Simple data types 35g37.3.3

29、.2.1 Enumeration: PduSessionStatus 36g37.4 Error handling 36g37.5 Feature negotiation . 36g3Annex A (normative): OpenAPI specification . 37g3A.1 General . 37g3A.2 Nudr_DataRepository for Policy Data . 37g3A.3 Nudr_DataRepository for Application Data . 37g3A.4 Nudr_DataRepository for Exposure Data 37

30、g3Annex B (informative): Change history . 41g3History 42g3ETSI ETSI TS 129 519 V15.0.0 (2018-07)63GPP TS 29.519 version 15.0.0 Release 15Foreword This Technical Specification has been produced by the 3rdGeneration Partnership Project (3GPP). The contents of the present document are subject to contin

31、uing work within the TSG and may change following formal TSG approval. Should the TSG modify the contents of the present document, it will be re-released by the TSG with an identifying change of release date and an increase in version number as follows: Version x.y.z where: x the first digit: 1 pres

32、ented to TSG for information; 2 presented to TSG for approval; 3 or greater indicates TSG approved document under change control. y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, updates, etc. z the third digit is incremented when editorial on

33、ly changes have been incorporated in the document. ETSI ETSI TS 129 519 V15.0.0 (2018-07)73GPP TS 29.519 version 15.0.0 Release 151 Scope The present specification provides the stage 3 definition for the usage of the Unified Data Repository service (Nudr_DataRepository) of 5G System for Policy Data,

34、 Application Data and Structured Data for Exposure. The Unified Data Repository (UDR) provides the Unified Data Repository service. This service provides a repository for policy data, application data and exposure data.g32 References The following documents contain provisions which, through referenc

35、e in this text, constitute provisions of the present document. - References are either specific (identified by date of publication, edition number, version number, etc.) or non-specific. - For a specific reference, subsequent revisions do not apply. - For a non-specific reference, the latest version

36、 applies. In the case of a reference to a 3GPP document (including a GSM document), a non-specific reference implicitly refers to the latest version of that document in the same Release as the present document. 1 3GPP TR 21.905: “Vocabulary for 3GPP Specifications“. 2 3GPP TS 23.501: “System Archite

37、cture for the 5G System; Stage 2“. 3 3GPP TS 23.502: “Procedures for the 5G System; Stage 2“. 4 3GPP TS 29.500: “5G System; Technical Realization of Service Based Architecture; Stage 3“. 5 3GPP TS 29.501: “5G System; Principles and Guidelines for Services Definition; Stage 3“. 6 3GPP TS 29.504:“5G S

38、ystem; Unified Data Repository Services; Stage 3“. 7 3GPP TS 29.571: “5G System; Common Data Types for Service Based Interfaces Stage 3“. 8 3GPP TS 29.551: “5G System; Packet Flow Description Management Service; Stage 3“. 9 3GPP TS 29.122: “T8 reference point for Northbound APIs“. 10 3GPP TS 29.518:

39、 “5G System; Access and Mobility Management Services; Stage 3“. 3 Definitions and abbreviations 3.1 Definitions For the purposes of the present document, the terms and definitions given in 3GPP TR 21.905 1 and the following apply. A term defined in the present document takes precedence over the defi

40、nition of the same term, if any, in 3GPP TR 21.905 1. 3.2 Abbreviations For the purposes of the present document, the abbreviations given in 3GPP TR 21.905 1 and the following apply. An abbreviation defined in the present document takes precedence over the definition of the same abbreviation, if any

41、, in 3GPP TR 21.905 1. PCF Policy Control Function NEF Network Exposure Function UDR Unified Data Repository ETSI ETSI TS 129 519 V15.0.0 (2018-07)83GPP TS 29.519 version 15.0.0 Release 154 Overview 5 Usage of Nudr_DataRepository Service API for Policy Data 5.1 Introduction 5.2 Resources 5.2.1 Overv

42、iew 5.2.2 Resource Structure /apiRoot/nudr-dr/v1/policy-data/ue-id/am-policies/sm-policies/usageMonIdFigure 5.2.2-1: Resource URI structure of the Nudr_DataRepository API for policy data Table 5.2.2-1 provides an overview of the resources and applicable HTTP methods. Table 5.2.2-1: Resources and met

43、hods overview Resource name Resource URI HTTP method or custom operation Description AccessAndMobilityPolicies apiRoot/nudr-dr/v1/ue-id/am-policies GET Retrieves the access and mobility policy data for a subscriber. PUT(FFS) Modifies am-policies. SessionManagementPolicies apiRoot/nudr-dr/v1/ue-id/sm

44、-policies GET Retrieves the session management policy data for a subscriber. UsageMonitoringInformation apiRoot/nudr-dr/v1/ue-id/sm-policies/usageMonId GET Retrieve a usage monitoring resource. apiRoot/nudr-dr/v1/ue-id/sm-policies/usageMonId PUT Modify or create a usage monitoring resource apiRoot/n

45、udr-dr/v1/ue-id/sm-policies/usageMonId DELETE Delete a usage monitoring resource. ETSI ETSI TS 129 519 V15.0.0 (2018-07)93GPP TS 29.519 version 15.0.0 Release 155.2.3 Resource: AccessAndMobilityPolicies 5.2.3.1 Description The “am-policies“ resource represents all UE related mobility and access poli

46、cies attributes in the UDR for a given “ueId“. 5.2.3.2 Resource definition Resource URI: apiRoot/nudr-dr/v1/policy-data/ue-id/am-policies This resource shall support the resource URI variables defined in table 5.2.3.2-1. Table 5.2.3.2-1: Resource URI variables for this resource Name Definition apiRo

47、ot See 3GPP TS 29.504 6 subclause 6.1 ue-id Represents the Subscription Identifier SUPI or GPSI (see 3GPP TS 23.501 2 clause 5.9.2) pattern: “(imsi-0-95,15|nai-.+|msisdn-0-95,15|extid-.+|.+)“ 5.2.3.3 Resource Standard Methods 5.2.3.3.1 GET This method shall support the URI query parameters specified

48、 in table 5.2.3.3.1-1. Table 5.2.3.3.1-1: URI query parameters supported by the GET method on this resource Name Data type P Cardinality Description n/a This method shall support the request data structures specified in table 5.2.3.3.1-2 and the response data structures and response codes specified

49、in table 5.2.3.3.1-3. Table 5.2.3.3.1-2: Data structures supported by the GET Request Body on this resource Data type P Cardinality Description n/a Table 5.2.3.3.1-3: Data structures supported by the GET Response Body on this resource Data type P Cardinality Response codes Description AccessAndMobilityPolicies (FFS) M 1N 200 OK Upon success, a response body containing access and mobility policies shall be returned. 5.2.4 Resource: SessionManagementPolicies 5.2.4.1 Description The “sm-policies“ resourc