End a Spending Limit Control Subscription
delete
{apiRoot}/nchf-spendinglimitcontrol/v1/subscriptions/{subscriptionId}
Ends an existing spending limit control subscription for a specified subscriber.
Request
Path Parameters
-
subscriptionId(required): string
Identifies an individual spending limit retrieval subscription.
There's no request body for this operation.
Back to TopResponse
204 Response
The spending limit control subscription was ended succesfully.
307 Response
The request should be repeated with another URI; however, future requests should still use the original URI
Headers
-
3gpp-Sbi-Target-Nf-Id:
Identifier of target NF (service) instance towards which the request is redirected
-
Location(required):
The URI pointing to the resource located on the redirect target
Root Schema : RedirectResponse
Type:
objectThe response should include a Location header field containing a different URI (pointing to a different URI of an other service instance), or the same URI if a request is redirected to the same target resource via a different SCP.
Show Source
-
cause: string
-
targetScp: string
String providing a URI formatted according to RFC 3986.
-
targetSepp: string
String providing a URI formatted according to RFC 3986.
308 Response
The current and all future requests should be directed to the given URI.
Headers
-
3gpp-Sbi-Target-Nf-Id:
'Identifier of target NF (service) instance towards which the request is redirected'
-
Location(required):
The URI pointing to the resource located on the redirect target
Root Schema : RedirectResponse
Type:
objectThe response should include a Location header field containing a different URI (pointing to a different URI of an other service instance), or the same URI if a request is redirected to the same target resource via a different SCP.
Show Source
-
cause: string
-
targetScp: string
String providing a URI formatted according to RFC 3986.
-
targetSepp: string
String providing a URI formatted according to RFC 3986.
400 Response
The request could not be processed because it contains missing or invalid information (such as a validation error on a parameter or a missing required value).
Root Schema : ProblemDetails
Type:
objectProvides additional information in an error response.
Show Source
-
accessTokenError: object
AccessTokenErr
Error returned in the access token response message.
-
accessTokenRequest: object
AccessTokenReq
Contains information related to an access token request.
-
cause: string
A machine-readable application error cause specific to this occurrence of the problem. This IE should be present and provide application-related error information if available.
-
detail: string
A human-readable explanation specific to this occurrence of the problem.
-
instance: string
String providing a URI formatted according to RFC 3986.
-
invalidParams: array
invalidParams
Minimum Number of Items:
1 -
nrfId: string
Minimum Length:
4Maximum Length:253Pattern:^([0-9A-Za-z]([-0-9A-Za-z]{0,61}[0-9A-Za-z])?\.)+[A-Za-z]{2,63}\.?$Fully Qualified Domain Name. -
status: integer
-
supportedFeatures: string
Pattern:
^[A-Fa-f0-9]*$A string indicating the features supported by an API, as defined in clause 6.6 in 3GPP TS 29.500. The string should contain a bitmask indicating supported features in hexadecimal representation. Each character in the string takes a value between "0" to "9", "a" to "f" or "A" to "F" and represents the support of 4 features, as described in table 5.2.2-3. The most significant character, representing the highest-numbered features, appears first in the string, and the character representing features 1 to 4 appear last in the string. The list of features and their numbering (starting from 1) is defined separately for each API. If the string contains fewer number of characters than the total number of defined features for an API, all features that are represented by characters missing in the string are not supported. -
title: string
-
type: string
String providing a URI formatted according to RFC 3986.
Nested Schema : AccessTokenErr
Type:
objectError returned in the access token response message.
Show Source
-
error(required): string
Allowed Values:
[ "invalid_request", "invalid_client", "invalid_grant", "unauthorized_client", "unsupported_grant_type", "invalid_scope" ] -
error_description: string
-
error_uri: string
Nested Schema : AccessTokenReq
Type:
objectContains information related to an access token request.
Show Source
-
grant_type(required): string
Allowed Values:
[ "client_credentials" ] -
hnrfAccessTokenUri: string
String providing a URI formatted according to RFC 3986.
-
nfInstanceId(required): string
(uuid)
String uniquely identifying an NF instance. The format of the NF Instance ID should be a Universally Unique Identifier (UUID) version 4, as described in IETF RFC 4122.
-
nfType: string
Allowed Values:
[ "NRF", "UDM", "AMF", "SMF", "AUSF", "NEF", "PCF", "SMSF", "NSSF", "UDR", "LMF", "GMLC", "5G_EIR", "SEPP", "UPF", "N3IWF", "AF", "UDSF", "BSF", "CHF", "NWDAF", "PCSCF", "CBCF", "HSS", "UCMF", "SOR_AF", "SPAF", "MME", "SCSAS", "SCEF", "SCP", "NSSAAF", "ICSCF", "SCSCF", "DRA", "IMS_AS", "AANF", "5G_DDNMF", "NSACF", "MFAF", "EASDF", "DCCF", "MB_SMF", "TSCTSF", "ADRF", "GBA_BSF", "CEF", "MB_UPF", "NSWOF", "PKMF", "MNPF", "SMS_GMSC", "SMS_IWMSC", "MBSF", "MBSTF", "PANF", "IP_SM_GW", "SMS_ROUTER" ]NF types known to NRF. -
requesterFqdn: string
Minimum Length:
4Maximum Length:253Pattern:^([0-9A-Za-z]([-0-9A-Za-z]{0,61}[0-9A-Za-z])?\.)+[A-Za-z]{2,63}\.?$Fully Qualified Domain Name. -
requesterPlmn: object
PlmnId
When PlmnId needs to be converted to string (e.g. when used in maps as key), the string should be composed of three digit "mcc" followed by "-" and two or three digit "mnc".
-
requesterPlmnList: array
requesterPlmnList
Minimum Number of Items:
2 -
requesterSnpnList: array
requesterSnpnList
Minimum Number of Items:
1 -
requesterSnssaiList: array
requesterSnssaiList
Minimum Number of Items:
1 -
scope(required): string
Pattern:
^([a-zA-Z0-9_:-]+)( [a-zA-Z0-9_:-]+)*$ -
sourceNfInstanceId: string
(uuid)
String uniquely identifying an NF instance. The format of the NF Instance ID should be a Universally Unique Identifier (UUID) version 4, as described in IETF RFC 4122.
-
targetNfInstanceId: string
(uuid)
String uniquely identifying an NF instance. The format of the NF Instance ID should be a Universally Unique Identifier (UUID) version 4, as described in IETF RFC 4122.
-
targetNfServiceSetId: string
NF Service Set Identifier (see clause 28.12 of 3GPP TS 23.003) formatted as the following string "set
.sn .nfi .5gc.mnc .mcc ", or encoded as defined in clause 5.4.2 ("Mcc" data type definition) encoding the Mobile Network Code part of the PLMN, comprising 3 digits. If there are only 2 significant digits in the MNC, one "0" digit should be inserted at the left side to fill the 3 digit coding of MNC. Pattern: '^[0-9]{3}$' encoded as defined in clause 5.4.2 ("Nid" data type definition). encoded as defined in clause 5.3.2. encoded as defined in 3GPP TS 29.510. encoded as a string of characters consisting of alphabetic characters (A-Z and a-z), digits (0-9), and/or the hyphen (-) and that should end with either an alphabetic character or a digit. -
targetNfSetId: string
NF Set Identifier (see clause 28.12 of 3GPP TS 23.003), formatted as the following string "set
. set.5gc.mnc .mcc ", or "set . set.5gc.nid .mnc .mcc " with encoded as defined in clause 5.4.2 ("Mcc" data type definition) encoding the Mobile Network Code part of the PLMN, comprising 3 digits. If there are only 2 significant digits in the MNC, one "0" digit should be inserted at the left side to fill the 3 digit coding of MNC. Pattern: '^[0-9]{3}$' encoded as a value defined in Table 6.1.6.3.3-1 of 3GPP TS 29.510 but with lower case characters encoded as a string of characters consisting of alphabetic characters (A-Z and a-z), digits (0-9), and/or the hyphen (-) and that should end with either an alphabetic character or a digit. -
targetNfType: string
Allowed Values:
[ "NRF", "UDM", "AMF", "SMF", "AUSF", "NEF", "PCF", "SMSF", "NSSF", "UDR", "LMF", "GMLC", "5G_EIR", "SEPP", "UPF", "N3IWF", "AF", "UDSF", "BSF", "CHF", "NWDAF", "PCSCF", "CBCF", "HSS", "UCMF", "SOR_AF", "SPAF", "MME", "SCSAS", "SCEF", "SCP", "NSSAAF", "ICSCF", "SCSCF", "DRA", "IMS_AS", "AANF", "5G_DDNMF", "NSACF", "MFAF", "EASDF", "DCCF", "MB_SMF", "TSCTSF", "ADRF", "GBA_BSF", "CEF", "MB_UPF", "NSWOF", "PKMF", "MNPF", "SMS_GMSC", "SMS_IWMSC", "MBSF", "MBSTF", "PANF", "IP_SM_GW", "SMS_ROUTER" ]NF types known to NRF. -
targetNsiList: array
targetNsiList
Minimum Number of Items:
1 -
targetPlmn: object
PlmnId
When PlmnId needs to be converted to string (e.g. when used in maps as key), the string should be composed of three digit "mcc" followed by "-" and two or three digit "mnc".
-
targetSnpn: object
PlmnIdNid
Contains the serving core network operator PLMN ID. For an SNPN, the NID together with the PLMN ID identifies the SNPN.
-
targetSnssaiList: array
targetSnssaiList
Minimum Number of Items:
1
Nested Schema : invalidParams
Type:
arrayMinimum Number of Items:
Show Source
1-
Array of:
object InvalidParam
It contains an invalid parameter and a related description.
Nested Schema : PlmnId
Type:
objectWhen PlmnId needs to be converted to string (e.g. when used in maps as key), the string should be composed of three digit "mcc" followed by "-" and two or three digit "mnc".
Show Source
-
mcc(required): string
Pattern:
^\d{3}$Mobile Country Code is a part of the PLMN, comprising 3 digits, as defined in clause 9.3.3.5 of 3GPP TS 38.413. -
mnc(required): string
Pattern:
^\d{2,3}$Mobile Network Code is a part of the PLMN, comprising 2 or 3 digits, as defined in clause 9.3.3.5 of 3GPP TS 38.413.
Nested Schema : requesterPlmnList
Type:
arrayMinimum Number of Items:
Show Source
2-
Array of:
object PlmnId
When PlmnId needs to be converted to string (e.g. when used in maps as key), the string should be composed of three digit "mcc" followed by "-" and two or three digit "mnc".
Nested Schema : requesterSnpnList
Type:
arrayMinimum Number of Items:
Show Source
1-
Array of:
object PlmnIdNid
Contains the serving core network operator PLMN ID. For an SNPN, the NID together with the PLMN ID identifies the SNPN.
Nested Schema : requesterSnssaiList
Type:
arrayMinimum Number of Items:
Show Source
1-
Array of:
object Snssai
When Snssai needs to be converted to string (e.g. when used in maps as key), the string should be composed of one to three digit "sst" optionally followed by "-" and 6 hexadecimal digit "sd".
Nested Schema : PlmnIdNid
Type:
objectContains the serving core network operator PLMN ID. For an SNPN, the NID together with the PLMN ID identifies the SNPN.
Show Source
-
mcc(required): string
Pattern:
^\d{3}$Mobile Country Code is a part of the PLMN, comprising 3 digits, as defined in clause 9.3.3.5 of 3GPP TS 38.413. -
mnc(required): string
Pattern:
^\d{2,3}$Mobile Network Code is a part of the PLMN, comprising 2 or 3 digits, as defined in clause 9.3.3.5 of 3GPP TS 38.413. -
nid: string
Pattern:
^[A-Fa-f0-9]{11}$This represents the Network Identifier, which together with a PLMN ID is used to identify an SNPN (see 3GPP TS 23.003 and 3GPP TS 23.501 clause 5.30.2.1).
Nested Schema : targetSnssaiList
Type:
arrayMinimum Number of Items:
Show Source
1-
Array of:
object Snssai
When Snssai needs to be converted to string (e.g. when used in maps as key), the string should be composed of one to three digit "sst" optionally followed by "-" and 6 hexadecimal digit "sd".
Nested Schema : Snssai
Type:
objectWhen Snssai needs to be converted to string (e.g. when used in maps as key), the string should be composed of one to three digit "sst" optionally followed by "-" and 6 hexadecimal digit "sd".
Show Source
-
sd: string
Pattern:
^[A-Fa-f0-9]{6}$3-octet string representing the Slice Differentiator in hexadecimal format. Each character in the string should take a value from "0" to "9", from "a" to "f", or from "A" to "F" and should represent 4 bits. The most significant character representing the 4 most significant bits of the SD should appear first in the string, and the character representing the 4 least significant bit of the SD shall appear last in the string. This is an optional parameter that complements the Slice/Service type(s) to allow to differentiate amongst multiple Network Slices of the same Slice/Service type. This IE should be absent if no SD value is associated with the SST. -
sst(required): integer
Minimum Value:
0Maximum Value:255Unsigned integer, within the range 0 to 255, representing the Slice/Service Type. It indicates the expected Network Slice behaviour in terms of features and services. Values from 0 to 127 correspond to the standardized SST range and values from 128 to 255 correspond to the Operator-specific range. See clause 28.4.2 of 3GPP TS 23.003. Standardized values are defined in clause 5.15.2.2 of 3GPP TS 23.501.
Nested Schema : InvalidParam
Type:
objectIt contains an invalid parameter and a related description.
Show Source
-
param(required): string
If the invalid parameter is an attribute in a JSON body, this IE should contain the attribute's name and be encoded as a JSON Pointer. If the invalid parameter is an HTTP header, this IE should be formatted as the concatenation of the string "header" plus the header name. If the invalid parameter is a query parameter, this IE should be formatted as the concatenation of the string "query " plus the query parameter name. If the invalid parameter is a variable part of a resource URI path, this IE should contain the variable name, including the "{" and "}" symbols used in the OpenAPI specification to represent variable path segments.
-
reason: string
A human-readable reason, for example, "must be a positive integer". In cases involving failed operations in a PATCH request, the reason string should identify the failed operation that using the operation's array index to help correlate the invalid parameter with the failed operation, for example, " Replacement value invalid for attribute (failed operation index= 4)."
401 Response
The request is not authorized. The authentication credentials included with this request are missing or invalid.
Root Schema : ProblemDetails
Type:
objectProvides additional information in an error response.
Show Source
-
accessTokenError: object
AccessTokenErr
Error returned in the access token response message.
-
accessTokenRequest: object
AccessTokenReq
Contains information related to an access token request.
-
cause: string
A machine-readable application error cause specific to this occurrence of the problem. This IE should be present and provide application-related error information if available.
-
detail: string
A human-readable explanation specific to this occurrence of the problem.
-
instance: string
String providing a URI formatted according to RFC 3986.
-
invalidParams: array
invalidParams
Minimum Number of Items:
1 -
nrfId: string
Minimum Length:
4Maximum Length:253Pattern:^([0-9A-Za-z]([-0-9A-Za-z]{0,61}[0-9A-Za-z])?\.)+[A-Za-z]{2,63}\.?$Fully Qualified Domain Name. -
status: integer
-
supportedFeatures: string
Pattern:
^[A-Fa-f0-9]*$A string indicating the features supported by an API, as defined in clause 6.6 in 3GPP TS 29.500. The string should contain a bitmask indicating supported features in hexadecimal representation. Each character in the string takes a value between "0" to "9", "a" to "f" or "A" to "F" and represents the support of 4 features, as described in table 5.2.2-3. The most significant character, representing the highest-numbered features, appears first in the string, and the character representing features 1 to 4 appear last in the string. The list of features and their numbering (starting from 1) is defined separately for each API. If the string contains fewer number of characters than the total number of defined features for an API, all features that are represented by characters missing in the string are not supported. -
title: string
-
type: string
String providing a URI formatted according to RFC 3986.
Nested Schema : AccessTokenErr
Type:
objectError returned in the access token response message.
Show Source
-
error(required): string
Allowed Values:
[ "invalid_request", "invalid_client", "invalid_grant", "unauthorized_client", "unsupported_grant_type", "invalid_scope" ] -
error_description: string
-
error_uri: string
Nested Schema : AccessTokenReq
Type:
objectContains information related to an access token request.
Show Source
-
grant_type(required): string
Allowed Values:
[ "client_credentials" ] -
hnrfAccessTokenUri: string
String providing a URI formatted according to RFC 3986.
-
nfInstanceId(required): string
(uuid)
String uniquely identifying an NF instance. The format of the NF Instance ID should be a Universally Unique Identifier (UUID) version 4, as described in IETF RFC 4122.
-
nfType: string
Allowed Values:
[ "NRF", "UDM", "AMF", "SMF", "AUSF", "NEF", "PCF", "SMSF", "NSSF", "UDR", "LMF", "GMLC", "5G_EIR", "SEPP", "UPF", "N3IWF", "AF", "UDSF", "BSF", "CHF", "NWDAF", "PCSCF", "CBCF", "HSS", "UCMF", "SOR_AF", "SPAF", "MME", "SCSAS", "SCEF", "SCP", "NSSAAF", "ICSCF", "SCSCF", "DRA", "IMS_AS", "AANF", "5G_DDNMF", "NSACF", "MFAF", "EASDF", "DCCF", "MB_SMF", "TSCTSF", "ADRF", "GBA_BSF", "CEF", "MB_UPF", "NSWOF", "PKMF", "MNPF", "SMS_GMSC", "SMS_IWMSC", "MBSF", "MBSTF", "PANF", "IP_SM_GW", "SMS_ROUTER" ]NF types known to NRF. -
requesterFqdn: string
Minimum Length:
4Maximum Length:253Pattern:^([0-9A-Za-z]([-0-9A-Za-z]{0,61}[0-9A-Za-z])?\.)+[A-Za-z]{2,63}\.?$Fully Qualified Domain Name. -
requesterPlmn: object
PlmnId
When PlmnId needs to be converted to string (e.g. when used in maps as key), the string should be composed of three digit "mcc" followed by "-" and two or three digit "mnc".
-
requesterPlmnList: array
requesterPlmnList
Minimum Number of Items:
2 -
requesterSnpnList: array
requesterSnpnList
Minimum Number of Items:
1 -
requesterSnssaiList: array
requesterSnssaiList
Minimum Number of Items:
1 -
scope(required): string
Pattern:
^([a-zA-Z0-9_:-]+)( [a-zA-Z0-9_:-]+)*$ -
sourceNfInstanceId: string
(uuid)
String uniquely identifying an NF instance. The format of the NF Instance ID should be a Universally Unique Identifier (UUID) version 4, as described in IETF RFC 4122.
-
targetNfInstanceId: string
(uuid)
String uniquely identifying an NF instance. The format of the NF Instance ID should be a Universally Unique Identifier (UUID) version 4, as described in IETF RFC 4122.
-
targetNfServiceSetId: string
NF Service Set Identifier (see clause 28.12 of 3GPP TS 23.003) formatted as the following string "set
.sn .nfi .5gc.mnc .mcc ", or encoded as defined in clause 5.4.2 ("Mcc" data type definition) encoding the Mobile Network Code part of the PLMN, comprising 3 digits. If there are only 2 significant digits in the MNC, one "0" digit should be inserted at the left side to fill the 3 digit coding of MNC. Pattern: '^[0-9]{3}$' encoded as defined in clause 5.4.2 ("Nid" data type definition). encoded as defined in clause 5.3.2. encoded as defined in 3GPP TS 29.510. encoded as a string of characters consisting of alphabetic characters (A-Z and a-z), digits (0-9), and/or the hyphen (-) and that should end with either an alphabetic character or a digit. -
targetNfSetId: string
NF Set Identifier (see clause 28.12 of 3GPP TS 23.003), formatted as the following string "set
. set.5gc.mnc .mcc ", or "set . set.5gc.nid .mnc .mcc " with encoded as defined in clause 5.4.2 ("Mcc" data type definition) encoding the Mobile Network Code part of the PLMN, comprising 3 digits. If there are only 2 significant digits in the MNC, one "0" digit should be inserted at the left side to fill the 3 digit coding of MNC. Pattern: '^[0-9]{3}$' encoded as a value defined in Table 6.1.6.3.3-1 of 3GPP TS 29.510 but with lower case characters encoded as a string of characters consisting of alphabetic characters (A-Z and a-z), digits (0-9), and/or the hyphen (-) and that should end with either an alphabetic character or a digit. -
targetNfType: string
Allowed Values:
[ "NRF", "UDM", "AMF", "SMF", "AUSF", "NEF", "PCF", "SMSF", "NSSF", "UDR", "LMF", "GMLC", "5G_EIR", "SEPP", "UPF", "N3IWF", "AF", "UDSF", "BSF", "CHF", "NWDAF", "PCSCF", "CBCF", "HSS", "UCMF", "SOR_AF", "SPAF", "MME", "SCSAS", "SCEF", "SCP", "NSSAAF", "ICSCF", "SCSCF", "DRA", "IMS_AS", "AANF", "5G_DDNMF", "NSACF", "MFAF", "EASDF", "DCCF", "MB_SMF", "TSCTSF", "ADRF", "GBA_BSF", "CEF", "MB_UPF", "NSWOF", "PKMF", "MNPF", "SMS_GMSC", "SMS_IWMSC", "MBSF", "MBSTF", "PANF", "IP_SM_GW", "SMS_ROUTER" ]NF types known to NRF. -
targetNsiList: array
targetNsiList
Minimum Number of Items:
1 -
targetPlmn: object
PlmnId
When PlmnId needs to be converted to string (e.g. when used in maps as key), the string should be composed of three digit "mcc" followed by "-" and two or three digit "mnc".
-
targetSnpn: object
PlmnIdNid
Contains the serving core network operator PLMN ID. For an SNPN, the NID together with the PLMN ID identifies the SNPN.
-
targetSnssaiList: array
targetSnssaiList
Minimum Number of Items:
1
Nested Schema : invalidParams
Type:
arrayMinimum Number of Items:
Show Source
1-
Array of:
object InvalidParam
It contains an invalid parameter and a related description.
Nested Schema : PlmnId
Type:
objectWhen PlmnId needs to be converted to string (e.g. when used in maps as key), the string should be composed of three digit "mcc" followed by "-" and two or three digit "mnc".
Show Source
-
mcc(required): string
Pattern:
^\d{3}$Mobile Country Code is a part of the PLMN, comprising 3 digits, as defined in clause 9.3.3.5 of 3GPP TS 38.413. -
mnc(required): string
Pattern:
^\d{2,3}$Mobile Network Code is a part of the PLMN, comprising 2 or 3 digits, as defined in clause 9.3.3.5 of 3GPP TS 38.413.
Nested Schema : requesterPlmnList
Type:
arrayMinimum Number of Items:
Show Source
2-
Array of:
object PlmnId
When PlmnId needs to be converted to string (e.g. when used in maps as key), the string should be composed of three digit "mcc" followed by "-" and two or three digit "mnc".
Nested Schema : requesterSnpnList
Type:
arrayMinimum Number of Items:
Show Source
1-
Array of:
object PlmnIdNid
Contains the serving core network operator PLMN ID. For an SNPN, the NID together with the PLMN ID identifies the SNPN.
Nested Schema : requesterSnssaiList
Type:
arrayMinimum Number of Items:
Show Source
1-
Array of:
object Snssai
When Snssai needs to be converted to string (e.g. when used in maps as key), the string should be composed of one to three digit "sst" optionally followed by "-" and 6 hexadecimal digit "sd".
Nested Schema : PlmnIdNid
Type:
objectContains the serving core network operator PLMN ID. For an SNPN, the NID together with the PLMN ID identifies the SNPN.
Show Source
-
mcc(required): string
Pattern:
^\d{3}$Mobile Country Code is a part of the PLMN, comprising 3 digits, as defined in clause 9.3.3.5 of 3GPP TS 38.413. -
mnc(required): string
Pattern:
^\d{2,3}$Mobile Network Code is a part of the PLMN, comprising 2 or 3 digits, as defined in clause 9.3.3.5 of 3GPP TS 38.413. -
nid: string
Pattern:
^[A-Fa-f0-9]{11}$This represents the Network Identifier, which together with a PLMN ID is used to identify an SNPN (see 3GPP TS 23.003 and 3GPP TS 23.501 clause 5.30.2.1).
Nested Schema : targetSnssaiList
Type:
arrayMinimum Number of Items:
Show Source
1-
Array of:
object Snssai
When Snssai needs to be converted to string (e.g. when used in maps as key), the string should be composed of one to three digit "sst" optionally followed by "-" and 6 hexadecimal digit "sd".
Nested Schema : Snssai
Type:
objectWhen Snssai needs to be converted to string (e.g. when used in maps as key), the string should be composed of one to three digit "sst" optionally followed by "-" and 6 hexadecimal digit "sd".
Show Source
-
sd: string
Pattern:
^[A-Fa-f0-9]{6}$3-octet string representing the Slice Differentiator in hexadecimal format. Each character in the string should take a value from "0" to "9", from "a" to "f", or from "A" to "F" and should represent 4 bits. The most significant character representing the 4 most significant bits of the SD should appear first in the string, and the character representing the 4 least significant bit of the SD shall appear last in the string. This is an optional parameter that complements the Slice/Service type(s) to allow to differentiate amongst multiple Network Slices of the same Slice/Service type. This IE should be absent if no SD value is associated with the SST. -
sst(required): integer
Minimum Value:
0Maximum Value:255Unsigned integer, within the range 0 to 255, representing the Slice/Service Type. It indicates the expected Network Slice behaviour in terms of features and services. Values from 0 to 127 correspond to the standardized SST range and values from 128 to 255 correspond to the Operator-specific range. See clause 28.4.2 of 3GPP TS 23.003. Standardized values are defined in clause 5.15.2.2 of 3GPP TS 23.501.
Nested Schema : InvalidParam
Type:
objectIt contains an invalid parameter and a related description.
Show Source
-
param(required): string
If the invalid parameter is an attribute in a JSON body, this IE should contain the attribute's name and be encoded as a JSON Pointer. If the invalid parameter is an HTTP header, this IE should be formatted as the concatenation of the string "header" plus the header name. If the invalid parameter is a query parameter, this IE should be formatted as the concatenation of the string "query " plus the query parameter name. If the invalid parameter is a variable part of a resource URI path, this IE should contain the variable name, including the "{" and "}" symbols used in the OpenAPI specification to represent variable path segments.
-
reason: string
A human-readable reason, for example, "must be a positive integer". In cases involving failed operations in a PATCH request, the reason string should identify the failed operation that using the operation's array index to help correlate the invalid parameter with the failed operation, for example, " Replacement value invalid for attribute (failed operation index= 4)."
403 Response
The user can't be authenticated. The user does not have authorization to perform this request.
Root Schema : ProblemDetails
Type:
objectProvides additional information in an error response.
Show Source
-
accessTokenError: object
AccessTokenErr
Error returned in the access token response message.
-
accessTokenRequest: object
AccessTokenReq
Contains information related to an access token request.
-
cause: string
A machine-readable application error cause specific to this occurrence of the problem. This IE should be present and provide application-related error information if available.
-
detail: string
A human-readable explanation specific to this occurrence of the problem.
-
instance: string
String providing a URI formatted according to RFC 3986.
-
invalidParams: array
invalidParams
Minimum Number of Items:
1 -
nrfId: string
Minimum Length:
4Maximum Length:253Pattern:^([0-9A-Za-z]([-0-9A-Za-z]{0,61}[0-9A-Za-z])?\.)+[A-Za-z]{2,63}\.?$Fully Qualified Domain Name. -
status: integer
-
supportedFeatures: string
Pattern:
^[A-Fa-f0-9]*$A string indicating the features supported by an API, as defined in clause 6.6 in 3GPP TS 29.500. The string should contain a bitmask indicating supported features in hexadecimal representation. Each character in the string takes a value between "0" to "9", "a" to "f" or "A" to "F" and represents the support of 4 features, as described in table 5.2.2-3. The most significant character, representing the highest-numbered features, appears first in the string, and the character representing features 1 to 4 appear last in the string. The list of features and their numbering (starting from 1) is defined separately for each API. If the string contains fewer number of characters than the total number of defined features for an API, all features that are represented by characters missing in the string are not supported. -
title: string
-
type: string
String providing a URI formatted according to RFC 3986.
Nested Schema : AccessTokenErr
Type:
objectError returned in the access token response message.
Show Source
-
error(required): string
Allowed Values:
[ "invalid_request", "invalid_client", "invalid_grant", "unauthorized_client", "unsupported_grant_type", "invalid_scope" ] -
error_description: string
-
error_uri: string
Nested Schema : AccessTokenReq
Type:
objectContains information related to an access token request.
Show Source
-
grant_type(required): string
Allowed Values:
[ "client_credentials" ] -
hnrfAccessTokenUri: string
String providing a URI formatted according to RFC 3986.
-
nfInstanceId(required): string
(uuid)
String uniquely identifying an NF instance. The format of the NF Instance ID should be a Universally Unique Identifier (UUID) version 4, as described in IETF RFC 4122.
-
nfType: string
Allowed Values:
[ "NRF", "UDM", "AMF", "SMF", "AUSF", "NEF", "PCF", "SMSF", "NSSF", "UDR", "LMF", "GMLC", "5G_EIR", "SEPP", "UPF", "N3IWF", "AF", "UDSF", "BSF", "CHF", "NWDAF", "PCSCF", "CBCF", "HSS", "UCMF", "SOR_AF", "SPAF", "MME", "SCSAS", "SCEF", "SCP", "NSSAAF", "ICSCF", "SCSCF", "DRA", "IMS_AS", "AANF", "5G_DDNMF", "NSACF", "MFAF", "EASDF", "DCCF", "MB_SMF", "TSCTSF", "ADRF", "GBA_BSF", "CEF", "MB_UPF", "NSWOF", "PKMF", "MNPF", "SMS_GMSC", "SMS_IWMSC", "MBSF", "MBSTF", "PANF", "IP_SM_GW", "SMS_ROUTER" ]NF types known to NRF. -
requesterFqdn: string
Minimum Length:
4Maximum Length:253Pattern:^([0-9A-Za-z]([-0-9A-Za-z]{0,61}[0-9A-Za-z])?\.)+[A-Za-z]{2,63}\.?$Fully Qualified Domain Name. -
requesterPlmn: object
PlmnId
When PlmnId needs to be converted to string (e.g. when used in maps as key), the string should be composed of three digit "mcc" followed by "-" and two or three digit "mnc".
-
requesterPlmnList: array
requesterPlmnList
Minimum Number of Items:
2 -
requesterSnpnList: array
requesterSnpnList
Minimum Number of Items:
1 -
requesterSnssaiList: array
requesterSnssaiList
Minimum Number of Items:
1 -
scope(required): string
Pattern:
^([a-zA-Z0-9_:-]+)( [a-zA-Z0-9_:-]+)*$ -
sourceNfInstanceId: string
(uuid)
String uniquely identifying an NF instance. The format of the NF Instance ID should be a Universally Unique Identifier (UUID) version 4, as described in IETF RFC 4122.
-
targetNfInstanceId: string
(uuid)
String uniquely identifying an NF instance. The format of the NF Instance ID should be a Universally Unique Identifier (UUID) version 4, as described in IETF RFC 4122.
-
targetNfServiceSetId: string
NF Service Set Identifier (see clause 28.12 of 3GPP TS 23.003) formatted as the following string "set
.sn .nfi .5gc.mnc .mcc ", or encoded as defined in clause 5.4.2 ("Mcc" data type definition) encoding the Mobile Network Code part of the PLMN, comprising 3 digits. If there are only 2 significant digits in the MNC, one "0" digit should be inserted at the left side to fill the 3 digit coding of MNC. Pattern: '^[0-9]{3}$' encoded as defined in clause 5.4.2 ("Nid" data type definition). encoded as defined in clause 5.3.2. encoded as defined in 3GPP TS 29.510. encoded as a string of characters consisting of alphabetic characters (A-Z and a-z), digits (0-9), and/or the hyphen (-) and that should end with either an alphabetic character or a digit. -
targetNfSetId: string
NF Set Identifier (see clause 28.12 of 3GPP TS 23.003), formatted as the following string "set
. set.5gc.mnc .mcc ", or "set . set.5gc.nid .mnc .mcc " with encoded as defined in clause 5.4.2 ("Mcc" data type definition) encoding the Mobile Network Code part of the PLMN, comprising 3 digits. If there are only 2 significant digits in the MNC, one "0" digit should be inserted at the left side to fill the 3 digit coding of MNC. Pattern: '^[0-9]{3}$' encoded as a value defined in Table 6.1.6.3.3-1 of 3GPP TS 29.510 but with lower case characters encoded as a string of characters consisting of alphabetic characters (A-Z and a-z), digits (0-9), and/or the hyphen (-) and that should end with either an alphabetic character or a digit. -
targetNfType: string
Allowed Values:
[ "NRF", "UDM", "AMF", "SMF", "AUSF", "NEF", "PCF", "SMSF", "NSSF", "UDR", "LMF", "GMLC", "5G_EIR", "SEPP", "UPF", "N3IWF", "AF", "UDSF", "BSF", "CHF", "NWDAF", "PCSCF", "CBCF", "HSS", "UCMF", "SOR_AF", "SPAF", "MME", "SCSAS", "SCEF", "SCP", "NSSAAF", "ICSCF", "SCSCF", "DRA", "IMS_AS", "AANF", "5G_DDNMF", "NSACF", "MFAF", "EASDF", "DCCF", "MB_SMF", "TSCTSF", "ADRF", "GBA_BSF", "CEF", "MB_UPF", "NSWOF", "PKMF", "MNPF", "SMS_GMSC", "SMS_IWMSC", "MBSF", "MBSTF", "PANF", "IP_SM_GW", "SMS_ROUTER" ]NF types known to NRF. -
targetNsiList: array
targetNsiList
Minimum Number of Items:
1 -
targetPlmn: object
PlmnId
When PlmnId needs to be converted to string (e.g. when used in maps as key), the string should be composed of three digit "mcc" followed by "-" and two or three digit "mnc".
-
targetSnpn: object
PlmnIdNid
Contains the serving core network operator PLMN ID. For an SNPN, the NID together with the PLMN ID identifies the SNPN.
-
targetSnssaiList: array
targetSnssaiList
Minimum Number of Items:
1
Nested Schema : invalidParams
Type:
arrayMinimum Number of Items:
Show Source
1-
Array of:
object InvalidParam
It contains an invalid parameter and a related description.
Nested Schema : PlmnId
Type:
objectWhen PlmnId needs to be converted to string (e.g. when used in maps as key), the string should be composed of three digit "mcc" followed by "-" and two or three digit "mnc".
Show Source
-
mcc(required): string
Pattern:
^\d{3}$Mobile Country Code is a part of the PLMN, comprising 3 digits, as defined in clause 9.3.3.5 of 3GPP TS 38.413. -
mnc(required): string
Pattern:
^\d{2,3}$Mobile Network Code is a part of the PLMN, comprising 2 or 3 digits, as defined in clause 9.3.3.5 of 3GPP TS 38.413.
Nested Schema : requesterPlmnList
Type:
arrayMinimum Number of Items:
Show Source
2-
Array of:
object PlmnId
When PlmnId needs to be converted to string (e.g. when used in maps as key), the string should be composed of three digit "mcc" followed by "-" and two or three digit "mnc".
Nested Schema : requesterSnpnList
Type:
arrayMinimum Number of Items:
Show Source
1-
Array of:
object PlmnIdNid
Contains the serving core network operator PLMN ID. For an SNPN, the NID together with the PLMN ID identifies the SNPN.
Nested Schema : requesterSnssaiList
Type:
arrayMinimum Number of Items:
Show Source
1-
Array of:
object Snssai
When Snssai needs to be converted to string (e.g. when used in maps as key), the string should be composed of one to three digit "sst" optionally followed by "-" and 6 hexadecimal digit "sd".
Nested Schema : PlmnIdNid
Type:
objectContains the serving core network operator PLMN ID. For an SNPN, the NID together with the PLMN ID identifies the SNPN.
Show Source
-
mcc(required): string
Pattern:
^\d{3}$Mobile Country Code is a part of the PLMN, comprising 3 digits, as defined in clause 9.3.3.5 of 3GPP TS 38.413. -
mnc(required): string
Pattern:
^\d{2,3}$Mobile Network Code is a part of the PLMN, comprising 2 or 3 digits, as defined in clause 9.3.3.5 of 3GPP TS 38.413. -
nid: string
Pattern:
^[A-Fa-f0-9]{11}$This represents the Network Identifier, which together with a PLMN ID is used to identify an SNPN (see 3GPP TS 23.003 and 3GPP TS 23.501 clause 5.30.2.1).
Nested Schema : targetSnssaiList
Type:
arrayMinimum Number of Items:
Show Source
1-
Array of:
object Snssai
When Snssai needs to be converted to string (e.g. when used in maps as key), the string should be composed of one to three digit "sst" optionally followed by "-" and 6 hexadecimal digit "sd".
Nested Schema : Snssai
Type:
objectWhen Snssai needs to be converted to string (e.g. when used in maps as key), the string should be composed of one to three digit "sst" optionally followed by "-" and 6 hexadecimal digit "sd".
Show Source
-
sd: string
Pattern:
^[A-Fa-f0-9]{6}$3-octet string representing the Slice Differentiator in hexadecimal format. Each character in the string should take a value from "0" to "9", from "a" to "f", or from "A" to "F" and should represent 4 bits. The most significant character representing the 4 most significant bits of the SD should appear first in the string, and the character representing the 4 least significant bit of the SD shall appear last in the string. This is an optional parameter that complements the Slice/Service type(s) to allow to differentiate amongst multiple Network Slices of the same Slice/Service type. This IE should be absent if no SD value is associated with the SST. -
sst(required): integer
Minimum Value:
0Maximum Value:255Unsigned integer, within the range 0 to 255, representing the Slice/Service Type. It indicates the expected Network Slice behaviour in terms of features and services. Values from 0 to 127 correspond to the standardized SST range and values from 128 to 255 correspond to the Operator-specific range. See clause 28.4.2 of 3GPP TS 23.003. Standardized values are defined in clause 5.15.2.2 of 3GPP TS 23.501.
Nested Schema : InvalidParam
Type:
objectIt contains an invalid parameter and a related description.
Show Source
-
param(required): string
If the invalid parameter is an attribute in a JSON body, this IE should contain the attribute's name and be encoded as a JSON Pointer. If the invalid parameter is an HTTP header, this IE should be formatted as the concatenation of the string "header" plus the header name. If the invalid parameter is a query parameter, this IE should be formatted as the concatenation of the string "query " plus the query parameter name. If the invalid parameter is a variable part of a resource URI path, this IE should contain the variable name, including the "{" and "}" symbols used in the OpenAPI specification to represent variable path segments.
-
reason: string
A human-readable reason, for example, "must be a positive integer". In cases involving failed operations in a PATCH request, the reason string should identify the failed operation that using the operation's array index to help correlate the invalid parameter with the failed operation, for example, " Replacement value invalid for attribute (failed operation index= 4)."
404 Response
The request includes a resource URI that does not exist.
Root Schema : ProblemDetails
Type:
objectProvides additional information in an error response.
Show Source
-
accessTokenError: object
AccessTokenErr
Error returned in the access token response message.
-
accessTokenRequest: object
AccessTokenReq
Contains information related to an access token request.
-
cause: string
A machine-readable application error cause specific to this occurrence of the problem. This IE should be present and provide application-related error information if available.
-
detail: string
A human-readable explanation specific to this occurrence of the problem.
-
instance: string
String providing a URI formatted according to RFC 3986.
-
invalidParams: array
invalidParams
Minimum Number of Items:
1 -
nrfId: string
Minimum Length:
4Maximum Length:253Pattern:^([0-9A-Za-z]([-0-9A-Za-z]{0,61}[0-9A-Za-z])?\.)+[A-Za-z]{2,63}\.?$Fully Qualified Domain Name. -
status: integer
-
supportedFeatures: string
Pattern:
^[A-Fa-f0-9]*$A string indicating the features supported by an API, as defined in clause 6.6 in 3GPP TS 29.500. The string should contain a bitmask indicating supported features in hexadecimal representation. Each character in the string takes a value between "0" to "9", "a" to "f" or "A" to "F" and represents the support of 4 features, as described in table 5.2.2-3. The most significant character, representing the highest-numbered features, appears first in the string, and the character representing features 1 to 4 appear last in the string. The list of features and their numbering (starting from 1) is defined separately for each API. If the string contains fewer number of characters than the total number of defined features for an API, all features that are represented by characters missing in the string are not supported. -
title: string
-
type: string
String providing a URI formatted according to RFC 3986.
Nested Schema : AccessTokenErr
Type:
objectError returned in the access token response message.
Show Source
-
error(required): string
Allowed Values:
[ "invalid_request", "invalid_client", "invalid_grant", "unauthorized_client", "unsupported_grant_type", "invalid_scope" ] -
error_description: string
-
error_uri: string
Nested Schema : AccessTokenReq
Type:
objectContains information related to an access token request.
Show Source
-
grant_type(required): string
Allowed Values:
[ "client_credentials" ] -
hnrfAccessTokenUri: string
String providing a URI formatted according to RFC 3986.
-
nfInstanceId(required): string
(uuid)
String uniquely identifying an NF instance. The format of the NF Instance ID should be a Universally Unique Identifier (UUID) version 4, as described in IETF RFC 4122.
-
nfType: string
Allowed Values:
[ "NRF", "UDM", "AMF", "SMF", "AUSF", "NEF", "PCF", "SMSF", "NSSF", "UDR", "LMF", "GMLC", "5G_EIR", "SEPP", "UPF", "N3IWF", "AF", "UDSF", "BSF", "CHF", "NWDAF", "PCSCF", "CBCF", "HSS", "UCMF", "SOR_AF", "SPAF", "MME", "SCSAS", "SCEF", "SCP", "NSSAAF", "ICSCF", "SCSCF", "DRA", "IMS_AS", "AANF", "5G_DDNMF", "NSACF", "MFAF", "EASDF", "DCCF", "MB_SMF", "TSCTSF", "ADRF", "GBA_BSF", "CEF", "MB_UPF", "NSWOF", "PKMF", "MNPF", "SMS_GMSC", "SMS_IWMSC", "MBSF", "MBSTF", "PANF", "IP_SM_GW", "SMS_ROUTER" ]NF types known to NRF. -
requesterFqdn: string
Minimum Length:
4Maximum Length:253Pattern:^([0-9A-Za-z]([-0-9A-Za-z]{0,61}[0-9A-Za-z])?\.)+[A-Za-z]{2,63}\.?$Fully Qualified Domain Name. -
requesterPlmn: object
PlmnId
When PlmnId needs to be converted to string (e.g. when used in maps as key), the string should be composed of three digit "mcc" followed by "-" and two or three digit "mnc".
-
requesterPlmnList: array
requesterPlmnList
Minimum Number of Items:
2 -
requesterSnpnList: array
requesterSnpnList
Minimum Number of Items:
1 -
requesterSnssaiList: array
requesterSnssaiList
Minimum Number of Items:
1 -
scope(required): string
Pattern:
^([a-zA-Z0-9_:-]+)( [a-zA-Z0-9_:-]+)*$ -
sourceNfInstanceId: string
(uuid)
String uniquely identifying an NF instance. The format of the NF Instance ID should be a Universally Unique Identifier (UUID) version 4, as described in IETF RFC 4122.
-
targetNfInstanceId: string
(uuid)
String uniquely identifying an NF instance. The format of the NF Instance ID should be a Universally Unique Identifier (UUID) version 4, as described in IETF RFC 4122.
-
targetNfServiceSetId: string
NF Service Set Identifier (see clause 28.12 of 3GPP TS 23.003) formatted as the following string "set
.sn .nfi .5gc.mnc .mcc ", or encoded as defined in clause 5.4.2 ("Mcc" data type definition) encoding the Mobile Network Code part of the PLMN, comprising 3 digits. If there are only 2 significant digits in the MNC, one "0" digit should be inserted at the left side to fill the 3 digit coding of MNC. Pattern: '^[0-9]{3}$' encoded as defined in clause 5.4.2 ("Nid" data type definition). encoded as defined in clause 5.3.2. encoded as defined in 3GPP TS 29.510. encoded as a string of characters consisting of alphabetic characters (A-Z and a-z), digits (0-9), and/or the hyphen (-) and that should end with either an alphabetic character or a digit. -
targetNfSetId: string
NF Set Identifier (see clause 28.12 of 3GPP TS 23.003), formatted as the following string "set
. set.5gc.mnc .mcc ", or "set . set.5gc.nid .mnc .mcc " with encoded as defined in clause 5.4.2 ("Mcc" data type definition) encoding the Mobile Network Code part of the PLMN, comprising 3 digits. If there are only 2 significant digits in the MNC, one "0" digit should be inserted at the left side to fill the 3 digit coding of MNC. Pattern: '^[0-9]{3}$' encoded as a value defined in Table 6.1.6.3.3-1 of 3GPP TS 29.510 but with lower case characters encoded as a string of characters consisting of alphabetic characters (A-Z and a-z), digits (0-9), and/or the hyphen (-) and that should end with either an alphabetic character or a digit. -
targetNfType: string
Allowed Values:
[ "NRF", "UDM", "AMF", "SMF", "AUSF", "NEF", "PCF", "SMSF", "NSSF", "UDR", "LMF", "GMLC", "5G_EIR", "SEPP", "UPF", "N3IWF", "AF", "UDSF", "BSF", "CHF", "NWDAF", "PCSCF", "CBCF", "HSS", "UCMF", "SOR_AF", "SPAF", "MME", "SCSAS", "SCEF", "SCP", "NSSAAF", "ICSCF", "SCSCF", "DRA", "IMS_AS", "AANF", "5G_DDNMF", "NSACF", "MFAF", "EASDF", "DCCF", "MB_SMF", "TSCTSF", "ADRF", "GBA_BSF", "CEF", "MB_UPF", "NSWOF", "PKMF", "MNPF", "SMS_GMSC", "SMS_IWMSC", "MBSF", "MBSTF", "PANF", "IP_SM_GW", "SMS_ROUTER" ]NF types known to NRF. -
targetNsiList: array
targetNsiList
Minimum Number of Items:
1 -
targetPlmn: object
PlmnId
When PlmnId needs to be converted to string (e.g. when used in maps as key), the string should be composed of three digit "mcc" followed by "-" and two or three digit "mnc".
-
targetSnpn: object
PlmnIdNid
Contains the serving core network operator PLMN ID. For an SNPN, the NID together with the PLMN ID identifies the SNPN.
-
targetSnssaiList: array
targetSnssaiList
Minimum Number of Items:
1
Nested Schema : invalidParams
Type:
arrayMinimum Number of Items:
Show Source
1-
Array of:
object InvalidParam
It contains an invalid parameter and a related description.
Nested Schema : PlmnId
Type:
objectWhen PlmnId needs to be converted to string (e.g. when used in maps as key), the string should be composed of three digit "mcc" followed by "-" and two or three digit "mnc".
Show Source
-
mcc(required): string
Pattern:
^\d{3}$Mobile Country Code is a part of the PLMN, comprising 3 digits, as defined in clause 9.3.3.5 of 3GPP TS 38.413. -
mnc(required): string
Pattern:
^\d{2,3}$Mobile Network Code is a part of the PLMN, comprising 2 or 3 digits, as defined in clause 9.3.3.5 of 3GPP TS 38.413.
Nested Schema : requesterPlmnList
Type:
arrayMinimum Number of Items:
Show Source
2-
Array of:
object PlmnId
When PlmnId needs to be converted to string (e.g. when used in maps as key), the string should be composed of three digit "mcc" followed by "-" and two or three digit "mnc".
Nested Schema : requesterSnpnList
Type:
arrayMinimum Number of Items:
Show Source
1-
Array of:
object PlmnIdNid
Contains the serving core network operator PLMN ID. For an SNPN, the NID together with the PLMN ID identifies the SNPN.
Nested Schema : requesterSnssaiList
Type:
arrayMinimum Number of Items:
Show Source
1-
Array of:
object Snssai
When Snssai needs to be converted to string (e.g. when used in maps as key), the string should be composed of one to three digit "sst" optionally followed by "-" and 6 hexadecimal digit "sd".
Nested Schema : PlmnIdNid
Type:
objectContains the serving core network operator PLMN ID. For an SNPN, the NID together with the PLMN ID identifies the SNPN.
Show Source
-
mcc(required): string
Pattern:
^\d{3}$Mobile Country Code is a part of the PLMN, comprising 3 digits, as defined in clause 9.3.3.5 of 3GPP TS 38.413. -
mnc(required): string
Pattern:
^\d{2,3}$Mobile Network Code is a part of the PLMN, comprising 2 or 3 digits, as defined in clause 9.3.3.5 of 3GPP TS 38.413. -
nid: string
Pattern:
^[A-Fa-f0-9]{11}$This represents the Network Identifier, which together with a PLMN ID is used to identify an SNPN (see 3GPP TS 23.003 and 3GPP TS 23.501 clause 5.30.2.1).
Nested Schema : targetSnssaiList
Type:
arrayMinimum Number of Items:
Show Source
1-
Array of:
object Snssai
When Snssai needs to be converted to string (e.g. when used in maps as key), the string should be composed of one to three digit "sst" optionally followed by "-" and 6 hexadecimal digit "sd".
Nested Schema : Snssai
Type:
objectWhen Snssai needs to be converted to string (e.g. when used in maps as key), the string should be composed of one to three digit "sst" optionally followed by "-" and 6 hexadecimal digit "sd".
Show Source
-
sd: string
Pattern:
^[A-Fa-f0-9]{6}$3-octet string representing the Slice Differentiator in hexadecimal format. Each character in the string should take a value from "0" to "9", from "a" to "f", or from "A" to "F" and should represent 4 bits. The most significant character representing the 4 most significant bits of the SD should appear first in the string, and the character representing the 4 least significant bit of the SD shall appear last in the string. This is an optional parameter that complements the Slice/Service type(s) to allow to differentiate amongst multiple Network Slices of the same Slice/Service type. This IE should be absent if no SD value is associated with the SST. -
sst(required): integer
Minimum Value:
0Maximum Value:255Unsigned integer, within the range 0 to 255, representing the Slice/Service Type. It indicates the expected Network Slice behaviour in terms of features and services. Values from 0 to 127 correspond to the standardized SST range and values from 128 to 255 correspond to the Operator-specific range. See clause 28.4.2 of 3GPP TS 23.003. Standardized values are defined in clause 5.15.2.2 of 3GPP TS 23.501.
Nested Schema : InvalidParam
Type:
objectIt contains an invalid parameter and a related description.
Show Source
-
param(required): string
If the invalid parameter is an attribute in a JSON body, this IE should contain the attribute's name and be encoded as a JSON Pointer. If the invalid parameter is an HTTP header, this IE should be formatted as the concatenation of the string "header" plus the header name. If the invalid parameter is a query parameter, this IE should be formatted as the concatenation of the string "query " plus the query parameter name. If the invalid parameter is a variable part of a resource URI path, this IE should contain the variable name, including the "{" and "}" symbols used in the OpenAPI specification to represent variable path segments.
-
reason: string
A human-readable reason, for example, "must be a positive integer". In cases involving failed operations in a PATCH request, the reason string should identify the failed operation that using the operation's array index to help correlate the invalid parameter with the failed operation, for example, " Replacement value invalid for attribute (failed operation index= 4)."
429 Response
The user has sent too many requests in a given amount of time.
Root Schema : ProblemDetails
Type:
objectProvides additional information in an error response.
Show Source
-
accessTokenError: object
AccessTokenErr
Error returned in the access token response message.
-
accessTokenRequest: object
AccessTokenReq
Contains information related to an access token request.
-
cause: string
A machine-readable application error cause specific to this occurrence of the problem. This IE should be present and provide application-related error information if available.
-
detail: string
A human-readable explanation specific to this occurrence of the problem.
-
instance: string
String providing a URI formatted according to RFC 3986.
-
invalidParams: array
invalidParams
Minimum Number of Items:
1 -
nrfId: string
Minimum Length:
4Maximum Length:253Pattern:^([0-9A-Za-z]([-0-9A-Za-z]{0,61}[0-9A-Za-z])?\.)+[A-Za-z]{2,63}\.?$Fully Qualified Domain Name. -
status: integer
-
supportedFeatures: string
Pattern:
^[A-Fa-f0-9]*$A string indicating the features supported by an API, as defined in clause 6.6 in 3GPP TS 29.500. The string should contain a bitmask indicating supported features in hexadecimal representation. Each character in the string takes a value between "0" to "9", "a" to "f" or "A" to "F" and represents the support of 4 features, as described in table 5.2.2-3. The most significant character, representing the highest-numbered features, appears first in the string, and the character representing features 1 to 4 appear last in the string. The list of features and their numbering (starting from 1) is defined separately for each API. If the string contains fewer number of characters than the total number of defined features for an API, all features that are represented by characters missing in the string are not supported. -
title: string
-
type: string
String providing a URI formatted according to RFC 3986.
Nested Schema : AccessTokenErr
Type:
objectError returned in the access token response message.
Show Source
-
error(required): string
Allowed Values:
[ "invalid_request", "invalid_client", "invalid_grant", "unauthorized_client", "unsupported_grant_type", "invalid_scope" ] -
error_description: string
-
error_uri: string
Nested Schema : AccessTokenReq
Type:
objectContains information related to an access token request.
Show Source
-
grant_type(required): string
Allowed Values:
[ "client_credentials" ] -
hnrfAccessTokenUri: string
String providing a URI formatted according to RFC 3986.
-
nfInstanceId(required): string
(uuid)
String uniquely identifying an NF instance. The format of the NF Instance ID should be a Universally Unique Identifier (UUID) version 4, as described in IETF RFC 4122.
-
nfType: string
Allowed Values:
[ "NRF", "UDM", "AMF", "SMF", "AUSF", "NEF", "PCF", "SMSF", "NSSF", "UDR", "LMF", "GMLC", "5G_EIR", "SEPP", "UPF", "N3IWF", "AF", "UDSF", "BSF", "CHF", "NWDAF", "PCSCF", "CBCF", "HSS", "UCMF", "SOR_AF", "SPAF", "MME", "SCSAS", "SCEF", "SCP", "NSSAAF", "ICSCF", "SCSCF", "DRA", "IMS_AS", "AANF", "5G_DDNMF", "NSACF", "MFAF", "EASDF", "DCCF", "MB_SMF", "TSCTSF", "ADRF", "GBA_BSF", "CEF", "MB_UPF", "NSWOF", "PKMF", "MNPF", "SMS_GMSC", "SMS_IWMSC", "MBSF", "MBSTF", "PANF", "IP_SM_GW", "SMS_ROUTER" ]NF types known to NRF. -
requesterFqdn: string
Minimum Length:
4Maximum Length:253Pattern:^([0-9A-Za-z]([-0-9A-Za-z]{0,61}[0-9A-Za-z])?\.)+[A-Za-z]{2,63}\.?$Fully Qualified Domain Name. -
requesterPlmn: object
PlmnId
When PlmnId needs to be converted to string (e.g. when used in maps as key), the string should be composed of three digit "mcc" followed by "-" and two or three digit "mnc".
-
requesterPlmnList: array
requesterPlmnList
Minimum Number of Items:
2 -
requesterSnpnList: array
requesterSnpnList
Minimum Number of Items:
1 -
requesterSnssaiList: array
requesterSnssaiList
Minimum Number of Items:
1 -
scope(required): string
Pattern:
^([a-zA-Z0-9_:-]+)( [a-zA-Z0-9_:-]+)*$ -
sourceNfInstanceId: string
(uuid)
String uniquely identifying an NF instance. The format of the NF Instance ID should be a Universally Unique Identifier (UUID) version 4, as described in IETF RFC 4122.
-
targetNfInstanceId: string
(uuid)
String uniquely identifying an NF instance. The format of the NF Instance ID should be a Universally Unique Identifier (UUID) version 4, as described in IETF RFC 4122.
-
targetNfServiceSetId: string
NF Service Set Identifier (see clause 28.12 of 3GPP TS 23.003) formatted as the following string "set
.sn .nfi .5gc.mnc .mcc ", or encoded as defined in clause 5.4.2 ("Mcc" data type definition) encoding the Mobile Network Code part of the PLMN, comprising 3 digits. If there are only 2 significant digits in the MNC, one "0" digit should be inserted at the left side to fill the 3 digit coding of MNC. Pattern: '^[0-9]{3}$' encoded as defined in clause 5.4.2 ("Nid" data type definition). encoded as defined in clause 5.3.2. encoded as defined in 3GPP TS 29.510. encoded as a string of characters consisting of alphabetic characters (A-Z and a-z), digits (0-9), and/or the hyphen (-) and that should end with either an alphabetic character or a digit. -
targetNfSetId: string
NF Set Identifier (see clause 28.12 of 3GPP TS 23.003), formatted as the following string "set
. set.5gc.mnc .mcc ", or "set . set.5gc.nid .mnc .mcc " with encoded as defined in clause 5.4.2 ("Mcc" data type definition) encoding the Mobile Network Code part of the PLMN, comprising 3 digits. If there are only 2 significant digits in the MNC, one "0" digit should be inserted at the left side to fill the 3 digit coding of MNC. Pattern: '^[0-9]{3}$' encoded as a value defined in Table 6.1.6.3.3-1 of 3GPP TS 29.510 but with lower case characters encoded as a string of characters consisting of alphabetic characters (A-Z and a-z), digits (0-9), and/or the hyphen (-) and that should end with either an alphabetic character or a digit. -
targetNfType: string
Allowed Values:
[ "NRF", "UDM", "AMF", "SMF", "AUSF", "NEF", "PCF", "SMSF", "NSSF", "UDR", "LMF", "GMLC", "5G_EIR", "SEPP", "UPF", "N3IWF", "AF", "UDSF", "BSF", "CHF", "NWDAF", "PCSCF", "CBCF", "HSS", "UCMF", "SOR_AF", "SPAF", "MME", "SCSAS", "SCEF", "SCP", "NSSAAF", "ICSCF", "SCSCF", "DRA", "IMS_AS", "AANF", "5G_DDNMF", "NSACF", "MFAF", "EASDF", "DCCF", "MB_SMF", "TSCTSF", "ADRF", "GBA_BSF", "CEF", "MB_UPF", "NSWOF", "PKMF", "MNPF", "SMS_GMSC", "SMS_IWMSC", "MBSF", "MBSTF", "PANF", "IP_SM_GW", "SMS_ROUTER" ]NF types known to NRF. -
targetNsiList: array
targetNsiList
Minimum Number of Items:
1 -
targetPlmn: object
PlmnId
When PlmnId needs to be converted to string (e.g. when used in maps as key), the string should be composed of three digit "mcc" followed by "-" and two or three digit "mnc".
-
targetSnpn: object
PlmnIdNid
Contains the serving core network operator PLMN ID. For an SNPN, the NID together with the PLMN ID identifies the SNPN.
-
targetSnssaiList: array
targetSnssaiList
Minimum Number of Items:
1
Nested Schema : invalidParams
Type:
arrayMinimum Number of Items:
Show Source
1-
Array of:
object InvalidParam
It contains an invalid parameter and a related description.
Nested Schema : PlmnId
Type:
objectWhen PlmnId needs to be converted to string (e.g. when used in maps as key), the string should be composed of three digit "mcc" followed by "-" and two or three digit "mnc".
Show Source
-
mcc(required): string
Pattern:
^\d{3}$Mobile Country Code is a part of the PLMN, comprising 3 digits, as defined in clause 9.3.3.5 of 3GPP TS 38.413. -
mnc(required): string
Pattern:
^\d{2,3}$Mobile Network Code is a part of the PLMN, comprising 2 or 3 digits, as defined in clause 9.3.3.5 of 3GPP TS 38.413.
Nested Schema : requesterPlmnList
Type:
arrayMinimum Number of Items:
Show Source
2-
Array of:
object PlmnId
When PlmnId needs to be converted to string (e.g. when used in maps as key), the string should be composed of three digit "mcc" followed by "-" and two or three digit "mnc".
Nested Schema : requesterSnpnList
Type:
arrayMinimum Number of Items:
Show Source
1-
Array of:
object PlmnIdNid
Contains the serving core network operator PLMN ID. For an SNPN, the NID together with the PLMN ID identifies the SNPN.
Nested Schema : requesterSnssaiList
Type:
arrayMinimum Number of Items:
Show Source
1-
Array of:
object Snssai
When Snssai needs to be converted to string (e.g. when used in maps as key), the string should be composed of one to three digit "sst" optionally followed by "-" and 6 hexadecimal digit "sd".
Nested Schema : PlmnIdNid
Type:
objectContains the serving core network operator PLMN ID. For an SNPN, the NID together with the PLMN ID identifies the SNPN.
Show Source
-
mcc(required): string
Pattern:
^\d{3}$Mobile Country Code is a part of the PLMN, comprising 3 digits, as defined in clause 9.3.3.5 of 3GPP TS 38.413. -
mnc(required): string
Pattern:
^\d{2,3}$Mobile Network Code is a part of the PLMN, comprising 2 or 3 digits, as defined in clause 9.3.3.5 of 3GPP TS 38.413. -
nid: string
Pattern:
^[A-Fa-f0-9]{11}$This represents the Network Identifier, which together with a PLMN ID is used to identify an SNPN (see 3GPP TS 23.003 and 3GPP TS 23.501 clause 5.30.2.1).
Nested Schema : targetSnssaiList
Type:
arrayMinimum Number of Items:
Show Source
1-
Array of:
object Snssai
When Snssai needs to be converted to string (e.g. when used in maps as key), the string should be composed of one to three digit "sst" optionally followed by "-" and 6 hexadecimal digit "sd".
Nested Schema : Snssai
Type:
objectWhen Snssai needs to be converted to string (e.g. when used in maps as key), the string should be composed of one to three digit "sst" optionally followed by "-" and 6 hexadecimal digit "sd".
Show Source
-
sd: string
Pattern:
^[A-Fa-f0-9]{6}$3-octet string representing the Slice Differentiator in hexadecimal format. Each character in the string should take a value from "0" to "9", from "a" to "f", or from "A" to "F" and should represent 4 bits. The most significant character representing the 4 most significant bits of the SD should appear first in the string, and the character representing the 4 least significant bit of the SD shall appear last in the string. This is an optional parameter that complements the Slice/Service type(s) to allow to differentiate amongst multiple Network Slices of the same Slice/Service type. This IE should be absent if no SD value is associated with the SST. -
sst(required): integer
Minimum Value:
0Maximum Value:255Unsigned integer, within the range 0 to 255, representing the Slice/Service Type. It indicates the expected Network Slice behaviour in terms of features and services. Values from 0 to 127 correspond to the standardized SST range and values from 128 to 255 correspond to the Operator-specific range. See clause 28.4.2 of 3GPP TS 23.003. Standardized values are defined in clause 5.15.2.2 of 3GPP TS 23.501.
Nested Schema : InvalidParam
Type:
objectIt contains an invalid parameter and a related description.
Show Source
-
param(required): string
If the invalid parameter is an attribute in a JSON body, this IE should contain the attribute's name and be encoded as a JSON Pointer. If the invalid parameter is an HTTP header, this IE should be formatted as the concatenation of the string "header" plus the header name. If the invalid parameter is a query parameter, this IE should be formatted as the concatenation of the string "query " plus the query parameter name. If the invalid parameter is a variable part of a resource URI path, this IE should contain the variable name, including the "{" and "}" symbols used in the OpenAPI specification to represent variable path segments.
-
reason: string
A human-readable reason, for example, "must be a positive integer". In cases involving failed operations in a PATCH request, the reason string should identify the failed operation that using the operation's array index to help correlate the invalid parameter with the failed operation, for example, " Replacement value invalid for attribute (failed operation index= 4)."
500 Response
The server encountered an unexpected condition that prevented it from fulfilling the request.
Root Schema : ProblemDetails
Type:
objectProvides additional information in an error response.
Show Source
-
accessTokenError: object
AccessTokenErr
Error returned in the access token response message.
-
accessTokenRequest: object
AccessTokenReq
Contains information related to an access token request.
-
cause: string
A machine-readable application error cause specific to this occurrence of the problem. This IE should be present and provide application-related error information if available.
-
detail: string
A human-readable explanation specific to this occurrence of the problem.
-
instance: string
String providing a URI formatted according to RFC 3986.
-
invalidParams: array
invalidParams
Minimum Number of Items:
1 -
nrfId: string
Minimum Length:
4Maximum Length:253Pattern:^([0-9A-Za-z]([-0-9A-Za-z]{0,61}[0-9A-Za-z])?\.)+[A-Za-z]{2,63}\.?$Fully Qualified Domain Name. -
status: integer
-
supportedFeatures: string
Pattern:
^[A-Fa-f0-9]*$A string indicating the features supported by an API, as defined in clause 6.6 in 3GPP TS 29.500. The string should contain a bitmask indicating supported features in hexadecimal representation. Each character in the string takes a value between "0" to "9", "a" to "f" or "A" to "F" and represents the support of 4 features, as described in table 5.2.2-3. The most significant character, representing the highest-numbered features, appears first in the string, and the character representing features 1 to 4 appear last in the string. The list of features and their numbering (starting from 1) is defined separately for each API. If the string contains fewer number of characters than the total number of defined features for an API, all features that are represented by characters missing in the string are not supported. -
title: string
-
type: string
String providing a URI formatted according to RFC 3986.
Nested Schema : AccessTokenErr
Type:
objectError returned in the access token response message.
Show Source
-
error(required): string
Allowed Values:
[ "invalid_request", "invalid_client", "invalid_grant", "unauthorized_client", "unsupported_grant_type", "invalid_scope" ] -
error_description: string
-
error_uri: string
Nested Schema : AccessTokenReq
Type:
objectContains information related to an access token request.
Show Source
-
grant_type(required): string
Allowed Values:
[ "client_credentials" ] -
hnrfAccessTokenUri: string
String providing a URI formatted according to RFC 3986.
-
nfInstanceId(required): string
(uuid)
String uniquely identifying an NF instance. The format of the NF Instance ID should be a Universally Unique Identifier (UUID) version 4, as described in IETF RFC 4122.
-
nfType: string
Allowed Values:
[ "NRF", "UDM", "AMF", "SMF", "AUSF", "NEF", "PCF", "SMSF", "NSSF", "UDR", "LMF", "GMLC", "5G_EIR", "SEPP", "UPF", "N3IWF", "AF", "UDSF", "BSF", "CHF", "NWDAF", "PCSCF", "CBCF", "HSS", "UCMF", "SOR_AF", "SPAF", "MME", "SCSAS", "SCEF", "SCP", "NSSAAF", "ICSCF", "SCSCF", "DRA", "IMS_AS", "AANF", "5G_DDNMF", "NSACF", "MFAF", "EASDF", "DCCF", "MB_SMF", "TSCTSF", "ADRF", "GBA_BSF", "CEF", "MB_UPF", "NSWOF", "PKMF", "MNPF", "SMS_GMSC", "SMS_IWMSC", "MBSF", "MBSTF", "PANF", "IP_SM_GW", "SMS_ROUTER" ]NF types known to NRF. -
requesterFqdn: string
Minimum Length:
4Maximum Length:253Pattern:^([0-9A-Za-z]([-0-9A-Za-z]{0,61}[0-9A-Za-z])?\.)+[A-Za-z]{2,63}\.?$Fully Qualified Domain Name. -
requesterPlmn: object
PlmnId
When PlmnId needs to be converted to string (e.g. when used in maps as key), the string should be composed of three digit "mcc" followed by "-" and two or three digit "mnc".
-
requesterPlmnList: array
requesterPlmnList
Minimum Number of Items:
2 -
requesterSnpnList: array
requesterSnpnList
Minimum Number of Items:
1 -
requesterSnssaiList: array
requesterSnssaiList
Minimum Number of Items:
1 -
scope(required): string
Pattern:
^([a-zA-Z0-9_:-]+)( [a-zA-Z0-9_:-]+)*$ -
sourceNfInstanceId: string
(uuid)
String uniquely identifying an NF instance. The format of the NF Instance ID should be a Universally Unique Identifier (UUID) version 4, as described in IETF RFC 4122.
-
targetNfInstanceId: string
(uuid)
String uniquely identifying an NF instance. The format of the NF Instance ID should be a Universally Unique Identifier (UUID) version 4, as described in IETF RFC 4122.
-
targetNfServiceSetId: string
NF Service Set Identifier (see clause 28.12 of 3GPP TS 23.003) formatted as the following string "set
.sn .nfi .5gc.mnc .mcc ", or encoded as defined in clause 5.4.2 ("Mcc" data type definition) encoding the Mobile Network Code part of the PLMN, comprising 3 digits. If there are only 2 significant digits in the MNC, one "0" digit should be inserted at the left side to fill the 3 digit coding of MNC. Pattern: '^[0-9]{3}$' encoded as defined in clause 5.4.2 ("Nid" data type definition). encoded as defined in clause 5.3.2. encoded as defined in 3GPP TS 29.510. encoded as a string of characters consisting of alphabetic characters (A-Z and a-z), digits (0-9), and/or the hyphen (-) and that should end with either an alphabetic character or a digit. -
targetNfSetId: string
NF Set Identifier (see clause 28.12 of 3GPP TS 23.003), formatted as the following string "set
. set.5gc.mnc .mcc ", or "set . set.5gc.nid .mnc .mcc " with encoded as defined in clause 5.4.2 ("Mcc" data type definition) encoding the Mobile Network Code part of the PLMN, comprising 3 digits. If there are only 2 significant digits in the MNC, one "0" digit should be inserted at the left side to fill the 3 digit coding of MNC. Pattern: '^[0-9]{3}$' encoded as a value defined in Table 6.1.6.3.3-1 of 3GPP TS 29.510 but with lower case characters encoded as a string of characters consisting of alphabetic characters (A-Z and a-z), digits (0-9), and/or the hyphen (-) and that should end with either an alphabetic character or a digit. -
targetNfType: string
Allowed Values:
[ "NRF", "UDM", "AMF", "SMF", "AUSF", "NEF", "PCF", "SMSF", "NSSF", "UDR", "LMF", "GMLC", "5G_EIR", "SEPP", "UPF", "N3IWF", "AF", "UDSF", "BSF", "CHF", "NWDAF", "PCSCF", "CBCF", "HSS", "UCMF", "SOR_AF", "SPAF", "MME", "SCSAS", "SCEF", "SCP", "NSSAAF", "ICSCF", "SCSCF", "DRA", "IMS_AS", "AANF", "5G_DDNMF", "NSACF", "MFAF", "EASDF", "DCCF", "MB_SMF", "TSCTSF", "ADRF", "GBA_BSF", "CEF", "MB_UPF", "NSWOF", "PKMF", "MNPF", "SMS_GMSC", "SMS_IWMSC", "MBSF", "MBSTF", "PANF", "IP_SM_GW", "SMS_ROUTER" ]NF types known to NRF. -
targetNsiList: array
targetNsiList
Minimum Number of Items:
1 -
targetPlmn: object
PlmnId
When PlmnId needs to be converted to string (e.g. when used in maps as key), the string should be composed of three digit "mcc" followed by "-" and two or three digit "mnc".
-
targetSnpn: object
PlmnIdNid
Contains the serving core network operator PLMN ID. For an SNPN, the NID together with the PLMN ID identifies the SNPN.
-
targetSnssaiList: array
targetSnssaiList
Minimum Number of Items:
1
Nested Schema : invalidParams
Type:
arrayMinimum Number of Items:
Show Source
1-
Array of:
object InvalidParam
It contains an invalid parameter and a related description.
Nested Schema : PlmnId
Type:
objectWhen PlmnId needs to be converted to string (e.g. when used in maps as key), the string should be composed of three digit "mcc" followed by "-" and two or three digit "mnc".
Show Source
-
mcc(required): string
Pattern:
^\d{3}$Mobile Country Code is a part of the PLMN, comprising 3 digits, as defined in clause 9.3.3.5 of 3GPP TS 38.413. -
mnc(required): string
Pattern:
^\d{2,3}$Mobile Network Code is a part of the PLMN, comprising 2 or 3 digits, as defined in clause 9.3.3.5 of 3GPP TS 38.413.
Nested Schema : requesterPlmnList
Type:
arrayMinimum Number of Items:
Show Source
2-
Array of:
object PlmnId
When PlmnId needs to be converted to string (e.g. when used in maps as key), the string should be composed of three digit "mcc" followed by "-" and two or three digit "mnc".
Nested Schema : requesterSnpnList
Type:
arrayMinimum Number of Items:
Show Source
1-
Array of:
object PlmnIdNid
Contains the serving core network operator PLMN ID. For an SNPN, the NID together with the PLMN ID identifies the SNPN.
Nested Schema : requesterSnssaiList
Type:
arrayMinimum Number of Items:
Show Source
1-
Array of:
object Snssai
When Snssai needs to be converted to string (e.g. when used in maps as key), the string should be composed of one to three digit "sst" optionally followed by "-" and 6 hexadecimal digit "sd".
Nested Schema : PlmnIdNid
Type:
objectContains the serving core network operator PLMN ID. For an SNPN, the NID together with the PLMN ID identifies the SNPN.
Show Source
-
mcc(required): string
Pattern:
^\d{3}$Mobile Country Code is a part of the PLMN, comprising 3 digits, as defined in clause 9.3.3.5 of 3GPP TS 38.413. -
mnc(required): string
Pattern:
^\d{2,3}$Mobile Network Code is a part of the PLMN, comprising 2 or 3 digits, as defined in clause 9.3.3.5 of 3GPP TS 38.413. -
nid: string
Pattern:
^[A-Fa-f0-9]{11}$This represents the Network Identifier, which together with a PLMN ID is used to identify an SNPN (see 3GPP TS 23.003 and 3GPP TS 23.501 clause 5.30.2.1).
Nested Schema : targetSnssaiList
Type:
arrayMinimum Number of Items:
Show Source
1-
Array of:
object Snssai
When Snssai needs to be converted to string (e.g. when used in maps as key), the string should be composed of one to three digit "sst" optionally followed by "-" and 6 hexadecimal digit "sd".
Nested Schema : Snssai
Type:
objectWhen Snssai needs to be converted to string (e.g. when used in maps as key), the string should be composed of one to three digit "sst" optionally followed by "-" and 6 hexadecimal digit "sd".
Show Source
-
sd: string
Pattern:
^[A-Fa-f0-9]{6}$3-octet string representing the Slice Differentiator in hexadecimal format. Each character in the string should take a value from "0" to "9", from "a" to "f", or from "A" to "F" and should represent 4 bits. The most significant character representing the 4 most significant bits of the SD should appear first in the string, and the character representing the 4 least significant bit of the SD shall appear last in the string. This is an optional parameter that complements the Slice/Service type(s) to allow to differentiate amongst multiple Network Slices of the same Slice/Service type. This IE should be absent if no SD value is associated with the SST. -
sst(required): integer
Minimum Value:
0Maximum Value:255Unsigned integer, within the range 0 to 255, representing the Slice/Service Type. It indicates the expected Network Slice behaviour in terms of features and services. Values from 0 to 127 correspond to the standardized SST range and values from 128 to 255 correspond to the Operator-specific range. See clause 28.4.2 of 3GPP TS 23.003. Standardized values are defined in clause 5.15.2.2 of 3GPP TS 23.501.
Nested Schema : InvalidParam
Type:
objectIt contains an invalid parameter and a related description.
Show Source
-
param(required): string
If the invalid parameter is an attribute in a JSON body, this IE should contain the attribute's name and be encoded as a JSON Pointer. If the invalid parameter is an HTTP header, this IE should be formatted as the concatenation of the string "header" plus the header name. If the invalid parameter is a query parameter, this IE should be formatted as the concatenation of the string "query " plus the query parameter name. If the invalid parameter is a variable part of a resource URI path, this IE should contain the variable name, including the "{" and "}" symbols used in the OpenAPI specification to represent variable path segments.
-
reason: string
A human-readable reason, for example, "must be a positive integer". In cases involving failed operations in a PATCH request, the reason string should identify the failed operation that using the operation's array index to help correlate the invalid parameter with the failed operation, for example, " Replacement value invalid for attribute (failed operation index= 4)."
503 Response
The server cannot handle the request (because it is overloaded or down for maintenance). Usually a temporary state.
Root Schema : ProblemDetails
Type:
objectProvides additional information in an error response.
Show Source
-
accessTokenError: object
AccessTokenErr
Error returned in the access token response message.
-
accessTokenRequest: object
AccessTokenReq
Contains information related to an access token request.
-
cause: string
A machine-readable application error cause specific to this occurrence of the problem. This IE should be present and provide application-related error information if available.
-
detail: string
A human-readable explanation specific to this occurrence of the problem.
-
instance: string
String providing a URI formatted according to RFC 3986.
-
invalidParams: array
invalidParams
Minimum Number of Items:
1 -
nrfId: string
Minimum Length:
4Maximum Length:253Pattern:^([0-9A-Za-z]([-0-9A-Za-z]{0,61}[0-9A-Za-z])?\.)+[A-Za-z]{2,63}\.?$Fully Qualified Domain Name. -
status: integer
-
supportedFeatures: string
Pattern:
^[A-Fa-f0-9]*$A string indicating the features supported by an API, as defined in clause 6.6 in 3GPP TS 29.500. The string should contain a bitmask indicating supported features in hexadecimal representation. Each character in the string takes a value between "0" to "9", "a" to "f" or "A" to "F" and represents the support of 4 features, as described in table 5.2.2-3. The most significant character, representing the highest-numbered features, appears first in the string, and the character representing features 1 to 4 appear last in the string. The list of features and their numbering (starting from 1) is defined separately for each API. If the string contains fewer number of characters than the total number of defined features for an API, all features that are represented by characters missing in the string are not supported. -
title: string
-
type: string
String providing a URI formatted according to RFC 3986.
Nested Schema : AccessTokenErr
Type:
objectError returned in the access token response message.
Show Source
-
error(required): string
Allowed Values:
[ "invalid_request", "invalid_client", "invalid_grant", "unauthorized_client", "unsupported_grant_type", "invalid_scope" ] -
error_description: string
-
error_uri: string
Nested Schema : AccessTokenReq
Type:
objectContains information related to an access token request.
Show Source
-
grant_type(required): string
Allowed Values:
[ "client_credentials" ] -
hnrfAccessTokenUri: string
String providing a URI formatted according to RFC 3986.
-
nfInstanceId(required): string
(uuid)
String uniquely identifying an NF instance. The format of the NF Instance ID should be a Universally Unique Identifier (UUID) version 4, as described in IETF RFC 4122.
-
nfType: string
Allowed Values:
[ "NRF", "UDM", "AMF", "SMF", "AUSF", "NEF", "PCF", "SMSF", "NSSF", "UDR", "LMF", "GMLC", "5G_EIR", "SEPP", "UPF", "N3IWF", "AF", "UDSF", "BSF", "CHF", "NWDAF", "PCSCF", "CBCF", "HSS", "UCMF", "SOR_AF", "SPAF", "MME", "SCSAS", "SCEF", "SCP", "NSSAAF", "ICSCF", "SCSCF", "DRA", "IMS_AS", "AANF", "5G_DDNMF", "NSACF", "MFAF", "EASDF", "DCCF", "MB_SMF", "TSCTSF", "ADRF", "GBA_BSF", "CEF", "MB_UPF", "NSWOF", "PKMF", "MNPF", "SMS_GMSC", "SMS_IWMSC", "MBSF", "MBSTF", "PANF", "IP_SM_GW", "SMS_ROUTER" ]NF types known to NRF. -
requesterFqdn: string
Minimum Length:
4Maximum Length:253Pattern:^([0-9A-Za-z]([-0-9A-Za-z]{0,61}[0-9A-Za-z])?\.)+[A-Za-z]{2,63}\.?$Fully Qualified Domain Name. -
requesterPlmn: object
PlmnId
When PlmnId needs to be converted to string (e.g. when used in maps as key), the string should be composed of three digit "mcc" followed by "-" and two or three digit "mnc".
-
requesterPlmnList: array
requesterPlmnList
Minimum Number of Items:
2 -
requesterSnpnList: array
requesterSnpnList
Minimum Number of Items:
1 -
requesterSnssaiList: array
requesterSnssaiList
Minimum Number of Items:
1 -
scope(required): string
Pattern:
^([a-zA-Z0-9_:-]+)( [a-zA-Z0-9_:-]+)*$ -
sourceNfInstanceId: string
(uuid)
String uniquely identifying an NF instance. The format of the NF Instance ID should be a Universally Unique Identifier (UUID) version 4, as described in IETF RFC 4122.
-
targetNfInstanceId: string
(uuid)
String uniquely identifying an NF instance. The format of the NF Instance ID should be a Universally Unique Identifier (UUID) version 4, as described in IETF RFC 4122.
-
targetNfServiceSetId: string
NF Service Set Identifier (see clause 28.12 of 3GPP TS 23.003) formatted as the following string "set
.sn .nfi .5gc.mnc .mcc ", or encoded as defined in clause 5.4.2 ("Mcc" data type definition) encoding the Mobile Network Code part of the PLMN, comprising 3 digits. If there are only 2 significant digits in the MNC, one "0" digit should be inserted at the left side to fill the 3 digit coding of MNC. Pattern: '^[0-9]{3}$' encoded as defined in clause 5.4.2 ("Nid" data type definition). encoded as defined in clause 5.3.2. encoded as defined in 3GPP TS 29.510. encoded as a string of characters consisting of alphabetic characters (A-Z and a-z), digits (0-9), and/or the hyphen (-) and that should end with either an alphabetic character or a digit. -
targetNfSetId: string
NF Set Identifier (see clause 28.12 of 3GPP TS 23.003), formatted as the following string "set
. set.5gc.mnc .mcc ", or "set . set.5gc.nid .mnc .mcc " with encoded as defined in clause 5.4.2 ("Mcc" data type definition) encoding the Mobile Network Code part of the PLMN, comprising 3 digits. If there are only 2 significant digits in the MNC, one "0" digit should be inserted at the left side to fill the 3 digit coding of MNC. Pattern: '^[0-9]{3}$' encoded as a value defined in Table 6.1.6.3.3-1 of 3GPP TS 29.510 but with lower case characters encoded as a string of characters consisting of alphabetic characters (A-Z and a-z), digits (0-9), and/or the hyphen (-) and that should end with either an alphabetic character or a digit. -
targetNfType: string
Allowed Values:
[ "NRF", "UDM", "AMF", "SMF", "AUSF", "NEF", "PCF", "SMSF", "NSSF", "UDR", "LMF", "GMLC", "5G_EIR", "SEPP", "UPF", "N3IWF", "AF", "UDSF", "BSF", "CHF", "NWDAF", "PCSCF", "CBCF", "HSS", "UCMF", "SOR_AF", "SPAF", "MME", "SCSAS", "SCEF", "SCP", "NSSAAF", "ICSCF", "SCSCF", "DRA", "IMS_AS", "AANF", "5G_DDNMF", "NSACF", "MFAF", "EASDF", "DCCF", "MB_SMF", "TSCTSF", "ADRF", "GBA_BSF", "CEF", "MB_UPF", "NSWOF", "PKMF", "MNPF", "SMS_GMSC", "SMS_IWMSC", "MBSF", "MBSTF", "PANF", "IP_SM_GW", "SMS_ROUTER" ]NF types known to NRF. -
targetNsiList: array
targetNsiList
Minimum Number of Items:
1 -
targetPlmn: object
PlmnId
When PlmnId needs to be converted to string (e.g. when used in maps as key), the string should be composed of three digit "mcc" followed by "-" and two or three digit "mnc".
-
targetSnpn: object
PlmnIdNid
Contains the serving core network operator PLMN ID. For an SNPN, the NID together with the PLMN ID identifies the SNPN.
-
targetSnssaiList: array
targetSnssaiList
Minimum Number of Items:
1
Nested Schema : invalidParams
Type:
arrayMinimum Number of Items:
Show Source
1-
Array of:
object InvalidParam
It contains an invalid parameter and a related description.
Nested Schema : PlmnId
Type:
objectWhen PlmnId needs to be converted to string (e.g. when used in maps as key), the string should be composed of three digit "mcc" followed by "-" and two or three digit "mnc".
Show Source
-
mcc(required): string
Pattern:
^\d{3}$Mobile Country Code is a part of the PLMN, comprising 3 digits, as defined in clause 9.3.3.5 of 3GPP TS 38.413. -
mnc(required): string
Pattern:
^\d{2,3}$Mobile Network Code is a part of the PLMN, comprising 2 or 3 digits, as defined in clause 9.3.3.5 of 3GPP TS 38.413.
Nested Schema : requesterPlmnList
Type:
arrayMinimum Number of Items:
Show Source
2-
Array of:
object PlmnId
When PlmnId needs to be converted to string (e.g. when used in maps as key), the string should be composed of three digit "mcc" followed by "-" and two or three digit "mnc".
Nested Schema : requesterSnpnList
Type:
arrayMinimum Number of Items:
Show Source
1-
Array of:
object PlmnIdNid
Contains the serving core network operator PLMN ID. For an SNPN, the NID together with the PLMN ID identifies the SNPN.
Nested Schema : requesterSnssaiList
Type:
arrayMinimum Number of Items:
Show Source
1-
Array of:
object Snssai
When Snssai needs to be converted to string (e.g. when used in maps as key), the string should be composed of one to three digit "sst" optionally followed by "-" and 6 hexadecimal digit "sd".
Nested Schema : PlmnIdNid
Type:
objectContains the serving core network operator PLMN ID. For an SNPN, the NID together with the PLMN ID identifies the SNPN.
Show Source
-
mcc(required): string
Pattern:
^\d{3}$Mobile Country Code is a part of the PLMN, comprising 3 digits, as defined in clause 9.3.3.5 of 3GPP TS 38.413. -
mnc(required): string
Pattern:
^\d{2,3}$Mobile Network Code is a part of the PLMN, comprising 2 or 3 digits, as defined in clause 9.3.3.5 of 3GPP TS 38.413. -
nid: string
Pattern:
^[A-Fa-f0-9]{11}$This represents the Network Identifier, which together with a PLMN ID is used to identify an SNPN (see 3GPP TS 23.003 and 3GPP TS 23.501 clause 5.30.2.1).
Nested Schema : targetSnssaiList
Type:
arrayMinimum Number of Items:
Show Source
1-
Array of:
object Snssai
When Snssai needs to be converted to string (e.g. when used in maps as key), the string should be composed of one to three digit "sst" optionally followed by "-" and 6 hexadecimal digit "sd".
Nested Schema : Snssai
Type:
objectWhen Snssai needs to be converted to string (e.g. when used in maps as key), the string should be composed of one to three digit "sst" optionally followed by "-" and 6 hexadecimal digit "sd".
Show Source
-
sd: string
Pattern:
^[A-Fa-f0-9]{6}$3-octet string representing the Slice Differentiator in hexadecimal format. Each character in the string should take a value from "0" to "9", from "a" to "f", or from "A" to "F" and should represent 4 bits. The most significant character representing the 4 most significant bits of the SD should appear first in the string, and the character representing the 4 least significant bit of the SD shall appear last in the string. This is an optional parameter that complements the Slice/Service type(s) to allow to differentiate amongst multiple Network Slices of the same Slice/Service type. This IE should be absent if no SD value is associated with the SST. -
sst(required): integer
Minimum Value:
0Maximum Value:255Unsigned integer, within the range 0 to 255, representing the Slice/Service Type. It indicates the expected Network Slice behaviour in terms of features and services. Values from 0 to 127 correspond to the standardized SST range and values from 128 to 255 correspond to the Operator-specific range. See clause 28.4.2 of 3GPP TS 23.003. Standardized values are defined in clause 5.15.2.2 of 3GPP TS 23.501.
Nested Schema : InvalidParam
Type:
objectIt contains an invalid parameter and a related description.
Show Source
-
param(required): string
If the invalid parameter is an attribute in a JSON body, this IE should contain the attribute's name and be encoded as a JSON Pointer. If the invalid parameter is an HTTP header, this IE should be formatted as the concatenation of the string "header" plus the header name. If the invalid parameter is a query parameter, this IE should be formatted as the concatenation of the string "query " plus the query parameter name. If the invalid parameter is a variable part of a resource URI path, this IE should contain the variable name, including the "{" and "}" symbols used in the OpenAPI specification to represent variable path segments.
-
reason: string
A human-readable reason, for example, "must be a positive integer". In cases involving failed operations in a PATCH request, the reason string should identify the failed operation that using the operation's array index to help correlate the invalid parameter with the failed operation, for example, " Replacement value invalid for attribute (failed operation index= 4)."
Default Response
Generic Error
Examples
The following example shows how to end a specified spending limit subscription by submitting a DELETE request on the REST resource using cURL. For more information about cURL, see "Use cURL".
curl -X DELETE 'apiRoot/nchf-spendinglimitcontrol/v1/subscriptions/imsi-6500000427" -H "accept: */*"
where apiRoot is for accessing the HTTP Gateway server at either http://hostname:httpPort or https://hostname:httpsPort.
Example of the Response Body
If successful, the response code 204 is returned along with a header. For example:
connection: keep-alive
date: Tue, 12 Jul 2022 08:28:22 +0530