Content for TS 29.510 Word version: 18.7.0
6 API Definitions
6.1 Nnrf_NFManagement Service API
6.2 Nnrf_NFDiscovery Service API
6.3 Nnrf_AccessToken Service API
6.4 Nnrf_Bootstrapping Service API
6 API Definitions p. 57
6.1 Nnrf_NFManagement Service API p. 57
6.1.1 API URI p. 57
6.1.2 Usage of HTTP p. 57
6.1.2.1 General p. 57
6.1.2.2 HTTP standard headers p. 57
6.1.2.2.1 General p. 57
6.1.2.2.2 Content type p. 57
6.1.2.2.3 Accept-Encoding p. 57
6.1.2.2.4 ETag |R16| p. 57
6.1.2.2.5 If-Match |R16| p. 58
6.1.2.3 HTTP custom headers p. 58
6.1.2.3.1 General p. 58
6.1.3 Resources p. 58
6.1.3.1 Overview p. 58
6.1.3.2 Resource: nf-instances (Store) p. 59
6.1.3.2.1 Description p. 59
6.1.3.2.2 Resource Definition p. 60
6.1.3.2.3 Resource Standard Methods p. 60
6.1.3.2.4 Resource Custom Operations p. 64
6.1.3.3 Resource: nf-instance (Document) p. 64
6.1.3.3.1 Description p. 64
6.1.3.3.2 Resource Definition p. 64
6.1.3.3.3 Resource Standard Methods p. 65
6.1.3.4 Resource: subscriptions (Collection) p. 71
6.1.3.4.1 Description p. 71
6.1.3.4.2 Resource Definition p. 71
6.1.3.4.3 Resource Standard Methods p. 71
6.1.3.5 Resource: subscription (Document) p. 73
6.1.3.5.1 Description p. 73
6.1.3.5.2 Resource Definition p. 73
6.1.3.5.3 Resource Standard Methods p. 73
6.1.3.6 Resource: shared-data (Document) |R18| p. 75
6.1.3.6.1 Description p. 75
6.1.3.6.2 Resource Definition p. 75
6.1.3.6.3 Resource Standard Methods p. 76
6.1.3.7 Resource: shared-data-store (Store) |R18| p. 82
6.1.4 Custom Operations without associated resources p. 82
6.1.5 Notifications p. 83
6.1.6 Data Model p. 84
6.1.6.1 General p. 84
6.1.6.2 Structured data types p. 90
6.1.6.2.1 Introduction p. 90
6.1.6.2.2 Type: NFProfile p. 91
6.1.6.2.3 Type: NFService p. 103
6.1.6.2.4 Type: DefaultNotificationSubscription p. 112
6.1.6.2.5 Type: IpEndPoint p. 114
6.1.6.2.6 Type: UdrInfo p. 115
6.1.6.2.7 Type: UdmInfo p. 116
6.1.6.2.8 Type: AusfInfo p. 117
6.1.6.2.9 Type: SupiRange p. 118
6.1.6.2.10 Type: IdentityRange p. 118
6.1.6.2.11 Type: AmfInfo p. 119
6.1.6.2.12 Type: SmfInfo p. 121
6.1.6.2.13 Type: UpfInfo p. 123
6.1.6.2.14 Type: SnssaiUpfInfoItem p. 125
6.1.6.2.15 Type: DnnUpfInfoItem p. 126
6.1.6.2.16 Type: SubscriptionData p. 127
6.1.6.2.17 Type: NotificationData p. 132
6.1.6.2.18 Void
6.1.6.2.19 Type: NFServiceVersion p. 134
6.1.6.2.20 Type: PcfInfo p. 135
6.1.6.2.21 Type: BsfInfo p. 136
6.1.6.2.22 Type: Ipv4AddressRange p. 137
6.1.6.2.23 Type: Ipv6PrefixRange p. 137
6.1.6.2.24 Type: InterfaceUpfInfoItem p. 137
6.1.6.2.25 Type: UriList p. 138
6.1.6.2.26 Type: N2InterfaceAmfInfo p. 138
6.1.6.2.27 Type: TaiRange p. 138
6.1.6.2.28 Type: TacRange p. 139
6.1.6.2.29 Type: SnssaiSmfInfoItem p. 139
6.1.6.2.30 Type: DnnSmfInfoItem p. 140
6.1.6.2.31 Type: NrfInfo p. 141
6.1.6.2.32 Type: ChfInfo p. 144
6.1.6.2.33 Void
6.1.6.2.34 Type: PlmnRange p. 145
6.1.6.2.35 Type: SubscrCond p. 146
6.1.6.2.36 Type: NfInstanceIdCond p. 146
6.1.6.2.37 Type: NfTypeCond p. 147
6.1.6.2.38 Type: ServiceNameCond p. 147
6.1.6.2.39 Type: AmfCond p. 147
6.1.6.2.40 Type: GuamiListCond p. 147
6.1.6.2.41 Type: NetworkSliceCond p. 147
6.1.6.2.42 Type: NfGroupCond p. 148
6.1.6.2.43 Type: NotifCondition p. 148
6.1.6.2.44 Type: PlmnSnssai p. 148
6.1.6.2.45 Type: NwdafInfo |R16| p. 149
6.1.6.2.46 Type: LmfInfo |R16| p. 150
6.1.6.2.47 Type: GmlcInfo |R16| p. 151
6.1.6.2.48 Type: NefInfo |R16| p. 152
6.1.6.2.49 Type: PfdData |R16| p. 153
6.1.6.2.50 Type: AfEventExposureData |R16| p. 153
6.1.6.2.51 Type: WAgfInfo |R16| p. 153
6.1.6.2.52 Type: TngfInfo |R16| p. 154
6.1.6.2.53 Type: PcscfInfo |R16| p. 154
6.1.6.2.54 Type: NfSetCond |R16| p. 155
6.1.6.2.55 Type: NfServiceSetCond |R16| p. 155
6.1.6.2.56 Type: NfInfo |R16| p. 155
6.1.6.2.57 Type: HssInfo |R16| p. 156
6.1.6.2.58 Type: ImsiRange |R16| p. 156
6.1.6.2.59 Type: InternalGroupIdRange |R16| p. 157
6.1.6.2.60 Type: UpfCond |R16| p. 157
6.1.6.2.61 Type: TwifInfo |R16| p. 157
6.1.6.2.62 Type: VendorSpecificFeature |R16| p. 158
6.1.6.2.63 Type: UdsfInfo |R16| p. 158
6.1.6.2.64 Type: NfInstanceIdListCond |R16| p. 158
6.1.6.2.65 Type: ScpInfo |R16| p. 159
6.1.6.2.66 Type: ScpDomainInfo |R16| p. 161
6.1.6.2.67 Type: ScpDomainCond |R16| p. 161
6.1.6.2.68 Type: OptionsResponse |R16| p. 162
6.1.6.2.69 Type: NwdafCond |R16| p. 162
6.1.6.2.70 Type: NefCond |R16| p. 163
6.1.6.2.71 Type: SuciInfo |R17| p. 163
6.1.6.2.72 Type: SeppInfo |R17| p. 164
6.1.6.2.73 Type: AanfInfo |R17| p. 164
6.1.6.2.74 Type: 5GDdnmfInfo |R17| p. 164
6.1.6.2.75 Type: MfafInfo |R17| p. 165
6.1.6.2.76 Type: NwdafCapability |R17| p. 166
6.1.6.2.77 Type: EasdfInfo |R17| p. 167
6.1.6.2.78 Type: SnssaiEasdfInfoItem |R17| p. 167
6.1.6.2.79 Type: DnnEasdfInfoItem |R17| p. 168
6.1.6.2.80 Type: DccfInfo |R17| p. 168
6.1.6.2.81 Type: NsacfInfo |R17| p. 169
6.1.6.2.82 Type: NsacfCapability |R17| p. 171
6.1.6.2.83 Type: DccfCond |R17| p. 172
6.1.6.2.84 Type: MlAnalyticsInfo |R17| p. 173
6.1.6.2.85 Type: MbSmfInfo |R17| p. 174
6.1.6.2.86 Type: TmgiRange |R17| p. 174
6.1.6.2.87 Type: MbsSession |R17| p. 175
6.1.6.2.88 Type: SnssaiMbSmfInfoItem |R17| p. 175
6.1.6.2.89 Type: DnnMbSmfInfoItem |R17| p. 175
6.1.6.2.90 Void
6.1.6.2.91 Type: TsctsfInfo |R17| p. 176
6.1.6.2.92 Type: SnssaiTsctsfInfoItem |R17| p. 176
6.1.6.2.93 Type: DnnTsctsfInfoItem |R17| p. 176
6.1.6.2.94 Type: MbUpfInfo |R17| p. 177
6.1.6.2.95 Type: UnTrustAfInfo |R17| p. 178
6.1.6.2.96 Type: TrustAfInfo |R17| p. 178
6.1.6.2.97 Type: SnssaiInfoItem |R17| p. 179
6.1.6.2.98 Type: DnnInfoItem |R17| p. 179
6.1.6.2.99 Type: CollocatedNfInstance |R17| p. 179
6.1.6.2.100 Type: ServiceNameListCond |R17| p. 179
6.1.6.2.101 Type: NfGroupListCond |R17| p. 180
6.1.6.2.102 Type: PlmnOauth2 |R17| p. 180
6.1.6.2.103 Type: V2xCapability |R17| p. 180
6.1.6.2.104 Type: NssaafInfo |R17| p. 181
6.1.6.2.105 Type: ProSeCapability |R17| p. 182
6.1.6.2.106 Type: SharedDataIdRange |R17| p. 183
6.1.6.2.107 Type: SubscriptionContext |R17| p. 183
6.1.6.2.108 Type: IwmscInfo |R17| p. 183
6.1.6.2.109 Type: MnpfInfo |R17| p. 184
6.1.6.2.110 Type: DefSubServiceInfo |R17| p. 184
6.1.6.2.111 Type: LocalityDescriptionItem |R18| p. 184
6.1.6.2.112 Type: LocalityDescription |R18| p. 184
6.1.6.2.113 Type: SmsfInfo |R18| p. 185
6.1.6.2.114 Type: DcsfInfo |R18| p. 185
6.1.6.2.115 Type: MlModelInterInfo |R18| p. 185
6.1.6.2.116 Type: PruExistenceInfo |R18| p. 186
6.1.6.2.117 Type: MrfInfo |R18| p. 186
6.1.6.2.118 Type: MrfpInfo |R18| p. 186
6.1.6.2.119 Type: MfInfo |R18| p. 186
6.1.6.2.120 Type: A2xCapability |R18| p. 187
6.1.6.2.121 Type: RuleSet |R18| p. 188
6.1.6.2.122 Type: AdrfInfo |R18| p. 189
6.1.6.2.123 Type: SelectionConditions |R18| p. 189
6.1.6.2.124 Type: ConditionItem |R18| p. 190
6.1.6.2.125 Type: ConditionGroup |R18| p. 191
6.1.6.2.126 Type: EpdgInfo |R18| p. 191
6.1.6.2.127 Type: CallbackUriPrefixItem |R18| p. 191
6.1.6.2.128 Type: SharedData |R18| p. 192
6.1.6.2.129 Type: NFProfileRegistrationError |R18| p. 192
6.1.6.2.130 Type: SharedDataIdList |R18| p. 193
6.1.6.2.131 Type: PortRange |R18| p. 193
6.1.6.2.132 Type: SharedScope |R18| p. 193
6.1.6.3 Simple data types and enumerations p. 193
6.1.6.3.1 Introduction p. 193
6.1.6.3.2 Simple data types p. 193
6.1.6.3.3 Enumeration: NFType p. 194
6.1.6.3.4 Enumeration: NotificationType p. 197
6.1.6.3.5 Enumeration: TransportProtocol p. 199
6.1.6.3.6 Enumeration: NotificationEventType p. 199
6.1.6.3.7 Enumeration: NFStatus p. 199
6.1.6.3.8 Enumeration: DataSetId p. 199
6.1.6.3.9 Enumeration: UPInterfaceType p. 201
6.1.6.3.10 Relation Types p. 201
6.1.6.3.11 Enumeration: ServiceName p. 202
6.1.6.3.12 Enumeration: NFServiceStatus p. 205
6.1.6.3.13 Enumeration: AnNodeType |R16| p. 205
6.1.6.3.14 Enumeration: ConditionEventType |R16| p. 205
6.1.6.3.15 Enumeration: IpReachability |R16| p. 206
6.1.6.3.16 Enumeration: ScpCapability |R17| p. 206
6.1.6.3.17 Enumeration: CollocatedNfType |R17| p. 206
6.1.6.3.18 Enumeration: LocalityType |R18| p. 206
6.1.6.3.19 Enumeration: FlCapabilityType |R18| p. 206
6.1.6.3.20 Void
6.1.6.3.21 Enumeration: RuleSetAction |R18| p. 207
6.1.6.3.22 Enumeration: DnsSecurityProtocol |R18| p. 207
6.1.7 Error Handling p. 207
6.1.8 Security p. 208
6.1.9 Features supported by the NFManagement service |R16| p. 208
6.2 Nnrf_NFDiscovery Service API p. 209
6.2.1 API URI p. 209
6.2.2 Usage of HTTP p. 210
6.2.2.1 General p. 210
6.2.2.2 HTTP standard headers p. 210
6.2.2.2.1 General p. 210
6.2.2.2.2 Content type p. 210
6.2.2.2.3 Cache-Control p. 210
6.2.2.2.4 ETag p. 210
6.2.2.2.5 If-None-Match p. 210
6.2.2.3 HTTP custom headers p. 210
6.2.2.3.1 General p. 210
6.2.3 Resources p. 211
6.2.3.1 Overview p. 211
6.2.3.2 Resource: nf-instances (Store) p. 212
6.2.3.2.1 Description p. 212
6.2.3.2.2 Resource Definition p. 212
6.2.3.2.3 Resource Standard Methods p. 212
6.2.3.2.4 Resource Custom Operations p. 236
6.2.3.3 Resource: Stored Search (Document) |R16| p. 236
6.2.3.3.1 Description p. 236
6.2.3.3.2 Resource Definition p. 236
6.2.3.4 Resource: Complete Stored Search (Document) |R16| p. 237
6.2.3.4.1 Description p. 237
6.2.3.4.2 Resource Definition p. 237
6.2.3.5 Resource: SCP Domain Routing Information (Document) |R17| p. 238
6.2.3.5.1 Description p. 238
6.2.3.5.2 Resource Definition p. 238
6.2.3.6 Resource: SCP Domain Routing Information Subscriptions (Collection) |R17| p. 239
6.2.3.6.1 Description p. 239
6.2.3.6.2 Resource Definition p. 239
6.2.3.6.3 Resource Standard Methods p. 239
6.2.3.7 Resource: Individual SCP Domain Routing Information Subscription (Document) |R17| p. 240
6.2.3.7.1 Description p. 240
6.2.3.7.2 Resource Definition p. 240
6.2.3.7.3 Resource Standard Methods p. 240
6.2.4 Custom Operations without associated resources p. 241
6.2.5 Notifications p. 241
6.2.5.1 General |R17| p. 241
6.2.5.2 SCP Domain Routing Information Change Notification |R17| p. 241
6.2.5.2.1 Description p. 241
6.2.5.2.2 Notification Definition p. 241
6.2.6 Data Model p. 242
6.2.6.1 General p. 242
6.2.6.2 Structured data types p. 245
6.2.6.2.1 Introduction p. 245
6.2.6.2.2 Type: SearchResult p. 246
6.2.6.2.3 Type: NFProfile p. 248
6.2.6.2.4 Type: NFService p. 257
6.2.6.2.5 Type: StoredSearchResult |R16| p. 263
6.2.6.2.6 Type: PreferredSearch |R16| p. 264
6.2.6.2.7 Type: NfInstanceInfo |R17| p. 266
6.2.6.2.8 Type: ScpDomainRoutingInformation |R17| p. 266
6.2.6.2.9 Type: ScpDomainConnectivity |R17| p. 267
6.2.6.2.10 Type: ScpDomainRoutingInfoSubscription |R17| p. 267
6.2.6.2.11 Type: ScpDomainRoutingInfoNotification |R17| p. 268
6.2.6.2.12 Type: NfServiceInstance |R17| p. 268
6.2.6.2.13 Type: NoProfileMatchInfo |R17| p. 268
6.2.6.2.14 Type: QueryParamCombination |R17| p. 268
6.2.6.2.15 Type: QueryParameter |R17| p. 268
6.2.6.2.16 Type: AfData |R18| p. 269
6.2.6.2.17 Type: SearchResultInfo |R18| p. 269
6.2.6.3 Simple data types and enumerations p. 269
6.2.7 Error Handling p. 270
6.2.8 Security p. 270
6.2.9 Features supported by the NFDiscovery service p. 271
6.3 Nnrf_AccessToken Service API p. 276
6.3.1 General p. 276
6.3.2 API URI p. 276
6.3.3 Usage of HTTP p. 276
6.3.3.1 General p. 276
6.3.3.2 HTTP standard headers p. 276
6.3.3.2.1 General p. 276
6.3.3.2.2 Content type p. 276
6.3.3.3 HTTP custom headers p. 277
6.3.3.3.1 General p. 277
6.3.4 Custom Operations without associated resources p. 277
6.3.4.1 Overview p. 277
6.3.4.2 Operation: Get (Access Token Request) p. 277
6.3.4.2.1 Description p. 277
6.3.4.2.2 Operation Definition p. 277
6.3.5 Data Model p. 279
6.3.5.1 General p. 279
6.3.5.2 Structured data types p. 279
6.3.5.2.1 Introduction p. 279
6.3.5.2.2 Type: AccessTokenReq p. 280
6.3.5.2.3 Type: AccessTokenRsp p. 283
6.3.5.2.4 Type: AccessTokenClaims p. 284
6.3.5.2.5 Type: AccessTokenErr |R16| p. 285
6.3.5.2.6 Type: MlModelInterInd |R18| p. 286
6.3.5.3 Simple data types and enumerations p. 286
6.3.5.4 Data types describing alternative data types or combinations of data types p. 286
6.3.5.4.1 Type: Audience p. 286
6.3.6 Error Handling |R17| p. 286
6.4 Nnrf_Bootstrapping Service API |R16| p. 287
6.4.1 API URI p. 287
6.4.2 Usage of HTTP p. 287
6.4.2.1 General p. 287
6.4.2.2 HTTP standard headers p. 287
6.4.2.2.1 General p. 287
6.4.2.2.2 Content type p. 287
6.4.2.2.3 Cache-Control |R17| p. 287
6.4.2.2.4 ETag |R17| p. 288
6.4.2.2.5 If-None-Match |R17| p. 288
6.4.2.3 HTTP custom headers p. 288
6.4.2.3.1 General p. 288
6.4.3 Resources p. 288
6.4.3.1 Overview p. 288
6.4.3.2 Resource: Bootstrapping (Document) p. 288
6.4.3.2.1 Description p. 288
6.4.3.2.2 Resource Definition p. 289
6.4.3.2.3 Resource Standard Methods p. 289
6.4.4 Custom Operations without associated resources p. 289
6.4.5 Notifications p. 289
6.4.6 Data Model p. 290
6.4.6.1 General p. 290
6.4.6.2 Structured data types p. 290
6.4.6.2.1 Introduction p. 290
6.4.6.2.2 Type: BootstrappingInfo p. 291
6.4.6.3 Simple data types and enumerations p. 291
