Tech-invite 3GPPspace IETF RFCs SIP

index 21 22 23 24 25 26 27 28 29 31 32 33 34 35 36 37 38 4‑5x

Content for TS 29.575 Word version: 18.0.0

1… 4…

4.1 Introduction 4.2 Nadrf_DataManagement Service 5.1 Nadrf_DataManagement Service API A.1 General A.2 Nadrf_DataManagement API

4 Services offered by the ADRF p. 10

4.1 Introduction p. 9

4.2 Nadrf_DataManagement Service p. 10

4.2.1 Service Description p. 10

4.2.1.1 Overview p. 10

4.2.1.2 Service Architecture p. 10

4.2.1.3 Network Functions p. 11

4.2.1.3.1 Analytics Data Repository Function (ADRF) p. 11

4.2.1.3.2 NF Service Consumers p. 11

4.2.2 Service Operations p. 12

4.2.2.1 Introduction p. 12

4.2.2.2 Nadrf_DataManagement_StorageRequest service operation p. 12

4.2.2.2.1 General p. 12

4.2.2.2.2 Request Storage of data or analytics p. 12

4.2.2.3 Nadrf_DataManagement_StorageSubscriptionRequest service operation p. 13

4.2.2.3.1 General p. 13

4.2.2.3.2 Requesting subscription and storage of data or analytics p. 13

4.2.2.4 Nadrf_DataManagement_StorageSubscriptionRemoval service operation p. 15

4.2.2.4.1 General p. 15

4.2.2.4.2 Requesting removal of subscription of data or analytics p. 15

4.2.2.5 Nadrf_DataManagement_RetrievalRequest service operation p. 15

4.2.2.5.1 General p. 15

4.2.2.5.2 Request and get stored data or analytics from ADRF Data Store p. 15

4.2.2.6 Nadrf_DataManagement_RetrievalSubscribe service operation p. 16

4.2.2.6.1 General p. 16

4.2.2.6.2 Requesting retrieval and subscription of data or analytics p. 16

4.2.2.7 Nadrf_DataManagement_RetrievalUnsubscribe service operation p. 17

4.2.2.7.1 General p. 17

4.2.2.7.2 Requesting removal of retrieval subscription for data or analytics p. 18

4.2.2.8 Nadrf_DataManagement_RetrievalNotify service operation p. 18

4.2.2.8.1 General p. 18

4.2.2.8.2 Notification about subscribed data or analytics p. 18

4.2.2.9 Nadrf_DataManagement_Delete service operation p. 20

4.2.2.9.1 General p. 20

4.2.2.9.2 Requesting removal of stored data or analytics p. 20

4.2.2.9.3 Requesting removal of stored data or analytics using data or analytics specification p. 20

5 API Definitions p. 21

5.1 Nadrf_DataManagement Service API p. 21

5.1.1 Introduction p. 21

5.1.2 Usage of HTTP p. 22

5.1.2.1 General p. 22

5.1.2.2 HTTP standard headers p. 22

5.1.2.2.1 General p. 22

5.1.2.2.2 Content type p. 22

5.1.2.3 HTTP custom headers p. 22

5.1.3 Resources p. 22

5.1.3.1 Overview p. 22

5.1.3.2 Resource: ADRF Data Store Records p. 23

5.1.3.2.1 Description p. 23

5.1.3.2.2 Resource Definition p. 23

5.1.3.2.3 Resource Standard Methods p. 23

5.1.3.2.3.1 POST p. 23

5.1.3.2.3.2 GET p. 24

5.1.3.2.4 Resource Custom Operations p. 24

5.1.3.3 Resource: Individual ADRF Data Store Record p. 25

5.1.3.3.1 Description p. 25

5.1.3.3.2 Resource Definition p. 25

5.1.3.3.3 Resource Standard Methods p. 25

5.1.3.3.3.1 DELETE p. 25

5.1.3.3.4 Resource Custom Operations p. 26

5.1.3.4 Resource: ADRF Data Retrieval Subscriptions p. 26

5.1.3.4.1 Description p. 26

5.1.3.4.2 Resource Definition p. 26

5.1.3.4.3 Resource Standard Methods p. 26

5.1.3.4.3.1 POST p. 26

5.1.3.4.4 Resource Custom Operations p. 27

5.1.3.5 Resource: Individual ADRF Data Retrieval Subscription p. 27

5.1.3.5.1 Description p. 27

5.1.3.5.2 Resource Definition p. 27

5.1.3.5.3 Resource Standard Methods p. 27

5.1.3.5.3.1 DELETE p. 27

5.1.3.5.4 Resource Custom Operations p. 28

5.1.4 Custom Operations without associated resources p. 28

5.1.4.1 Overview p. 28

5.1.4.2 Operation: request-storage-sub p. 29

5.1.4.2.1 Description p. 29

5.1.4.2.2 Operation Definition p. 29

5.1.4.3 Operation: request-storage-sub-removal p. 30

5.1.4.3.1 Description p. 30

5.1.4.3.2 Operation Definition p. 30

5.1.4.4 Operation: remove-stored-data-analytics p. 30

5.1.4.4.1 Description p. 30

5.1.4.4.2 Operation Definition p. 30

5.1.5 Notifications p. 31

5.1.5.1 General p. 31

5.1.5.2 Retrieval Notification p. 31

5.1.5.2.1 Description p. 31

5.1.5.2.2 Target URI p. 31

5.1.5.2.3 Standard Methods p. 31

5.1.5.2.3.1 POST p. 31

5.1.6 Data Model p. 32

5.1.6.1 General p. 32

5.1.6.2 Structured data types p. 35

5.1.6.2.1 Introduction p. 35

5.1.6.2.2 Type: NadrfDataStoreRecord p. 35

5.1.6.2.3 Type: NadrfDataStoreSubscription p. 36

5.1.6.2.4 Type: NadrfDataRetrievalSubscription p. 37

5.1.6.2.5 Type: NadrfDataRetrievalNotification p. 38

5.1.6.2.6 Type: NadrfDataStoreSubscriptionRef p. 38

5.1.6.2.7 Type: NadrfStoredDataSpec p. 39

5.1.6.2.8 Type: DataSubscription p. 39

5.1.6.2.9 Type: DataNotification p. 40

5.1.6.3 Simple data types and enumerations p. 40

5.1.6.4 Data types describing alternative data types or combinations of data types p. 40

5.1.7 Error Handling p. 40

5.1.7.1 General p. 40

5.1.7.2 Protocol Errors p. 40

5.1.7.3 Application Errors p. 40

5.1.8 Feature negotiation p. 41

5.1.9 Security p. 41

A (Normative) OpenAPI specification p. 42

A.1 General p. 42

A.2 Nadrf_DataManagement API p. 42

$ Change history p. 52