3gpp-29504-j20.docx资源-CSDN文库

3gpp

需积分: 5 170 浏览量 2025-03-23 10:08:44 上传评论收藏 692KB DOCX 举报

展开

资源推荐

资源详情

资源评论

3GPP TS 29.504 V19.2.0 (2025-03)

Technical Specification

3rd Generation Partnership Project;

Technical Specification Group Core Network and Terminals;

5G System; Unified Data Repository Services;

Stage 3

(Release 19)

The present document has been developed within the 3rd Generation Partnership Project (3GPP

) and may be further elaborated for the purposes of 3GPP.

The present document has not been subject to any approval process by the 3GPP

Organizational Partners and shall not be implemented.

This Specification is provided for future development work within 3GPP

only. The Organizational Partners accept no liability for any use of this Specification.

Specifications and Reports for implementation of the 3GPP

system should be obtained via the 3GPP Organizational Partners' Publications Offices.

3GPP

3GPP TS 29.504 V19.2.0 (2025-03)

Release 19

Contents

Foreword .............................................................................................................................................................6

1 Scope.........................................................................................................................................................7

2 References.................................................................................................................................................7

3 Definitions and abbreviations ...................................................................................................................8

3.1 Definitions ...........................................................................................................................................................8

3.2 Abbreviations.......................................................................................................................................................8

4 Overview...................................................................................................................................................8

5 Services offered by the UDR ....................................................................................................................9

5.1 Introduction .........................................................................................................................................................9

5.2 Nudr_DataRepository Service...........................................................................................................................10

5.2.1 Service Description......................................................................................................................................10

5.2.1.1 Service and operation description ..........................................................................................................10

5.2.1.2 Service operation and data access authorization ....................................................................................10

5.2.2 Service Operations .......................................................................................................................................11

5.2.2.1 Introduction ............................................................................................................................................11

5.2.2.2 Query......................................................................................................................................................11

5.2.2.2.1 General..............................................................................................................................................11

5.2.2.2.2 Data retrieval ....................................................................................................................................11

5.2.2.2.3 Retrieval of subset of a resource.......................................................................................................12

5.2.2.3 Create .....................................................................................................................................................13

5.2.2.3.1 General..............................................................................................................................................13

5.2.2.3.2 Data Creation using PUT..................................................................................................................14

5.2.2.3.3 Data Creation using POST ...............................................................................................................14

5.2.2.4 Delete .....................................................................................................................................................15

5.2.2.4.1 General..............................................................................................................................................15

5.2.2.4.2 Deleting Data....................................................................................................................................15

5.2.2.5 Update ....................................................................................................................................................15

5.2.2.5.1 General..............................................................................................................................................15

5.2.2.5.2 Data Update using PATCH ..............................................................................................................15

5.2.2.5.3 Data Update using PUT....................................................................................................................16

5.2.2.6 Subscribe ................................................................................................................................................16

5.2.2.6.1 General..............................................................................................................................................16

5.2.2.6.2 NF service consumer subscribes to notifications to UDR................................................................17

5.2.2.6.3 Stateless UDM subscribes to notifications to UDR..........................................................................17

5.2.2.7 Unsubscribe............................................................................................................................................18

5.2.2.7.1 General..............................................................................................................................................18

5.2.2.7.2 Unsubscribe service operation..........................................................................................................19

5.2.2.8 Notify .....................................................................................................................................................19

5.2.2.8.1 General..............................................................................................................................................19

5.2.2.8.2 Notification to NF service consumer on data change.......................................................................19

5.2.2.8.3 Notification to stateless UDM on data change .................................................................................20

5.2.2.9 DataRestorationNotification...................................................................................................................20

5.2.2.9.1 General..............................................................................................................................................20

5.2.2.9.2 Notification on Data Restoration......................................................................................................20

5.3 Nudr_GroupIDmap Service...............................................................................................................................21

5.3.1 Service Description......................................................................................................................................21

5.3.1.1 Service and operation description ..........................................................................................................21

5.3.2 Service Operations .......................................................................................................................................21

5.3.2.1 Introduction ............................................................................................................................................21

5.3.2.2 Query......................................................................................................................................................22

5.3.2.2.1 General..............................................................................................................................................22

5.3.2.2.2 NF Group ID retrieval ......................................................................................................................22

5.3.2.3 QueryRID ...............................................................................................................................................22

5.3.2.3.1 General..............................................................................................................................................22

5.3.2.3.2 Routing IDs retrieval ........................................................................................................................22

3GPP

3GPP TS 29.504 V19.2.0 (2025-03)

Release 19

5.3.2.4 Subscribe ................................................................................................................................................23

5.3.2.4.1 General..............................................................................................................................................23

5.3.2.4.2 NF service consumer subscribes to notifications to UDR................................................................23

5.3.2.5 Unsubscribe............................................................................................................................................24

5.3.2.5.1 General..............................................................................................................................................24

5.3.2.5.2 Unsubscribe service operation..........................................................................................................24

5.3.2.6 Notify .....................................................................................................................................................24

5.3.2.6.1 General..............................................................................................................................................24

5.3.2.6.2 Notification to NF service consumer on data change.......................................................................24

6 API Definitions .......................................................................................................................................25

6.1 Nudr_DataRepository Service API ...................................................................................................................25

6.1.1 API URI .......................................................................................................................................................25

6.1.2 Usage of HTTP ............................................................................................................................................25

6.1.2.1 General ...................................................................................................................................................25

6.1.2.2 HTTP standard headers ..........................................................................................................................26

6.1.2.2.1 General..............................................................................................................................................26

6.1.2.2.2 Content type......................................................................................................................................26

6.1.2.2.3 Cache-Control...................................................................................................................................26

6.1.2.2.4 ETag..................................................................................................................................................26

6.1.2.2.5 If-None-Match ..................................................................................................................................26

6.1.2.2.5a If-Match ............................................................................................................................................26

6.1.2.2.6 Last-Modified ...................................................................................................................................26

6.1.2.2.7 If-Modified-Since .............................................................................................................................27

6.1.2.2.8 When to Use Entity-Tags and Last-Modified Dates.........................................................................27

6.1.2.3 HTTP custom headers ............................................................................................................................27

6.1.2.3.1 General..............................................................................................................................................27

6.1.2.3.2 3gpp-Sbi-Message-Priority...............................................................................................................27

6.1.2.3.3 3gpp-Sbi-Notification-Correlation ...................................................................................................27

6.1.2.3.4 3gpp-Sbi-Etags .................................................................................................................................27

6.1.3 Resources .....................................................................................................................................................28

6.1.3.1 Overview ................................................................................................................................................28

6.1.3.2 SubscriptionData ....................................................................................................................................29

6.1.3.3 PolicyData ..............................................................................................................................................29

6.1.3.4 StructuredDataForExposure ...................................................................................................................29

6.1.3.5 ApplicationData .....................................................................................................................................29

6.1.3.6 Resource: DataRestorationEvents ..........................................................................................................29

6.1.3.6.1 Description........................................................................................................................................29

6.1.3.6.2 Resource Definition..........................................................................................................................29

6.1.3.6.3 Resource Standard Methods .............................................................................................................29

6.1.4 Custom Operations without associated resources........................................................................................30

6.1.5 Notifications.................................................................................................................................................30

6.1.5.1 General ...................................................................................................................................................30

6.1.5.2 Data Change Notification.......................................................................................................................30

6.1.5.3 Data Restoration Notification.................................................................................................................30

6.1.5a Data Model...................................................................................................................................................32

6.1.5a.1 General ...................................................................................................................................................32

6.1.5a.2 Structured data types ..............................................................................................................................32

6.1.5a.2.1 Introduction ......................................................................................................................................32

6.1.5a.2.2 Type: DataRestorationNotification...................................................................................................33

6.1.6 Error Handling .............................................................................................................................................33

6.1.7 Security ........................................................................................................................................................34

6.1.8 Feature negotiation.......................................................................................................................................39

6.2 Nudr_GroupIDmap Service API .......................................................................................................................44

6.2.1 API URI .......................................................................................................................................................44

6.2.2 Usage of HTTP ............................................................................................................................................45

6.2.2.1 General ...................................................................................................................................................45

6.2.2.2 HTTP standard headers ..........................................................................................................................45

6.2.2.2.1 General..............................................................................................................................................45

6.2.2.2.2 Content type......................................................................................................................................45

6.2.2.2.3 Cache-Control...................................................................................................................................45

6.2.2.2.4 ETag..................................................................................................................................................45

3GPP

3GPP TS 29.504 V19.2.0 (2025-03)

Release 19

6.2.2.2.5 If-None-Match ..................................................................................................................................45

6.2.2.2.6 Last-Modified ...................................................................................................................................45

6.2.2.2.7 If-Modified-Since .............................................................................................................................46

6.2.2.2.8 When to Use Entity-Tags and Last-Modified Dates.........................................................................46

6.2.2.3 HTTP custom headers ............................................................................................................................46

6.2.2.3.1 General..............................................................................................................................................46

6.2.3 Resources .....................................................................................................................................................46

6.2.3.1 Overview ................................................................................................................................................46

6.2.3.2 Resource NfGroupIds.............................................................................................................................47

6.2.3.2.1 Description........................................................................................................................................47

6.2.3.2.2 Resource Definition..........................................................................................................................47

6.2.3.2.3 Resource Standard Methods .............................................................................................................47

6.2.3.3 Resource RoutingIds ..............................................................................................................................48

6.2.3.3.1 Description........................................................................................................................................48

6.2.3.3.2 Resource Definition..........................................................................................................................48

6.2.3.3.3 Resource Standard Methods .............................................................................................................48

6.2.3.4 Resource Subscriptions ..........................................................................................................................48

6.2.3.4.1 Description........................................................................................................................................48

6.2.3.4.2 Resource Definition..........................................................................................................................48

6.2.3.4.3 Resource Standard Methods .............................................................................................................49

6.2.3.5 Resource IndividualSubscription ...........................................................................................................49

6.2.3.5.1 Description........................................................................................................................................49

6.2.3.5.2 Resource Definition..........................................................................................................................49

6.2.3.5.3 Resource Standard Methods .............................................................................................................49

6.2.4 Custom Operations without associated resources........................................................................................51

6.2.5 Notifications.................................................................................................................................................51

6.2.5.1 General ...................................................................................................................................................51

6.2.5.2 Data Change Notification.......................................................................................................................51

6.2.6 Data Model...................................................................................................................................................52

6.2.6.1 General ...................................................................................................................................................52

6.2.6.2 Structured data types ..............................................................................................................................52

6.2.6.2.1 Introduction ......................................................................................................................................52

6.2.6.2.2 Type: NfGroupIdMapResult.............................................................................................................52

6.2.6.2.3 Type: RoutingIdResult .....................................................................................................................53

6.2.6.2.4 Type: SubscriptionData ....................................................................................................................53

6.2.6.2.5 Type: GroupIdMapNotify.................................................................................................................54

6.2.6.3 Simple data types and enumerations ......................................................................................................54

6.2.6.3.1 Introduction ......................................................................................................................................54

6.2.6.3.2 Simple data types..............................................................................................................................54

6.2.7 Error Handling .............................................................................................................................................55

6.2.7.1 General ...................................................................................................................................................55

6.2.7.2 Protocol Errors .......................................................................................................................................55

6.2.7.3 Application Errors ..................................................................................................................................55

6.2.8 Security ........................................................................................................................................................55

6.2.9 Feature Negotiation......................................................................................................................................55

Annex A (normative): OpenAPI specification ...................................................................................56

A.1 General....................................................................................................................................................56

A.2 Nudr_DataRepository API......................................................................................................................56

A.3 Nudr_GroupIDmap API .........................................................................................................................63

Annex B (Normative): ABNF grammar for 3GPP SBI HTTP custom headers..............................70

B.1 General....................................................................................................................................................70

B.2 ABNF definitions (Filename: "TS29504_CustomHeaders.abnf") .........................................................70

Annex C (informative): Change history................................................................................................72